From 1e6146eb5e1fe99e7960eb66455f05cba1045f66 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 28 Aug 2015 07:00:31 +0000
Subject: [PATCH 001/525] Create UDK2015 branch from EDKII trunk r18350

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18351 6f19259b-4bc3-4df7-8a09-765794883524

From 8a4fbdefadaba444a44a8b3ac6f117d3e2d6cf2a Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 28 Aug 2015 07:50:47 +0000
Subject: [PATCH 002/525] MdePkg: Modify string expression of BMC device path
 to follow UEFI spec

According to UEFI 2.5 spec, the string expression of a BMC device node
should be displayed as: BMC(Type,Address). However, current code displays
it as: Bmc(Type,Address).

(Sync patch r18353 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18356 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c | 2 +-
 MdePkg/Library/UefiDevicePathLib/DevicePathToText.c   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
index e5f6a1f0621a..2dccfcf472c2 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
@@ -3458,7 +3458,7 @@ GLOBAL_REMOVE_IF_UNREFERENCED DEVICE_PATH_FROM_TEXT_TABLE mUefiDevicePathLibDevP
   {L"MemoryMapped",            DevPathFromTextMemoryMapped            },
   {L"VenHw",                   DevPathFromTextVenHw                   },
   {L"Ctrl",                    DevPathFromTextCtrl                    },
-  {L"Bmc",                     DevPathFromTextBmc                     },
+  {L"BMC",                     DevPathFromTextBmc                     },
 
   {L"AcpiPath",                DevPathFromTextAcpiPath                },
   {L"Acpi",                    DevPathFromTextAcpi                    },
diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
index 627308c340be..08cc3e87f271 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
@@ -333,7 +333,7 @@ DevPathToTextBmc (
   Bmc = DevPath;
   UefiDevicePathLibCatPrint (
     Str,
-    L"Bmc(0x%x,0x%lx)",
+    L"BMC(0x%x,0x%lx)",
     Bmc->InterfaceType,
     ReadUnaligned64 ((UINT64 *) (&Bmc->BaseAddress))
     );

From 6896bb7f4e9c2d81c5121ff94e7b931d5764249e Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 28 Aug 2015 07:51:16 +0000
Subject: [PATCH 003/525] MdePkg: Modify string expression of Wi-Fi device path
 to follow UEFI spec

According to UEFI 2.5 spec, the string expression of a Wi-Fi device node
should be displayed as: Wi-Fi(SSID). However, current code displays it as:
WiFi(SSID).

(Sync patch r18354 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18357 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c | 2 +-
 MdePkg/Library/UefiDevicePathLib/DevicePathToText.c   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
index 2dccfcf472c2..9c5436d33763 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
@@ -3519,7 +3519,7 @@ GLOBAL_REMOVE_IF_UNREFERENCED DEVICE_PATH_FROM_TEXT_TABLE mUefiDevicePathLibDevP
   {L"Vlan",                    DevPathFromTextVlan                    },
   {L"Uri",                     DevPathFromTextUri                     },
   {L"Bluetooth",               DevPathFromTextBluetooth               },
-  {L"WiFi",                    DevPathFromTextWiFi                    },
+  {L"Wi-Fi",                   DevPathFromTextWiFi                    },
   {L"MediaPath",               DevPathFromTextMediaPath               },
   {L"HD",                      DevPathFromTextHD                      },
   {L"CDROM",                   DevPathFromTextCDROM                   },
diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
index 08cc3e87f271..0774fd8c17a4 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
@@ -1618,7 +1618,7 @@ DevPathToTextWiFi (
   WIFI_DEVICE_PATH      *WiFi;
 
   WiFi = DevPath;
-  UefiDevicePathLibCatPrint (Str, L"WiFi(%a)", WiFi->SSId);
+  UefiDevicePathLibCatPrint (Str, L"Wi-Fi(%a)", WiFi->SSId);
 }
 
 /**

From 889f1f4cffe3889074d26bc53e2484784c760844 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 28 Aug 2015 07:51:45 +0000
Subject: [PATCH 004/525] MdePkg UefiDevicePathLib: Fix possible memory
 read/write cross boundary

The SSID field of a Wi-Fi device path node may not contain a NULL
termination.

Additonal handle is added to make sure no cross-boundary memory read/write
will occur.

(Sync patch r18355 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18358 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiDevicePathLib/DevicePathFromText.c        | 15 ++++++++++++---
 .../Library/UefiDevicePathLib/DevicePathToText.c  |  7 ++++++-
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
index 9c5436d33763..6a9b389ca5c5 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathFromText.c
@@ -2827,7 +2827,8 @@ DevPathFromTextWiFi (
   )
 {
   CHAR16                *SSIdStr;
-  CHAR8                 *AsciiStr;
+  CHAR8                 AsciiStr[33];
+  UINTN                 DataLen;
   WIFI_DEVICE_PATH      *WiFiDp;
 
   SSIdStr = GetNextParamStr (&TextDeviceNode);
@@ -2837,8 +2838,16 @@ DevPathFromTextWiFi (
                                    (UINT16) sizeof (WIFI_DEVICE_PATH)
                                    );
 
-  AsciiStr = (CHAR8 *) WiFiDp->SSId;
-  StrToAscii (SSIdStr, &AsciiStr);
+  if (NULL != SSIdStr) {
+    DataLen = StrLen (SSIdStr);
+    if (StrLen (SSIdStr) > 32) {
+      SSIdStr[32] = L'\0';
+      DataLen     = 32;
+    }
+
+    UnicodeStrToAsciiStr (SSIdStr, AsciiStr);
+    CopyMem (WiFiDp->SSId, AsciiStr, DataLen);
+  }
 
   return (EFI_DEVICE_PATH_PROTOCOL *) WiFiDp;
 }
diff --git a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
index 0774fd8c17a4..363830bd32ca 100644
--- a/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
+++ b/MdePkg/Library/UefiDevicePathLib/DevicePathToText.c
@@ -1616,9 +1616,14 @@ DevPathToTextWiFi (
   )
 {
   WIFI_DEVICE_PATH      *WiFi;
+  UINT8                 SSId[33];
 
   WiFi = DevPath;
-  UefiDevicePathLibCatPrint (Str, L"Wi-Fi(%a)", WiFi->SSId);
+
+  SSId[32] = '\0';
+  CopyMem (SSId, WiFi->SSId, 32);
+
+  UefiDevicePathLibCatPrint (Str, L"Wi-Fi(%a)", SSId);
 }
 
 /**

From 727048b5fc68382dad540f2a8548d29905e38278 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Fri, 28 Aug 2015 08:37:19 +0000
Subject: [PATCH 005/525] NetworkPkg: Fix IpSec run into infinite loop issue in
 some case

v2:
* Update the copyright year and conditional judgment for removing.

When edit one SPEntry in SPD database, the corresponding SA entry will
be updated to the sas list of the new SPD entry. But before that, all
of them should be removed from the original sas list. If not, the list
will be broken into infinite loop.

(Sync patch r18352 from main trunk.)

Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18361 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/IpSecDxe/IpSecConfigImpl.c | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
index 6eabfe45dee8..bd49245190bd 100644
--- a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
+++ b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
@@ -1,7 +1,7 @@
 /** @file
   The implementation of IPSEC_CONFIG_PROTOCOL.
 
-  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -1199,6 +1199,9 @@ SetSpdEntry (
             (EFI_IPSEC_CONFIG_SELECTOR *) &SpdData->SaId[Index],
             (EFI_IPSEC_CONFIG_SELECTOR *) SadEntry->Id
             )) {
+        if (SadEntry->Data->SpdEntry != NULL) {  
+          RemoveEntryList (&SadEntry->BySpd);
+        }
         InsertTailList (&SpdEntry->Data->Sas, &SadEntry->BySpd);
         SadEntry->Data->SpdEntry = SpdEntry;
         DuplicateSpdSelector (

From f0e92f2f4f04e831bfcecabd8bdce3161f0b988b Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Sat, 29 Aug 2015 14:43:31 +0000
Subject: [PATCH 006/525] Update BaseTools binary to match main trunk r18339.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18362 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Bin/externals.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Bin/externals.txt b/BaseTools/Bin/externals.txt
index c2c4ab729732..f47774936432 100644
--- a/BaseTools/Bin/externals.txt
+++ b/BaseTools/Bin/externals.txt
@@ -1 +1 @@
-Win32  https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
+Win32  -r92 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32

From 24542d59049bdc7684835a4b820e21638433adaa Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Mon, 31 Aug 2015 06:03:10 +0000
Subject: [PATCH 007/525] ShellPkg: Get media status in ifconfig command

v2:
* Update to use NetLibDetectMedia() directly.

This patch is used to get media status in ifconfig command.

(Sync patch r18363 from main trunk.)

Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Cc: Jaben Carsey <jaben.carsey@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18364 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellNetwork1CommandsLib/Ifconfig.c   |  25 +++++++++++++-----
 .../UefiShellNetwork1CommandsLib.uni          | Bin 20910 -> 21094 bytes
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
index 273f1a85dd72..e16d46a8ec4d 100644
--- a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
+++ b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
@@ -596,11 +596,14 @@ IfConfigShowInterfaceInfo (
   IN LIST_ENTRY    *IfList
   )
 {
-  LIST_ENTRY                *Entry;
-  LIST_ENTRY                *Next;
-  IFCONFIG_INTERFACE_CB     *IfCb;
-  EFI_IPv4_ADDRESS          Gateway;
-  UINT32                    Index;
+  LIST_ENTRY                   *Entry;
+  LIST_ENTRY                   *Next;
+  IFCONFIG_INTERFACE_CB        *IfCb;
+  BOOLEAN                       MediaPresent;
+  EFI_IPv4_ADDRESS              Gateway;
+  UINT32                        Index;
+  
+  MediaPresent = TRUE;
 
   if (IsListEmpty (IfList)) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INVALID_INTERFACE), gShellNetwork1HiiHandle);
@@ -617,7 +620,17 @@ IfConfigShowInterfaceInfo (
     //
     // Print interface name.
     //
-    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INFO_IF_NAME), gShellNetwork1HiiHandle, IfCb->IfInfo->Name);
+    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INFO_IF_NAME), gShellNetwork1HiiHandle, IfCb->IfInfo->Name); 
+
+    //
+    // Get Media State.
+    //
+    NetLibDetectMedia (IfCb->NicHandle, &MediaPresent);
+    if (!MediaPresent) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INFO_MEDIA_STATE), gShellNetwork1HiiHandle, L"Media disconnected");
+    } else {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INFO_MEDIA_STATE), gShellNetwork1HiiHandle, L"Media present");
+    }
 
     //
     // Print interface config policy.
diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni b/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
index 7cc7b7d672246a62ef97a8b002a780003d3da330..43259591820582cc38937ad680739fcff21b96c5 100644
GIT binary patch
delta 66
zcmZ3tnDN;X#toCSgnb!Y8C)1V85|kn8G;!?fON>@hnk|30}QmpJs5l$QW;VhG8qyX
S6o9fNK)Qq>b+fZpwmJY$n-Ez5

delta 14
WcmaF1gmK+s#toCSHhXEyr~?2p<OQ_=


From 9b28a5d19f9aecea3cfcbab718e792b88aad5d65 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hp.com>
Date: Tue, 1 Sep 2015 00:37:24 +0000
Subject: [PATCH 008/525] MdeModulePkg/NetworkPkg: Locate IpSec on IP packet
 processing only if it's installed.

Modified the logic in Ip4Dxe and Ip6Dxe to not locate EFI_IPSEC2_PROTOCOL on each
message transmit/receive. Instead, register a callback in the drivers entry points
on the IpSec protocol installation, and process only if the protocol is installed.
This speeds up the network stacks when IpSec is not installed since there is a
penalty associated with searching the entire handle database on each packet processing.

(Sync patch r18365 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hp.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18367 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/Network/Ip4Dxe/Ip4Driver.c      | 36 ++++++++++++++++++
 .../Universal/Network/Ip4Dxe/Ip4Impl.h        |  3 ++
 .../Universal/Network/Ip4Dxe/Ip4Input.c       |  7 ++++
 NetworkPkg/Ip6Dxe/Ip6Driver.c                 | 38 +++++++++++++++++++
 NetworkPkg/Ip6Dxe/Ip6Impl.h                   |  2 +
 NetworkPkg/Ip6Dxe/Ip6Input.c                  |  6 +++
 6 files changed, 92 insertions(+)

diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Driver.c b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Driver.c
index d8ab948457c7..3dc4d88f13b7 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Driver.c
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Driver.c
@@ -2,6 +2,8 @@
   The driver binding and service binding protocol for IP4 driver.
 
 Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
+
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -23,6 +25,30 @@ EFI_DRIVER_BINDING_PROTOCOL gIp4DriverBinding = {
   NULL
 };
 
+BOOLEAN  mIpSec2Installed = FALSE;
+
+/**
+   Callback function for IpSec2 Protocol install.
+
+   @param[in] Event           Event whose notification function is being invoked
+   @param[in] Context         Pointer to the notification function's context
+
+**/
+VOID
+EFIAPI
+IpSec2InstalledCallback (
+  IN EFI_EVENT  Event,
+  IN VOID       *Context
+  )
+{
+  //
+  // Close the event so it does not get called again.
+  //
+  gBS->CloseEvent (Event);
+
+  mIpSec2Installed = TRUE;
+}
+
 /**
   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
@@ -45,6 +71,16 @@ Ip4DriverEntryPoint (
   IN EFI_SYSTEM_TABLE       *SystemTable
   )
 {
+  VOID            *Registration;
+
+  EfiCreateProtocolNotifyEvent (
+    &gEfiIpSec2ProtocolGuid,
+    TPL_CALLBACK,
+    IpSec2InstalledCallback,
+    NULL,
+    &Registration
+    );
+
   return EfiLibInstallDriverBindingComponentName2 (
            ImageHandle,
            SystemTable,
diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Impl.h b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Impl.h
index a1a76bd612b9..e802b9516bcd 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Impl.h
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Impl.h
@@ -2,6 +2,8 @@
   Ip4 internal functions and type defintions.
   
 Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
+
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -396,5 +398,6 @@ Ip4FreeTxToken (
   );
 
 extern EFI_IPSEC2_PROTOCOL   *mIpSec;
+extern BOOLEAN               mIpSec2Installed;
 
 #endif
diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Input.c b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Input.c
index 38ad1c39daf4..09b8f2bac235 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Input.c
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Input.c
@@ -2,6 +2,8 @@
   IP4 input process.
   
 Copyright (c) 2005 - 2014, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
+
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -512,6 +514,11 @@ Ip4IpSecProcessPacket (
   IP4_HEAD                  ZeroHead;
 
   Status        = EFI_SUCCESS;
+
+  if (!mIpSec2Installed) {
+    goto ON_EXIT;
+  }
+  
   Packet        = *Netbuf;
   RecycleEvent  = NULL;
   IpSecWrap     = NULL;
diff --git a/NetworkPkg/Ip6Dxe/Ip6Driver.c b/NetworkPkg/Ip6Dxe/Ip6Driver.c
index 69587849cc77..4fde47601cdf 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Driver.c
+++ b/NetworkPkg/Ip6Dxe/Ip6Driver.c
@@ -2,6 +2,7 @@
   The driver binding and service binding protocol for IP6 driver.
 
   Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -24,6 +25,33 @@ EFI_DRIVER_BINDING_PROTOCOL gIp6DriverBinding = {
   NULL
 };
 
+BOOLEAN  mIpSec2Installed = FALSE;
+
+/**
+   Callback function for IpSec2 Protocol install.
+
+   @param[in] Event           Event whose notification function is being invoked
+   @param[in] Context         Pointer to the notification function's context
+
+   @retval  EFI_SUCCESS       Callback successful.
+**/
+VOID
+EFIAPI
+IpSec2InstalledCallback (
+  IN EFI_EVENT  Event,
+  IN VOID       *Context
+  )
+{
+  //
+  // Close the event so it does not get called again.
+  //
+  gBS->CloseEvent (Event);
+
+  mIpSec2Installed = TRUE;
+
+  return;
+}
+
 /**
   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
@@ -46,6 +74,16 @@ Ip6DriverEntryPoint (
   IN EFI_SYSTEM_TABLE       *SystemTable
   )
 {
+  VOID            *Registration;
+
+  EfiCreateProtocolNotifyEvent (
+    &gEfiIpSec2ProtocolGuid,
+    TPL_CALLBACK,
+    IpSec2InstalledCallback,
+    NULL,
+    &Registration
+    );
+
   return EfiLibInstallDriverBindingComponentName2 (
            ImageHandle,
            SystemTable,
diff --git a/NetworkPkg/Ip6Dxe/Ip6Impl.h b/NetworkPkg/Ip6Dxe/Ip6Impl.h
index 8f114bbb10a5..d30246b2db3e 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Impl.h
+++ b/NetworkPkg/Ip6Dxe/Ip6Impl.h
@@ -2,6 +2,7 @@
   Implementation of EFI_IP6_PROTOCOL protocol interfaces and type definitions.
 
   Copyright (c) 2009 - 2012, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -89,6 +90,7 @@
 #define IP6_NO_MAPPING(IpInstance) (!(IpInstance)->Interface->Configured)
 
 extern EFI_IPSEC2_PROTOCOL *mIpSec;
+extern BOOLEAN             mIpSec2Installed;
 
 //
 // IP6_TXTOKEN_WRAP wraps the upper layer's transmit token.
diff --git a/NetworkPkg/Ip6Dxe/Ip6Input.c b/NetworkPkg/Ip6Dxe/Ip6Input.c
index cf88884e381b..e53e0874b9b5 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Input.c
+++ b/NetworkPkg/Ip6Dxe/Ip6Input.c
@@ -2,6 +2,7 @@
   IP6 internal functions to process the incoming packets.
 
   Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -525,6 +526,11 @@ Ip6IpSecProcessPacket (
   EFI_IP6_HEADER            ZeroHead;
 
   Status        = EFI_SUCCESS;
+
+  if (!mIpSec2Installed) {
+    goto ON_EXIT;
+  }
+  
   Packet        = *Netbuf;
   RecycleEvent  = NULL;
   IpSecWrap     = NULL;

From 1f90b7bf9346cfb1bd1a1a2c6d355106af53e090 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Tue, 1 Sep 2015 05:21:48 +0000
Subject: [PATCH 009/525] ShellPkg: Replace use case of deprecated function
 GetVariable with GetVariable2.

(Sync patch r18368 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18371 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index 6a248522b56d..28521ecc154b 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -3221,6 +3221,7 @@ EfiShellGetAlias(
   UINT32      Attribs;
   EFI_STATUS  Status;
   CHAR16      *AliasLower;
+  CHAR16      *AliasVal;
 
   // Convert to lowercase to make aliases case-insensitive
   if (Alias != NULL) {
@@ -3229,7 +3230,8 @@ EfiShellGetAlias(
     ToLower (AliasLower);
 
     if (Volatile == NULL) {
-      return (AddBufferToFreeList(GetVariable(AliasLower, &gShellAliasGuid)));
+      GetVariable2 (AliasLower, &gShellAliasGuid, (VOID **)&AliasVal, NULL);
+      return (AddBufferToFreeList(AliasVal));
     }
     RetSize = 0;
     RetVal = NULL;

From 091269232629660ef5b1997d66658c94b58b009d Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Sep 2015 03:15:20 +0000
Subject: [PATCH 010/525] UefiCpuPkg/CpuMpPei: Update the old/new BSP state in
 SwitchBsp()

(Sync patch r18372 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18380 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/PeiMpServices.c | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/PeiMpServices.c b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
index 503778fd9350..625c24a6f40e 100644
--- a/UefiCpuPkg/CpuMpPei/PeiMpServices.c
+++ b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
@@ -804,6 +804,16 @@ PeiSwitchBSP (
   ApicBaseMsr.Uint64 = AsmReadMsr64 (MSR_IA32_APIC_BASE_ADDRESS);
   ApicBaseMsr.Bits.Bsp = 1;
   AsmWriteMsr64 (MSR_IA32_APIC_BASE_ADDRESS, ApicBaseMsr.Uint64);
+  //
+  // Set old BSP enable state
+  //
+  if (!EnableOldBSP) {
+    PeiCpuMpData->CpuData[PeiCpuMpData->BspNumber].State = CpuStateDisabled;
+  }
+  //
+  // Save new BSP number
+  //
+  PeiCpuMpData->BspNumber = (UINT32) ProcessorNumber;
 
   return EFI_SUCCESS;
 }

From 5b70667c58a29ac4d7fa526fd8b0c180f35a8202 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Sep 2015 03:15:44 +0000
Subject: [PATCH 011/525] UefiCpuPkg/CpuMpPei: Check Function pointer in
 PeiStartupAllAPs ()

(Sync patch r18373 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18381 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/PeiMpServices.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/PeiMpServices.c b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
index 625c24a6f40e..4215f9e51b19 100644
--- a/UefiCpuPkg/CpuMpPei/PeiMpServices.c
+++ b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
@@ -441,6 +441,10 @@ PeiStartupAllAPs (
     return EFI_NOT_FOUND;
   }
 
+  if (Procedure == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
   //
   // Check whether caller processor is BSP
   //

From 81ae98cc176cb6c8be13f7f776663fd99d9ad60a Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Sep 2015 03:16:05 +0000
Subject: [PATCH 012/525] UefiCpuPkg/CpuMpPei: Fix CPU Healthy issue in
 PeiGetProcessorInfo ()

CPU Healthy state maybe changed by software. We should return Healthy state
from Healthy bit instead of from CPU BIST hardware information.

(Sync patch r18374 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18382 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuBist.c       | 5 ++++-
 UefiCpuPkg/CpuMpPei/PeiMpServices.c | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuBist.c b/UefiCpuPkg/CpuMpPei/CpuBist.c
index 2bee7a4a665b..56292452a9c7 100644
--- a/UefiCpuPkg/CpuMpPei/CpuBist.c
+++ b/UefiCpuPkg/CpuMpPei/CpuBist.c
@@ -226,7 +226,10 @@ CollectBistDataFromPpi (
         CpuData->Health = CpuInstance[CpuIndex].InfoRecord.IA32HealthFlags;
       }
     }
-    if (CpuData->Health.Uint32 != 0) {
+    if (CpuData->Health.Uint32 == 0) {
+      CpuData->CpuHealthy = TRUE;
+    } else {
+      CpuData->CpuHealthy = FALSE;
       //
       // Report Status Code that self test is failed
       //
diff --git a/UefiCpuPkg/CpuMpPei/PeiMpServices.c b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
index 4215f9e51b19..5dd2c153f46a 100644
--- a/UefiCpuPkg/CpuMpPei/PeiMpServices.c
+++ b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
@@ -334,7 +334,7 @@ PeiGetProcessorInfo (
   if (PeiCpuMpData->CpuData[ProcessorNumber].ApicId == GetInitialApicId()) {
     ProcessorInfoBuffer->StatusFlag |= PROCESSOR_AS_BSP_BIT;
   }
-  if (PeiCpuMpData->CpuData[ProcessorNumber].Health.Uint32 == 0) {
+  if (PeiCpuMpData->CpuData[ProcessorNumber].CpuHealthy) {
     ProcessorInfoBuffer->StatusFlag |= PROCESSOR_HEALTH_STATUS_BIT;
   }
   if (PeiCpuMpData->CpuData[ProcessorNumber].State == CpuStateDisabled) {

From 353938e942b2ac12332012f93e353b21900d0ecf Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 2 Sep 2015 08:32:00 +0000
Subject: [PATCH 013/525] Add more strict check for MOR variable, besides MOR
 lock variable.

(Sync patch r18383 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18386 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../TcgMorLock.c                                  | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLock.c b/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLock.c
index 7ca707915e25..c6f3edc75631 100644
--- a/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLock.c
+++ b/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLock.c
@@ -143,20 +143,21 @@ SetVariableCheckHandlerMor (
     return EFI_INVALID_PARAMETER;
   }
   
+  //
+  // Delete not OK
+  //
+  if ((DataSize != sizeof(UINT8)) || (Data == NULL) || (Attributes == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
   //
   // check format
   //
   if (IsMorLockVariable(VariableName, VendorGuid)) {
-    //
-    // Delete not OK
-    //
-    if ((DataSize == 0) || (Data == NULL) || (Attributes == 0)) {
-      return EFI_INVALID_PARAMETER;
-    }
     //
     // set to any other value not OK
     //
-    if ((DataSize != sizeof(UINT8)) || ((*(UINT8 *)Data != 1) && (*(UINT8 *)Data != 0))) {
+    if ((*(UINT8 *)Data != 1) && (*(UINT8 *)Data != 0)) {
       return EFI_INVALID_PARAMETER;
     }
   }

From bbe8770845724e629f4d79d3813bbb953d693296 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Wed, 2 Sep 2015 08:32:20 +0000
Subject: [PATCH 014/525] NetworkPkg: remove redundant words in function
 comment.

A function with void return type doesn't need @retval line in its function
comment. This patch removes one redundant line from Ip6 driver in r18365.

(Sync patch r18384 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18387 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/Ip6Dxe/Ip6Driver.c | 1 -
 1 file changed, 1 deletion(-)

diff --git a/NetworkPkg/Ip6Dxe/Ip6Driver.c b/NetworkPkg/Ip6Dxe/Ip6Driver.c
index 4fde47601cdf..076dc605e6df 100644
--- a/NetworkPkg/Ip6Dxe/Ip6Driver.c
+++ b/NetworkPkg/Ip6Dxe/Ip6Driver.c
@@ -33,7 +33,6 @@ BOOLEAN  mIpSec2Installed = FALSE;
    @param[in] Event           Event whose notification function is being invoked
    @param[in] Context         Pointer to the notification function's context
 
-   @retval  EFI_SUCCESS       Callback successful.
 **/
 VOID
 EFIAPI

From 09bcbf6219e3e22a308781ecf447489246be2a44 Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Sat, 5 Sep 2015 02:19:06 +0000
Subject: [PATCH 015/525] CryptoPkg: Replace string wrapper functions with safe
 string functions

EDKII core suggests to retire unsafe string functions. This patch is to
replace string wrapper functions with new-added safe string functions
for consistency.

(Sync patch r18385 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18397 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Include/OpenSslSupport.h | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/CryptoPkg/Include/OpenSslSupport.h b/CryptoPkg/Include/OpenSslSupport.h
index b5a8b58148cc..2c6e23cee3fe 100644
--- a/CryptoPkg/Include/OpenSslSupport.h
+++ b/CryptoPkg/Include/OpenSslSupport.h
@@ -21,6 +21,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/MemoryAllocationLib.h>
 #include <Library/DebugLib.h>
 
+#define MAX_STRING_SIZE  0x1000
+
 //
 // File operations are not required for building Open SSL, 
 // so FILE is mapped to VOID * to pass build
@@ -236,10 +238,10 @@ extern FILE  *stdout;
 #define memmove(dest,source,count)        CopyMem(dest,source,(UINTN)(count))
 #define strcmp                            AsciiStrCmp
 #define strncmp(string1,string2,count)    (int)(AsciiStrnCmp(string1,string2,(UINTN)(count)))
-#define strcpy(strDest,strSource)         AsciiStrCpy(strDest,strSource)
-#define strncpy(strDest,strSource,count)  AsciiStrnCpy(strDest,strSource,(UINTN)count)
-#define strlen(str)                       (size_t)(AsciiStrLen(str))
-#define strcat(strDest,strSource)         AsciiStrCat(strDest,strSource)
+#define strcpy(strDest,strSource)         AsciiStrCpyS(strDest,MAX_STRING_SIZE,strSource)
+#define strncpy(strDest,strSource,count)  AsciiStrnCpyS(strDest,MAX_STRING_SIZE,strSource,(UINTN)count)
+#define strlen(str)                       (size_t)(AsciiStrnLenS(str,MAX_STRING_SIZE))
+#define strcat(strDest,strSource)         AsciiStrCatS(strDest,MAX_STRING_SIZE,strSource)
 #define strchr(str,ch)                    ScanMem8((VOID *)(str),AsciiStrSize(str),(UINT8)ch)
 #define abort()                           ASSERT (FALSE)
 #define assert(expression)

From 59f1fa8dec6ab2b48f5f00a5080af1aa85464fda Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Sat, 5 Sep 2015 02:19:31 +0000
Subject: [PATCH 016/525] CryptoPkg: Fix one wrong parameter for weak key
 checking

Fix one wrong offset which is passed into DES weak key checking in TdesInit().

(Sync patch r18389 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18398 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Cipher/CryptTdes.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Cipher/CryptTdes.c b/CryptoPkg/Library/BaseCryptLib/Cipher/CryptTdes.c
index f89094a58117..8025a49cc8bc 100644
--- a/CryptoPkg/Library/BaseCryptLib/Cipher/CryptTdes.c
+++ b/CryptoPkg/Library/BaseCryptLib/Cipher/CryptTdes.c
@@ -1,7 +1,7 @@
 /** @file
   TDES Wrapper Implementation over OpenSSL.
 
-Copyright (c) 2010 - 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -90,7 +90,7 @@ TdesInit (
     return TRUE;
   }
 
-  if (DES_is_weak_key ((const_DES_cblock *) Key + 8) == 1) {
+  if (DES_is_weak_key ((const_DES_cblock *) (Key + 8)) == 1) {
     return FALSE;
   }
 
@@ -101,7 +101,7 @@ TdesInit (
     return TRUE;
   }
 
-  if (DES_is_weak_key ((const_DES_cblock *) Key + 16) == 1) {
+  if (DES_is_weak_key ((const_DES_cblock *) (Key + 16)) == 1) {
     return FALSE;
   }
 

From 472adcec6fc2d4c5bf94f140781bd4f9dd18785b Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Sat, 5 Sep 2015 02:19:52 +0000
Subject: [PATCH 017/525] UefiCpuPkg/MtrrLib: MtrrValidBitsMask and
 MtrrValidAddressMask wrong

Per IA32 SDM, if CPUID.80000008H is not available, software may assume that the
processor supports a 36-bit physical address size.
However, for such old processors (For example, Quark processor),
MtrrValidBitsMask and MtrrValidAddressMask values are reverted and wrong in
MtrrLib. MtrrValidBitsMask should be 0xFFFFFFFFFULL and MtrrValidAddressMask
should be 0xFFFFFF000ULL.

(Sync patch r18396 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18399 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index d9449bcca5d9..a65560542c88 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -1,7 +1,7 @@
 /** @file
   MTRR setting library
 
-  Copyright (c) 2008 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2008 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -840,8 +840,8 @@ MtrrLibInitializeMtrrMask (
     *MtrrValidBitsMask    = LShiftU64 (1, PhysicalAddressBits) - 1;
     *MtrrValidAddressMask = *MtrrValidBitsMask & 0xfffffffffffff000ULL;
   } else {
-    *MtrrValidBitsMask    = MTRR_LIB_CACHE_VALID_ADDRESS;
-    *MtrrValidAddressMask = 0xFFFFFFFF;
+    *MtrrValidBitsMask    = MTRR_LIB_MSR_VALID_MASK;
+    *MtrrValidAddressMask = MTRR_LIB_CACHE_VALID_ADDRESS;
   }
 }
 

From 3751df6c38a201e4ceb8f284737164bbacdb8d1d Mon Sep 17 00:00:00 2001
From: Dandan Bi <dandan.bi@intel.com>
Date: Sun, 6 Sep 2015 02:17:49 +0000
Subject: [PATCH 018/525] MdeModulePkg:Support orderedList with default value

Our tool can support OrderedList which has default value,but doesn't update the
source code in HiiDatabase when parse the ifr data.Now update the code and add
test case in DriverSample.

(Sync patch r18388 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <dandan.bi@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18401 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/DriverSampleDxe/Vfr.vfr         |  1 +
 .../Universal/HiiDatabaseDxe/ConfigRouting.c  | 21 +++++++++----------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/MdeModulePkg/Universal/DriverSampleDxe/Vfr.vfr b/MdeModulePkg/Universal/DriverSampleDxe/Vfr.vfr
index 8da0d4b30bda..bd28797a555f 100644
--- a/MdeModulePkg/Universal/DriverSampleDxe/Vfr.vfr
+++ b/MdeModulePkg/Universal/DriverSampleDxe/Vfr.vfr
@@ -234,6 +234,7 @@ formset
         option text = STRING_TOKEN(STR_ONE_OF_TEXT1), value = 3, flags = 0;
         option text = STRING_TOKEN(STR_ONE_OF_TEXT2), value = 2, flags = 0;
         option text = STRING_TOKEN(STR_ONE_OF_TEXT3), value = 1, flags = 0;
+        default     = {1,2,3},
       endlist;
     endif;
 
diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigRouting.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigRouting.c
index 1081e7592116..b618903b6a5b 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigRouting.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigRouting.c
@@ -1599,6 +1599,7 @@ ParseIfrData (
   UINT16                   VarWidth;
   UINT16                   VarDefaultId;
   BOOLEAN                  FirstOneOfOption;
+  BOOLEAN                  FirstOrderedList;
   LIST_ENTRY               *LinkData;
   LIST_ENTRY               *LinkDefault;
   EFI_IFR_VARSTORE_NAME_VALUE *IfrNameValueVarStore;
@@ -1610,6 +1611,7 @@ ParseIfrData (
   DefaultDataPtr   = NULL;
   FirstOneOfOption = FALSE;
   VarStoreId       = 0;
+  FirstOrderedList = FALSE;
   ZeroMem (&DefaultData, sizeof (IFR_DEFAULT_DATA));
 
   //
@@ -1856,9 +1858,9 @@ ParseIfrData (
       //
       // offset by question header
       // width by EFI_IFR_ORDERED_LIST MaxContainers * OneofOption Type
-      // no default value and default id, how to define its default value?
       //
 
+      FirstOrderedList = TRUE;
       //
       // OrderedList question is not in IFR Form. This IFR form is not valid. 
       //
@@ -2102,6 +2104,10 @@ ParseIfrData (
 
       IfrOneOfOption = (EFI_IFR_ONE_OF_OPTION *) IfrOpHdr;
       if (BlockData->OpCode == EFI_IFR_ORDERED_LIST_OP) {
+
+        if (!FirstOrderedList){
+          break;
+        }
         //
         // Get ordered list option data type.
         //
@@ -2158,10 +2164,9 @@ ParseIfrData (
         // Add Block Data into VarStorageData BlockEntry
         //
         InsertBlockData (&VarStorageData->BlockEntry, &BlockData);
-        //
-        // No default data for OrderedList.
-        //
-        BlockData = NULL;
+
+        FirstOrderedList = FALSE;
+
         break;
       }
 
@@ -2222,12 +2227,6 @@ ParseIfrData (
         break;
       }
 
-      if (BlockData->OpCode == EFI_IFR_ORDERED_LIST_OP) {
-        //
-        // OrderedList Opcode is no default value.
-        //
-        break;
-      }
       //
       // Get the DefaultId
       //

From 7027b268bf1887f7393487574dba309fda84bb74 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Sun, 6 Sep 2015 02:18:22 +0000
Subject: [PATCH 019/525] NetworkPkg: Fix the HttpCloseConnection fail issue

When HTTP server is unavailable,HttpCloseConnection will enter
infinite loop to wait for TCP4->close Event return, So we need to
decide the Http Instance state whether in the appropriate state
before close it.

(Sync patch r18400 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18402 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c  |  1 +
 NetworkPkg/HttpDxe/HttpProto.c | 25 ++++++++++++++-----------
 2 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 5b3c5d058cb1..dc06b9855c27 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -516,6 +516,7 @@ EfiHttpRequest (
   HttpCloseTcp4ConnCloseEvent (HttpInstance);
   if (NULL != Wrap->TcpWrap.TxToken.CompletionToken.Event) {
     gBS->CloseEvent (Wrap->TcpWrap.TxToken.CompletionToken.Event);
+    Wrap->TcpWrap.TxToken.CompletionToken.Event = NULL;
   }
 
 Error1:
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 829758ad5ea4..e8ce9879f309 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -243,10 +243,12 @@ HttpCloseTcp4ConnCloseEvent (
 
   if (NULL != HttpInstance->ConnToken.CompletionToken.Event) {
     gBS->CloseEvent (HttpInstance->ConnToken.CompletionToken.Event);
+    HttpInstance->ConnToken.CompletionToken.Event = NULL;
   }
 
   if (NULL != HttpInstance->CloseToken.CompletionToken.Event) {
     gBS->CloseEvent(HttpInstance->CloseToken.CompletionToken.Event);
+    HttpInstance->CloseToken.CompletionToken.Event = NULL;
   }  
 }
 
@@ -581,21 +583,22 @@ HttpCloseConnection (
 {
   EFI_STATUS                Status;
 
-  HttpInstance->CloseToken.AbortOnClose = TRUE;
-  HttpInstance->IsCloseDone             = FALSE;
-  
-
-  Status = HttpInstance->Tcp4->Close (HttpInstance->Tcp4, &HttpInstance->CloseToken);
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
+  if (HttpInstance->State == HTTP_STATE_TCP_CONNECTED) {
+    HttpInstance->CloseToken.AbortOnClose = TRUE;
+    HttpInstance->IsCloseDone             = FALSE;
+    
+    Status = HttpInstance->Tcp4->Close (HttpInstance->Tcp4, &HttpInstance->CloseToken);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
 
-  while (!HttpInstance->IsCloseDone) {
-    HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+    while (!HttpInstance->IsCloseDone) {
+      HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+    }
   }
 
   HttpInstance->State = HTTP_STATE_TCP_CLOSED;
-  return Status;
+  return EFI_SUCCESS;
 }
 
 /**

From 75e4a0767e964a05987da4dce0f75de166636517 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Mon, 7 Sep 2015 01:00:49 +0000
Subject: [PATCH 020/525] SecurityPkg: Use pointer instead of array to make
 code readable.

(Sync patch r18403 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18407 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c | 35 +++++++++++++++++++++----------
 1 file changed, 24 insertions(+), 11 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index 56a8613c59f1..9ad970a47be6 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -1456,6 +1456,7 @@ SetupEventLog (
   UINT8                           TempBuf[sizeof(TCG_EfiSpecIDEventStruct) + (HASH_COUNT * sizeof(TCG_EfiSpecIdEventAlgorithmSize)) + sizeof(UINT8)];
   TCG_PCR_EVENT_HDR               FirstPcrEvent;
   TCG_EfiSpecIdEventAlgorithmSize *DigestSize;
+  TCG_EfiSpecIdEventAlgorithmSize *TempDigestSize;
   UINT8                           *VendorInfoSize;
   UINT32                          NumberOfAlgorithms;
 
@@ -1501,32 +1502,44 @@ SetupEventLog (
         NumberOfAlgorithms = 0;
         DigestSize = (TCG_EfiSpecIdEventAlgorithmSize *)((UINT8 *)TcgEfiSpecIdEventStruct + sizeof(*TcgEfiSpecIdEventStruct) + sizeof(NumberOfAlgorithms));
         if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SHA1) != 0) {
-          DigestSize[NumberOfAlgorithms].algorithmId = TPM_ALG_SHA1;
-          DigestSize[NumberOfAlgorithms].digestSize = SHA1_DIGEST_SIZE;
+          TempDigestSize = DigestSize;
+          TempDigestSize += NumberOfAlgorithms;
+          TempDigestSize->algorithmId = TPM_ALG_SHA1;
+          TempDigestSize->digestSize = SHA1_DIGEST_SIZE;
           NumberOfAlgorithms++;
         }
         if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SHA256) != 0) {
-          DigestSize[NumberOfAlgorithms].algorithmId = TPM_ALG_SHA256;
-          DigestSize[NumberOfAlgorithms].digestSize = SHA256_DIGEST_SIZE;
+          TempDigestSize = DigestSize;
+          TempDigestSize += NumberOfAlgorithms;
+          TempDigestSize->algorithmId = TPM_ALG_SHA256;
+          TempDigestSize->digestSize = SHA256_DIGEST_SIZE;
           NumberOfAlgorithms++;
         }
         if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SHA384) != 0) {
-          DigestSize[NumberOfAlgorithms].algorithmId = TPM_ALG_SHA384;
-          DigestSize[NumberOfAlgorithms].digestSize = SHA384_DIGEST_SIZE;
+          TempDigestSize = DigestSize;
+          TempDigestSize += NumberOfAlgorithms;
+          TempDigestSize->algorithmId = TPM_ALG_SHA384;
+          TempDigestSize->digestSize = SHA384_DIGEST_SIZE;
           NumberOfAlgorithms++;
         }
         if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SHA512) != 0) {
-          DigestSize[NumberOfAlgorithms].algorithmId = TPM_ALG_SHA512;
-          DigestSize[NumberOfAlgorithms].digestSize = SHA512_DIGEST_SIZE;
+          TempDigestSize = DigestSize;
+          TempDigestSize += NumberOfAlgorithms;
+          TempDigestSize->algorithmId = TPM_ALG_SHA512;
+          TempDigestSize->digestSize = SHA512_DIGEST_SIZE;
           NumberOfAlgorithms++;
         }
         if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SM3_256) != 0) {
-          DigestSize[NumberOfAlgorithms].algorithmId = TPM_ALG_SM3_256;
-          DigestSize[NumberOfAlgorithms].digestSize = SM3_256_DIGEST_SIZE;
+          TempDigestSize = DigestSize;
+          TempDigestSize += NumberOfAlgorithms;
+          TempDigestSize->algorithmId = TPM_ALG_SM3_256;
+          TempDigestSize->digestSize = SM3_256_DIGEST_SIZE;
           NumberOfAlgorithms++;
         }
         CopyMem (TcgEfiSpecIdEventStruct + 1, &NumberOfAlgorithms, sizeof(NumberOfAlgorithms));
-        VendorInfoSize = (UINT8 *)&DigestSize[NumberOfAlgorithms];
+        TempDigestSize = DigestSize;
+        TempDigestSize += NumberOfAlgorithms;
+        VendorInfoSize = (UINT8 *)TempDigestSize;
         *VendorInfoSize = 0;
 
         //

From 79a12b0b18bca465a1fbd2c0023710e2ea99a142 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 7 Sep 2015 01:01:11 +0000
Subject: [PATCH 021/525] Handle extra module patchable PCD variable in Linux
 map.

Add comment for python function, too.

(Sync patch r18406 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Mudusuru, Giri P" <giri.p.mudusuru@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18408 6f19259b-4bc3-4df7-8a09-765794883524
---
 IntelFspPkg/Tools/PatchFv.py | 346 +++++++++++++++++++++++++++++++++--
 1 file changed, 334 insertions(+), 12 deletions(-)

diff --git a/IntelFspPkg/Tools/PatchFv.py b/IntelFspPkg/Tools/PatchFv.py
index 4421a83bd802..b6dab5591b83 100644
--- a/IntelFspPkg/Tools/PatchFv.py
+++ b/IntelFspPkg/Tools/PatchFv.py
@@ -15,6 +15,15 @@
 import re
 import sys
 
+#
+#  Read data from file
+#
+#  param [in]  binfile     Binary file
+#  param [in]  offset      Offset
+#  param [in]  len         Length
+#
+#  retval      value       Value
+#
 def readDataFromFile (binfile, offset, len=1):
     fd     = open(binfile, "r+b")
     fsize  = os.path.getsize(binfile)
@@ -31,11 +40,18 @@ def readDataFromFile (binfile, offset, len=1):
     fd.close()
     return value
 
+#
+#  Check FSP header is valid or not
+#
+#  param [in]  binfile     Binary file
+#
+#  retval      boolean     True: valid; False: invalid
+#
 def IsFspHeaderValid (binfile):
     fd     = open (binfile, "rb")
-    bindat = fd.read(0x200)
+    bindat = fd.read(0x200) # only read first 0x200 bytes
     fd.close()
-    HeaderList = ['FSPH' , 'FSPP' , 'FSPE']
+    HeaderList = ['FSPH' , 'FSPP' , 'FSPE']       # Check 'FSPH', 'FSPP', and 'FSPE' in the FSP header
     OffsetList = []
     for each in HeaderList:
         if each in bindat:
@@ -43,13 +59,26 @@ def IsFspHeaderValid (binfile):
         else:
             idx = 0
         OffsetList.append(idx)
-    if not OffsetList[0] or not OffsetList[1]:
+    if not OffsetList[0] or not OffsetList[1]:    # If 'FSPH' or 'FSPP' is missing, it will return false
         return False
     Revision = ord(bindat[OffsetList[0] + 0x0B])
+    #
+    # if revision is bigger than 1, it means it is FSP v1.1 or greater revision, which must contain 'FSPE'.
+    #
     if Revision > 1 and not OffsetList[2]:
-        return False
+        return False                              # If FSP v1.1 or greater without 'FSPE', then return false
     return True
 
+#
+#  Patch data in file
+#
+#  param [in]  binfile     Binary file
+#  param [in]  offset      Offset
+#  param [in]  value       Patch value
+#  param [in]  len         Length
+#
+#  retval      len         Length
+#
 def patchDataInFile (binfile, offset, value, len=1):
     fd     = open(binfile, "r+b")
     fsize  = os.path.getsize(binfile)
@@ -83,49 +112,98 @@ def __init__(self):
         self.parenthesisOpenSet   =  '([{<'
         self.parenthesisCloseSet  =  ')]}>'
 
+    #
+    #  Get FD file
+    #
+    #  retval      self.fdFile Retrieve FD file
+    #
     def getFdFile (self):
         return self.fdFile
 
+    #
+    #  Get FD size
+    #
+    #  retval      self.fdSize Retrieve the size of FD file
+    #
     def getFdSize (self):
         return self.fdSize
 
+    #
+    #  Create dictionaries
+    #
+    #  param [in]  fvDir       FV's directory
+    #  param [in]  fvNames     All FV's names
+    #
+    #  retval      0           Created dictionaries successfully
+    #
     def createDicts (self, fvDir, fvNames):
+        #
+        # If the fvDir is not a dirctory, then raise an exception
+        #
         if not os.path.isdir(fvDir):
             raise Exception ("'%s' is not a valid directory!" % FvDir)
 
+        #
+        # If the Guid.xref is not existing in fvDir, then raise an exception
+        #
         xrefFile = os.path.join(fvDir, "Guid.xref")
         if not os.path.exists(xrefFile):
             raise Exception("Cannot open GUID Xref file '%s'!" % xrefFile)
 
+        #
+        # Add GUID reference to dictionary
+        #
         self.dictGuidNameXref  = {}
         self.parseGuidXrefFile(xrefFile)
 
+        #
+        # Split up each FV from fvNames and get the fdBase
+        #
         fvList = fvNames.split(":")
         fdBase = fvList.pop()
         if len(fvList) == 0:
             fvList.append(fdBase)
 
+        #
+        # If the FD file is not existing, then raise an exception
+        #
         fdFile =  os.path.join(fvDir, fdBase.strip() + ".fd")
         if not os.path.exists(fdFile):
             raise Exception("Cannot open FD file '%s'!" % fdFile)
 
+        #
+        # Get the size of the FD file
+        #
         self.fdFile = fdFile
         self.fdSize = os.path.getsize(fdFile)
 
+        #
+        # If the INF file, which is the first element of fvList, is not existing, then raise an exception
+        #
         infFile = os.path.join(fvDir, fvList[0].strip()) + ".inf"
         if not os.path.exists(infFile):
             raise Exception("Cannot open INF file '%s'!" % infFile)
 
+        #
+        # Parse INF file in order to get fdBase and then assign those values to dictVariable
+        #
         self.parseInfFile(infFile)
-
         self.dictVariable = {}
         self.dictVariable["FDSIZE"] =  self.fdSize
         self.dictVariable["FDBASE"] =  self.fdBase
 
+        #
+        # Collect information from FV MAP file and FV TXT file then
+        # put them into dictionaries
+        #
         self.dictSymbolAddress = {}
         self.dictFfsOffset     = {}
         for file in fvList:
 
+            #
+            # If the .Fv.map file is not existing, then raise an exception.
+            # Otherwise, parse FV MAP file
+            #
             fvFile  = os.path.join(fvDir, file.strip()) + ".Fv"
             mapFile = fvFile + ".map"
             if not os.path.exists(mapFile):
@@ -133,12 +211,19 @@ def createDicts (self, fvDir, fvNames):
 
             self.parseFvMapFile(mapFile)
 
+            #
+            # If the .Fv.txt file is not existing, then raise an exception.
+            # Otherwise, parse FV TXT file
+            #
             fvTxtFile  = fvFile + ".txt"
             if not os.path.exists(fvTxtFile):
                 raise Exception("Cannot open FV TXT file '%s'!" % fvTxtFile)
 
             self.parseFvTxtFile(fvTxtFile)
 
+        #
+        # Search all MAP files in FFS directory if it exists then parse MOD MAP file
+        #
         ffsDir = os.path.join(fvDir, "Ffs")
         if (os.path.isdir(ffsDir)):
             for item in os.listdir(ffsDir):
@@ -151,7 +236,17 @@ def createDicts (self, fvDir, fvNames):
 
         return 0
 
+    #
+    #  Get FV offset in FD file
+    #
+    #  param [in]  fvFile      FV file
+    #
+    #  retval      offset      Got FV offset successfully
+    #
     def getFvOffsetInFd(self, fvFile):
+        #
+        # Check if the first 0x70 bytes of fvFile can be found in fdFile
+        #
         fvHandle = open(fvFile, "r+b")
         fdHandle = open(self.fdFile, "r+b")
         offset = fdHandle.read().find(fvHandle.read(0x70))
@@ -161,7 +256,18 @@ def getFvOffsetInFd(self, fvFile):
             raise Exception("Could not locate FV file %s in FD!" % fvFile)
         return offset
 
+    #
+    #  Parse INF file
+    #
+    #  param [in]  infFile     INF file
+    #
+    #  retval      0           Parsed INF file successfully
+    #
     def parseInfFile(self, infFile):
+        #
+        # Get FV offset and search EFI_BASE_ADDRESS in the FD file 
+        # then assign the value of EFI_BASE_ADDRESS to fdBase
+        #
         fvOffset    = self.getFvOffsetInFd(infFile[0:-4] + ".Fv")
         fdIn        = open(infFile, "r")
         rptLine     = fdIn.readline()
@@ -177,7 +283,19 @@ def parseInfFile(self, infFile):
             raise Exception("Could not find EFI_BASE_ADDRESS in INF file!" % fvFile)
         return 0
 
+    #
+    #  Parse FV TXT file
+    #
+    #  param [in]  fvTxtFile   .Fv.txt file
+    #
+    #  retval      0           Parsed FV TXT file successfully
+    #
     def parseFvTxtFile(self, fvTxtFile):
+        #
+        # Get information from .Fv.txt in order to create a dictionary
+        # For example,
+        # self.dictFfsOffset[912740BE-2284-4734-B971-84B027353F0C] = 0x000D4078
+        #
         fvOffset = self.getFvOffsetInFd(fvTxtFile[0:-4])
         fdIn     = open(fvTxtFile, "r")
         rptLine  = fdIn.readline()
@@ -189,7 +307,23 @@ def parseFvTxtFile(self, fvTxtFile):
         fdIn.close()
         return 0
 
+    #
+    #  Parse FV MAP file
+    #
+    #  param [in]  mapFile     .Fv.map file
+    #
+    #  retval      0           Parsed FV MAP file successfully
+    #
     def parseFvMapFile(self, mapFile):
+        #
+        # Get information from .Fv.map in order to create dictionaries
+        # For example,
+        # self.dictModBase[FspSecCore:BASE]  = 4294592776 (0xfffa4908)
+        # self.dictModBase[FspSecCore:ENTRY] = 4294606552 (0xfffa7ed8)
+        # self.dictModBase[FspSecCore:TEXT]  = 4294593080 (0xfffa4a38)
+        # self.dictModBase[FspSecCore:DATA]  = 4294612280 (0xfffa9538)
+        # self.dictSymbolAddress[FspSecCore:_SecStartup] = 0x00fffa4a38
+        #
         fdIn     = open(mapFile, "r")
         rptLine  = fdIn.readline()
         modName  = ""
@@ -220,30 +354,65 @@ def parseFvMapFile(self, mapFile):
         fdIn.close()
         return 0
 
+    #
+    #  Parse MOD MAP file
+    #
+    #  param [in]  moduleName  Module name
+    #  param [in]  mapFile     .Fv.map file
+    #
+    #  retval      0           Parsed MOD MAP file successfully
+    #  retval      1           There is no moduleEntryPoint in modSymbols
+    #
     def parseModMapFile(self, moduleName, mapFile):
+        #
+        # Get information from mapFile by moduleName in order to create a dictionary
+        # For example,
+        # self.dictSymbolAddress[FspSecCore:___guard_fids_count] = 0x00fffa4778
+        #
         modSymbols  = {}
         fdIn        = open(mapFile, "r")
-        reportLine  = fdIn.readline()
+        reportLines = fdIn.readlines()
+        fdIn.close()
+
+        moduleEntryPoint = "__ModuleEntryPoint"
+        reportLine = reportLines[0]
         if reportLine.strip().find("Archive member included") != -1:
             #GCC
             #                0x0000000000001d55                IoRead8
             patchMapFileMatchString = "\s+(0x[0-9a-fA-F]{16})\s+([^\s][^0x][_a-zA-Z0-9\-]+)\s"
             matchKeyGroupIndex = 2
             matchSymbolGroupIndex  = 1
-            moduleEntryPoint = "_ModuleEntryPoint"
+            prefix = '_'
         else:
             #MSFT
             #0003:00000190       _gComBase                  00007a50     SerialPo
             patchMapFileMatchString =  "^\s[0-9a-fA-F]{4}:[0-9a-fA-F]{8}\s+(\w+)\s+([0-9a-fA-F]{8}\s+)"
             matchKeyGroupIndex = 1
             matchSymbolGroupIndex  = 2
-            moduleEntryPoint = "__ModuleEntryPoint"
-        while (reportLine != "" ):
+            prefix = ''
+
+        for reportLine in reportLines:
             match = re.match(patchMapFileMatchString, reportLine)
             if match is not None:
-                modSymbols[match.group(matchKeyGroupIndex)] = match.group(matchSymbolGroupIndex)
-            reportLine  = fdIn.readline()
-        fdIn.close()
+                modSymbols[prefix + match.group(matchKeyGroupIndex)] = match.group(matchSymbolGroupIndex)
+
+        # Handle extra module patchable PCD variable in Linux map since it might have different format
+        # .data._gPcd_BinaryPatch_PcdVpdBaseAddress
+        #        0x0000000000003714        0x4 /tmp/ccmytayk.ltrans1.ltrans.o
+        handleNext = False
+        if matchSymbolGroupIndex == 1:
+            for reportLine in reportLines:
+                if handleNext:
+                    handleNext = False
+                    pcdName = match.group(1)
+                    match   = re.match("\s+(0x[0-9a-fA-F]{16})\s+", reportLine)
+                    if match is not None:
+                        modSymbols[prefix + pcdName] = match.group(1)
+                else:
+                    match = re.match("^\s\.data\.(_gPcd_BinaryPatch[_a-zA-Z0-9\-]+)", reportLine)
+                    if match is not None:
+                        handleNext = True
+                        continue
 
         if not moduleEntryPoint in modSymbols:
             return 1
@@ -263,7 +432,19 @@ def parseModMapFile(self, moduleName, mapFile):
                 self.dictSymbolAddress[fullSym] = "0x00%08x" % (baseOffset+ int(modSymbols[symbol], 16))
         return 0
 
+    #
+    #  Parse Guid.xref file
+    #
+    #  param [in]  xrefFile    the full directory of Guid.xref file
+    #
+    #  retval      0           Parsed Guid.xref file successfully
+    #
     def parseGuidXrefFile(self, xrefFile):
+        #
+        # Get information from Guid.xref in order to create a GuidNameXref dictionary
+        # The dictGuidNameXref, for example, will be like
+        # dictGuidNameXref [1BA0062E-C779-4582-8566-336AE8F78F09] = FspSecCore
+        #
         fdIn     = open(xrefFile, "r")
         rptLine  = fdIn.readline()
         while (rptLine != "" ):
@@ -274,18 +455,35 @@ def parseGuidXrefFile(self, xrefFile):
         fdIn.close()
         return 0
 
+    #
+    #  Get current character
+    #
+    #  retval      elf.string[self.index]
+    #  retval      ''                       Exception
+    #
     def getCurr(self):
         try:
             return self.string[self.index]
         except Exception:
             return ''
 
+    #
+    #  Check to see if it is last index
+    #
+    #  retval      self.index
+    #
     def isLast(self):
         return self.index == len(self.string)
 
+    #
+    #  Move to next index
+    #
     def moveNext(self):
         self.index += 1
 
+    #
+    #  Skip space
+    #
     def skipSpace(self):
         while not self.isLast():
             if self.getCurr() in ' \t':
@@ -293,6 +491,11 @@ def skipSpace(self):
             else:
                 return
 
+    #
+    #  Parse value
+    #
+    #  retval      value
+    #
     def parseValue(self):
         self.skipSpace()
         var = ''
@@ -325,6 +528,11 @@ def parseValue(self):
                 value = self.getVariable(var)
         return int(value)
 
+    #
+    #  Parse single operation
+    #
+    #  retval      ~self.parseBrace() or self.parseValue()
+    #
     def parseSingleOp(self):
         self.skipSpace()
         char = self.getCurr()
@@ -334,6 +542,11 @@ def parseSingleOp(self):
         else:
             return self.parseValue()
 
+    #
+    #  Parse symbol of Brace([, {, <)
+    #
+    #  retval      value or self.parseSingleOp()
+    #
     def parseBrace(self):
         self.skipSpace()
         char = self.getCurr()
@@ -355,6 +568,11 @@ def parseBrace(self):
         else:
             return self.parseSingleOp()
 
+    #
+    #  Parse symbol of Multiplier(*)
+    #
+    #  retval      value or self.parseSingleOp()
+    #
     def parseMul(self):
         values = [self.parseBrace()]
         while True:
@@ -370,6 +588,11 @@ def parseMul(self):
             value *= each
         return value
 
+    #
+    #  Parse symbol of And(&) and Or(|)
+    #
+    #  retval      value
+    #
     def parseAndOr(self):
         values = [self.parseMul()]
         op     = None
@@ -398,6 +621,11 @@ def parseAndOr(self):
 
         return value
 
+    #
+    #  Parse symbol of Add(+) and Minus(-)
+    #
+    #  retval      sum(values)
+    #
     def parseAddMinus(self):
         values = [self.parseAndOr()]
         while True:
@@ -413,9 +641,19 @@ def parseAddMinus(self):
                 break
         return sum(values)
 
+    #
+    #  Parse expression
+    #
+    #  retval      self.parseAddMinus()
+    #
     def parseExpr(self):
         return self.parseAddMinus()
 
+    #
+    #  Get result
+    #
+    #  retval      value
+    #
     def getResult(self):
         value = self.parseExpr()
         self.skipSpace()
@@ -423,6 +661,11 @@ def getResult(self):
             raise Exception("Unexpected character found '%s'" % self.getCurr())
         return value
 
+    #
+    #  Get module GUID
+    #
+    #  retval      value
+    #
     def getModGuid(self, var):
         guid = (guid for guid,name in self.dictGuidNameXref.items() if name==var)
         try:
@@ -431,12 +674,22 @@ def getModGuid(self, var):
             raise Exception("Unknown module name %s !" % var)
         return value
 
+    #
+    #  Get variable
+    #
+    #  retval      value
+    #
     def getVariable(self, var):
         value = self.dictVariable.get(var, None)
         if value == None:
             raise Exception("Unrecognized variable '%s'" % var)
         return value
 
+    #
+    #  Get number
+    #
+    #  retval      value
+    #
     def getNumber(self, var):
         var = var.strip()
         if var.startswith('0x'):  # HEX
@@ -445,6 +698,13 @@ def getNumber(self, var):
             value = int(var, 10)
         return value
 
+    #
+    #  Get content
+    #
+    #  param [in]  value
+    #
+    #  retval      value
+    #
     def getContent(self, value):
         if (value >= self.fdBase) and (value < self.fdBase + self.fdSize):
             value = value - self.fdBase
@@ -452,16 +712,37 @@ def getContent(self, value):
             raise Exception("Invalid file offset 0x%08x !" % value)
         return readDataFromFile (self.fdFile, value, 4)
 
+    #
+    #  Change value to address
+    #
+    #  param [in]  value
+    #
+    #  retval      value
+    #
     def toAddress(self, value):
         if value < self.fdSize:
             value = value + self.fdBase
         return value
 
+    #
+    #  Change value to offset
+    #
+    #  param [in]  value
+    #
+    #  retval      value
+    #
     def toOffset(self, value):
         if value > self.fdBase:
             value = value - self.fdBase
         return value
 
+    #
+    #  Get GUID offset
+    #
+    #  param [in]  value
+    #
+    #  retval      value
+    #
     def getGuidOff(self, value):
         # GUID:Offset
         symbolName = value.split(':')
@@ -471,6 +752,13 @@ def getGuidOff(self, value):
             raise Exception("Unknown GUID %s !" % value)
         return value
 
+    #
+    #  Get symbols
+    #
+    #  param [in]  value
+    #
+    #  retval      ret
+    #
     def getSymbols(self, value):
         if self.dictSymbolAddress.has_key(value):
             # Module:Function
@@ -479,6 +767,14 @@ def getSymbols(self, value):
             raise Exception("Unknown symbol %s !" % value)
         return ret
 
+    #
+    #  Evaluate symbols
+    #
+    #  param [in]  expression
+    #  param [in]  isOffset
+    #
+    #  retval      value & 0xFFFFFFFF
+    #
     def evaluate(self, expression, isOffset):
         self.index     = 0
         self.synUsed   = False
@@ -498,6 +794,9 @@ def evaluate(self, expression, isOffset):
                 raise Exception("Invalid offset expression !")
         return value & 0xFFFFFFFF
 
+#
+#  Print out the usage
+#
 def usage():
     print "Usage: \n\tPatchFv FvBuildDir [FvFileBaseNames:]FdFileBaseNameToPatch \"Offset, Value\""
 
@@ -507,23 +806,38 @@ def main():
     #
     symTables = Symbols()
 
+    #
+    # If the arguments are less than 4, then return an error.
+    #
     if len(sys.argv) < 4:
         Usage()
         return 1
 
+    #
+    # If it fails to create dictionaries, then return an error.
+    #
     if symTables.createDicts(sys.argv[1], sys.argv[2]) != 0:
         print "ERROR: Failed to create symbol dictionary!!"
         return 2
 
+    #
+    # Get FD file and size
+    #
     fdFile = symTables.getFdFile()
     fdSize = symTables.getFdSize()
 
     try:
+        #
+        # Check to see if FSP header is valid
+        #
         ret = IsFspHeaderValid(fdFile)
         if ret == False:
           raise Exception ("The FSP header is not valid. Stop patching FD.")
         comment = ""
         for fvFile in  sys.argv[3:]:
+            #
+            # Check to see if it has enough arguments
+            #
             items = fvFile.split(",")
             if len (items) < 2:
                 raise Exception("Expect more arguments for '%s'!" % fvFile)
@@ -542,8 +856,14 @@ def main():
                         isOffset = True
                     else :
                         isOffset = False
+                    #
+                    # Parse symbols then append it to params
+                    #
                     params.append (symTables.evaluate(item, isOffset))
 
+            #
+            # Patch a new value into FD file if it is not a command
+            #
             if command == "":
                 # Patch a DWORD
                 if len (params) == 2:
@@ -560,7 +880,9 @@ def main():
                     print  "Patched offset 0x%08X:[%08X] with value 0x%08X  # %s" % (offset, oldvalue, value, comment)
 
             elif command == "COPY":
+                #
                 # Copy binary block from source to destination
+                #
                 if len (params) == 3:
                     src  = symTables.toOffset(params[0])
                     dest = symTables.toOffset(params[1])

From bcb9fdb5baeb9d9df6ad391129e95027d0f645cc Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Tue, 8 Sep 2015 06:01:04 +0000
Subject: [PATCH 022/525] NetworkPkg: Fix suspicious dereference of pointer
 'FieldCount'

This patch is used to fix suspicious dereference of pointer 'FieldCount'
before NULL check.

(Sync patch r18409 from main trunk.)

Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18410 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesProtocol.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesProtocol.c b/NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesProtocol.c
index 8c29f20adfe2..a83c9633fc02 100644
--- a/NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesProtocol.c
+++ b/NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesProtocol.c
@@ -307,7 +307,6 @@ HttpUtilitiesParse (
   
   Status          = EFI_SUCCESS;
   TempHttpMessage = NULL;
-  *FieldCount     = 0;
   Token           = NULL;
   NextToken       = NULL;
   FieldName       = NULL;
@@ -328,6 +327,7 @@ HttpUtilitiesParse (
   //
   // Get header number
   //
+  *FieldCount = 0;
   Token = TempHttpMessage;
   while (TRUE) {
     FieldName     = NULL;

From c9d0fe0817a87313a28b800e001ecf2b5d4bbb5a Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 9 Sep 2015 07:50:09 +0000
Subject: [PATCH 023/525] MdeModulePkg: Fix a performance data buffer overrun
 issue

The mBmPerfHeader.Count isn't reset to 0 in BmWriteBootToOsPerformanceData()
so when the actual performance data entry count exceeds the LimitCount,
the performance data collection breaks on condition
if (mBmPerfHeader.Count == LimitCount), but 2nd time calling this function
will not break on condition if (mBmPerfHeader.Count == LimitCount) because
the mBmPerfHeader.Count always bigger than LimitCount, which results buffer
overrun.

(Sync patch r18417 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18420 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c b/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
index 7b13ec663c68..e45c0bd23a5b 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
+++ b/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
@@ -185,6 +185,11 @@ BmWriteBootToOsPerformanceData (
   //
   PERF_END(NULL, "BDS", NULL, 0);
 
+  //
+  // Reset the entry count
+  //
+  mBmPerfHeader.Count = 0;
+
   //
   // Retrieve time stamp count as early as possible
   //

From 6c6967d4a6073313fe7b53b881eaba6014c7f72b Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Thu, 10 Sep 2015 05:24:32 +0000
Subject: [PATCH 024/525] MdePkg: Refine UefiFileHandleLib to avoid write
 non-ASCII char into ASCII file.

(Sync patch r18430 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18432 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
index 04a2f189eceb..dfec5fa4d47d 100644
--- a/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
+++ b/MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.c
@@ -1079,6 +1079,7 @@ FileHandleWriteLine(
   EFI_STATUS  Status;
   CHAR16      CharBuffer;
   UINTN       Size;
+  UINTN       Index;
   UINTN       CharSize;
   UINT64      FileSize;
   UINT64      OriginalFilePosition;
@@ -1136,6 +1137,12 @@ FileHandleWriteLine(
       return EFI_OUT_OF_RESOURCES;
     }
     UnicodeStrToAsciiStr (Buffer, AsciiBuffer);
+    for (Index = 0; Index < Size; Index++) {
+      if (!((AsciiBuffer[Index] >= 0) && (AsciiBuffer[Index] < 128))){
+        FreePool(AsciiBuffer);
+        return EFI_INVALID_PARAMETER;
+      }
+    }
     
     Size = AsciiStrSize(AsciiBuffer) - sizeof(CHAR8);
     Status = FileHandleWrite(Handle, &Size, AsciiBuffer);

From c554140290c61d7f9af7e563815dd15e31aa5c52 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Thu, 10 Sep 2015 05:25:06 +0000
Subject: [PATCH 025/525] ShellPkg: Fix Shell fail with redundant space
 following delay number.

When boot from Shell we can use '-delay [num]' as optional data. If blank space exist after '[num]' Shell will fail. This patch add error handling to avoid this failure.

(Sync patch r18431 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18433 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.h                   | 11 +++++++++++
 ShellPkg/Application/Shell/ShellParametersProtocol.c |  1 +
 2 files changed, 12 insertions(+)

diff --git a/ShellPkg/Application/Shell/Shell.h b/ShellPkg/Application/Shell/Shell.h
index 4d804fc45bb3..b6686256aac3 100644
--- a/ShellPkg/Application/Shell/Shell.h
+++ b/ShellPkg/Application/Shell/Shell.h
@@ -360,5 +360,16 @@ FindFirstCharacter(
   IN CONST CHAR16 EscapeCharacter
   );
 
+/**
+  Cleans off leading and trailing spaces and tabs.
+
+  @param[in] String pointer to the string to trim them off.
+**/
+EFI_STATUS
+EFIAPI
+TrimSpaces(
+  IN CHAR16 **String
+  );
+
 #endif //_SHELL_INTERNAL_HEADER_
 
diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.c b/ShellPkg/Application/Shell/ShellParametersProtocol.c
index 1c1367bdf89c..bc19df7e931e 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.c
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.c
@@ -359,6 +359,7 @@ CreatePopulateInstallShellParametersProtocol (
     //
     // Populate Argc and Argv
     //
+    TrimSpaces (&FullCommandLine);
     Status = ParseCommandLineToArgs(FullCommandLine,
                                     &(*NewShellParameters)->Argv,
                                     &(*NewShellParameters)->Argc);

From 130fd7399bcbf13bd386f419fb66dc8f066df212 Mon Sep 17 00:00:00 2001
From: Feng Tian <feng.tian@intel.com>
Date: Fri, 11 Sep 2015 00:52:06 +0000
Subject: [PATCH 026/525] MdePkg/UefiScsiLib: comments update to add
 EFI_INVALID_PARAMETER status

EFI_SCSI_IO_PROTOCOL has alignment requirement on any data buffer
used in SCSI data transfer. As a wrap of this protocol, UefiScsiLib
have same request. Adding EFI_INVALID_PARAMETER return status in
function comments to ask the caller to guarantee this alignment.

(Sync patch r18434 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18439 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/UefiScsiLib.h     | 379 +++++++++++++---------
 MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 385 ++++++++++++++---------
 2 files changed, 469 insertions(+), 295 deletions(-)

diff --git a/MdePkg/Include/Library/UefiScsiLib.h b/MdePkg/Include/Library/UefiScsiLib.h
index 768a912a22fc..26e4aa4e0f02 100644
--- a/MdePkg/Include/Library/UefiScsiLib.h
+++ b/MdePkg/Include/Library/UefiScsiLib.h
@@ -5,7 +5,7 @@
   for hard drive, CD and DVD devices that are the most common SCSI boot targets used by UEFI platforms.
   This library class depends on SCSI I/O Protocol defined in UEFI Specification and SCSI-2 industry standard.
 
-Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials                          
 are licensed and made available under the terms and conditions of the BSD License         
 which accompanies this distribution.  The full text of the license may be found at        
@@ -32,6 +32,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   If HostAdapterStatus is NULL, then ASSERT().
   If TargetStatus is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]     ScsiIo             A pointer to the SCSI I/O Protocol instance
                                     for the specific SCSI target.
@@ -61,27 +64,28 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
                                     Protocol in the UEFI Specification for details on
                                     the possible return values. 
 
-  @retval EFI_SUCCESS          The command was executed successfully.
-                               See HostAdapterStatus, TargetStatus, SenseDataLength,
-                               and SenseData in that order for additional status
-                               information.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because
-                               there are too many SCSI Command Packets already
-                               queued. The SCSI Request Packet was not sent, so
-                               no additional status information is available.
-                               The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send
-                               SCSI Request Packet.  See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that
-                               order for additional status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet
-                               is not supported by the SCSI initiator(i.e., SCSI
-                               Host Controller). The SCSI Request Packet was not
-                               sent, so no additional status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS               The command was executed successfully.
+                                    See HostAdapterStatus, TargetStatus, SenseDataLength,
+                                    and SenseData in that order for additional status
+                                    information.
+  @retval EFI_NOT_READY             The SCSI Request Packet could not be sent because
+                                    there are too many SCSI Command Packets already
+                                    queued. The SCSI Request Packet was not sent, so
+                                    no additional status information is available.
+                                    The caller may retry again later.
+  @retval EFI_DEVICE_ERROR          A device error occurred while attempting to send
+                                    SCSI Request Packet.  See HostAdapterStatus,
+                                    TargetStatus, SenseDataLength, and SenseData in that
+                                    order for additional status information.
+  @retval EFI_UNSUPPORTED           The command described by the SCSI Request Packet
+                                    is not supported by the SCSI initiator(i.e., SCSI
+                                    Host Controller). The SCSI Request Packet was not
+                                    sent, so no additional status information is available.
+  @retval EFI_TIMEOUT               A timeout occurred while waiting for the SCSI Request
+                                    Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                    SenseDataLength, and SenseData in that order for
+                                    additional status information.
+  @retval EFI_INVALID_PARAMETER     The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -108,6 +112,14 @@ ScsiTestUnitReadyCommand (
   If TargetStatus is NULL, then ASSERT().
   If InquiryDataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If InquiryDataLength is non-zero and InquiryDataBuffer is not NULL, InquiryDataBuffer
+  must meet buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
   @param[in]      ScsiIo                 A pointer to the SCSI I/O Protocol instance
                                          for the specific SCSI target.
   @param[in]      Timeout                The timeout in 100 ns units to use for the
@@ -150,28 +162,29 @@ ScsiTestUnitReadyCommand (
                                          If FALSE, then the standard inquiry data is
                                          returned in InquiryDataBuffer. 
 
-  @retval EFI_SUCCESS          The command was executed successfully. See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that order
-                               for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire
-                               InquiryDataBuffer could not be transferred. The actual
-                               number of bytes transferred is returned in InquiryDataLength.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because there
-                               are too many SCSI Command Packets already queued.
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available. The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI
-                               Request Packet.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for additional
-                               status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not
-                               supported by the SCSI initiator(i.e., SCSI  Host Controller).
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS                    The command was executed successfully. See HostAdapterStatus,
+                                         TargetStatus, SenseDataLength, and SenseData in that order
+                                         for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE            The SCSI Request Packet was executed, but the entire
+                                         InquiryDataBuffer could not be transferred. The actual
+                                         number of bytes transferred is returned in InquiryDataLength.
+  @retval EFI_NOT_READY                  The SCSI Request Packet could not be sent because there
+                                         are too many SCSI Command Packets already queued.
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available. The caller may retry again later.
+  @retval EFI_DEVICE_ERROR               A device error occurred while attempting to send SCSI
+                                         Request Packet.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for additional
+                                         status information.
+  @retval EFI_UNSUPPORTED                The command described by the SCSI Request Packet is not
+                                         supported by the SCSI initiator(i.e., SCSI  Host Controller).
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available.
+  @retval EFI_TIMEOUT                    A timeout occurred while waiting for the SCSI Request
+                                         Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for
+                                         additional status information.
+  @retval EFI_INVALID_PARAMETER          The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -201,6 +214,14 @@ ScsiInquiryCommand (
   If TargetStatus is NULL, then ASSERT().
   If InquiryDataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If InquiryDataLength is non-zero and InquiryDataBuffer is not NULL, InquiryDataBuffer
+  must meet buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
   @param[in]      ScsiIo                 A pointer to the SCSI I/O Protocol instance
                                          for the specific SCSI target.
   @param[in]      Timeout                The timeout in 100 ns units to use for the
@@ -245,28 +266,29 @@ ScsiInquiryCommand (
   @param[in]      PageCode               The page code of the vital product data.
                                          It's ignored if EnableVitalProductData is FALSE.
 
-  @retval EFI_SUCCESS          The command executed successfully. See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that order
-                               for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire
-                               InquiryDataBuffer could not be transferred. The actual
-                               number of bytes transferred is returned in InquiryDataLength.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because there
-                               are too many SCSI Command Packets already queued.
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available. The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI
-                               Request Packet.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for additional
-                               status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not
-                               supported by the SCSI initiator(i.e., SCSI  Host Controller).
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS                    The command executed successfully. See HostAdapterStatus,
+                                         TargetStatus, SenseDataLength, and SenseData in that order
+                                         for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE            The SCSI Request Packet was executed, but the entire
+                                         InquiryDataBuffer could not be transferred. The actual
+                                         number of bytes transferred is returned in InquiryDataLength.
+  @retval EFI_NOT_READY                  The SCSI Request Packet could not be sent because there
+                                         are too many SCSI Command Packets already queued.
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available. The caller may retry again later.
+  @retval EFI_DEVICE_ERROR               A device error occurred while attempting to send SCSI
+                                         Request Packet.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for additional
+                                         status information.
+  @retval EFI_UNSUPPORTED                The command described by the SCSI Request Packet is not
+                                         supported by the SCSI initiator(i.e., SCSI  Host Controller).
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available.
+  @retval EFI_TIMEOUT                    A timeout occurred while waiting for the SCSI Request
+                                         Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for
+                                         additional status information.
+  @retval EFI_INVALID_PARAMETER          The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -299,6 +321,13 @@ ScsiInquiryCommandEx (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo             A pointer to the SCSI I/O Protocol instance
                                      for the specific SCSI target.
@@ -340,30 +369,31 @@ ScsiInquiryCommandEx (
   @param[in]      PageControl        Specifies the PC field of the CDB for this SCSI Command. 
   @param[in]      PageCode           Specifies the Page Control field of the CDB for this SCSI Command. 
 
-  @retval EFI_SUCCESS               The command was executed successfully.
-                                    See HostAdapterStatus, TargetStatus, SenseDataLength,
-                                    and SenseData in that order for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE       The SCSI Request Packet was executed, but the
-                                    entire DataBuffer could not be transferred.
-                                    The actual number of bytes transferred is returned
-                                    in DataLength.
-  @retval EFI_NOT_READY             The SCSI Request Packet could not be sent because
-                                    there are too many SCSI Command Packets already queued.
-                                    The SCSI Request Packet was not sent, so no additional
-                                    status information is available.  The caller may retry
-                                    again later.
-  @retval EFI_DEVICE_ERROR          A device error occurred while attempting to send
-                                    SCSI Request Packet.  See HostAdapterStatus, TargetStatus,
-                                    SenseDataLength, and SenseData in that order for
-                                    additional status information.
-  @retval EFI_UNSUPPORTED           The command described by the SCSI Request Packet
-                                    is not supported by the SCSI initiator(i.e., SCSI
-                                    Host Controller). The SCSI Request Packet was not
-                                    sent, so no additional status information is available.
-  @retval EFI_TIMEOUT               A timeout occurred while waiting for the SCSI
-                                    Request Packet to execute.  See HostAdapterStatus,
-                                    TargetStatus, SenseDataLength, and SenseData in that
-                                    order for additional status information.
+  @retval EFI_SUCCESS                The command was executed successfully.
+                                     See HostAdapterStatus, TargetStatus, SenseDataLength,
+                                     and SenseData in that order for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE        The SCSI Request Packet was executed, but the
+                                     entire DataBuffer could not be transferred.
+                                     The actual number of bytes transferred is returned
+                                     in DataLength.
+  @retval EFI_NOT_READY              The SCSI Request Packet could not be sent because
+                                     there are too many SCSI Command Packets already queued.
+                                     The SCSI Request Packet was not sent, so no additional
+                                     status information is available.  The caller may retry
+                                     again later.
+  @retval EFI_DEVICE_ERROR           A device error occurred while attempting to send
+                                     SCSI Request Packet.  See HostAdapterStatus, TargetStatus,
+                                     SenseDataLength, and SenseData in that order for
+                                     additional status information.
+  @retval EFI_UNSUPPORTED            The command described by the SCSI Request Packet
+                                     is not supported by the SCSI initiator(i.e., SCSI
+                                     Host Controller). The SCSI Request Packet was not
+                                     sent, so no additional status information is available.
+  @retval EFI_TIMEOUT                A timeout occurred while waiting for the SCSI
+                                     Request Packet to execute.  See HostAdapterStatus,
+                                     TargetStatus, SenseDataLength, and SenseData in that
+                                     order for additional status information.
+  @retval EFI_INVALID_PARAMETER      The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -395,6 +425,10 @@ ScsiModeSense10Command (
   If HostAdapterStatus is NULL, then ASSERT().
   If TargetStatus is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]       ScsiIo               A pointer to SCSI IO protocol.
   @param[in]       Timeout              The length of timeout period.
   @param[in, out]  SenseData            A pointer to output sense data.
@@ -409,6 +443,7 @@ ScsiModeSense10Command (
   @retval EFI_UNSUPPORTED               The command described by the SCSI Request Packet is not supported by
                                         the SCSI initiator(i.e., SCSI  Host Controller)
   @retval EFI_TIMEOUT                   A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval EFI_INVALID_PARAMETER         The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -436,6 +471,14 @@ ScsiRequestSenseCommand (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -446,16 +489,17 @@ ScsiRequestSenseCommand (
   @param[in, out] DataLength           The length of data buffer.
   @param[in]      Pmi                  Partial medium indicator.
 
-  @retval  EFI_SUCCESS           Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE   The SCSI Request Packet was executed, but the entire
-                                 DataBuffer could not be transferred. The actual
-                                 number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY         The SCSI Request Packet could not be sent because
-                                 there are too many SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR      A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED       The command described by the SCSI Request Packet
-                                 is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT           A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire
+                                       DataBuffer could not be transferred. The actual
+                                       number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because
+                                       there are too many SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet
+                                       is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -486,6 +530,14 @@ ScsiReadCapacityCommand (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -496,16 +548,17 @@ ScsiReadCapacityCommand (
   @param[in, out] DataLength           The length of data buffer.
   @param[in]      Pmi                  Partial medium indicator.
 
-  @retval  EFI_SUCCESS           Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE   The SCSI Request Packet was executed, but the entire
-                                 DataBuffer could not be transferred. The actual
-                                 number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY         The SCSI Request Packet could not be sent because
-                                 there are too many SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR      A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED       The command described by the SCSI Request Packet
-                                 is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT           A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire
+                                       DataBuffer could not be transferred. The actual
+                                       number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because
+                                       there are too many SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet
+                                       is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -537,6 +590,13 @@ ScsiReadCapacity16Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
@@ -549,15 +609,16 @@ ScsiReadCapacity16Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -590,6 +651,14 @@ ScsiRead10Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               SCSI IO Protocol to use
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -601,15 +670,16 @@ ScsiRead10Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -641,6 +711,13 @@ ScsiWrite10Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
@@ -653,15 +730,16 @@ ScsiWrite10Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -694,6 +772,14 @@ ScsiRead16Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               SCSI IO Protocol to use
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -705,15 +791,16 @@ ScsiRead16Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          Command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
index 8a073db5f3ab..89f261777bb6 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
@@ -1,7 +1,7 @@
 /** @file
   UEFI SCSI Library implementation
 
-  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials                          
   are licensed and made available under the terms and conditions of the BSD License         
   which accompanies this distribution.  The full text of the license may be found at        
@@ -42,6 +42,9 @@
   If HostAdapterStatus is NULL, then ASSERT().
   If TargetStatus is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]     ScsiIo             A pointer to the SCSI I/O Protocol instance
                                     for the specific SCSI target.
@@ -71,27 +74,28 @@
                                     Protocol in the UEFI Specification for details on
                                     the possible return values. 
 
-  @retval EFI_SUCCESS          The command was executed successfully.
-                               See HostAdapterStatus, TargetStatus, SenseDataLength,
-                               and SenseData in that order for additional status
-                               information.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because
-                               there are too many SCSI Command Packets already
-                               queued. The SCSI Request Packet was not sent, so
-                               no additional status information is available.
-                               The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send
-                               SCSI Request Packet.  See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that
-                               order for additional status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet
-                               is not supported by the SCSI initiator(i.e., SCSI
-                               Host Controller). The SCSI Request Packet was not
-                               sent, so no additional status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS               The command was executed successfully.
+                                    See HostAdapterStatus, TargetStatus, SenseDataLength,
+                                    and SenseData in that order for additional status
+                                    information.
+  @retval EFI_NOT_READY             The SCSI Request Packet could not be sent because
+                                    there are too many SCSI Command Packets already
+                                    queued. The SCSI Request Packet was not sent, so
+                                    no additional status information is available.
+                                    The caller may retry again later.
+  @retval EFI_DEVICE_ERROR          A device error occurred while attempting to send
+                                    SCSI Request Packet.  See HostAdapterStatus,
+                                    TargetStatus, SenseDataLength, and SenseData in that
+                                    order for additional status information.
+  @retval EFI_UNSUPPORTED           The command described by the SCSI Request Packet
+                                    is not supported by the SCSI initiator(i.e., SCSI
+                                    Host Controller). The SCSI Request Packet was not
+                                    sent, so no additional status information is available.
+  @retval EFI_TIMEOUT               A timeout occurred while waiting for the SCSI Request
+                                    Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                    SenseDataLength, and SenseData in that order for
+                                    additional status information.
+  @retval EFI_INVALID_PARAMETER     The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -153,6 +157,14 @@ ScsiTestUnitReadyCommand (
   If TargetStatus is NULL, then ASSERT().
   If InquiryDataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If InquiryDataLength is non-zero and InquiryDataBuffer is not NULL, InquiryDataBuffer
+  must meet buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
   @param[in]      ScsiIo                 A pointer to the SCSI I/O Protocol instance
                                          for the specific SCSI target.
   @param[in]      Timeout                The timeout in 100 ns units to use for the
@@ -197,28 +209,29 @@ ScsiTestUnitReadyCommand (
   @param[in]      PageCode               The page code of the vital product data.
                                          It's ignored if EnableVitalProductData is FALSE.
 
-  @retval EFI_SUCCESS          The command executed successfully. See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that order
-                               for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire
-                               InquiryDataBuffer could not be transferred. The actual
-                               number of bytes transferred is returned in InquiryDataLength.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because there
-                               are too many SCSI Command Packets already queued.
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available. The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI
-                               Request Packet.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for additional
-                               status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not
-                               supported by the SCSI initiator(i.e., SCSI  Host Controller).
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS                    The command executed successfully. See HostAdapterStatus,
+                                         TargetStatus, SenseDataLength, and SenseData in that order
+                                         for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE            The SCSI Request Packet was executed, but the entire
+                                         InquiryDataBuffer could not be transferred. The actual
+                                         number of bytes transferred is returned in InquiryDataLength.
+  @retval EFI_NOT_READY                  The SCSI Request Packet could not be sent because there
+                                         are too many SCSI Command Packets already queued.
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available. The caller may retry again later.
+  @retval EFI_DEVICE_ERROR               A device error occurred while attempting to send SCSI
+                                         Request Packet.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for additional
+                                         status information.
+  @retval EFI_UNSUPPORTED                The command described by the SCSI Request Packet is not
+                                         supported by the SCSI initiator(i.e., SCSI  Host Controller).
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available.
+  @retval EFI_TIMEOUT                    A timeout occurred while waiting for the SCSI Request
+                                         Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for
+                                         additional status information.
+  @retval EFI_INVALID_PARAMETER          The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -293,6 +306,14 @@ ScsiInquiryCommandEx (
   If TargetStatus is NULL, then ASSERT().
   If InquiryDataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If InquiryDataLength is non-zero and InquiryDataBuffer is not NULL, InquiryDataBuffer
+  must meet buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
   @param[in]      ScsiIo                 A pointer to the SCSI I/O Protocol instance
                                          for the specific SCSI target.
   @param[in]      Timeout                The timeout in 100 ns units to use for the
@@ -335,28 +356,29 @@ ScsiInquiryCommandEx (
                                          If FALSE, then the standard inquiry data is
                                          returned in InquiryDataBuffer. 
 
-  @retval EFI_SUCCESS          The command executed successfully. See HostAdapterStatus,
-                               TargetStatus, SenseDataLength, and SenseData in that order
-                               for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire
-                               InquiryDataBuffer could not be transferred. The actual
-                               number of bytes transferred is returned in InquiryDataLength.
-  @retval EFI_NOT_READY        The SCSI Request Packet could not be sent because there
-                               are too many SCSI Command Packets already queued.
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available. The caller may retry again later.
-  @retval EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI
-                               Request Packet.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for additional
-                               status information.
-  @retval EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not
-                               supported by the SCSI initiator(i.e., SCSI  Host Controller).
-                               The SCSI Request Packet was not sent, so no additional
-                               status information is available.
-  @retval EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request
-                               Packet to execute.  See HostAdapterStatus, TargetStatus,
-                               SenseDataLength, and SenseData in that order for
-                               additional status information.
+  @retval EFI_SUCCESS                    The command was executed successfully. See HostAdapterStatus,
+                                         TargetStatus, SenseDataLength, and SenseData in that order
+                                         for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE            The SCSI Request Packet was executed, but the entire
+                                         InquiryDataBuffer could not be transferred. The actual
+                                         number of bytes transferred is returned in InquiryDataLength.
+  @retval EFI_NOT_READY                  The SCSI Request Packet could not be sent because there
+                                         are too many SCSI Command Packets already queued.
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available. The caller may retry again later.
+  @retval EFI_DEVICE_ERROR               A device error occurred while attempting to send SCSI
+                                         Request Packet.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for additional
+                                         status information.
+  @retval EFI_UNSUPPORTED                The command described by the SCSI Request Packet is not
+                                         supported by the SCSI initiator(i.e., SCSI  Host Controller).
+                                         The SCSI Request Packet was not sent, so no additional
+                                         status information is available.
+  @retval EFI_TIMEOUT                    A timeout occurred while waiting for the SCSI Request
+                                         Packet to execute.  See HostAdapterStatus, TargetStatus,
+                                         SenseDataLength, and SenseData in that order for
+                                         additional status information.
+  @retval EFI_INVALID_PARAMETER          The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -401,6 +423,13 @@ ScsiInquiryCommand (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo             A pointer to the SCSI I/O Protocol instance
                                      for the specific SCSI target.
@@ -442,30 +471,31 @@ ScsiInquiryCommand (
   @param[in]      PageControl        Specifies the PC field of the CDB for this SCSI Command. 
   @param[in]      PageCode           Specifies the Page Control field of the CDB for this SCSI Command. 
 
-  @retval EFI_SUCCESS               The command executed successfully.
-                                    See HostAdapterStatus, TargetStatus, SenseDataLength,
-                                    and SenseData in that order for additional status information.
-  @retval EFI_BAD_BUFFER_SIZE       The SCSI Request Packet was executed, but the
-                                    entire DataBuffer could not be transferred.
-                                    The actual number of bytes transferred is returned
-                                    in DataLength.
-  @retval EFI_NOT_READY             The SCSI Request Packet could not be sent because
-                                    there are too many SCSI Command Packets already queued.
-                                    The SCSI Request Packet was not sent, so no additional
-                                    status information is available.  The caller may retry
-                                    again later.
-  @retval EFI_DEVICE_ERROR          A device error occurred while attempting to send
-                                    SCSI Request Packet.  See HostAdapterStatus, TargetStatus,
-                                    SenseDataLength, and SenseData in that order for
-                                    additional status information.
-  @retval EFI_UNSUPPORTED           The command described by the SCSI Request Packet
-                                    is not supported by the SCSI initiator(i.e., SCSI
-                                    Host Controller). The SCSI Request Packet was not
-                                    sent, so no additional status information is available.
-  @retval EFI_TIMEOUT               A timeout occurred while waiting for the SCSI
-                                    Request Packet to execute.  See HostAdapterStatus,
-                                    TargetStatus, SenseDataLength, and SenseData in that
-                                    order for additional status information.
+  @retval EFI_SUCCESS                The command was executed successfully.
+                                     See HostAdapterStatus, TargetStatus, SenseDataLength,
+                                     and SenseData in that order for additional status information.
+  @retval EFI_BAD_BUFFER_SIZE        The SCSI Request Packet was executed, but the
+                                     entire DataBuffer could not be transferred.
+                                     The actual number of bytes transferred is returned
+                                     in DataLength.
+  @retval EFI_NOT_READY              The SCSI Request Packet could not be sent because
+                                     there are too many SCSI Command Packets already queued.
+                                     The SCSI Request Packet was not sent, so no additional
+                                     status information is available.  The caller may retry
+                                     again later.
+  @retval EFI_DEVICE_ERROR           A device error occurred while attempting to send
+                                     SCSI Request Packet.  See HostAdapterStatus, TargetStatus,
+                                     SenseDataLength, and SenseData in that order for
+                                     additional status information.
+  @retval EFI_UNSUPPORTED            The command described by the SCSI Request Packet
+                                     is not supported by the SCSI initiator(i.e., SCSI
+                                     Host Controller). The SCSI Request Packet was not
+                                     sent, so no additional status information is available.
+  @retval EFI_TIMEOUT                A timeout occurred while waiting for the SCSI
+                                     Request Packet to execute.  See HostAdapterStatus,
+                                     TargetStatus, SenseDataLength, and SenseData in that
+                                     order for additional status information.
+  @retval EFI_INVALID_PARAMETER      The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -543,6 +573,10 @@ ScsiModeSense10Command (
   If HostAdapterStatus is NULL, then ASSERT().
   If TargetStatus is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]       ScsiIo               A pointer to SCSI IO protocol.
   @param[in]       Timeout              The length of timeout period.
   @param[in, out]  SenseData            A pointer to output sense data.
@@ -550,13 +584,14 @@ ScsiModeSense10Command (
   @param[out]      HostAdapterStatus    The status of Host Adapter.
   @param[out]      TargetStatus         The status of the target.
 
-  @retval EFI_SUCCESS                   The command executed successfully.
+  @retval EFI_SUCCESS                   Command is executed successfully.
   @retval EFI_NOT_READY                 The SCSI Request Packet could not be sent because there are
                                         too many SCSI Command Packets already queued.
   @retval EFI_DEVICE_ERROR              A device error occurred while attempting to send SCSI Request Packet.
   @retval EFI_UNSUPPORTED               The command described by the SCSI Request Packet is not supported by
                                         the SCSI initiator(i.e., SCSI  Host Controller)
   @retval EFI_TIMEOUT                   A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval EFI_INVALID_PARAMETER         The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -620,6 +655,14 @@ ScsiRequestSenseCommand (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -628,18 +671,19 @@ ScsiRequestSenseCommand (
   @param[out]     TargetStatus         The status of the target.
   @param[in, out] DataBuffer           A pointer to a data buffer.
   @param[in, out] DataLength           The length of data buffer.
-  @param[in]      Pmi                  A partial medium indicator.
-
-  @retval  EFI_SUCCESS           The command executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE   The SCSI Request Packet was executed, but the entire
-                                 DataBuffer could not be transferred. The actual
-                                 number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY         The SCSI Request Packet could not be sent because
-                                 there are too many SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR      A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED       The command described by the SCSI Request Packet
-                                 is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT           A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @param[in]      Pmi                  Partial medium indicator.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire
+                                       DataBuffer could not be transferred. The actual
+                                       number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because
+                                       there are too many SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet
+                                       is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -715,6 +759,14 @@ ScsiReadCapacityCommand (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -725,16 +777,17 @@ ScsiReadCapacityCommand (
   @param[in, out] DataLength           The length of data buffer.
   @param[in]      Pmi                  Partial medium indicator.
 
-  @retval  EFI_SUCCESS           The command executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE   The SCSI Request Packet was executed, but the entire
-                                 DataBuffer could not be transferred. The actual
-                                 number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY         The SCSI Request Packet could not be sent because
-                                 there are too many SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR      A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED       The command described by the SCSI Request Packet
-                                 is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT           A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire
+                                       DataBuffer could not be transferred. The actual
+                                       number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because
+                                       there are too many SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet
+                                       is not supported by the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -813,6 +866,13 @@ ScsiReadCapacity16Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
@@ -825,15 +885,16 @@ ScsiReadCapacity16Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          The command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -905,6 +966,14 @@ ScsiRead10Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               SCSI IO Protocol to use
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -916,15 +985,16 @@ ScsiRead10Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          The command executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -995,6 +1065,13 @@ ScsiWrite10Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
 
   @param[in]      ScsiIo               A pointer to SCSI IO protocol.
   @param[in]      Timeout              The length of timeout period.
@@ -1007,15 +1084,16 @@ ScsiWrite10Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          The command executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS
@@ -1087,6 +1165,14 @@ ScsiRead16Command (
   If TargetStatus is NULL, then ASSERT().
   If DataLength is NULL, then ASSERT().
 
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet buffer
+  alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise EFI_INVALID_PARAMETER
+  gets returned.
+
   @param[in]      ScsiIo               SCSI IO Protocol to use
   @param[in]      Timeout              The length of timeout period.
   @param[in, out] SenseData            A pointer to output sense data.
@@ -1098,15 +1184,16 @@ ScsiRead16Command (
   @param[in]      StartLba             The start address of LBA.
   @param[in]      SectorSize           The number of contiguous logical blocks of data that shall be transferred.
 
-  @retval  EFI_SUCCESS          The command is executed successfully.
-  @retval  EFI_BAD_BUFFER_SIZE  The SCSI Request Packet was executed, but the entire DataBuffer could
-                                not be transferred. The actual number of bytes transferred is returned in DataLength.
-  @retval  EFI_NOT_READY        The SCSI Request Packet could not be sent because there are too many 
-                                SCSI Command Packets already queued.
-  @retval  EFI_DEVICE_ERROR     A device error occurred while attempting to send SCSI Request Packet.
-  @retval  EFI_UNSUPPORTED      The command described by the SCSI Request Packet is not supported by 
-                                the SCSI initiator(i.e., SCSI  Host Controller)
-  @retval  EFI_TIMEOUT          A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed, but the entire DataBuffer could
+                                       not be transferred. The actual number of bytes transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be sent because there are too many
+                                       SCSI Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI Request Packet is not supported by
+                                       the SCSI initiator(i.e., SCSI  Host Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet are invalid.
 
 **/
 EFI_STATUS

From 21170d1fba4d45d16ddb03e331da704ec0d44266 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Fri, 11 Sep 2015 00:52:31 +0000
Subject: [PATCH 027/525] MdeModulePkg: PXE Driver's LoadFile protocol should
 check FilePath

PXE driver's LoadFile protocol should check the input parameter
FilePath to see whether it's a supported device path.If not,
it should return invalid parameter, do not continue PXE boot.

(Sync patch r18435 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18440 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c | 4 ++++
 MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.h | 1 +
 2 files changed, 5 insertions(+)

diff --git a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
index 4dd7944e6a9a..72923f1b38a4 100644
--- a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
+++ b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
@@ -2776,6 +2776,10 @@ EfiPxeLoadFile (
   UINT64                      TmpBufSize;
   BOOLEAN                     MediaPresent;
 
+  if (FilePath == NULL || !IsDevicePathEnd (FilePath)) {
+    return EFI_INVALID_PARAMETER;
+  }
+  
   Private         = PXEBC_PRIVATE_DATA_FROM_LOADFILE (This);
   PxeBc           = &Private->PxeBc;
   NewMakeCallback = FALSE;
diff --git a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.h b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.h
index 6e88deae47f3..ce8d8add3fff 100644
--- a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.h
+++ b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.h
@@ -33,6 +33,7 @@ typedef struct _PXEBC_PRIVATE_DATA  PXEBC_PRIVATE_DATA;
 #include <Protocol/Ip4Config2.h>
 
 #include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
 #include <Library/BaseMemoryLib.h>
 #include <Library/MemoryAllocationLib.h>
 #include <Library/UefiDriverEntryPoint.h>

From a687f448f938f0660356f3c07e393f93ef7166c4 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Fri, 11 Sep 2015 00:52:51 +0000
Subject: [PATCH 028/525] NetworkPkg: PXE Driver's LoadFile protocol should
 check FilePath

PXE driver's LoadFile protocol should check the input parameter
FilePath to see whether it's a supported device path.If not,
it should return invalid parameter, do not continue PXE boot.

(Sync patch r18436 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18441 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c b/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
index cdcf2f0d3ead..367a1356abcc 100644
--- a/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
+++ b/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
@@ -2328,6 +2328,10 @@ EfiPxeLoadFile (
   EFI_STATUS                  Status;
   BOOLEAN                     MediaPresent;
 
+  if (FilePath == NULL || !IsDevicePathEnd (FilePath)) {
+    return EFI_INVALID_PARAMETER;
+  }
+  
   VirtualNic = PXEBC_VIRTUAL_NIC_FROM_LOADFILE (This);
   Private    = VirtualNic->Private;
   PxeBc      = &Private->PxeBc;

From e5a9019a501bdde2fa22f5ca4d5ac651dd2d89cf Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 11 Sep 2015 03:13:01 +0000
Subject: [PATCH 029/525] ShellPkg: Fix 'for' command fail with multiple
 fields.

When multiple fields are found in 'for' command return invalid parameters error.

(Sync patch r18416 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18442 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellLevel1CommandsLib/For.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ShellPkg/Library/UefiShellLevel1CommandsLib/For.c b/ShellPkg/Library/UefiShellLevel1CommandsLib/For.c
index 2ecc5cd9ef48..cbf05170135d 100644
--- a/ShellPkg/Library/UefiShellLevel1CommandsLib/For.c
+++ b/ShellPkg/Library/UefiShellLevel1CommandsLib/For.c
@@ -438,6 +438,11 @@ ShellCommandRunFor (
         gEfiShellParametersProtocol->Argv[2]) == 0) {
       for (LoopVar = 0x3 ; LoopVar < gEfiShellParametersProtocol->Argc ; LoopVar++) {
         ASSERT((ArgSet == NULL && ArgSize == 0) || (ArgSet != NULL));
+        if (StrStr (gEfiShellParametersProtocol->Argv[LoopVar], L")") != NULL &&
+            (LoopVar + 1) < gEfiShellParametersProtocol->Argc
+           ) {
+          return (SHELL_INVALID_PARAMETER);
+        }
         if (ArgSet == NULL) {
 //        ArgSet = StrnCatGrow(&ArgSet, &ArgSize, L"\"", 0);
         } else {

From a565ec4117d31256151d8ce343a7c943c97bae40 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:38:43 +0000
Subject: [PATCH 030/525] NetworkPkg: Enlarge receive block size of HTTP boot
 driver.

HTTP boot driver uses block size of 1024 when receiving HTTP message body,
but typically the MTU of Ethernet is 1500 bytes so it makes 1 TCP segment data
split into 2 Http.Response call. This patch enlarges the block size to avoid
this issue.

(Sync patch r18447 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18457 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpBootDxe/HttpBootClient.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.h b/NetworkPkg/HttpBootDxe/HttpBootClient.h
index 2dfafab93681..06b91098fc38 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.h
@@ -16,7 +16,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define __EFI_HTTP_BOOT_HTTP_H__
 
 #define HTTP_BOOT_REQUEST_TIMEOUT            5000      // 5 seconds in uints of millisecond.
-#define HTTP_BOOT_BLOCK_SIZE                 1024
+#define HTTP_BOOT_BLOCK_SIZE                 1500
 
 #define HTTP_FIELD_NAME_USER_AGENT           "User-Agent"
 #define HTTP_FIELD_NAME_HOST                 "Host"

From 1e4de20d3a2273df954f061561a43e2def3d313b Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:39:05 +0000
Subject: [PATCH 031/525] NetworkPkg: Update cache management in HTTP boot
 driver.

The original HTTP boot driver always save the received message body in its cache,
it bring a large of memory allocation during HTTP download. This patch updates
the HTTP boot driver to only cache data when caller doesn't provide a buffer for
download (which is usually used when caller want to get the required buffer size).

(Sync patch r18448 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18458 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpBootDxe/HttpBootClient.c | 63 ++++++++++++++-----------
 1 file changed, 35 insertions(+), 28 deletions(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.c b/NetworkPkg/HttpBootDxe/HttpBootClient.c
index 3b4afc396f01..5669c5f37ce1 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.c
@@ -458,22 +458,6 @@ HttpBootGetBootFileCallback (
   }
 
   CallbackData = (HTTP_BOOT_CALLBACK_DATA *) Context;
-
-  //
-  // Save the data into cache list.
-  //
-  NewEntityData = AllocatePool (sizeof (HTTP_BOOT_ENTITY_DATA));
-  if (NewEntityData == NULL) {
-    return EFI_OUT_OF_RESOURCES;
-  }
-  if (CallbackData->NewBlock) {
-    NewEntityData->Block = CallbackData->Block;
-    CallbackData->Block = NULL;
-  }
-  NewEntityData->DataLength = Length;
-  NewEntityData->DataStart  = (UINT8*) Data;
-  InsertTailList (&CallbackData->Cache->EntityDataList, &NewEntityData->Link);
-
   //
   // Copy data if caller has provided a buffer.
   //
@@ -486,6 +470,22 @@ HttpBootGetBootFileCallback (
     CallbackData->CopyedSize += MIN (Length, CallbackData->BufferSize - CallbackData->CopyedSize);
   }
 
+  //
+  // The caller doesn't provide a buffer, save the block into cache list.
+  //
+  if (CallbackData->Cache != NULL) {
+    NewEntityData = AllocatePool (sizeof (HTTP_BOOT_ENTITY_DATA));
+    if (NewEntityData == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    if (CallbackData->NewBlock) {
+      NewEntityData->Block = CallbackData->Block;
+      CallbackData->Block = NULL;
+    }
+    NewEntityData->DataLength = Length;
+    NewEntityData->DataStart  = (UINT8*) Data;
+    InsertTailList (&CallbackData->Cache->EntityDataList, &NewEntityData->Link);
+  }
   return EFI_SUCCESS;
 }
 
@@ -566,10 +566,10 @@ HttpBootGetBootFile (
   //
 
   //
-  // 1. Create a temp cache item for the requested URI.
+  // 1. Create a temp cache item for the requested URI if caller doesn't provide buffer.
   //
   Cache = NULL;
-  if (!HeaderOnly) {
+  if ((!HeaderOnly) && (*BufferSize == 0)) {
     Cache = AllocateZeroPool (sizeof (HTTP_BOOT_CACHE_CONTENT));
     if (Cache == NULL) {
       Status = EFI_OUT_OF_RESOURCES;
@@ -659,7 +659,7 @@ HttpBootGetBootFile (
   //
   // 2.3 Record the request info in a temp cache item.
   //
-  if (!HeaderOnly) {
+  if (Cache != NULL) {
     Cache->RequestData = RequestData;
   }
 
@@ -703,7 +703,7 @@ HttpBootGetBootFile (
   //
   // 3.2 Cache the response header.
   //
-  if (!HeaderOnly) {
+  if (Cache != NULL) {
     Cache->ResponseData = ResponseData;
   }
   
@@ -733,17 +733,26 @@ HttpBootGetBootFile (
   //
   // 3.4 Continue to receive and parse message-body if needed.
   //
+  Block = NULL;
   if (!HeaderOnly) {
     ZeroMem (&ResponseBody, sizeof (HTTP_IO_RESOPNSE_DATA));
     while (!HttpIsMessageComplete (Parser)) {
       //
-      // Allocate a new block to hold the message-body.
+      // Allocate a block to hold the message-body, if caller doesn't provide
+      // a buffer, the block will be cached and we will allocate a new one here.
       //
-      Block = AllocatePool (HTTP_BOOT_BLOCK_SIZE);
-      if (Block == NULL) {
-        Status = EFI_OUT_OF_RESOURCES;
-        goto ERROR_6;
+      if (Block == NULL || Context.BufferSize == 0) {
+        Block = AllocatePool (HTTP_BOOT_BLOCK_SIZE);
+        if (Block == NULL) {
+          Status = EFI_OUT_OF_RESOURCES;
+          goto ERROR_6;
+        }
+        Context.NewBlock = TRUE;
+        Context.Block = Block;
+      } else {
+        Context.NewBlock = FALSE;
       }
+
       ResponseBody.Body       = (CHAR8*) Block;
       ResponseBody.BodyLength = HTTP_BOOT_BLOCK_SIZE;
       Status = HttpIoRecvResponse (
@@ -758,8 +767,6 @@ HttpBootGetBootFile (
       //
       // Parse the new received block of the message-body, the block will be saved in cache.
       //
-      Context.NewBlock = TRUE;
-      Context.Block    = Block;
       Status = HttpParseMessageBody (
                  Parser,
                  ResponseBody.BodyLength,
@@ -787,7 +794,7 @@ HttpBootGetBootFile (
   //
   // 4. Save the cache item to driver's cache list and return.
   //
-  if (!HeaderOnly) {
+  if (Cache != NULL) {
     Cache->EntityLength = ContentLength;
     InsertTailList (&Private->CacheList, &Cache->Link);
   }

From d277707a56041fad7a99dd345e9d151b87bf0519 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:39:28 +0000
Subject: [PATCH 032/525] NetworkPkg: Avoid memory allocation for each HTTP
 message exchange.

This patch updates the HTTP driver to use a shared buffer for URL parsing to
avoid memory allocation for each HTTP request.

(Sync patch r18449 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18459 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c  | 19 ++++++++++---------
 NetworkPkg/HttpDxe/HttpProto.c | 11 +++++++++++
 NetworkPkg/HttpDxe/HttpProto.h |  4 ++++
 3 files changed, 25 insertions(+), 9 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index dc06b9855c27..c5b2be430e29 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -224,6 +224,7 @@ EfiHttpRequest (
   BOOLEAN                       ReConfigure;
   CHAR8                         *RequestStr;
   CHAR8                         *Url;
+  UINTN                         UrlLen;
   CHAR16                        *HostNameStr;
   HTTP_TOKEN_WRAP               *Wrap;
   HTTP_TCP_TOKEN_WRAP           *TcpWrap;
@@ -283,10 +284,15 @@ EfiHttpRequest (
   //
   // Parse the URI of the remote host.
   //
-  Url = AllocatePool (StrLen (Request->Url) + 1);
-  if (Url == NULL) {
-    return EFI_OUT_OF_RESOURCES;
-  }
+  UrlLen = StrLen (Request->Url) + 1;
+  if (UrlLen > HTTP_URL_BUFFER_LEN) {
+    Url = AllocateZeroPool (UrlLen);
+    if (Url == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    FreePool (HttpInstance->Url);
+    HttpInstance->Url = Url;    
+  }  
 
   UnicodeStrToAsciiStr (Request->Url, Url);
   UrlParser = NULL;
@@ -347,7 +353,6 @@ EfiHttpRequest (
 
         Wrap->TcpWrap.Method = Request->Method;
 
-        FreePool (Url);
         FreePool (HostName);
         
         //
@@ -480,7 +485,6 @@ EfiHttpRequest (
     goto Error4;
   }
 
-  FreePool (Url);
   if (HostName != NULL) {
     FreePool (HostName);
   }
@@ -520,9 +524,6 @@ EfiHttpRequest (
   }
 
 Error1:
-  if (Url != NULL) {
-    FreePool (Url);
-  }
   if (HostName != NULL) {
     FreePool (HostName);
   }
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index e8ce9879f309..99f907e10c7f 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -431,6 +431,12 @@ HttpInitProtocol (
     goto ON_ERROR;
   }
 
+  HttpInstance->Url = AllocateZeroPool (HTTP_URL_BUFFER_LEN);
+  if (HttpInstance->Url == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_ERROR;
+  }
+
   NetMapInit (&HttpInstance->TxTokens);
   NetMapInit (&HttpInstance->RxTokens);
 
@@ -496,6 +502,11 @@ HttpCleanProtocol (
     HttpInstance->MsgParser = NULL;
   }
 
+  if (HttpInstance->Url != NULL) {
+    FreePool (HttpInstance->Url);
+    HttpInstance->Url = NULL;
+  }
+
   NetMapClean (&HttpInstance->TxTokens);
   NetMapClean (&HttpInstance->RxTokens);
 
diff --git a/NetworkPkg/HttpDxe/HttpProto.h b/NetworkPkg/HttpDxe/HttpProto.h
index ca4b7b60353d..c37b80c8ec74 100644
--- a/NetworkPkg/HttpDxe/HttpProto.h
+++ b/NetworkPkg/HttpDxe/HttpProto.h
@@ -51,6 +51,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define HTTP_KEEP_ALIVE_TIME         7200
 #define HTTP_KEEP_ALIVE_INTERVAL     30
 
+#define HTTP_URL_BUFFER_LEN          4096
+
 typedef struct _HTTP_SERVICE {
   UINT32                        Signature;
   EFI_SERVICE_BINDING_PROTOCOL  ServiceBinding;
@@ -120,6 +122,8 @@ typedef struct _HTTP_PROTOCOL {
 
   NET_MAP                       TxTokens;
   NET_MAP                       RxTokens;
+
+  CHAR8                         *Url;
 } HTTP_PROTOCOL;
 
 typedef struct {

From 07e11eedfc6edff2a03df5105e7a8ae9946c16f6 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:39:48 +0000
Subject: [PATCH 033/525] NetworkPkg: RxToken event not closed in
 Http.Response().

This patch contains a bug fix in HTTP driver that the RxToken is not closed,
this is one of the main reasons which lower the HTTP download speed.

(Sync patch r18450 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18460 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpProto.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 99f907e10c7f..9b06e24bed0e 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -104,6 +104,7 @@ HttpTcpReceiveNotify (
   }
 
   Wrap = (HTTP_TOKEN_WRAP *) Context;
+  gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
   if (EFI_ERROR (Wrap->TcpWrap.RxToken.CompletionToken.Status)) {
     return ;
   }

From 38ada0e8aff0f447dc98a1f37af40f0a65b0fb59 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:40:12 +0000
Subject: [PATCH 034/525] NetworkPkg: Update Http driver to use DPC mechanism.

This patch updates the HttpDxe driver to use the DPC mechanism to avoid long
time delay when single event.

(Sync patch r18451 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18461 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpDriver.h |  2 +-
 NetworkPkg/HttpDxe/HttpDxe.inf  |  1 +
 NetworkPkg/HttpDxe/HttpImpl.c   |  9 +++++-
 NetworkPkg/HttpDxe/HttpProto.c  | 54 ++++++++++++++++++++++++++++-----
 4 files changed, 56 insertions(+), 10 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpDriver.h b/NetworkPkg/HttpDxe/HttpDriver.h
index d95b05b63492..eea8d5169e71 100644
--- a/NetworkPkg/HttpDxe/HttpDriver.h
+++ b/NetworkPkg/HttpDxe/HttpDriver.h
@@ -28,7 +28,7 @@
 #include <Library/DebugLib.h>
 #include <Library/NetLib.h>
 #include <Library/HttpLib.h>
-#include <Library/TcpIoLib.h>
+#include <Library/DpcLib.h>
 
 //
 // UEFI Driver Model Protocols
diff --git a/NetworkPkg/HttpDxe/HttpDxe.inf b/NetworkPkg/HttpDxe/HttpDxe.inf
index e8117006d6e7..0d3bd00cf7b7 100644
--- a/NetworkPkg/HttpDxe/HttpDxe.inf
+++ b/NetworkPkg/HttpDxe/HttpDxe.inf
@@ -48,6 +48,7 @@
   DebugLib
   NetLib
   HttpLib
+  DpcLib
 
 [Protocols]
   gEfiHttpServiceBindingProtocolGuid               ## BY_START
diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index c5b2be430e29..2b62dc5db299 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -502,6 +502,8 @@ EfiHttpRequest (
     goto Error5;    
   }
 
+  DispatchDpc ();
+
   return EFI_SUCCESS;
 
 Error5:
@@ -1330,6 +1332,7 @@ EfiHttpPoll (
   )
 {
   HTTP_PROTOCOL                 *HttpInstance;
+  EFI_STATUS                    Status;
 
   if (This == NULL) {
     return EFI_INVALID_PARAMETER;
@@ -1346,5 +1349,9 @@ EfiHttpPoll (
     return EFI_NOT_STARTED;
   }
 
-  return HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+  Status = HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+
+  DispatchDpc ();
+
+  return Status;
 }
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 9b06e24bed0e..8fbd45411064 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -38,20 +38,18 @@ HttpCommonNotify (
 /**
   The notify function associated with TxToken for Tcp4->Transmit().
 
-  @param[in]  Event   The event signaled.
   @param[in]  Context The context.
 
 **/
 VOID
 EFIAPI
-HttpTcpTransmitNotify (
-  IN EFI_EVENT  Event,
+HttpTcpTransmitNotifyDpc (
   IN VOID       *Context
   )
 {
   HTTP_TOKEN_WRAP          *Wrap;
 
-  if ((Event == NULL) || (Context == NULL)) {
+  if (Context == NULL) {
     return ;
   }
 
@@ -79,17 +77,36 @@ HttpTcpTransmitNotify (
 
 }
 
+/**
+  Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK.
+
+  @param  Event                 The receive event delivered to TCP for transmit.
+  @param  Context               Context for the callback.
+
+**/
+VOID
+EFIAPI
+HttpTcpTransmitNotify (
+  IN EFI_EVENT                Event,
+  IN VOID                     *Context
+  )
+{
+  //
+  // Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK
+  //
+  QueueDpc (TPL_CALLBACK, HttpTcpTransmitNotifyDpc, Context);
+}
+
+
 /**
   The notify function associated with RxToken for Tcp4->Receive ().
 
-  @param[in]  Event   The event signaled.
   @param[in]  Context The context.
 
 **/
 VOID
 EFIAPI
-HttpTcpReceiveNotify (
-  IN EFI_EVENT  Event,
+HttpTcpReceiveNotifyDpc (
   IN VOID       *Context
   )
 {
@@ -99,7 +116,7 @@ HttpTcpReceiveNotify (
   EFI_STATUS               Status;
   HTTP_PROTOCOL            *HttpInstance;
 
-  if ((Event == NULL) || (Context == NULL)) {
+  if (Context == NULL) {
     return ;
   }
 
@@ -173,6 +190,27 @@ HttpTcpReceiveNotify (
   FreePool (Wrap);
 }
 
+/**
+  Request HttpTcpReceiveNotifyDpc as a DPC at TPL_CALLBACK.
+
+  @param  Event                 The receive event delivered to TCP for receive.
+  @param  Context               Context for the callback.
+
+**/
+VOID
+EFIAPI
+HttpTcpReceiveNotify (
+  IN EFI_EVENT                Event,
+  IN VOID                     *Context
+  )
+{
+  //
+  // Request HttpTcpTransmitNotifyDpc as a DPC at TPL_CALLBACK
+  //
+  QueueDpc (TPL_CALLBACK, HttpTcpReceiveNotifyDpc, Context);
+}
+
+
 /**
   Create events for the TCP4 connection token and TCP4 close token.
 

From 43b3c498bda4f1e2c96772d1e1af956cabae6cf5 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Tue, 15 Sep 2015 05:40:43 +0000
Subject: [PATCH 035/525] ShellPkg: Fix Shell does not support ASCII pipe(|a).

(Sync patch r18452 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18462 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c | 36 +++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 11 deletions(-)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 78a64de19eae..03f5e4f05fe8 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1578,11 +1578,18 @@ RunSplitCommand(
     SHELL_FREE_NON_NULL(OurCommandLine);
     SHELL_FREE_NON_NULL(NextCommandLine);
     return (EFI_INVALID_PARAMETER);
-  } else if (NextCommandLine[0] != CHAR_NULL &&
-      NextCommandLine[0] == L'a' &&
-      NextCommandLine[1] == L' '
-     ){
+  } else if (NextCommandLine[0] == L'a' &&
+             (NextCommandLine[1] == L' ' || NextCommandLine[1] == CHAR_NULL)
+            ){
     CopyMem(NextCommandLine, NextCommandLine+1, StrSize(NextCommandLine) - sizeof(NextCommandLine[0]));
+    while (NextCommandLine[0] == L' ') {
+      CopyMem(NextCommandLine, NextCommandLine+1, StrSize(NextCommandLine) - sizeof(NextCommandLine[0]));
+    }
+    if (NextCommandLine[0] == CHAR_NULL) {
+      SHELL_FREE_NON_NULL(OurCommandLine);
+      SHELL_FREE_NON_NULL(NextCommandLine);
+      return (EFI_INVALID_PARAMETER);
+    }
     Unicode = FALSE;
   } else {
     Unicode = TRUE;
@@ -1884,24 +1891,31 @@ VerifySplit(
   EFI_STATUS    Status;
 
   //
-  // Verify up to the pipe or end character
+  // If this was the only item, then get out
   //
-  Status = IsValidSplit(CmdLine);
-  if (EFI_ERROR(Status)) {
-    return (Status);
+  if (!ContainsSplit(CmdLine)) {
+    return (EFI_SUCCESS);
   }
 
   //
-  // If this was the only item, then get out
+  // Verify up to the pipe or end character
   //
-  if (!ContainsSplit(CmdLine)) {
-    return (EFI_SUCCESS);
+  Status = IsValidSplit(CmdLine);
+  if (EFI_ERROR(Status)) {
+    return (Status);
   }
 
   //
   // recurse to verify the next item
   //
   TempSpot = FindFirstCharacter(CmdLine, L"|", L'^') + 1;
+  if (*TempSpot == L'a' && 
+      (*(TempSpot + 1) == L' ' || *(TempSpot + 1) == CHAR_NULL)
+     ) {
+    // If it's an ASCII pipe '|a'
+    TempSpot += 1;
+  }
+  
   return (VerifySplit(TempSpot));
 }
 

From 19af298bc451bef3661ccdc81dca1c8c6af93444 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:44:16 +0000
Subject: [PATCH 036/525] NetworkPkg: Correct the missed code in r18449.

The fix r18449 missed 1 line which will cause Http.Request() ASSERT. This patch
will correct this error.

(Sync patch r18453 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18463 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 2b62dc5db299..76c95b2bb66a 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -275,7 +275,6 @@ EfiHttpRequest (
     return EFI_ACCESS_DENIED;   
   }  
 
-  Url         = NULL;
   HostName    = NULL;
   Wrap        = NULL;
   HostNameStr = NULL;
@@ -284,6 +283,7 @@ EfiHttpRequest (
   //
   // Parse the URI of the remote host.
   //
+  Url = HttpInstance->Url;
   UrlLen = StrLen (Request->Url) + 1;
   if (UrlLen > HTTP_URL_BUFFER_LEN) {
     Url = AllocateZeroPool (UrlLen);

From 9f00fa9165ebc8da0cc604e7f475f3f2ad7735ca Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Tue, 15 Sep 2015 05:44:39 +0000
Subject: [PATCH 037/525] ShellPkg: Update the help information for 'setvar'
 command to follow Shell behavior.

Since Shell will remove the quotes in parameters, setvar cannot receive the quotes from ="ascii" or =L"unicode". User should add ^ to escape quotes in setvar data.

(Sync patch r18454 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18464 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib.uni            | Bin 140668 -> 140676 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index 167cacc70dc5fe582a8c3b4d47ed042f7994879c..e16175a6174fbd08275d14d88eaa385e42ae4781 100644
GIT binary patch
delta 40
tcmex!ilgN;N5d9IpSg^2)4k_1N&~6Xxs2UF>it|sNyfPC?DH5)+W|?A4;BCb

delta 51
zcmZoU&GF|HN5d9IpSjch<}yl6&zj5FC9cE}%HYfp%wWWz%TUZv!cfGJ$&km8zMX#_
HV`)18$NLY3


From 9a36457f943e1a758fdb4b39205022a55bf74cdc Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Tue, 15 Sep 2015 05:45:03 +0000
Subject: [PATCH 038/525] MdeModulePkg: Change the algorithm in SNP to use the
 first found BAR index.

The driver binding start function in SNP.c goes through all the BARs and get
the last BAR index for use. Theoretically it should work with all valid BARs,
but we got reports some device did always use the first valid BAR, so we change
the logic in SNP to use the first found BAR index instead of the last one.

(Sync patch r18455 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18465 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Network/SnpDxe/Snp.c | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Universal/Network/SnpDxe/Snp.c b/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
index a63dd10b296d..db5b6267a613 100644
--- a/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
+++ b/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of driver entry point and driver binding protocol.
 
-Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed
 and made available under the terms and conditions of the BSD License which
 accompanies this distribution. The full text of the license may be found at
@@ -273,6 +273,8 @@ SimpleNetworkDriverStart (
   PXE_STATFLAGS                             InitStatFlags;
   EFI_PCI_IO_PROTOCOL                       *PciIo;
   EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR         *BarDesc;
+  BOOLEAN                                   FoundIoBar;
+  BOOLEAN                                   FoundMemoryBar;
   
   DEBUG ((EFI_D_NET, "\nSnpNotifyNetworkInterfaceIdentifier()  "));
 
@@ -403,7 +405,7 @@ SimpleNetworkDriverStart (
   Snp->TxRxBuffer         = NULL;
  
   if (Nii->Revision >= EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL_REVISION) {
-  	Snp->IfNum = Nii->IfNum;
+    Snp->IfNum = Nii->IfNum;
 
   } else {
     Snp->IfNum = (UINT8) (Nii->IfNum & 0xFF);
@@ -463,6 +465,8 @@ SimpleNetworkDriverStart (
   //
   Snp->MemoryBarIndex = 0;
   Snp->IoBarIndex     = 1;
+  FoundMemoryBar      = FALSE;
+  FoundIoBar          = FALSE;
   for (BarIndex = 0; BarIndex < PCI_MAX_BAR; BarIndex++) {
     Status = PciIo->GetBarAttributes (
                       PciIo,
@@ -476,13 +480,19 @@ SimpleNetworkDriverStart (
       goto Error_DeleteSNP;
     }
 
-    if (BarDesc->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
+    if ((!FoundMemoryBar) && (BarDesc->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM)) {
       Snp->MemoryBarIndex = BarIndex;
-    } else if (BarDesc->ResType == ACPI_ADDRESS_SPACE_TYPE_IO) {
+      FoundMemoryBar      = TRUE;
+    } else if ((!FoundIoBar) && (BarDesc->ResType == ACPI_ADDRESS_SPACE_TYPE_IO)) {
       Snp->IoBarIndex = BarIndex;
+      FoundIoBar      = TRUE;
     }
 
     FreePool (BarDesc);
+
+    if (FoundMemoryBar && FoundIoBar) {
+      break;
+    }
   }
 
   Status = PxeStart (Snp);

From 737acfa88d985fb096a750288b9beff775369b11 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Tue, 15 Sep 2015 05:45:27 +0000
Subject: [PATCH 039/525] ShellPkg: Rename some functions in Dp to avoid build
 errors.

There are other libraries with similarly named functions that could be linked with the Shell

(Sync patch r18456 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18466 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiDpLib/DpInternal.h  | 5 +++--
 ShellPkg/Library/UefiDpLib/DpTrace.c     | 5 +++--
 ShellPkg/Library/UefiDpLib/DpUtilities.c | 7 ++++---
 3 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/ShellPkg/Library/UefiDpLib/DpInternal.h b/ShellPkg/Library/UefiDpLib/DpInternal.h
index c7d9a592fe71..9b8163aaa0f7 100644
--- a/ShellPkg/Library/UefiDpLib/DpInternal.h
+++ b/ShellPkg/Library/UefiDpLib/DpInternal.h
@@ -7,6 +7,7 @@
   DpUtilities.c, DpTrace.c, and DpProfile.c are included here.
 
   Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -96,7 +97,7 @@ IsPhase(
   
 **/
 VOID
-GetShortPdbFileName (
+DpGetShortPdbFileName (
   IN  CHAR8     *PdbFileName,
   OUT CHAR16    *UnicodeBuffer
   );
@@ -118,7 +119,7 @@ GetShortPdbFileName (
   
 **/
 VOID
-GetNameFromHandle (
+DpGetNameFromHandle (
   IN EFI_HANDLE Handle
   );
 
diff --git a/ShellPkg/Library/UefiDpLib/DpTrace.c b/ShellPkg/Library/UefiDpLib/DpTrace.c
index de1d45aa8b7d..cf8200c6f1a2 100644
--- a/ShellPkg/Library/UefiDpLib/DpTrace.c
+++ b/ShellPkg/Library/UefiDpLib/DpTrace.c
@@ -2,6 +2,7 @@
   Trace reporting for the Dp utility.
 
   Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -216,7 +217,7 @@ DumpAllTrace(
         // See if the Handle is in the HandleBuffer
         for (TIndex = 0; TIndex < (Size / sizeof(HandleBuffer[0])); TIndex++) {
           if (Measurement.Handle == HandleBuffer[TIndex]) {
-            GetNameFromHandle (HandleBuffer[TIndex]);
+            DpGetNameFromHandle (HandleBuffer[TIndex]);
             break;
           }
         }
@@ -582,7 +583,7 @@ ProcessHandles(
       // See if the Handle is in the HandleBuffer
       for (Index = 0; Index < (Size / sizeof(HandleBuffer[0])); Index++) {
         if (Measurement.Handle == HandleBuffer[Index]) {
-          GetNameFromHandle (HandleBuffer[Index]); // Name is put into mGaugeString
+          DpGetNameFromHandle (HandleBuffer[Index]); // Name is put into mGaugeString
           break;
         }
       }
diff --git a/ShellPkg/Library/UefiDpLib/DpUtilities.c b/ShellPkg/Library/UefiDpLib/DpUtilities.c
index 063eb658c896..5237459e5b00 100644
--- a/ShellPkg/Library/UefiDpLib/DpUtilities.c
+++ b/ShellPkg/Library/UefiDpLib/DpUtilities.c
@@ -2,6 +2,7 @@
   Utility functions used by the Dp application.
 
   Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -131,7 +132,7 @@ IsPhase(
   
 **/
 VOID
-GetShortPdbFileName (
+DpGetShortPdbFileName (
   IN  CHAR8     *PdbFileName,
   OUT CHAR16    *UnicodeBuffer
   )
@@ -188,7 +189,7 @@ GetShortPdbFileName (
 
 **/
 VOID
-GetNameFromHandle (
+DpGetNameFromHandle (
   IN EFI_HANDLE   Handle
   )
 {
@@ -236,7 +237,7 @@ GetNameFromHandle (
     PdbFileName = PeCoffLoaderGetPdbPointer (Image->ImageBase);
 
     if (PdbFileName != NULL) {
-      GetShortPdbFileName (PdbFileName, mGaugeString);
+      DpGetShortPdbFileName (PdbFileName, mGaugeString);
       return;
     }
   }

From a6c273bb633cca00c0fa0f79fbf95704a8fec5e9 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Tue, 15 Sep 2015 08:46:29 +0000
Subject: [PATCH 040/525] MdeModulePkg PiDxeS3BootScriptLib: Remove a hidden
 assumption.

What to do:
1. Remove a hidden assumption "No SMM driver writes BootScript between
SmmReadyToLock and S3SleepEntryCallback".
 1.1. Use SmmExitBootServices and SmmLegacyBoot notification to record
      AtRuntime flag.
 1.2. Use mBootScriptDataBootTimeGuid LockBox to save boot time boot
      script data to handle potential INSERT boot script at runtime in SMM.
2. Do not depend on OS to help restore ACPINvs data and use
EfiReservedMemoryType instead of EfiACPIMemoryNVS.
 2.1. Use mBootScriptSmmPrivateDataGuid LockBox to save boot script
      SMM private data with BackFromS3 = TRUE at runtime. S3 resume
      will help restore it to tell the Library the system is back
      from S3.

Why to do:
1. The hidden assumption "No SMM driver writes BootScript between
SmmReadyToLock and S3SleepEntryCallback" will cause confusion to
the library's consumer and block the usage of "SMM driver writes
BootScript after SmmReadyToLock". So Remove the assumption.
2. In original code, there might be a corner case that malicious
code patch ACPINvs boot TableLength field same as SMM boot script.
So that it can skip the table restore. The impact is that BootScript
in SMM may be overridden by malicious code.
--------------------
    CopyMem ((VOID*)&TableHeader, (VOID*)mS3BootScriptTablePtr->TableBase, sizeof(EFI_BOOT_SCRIPT_TABLE_HEADER));
    if (mS3BootScriptTablePtr->TableLength + sizeof(EFI_BOOT_SCRIPT_TERMINATE) != TableHeader.TableLength) { // TableLength is in NVS
      ......
      //
      // NOTE: We should NOT use TableHeader.TableLength, because it is already updated to be whole length.
      //
      mS3BootScriptTablePtr->TableLength = (UINT32)(mLockBoxLength - sizeof(EFI_BOOT_SCRIPT_TERMINATE)); ? This line can be skipped.
--------------------
So use EfiReservedMemoryType instead of EfiACPIMemoryNVS as the code
has been updated to not depend on OS to help restore ACPINvs data.

(Sync patch r18467 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18474 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PiDxeS3BootScriptLib/BootScriptSave.c     | 477 ++++++++++++------
 .../DxeS3BootScriptLib.inf                    |   4 +-
 .../InternalBootScriptLib.h                   |  17 +-
 MdeModulePkg/MdeModulePkg.dec                 |   8 +-
 MdeModulePkg/MdeModulePkg.uni                 | Bin 183916 -> 184014 bytes
 5 files changed, 345 insertions(+), 161 deletions(-)

diff --git a/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c b/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
index 586a205a532a..24c67984ca16 100644
--- a/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
+++ b/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
@@ -19,45 +19,111 @@
 
   Data structure usage:
 
-  +------------------------------+<-- PcdS3BootScriptTablePrivateDataPtr
+  +------------------------------+<------- PcdS3BootScriptTablePrivateDataPtr
+  | SCRIPT_TABLE_PRIVATE_DATA    |          (mS3BootScriptTablePtr, Before SmmReadyToLock)
+  |    TableBase                 |---      PcdS3BootScriptTablePrivateSmmDataPtr
+  |    TableLength               |--|--     (mS3BootScriptTablePtr = mS3BootScriptTableSmmPtr, After SmmReadyToLock InSmm)
+  |    TableMemoryPageNumber     |--|-|----
+  |    AtRuntime                 |  | |   |
+  |    InSmm                     |  | |   |
+  |    BootTimeScriptLength      |--|-|---|---
+  |    SmmLocked                 |  | |   |  |
+  |    BackFromS3                |  | |   |  |
+  +------------------------------+  | |   |  |
+                                    | |   |  |
+  +------------------------------+<-- |   |  |
+  | EFI_BOOT_SCRIPT_TABLE_HEADER |    |   |  |
+  |    TableLength               |----|-- |  |
+  +------------------------------+    | | |  |
+  |     ......                   |    | | |  |
+  +------------------------------+<---- | |  |
+  | EFI_BOOT_SCRIPT_TERMINATE    |      | |  |
+  +------------------------------+<------ |  |
+                                          |  |
+                                          |  |
+  mBootScriptDataBootTimeGuid LockBox:    |  |
+   Used to restore data after back from S3|  |
+   to handle potential INSERT boot script |  |
+   at runtime.                            |  |
+  +------------------------------+        |  |
+  | Boot Time Boot Script        |        |  |
+  | Before SmmReadyToLock        |        |  |
+  |                              |        |  |
+  |                              |        |  |
+  +------------------------------+        |  |
+  | Boot Time Boot Script        |        |  |
+  | After SmmReadyToLock InSmm   |        |  |
+  |                              |        |  |
+  +------------------------------+<-------|--|
+                                          |  |
+                                          |  |
+  mBootScriptDataGuid LockBox: (IN_PLACE) |  |
+   Used to restore data at S3 resume.     |  |
+  +------------------------------+        |  |
+  | Boot Time Boot Script        |        |  |
+  | Before SmmReadyToLock        |        |  |
+  |                              |        |  |
+  |                              |        |  |
+  +------------------------------+        |  |
+  | Boot Time Boot Script        |        |  |
+  | After SmmReadyToLock InSmm   |        |  |
+  |                              |        |  |
+  +------------------------------+<-------|---
+  | Runtime Boot Script          |        |
+  | After SmmReadyToLock InSmm   |        |
+  +------------------------------+        |
+  |     ......                   |        |
+  +------------------------------+<--------
+
+
+  mBootScriptTableBaseGuid LockBox: (IN_PLACE)
+  +------------------------------+
+  | mS3BootScriptTablePtr->      |
+  |  TableBase                   |
+  +------------------------------+
+
+
+  mBootScriptSmmPrivateDataGuid LockBox: (IN_PLACE)
+   SMM private data with BackFromS3 = TRUE
+   at runtime. S3 will help restore it to
+   tell the Library the system is back from S3.
+  +------------------------------+
   | SCRIPT_TABLE_PRIVATE_DATA    |
-  |    TableBase                 |---
-  |    TableLength               |--|--
-  |    AtRuntime                 |  | |
-  |    InSmm                     |  | |
-  +------------------------------+  | |
-                                    | |
-  +------------------------------+<-- |
-  | EFI_BOOT_SCRIPT_TABLE_HEADER |    |
-  |    TableLength               |----|--
-  +------------------------------+    | |
-  |     ......                   |    | |
-  +------------------------------+<---- |
-  | EFI_BOOT_SCRIPT_TERMINATE    |      |
-  +------------------------------+<------
+  |    TableBase                 |
+  |    TableLength               |
+  |    TableMemoryPageNumber     |
+  |    AtRuntime                 |
+  |    InSmm                     |
+  |    BootTimeScriptLength      |
+  |    SmmLocked                 |
+  |    BackFromS3 = TRUE         |
+  +------------------------------+
 
 **/
 
 SCRIPT_TABLE_PRIVATE_DATA        *mS3BootScriptTablePtr;
-EFI_EVENT                        mEnterRuntimeEvent;
+
 //
-// Allocate SMM copy because we can not use mS3BootScriptTablePtr when we AtRuntime in InSmm.
+// Allocate SMM copy because we can not use mS3BootScriptTablePtr after SmmReadyToLock in InSmm.
 //
 SCRIPT_TABLE_PRIVATE_DATA        *mS3BootScriptTableSmmPtr;
-UINTN                            mLockBoxLength;
 
 EFI_GUID                         mBootScriptDataGuid = {
   0xaea6b965, 0xdcf5, 0x4311, { 0xb4, 0xb8, 0xf, 0x12, 0x46, 0x44, 0x94, 0xd2 }
 };
 
-EFI_GUID                         mBootScriptDataOrgGuid = {
+EFI_GUID                         mBootScriptDataBootTimeGuid = {
   0xb5af1d7a, 0xb8cf, 0x4eb3, { 0x89, 0x25, 0xa8, 0x20, 0xe1, 0x6b, 0x68, 0x7d }
 };
 
-EFI_GUID                         mBootScriptHeaderDataGuid = {
+EFI_GUID                         mBootScriptTableBaseGuid = {
   0x1810ab4a, 0x2314, 0x4df6, { 0x81, 0xeb, 0x67, 0xc6, 0xec, 0x5, 0x85, 0x91 }
 };
 
+EFI_GUID                         mBootScriptSmmPrivateDataGuid = {
+  0x627ee2da, 0x3bf9, 0x439b, { 0x92, 0x9f, 0x2e, 0xe, 0x6e, 0x9d, 0xba, 0x62 }
+};
+
 /**
   This is an internal function to add a terminate node the entry, recalculate the table 
   length and fill into the table. 
@@ -97,18 +163,15 @@ S3BootScriptInternalCloseTable (
   return S3TableBase;
   //
   // NOTE: Here we did NOT adjust the mS3BootScriptTablePtr->TableLength to 
-  // mS3BootScriptTablePtr->TableLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE). Because 
-  // maybe in runtime, we still need add entries into the table, and the runtime entry should be
-  // added start before this TERMINATE node.
+  // mS3BootScriptTablePtr->TableLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE).
+  // Because maybe after SmmReadyToLock, we still need add entries into the table,
+  // and the entry should be added start before this TERMINATE node.
   //
 }  
 
 /**
   This function save boot script data to LockBox.
-  1. BootSriptPrivate data, BootScript data - Image and DispatchContext are handled by platform.
-  2. BootScriptExecutor, BootScriptExecutor context
-  - ACPI variable - (PI version) sould be handled by SMM driver. S3 Page table is handled here.
-  - ACPI variable - framework version is already handled by Framework CPU driver.
+
 **/
 VOID
 SaveBootScriptDataToLockBox (
@@ -118,49 +181,37 @@ SaveBootScriptDataToLockBox (
   EFI_STATUS            Status;
 
   //
-  // mS3BootScriptTablePtr->TableLength does not include EFI_BOOT_SCRIPT_TERMINATE, because we need add entry at runtime.
-  // Save all info here, just in case that no one will add boot script entry in SMM.
+  // Save whole memory copy into LockBox.
+  // It will be used to restore data at S3 resume.
   //
   Status = SaveLockBox (
              &mBootScriptDataGuid,
              (VOID *)mS3BootScriptTablePtr->TableBase,
-             mS3BootScriptTablePtr->TableLength + sizeof(EFI_BOOT_SCRIPT_TERMINATE)
+             EFI_PAGES_TO_SIZE (mS3BootScriptTablePtr->TableMemoryPageNumber)
              );
   ASSERT_EFI_ERROR (Status);
 
   Status = SetLockBoxAttributes (&mBootScriptDataGuid, LOCK_BOX_ATTRIBUTE_RESTORE_IN_PLACE);
   ASSERT_EFI_ERROR (Status);
 
-  //
-  // We need duplicate the original copy, because it may have INSERT boot script at runtime in SMM.
-  // If so, we should use original copy to restore data after OS rewrites the ACPINvs region.
-  // Or the data inserted may cause some original boot script data lost.
-  //
-  Status = SaveLockBox (
-             &mBootScriptDataOrgGuid,
-             (VOID *)mS3BootScriptTablePtr->TableBase,
-             mS3BootScriptTablePtr->TableLength + sizeof(EFI_BOOT_SCRIPT_TERMINATE)
-             );
-  ASSERT_EFI_ERROR (Status);
-
   //
   // Just need save TableBase.
   // Do not update other field because they will NOT be used in S3.
   //
   Status = SaveLockBox (
-             &mBootScriptHeaderDataGuid,
+             &mBootScriptTableBaseGuid,
              (VOID *)&mS3BootScriptTablePtr->TableBase,
              sizeof(mS3BootScriptTablePtr->TableBase)
              );
   ASSERT_EFI_ERROR (Status);
 
-  Status = SetLockBoxAttributes (&mBootScriptHeaderDataGuid, LOCK_BOX_ATTRIBUTE_RESTORE_IN_PLACE);
+  Status = SetLockBoxAttributes (&mBootScriptTableBaseGuid, LOCK_BOX_ATTRIBUTE_RESTORE_IN_PLACE);
   ASSERT_EFI_ERROR (Status);
 }
 
 /**
   This is the Event call back function to notify the Library the system is entering
-  run time phase.
+  SmmLocked phase.
   
   @param  Event   Pointer to this event
   @param  Context Event handler private data 
@@ -189,28 +240,29 @@ S3BootScriptEventCallBack (
   }
 
   //
-  // Here we should tell the library that we are enter into runtime phase. and 
-  // the memory page number occupied by the table should not grow anymore.
+  // Here we should tell the library that we are entering SmmLocked phase.
+  // and the memory page number occupied by the table should not grow anymore.
   //
-  if (!mS3BootScriptTablePtr->AtRuntime) {
+  if (!mS3BootScriptTablePtr->SmmLocked) {
     //
-    // In boot time, we need not write the terminate node when adding a node to boot scipt table
-    // or else, that will impact the performance. However, in runtime, we should append terminate
-    // node on every add to boot script table
+    // Before SmmReadyToLock, we need not write the terminate node when adding a node to boot scipt table
+    // or else, that will impact the performance. However, after SmmReadyToLock, we should append terminate
+    // node on every add to boot script table.
     //
     S3BootScriptInternalCloseTable ();
-    mS3BootScriptTablePtr->AtRuntime = TRUE;
+    mS3BootScriptTablePtr->SmmLocked = TRUE;
 
     //
     // Save BootScript data to lockbox
     //
     SaveBootScriptDataToLockBox ();
   }
-} 
+}
+
 /**
-  This is the Event call back function is triggered in SMM to notify the Library the system is entering
-  run time phase and set InSmm flag.
-  
+  This is the Event call back function is triggered in SMM to notify the Library
+  the system is entering SmmLocked phase and set InSmm flag.
+
   @param  Protocol   Points to the protocol's unique identifier
   @param  Interface  Points to the interface instance
   @param  Handle     The handle on which the interface was installed
@@ -233,7 +285,7 @@ S3BootScriptSmmEventCallBack (
   }
 
   //
-  // Last chance to call-out, just make sure AtRuntime is set
+  // Last chance to call-out, just make sure SmmLocked is set.
   //
   S3BootScriptEventCallBack (NULL, NULL);
 
@@ -242,22 +294,117 @@ S3BootScriptSmmEventCallBack (
   //
   if (mS3BootScriptTableSmmPtr->TableBase == NULL) {
     CopyMem (mS3BootScriptTableSmmPtr, mS3BootScriptTablePtr, sizeof(*mS3BootScriptTablePtr));
+
+    //
+    // Set InSmm, we allow boot script update when InSmm, but not allow boot script outside SMM.
+    // InSmm will only be checked if SmmLocked is TRUE.
+    //
+    mS3BootScriptTableSmmPtr->InSmm = TRUE;
   }
   //
-  // We should not use ACPINvs copy, because it is not safe.
+  // We should not use ACPI Reserved copy, because it is not safe.
   //
   mS3BootScriptTablePtr = mS3BootScriptTableSmmPtr;
 
+  return EFI_SUCCESS;
+}
+
+/**
+  This function is to save boot time boot script data to LockBox.
+
+  Because there may be INSERT boot script at runtime in SMM.
+  The boot time copy will be used to restore data after back from S3.
+  Otherwise the data inserted may cause some boot time boot script data lost
+  if only BootScriptData used.
+
+**/
+VOID
+SaveBootTimeDataToLockBox (
+  VOID
+  )
+{
+  EFI_STATUS    Status;
+
+  //
+  // ACPI Reserved copy is not safe, restore from BootScriptData LockBox first,
+  // and then save the data to BootScriptDataBootTime LockBox.
+  //
+  Status = RestoreLockBox (
+             &mBootScriptDataGuid,
+             NULL,
+             NULL
+             );
+  ASSERT_EFI_ERROR (Status);
+
   //
-  // Set InSmm, we allow boot script update when InSmm, but not allow boot script outside SMM.
-  // InSmm will only be checked if AtRuntime is TRUE.
+  // Save BootScriptDataBootTime
+  // It will be used to restore data after back from S3.
   //
-  mS3BootScriptTablePtr->InSmm = TRUE;
+  Status = SaveLockBox (
+             &mBootScriptDataBootTimeGuid,
+             (VOID *) mS3BootScriptTablePtr->TableBase,
+             mS3BootScriptTablePtr->BootTimeScriptLength
+             );
+  ASSERT_EFI_ERROR (Status);
+}
+
+/**
+  This function save boot script SMM private data to LockBox with BackFromS3 = TRUE at runtime.
+  S3 resume will help restore it to tell the Library the system is back from S3.
+
+**/
+VOID
+SaveSmmPriviateDataToLockBoxAtRuntime (
+  VOID
+  )
+{
+  EFI_STATUS    Status;
 
   //
-  // Record LockBoxLength
+  // Save boot script SMM private data with BackFromS3 = TRUE.
   //
-  mLockBoxLength = mS3BootScriptTableSmmPtr->TableLength + sizeof(EFI_BOOT_SCRIPT_TERMINATE);
+  mS3BootScriptTablePtr->BackFromS3 = TRUE;
+  Status = SaveLockBox (
+             &mBootScriptSmmPrivateDataGuid,
+             (VOID *) mS3BootScriptTablePtr,
+             sizeof (SCRIPT_TABLE_PRIVATE_DATA)
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  Status = SetLockBoxAttributes (&mBootScriptSmmPrivateDataGuid, LOCK_BOX_ATTRIBUTE_RESTORE_IN_PLACE);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Set BackFromS3 flag back to FALSE to indicate that now is not back from S3.
+  //
+  mS3BootScriptTablePtr->BackFromS3 = FALSE;
+}
+
+/**
+  This is the Event call back function is triggered in SMM to notify the Library
+  the system is entering runtime phase.
+
+  @param[in] Protocol   Points to the protocol's unique identifier
+  @param[in] Interface  Points to the interface instance
+  @param[in] Handle     The handle on which the interface was installed
+
+  @retval EFI_SUCCESS SmmAtRuntimeCallBack runs successfully
+ **/
+EFI_STATUS
+EFIAPI
+S3BootScriptSmmAtRuntimeCallBack (
+  IN CONST EFI_GUID     *Protocol,
+  IN VOID               *Interface,
+  IN EFI_HANDLE         Handle
+  )
+{
+  if (!mS3BootScriptTablePtr->AtRuntime) {
+    mS3BootScriptTablePtr->BootTimeScriptLength = (UINT32) (mS3BootScriptTablePtr->TableLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE));
+    SaveBootTimeDataToLockBox ();
+
+    mS3BootScriptTablePtr->AtRuntime = TRUE;
+    SaveSmmPriviateDataToLockBoxAtRuntime ();
+  }
 
   return EFI_SUCCESS;
 }
@@ -288,6 +435,7 @@ S3BootScriptLibInitialize (
   BOOLEAN                        InSmm;
   EFI_SMM_SYSTEM_TABLE2          *Smst;
   EFI_PHYSICAL_ADDRESS           Buffer;
+  EFI_EVENT                      Event;
 
   S3TablePtr = (SCRIPT_TABLE_PRIVATE_DATA*)(UINTN)PcdGet64(PcdS3BootScriptTablePrivateDataPtr);
   //
@@ -297,7 +445,7 @@ S3BootScriptLibInitialize (
     Buffer = SIZE_4GB - 1;
     Status = gBS->AllocatePages (
                     AllocateMaxAddress,
-                    EfiACPIMemoryNVS,
+                    EfiReservedMemoryType,
                     EFI_SIZE_TO_PAGES(sizeof(SCRIPT_TABLE_PRIVATE_DATA)),
                     &Buffer
                     );
@@ -309,17 +457,17 @@ S3BootScriptLibInitialize (
     PcdSet64 (PcdS3BootScriptTablePrivateDataPtr, (UINT64) (UINTN)S3TablePtr); 
     ZeroMem (S3TablePtr, sizeof(SCRIPT_TABLE_PRIVATE_DATA));  
     //
-    // create event to notify the library system enter the runtime phase
+    // Create event to notify the library system enter the SmmLocked phase.
     //
-    mEnterRuntimeEvent = EfiCreateProtocolNotifyEvent  (
-                          &gEfiDxeSmmReadyToLockProtocolGuid,
-                          TPL_CALLBACK,
-                          S3BootScriptEventCallBack,
-                          NULL,
-                          &Registration
-                          );
-    ASSERT (mEnterRuntimeEvent != NULL);
-  } 
+    Event = EfiCreateProtocolNotifyEvent  (
+              &gEfiDxeSmmReadyToLockProtocolGuid,
+              TPL_CALLBACK,
+              S3BootScriptEventCallBack,
+              NULL,
+              &Registration
+              );
+    ASSERT (Event != NULL);
+  }
   mS3BootScriptTablePtr = S3TablePtr;
 
   //
@@ -360,11 +508,30 @@ S3BootScriptLibInitialize (
 
     PcdSet64 (PcdS3BootScriptTablePrivateSmmDataPtr, (UINT64) (UINTN)S3TableSmmPtr);
     ZeroMem (S3TableSmmPtr, sizeof(SCRIPT_TABLE_PRIVATE_DATA));
+
+    //
+    // Register SmmExitBootServices and SmmLegacyBoot notification.
+    //
+    Registration = NULL;
+    Status = Smst->SmmRegisterProtocolNotify (
+                     &gEdkiiSmmExitBootServicesProtocolGuid,
+                     S3BootScriptSmmAtRuntimeCallBack,
+                     &Registration
+                     );
+    ASSERT_EFI_ERROR (Status);
+
+    Registration = NULL;
+    Status = Smst->SmmRegisterProtocolNotify (
+                     &gEdkiiSmmLegacyBootProtocolGuid,
+                     S3BootScriptSmmAtRuntimeCallBack,
+                     &Registration
+                     );
+    ASSERT_EFI_ERROR (Status);
   }
   mS3BootScriptTableSmmPtr = S3TableSmmPtr;
 
   //
-  // Then register event after lock
+  // Register SmmReadyToLock notification.
   //
   Registration = NULL;
   Status = Smst->SmmRegisterProtocolNotify (
@@ -401,14 +568,14 @@ S3BootScriptGetBootTimeEntryAddAddress (
    
    S3TableBase = (EFI_PHYSICAL_ADDRESS)(UINTN)(mS3BootScriptTablePtr->TableBase);
    if (S3TableBase == 0) {
+     //
      // The table is not exist. This is the first to add entry. 
-     // Allocate ACPI script table space under 4G memory. We need it to save
-     // some settings done by CSM, which runs after normal script table closed
+     // Allocate ACPI script table space under 4G memory.
      //
      S3TableBase = 0xffffffff;
      Status = gBS->AllocatePages (
                   AllocateMaxAddress,
-                  EfiACPIMemoryNVS,
+                  EfiReservedMemoryType,
                   2 + PcdGet16(PcdS3BootScriptRuntimeTableReservePageNumber),
                   (EFI_PHYSICAL_ADDRESS*)&S3TableBase
                   );
@@ -431,16 +598,16 @@ S3BootScriptGetBootTimeEntryAddAddress (
    }
      
    // Here we do not count the reserved memory for runtime script table.
-   PageNumber   = (UINT16)(mS3BootScriptTablePtr->TableMemoryPageNumber - PcdGet16(PcdS3BootScriptRuntimeTableReservePageNumber));   
+   PageNumber = (UINT16) (mS3BootScriptTablePtr->TableMemoryPageNumber - PcdGet16(PcdS3BootScriptRuntimeTableReservePageNumber));
    TableLength =  mS3BootScriptTablePtr->TableLength;
-   if ((UINT32)(PageNumber * EFI_PAGE_SIZE) < (TableLength + EntryLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE))) {
+   if ((UINTN) EFI_PAGES_TO_SIZE ((UINTN) PageNumber) < (UINTN) (TableLength + EntryLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE))) {
      // 
      // The buffer is too small to hold the table, Reallocate the buffer
      //
      NewS3TableBase = 0xffffffff;
      Status = gBS->AllocatePages (
                   AllocateMaxAddress,
-                  EfiACPIMemoryNVS,
+                  EfiReservedMemoryType,
                   2 + PageNumber + PcdGet16(PcdS3BootScriptRuntimeTableReservePageNumber),
                   (EFI_PHYSICAL_ADDRESS*)&NewS3TableBase
                   );
@@ -476,12 +643,12 @@ S3BootScriptGetBootTimeEntryAddAddress (
    return NewEntryPtr;    
 }
 /**
-  To get the start address from which a new runtime s3 boot script entry will write into.
+  To get the start address from which a new runtime(after SmmReadyToLock) s3 boot script entry will write into.
   In this case, it should be ensured that there is enough buffer to hold the entry.
   
   @param EntryLength      the new entry length.
   
-  @retval the address from which the a new s3 runtime script entry will write into
+  @retval the address from which the a new s3 runtime(after SmmReadyToLock) script entry will write into
  **/
 UINT8*
 S3BootScriptGetRuntimeEntryAddAddress (
@@ -494,7 +661,7 @@ S3BootScriptGetRuntimeEntryAddAddress (
    //
    // Check if the memory range reserved for S3 Boot Script table is large enough to hold the node. 
    //
-   if (mS3BootScriptTablePtr->TableLength + EntryLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE) <= EFI_PAGES_TO_SIZE((UINT32)(mS3BootScriptTablePtr->TableMemoryPageNumber))) {
+   if ((UINTN) (mS3BootScriptTablePtr->TableLength + EntryLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE)) <= (UINTN) EFI_PAGES_TO_SIZE ((UINTN) (mS3BootScriptTablePtr->TableMemoryPageNumber))) {
      NewEntryPtr = mS3BootScriptTablePtr->TableBase + mS3BootScriptTablePtr->TableLength;   
      mS3BootScriptTablePtr->TableLength = mS3BootScriptTablePtr->TableLength + EntryLength;
      //
@@ -504,12 +671,53 @@ S3BootScriptGetRuntimeEntryAddAddress (
    }
    return (UINT8*)NewEntryPtr;    
 }
+
+/**
+  This function is to restore boot time boot script data from LockBox.
+
+**/
+VOID
+RestoreBootTimeDataFromLockBox (
+  VOID
+  )
+{
+  EFI_STATUS    Status;
+  UINTN         LockBoxLength;
+
+  //
+  // Restore boot time boot script data from LockBox.
+  //
+  LockBoxLength = mS3BootScriptTablePtr->BootTimeScriptLength;
+  Status = RestoreLockBox (
+             &mBootScriptDataBootTimeGuid,
+             (VOID *) mS3BootScriptTablePtr->TableBase,
+             &LockBoxLength
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Update the data to BootScriptData LockBox.
+  //
+  Status = UpdateLockBox (
+             &mBootScriptDataGuid,
+             0,
+             (VOID *) mS3BootScriptTablePtr->TableBase,
+             LockBoxLength
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Update TableLength.
+  //
+  mS3BootScriptTablePtr->TableLength = (UINT32) (mS3BootScriptTablePtr->BootTimeScriptLength - sizeof (EFI_BOOT_SCRIPT_TERMINATE));
+}
+
 /**
   To get the start address from which a new s3 boot script entry will write into.
   
   @param EntryLength      the new entry length.
   
-  @retval the address from which the a new s3 runtime script entry will write into 
+  @retval the address from which the a new s3 boot script entry will write into 
  **/ 
 UINT8* 
 S3BootScriptGetEntryAddAddress (
@@ -517,78 +725,31 @@ S3BootScriptGetEntryAddAddress (
   )
 {
   UINT8*                         NewEntryPtr;
-  EFI_BOOT_SCRIPT_TABLE_HEADER   TableHeader;
-  EFI_STATUS                     Status;
-  UINTN                          OrgLockBoxLength;
 
-  if (mS3BootScriptTablePtr->AtRuntime) {
+  if (mS3BootScriptTablePtr->SmmLocked) {
     //
-    // We need check InSmm when AtRuntime, because after SmmReadyToLock, only SMM driver is allowed to write boot script.
+    // We need check InSmm, because after SmmReadyToLock, only SMM driver is allowed to write boot script.
     //
     if (!mS3BootScriptTablePtr->InSmm) {
       //
-      // Add DEBUG ERROR, so that we can find it at boot time.
-      // Do not use ASSERT, because we may have test invoke this interface.
+      // Add DEBUG ERROR, so that we can find it after SmmReadyToLock.
+      // Do not use ASSERT, because we may have test to invoke this interface.
       //
-      DEBUG ((EFI_D_ERROR, "FATAL ERROR: Set boot script after ReadyToLock!!!\n"));
+      DEBUG ((EFI_D_ERROR, "FATAL ERROR: Set boot script outside SMM after SmmReadyToLock!!!\n"));
       return NULL;
     }
 
-    //
-    // NOTE: OS will restore ACPINvs data. After S3, the table length in mS3BootScriptTableSmmPtr (SMM) is different with
-    // table length in BootScriptTable header (ACPINvs).
-    // So here we need sync them. We choose ACPINvs table length, because we want to override the boot script saved
-    // in SMM every time.
-    //
-    ASSERT (mS3BootScriptTablePtr == mS3BootScriptTableSmmPtr);
-    CopyMem ((VOID*)&TableHeader, (VOID*)mS3BootScriptTablePtr->TableBase, sizeof(EFI_BOOT_SCRIPT_TABLE_HEADER));
-    if (mS3BootScriptTablePtr->TableLength + sizeof(EFI_BOOT_SCRIPT_TERMINATE) != TableHeader.TableLength) {
-      //
-      // Restore it to use original value
-      //
-      OrgLockBoxLength = mLockBoxLength;
-      Status = RestoreLockBox (
-                 &mBootScriptDataOrgGuid,
-                 (VOID *)mS3BootScriptTablePtr->TableBase,
-                 &OrgLockBoxLength
-                 );
-     ASSERT_EFI_ERROR (Status);
-     ASSERT (OrgLockBoxLength == mLockBoxLength);
-
-      //
-      // Update the current BootScriptData into LockBox as well
-      //
-      Status = UpdateLockBox (
-                 &mBootScriptDataGuid,
-                 0,
-                 (VOID *)mS3BootScriptTablePtr->TableBase,
-                 OrgLockBoxLength
-                 );
-      ASSERT_EFI_ERROR (Status);
-
+    if (mS3BootScriptTablePtr->BackFromS3) {
       //
-      // NOTE: We should NOT use TableHeader.TableLength, because it is already updated to be whole length.
+      // Back from S3, restore boot time boot script data from LockBox
+      // and set BackFromS3 flag back to FALSE.
       //
-      mS3BootScriptTablePtr->TableLength = (UINT32)(mLockBoxLength - sizeof(EFI_BOOT_SCRIPT_TERMINATE));
+      RestoreBootTimeDataFromLockBox ();
+      mS3BootScriptTablePtr->BackFromS3 = FALSE;
     }
 
     NewEntryPtr  = S3BootScriptGetRuntimeEntryAddAddress (EntryLength);
-
-    if (EntryLength != 0) {
-      //
-      // Now the length field is updated, need sync to lockbox.
-      // So in S3 resume, the data can be restored correctly.
-      //
-      CopyMem ((VOID*)&TableHeader, (VOID*)mS3BootScriptTablePtr->TableBase, sizeof(EFI_BOOT_SCRIPT_TABLE_HEADER));
-      Status = UpdateLockBox (
-                 &mBootScriptDataGuid,
-                 OFFSET_OF(EFI_BOOT_SCRIPT_TABLE_HEADER, TableLength),
-                 &TableHeader.TableLength,
-                 sizeof(TableHeader.TableLength)
-                 );
-      ASSERT_EFI_ERROR (Status);
-    }
-  } else {   
+  } else {
     NewEntryPtr  = S3BootScriptGetBootTimeEntryAddAddress (EntryLength);
   }  
   return NewEntryPtr;
@@ -607,17 +768,21 @@ SyncBootScript (
   )
 {
   EFI_STATUS  Status;
-  UINTN       ScriptOffset;
+  UINT32      ScriptOffset;
+  UINT32      TotalScriptLength;
 
-  ScriptOffset = (UINTN) (Script - mS3BootScriptTablePtr->TableBase);
-
-  if (!mS3BootScriptTablePtr->AtRuntime || !mS3BootScriptTablePtr->InSmm || ScriptOffset >= mLockBoxLength) {
+  if (!mS3BootScriptTablePtr->SmmLocked || !mS3BootScriptTablePtr->InSmm) {
     //
-    // If it is not at runtime in SMM or in the range that needs to be synced in LockBox, just return.
+    // If it is not after SmmReadyToLock in SMM,
+    // just return.
     //
     return ;
   }
 
+  ScriptOffset = (UINT32) (Script - mS3BootScriptTablePtr->TableBase);
+
+  TotalScriptLength = (UINT32) (mS3BootScriptTablePtr->TableLength + sizeof (EFI_BOOT_SCRIPT_TERMINATE));
+
   //
   // Update BootScriptData
   // So in S3 resume, the data can be restored correctly.
@@ -626,7 +791,19 @@ SyncBootScript (
              &mBootScriptDataGuid,
              ScriptOffset,
              (VOID *)((UINTN)mS3BootScriptTablePtr->TableBase + ScriptOffset),
-             mLockBoxLength - ScriptOffset
+             TotalScriptLength - ScriptOffset
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Now the length field is updated, need sync to lockbox.
+  // So at S3 resume, the data can be restored correctly.
+  //
+  Status = UpdateLockBox (
+             &mBootScriptDataGuid,
+             OFFSET_OF (EFI_BOOT_SCRIPT_TABLE_HEADER, TableLength),
+             &TotalScriptLength,
+             sizeof (TotalScriptLength)
              );
   ASSERT_EFI_ERROR (Status);
 }
@@ -649,7 +826,7 @@ SyncBootScript (
   for Framework Spec compatibility.
   
   If anyone does call CloseTable() on a real platform, then the caller is responsible for figuring out 
-  how to get the script to run on an S3 resume because the boot script maintained by the lib will be 
+  how to get the script to run at S3 resume because the boot script maintained by the lib will be 
   destroyed.
  
   @return the base address of the new copy of the boot script table.   
diff --git a/MdeModulePkg/Library/PiDxeS3BootScriptLib/DxeS3BootScriptLib.inf b/MdeModulePkg/Library/PiDxeS3BootScriptLib/DxeS3BootScriptLib.inf
index 3e12372be4b0..6b7540a5eab9 100644
--- a/MdeModulePkg/Library/PiDxeS3BootScriptLib/DxeS3BootScriptLib.inf
+++ b/MdeModulePkg/Library/PiDxeS3BootScriptLib/DxeS3BootScriptLib.inf
@@ -1,7 +1,7 @@
 ## @file
 # DXE S3 boot script Library.
 #
-# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 #
 # This program and the accompanying materials are
 # licensed and made available under the terms and conditions of the BSD License
@@ -59,6 +59,8 @@
   gEfiSmmBase2ProtocolGuid                      ## SOMETIMES_CONSUMES
   gEfiDxeSmmReadyToLockProtocolGuid             ## NOTIFY
   gEfiSmmReadyToLockProtocolGuid                ## NOTIFY
+  gEdkiiSmmExitBootServicesProtocolGuid         ## NOTIFY
+  gEdkiiSmmLegacyBootProtocolGuid               ## NOTIFY
 
 [Pcd]
   ## CONSUMES
diff --git a/MdeModulePkg/Library/PiDxeS3BootScriptLib/InternalBootScriptLib.h b/MdeModulePkg/Library/PiDxeS3BootScriptLib/InternalBootScriptLib.h
index 3e2a0d2bacf5..e54027848346 100644
--- a/MdeModulePkg/Library/PiDxeS3BootScriptLib/InternalBootScriptLib.h
+++ b/MdeModulePkg/Library/PiDxeS3BootScriptLib/InternalBootScriptLib.h
@@ -2,7 +2,7 @@
   Support for S3 boot script lib. This file defined some internal macro and internal 
   data structure
  
-  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions
@@ -23,6 +23,8 @@
 #include <Protocol/SmmBase2.h>
 #include <Protocol/DxeSmmReadyToLock.h>
 #include <Protocol/SmmReadyToLock.h>
+#include <Protocol/SmmExitBootServices.h>
+#include <Protocol/SmmLegacyBoot.h>
 
 #include <Library/S3BootScriptLib.h>
 
@@ -70,11 +72,14 @@ typedef union {
 // The boot script private data.
 //
 typedef struct {
-  UINT8           *TableBase;
-  UINT32          TableLength;               // Record the actual memory length 
-  UINT16          TableMemoryPageNumber;     // Record the page number Allocated for the table 
-  BOOLEAN         AtRuntime;                 // Record if current state is after SmmReadyToLock
-  BOOLEAN         InSmm;                     // Record if this library is in SMM.
+  UINT8     *TableBase;
+  UINT32    TableLength;            // Record the actual memory length 
+  UINT16    TableMemoryPageNumber;  // Record the page number Allocated for the table 
+  BOOLEAN   InSmm;                  // Record if this library is in SMM.
+  BOOLEAN   AtRuntime;              // Record if current state is after SmmExitBootServices or SmmLegacyBoot.
+  UINT32    BootTimeScriptLength;   // Maintain boot time script length in LockBox after SmmReadyToLock in SMM.
+  BOOLEAN   SmmLocked;              // Record if current state is after SmmReadyToLock
+  BOOLEAN   BackFromS3;             // Indicate that the system is back from S3.
 } SCRIPT_TABLE_PRIVATE_DATA;
 
 typedef
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 5c1d29a68afe..24d13f4e3916 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -1222,10 +1222,10 @@
   # @Prompt SATA spin-up delay time in second for recovery path.
   gEfiMdeModulePkgTokenSpaceGuid.PcdSataSpinUpDelayInSecForRecoveryPath|15|UINT16|0x0001005B
 
-  ## This PCD is used to specify memory size with page number for a pre-allocated ACPI NVS memory to hold
-  #  runtime created S3 boot script entries. The default page number is 2. When changing the value of this
-  #  PCD, the platform developer should make sure the memory size is large enough to hold the S3 boot
-  #  script node created in runtime phase.
+  ## This PCD is used to specify memory size with page number for a pre-allocated ACPI reserved memory
+  #  to hold runtime(after SmmReadyToLock) created S3 boot script entries. The default page number is 2.
+  #  When changing the value of this PCD, the platform developer should make sure the memory size is
+  #  large enough to hold the S3 boot script node created in runtime(after SmmReadyToLock) phase.
   # @Prompt Reserved page number for S3 Boot Script Runtime Table.
   gEfiMdeModulePkgTokenSpaceGuid.PcdS3BootScriptRuntimeTableReservePageNumber|0x2|UINT16|0x0001005C
 
diff --git a/MdeModulePkg/MdeModulePkg.uni b/MdeModulePkg/MdeModulePkg.uni
index 9db6e58e165898f02e3dbad097d0fd84f3f8ea03..b1fd210d2b93664435762262a67efa34006061b1 100644
GIT binary patch
delta 129
zcmaDehx^=I?uIRlHZ7Bv#0X7~kznMT9@N4pr>((|$dJZR!jQ^P#Gt?s%#aI&K|o$2
nLkdGBLkL4YgAWiVGh{PpZqILF+{;Lcj&|)f#_if|OpYD^llUJO

delta 47
zcmX>%m;22e?uIRlHZ81v3}FnxlRxeko*vi2C^OxOiAiYtjuysMjO~4GjNAL#m>fI+
DvC<J{


From a7757cf69f830bcfb7c6eed4786b303f23f53140 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Tue, 15 Sep 2015 08:47:05 +0000
Subject: [PATCH 041/525] MdeModulePkg: Enhance PCI capability looking up logic
 to avoid hang

Certain PCI device may have capability pointing to itself.
Update LocateCapabilityRegBlock() to break when detecting such loop.

(Sync patch r18473 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18475 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Pci/PciBusDxe/PciCommand.c | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciCommand.c b/MdeModulePkg/Bus/Pci/PciBusDxe/PciCommand.c
index 8a8b4b8faca8..0bc1fbfefffe 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciCommand.c
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciCommand.c
@@ -173,6 +173,14 @@ LocateCapabilityRegBlock (
       return EFI_SUCCESS;
     }
 
+    //
+    // Certain PCI device may incorrectly have capability pointing to itself,
+    // break to avoid dead loop.
+    //
+    if (CapabilityPtr == (UINT8) (CapabilityEntry >> 8)) {
+      break;
+    }
+
     CapabilityPtr = (UINT8) (CapabilityEntry >> 8);
   }
 

From 9f97f1253778216c41e9e4796333526669f24b0a Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Wed, 16 Sep 2015 02:55:23 +0000
Subject: [PATCH 042/525] MdeModulePkg: PcdSetNxForStack: enable dynamism

Allow platforms to instantiate this PCD as PcdsDynamic and PcdsDynamicEx
too, not just PcdsFixedAtBuild and PcdsPatchableInModule.

(Sync patch r18468 from main trunk.)

Cc: Star Zeng <star.zeng@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18477 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dec | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 24d13f4e3916..3dfcd6a77f64 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -969,15 +969,6 @@
   # @Prompt Serial Port Register Stride in Bytes
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterStride|1|UINT32|0x0001006d
 
-  ## Indicates if to set NX for stack.<BR><BR>
-  #  For the DxeIpl and the DxeCore are both X64, set NX for stack feature also require PcdDxeIplBuildPageTables be TRUE.<BR>
-  #  For the DxeIpl and the DxeCore are both IA32 (PcdDxeIplSwitchToLongMode is FALSE), set NX for stack feature also require
-  #  IA32 PAE is supported and Execute Disable Bit is available.<BR>
-  #   TRUE  - to set NX for stack.<BR>
-  #   FALSE - Not to set NX for stack.<BR>
-  # @Prompt Set NX for stack.
-  gEfiMdeModulePkgTokenSpaceGuid.PcdSetNxForStack|FALSE|BOOLEAN|0x0001006f
-
   ## This PCD to include the driver guid of VFR drivers for VarCheckHiiBin generation.<BR><BR>
   # Default is gZeroGuid that means no VFR driver will be parsed for VarCheckHiiBin generation.<BR>
   # If it is set to an all FFs GUID, it means all modules in all FVs will be parsed for VarCheckHiiBin generation.<BR>
@@ -1373,6 +1364,15 @@
   # @Prompt Default Creator Revision for ACPI table creation.
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision|0x01000013|UINT32|0x30001038
 
+  ## Indicates if to set NX for stack.<BR><BR>
+  #  For the DxeIpl and the DxeCore are both X64, set NX for stack feature also require PcdDxeIplBuildPageTables be TRUE.<BR>
+  #  For the DxeIpl and the DxeCore are both IA32 (PcdDxeIplSwitchToLongMode is FALSE), set NX for stack feature also require
+  #  IA32 PAE is supported and Execute Disable Bit is available.<BR>
+  #   TRUE  - to set NX for stack.<BR>
+  #   FALSE - Not to set NX for stack.<BR>
+  # @Prompt Set NX for stack.
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSetNxForStack|FALSE|BOOLEAN|0x0001006f
+
 [PcdsPatchableInModule]
   ## Specify memory size with page number for PEI code when
   #  Loading Module at Fixed Address feature is enabled.

From a42b7ff22dd12b231bff598970888e8f91ffc6a1 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 16 Sep 2015 08:16:16 +0000
Subject: [PATCH 043/525] Nt32Pkg: Fix PlatformBootManagerLib to respect
 PcdShellFile.

Fix the code to use PcdShellFile instead of using hard code GUID
which always points to new UEFI shell.

(Sync patch r18478 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Eric Jin <eric.jin@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18479 6f19259b-4bc3-4df7-8a09-765794883524
---
 Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c | 5 +----
 .../PlatformBootManagerLib/PlatformBootManagerLib.inf        | 5 +++--
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
index 3f634fcff981..e944105b3925 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
@@ -15,9 +15,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "PlatformBootManager.h"
 
-
-EFI_GUID mUefiShellFileGuid = { 0x7C04A583, 0x9E3E, 0x4f1c, 0xAD, 0x65, 0xE0, 0x52, 0x68, 0xD0, 0xB4, 0xD1 };
-
 /**
   Perform the platform diagnostic, such like test memory. OEM/IBV also
   can customize this function to support specific platform diagnostic.
@@ -220,7 +217,7 @@ PlatformBootManagerBeforeConsole (
   //
   // Register UEFI Shell
   //
-  PlatformRegisterFvBootOption (&mUefiShellFileGuid, L"UEFI Shell", LOAD_OPTION_ACTIVE);
+  PlatformRegisterFvBootOption (PcdGetPtr (PcdShellFile), L"UEFI Shell", LOAD_OPTION_ACTIVE);
 }
 
 /**
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
index d6175380583b..9b1eeaba02ed 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
@@ -65,9 +65,10 @@
 
 [Pcd]
   gEfiMdePkgTokenSpaceGuid.PcdPlatformBootTimeOut
+  gEfiMdePkgTokenSpaceGuid.PcdUgaConsumeSupport
   gEfiMdeModulePkgTokenSpaceGuid.PcdConOutRow
   gEfiMdeModulePkgTokenSpaceGuid.PcdConOutColumn
-  gEfiMdePkgTokenSpaceGuid.PcdUgaConsumeSupport
+  gEfiMdeModulePkgTokenSpaceGuid.PcdConInConnectOnDemand
   gEfiIntelFrameworkModulePkgTokenSpaceGuid.PcdBootlogoOnlyEnable
   gEfiIntelFrameworkModulePkgTokenSpaceGuid.PcdLogoFile
-  gEfiMdeModulePkgTokenSpaceGuid.PcdConInConnectOnDemand
+  gEfiIntelFrameworkModulePkgTokenSpaceGuid.PcdShellFile

From b2953a39cc17d49974ebbd66fb4449f326f323fc Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Wed, 16 Sep 2015 08:40:20 +0000
Subject: [PATCH 044/525] ShellPkg: Fix a command line unicode string type.

(Sync patch r18480 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18481 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellDriver1CommandsLib/Reconnect.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDriver1CommandsLib/Reconnect.c b/ShellPkg/Library/UefiShellDriver1CommandsLib/Reconnect.c
index 092e2c974bcb..d2ae8e82719d 100644
--- a/ShellPkg/Library/UefiShellDriver1CommandsLib/Reconnect.c
+++ b/ShellPkg/Library/UefiShellDriver1CommandsLib/Reconnect.c
@@ -1,8 +1,9 @@
 /** @file
   Main file for Reconnect shell Driver1 function.
 
-  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
   Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>  
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -75,7 +76,7 @@ ShellCommandRunReconnect (
   Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);
   if (EFI_ERROR(Status)) {
     if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDriver1HiiHandle, "reconnect", ProblemParam);
+      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDriver1HiiHandle, L"reconnect", ProblemParam);
       FreePool(ProblemParam);
       ShellStatus = SHELL_INVALID_PARAMETER;
     } else {

From 3d4bfa3c396c5b6e10652b03ea13238d45bc4abb Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Thu, 17 Sep 2015 00:54:45 +0000
Subject: [PATCH 045/525] NetworkPkg: Enhance the NULL pointer check before
 dereference it.

This patch enhances the NULL pointer check of the HttpInstance->RemoteHost
pointer before dereference it.

(Sync patch r18482 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18485 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 76c95b2bb66a..50c061743665 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -316,7 +316,7 @@ EfiHttpRequest (
   Configure   = TRUE;
   ReConfigure = TRUE;  
 
-  if (HttpInstance->RemoteHost == NULL && HttpInstance->RemotePort == 0) {
+  if (HttpInstance->RemoteHost == NULL) {
     //
     // Request() is called the first time. 
     //
@@ -373,6 +373,7 @@ EfiHttpRequest (
       if (HttpInstance->RemoteHost != NULL) {
         FreePool (HttpInstance->RemoteHost);
         HttpInstance->RemoteHost = NULL;
+        HttpInstance->RemotePort = 0;
       }
     }
   } 

From b175ea532fc48be3d926a6c1630138598904ad52 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Thu, 17 Sep 2015 00:55:10 +0000
Subject: [PATCH 046/525] NetworkPkg: TrafficDirection not saved in
 IPsecConfig.

Fix a bug that the TrafficDirection field is not saved in IPsecConfig.SetData.

(Sync patch r18483 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18486 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/IpSecDxe/IpSecConfigImpl.c | 14 ++++++++------
 NetworkPkg/IpSecDxe/IpSecImpl.h       |  1 +
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
index bd49245190bd..6aa47aababfe 100644
--- a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
+++ b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
@@ -1167,9 +1167,10 @@ SetSpdEntry (
     SpdData->Name,
     sizeof (SpdData->Name)
     );
-  SpdEntry->Data->PackageFlag = SpdData->PackageFlag;
-  SpdEntry->Data->Action      = SpdData->Action;
-
+  SpdEntry->Data->PackageFlag      = SpdData->PackageFlag;
+  SpdEntry->Data->TrafficDirection = SpdData->TrafficDirection;
+  SpdEntry->Data->Action           = SpdData->Action;
+  
   //
   // Fix the address of ProcessingPolicy and copy it if need, which is continous
   // memory and close to the base structure of SAD data.
@@ -1690,9 +1691,10 @@ GetSpdEntry (
       //
       CopyMem (SpdData->Name, SpdEntry->Data->Name, sizeof (SpdData->Name));
 
-      SpdData->PackageFlag  = SpdEntry->Data->PackageFlag;
-      SpdData->Action       = SpdEntry->Data->Action;
-
+      SpdData->PackageFlag      = SpdEntry->Data->PackageFlag;
+      SpdData->TrafficDirection = SpdEntry->Data->TrafficDirection;
+      SpdData->Action           = SpdEntry->Data->Action;
+      
       if (SpdData->Action != EfiIPsecActionProtect) {
         SpdData->ProcessingPolicy = NULL;
       } else {
diff --git a/NetworkPkg/IpSecDxe/IpSecImpl.h b/NetworkPkg/IpSecDxe/IpSecImpl.h
index 8b63d24b5200..89597bdc807b 100644
--- a/NetworkPkg/IpSecDxe/IpSecImpl.h
+++ b/NetworkPkg/IpSecDxe/IpSecImpl.h
@@ -76,6 +76,7 @@ typedef struct _EFI_ESP_TAIL {
 struct _IPSEC_SPD_DATA {
   CHAR16                    Name[100];
   UINT32                    PackageFlag;
+  EFI_IPSEC_TRAFFIC_DIR     TrafficDirection;
   EFI_IPSEC_ACTION          Action;
   EFI_IPSEC_PROCESS_POLICY  *ProcessingPolicy;
   LIST_ENTRY                Sas;

From 0fb361d8281b4b5cf919c7fbbd3b5f72f6403990 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Thu, 17 Sep 2015 00:55:32 +0000
Subject: [PATCH 047/525] NetworkPkg: Fix connection issue after correct SPD
 and re-enable IPsec
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This patch is used to fix connection failure issue after correct the SPD
and re-enable IPsec. The driver should not update the SadEntry's SpdSelector
when doing SpdEntry modification. SadEntry's SpdSelector may not equal to
this edited SpdEntry’s Selector.

(Sync patch r18484 from main trunk.)

Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18487 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/IpSecDxe/IpSecConfigImpl.c | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
index 6aa47aababfe..8c7724c7da80 100644
--- a/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
+++ b/NetworkPkg/IpSecDxe/IpSecConfigImpl.c
@@ -1204,12 +1204,7 @@ SetSpdEntry (
           RemoveEntryList (&SadEntry->BySpd);
         }
         InsertTailList (&SpdEntry->Data->Sas, &SadEntry->BySpd);
-        SadEntry->Data->SpdEntry = SpdEntry;
-        DuplicateSpdSelector (
-          (EFI_IPSEC_CONFIG_SELECTOR *)SadEntry->Data->SpdSelector,
-          (EFI_IPSEC_CONFIG_SELECTOR *)SpdEntry->Selector,
-          NULL
-          );             
+        SadEntry->Data->SpdEntry = SpdEntry;             
       }
     }
   }

From 1e15a0e60edae01782782ea3b5012c7032a660b2 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Thu, 17 Sep 2015 02:11:22 +0000
Subject: [PATCH 048/525] MdeModulePkg/HiiDatabase: Fix Progress not point to
 the correct place issue.

(Sync patch r18488 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18492 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/HiiDatabaseDxe/ConfigKeywordHandler.c    | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index e88a0c45975f..ccd6f820c68e 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -2979,6 +2979,8 @@ EfiConfigKeywordHandlerSetData (
   *ProgressErr = KEYWORD_HANDLER_NO_ERROR;
 
 Done:
+  *Progress = KeywordString + (StringPtr - TempString);
+
   ASSERT (TempString != NULL);
   FreePool (TempString);
   if (NameSpace != NULL) {
@@ -2998,8 +3000,8 @@ EfiConfigKeywordHandlerSetData (
   }
   if (MultiConfigResp != NULL && MultiConfigResp != ConfigResp) {
     FreePool (MultiConfigResp);
-  }  
-  *Progress = StringPtr;
+  }
+  
   return Status;
 }
 
@@ -3271,6 +3273,8 @@ EfiConfigKeywordHandlerGetData (
   *ProgressErr = KEYWORD_HANDLER_NO_ERROR;
 
 Done:
+  *Progress = KeywordString + (StringPtr - TempString);
+
   if (TempString != NULL) {
     FreePool (TempString);
   }
@@ -3283,6 +3287,6 @@ EfiConfigKeywordHandlerGetData (
   if (KeywordData != NULL) {
     FreePool (KeywordData);
   }
-  *Progress = StringPtr;
+
   return Status;
 }

From 0c9da39b512058153731ba35542ee781f33f5477 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Thu, 17 Sep 2015 02:11:53 +0000
Subject: [PATCH 049/525] MdeModulePkg/HiiDatabase: Refine
 KeywordHandlerProtocol->GetData().

Update this function to follow UEFI spec requirement.

(Sync patch r18489 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18493 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../HiiDatabaseDxe/ConfigKeywordHandler.c     | 23 +++++++++++++------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index ccd6f820c68e..b97866968714 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -1340,8 +1340,7 @@ GetStringIdFromRecord (
     if (AsciiStrnCmp(Name, StringPackage->StringPkgHdr->Language, AsciiStrLen (Name)) == 0) {
       Status = GetStringIdFromString (StringPackage, KeywordValue, StringId); 
       if (EFI_ERROR (Status)) {
-        RetVal = KEYWORD_HANDLER_KEYWORD_NOT_FOUND;
-        continue;
+        return KEYWORD_HANDLER_KEYWORD_NOT_FOUND;
       } else {
         if (*NameSpace == NULL) {
           *NameSpace = AllocateCopyPool (AsciiStrSize (StringPackage->StringPkgHdr->Language), StringPackage->StringPkgHdr->Language);
@@ -2556,6 +2555,7 @@ MergeToMultiKeywordResp (
 
   @param  NameSpace                      The namespace used to search the string.
   @param  MultiResp                      Return the MultiKeywordResp string for the system.
+  @param  ProgressErr                    Return the error status.
 
   @retval EFI_OUT_OF_RESOURCES           The memory can't be allocated.
   @retval EFI_SUCCESS                    Generate the MultiKeywordResp string.
@@ -2565,7 +2565,8 @@ MergeToMultiKeywordResp (
 EFI_STATUS
 EnumerateAllKeywords (
   IN  CHAR8             *NameSpace,
-  OUT EFI_STRING        *MultiResp
+  OUT EFI_STRING        *MultiResp,
+  OUT UINT32            *ProgressErr
   )
 {
   LIST_ENTRY                          *Link;
@@ -2585,6 +2586,7 @@ EnumerateAllKeywords (
   CHAR16                              *MultiKeywordResp;
   CHAR16                              *KeywordData;
   BOOLEAN                             ReadOnly;
+  BOOLEAN                             FindKeywordPackages;
 
   DataBaseRecord   = NULL;
   Status           = EFI_SUCCESS;
@@ -2594,6 +2596,7 @@ EnumerateAllKeywords (
   ConfigRequest    = NULL;
   ValueElement     = NULL;
   KeywordResp      = NULL;
+  FindKeywordPackages = FALSE;
 
   if (NameSpace == NULL) {
     NameSpace = UEFI_CONFIG_LANG;
@@ -2616,6 +2619,7 @@ EnumerateAllKeywords (
       // Check whether has keyword string package.
       //
       if (AsciiStrnCmp(NameSpace, StringPackage->StringPkgHdr->Language, AsciiStrLen (NameSpace)) == 0) {
+        FindKeywordPackages = TRUE;
         //
         // Keep the NameSpace string.
         //
@@ -2718,6 +2722,11 @@ EnumerateAllKeywords (
   //
   if (MultiKeywordResp == NULL) {
     Status = EFI_NOT_FOUND;
+    if (!FindKeywordPackages) {
+      *ProgressErr = KEYWORD_HANDLER_NAMESPACE_ID_NOT_FOUND;
+    } else {
+      *ProgressErr = KEYWORD_HANDLER_KEYWORD_NOT_FOUND;
+    }
   } else {
     Status = EFI_SUCCESS;
   }
@@ -2857,7 +2866,7 @@ EfiConfigKeywordHandlerSetData (
     // 1.1 Check whether the input namespace is valid.
     //
     if (AsciiStrnCmp(NameSpace, UEFI_CONFIG_LANG, AsciiStrLen (UEFI_CONFIG_LANG)) != 0) {
-      *ProgressErr = KEYWORD_HANDLER_UNDEFINED_PROCESSING_ERROR;
+      *ProgressErr = KEYWORD_HANDLER_MALFORMED_STRING;
       Status = EFI_INVALID_PARAMETER;
       goto Done;
     }
@@ -3133,7 +3142,7 @@ EfiConfigKeywordHandlerGetData (
     TempString = NULL;
   }
   if (EFI_ERROR (Status)) {
-    *ProgressErr = KEYWORD_HANDLER_NAMESPACE_ID_NOT_FOUND;
+    *ProgressErr = KEYWORD_HANDLER_MALFORMED_STRING;
     return Status;
   }
   //
@@ -3141,7 +3150,7 @@ EfiConfigKeywordHandlerGetData (
   //
   if (NameSpace != NULL){
     if (AsciiStrnCmp(NameSpace, UEFI_CONFIG_LANG, AsciiStrLen (UEFI_CONFIG_LANG)) != 0) {
-      *ProgressErr = KEYWORD_HANDLER_UNDEFINED_PROCESSING_ERROR;
+      *ProgressErr = KEYWORD_HANDLER_MALFORMED_STRING;
       return EFI_INVALID_PARAMETER;
     }
   }
@@ -3263,7 +3272,7 @@ EfiConfigKeywordHandlerGetData (
     //
     // Enumerate all keyword in the system.
     //
-    Status = EnumerateAllKeywords(NameSpace, &MultiKeywordResp);
+    Status = EnumerateAllKeywords(NameSpace, &MultiKeywordResp, ProgressErr);
     if (EFI_ERROR (Status)) {
       goto Done;
     }

From 873ad3b80c39a28895ec1550f4b39e0c3fcd0907 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Thu, 17 Sep 2015 02:17:53 +0000
Subject: [PATCH 050/525] MdeModulePkg/HiiDatabase: Refine
 KeywordHandlerProtocol->SetData().

Update this function to follow UEFI spec requirement.

(Sync patch r18490 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18494 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../HiiDatabaseDxe/ConfigKeywordHandler.c        | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index b97866968714..6923d6c47316 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -2829,6 +2829,7 @@ EfiConfigKeywordHandlerSetData (
   BOOLEAN                             ReadOnly;
   EFI_STRING                          InternalProgress;
   CHAR16                              *TempString;
+  CHAR16                              *KeywordStartPos;
 
   if (This == NULL || Progress == NULL || ProgressErr == NULL || KeywordString == NULL) {
     return EFI_INVALID_PARAMETER;
@@ -2843,6 +2844,7 @@ EfiConfigKeywordHandlerSetData (
   KeywordData     = NULL;
   ValueElement    = NULL;
   ConfigResp      = NULL;
+  KeywordStartPos = NULL;
   KeywordStringId = 0;
 
   //
@@ -2886,6 +2888,7 @@ EfiConfigKeywordHandlerSetData (
     //
     // 3. Extract keyword from the KeywordRequest string.
     //
+    KeywordStartPos = StringPtr;
     Status = ExtractKeyword(StringPtr, &KeywordData, &NextStringPtr);
     if (EFI_ERROR (Status)) {
       //
@@ -2942,8 +2945,8 @@ EfiConfigKeywordHandlerSetData (
     // 8. Check the readonly flag.
     //
     if (ExtractReadOnlyFromOpCode (OpCode) != ReadOnly) {
-      *ProgressErr = KEYWORD_HANDLER_INCOMPATIBLE_VALUE_DETECTED;
-      Status = EFI_INVALID_PARAMETER;
+      *ProgressErr = KEYWORD_HANDLER_ACCESS_NOT_PERMITTED;
+      Status = EFI_ACCESS_DENIED;
       goto Done;      
     }
     
@@ -2970,6 +2973,7 @@ EfiConfigKeywordHandlerSetData (
       FreePool (ConfigResp);
       ConfigResp = NULL;
     }
+    KeywordStartPos = NULL;
   }
 
   //
@@ -2988,7 +2992,11 @@ EfiConfigKeywordHandlerSetData (
   *ProgressErr = KEYWORD_HANDLER_NO_ERROR;
 
 Done:
-  *Progress = KeywordString + (StringPtr - TempString);
+  if (KeywordStartPos != NULL) {
+    *Progress = KeywordString + (KeywordStartPos - TempString);
+  } else {
+    *Progress = KeywordString + (StringPtr - TempString);
+  }
 
   ASSERT (TempString != NULL);
   FreePool (TempString);
@@ -3010,7 +3018,7 @@ EfiConfigKeywordHandlerSetData (
   if (MultiConfigResp != NULL && MultiConfigResp != ConfigResp) {
     FreePool (MultiConfigResp);
   }
-  
+
   return Status;
 }
 

From 43f4250c100629e13cd1692a8c36989c0a18b5e5 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 17 Sep 2015 05:33:07 +0000
Subject: [PATCH 051/525] MdePkg/SmmServicesTableLib: Return TRUE in InSmm ()

SmmServicesTableLib instance only supports DXE_SMM_DRIVER type drivers that
will be loaded into SMM range. InSmm() could return TRUE directly.

(Sync patch r18495 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Jiewen Yao <Jiewen.Yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18496 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmmServicesTableLib/SmmServicesTableLib.c | 30 ++++++-------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.c b/MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.c
index 23a85a0c68e5..81e5ce8e3f4e 100644
--- a/MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.c
+++ b/MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.c
@@ -1,7 +1,7 @@
 /** @file
   SMM Services Table Library.
 
-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -18,7 +18,6 @@
 #include <Library/DebugLib.h>
 
 EFI_SMM_SYSTEM_TABLE2   *gSmst             = NULL;
-EFI_SMM_BASE2_PROTOCOL  *mInternalSmmBase2 = NULL;
 
 /**
   The constructor function caches the pointer of SMM Services Table.
@@ -36,8 +35,10 @@ SmmServicesTableLibConstructor (
   IN EFI_SYSTEM_TABLE  *SystemTable
   )
 {
-  EFI_STATUS  Status;
+  EFI_STATUS              Status;
+  EFI_SMM_BASE2_PROTOCOL  *InternalSmmBase2;
 
+  InternalSmmBase2 = NULL;
   //
   // Retrieve SMM Base2 Protocol,  Do not use gBS from UefiBootServicesTableLib on purpose
   // to prevent inclusion of gBS, gST, and gImageHandle from SMM Drivers unless the 
@@ -46,25 +47,15 @@ SmmServicesTableLibConstructor (
   Status = SystemTable->BootServices->LocateProtocol (
                                         &gEfiSmmBase2ProtocolGuid,
                                         NULL,
-                                        (VOID **)&mInternalSmmBase2
+                                        (VOID **)&InternalSmmBase2
                                         );
   ASSERT_EFI_ERROR (Status);
-  ASSERT (mInternalSmmBase2 != NULL);
-
-  //
-  // Check to see if we are already in SMM
-  //
-  if (!InSmm ()) {
-    //
-    // We are not in SMM, so SMST is not needed
-    //
-    return EFI_SUCCESS;
-  }
+  ASSERT (InternalSmmBase2 != NULL);
 
   //
   // We are in SMM, retrieve the pointer to SMM System Table
   //
-  mInternalSmmBase2->GetSmstLocation (mInternalSmmBase2, &gSmst);
+  InternalSmmBase2->GetSmstLocation (InternalSmmBase2, &gSmst);
   ASSERT (gSmst != NULL);
 
   return EFI_SUCCESS;
@@ -87,11 +78,8 @@ InSmm (
   VOID
   )
 {
-  BOOLEAN  InSmm;
-
   //
-  // Check to see if we are already in SMM
+  // We are already in SMM
   //
-  mInternalSmmBase2->InSmm (mInternalSmmBase2, &InSmm);
-  return InSmm;
+  return TRUE;
 }

From b523178555ad499ccd223b88258ec48f899edbad Mon Sep 17 00:00:00 2001
From: Dandan Bi <dandan.bi@intel.com>
Date: Thu, 17 Sep 2015 07:37:44 +0000
Subject: [PATCH 052/525] MdeModulePkg:Fix the bug the incorrect change of
 StrCpyS function

The pointer to the destination string changed,the max length also changed.Previous change neglect this point.
And base on the code logic,we can use StrCatS to replace StrCpyS.Now this patch is to fix this bug.

(Sync patch r18497 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <dandan.bi@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18498 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/UefiHiiLib/HiiLib.c      |  4 +-
 .../HiiDatabaseDxe/ConfigKeywordHandler.c     | 65 ++++++-------------
 2 files changed, 23 insertions(+), 46 deletions(-)

diff --git a/MdeModulePkg/Library/UefiHiiLib/HiiLib.c b/MdeModulePkg/Library/UefiHiiLib/HiiLib.c
index bee5e0d22cfa..66d72acf2755 100644
--- a/MdeModulePkg/Library/UefiHiiLib/HiiLib.c
+++ b/MdeModulePkg/Library/UefiHiiLib/HiiLib.c
@@ -662,7 +662,7 @@ HiiConstructConfigHdr (
   //
   // Append L"&NAME="
   //
-  StrCpyS (String, MaxLen, L"&NAME=");
+  StrCatS (ReturnString, MaxLen, L"&NAME=");
   String += StrLen (String);
 
   if (Name != NULL) {
@@ -677,7 +677,7 @@ HiiConstructConfigHdr (
   //
   // Append L"&PATH="
   //
-  StrCpyS (String, MaxLen, L"&PATH=");
+  StrCatS (ReturnString, MaxLen, L"&PATH=");
   String += StrLen (String);
 
   //
diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index 6923d6c47316..52aa4d8bcf0b 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -1758,7 +1758,7 @@ ConstructConfigHdr (
   //
   // Append L"&NAME="
   //
-  StrCpyS (String, MaxLen, L"&NAME=");
+  StrCatS (ReturnString, MaxLen, L"&NAME=");
   String += StrLen (String);
 
   if (Name != NULL) {
@@ -1773,7 +1773,7 @@ ConstructConfigHdr (
   //
   // Append L"&PATH="
   //
-  StrCpyS (String, MaxLen, L"&PATH=");
+  StrCatS (ReturnString, MaxLen, L"&PATH=");
   String += StrLen (String);
 
   //
@@ -2044,14 +2044,10 @@ ExtractConfigRequest (
       StringPtr = *ConfigRequest;
 
       StrCpyS (StringPtr, MaxLen, ConfigHdr);
-      StringPtr += StrLen (StringPtr);
 
-      *StringPtr = L'&';
-      StringPtr++;
+      StrCatS (StringPtr, MaxLen, L"&");
 
-      StrCpyS (StringPtr, MaxLen, RequestElement);
-      StringPtr += StrLen (StringPtr);
-      *StringPtr = L'\0';
+      StrCatS (StringPtr, MaxLen, RequestElement);
 
       FreePool (ConfigHdr);
       FreePool (RequestElement);
@@ -2152,23 +2148,17 @@ ExtractConfigResp (
       StringPtr = *ConfigResp;
 
       StrCpyS (StringPtr, MaxLen, ConfigHdr);
-      StringPtr += StrLen (StringPtr);
 
-      *StringPtr = L'&';
-      StringPtr++;
+      StrCatS (StringPtr, MaxLen, L"&");
 
-      StrCpyS (StringPtr, MaxLen, RequestElement);
-      StringPtr += StrLen (StringPtr);
-      
-      *StringPtr = L'&';
-      StringPtr++;
 
-      StrCpyS (StringPtr, MaxLen, L"VALUE=");
-      StringPtr += StrLen (StringPtr);
+      StrCatS (StringPtr, MaxLen, RequestElement);
+
+      StrCatS (StringPtr, MaxLen, L"&");
+
+      StrCatS (StringPtr, MaxLen, L"VALUE=");
 
-      StrCpyS (StringPtr, MaxLen, ValueElement);
-      StringPtr += StrLen (StringPtr);
-      *StringPtr = L'\0';
+      StrCatS (StringPtr, MaxLen, ValueElement);
 
       FreePool (ConfigHdr);
       FreePool (RequestElement);
@@ -2452,43 +2442,33 @@ GenerateKeywordResp (
   // 2.1 Copy NameSpaceId section.
   //
   StrCpyS (RespStr, RespStrLen, L"NAMESPACE=");
-  RespStr += StrLen (RespStr);
-  StrCpyS (RespStr, RespStrLen, UnicodeNameSpace);
-  RespStr += StrLen (RespStr);
+
+  StrCatS (RespStr, RespStrLen, UnicodeNameSpace);
 
   //
   // 2.2 Copy PathHdr section.
   //
-  StrCpyS (RespStr, RespStrLen, PathHdr);
-  RespStr += StrLen (RespStr);
+  StrCatS (RespStr, RespStrLen, PathHdr);
 
   //
   // 2.3 Copy Keyword section.
   //
-  StrCpyS (RespStr, RespStrLen, L"KEYWORD=");
-  RespStr += StrLen (RespStr);
-  StrCpyS (RespStr, RespStrLen, KeywordData);
-  RespStr += StrLen (RespStr);
+  StrCatS (RespStr, RespStrLen, L"KEYWORD=");
+
+  StrCatS (RespStr, RespStrLen, KeywordData);
 
   //
   // 2.4 Copy the Value section.
   //
-  StrCpyS (RespStr, RespStrLen, ValueStr);
-  RespStr += StrLen (RespStr);
+  StrCatS (RespStr, RespStrLen, ValueStr);
 
   //
   // 2.5 Copy ReadOnly section if exist.
   //
   if (ReadOnly) {
-    StrCpyS (RespStr, RespStrLen, L"&READONLY");
-    RespStr += StrLen (RespStr);
+    StrCatS (RespStr, RespStrLen, L"&READONLY");
   }
 
-  //
-  // 2.6 Add the end.
-  //
-  *RespStr = L'\0';
-
   if (UnicodeNameSpace != NULL) {
     FreePool (UnicodeNameSpace);
   }
@@ -2536,12 +2516,9 @@ MergeToMultiKeywordResp (
   FreePool (*MultiKeywordResp);
   *MultiKeywordResp = StringPtr;
 
-  StringPtr += StrLen (StringPtr);
-
-  *StringPtr = L'&';
-  StringPtr++;
+  StrCatS (StringPtr, MultiKeywordRespLen / sizeof (CHAR16), L"&");
 
-  StrCpyS (StringPtr, MultiKeywordRespLen / sizeof (CHAR16), *KeywordResp);
+  StrCatS (StringPtr, MultiKeywordRespLen / sizeof (CHAR16), *KeywordResp);
 
   return EFI_SUCCESS;
 }

From ef89277916d65046c9853e23aaf7db67ab34956f Mon Sep 17 00:00:00 2001
From: Yang Jadis <jadis.yang@intel.com>
Date: Fri, 18 Sep 2015 01:18:34 +0000
Subject: [PATCH 053/525] ShellPkg: Fix Shell fail when execute command in
 ShellProtocol.Execute().

When execute a command with tailing blank spaces in ShellProtocol.Execute() Shell will fail.
This patch move the TrimSpaces operation into ParseCommandLineToArgs function to fix the problem.

(Sync patch r18491 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yang Jadis <jadis.yang@intel.com>
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18501 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellParametersProtocol.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.c b/ShellPkg/Application/Shell/ShellParametersProtocol.c
index bc19df7e931e..b40498734044 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.c
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.c
@@ -206,6 +206,7 @@ ParseCommandLineToArgs(
     return (EFI_SUCCESS);
   }
 
+  TrimSpaces(&(CHAR16*)CommandLine);
   Size = StrSize(CommandLine);
   TempParameter = AllocateZeroPool(Size);
   if (TempParameter == NULL) {
@@ -359,7 +360,6 @@ CreatePopulateInstallShellParametersProtocol (
     //
     // Populate Argc and Argv
     //
-    TrimSpaces (&FullCommandLine);
     Status = ParseCommandLineToArgs(FullCommandLine,
                                     &(*NewShellParameters)->Argv,
                                     &(*NewShellParameters)->Argc);

From 3465020defae51cb5af69a6f65a2c3de8e06e08e Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Sep 2015 01:19:00 +0000
Subject: [PATCH 054/525] ShellPkg: Fix GCC build fail and code refine.

1. Fix GCC build fail.
2. It's not correct to cast away constness to allow TrimSpaces() to modify 'commandline'.
   This patch makes a copy of 'commandLine' and work with that in the remainder of the function.

(Sync patch r18500 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18502 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Shell/ShellParametersProtocol.c           | 34 +++++++++++++------
 1 file changed, 23 insertions(+), 11 deletions(-)

diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.c b/ShellPkg/Application/Shell/ShellParametersProtocol.c
index b40498734044..bbe026b644b2 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.c
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.c
@@ -195,7 +195,9 @@ ParseCommandLineToArgs(
   CHAR16      *TempParameter;
   CHAR16      *Walker;
   CHAR16      *NewParam;
+  CHAR16      *NewCommandLine;
   UINTN       Size;
+  EFI_STATUS  Status;
 
   ASSERT(Argc != NULL);
   ASSERT(Argv != NULL);
@@ -206,15 +208,21 @@ ParseCommandLineToArgs(
     return (EFI_SUCCESS);
   }
 
-  TrimSpaces(&(CHAR16*)CommandLine);
-  Size = StrSize(CommandLine);
+  NewCommandLine = AllocateCopyPool(StrSize(CommandLine), CommandLine);
+  if (NewCommandLine == NULL){
+    return (EFI_OUT_OF_RESOURCES);
+  }
+
+  TrimSpaces(&NewCommandLine);
+  Size = StrSize(NewCommandLine);
   TempParameter = AllocateZeroPool(Size);
   if (TempParameter == NULL) {
+    SHELL_FREE_NON_NULL(NewCommandLine);
     return (EFI_OUT_OF_RESOURCES);
   }
 
   for ( Count = 0
-      , Walker = (CHAR16*)CommandLine
+      , Walker = (CHAR16*)NewCommandLine
       ; Walker != NULL && *Walker != CHAR_NULL
       ; Count++
       ) {
@@ -228,30 +236,34 @@ ParseCommandLineToArgs(
   //
   (*Argv) = AllocateZeroPool((Count)*sizeof(CHAR16*));
   if (*Argv == NULL) {
-    SHELL_FREE_NON_NULL(TempParameter);
-    return (EFI_OUT_OF_RESOURCES);
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Done;
   }
 
   *Argc = 0;
-  Walker = (CHAR16*)CommandLine;
+  Walker = (CHAR16*)NewCommandLine;
   while(Walker != NULL && *Walker != CHAR_NULL) {
     SetMem16(TempParameter, Size, CHAR_NULL);
     if (EFI_ERROR(GetNextParameter(&Walker, &TempParameter, Size))) {
-      SHELL_FREE_NON_NULL(TempParameter);
-      return (EFI_INVALID_PARAMETER);
+      Status = EFI_INVALID_PARAMETER;
+      goto Done;
     }
 
     NewParam = AllocateCopyPool(StrSize(TempParameter), TempParameter);
     if (NewParam == NULL){
-      SHELL_FREE_NON_NULL(TempParameter);
-      return (EFI_OUT_OF_RESOURCES);
+      Status = EFI_OUT_OF_RESOURCES;
+      goto Done;
     }
     ((CHAR16**)(*Argv))[(*Argc)] = NewParam;
     (*Argc)++;
   }
   ASSERT(Count >= (*Argc));
+  Status = EFI_SUCCESS;
+  
+Done:
   SHELL_FREE_NON_NULL(TempParameter);
-  return (EFI_SUCCESS);
+  SHELL_FREE_NON_NULL(NewCommandLine);
+  return (Status);
 }
 
 /**

From b2024e34bef646cd76f8cc251f58dabf38ba21d8 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Fri, 18 Sep 2015 02:33:47 +0000
Subject: [PATCH 055/525] MdeModulePkg DxeCore: Relocate HOB List after other
 tested memory resources added

The HOB List relocation should be at after all the tested memory resources added
(except the memory space that covers HOB List) to the memory services,
because the memory resource found in CoreInitializeMemoryServices()
may have not enough remaining resource for HOB List.

And the memory space that covers HOB List should be processed
after HOB List relocation to avoid the resources allocated by others
to corrupt HOB List before its relocation.

(Sync patch r18499 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18504 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Dxe/Gcd/Gcd.c | 65 +++++++++++++++++++++++++++------
 1 file changed, 53 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
index a50fda2466da..77586a9ac8f3 100644
--- a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
+++ b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
@@ -2311,6 +2311,7 @@ CoreInitializeGcdServices (
   UINTN                              Index;
   UINT64                             Capabilities;
   EFI_HOB_CPU *                      CpuHob;
+  EFI_GCD_MEMORY_SPACE_DESCRIPTOR    *MemorySpaceMapHobList;
 
   //
   // Cache the PHIT HOB for later use
@@ -2493,24 +2494,13 @@ CoreInitializeGcdServices (
     }
   }
 
-  //
-  // Relocate HOB List to an allocated pool buffer.
-  //
-  NewHobList = AllocateCopyPool (
-                 (UINTN)PhitHob->EfiFreeMemoryBottom - (UINTN)(*HobStart),
-                 *HobStart
-                 );
-  ASSERT (NewHobList != NULL);
-
-  *HobStart = NewHobList;
-  gHobList  = NewHobList;
-
   //
   // Add and allocate the remaining unallocated system memory to the memory services.
   //
   Status = CoreGetMemorySpaceMap (&NumberOfDescriptors, &MemorySpaceMap);
   ASSERT (Status == EFI_SUCCESS);
 
+  MemorySpaceMapHobList = NULL;
   for (Index = 0; Index < NumberOfDescriptors; Index++) {
     if ((MemorySpaceMap[Index].GcdMemoryType == EfiGcdMemoryTypeSystemMemory) ||
         (MemorySpaceMap[Index].GcdMemoryType == EfiGcdMemoryTypeMoreReliable)) {
@@ -2520,6 +2510,16 @@ CoreInitializeGcdServices (
         if (Length == 0 || MemorySpaceMap[Index].BaseAddress + MemorySpaceMap[Index].Length < BaseAddress) {
           continue;
         }
+        if (((UINTN) MemorySpaceMap[Index].BaseAddress <= (UINTN) (*HobStart)) &&
+            ((UINTN) (MemorySpaceMap[Index].BaseAddress + MemorySpaceMap[Index].Length) >= (UINTN) PhitHob->EfiFreeMemoryBottom)) {
+          //
+          // Skip the memory space that covers HOB List, it should be processed
+          // after HOB List relocation to avoid the resources allocated by others
+          // to corrupt HOB List before its relocation.
+          //
+          MemorySpaceMapHobList = &MemorySpaceMap[Index];
+          continue;
+        }
         CoreAddMemoryDescriptor (
           EfiConventionalMemory,
           BaseAddress,
@@ -2538,6 +2538,47 @@ CoreInitializeGcdServices (
       }
     }
   }
+
+  //
+  // Relocate HOB List to an allocated pool buffer.
+  // The relocation should be at after all the tested memory resources added
+  // (except the memory space that covers HOB List) to the memory services,
+  // because the memory resource found in CoreInitializeMemoryServices()
+  // may have not enough remaining resource for HOB List.
+  //
+  NewHobList = AllocateCopyPool (
+                 (UINTN) PhitHob->EfiFreeMemoryBottom - (UINTN) (*HobStart),
+                 *HobStart
+                 );
+  ASSERT (NewHobList != NULL);
+
+  *HobStart = NewHobList;
+  gHobList  = NewHobList;
+
+  if (MemorySpaceMapHobList != NULL) {
+    //
+    // Add and allocate the memory space that covers HOB List to the memory services
+    // after HOB List relocation.
+    //
+    BaseAddress = PageAlignAddress (MemorySpaceMapHobList->BaseAddress);
+    Length      = PageAlignLength  (MemorySpaceMapHobList->BaseAddress + MemorySpaceMapHobList->Length - BaseAddress);
+    CoreAddMemoryDescriptor (
+      EfiConventionalMemory,
+      BaseAddress,
+      RShiftU64 (Length, EFI_PAGE_SHIFT),
+      MemorySpaceMapHobList->Capabilities & (~EFI_MEMORY_RUNTIME)
+      );
+    Status = CoreAllocateMemorySpace (
+               EfiGcdAllocateAddress,
+               MemorySpaceMapHobList->GcdMemoryType,
+               0,
+               Length,
+               &BaseAddress,
+               gDxeCoreImageHandle,
+               NULL
+               );
+  }
+
   CoreFreePool (MemorySpaceMap);
 
   return EFI_SUCCESS;

From 8c5f576fe1dbac6ad49bda3c17912321d0d1fff9 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Fri, 18 Sep 2015 02:35:23 +0000
Subject: [PATCH 056/525] MdeModulePkg DxeCore: Take the range in resource HOB
 for PHIT as higher priority

Take the range in the resource descriptor HOB for the memory region described
by the PHIT as higher priority if it is big enough. It can make the memory bin
allocated to be at the same memory region with PHIT that has more better compatibility
to avoid memory fragmentation for some code practices assume and allocate <4G ACPI memory.

Also let the minimal memory size needed include the total memory bin size needed to
make sure memory bin could be allocated successfully.

(Sync patch r18503 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18505 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Dxe/Gcd/Gcd.c | 163 +++++++++++++++++++-------------
 1 file changed, 95 insertions(+), 68 deletions(-)

diff --git a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
index 77586a9ac8f3..c2769622581d 100644
--- a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
+++ b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
@@ -2003,6 +2003,30 @@ CoreConvertResourceDescriptorHobAttributesToCapabilities (
   return Capabilities;
 }
 
+/**
+  Calculate total memory bin size neeeded.
+
+  @return The total memory bin size neeeded.
+
+**/
+UINT64
+CalculateTotalMemoryBinSizeNeeded (
+  VOID
+  )
+{
+  UINTN     Index;
+  UINT64    TotalSize;
+
+  //
+  // Loop through each memory type in the order specified by the gMemoryTypeInformation[] array
+  //
+  TotalSize = 0;
+  for (Index = 0; gMemoryTypeInformation[Index].Type != EfiMaxMemoryType; Index++) {
+    TotalSize += LShiftU64 (gMemoryTypeInformation[Index].NumberOfPages, EFI_PAGE_SHIFT);
+  }
+
+  return TotalSize;
+}
 
 /**
   External function. Initializes memory services based on the memory
@@ -2044,7 +2068,8 @@ CoreInitializeMemoryServices (
   UINT64                             TestedMemoryLength;
   EFI_PHYSICAL_ADDRESS               HighAddress;
   EFI_HOB_GUID_TYPE                  *GuidHob;
-  UINT32                              ReservedCodePageNumber;
+  UINT32                             ReservedCodePageNumber;
+  UINT64                             MinimalMemorySizeNeeded;
 
   //
   // Point at the first HOB.  This must be the PHIT HOB.
@@ -2097,10 +2122,14 @@ CoreInitializeMemoryServices (
     }
   }
 
+  //
+  // Include the total memory bin size needed to make sure memory bin could be allocated successfully.
+  //
+  MinimalMemorySizeNeeded = MINIMUM_INITIAL_MEMORY_SIZE + CalculateTotalMemoryBinSizeNeeded ();
+
   //
   // Find the Resource Descriptor HOB that contains PHIT range EfiFreeMemoryBottom..EfiFreeMemoryTop
   //
-  Length = 0;
   Found  = FALSE;
   for (Hob.Raw = *HobStart; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {
     //
@@ -2138,19 +2167,19 @@ CoreInitializeMemoryServices (
     Found = TRUE;
 
     //
-    // Compute range between PHIT EfiFreeMemoryTop and the end of the Resource Descriptor HOB
+    // Compute range between PHIT EfiMemoryTop and the end of the Resource Descriptor HOB
     //
     Attributes  = PhitResourceHob->ResourceAttribute;
     BaseAddress = PageAlignAddress (PhitHob->EfiMemoryTop);
     Length      = PageAlignLength  (ResourceHob->PhysicalStart + ResourceHob->ResourceLength - BaseAddress);
-    if (Length < MINIMUM_INITIAL_MEMORY_SIZE) {
+    if (Length < MinimalMemorySizeNeeded) {
       //
       // If that range is not large enough to intialize the DXE Core, then 
       // Compute range between PHIT EfiFreeMemoryBottom and PHIT EfiFreeMemoryTop
       //
       BaseAddress = PageAlignAddress (PhitHob->EfiFreeMemoryBottom);
       Length      = PageAlignLength  (PhitHob->EfiFreeMemoryTop - BaseAddress);
-      if (Length < MINIMUM_INITIAL_MEMORY_SIZE) {
+      if (Length < MinimalMemorySizeNeeded) {
         //
         // If that range is not large enough to intialize the DXE Core, then 
         // Compute range between the start of the Resource Descriptor HOB and the start of the HOB List
@@ -2168,81 +2197,79 @@ CoreInitializeMemoryServices (
   ASSERT (Found);
 
   //
-  // Search all the resource descriptor HOBs from the highest possible addresses down for a memory
-  // region that is big enough to initialize the DXE core.  Always skip the PHIT Resource HOB.
-  // The max address must be within the physically addressible range for the processor.
+  // Take the range in the resource descriptor HOB for the memory region described
+  // by the PHIT as higher priority if it is big enough. It can make the memory bin
+  // allocated to be at the same memory region with PHIT that has more better compatibility
+  // to avoid memory fragmentation for some code practices assume and allocate <4G ACPI memory.
   //
-  HighAddress = MAX_ADDRESS;
-  for (Hob.Raw = *HobStart; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {
-    //
-    // Skip the Resource Descriptor HOB that contains the PHIT
-    //
-    if (Hob.ResourceDescriptor == PhitResourceHob) {
-      continue;
-    }
+  if (Length < MinimalMemorySizeNeeded) {
     //
-    // Skip all HOBs except Resource Descriptor HOBs
+    // Search all the resource descriptor HOBs from the highest possible addresses down for a memory
+    // region that is big enough to initialize the DXE core.  Always skip the PHIT Resource HOB.
+    // The max address must be within the physically addressible range for the processor.
     //
-    if (GET_HOB_TYPE (Hob) != EFI_HOB_TYPE_RESOURCE_DESCRIPTOR) {
-      continue;
-    }
+    HighAddress = MAX_ADDRESS;
+    for (Hob.Raw = *HobStart; !END_OF_HOB_LIST(Hob); Hob.Raw = GET_NEXT_HOB(Hob)) {
+      //
+      // Skip the Resource Descriptor HOB that contains the PHIT
+      //
+      if (Hob.ResourceDescriptor == PhitResourceHob) {
+        continue;
+      }
+      //
+      // Skip all HOBs except Resource Descriptor HOBs
+      //
+      if (GET_HOB_TYPE (Hob) != EFI_HOB_TYPE_RESOURCE_DESCRIPTOR) {
+        continue;
+      }
 
-    //
-    // Skip Resource Descriptor HOBs that do not describe tested system memory below MAX_ADDRESS
-    //
-    ResourceHob = Hob.ResourceDescriptor;
-    if (ResourceHob->ResourceType != EFI_RESOURCE_SYSTEM_MEMORY) {
-      continue;
-    }
-    if ((ResourceHob->ResourceAttribute & MEMORY_ATTRIBUTE_MASK) != TESTED_MEMORY_ATTRIBUTES) {
-      continue;
-    }
-    if ((ResourceHob->PhysicalStart + ResourceHob->ResourceLength) > (EFI_PHYSICAL_ADDRESS)MAX_ADDRESS) {
-      continue;
-    }
-    
-    //
-    // Skip Resource Descriptor HOBs that are below a previously found Resource Descriptor HOB
-    //
-    if (HighAddress != (EFI_PHYSICAL_ADDRESS)MAX_ADDRESS && ResourceHob->PhysicalStart <= HighAddress) {
-      continue;
-    }
+      //
+      // Skip Resource Descriptor HOBs that do not describe tested system memory below MAX_ADDRESS
+      //
+      ResourceHob = Hob.ResourceDescriptor;
+      if (ResourceHob->ResourceType != EFI_RESOURCE_SYSTEM_MEMORY) {
+        continue;
+      }
+      if ((ResourceHob->ResourceAttribute & MEMORY_ATTRIBUTE_MASK) != TESTED_MEMORY_ATTRIBUTES) {
+        continue;
+      }
+      if ((ResourceHob->PhysicalStart + ResourceHob->ResourceLength) > (EFI_PHYSICAL_ADDRESS)MAX_ADDRESS) {
+        continue;
+      }
 
-    //
-    // Skip Resource Descriptor HOBs that are not large enough to initilize the DXE Core
-    //
-    TestedMemoryBaseAddress = PageAlignAddress (ResourceHob->PhysicalStart);
-    TestedMemoryLength      = PageAlignLength  (ResourceHob->PhysicalStart + ResourceHob->ResourceLength - TestedMemoryBaseAddress);
-    if (TestedMemoryLength < MINIMUM_INITIAL_MEMORY_SIZE) {
-      continue;
+      //
+      // Skip Resource Descriptor HOBs that are below a previously found Resource Descriptor HOB
+      //
+      if (HighAddress != (EFI_PHYSICAL_ADDRESS)MAX_ADDRESS && ResourceHob->PhysicalStart <= HighAddress) {
+        continue;
+      }
+
+      //
+      // Skip Resource Descriptor HOBs that are not large enough to initilize the DXE Core
+      //
+      TestedMemoryBaseAddress = PageAlignAddress (ResourceHob->PhysicalStart);
+      TestedMemoryLength      = PageAlignLength  (ResourceHob->PhysicalStart + ResourceHob->ResourceLength - TestedMemoryBaseAddress);
+      if (TestedMemoryLength < MinimalMemorySizeNeeded) {
+        continue;
+      }
+
+      //
+      // Save the range described by the Resource Descriptor that is large enough to initilize the DXE Core
+      //
+      BaseAddress = TestedMemoryBaseAddress;
+      Length      = TestedMemoryLength;
+      Attributes  = ResourceHob->ResourceAttribute; 
+      HighAddress = ResourceHob->PhysicalStart;
     }
-    
-    //
-    // Save the Resource Descriptor HOB context that is large enough to initilize the DXE Core
-    //
-    MaxMemoryBaseAddress = TestedMemoryBaseAddress;
-    MaxMemoryLength      = TestedMemoryLength;
-    MaxMemoryAttributes  = ResourceHob->ResourceAttribute; 
-    HighAddress          = ResourceHob->PhysicalStart;
   }
 
-  //
-  // If Length is not large enough to initialize the DXE Core or a Resource 
-  // Descriptor HOB was found above the PHIT HOB that is large enough to initialize 
-  // the DXE Core, then use the range described by the Resource Descriptor 
-  // HOB that was found above the PHIT HOB.
-  //
-  if ((Length < MINIMUM_INITIAL_MEMORY_SIZE) ||
-      (MaxMemoryBaseAddress > BaseAddress && MaxMemoryLength >= MINIMUM_INITIAL_MEMORY_SIZE)) {
-    BaseAddress = MaxMemoryBaseAddress;
-    Length      = MaxMemoryLength;
-    Attributes  = MaxMemoryAttributes;
-  }
+  DEBUG ((EFI_D_INFO, "CoreInitializeMemoryServices:\n"));
+  DEBUG ((EFI_D_INFO, "  BaseAddress - 0x%lx Length - 0x%lx MinimalMemorySizeNeeded - 0x%lx\n", BaseAddress, Length, MinimalMemorySizeNeeded));
 
   //
   // If no memory regions are found that are big enough to initialize the DXE core, then ASSERT().
   //
-  ASSERT (Length >= MINIMUM_INITIAL_MEMORY_SIZE);
+  ASSERT (Length >= MinimalMemorySizeNeeded);
 
   //
   // Convert the Resource HOB Attributes to an EFI Memory Capabilities mask

From 4b291a290e9c99a4306a73df1d9260e0025fcbe1 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Fri, 18 Sep 2015 03:03:38 +0000
Subject: [PATCH 057/525] ShellPkg: Added SMBIOS 3.0 support in dmem.

Added SMBIOS 3.0 support in dmdem Shell command since SMBIOS 3.0 uses a different GUID in the System Configuration Table.

(Sync patch r18506 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18509 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellDebug1CommandsLib/Dmem.c | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/Dmem.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/Dmem.c
index 05dc0d56d599..7693835b8865 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/Dmem.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/Dmem.c
@@ -1,8 +1,9 @@
 /** @file
   Main file for Dmem shell Debug1 function.
 
-  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
   Copyright (c) 2010 - 2011, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>  
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>  
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -193,6 +194,10 @@ ShellCommandRunDmem (
               SmbiosTableAddress = (UINT64)(UINTN)gST->ConfigurationTable[TableWalker].VendorTable;
               continue;
             }
+            if (CompareGuid (&gST->ConfigurationTable[TableWalker].VendorGuid, &gEfiSmbios3TableGuid)) {
+              SmbiosTableAddress = (UINT64) (UINTN) gST->ConfigurationTable[TableWalker].VendorTable;
+              continue;
+            }
             if (CompareGuid(&gST->ConfigurationTable[TableWalker].VendorGuid, &gEfiMpsTableGuid)) {
               MpsTableAddress = (UINT64)(UINTN)gST->ConfigurationTable[TableWalker].VendorTable;
               continue;

From 1ee59ed17339e3cda0141e3080792fc12f147056 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Fri, 18 Sep 2015 03:04:04 +0000
Subject: [PATCH 058/525] ShellPkg: Added SMBIOS 2.8 Type 17 changes to
 smbiosview

Updated smbiosview to decode SMBIOS Type 17 MinimumVoltage, MaximumVoltage, and ConfiguredVoltage

(Sync patch r18507 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18510 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c     | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
index 1494c47e3709..e348c6f25c3a 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
@@ -2,7 +2,8 @@
   Module for clarifying the content of the smbios structure element information.
 
   Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
-  (C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>
+  (C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>  
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -721,6 +722,11 @@ SmbiosPrintStructure (
       PRINT_STRUCT_VALUE (Struct, Type17, ExtendedSize);
       PRINT_STRUCT_VALUE (Struct, Type17, ConfiguredMemoryClockSpeed);
     }
+    if (AE_SMBIOS_VERSION (0x2, 0x8) && (Struct->Hdr->Length > 0x22)) {
+      PRINT_STRUCT_VALUE (Struct, Type17, MinimumVoltage);
+      PRINT_STRUCT_VALUE (Struct, Type17, MaximumVoltage);
+      PRINT_STRUCT_VALUE (Struct, Type17, ConfiguredVoltage);
+    }
     break;
 
   //

From 8df1f5edda8abc91c33ffb12d649ecf449ba2523 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Sep 2015 06:25:27 +0000
Subject: [PATCH 059/525] ShellBinPkg: Ia32/X64 Shell binary update.

The binaries of ShellBinPkg are generated with ShellPkg project 18507. The binaries are built with no debug information by building with "RELEASE" target.

(Sync patch r18511 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18512 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellBinPkg/MinUefiShell/Ia32/Shell.efi | Bin 339136 -> 338944 bytes
 ShellBinPkg/MinUefiShell/X64/Shell.efi  | Bin 382336 -> 382528 bytes
 ShellBinPkg/ReadMe.txt                  |   2 +-
 ShellBinPkg/UefiShell/Ia32/Shell.efi    | Bin 801984 -> 801824 bytes
 ShellBinPkg/UefiShell/X64/Shell.efi     | Bin 895232 -> 896800 bytes
 5 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/ShellBinPkg/MinUefiShell/Ia32/Shell.efi b/ShellBinPkg/MinUefiShell/Ia32/Shell.efi
index ed01d4626cd73a38868ec7238d02f79d3daf4e27..154171811e70c20ebee9af11b471120829c32054 100644
GIT binary patch
delta 121400
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
S{~u9jAUkd&7nqtY-~R)4v1&H}

delta 121076
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
C(rt7A

diff --git a/ShellBinPkg/MinUefiShell/X64/Shell.efi b/ShellBinPkg/MinUefiShell/X64/Shell.efi
index 3e4f6c58847ab10fc4b34ca44b836a2abe1e434e..e7370161693f522520fc3b3499258aa7b596f22d 100644
GIT binary patch
delta 103813
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

delta 103775
zcma%E30#!L``=x55nb2CV-*i{5m4|%5e4yB6m-!=@jx-}BagDg1oLb$z+7K9k1@5&
zBP;FjD9ZznNKH@_QS-_&`;|3@8D=TvvH$Ng?=0f>`+YutKA)O*o@<_Y=9y<^o_F50
z;Nu3_A2nEUNULA@g{5}EM+VKfmKyPAy`$5NTX{XykbNFNX3~!Izjnr;S?#wnVK6Ju
z28`ZG#5#>eFrlpaXVqw?dh18)X*AaD2F*2Ddf`;sG@4%R=1dx&IbNgrwiW<KKu0A@
z(KWWN_S0yn&5g1Iyz<Wm&OO=tb+%g0ofCn_-_cC9%*|3u+e>QsR<>GZ&r{2cRJFV*
z%j}_QJ#4UA1`SlpWwX^X;zhNLovD^#PfNU7IyHYjr2^hvpq4kss^w3zd`rSR4O8Kl
zn&^eXqk`2kb&Lw1IzTOhMyqA6#IKWOfh>1Qxm?tp8qL=dp>L`RJUK%Z@Y7VaEN`a5
zS4%~|9-+d87Wf~Ho)-U=%7(4as`%1p)bi*HPtvQ@U|0`$AC&qxR040AN{A}(iZ|8z
z|0=<^GNJt-(gA-y%wC~h=9&`kt^cp`|0Oj2|0&Gd$p1^ImpJzSDO?DRF;-K%uSq?r
zTUpz(C;gOeT(js=SJb&BZKD|{>)sg`v`c+b4UBnrMYp!>rY_id^i6fp16Qb}PD)6W
z@Y3Zf+)u(+tW@hOB)y+(VbmKwaM{wNRX%XFswq<GotjEP2DM*9nGb`%3eQ~Q12?Mh
zuYKV)Rru6(KJ+FPp8k4OIHrYPbrtc}+Nub^DZ=2d)VBvURQOw~eduee@YL6Q;B{2^
zPG5Lkz=z?#2%jG4rK!VwOs$uue&7q2rmmvU%G%+Jf7dPk-Ea5r`b*uTSIqMIfvU=Q
zwa{$zflrX|piJFbV_QRtGc`bk9383l$?HBDa<JMwt-{s+Yc%5|ffp{xG#kASvH>}!
znkXq>f;C>>E?4DXbmX6xE>I4Z7w)avyaW;<$4Il$2QHmPEJ<D&R7$7OWP1e)WH*gQ
zdX46qS2f8cokLUV?Ye}UWoa|8cG~*Rav!wx5zV-nPmYN65lxg2J^2Xzt?+3ctEBiV
zmxf(7NoBN1c&gfu#|Eq~5!pV18c2AcwAi=_s-PeV&v;T#O+yJUeZo*0O(O}{cwI!)
z(SBoz7$<u+YP9;$M8XSvED<c><vxlwmGBiWJgHGL3D15Ktg#ZD`oF?Q(-1=7&*lSf
zu7Wk!d>ROq@F*W24wLW<uQSVfOIemf&SU!n7$FfFA3?1oe4G!wwS;f<X`qdS2m1JS
zI|;YSp`0^TueRS_A_{yOi1IS{G|)l9SNJs0QNl}oh9=r8-^X&Dy#3$l({PMr(0He*
ztatXpeH7{<;VXRP#7cOSk3w-0e$6SJ&MUX8e6adx8ZY6gKF){$ApUmxG|=4(_mSU2
z!c!%@a{POG5l>7Hv9%SLYd#GpcpLDc?<L_GJ`MMl@bV{}+NnvDh|16^>q)Y__9TPY
zrxD8LGX#AleV~se>=K^pGc?Hpj{aMH8t5k(cKX2kOZYXPdF=4g`@mBqT;sEb4Uq70
z)PYL-<9VP&6!`QYRl+y=48b4?xBAczm2i!Z4-NLpuhKEm{t$^M_31&Hgv*16SFG3*
zP^Hvo2!>0F6+UC1F5w$}d}Tys|9u#qk_>@9Js2tBHXr&IB;4u~4`z8A_K}k*;p3`R
zwLgGa5>epOz$6Jz^$|2#!n1vb=IQ?dpW>D8wS>3*sS*+B<1Eu8{F+bCo{{hjpN5~6
z@SQ$GGhM<{ec;aLBqGqOk*q&2%M2fdW=MFp4?JAL3w(U2g;$PG2ga&!rzXS4q_e$(
zd^CMg!pnVnJV(N_edy;(c!tmHm?z;j(XQA20M3_)avx0>NO-A_g%(QqPM;3EB;i&c
zAM!S3ts003m@OHuRYd@{NWx2f;4e#fpicuiUbv4XawWXn2c8GGP%5KJKp@)1lA+Yc
z)UQbRMxQZW;-&YogiFFxeTHDEgkST2BK~PKibO>DXu3?oclr#CTf)crH2kWBukh)>
zatYT|c32L|3a=oa23AUVpwAGjlJJc_J&Tm^Y#%voCEO}~C}6TWcFgM(1wIU`B}1tX
ze3XPo`Sf_SgkSS<(lHXgv9iZ1V4{StwYD_`HnUz*M>I;7c3GyY<=O=1*U;z<rcqbv
zSl`&&^CeeRUage4LZC<bq9s<7`TdjRUbvS&*9X7Mr@s1o-P)XZLtCeByO(^{W$59R
zElMyxQNQLx&wc9UvhM8{vKfM3*4MW0W(cY4+o)=rwR5@|*3}*N<G&h&-JITz`s#0$
z<lgqY%6jSli#RWdD7}XAnL3r*D%oB)ks+(f>21KbFUzj0`g=V}P3KhV??rn>-IV0s
zx>p}>{ZAkK1E0G7=O@kOt4>W7ztU1W-m7uqFHa1K#@pooGGWm#<hg5k4?~2Xqpb3|
zuJzWFO-I}!TxA{$nxI<Qs<#zy$D)3JlH2PzUcBvhVy~PpzIKD(Rc*{?cKLcSMzN|c
z*4t0E9VP4DaAo(wLmb%m?6n!@G<Hs1uQF%Ia)~TA%5twPFUhi8mYNMJUyv*#WEm^V
zR9TLbWri%XWw}l*otmu@uveBvvb-cqF3Sp825giK%Q8Ziv9h$wGF6u2WSJq$Y+0@o
zCC+#|C7?i-rLw#x%W_$2HpzxJ>Gn(<Z5UYB@SJ9%CSvWNxdzLglNknEbyFYBG@PHq
zHRCl{1NJnWXE6KqPT!@nssGn#=E%BtMy-%_?>b)enM&y$z4Fg!wATEl3vd?QRhhI>
z)-`Wk%KFn=m$I7Nlk`$n*gvu^!$T)o_hwTwymcwxdS9j2sfANh@j!j@rdhKe%DQCu
z$y-;!ng`yxMV$wMk0ia!^KA9jWqv0}qiXIa^Eb=9b&<EhGWo6-AbYsiTbDg7^40^@
z2CsSRGNbjDRyJT(@jJcsI%+-DPvWJ8=6LHy;Axp&;sw-H87lOW!KBs~_{+LnYICc}
zdMy=yz+0C&1@92~)m8B)10=mnogJ+%>&SG8Z9-HH36L49OI`w*sj^DEH$8jQTbD!R
zFsl4|IYeFs^wNUsym*yNv&37krcqCDTfG2jqP^a_+@utF>(T<>%DO=Y<Uo@u*(vMa
zn)DQnGO`V&t=UH1Fy~&K#_sOEV!y{@&pVz~$2}<8;Wmt*s&bkqagE0A3T_3Wgaed7
zvFBaMssn-o5F{vH6HN%wD80woU4|MYEUzG|At-i(!kyZaC_KLqh2iENod$@cebl09
zd+mpw=(8T@3L7-DyW4JHka!49WZRVrhr9b8)FErG)u9yFmGcQo36CN<Zj<GJ$CIKI
zCM#d__X!dga|i8a1wr-%pg?g4ZRb;3hv$L7;SPUU2=mNs>QD+HEE&Rn{8^)c6leZb
zw4bb;<RgWaz0=VT2Q;OA)Q8BuXQ?0UA+-cgJVsC%nyY<@CqlQWULDaF*_B|!IaPJE
zMygY5v(?t}X;AG-F~5a6OmbznQ`qFeZXxIGT2<tr?^OhJmI7#VNdmU30^S58lsu~P
zAN=3^cdv`?=1-FR&#U|+ovMK8s(^>4Dheou9xAf0iY%`x-ECS)eRsw5qA_>H^j3>R
zwFp;>?JCIzwOE0IfAk0RcbndYNWKBjPE<66U@GDyAzo3R0|-8!p5tOV0e;Ld2LIRE
zmc$H0iDD26w7pX;K0%Sy7gk;JxiE^Bz;08%>S*fVz^LKLd#k|+_{+xNuyTXm`Rz}t
zamuAD427|{=R++yLDfO{Ow!$vbZv-ka|)Vyl5Ux#yDRDRpo5;TLoXid`WJbf(USge
zNq_z)Hhx({w%$M72^P%DOaspdfjWw*VI^R!3eZ#n1^~dTFVbobioQXmNW0q-w8G<o
zA1bH#;U8%(7}^5>v)EANcSD%s9nm@@e*r<!6a+Hu(O2y8-S?nAt6^)ql4uM-|1vFh
zrHF67CumoHu45ysH5{5v)tvAQkdlbnSWH!IcUVc=5^juAjo1pB%wH}vu|t(GRh5;1
zK$Uk;<o6;~Rs+tmw*|B7)fzd!Q?a*D@Dw2IanWLu2df>pKwOkA<57fEjFWTXteO7!
zfAy?Xo}t3*?m;?-Td(2S-)l5w-`JIS3P?kMoSd_u?;~qwU8?sM#PI@DJu8?%Q9okM
zBB8F#ghwd3mAM0Y>TdqTN&-^D`jKkN<;10he7=YJVCe=(!d^K$?MgY{#d=kbNxuE6
z$3s-%L<J-Ew!7^*0KjnpD0}>oSv7b7A(is75dP>93G1%|dOy%!f#p1g6;w~Legg9<
zhBy=s#nfEXk|P}Mq(IQ0tNGBw+SUk;u48%Vardv26kU*L-g7+XxX12F46`a{czB9d
z6J2m)J4|L*k^&uWlM|%yh%mOWMu+MH)JmC)?WqxA3|DLUE)2-ZHNgP}wZ4j(jd9K$
zq(`dFuAJ};j*9*b9WyV<#De5-xBaB<Lp0d7Mm<p&Q6wv;Y)jhC1pJucEdH;x7aA_2
z^rNAhcN5CEO$>GZy!vbg51&BKis4PPloWj&eThCBecZEx4pMf-X?hFv==0~qwhXBa
zhdZX>GBV;Nq09FM!95JzpK2Y7&6cbbC3r|-OIN_q<y{DLXm`5tp$GCgZv;1W8M>2L
z#C@}UzuX{X-(V!mZP|qo4~92UaObbF1dBPn6hrg{O*SkszoG(O87?j)z=tMYrLb}|
z{{u0tOZXMk?Qw0>AtS3El=ww~2P4X0`6=Ot2<bNUrUn}2;`y<xWXNhDW$gsHljxVL
z!f5Fc!mg08Po%IHfaI^WR_C6&id-NmXTMW5+9T=u5#4+9{zdnpq|29d&57;?Mp#&Q
zB!-(_qVRwv;B;Fep#xNJM5-@BZ1qunj1*QXg<U{hF-%8T-cS3+tu}Ms8R3(Lt=n{L
zgDFV2L&x@+g8TQ#fl1-K5%7e0AQz6z-%6%N4VPVyk)wfxvlr(SV>Am?e?Nysawd@~
zrWOzzQY+k9A7rkfVNr=BQvrdOm`8w6F}xc1(6iN=MQi<hj3)mk^k04H`>krg2eL0;
zppNa+*V|}DoaVM)5oLPVl_5cPrGH?;PA%`1T`9v^U{}N__(>rr5b|g!=aUfS90`bp
z0J~C(M_8Jdpq5*Zxf6c-EVYn#HnSs?`vqMm+0jUy``CKx6;;0)QnVGK_fLX#VGZZ%
zTN+KGyZ;8b-afLPQbdhbaLsYZahpC-#oCpN{2OHJeIyT*lIuvxg{Z@}4zma$Zwq<n
zltqa!Orqivn>yt*MIOGXNQhtRd@O(dzvY*IqiSAX%AcyrPx(m9*B+{T^PYqN40Li0
z7)Z$OqskusShSTyi#Xt&isbmKAl*rGv5^#CLx?}k*TW{*)S8z}f#Ql`IrcbP1G8%J
z_h||$mlVT7Koa&~1-vq6KtgUIP&57}+W|EJD1vteJhKCwbkm0zB)925@FTl2C(7<l
zh3j_YJzghSroK6Zb|pk9hDdOh`P-F;cI7XU&;%n)n?F#!ih>_hr<!8Wpk~g$7GQpP
z0|wC++xFgvIu=kn*g27tYh(o=y7FC1$;}N8&?3@qqtJ#R))>Q_umnM2knFMsHUL>T
z$c|;hZW=9W4N$YYww9ub#-|alVmR>uxw9)4Ch?@s;l((Pq3KDazH%uu+n(ofW`^1G
z?q)Uv&l*9T9L3{AHw}xa?n3Wf8R)%fgHY#qW^Krw1(YW>1M7oJG-O&Tku|yIHz?q0
zJ6DCztAuk}2wZJd#kwEHB8S#9XF0I|PF88nqJ2XU3fkSfEzi%u`2gD(vuDK;>Xxf*
zH&B-Odsa}&*&f$Evjv$wZbrat>}kw)rRHt^GBx8lW{-a{;Ds^(`Ao3@o#xZj_WM!8
zilM(~zaZ1*RApmwh64QFR&?2Ix$6%ix5=~ELyL+CF4M!Tp44=hp$<5CT((fhAI~&y
z?_dw^9m79FC^hXTvZX4VmWch3mG6=R*y|G571J+Rw4Aifs>x5434s>?0pcPR0{*!Q
zKc>RXLTjSGUJst)YWs-bZc`x&-c)U@ChB{r{tPLinEX_pEGv}o<Ut9_2Z?p+A}JAN
z`jKRyu^?{B6Kb6$?(UBphR1XvyO@)LQL@syU7Y73$nHuBvb*WOv_QKnDUgq<g9fpK
z$lXSxg98^45t4{NV0VoU;$6H%Vnp4B&Hs(4j!Kj{1yYv&7lK57yS8X6vkxfd{uc^f
zDha|tF!jF?>|iJAbs5-NpiDPkhG80DBg6Y#fbMx7u|I90B2N=Ch>($lR80Qw)BG`*
zQ8?U*VX5$#937&ka(wN|IIV>}ZK>DjJ#u2xK@@f+87JDruyl}(_B`;YH0xLSv+b5@
zL+{)mkq!uPA&ewj`F|<_Zc8JO+g;VrR)$xQVo1XyywbA*J9E+|NuUe^sBl{fwb(sY
zuitSXs@PCk;SCod1qXC-Zi>E(5t_3A5+k?hG>gKQ2R!s>Xs=pmScXSzku=Ixdt64q
z?Czj3fCe(JV)<rE>o;-^1PR5OOJo4g5qo@kzzaw28e#zs1UL>QyyO@*VD0dT1zZ^w
zHr1YUG-~Xa(MPaVg*KMe5GD@qMc_entDa-3sP@pKE88Lolz$Uk1cAP6u~Skk^`WSl
zW7-XhfEyFU{#!J&_}?_EKofYQ$77n8|4s8eXskCHJ*IiS3QZT%7mf7;k?qD^GMn0`
z2~~)QCe57RHXKAWa@*h2vC9owYELq4P<`ihM3x(_$D9TqP7^ryf+pa`BqDN~{)F=-
z?8Qi9s4w!RU!$Zc7D!`{)h@TYkae1OJBQ6PMa_CinBO=iT?c{7u#h4dF{tZ;(eT^5
zI!%sg7{F{(P>^$oz@NoYi6Q_(#LH+8&4xPR^S8<87oHV|&3^<uEdsb^;Gw;?F#&Th
zE+!Dw%zo&p6QVKSiR6KSrUSWYilV>7f50vR3**m#($)v(GQ(gZ_9O})GUrTwNVZIg
zxG_^$-t@Vkq(Jwk=ts=E1lU_0J;Pu2jq!rsKmzyqt-aP**GT&ZTidYJQ_+A#qv<~q
zlmgd6o87grJm;F$oCmwnTnSU<nsbk$&JSU?3Sa{Qx|;~Qkr_<<Jwmvf^tR_5(Nm7*
z%O7!gN+_($+BK@?Jgo=$8LTZu*y{1)=Rq3R{V;$CM%V+UgV&)H!;~*Af~U78D!`LH
z$N3qtZkO;FL1K6nJVaTQWV<BUjm$2%uuAiRKhfin8}DFT6Ydr`b(sM)ph#Z<Y<L-2
z_UN-u9F2lokcNjac=VSIH_6Px8b3D!<U>H7u$QK}-8G8#<8~XMX<$e)?}4g=>~uss
zt_()BrY+x;ZZvX+FtF{j^)hQbD~42n`K}?~4^EoZ5I8Mx7<L<Uh*FPd0XPHOJ;hlH
zjC&t+V%)?k>Ik#q9E*)#5stAnRoP!|(6PmhTj@K2l6}^=<%IAaXw#Kshu>x{K*ab9
zzDOyHuV_>N^PB97O>y_pqtObiEztNlzulemEFw039A_Muf9YiM<i{i>AVEm}2$7m~
zZ_?EH`hQ5=-MORCL=tErWis|+aKk8=9UY6Jj$!c7q`{LKRA%54;0N#r$_k7GHyTC*
z<w@=Y1jQ15DTT0N%(@HNSLVdom9%nl`6#p;NNa@KP@B4gBm3E>aWY8`B_7KoL~S%&
zj!nF0747KChJ$1$QS1t*p3!kQ%W98XSf1G(GA_I%WL%twSxOg=d5044grbp;AqfQA
zKoEVFtoBQDsdEM2`U5={A|Trm#;_5=b#-s+*z>_1wXtkdaI<=0q=eh_7bQYcF@~mD
zKz|+FyzcH(;LEAd&W?mtMu2LcPRu#e({Wl&S#vTKfGnzMgE|R-fb&%i^~bOr1sl<{
zRn1d4g`;mYmnO62P20vaK^BJq=oLksgoUC%&F7*&e^GxHoCMx&>LBD?w7bRz^7k&Y
z+fBRo?xB)?F$bi};mEupkt(NBlwbG+!PQBPfS<fT<ITyB=g=6w;BaTaK}+}?HnUml
z#6Xp{k3HuYvNQvAbk^h5U`DCdAq+iHkGf2tQasXR`~x-Y72l#P1|QF^H4E;zqnK3H
zi$;^<kIu$QSj^u5(BTeKV~TRBEOl~@^HF$K65(EA?X7LbUms6$i+HkN?^H#Pb3B0z
zu3Bd!afAyR5s!4{ykQt0hw>H9pnM!o;BYwy&VFt2nCzY&hJba-0S66c2dohdMu}F)
z&gR^;@GB&Cp2PUE`__gnE6`c75~H6dc|XMY6p|`x-B2U{InDi9e2BHt%=R>{7gCgC
z_A|fIIc%e_6wbLUD<ssMD)y46#DVt`Z_2iWv~%8Tr-i^{Shk2hQqUt3p5h&!ATC0U
zj>gefl9k^v6-Uh$XJR6B|4d$C=>spvDOvQ3^Em_*w#lqdIXDo6s|0+sKw+wQ%(*|Y
zq0NK!_p;E}tme^m-^GL7ZAwCs|32)%Hx#k`&C`0mg~?`j55ef4Ms`tkoUK?K$`D<i
z)ggVF_nSGd6l-i5RghtWhb|cv7KNN!5+2!?A@!1{wS{fY+(KW`Q5uzXa4q3zIGU1a
zGelWf7Dk4ch)N1hTsZKR@L{6z6ID*~WcG2WZSZBJp!At^@F~cogTqF0^dNs#(!fGe
zx9uq4;TLx0Jb#;x{Fp^V>L$`gk~EA+mGdBDJ;H*V6Nt_|G%UmJMi6$mZ8{2@t7B+b
zi3ld;Jp|3_FtIgneS|0@9Lf><nF<FSb*i96G=p{D659{>)JA$B0Yz%^0e+S@5im#G
zg0Kv8Zn}6p5Vph#o11g{p*lII=lDeTRBKk)<ixlcIyFhV?-*$}Tn>YVA3uz>Zt3r3
zezwoGbin#b9GEb&YDe>5L`S>Hjz)slw)B+4H7kgZcnfk|y~W0oEb;*n_5>j^Z6~=#
zv|>v82fJ!4-QU5-DQ^EzlS(zylN^7+?&^=E4^K8HBJK<cbSQ?Qf71p!L1r!Uew$;Y
ziSeOe<M1jy1oCKXz>ozNV>XhS9WM1-`V|mP%;ICTc|$gd_84`N<4ZD42$6qRJn(o{
zP{;==NNhg<{jmzPm|qvYKh3`rWeGno%CE|7q<xV@7Ep<|HR3P345xaT>EA+#>Nsm7
zq@U(*u$e7F*RF4^^LGZM4I6G(ZrXEhTJ6f;Xj+8g6PSPK(-7>$^4FpZd>f{NJ*TJo
zUhb%hjUnth!Y(H)&fYmsM_~jldQ32Wh3t%>3UDaZ;ALe^?MgG?xazh10MKx&@pibF
za4jt2QPF4lZym`QM@K<c1Rjd{MtD;6*<85PK4Bljj(aq6#aN7Khk*`uA+irdJSpKL
zpo#+l$GZi7o6Tw2&iOn^btOfRLRQ)f!3@RRA$ZJW@BO?dRdQNt%63vu+?EDVl;5IZ
zbEhHqlY&W5K(i%OC`b)w)hqi9og*9}YDfgQA+S2XMdw5aL~{XZd*5APZ6m^+izjF)
z*i}RJUhPsbA9)0{N-<tp^nTPeD;~|yorUI8sd<`B%c$#aOA`uUP&}64m~CNT+mGo)
zKKJ6Y?%ukxXL(pK8IXc~<_Iw(Npwzyes)(H`9BV8dO*_9uvmLe!2`RyW?#g!yCWdh
z<p{IUWVg{;8Ozr^1RMHjaHng_4ExEYi2we1W{zy*gsUXs?UFks7Cp!Efz79DVJtsP
z?}uDTv7~b@^dOxZA%8=9j3FO^Qu@h>u2|wsR_^gHA=jZ~#j1N7^O9AvnQ%;fD5r+v
zM4B?LB%6>bEapU@c4ftK&zD4&2E9{aD<gNuAOMvtBA+8R<0BBcVSubSw;k)EVcuU4
zJUJ(5|4B(5;|aSf6MJB>(Nz${_tk<9{5w*9KRx0vyE0T?5J#`OP8!b=eq7Y9%;`mz
zDZ1+MU{w2|%aPC1acvAZ39%XXHSF#=x*MmV2ljWc4!r?fM$G%YhZ*ec>6|={&dCX5
z6UNY4Il7>%?Bq$>q6cA;CJaj$uFlfic6O~*^;(_+k}GZ0l-+C9L%WN0Zr##Z`~tOe
znlC3K#usMd0E)yz*$0@=dx0vfX4P0V{AprWYI)B*JdNs}0*AX(Z(5XI5OMJmjF?r^
ze$cCCS>NO{w-8b@ASYp;0X<AsF3{*2X|^l1xVb>n9wX`xFqRAQ)m5~fpdEBNfXC4R
z)z!o9YKj#^jYTb(u}!G64(UvbQho~v<s&}^6TH+4of}YFlpjxj3=5U8W`H5XkaINs
z2-zt>TIe!=;|kfJn0NdKB^+TgRq_PT$T$5#NW^c<5}K)bXJa8cClvna$&3c2-4)MA
zsKgk~V#GP#f?N&mD+0%F;^bM(W3I64Z4zo9J|tpUWz6wsUD|f3Jr7WISAlaN-dQeX
z&bE!T{n;CBL!74l)Lqk>d_>SZ%mH3>kchiyy-KHz(_%kZmf(n+7%0N=BhZ0-3Xy|C
z!(S(I#o&*ML%~WX20^4!GN;jL1tNOTcCqr^!`G<6JGYVBMvQ8VX^Otg#Ze)1If*c2
zp}-NOom<D!+F3gtaqBdh4eS%YFG~dU;WE6RU;1nW@=ZgmWv5{zq<>5Js_Vkz4av%P
zWx@O{_CdSI7K__KyXO$HNq$|TvJ0xLYRU26C7YAJCEto;740TFU%)KEQIWq&b^>)v
zJJ$HWBL!<#BXWi)5nR5)s_<zmfYtL)1d&asUs<P<!|xCU`(#greSQpp2H)(b&KL7%
zB80d(l+Hi#`vcEDAaP=&cd2#Mm#NdkB9t@g?7zT%Zy%&@2r_1jYHsbXh!mT;dsQi>
z_aw2{-j(y~B`hVXr}kaujv7~YWJ7WQS`+3pr&z=rU0l_nX`gww&|;0s7O6o81siXJ
zi(8O($lqX-jL|o}1A0Ca+W@4IYoor3>R+-+9m4(EFVnGQ9a{AF$56<f0=7EXEm-Z!
z!XkV8X_1lVP}z%}4@~d|B%47{3c@HN3gU5dsSCl2T{`x#L*rhK`Jy^r&?VuVG#~N5
zH{x;sRPdFnJS|nCZYog)h>)o4ZHG-eK+IDeM>P8F88HB}aaPUGM6lqcdr59FZ^BM>
zwCV=7WWRT8uB&#Q)s2pBaQ15u1NR2eAiiJ+RLsv8v(eEVr))bfa9HkhT@(nm{Y7=m
z(}Fq31Dkr?ghgs2*1$rIQSV6g@#-p>Sp&%jOa(fmV~FYCQp_XEz5H|GUxp9MFe2Ep
zF>|Y+A-h9``PC_H5!0pc#v}{{FW3XkyrK1b3Se^YP+tt!ry`IS^B+!VG&kN;E68g{
z@g;10r%3HprgREP?*<v-3PRVcdI%z;r;sA2c?T?D<n83P)u#dGHa#^FR{I2RTKQ+Y
zfkX=RSK8rR#B@s?r|xm)&I0%ifcF{2p*!OJ<~Vfs!~DH{;{ncrg_!i1N}2bmk@7Nf
z_jIBTP}5?Q*!Y<Gwf0d*ykYlamKW0_=EcR7AZ|MuIa9G`y-qWzE?k!O+n;@|(JVC#
z0m(ia#$risn1+lK%qn7<ryL?m`V5gMp97_LBS2O+gu${dKN?)T+biY|pMti#p;Qs4
zp4kJiy%sy*dG;@V@Z;Orl+MkAoFuWMl=$c~VTt*mXPY`(w2RrE&QXKMQxJCdkK*Zg
z!2ZFGwpU`r;0^Qa?$u!d(2rn|bWp|nA9WjanHH#HBoKDTwUC~nnKApK$h*Ef#^SoP
zOvr$=vXwMC$8cUMdxf43;OWLOInZ~Y|H14YNQ<B1uZWe7=DIoeec%DgWShFw3!Fj9
zxq2f$Ay06UcVl053DMo%$9R`^;b(V|zBmJyh^64i9U6_;rDGH2@GH+cKrL=(@v%*{
zIqa#}&H8wxqL?<WUecWg<f8?1kx#XB86$4oz=1T`{OTtNIc`IL!1C8gqYeI)y5BqC
zSYlX|7KhVYn2vVEW@91U>Lt8UMbg#LRV3x9lKucJ|4k|BZ@{WbdK;41j<}$tgep?<
zs!D02N_m~6td~+Y`bcr8`a}tRIE8T8vo=*Fo!cpTW+O?Pq@=z+lI~A}KI6LvB`vQa
z<=m($y_%;=`3122ccqkDfK~0)hmZpMSV^Cx&Q&DMt12l(mGmk}+9D;r<|Ao@Dk(^e
z*>{%5JqxKSsR+Z4F^eHdA4*Bxd?W>^k^+TJxm6?;jjYnU8LFgj0n6VeC6QBA?cE-P
z74$BEbV_JlMbeC_lIp9Ha!ArnDQT&Xq{)!Pns#fDc#d8;$}wwDRm!35qGzp1$}TCT
zBcvoQSwLx$m`0EQhx8*sUv{h4X+8u=oarKhkAref7qML+U<56aRzAE6%}1aSjL}tq
z&i}z^u0k`!%UD+Taf>bg2V-Fsn)~Bri<_$ePXqYhRCQLN*(@2gBiZ)u4YUo|vF`1h
ze{RFrAo`5lOObSPT$09|hj5`uT-v?WOIV`aDY|2ZW_ZHp=}!!s+w=^?*p>5?#On{^
z5;HA$&#GYFMZ&5jF6qt}(niIT7~B1OJel+QBMS0ck7$uJ=WReGrB>cu^O7}q0!{ux
z9b42R$ay56LefdvA|hz<bnKY05-h?|P((W7{RJArqau#kBD6Q~PJ-B{Q4_f<1;)_(
z8p1g)%wpJ)ELL|wncXPd-lh#aWsBP(>aPZw*!U#ml;EI=R|<P|EU0H~=bJ%T7ie9c
z42pev2qg+Snc;#k*6;-EYsJCr1rTE9Oc_V^KMgQlAZ`mFMf>181TDYuoru;$A}IP^
zMwG15yXVo_8^M$^b+=uWF1v_)%#es1ffdAUaxb8j(6AWsRGfmv)mnaf9lC*Yhz-3|
zfTDBAmc+-fwGzevgK=ySf&qy~VP0+MNFrU`qfyXCxbYWc&C|RtN~8-?2Wy*ac;mrZ
zjd{1FI&th?CKgx>wK?%jbioqKo%uSJY_n;9WJ_(~+8DOeX4NiWXKc;=@)qdWU0XA4
zZ&p9Su3gH;CN$E{VDl21wHWvzT8S@z;Xhb+J%!wcDmJX~MK63t3vma+y7j%+u51X;
zT<;&it|m0JZbLFzJ+Jb1u+ik4SWTu?rd9VL46_EkUerFtmiKaKwd~toQOVzKrLNF1
zqw>^!<6Q#XFAJTVQ_&pxJS5Zk=R{VS&{GfdUkbX@Sk7_~23cC~k<N05@(&UU$aRXt
z4uwpZyCX$O?1eS_=oU(rs&C_`t4IqWv7OQIEkI&Zqh=Y&yuS(n7U#b3cLH1nz?+39
z*Z7NeU}`!6R|EG}kAxWfW#4Ef7z$IAzkp6hVlpB#L}nM#aoLDpX3G<sI5(1K;dMN;
z#bz_bMn}la{CzlB*;`0l*&MERc;QIw?K7W(594AxSw4jNt)?o3u&jsZC3dx$#6tv4
zNKIq`yosxEq$XxPk_+{d>0Zl1+-29FaoRop=x^3WM||g5w22&z$p>@YdI}b~kACp%
z_lfaJCho=-b2I7HLF`%|i0M&$V-SYetGI#RqGldv3<IEkimUzOxAs=bMkI_*7)2Qg
zBqP`xN#TRXqcQYb<eSe^!`MmFbmKq0M{VB~h@S|7ji5jj6GAa<&7!$r_yh%1|MfD3
z4~t(nI700{VV$bcfk53h(!hve!MOB5SOjm1$~#Q(CLtwfDL#YUVeLNknX`|n$DgS*
zj|=!l7#gxo=w?1eLQ<=qXx&hqB!n!W%s0l(Z5eb<gs)aml%41k5<Cc7c86j)mPy(P
zin=PrO+-Z&(AU<y01x?Nq|_<GmD8e>e#lmSsk6IMZ2TO1rf*~WM;l3F9DgxCdIj*X
z2W0Wn6wCLa31pMz#-aK11L@0$V;BJJ=N4=hYTp1XKSMT9&QA4h=G0#iRtoM4Auc<7
z&JV*q;~M~7cANmIHl9dab}LM~249ssklS#Z7T^i~=UI`B2FgYPmwyptq!y&O`azOm
zYb6AibNWG=VNE53q}gZbf-xlhtPqJT!90O9g+em)Uls?eEU`!Qk0QIe)2!+h1<#5C
zG)Pfw$#Qy741r?gQmmjU_pGQ;f%jo$xS^FUrO>$obUahX?%U&oJ`^atGX=U5`5KS|
zl6&fV!a{6ivZeYPgUPDJ{CTz`IllT;S!>1aBzM&}J`d06(64!&?-1Hxi(_dp>ua>U
zrn9H}?e=qL=vdSKBei90UjIn#bL`#zgBpc?jkDw*Sg0M!b6?;@K^I5O1na@fj>zh<
z5J6|1Z&`vPveQy}$B=Ub_pB`UhYCG#06cvxX{(m6-K6$D54&+PQyK8Y=w$01p;6I~
z89xK!Ske}}(?Y^&^d4?g8MDTMsYo)lVYeNjVb|VNTf?+;Tb8Ts5vN1B1J3W4Bz?fI
zv)Gi7dR-*j{*7P|`I5{CHZ!%Jb(Sij2Ke=$xe-r6z-<YT^b6Rgl+f@fl_&sfPtq1(
zPYwa)JqjCc%QZYxFFLUsDUp%?c|(1Fh1}1BGUWY_)Tp8ks9yy&jm>{p{D4OO^HJl6
z*~kISwDZ{f0nIvfmgspKgsG4hdPp&RNvMI;PWb{7LW$=o!mHhIP&c%7*pCCks$Z64
zZDN4~8~GnYjsM1?1~${a$5ID|R$nO5o7e)NpCR-j_7>1_?7+a#$PkH+S^s3?SN$p*
zuSGl-7LeMk=PB9&pnp*5Dnbf6<xuX!=)a4xzWDZ&GO{1bC;&Cz!%n3(!^*rkwQ2PQ
zDm%|$+fp0(Pa|}yKnJkjQk%94m+0y~B0m+;PuQdm@!WWebr{%GyNL}Q6k7c_f*#rV
zZI(T#k^gSg_(HaEP%~^63I<stGbFkbIbB{srJY4~Teb6O;;AQiPO`|sR%ZjrQ%ufK
zg(p+YQK5&Pcs?S$IyUxve{%JB9Jq@T-Mt#w&ArO`#5I(frOdf-l3FmLKio>XEX;Wb
z6Pa|M@I*tbXt2qDGf=!2yE3?0?|)u{WUzu^mdXI*7jokhOy(sx-FrP}C^478L8W%d
zY-dWnzMDyol2(W*gqs*bB_repEJ^x^1VX$?>a&ShD?2`CfON=510Xh!tsBxTuDhyJ
z0GLVuMJFKQA|FtN5ys^m$#s+zOlS345f5SILxQS5paDj|HLUi~23pP{hyJPkf;CMG
z(Z0=WX)ScK&#<W|2Ap9l(js-CXW0I<NNokXp0-YVkG(W3sNvP;#nwKznmQtoZ@JeW
z${`RA>!W+o$nFh`*7Y*7HpAQNY8%<;;ZfS}*{j2!*E<Rycvhu{=!X2rLet}%<EBFq
zSJDo2HmeDiOh-TT#ckTw7qOClU4i#xq$v?#ZhjBf#uCtAq6pi=ar4=l>`t|(D7IAE
z@H>YPt*K&yNSXqhnz(e~77V{Rw=48a%JtB8$uQ^G1B8(h&x&$QS1`EKb|7z*yce?R
zFPpN%FaL)mRbZgvl6KIQ=m$3@(X>K5N~Rc8!ULFPM0>p+qL_U|wEomrcyNvgd#2&D
zAgj_L1L)DA$$iiv`awNjfpbe`ht^?Yp+lwPD?1c~4#lEFHtJC9V4^jB0yI=ahirIJ
zwFhs@diKHsWO}Nha}{yAEkAzoz=PXAI_g$xI_VcO=}A4N*@Ye_lAy<Xq{k?!2b%8=
zAr56B-oX|nyZTmYz~37rns55Jc{IH<0e2AeL=Iipdrvi(_+XsSA?05>C=;L5;T%R4
zw&+AUd`>zXTR{yZ?SKwjAOwwDNe4Nkysp~*vT-`rY-D|HYu0&Wn05jiIkIEp#?+>g
zvcsNpI3n3KFpwV_AawNu?beYo+O_QJ$RNL8$LrYNBg6d;qYN1pJn*HdUWGhJk}H;{
z#*!53bRY@hk5Yt?-UP<2dYU1>yhEViD1f31lp!@;NyF*2zG7%GR>$0<8v5x_elRLB
z=+@x};?#%)yK)A59`(?uzt4UhHK5K`bQwMW0mGL66c!jhi}f4bN!yh<N4Idy2h_Wh
zZBMqDBbK1k{E=I%aAGIhnGka&;yMuCEp7}U=1Ig!c6)TgIs<4C_Y~UW=ZmZ7M&6w@
z8DmR(YYaXX6hX;tT7hSIN#=8eF>EzP<CKkjD6W{<<6@D?$EQq!<{U3aOew>?41`IF
z;o@Bn(x*6c)Z$y&Cu8c@TDcMMoQZ)z7V}(oeoQiMK{gxPp!%<)sTs;E_8i;DdFOQq
z!m$k33vfG=XBJW~3h2r|9piXSid~g&i{3#EZ;Q@Q&bF9O7m>c0AHZsich(pbkQ)3)
zK|H;r#|2|#C)4mw*R*Ok?L!yFdRAa35A4DS4Z4JcQHRFhI6qQwL=gwJ@7UkDO@lti
z+`Tilk9HR8I<7~;&A&-@F<+sG<T+l3XVTZl)4J0T(o1XkR)`-Fgm^{7Q&K4lfG31|
zzLD)4*R5-7s21(PEoavPdYz4r8+ancVz;R_DNWtvycP^XNe((<LK(PKG5?gcA8&Eq
z#4H1C5;;sfVi%vX6eL*4nnINyX&Vkz>>^8m$iQz`0E;XI;zJUQTNQPIPzu_oOf-=|
z>`P<?<vjmpEwyW!A*w>7>Ch1xb;w0h0Z!?`=~FS58Ts{%)PNrar8?wYiV<UTgVz_c
z<20{zko`Hn!>DITYZuOvu7$WXc|0ow%5DHG|6O!}4nebB;Efxdnnf269s-CV88(8B
zI!PFbv{Web%PyQ$)Um_S^b#QNJq5o#$reorYB`pK?UusolQ6~Lr}9^TKONMo!OsdN
zGzlGQ1FibG*-3tG38s?L7q&@*)lzI^v?=$PXF|i;71)Dy)0^`S(I6ml)?<+qn>fpQ
zg8Q^==^1bnst&x5E_NuT+ynPilTBiJzDtdrmE`e6E?(o}2;2@YVCFv>mDyr)Le5M2
zQDOjBf!eD{!ai_m_>Q~aK}JB{Cv{e8xfTcnblOM&%@<%I&`rl;{sNw&ufW1_ozeCQ
zwQaIKKk$mG?oQfW;*}r<tsykWxaR&vJ867z-xg<iG-3KH9bp&uxd+j9!fpB)RrJoG
z_*L*9S)WO<#(6kk*<I7a#_`q6H7PWBl8}wuiQG>Nr8?bEhDMp}_@pLIMa-L?qp;TI
z6za%qgRl)lg!xl_M?{dqS5*zM-NDvHTxjejX8)10Oe|-mu>?L%?WXfz$eM6z46Xy0
z6IvIN7+lwJ+qJyzUnGZa2xQ`FNfF<%7(cQgZ?Lo?mA?On`ddIZz44Y;G*M2oU@CxF
zIE5DTuP_G@t#gh>AiFRUHy{kgVdRkFbBduLberDTS;Zyi;%ySXl>}E=0r7WVOv%*g
zeRWyYq4|&=t*|`SBt$q6$fWcYA64+4;us-rw+#g^$#5{!WViMNdvkKr!S{yJ5^TDL
z0$&e3N;rg#0nLiNkQu)XD~ozTWE4LBS%H)z#m%`f(De(IZ>!{!9C3}XJuprQ(^YT4
zI!uYwJzC2~O^MW=V~eMRY4h1fQ@V708CPR)$mF;|6SuI`y!dP3{aHm=*i#{Q#}J{<
zIuyx@<DplTijUOKMjBY>!rq2CD%E%&s@p*x@o`B#Hf3r(?LoF+YAfxhY|GR(+C294
z)WifE`~gv5XQl<=YA2>*^jW%)7;~FOqHI#a-LG_+^kz3>uux(I6(T@b9-)225!Sv&
zeKup7Nn6AgPU{zb8Q-H7+OCnw>^b8uf!IcAgtGwKk=Aotrhbf=aC2I4gDn8T%qytC
z2xD+9ogk7~pXsIR5yd7w6Ju#0ak1ocSRzdC6T$Xp+H04ytIy1<o1W^`hVJ~BZhQ#r
zv(GkqdJAGH#d39Y<i(OhV)t6YPoT##aO_znMjz3brvplnr$pGkglEb+MIvmju3>4r
zCOqXL84M2GoBjIi+~(ImmHXEs;={Lo$X=K5o+=III~L`<>DJD>L_=8!#8>7tB>TRB
zSNzyBU8C@Im9C1q{LAVK0G4vP0yq<b*_G*?qg!^NP3|QmM7d@W+K4aA!iWC@^}JuY
zn8`J(Wa}mhL@-NyZkYZM_LOS}wb0gOpFG#F?&60+z05?4g*|CXTw~uo7i4X`A2SBi
z4^q7OwXz20Jy?H=`3#d*vv#Ic*I@1GiCP2e@O+b+cVb8xM6tgyV@5o0brxbes`(=$
zEi#mVJOCOD#=}mCgk`j|Y_?GB6Rwbj+?IWWh6Qc|N)x}1?d~yc)_d5^euUKm>sr}4
zP*nprQ58!n%x8lU__C`&z9dC#U)W!jQI}+x^TayoHca{qbl90&LM5H&C6K{xxQhY1
zB@YvJs{tO|n?{I$wg5L}y=TPfzeS2lSZ%FmrPiOlKBHmSnjO?dM;LZ7oVtMMbmZj8
zV}?AyHAjva7NTSqW+Vp>qTq;pfa|#^etkZ<&ExECB<q&ZsrE)dt6l-x$rfca_N&()
z-$iFcM(}>Pt+DDF+PLvL<`10U0w9<oUr^yrDnOSKx1h1|jQaYe9T8S)%xqdeH5zt4
zF7})y{FQmMK%GX~vB%7?pm)+B1q-*hReWj$i8P%+0AurJcC>ySF7l&f<b`u7z8QW6
zB%gjVkzDvTJ2}&;wX)x4wg^t5Ev}M;MUSTP@?_E`<r1{{$qXf;UI=o=J{I=F93gA~
z3417orJ(_E_5vq-Jj%0zI$4IBNrv_kgiSgn{z?G{MJjD*{p>EJ!VD%!0RvEzW6-4h
z)DvO11t15)Ji(OdrJg*kHh!W58n25a1oh-H`{{-7NduROK3s$JOJYA>@xu4KD}Z01
z$!u&xig*DQ2`r7BL}ehngaSLY5Fb`)s-IpIy-TJBTFVB~(I^@HCVOsHZ|69n@2@z~
zv_PbDD7RtsdU#4!F4N4RO}!^I5Z{eV5eF`l1~_q%y&_?0DIX?GUBo9~;RfRs#5*7f
z(@kRRzzF)&1Z^Rq9f>|?QdrbjQN+@Cz7j>QU3Hh-@Mlm}g*cS2xE??UZUo|M6fFL9
zCxNccS^22@VhYkW`aErTX;00I*{hi`w%0@*ca1Pi2L6g#3sP%y)mjAAD3FanQ1;$s
zF2>}sj=V99`DMj6`6`cu;u~DC?=W(0F4gH49$&+TXZ5MQBL_}0)vlZ`>w!s-*GI>;
zXEh%BJD?a=Qmc)SP{Qddz8$Ggy7gw}ZwLasAVCl-=TVS~?eSK+#EV__!YWA4>#E4b
zYiC$>7B+5iEoPhDIQ<8)t)h*LIk!MK<iH@lF^jB3n^yTP-H$}&>WvvO(8^y{vDQlL
zS1Q(OSBAr`hwVxo942<nPKcRAK_X{j5c;6nuLc)!BWI$OKv8728oY-}h1=7J!yT5e
zQy(;By<Uveo?+8p3?KXv92HH2R^F%Cjn>NWKB1a;X<o!%%0S(K^%nwgPJs_Q!qTy}
zW7)&yxz+y>>=-@q$_m$KX0sn(Y}aClfYUdrK!lTiypu46(8`=k1I3%OE^}Jc+0}+z
z%haYdrop^wi17p1j5(Gj*M5LxFxL{y$Drm79GWmTMf?Z0an7Kg1NRC7^O85k7P*8E
zz`Z4Km~*iY!z3y}@Jz>l_(>E(h%;eIy1Z%K`3Dv?*D|Iq^}ceox`FQvL1?+rTy1Ax
zrf5N2D~`asG#q2-U`axb&_UyeYru<nh^t6A5_}E|mwiM}P`a4!W}D}R>Slk&isr`K
z<Ag_6P>*O~8-U)T(=SG%)7Pleug@e|_#G`;U(|E+VLVcf6ZA=`$?C5|-D3Uc^{sYH
z2s^^AoNXv>+Oxg$8aCOWrELJUFb8u5YYfEj66EvnMHX|;Z?LMZfmNShe?*6J0u}Su
zJSd?~wY?KzuQEUL9)L~zZQ{)imTew^OBQkyj?-ch-wRIwBY5bu$<6413&*{(#{3tW
z2zzU-{bZuHA@j^Lur>4ZLPK5#5Igc%Y9kn3K7hWW%cEPO%i9CcWhd*gpuTn|OIy$>
zru|Nu63fD}p^6>lI+Wm94Ptq|wesb(=chvf?vs(J-eiXsL^teD8yTg@?n*-Th1NtR
z1^=Dnzq1+(+q8bvf_O^!RiQhb<l!K%C5C122ZC0d?ZxCSV&fO~?mpBCznn$Hpi{5L
zD+7XfnlPiPR^<`NM!+f`agJg?ENrJ8&jMd+P~!tkVmon0unsT9HrtGT@Xka}{z=OO
zkeK0?R|yf!mb{cP-b#JNk7Z$j$Zv=Z6yG(S$nJ||r6#MM+aAlUP6DZ&wTp$2QUd5P
zKTNee&z$}uw$evJ-LQVkis)b|8{v%5USuyjM@Bbpie|fd^%39tBH*Wrcs~wY#k@8e
zue#|-V}aR?>!yiKhvgWqJCGU(uivvC*+IHm->~%T34XKVb?jhvv&IX^i7`w8G)yx@
z<u|I}axJ@;9j_h0q8D{`E^k6oiup&>PdLd0OsU`Xc=jF&Q{`kmdx<hO@uM8@>Qp*@
z9zjC%INyLS)A19(;E>hK5r?oOZa!WM6?Qxx0y`cfJC;q8GVzJkSqfjNB7F5b!skIS
zU5!sAHC)1;xF}T2KcpAv@N~rd{$kU3cdo&%94lLh$ZzX-m$$;oEfxV7_7bmnk#&5z
zgE{00;2!qE%Tt|e$PL^n<vb)257+`wex$XCG5`*pjd^FY=gbdOzkP{PHD3fD%x_Tx
zns1&;?eq`ix99<KC^E>e$n0ADB0@h%P~k$8?@`49wGAEtD}AXSW_P6o@~h+sf*ErM
zcU$>FL1xaIN%54lEANHqiu+UObUFV5I+s0V&v8nv-lS;gHr;Fnt>Q?lT5Ly7(*c`>
zcb4$@O4Tmf-Rf6{{7u<yv2IrIC{-;c+WG}Jj2brKXm|`7CWHUX8s|1{@NyUI=|Zqy
zz$%AbVIby5;cM7prsOsVzJ$?{uuXtb96)ffVpGty3oaeyHqq{9>vN;~_nZQWh*0!S
z`buZWgI`<GeM<{)VcaQ$tDF|Uv{B6K5HW2~fcFR9A@AjacSC0#Ym(Qz_B_atY;Ma}
ztD()nycFkZlB}FTgql~6tfv0dfcga_n6rQeZVd)f#BvplZ;chhQz~kH-6v7wf$FKE
zvVBl}fC^JlZ%b4I*<faC;Hs;*4}oJH7Y`V;5p_Og7A28j=jSjFF=gB)7w}lH{jr0>
z=u#496eTc6;d`7u;s!je9GRVP&l&p?aVrT+2(5Cf*_p+SOmolCNa5&M%xkP;6^p0(
z7sQ~QSJ>oNLesCDrNL>d5fhsBr6PBB20<p@VWhSA6c3z4{3ZM(6oa+9*QfsDld8$6
z;uTOHF4K!~a{y_T$ZqV1R~k5{lW_I6t;qJ2)4h99H|M62&$<kzPC88)HZ0xscp!1P
z-GFeoU$mygwZPprG;|h=91=)<ko7et<71K<n5`+U7P$M9*@8CQp8^j$n$KJ4G5%6!
zs5o3lpoW`BeaigkppRQNunE10xo`#@bKzqY@%c$p{sP;uq*YiUB4fT&_W9=t#A+Dc
z7)m~7oWp)w5~RJu{9WPW+hS%oT%jQHAhjcj$i`Mkr@Smo*~k(1v`yTg?n1)XOX0&H
zTr!9ZL@~cvN?kx2jMy?$;FWl%xXjhm`7_2Pf0N`hs7lR#vc0v$3&!~FgF5OoSsCi~
zRDAs;qNVF;8=nOl=#pARqnhYi{x&K3qw&Bic-5m`MIt`l6Fg1uZWLQ5Q#p=XbjdAK
ztm8PC!PfOy($Zw-JaQbj=|1vH`Bxx~2SXG&E^U>P#t3A|XdsJpKxzo-Zo91m&B0TA
z5tgyCUXP<_j7q<r=+6*+={T~Bp*!f+4_Xl8<&112rf2O_Jd4&s+U1`jt&FUx(#&~|
z`0#O;c`^M&DlKJS0wV6+Pg8dwpLpxZ=DZ&?D$Uyx_F%F~<M!73nDY)wnz<78&(kW+
zG;cl0ocFq<NgFDG746J<IGhLt5&)x*2Vg-DANK+QIr#|Lsk?A9)A|PJ_pfBcg0U)7
zO=6-iOD=IO3tZN)%ax}oX^wO^KC3-N?=Y<V+hn2<ov%$ZR5?<HEb3|R2P#CekBwW_
zyk^O&2c9D*ml_IDvR9Wi(XL`2Eo<fXV>=zYw5(4^SD{l0uP?T<6jIE&JB9MFtziME
zdb*o9v+@wZDgLh;B^Ioa*fVDZ%e}7QVnZ?DfrtY6BWj`}9mhZ;@fJb+76bCcyzr!$
zS{rMLSp)A97(4ws!^ebDvdF!tj^o~~wj$?I4k{a+YS=e!OUN{6n5=wX7DW4X>`jXK
za1}xW?Z6`&G^s8NeYH_%e~dma8BJ0jCt>Pjkd?%OO2+S^>KtK#&To;<{n)Hm+eIqa
zE#J+m!IhO*VBZjSF!%{=kn;Bav`>v(nDXma!<{KJs13{EHl%J9g5x=~;9)ybA=bPE
z&tN3~3g*_v3{kgOQBVdu@vx<o+*XS3mWFAU`13|W#nWX0Jn<pSgmAEPIhCVuD#NFM
z;?f<y0aT9KUFrC0Vk%ods}{>$-pRz_LUy<5GFFWI%j~P=UF(0@x^fki%VpuqP};I0
z#PSXv%&U)7Svu#m*0KI8GPIZ3ffXIJ@$A-$Ig{Ra6_=e%wA|wCvqG%I-u1gnD{<lw
zKiim^N*=R>-p{~Yf`L)jZ>-u0xL1WWrXiXW#=$S1DCa#ZgmbyOABKE(Vr5Ui9g#X#
zbJf7+Ph%v|ht9RphmTDdkn|BkW>O?Y0aH7WEnL;UbxlzfKXG}+O^KEB*fIslp92%a
zI|m=^n%V-#F0P8`=fVSiI%97wj3xfEu}&Zpi*)fa^zRZDGc38}5Bq3afScBVX#ONM
zzbsueKQ{tha+@YZ;Px$ZIG+U@txm%Qr#aWIcDyE0DW<<#60xOLHsyYf$V`=DxJ6(^
zi3KhFL|V>fdLsH$0%0f-1%B>RG3~-5xtR@Orof8|@pFa<iPEZ`wHxEKHCWTtHJ$Z^
zB1Inh89E|YEH(cH(ftcjp^*Ajxo-Un^3%T{-~0<w>IV?}cy&nKvKBNv0|Su>!8XKl
z^CiHqtsbUtv=k3rUu*0)v4xJMzt+T56CCEmFP9hu>!R1{hBN^yIgOBD@)xzr-#p#3
z2>kfX)7E!g5B~dao>o6BGRvogDGkFx#vZ=bOdm!KTi3+s?+|3fnzs5A^ssbInEpe0
z_;gM8S|M;U_Yh=8Og-_$9<GV@%MR1+ieCG)wzf4?jNu5h54<iEmkQPms<FK}>1x{1
zT*vgU$A*6`!kFnV6nw#88lL&->XD!o)=cnS0fvo#y-%C!g0VMZM{i8o1f22lGt_QN
zSGWjWBSHUv4-uj-h3MG1*IOCus-ioQfPgpF8=o-=feMOUpS%&LHTJ<T$)bh6H39hR
zO#tQ@1%)397Weji<ER><z7Pfb;_YR|g)08%>ZlJ}-`>d7`o~mXu|8d&PK-C##~U{R
z0?9Q9(Q!iu<9W4S5`g;i8(uPIs`VtQ-`g<E7_ZiUs)l;{#{BU~7<|<VZB&c}nEcuB
zU%s{<MM}eJP~;<fBEn^qyWfLjhCpKCp#?M{aJWBa@GN{lKPiSteLSlrW@dmY>$pE!
znYAe<+71SL&c;$m(Uc9%iSx_q!rw)(hbh|vrT+dQ4VDvv0KC>v$F6K@WQ?y6cIyT?
ztKR9QYqggpzB5PP2}G>molg1(3-D0!PFsC3Jw$F^j(^Khm}4%A{62o@#QnZ#5kCVm
zqT;S$>HG&CeI{-u13`bdnM|P|E?5V4ajad5hG5OE#NLnC4}cwNZE7Ig{v8xF)5qaA
z-Xh=;y=FZ?s+7_w;uqP>OUCTMvn@8J7X+GfKSU+bJsXA@N-Ty+k{v&$b~q5*Tl{2p
zLlDwOf>>$VKwzCak0>*~kCfy4`jE{HEdYZ~Tl`?l*WT@!@G*LkU`{-?#PAND%KVoa
z-atuj&z_=<x?;FL?}5h_yR!&FvhbRSh7Nz(WsRX&U*MSKJ)3a|#6jw}I!GP&UYhX^
z9#CIE^#atHT5m#i>-!6hMzy|Li~830yXoi8fgt{VbK`nIz}S)ymMvfFXTJ!<Z(G8R
zYcvAU3<V3`I@K7e)<5<<f(vhb*>8Ov9kYCJ*6&Ph9sBizq53*mVC?nbbG1Y2!q_++
zVU;cMSnh+Y;6r<(oq_aYm9%utX^&2BLKOyU^gNiFe>5q$Bh{7UKm==q<S<ba$)DGs
z1I6Z#7U(-*uvqBFf9QXlj)#WZdiag6g^ypijjiJ`Q9S$->@>|g5W09<`>3a9!d+67
zqD<pskD*uG>p`B3bE#spCFA~+XB;**2A4_4T5W$uuLl!bw>`seYfT+9?id|zuSq_W
z)J)t|z{jmoAnpbj`GEL5)X)Ny?j1ILXa-o%>}b#+01vcTqn`|IqRxQsD41u*Sp6T=
z;R!oa8`qiv7t0&qj}2D5C#&_1L_8(NTJ914)XsiwKKNU>%?T9wzrfA;TV2VOM{gj>
zw0c&k1VqPrf3j6?xrvA0KWU)vM;5E`>3-`gXcWJAM%%V;dr{!V{&0t#?&m3n8DypF
zpUxlh;9ZEt?szDrkYT=e|9Ir#UE&0gUR(+wBVcn0#N7e`oJT;D1X?6;8h~uqt`O}t
zc7E49ee$ypJiCT`_NlfJn?{l09C!AnZr}ix^gXsY3jt-#c8BTH=%MfKy~Z!6(pJfk
zkAl_M(??(N69f+3b1kF^9?)$IO($eEBJl4e;3K3IKWxtF?a9myEN$;0zqfTdR)1gf
z`q{T1dHTEcJ?!^zXHYrO%U#dP=d5P~_9Ytqe-xH2yb8f@?`zlO`hP_IRn+s123VSR
zfQoL@=TAe0U-or0_Ju6ei^{<emOrRge=Ygy4H)b7u^`FG?;rSwhP;G+K+<jLLBOl|
z`;3tQqCRg7>hJ9DUGItqhjKO5qFe?dln{UKZ(jF3ARNjGhe+1AEw@Gk-tItr?cv0r
z{E>|Fi`()JLFXOl7+8;}Wn1G2c;LXWAb&h0h|fr>Y%*Veq-CuRwyE{ZBa)Awny~C0
z1^P(`Q)-(5!u<eM^iu>qd@v&L0<I;IXd6hI6Y!sdiN==!ME%@I3}y16_S!lD@HFEI
zo`k>&v(y;}x}{%4IcniSTtvp1*4@v;-`@nE!<hF8#IJo|<hGYla6Dzi4}Ksi#jmUt
z>|0?idXeOJpRXie!jCeL{rn4l(trBvBhRi|1=F<pl^muYd3d1yE<J2N+@P7?4UE=*
zFj{mH`6B{l&irv2kpTz*iv4tWr#_R2*B!a6Z~Y4dWgU&u8XMmgeVINKP3-)tZR_Zt
zAK{;)z#B+Y0-pG#a1v-Z^_R3TEf(0hTIvyfz_AX^2A-il9N9+!ncoc)0e&K25b*VN
zw3dFXTLe9z?nc4GAh2u<O<DTKFMd6b)`rk`^ch5a;Mg|5;eTq`^ulp|f8Nou(}m6S
ztp=l|KML)27vCWrQc@jmN)}j74+1=;Xp-41-~u)Zuw4a3f!g4`r^LELALWe?5lWQ+
zf_8esx7lyUo7ev2HahN2^F0^{Vb&A%f`<yeBb2InXcc_VsC-v`0N<b!W6e`R>OF+$
zZ)@2XCxU}NJ}Fuwt~8bFFd%3xnz;TxvAkKuHAEhuS2u?}<<a{lV4%rE!L}5K>UYya
zNpWlaD|p!TusBJppZz^ReNHXb-=w)&dg=}R7<zcVq><iE56en=rY<A}5zz)UgJ`!!
z2RN#flkG_me0f&~;4*xRNK~x}hG^rqEc{l5G^|234KUXDbc8NaVM(VmTD6p1Q<@6d
z2d-4gP9unv{T{&VdvHCylvOWnVysJCZqor07FF7yW%yEI$v-YXqFk!@>ii@R1n>q@
z*PiI#pv(o}*z=_ia3AT}Go72X6b+T|&5h9tWdp=17=unN9X#`jb`DEA+c);(Z$v|B
zDDu;2Nod(ne)f;wJi||+pX7&L5lt%>Wzz!q0Xup&spfKU{b3F?I8idoxx4z~NAY0(
z+M|E@5+3TDkI=r%;?FnN7P2wt`|27TV_VK&(mnk-TXf-7UG3?t_Qm?z+AQK?q-nXG
zW^6g;$-(PdHs)eDzTe5c_>z7=UwD=Or3n$SaB~=B1d4p@zcjpmUHn+(5v|yw<*3MR
zDA<ZixyEH*3*v1kShLG-M`WsX1B(1_Xd8R4_G9MuDw3ZA@lTf({ajLg);DvFVd@+V
zzkvF^Z>AV^cz_DKsFi6~+8J-Ft<FQS>zykBel3<l#EtuU8t34b@toWmd4q*>Zg7B-
z{VD*RN{uYK8p`fm?Vw+M7L|zao3}ltdiwWpy9B)6eimsA^PVnt_k8hDAWiajRf>b;
zurGc;TK^|hW0$^PqhCc2FI<b$KTQuit_|0}gBR(n#t+X1<&gTysM3hC+V-5k4KLzY
zXP7}$?jM@yb3nCg+YhB${hks$E&8$4&-euf5B)1R4w_NF3^%@ZLe$4l{m?JXjQiDk
zC#v&bRz`kNjL4IQkKRlMsK>iuZ)|V<yCeRu*|e32Q&s*IMC=`|IDb4Wq$Lumf-$hu
zKYQWs?XkDUm#kk3mIBa1S_nw;<7tfXS%SuPw@@AA!Ky$%!geDpeS7NlfP*UQ&nWV{
z6OvBb^jof;;>oT~W3%qDk8k`GxlX0}5(O7|Z(Mx5cL}Kk(R?ozyBP)B_v?VV)z$vK
zfqH&tlKHWQefeuB>s}UFYbk*4A^1%%6Uk(mWo`TdOSNosS+|BW0ic&%QTbS^HT;?1
zu;o<@`%i0GMVT!k@MF=(WD@!@37wDm>+Quk!D?zlBFEiqY&@^l{i(kA=1}8qwY~+4
zvFkUR8$VF%^Qd0uw-<~x)%rskq2<3dZ{tyWP>Onf7n<C<M^I+bBl^A9+4zLtP+uk3
zK@8vh_M&ltT5n7BvA3EVr>J!e)tB9xYwZ1j(0)M?>Vdxp8yl<mp;V9kJ#Ek(5W*&Z
z7NWuZwC!nuqYUL)`p_}Nqo!zXsYIuV=l~IEiD;2WXw?>4#i#_^LBOv5{*<vC50JVD
zVAi{Qbf6UvcfZt%g}ELP?JTcv?FwN2URadYh}+21(r=kzjielZAL9JEJgi+0B02=3
zvI|}_)B?UQfsYdS3rZUjD3e%XZwKoq(!+?`J@qzvc<c7YKDlVp+x(obz!?D3(kl!4
zR|kZ<(hn4_2UUJ`iAe({Df%a`J|B|OFaHtN>m4F8gQ)DnUh2L*p3kP%i69@p?w~0<
z<cKd9ps}!VK7P(ZLl+%>6FMFxG5n9_dSR(rclzi_HI{zo<H!Th%d6wgBjB7UG&#w)
z+*93+RJ;fx*7naf`qT6<`p>Y0Lh25EsrsaSN(nrhz?JrSNT3A-`k2%qD}Rb#R$+(#
z?5JNx4;6oQ)4xk{WB=M5c^xWv)w%p7IFAW+PVv&e9;>6F#Y2BLQhy)Rti#=~v^%8v
zIiZgDjbcaqZD9){$iGZ*nCEW++6m_TZwT}e(%Hg176M%(&^oV*C#Z=J?{?8|poi;s
z`{=h(TkY>{OgN4QN>$*WSL=q(Ed2~syyUog2fi8COuSe7nVO~OLWr*fVr+oG{7F&*
zD=hk1@8Th{qP6}cLDDN?jKw4uza&ZZbrrG3t!n*CghO_vBFUJp)@M?^_1{UxRJ9&L
z_4$9dGLBU1H(@ol^Y2JwOSQh2>OcM6#u%&C7g4?OKQYFgU_^TfR3G_|-T0SUzg2+x
z_J3v>3)OlC)!W>^*z_R?X}{a>51OfXSs`8{evS>r9TE}pz@h($9%eqMtAC3gmOQXG
zPM1uM+r%U|4uV58TK1rq@yG2#i3ik3?89*5F13D=>Qf)KF)mQ+uTg!&!+7HwJV5C!
zRKNbPtKaJfwXFH0$?cYG6Y#$Q&yS;M+FC@@s!=<JRB@Xw5bN$opSMdnphZqV<moAU
zQfr;qSE`%q&&%lLq@g)rV7c=JSYG#p_>Dnp2R&2$?i|p*7NH%huMLr}Dcb&iy#TnZ
z?HjlbUp>&aJqlbm>*L0DlvdlZ-68x+W5Uu)wx$2raX}C}(h&Y8g*lhuU0?_hn7H(a
zZ7JS*;eG4c6<TeqQG+%iq#=s6=d{|<#;I=zz$b?Qh}UVG8hfgMB?OqH(}s64tAKO>
z^6|NlhPS$bMsO8FZ2zZyKnoG2K%M)ss?`F{yvJ|tOr18!c;s~<yC#Xcrqi}HDk|XX
zg8&5iX}cJcRlq6&JmshDXZ%w&O?Lw9@Y6PIlYu8v7)3sQ*$kIDexcS2)z({WMeD;8
zKw!%U$De-M$R_hu5l0Vz!$uryh{J7}NHXK}+OGO=dU{c>-59tDpPrCmV}Xwegkf76
zwD0&0+@oE4(x836)@*3*PK|;1Wz>gke{DkNwRjR2(oUXCH1F<(G@j*M0=0+fPvWgg
z&Q0WIdj&d_egTP!K)*-4_x!cPowL`15U*L$X3X<Y;s$cn^jrtJ+H!w0{~udd0$=0t
zwKGXBA>!I@1W5!5u_i<i5fTzE5@M(JrLmP-l9m=1i4wQBw$@ZFrPW>0sx76BDncZo
zRTM=R?WC!q3tHuV&ol3vrTu??Ke_LmbLPyMGiPSb>{<Q@+g&rsbWu%uqy=i}clts+
z9tt1Cba0@9V}w<ZmgtG)=wza4r9huC(TU~gq)%D{&&O?mpIz069#)R;$><NDFrer7
zK^K2l7ERjbAAIC4sR5(?f*+Ofu>_h1NiC3bG;#_{OvSs5X#M6Rr~Q0HLvJr&<!m3(
z$h$hf*87NNoi~C5e83(2u_hgXR!86y9aac#@kzrcn0M1Ow(C$%vNh=>Xo3Kd_YmLl
z2{kqcYQ|kIJX@QCaKaJgljL>0q`C>)2N<RL1YLTfvnMY}``84%2T<{9ww^BAF658e
zTX$V6w+2AlL00kv3S$rogEi)-`>d?}SQcA>OBuk0Qw++Knm~Uc^JX1f5{u~)lYI(-
z%WkGON%#cH@PKV3c4hJlO?+$MdwV^y$3C3%J-~ASmcLdJ&Aof`t3g%K)Vm|UlB$Za
zlMmsmWEAYj2c(r5=w=2kLAsK5X26e_Ff$O(K!6z-#DK3EsDwaq%?H#-A2NK7VS%vR
zl_UaW6JIgLI|4Ad%vbdHzJe6wMPJd@`%`}TRTE9eA7-l6SW`F~c>*Ez8C;4)XD=?G
zCZVap`9clHmIU<{P&hIJ8-}T<4G3jAs-e@$&#0D+JDFUzH_O<?Bea#tyjTsklF6@w
z)zAbE=U1Sg2n^&Giz5%kVRw!6w!4cmZXi}QR`|hwP+$|%F7Xp}TJ=DunT(kY{o@yg
zAI{38SQGOWKjV$d%Pc?d0W;jLfTl_w0r!UdDsBqar%$8CqSk7STfkA@;j?a5hJU}G
z5u>V>;%oIY+?Ob~^B#-04RzUw1`C5b3j}Y6%Y5X6YjRw+J77%sLBL5IK^yzy0MZ>-
zUDWYX2Oh~o^+i3oy1EE<tkuL{tAQ1{)9|tpfm~w#!+nIwy-_K5YI~GPTul?>GJZEi
zLA^-AZRWOKW{g{R*+8e%vF<;TmU-Qp5s-Cqo)7J`BM4-)RWx#VY9(1}^T(R>+1(={
zKp*~)s`V?>KbE)fqi0Z1Nl)E9g1q@<5u>ZMt?hn8>ZwR;WfHb*=7(Cl2z{LD5=yOP
zF@<89xi1(sIKiE(YcSdb+o4))Uy$ckh>h@kFq1!7#Z2!(Eb$RFM5|s-d=)Q(>sH<d
zzf90{4MIukQrt|?aDbryJ{J7Zt?^rgcGraK&Un_5*K45L83Q2lZ~<AC(KSVgcV7VH
zh?=6KcPhVLtSOR`8zP6r4UCrV!3X%J;|vKe@Y~Dy{+QqQj7DY^ze|ko>HNNCeBZ;j
z467v)ygy^xHm#OuT2tYx<Xjgot)vD_a$7CYBqot^K^I-%?3M62iKB>%(}FJBEBvTO
z{qTdvmCBFG_=v!Vd{|3_d7r1fHLWdL2D`yu&rt59o0a)_r=zFQIMBpwOzcU}ct4^v
zTWX62-jaGaTw4TG{t__MKABrz*yNqs;*_^;k3X%0ZuCjgKdd9d9P72^6(!>3yb$&E
zZKU8V%DQY_W+*7gm)3%5@=t+D%Uo2W63{xMZQx#&R41q=wtKs5{s^lLpem^e6Y0rZ
zd1V9i96*Z~)q=7uULZk5{(&jFY&Uhna+^&w^S(_(Ic*bNy?64fy1$6@e@0tkk^1bG
zmI*PcQ8|PC(QGuJa+dguuxW4ZMjE3*0!hNlgggD7DO|WA+(!tjj-WDx3kS1p%K-`n
z$hxmz3+%bC$AyWabZl|7JwnRZNrQ^R58m{#iBi?5D_VF5Q@vg5iu&H(NLh}mD`LFY
z5xb$TNbflvU+OOWOx=VoWJn>j66$c~W0wIH<skG6(ojd)2*JE_RW7|#mu(5ca!`P1
z8lH)-5<FC8o5PPle2nG?BPH{L<`Rn!xh+8S=n;x9JXzX1yN6N%U}fFEs1o*Dy#W^w
zD&MJpq9Z_rJ{#vi^LZb$HR+i8<rnSNx<DYC)e|8-=oFR&9Pp^2XYQsWl(y`C2Azj%
z`#6b;BNq8;6JkN(-YnG`nz!XFu#o88U0}4bo@nE}8vuEzo`?-wgD<@%;)7@~;P{a^
zKZT2sXu^kqE4~fin$5KwQ(yQD?yOkgnDR<}s0zR5ciD~|c<HR`JKlwV_%s%%)R?o>
z+E8!IO8-N_J}Y3@mI*p;{Baf>PmKKs6D2aIzGxu!%k%X`>rqR9RjrU_Nfc(0FyZ9q
zeoG5)Cwo@45}Q-QuNiP3z;zA0_cOGGy}j6y#ttNv^c?qaS0;Do6rY!48wi_2GeS)*
z-j4{SE+rzAC7`wtq3g1#h|%Cxyn_4<#SCG1UU^vKr~D^8oZ<4mZ#?59{_K{&HxNNp
zU%dN((y4$#SwB!TwY4X9qtTA}+%s@j<cdHM<lh;n-bb#7luUw<78Cc5f$LU^YYW_O
zCeNqj$AO|z=i$KNp7@Yt-#ljz+@)Ta?3=54U>s4>$OPfUeK;u)cP@y5r$Z1@Ed7Jv
zRF4HneTMQbNrZuY`vy#}B|gsZqcJ}A^MeQexA23mtcxGC#&monyR=Uv$Yp`Hn*8{z
zyEw?<vK@g{sww2m=BO9yg6(gZrW&Hj@Ky(p;mcowgm0xKAT91B9|nnLw)=a@HLe&x
z>5Z`n5B2%|AY+0>b4T?bSd>N9eHYaQTBXZ23si}8D+_cD{s3c@k|6aXkSWf@Yc!BF
zQdsxpfkdt4P{vvGF(!09)E#n&J^B>JC$_^F2$5hm<JSebH}Cs@&xDR-G`y<j4^a;3
zSQqD90sdtJFW0;v>iLW<ZVa;1r_n10%JvOKqwYQOnOdRpg4A5g=T-^4A>spp_+&|I
zw0@YI2=ZV?W4S6;s19K~(Y>>GGhBj)&?PAwioU^3IhTPM$q;4#(criPWP0=J8MR@3
zh^Sv@&NTyZ3J7d0!kAt~$u=RPo@eu`vUiAR;TRlRgBP(w=VcE{RMMS*-!8OBIoF^P
zH9`w)>9^5X7qXkHLtOo{BfI^6dw^Lm7!S6A+wJ<MdE^LNxsIfJV;5Z#_e9v$q;Dt!
zn~U_HOIL~hdBtI@o{^2uzt~`x1P+krt7oo4^Eu{~`$kPh3&nL@Tz`kWYvGMExICVP
z8!U_^Z{0<?{7PVdIbAp#`O+z-Z&~?@k%{5RL=!yoq1U;X6MEp4#&a>`|I10n)6B(i
zwe<?P82gA@z|z_5+g*OoF_l!N63J9DWA$zfoR#3e#U-)0`K>gG*T*3S8!X7;-XL0I
zGkj@!dJpz|oQd~U&rw;FkGDmawqQqB$X}a^`f_<AVXb`?Nh0N2FcM=*cEd^eP9qUq
zd)sM5jXn01H*R|OrM0X+EiW|^6Fuc=*{!kYU#Hz=5TF#kO~#;s7rExC+VZu=qJ6*P
zVCEXy2W)@9ml~NzLSs3y0g`hK>I>9KqT-3lJQTW>8Pr=0o>`&gd5`iW1E_*zXcIB7
zdBEqOgz7MQ$J{x$npV<~7j;|$I}v#2s65t0#JAmbl;q4Y&!*U|yRO;2uJR%S_&Mt|
z&WNZ%`D*b|*&$SH7*{~28W$_#CucWPA9tLsb@W1fbKa0E7xi>?@jFGD4@lDmH2RWx
z_2EUPTGo|4`JCpqm6RWmvX+d%ot|Qzd^}8aaumJ<r!=D<3ebfwaQ*~8Nd41056Yfx
zgo5=hpV-;#?aW<1-y!E9?++Nrufu)I`IYPk9^*8!z6HHV6<jI{=%vcT2<z?ncQY#4
z@yv3G3~VZDHtxnW+2eEPHAF{2Z(=S=x3I3dDEl`RjU5kOB;6%lz46W=g#G{!NbwyJ
zF2C<@|F6(vXH^iI#Rc-YfPvhbLi3_X^^`6~%SLj;#fHwhx_x2mo%wmlSi3s}m2_~Z
zyxml^s5OnAs>_cKYtB~Y*d|*w6HP^TIj9+A?0eqKB9=38#vAftBXyqIam4M$J7RX%
zlbF>$6uMYrun2Gt)bK0p&Vo$ko#@QPKJ15|qG5MAeC%E&y`6aV@ovUfiTc4g+buYz
zpj4MZfy^&hXEZn=NWj>P?XDsJXeMl)U!Iq~;iAo84k;k(FK{7q^iJiwpXr#sh^cqC
zV|%7gY4L8ESwT}tAcUqq1Plz`BLglWsJ)*_SGZ`|_w%&^wf%<_=WRTzG7i>uQ&07M
z1wz-5o`_O{FEs&NXtH&|>JnHbxQ6xuu86pvT9g8{UV1ebDXk6=RvX5HrfUbju~-3H
zQ!@xb1@DdCRqs8uTwWvOg65)+@Rui=i!lxdx?Avk89#;vR)wn5lFW*7*1$eP>@6r=
z{gO)!;QZ&LP;7&`qS_-@#zuK-7IVl6jCk;S8!^=H7z4s>+eaqL(A#3K6`p#UgqxzR
zNhgwHz``!yYa#sL@f~a-qP=FU7V=ID5nAiRFPMt%Ai7}Jc1OUQwG<I8Twn5DgDYU8
zmf};hNJrm*ttV<W0A(gWNiJ?FLcB0rD7Uu6+nu*Drh!!1J0aC#qxfB`ge+_+q9Tsc
zIW>DD=nR&Tw92rIcx}fQ_+(LOAN1iDGP0HE<ehutfm=S&N(8lxMRarK*tQN({eB9Z
z&5Q0~@r;INg)URZeAQZh)C!}h6h^()N?Z|P@=$Bh&oie;R%;_#d%kr>#<me{S~fEl
z5U1cL=Pz2#sY5zz^Qzf1aWA)r?n;}mZ%C0Zwh>R)T842Ga(5g*IT4tBRN*oxLe#7L
zZV_&(tR#4Bx~?1?A-afExh6skN=`H)+@ynkg%SFHOdVL&M*Jqbx^UgqBRRI~Q#@Q6
zVG!q%_$rATgQ&!di*G20sWLKBv}@>D2nN}~B~^O6`gy9s^zZrhZ61xUoeGdkB1Qe0
zLHl(oxUc6C>b0uAU;2#{4P}0$=<dBd9pjLiZAH%x2|1wRc7_`iBBo`=(9+Wj_uv8|
zpX2b8(}VjoKRZZqEm3n2*VR@84fw>MXhsUX5j0y<^i0(UXHW)TV=fgje%9?S&fqw4
z2cVZa3Mj0apMS8=bS7Z~jb+<huzk>0j2vFeVEZhbxg0Knt8WfyHvP)ks21b_cL1&L
zNb>lkY#%!g%flUsQU4$kN)4x65+04pXs&)aAa}Nd|8@3&JlRf!SH7ivs}t+`uk@GI
zqcC=TaTWw<6(tgC<uBI_^)K0MsBJS+0Cz-*y0NDW!1U`FCuANOr>^cb{75#-Fyu@`
z)2IH>r6l0Jy;3)=0U4Z)62YEdos@T?L}-mBIswCpJCO`*SbGsu@6vN@=&Jn=W!zh#
zlb#1$va>+HgIw3?_k{tSd(B86os;_hBl&uJ(YSgOqDs$yRF_}2N8=w0e&999h!uAg
z6~P)Unj}^-;1L?`=L2}@o5$FNTTe5}wOj2tSm)=<kkfK*ndW3MI5nlj528gq2X@zA
zWu}*r9&f<e&gjq=>DX!LcSwKZ=^*TH-iq&%`K*?USa7JQxToFrH-{^wee|~<u|(q*
zF_zQP-$-!^Lm0U9B_Vp{{IY%j7(<1~>K#OtrU^QRUmyKr>&u^Ixye@hiR5fc7(+2}
zO_vK9*Fm&)Y|$!S!ewnNE4^%lE*hb=M(DZ`dfo_egD)tbGeXJ;EjB{;jnFejNMFyJ
zZAmvmJ~WAJ%S<B_f>7}?T%uCkLHIiA5a_a;M0*XA>PF~$BjjU*ij9z`5xQlB{((*q
z?@uFi*9ciTtC(%MZG>(bxS#)p`@zI<8a3N;)pMDU868Ea<2c~Z_1EbbgZOnPk<;SL
zWE!^iz1fN2YJ{V9YhpfjNSSYFXNIlOkuu|!@HZV7B3OnSQO+U?2=xp@ei`{=Ci#Ri
z^5zD4yUPv^Uj9oTYtrjq&HnGDTB1S!FZ((Md018!q=7#V4+uA8W&RS59DRU@s)iex
zhPlBD_S;H;n`1neEq%<RR&KqB$&S0hhq{63^tx{Grs5}O2^cCT;D|V7sgOrIi9TK<
zvxKY>BchWxvZu#O!)vq#EkA%-Uuba_4d&BV9+ck?XI(MVAUUE*{NBY6n*P!*tS@L;
zyW>26%#&wggnz9MPq^K@a_L7J7doB76Y_qHXjtnT!0GO}Qvd0lnd_~N9hJ>Hi^m%d
z)ZSo`dsq!PU-Pi-*H^s?Qg#MtUw!2JoyEcy9k%I={j?Psdz+m~mE9oGJ5iC$;^OxV
z8S5gSgJVTp+sZ)G(J#H$qpx;<^eA?e?#~NVAbxQ|I|&Bx&JrO%ixshsmdqUPdGKMg
zd|t<~4Ac3>Jq6l@D>CoB#`Js|MAFOS>i#YWgPv;;bI^}#PQ8&0x9!kk>gqmFdKeJ~
z>7m|zuObs?n2C!!nNPl1i@{WOFMAIiYn6@#mjK7owFt*CfrCeN2nMHyXc7Mb3vil2
zPP#*0r8!x)FBbAsblcVuni%t+h#0g;$ly5P->#Lx0Xx-k*^%A7bt_8<pBNS6?3u-8
zqOqVeZaBgZ9YUtXiFVP8w;(lagy0U5P$rp)@hZ2sta~5w$2<{g*Qk1nfXXsa^JGCB
z)=}c70k+bFC6nCw2ws<_{}ya>oF*<(vwAYXy6gs}ig|Llrum9A(xj<o(8O!ZWnx}7
zF~9AgAWs@{6ce*SWBiKLMW7CL0#DUXKHXJ>JN^OyXJg~bY@-Ve!npFqt}Yu`%qo}{
z!UP-G5M23!%SQB-FTMsS(jGHCAUy<sL(=QB_|a#uN5pt@A>0VNvqLfVl;F27{6RiI
zcY^U+XHO5%yVx~ouVytJ+>JY8s;Jiu2wJp!B|nvYyNNLaPHfi2J!KOzb{82_E8hbr
zbGo9|0*&lT<UJy1Xe3US9M+YhNbLroVrBT_u>8B5Xf<dK3CkXC@K8(NLYNEr7#mu`
z7HV^|X1xU6CC5Z%gc(|#dKg4{8pE1(ibaLtR<?H3EWa%fa(=vM(B&Mq0l5dxEAa!L
zJbtIb!tcYlp$BW$7c7j!aBg^8;xWy_SJnFjY*FcI$}{mIp#D6>vSu06nw+NcFj5$g
z6g(3|GtZ5OWXl9mzwVxWjD}f#5(Q&H7b#W-(WnGW3{REw5=0Y`BsV39B*(q^T2GO$
zKu?o6%RKNMP5$JwI-{r+cuFI6R`K(cC^N1<z#i$4+gBZABAA&$9?~ZgV23oA_wR}7
zuTr&_HVp0cDfd8(r*Wy!OZ2~af6(*BN2JO;<PHU>NIk0|zG`wg%Z#0dVqhSnWmb2w
z)Y14EHXBEav(QH1{)kR)TMZ4d^yUu?4HvxnEgTBl;?v!>mVok9zSGhiUnMwWZwt_b
zU!-FZ(r+*c2l|xYkr|8*VHU@cLDt@uZ*z21Sayj@1B7{rN)>J;q4{-`FZ2)%YxG5x
z&;#BtSwNe2$-_NF!hja@DI{hT;eHoC&~{EqYn$Ms^va!<L>;t6^9O?S0Ox=Wrr@_r
z>hO|o$`}Wj?4O7^_V%zrQz$*98cLhwdzD@AUS*L=&=rd#J!@7aH%QOkq7aYXWNKW*
zD0`{I_jTsR7BCE@j=U&l4ib3bL3xHxBZj`ka#VUPG;80E;TZUWJprgWXiIUEXxC90
z-o5c)II>O*5F^;gx@^axP$s(GWN8EJLld_2Z5f&*I(QX6E#&AV(W1(>r>Q1vB$um`
zL{G=c_1Xwy@sm>%XRg%fHz;|L`hd2JTrFei5b!b)uIPhZbYf+Nw1i-HuHDrNokfA#
zqU(jB4{f+-Z|eCi%!1^ry)<z2X4Un?E<rVwC)-e$?a3jATDr-!o+7keb*aT#{u0D$
zMX}!5uE|<xvO@JY^@~%#kT7E@Sz{>LQ^YwMA_B@#H^_UKr{Rc9x!N(l+0N$>F~UUD
z(+K0~kat!C@tBG5Fj904)%jIlYdVzj3F^aTbAbt!exww>3vfBF7xoxbD+Oh0)z#L6
z@<P>|nnH=A-$sWwDRj7p`tEgkpqFS7wDc-a&H`c^t2?NQCD_f+^C)P#)1<qXsOx!Z
zpA4{z#M)V_v}X3MgQ%}SRCVDs`J`REmGIh&8u4H)5I2bkdX25@N1>}BMd`%hVde%~
z(Ma?wiSBPhZ-hlS4>eN`>x}_b=1%!^Z_%^eT-cWJTHV7v6wWA8-1>>CTJ5engm@`V
z@4IE)l6#N5)my|isf2jCR?`E5A%6lvk>Z6lNU?(t()nwvOz9&Yi@CFv;`I&TLp7PX
zp1obI5|f?B)SFB#yGIC1mQ$VGjrctnzZ>H}F0c0yb;AX;S;Fh%^HMP<G6<%x#o-w(
z49$BWtmS-0HtZ`N7x5C$Q#Gvl$E!>e`%BEew3FQ1SA>dT@={+B7StB)3a{>Q*?vN5
z>Jl;lf6ReaqyKCn1CvGj+IBGbSGJuW$cf3Kk=K=3LM~4h37u}khLGRhD5jiUly~|T
za5cNek>CqtD<XFj*^fx4-`rVZeTrz<ECw4}X})x+q7B*~UjXfAr1jCXHXBmvnIZ-z
z-qzycJT%t|ROb)KsXz3_P%9lOQla`cU)5mG>cnvGzIp?n$kt)j8jHM=BI0Wtc$e5S
zc32>MyyxDNt@?@JX8kq;3X5EX{!E)Nwh!yP<fczIO*o!YHM9GPrX33|7|kT;o2xEx
zb`1;G&c_G9krCVxw1@?&H<BwJjK&g^^@aUJzZwU0$7iH}Q9bvrY}KFXZz@aQzchVQ
zB&3gr9Wei<)9){u#uuEgm_FR!vh>fZ4}fF(&9uXe^pTvIKK*30ZAUlC3;ji6<AX38
zoJEM48=f9vc-QJG8&&FtQ(`Jz#-)nb@KFFpxl3$z>`U;-@Zv>}y0KT!mQq92x8XZ%
zO%*fSu6zY7@F<yeDSAP)Mulo#8Dt6}E}QHF!{D8sxM>SDzS{udAJc<GxX=Txfrpx)
z3;RB^(Um3F6i66})nyFhVbCOFUJgAcUl<_Tw`lP)ZT&tTglcNd;sIZ({>TRK1P`M?
z(E=B$?_QC=48SbTx(%{2-UdtaVn2m$rer-Mj7J3YbG*Ju4Pj({oA*E`G3=_=1JB7n
zjkluk^709ip8Z*spl%lrLJ3o#G>U!zjv)Un=Jm5hYM@*-P(*b*4;k%Vxm-l*l)(iy
zxHo<qrm+&7<lQ`$W&C#b4$!wrVjyf@={W#ok4+O&3=*wsW%ksS>Ibaa<gBO)T~(6Z
z28kr!c$gVfigM^6R}B(D4YDSKnagrxCAKH5c!F!Q1L85g`whbK#2^vrsM$l$o~Xm?
zwQ^e^Xvb7P8J{HM){+^vtSn{l3E$=fha~{OT;L`oI**fexLy`hvyDDfub%AfUSVct
zl##$mz>vVZSS8KLuj)|`SDpib6k<wK0P|>yw`#Bm=`x}s3lD?E41+~KvM8X8vkVS5
zv&~F`LovQ(2{}AWs364lmvk;`8XSJZLQzf;In*&YY^%UwGdc7cBAWEwQjtTF!Qn%|
zkd1ZZaF!hQ0-oY5&^{V{AQiY2*Zbg(iS&?6y!gt3UG%t+dxwbdMsrbmyjla6c!=uN
zqf>pYVhCZIUXqW7h_+s6!)3dnV$EYSCegXnXP6UsC57v0yzCAWUnaD<SyF(9dsKmh
zr!9V>*9JkZ>EB}|4GH{$fzlbiV{gfzVPbaUX=PLQy8G!1#UgL%S;*TO-kh_3o!mW4
zG!z&Y3=_?3Sq*#u@w<udEPaQINUzqAx9e~b<*+8vHu6+U=mc#7D<58Wv)xZ5xJcE}
z;5@v_0(9nm&kXOh>@je5EuSJEAaL{KbrEA#QK4{pP)AZ!1ALU=scPG=eGD#zFES^&
z>6OxAhI^)8wmXmUc|(l-l)OD$)b|RWB&6R6(W3S{i*$A_ErqzZDDFRNWS<ct-fPQ5
zAzdTH%K8E*)IRM&9UBF*mDSjE<f}Te?PH>OpTfm}Z82frtY)UHs`(n4QhRgSy~9)7
zOL3TlTTQ}`K*%ZgyId*4C0j-6?rORHF%eOJ4VxQGwPWrbqo%+aa4>XoU%w`AJ|==i
zBUx=E3V)ECGg72^FV27=UKuGunztXz3DhJ!e1e8qA5U)qh<Q9cA@h+XqZ_nXeXNkH
z#$X3)+$dr7K8L)?)KMbL>*FyR?mt1-&5X_!szu-nx>{rdhJv5wKrYhtEiHhbsLU}y
z@hME9BZoiI6~^@#B>9LWQ$bSvK9F>BYl7klE(+WpB|@5njQOv){(zL9ruQ%e3XpwA
zL(t<(5O2(AF~0o<%;Dq0T<2N!>|fNiW!&ihG8zg<IivW|W{!QwfKeqf3LYaO6RMUm
z`sF@)-nXvm;qJ0vJ*2aIKI*?*a{wvlx_y-9+RS?zN>$=1x`ws-;|sa(v=F&}kGX$L
zmW;tRwf0=h2p@|)tC9a@dKHjzrg<X`QEOL4Cx`{Ul<vlf=@+0-xqd7*8qb}Lui~+y
zag(tB;nm<@yetMU|C;mqR^U_wbC*NLi3wrN;kl$>9t?L>7pOo4jHG_E>oeU?-lcAj
zV&%dnH@EbxEbosK^@D!QgC#hRJJFY;|G%#){Y@(E2khA_BgTtMwJyLOp#-02poIQd
zFi|aJg9)Oah}b`Eg2)t}?=9bdYoeGgn*5Eb#9B0MIe4I^wnFWFgb4uS@H#Q6a^d5m
z2n+KmX(Cn(m)U7zievda%|8Um<OIM?SKYHvk<j90H-;^Y7z%Z|hTKPE=GO1q;dcLV
z#xnvjkKgA$4@(D-@QzrJ-3FOGI|EPQ>FIe);Zlgb5fyBI6q;w4?Mc9pt9R3@BH0io
zdpc7-Gg&nBDjFi>rpY4MYbQPqPZo)_RvDdS4On_k7m~J<wWo-VLxP7uHm50@2MQQ|
zmCF|X^dt8{R&g~DT|xz~pdD3EAIa-6uwO<)uFmBvA3*S%mc5|IBlTdZe07RQ^2!=4
z<WEyX!xn4FgCp<ty3xSK7v%tmcYzMafEmkFe(9}v9Viz0rV3l#LH|aEWYi%tPL7%?
zLYgK%MMV_p9g^J0ZW#oC`tT+N;FcQgS9g=IO%+3jD4>duB2kd-;5Yp%e9z<ed&W2U
z6~AhH2k?8H@%;<RvUs`iy&K;pixBYy2xQ7M(ZmsN=>85AmD3Sa>gZyWcwf-$1gNAv
zK3x3Z2DW5=a06Qdez4K~8GQ5xwh#Eh4Qz|?fy>PTurPot9)oW&J4peY)*o$5>u1Jo
z!c#ULY%XoFsW^j)NFN=*dKm83e^)OksA8_JW?P;D9n`H?`agtWx-g68^0Omt)lfE_
zF2bW;12pQSy4O#56b}MZHD7nie)SPEXESnxbv(7~6O1hBIk8S9$|ci9gZi8LBVAm+
z%^z2m9<st(D(%2re)0^_NK}y*r;8Wkucy$cbPb%kmSt~V9Xm<~%xUue4B(PF?BXa=
z-8II%#VuOyctUiV5(<eS<#;eFzDy~<=L(wBFAHMlY%!(0g^95;DR=6A4nttfR=t84
z+UT%!37Kt`5DTK;0ym2OHsV9{#c!61K3C41A!55%Zl&wg0oD^-<Af>Gg(%lJDEkJD
zfTehdA1uXn{NOgk&ir60e#?%eWQN!gg#l}+3c6CN(#3(cT0}F~p&Dc6x~@DmQ^YvJ
zzzezVj`+oIpbDzbv8aL;A}E=HCv}3*6Hwl$ZN}X|$fLfJcE0W*{JMfHhf}XC!gq2Q
zl~V%g-{3tD#Pu7){?d6S#p$80^`VGpHSen_tF&fCvgqrP!&=JNPw3eCNFFv9xYIYX
zpt^ywWDRT+vtjTVixQoSS5r;vG&6nqW}s#UpGg)xDI%(8AtyP~<atY0oh6zLZBR;m
zUu{Qc%qC=${`HF{^~)yp)`P@R0&7+zOcZ&zZ4C0%*S#scPH%#aS%i*l`799?cO1O+
z@iyk6t>(b-m^G_wMGk1<H3w~^zq|CPRF$~oy;-7d$KhbX*m-)6ma)^}!P@GL(`_)N
z^(>F<L}a?anJzhYwrE`M1Ugo#Rc{gg#9k(5FZs%BF{)2@#H0c4MjpX)?pyyUOE&hu
zhE{0oUz(>Id(SX!m{C}(&naeYu*mp1qJHfTOwQ$3ned+p|9YOBF-J5E=;YL8dJ_`l
z%rX>;ai$s~x6cvbK?@!?)L!j*P4xz;W}9lSA&ckWRKWY;Fy>}+;Y1IVz2*u#YWM27
zqLHVZB=^k4R;tSK(p((o>e!1JO5}DNTi<P50c7z(XS&}iZd@TNtDn+Yc?cLpZiB5x
zIXpL~Jf21+)+h0w%BDE9SnbwNN3KBWO-fwz=b_GngWiXO%9h3~cY#aek?8D=y;=F{
z@I>iK7r~(mdkVZda~lyLS$x3COX#Iswz^xP>PGVvD$^4^g)B-J4LW`YC82TXg$P)z
zkHilMzkXG>r`o*kC%D&!K&@GqGkUQSbY~@)CmUsm+G3K7&Jc|~v$N%h43UsD^hsTF
z-%CWzT?_{lZ^Xp&kKIEzP^#(*%5GTm7~-9l=}Ed$pFyI#H|a$2-c5b^SB7ZlKLt1#
zp`nfW&2!jCseIYyDd9iD2Wfy+v4j(AY;Sw5!tCFRbZzMi6{>4JNT_EyrXcyGsGG?#
zGcH=68v_!(v&QcZSmkU3ZyNk4x%ny4#<8S4mLas?>!f<kq^hpdGAfmaP79ZEVsZq9
z-`fjo6?62=RTUJ`A2ZM}Vj@K2mqV?@k1WU6LBW;;oA_ZH4SZ}}gP=Ybv<HFSF<Pi@
zc9-Ly#_0bRgoCWS-hR}FrPh)@00M+*;yg7!onTD87t)SG!KNiJYH4@s0u}zY@}+wR
zgYm*|@$V>J%vq=j8n1O#@*MF+>U;gm{X0o#aNW&yG{CaPJW(fQ6oklm-PFek%-$If
zj#;w~8qA6@hk?X&zU{C(=DXEwt(VT|!h#rmyBU3joIOv3wEZ{%cGIXlTIDT9w9B(}
zwAqMu8WQHbVMgmHKbt3pwT)u54S<=cJ-NY%HVDxW#f~V@77lF<&Uq75YM1OYU-ZHw
z0a)@0&3TKUk#fs?QLp|>0MYk^eu9@Vath8q^ZAJy^6Y#O5`7CkEw50IEbGj^(GX-(
zlNB+fZQhJ&QHQc*(`Q5%$NJH_9=j)_#x{WItFv0VpfQjRbrXa87Pz-~I6`w9VM!CK
zQ|HyMGnwy<$(*&zJPKDRE&_NDEHb)+(tKzZphLp7NPNT~?o3J^Dh&F(A_YzYoma2U
zls`Qq5*-C}@o}vvW$8&-d>~7jIrE!0O(W|O*^9`MCz)x>VrUuO!)*LuRytlkV|C;^
zFZByu+ic4S!eMK*?b*>o_+9oOMM<jNZRxIKpU8pV?cuKy7zg*48oaRL@7Ewf$lPbe
zv|5EDb@JRIkaL~MSCL&7plFU(0zA{<<B>kfx*racU;S=I54BQ0xj=-7ujJ|lBA{(2
za>jzAby;QFQRaz&jLmje+}Hn&y}PRsJH&`RUB`|sTv8gFE}$9P8Mg~b;aVWHeNWh9
zTfc+Q+=+$|aVDGhcgR@_L_^Q}Z_70cMBTb0O-31Q?CxXagR<+|4I`3;qJ8*Z>?^QL
z?$=)rwJs_78k1cRYDZgb8LWZ0v^Y<?7m5as5uA3=NVJ2-7EHT309PBHV})(%#`gRG
z<5)pv+?Y6I-@1&$86?yeA+-rEuAM1!Z(4lmcKG96gvY0#Vin=-wb+K$1k~=;ypI(r
zI@pc1N7FJhph7ohdqQ_(O92D>Jrhw_tGR%_3~<O*?4<g#<1T@@J$6B8{L`}!h5)2)
zEF!+Fb8819L;Sgnzn<}vbbP<p7>@@S?9PP2r*QGlpc*J~mxg|6&&I9*m)}@~)IjFR
zX_-rm*9n;6RDQ*xD}HK~F|D-PAs=&yPO*<-$+A#&M+{7d$2?oZn#FcRPo5X5iJB2R
z42Y-xLI^7lUxW2iu|gI&M8m27Ky)J$=iv`m$V3yED&(0o0h#!QndmSb`0QsPvTc=-
zDl!m&O0YzSzElI?&)9LG%G`6Gj(l?aHj2~oYiFHYUH|#m0g$hPpF!*FqlYHg$gd{L
zrHe&7$D#2!!i~DdT_r0XN3y(|kmQbOdhS3YRuRFub|TV%usat{femZqS|WRz$lgR^
z8#38#Bchjyh}5wxL7fF|neUq7EHrFHMlBJc9WoX$mz7!P8Buc_Wk&pZD!s{TDKTBG
z&ox2!*jqnmV%Zmisk<d2GSX}P19u;1wQtq&$y(9KYh`<8wTqs`_jQq=*~M)W(j?k8
zS>9YC>NlRh+5{}nu`-}PO}K5H37;gJFBJ_&2d*{4-TqBCxD?*ZNEKU!b*k|=jcRae
zyvB@a`FG6Dj~*KG-b|C*mWqJzW~Ho7rRfY*AuDT6tBaVmNrA?Pz;Z1UI*I+?E){sv
zW{O;rC2VjaWtLbOc@M=0gR!GWFqVw#g9%H9tB7+9WJ@AjbKUdd<8r_<@o}SEc!;>F
zpZX?Um_gSMtwqi_(uK&@&xtYBN5i)G9smTv4hy;AInl*ydV3)+J}26G9(_vsE*A-6
zu}oPm8hBld5_0--(MI%_uPhfqfj-=0jwZ`#!IoFHMfdRoNk3SHA>x-HbhrU10YRbJ
zedV#XJOgJ1T~Q6A5B!||Y3Xyj`?a%LsCpP3|8XqKha!=Z1hRNR_kfy3$A7U{QqIEI
z08~}Y)F6j`CMsWzH`(3<2h`I&VEZN|3nkl5<!rx2vXo3EVp)>)Al!`jkr5GIXY@DB
zBcg57pbSSzTIm|-vtxBR1>z^?C|j?7jtS(KuU49TjU1oLD9drFxJL|7#Ye4n8lVs@
z$2JC#s7v>)y3J{9h?EJDnwTP44UwKI8O=m(v)vA8w)CBqVc2(pvRRCuoW+#x!|~+F
z=bua8KklMa0VH#r50Wh{p)f-d<3Z#AQxflTNjBgUT74c(?woc|j-F4tO^?zqGc30)
z`-RM~-ED=ex>7WYy!OHax5BNrNSp0?`eb`%CnR=1eJJecw@4~iZ+YafeGh2m_?4oz
zS2ChMy%Jkw25L_gt7<q`j7;{BZ>|(A9lH!~sS|5KOC+eKjY9%1zq&|W{W=3pc+YZ8
zyk-#ll9(2(;z;bYyo<#D`&L3%F!@3Y^`*KBJ_sJwK{Wjr)hz8prEiz1P7&>RV7N(H
ztYVAFci&hYVIm@^&i@hOSA%#MiL*(ZO=73zZp8lz!K==KO(9wsLRia%I0OjPzg>Di
zFB<z@!a{P%CFt%YaF$Wei<p${bdk)34<DxY7t-T0(TOog(rm~(67jc**r^dWbwk~i
zhzBO(r7`m0^P;2U3M|d+(%6_cvVsOz{A#Z8jEu(QdHhz~3wMTb_}sYJ13Uq-a%!28
zd_jzh{D<4Ku|v<*dPVg|?iD@4xnpyj-H97vdqnb>%oKa}+<>&~9*#~bLW_tw3cYj9
z>36LSo1VBc`X~A<e_)3gD1D`B=;E~<)-XN^j(rH|*}lk#gO{}hP!Ii%aSG+(ssUBA
zU^Ilyj9Wo$h7DQ#-A`{>HU>#!l;t#shS-sO%p7a|k*__Rf{JA78i1&uKeVP*>pfjH
zbr)Hv-Zy?}M6c;jVDDqn%<1=ZYax?g5Dmg#qFdm+SmHSkFTm)?8#U!cbD-K5c$E8o
zdB<A>t&3daEqCK6tE1P5^3vY;7_wAdk2ed{v{B$^_UEq<VKos0fG|9j6R_tB#aa!S
z$+4MKEg2n}c^bdm<y5-U<YOHN2LO81P$Ng7$*EZ8uM){72<QN9PB9QKC&1)+aim5E
zcxY5Gg{o(w4in{y{-RZx>f{tdfG9W%5QM4=*Pmsodx)x!Q%Q7`h6P{(Ji(3EB61g@
zg#$^EYGA0Zf<hbV_@xTnKUI3IhPyO~8pQpt!ywLhh@&cLS^OG67PS&m;7P2qX0_{Z
zP5c&#r;+&U$4c|WZnvSqYX#BMiOwO~X~ChX|7mOb0d8$6+7f{*U^H$%*wO*gyow0O
zhw4Es;K_R()Q!+rQ{;`+BGq%x4B2swXxwoXTZqhwXu)022CyqAQnTQmpajC%-eQLV
z&XVekvx3<JSWl|+j;uAJevht<>;xin9DAO=h{Ew~GlOS1Kt*b&;SQ}W+e}$SV|frZ
zUp;(6ej6m}IJmFg<rmWeDr4#}RPKVP0azGehv>pM<I&X^o1)_fVJChF4j8bZ>JBP*
zb5M0KV)~Tr*2jzLgfG&uwI|R_TLrr8m5<0VU(Ljjprmog!2tGgJz0m4=}*CNCt|Yd
zWDl>QUU^(@T`Tag9Lfc#-a}A4!#R3<b~x(7Bu2fXt>r$C)}mwkDV*hX((XQD&-S~7
z0CrS5EhjZJkGll3Er$@m4u@kyAGw$DCG*qx$RR7}EZLfvtC}QHLVa`|<8wOjvfDZl
zBL>U)>qO&V3zDu_vFK)V4Hz{?-Iy*9t`mWd%S;1S@ZKaeKUsIJS(s!3z>>+lx%@Wu
zh7wYJ&@gdT42vT;%bUygmNV@?A(QIrG2Kk<ugrWKB%oF&0Im>*80sT~@*rZBVH_ac
z{J*3t4boi|NkKXHe<{Zql+Dp!lraTmZ&ErfpXl5Ti9}Am#PTJcO~OO3Xcv(KJu})h
z%(KFn^2QLIm4SdELX$zz_I?)O5PAPa5g2ezo4Da%S=4bI!rfR?WviD&tfLB($_yLd
zl={mI8=!w(w#PW`$HtiQ)Ln7G&8YJt_1#38aYl0(G0aS%1o+!YGsb>2U_r%J>7XXW
zXb^X4FNU-8&20)A)?pxcYo7;Crv3Pms6Y5L%-fjW)a_sM!N`IqMufciHxjwCJH0s7
zgRPU?Uw~>mk<F?5MDJ|x4$01Yy^s9p)!XSE%mV(_?1sk6!Rtk9>ji4V-(>a4V7Yp|
zsMlh$M+NOwAFQ?aEMPeSCgD=R>{vzimtU?IkuCiy(tk8a(>Ef0Ba=Sdq(3xSwvi$%
z_$B6tyI|Q*tUv${J!BS9p%WLvk((_=v#9pE>as|6p4UJrIk6_cmyrhZjJ*`)dCq@A
z=1WZ2oRq&v9A4|g2>r|mZDrugqJGOu7;eGP^${JlWS|!GSHSdXe=74&z?iY@G&%ld
zQMcACV*q8mBQz0#D4BZ}m;Ai?vS{aRrL14QEW$mDCQ0|pqJ@|)TWr8m-Bg*3y8yiI
zHNiRE4I<R*3_f1RNANpMXd%e;8Eo9aqovvksy%M3ka)`*8$@&KC2cPS>I?mQRBjz8
z>dN-7fcs22_7!1E8Lkb8bKQ7X73MYxgeBMUvNo$THXPv<$Lt98*r&)zHf|m>$O=^)
z$*^<H?_47aao(Q2s0L=+kGvwH>b(e%`ktPQ%Ws87>ki}nG170Ns9SZC27Rfp8NSU%
z5fR^@t2X`}II@>B1S4~GwLjHnc|bb-=rLE&j1jlxM;#equF7B`;Cv$?H*XZJaBB3_
zM$w|hCi-W5(?*X5e$)e@B6Zaq5S`M_gkDG+D}y(Q_Ks)tXhdh9&nygk_z<hG;~==L
zADXQz{V=b=eaM`PO2yQ34)51tmFOIcbTYf)yD+1%@}b1$E<V=IP;xaU9frA5r<HV5
zKZ29q3TtllJ8y)CAXX1`3V~$qlQnkHa*8{%oP)nBH65a5G}CHYlmfYuOm5CE*>Yol
zpnWLWV>iNBANBco*>tm*;{8ejJn^-gMHlZ{h$Fw)EZz*`Y0Z*`37NUKO77TQ7-`{l
zB7oGUhbT^lR>gyK^A_w33gcJhSH(*alW?>V8u_LV3MdN=mwL4?QZwgaCmYCIB6-qH
zEtUDNilIHO0f0!u34fdL`Z|&^d+?osj3x3NA|LkA@~by=acDz+WxSlURfKrrtnhPN
zMT>~lMx2xAYjRF7j+1drDb^Xt9Yp34Ia6NSD&itS4ftrnzbCw*j$}yD%s|Ey`2&%j
zvhOw#7kK~xh<*pHu^xe_J-y3Q`q)68Bk~_cTHjk9*d{tfq#B59BI>}MSA8qQ;?Y2`
ze1b?Dk!@td*O1f?0016Dcx%G1*~^pq$v}D#*@no^?DF~7#0bYo1My-nAX11JS|QdL
z1Nk(O{fLYK(z<V$UUysexBj-!Nay1l)vS5|Tnx;&PGMc6<$p8#LFwT@><Gp?wOEo}
z!Q}@Ke_I#Cfq0D`znr+7@+nf#(NkeO+YwVPeqA)KeHE#L)rFoAVibkg&`a)pUAS89
z14N(Y!5%DZpTMSH1aXBKo1XQ5G2r*{m4}e)Jhnj0+%Dq80J&qkh>Vz|Bl>Ml0>`7|
zIJRfGrY0N6#YBEiWOwQNhG-k<ZNTFQzf8D0sXS6;0~tc3K4SM>l6>L~kr1&C5Xf;F
zI|_6DVyqV`#9D74cM<tFk+bEMH$-SeyaAt2cw>6pu@xfqFp#5&<V2$imJx4?q(~-#
zlq`gICHzDp<ulB)$UrLW2g>P2<hzM-`<o)vw?+t-FTdb$agqG;O))9Cib2_(loLtm
zU4czC0~to-BqD$6K{Y=S8iFf}l7oHFw2W^^hIaH+MUgV|EipSH8PpJLS$9OrWTak<
zWD3^bKu#eti^vwT$=jl3l|F!@OdmwZVQ-6wpjsru+IplNcky5YFH4zI`XJdAAzy!6
z4C!YF3na4yEmh7(<kX{kc`|(s<Rl{Z64?~UWEY-Cv^z^EdmCIIX4xE6stjM*^BvK#
z+DHvxW=^(|+3$$45yQa&sjNYRmUEGe1|={R<1V0)1~Q$<uZip+>%J@Edi??bBC!?B
z`Hk?O;>#o5GLSw*{!Zj6An}wMl^LZO;<Os_xxcmC_^ybKm}Stv(+%{#bQY&qU^dr4
zK2KydBKt}AyJGy1+jX=A^$5Q~_~mZ!81CYFR5d_578r=!S5@J@<HUK0L*Q07XMXWv
zR#Y=@TM!j_xPT5e=MXt;=qC5RhgH5^HH@y6)s9Y&1vgrhSkx8m2;rWP+v+Q%&>JT?
z-31wFjV+59K@VpukiTz`^Lo}dwLlNqtUS;jBnG#6Y7%-S9s%s&X2Ff(oC-FykE|hQ
z?GWvUZmN#?dh|i&ijKLIWBT0vf3DzL-Hl^>%S6DCo$YbR&SP-JR9aUQ30om-nlHfA
zsfRk3%G(QU()zxr3lFE+`yw)^-aHl@kEUUL(&hbt6Mq@smiX9VA{jFMebKshZA@B|
z(X8ItaBF$qBU*m+z6k4ZuesLX)-Fi$MJ71`qG<oP#L67rN=1-|6~Gp*(JxfM<y2|i
zDY~?eMkEd^IaBplO)%h=eNK0)E)?jpMvOxOIlLB&h@vjiu~S5fBXajn5g<b3$(<N1
zPG;N&Cdp97#rn2hp;VLTg`geSjgr87jibjsz$8I(Ojwr}aqWmJ4%Zo@5U-^7>FxZ7
z&BY9qQuoeT5!a(IyHtyi<tF4?K+@~-zA{&rk@h1$dG(9g9-#=V?kK_W9`BJU&O^rt
z!1(D5oDM`za9<#cBf9AGXf!P#2Fv?dlsAOTHH6IVjAH|qfmr=WaeiLnACq)3-M_ax
zw>O4}UbzX*tYfRe7Eixs+(_}t?U8v%hrQDS`UCZHl*ce6Y0GHDa!AQloql0OOF9GC
zLq&4{EYyHq$66DPL*ur-Qes~quw-&weWD$#lw7=Cjz?f|E7{G5xD9f*2*R%OQM*Na
zk2=-hvc{sLEa6Lz{=T&KK>_;wg*ly*-VUaBQzO1qz1iQo{I2Stc5W}*<+a@+u$}Gt
zLnsl?y!vp7GahSeO{%hgwXjGKW$$ET2jE%GXJ=b>Ru!`K2O`RQ3U+(RNgs&Nx~ZUt
zh|Oc5Yu$R{@FbD10_khhNI!o93O^8y>#8c6x+eCVlv3Y_q2u-;sNdH}znwoKw;etN
z^<sm1#L9AN7pb2lb&^3njesqr4lt<Kyj)HlN92VMMMG-~e5LW230jBqK0;ddh!(!@
z_)r?ZzdM1d^B%BRpaHh=ndK}_5;=Dd5==0tUnAf(P&?`v)Jy!!sb>S3$g7KvA5RPo
z7iz>sYTh;hU?kKRKWgVC4H{;EA_>}PfRYW+v5o+(FhEHL=oCR22B@n6>ea~s*aQPc
z#^6r|s=onBH9(sgv&+Ajtt6<q0qSm04f^4sTloWYU^SYhQawduv0s-`qN~3^E?(mE
zlbB;i9A;2{_K~RH{+~*^L}P}PE8#CBP^N*z3*fr80@r+8=u=~_sN;POWHNlOXc-gD
zs)0!@+(6Qaf8tfIPEZnBsFo-$H^jho8L7kRdBw9&#x-lXoR66*pWiEjTld)xV$2w!
zY;h*m^kZsb9xa4`i_zGH!TrMw<VVX3dqs3D?_0WUe%JwR)emfmBV_PCQBNF}o%V^g
zqNAL)PqfCqw3qjZkig_D@<+0IlI3K2CAaNy<{JEL^4vbrEn+nIKr?rv!46Z7IF;6(
z@*9rPa0B@@k(e9xP`<MJezCmfg($WSXu{0Hhz;bW{Wwvw8DP6>5YB+`?68M=KSJ6L
zh^axJMe&ly{U>qv>S}1Eub1#}o_7`^xI%p=Hy#kJ+j_H>I!B|1XDDn~p^tmy7pgX2
zouojqM{zrV%l3f@+uL6LbpZSA-jN{(MbzWVJOy{*pCnfndx)yLh3$0Gb?#tLpKK%Z
zh1a>60h=_DIi9|pbsHnlp%ZBq?O|4X+ma}$6NvEQVV@YQaVEVp3k5ICcnNvnplIUt
z5<adT6b;gD!Sg#{Lje@O4(Ak&U!FRnd&v}d3&_WPwHaOnZ<dtMoIc-(JrgCcR?!YD
zx%(1ZhD#A6h)@)Phz=TIse`m;ulKac^c>+I`{+B61VP1GLhG`VNE;Kl0qS8SMdZt}
z=8*Rn0x;YyJ$&vXkL8H=wJO7$ASc(|vdHW8cGCA_(V}5XS}YISzf0Fs6W|PfHW)fB
z4LxxS$j72b-G%6mi?O>9$9U{9NqL+CvK$ja?)+FZX#JL8O-jL?Y_lK{3+hNQ5*SQ5
z&{d2#fx8LpChvYM!U7Mw^}&e>Mb>{KQ@3;h(~gHkc$@j4IGB!1vSi`9lozfSD2oHp
z<;G{ZGq5?z($DQ7U5DU^T$FDd5{V68Mc<%4(Q3(4@3sM7oKLbocOJ}O4k^;-uxL5v
z$R-*wCgNQ~AaP10Cson4z6&rM4px}#q)6p_Mdx8&G%RK;n)eFS%0Uh;%W(8@6~H>$
zB)R4=Ry6}3dC0d8i{R=_v?FXjY>nx+!y+~{?HNXo-pFn9aK<p5Zo74{f-|<hm1ggS
zi?ebX!XoGcRBcTdw*0z=pd9_Keen<n0&)A18t?+{IerbcGWQcv({ZRZc;a?Wj0n(}
zLqk0t8hXULP*A0=BRH6I_GRWZUq!=7*5k|K4zOip>5ofDlg$Csd=_#P2N_0A<8fbw
zcB`(UaqCxtPLLSu!kV}ri0$2AL<xrg@xYsp>W|f0g&7@Oc3fy|X$09!87SGi|CC8q
zDpsuQ{;6mj6u4N&v#vO;Ej=X?KAtt}Qv}q*7`fzAVH-J<tc~qMdtteeDmsP$kg^J1
zRGyuUDu_X}hw8o12%u+Y#i5xVzk#fbpvW*&y9wM&V4}S9sc2d$8^Wq{GALKnjk%6`
zQalqL*TGs8$YpuZ@;_Q$`k*W?6|`JK&d3$PbyCWar5U{{UnQo&|6+E?v$>*<wS+3j
zd^{5JrgTzk<R7^rI;}5!Xlh|GjOQ}<=EHcJATvc@Y2$%=JHNTMoF4&j4I02QyakBr
zb6jV1ep3*?W)O2WpszuF0FWH?g}N9&Z7x?G5w@y3iXOUG@U>32+<64Ec>P*1%RGT<
z8rF@!;8GUp=ACu)0){!d0iOL53!*@M)djCe_wp+K8upVj5!{RS(UM%Yk1n%$$I(fr
zHl(UK(}>&v<fj<tA;X2v3u=!`OPtXn(d9rdSm;Oq@Kpj`t)Hj%QEZ8J;|ylH!3Y-y
zTi$`Mk5;3IbJM1rT_NYc1U&nq+x;<8^C*s{Kn9OU@IW$jtv}O3e5Hb(CrHm{N4rMY
ztLXV|i=D%jih8()Y17h%s!Rzpkw(czWVV=ULuSve#D)DUb7A(q{zjsZ9&?el*HP<b
z%u#G}I2~^Elojg7crY$k>%DbQ=UAU&9GpWrT~JR_I(Qp1!LkThq_^Q?EIFhPN{b0d
z?+1BZPhua8WjD}}0eHw+V5WeIVsYOqO<_iQ>G|K)NQVONXog>$pysjaw3y(G15vrf
zzd$oco9H{xR}Phk0K2?zwf+>kSZkJ^$U+Vyk;7wD7wF&5F3o?FzdU5>=b}M73&jE%
zq{fj^ACC4c-1Ws=VU%~2g5tBj%N~l7m6)5An?Dy#BW;ixc`H}V+iRihI{Fk0TCnry
z9%4jRs3tTuGO||w{<%nT1Y9tjib>&GZ`NhWYz$mB4=rH6N-l+S-w5E7&=#<TY+niw
zG~nk@P=p7T!o3an6m}7SdzZqgEbw{Tpm(TWs8ICr%gz~y7fnXzO5ukL_&l`iWOS$$
zzTJSYFf*{d6#l#cKZM##`sWRJ#ylh%Y4Vt7!Y0`rE?c;n;3N}BS1Z7TrJArVfc;=5
z)Ww9cds5YmT!))5j_~5mgzFfv^f;7X`#;fjV;o)DGU%=d!{q0q!ydVvMY<j)!&`=z
zL1*n<wBl?dxC5V?Sm7*Vk)?pI2RbcF?s~}Ij$`2VaVq9Ko1ehulqWFF!Sf=yM%HHo
zp|Acd#L(D1G~S+_6`BWB>CGYEHigs}E8!<64RE!i2@X*f!IObVn?iBgJnLq91a8j^
zP0JSQdmxdmKr(fCCp9G_Cycu=CA*S)DEbH`ubmLJ#_j?g<0QLU>BGZni;idnl4EZ^
zm6+nJ)Z6Kg$jL2_rFb1vy(zXn?2ysgW#=i#*MHZI659>haRrsMmZ^E7vGoNgHN}+#
z%ePJJkL)kW6A_}5{2)&Rc~$-0L!QkOjq0s@0Y}siSs`czrF`8F<i00GE5}RlpDQ3<
z0m9H0I!J2EX{-AO^^SEH_gd<WGbX%!)B}YDz172y-eIru8=(W_B28kaxjv|jy?{w}
z^?(Ze;_;cFPs=1*lk$)?=N<C2$2;Y|lLFJUzj?^ZCq@0x<!roRrzMc8qyq@Q03iw^
znT;vRBdRefc)e31Q1p@=PGN8Q-!sa4yQ(NGRG#^K^kLEI(%vpSME7<t0g&?(q+_+;
z1em&aNY^#p-}N`h+27r7sOcXk{Y{hp3C$yEIQ**n$n%=x58a6?Cc!qv9{KkvXt6P;
zI$*M89pARw|6gApp?eEl=LSFB=w0~g6_h!!5UHW5)6#tn35p*YEyj3VNek7~rDYCP
zQ_^y$HgobmXfZ@AR0lDZ(=2%{ep^>xjB72f5Tn1~bDw5MR~2%xf}J($)~jfdi`Riy
z4*sJ=3YATd33Z1S2>s8w;~~XqQLoX=vur_%)Jl{xlx$vP;IggN4MCBbBV$jC297N#
zK;&l?$_dJXBbt)R0j(}q3@oT7B$B>_RISI83L`z|SBWd{tFg#pvNIzUJw;NMJH45C
zc>-Riq$?SK{3IbdEuqsvUg63dM3zi7$r@?0q;x%i>*VT>he#}G4GsFTQn~T#|5qw=
z(d}ZR40gey{uZef!LojVsNbXxVzcg5(B2xvub{oAa#(=~t~ytb4GUG}#nMqA+V?p!
z%`mJMu)_f-E4b|U0}ayx%ryvaXZS@SLuy(Oq1@?)mJL&=eur`Et@f&R%ZCNnMf)da
z(m9n?mW@rYOH(rTe{3b;uD3w%N#(wPk&V8uu{e(f+YPEJf%a@O;jA%#PdT(ggK~NT
zgR*Lq4>;bigR!W6kg#}pxjhuAQA@__++;ij7V)4Vi}qlFV2lx@KjZ>06{I<5Bm>pd
zq^xRy@KUYK%LLtHWZls5Bubu=fzr1KcZ}W%{Fmqd3i`$h>SqpHt|+ZGCz#yoMOuo@
zC?^O78+lSK1PGfnb|AS$23Sq|PjXd}MNFjXR=LCr9SX`9TG->DvG76yqh_pL4l-<J
zfWuL!E;PW%_6t`Z&yuFFX6W1qgsST0%$qPTJ2fFT2AT<gAu3UPi3e`xn^I!K!MXPM
zF69x0In9AnsL;n2x@GG#;=>4=F2sxUY54f?yTLq-JPgH?hcDH?zRvL(JUqu%a%-Th
zepdK9765GBkF}z-%;Lzj%)hEURfFiq0oJF^J7?(d5QY;uV^o3-Lbhi#mm<}N3ehfX
zdbPC7Zn3<=9#<3ofel8y*~rrMXP5~$I${?c?^VZnce=y*Y6GQ#v*P<=E_B|Opjf%{
ztib+%S$tM>n=r2)`X^(rAXYuF>#HSGg8v7Dc@joOjSU73giLzWIX#9AS|Y;8ZWxUc
zL$qietTUSNp^xesT)-X*tL-})%avb<@Rl7gM2lZ}q8I}u@GMYG8Sb<obe1)12|(=W
z7a+qCs7LafFK~ZzJ$^mFS7R@HC43-Qjhuy;+6)ouiHF*Tf)V2;Oj36IQiL}?sg09G
zUq;v1pgRY;J)~RmrC4iQg35<RPf?-SN%*n!E%uP%=S2Tzqfcm`6E_uHSIwC%V*@ny
z$Q;G}&q>$8XJ!NN*>Vo=;U)7c@0<wpj^fvyb9f@I62JVv!t@9md!q_jv%X@c@vt5G
zB<gdh9QGAX+dl&eUR6j{^LR41h5*|jpe)@4L~3tF@&-8Bc|8gf^FO3F>Ye$yC%4Uf
zXXCQPIh1RuIjdVW(Nub+WqT#AeB92Zl21Ux8wq+nip>~C!21A1ootwvke%G?5#ANS
z8VStZ+`xjIf0qgT<#h=sYPXZ<`yj+?#|+8m)P-#5S->8L`g0Rj!pMqLRtrjudAp?R
z7<G?6k16j^%7xp^5qALMO6PgpDBt>qhunD{_p0oc1?NTm`Ws+tu*%11mG5gF`CYs-
zY^tDz6c<G8z~=$$;+bK^yE|d1o$fdf5ARA?dI5Po8F@i8s<IsOr;tOvB_F#Wf~U6k
z*Wy{TUZpzGS#*SWxU2>;`f2_}UA)r$)jRt8K9zkQpJ<i7De+Tvb!zFAyI9hpx)Qc2
z&p*zLrOd+7yBPs&!Qfd~M&e6;dqITvE&ASQ{-_D(xdbO(YJhdBQD|^@>-sF#m5(uc
zDM?Gp`awUtwHe(;Nig9fYnLf#1%Pt!MO@@I@q66jcTohj`iae^6ZU2dtMXKL4uVRL
z+eaf%b|55N9=Rx5)p?8c7Sq$%p3Obl@Ctr_SMasy>=liVu3wAMj=1ljEZ1yrc9yQz
z9Y1}@NgU_dB<p?@UD>@+A7hTi=$a1GnO}C<nzdJ(Z`|Q`Xaq&-FbvGz^0+l?E8zNa
zG>jzk)umb#5w@IdkpH;fAb-IiPj_UL)9x~8(<fj*_}Bvm-DH!lUpd(dlPnhbS^TXz
zBGE&U(q6~ade$co-N*#{*s?s_Uw|$Wb3LdU|0J&5VH`{McePFeZDObGdf1`wI&Sr?
zhun1uuIdN!^d%7-ycQ9WR{!hTtn{h61m5)MvR&y6Z`|jyXwl}C#-!2Be^q@VvN(~I
zghh|2x394g<Y_#(Qj9b1vT)QDhnYvqV-=8BI{|t3vIuW?N;5<hwY^a(YvV%CQl=gi
z;$<;j>J<^^zvn8|@3#p*yk{N>Cd2^u`W2BLcJgB;h^cpQgz;reK<a)Vq@Li@BlPN3
z5834#>;|hNr+$Ogy}NSxH^N!<Grb&=uhv@k2VNC*L`aP*V6Qi~;8CSUm`HN<)mPzj
z)cImGWw|CoJ%<Myi^<Mw!dm0a%Z3g}(wQXhUc&{nP2}-wqF-PuAR&d`B?kQa?H}N2
z4!b8yHH6pd*X@j(WN~vsFjavOjd}{cm!WTK7J9SNnMW$S=u&w?gTP2Gxh`7zzeuRl
zZy|o5mj_6sF>#+=7k1C9L9*JnqK~6bRko&j{X=(qFQ9|v22Qrd89uIFRf=<H#b_Zy
zK#9(;7dk(<p192rVRU|Xw1O`xp@U_e-z5#k8l3L@=An`sqVqYTA{B_N;Bt@&_JIiG
zRUs1l0#n^;_^-Mpgd>B&4MfouknbH?=0IKOFL@Og+JbA?#y3twQ04Ntm606K2OkZT
z&At-}j!s}&F<%Sl?A)xFuN!8*s)N$ZS6}Aqk&n*TwHzAGMRiLD%kq_{!KL|1W4+W>
z055bvWcq73BD&H88w(iT<0Ef<hYN{2UeqNK!XLwXwte0fMG^8nZfJTNqT%3mOJpfb
z7gaJhJzS`espsUx??una`Get7Lh8jBT>5hU!W=*L-(!p)^VMIKkZX)30LZbRJlV<3
zsEqMr-s=z)<eV=JG01hTFz7pw-p8bmlQn)2{=S#q=eQ9&e$)cl_6HH+n0Eo~4z^l)
z;LRYmI?3A0cSTS62<;B;($9s@1&}!r^6MNnI)!Q=EVXzO8ql0N;9oKr>DRqS%@(L`
zQ>kcMa#eOH1&J%KugD7B3jV68fpGY0MEuIzs?JomgR~EI6IrnGqVfU_`m1_5!C;Fl
ze+(&@+g`{~F|Q9#_ymd4ViK?|tazHvetH$Q@x|c+2$wC-NAp()rf4~;7|C&ffHP_y
zY8${@^TME>)Ky+H$ydtBH$=mZUl?Mm2`1Tx2H8;)+}8weG{A{w<o5FL4biIQy$_*+
z*drOOVc6fpDMH1sYO2-wr4zS{l<9G*tn(wL4i<w51UO}~2vN1N|3&6K8`<W#Sk0Vl
zh#idV<AFTuG9HTIBcFcwMLzabF>>A0q`PZ4HgB2W2orn_U~`;ZpxQ)2+vemb{Mq{|
z7-7u+pzqD-0<*F%+iGy}tZXp<SyuiDTZR^*3#HV02n<CmhWyzdz^+`=D<S*VW$Yno
zCGBA?@ago;i^;KJ(U?)3JKyf|tA-CXi2b3<&ja7)a%2#y9sH%_<e13;893+a!2O@N
z*vjvlFG+GijX;c&({>A<XZq4Zp7=?0On%MF@cnwC`RZJ1x&^zTOLGR<Y1xn1l$Odj
zN`X#H5>5;n3rd5LN1E6$xme*v;E4*|Wg~uv_HB=-obrk^x&5aQ56(1sm}s3ohbWc@
zUtq$zVtKzHZz(+Qb7~h{q58$5RfDylIEeck(Xm1<Ry@*EvOqb$SoBNYP|47F%p_eS
zs;U+5X=BGxESK$h6B%eA6V-*C8acl+isIf*ZA#=830bb6^^gyWMc~B8F;A7?d{i>O
z%m6Oa|HCY-!HwH?_JSc=Q&?C=Gu)oi1Xhs2QONsVhBPlt#H&HzE11{t;y3@%3|5)g
zr{yz0;|}(p<d&cDdQ_bqM*CH$K5=sz&e9Tq1lKU`o*8bzP%;8OuNs(QNY0sx@7~if
z=$bl>DE9#Yd2^8Gbb_|j0}a>9i*_JF;4LKT<;CupBS^?Bq`iUDIFCodEf<uCP_IsB
zJml*o*iy28I`dYj8lcxoa6RP(RRkFqy16VD&@6)83U8#7$aEe<I&h7VhV6Tpw)z$9
z(J*n=@jZif6ls%5+Xl47xoDhp1hh+EK}*nFdWRg{Sh*}OyC1q8^i5DE;V6^rBJEk9
zLL-*oG&cm)gLuwI#q&)*x{%cK;G|d6Gp4FDsoFU}9P)08#-(W~zZiqx$uefA(J~gd
z0jq;`Xk#u*U3Vws&`jR<zvNp${wXK4iXWieMV@D4(+b8+a8+?b(}Q0`lQByl;Vx0v
zP>jk7_11~Ce<O@FmkbP%3e`D3>Xv)wty#|*EK+o%o~OP+L=B&5z+*JLP#rVi84;M9
z`&urzDZ*kqf(yI?m#zLj2n)7MlyR4>g>0Z(%gy!3{6TsyvrjNh%)p~_uO_eD#9f@v
z6nV%+xA1(K^;cng;v?+fub}id3iN7k**GQ!tzCj^L8!HOiP46(N9|;)sVsY@nu(Sd
zsj7ZDRcn?n+%tqPGVB@xJ4=a&hM*^0oW1&2964)WO}AiwB)fWgmUv;GPAM5_qG*4v
zAu8bj*uqvIc^+)x<wA`8R_79go;>cL4PObFr$K7D@ej+a!Xo*()Bo>?Y&?3U;;kMY
zBWZz3jqS>+01n_6lK^L(6PK_2msj@x&&waYv{ujw48`z>r}Zp<7HGXT2=4|iiLR%c
zRZwdy@WJqqU2vId56L69M1Vs=<L=d*u}{uksEU6?zNz2c4>-+Letz>0Z9IC!5o6~3
z*n@u+-M)OC2JJV*)x#6%pvBBnJ<zMUo~=^sB4bPqvSPw8Mm;3|`*sH!FP?z>08Rud
zcU2EmShVOK>I!U^f;@rvQ702!vzwW!>UTQ<GyTw3Po&S5xoo~O8WOOTM#izin^3xl
z{8<_-wr^TOOn=XGe@r;^=hh;1hWuUCCih5={VOBdWckP6$dVq58g0N2r}RLfBDV~1
z)77v9uDE3+6x-XSH|x7`4u#h(Uso-XvAWMCpVGR#`4on~cSJzvrifhLB`3#zn}J)&
zEKiuJRw%F$NVsCEH|6R(!oOELQ2r~+jX+nH<?`YGPCaQ*sA{p)N^khJ=psz9tC!`?
zJ7RdvJs2Fjh7N_+XFo#gdH=o~`kQFhdH-L!W@S{yBJBxQIw)&8dSa*_cO=5%8e-Z#
zBN{GqTWlV3r3T~vrZd=-fld7Te-lmpE9<oLL2g}U-1cHwjQs!p8_qCZl&yakVKttE
zxgoQqbEpmEgx^JIz)UCymhdcE1XRH@sJXh@4wGAc7eNun`s$il3dR5fbCeOPu@R|+
z%|eApzVheav9l{z*8BrEWSp1H{tzLJ5BD^3frC>iXWX{$AO+&Y>oyd7f-&HeQ~$sT
zu4kkZKQ(s{uWy<fa^G#+lII~0{~<!X-HkDNxbcSww|?qFf!WX5@(2w4Q#A2>r;1GY
zQ`GLuS3OuVnCURfl~dETCSYLY3)3jZke1x@RDW_Y27UdI{c3DhU4E@$+&PLBVb`DX
z)jx%Qz3G_DhEnHY0+qL44Z)k2C)~EtCp=`~pQ3Bx>0@xAbXuiq9fR(W6Hq=J4jo1+
zIwBA1x@~tMU2^t}cz`g$qqp>Ze;jM+cf~yMygYeVG>G_xi`Fi`ul|A{JU^<2{XxUH
ztndA@(hyyK2Z+RVYP|Nj_C1kW{}=#(4<&p6;TL~5s__)L@SX^A^!($Yc1y9k`?;YX
zZO(Msw6~&L4|QlPg~j{Tl}qP=8ds(RSfD%w$2JAp8CB{GLQ$7FQg9pE3_(%6iWWw-
z)3TzYTUU-)`ToOBZdK2~@K%4^L$9SvLECF?dYeoDHod_Oz;r98Icso=GgS__kGH9(
zQ7(1>P+Nc+WrXHop1V->Hv-lbHy=^<uPE$v_)g`*3J6==#!alnb`-t-B8X;=Jg^6+
z>hHQWb>`!c82vUw6RXD{QjuoqcfIpx7#J)>EEtq}z!_xRTt=9`0b_TC);CpM0}k#o
zmx&P`t~PqhsJ|fpVsx5@KpaW*gLp_E&zMq!&;DOsR{|g7@%}dxOB}I5RuY0B2nj-j
zL>vhs8xlesaUXTnT@s>>4T8jWNn16v+9q;{n`())C9NW^MC(ecEj_fewk4>ej^zJ+
z=6!dw{QCF#wApu#=XvItXP$ZHnP+A&^Mi~@_rblizBEPZ*3e~ov7ys_q=r61Ye!gf
z_*1xzx_0|L+!th??io}R9a_y-mN}%9dHx7xKBO`$P$rsQWiabc>}~?kBkoJ>qD#F2
z)uQI?g8_+KXrKJ+)U<KQICLp7S(m<-x(;SyHt>SOSPMUO@(;>+NCI_1^Z;bJAuu+v
z(KNgbBZJ5WO7|fA5*NgePjGau75%EuH$KIqu+PhR-cwk<-T2w3PMz9mRXA6`6D(-{
zp_Y(IV8JO(LOW->f;Rm=Z}rTnLzlfIH-Hvd{vUXU<x^pa_ts+@-p1uT<EfK-s1`MX
z&P+>>iL9U*RVj7=#i&){t_0V=Vr*iqXj7EWwACSFlcrHl$z6W=84lF#xyv8nZ_V54
zNLt04J;#fv<{fsFO$lXNsxyqoK6mo+><*w3WB-a+z*JHG{)n%5?$pRTW{i~LWUPSU
z2~a;!=z_R&hkyFqsipgSZDk2v>Q3+i&xrVnBX_v<xl`kI@81Erq01sQx>SQLZ!M)^
zYeq9xS-umbUtjRR7fvmlp7Qt?PMs!Bf$S@uw9)FX1QAESZ0_W~_@Gx))@=V*DQS>l
zdYkYi+91!e9={-|h!~=g6%Om9N|3KU<G;UfYU4Wm(hKY(m5?&Qfe_CMrzQilalS^K
zA79Zi?MJB#LkoOBAWoZ%qDNDdkwjHqDgT0}R5*D!M|`Q_?^ifA@Ag#!>O(7OEc@l~
z#HI<xlYO$Siw|<Z<HDp8fs4;%Xa8GS!S7c%O)|C*r-WG8;)q4W9W9s%oD5+RE{T22
z197jtcFteuTu0Mp7y^3!cQ*NTB*2(s%gqa!Xx9f^@{zLJr0zXbR}HK0@Vk)K&osfU
zw35`t4lXBrp~;?d(B7jG!_^WKl@cg`%cr!9z!N+_;isJ6Rb6;=Kqd)?{t8E`bpqaN
z&O9f54u%pjVnak_<)bKr6FqQ0?g{yAeE{T=b->Y8aztyFTVFC9r@^tNwoNKMOp}jC
z5P!x!Ii^DmE8YtL*lzE=&wT5)ldBE&X5S|7oo7+TN!=<dkD*)&9Qj#yWy@u3$F28l
zYuk+$xwd_dgu=Ha(WS!qHdeRe*8-2~n>(x&r(rZfDSw{IZ&J%&l4;6C;s&#;=iBP$
zdt)|GjhWr)#OfGZ!e^_v>XdLs*^6)*Ho#%1|BYGNI-J^BB3?Yl{_O;3%R?XocaL!(
zmVO<~+>t<Rp#zVIY9~|U%m*~^5d{c?2&-M{jSW<O2NiKe1wAUD?>c|3;Sr2^_3saM
zQ-uwv&~Lo}h#&t}QkIcTg-1KqKS_&>6F<k2AyOV4_Kj|>j(}0P^O}9&EEYze@l3`V
z`3|5mcy&NoG{cVntOtRJ#cmJW)@Ksih|EX)XU6=E&&UX_kIH1MV-_Me$L9q~PlF!?
z@bQxg_;SEfFSuFF6LgmKkmFeYe<-5I+|!Jrv0;DcR(}j=*b9=bE0G<l%u(x+D0d%m
zmjF-_aprhuLnvr_7$$o+8Q}vU5Y*KaKSS$-X<=%Ok*Fc5uu<5kK*PUsW*$yC{Cj8C
zq{|OIF{<DI1oI^bT`K&@8Zl3T(XD~x0y(x!OT_Pzm&HOn;_a$2Z?E;JDW|cOC<Ci$
zxmqrdPpHP4IFCJ|;l^srBjJys@GMI)4?2qJ7KpSRk4Uc3m_YN}{`p^=+K+0G7{lu2
z2^!kgi%k&avMUg^WPs9a#_v>Pr(!mJ28b9vc#c<j1Ur&i8e$&Q7+Pkq)H2jHh(bol
zAt9t}@_txR@nv&z`R3}(JEAO}`dh98UCe!JTBPA+)_1x<5_Rr$WI2>6VpaYm5rjk(
zCDy|0BzW5f#yTY69PQ0kXC5`n&&%>6kT0*!+O~L#)}%!~AZr!D-4pPv+4V$t74>;)
zu|NLc#no9Wgi+n8&e}V-|5U@9)?kr?>U9D&<|bF^q#=f}AF8~+QI7hfU}cJk_)QM{
zeMl=TlFU6PK9gy5XScjU<aXm{2!6*YRq>o3tik-;E8$j=UP2oy?i_+l=$YR5COjLY
z&VPP{5qTLRT8P!3#)>CBW5GiGai|M%Hd2mCFS&@t&|C#QLG7*!td?9-&nPVYx#Cci
zl#s;WqcDXO7qfODklXN1KlIYvg@-E1_4o*m4NHOw=yUwlm@bLe6;Qf0v|>Q-efSA>
zxm{Qj<8X`8t?Ckldiv>a&_viTQ2P0=PZTdGfldWzb6*$B0|`X7=`+NYiJSeTp@?x4
zs!UHu078XGvXT!NBs(-?5?mkA9guW~WAF0;HCek>Q;?4{#eq0d>__&kQszEXiM%2a
za&bw_=38sBwt)=+nLs%}cP0w$khh|ibO;h3#k>4|O_nm~>Va3JJep919Bo1kL6jLr
z5G7FS2ja|%qn!I6d{xfB<VCeuo93?Q>}jVX|4|laiY!y4YWh3Wp~WJX53J3++L2)U
zlWTernw%E-4@oXWcqv4<Ql4GxFUyyT$yC0RlP_Ohn>DWIB1=EA@1TeCowZqn^Z5N5
z{&#IQVo;|5DcFx_4W<fq;d%$bp7gU6>=L9E?vlcAPF#^`k>L<*a=X@A_k!HOh*a_B
zZ`WaMj6VBqQ<JibBm)tlU_5coMcqYmh#lQLfChT0cnUk)vKC&-LJ~IXBJ_6@=7g7&
ziUYgJi*MGxfEW{(0ln~s%6ubgeuSE&Z_%9&r~-hB<gPQYfWs>@h{Gi!9Yzvl&P(19
zfuR)f7NwsP7k&ao<O8+EjEjY^eMr{?14S56*annJLI_BR3`!_c)>ig_;lt4wN&5&6
zjUvJrKyb`Wyuc7Fg?7<cBriri$zbdml!!;Ym070(HB^QE8?RfJwXWueN<5@43#fJ;
zbn+Q>SzG6*y&Ar$E^Fz15-Qo+Q+GJ>5k|#B-QnT?kbHt#7nB&HV=ddRMTw&g0M$ZQ
zcE}*A5^<}S#FqL_Rnm97nT~aIUcX1F=k9`fmJO&Ep*#L{jJZkK&o(lanQUY{-mQ?~
zl*C=!SetIIV+_avf}XndOVxOwDcZc7ERdd?Vc)&dOCEfh8}l1D00oGzRYUSexK%7a
zfJBuc;h-8~04N;*g%+V;qWx*w?|#74VAflKmw)fZ+B$v2o$ImIPK$ZFdaQ$c2-2m5
zC<L0c^LA<Y?0U?*!#~ih5nsYC(O9*|vlLMo3k1|HF*MnxL-Zj8GiY>L`Qdu3O{d1l
zSE14IMX3W!+FLux`C*fT0y5&!qGE{FJYKgxYf5ga`mA~P!+<IS&{b_j{8@y$w&qvC
z5YBeuh@2NZtv(yl{B)UY>P;E}<QXgyFS4beBFxOB9g?r%PwO-9mbKIoLaOv|z5@Pb
zuTei9+5k4g{T&)UssZcmd;mW_Xuujr&qQzAG+Wp2t9p_^RR^e-XYegp)?1*~!2ehu
z>Ge7h^j%DP5+)U1*?={4U6@Xk7Gr)FZ+*{OxU&|zv1r(|Sr>a)W$?ft9`DZl>bF9o
z?#S@xy2HiO{J*v8@FIoToi*>!V#SNfX<_azIM;^<#SJ~_FztdrDG*R=%u{qmWt@-n
zsv{bT|LD%5Mhs~w$6UjofLhgbKdf}nbStk&O?L-rh22zl<U^TednRR*?-t;J#v2Os
zipJ~0m*`m+_kq^{$Z;9fC{LZr^RPytsk{~$*K|;_&;Z!hF|>A_+Z`0)xxz(`6Z5^R
z3a5#)Cv%lfQZ*TMfR7jki1JVignJKEFG2bgD-)@~h5|S=*zDDmeoj1@c^PQw1`%kR
zZDq1BO@eDs9@WQ7slEUYOe(mBePszI3E`dk6X;}uJVr^vsU@hT3nB)AM&MpjEwiDf
z+>D^O4VlxKA8*LKjd~QY*1&lG=lTmprlr^@+FFCQkxWw(weMn%T}vx%dkvacPP&#v
zj6YF~BM4{~_Az^YycFAo$9zF0fih{|Lsfv%y~G;daEggD8>>ZEmLy%bbfUF|Nqaq8
z!{>W2pAH#6DCq5@%&Z-L#nDD-1E40=vN+C<c|gbh@g~&A9S;`PCJ4mO`npFy|DtJ;
zYtBT!Rs=pjScQlL-QZ%Pp0un9sNy`CZ$}rXZ*cJn<bv2XCs@(1xJ^J~9yrA!ttaf$
ztJ#BiwkPZD_a=x@F@!GjjZsj9zJlW0?HXRoi}}_c1np;?4kTVGl!H9ni|MN^T>^?n
zd9n75hHig_y|+kvft*`B(~E@+KL9C-hJWt-C3tZVH$(a}$%70FJc_G-N0p&{$fZ0y
zwIfqX#WtBjMt71ol}1pdeu`Q;g|~0SnmaY+gB!7dt>6C^bx{oNF>U88v^{nim`@@A
zg(15fYjD^>jaYE~-4`+b95#aP{>p1KW*v<)kq)m<--@xc&Oawc(|7u81P%W}n*<b<
zd;=UXk6d9eyPEM!{0={+Je4D31jWNzQf3oz#9hYjwfYX(VJ8S$si-5N_vkwouTf)|
zM#6eN;A9;RdfR1Uet%QLKWog~-4D?U5BVO*rx*XU6(4K(PmNg<r&at}V;0xkl{&%f
z`VoYr@Gy;~@)9CKKS_?z5)r{?d$VSB^^&wY$`PC{e5*HWGVnG^QdBY|Pd%YdvBX^@
zlW{Z)#um8^sp&;1Nv=Z}UI@-qLdMBHf{HbyM?Mk%aHl5Bx7C;yL@dl|a{7?Y5s^O<
z5Z#)#_>lJOrt5q_6V}+T^m_@NHpV<ZmMz%%AzDD2lH%M2@_k{=c}@gya}(Cc*pn0%
zW<EV_%(ww_plIlesjD#>Y)y<d4e}IMQHkDCtwua}cmp4{HC%E{%SQk!OC3O|SW|yb
zwarwR+WarXMdoK9A0+KvLnOINV8}OGC}>Bb&4e;P+K8&*U1C}ilJa#_E$cpfbyD)e
zI^I%`Txb|FMpQv}22*#C<@Gy2QCN0I3B3<Z6*z?q7!l?{?y9^-POsWYx&Sq2Ir&1-
z?Z2O=W>!6?ewn_jUM|0f9#pwdSAzc?{bNBm7QJCEJHD9CMpi%)iPxLY^E%C#=d8?B
z8l6&NJ3)(E5zl{4Ob2MJa})bkBsIX_u1T(xI)qXwjvnJjtx^H;u_8J|3I~#L>5!3n
zPxgi`buuRB=yY$K)IuNj;TxN=@huLWBLWbkr*2VX)3?L9{Nq1yoeyi-qXbNgHgzTb
zy@nzfo8(mXM5w;<qWS`<3Zxb53@V~cc!eChUYEqf?<)A)L!BD%!5y8ne60@#_oZb@
zN8CjV=rtP%S2Ke-L2jIuo+Ww+jy>G_$5WJ4B0fbH1jVO{Rw|2^;&DIWF!42{U1fMj
zincUqzj$A2!dDc}fUd8BBgbo^@9{6ig2f%gb3|Z7K^%UObvK9btv-!))~q<gw|B|?
z5B&)}l1NuF#6vZU^)x2!-u53M!B!W1iv=|Pp=)b#-kf!;B{d;FzdOS(Hire&`2)gm
z4!#TV_(%SrIUCw%_eJnRy%)$>h*9{X94_a@onnAe@5QeBEi!&mGp-;5aT)2$Z{WXc
zqJ*z&!RFNMLg%sWsznBJ){=D?QE(mnB`<M=>6GPtj5lb38{+IWqLB^;+@MjAx=d!c
zE`^y>xCAVKt`?iClhn9Qr!;l@hoWlIBmWdj`P!Du$JiA{Qk9Rq+Eqo>%mo386&-1w
zT0=y5(e66wpm3rrbg)kny$&>&#xCBzDh0`O^h}I8O-(|+r(^z~)Fcne54Gh7N|*AY
z(ifow;4~HRqyk<jpl<h!hbbrS;afJ2EF3i>nlj2x^YOl{k^6jFCr}6CD0t*G{C5|Z
z55MKh7SwBqVFx}<$0i_cW9`1ob*-33%dep`V@y;3v~PJHL;`Kz?ZjV_&aCfwbSviF
z{!elm;d>+b%fR2Xtt3`((KW)J_K3}x4&!N0+h`tG4Nqgd(~5N*(gq+9dYnGaXn~SI
zZ9E5SPa;^26j({{Kn<?}y&qiw<BtBNP;NDxL;xnbu`{+trM@lK@cOM;=hkCS%5fT{
z%%P<shQ8Cs;y?s;IdF4^S^E)`8K2pjb#eWA7fhmyCS2T9BDVA0ty!;jjghJD63~rp
zCfA=gN$ab4burR$r5Raa#iom5CU4M&nVk$gs}1vL90>8EolR^_oEI%g)@-{lxKg4G
z>o<6u8^|^H{O&9XzT#E;W3GcqZvI+M15c4w_#rx%CTyn@lqO@oFbBG}e)d#3n-=Y>
zddHXg!8<+#+p+)U9iMsvjr*Syy{9`6t4oAGWS6|-yMYVB`PY2l-KpYT2wE)fP=+Z9
zi1m*XNj;Z{N=$&TQOP_01(iQQ<&7Y;FDg)h!EGul<qI`rM1`H!t$m0Apt!tA;lSnH
z++FE47xSR{78>+WFjVtsYw2c=v-`k($-Fhi#!2ONCNV(hFlWFxKxE$a<fedhO~zoy
z#_=_6F<nnZ{Z~EXt=>_V6j(I(|5{nIzU&##Z?Aa9Y5W@eAIF&fG=x>?R!_hu>eNRa
zILk$SAfmyn?9E*!Y9F_Hh1%AWNg6?J3>~pLlNcgmF>`?2j(8t7xgAabQMIplzjmyx
zJ4bDjA`C#qg+Kaj#X&y$cX+5iuM1AemIKaf;#=rez!{C%D^7TNNbW6(!N4*|2RFc)
z<L`?gfHWK>k2n6MnB$+5sM^=&mJG!&Zd?fX(UsrC!12H8Cd>n?-97#pmX&BM%^GO>
zrK100S1@WT?(sOqJ&qWD^b)nKg<^)u4FRo4##AUcf>vcr7kC%>JwozL+cs;NC(ra}
z4Sid~=&{zvRqlS8q$YCW!&x{or|5E!QuMjFd4d1n&l)%QlMD=8l`i_Elh@F77I@_n
zz<hiCK2we!Am4CI4xML6K$ImcOV{MnP<oX}CZ+N&*}$gRzR47-J|E)zru8Yte*p6{
zcE=QEOYMVHdHNc2-jhmtMGX%5>q{s+bEHIt7L*8$f@=;^faea*a1{;%%f)<&Olt-k
zX-_s;iT<*zMP85{#f{rf@unZn#u-ct{h-izz4olB+lLTr8xgrE!F#u79>&7gsd*<9
zm;0nIWeZD?2CRdDm8_^sNImKW4A5zZj>#S)iK5kJKX|WRu>h{f{bywn@g@4#JaRc;
zIRlnh4?rn+uM2R(@Ev0w>`M<#htqFeWD(#EH*5GG?OFR4Cvn&`2C@b6i*OnfH+jgV
zjTl1Ep$R^_$b&nuSYt1!QQNym@8h?8KaO0w2fsjXs1y7oxN+tAb;{U68Ky6MC(>ZV
zVu!R$GSyTjvr@5G)>N(xTud1|&~&Of9vSjR_8n56#FI<f_3CUW`RX0n@;-lmBb)I<
zK3z9vI4(cF%crwH*OZ*I`LOTxCCbOw`LMLKC-GrWj>|7HY52*G?2E{eCJ+Yx`V`Cu
zVsN+EG}H}>=r^byOJmX*roMp@g)@+eWA|-mK^oVG8=}pI5MQT9WdM2%3Ynh@WX+xL
zt=I6|fvknoeD2zbwHxqyA+;U%-mLzL^z8r?gdK>NceL}c6$k6A(hZXauHQo$(Zg04
zJ47f*b=1Or0Cr_3=3h4ewd^6WCwO5eOjLWhp))ow!j8)65lc*3B%Txgw(pLKboq1m
z8zf@G??T=D2?-Swq0wO{{E7PpvHq?~H&D7Xr(hct(QB*4A`T`RrmGvO>$g<wuY*El
z4A8roP-!;|YiePcCNG-JIK}UDX067a!SsxwMj^tHccBR^%fU(UTTMmhQXnc>5wvLg
zZHAQoWsu#%kEu|_5y>@A5nX^Ewl!jC<lTjOFv=5;M$ZdkjT-1s0g@g_^|GnnCr9|U
zAm&;Bxssu!j2y~X$4>>Z+1;zJBN@j)ia0ulMwfD~Dg&vIcicoZ#2|$qy|2iABe{f%
z)rsYNb{E#sZOJ#XNm7@=@~q2ucVW@4ze5+;qR5tUr(oudowugJ%+q)b(<*5ju$j1(
z>WbwO@pI_mm%FNu?OW-pkuVh;yJRtep{~Lk&Pgw4jYXD2&lHm>ei<y5o#S6B8wpCA
z!rriC%db+=<P6NSA`7h+*WlR2F8mek`AyK>ICCD9Mi8h${lsBXaB*ukB{t<AUD@E^
zeXs{)e=B!A^#xqa0;$-Tue559QJ}Bgpd3jCzZuB8@(;SQX~u;JOrag%6x>m8=nFIh
z#u8mB@puBpgbCXXBI}S;hIJ>R+j>K=D0W5vDQ2Acak547P*AZ_oFx1WrTouGDI{kE
zmA@s^<fRffAsf5K(q&z=U+EOUS9Zg`PGG9ds47w2c!)*@Ny!MQHPPd0rmJ)tf*Mhl
z*Nl4XoTvo@Tsd5^2g?g|#F<GzIz&Yp2c(vFY29JgmrX^}P~#@-2Gykckjf?~WsSlY
zg{eTGCqN@;U=i)Ze6ZTK52H{8f&>=VL{7;|1T_RfmW5<hoAv97i-5EUsOX%4x&5c8
zL;X=s9bwkLt`-=M$(*jb2U~bv2#f1dUCp?Unnztw7>G#Z$!C9Rl`_N7-ER(@i0AD>
z*@S?l(t5)LT9h;sh08#<a@(TfA!%baxSNyfBB%8#4G-+jJf<9ILL#bllKLmM47vx)
z_y#`I0(p%E=0YSeB+xw-QY=CG+Sin}Z3nlM;{tTHE&=H1YDZuXuw&Z2Qo&>h1|~}j
zQY>bDuv&izaT~?Sv02kjEMnFPyBg}A1fIr(PL0F6nF#QNdw*khjNxd$r#tg9HUm&e
zGb+et)5AqiX-Md)nrUj8v<1)#QB6&t<w62z_y&57Rt-6yNE#Buk#;~$%b+x@>&4Oo
z^h3WzNhe=`Gx|f!M?PR0x|rkSvGJrmu&eeEhX`U6D#1D<bE*f`_dkIEwutmP{n5%x
zMjS~FW8S*A4ugeir-q~`JaYP)e;&pfd)@w+8c?5v8zHT@aum|P9*5QH^SfcJyYqg)
z2<XAuIj_QxQ9W35Uxv6Z`!Z+}w17QaYnY-EZVDWd>A^Y=&Ox*pjqP>-+hw#I+lsAo
zeXkte2Bewe+hcGx#JLF(yN^=kyUq5ki8+6$>!A#tTo1YPpq{LO@soYjAcy;4Rw5`=
zHHK6Hrl?^ZPV$k(vhXX6%2J2}I;<P?05GN<!AJ}x{uY85%Mp?l(_89}h`u`%kBG!_
z4&#>QC8ku0r%K@(jX$2&L@ir|s>}A;5Fa69?#g9*bwDOB@5#KJp7C0}SZAkV-m@3;
zYP^1&q~Q>{McNYL7Wxz&#=zq@P_EIW=L&R~nlL%w$Uc(@&zSb`3dB<PVvRimV0hEi
zjH!h7J}Rv<kZWD0;pM$plfm<#Pn6IYJnj3IF9E64*9C`;2H_|1jqJzVWp<XSXRv8I
zCWz`nLD{(>+VZizS;W9=hzrH$?q8pQbo42m%A7dTp-*e<mVKItG;@3eEf|)|6sdsA
z!SPkY)X1-sT=a(eJ+suNer?<8@OffklC>M^S2>*Nuu<5XmPG)X4I|t#kG9ogL8QER
zC5^a=Ue0ip{pD3S969JT!zg7*dwCbC^ieiG%OKrUc8aSJ@Sqp*9b<ZsS`=~IM>e`N
zRu}nL^am*99zt$vk-_u;RiY`q1JWaoL%nMt7|yY^AEQufl0|@|GXs<wEmPA}M9*O#
zA+=ic>Jl<X2_F@{Rj0F(Zcx%`)KPi~ibu%hbrpj8`<1*;c<%_-);Mt&eZr4jD&DS3
zdPnYa)HAHEaMG>mF6X4+kO-7ny&P*elHUFV-0XT6Q$pby&@QreQeQ>JNh^-J>YEqJ
zNQJp50fzvvO<`!>1UIX8efggetS<ZWFn=7uMmw)tqT$2(us)Oiz@lHg@l-Bku{{zC
z<#biNPWFRb;KSooE-LUza}u1*mDcJJUq~Z?*1Rt&P;T{9`3A$1P?ZL6>H}42{hqAh
zF_Fx>#p^&5X}V>oJY^Yx#ceb^FbLq)?n|Z~@5%Eq-h%srNqOKS?X0ComLq*E(rK)u
z())7?U&!G(?i0zE>iAQ5f%sCegXpCyDsRX{yQXR}M5|mOrVk{GSEZ`~;jQ8gEzT`Q
zs1j&jH0voW7E2R+;uTUKbp9^P{-S5TWVJ5!2@0zj?@@-YEdv(@VDxF@z}lAmSnF1$
zKte+f(euL-h=N_U73YEs2%?F4&SDLp+YixqkNMhutWB#~uh!`QYK@v|jo03V#!{{?
z1Igv097_eI_wcYE$hY^N5V`oI-os)Y(uC&iAtgn<7Gs)26Y-KBDu+(f4wcHGjf<3?
z^KzGn$ng=4H<&S=OjmG_B0;3`m66QLxfjZPh#uCRfNG2QLeW4te!+_)*_7tPw#uHm
zfRUhFBB#s6BuFtt@VjVRqcO4lS!libu(-_eZ$j4Rqog>J!+C$!!ubebf6<?H4Op>=
zSYBG0p&@lo_tewB6a>n`c6vJprg%TviKDO8ylE6mcIwJ`6br)s-?=CjV;r(clJV<a
zkU_yM!Z({bQ@O6$oAiL$^(1B1r_372guOspcLsorG)Fi^nC^)D`&6fBNe$`Cp@+_5
zd<~-EEt#6!Q@*T*Mh#yGZ_Qap!!%g`X0|j0YoB#E>F^!jZ9p(@g*SLEEw98b*hvXY
zs?{&#Q(uHKXp*oiqMrb&s9Eo#k+fOpEN}BaCyswc-xUislUHnw7Hp3-RggC$_`-Io
z0n)-lzL0PdYX}6zRpMb#x=ve|B|_3Yy3`9!fw=uUG(?yB1u@pFzqf}f7mHRB9j+Up
zwU@!P$u|uIks7bVv!Yp_T03RAbK<LP{&zGB>Ya>lG}<OSJKs>IC`{=uwK*87!90&y
z$_ScS-&KV&h))>6diZOz)HPKLWjpC%CcbSKc?*2dh8_u+sKHMSV6pyFhtVWZTKlZ%
zNMjo#>;&1G_ywmWepz%R^7z<ui1!-EdJK8`m+UP0YTEjN4wGP~kL4uz5z-(E6QHRJ
z>Gn5~CDUaPG|WNQuF>jLXweYh<q7<a9n78I7|7}weKG;hG4|rxJTwwUJ()MO3b5a@
zJsE?Vl=mqZi01LmmRrCCt+p;!A}`(v<Z=yN3&`bNWl|V}jhLaarc8)5PjW(|;G9p0
zG<}0V0#_%MGqH)k5rd%3+w-ZX5WEWu8L=)m?N3vEt7edrL?$w1H{gU-^O(@2n@No!
zynAICnAQNGj<(Qo2}uYjF73DenONZr%EL}B@US{Zu76GppN$md_Jgof3#(%dZoFV^
zN!QfD>?sw4k!uJ$wOD@iQ7SL$0)~_jW8ilA`J<OyV|*^w;dVZ?hdPQd{cI^fm&^F&
zQn8&8>u9Q@tzVr1(}dW7G-c|6gI5?+=o9Y~fQ=|d)0aGg0pkw$ca>CHaoj*(N68f7
zSkRKV3-pK*ThKjARuio$2P<eQ-C9knua+)EY3w~w7w(r8W6QBgL3+_t)Q>w4V(!)F
zRN}_Y6a3~vCr|#NKdZre3}Wq!Y=i9Kc+6_zhizCD%X^ohQgA3zZ#Fo{V;AH?B(jhO
zv1@?}@)lr`gLHJ$SKt#GR~Z+sMoY9p;eQ4|iN?)B`TIM7U<nnKcbb5GDHgma+X!{^
zQL}02MTV11LDiE%*>ARnR}O;fs{lV*4rVQ)y18H(ww(s4Nqcvel&5fr4Wcad6N{hX
z^`$K`uMBf8&aEK)0_ZuA0(Ut66s|(H`1%9>)?n7yxf7u78qAv3`m_ddS^LH;4gYR1
zRwn)MqjE57+4L|_M402ILojgq9Jgp(QEXk%=Yw-n;c={y^9mFm7snd2YBl(qajcp1
zj+q+1Ee^B9D*X5=j<v4igmnlut<Wux_womEtY>V$KZ%XO>A4^cY{q7l{z9Y!n-jN6
zHvfXO!f!z{b*YePcI$U<Uv<bMa(f7C-6VLXYW>o=ej3{9frnNB@56>E8p7O-`C4ix
zbS0J=5j4QbE(C|pM*+=GDw=qpv2dwf<tc}2q<T>42CNpCkX|UijmrP7mTyVrC!l=9
zG5il5gM-ai#Yx5fOX^PR7L#`U>&UOG5{9=GO_+Z9q@m1xW)09JY0;s!96=?qnA4J#
z`ifD53Nffa4U+~zi5P|Kmu#wUNP)`rOL7vK7($na`Mf9iIypz7zdpY)l(jdyAl+_*
z;8K5lqE!dT{=mGuq=v}8gNjjN8~y;GwWo@)=sEo6_0d2FcSZ`_w!~@WVuG0TDK^(m
z?P}_ljI>N>1d0^YM_1R@t-;QaWawSKIi7Xuyd*+Cd@|P8{_x4j>9SWQ`adVRt=WMz
z(HWt=1OVyU+tW4t-*^_%Rfnk?t9ZQefk-<)ywHVZn>otO_GCr|fS~nG9q>n5PG;9R
zkS0ET7;90RFaUH4C2ShTd^`e_(y<;@rJGacIV$~Nnk+pQ^EZD&rHf^Pex+|!>0rw2
zI2@%nDy6sdL&DhM%%|@ZrSx9JfZHf}1DW!1k`oH;SzU>CI%n{#jl|`L0=Aa;PSfz?
z!`W=SC>bz<weemK!bpb?;i~(FE}(OPkPVxv;qyi?U+4Dtv3Ud==6rPuqPRz};WhGL
zhlj5}`EEsrrhNKH_KEk$n9|YjSt(!mk`~t_PQe8p6Ake4?abuC3GCys=ih;dnGmUm
zySNaX31wVYs#&=>qM)j!m?F&a5HZ)c@k<y`p6YLs^{`!jWm>v7IZd)Bqe-eaKB+Yo
zd4mUzVy)P_xqRd(w%O?tzcUJM{R6z-Xx7*%k+&bsn&D6EXx6mfa7;DPVW*P%B6_4f
z-S0A(iRRGZWSKp_Zmms>sHc1*_@aFh0%!&?QAx|6$7S?XQ;E3G_m5@`^*bn9g_ieL
zIDym^(HQ>2Xx5c5j{&Z?;oN-{*EoXYfGbw{cEA<ph^vFd)$lipHX%E%O%*Pl!9O0u
zf(HN56WwQaJ%Ynig;5yu;`NPCAXw*BhK!5Tt-*c?h8Wo;@G7ElbhJDA7+LxFmqO&t
zuF5VEnY{T})*x^;sS5`(=~4rHJCHemQfw^g$)}9P4$9B)Ruh>UTEKWyS@I63p|p+N
zK#`@U%)rZ2G<sixca>6X@XqkEu`EbGNrjiL950azUp@C3hoI^=dDJ+tcnoG5YQsc_
z?rfvLws)t;|KQR(;(Ee&jsva?a)E=+w9DX&N;@7oAY41S=Xl^+kH8ed74Lv+1T8(G
zCLiBWM5n*<?ZBrllwxaF8~)~a*1Fz#c&LHPh?RwGQz}0=o(*jEe2eT!GyW95K|R^~
zErPC{G9HfG>ln<nNy|5%z*;$X9<Sli6IkPf^RiCt4$=ExXhC!A4q5<mYJyq+1@c52
zq+?)4!HC^K{a+g}5kVDI(KacFzMq-o8ptLeGDt&I*YYnWu%`MEfDm!4Hi1)3h=0at
z_}vMJyM5y^q-+I3nSiJ*A<B3{h;(a4!AFg>RyM+t)$|CN9vrNuqv>KCvTQWtWEfTZ
zfdf>etdcm_Msr)xsM3t<EK7x#siGekQ>qY~0lycxnXH8y$l8(e*{{Sma=s<iG1z6@
z3YT%Qm`tT<ce`9P<|Pxc$@^@y+;vylNq1zB4R3#=V96u6Z{>CZ2u!goQ(CbYWKs)E
zk7c7%4=L2wp=5M|SSZsIx7k`Sa=pC;X+&WZeN#LP7I50yW6^Y&pgIiW#oe%ilTQ@L
zoBqWZnU!>lTwK_&B|X`1GxVf<nCJd`VAjrbY7oNqN<@W;ADG1S?0PysJ&Cn+-hj^f
zdlG9@Z7Ztq+LKvewdM4y_hjbf_SO_s9t_Tc>tz7MXG~`8UhhCgb=B2cxK3;^X7?T9
z5wU@M!}Ko&RK$kKre2GwU0mpgG?AJlO^9n~|7mCx>=QJEh)`uidgKxDSsLVJDWn>U
zft`fz*<|M9b_TA0@fMf?BJ`B%{~BvIc@|9!FA;&jO%M^}NJOT*gA&k!QO`1ui~wB7
zjNh^Y+#gD@Um)?D^*srXM!}N~9|1q|8uK;YqQ%{R;Mx1op|M34tlj`rdmQyF7P-)j
zoF46eQf>&rf2$oa3YH>iRD(&HF9S^dgxr-Rn>%ZyG;yi~D&PUlgB8|>F?{qC=GxE<
zWW*tqtqwqF#A`(0@+r(Wq%VHS<}jSr!YHnDI&wc)sIkcFN6dPETmG*PC_gC?wVP4x
z@24>DYBlKBzx3<wyZGfb6~C_0uTc7Rf_{y{uU@<HOJeCDp(NG>mKwk!gS|J~GV4`k
zVhm`k1AuEK!8kOPwTpHhp_pz}?KIz$?TlW1lEsA0nZAhpoWT;9>slNgEF@2#2w6iS
zq8$e&0o)3NBJkGJSWCAL$h|*)os^3|QJRmMhC`BlxN#b5IHoo@_>wG6#-Kq1s$_BN
z8+KVl>=ntPKh-f&REapB3P~KUNMaFSTWZVS`tyXRd>V6iyNO*&k-b)851>@{>8zFK
zI-2obk`@oz#l#I7)0sYGC_y6ME!r^xza>LE-BZ*9Lhm3P7zxND*j@_k?HPdm5n#Vg
z$E5!Q_9^ht-qIoqyt9C-EkiY%KK?x(;`OS|nsryQ-e7u0H*QA)ZLG=$n0zx>*sztG
zfsP&_*((Vv74wl`$yBH>*r-z9tQ_btZ9wqalhSftZC7Fl7b+DGRso7l3-{rl&tOe@
zWFip9U~(B?im|v@FVP8Uvo;X`U!FyN9r_<s<5t4gS+@pr0tvlqFD#)8mynE<ujJ!j
zXA_+Z<FWjEoi(5L^AKszFC{un?myUUL0#(GvNhU8;0c6ny3BWjc<n_6$C8N%s@29R
zrK0Vn*1cK^&Jb-oARRK3ZEy<aH)k?Gr@wg3S=buMBqG6rL}CF{H#s_Kv?s?&)WNj=
zC!MUsj3jCCpry5+Vf8boBp;L-s+3xamB>q_qD?<h)U~#=l0WN}e7FR0`OtMdn929g
zV%6JCFvAG{%*l}6-;dU_zVDKVBarXBh(rz|AMlgnNUxjujah7zv8<h35hEr=tXx3@
zM0*D*;B{{kcr9P{y@zxVP#3JI%t!${p;SVZUR=-~y(lL_o9rbFmc6J%H&Qe!t>SOo
zhOaBCnq?IBIRNQAnxeRkLiv%|%r({*U~B-~0D#teFHN|d0Q5)XJOGGV2&qfM`+r#0
z;MPC0_KyG}SpQi5ajnMd&0)Qa!EgP~F`EuZQbPNvSLP3bw@IZ>Bk6Ooya`KMSkKDt
zllz}b+e+?8PA-?+c^fI<&adg<&SWaS3F!cL6l5cc^eVVUYjl`L1`~<d?N|-}eh$KW
zR-u3lL8sI&u?=RRFcn(>Q5QI8CK8Cy1ulzP7)&H)TTn>W7>b!r4K%{}5Pb;BrHw1M
zVwYYYfZzSnlFDOEkCjTV5oB}EaL@q+2m(jYJJsz0fyAt>eU4_^$>{bf85q*~A5cP)
z0hb_=Q6DWhI2R70yg?d%WiD&&zMNo~wTsph4r<P)F&eI$#~OyjBL|m|<8}{&OJYa5
z=naSUwR<5^=uTS?Z;p9&TJYiH=CRh@AA%g&?U*x7r2|aW<b^(gfH06`Qnfa_p}G{S
zf?AM8h)S_2;$O~VeS=cbDJmYSl!ec#{ys6#-rogvY!wIap!sZ?^9|6yZ9Z$+{U~7n
zHw8NCca?%?1OA7CRQ~UL*5CMTE1Wk2@Dw-$Me-6UF>}&T6W-&skeJ^{Vg%B`G*@cJ
z>SPzEMIrc_4wy%2g2i>2ulXsmTXmk%enZla*l>_;Jxd}@P$unhG|N6J1452MIRb>%
z3rHPUUJKA^P&piUdY9jRgEiINYy$~5YwzI?i0sTg7O<c(o7Yie>4{CWm{{2s2}g-*
zHWnmC+W`{4)aN0d{toJ>5f%jaY8=PtFa>_@TAsUrwRP#NeD>y77qCG6A7IT(=$0UX
zH(toP#U5+vz|g6SB|}G3akFd7R4}vyDTFIX2P>X}rYeRGGuRobk84c`hVdaQnEQY;
zzu8#$Gd0Mh-Gh2|7TP)36j&TM_&CbmU@3fvQ%K=27J`Gf(C1J;r{o{kX1rY@>)tV7
z4PjK6=Z@dRd>ij30#sGkl776+-%Z3NB8N{PNC`BhVD?zj1~4O9NcDp`#VQSHZ2}U^
z@g30m)&MHTErJ`lK#5+E`pQkIK(o+MrABL{p!j2ARwuv~ZBYk}?hp3Z8{HLM+-glU
zc5%)qQBpQi-|jD4Ew#DY$BnR#GDkVds}t3@k6{$N>#E(S27UNl<3m1Rjd*4ft2=bE
zFEPR)=A*d+@|Bz7cKkwAVI_)%%jYD+mg$gh2<BM`0Dw0p`uh<5v6~k${n)$TqdZia
z);w5i^`ITE`EpxaTvalXg3N~MXw@ZDcMyD1{27tT7+2fV1ei@XEF=p+*BFAy-&n*N
zw3`nxse(%kNfxsSIPIg6!zvj@Bn|T@zHbrp(AAcN>gy=<M)1pvSPxy?YMU6CwBPj8
z@Mepdr)MMrywzCpQjtUUERl~eyTOZDOC$U06(KM;vk5`Bg;M@=kYJAY2UosZ1tHjp
zR8fr%F+gf4XlJZaf!L{4YAiqsif5yEVFzMjl1z7aU1!T~we#5LmzCagO=fkCt&Feq
z-lu)-!$2Jz6tUC&1~sBod;}9#>Amhs?~Q9N5!WTe-3jr{1+Xb;bKPKC<~u{Z(x6nV
zyaoX1&LC9<YWJ+5ew%LBSk!T$!0n)HPW=o}rvUUzfCIczIDoq=aFVp<SgjRTvdXRh
zR+NZdn}`m>WC#$V#47P6#{g`fK6tia3G*_x22O_&e+1&@AUf2}aG?C0^qaM>3j6R?
zc&usZqgEtk`SbFZ$NO9W!oadA$!9;QOd^gwx<s6t?VEu8qOD6{CLBBVO7}-Mv3380
z`Lg>bBEcNr3H^B|1>HXt%NkKcQ5S0Wdny$O`d3Pg4oE@q<0xL(1+<Dzaw*i0-c<ry
zkkzHJy3fHDe<!=&ID_IqBjwc+Xp+<NSL9%Rgq=BR%ZWdaex%mm;U27}6gi+L0Wqw+
z6aj2U6oeB6+d!GcL&^azp{Fep4dUi|U7`9or%}W&zKPw;>sVP+vqH^-;Um`0UPe?n
zJfwLYu+%PcpkflJFi&u@&;?4Q>A-%QrlY5OfDeOY86;cm{*D~fNzUQxpM^B}2*7lk
ziqf?2;m4!0Mn&N>TbxeQuE&?bM7&DZrsB7iWaa^y|GzNX63hfgm;<SDdXpIZ(QW!V
zO&^9IkA7(MU3iOYY5G9QByvQ-w>)DBwvu-xvfBLbrL68$Jvs!+McNYLi@CDn+ae8p
zRSQ@Ou`8ev0rQAm+Gq!2lI-(WgQap)-f`l|=q=^6_F2+qKB5VqxQsQa_W)vVj>9IT
z>sI^{MRWOvWvm0jZNFT`77Tm?xM^fgrZ|Kt^s)L$jRpO{!F5eR4id+pE2#vOqJE*8
z7Nw?nBW;437R29N&iW3F_i||2)7i3R(~)M5j{ylMA!uUu9NDgPkZWVIjQ<opF{LxK
z91?XI%;1AoFprMopp@nLGxd^DtpW9_?11f5iN-7{ZLn49;6arLl!cbzA`SaRWUk;p
z1hZ*}OHS+i%RjD1-sJDDU|}5_$w8pZ=}qz5k+qL{ygH}DI#|K*?jp&odY;lS6Fv7f
z@X>OtauzkRM66qat+1guaD%Jm>10LN>nMbiqO#BrRA}{5PbJHT>f^|!%sMXX55&^o
ziueF*q%P>CoKzLF08<9Jm%zP=7c<_J`!L&%`k*d_PZ(J<qqC7fzviYfm<PH+Gs?$^
z#J}K+A-%7gb&kQD>}gotTO$vZ-B}9EJ5|i>fmzOdCzaiUld=v5=u$U(g`cRxZneVm
znX-b!K<Z%=DqvIP5}I#FuOS-oc_~=2U7sPv`>!`q^E45<0oAB@!(?!1w89~B7@eIi
z3!b2Y7pdS>Dk!-`*}D}uIh6e^W%rkGh*MWZ3*s6$1(z_;mx}w+bi9b4@D!JcG=6U-
z^Wp<mVj^y=zzHBYR)SOVx<bzg)N!PzmO_s+75s+^=2AgBJys?A_a(@FNZD&89EG0A
zM4JOWo$d4tCwhwU2~W$W&PDX%eW1aV2%CKMH$D?^<msGP1;)tp6yGkBKiovI{DCw2
z_=_6^&Kg$#g>CO)z9A9vH7}T~5vvdp_2*|5>K%emu5B?!7q}~vOo{NGAxC675-=QZ
zCxhq+XlL;j(#4<Has{>0%IK|BArThSWu4(lox@Z|UZI<SI?zu^nECDFI22(RMu659
zHGH9ltU?*l^nN@<Dsve_YL5cxe;K;Gual)c79S`R1W?MoaiIp6g?K+ty98k58B1xh
z${}geCIS?Ndtg$i3MhGosn*=z+45`cR%p-Msvt}fnoEmid!OTva+B{z)A=W>S%-G_
z^%&@BH0PN0ckmlbX$i|3@=vLL{nF;dQQVJ@7{_a+GT$NR0RbC0s_DOvzT|EC)WR*@
zK$cX!?T8jQMC#R+&GHC^dNN^H8(gNX4sE4dGZQAow9rx2bZaJZV=8VUj6?z;v;c%y
zQ@9(5`G6=^-2%ud3PF%D2r#}u>1Nl$MQF()>bbGgWG}2Fo|s%v^HM9SS?7DPo%#pc
zTWkJ>SOUg)Dgp;Gv@w;WB1T)0t4fhDrHD6_l&#2ETM@b6VKiwyl`=1A{HS0;ZDleP
zFb|0nl-J{XY@D@7ilnjV0z&1EP7B<(jWs8FmLiqls7wI6MNfzVc`mAw3^))WS|d5A
z(lP=~MWy_DM0`~d;c}UmuVMOj_rP)F53P^q!1kf7Q)OQ)r=ZbtP@<lULW_s-j%!&X
zWAH*6dAc=el3>JGrowWyjsu96uV7eBkWEpZ4p=2&vlNWy>%Byf%!)%6T)#kk4Zb*;
zG!EdEBq*aN!gwFw82K4!eYtpngJnUL)-k}I=lK#iQJp}k?Il14lXh`en&z=Kfv8j~
z6TibCLB+`bpyLc>DFmQiZ`6ZN(h!#5qT^BPU=jD3Lco=q7*L=#6`)>=b`fnTYjqJW
zcc{}>^v9Y~p08DIw|7n=8eOX;LIkr&1oK`aFJx)N=}1j{|LBF{Hhr6ycZO#Y2jpZ_
z9|^#N3B&_!POyr`06axXRT~xJ0KVy5g&GWq;)`T)H^a9Ua(E#lwln%H+WCUW0X#Z}
zxQw?+V_lqr_}DbKY3E8OWU^1tnGl1YE_Et>nxi^Lkkd2@PSgH=X$C*bAS6e8Q4^4?
z$H7V9sS!j4_2moc+FcAmb?oWZd<~}#@;`=YZ7|(1geAKyJQ;-Z6_xPohAzLE*aO@j
zjapzy_JS8i^<tCA$&e>H*jEIRwDlm#`Q?k?g3^<*07=Nz{-y4u5}#0s$`e&R*NRZ1
z+ZLGUR^il08T<lb3@)NG&=9la>T5`1Mdc`U6O^=GU4<&$0(4X{b=1L06_uxJP#@uZ
z{Y7f93D;Q-a1nnY16NgcuIeuBL79C{dH{#Ih}+}1em!d!^fSB+4#Cx6qvE5Rd;#%L
zGD6rg3WgUrS<r(b{YynMU$CA9BWO2&J$h*>|7ksII=IFE119f077lbFH{MrVu0bqD
zv^kcEaBQv04RzXl38D|P{-PU!zkp74K?K796Ap5m<jYOWGx+i&htj9%BR$H^5E|vO
zyq4i~lqY~|tkn$Zi!r42F$xsn!_N|gNdCgaT8+6hUv}rG^T4={XpI;FQL}b`iKdp0
zSQ^p?jwa}AG<k~E#8T3}Sd2mJ2m9bHlRy#6m%qh)W0rLUi)gASurpA54lnPTe(Se>
z4x;q?`%%@@-<}ci$v&1J@Iy^atd5R%qeooPH`<_%*zSFcHE*{2teyYwpl~6DQPWv;
zdg<q^Wf5<0W{v7^K!YHr8|TvGLG9|qN10i(&Tqq>k1-8)fy^APjUspnjn>v>;`snH
z0<_1P`v=0L68YHNBGY6U-(_Y|^#c@mx8?v|9>H73oj0&Z;~c5mT{lqrK}ruCM+l-|
zti%e4I5y`_p}D|-W+v6_XP#Ko;*EX*3kyLT@Qd-JEMPgg(=H47!q17`08$kT-if~G
zlA6Td94TCj4J_Dt=WtQ_`3<a#&Xw9@*4LGPT>Em}My7XK&RcC{ttZ`{jXZTKFTrm|
zi~n$d;*GGIDiOuRU|MN}ObDb1ShYw0l`JV0W~|oiH(;jVBf|8Jj1ld69(K$_?W+-L
z@A}Ibt<EADp%$6?l#C8s;e=+VYdZuWLTw`pF*X1Tt0L5#MA&n(ESlNkx-J6<T6eFy
zB2KVkT<=jsC^lBcg*l0uvIcIQ*7t>xWvlpstmt~##sS9~bhg4A)rg83$#*?pK{D05
z3Q6uONOENrT*IsP@T@}8O+k|OUq}|p8s0W~>L@s_NU4=;FxOG2W~`!1BO+uKdK{{+
zz6!~ucEkeL9{+_zCu=mZA<36T^>d*1)oypyztWJO5JY8;@&XRt9Hl}q&7p)1zzhHY
zMY6J;!Mjlf<^P&Rg629Ee}v`*|Kn{II{588Da6vCZVm~sFZqiTFdncsjx=+82&!dM
zweF)RRbJ-%1ZhU+7nL#|R5>BLtdQU1@R|(3{%i=jZ*XlCE)CM&!?N)u7i>z~|8kpD
zd;?mbjwfR=X&&!nq2vA_p=Aw8wma}E?@;A|G)rF^jHczFLf@`73ZP!+&!xrUX+)*F
z)n%odv|t^GE)xq-31#;aDJWY*DO)EzE%=2W7U6$Wx8e|`nk``O!1$@1*5n4|mQt<~
z74_>El3_`mA$AmE0t-K+3H^}D5)V+-Pcl}+p9VBkrPEFLp<Nbp6^Kj)1nu|AK&uS;
zR$gTf1pjG}$s3m{5nhOppsQk@TEPPi>*zua8(t1Q6-Xufo+746I0lt8|9qVC3<Pcz
z-wEE(9sS>mg(n=2TrygPf(@Iw|0d?|JfbZQX>MX|d$BeM>ayKk-CatNypa=~czhfX
zW5CfmVkwHL?Q?K@{mY9sF|TGV;|aF*Jn@8fo6l8d6v)P-EoC?-{$vx2^|Z>qrYOtA
zN#OgQy3{Sj;w?VzJ=W6yGObt@KO5!;SOV|1RwnURZ`#p)&3C`Y8u?U`QlhDBCd48n
zRh}2orH+#_qCMM2!*9KZkU3XgXEXDRy$B1AEbG6BDqL`$_M0S6zM8QG^P}(|p+HOB
zRh6-tGV0qh$cKV9_5$QLHnX;E3a3>uX9ZSwQW)e*v0xM34@6f9i6{K4%`CwAcxxQE
z+zcf@kXOgORL-mM9l$Xu_0F=bip@Qb6GW_Z>45u*%I7pNvCy3Z-lA83Ktka$Nkggl
z1!<y3xg=ShuiT^*r-gA(rTi``|CL()piHwr7uUMtxpH;Tzq}mO80-0Bg-dg@dgqH8
zU>@9dDpr!puDZi9qQ%FlvrEKvES>1ipoN%ALEttgjJpdeLJ|neXk=h{VL)?sK&OaL
z-~qr0BZt#GDtuWj+~Ltsf*5PCxnw^&B3qW!4g6lz5@KMU&OjRC>bFdR2d-!fYZ&n>
zeAa~hC)wdZLd%-FBA%+sbB?;yuaTux8-i*8QVn`6T)me*k9%xoEy9cw6~R!p2V%oT
z38r{FaSHYEPqvb^iO5{N!cDWRtJ<1|Bhi|pJaH>dJuhm3o$9TK-YfqS{^z=~Nq9U6
zLwGS63-pi>U3*Y2>L{2}CrCpX$vCOoR}`WUyusZuw!?)}zHGNVoDuv&3V`B_{V`6;
zKs3^zf@`5Qh3;sah#7(ktEYy8&9!0;h)Jh_^m0Dredg|byt#(Yc%L=bbp&D7!(in*
z&B>9$XT8swx-$oA4dVGHkS8NQ`#$S2VAqEV5wxq*{ka1XzYLZ{3__Z+9XR$iupwTO
zCa=;N=9>)a7Nx1XI$L?%2RL8pKbgjf!)Dz3KL4djJV}#5JuSmX{Tza$u~guH5S1_p
zE5M!y7-c)>80fJ4A{o7mFzO>1FraEQS^@c@#|f(|mH6Zr1K~?TS&>e)a_~!Cb(e~c
zpUQ?NwuGizH|Z6}(4%IONaadYD;&|<9?dko?=}|cybV80+gOuYZkSLAuiHWX$u_j~
z$_G_rSx>FTSO#$YsHe8E>^w-aa6S^u@sRFPu>>jN@@<9XbW%D%DNF<GN~|p12Pv}U
zvW*gg1G|5GqK@T_eDsGP;+F};Zigq^GMd`QHMyqj@uYPy-w~GiSQ5}cs)Rs+bDhw=
zh5aRWOGN=FP~WRdl&lWZ5UWc>-vg4>G?X<|0YMay!BVl#h#D$~OGIaM2&wyEC2%JS
zq{*(e%_)y?asbLwdf)7HB^?FMSs(_?u*50ouI#U%%eUx&wYDA|H!#uT)<ZDpUAv>B
zOe@LthtQV9PJHD@Ot0U7G6+VaZ8zo6k&n<F<-0#(O^r+MKd1NS<i)i#uMMQ4RmCnA
zfMm1&Z{i}_84ScUZ<wfkX8q<NN^(<~oRoaDo=n&Nj80HzMS}SlMk&peRm@&OU`?(a
zu%6)2AG0>GpP~pZ>ksTl(<_xztNVx!3I$_S3f|o(IZg4lnMjH_8V;0HL0pllu0&|}
z@h?AS1}A4;J(D#L9w+%j`&m+tG<@tZgulef34q!m4MVCn;3?0Ew&!CrnUDLY(bV{1
zzBAzR!YZ~>U+S&l8JTQCt)yO<31~jc;QwZ_#&ybJk|>8`#OvHAiw*X8*i$Xxb{Ifl
z$Ampt@Rc~h*JiQip3BFf|IQNXcvP%?R$RnXU@)D0H{)Rw{$m!?xp^U7BG`l+>#Fnb
z-9=yFdaUK;;_c1$Vb!D)StRNdsefo2R>uvpSpi5WET$g8N-GF$5gQP>Ld9ud{qc`1
zPQAKODgPWPh3C}r&L~d@k6>sefH&g7^GcU+`K0QAU1Z`mG}1j9bb$r@hT6$qwi)x~
z=b~qhMl=5Bx#(hO8VctM7>l8{)Y&o~&KvOJ??=FYO~s!Gnk;mUM+^>mg4`z<_2j6~
z>{dsb(X9QFDp1e>HLxElkfcH+soeLw<Y)I-`MJI<4Q|SlNW-%;sn-+xKri-^PHg2q
zYJa+=LM}2*T8_mLNh^YY_KcFd(aOd1_V}M#Am7^0sN7uvTzKYE823odCWV*{SoCX$
z0R|weV5X^H<U<s8Fy9=iP_M&DfPTj`3{bJAzeE>+Qm!V@rS>9|!5rKQ0055sq_SLz
zFnz#-a+q)1NyC)^`93KKI);8=82DBRo`|bkl&qS_5@&cy4r}VX)<eUya+tUKGpHiv
zY1geNiyKt^aA)whIn2Yk2Z~s8SWn~ghU%!5FJaipUP3i#Lc-#P{8w|(#SoC{_*2-P
zQ2F%-D?kceWAHod9{P<rpU#0U0dY_tsnG9AGUj}}Xd_dT>PR>1+-=nQo3U%g{w~Ms
z$M>GYdjCe5_xndm!9IjEpxgwm6m}z&hmnqXzZ~8|e4;s}vCe<d+&>&WuJUq?Kag6-
zp>up2YPfSAYhGv5L3HFnQc!x_?1GdA(~%<CLLxMI2ZqcoJ|&NZ8|%D-X&9jGVL`lH
z8Exl8L_bN?J|rlw7}o(^;t*0r-Cv|s$fe~pr2>hnPN}gBDQLz|31|lVry5~II;hzO
z#@qL5LS)Dnwq><*N4yjoao1hx9xQUCsg3o`e9S`1F6>sYfdYeI4#-Fu*XX;?afj0~
z?2#<ZrQiZjzHSF|Grky3a!<Qj>au286;zuB2H>aA??m|ckv5U_k_fa-Fngd06)*th
zBq=icLj0biF|=0}j`7$MW0b1;W0kEMBSPuEGb70lOEaaIMYWFOmpWCR6ZP^X=Mv#8
z(T)O<Xyr>Gu2&k!);k78jR28W+}fvqBNB}Q%A>i63xNiqSlNcSXf+FU%tLT@A4U4)
zU|O-(sw1x!gr}>7f1J-6by|obh(Ab01i}pZ`JVPQ{4q4|IT?SB!=ZuI(wRi9=u4|0
zpt#0w=d%v+TQ&j{GE;D4h6{K>I+mO{-gl&sh~fw-BEk4H$HU`ZDth&y6lIlWFmLir
zA<$;mF>k8I;tD=%CkqI?6;J)+U@R`HZ|`--{@F|9;I2P@dM9hvzbh2Eh{%x)_bQA8
zXpGZ;ApwMW4QR1kLif=HH-uL5T(n02C?h4QA!Kl1JuJv}F|YWMNIyoy9jC|_A?Qup
z8YH1NpxW$vYM*1;2Q{|fns88K84C=g<42O{AY4JWjv`GcC6aI1#oDsQ`}v7oY?Nye
zCUm(Z&<=9b@V2{ID`SOK8C#_yzqe$Z{x2x{L=Zs@@D8U6S|>M}8w}ymrZW+hLjsBA
zG*5i3)Fp1rQYx1rrEn1{Tc9f|m7Pm$U}K(m>9T-HfJgdz^%-xQ?Ly%+H!$Crezx&S
zlyTe%8#2L!7Sr=q@+^}s^?TwEtbrV0wC#$B6SNpnu9$H#N7l3)mW4`%kqVJlpz1d3
zx5B8Nek;0&=Hu6S${wa~;{hZze&diPk(H45VDE1gc<3m`H%?lAvvjziV-M@*L311V
zn`%xA?WkKbOfIVMs5!5-m-U`G-Q=LXXs`Lc#iqTs^^_d0dHXp|C&Sc%5NgrGqE0X9
zujxM!P-U<AxKf3reuh%#3Q|z~>QD^+S!kRn>si4wzH)M}qeV`?v?<Uw9v|~ddzt^x
zxr1L(G<qxz6?Qvv``w+yn{(nZR#Ecd6-yh)9;Ej$IuW?K5w69AE0o9WV_remvee}f
zc!Xz6v1@k{DT*K`PN6;-0%GZIb@fJl@gCo{4>4XXk*scX;;3q=Xn=40h3k4sRE5ye
zmw6<^Rtq||ROmzLTi-$LpspXwu|?D0127JRB|@AE%|zIu9s~%Fl!FckzEe^yaqT%y
zST>^}XVyFSCgoJpRy_Df!e|6ho&jFKkri>kDd;;$I36sq+?T=v??o1$w4Zsnc0m!;
z{<0UkCZDg_&$<{7!L+fd?FsN2tK76r1~)N#MVRN-vCg6t(xa<TL7gqgD)&d7FUeJo
ziWh8ScNc0|L&dsG7^uoK!eQ9w(?+4HQiN*Ws||YnR0ZIZSPcMhksxZCtkm*(AEM<D
zMHk}SsX=_=0XDY14~aN!mwYW-Hcqm&HWH&v9x*0dOWQ?mL4x6(5lU`3fYZ%)YiYRK
zL8fnUq`Rz($E_e5yXZr`j6Ug@71k$i%I8rBnZMWiuE_fKjts5GzROi{6he#}I5hli
zFDG~Y@j=$nd&TspxS}9({mmHDZG)WZK~GA*^$$d~EBy9BNJbKQo^e&ZGJWd1qJr(Z
z1v<H?OZx#eL}LsoS_#pI!GxtgZr}YJHSt6;LiQD<<bsJO8vKd}zto=flswoXD`~@!
zZZI`TMKyc2sV2D%Os?~5YWT)aa6Wnj-~R~<@#slZ(N>Y{Uz<Dab6)WY?nraxo`=|E
zW7jpdVQ%iZmZSqimz-yXzu89nlx}jge~W}dx_+H{s0?W$=(1$7Tp5^@;>6f4O8G1*
zueh6`lVw_@P+YLCuE?V>3?ISnZXwe`&)q&{u5LA4)FlB1i76Uxs`j5^2{R`fcmVj@
z0qVH5e5MTWj9Wl4SS85=C?ZThTDDT2@&=_Lh75U}gWgKr-!mGYFehd~ky7e<q~dcd
z8XKh+Tr87t9U<ZjLzTKywtC27@LOqzK=P$COnc1$;(qxQM`u6Zj)`jsROjcwOLLX!
zlIRF02KWd=1iR1nI`XOzGMPy9P1k7hQ;)GMCK%_@4mqt7ZGXQ{6vy7g2!{s~w#IqP
z%y?PzCY>84&u_k<nYlz54@iqW5m&)$+k+^z5^8+lP=jLQW?^MlmAf3dNZdY9R#7j9
zoS{~+E>>7XK{8@65C9W6g{`q`A{;CNN!I=#;_?7kW1^!%K}~?00&rH`FsT1+fWo~7
zGLN2**L#L2Ng5@IuF4qx5_T)PnXYvN)AqoTihMKWlapRKM59~t4Onb8c%Z~5D1ol%
zXT<DFoV2?>I*<y5=NtLvkzU9WnG0o8|7`?y1pj6+Z4Q))tI$>?R5P&zj4=H~ynKd5
zGF>ts25Ni593s8MgDI^jshK&>3ut=)EMTGs&nhUVVyjntE@733W`JeCtFb;l<Q?6<
z2WaH3{$_r}goyDG<08gR7(WjBv1d(cWcr+&_z!J{FCu~{lElq~r3XELQ#~@+jq~wG
zSTo%v6tI4SiR09yr<Gz7f9nVy@;MJ<)nL+LnTNrp-+&zc^%3Te_oMF|VSS9A7~Z6E
zZY$d3OSw2!p7|)o(PSXO<4oESAcbNArO7}FH&-d%3+Yfc>rl&{ZE{V<Cq;mmiYnt>
z=wb83C6Vg^lNO`mHLNE{ht!oxe18G%k{Ru+;TH;U9ZXOBxLv@!-9EuYX03KAGQo-J
z6nEwgkFo%-ugUI{F`q!6V!(N2SWDXTOvA?<WsPd=#|VR4j^8O@cqQp0zWFGN^E=j_
zB-m94*%zBT5$@~qV0C{aC>K!t6NRj$ylx@$47~a;tm)ysQGu>?5%E;P-)abZC{MJ;
z!C!!^gUBlE4H85UA5qAr8+SCND{7>H@F=l1iG?dFMmxhm2vCDyu82qIGsU(`oHH#Q
zI{Ojc2Bq7DupL!Q@6&{mDB*aN**l3;g*X#Pa*1^Xsef~wDB6bq-dmOtdy!|qf4NK8
zNx5pC1iC<8BO=ckeIU9}DMYS7%vOKnN8$z18gt@2{W}t|N87x$5e6!WUuI^0=7G$D
z%%aTV%!`?2nKv^<W_jk5Oih+cmRpu*mQR*nR$x|0R(O^nD=sS`Yhu=ntod2VSt(g*
zSs7VdvNE&svkqhxWEEu<XI;z^S>;(zvNYR0xBG1O+a9<*WPA8_!}hrC3EL-b-?BY(
zd;azV+Y7cAZ7<$#ytut=`_1j1**@8R*@4+1+2PrS?6~ZN?1|Z1vNN;uvkzn!WEW)@
zXJ5=N%f6ZIlcNdLXeNT-EyycCy2vii*5tV4c;@)z1m=X~7;@rrCg#k@NzO^h$;jD~
zlb>@Srzod5r!41YPI=Cg9G6_TT%TOO+>qSx+_>BXWA2RH`MD{%X}Mc+Gjk8*7UXK?
zGYv(G6ab~j4#^1zzytuC4}e<$tQdfv<hTJucy0pfrlDRz?!{b@Tb`@Q^UMp(3&}I&
zP0UNq%gEc3m!DUZSC&_v=d#0RN63!29W!>M?AWs7z>eY_H+MYQp~*M8<@@D_=O^UP
z&ri$G%rD5lm@o1*J3V&>?lkP2xHEZY#?JhmMLWxOmhW`g<+CefSKO`{yHa*-*>zx7
z@vfV@p6qhl?YBF8cf#)ZyVG`O?k?DUaktp5+2gq<aF1cn#68J-GWO)}DcV!Er+kmg
zUZ1@od*k-b*qgF<%iaTfi}&8#`^31{ZJ*!1@O=sU=I=|}m$|QC-^G1mpJu=3{=of)
z{S)^m@6XtuzrSdI+5YnVniQrX=e|p(Pi9DFT;`0-l*}!Vnqny}Pcq#gBjJz@n@kjC
z-Gm&tK?cIn_Y=2gpyv;u*Ds>O%eQOL-Qn3r>OJZ?>b3dkG3u?0=qZitr$E_D6VX8#
z=$!K0z`Ss<HU+HB%sY^GG4E!c28;~^V<+yI57v?-Gfe{ixMlyBOwGuipPihYlAV^F
zp~#o<6#*l0dLjkNO^TGC6smA)b`jIer`99gPYN0dS(+5F0x4iZikGJpE(2s^MsBi{
xt9-~uac&tT<VmgzB*afjNJ8EW$VlrnDI^7X#Sjyb_XL9Cxx){l0!$A7{twyhDboM|

diff --git a/ShellBinPkg/ReadMe.txt b/ShellBinPkg/ReadMe.txt
index 5a5df99b0fe5..788922d225f5 100644
--- a/ShellBinPkg/ReadMe.txt
+++ b/ShellBinPkg/ReadMe.txt
@@ -2,7 +2,7 @@
                                  OVERVIEW
 ============================================================================
 The binaries of ShellBinPkg are generated with ShellPkg project and built with 
-BaseTools Package (r18330). The binaries are built with no debug information 
+BaseTools Package (r18507). The binaries are built with no debug information 
 by building with "RELEASE" target.
 
 The following steps can help to re-generate these binaries for customization:
diff --git a/ShellBinPkg/UefiShell/Ia32/Shell.efi b/ShellBinPkg/UefiShell/Ia32/Shell.efi
index ff1457964e40fb6fddf38d0078a3c4e364d51965..7fb32890cf82024091ea29acb8d5504142811d17 100644
GIT binary patch
delta 279128
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%0DWwy;YnNdH-;@ZfSCh
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

delta 279055
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%0Aa2xomF3C)?1Kd?~O*&j(-tdGAxyG_GM
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

diff --git a/ShellBinPkg/UefiShell/X64/Shell.efi b/ShellBinPkg/UefiShell/X64/Shell.efi
index b7b3a183781ceffdd41aac621e955a1ff696bdd5..13858c1411a671324140ac6ee4689b25764d9a27 100644
GIT binary patch
delta 243280
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

delta 240591
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


From e8a7f76f9c99c8329cc0c05a5eb8648c413a1183 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Mon, 21 Sep 2015 01:03:56 +0000
Subject: [PATCH 060/525] MdeModulePkg/Core/Dxe/Gcd: remove set but not used
 variables

These trip up compilation with gcc.

(Sync patch r18515 from main trunk.)

Cc: Liming Gao <liming.gao@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Star Zeng <star.zeng@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18516 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Dxe/Gcd/Gcd.c | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
index c2769622581d..bd7c6c649350 100644
--- a/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
+++ b/MdeModulePkg/Core/Dxe/Gcd/Gcd.c
@@ -2061,9 +2061,6 @@ CoreInitializeMemoryServices (
   UINT64                             Length;
   UINT64                             Attributes;
   UINT64                             Capabilities;
-  EFI_PHYSICAL_ADDRESS               MaxMemoryBaseAddress;
-  UINT64                             MaxMemoryLength;
-  UINT64                             MaxMemoryAttributes;
   EFI_PHYSICAL_ADDRESS               TestedMemoryBaseAddress;
   UINT64                             TestedMemoryLength;
   EFI_PHYSICAL_ADDRESS               HighAddress;
@@ -2091,9 +2088,6 @@ CoreInitializeMemoryServices (
   BaseAddress           = 0;
   Length                = 0;
   Attributes            = 0;
-  MaxMemoryBaseAddress  = 0;
-  MaxMemoryLength       = 0;
-  MaxMemoryAttributes   = 0;
 
   //
   // Cache the PHIT HOB for later use

From 3a263f4c8203ce57f1bcc4be59511bcf5f15ce43 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Mon, 21 Sep 2015 08:00:09 +0000
Subject: [PATCH 061/525] MdePkg: Http.h - Add HttpMethodMax to
 EFI_HTTP_METHOD.

Add HttpMethodMax enum value to EFI_HTTP_METHOD to make it easier to iterate
through the HTTP methods using a loop.

(Sync patch r18520 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18522 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Protocol/Http.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/MdePkg/Include/Protocol/Http.h b/MdePkg/Include/Protocol/Http.h
index b1f8c51341d5..64b31213a46e 100644
--- a/MdePkg/Include/Protocol/Http.h
+++ b/MdePkg/Include/Protocol/Http.h
@@ -5,6 +5,7 @@
   HTTP Protocol (HTTP)
 
   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution. The full text of the license may be found at
@@ -54,7 +55,8 @@ typedef enum {
   HttpMethodHead,
   HttpMethodPut,
   HttpMethodDelete,
-  HttpMethodTrace
+  HttpMethodTrace,
+  HttpMethodMax
 } EFI_HTTP_METHOD;
 
 ///

From c6a0621e25b422a25d596a49c8d8d3dfa6afcd85 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Mon, 21 Sep 2015 08:00:42 +0000
Subject: [PATCH 062/525] NetworkPkg: Fix typos in some EFI_HTTP_STATUS_CODE
 definitions

Fix spelling typos in EFI_HTTP_STATUS_CODE definitions for error 415 and 501.

(Sync patch r18521 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18523 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Protocol/Http.h | 4 ++--
 NetworkPkg/HttpDxe/HttpProto.c | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/MdePkg/Include/Protocol/Http.h b/MdePkg/Include/Protocol/Http.h
index 64b31213a46e..839e378effe3 100644
--- a/MdePkg/Include/Protocol/Http.h
+++ b/MdePkg/Include/Protocol/Http.h
@@ -95,11 +95,11 @@ typedef enum {
   HTTP_STATUS_412_PRECONDITION_FAILED,
   HTTP_STATUS_413_REQUEST_ENTITY_TOO_LARGE,
   HTTP_STATUS_414_REQUEST_URI_TOO_LARGE,
-  HTTP_STATUS_415_UNSUPPORETD_MEDIA_TYPE,
+  HTTP_STATUS_415_UNSUPPORTED_MEDIA_TYPE,
   HTTP_STATUS_416_REQUESTED_RANGE_NOT_SATISFIED,
   HTTP_STATUS_417_EXPECTATION_FAILED,
   HTTP_STATUS_500_INTERNAL_SERVER_ERROR,
-  HTTP_STATUS_501_NOT_IMIPLEMENTED,
+  HTTP_STATUS_501_NOT_IMPLEMENTED,
   HTTP_STATUS_502_BAD_GATEWAY,
   HTTP_STATUS_503_SERVICE_UNAVAILABLE,
   HTTP_STATUS_504_GATEWAY_TIME_OUT,
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 8fbd45411064..13d5748378e3 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -2,6 +2,7 @@
   Miscellaneous routines for HttpDxe driver.
 
 Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -893,7 +894,7 @@ HttpMappingToStatusCode (
   case 414:
     return HTTP_STATUS_414_REQUEST_URI_TOO_LARGE;
   case 415:
-    return HTTP_STATUS_415_UNSUPPORETD_MEDIA_TYPE;
+    return HTTP_STATUS_415_UNSUPPORTED_MEDIA_TYPE;
   case 416:
     return HTTP_STATUS_416_REQUESTED_RANGE_NOT_SATISFIED;
   case 417:
@@ -901,7 +902,7 @@ HttpMappingToStatusCode (
   case 500:
     return HTTP_STATUS_500_INTERNAL_SERVER_ERROR;
   case 501:
-    return HTTP_STATUS_501_NOT_IMIPLEMENTED;
+    return HTTP_STATUS_501_NOT_IMPLEMENTED;
   case 502:
     return HTTP_STATUS_502_BAD_GATEWAY;
   case 503:

From d0b29b5ef6f903698d011510722233e37bcc7914 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 24 Sep 2015 03:22:55 +0000
Subject: [PATCH 063/525] SourceLevelDebugPkg: Change the debug message to
 "v1.5" from "v1.4"

(Sync patch r18534 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18536 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/DebugAgent/DebugAgentCommon/DebugAgent.c            | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugAgent.c b/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugAgent.c
index 6c3258630331..6a82cd354b3c 100644
--- a/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugAgent.c
+++ b/SourceLevelDebugPkg/Library/DebugAgent/DebugAgentCommon/DebugAgent.c
@@ -19,7 +19,7 @@
 #include "Ia32/DebugException.h"
 
 GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mErrorMsgVersionAlert[]       = "\rThe SourceLevelDebugPkg you are using requires a newer version of the Intel(R) UDK Debugger Tool.\r\n";
-GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mErrorMsgSendInitPacket[]     = "\rSend INIT break packet and try to connect the HOST (Intel(R) UDK Debugger Tool v1.4) ...\r\n";
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mErrorMsgSendInitPacket[]     = "\rSend INIT break packet and try to connect the HOST (Intel(R) UDK Debugger Tool v1.5) ...\r\n";
 GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mErrorMsgConnectOK[]          = "HOST connection is successful!\r\n";
 GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mErrorMsgConnectFail[]        = "HOST connection is failed!\r\n";
 GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 mWarningMsgIngoreBreakpoint[] = "Ignore break point in SMM for SMI issued during DXE debugging!\r\n";

From d81a37c69082331f98be995247fae41a65850e60 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 24 Sep 2015 03:23:20 +0000
Subject: [PATCH 064/525] SourceLevelDebugPkg: Change revision to 4 to compress
 packet

(Sync patch r18535 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18537 6f19259b-4bc3-4df7-8a09-765794883524
---
 SourceLevelDebugPkg/Include/TransferProtocol.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SourceLevelDebugPkg/Include/TransferProtocol.h b/SourceLevelDebugPkg/Include/TransferProtocol.h
index 45d82c299599..ef7c891c39c8 100644
--- a/SourceLevelDebugPkg/Include/TransferProtocol.h
+++ b/SourceLevelDebugPkg/Include/TransferProtocol.h
@@ -24,7 +24,7 @@
 //
 #define DEBUG_AGENT_REVISION_03         ((0 << 16) | 03)
 #define DEBUG_AGENT_REVISION_04         ((0 << 16) | 04)
-#define DEBUG_AGENT_REVISION            DEBUG_AGENT_REVISION_03
+#define DEBUG_AGENT_REVISION            DEBUG_AGENT_REVISION_04
 #define DEBUG_AGENT_CAPABILITIES        0
 
 //

From 182b7390e295ac469bde0e6606bef0c58d6521b5 Mon Sep 17 00:00:00 2001
From: Jaben Carsey <jaben.carsey@intel.com>
Date: Fri, 25 Sep 2015 06:06:59 +0000
Subject: [PATCH 065/525] ShellPkg: Update tftp to build with current tip

(Sync patch r18543 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jaben Carsey <jaben.carsey@intel.com>
Signed-off-by: Tapan  Shah <tapandshah@hpe.com>
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18547 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiShellTftpCommandLib/Tftp.c    |  26 +++++++++++-------
 .../UefiShellTftpCommandLib.h                 |   9 +++---
 .../UefiShellTftpCommandLib.uni               | Bin 8748 -> 8856 bytes
 3 files changed, 20 insertions(+), 15 deletions(-)

diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
index d2f7046de037..2dc9287020d7 100644
--- a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
+++ b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
@@ -2,6 +2,8 @@
   The implementation for the 'tftp' Shell command.
 
   Copyright (c) 2015, ARM Ltd. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved. <BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -14,6 +16,8 @@
 
 #include "UefiShellTftpCommandLib.h"
 
+#define IP4_CONFIG2_INTERFACE_INFO_NAME_LENGTH 32
+
 /*
    Constant strings and definitions related to the message indicating the amount of
    progress in the dowloading of a TFTP file.
@@ -59,7 +63,8 @@ StringToUint16 (
   @param[in]   NicNumber         The network physical device number.
   @param[out]  NicName           Address where to store the NIC name.
                                  The memory area has to be at least
-                                 IP4_NIC_NAME_LENGTH bytes wide.
+                                 IP4_CONFIG2_INTERFACE_INFO_NAME_LENGTH 
+                                 double byte wide.
 
   @return  EFI_SUCCESS  The name of the NIC was returned.
   @return  Others       The creation of the child for the Managed
@@ -258,7 +263,7 @@ ShellCommandRunTftp (
   EFI_HANDLE              *Handles;
   UINTN                   HandleCount;
   UINTN                   NicNumber;
-  CHAR16                  NicName[IP4_NIC_NAME_LENGTH];
+  CHAR16                  NicName[IP4_CONFIG2_INTERFACE_INFO_NAME_LENGTH];
   EFI_HANDLE              ControllerHandle;
   EFI_HANDLE              Mtftp4ChildHandle;
   EFI_MTFTP4_PROTOCOL     *Mtftp4;
@@ -271,6 +276,7 @@ ShellCommandRunTftp (
   NicFound            = FALSE;
   AsciiRemoteFilePath = NULL;
   Handles             = NULL;
+  FileSize            = 0;
 
   //
   // Initialize the Shell library (we must be in non-auto-init...)
@@ -571,7 +577,7 @@ StringToUint16 (
     return FALSE;
   }
 
-  *Value = Val;
+  *Value = (UINT16)Val;
   return TRUE;
 }
 
@@ -582,7 +588,8 @@ StringToUint16 (
   @param[in]   NicNumber         The network physical device number.
   @param[out]  NicName           Address where to store the NIC name.
                                  The memory area has to be at least
-                                 IP4_NIC_NAME_LENGTH bytes wide.
+                                 IP4_CONFIG2_INTERFACE_INFO_NAME_LENGTH 
+                                 double byte wide.
 
   @return  EFI_SUCCESS  The name of the NIC was returned.
   @return  Others       The creation of the child for the Managed
@@ -623,7 +630,7 @@ GetNicName (
 
   UnicodeSPrint (
     NicName,
-    IP4_NIC_NAME_LENGTH,
+    IP4_CONFIG2_INTERFACE_INFO_NAME_LENGTH,
     SnpMode.IfType == NET_IFTYPE_ETHERNET ?
     L"eth%d" :
     L"unk%d" ,
@@ -942,7 +949,7 @@ CheckPacket (
 {
   DOWNLOAD_CONTEXT  *Context;
   CHAR16            Progress[TFTP_PROGRESS_MESSAGE_SIZE];
-  UINT64            NbOfKb;
+  UINTN             NbOfKb;
   UINTN             Index;
   UINTN             LastStep;
   UINTN             Step;
@@ -966,10 +973,9 @@ CheckPacket (
   NbOfKb = Context->DownloadedNbOfBytes / 1024;
 
   Progress[0] = L'\0';
-  LastStep  = (Context->LastReportedNbOfBytes * TFTP_PROGRESS_SLIDER_STEPS) /
-              Context->FileSize;
-  Step      = (Context->DownloadedNbOfBytes   * TFTP_PROGRESS_SLIDER_STEPS) /
-              Context->FileSize;
+  LastStep  = (Context->LastReportedNbOfBytes * TFTP_PROGRESS_SLIDER_STEPS) / Context->FileSize;
+  Step      = (Context->DownloadedNbOfBytes * TFTP_PROGRESS_SLIDER_STEPS) / Context->FileSize;
+
   if (Step <= LastStep) {
     return EFI_SUCCESS;
   }
diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.h b/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.h
index a73b86c85b12..bef1e1d9f74d 100644
--- a/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.h
+++ b/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.h
@@ -1,7 +1,7 @@
 /** @file
   header file for NULL named library for 'tftp' Shell command functions.
 
-  Copyright (c) 2010 - 2011, Intel Corporation. All rights reserved. <BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved. <BR>
   Copyright (c) 2015, ARM Ltd. All rights reserved.<BR>
 
   This program and the accompanying materials
@@ -21,7 +21,6 @@
 #include <ShellBase.h>
 
 #include <Guid/ShellLibHiiGuid.h>
-#include <Guid/NicIp4ConfigNvData.h>
 
 #include <Protocol/ServiceBinding.h>
 #include <Protocol/Mtftp4.h>
@@ -42,9 +41,9 @@
 extern EFI_HANDLE gShellTftpHiiHandle;
 
 typedef struct {
-  UINT64  FileSize;
-  UINT64  DownloadedNbOfBytes;
-  UINT64  LastReportedNbOfBytes;
+  UINTN  FileSize;
+  UINTN  DownloadedNbOfBytes;
+  UINTN  LastReportedNbOfBytes;
 } DOWNLOAD_CONTEXT;
 
 /**
diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni b/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni
index 607a3602d2a3aad30619c0844162e7399c0aba9a..43b8cc5e7cd8726138c600b96b4ebbb1c960824c 100644
GIT binary patch
delta 329
zcmZ4EGQ)L(lesB_0)q!bDnmI#4v;JXLIs8ZhD3&BhHM~N#E=5yyE5bf#Z!U20wB(0
zC}v2Vm@Ccf!w|4>p)ZSQ2tyiBx`4r%A)g@^2or(IQzrAWc8Z5ExG{tPjZ**`ha|W8
zAZxWSw;zK)P|}qln89kYqKGi30)rug9#Cn><byKulj9^?COasyO@1J`08H0OL1-E2
zzR5}=LLf1A1)xRw3?-8fO3w$YiIZ_+RbVh;(3?D0rXQvXXl^OU#Xu*y%67s;`4xaZ
z%LnRD1=^UzP&xUnY&uY{F;H)yTrW)3<QzGf$z1Y9aDI)v+~igA1u*_*DFq=W07@ZG
AV*mgE

delta 289
zcmbQ?y2fRK6SFac?nG-zeqDwDhD3&BhHM~N#E>$vQd-iPA)g_ap#Uh5$56?j!=S+6
z!=MLLrnhmrFN?e%Ln=cFLpe}Q5m1v614MN$Sak|R@#LQ@o!Uk~^#(wFc_?ZX7z}}8
z$zapr>Nn41trlihU<jG~Rz`kulw=D#$l?-)jLH6rx|5}(vL^RP&6{i_-NOztE}x-f
z@<CDI$q%IGOm2~Jn0!VCBwor;%#b>nQCxI#jcgmg0z(Q=9mr}0h9rhcuzDT2l*u#X
lx+XVpiA+8uDl|Djz5>MNEC#9p`8yS)YLY_U<~9W(CII6DN&o-=


From 048e530ad73bed4d85ed50a5f727a6f4febc4dce Mon Sep 17 00:00:00 2001
From: Ye Ting <ting.ye@intel.com>
Date: Fri, 25 Sep 2015 06:07:27 +0000
Subject: [PATCH 066/525] NetworkPkg:Fix iSCSI driver issue to work with iSCSI
 LIO target

The patch fixes iSCSI driver can't reinstate itself when configured
 in AutoConfigure mode and IPv6 stack is actually used.
The issue occurs when iSCSI driver communicates with
iSCSI LIO target in IPv6 path and the target sends
back TCP FIN packets randomly.

(Sync patch r18546 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0

Signed-off-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu siyuan <siyuan.fu@intel.com>
Reviewed-by: Wu jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18548 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/IScsiDxe/IScsiConfig.h | 4 ++--
 NetworkPkg/IScsiDxe/IScsiDriver.c | 4 ++--
 NetworkPkg/IScsiDxe/IScsiDriver.h | 3 +--
 NetworkPkg/IScsiDxe/IScsiMisc.c   | 3 ++-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/NetworkPkg/IScsiDxe/IScsiConfig.h b/NetworkPkg/IScsiDxe/IScsiConfig.h
index 7fd18a0ae2f2..daa0d343828a 100644
--- a/NetworkPkg/IScsiDxe/IScsiConfig.h
+++ b/NetworkPkg/IScsiDxe/IScsiConfig.h
@@ -2,7 +2,7 @@
   The header file of functions for configuring or getting the parameters
   relating to iSCSI.
 
-Copyright (c) 2004 - 2011, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -78,7 +78,7 @@ struct _ISCSI_ATTEMPT_CONFIG_NVDATA {
   union {
     ISCSI_CHAP_AUTH_CONFIG_NVDATA  CHAP;
   } AuthConfigData;
-
+  BOOLEAN                          AutoConfigureSuccess;
 };
 
 ///
diff --git a/NetworkPkg/IScsiDxe/IScsiDriver.c b/NetworkPkg/IScsiDxe/IScsiDriver.c
index 5e5d700e4787..363daadc8f70 100644
--- a/NetworkPkg/IScsiDxe/IScsiDriver.c
+++ b/NetworkPkg/IScsiDxe/IScsiDriver.c
@@ -477,7 +477,7 @@ IScsiStart (
     // Don't process the autoconfigure path if it is already established.
     //
     if (AttemptConfigData->SessionConfigData.IpMode == IP_MODE_AUTOCONFIG &&
-        AttemptConfigData->AutoConfigureMode == IP_MODE_AUTOCONFIG_SUCCESS) {
+        AttemptConfigData->AutoConfigureSuccess) {
       continue;
     }
 
@@ -576,7 +576,7 @@ IScsiStart (
       // IScsi session success. Update the attempt state to NVR.
       //
       if (AttemptConfigData->SessionConfigData.IpMode == IP_MODE_AUTOCONFIG) {
-        AttemptConfigData->AutoConfigureMode = IP_MODE_AUTOCONFIG_SUCCESS;
+        AttemptConfigData->AutoConfigureSuccess = TRUE;
       }
 
       gRT->SetVariable (
diff --git a/NetworkPkg/IScsiDxe/IScsiDriver.h b/NetworkPkg/IScsiDxe/IScsiDriver.h
index 825394a1d29a..338e3dcf188b 100644
--- a/NetworkPkg/IScsiDxe/IScsiDriver.h
+++ b/NetworkPkg/IScsiDxe/IScsiDriver.h
@@ -1,7 +1,7 @@
 /** @file
   The header file of IScsiDriver.c.
 
-Copyright (c) 2004 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -29,7 +29,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #define IP_MODE_AUTOCONFIG_IP4     3
 #define IP_MODE_AUTOCONFIG_IP6     4
-#define IP_MODE_AUTOCONFIG_SUCCESS 5
 
 extern EFI_COMPONENT_NAME2_PROTOCOL       gIScsiComponentName2;
 extern EFI_COMPONENT_NAME_PROTOCOL        gIScsiComponentName;
diff --git a/NetworkPkg/IScsiDxe/IScsiMisc.c b/NetworkPkg/IScsiDxe/IScsiMisc.c
index f5c54e70188e..e7198d5ab04c 100644
--- a/NetworkPkg/IScsiDxe/IScsiMisc.c
+++ b/NetworkPkg/IScsiDxe/IScsiMisc.c
@@ -1054,7 +1054,7 @@ IScsiGetConfigData (
       // Check the autoconfig path to see whether it should be retried.
       //
       if (AttemptTmp->SessionConfigData.IpMode == IP_MODE_AUTOCONFIG &&
-          AttemptTmp->AutoConfigureMode != IP_MODE_AUTOCONFIG_SUCCESS) {
+          !AttemptTmp->AutoConfigureSuccess) {
         if (mPrivate->Ipv6Flag &&
             AttemptTmp->AutoConfigureMode == IP_MODE_AUTOCONFIG_IP6) {
           //
@@ -1197,6 +1197,7 @@ IScsiGetConfigData (
 
       AttemptConfigData->AutoConfigureMode =
         (UINT8) (mPrivate->Ipv6Flag ? IP_MODE_AUTOCONFIG_IP6 : IP_MODE_AUTOCONFIG_IP4);
+      AttemptConfigData->AutoConfigureSuccess = FALSE;
     }
     
     //

From 9228f69e2222ad78a5ba4e1f68446df8df6ee96e Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 25 Sep 2015 07:11:53 +0000
Subject: [PATCH 067/525] UefiCpuPkg/CpuMpPei: Add check on Processors number
 found

(Sync patch r18549 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18551 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index d5aee86d11e2..81d5b19fca0d 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -368,6 +368,7 @@ CountProcessorNumber (
   MicroSecondDelay (PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
   PeiCpuMpData->InitFlag  = 0;
   PeiCpuMpData->CpuCount += (UINT32) PeiCpuMpData->MpCpuExchangeInfo->NumApsExecuting;
+  ASSERT (PeiCpuMpData->CpuCount <= PcdGet32(PcdCpuMaxLogicalProcessorNumber));
   //
   // Sort BSP/Aps by CPU APIC ID in ascending order
   //

From 59fd15c5a2174a6a6fc4133964e6d5b520b58663 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 25 Sep 2015 07:12:21 +0000
Subject: [PATCH 068/525] UefiCpuPkg/CpuMpPei: Fix wrong CpuData pointer

CpuData buffer should be located in allocated buffer instead of at end of
WakeupBuffer.

(Sync patch r18550 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18552 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 81d5b19fca0d..d5bc0c9b806a 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -428,7 +428,8 @@ PrepareAPStartupVector (
 
   PeiCpuMpData->CpuCount                 = 1;
   PeiCpuMpData->BspNumber                = 0;
-  PeiCpuMpData->CpuData                  = (PEI_CPU_DATA *) (PeiCpuMpData->MpCpuExchangeInfo + 1);
+  PeiCpuMpData->CpuData                  = (PEI_CPU_DATA *) (PeiCpuMpData->BackupBuffer +
+                                                             PeiCpuMpData->BackupBufferSize);
   PeiCpuMpData->CpuData[0].ApicId        = GetInitialApicId ();
   PeiCpuMpData->CpuData[0].Health.Uint32 = 0;
   PeiCpuMpData->EndOfPeiFlag             = FALSE;

From af7fca3649779f0e55220a7acda9bd11bc660fc3 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Mon, 16 Nov 2015 05:29:49 +0000
Subject: [PATCH 069/525] Update BaseTools from main trunk r18767.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18784 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Bin/externals.txt                   |   2 +-
 BaseTools/BuildEnv                            |  66 ++++++--
 BaseTools/Conf/tools_def.template             |  22 ++-
 BaseTools/Scripts/SetVisualStudio.bat         |   2 +-
 BaseTools/Scripts/ShowEnvironment.bat         |   2 +
 BaseTools/Source/C/Common/PeCoffLoaderEx.c    |   2 +-
 BaseTools/Source/C/GenFw/Elf32Convert.c       |  42 +++--
 BaseTools/Source/C/GenFw/Elf64Convert.c       |  42 +++--
 BaseTools/Source/C/GenFw/GenFw.c              |  82 ++++++----
 BaseTools/Source/C/Split/Split.c              |  25 +--
 BaseTools/Source/C/VfrCompile/VfrSyntax.g     |  12 +-
 BaseTools/Source/Python/AutoGen/AutoGen.py    |  16 +-
 BaseTools/Source/Python/AutoGen/GenC.py       |  27 ++--
 BaseTools/Source/Python/AutoGen/GenMake.py    |   4 +-
 .../Source/Python/Common/EdkIIWorkspace.py    |   3 +-
 .../Source/Python/Common/FdfParserLite.py     |   6 +-
 .../Python/Common/LongFilePathOsPath.py       |   2 +
 BaseTools/Source/Python/Common/Misc.py        |   7 +-
 BaseTools/Source/Python/Common/String.py      |   8 +-
 BaseTools/Source/Python/Ecc/Check.py          |  18 +--
 BaseTools/Source/Python/Ecc/Ecc.py            |   8 +-
 BaseTools/Source/Python/Ecc/MetaDataParser.py |   5 +-
 BaseTools/Source/Python/Ecc/c.py              |  16 +-
 .../Source/Python/GenFds/FfsInfStatement.py   |   7 +-
 BaseTools/Source/Python/GenFds/GenFds.py      |  13 +-
 .../Python/GenFds/GenFdsGlobalVariable.py     |   4 +-
 BaseTools/Source/Python/GenFds/Region.py      |   3 +-
 BaseTools/Source/Python/Makefile              |   1 +
 .../UPT/Core/DistributionPackageClass.py      |  26 +--
 .../Source/Python/UPT/Core/PackageFile.py     |   8 +-
 .../Source/Python/UPT/Library/GlobalData.py   |   3 +-
 BaseTools/Source/Python/UPT/Library/Misc.py   |   7 +-
 .../Python/UPT/Library/ParserValidate.py      |   3 +-
 .../Source/Python/UPT/Library/Parsing.py      |  32 ++--
 BaseTools/Source/Python/UPT/MkPkg.py          |   7 +-
 .../Python/UPT/PomAdapter/InfPomAlignment.py  |   5 +-
 BaseTools/Source/Python/UPT/UPT.py            |   3 +-
 .../Source/Python/Workspace/MetaFileParser.py |  11 +-
 .../Python/Workspace/WorkspaceDatabase.py     |  31 +++-
 BaseTools/toolsetup.bat                       | 150 +++++++++++-------
 40 files changed, 453 insertions(+), 280 deletions(-)

diff --git a/BaseTools/Bin/externals.txt b/BaseTools/Bin/externals.txt
index f47774936432..c2c4ab729732 100644
--- a/BaseTools/Bin/externals.txt
+++ b/BaseTools/Bin/externals.txt
@@ -1 +1 @@
-Win32  -r92 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
+Win32  https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
diff --git a/BaseTools/BuildEnv b/BaseTools/BuildEnv
index 6a1281b96b2a..7c77454bf88b 100755
--- a/BaseTools/BuildEnv
+++ b/BaseTools/BuildEnv
@@ -2,7 +2,7 @@
 # Setup the environment for unix-like systems running a bash-like shell.
 # This file must be "sourced" not merely executed. For example: ". edksetup.sh"
 #
-# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -35,11 +35,28 @@ RestorePreviousConfiguration() {
   #
   # Restore previous configuration
   #
-  PREVIOUS_CONF_FILE=Conf/BuildEnv.sh
+  if [ -z "$CONF_PATH" ]
+  then
+    export CONF_PATH=$WORKSPACE/Conf
+    if [ ! -d $WORKSPACE/Conf ] && [ -n "$PACKAGES_PATH" ]
+    then
+      PACKAGES_PATH=${PACKAGES_PATH//:/ }
+      for DIR in $PACKAGES_PATH
+      do
+        if [ -d $DIR/Conf ]
+        then
+          export CONF_PATH=$DIR/Conf
+          break
+        fi
+      done
+    fi
+  fi
+  
+  PREVIOUS_CONF_FILE=$CONF_PATH/BuildEnv.sh
   if [ -e $PREVIOUS_CONF_FILE ]
   then
-    echo Loading previous configuration from \$WORKSPACE/$PREVIOUS_CONF_FILE
-    . $WORKSPACE/$PREVIOUS_CONF_FILE
+    echo Loading previous configuration from $PREVIOUS_CONF_FILE
+    . $PREVIOUS_CONF_FILE
   fi
 }
 
@@ -70,9 +87,8 @@ StoreCurrentConfiguration() {
   # Write configuration to a shell script to allow for configuration to be
   # easily reloaded.
   #
-  OUTPUT_FILE=Conf/BuildEnv.sh
-  #echo Storing current configuration into \$WORKSPACE/$OUTPUT_FILE
-  OUTPUT_FILE=$WORKSPACE/$OUTPUT_FILE
+  OUTPUT_FILE=$CONF_PATH/BuildEnv.sh
+  #echo Storing current configuration into $OUTPUT_FILE
   echo "# Auto-generated by ${BASH_SOURCE[0]}" > $OUTPUT_FILE
   GenerateShellCodeToSetVariable WORKSPACE $OUTPUT_FILE
   GenerateShellCodeToSetVariable EDK_TOOLS_PATH $OUTPUT_FILE
@@ -90,20 +106,20 @@ SetEdkToolsPath() {
   fi
 
   #
-  # Try $WORKSPACE/Conf/EdkTools
+  # Try $CONF_PATH/EdkTools
   #
-  if [ -e $WORKSPACE/Conf/EdkTools ]
+  if [ -e $CONF_PATH/EdkTools ]
   then
-    export EDK_TOOLS_PATH=$WORKSPACE/Conf/EdkTools
+    export EDK_TOOLS_PATH=$CONF_PATH/EdkTools
     return 0
   fi
 
   #
-  # Try $WORKSPACE/Conf/BaseToolsSource
+  # Try $CONF_PATH/BaseToolsSource
   #
-  if [ -e $WORKSPACE/Conf/BaseToolsSource ]
+  if [ -e $CONF_PATH/BaseToolsSource ]
   then
-    export EDK_TOOLS_PATH=$WORKSPACE/Conf/BaseToolsSource
+    export EDK_TOOLS_PATH=$CONF_PATH/BaseToolsSource
     return 0
   fi
 
@@ -116,6 +132,22 @@ SetEdkToolsPath() {
     return 0
   fi
 
+  #
+  # Try $PACKAGES_PATH
+  #
+  if [ -n "$PACKAGES_PATH"]
+  then
+    PACKAGES_PATH=${PACKAGES_PATH//:/ }
+    for DIR in $PACKAGES_PATH
+    do
+      if [ -d $DIR/BaseTools ]
+      then
+        export EDK_TOOLS_PATH=$DIR/BaseTools
+        return 0
+      fi
+    done
+  fi
+
   echo "Unable to determine EDK_TOOLS_PATH"
   echo
   echo "You may need to download the 'BaseTools' from buildtools.tianocore.org."
@@ -179,17 +211,16 @@ AddEdkToolsToPath() {
 CopySingleTemplateFile() {
 
   SRC_FILENAME=Conf/$1.template
-  DST_FILENAME=Conf/$1.txt
+  DST_FILENAME=$CONF_PATH/$1.txt
 
-  if [ -e $WORKSPACE/$DST_FILENAME ]
+  if [ -e $DST_FILENAME ]
   then
     return
   fi
 
   echo "Copying \$EDK_TOOLS_PATH/$SRC_FILENAME"
-  echo "     to \$WORKSPACE/$DST_FILENAME"
+  echo "     to $DST_FILENAME"
   SRC_FILENAME=$EDK_TOOLS_PATH/$SRC_FILENAME
-  DST_FILENAME=$WORKSPACE/$DST_FILENAME
   cp $SRC_FILENAME $DST_FILENAME
 
 }
@@ -230,6 +261,7 @@ ScriptMain() {
 
   echo WORKSPACE: $WORKSPACE
   echo EDK_TOOLS_PATH: $EDK_TOOLS_PATH
+  echo CONF_PATH: $CONF_PATH
 
   CopyTemplateFiles
 
diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index aa2b6b1488c4..db08e252d2b9 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -3812,12 +3812,12 @@ DEFINE GCC_IA32_CC_FLAGS           = DEF(GCC_ALL_CC_FLAGS) -m32 -malign-double -
 DEFINE GCC_X64_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mno-red-zone -Wno-address -mno-stack-arg-probe
 DEFINE GCC_IPF_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -minline-int-divide-min-latency
 DEFINE GCC_ARM_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mword-relocations -mlittle-endian -mabi=aapcs -mapcs -fno-short-enums -save-temps -fsigned-char -ffunction-sections -fdata-sections -fomit-frame-pointer -Wno-address -mthumb -mfloat-abi=soft
-DEFINE GCC_AARCH64_CC_FLAGS        = DEF(GCC_ALL_CC_FLAGS) -mcmodel=tiny -mlittle-endian -fno-short-enums -save-temps -fverbose-asm -fsigned-char  -ffunction-sections -fdata-sections -fomit-frame-pointer -fno-builtin -Wno-address -fno-asynchronous-unwind-tables
+DEFINE GCC_AARCH64_CC_FLAGS        = DEF(GCC_ALL_CC_FLAGS) -mlittle-endian -fno-short-enums -save-temps -fverbose-asm -fsigned-char  -ffunction-sections -fdata-sections -fomit-frame-pointer -fno-builtin -Wno-address -fno-asynchronous-unwind-tables
 DEFINE GCC_DLINK_FLAGS_COMMON      = -nostdlib --pie
 DEFINE GCC_DLINK2_FLAGS_COMMON     = --script=$(EDK_TOOLS_PATH)/Scripts/GccBase.lds
 DEFINE GCC_IA32_X64_DLINK_COMMON   = DEF(GCC_DLINK_FLAGS_COMMON) --gc-sections
 DEFINE GCC_ARM_AARCH64_DLINK_COMMON= --emit-relocs -nostdlib --gc-sections -u $(IMAGE_ENTRY_POINT) -e $(IMAGE_ENTRY_POINT) -Map $(DEST_DIR_DEBUG)/$(BASE_NAME).map
-DEFINE GCC_ARM_DLINK_FLAGS         = DEF(GCC_ARM_AARCH64_DLINK_COMMON) -Ttext=0x0
+DEFINE GCC_ARM_DLINK_FLAGS         = DEF(GCC_ARM_AARCH64_DLINK_COMMON) -z common-page-size=0x20
 DEFINE GCC_AARCH64_DLINK_FLAGS     = DEF(GCC_ARM_AARCH64_DLINK_COMMON) -z common-page-size=0x20
 DEFINE GCC_IA32_X64_ASLDLINK_FLAGS = DEF(GCC_IA32_X64_DLINK_COMMON) --entry _ReferenceAcpiTable -u $(IMAGE_ENTRY_POINT)
 DEFINE GCC_ARM_ASLDLINK_FLAGS      = DEF(GCC_ARM_DLINK_FLAGS) --entry ReferenceAcpiTable -u $(IMAGE_ENTRY_POINT)
@@ -3844,9 +3844,9 @@ DEFINE GCC44_X64_CC_FLAGS            = DEF(GCC44_ALL_CC_FLAGS) -m64 -fno-stack-p
 DEFINE GCC44_IA32_X64_DLINK_COMMON   = -nostdlib -n -q --gc-sections -z common-page-size=0x20
 DEFINE GCC44_IA32_X64_ASLDLINK_FLAGS = DEF(GCC44_IA32_X64_DLINK_COMMON) --entry ReferenceAcpiTable -u ReferenceAcpiTable
 DEFINE GCC44_IA32_X64_DLINK_FLAGS    = DEF(GCC44_IA32_X64_DLINK_COMMON) --entry $(IMAGE_ENTRY_POINT) -u $(IMAGE_ENTRY_POINT) -Map $(DEST_DIR_DEBUG)/$(BASE_NAME).map
-DEFINE GCC44_IA32_DLINK2_FLAGS       = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
+DEFINE GCC44_IA32_DLINK2_FLAGS       = --defsym=PECOFF_HEADER_SIZE=0x220 DEF(GCC_DLINK2_FLAGS_COMMON)
 DEFINE GCC44_X64_DLINK_FLAGS         = DEF(GCC44_IA32_X64_DLINK_FLAGS)  -melf_x86_64 --oformat=elf64-x86-64
-DEFINE GCC44_X64_DLINK2_FLAGS        = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x228
+DEFINE GCC44_X64_DLINK2_FLAGS        = --defsym=PECOFF_HEADER_SIZE=0x228 DEF(GCC_DLINK2_FLAGS_COMMON)
 DEFINE GCC44_ASM_FLAGS               = DEF(GCC_ASM_FLAGS)
 
 DEFINE GCC45_IA32_CC_FLAGS           = DEF(GCC44_IA32_CC_FLAGS)
@@ -3871,6 +3871,7 @@ DEFINE GCC46_ASM_FLAGS               = DEF(GCC45_ASM_FLAGS)
 DEFINE GCC46_ARM_ASM_FLAGS           = $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_ASM_FLAGS) -mlittle-endian
 DEFINE GCC46_ARM_CC_FLAGS            = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) DEF(GCC_ARM_CC_FLAGS) -fstack-protector
 DEFINE GCC46_ARM_DLINK_FLAGS         = DEF(GCC_ARM_DLINK_FLAGS) --oformat=elf32-littlearm
+DEFINE GCC46_ARM_DLINK2_FLAGS        = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
 DEFINE GCC46_ARM_ASLDLINK_FLAGS      = DEF(GCC_ARM_ASLDLINK_FLAGS) --oformat=elf32-littlearm
 
 DEFINE GCC47_IA32_CC_FLAGS           = DEF(GCC46_IA32_CC_FLAGS)
@@ -3885,8 +3886,9 @@ DEFINE GCC47_ASM_FLAGS               = DEF(GCC46_ASM_FLAGS)
 DEFINE GCC47_ARM_ASM_FLAGS           = DEF(GCC46_ARM_ASM_FLAGS)
 DEFINE GCC47_AARCH64_ASM_FLAGS       = $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_ASM_FLAGS) -mlittle-endian
 DEFINE GCC47_ARM_CC_FLAGS            = DEF(GCC46_ARM_CC_FLAGS) -mno-unaligned-access
-DEFINE GCC47_AARCH64_CC_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) DEF(GCC_AARCH64_CC_FLAGS)
+DEFINE GCC47_AARCH64_CC_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) -mcmodel=large DEF(GCC_AARCH64_CC_FLAGS)
 DEFINE GCC47_ARM_DLINK_FLAGS         = DEF(GCC46_ARM_DLINK_FLAGS)
+DEFINE GCC47_ARM_DLINK2_FLAGS        = DEF(GCC46_ARM_DLINK2_FLAGS)
 DEFINE GCC47_AARCH64_DLINK_FLAGS     = DEF(GCC_AARCH64_DLINK_FLAGS)
 DEFINE GCC47_AARCH64_DLINK2_FLAGS    = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x228
 DEFINE GCC47_ARM_ASLDLINK_FLAGS      = DEF(GCC46_ARM_ASLDLINK_FLAGS)
@@ -3906,6 +3908,7 @@ DEFINE GCC48_AARCH64_ASM_FLAGS       = DEF(GCC47_AARCH64_ASM_FLAGS)
 DEFINE GCC48_ARM_CC_FLAGS            = DEF(GCC47_ARM_CC_FLAGS)
 DEFINE GCC48_AARCH64_CC_FLAGS        = DEF(GCC47_AARCH64_CC_FLAGS)
 DEFINE GCC48_ARM_DLINK_FLAGS         = DEF(GCC47_ARM_DLINK_FLAGS)
+DEFINE GCC48_ARM_DLINK2_FLAGS        = DEF(GCC47_ARM_DLINK2_FLAGS)
 DEFINE GCC48_AARCH64_DLINK_FLAGS     = DEF(GCC47_AARCH64_DLINK_FLAGS)
 DEFINE GCC48_AARCH64_DLINK2_FLAGS    = DEF(GCC47_AARCH64_DLINK2_FLAGS)
 DEFINE GCC48_ARM_ASLDLINK_FLAGS      = DEF(GCC47_ARM_ASLDLINK_FLAGS)
@@ -3923,8 +3926,9 @@ DEFINE GCC49_ASM_FLAGS               = DEF(GCC48_ASM_FLAGS)
 DEFINE GCC49_ARM_ASM_FLAGS           = DEF(GCC48_ARM_ASM_FLAGS)
 DEFINE GCC49_AARCH64_ASM_FLAGS       = DEF(GCC48_AARCH64_ASM_FLAGS)
 DEFINE GCC49_ARM_CC_FLAGS            = DEF(GCC48_ARM_CC_FLAGS)
-DEFINE GCC49_AARCH64_CC_FLAGS        = DEF(GCC48_AARCH64_CC_FLAGS)
+DEFINE GCC49_AARCH64_CC_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) -mcmodel=tiny DEF(GCC_AARCH64_CC_FLAGS)
 DEFINE GCC49_ARM_DLINK_FLAGS         = DEF(GCC48_ARM_DLINK_FLAGS)
+DEFINE GCC49_ARM_DLINK2_FLAGS        = DEF(GCC48_ARM_DLINK2_FLAGS)
 DEFINE GCC49_AARCH64_DLINK_FLAGS     = DEF(GCC48_AARCH64_DLINK_FLAGS)
 DEFINE GCC49_AARCH64_DLINK2_FLAGS    = DEF(GCC48_AARCH64_DLINK2_FLAGS)
 DEFINE GCC49_ARM_ASLDLINK_FLAGS      = DEF(GCC48_ARM_ASLDLINK_FLAGS)
@@ -4250,6 +4254,7 @@ DEFINE GCC49_AARCH64_ASLDLINK_FLAGS  = DEF(GCC48_AARCH64_ASLDLINK_FLAGS)
 *_GCC46_ARM_ASLDLINK_FLAGS       = DEF(GCC46_ARM_ASLDLINK_FLAGS)
 *_GCC46_ARM_ASM_FLAGS            = DEF(GCC46_ARM_ASM_FLAGS)
 *_GCC46_ARM_DLINK_FLAGS          = DEF(GCC46_ARM_DLINK_FLAGS)
+*_GCC46_ARM_DLINK2_FLAGS         = DEF(GCC46_ARM_DLINK2_FLAGS)
 *_GCC46_ARM_PLATFORM_FLAGS       = -march=armv7-a
 *_GCC46_ARM_PP_FLAGS             = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC46_ARM_RC_FLAGS             = DEF(GCC_ARM_RC_FLAGS)
@@ -4349,6 +4354,7 @@ RELEASE_GCC46_ARM_CC_FLAGS       = DEF(GCC46_ARM_CC_FLAGS) -D__ARM_FEATURE_UNALI
 *_GCC47_ARM_ASLDLINK_FLAGS       = DEF(GCC47_ARM_ASLDLINK_FLAGS)
 *_GCC47_ARM_ASM_FLAGS            = DEF(GCC47_ARM_ASM_FLAGS)
 *_GCC47_ARM_DLINK_FLAGS          = DEF(GCC47_ARM_DLINK_FLAGS)
+*_GCC47_ARM_DLINK2_FLAGS         = DEF(GCC47_ARM_DLINK2_FLAGS)
 *_GCC47_ARM_PLATFORM_FLAGS       = -march=armv7-a
 *_GCC47_ARM_PP_FLAGS             = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC47_ARM_RC_FLAGS             = DEF(GCC_ARM_RC_FLAGS)
@@ -4475,6 +4481,7 @@ RELEASE_GCC47_AARCH64_CC_FLAGS   = DEF(GCC47_AARCH64_CC_FLAGS) -Wno-unused-but-s
 *_GCC48_ARM_ASLDLINK_FLAGS       = DEF(GCC48_ARM_ASLDLINK_FLAGS)
 *_GCC48_ARM_ASM_FLAGS            = DEF(GCC48_ARM_ASM_FLAGS)
 *_GCC48_ARM_DLINK_FLAGS          = DEF(GCC48_ARM_DLINK_FLAGS)
+*_GCC48_ARM_DLINK2_FLAGS         = DEF(GCC48_ARM_DLINK2_FLAGS)
 *_GCC48_ARM_PLATFORM_FLAGS       = -march=armv7-a
 *_GCC48_ARM_PP_FLAGS             = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC48_ARM_RC_FLAGS             = DEF(GCC_ARM_RC_FLAGS)
@@ -4601,6 +4608,7 @@ RELEASE_GCC48_AARCH64_CC_FLAGS   = DEF(GCC48_AARCH64_CC_FLAGS) -Wno-unused-but-s
 *_GCC49_ARM_ASLDLINK_FLAGS       = DEF(GCC49_ARM_ASLDLINK_FLAGS)
 *_GCC49_ARM_ASM_FLAGS            = DEF(GCC49_ARM_ASM_FLAGS)
 *_GCC49_ARM_DLINK_FLAGS          = DEF(GCC49_ARM_DLINK_FLAGS)
+*_GCC49_ARM_DLINK2_FLAGS         = DEF(GCC49_ARM_DLINK2_FLAGS)
 *_GCC49_ARM_PLATFORM_FLAGS       = -march=armv7-a
 *_GCC49_ARM_PP_FLAGS             = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC49_ARM_RC_FLAGS             = DEF(GCC_ARM_RC_FLAGS)
@@ -6609,7 +6617,7 @@ RELEASE_XCODE5_X64_CC_FLAGS   = -target x86_64-pc-win32-macho -c    -Os       -W
 
 DEFINE RVCT_ALL_ASM_FLAGS   = --diag_suppress=1786 --diag_error=warning --apcs /interwork
 DEFINE RVCT_ALL_CC_FLAGS    = --c90 -c --no_autoinline --asm --gnu --apcs /interwork --signed_chars --no_unaligned_access --split_sections --enum_is_int --preinclude AutoGen.h --diag_suppress=186 --diag_warning 167 --diag_error=warning --diag_style=ide --protect_stack
-DEFINE RVCT_ALL_DLINK_FLAGS = --ro-base 0 --no_scanlib --reloc --no_exceptions --datacompressor off --strict --symbols --diag_style=ide
+DEFINE RVCT_ALL_DLINK_FLAGS = --ro-base 0 --no_scanlib --reloc --no_exceptions --datacompressor off --strict --symbols --diag_style=ide --no_legacyalign
 
 ####################################################################################
 #
diff --git a/BaseTools/Scripts/SetVisualStudio.bat b/BaseTools/Scripts/SetVisualStudio.bat
index a302a835969f..d379cd73dff4 100755
--- a/BaseTools/Scripts/SetVisualStudio.bat
+++ b/BaseTools/Scripts/SetVisualStudio.bat
@@ -68,7 +68,7 @@ if not exist "%COMMONTOOLSx64%\vcvarsx86_amd64.bat" (
 @goto End
 
 :RebuildTools
-@call python "%WORKSPACE%\BaseTools\Scripts\UpdateBuildVersions.py"
+@call python "%BASE_TOOLS_PATH%\Scripts\UpdateBuildVersions.py"
 @set "BIN_DIR=%EDK_TOOLS_PATH%\Bin\Win32"
 if not exist "%BIN_DIR%" @mkdir "%BIN_DIR%"
 @echo Removing temporary and binary files
diff --git a/BaseTools/Scripts/ShowEnvironment.bat b/BaseTools/Scripts/ShowEnvironment.bat
index c4613e11708f..2b320fbc2152 100755
--- a/BaseTools/Scripts/ShowEnvironment.bat
+++ b/BaseTools/Scripts/ShowEnvironment.bat
@@ -47,9 +47,11 @@ if defined SRC_CONF @goto SetEnv
 @echo #############################################################################
 @if defined WORKSPACE @echo     WORKSPACE            = %WORKSPACE%
 @if not defined WORKSPACE @echo     WORKSPACE            = Not Set
+@if defined PACKAGES_PATH @echo     PACKAGES_PATH        = %PACKAGES_PATH%
 @if defined EDK_TOOLS_PATH @echo     EDK_TOOLS_PATH       = %EDK_TOOLS_PATH%
 @if not defined EDK_TOOLS_PATH @echo     EDK_TOOLS_PATH       = Not Set
 @if defined BASE_TOOLS_PATH @echo     BASE_TOOLS_PATH      = %BASE_TOOLS_PATH%
+@if defined EDK_TOOLS_BIN @echo     EDK_TOOLS_BIN        = %EDK_TOOLS_BIN%
 @if defined PYTHON_FREEZER_PATH @echo     PYTHON_FREEZER_PATH  = %PYTHON_FREEZER_PATH%
 @if "%NT32PKG%"=="TRUE" (
     @echo.
diff --git a/BaseTools/Source/C/Common/PeCoffLoaderEx.c b/BaseTools/Source/C/Common/PeCoffLoaderEx.c
index 382138a8937e..d04fa7d5ba2d 100644
--- a/BaseTools/Source/C/Common/PeCoffLoaderEx.c
+++ b/BaseTools/Source/C/Common/PeCoffLoaderEx.c
@@ -402,8 +402,8 @@ PeCoffLoaderRelocateArmImage (
     
     if (*FixupData != NULL) {
       *FixupData = ALIGN_POINTER(*FixupData, sizeof(UINT64));
-      *(UINT64 *)(*FixupData) = *Fixup16;
       CopyMem (*FixupData, Fixup16, sizeof (UINT64));
+      *FixupData = *FixupData + sizeof(UINT64);
     }
     break;
   
diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index e1b92ebd713e..a7b077873b40 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -218,6 +218,15 @@ CoffAlign (
   return (Offset + mCoffAlignment - 1) & ~(mCoffAlignment - 1);
 }
 
+STATIC
+UINT32
+DebugRvaAlign (
+  UINT32 Offset
+  )
+{
+  return (Offset + 3) & ~3;
+}
+
 //
 // filter functions
 //
@@ -331,12 +340,8 @@ ScanSections32 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1);
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
 
@@ -365,11 +370,8 @@ ScanSections32 (
     assert (FALSE);
   }
 
-  mDebugOffset = mCoffOffset;
-
-  if (mEhdr->e_machine != EM_ARM) {
-    mCoffOffset = CoffAlign(mCoffOffset);
-  }
+  mDebugOffset = DebugRvaAlign(mCoffOffset);
+  mCoffOffset = CoffAlign(mCoffOffset);
 
   if (SectionCount > 1 && mOutImageType == FW_EFI_IMAGE) {
     Warning (NULL, 0, 0, NULL, "Mulitple sections in %s are merged into 1 text section. Source level debug might not work correctly.", mInImageName);
@@ -389,12 +391,8 @@ ScanSections32 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1);
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
 
@@ -423,7 +421,7 @@ ScanSections32 (
   // section alignment.
   //
   if (SectionCount > 0) {
-    mDebugOffset = mCoffOffset;
+    mDebugOffset = DebugRvaAlign(mCoffOffset);
   }
   mCoffOffset = mDebugOffset + sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY) +
                 sizeof(EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY) +
@@ -446,12 +444,8 @@ ScanSections32 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1);
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
       if (shdr->sh_size != 0) {
diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index c758ed9d64a6..90d80a22daf2 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -211,6 +211,15 @@ CoffAlign (
   return (Offset + mCoffAlignment - 1) & ~(mCoffAlignment - 1);
 }
 
+STATIC
+UINT32
+DebugRvaAlign (
+  UINT32 Offset
+  )
+{
+  return (Offset + 3) & ~3;
+}
+
 //
 // filter functions
 //
@@ -325,12 +334,8 @@ ScanSections64 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (UINT32) ((mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1));
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
 
@@ -359,11 +364,8 @@ ScanSections64 (
     assert (FALSE);
   }
 
-  mDebugOffset = mCoffOffset;
-
-  if (mEhdr->e_machine != EM_ARM) {
-    mCoffOffset = CoffAlign(mCoffOffset);
-  }
+  mDebugOffset = DebugRvaAlign(mCoffOffset);
+  mCoffOffset = CoffAlign(mCoffOffset);
 
   if (SectionCount > 1 && mOutImageType == FW_EFI_IMAGE) {
     Warning (NULL, 0, 0, NULL, "Mulitple sections in %s are merged into 1 text section. Source level debug might not work correctly.", mInImageName);
@@ -383,12 +385,8 @@ ScanSections64 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (UINT32) ((mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1));
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
 
@@ -412,7 +410,7 @@ ScanSections64 (
   // section alignment.
   //
   if (SectionCount > 0) {
-    mDebugOffset = mCoffOffset;
+    mDebugOffset = DebugRvaAlign(mCoffOffset);
   }
   mCoffOffset = mDebugOffset + sizeof(EFI_IMAGE_DEBUG_DIRECTORY_ENTRY) +
                 sizeof(EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY) +
@@ -439,12 +437,8 @@ ScanSections64 (
         if ((shdr->sh_addr & (shdr->sh_addralign - 1)) == 0) {
           // if the section address is aligned we must align PE/COFF
           mCoffOffset = (UINT32) ((mCoffOffset + shdr->sh_addralign - 1) & ~(shdr->sh_addralign - 1));
-        } else if ((shdr->sh_addr % shdr->sh_addralign) != (mCoffOffset % shdr->sh_addralign)) {
-          // ARM RVCT tools have behavior outside of the ELF specification to try
-          // and make images smaller.  If sh_addr is not aligned to sh_addralign
-          // then the section needs to preserve sh_addr MOD sh_addralign.
-          // Normally doing nothing here works great.
-          Error (NULL, 0, 3000, "Invalid", "Unsupported section alignment.");
+        } else {
+          Error (NULL, 0, 3000, "Invalid", "Section address not aligned to its own alignment.");
         }
       }
       if (shdr->sh_size != 0) {
diff --git a/BaseTools/Source/C/GenFw/GenFw.c b/BaseTools/Source/C/GenFw/GenFw.c
index 4756c5276261..9ddd18e294a0 100644
--- a/BaseTools/Source/C/GenFw/GenFw.c
+++ b/BaseTools/Source/C/GenFw/GenFw.c
@@ -1,7 +1,7 @@
 /** @file
 Converts a pe32+ image to an FW, Te image type, or other specific image.
 
-Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -168,7 +168,7 @@ Routine Description:
   //
   // Copyright declaration
   //
-  fprintf (stdout, "Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.\n\n");
+  fprintf (stdout, "Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.\n\n");
 
   //
   // Details Option
@@ -184,9 +184,9 @@ Routine Description:
                         PIC_PEIM, RELOCATABLE_PEIM, BS_DRIVER, RT_DRIVER,\n\
                         APPLICATION, SAL_RT_DRIVER to support all module types\n\
                         It can only be used together with --keepexceptiontable,\n\
-                        --keepzeropending, -r, -o option.It is a action option.\n\
-                        If it is combined with other action options, the later\n\
-                        input action option will override the previous one.\n");
+                        --keepzeropending, --keepoptionalheader, -r, -o option.\n\
+                        It is a action option. If it is combined with other action options,\n\
+                        the later input action option will override the previous one.\n");
   fprintf (stdout, "  -c, --acpi            Create Acpi table.\n\
                         It can't be combined with other action options\n\
                         except for -o, -r option. It is a action option.\n\
@@ -194,9 +194,9 @@ Routine Description:
                         input action option will override the previous one.\n");
   fprintf (stdout, "  -t, --terse           Create Te Image.\n\
                         It can only be used together with --keepexceptiontable,\n\
-                        --keepzeropending, -r, -o option.It is a action option.\n\
-                        If it is combined with other action options, the later\n\
-                        input action option will override the previous one.\n");
+                        --keepzeropending, --keepoptionalheader, -r, -o option.\n\
+                        It is a action option. If it is combined with other action options,\n\
+                        the later input action option will override the previous one.\n");
   fprintf (stdout, "  -u, --dump            Dump TeImage Header.\n\
                         It can't be combined with other action options\n\
                         except for -o, -r option. It is a action option.\n\
@@ -246,6 +246,9 @@ Routine Description:
   fprintf (stdout, "  --keepexceptiontable  Don't clear exception table.\n\
                         This option can be used together with -e or -t.\n\
                         It doesn't work for other options.\n");
+  fprintf (stdout, "  --keepoptionalheader  Don't zero PE/COFF optional header fields.\n\
+                        This option can be used together with -e or -t.\n\
+                        It doesn't work for other options.\n");
   fprintf (stdout, "  --keepzeropending     Don't strip zero pending of .reloc.\n\
                         This option can be used together with -e or -t.\n\
                         It doesn't work for other options.\n");
@@ -1079,6 +1082,7 @@ Routine Description:
   STATUS                           Status;
   BOOLEAN                          ReplaceFlag;
   BOOLEAN                          KeepExceptionTableFlag;
+  BOOLEAN                          KeepOptionalHeaderFlag;
   BOOLEAN                          KeepZeroPendingFlag;
   UINT64                           LogLevel;
   EFI_TE_IMAGE_HEADER              TEImageHeader;
@@ -1141,6 +1145,7 @@ Routine Description:
   Optional32        = NULL;
   Optional64        = NULL;
   KeepExceptionTableFlag = FALSE;
+  KeepOptionalHeaderFlag = FALSE;
   KeepZeroPendingFlag    = FALSE;
   NumberOfFormPacakge    = 0;
   HiiPackageListBuffer   = NULL;
@@ -1269,6 +1274,13 @@ Routine Description:
       continue;
     }
 
+    if (stricmp(argv[0], "--keepoptionalheader") == 0) {
+      KeepOptionalHeaderFlag = TRUE;
+      argc--;
+      argv++;
+      continue;
+    }
+
     if (stricmp (argv[0], "--keepzeropending") == 0) {
       KeepZeroPendingFlag = TRUE;
       argc --;
@@ -2303,19 +2315,20 @@ Routine Description:
 
   if (PeHdr->Pe32.OptionalHeader.Magic == EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC) {
     Optional32 = (EFI_IMAGE_OPTIONAL_HEADER32 *)&PeHdr->Pe32.OptionalHeader;
-    Optional32->MajorOperatingSystemVersion = 0;
-    Optional32->MinorOperatingSystemVersion = 0;
-    Optional32->MajorImageVersion           = 0;
-    Optional32->MinorImageVersion           = 0;
-    Optional32->MajorSubsystemVersion       = 0;
-    Optional32->MinorSubsystemVersion       = 0;
-    Optional32->Win32VersionValue           = 0;
-    Optional32->CheckSum                    = 0;
-    Optional32->SizeOfStackReserve = 0;
-    Optional32->SizeOfStackCommit  = 0;
-    Optional32->SizeOfHeapReserve  = 0;
-    Optional32->SizeOfHeapCommit   = 0;
-
+    if (!KeepOptionalHeaderFlag) {
+      Optional32->MajorOperatingSystemVersion = 0;
+      Optional32->MinorOperatingSystemVersion = 0;
+      Optional32->MajorImageVersion = 0;
+      Optional32->MinorImageVersion = 0;
+      Optional32->MajorSubsystemVersion = 0;
+      Optional32->MinorSubsystemVersion = 0;
+      Optional32->Win32VersionValue = 0;
+      Optional32->CheckSum = 0;
+      Optional32->SizeOfStackReserve = 0;
+      Optional32->SizeOfStackCommit = 0;
+      Optional32->SizeOfHeapReserve = 0;
+      Optional32->SizeOfHeapCommit = 0;
+    }
     TEImageHeader.AddressOfEntryPoint = Optional32->AddressOfEntryPoint;
     TEImageHeader.BaseOfCode          = Optional32->BaseOfCode;
     TEImageHeader.ImageBase           = (UINT64) (Optional32->ImageBase);
@@ -2395,19 +2408,20 @@ Routine Description:
     }
   } else if (PeHdr->Pe32.OptionalHeader.Magic == EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC) {
     Optional64 = (EFI_IMAGE_OPTIONAL_HEADER64 *)&PeHdr->Pe32.OptionalHeader;
-    Optional64->MajorOperatingSystemVersion = 0;
-    Optional64->MinorOperatingSystemVersion = 0;
-    Optional64->MajorImageVersion           = 0;
-    Optional64->MinorImageVersion           = 0;
-    Optional64->MajorSubsystemVersion       = 0;
-    Optional64->MinorSubsystemVersion       = 0;
-    Optional64->Win32VersionValue           = 0;
-    Optional64->CheckSum                    = 0;
-    Optional64->SizeOfStackReserve = 0;
-    Optional64->SizeOfStackCommit  = 0;
-    Optional64->SizeOfHeapReserve  = 0;
-    Optional64->SizeOfHeapCommit   = 0;
-
+    if (!KeepOptionalHeaderFlag) {
+      Optional64->MajorOperatingSystemVersion = 0;
+      Optional64->MinorOperatingSystemVersion = 0;
+      Optional64->MajorImageVersion = 0;
+      Optional64->MinorImageVersion = 0;
+      Optional64->MajorSubsystemVersion = 0;
+      Optional64->MinorSubsystemVersion = 0;
+      Optional64->Win32VersionValue = 0;
+      Optional64->CheckSum = 0;
+      Optional64->SizeOfStackReserve = 0;
+      Optional64->SizeOfStackCommit = 0;
+      Optional64->SizeOfHeapReserve = 0;
+      Optional64->SizeOfHeapCommit = 0;
+    }
     TEImageHeader.AddressOfEntryPoint = Optional64->AddressOfEntryPoint;
     TEImageHeader.BaseOfCode          = Optional64->BaseOfCode;
     TEImageHeader.ImageBase           = (UINT64) (Optional64->ImageBase);
diff --git a/BaseTools/Source/C/Split/Split.c b/BaseTools/Source/C/Split/Split.c
index b63aef78f9a2..44a09681d36a 100644
--- a/BaseTools/Source/C/Split/Split.c
+++ b/BaseTools/Source/C/Split/Split.c
@@ -2,7 +2,7 @@
 
   Split a file into two pieces at the request offset.
 
-Copyright (c) 1999 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed and made available
 under the terms and conditions of the BSD License which accompanies this
 distribution.  The full text of the license may be found at
@@ -58,7 +58,7 @@ Routine Description:
 --*/
 {
   printf ("%s Version %d.%d %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
-  printf ("Copyright (c) 1999-2014 Intel Corporation. All rights reserved.\n");
+  printf ("Copyright (c) 1999-2015 Intel Corporation. All rights reserved.\n");
   printf ("\n  SplitFile creates two Binary files either in the same directory as the current working\n");
   printf ("  directory or in the specified directory.\n");
 }
@@ -176,20 +176,25 @@ CreateDir (
 {
   CHAR8* temp = *FullFileName;
   CHAR8* start = temp;
+  CHAR8  tempchar;
   UINT64 index = 0;
 
   for (;index < strlen(temp); ++index) {
     if (temp[index] == '\\' || temp[index] == '/') {
-      temp[index] = 0;
-      if (chdir(start)) {
-        if (mkdir(start, S_IRWXU | S_IRWXG | S_IRWXO) != 0) {
-          return EFI_ABORTED;
+      if (temp[index + 1] != '\0') {
+        tempchar = temp[index + 1];
+        temp[index + 1] = 0;
+        if (chdir(start)) {
+          if (mkdir(start, S_IRWXU | S_IRWXG | S_IRWXO) != 0) {
+            return EFI_ABORTED;
+          }
+          chdir(start);
         }
-        chdir(start);
+        start = temp + index + 1;
+        temp[index] = '/';
+        temp[index + 1] = tempchar;
+      }
     }
-      start = temp + index + 1;
-      temp[index] = '/';
-  }
   }
 
   return EFI_SUCCESS;
diff --git a/BaseTools/Source/C/VfrCompile/VfrSyntax.g b/BaseTools/Source/C/VfrCompile/VfrSyntax.g
index ad839b2ab66e..d74fec8815c1 100644
--- a/BaseTools/Source/C/VfrCompile/VfrSyntax.g
+++ b/BaseTools/Source/C/VfrCompile/VfrSyntax.g
@@ -3258,7 +3258,7 @@ vfrStatementInconsistentIf :
   Prompt "=" "STRING_TOKEN" "\(" S:Number "\)" ","     << IIObj.SetError (_STOSID(S->getText(), S->getLine())); >>
   { FLAGS "=" flagsField ( "\|" flagsField )* "," }
   vfrStatementExpression[0]
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementNoSubmitIf :
@@ -3267,7 +3267,7 @@ vfrStatementNoSubmitIf :
   Prompt "=" "STRING_TOKEN" "\(" S:Number "\)" ","     << NSIObj.SetError (_STOSID(S->getText(), S->getLine())); >>
   { FLAGS "=" flagsField ( "\|" flagsField )* "," }
   vfrStatementExpression[0]
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementWarningIf :
@@ -3276,7 +3276,7 @@ vfrStatementWarningIf :
   Prompt "=" "STRING_TOKEN" "\(" S:Number "\)" ","     << WIObj.SetWarning (_STOSID(S->getText(), S->getLine())); >>
   {Timeout "=" T:Number ","                            << WIObj.SetTimeOut (_STOU8(T->getText(), T->getLine())); >>}
   vfrStatementExpression[0]
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementDisableIfQuest :
@@ -3286,7 +3286,7 @@ vfrStatementDisableIfQuest :
   L:DisableIf                                          << DIObj.SetLineNo(L->getLine()); >>
   vfrStatementExpression[0] ";"
   vfrStatementQuestionOptionList
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementRefresh :
@@ -3316,7 +3316,7 @@ vfrStatementSuppressIfQuest :
   { FLAGS "=" flagsField ( "\|" flagsField )* "," }
   vfrStatementExpression[0] ";"
   vfrStatementQuestionOptionList
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementGrayOutIfQuest :
@@ -3325,7 +3325,7 @@ vfrStatementGrayOutIfQuest :
   { FLAGS "=" flagsField ( "\|" flagsField )* "," }
   vfrStatementExpression[0] ";"
   vfrStatementQuestionOptionList
-  E:EndIf                                              << CRT_END_OP (E); >>
+  E:EndIf {";"}                                        << CRT_END_OP (E); >>
   ;
 
 vfrStatementOptions :
diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index 259abc519b00..fe565743576b 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -40,7 +40,7 @@
 import Common.VpdInfoFile as VpdInfoFile
 from GenPcdDb import CreatePcdDatabaseCode
 from Workspace.MetaFileCommentParser import UsageList
-
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 import InfSectionParser
 
 ## Regular expression for splitting Dependency Expression string into tokens
@@ -953,7 +953,7 @@ def CollectPlatformDynamicPcds(self):
         self._GuidValue = {}
         FdfModuleList = []
         for InfName in self._AsBuildInfList:
-            InfName = os.path.join(self.WorkspaceDir, InfName)
+            InfName = mws.join(self.WorkspaceDir, InfName)
             FdfModuleList.append(os.path.normpath(InfName))
         for F in self.Platform.Modules.keys():
             M = ModuleAutoGen(self.Workspace, F, self.BuildTarget, self.ToolChain, self.Arch, self.MetaFile)
@@ -1288,7 +1288,7 @@ def _GetVersion(self):
     def _GetFdfFile(self):
         if self._FdfFile == None:
             if self.Workspace.FdfFile != "":
-                self._FdfFile= path.join(self.WorkspaceDir, self.Workspace.FdfFile)
+                self._FdfFile= mws.join(self.WorkspaceDir, self.Workspace.FdfFile)
             else:
                 self._FdfFile = ''
         return self._FdfFile
@@ -2115,8 +2115,11 @@ def ApplyBuildOption(self, Module):
                         BuildOptions[Tool][Attr] = ""
                     # check if override is indicated
                     if Value.startswith('='):
-                        BuildOptions[Tool][Attr] = Value[1:]
+                        ToolPath = Value[1:]
+                        ToolPath = mws.handleWsMacro(ToolPath)
+                        BuildOptions[Tool][Attr] = ToolPath
                     else:
+                        Value = mws.handleWsMacro(Value)
                         BuildOptions[Tool][Attr] += " " + Value
         if Module.AutoGenVersion < 0x00010005 and self.Workspace.UniFlag != None:
             #
@@ -2193,8 +2196,7 @@ def _Init(self, Workspace, ModuleFile, Target, Toolchain, Arch, PlatformFile):
             return False
 
         self.SourceDir = self.MetaFile.SubDir
-        if self.SourceDir.upper().find(self.WorkspaceDir.upper()) == 0:
-            self.SourceDir = self.SourceDir[len(self.WorkspaceDir) + 1:]
+        self.SourceDir = mws.relpath(self.SourceDir, self.WorkspaceDir)
 
         self.SourceOverrideDir = None
         # use overrided path defined in DSC file
@@ -3042,7 +3044,7 @@ def _GetIncludePathList(self):
                 self._IncludePathList.append(self.DebugDir)
 
             for Package in self.Module.Packages:
-                PackageDir = path.join(self.WorkspaceDir, Package.MetaFile.Dir)
+                PackageDir = mws.join(self.WorkspaceDir, Package.MetaFile.Dir)
                 if PackageDir not in self._IncludePathList:
                     self._IncludePathList.append(PackageDir)
                 for Inc in Package.Includes:
diff --git a/BaseTools/Source/Python/AutoGen/GenC.py b/BaseTools/Source/Python/AutoGen/GenC.py
index 77de1657f0bb..45fb9899f2c2 100644
--- a/BaseTools/Source/Python/AutoGen/GenC.py
+++ b/BaseTools/Source/Python/AutoGen/GenC.py
@@ -1384,22 +1384,21 @@ def CreateModuleUnloadImageCode(Info, AutoGenC, AutoGenH):
 #   @param      AutoGenH    The TemplateString object for header file
 #
 def CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH):
-    if Info.IsLibrary:
-        return
-
     if Info.ModuleType in ["USER_DEFINED", "BASE"]:
         GuidType = "GUID"
     else:
         GuidType = "EFI_GUID"
 
     if Info.GuidList:
-        AutoGenC.Append("\n// Guids\n")
+        if not Info.IsLibrary:
+            AutoGenC.Append("\n// Guids\n")
         AutoGenH.Append("\n// Guids\n")
     #
     # GUIDs
     #
     for Key in Info.GuidList:
-        AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.GuidList[Key]))
+        if not Info.IsLibrary:
+            AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.GuidList[Key]))
         AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))
 
 ## Create code for protocol
@@ -1409,22 +1408,21 @@ def CreateGuidDefinitionCode(Info, AutoGenC, AutoGenH):
 #   @param      AutoGenH    The TemplateString object for header file
 #
 def CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH):
-    if Info.IsLibrary:
-        return
-
     if Info.ModuleType in ["USER_DEFINED", "BASE"]:
         GuidType = "GUID"
     else:
         GuidType = "EFI_GUID"
 
     if Info.ProtocolList:
-        AutoGenC.Append("\n// Protocols\n")
+        if not Info.IsLibrary:
+            AutoGenC.Append("\n// Protocols\n")
         AutoGenH.Append("\n// Protocols\n")
     #
     # Protocol GUIDs
     #
     for Key in Info.ProtocolList:
-        AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.ProtocolList[Key]))
+        if not Info.IsLibrary:
+            AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.ProtocolList[Key]))
         AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))
 
 ## Create code for PPI
@@ -1434,22 +1432,21 @@ def CreateProtocolDefinitionCode(Info, AutoGenC, AutoGenH):
 #   @param      AutoGenH    The TemplateString object for header file
 #
 def CreatePpiDefinitionCode(Info, AutoGenC, AutoGenH):
-    if Info.IsLibrary:
-        return
-
     if Info.ModuleType in ["USER_DEFINED", "BASE"]:
         GuidType = "GUID"
     else:
         GuidType = "EFI_GUID"
 
     if Info.PpiList:
-        AutoGenC.Append("\n// PPIs\n")
+        if not Info.IsLibrary:
+            AutoGenC.Append("\n// PPIs\n")
         AutoGenH.Append("\n// PPIs\n")
     #
     # PPI GUIDs
     #
     for Key in Info.PpiList:
-        AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.PpiList[Key]))
+        if not Info.IsLibrary:
+            AutoGenC.Append('GLOBAL_REMOVE_IF_UNREFERENCED %s %s = %s;\n' % (GuidType, Key, Info.PpiList[Key]))
         AutoGenH.Append('extern %s %s;\n' % (GuidType, Key))
 
 ## Create code for PCD
diff --git a/BaseTools/Source/Python/AutoGen/GenMake.py b/BaseTools/Source/Python/AutoGen/GenMake.py
index 0342709a3a63..d9b219e1c75f 100644
--- a/BaseTools/Source/Python/AutoGen/GenMake.py
+++ b/BaseTools/Source/Python/AutoGen/GenMake.py
@@ -19,7 +19,7 @@
 import re
 import os.path as path
 from Common.LongFilePathSupport import OpenLongFilePath as open
-
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 from Common.BuildToolError import *
 from Common.Misc import *
 from Common.String import *
@@ -559,7 +559,7 @@ def _CreateTemplateDict(self):
         found = False
         while not found and os.sep in package_rel_dir:
             index = package_rel_dir.index(os.sep)
-            current_dir = os.path.join(current_dir, package_rel_dir[:index])
+            current_dir = mws.join(current_dir, package_rel_dir[:index])
             for fl in os.listdir(current_dir):
                 if fl.endswith('.dec'):
                     found = True
diff --git a/BaseTools/Source/Python/Common/EdkIIWorkspace.py b/BaseTools/Source/Python/Common/EdkIIWorkspace.py
index 84d89b6c2ef8..401efeef3c94 100644
--- a/BaseTools/Source/Python/Common/EdkIIWorkspace.py
+++ b/BaseTools/Source/Python/Common/EdkIIWorkspace.py
@@ -17,6 +17,7 @@
 import Common.LongFilePathOs as os, sys, time
 from DataType import *
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## EdkIIWorkspace
 #
@@ -112,7 +113,7 @@ def WorkspaceRelativePath(self, FileName):
     # @retval string  The full path filename
     #
     def WorkspaceFile(self, FileName):
-        return os.path.realpath(os.path.join(self.WorkspaceDir,FileName))
+        return os.path.realpath(mws.join(self.WorkspaceDir,FileName))
 
     ## Convert to a real path filename
     #
diff --git a/BaseTools/Source/Python/Common/FdfParserLite.py b/BaseTools/Source/Python/Common/FdfParserLite.py
index 54a60a7e8f81..a0ee249748e1 100644
--- a/BaseTools/Source/Python/Common/FdfParserLite.py
+++ b/BaseTools/Source/Python/Common/FdfParserLite.py
@@ -20,6 +20,7 @@
 
 import CommonDataClass.FdfClass
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ##define T_CHAR_SPACE                ' '
 ##define T_CHAR_NULL                 '\0'
@@ -485,7 +486,8 @@ def PreprocessIncludeFile(self):
                 IncFileName = self.__Token
                 if not os.path.isabs(IncFileName):
                     if IncFileName.startswith('$(WORKSPACE)'):
-                        Str = IncFileName.replace('$(WORKSPACE)', os.environ.get('WORKSPACE'))
+                        Str = mws.handleWsMacro(IncFileName)
+                        Str = Str.replace('$(WORKSPACE)', os.environ.get('WORKSPACE'))
                         if os.path.exists(Str):
                             if not os.path.isabs(Str):
                                 Str = os.path.abspath(Str)
@@ -494,7 +496,7 @@ def PreprocessIncludeFile(self):
                         # file is in the same dir with FDF file
                         FullFdf = self.FileName
                         if not os.path.isabs(self.FileName):
-                            FullFdf = os.path.join(os.environ.get('WORKSPACE'), self.FileName)
+                            FullFdf = mws.join(os.environ.get('WORKSPACE'), self.FileName)
                 
                         IncFileName = os.path.join(os.path.dirname(FullFdf), IncFileName)
                     
diff --git a/BaseTools/Source/Python/Common/LongFilePathOsPath.py b/BaseTools/Source/Python/Common/LongFilePathOsPath.py
index cb89b1b81384..0bba4464195d 100644
--- a/BaseTools/Source/Python/Common/LongFilePathOsPath.py
+++ b/BaseTools/Source/Python/Common/LongFilePathOsPath.py
@@ -49,3 +49,5 @@ def getctime(filename):
 islink = os.path.islink
 isabs = os.path.isabs
 realpath = os.path.realpath
+relpath = os.path.relpath
+pardir = os.path.pardir
diff --git a/BaseTools/Source/Python/Common/Misc.py b/BaseTools/Source/Python/Common/Misc.py
index 8ba5819cc1e3..0eedddc86125 100644
--- a/BaseTools/Source/Python/Common/Misc.py
+++ b/BaseTools/Source/Python/Common/Misc.py
@@ -35,6 +35,7 @@
 from CommonDataClass.DataClass import *
 from Parsing import GetSplitValueList
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Regular expression used to find out place holders in string template
 gPlaceholderPattern = re.compile("\$\{([^$()\s]+)\}", re.MULTILINE|re.UNICODE)
@@ -1728,6 +1729,7 @@ def __init__(self, File='', Root='', AlterRoot='', Type='', IsBinary=False,
 
         # Remove any '.' and '..' in path
         if self.Root:
+            self.Root = mws.getWs(self.Root, self.File)
             self.Path = os.path.normpath(os.path.join(self.Root, self.File))
             self.Root = os.path.normpath(CommonPath([self.Root, self.Path]))
             # eliminate the side-effect of 'C:'
@@ -1838,7 +1840,10 @@ def Validate(self, Type='', CaseSensitive=True):
                 RealFile = os.path.join(self.AlterRoot, self.File)
             elif self.Root:
                 RealFile = os.path.join(self.Root, self.File)
-            return FILE_NOT_FOUND, os.path.join(self.AlterRoot, RealFile)
+            if len (mws.getPkgPath()) == 0:
+                return FILE_NOT_FOUND, os.path.join(self.AlterRoot, RealFile)
+            else:
+                return FILE_NOT_FOUND, "%s is not found in packages path:\n\t%s" % (self.File, '\n\t'.join(mws.getPkgPath()))
 
         ErrorCode = 0
         ErrorInfo = ''
diff --git a/BaseTools/Source/Python/Common/String.py b/BaseTools/Source/Python/Common/String.py
index 6c9671d51422..5c8d1e0ded5b 100644
--- a/BaseTools/Source/Python/Common/String.py
+++ b/BaseTools/Source/Python/Common/String.py
@@ -24,6 +24,7 @@
 from BuildToolError import *
 from CommonDataClass.Exceptions import *
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 gHexVerPatt = re.compile('0x[a-f0-9]{4}[a-f0-9]{4}$', re.IGNORECASE)
 gHumanReadableVerPatt = re.compile(r'([1-9][0-9]*|0)\.[0-9]{1,2}$')
@@ -305,6 +306,11 @@ def NormPath(Path, Defines={}):
         # To local path format
         #
         Path = os.path.normpath(Path)
+        if Path.startswith(GlobalData.gWorkspace) and not os.path.exists(Path):
+            Path = Path[len (GlobalData.gWorkspace):]
+            if Path[0] == os.path.sep:
+                Path = Path[1:]
+            Path = mws.join(GlobalData.gWorkspace, Path)
 
     if IsRelativePath and Path[0] != '.':
         Path = os.path.join('.', Path)
@@ -702,7 +708,7 @@ def RaiseParserError(Line, Section, File, Format='', LineNo= -1):
 # @retval string A full path
 #
 def WorkspaceFile(WorkspaceDir, Filename):
-    return os.path.join(NormPath(WorkspaceDir), NormPath(Filename))
+    return mws.join(NormPath(WorkspaceDir), NormPath(Filename))
 
 ## Split string
 #
diff --git a/BaseTools/Source/Python/Ecc/Check.py b/BaseTools/Source/Python/Ecc/Check.py
index 7932fb3394a9..5e5c8e72e400 100644
--- a/BaseTools/Source/Python/Ecc/Check.py
+++ b/BaseTools/Source/Python/Ecc/Check.py
@@ -19,6 +19,7 @@
 import EccGlobalData
 import c
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Check
 #
@@ -380,9 +381,7 @@ def IncludeFileCheckSameName(self):
             for Key in RecordDict:
                 if len(RecordDict[Key]) > 1:
                     for Item in RecordDict[Key]:
-                        Path = Item[1].replace(EccGlobalData.gWorkspace, '')
-                        if Path.startswith('\\') or Path.startswith('/'):
-                            Path = Path[1:]
+                        Path = mws.relpath(Item[1], EccGlobalData.gWorkspace)
                         if not EccGlobalData.gException.IsException(ERROR_INCLUDE_FILE_CHECK_NAME, Path):
                             EccGlobalData.gDb.TblReport.Insert(ERROR_INCLUDE_FILE_CHECK_NAME, OtherMsg="The file name for [%s] is duplicate" % Path, BelongsToTable='File', BelongsToItem=Item[0])
 
@@ -653,7 +652,7 @@ def MetaDataFileCheckLibraryInstanceDependent(self):
                 if LibraryClass[1].upper() == 'NULL' or LibraryClass[1].startswith('!ifdef') or LibraryClass[1].startswith('!ifndef') or LibraryClass[1].endswith('!endif'):
                     continue
                 else:
-                    LibraryIns = os.path.normpath(os.path.join(EccGlobalData.gWorkspace, LibraryClass[2]))
+                    LibraryIns = os.path.normpath(mws.join(EccGlobalData.gWorkspace, LibraryClass[2]))
                     SqlCommand = """select Value3 from Inf where BelongsToFile =
                                     (select ID from File where lower(FullPath) = lower('%s'))
                                     and Value2 = '%s'""" % (LibraryIns, 'LIBRARY_CLASS')
@@ -729,7 +728,7 @@ def MetaDataFileCheckBinaryInfInFdf(self):
             for Record in RecordSet:
                 FdfID = Record[0]
                 FilePath = Record[1]
-                FilePath = os.path.normpath(os.path.join(EccGlobalData.gWorkspace, FilePath))
+                FilePath = os.path.normpath(mws.join(EccGlobalData.gWorkspace, FilePath))
                 SqlCommand = """select ID from Inf where Model = %s and BelongsToFile = (select ID from File where FullPath like '%s')
                                 """ % (MODEL_EFI_SOURCE_FILE, FilePath)
                 NewRecordSet = EccGlobalData.gDb.TblFile.Exec(SqlCommand)
@@ -913,9 +912,7 @@ def GetInfFilePathFromID(self, FileID):
         RecordSet = Table.Exec(SqlCommand)
         Path = ""
         for Record in RecordSet:
-            Path = Record[0].replace(EccGlobalData.gWorkspace, '')
-            if Path.startswith('\\') or Path.startswith('/'):
-                Path = Path[1:]
+            Path = mws.relpath(Record[0], EccGlobalData.gWorkspace)
         return Path
 
     # Check whether two module INFs under one workspace has the same FILE_GUID value
@@ -1223,7 +1220,10 @@ def NamingConventionCheckVariableName(self, FileTable):
             SqlCommand = """select ID, Name from %s where Model = %s""" % (FileTable, MODEL_IDENTIFIER_VARIABLE)
             RecordSet = EccGlobalData.gDb.TblFile.Exec(SqlCommand)
             for Record in RecordSet:
-                if not Pattern.match(Record[1]):
+                Var = Record[1]
+                if Var.startswith('CONST'):
+                    Var = Var[5:].lstrip()
+                if not Pattern.match(Var):
                     if not EccGlobalData.gException.IsException(ERROR_NAMING_CONVENTION_CHECK_VARIABLE_NAME, Record[1]):
                         EccGlobalData.gDb.TblReport.Insert(ERROR_NAMING_CONVENTION_CHECK_VARIABLE_NAME, OtherMsg="The variable name [%s] does not follow the rules" % (Record[1]), BelongsToTable=FileTable, BelongsToItem=Record[0])
 
diff --git a/BaseTools/Source/Python/Ecc/Ecc.py b/BaseTools/Source/Python/Ecc/Ecc.py
index ec8f6c22cfa4..c2ad4faff446 100644
--- a/BaseTools/Source/Python/Ecc/Ecc.py
+++ b/BaseTools/Source/Python/Ecc/Ecc.py
@@ -38,6 +38,7 @@
 import re, string
 from Exception import *
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Ecc
 #
@@ -70,8 +71,13 @@ def __init__(self):
         #
         WorkspaceDir = os.path.normcase(os.path.normpath(os.environ["WORKSPACE"]))
         os.environ["WORKSPACE"] = WorkspaceDir
+        
+        # set multiple workspace
+        PackagesPath = os.getenv("PACKAGES_PATH")
+        mws.setWs(WorkspaceDir, PackagesPath)
+        
         if "ECP_SOURCE" not in os.environ:
-            os.environ["ECP_SOURCE"] = os.path.join(WorkspaceDir, GlobalData.gEdkCompatibilityPkg)
+            os.environ["ECP_SOURCE"] = mws.join(WorkspaceDir, GlobalData.gEdkCompatibilityPkg)
         if "EFI_SOURCE" not in os.environ:
             os.environ["EFI_SOURCE"] = os.environ["ECP_SOURCE"]
         if "EDK_SOURCE" not in os.environ:
diff --git a/BaseTools/Source/Python/Ecc/MetaDataParser.py b/BaseTools/Source/Python/Ecc/MetaDataParser.py
index d80a5cff5d68..82ede3eb330c 100644
--- a/BaseTools/Source/Python/Ecc/MetaDataParser.py
+++ b/BaseTools/Source/Python/Ecc/MetaDataParser.py
@@ -14,6 +14,7 @@
 import Common.LongFilePathOs as os
 from CommonDataClass.DataClass import *
 from EccToolError import *
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 import EccGlobalData
 import re
 ## Get the inlcude path list for a source file
@@ -33,8 +34,8 @@ def GetIncludeListOfFile(WorkSpace, Filepath, Db):
                 % (MODEL_META_DATA_PACKAGE, MODEL_EFI_SOURCE_FILE, '\\', Filepath)
     RecordSet = Db.TblFile.Exec(SqlCommand)
     for Record in RecordSet:
-        DecFullPath = os.path.normpath(os.path.join(WorkSpace, Record[0]))
-        InfFullPath = os.path.normpath(os.path.join(WorkSpace, Record[1]))
+        DecFullPath = os.path.normpath(mws.join(WorkSpace, Record[0]))
+        InfFullPath = os.path.normpath(mws.join(WorkSpace, Record[1]))
         (DecPath, DecName) = os.path.split(DecFullPath)
         (InfPath, InfName) = os.path.split(InfFullPath)
         SqlCommand = """select Value1 from Dec where BelongsToFile =
diff --git a/BaseTools/Source/Python/Ecc/c.py b/BaseTools/Source/Python/Ecc/c.py
index dcb37e5632fb..256b9e021c26 100644
--- a/BaseTools/Source/Python/Ecc/c.py
+++ b/BaseTools/Source/Python/Ecc/c.py
@@ -1271,7 +1271,10 @@ def CheckFuncLayoutReturnType(FullFileName):
         FuncName = Result[5]
         if EccGlobalData.gException.IsException(ERROR_C_FUNCTION_LAYOUT_CHECK_RETURN_TYPE, FuncName):
             continue
-        Index = Result[0].find(TypeStart)
+        Result0 = Result[0]
+        if Result0.upper().startswith('STATIC'):
+            Result0 = Result0[6:].strip()
+        Index = Result0.find(TypeStart)
         if Index != 0 or Result[3] != 0:
             PrintErrorMsg(ERROR_C_FUNCTION_LAYOUT_CHECK_RETURN_TYPE, '[%s] Return Type should appear at the start of line' % FuncName, FileTable, Result[1])
 
@@ -1313,9 +1316,10 @@ def CheckFuncLayoutModifier(FullFileName):
     for Result in ResultSet:
         ReturnType = GetDataTypeFromModifier(Result[0])
         TypeStart = ReturnType.split()[0]
-#        if len(ReturnType) == 0:
-#            continue
-        Index = Result[0].find(TypeStart)
+        Result0 = Result[0]
+        if Result0.upper().startswith('STATIC'):
+            Result0 = Result0[6:].strip()
+        Index = Result0.find(TypeStart)
         if Index != 0:
             PrintErrorMsg(ERROR_C_FUNCTION_LAYOUT_CHECK_OPTIONAL_FUNCTIONAL_MODIFIER, '', FileTable, Result[1])
 
@@ -1327,8 +1331,6 @@ def CheckFuncLayoutModifier(FullFileName):
     for Result in ResultSet:
         ReturnType = GetDataTypeFromModifier(Result[0])
         TypeStart = ReturnType.split()[0]
-#        if len(ReturnType) == 0:
-#            continue
         Result0 = Result[0]
         if Result0.upper().startswith('STATIC'):
             Result0 = Result0[6:].strip()
@@ -1631,6 +1633,8 @@ def CheckMemberVariableFormat(Name, Value, FileTable, TdId, ModelId):
         Field = Field.strip()
         if Field == '':
             continue
+        if Field.startswith("#"):
+            continue
         # Enum could directly assign value to variable
         Field = Field.split('=')[0].strip()
         TokenList = Field.split()
diff --git a/BaseTools/Source/Python/GenFds/FfsInfStatement.py b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
index 29dc75f433f4..ed767d3fa698 100644
--- a/BaseTools/Source/Python/GenFds/FfsInfStatement.py
+++ b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
@@ -28,6 +28,7 @@
 import RuleSimpleFile
 import RuleComplexFile
 from CommonDataClass.FdfClass import FfsInfStatementClassObject
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 from Common.String import *
 from Common.Misc import PathClass
 from Common.Misc import GuidStructureByteArrayToGuidString
@@ -365,7 +366,7 @@ def GenFfs(self, Dict = {}, FvChildAddr = [], FvParentAddr=None):
         #
 
         self.__InfParse__(Dict)
-        SrcFile = os.path.join( GenFdsGlobalVariable.WorkSpaceDir , self.InfFileName);
+        SrcFile = mws.join( GenFdsGlobalVariable.WorkSpaceDir , self.InfFileName);
         DestFile = os.path.join( self.OutputPath, self.ModuleGuid + '.ffs')
         
         SrcFileDir = "."
@@ -511,7 +512,7 @@ def __GetRule__ (self) :
     #
     def __GetPlatformArchList__(self):
 
-        InfFileKey = os.path.normpath(os.path.join(GenFdsGlobalVariable.WorkSpaceDir, self.InfFileName))
+        InfFileKey = os.path.normpath(mws.join(GenFdsGlobalVariable.WorkSpaceDir, self.InfFileName))
         DscArchList = []
         PlatformDataBase = GenFdsGlobalVariable.WorkSpace.BuildObject[GenFdsGlobalVariable.ActivePlatform, 'IA32', GenFdsGlobalVariable.TargetName, GenFdsGlobalVariable.ToolChainTag]
         if  PlatformDataBase != None:
@@ -878,7 +879,7 @@ def __GenComplexFileSection__(self, Rule, FvChildAddr, FvParentAddr):
             
             if not HasGneratedFlag:
                 UniVfrOffsetFileSection = ""    
-                ModuleFileName = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, self.InfFileName)
+                ModuleFileName = mws.join(GenFdsGlobalVariable.WorkSpaceDir, self.InfFileName)
                 InfData = GenFdsGlobalVariable.WorkSpace.BuildObject[PathClass(ModuleFileName), self.CurrentArch]
                 #
                 # Search the source list in InfData to find if there are .vfr file exist.
diff --git a/BaseTools/Source/Python/GenFds/GenFds.py b/BaseTools/Source/Python/GenFds/GenFds.py
index c2ad4e0e2a7c..a0beff039132 100644
--- a/BaseTools/Source/Python/GenFds/GenFds.py
+++ b/BaseTools/Source/Python/GenFds/GenFds.py
@@ -39,6 +39,7 @@
 from Common.Misc import ClearDuplicatedInf
 from Common.Misc import GuidStructureStringToGuidString
 from Common.BuildVersion import gBUILD_VERSION
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Version and Copyright
 versionNumber = "1.0" + ' ' + gBUILD_VERSION
@@ -94,6 +95,10 @@ def main():
             if (Options.debug):
                 GenFdsGlobalVariable.VerboseLogger( "Using Workspace:" + Workspace)
         os.chdir(GenFdsGlobalVariable.WorkSpaceDir)
+        
+        # set multiple workspace
+        PackagesPath = os.getenv("PACKAGES_PATH")
+        mws.setWs(GenFdsGlobalVariable.WorkSpaceDir, PackagesPath)
 
         if (Options.filename):
             FdfFilename = Options.filename
@@ -102,7 +107,7 @@ def main():
             if FdfFilename[0:2] == '..':
                 FdfFilename = os.path.realpath(FdfFilename)
             if not os.path.isabs (FdfFilename):
-                FdfFilename = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, FdfFilename)
+                FdfFilename = mws.join(GenFdsGlobalVariable.WorkSpaceDir, FdfFilename)
             if not os.path.exists(FdfFilename):
                 EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=FdfFilename)
 
@@ -129,13 +134,13 @@ def main():
                 ActivePlatform = os.path.realpath(ActivePlatform)
 
             if not os.path.isabs (ActivePlatform):
-                ActivePlatform = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, ActivePlatform)
+                ActivePlatform = mws.join(GenFdsGlobalVariable.WorkSpaceDir, ActivePlatform)
 
             if not os.path.exists(ActivePlatform)  :
                 EdkLogger.error("GenFds", FILE_NOT_FOUND, "ActivePlatform doesn't exist!")
 
             if os.path.normcase (ActivePlatform).find(Workspace) == 0:
-                ActivePlatform = ActivePlatform[len(Workspace):]
+                ActivePlatform = mws.relpath(ActivePlatform, Workspace)
             if len(ActivePlatform) > 0 :
                 if ActivePlatform[0] == '\\' or ActivePlatform[0] == '/':
                     ActivePlatform = ActivePlatform[1:]
@@ -159,7 +164,7 @@ def main():
                 ConfDirectoryPath = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, ConfDirectoryPath)
         else:
             # Get standard WORKSPACE/Conf, use the absolute path to the WORKSPACE/Conf
-            ConfDirectoryPath = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, 'Conf')
+            ConfDirectoryPath = mws.join(GenFdsGlobalVariable.WorkSpaceDir, 'Conf')
         GenFdsGlobalVariable.ConfDir = ConfDirectoryPath
         BuildConfigurationFile = os.path.normpath(os.path.join(ConfDirectoryPath, "target.txt"))
         if os.path.isfile(BuildConfigurationFile) == True:
diff --git a/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py b/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
index 04bbc300ceda..5bdc1b8288a8 100644
--- a/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
+++ b/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
@@ -31,6 +31,7 @@
 import Common.DataType as DataType
 from Common.Misc import PathClass
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Global variables
 #
@@ -322,12 +323,13 @@ def SetDir (OutputDir, FdfParser, WorkSpace, ArchList):
     #   @param  String           String that may contain macro
     #
     def ReplaceWorkspaceMacro(String):
+        String = mws.handleWsMacro(String)
         Str = String.replace('$(WORKSPACE)', GenFdsGlobalVariable.WorkSpaceDir)
         if os.path.exists(Str):
             if not os.path.isabs(Str):
                 Str = os.path.abspath(Str)
         else:
-            Str = os.path.join(GenFdsGlobalVariable.WorkSpaceDir, String)
+            Str = mws.join(GenFdsGlobalVariable.WorkSpaceDir, String)
         return os.path.normpath(Str)
 
     ## Check if the input files are newer than output files
diff --git a/BaseTools/Source/Python/GenFds/Region.py b/BaseTools/Source/Python/GenFds/Region.py
index 15b2ecba906a..feb56cb60f27 100644
--- a/BaseTools/Source/Python/GenFds/Region.py
+++ b/BaseTools/Source/Python/GenFds/Region.py
@@ -24,6 +24,7 @@
 from Common import EdkLogger
 from Common.BuildToolError import *
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## generate Region
 #
@@ -205,7 +206,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
             for RegionData in self.RegionDataList:
                 RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
                 if RegionData[1] != ':' :
-                    RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
+                    RegionData = mws.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                 if not os.path.exists(RegionData):
                     EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
                 #
diff --git a/BaseTools/Source/Python/Makefile b/BaseTools/Source/Python/Makefile
index 4044fcefeb9f..d3f1baa83109 100644
--- a/BaseTools/Source/Python/Makefile
+++ b/BaseTools/Source/Python/Makefile
@@ -59,6 +59,7 @@ COMMON_PYTHON=$(BASE_TOOLS_PATH)\Source\Python\Common\BuildToolError.py \
               $(BASE_TOOLS_PATH)\Source\Python\Common\ToolDefClassObject.py \
               $(BASE_TOOLS_PATH)\Source\Python\Common\VpdInfoFile.py \
               $(BASE_TOOLS_PATH)\Source\Python\Common\BuildVersion.py \
+              $(BASE_TOOLS_PATH)\Source\Python\Common\MultipleWorkspace.py \
               $(BASE_TOOLS_PATH)\Source\Python\CommonDataClass\CommonClass.py \
               $(BASE_TOOLS_PATH)\Source\Python\CommonDataClass\DataClass.py \
               $(BASE_TOOLS_PATH)\Source\Python\CommonDataClass\Exceptions.py \
diff --git a/BaseTools/Source/Python/UPT/Core/DistributionPackageClass.py b/BaseTools/Source/Python/UPT/Core/DistributionPackageClass.py
index bfe6dcc70fea..9c55e0ea88a7 100644
--- a/BaseTools/Source/Python/UPT/Core/DistributionPackageClass.py
+++ b/BaseTools/Source/Python/UPT/Core/DistributionPackageClass.py
@@ -32,6 +32,7 @@
 from Object.POM.CommonObject import IdentificationObject
 from Object.POM.CommonObject import CommonHeaderObject
 from Object.POM.CommonObject import MiscFileObject
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## DistributionPackageHeaderClass
 #
@@ -110,14 +111,17 @@ def __init__(self):
     # @param ModuleList:    A list of all modules
     #
     def GetDistributionPackage(self, WorkspaceDir, PackageList, ModuleList):
+        # Backup WorkspaceDir
+        Root = WorkspaceDir
+
         #
         # Get Packages
         #
         if PackageList:
             for PackageFile in PackageList:
-                PackageFileFullPath = \
-                os.path.normpath(os.path.join(WorkspaceDir, PackageFile))
-                DecObj = DecPomAlignment(PackageFileFullPath, WorkspaceDir, CheckMulDec = True)
+                PackageFileFullPath = mws.join(Root, PackageFile)
+                WorkspaceDir = mws.getWs(Root, PackageFile)
+                DecObj = DecPomAlignment(PackageFileFullPath, WorkspaceDir, CheckMulDec=True)
                 PackageObj = DecObj
                 #
                 # Parser inf file one bye one
@@ -140,8 +144,7 @@ def GetDistributionPackage(self, WorkspaceDir, PackageList, ModuleList):
                     # Inf class in InfPomAlignment.
                     #
                     try:
-                        ModuleObj = InfPomAlignment(Filename, WorkspaceDir, \
-                                                PackageObj.GetPackagePath())
+                        ModuleObj = InfPomAlignment(Filename, WorkspaceDir, PackageObj.GetPackagePath())
      
                         #
                         # Add module to package
@@ -168,11 +171,11 @@ def GetDistributionPackage(self, WorkspaceDir, PackageList, ModuleList):
         #
         if ModuleList:
             for ModuleFile in ModuleList:
-                ModuleFileFullPath = \
-                os.path.normpath(os.path.join(WorkspaceDir, ModuleFile))
+                ModuleFileFullPath = mws.join(Root, ModuleFile)
+                WorkspaceDir = mws.getWs(Root, ModuleFile)
+
                 try:
-                    ModuleObj = InfPomAlignment(ModuleFileFullPath, 
-                                                WorkspaceDir)
+                    ModuleObj = InfPomAlignment(ModuleFileFullPath, WorkspaceDir)
                     ModuleKey = (ModuleObj.GetGuid(), 
                                  ModuleObj.GetVersion(), 
                                  ModuleObj.GetName(), 
@@ -185,7 +188,10 @@ def GetDistributionPackage(self, WorkspaceDir, PackageList, ModuleList):
                                      ST.WRN_EDK1_INF_FOUND%ModuleFileFullPath, 
                                      ExtraData=ST.ERR_NOT_SUPPORTED_SA_MODULE)
                     else:
-                        raise                
+                        raise
+
+        # Recover WorkspaceDir
+        WorkspaceDir = Root
 
     ## Get all files included for a distribution package, except tool/misc of 
     # distribution level
diff --git a/BaseTools/Source/Python/UPT/Core/PackageFile.py b/BaseTools/Source/Python/UPT/Core/PackageFile.py
index 47ea0bc0a932..5fafd85bffbf 100644
--- a/BaseTools/Source/Python/UPT/Core/PackageFile.py
+++ b/BaseTools/Source/Python/UPT/Core/PackageFile.py
@@ -37,6 +37,7 @@
 from Library.Misc import CreateDirectory
 from Library.Misc import RemoveDirectory
 from Core.FileHook import __FileHookOpen__
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 
 class PackageFile:
@@ -203,8 +204,11 @@ def Pack(self, Top, BaseDir):
     # @param Files:  the files to pack 
     #
     def PackFiles(self, Files):
-        for File1 in Files:
-            self.PackFile(File1)
+        for File in Files:
+            Cwd = os.getcwd()
+            os.chdir(mws.getWs(mws.WORKSPACE, File))
+            self.PackFile(File)
+            os.chdir(Cwd)
 
     ## Pack the file
     # 
diff --git a/BaseTools/Source/Python/UPT/Library/GlobalData.py b/BaseTools/Source/Python/UPT/Library/GlobalData.py
index d478983c23db..8f446d48883d 100644
--- a/BaseTools/Source/Python/UPT/Library/GlobalData.py
+++ b/BaseTools/Source/Python/UPT/Library/GlobalData.py
@@ -19,6 +19,7 @@
 # The workspace directory 
 #
 gWORKSPACE = '.'
+gPACKAGE_PATH = None
 
 #
 # INF module directory
@@ -107,4 +108,4 @@
 # Used by Library instance parser
 # {FilePath: FileObj}
 #
-gLIBINSTANCEDICT = {}
\ No newline at end of file
+gLIBINSTANCEDICT = {}
diff --git a/BaseTools/Source/Python/UPT/Library/Misc.py b/BaseTools/Source/Python/UPT/Library/Misc.py
index bc9e0e172bf7..0d92cb3767c6 100644
--- a/BaseTools/Source/Python/UPT/Library/Misc.py
+++ b/BaseTools/Source/Python/UPT/Library/Misc.py
@@ -50,6 +50,7 @@
 from Library.ParserValidate import IsValidPath
 from Object.POM.CommonObject import TextObject
 from Core.FileHook import __FileHookOpen__
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Convert GUID string in xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx style to C 
 # structure style
@@ -592,7 +593,11 @@ def GetWorkspace():
 
     if WorkspaceDir[-1] == ':':
         WorkspaceDir += os.sep
-    return WorkspaceDir
+
+    PackagesPath = os.environ.get("PACKAGES_PATH")
+    mws.setWs(WorkspaceDir, PackagesPath)
+
+    return WorkspaceDir, mws.PACKAGES_PATH
 
 ## Get relative path
 #
diff --git a/BaseTools/Source/Python/UPT/Library/ParserValidate.py b/BaseTools/Source/Python/UPT/Library/ParserValidate.py
index e9732278981a..028cf9a54f84 100644
--- a/BaseTools/Source/Python/UPT/Library/ParserValidate.py
+++ b/BaseTools/Source/Python/UPT/Library/ParserValidate.py
@@ -27,6 +27,7 @@
 from Library.String import GetSplitValueList
 from Library.ExpressionValidate import IsValidBareCString
 from Library.ExpressionValidate import IsValidFeatureFlagExp
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## __HexDigit() method
 #
@@ -236,7 +237,7 @@ def IsValidPath(Path, Root):
     
     Path = os.path.normpath(Path).replace('\\', '/')
     Root = os.path.normpath(Root).replace('\\', '/')
-    FullPath = os.path.normpath(os.path.join(Root, Path)).replace('\\', '/')
+    FullPath = mws.join(Root, Path)
     
     if not os.path.exists(FullPath):
         return False
diff --git a/BaseTools/Source/Python/UPT/Library/Parsing.py b/BaseTools/Source/Python/UPT/Library/Parsing.py
index ace3e0d11841..c34e7751442a 100644
--- a/BaseTools/Source/Python/UPT/Library/Parsing.py
+++ b/BaseTools/Source/Python/UPT/Library/Parsing.py
@@ -827,21 +827,23 @@ def GetPkgInfoFromDec(Path):
 def GetWorkspacePackage():
     DecFileList = []
     WorkspaceDir = GlobalData.gWORKSPACE
-    for Root, Dirs, Files in os.walk(WorkspaceDir):
-        if 'CVS' in Dirs:
-            Dirs.remove('CVS')
-        if '.svn' in Dirs:
-            Dirs.remove('.svn')
-        for Dir in Dirs:
-            if Dir.startswith('.'):
-                Dirs.remove(Dir)
-        for FileSp in Files:
-            if FileSp.startswith('.'):
-                continue
-            Ext = os.path.splitext(FileSp)[1]
-            if Ext.lower() in ['.dec']:
-                DecFileList.append\
-                (os.path.normpath(os.path.join(Root, FileSp)))
+    PackageDir = GlobalData.gPACKAGE_PATH
+    for PkgRoot in [WorkspaceDir] + PackageDir:
+        for Root, Dirs, Files in os.walk(PkgRoot):
+            if 'CVS' in Dirs:
+                Dirs.remove('CVS')
+            if '.svn' in Dirs:
+                Dirs.remove('.svn')
+            for Dir in Dirs:
+                if Dir.startswith('.'):
+                    Dirs.remove(Dir)
+            for FileSp in Files:
+                if FileSp.startswith('.'):
+                    continue
+                Ext = os.path.splitext(FileSp)[1]
+                if Ext.lower() in ['.dec']:
+                    DecFileList.append\
+                    (os.path.normpath(os.path.join(Root, FileSp)))
     #
     # abstract package guid, version info from DecFile List
     #
diff --git a/BaseTools/Source/Python/UPT/MkPkg.py b/BaseTools/Source/Python/UPT/MkPkg.py
index 2eb84588bdc4..87c84f0cc25b 100644
--- a/BaseTools/Source/Python/UPT/MkPkg.py
+++ b/BaseTools/Source/Python/UPT/MkPkg.py
@@ -50,6 +50,7 @@
 
 from Core.DistributionPackageClass import DistributionPackageClass
 from Core.PackageFile import PackageFile
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## CheckForExistingDp
 #
@@ -136,7 +137,7 @@ def Main(Options = None):
                 # write().
                 #
                 FromFile = os.path.normpath(FileObject.GetURI()).encode('utf_8')
-                FileFullPath = os.path.normpath(os.path.join(WorkspaceDir, FromFile))
+                FileFullPath = mws.join(WorkspaceDir, FromFile)
                 if FileFullPath in RePkgDict:
                     (DpGuid, DpVersion, DpName, Repackage) = RePkgDict[FileFullPath]
                     if not Repackage:
@@ -183,7 +184,7 @@ def Main(Options = None):
                     DistPkg.Header.RePackage = True
           
         Cwd = getcwd()
-        chdir(WorkspaceDir)        
+        chdir(WorkspaceDir)
         ContentFile.PackFiles(FileList)
         chdir(Cwd)
         
@@ -264,7 +265,7 @@ def CheckFileList(QualifiedExt, FileList, ErrorStringExt, ErrorStringFullPath):
                          ErrorStringExt % Item)
         
         Item = os.path.normpath(Item)
-        Path = os.path.normpath(os.path.join(WorkspaceDir, Item))
+        Path = mws.join(WorkspaceDir, Item)
         if not os.path.exists(Path):
             Logger.Error("\nMkPkg", FILE_NOT_FOUND, ST.ERR_NOT_FOUND % Item)
         elif Item == Path:
diff --git a/BaseTools/Source/Python/UPT/PomAdapter/InfPomAlignment.py b/BaseTools/Source/Python/UPT/PomAdapter/InfPomAlignment.py
index 22e9ef5fc0a3..a15173285345 100644
--- a/BaseTools/Source/Python/UPT/PomAdapter/InfPomAlignment.py
+++ b/BaseTools/Source/Python/UPT/PomAdapter/InfPomAlignment.py
@@ -51,7 +51,7 @@
 from PomAdapter.InfPomAlignmentMisc import GenBinaryData
 from Parser import InfParser
 from PomAdapter.DecPomAlignment import DecPomAlignment
-
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## InfPomAlignment
 #
@@ -534,8 +534,7 @@ def _GenPackages(self, Skip):
             PackageDependency.SetSupArchList(ConvertArchList(PackageItemObj.GetSupArchList()))
             PackageDependency.SetFeatureFlag(PackageItemObj.GetFeatureFlagExp())
 
-            PkgInfo = GetPkgInfoFromDec(os.path.normpath(os.path.join(self.WorkSpace,
-                                                                      NormPath(PackageItemObj.GetPackageName()))))
+            PkgInfo = GetPkgInfoFromDec(mws.join(self.WorkSpace, NormPath(PackageItemObj.GetPackageName())))
             if PkgInfo[1] and PkgInfo[2]:
                 PackageDependency.SetGuid(PkgInfo[1])
                 PackageDependency.SetVersion(PkgInfo[2])
diff --git a/BaseTools/Source/Python/UPT/UPT.py b/BaseTools/Source/Python/UPT/UPT.py
index e7b0a8f264b1..17decda5c3e6 100644
--- a/BaseTools/Source/Python/UPT/UPT.py
+++ b/BaseTools/Source/Python/UPT/UPT.py
@@ -39,6 +39,7 @@
 from Logger.ToolError import OPTION_CONFLICT
 from Logger.ToolError import FatalError
 from Logger.ToolError import UPT_ALREADY_INSTALLED_ERROR
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 import MkPkg
 import InstallPkg
@@ -164,7 +165,7 @@ def Main():
         setattr(Opt, Var[0], Var[1])
 
     try:
-        GlobalData.gWORKSPACE = GetWorkspace()
+        GlobalData.gWORKSPACE, GlobalData.gPACKAGE_PATH = GetWorkspace()
     except FatalError, XExcept:
         if Logger.GetLevel() <= Logger.DEBUG_9:
             Logger.Quiet(ST.MSG_PYTHON_ON % (python_version(), platform) + format_exc())
diff --git a/BaseTools/Source/Python/Workspace/MetaFileParser.py b/BaseTools/Source/Python/Workspace/MetaFileParser.py
index fe1f7fd6f642..e7d6df659590 100644
--- a/BaseTools/Source/Python/Workspace/MetaFileParser.py
+++ b/BaseTools/Source/Python/Workspace/MetaFileParser.py
@@ -343,9 +343,14 @@ def _DefineParser(self):
         Name, Value = self._ValueList[1], self._ValueList[2]
         # Sometimes, we need to make differences between EDK and EDK2 modules 
         if Name == 'INF_VERSION':
-            try:
-                self._Version = int(Value, 0)
-            except:
+            if re.match(r'0[xX][\da-f-A-F]{5,8}', Value):
+                self._Version = int(Value, 0)   
+            elif re.match(r'\d+\.\d+', Value):
+                ValueList = Value.split('.')
+                Major = '%04o' % int(ValueList[0], 0)
+                Minor = '%04o' % int(ValueList[1], 0)
+                self._Version = int('0x' + Major + Minor, 0)
+            else:
                 EdkLogger.error('Parser', FORMAT_INVALID, "Invalid version number",
                                 ExtraData=self._CurrentLine, File=self.MetaFile, Line=self._LineIndex + 1)
 
diff --git a/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py b/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
index fd10c5dfb9a8..46eb5d3a8c2f 100644
--- a/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
+++ b/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
@@ -21,6 +21,7 @@
 
 import Common.EdkLogger as EdkLogger
 import Common.GlobalData as GlobalData
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 from Common.String import *
 from Common.DataType import *
@@ -166,7 +167,7 @@ def _HandleOverridePath(self):
             ModuleFile = PathClass(NormPath(Record[0]), GlobalData.gWorkspace, Arch=self._Arch)
             RecordList = self._RawData[MODEL_META_DATA_COMPONENT_SOURCE_OVERRIDE_PATH, self._Arch, None, ModuleId]
             if RecordList != []:
-                SourceOverridePath = os.path.join(GlobalData.gWorkspace, NormPath(RecordList[0][0]))
+                SourceOverridePath = mws.join(GlobalData.gWorkspace, NormPath(RecordList[0][0]))
 
                 # Check if the source override path exists
                 if not os.path.isdir(SourceOverridePath):
@@ -1954,7 +1955,13 @@ def _GetInfVersion(self):
             RecordList = self._RawData[MODEL_META_DATA_HEADER, self._Arch, self._Platform]
             for Record in RecordList:
                 if Record[1] == TAB_INF_DEFINES_INF_VERSION:
-                    self._AutoGenVersion = int(Record[2], 0)
+                    if '.' in Record[2]:
+                        ValueList = Record[2].split('.')
+                        Major = '%04o' % int(ValueList[0], 0)
+                        Minor = '%04o' % int(ValueList[1], 0)
+                        self._AutoGenVersion = int('0x' + Major + Minor, 0)
+                    else:
+                        self._AutoGenVersion = int(Record[2], 0)
                     break
             if self._AutoGenVersion == None:
                 self._AutoGenVersion = 0x00010000
@@ -2179,8 +2186,11 @@ def _GetSourceFiles(self):
                 if self.AutoGenVersion < 0x00010005:
                     Macros["EDK_SOURCE"] = GlobalData.gEcpSource
                     Macros['PROCESSOR'] = self._Arch
+                    SourceFile = NormPath(Record[0], Macros)
+                    if SourceFile[0] == os.path.sep:
+                        SourceFile = mws.join(GlobalData.gWorkspace, SourceFile[1:])
                     # old module source files (Edk)
-                    File = PathClass(NormPath(Record[0], Macros), self._ModuleDir, self._SourceOverridePath,
+                    File = PathClass(SourceFile, self._ModuleDir, self._SourceOverridePath,
                                      '', False, self._Arch, ToolChainFamily, '', TagName, ToolCode)
                     # check the file validation
                     ErrorCode, ErrorInfo = File.Validate(CaseSensitive=False)
@@ -2343,10 +2353,21 @@ def _GetIncludes(self):
                     if File[0] == '.':
                         File = os.path.join(self._ModuleDir, File)
                     else:
-                        File = os.path.join(GlobalData.gWorkspace, File)
+                        File = mws.join(GlobalData.gWorkspace, File)
                     File = RealPath(os.path.normpath(File))
                     if File:
                         self._Includes.append(File)
+                    if not File and Record[0].find('EFI_SOURCE') > -1:
+                        # tricky to regard WorkSpace as EFI_SOURCE
+                        Macros['EFI_SOURCE'] = GlobalData.gWorkspace
+                        File = NormPath(Record[0], Macros)
+                        if File[0] == '.':
+                            File = os.path.join(self._ModuleDir, File)
+                        else:
+                            File = os.path.join(GlobalData.gWorkspace, File)
+                        File = RealPath(os.path.normpath(File))
+                        if File:
+                            self._Includes.append(File)
         return self._Includes
 
     ## Retrieve packages this module depends on
@@ -2797,7 +2818,7 @@ def __getitem__(self, Key):
     def __init__(self, DbPath, RenewDb=False):
         self._DbClosedFlag = False
         if not DbPath:
-            DbPath = os.path.normpath(os.path.join(GlobalData.gWorkspace, 'Conf', GlobalData.gDatabasePath))
+            DbPath = os.path.normpath(mws.join(GlobalData.gWorkspace, 'Conf', GlobalData.gDatabasePath))
 
         # don't create necessary path for db in memory
         if DbPath != ':memory:':
diff --git a/BaseTools/toolsetup.bat b/BaseTools/toolsetup.bat
index 2afa8103ec7c..59874c58392f 100755
--- a/BaseTools/toolsetup.bat
+++ b/BaseTools/toolsetup.bat
@@ -113,30 +113,43 @@ if /I "%1"=="/?" goto Usage
 
 :set_PATH
   if defined WORKSPACE_TOOLS_PATH goto check_PATH
-  set PATH=%EDK_TOOLS_PATH%\Bin;%EDK_TOOLS_PATH%\Bin\Win32;%PATH%
+  if not defined EDK_TOOLS_BIN (
+    if exist %EDK_TOOLS_PATH%\Bin\Win32 (
+      set EDK_TOOLS_BIN=%EDK_TOOLS_PATH%\Bin\Win32
+    ) else (
+      echo.
+      echo !!! ERROR !!! Cannot find BaseTools Bin Win32!!!
+      echo Please check the directory %EDK_TOOLS_PATH%\Bin\Win32
+      echo Or configure EDK_TOOLS_BIN env to point Win32 directory.
+      echo. 
+      goto end
+    )
+  )
+  set PATH=%EDK_TOOLS_BIN%;%PATH%
   set WORKSPACE_TOOLS_PATH=%EDK_TOOLS_PATH%
   goto PATH_ok
 
 :check_PATH
   if "%EDK_TOOLS_PATH%"=="%WORKSPACE_TOOLS_PATH%" goto PATH_ok
-  set PATH=%EDK_TOOLS_PATH%\Bin;%EDK_TOOLS_PATH%\Bin\Win32;%PATH%
+  if not defined EDK_TOOLS_BIN (
+    if exist %EDK_TOOLS_PATH%\Bin\Win32 (
+      set EDK_TOOLS_BIN=%EDK_TOOLS_PATH%\Bin\Win32
+    ) else (
+      echo.
+      echo !!! ERROR !!! Cannot find BaseTools Bin Win32!!!
+      echo Please check the directory %EDK_TOOLS_PATH%\Bin\Win32
+      echo Or configure EDK_TOOLS_BIN env to point Win32 directory.
+      echo. 
+      goto end
+    )
+  )
+  set PATH=%EDK_TOOLS_BIN%;%PATH%
   set WORKSPACE_TOOLS_PATH=%EDK_TOOLS_PATH%
   echo Resetting the PATH variable to include the EDK_TOOLS_PATH for this session.
 
 :PATH_ok
-  echo           PATH      = %PATH%
-  echo.
-  if defined WORKSPACE (
-    echo      WORKSPACE      = %WORKSPACE%
-  )
-  echo EDK_TOOLS_PATH      = %EDK_TOOLS_PATH%
-  if defined BASE_TOOLS_PATH (
-    echo BASE_TOOLS_PATH     = %BASE_TOOLS_PATH%
-  )
-  echo.
-
 REM
-REM copy *.template to %WORKSPACE%\Conf
+REM copy *.template to %CONF_PATH%
 REM
 if not defined WORKSPACE (
    if defined RECONFIG (
@@ -147,49 +160,80 @@ if not defined WORKSPACE (
    goto skip_reconfig
 )
 
-if NOT exist %WORKSPACE%\Conf (
-  mkdir %WORKSPACE%\Conf
+set CONF_PATH=%WORKSPACE%\Conf
+if NOT exist %CONF_PATH% (
+  if defined PACKAGES_PATH (
+    for %%i IN (%PACKAGES_PATH%) DO (
+      if exist %%~fi\Conf (
+        set CONF_PATH=%%i\Conf
+        goto CopyConf
+      )
+    )
+  )
+)
+ 
+:CopyConf
+if NOT exist %CONF_PATH% (
+  mkdir %CONF_PATH%
 ) else (
   if defined RECONFIG (
     echo.
-    echo  Over-writing the files in the WORKSPACE\Conf directory
+    echo  Over-writing the files in the CONF_PATH directory
     echo  using the default template files
     echo.
   )
 )
 
-if NOT exist %WORKSPACE%\Conf\target.txt (
-  echo copying ... target.template to %WORKSPACE%\Conf\target.txt
+if NOT exist %CONF_PATH%\target.txt (
+  echo copying ... target.template to %CONF_PATH%\target.txt
   if NOT exist %EDK_TOOLS_PATH%\Conf\target.template (
     echo Error: target.template is missing at folder %EDK_TOOLS_PATH%\Conf\
   )
-  copy %EDK_TOOLS_PATH%\Conf\target.template %WORKSPACE%\Conf\target.txt > nul
+  copy %EDK_TOOLS_PATH%\Conf\target.template %CONF_PATH%\target.txt > nul
 ) else (
-  if defined RECONFIG echo over-write ... target.template to %WORKSPACE%\Conf\target.txt
-  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\target.template %WORKSPACE%\Conf\target.txt > nul
+  if defined RECONFIG echo over-write ... target.template to %CONF_PATH%\target.txt
+  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\target.template %CONF_PATH%\target.txt > nul
 )
 
-if NOT exist %WORKSPACE%\Conf\tools_def.txt (
-  echo copying ... tools_def.template to %WORKSPACE%\Conf\tools_def.txt
+if NOT exist %CONF_PATH%\tools_def.txt (
+  echo copying ... tools_def.template to %CONF_PATH%\tools_def.txt
   if NOT exist %EDK_TOOLS_PATH%\Conf\tools_def.template (
     echo Error: tools_def.template is missing at folder %EDK_TOOLS_PATH%\Conf\
   )
-  copy %EDK_TOOLS_PATH%\Conf\tools_def.template %WORKSPACE%\Conf\tools_def.txt > nul
+  copy %EDK_TOOLS_PATH%\Conf\tools_def.template %CONF_PATH%\tools_def.txt > nul
 ) else (
-  if defined RECONFIG echo over-write ... tools_def.template to %WORKSPACE%\Conf\tools_def.txt
-  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\tools_def.template %WORKSPACE%\Conf\tools_def.txt > nul
+  if defined RECONFIG echo over-write ... tools_def.template to %CONF_PATH%\tools_def.txt
+  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\tools_def.template %CONF_PATH%\tools_def.txt > nul
 )
 
-if NOT exist %WORKSPACE%\Conf\build_rule.txt (
-  echo copying ... build_rule.template to %WORKSPACE%\Conf\build_rule.txt
+if NOT exist %CONF_PATH%\build_rule.txt (
+  echo copying ... build_rule.template to %CONF_PATH%\build_rule.txt
   if NOT exist %EDK_TOOLS_PATH%\Conf\build_rule.template (
     echo Error: build_rule.template is missing at folder %EDK_TOOLS_PATH%\Conf\
   )
-  copy %EDK_TOOLS_PATH%\Conf\build_rule.template %WORKSPACE%\Conf\build_rule.txt > nul
+  copy %EDK_TOOLS_PATH%\Conf\build_rule.template %CONF_PATH%\build_rule.txt > nul
 ) else (
-  if defined RECONFIG echo over-write ... build_rule.template to %WORKSPACE%\Conf\build_rule.txt
-  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\build_rule.template %WORKSPACE%\Conf\build_rule.txt > nul
+  if defined RECONFIG echo over-write ... build_rule.template to %CONF_PATH%\build_rule.txt
+  if defined RECONFIG copy /Y %EDK_TOOLS_PATH%\Conf\build_rule.template %CONF_PATH%\build_rule.txt > nul
+)
+
+echo           PATH      = %PATH%
+echo.
+if defined WORKSPACE (
+  echo      WORKSPACE      = %WORKSPACE%
+)
+if defined PACKAGES_PATH (
+  echo  PACKAGES_PATH      = %PACKAGES_PATH%
+)
+echo EDK_TOOLS_PATH      = %EDK_TOOLS_PATH%
+if defined BASE_TOOLS_PATH (
+  echo BASE_TOOLS_PATH     = %BASE_TOOLS_PATH%
+)
+if defined EDK_TOOLS_BIN (
+  echo  EDK_TOOLS_BIN      = %EDK_TOOLS_BIN%
 )
+echo      CONF_PATH      = %CONF_PATH%
+echo.
 
 :skip_reconfig
 
@@ -198,28 +242,26 @@ if NOT exist %WORKSPACE%\Conf\build_rule.txt (
 @REM
 if defined FORCE_REBUILD goto check_build_environment
 if defined REBUILD goto check_build_environment
-if not exist "%EDK_TOOLS_PATH%\Bin" goto check_build_environment
-
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\BootSectImage.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\build.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\EfiLdrImage.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\EfiRom.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenBootSector.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenFds.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenFfs.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenFv.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenFw.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenPage.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenSec.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\GenVtf.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\MigrationMsa2Inf.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\Split.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\TargetTool.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\TianoCompress.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\Trim.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\VfrCompile.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\Fpd2Dsc.exe" goto check_build_environment
-IF NOT EXIST "%EDK_TOOLS_PATH%\Bin\Win32\VolInfo.exe" goto check_build_environment
+if not exist "%EDK_TOOLS_PATH%" goto check_build_environment
+
+IF NOT EXIST "%EDK_TOOLS_BIN%\BootSectImage.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\build.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\EfiLdrImage.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\EfiRom.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenBootSector.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenFds.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenFfs.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenFv.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenFw.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenPage.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenSec.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\GenVtf.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\Split.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\TargetTool.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\TianoCompress.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\Trim.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\VfrCompile.exe" goto check_build_environment
+IF NOT EXIST "%EDK_TOOLS_BIN%\VolInfo.exe" goto check_build_environment
 
 goto end
 

From 01c307eacd05fc15cfc1d2d0444867f7f9e9da82 Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Mon, 16 Nov 2015 06:38:00 +0000
Subject: [PATCH 070/525] MdePkg: Add CPU RdRand access APIs for random number
 generation

Add AsmRdRand16/32/64 APIs for RdRand instruction access to generate
high-quality random number.

(Sync patch r18518 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18785 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/BaseLib.h       | 51 ++++++++++++++
 MdePkg/Library/BaseLib/BaseLib.inf     |  6 ++
 MdePkg/Library/BaseLib/Ia32/RdRand.S   | 80 ++++++++++++++++++++++
 MdePkg/Library/BaseLib/Ia32/RdRand.asm | 94 ++++++++++++++++++++++++++
 MdePkg/Library/BaseLib/X64/RdRand.S    | 72 ++++++++++++++++++++
 MdePkg/Library/BaseLib/X64/RdRand.asm  | 83 +++++++++++++++++++++++
 6 files changed, 386 insertions(+)
 create mode 100644 MdePkg/Library/BaseLib/Ia32/RdRand.S
 create mode 100644 MdePkg/Library/BaseLib/Ia32/RdRand.asm
 create mode 100644 MdePkg/Library/BaseLib/X64/RdRand.S
 create mode 100644 MdePkg/Library/BaseLib/X64/RdRand.asm

diff --git a/MdePkg/Include/Library/BaseLib.h b/MdePkg/Include/Library/BaseLib.h
index 7e10804082d1..c41fa783df2b 100644
--- a/MdePkg/Include/Library/BaseLib.h
+++ b/MdePkg/Include/Library/BaseLib.h
@@ -7647,6 +7647,57 @@ 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
+  );
+
 #endif
 #endif
 
diff --git a/MdePkg/Library/BaseLib/BaseLib.inf b/MdePkg/Library/BaseLib/BaseLib.inf
index 4a37e60fe38b..4cc86d7e5d2f 100644
--- a/MdePkg/Library/BaseLib/BaseLib.inf
+++ b/MdePkg/Library/BaseLib/BaseLib.inf
@@ -159,6 +159,7 @@
   Ia32/EnablePaging64.asm | MSFT
   Ia32/EnableCache.c | MSFT
   Ia32/DisableCache.c | MSFT
+  Ia32/RdRand.asm | MSFT
 
   Ia32/Wbinvd.asm | INTEL 
   Ia32/WriteMm7.asm | INTEL 
@@ -252,6 +253,7 @@
   Ia32/EnablePaging64.asm | INTEL
   Ia32/EnableCache.asm | INTEL
   Ia32/DisableCache.asm | INTEL
+  Ia32/RdRand.asm | INTEL
 
   Ia32/GccInline.c | GCC
   Ia32/Thunk16.nasm | GCC 
@@ -279,6 +281,7 @@
   Ia32/LShiftU64.S | GCC 
   Ia32/EnableCache.S | GCC
   Ia32/DisableCache.S | GCC
+  Ia32/RdRand.S | GCC
 
   Ia32/DivS64x64Remainder.c
   Ia32/InternalSwitchStack.c | MSFT
@@ -383,10 +386,12 @@
   X64/CpuBreakpoint.c | MSFT 
   X64/WriteMsr64.c | MSFT 
   X64/ReadMsr64.c | MSFT 
+  X64/RdRand.asm | MSFT
 
   X64/CpuBreakpoint.asm | INTEL 
   X64/WriteMsr64.asm | INTEL 
   X64/ReadMsr64.asm | INTEL 
+  X64/RdRand.asm | INTEL
 
   X64/Non-existing.c
   Math64.c
@@ -417,6 +422,7 @@
   X64/CpuIdEx.S | GCC 
   X64/EnableCache.S | GCC
   X64/DisableCache.S | GCC
+  X64/RdRand.S | GCC
   ChkStkGcc.c  | GCC 
 
 [Sources.IPF]
diff --git a/MdePkg/Library/BaseLib/Ia32/RdRand.S b/MdePkg/Library/BaseLib/Ia32/RdRand.S
new file mode 100644
index 000000000000..503f65a72107
--- /dev/null
+++ b/MdePkg/Library/BaseLib/Ia32/RdRand.S
@@ -0,0 +1,80 @@
+#------------------------------------------------------------------------------ ;
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   RdRand.S
+#
+# Abstract:
+#
+#   Generates random number through CPU RdRand instruction under 32-bit platform.
+#
+# Notes:
+#
+#------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+//  Generates a 16 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand16 (UINT16 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand16)
+ASM_PFX(AsmRdRand16):
+    .byte  0x0f, 0xc7, 0xf0        // rdrand r16: "0f c7 /6  ModRM:r/m(w)"
+    jc     rn16_ok                 // jmp if CF=1
+    xor    %eax, %eax              // reg=0 if CF=0
+    ret                            // return with failure status
+rn16_ok:
+    mov    0x4(%esp), %edx
+    mov    %ax, (%edx)
+    mov    $0x1, %eax
+    ret
+
+//------------------------------------------------------------------------------
+//  Generates a 32 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand32 (UINT32 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand32)
+ASM_PFX(AsmRdRand32):
+    .byte  0x0f, 0xc7, 0xf0        // rdrand r32: "0f c7 /6  ModRM:r/m(w)"
+    jc     rn32_ok                 // jmp if CF=1
+    xor    %eax, %eax              // reg=0 if CF=0
+    ret                            // return with failure status
+rn32_ok:
+    mov    0x4(%esp), %edx
+    mov    %eax, (%edx)
+    mov    $0x1, %eax
+    ret
+
+//------------------------------------------------------------------------------
+//  Generates a 64 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand64 (UINT64 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand64)
+ASM_PFX(AsmRdRand64):
+    .byte  0x0f, 0xc7, 0xf0        // rdrand r32: "0f c7 /6  ModRM:r/m(w)"
+    jnc    rn64_ret                // jmp if CF=0
+    mov    0x4(%esp), %edx
+    mov    %eax, (%edx)
+
+    .byte  0x0f, 0xc7, 0xf0        // generate another 32 bit RN
+    jnc    rn64_ret                // jmp if CF=0
+    mov    %eax, 0x4(%edx)
+
+    mov    $0x1, %eax
+    ret
+rn64_ret:
+    xor    %eax, %eax
+    ret                            // return with failure status
diff --git a/MdePkg/Library/BaseLib/Ia32/RdRand.asm b/MdePkg/Library/BaseLib/Ia32/RdRand.asm
new file mode 100644
index 000000000000..21349b0918d4
--- /dev/null
+++ b/MdePkg/Library/BaseLib/Ia32/RdRand.asm
@@ -0,0 +1,94 @@
+;------------------------------------------------------------------------------
+;
+; Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   RdRand.asm
+;
+; Abstract:
+;
+;   Generates random number through CPU RdRand instruction under 32-bit platform.
+;
+; Notes:
+;
+;------------------------------------------------------------------------------
+
+.686P
+.model flat, C
+
+.code
+
+;------------------------------------------------------------------------------
+;  Generates a 16 bit random number through RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand16 (UINT16 *Rand);
+;------------------------------------------------------------------------------
+AsmRdRand16  PROC
+    ; rdrand   ax                  ; generate a 16 bit RN into ax
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     0fh, 0c7h, 0f0h         ; rdrand r16: "0f c7 /6  ModRM:r/m(w)"
+    jc     rn16_ok                 ; jmp if CF=1
+    xor    eax, eax                ; reg=0 if CF=0
+    ret                            ; return with failure status
+rn16_ok:
+    mov    edx, dword ptr [esp + 4]
+    mov    [edx], ax
+    mov    eax,  1
+    ret
+AsmRdRand16 ENDP
+
+;------------------------------------------------------------------------------
+;  Generates a 32 bit random number through RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand32 (UINT32 *Rand);
+;------------------------------------------------------------------------------
+AsmRdRand32  PROC
+    ; rdrand   eax                 ; generate a 32 bit RN into eax
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     0fh, 0c7h, 0f0h         ; rdrand r32: "0f c7 /6  ModRM:r/m(w)"
+    jc     rn32_ok                 ; jmp if CF=1
+    xor    eax, eax                ; reg=0 if CF=0
+    ret                            ; return with failure status
+rn32_ok:
+    mov    edx, dword ptr [esp + 4]
+    mov    [edx], eax
+    mov    eax,  1
+    ret
+AsmRdRand32 ENDP
+
+;------------------------------------------------------------------------------
+;  Generates a 64 bit random number through RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand64 (UINT64 *Rand);
+;------------------------------------------------------------------------------
+AsmRdRand64  PROC
+    ; rdrand   eax                 ; generate a 32 bit RN into eax
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     0fh, 0c7h, 0f0h         ; rdrand r32: "0f c7 /6  ModRM:r/m(w)"
+    jnc    rn64_ret                ; jmp if CF=0
+    mov    edx, dword ptr [esp + 4]
+    mov    [edx], eax
+
+    db     0fh, 0c7h, 0f0h         ; generate another 32 bit RN
+    jnc    rn64_ret                ; jmp if CF=0
+    mov    [edx + 4], eax
+
+    mov    eax,  1
+    ret
+rn64_ret:
+    xor    eax, eax
+    ret                            ; return with failure status
+AsmRdRand64 ENDP
+
+    END
diff --git a/MdePkg/Library/BaseLib/X64/RdRand.S b/MdePkg/Library/BaseLib/X64/RdRand.S
new file mode 100644
index 000000000000..49b50e69013d
--- /dev/null
+++ b/MdePkg/Library/BaseLib/X64/RdRand.S
@@ -0,0 +1,72 @@
+#------------------------------------------------------------------------------ ;
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   RdRand.S
+#
+# Abstract:
+#
+#   Generates random number through CPU RdRand instruction under 64-bit platform.
+#
+# Notes:
+#
+#------------------------------------------------------------------------------
+
+//------------------------------------------------------------------------------
+//  Generates a 16 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand16 (UINT16 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand16)
+ASM_PFX(AsmRdRand16):
+    .byte  0x0f, 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    %ax, (%rcx)
+    mov    $0x1, %rax
+    ret
+
+//------------------------------------------------------------------------------
+//  Generates a 32 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand32 (UINT32 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand32)
+ASM_PFX(AsmRdRand32):
+    .byte  0x0f, 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    %eax, (%rcx)
+    mov    $0x1, %rax
+    ret
+
+//------------------------------------------------------------------------------
+//  Generates a 64 bit random number through RDRAND instruction.
+//  Return TRUE if Rand generated successfully, or FALSE if not.
+//
+//  BOOLEAN EFIAPI AsmRdRand64 (UINT64 *Rand);
+//------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmRdRand64)
+ASM_PFX(AsmRdRand64):
+    .byte  0x48, 0x0f, 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    %rax, (%rcx)
+    mov    $0x1, %rax
+    ret
diff --git a/MdePkg/Library/BaseLib/X64/RdRand.asm b/MdePkg/Library/BaseLib/X64/RdRand.asm
new file mode 100644
index 000000000000..370cdb607a70
--- /dev/null
+++ b/MdePkg/Library/BaseLib/X64/RdRand.asm
@@ -0,0 +1,83 @@
+;------------------------------------------------------------------------------
+;
+; Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   RdRand.asm
+;
+; Abstract:
+;
+;   Generates random number through CPU RdRand instruction under 64-bit platform.
+;
+; Notes:
+;
+;------------------------------------------------------------------------------
+
+    .code
+
+;------------------------------------------------------------------------------
+;  Generates a 16 bit random number through RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand16 (UINT16 *Rand);
+;------------------------------------------------------------------------------
+AsmRdRand16  PROC
+    ; rdrand   ax                  ; generate a 16 bit RN into eax,
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     0fh, 0c7h, 0f0h         ; 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
+AsmRdRand16 ENDP
+
+;------------------------------------------------------------------------------
+;  Generates a 32 bit random number through RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand32 (UINT32 *Rand);
+;------------------------------------------------------------------------------
+AsmRdRand32  PROC
+    ; rdrand   eax                 ; generate a 32 bit RN into eax,
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     0fh, 0c7h, 0f0h         ; 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
+AsmRdRand32 ENDP
+
+;------------------------------------------------------------------------------
+;  Generates a 64 bit random number through one RDRAND instruction.
+;  Return TRUE if Rand generated successfully, or FALSE if not.
+;
+;  BOOLEAN EFIAPI AsmRdRand64 (UINT64 *Random);
+;------------------------------------------------------------------------------
+AsmRdRand64  PROC
+    ; rdrand   rax                 ; generate a 64 bit RN into rax,
+                                   ; CF=1 if RN generated ok, otherwise CF=0
+    db     048h, 0fh, 0c7h, 0f0h   ; 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
+AsmRdRand64 ENDP
+
+    END

From 8b5a1bf12b775a84278b6d7a4e1970a6729b8b77 Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Mon, 16 Nov 2015 06:38:54 +0000
Subject: [PATCH 071/525] MdePkg: Add RngLib into MdePkg

Add one library class (RngLib.h) with three GetRandomNumber16/32/64
APIs to provide random number generator services, and one library
instance (BaseRngLib), based on Intel RdRand instruction access,
to provide high-quality random numbers generator.

(Sync patch r18519 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18786 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/RngLib.h          |  69 ++++++++++
 MdePkg/Library/BaseRngLib/BaseRng.c      | 157 +++++++++++++++++++++++
 MdePkg/Library/BaseRngLib/BaseRngLib.inf |  41 ++++++
 MdePkg/Library/BaseRngLib/BaseRngLib.uni | Bin 0 -> 1878 bytes
 MdePkg/MdePkg.dec                        |   4 +
 MdePkg/MdePkg.dsc                        |   1 +
 6 files changed, 272 insertions(+)
 create mode 100644 MdePkg/Include/Library/RngLib.h
 create mode 100644 MdePkg/Library/BaseRngLib/BaseRng.c
 create mode 100644 MdePkg/Library/BaseRngLib/BaseRngLib.inf
 create mode 100644 MdePkg/Library/BaseRngLib/BaseRngLib.uni

diff --git a/MdePkg/Include/Library/RngLib.h b/MdePkg/Include/Library/RngLib.h
new file mode 100644
index 000000000000..157a93139c24
--- /dev/null
+++ b/MdePkg/Include/Library/RngLib.h
@@ -0,0 +1,69 @@
+/** @file
+  Provides random number generator services.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __RNG_LIB_H__
+#define __RNG_LIB_H__
+
+/**
+  Generates a 16-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 16-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber16 (
+  OUT     UINT16                    *Rand
+  );
+
+/**
+  Generates a 32-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 32-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber32 (
+  OUT     UINT32                    *Rand
+  );
+
+/**
+  Generates a 64-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 64-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber64 (
+  OUT     UINT64                    *Rand
+  );
+
+#endif  // __RNG_LIB_H__
diff --git a/MdePkg/Library/BaseRngLib/BaseRng.c b/MdePkg/Library/BaseRngLib/BaseRng.c
new file mode 100644
index 000000000000..279df3013c9f
--- /dev/null
+++ b/MdePkg/Library/BaseRngLib/BaseRng.c
@@ -0,0 +1,157 @@
+/** @file
+  Random number generator services that uses RdRand instruction access
+  to provide high-quality random numbers.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+
+//
+// Bit mask used to determine if RdRand instruction is supported.
+//
+#define RDRAND_MASK                  BIT30
+
+//
+// Limited retry number when valid random data is returned.
+// Uses the recommended value defined in Section 7.3.17 of "Intel 64 and IA-32
+// Architectures Software Developer's Mannual".
+//
+#define RDRAND_RETRY_LIMIT           10
+
+/**
+  The constructor function checks whether or not RDRAND instruction is supported
+  by the host hardware.
+
+  The constructor function checks whether or not RDRAND instruction is supported.
+  It will ASSERT() if RDRAND instruction is not supported.
+  It will always return RETURN_SUCCESS.
+
+  @retval RETURN_SUCCESS   The constructor always returns EFI_SUCCESS.
+
+**/
+RETURN_STATUS
+EFIAPI
+BaseRngLibConstructor (
+  VOID
+  )
+{
+  UINT32  RegEcx;
+
+  //
+  // Determine RDRAND support by examining bit 30 of the ECX register returned by
+  // CPUID. A value of 1 indicates that processor support RDRAND instruction.
+  //
+  AsmCpuid (1, 0, 0, &RegEcx, 0);
+  ASSERT ((RegEcx & RDRAND_MASK) == RDRAND_MASK);
+
+  return RETURN_SUCCESS;
+}
+
+/**
+  Generates a 16-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 16-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber16 (
+  OUT     UINT16                    *Rand
+  )
+{
+  UINT32  Index;
+
+  ASSERT (Rand != NULL);
+
+  //
+  // A loop to fetch a 16 bit random value with a retry count limit.
+  //
+  for (Index = 0; Index < RDRAND_RETRY_LIMIT; Index++) {
+    if (AsmRdRand16 (Rand)) {
+      return TRUE;
+    }
+  }
+
+  return FALSE;
+}
+
+/**
+  Generates a 32-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 32-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber32 (
+  OUT     UINT32                    *Rand
+  )
+{
+  UINT32  Index;
+
+  ASSERT (Rand != NULL);
+
+  //
+  // A loop to fetch a 32 bit random value with a retry count limit.
+  //
+  for (Index = 0; Index < RDRAND_RETRY_LIMIT; Index++) {
+    if (AsmRdRand32 (Rand)) {
+      return TRUE;
+    }
+  }
+
+  return FALSE;
+}
+
+/**
+  Generates a 64-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 64-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber64 (
+  OUT     UINT64                    *Rand
+  )
+{
+  UINT32  Index;
+
+  ASSERT (Rand != NULL);
+
+  //
+  // A loop to fetch a 64 bit random value with a retry count limit.
+  //
+  for (Index = 0; Index < RDRAND_RETRY_LIMIT; Index++) {
+    if (AsmRdRand64 (Rand)) {
+      return TRUE;
+    }
+  }
+
+  return FALSE;
+}
diff --git a/MdePkg/Library/BaseRngLib/BaseRngLib.inf b/MdePkg/Library/BaseRngLib/BaseRngLib.inf
new file mode 100644
index 000000000000..05a5b77dc351
--- /dev/null
+++ b/MdePkg/Library/BaseRngLib/BaseRngLib.inf
@@ -0,0 +1,41 @@
+## @file
+#  Instance of RNG (Random Number Generator) Library.
+#
+#  BaseRng Library that uses CPU RdRand instruction access to provide
+#  high-quality random numbers.
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BaseRngLib
+  MODULE_UNI_FILE                = BaseRngLib.uni
+  FILE_GUID                      = 626440D8-1971-41D9-9AB2-FB25F4AE79BC
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = RngLib
+  CONSTRUCTOR                    = BaseRngLibConstructor
+
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources.Ia32, Sources.X64]
+  BaseRng.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib
diff --git a/MdePkg/Library/BaseRngLib/BaseRngLib.uni b/MdePkg/Library/BaseRngLib/BaseRngLib.uni
new file mode 100644
index 0000000000000000000000000000000000000000..3d6e905d79a40b0c90329a576bcdb193cee6cf06
GIT binary patch
literal 1878
zcmd6nU2hUW6o${WiT`0kZ>niQO}sJ2Sjt+7TF3&aUNs9?*n|S^QYwF5ecl;%2W<Vi
zGn?I+IiK%&&zb%Htziv|cpvjb_S&v2vzdLihxP!ebZwhkVJk~nM`$8jU=>+n=XS<=
z$WFR3@@vlLcEdWvGUs&0I(Pe&7z<>NkiI9&kbTO#v3iv)WNo4=@JsNX-0_HrHN|3u
z=Em6->`tv~1J(pAC8mf>9)FJI2#*XDbF5NMs;A&lyanGScow$CW{f7FnIf5x@z}l)
zC5533j}0EGA=EzKslB+ju2bSK@yxdoRly-R#L6>!Vo&Y49kCbdD=^I1%O}T6U)Ag@
zsG~VSFN+XOwdAfU@xNv_2FFWl!pN(tqEK0%sxrrbuYKZjsE@ub&$PPk`BIOUPPf6&
z_vYH6QofAcjA$XgIxKH7CbrcJVG8l(Ew&|D^J@N5rbAPx?uuPMOX|5~;w1-%YAsQY
zU`Lkfi|0pLKdGf((|XoIs_6?@0@ho{#fb0SYBO^BIVt&4F5L@NJp^Z&SA7wyLVAVV
zcSxAOV)HYmeO@A}O5I%P{>Xo^Wk85lJG@Rgt?0xHcS|)>o?F@HuDZILmkIj)90igg
z$j40czNSu;DQ~!ss^qQ3An7tc9d2{N%zfb8hRX;xwf2#=nXm!7*fBidFVJG2U{gj2
z?6;Zd7>k~Z++n9l*0;v0xQbe1ZMw5gM?1A&pjXt6%NW@OR*6G)j=W7&#pt-~2`6Ef
zOga15%0^ke)f;S;{S)guG(xT$7;m%qDq{Os#R<{daM5L+l(V(NTbL>RR~rtyWO@&(
zsqweR^LI(44lxEqi|rCb;!Dh)z*ZkTzj_YnqHe*2&Zm4eH=2cGVhL#tbie<D>pq0P
kajio8cSzOe9vC$P-HO}$(Eb_e|M1t3++X0||Mr2mAF7cjiU0rr

literal 0
HcmV?d00001

diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
index 60549afaaafc..337059a6a602 100644
--- a/MdePkg/MdePkg.dec
+++ b/MdePkg/MdePkg.dec
@@ -249,6 +249,10 @@
   #
   SmmPeriodicSmiLib|Include/Library/SmmPeriodicSmiLib.h
 
+  ##  @libraryclass  Provides services to generate random number.
+  #
+  RngLib|Include/Library/RngLib.h
+
 [LibraryClasses.IPF]
   ##  @libraryclass  The SAL Library provides a service to make a SAL CALL.
   SalLib|Include/Library/SalLib.h
diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index 89fc6304c4a3..e8a3ea76332e 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -151,6 +151,7 @@
   MdePkg/Library/BaseS3SmbusLib/BaseS3SmbusLib.inf
   MdePkg/Library/BaseS3StallLib/BaseS3StallLib.inf
   MdePkg/Library/SmmMemLib/SmmMemLib.inf
+  MdePkg/Library/BaseRngLib/BaseRngLib.inf
 
 [Components.IPF]
   MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf

From afcd7b24c523edfa9f562c07a47f3f3c62cc0752 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Mon, 16 Nov 2015 06:48:33 +0000
Subject: [PATCH 072/525] MdeModulePkg: Add SMBIOS 3.0 support in
 NetLibGetSystemGuid.

NetLibGetSystemGuid gets the UUID from SMBIOS table to use as the System GUID
(in DHCP and other network use cases). This change adds support to get the
UUID from either SMBIOS 2.x or 3.0, since SMBIOS 3.0 uses a different GUID in
the System Configuration Table.

(Sync patch r18559 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18787 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/DxeNetLib/DxeNetLib.c   | 30 ++++++++++++--------
 MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf |  2 ++
 2 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Library/DxeNetLib/DxeNetLib.c b/MdeModulePkg/Library/DxeNetLib/DxeNetLib.c
index 57e8f9f27b0d..e112d45ef21c 100644
--- a/MdeModulePkg/Library/DxeNetLib/DxeNetLib.c
+++ b/MdeModulePkg/Library/DxeNetLib/DxeNetLib.c
@@ -2,6 +2,7 @@
   Network library.
 
 Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -3254,22 +3255,27 @@ NetLibGetSystemGuid (
   OUT EFI_GUID              *SystemGuid
   )
 {
-  EFI_STATUS                Status;
-  SMBIOS_TABLE_ENTRY_POINT  *SmbiosTable;
-  SMBIOS_STRUCTURE_POINTER  Smbios;
-  SMBIOS_STRUCTURE_POINTER  SmbiosEnd;
-  CHAR8                     *String;
+  EFI_STATUS                    Status;
+  SMBIOS_TABLE_ENTRY_POINT      *SmbiosTable;
+  SMBIOS_TABLE_3_0_ENTRY_POINT  *Smbios30Table;
+  SMBIOS_STRUCTURE_POINTER      Smbios;
+  SMBIOS_STRUCTURE_POINTER      SmbiosEnd;
+  CHAR8                         *String;
 
   SmbiosTable = NULL;
-  Status      = EfiGetSystemConfigurationTable (&gEfiSmbiosTableGuid, (VOID **) &SmbiosTable);
-
-  if (EFI_ERROR (Status) || SmbiosTable == NULL) {
-    return EFI_NOT_FOUND;
+  Status = EfiGetSystemConfigurationTable (&gEfiSmbios3TableGuid, (VOID **) &Smbios30Table);
+  if (!(EFI_ERROR (Status) || Smbios30Table == NULL)) {
+    Smbios.Hdr = (SMBIOS_STRUCTURE *) (UINTN) Smbios30Table->TableAddress;
+    SmbiosEnd.Raw = (UINT8 *) (UINTN) (Smbios30Table->TableAddress + Smbios30Table->TableMaximumSize);
+  } else {
+    Status = EfiGetSystemConfigurationTable (&gEfiSmbiosTableGuid, (VOID **) &SmbiosTable);
+    if (EFI_ERROR (Status) || SmbiosTable == NULL) {
+      return EFI_NOT_FOUND;
+    }
+    Smbios.Hdr    = (SMBIOS_STRUCTURE *) (UINTN) SmbiosTable->TableAddress;
+    SmbiosEnd.Raw = (UINT8 *) (UINTN) (SmbiosTable->TableAddress + SmbiosTable->TableLength);
   }
 
-  Smbios.Hdr    = (SMBIOS_STRUCTURE *) (UINTN) SmbiosTable->TableAddress;
-  SmbiosEnd.Raw = (UINT8 *) (UINTN) (SmbiosTable->TableAddress + SmbiosTable->TableLength);
-
   do {
     if (Smbios.Hdr->Type == 1) {
       if (Smbios.Hdr->Length < 0x19) {
diff --git a/MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf b/MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf
index 50fbcc24b503..1ff3a4fe556a 100644
--- a/MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf
+++ b/MdeModulePkg/Library/DxeNetLib/DxeNetLib.inf
@@ -2,6 +2,7 @@
 #  This library instance provides the basic network services.
 #
 #  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+#  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution.  The full text of the license may be found at
@@ -52,6 +53,7 @@
 
 [Guids]
   gEfiSmbiosTableGuid                           ## SOMETIMES_CONSUMES  ## SystemTable
+  gEfiSmbios3TableGuid                          ## SOMETIMES_CONSUMES  ## SystemTable
 
 
 [Protocols]

From faf34685caed686109e68f2d7b55a3e3852852a6 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Mon, 16 Nov 2015 06:49:28 +0000
Subject: [PATCH 073/525] MdeModulePkg Ip4Dxe: Ip4Config2 to request DHCP
 Option6 DNS server IP

Ip4Config2 protocol implementation must request for DNS server info when the
policy is set to DHCP. And when a DHCP server responds to it with a list of
DNS server addresses, it must parse it and set it for the instance. Without
this, nobody can do a Ip4Config->GetData for DNS server IPs before calling
Dns->Configure(). This will mean a DHCP is initiated when calling
Dns->Configure(), thus causing serious performance issues. This patch
attempts to address this issue.

(Sync patch r18560 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18788 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/Network/Ip4Dxe/Ip4Config2Impl.c | 258 +++++++++++-------
 .../Universal/Network/Ip4Dxe/Ip4Config2Impl.h |   4 +-
 2 files changed, 168 insertions(+), 94 deletions(-)

diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.c b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.c
index 637d7cd65993..edbddba02118 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.c
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.c
@@ -2,6 +2,7 @@
   The implementation of EFI IPv4 Configuration II Protocol.
 
   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -677,6 +678,126 @@ Ip4Config2CleanDhcp4 (
   }
 }
 
+/**
+  This worker function sets the DNS server list for the EFI IPv4 network
+  stack running on the communication device that this EFI_IP4_CONFIG2_PROTOCOL
+  manages. The DNS server addresses must be unicast IPv4 addresses. 
+
+  @param[in]     Instance        The pointer to the IP4 config2 instance data.
+  @param[in]     DataSize        The size of the buffer pointed to by Data in bytes.
+  @param[in]     Data            The data buffer to set, points to an array of
+                                 EFI_IPv4_ADDRESS instances.
+
+  @retval EFI_BAD_BUFFER_SIZE    The DataSize does not match the size of the type.
+  @retval EFI_INVALID_PARAMETER  One or more fields in Data is invalid.
+  @retval EFI_OUT_OF_RESOURCES   Failed to allocate resources to complete the operation.
+  @retval EFI_ABORTED            The DNS server addresses to be set equal the current
+                                 configuration.
+  @retval EFI_SUCCESS            The specified configuration data for the EFI IPv4
+                                 network stack was set.
+
+**/
+EFI_STATUS
+Ip4Config2SetDnsServerWorker (
+  IN IP4_CONFIG2_INSTANCE    *Instance,
+  IN UINTN                   DataSize,
+  IN VOID                    *Data
+  )
+{
+  UINTN                 OldIndex;
+  UINTN                 NewIndex;
+  UINTN                 Index1;
+  EFI_IPv4_ADDRESS      *OldDns;
+  EFI_IPv4_ADDRESS      *NewDns;
+  UINTN                 OldDnsCount;
+  UINTN                 NewDnsCount;
+  IP4_CONFIG2_DATA_ITEM *Item;
+  BOOLEAN               OneAdded;
+  VOID                  *Tmp;
+  IP4_ADDR              DnsAddress;
+
+  if ((DataSize % sizeof (EFI_IPv4_ADDRESS) != 0) || (DataSize == 0)) {
+    return EFI_BAD_BUFFER_SIZE;
+  }
+
+  Item        = &Instance->DataItem[Ip4Config2DataTypeDnsServer];
+  NewDns      = (EFI_IPv4_ADDRESS *) Data;
+  OldDns      = Item->Data.DnsServers;
+  NewDnsCount = DataSize / sizeof (EFI_IPv4_ADDRESS);  
+  OldDnsCount = Item->DataSize / sizeof (EFI_IPv4_ADDRESS);
+  OneAdded    = FALSE;
+
+  if (NewDnsCount != OldDnsCount) {
+    Tmp = AllocatePool (DataSize);
+    if (Tmp == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+  } else {
+    Tmp = NULL;
+  }
+
+  for (NewIndex = 0; NewIndex < NewDnsCount; NewIndex++) {
+    CopyMem (&DnsAddress, NewDns + NewIndex, sizeof (IP4_ADDR));
+
+    if (!NetIp4IsUnicast (NTOHL (DnsAddress), 0)) {
+      //
+      // The dns server address must be unicast.
+      //
+      FreePool (Tmp);
+      return EFI_INVALID_PARAMETER;
+    }
+
+    for (Index1 = NewIndex + 1; Index1 < NewDnsCount; Index1++) {
+      if (EFI_IP4_EQUAL (NewDns + NewIndex, NewDns + Index1)) {
+        FreePool (Tmp);
+        return EFI_INVALID_PARAMETER;
+      }
+    }
+
+    if (OneAdded) {
+      //
+      // If any address in the new setting is not in the old settings, skip the
+      // comparision below.
+      //
+      continue;
+    }
+
+    for (OldIndex = 0; OldIndex < OldDnsCount; OldIndex++) {
+      if (EFI_IP4_EQUAL (NewDns + NewIndex, OldDns + OldIndex)) {
+        //
+        // If found break out.
+        //
+        break;
+      }
+    }
+
+    if (OldIndex == OldDnsCount) {
+      OneAdded = TRUE;
+    }
+  }
+
+  if (!OneAdded && (DataSize == Item->DataSize)) {
+    //
+    // No new item is added and the size is the same.
+    //
+    Item->Status = EFI_SUCCESS;
+    return EFI_ABORTED;
+  } else {
+    if (Tmp != NULL) {
+      if (Item->Data.Ptr != NULL) {
+        FreePool (Item->Data.Ptr);
+      }      
+      Item->Data.Ptr = Tmp;
+    }
+
+    CopyMem (Item->Data.Ptr, Data, DataSize);
+    Item->DataSize = DataSize;
+    Item->Status   = EFI_SUCCESS;
+    return EFI_SUCCESS;
+  }
+}
+
+
 
 /**
   Callback function when DHCP process finished. It will save the
@@ -701,6 +822,9 @@ Ip4Config2OnDhcp4Complete (
   IP4_ADDR                  StationAddress;
   IP4_ADDR                  SubnetMask;
   IP4_ADDR                  GatewayAddress;
+  UINT32                    Index;
+  UINT32                    OptionCount;
+  EFI_DHCP4_PACKET_OPTION   **OptionList;
 
   Instance = (IP4_CONFIG2_INSTANCE *) Context;
   ASSERT (Instance->Dhcp4 != NULL);
@@ -724,6 +848,44 @@ Ip4Config2OnDhcp4Complete (
       goto Exit;
     }
   
+    //
+    // Parse the ACK to get required DNS server information.
+    //
+    OptionCount = 0;
+    OptionList  = NULL;
+
+    Status      = Instance->Dhcp4->Parse (Instance->Dhcp4, Dhcp4Mode.ReplyPacket, &OptionCount, OptionList);
+    if (Status != EFI_BUFFER_TOO_SMALL) {
+      goto Exit;
+    }
+
+    OptionList = AllocateZeroPool (OptionCount * sizeof (EFI_DHCP4_PACKET_OPTION *));
+    if (OptionList == NULL) {
+      goto Exit;
+    }
+
+    Status = Instance->Dhcp4->Parse (Instance->Dhcp4, Dhcp4Mode.ReplyPacket, &OptionCount, OptionList);
+    if (EFI_ERROR (Status)) {
+      FreePool (OptionList);
+      goto Exit;
+    }
+
+    for (Index = 0; Index < OptionCount; Index++) {
+      //
+      // Look for DNS Server opcode (6).
+      //
+      if (OptionList[Index]->OpCode == DHCP_TAG_DNS_SERVER) {
+        if (((OptionList[Index]->Length & 0x3) != 0) || (OptionList[Index]->Length == 0)) {
+          break;
+        }
+
+        Ip4Config2SetDnsServerWorker (Instance, OptionList[Index]->Length, &OptionList[Index]->Data[0]);
+        break;
+      }
+    }
+
+    FreePool (OptionList);
+
     Instance->DhcpSuccess = TRUE;
   }
 
@@ -831,9 +993,10 @@ Ip4StartAutoConfig (
   // yields the control of this DHCP service to us.
   //
   ParaList.Head.OpCode             = DHCP_TAG_PARA_LIST;
-  ParaList.Head.Length             = 2;
+  ParaList.Head.Length             = 3;
   ParaList.Head.Data[0]            = DHCP_TAG_NETMASK;
   ParaList.Route                   = DHCP_TAG_ROUTER;
+  ParaList.Dns                     = DHCP_TAG_DNS_SERVER;
   OptionList[0]                    = &ParaList.Head;
   Dhcp4Mode.ConfigData.OptionCount = 1;
   Dhcp4Mode.ConfigData.OptionList  = OptionList;
@@ -1293,102 +1456,11 @@ Ip4Config2SetDnsServer (
   IN VOID                 *Data
   )
 {
-  UINTN                 OldIndex;
-  UINTN                 NewIndex;
-  UINTN                 Index1;
-  EFI_IPv4_ADDRESS      *OldDns;
-  EFI_IPv4_ADDRESS      *NewDns;
-  UINTN                 OldDnsCount;
-  UINTN                 NewDnsCount;
-  IP4_CONFIG2_DATA_ITEM *Item;
-  BOOLEAN               OneAdded;
-  VOID                  *Tmp;
-  IP4_ADDR              DnsAddress;
-
-  if ((DataSize % sizeof (EFI_IPv4_ADDRESS) != 0) || (DataSize == 0)) {
-    return EFI_BAD_BUFFER_SIZE;
-  }
-
   if (Instance->Policy != Ip4Config2PolicyStatic) {
     return EFI_WRITE_PROTECTED;
   }
 
-  Item        = &Instance->DataItem[Ip4Config2DataTypeDnsServer];
-  NewDns      = (EFI_IPv4_ADDRESS *) Data;
-  OldDns      = Item->Data.DnsServers;
-  NewDnsCount = DataSize / sizeof (EFI_IPv4_ADDRESS);
-  OldDnsCount = Item->DataSize / sizeof (EFI_IPv4_ADDRESS);
-  OneAdded    = FALSE;
-
-  if (NewDnsCount != OldDnsCount) {
-    Tmp = AllocatePool (DataSize);
-    if (Tmp == NULL) {
-      return EFI_OUT_OF_RESOURCES;
-    }
-  } else {
-    Tmp = NULL;
-  }
-
-  for (NewIndex = 0; NewIndex < NewDnsCount; NewIndex++) {
-    CopyMem (&DnsAddress, NewDns + NewIndex, sizeof (IP4_ADDR));
-
-    if (!NetIp4IsUnicast (NTOHL (DnsAddress), 0)) {
-      //
-      // The dns server address must be unicast.
-      //
-      FreePool (Tmp);
-      return EFI_INVALID_PARAMETER;
-    }
-
-    for (Index1 = NewIndex + 1; Index1 < NewDnsCount; Index1++) {
-      if (EFI_IP4_EQUAL (NewDns + NewIndex, NewDns + Index1)) {
-        FreePool (Tmp);
-        return EFI_INVALID_PARAMETER;
-      }
-    }
-
-    if (OneAdded) {
-      //
-      // If any address in the new setting is not in the old settings, skip the
-      // comparision below.
-      //
-      continue;
-    }
-
-    for (OldIndex = 0; OldIndex < OldDnsCount; OldIndex++) {
-      if (EFI_IP4_EQUAL (NewDns + NewIndex, OldDns + OldIndex)) {
-        //
-        // If found break out.
-        //
-        break;
-      }
-    }
-
-    if (OldIndex == OldDnsCount) {
-      OneAdded = TRUE;
-    }
-  }
-
-  if (!OneAdded && (DataSize == Item->DataSize)) {
-    //
-    // No new item is added and the size is the same.
-    //
-    Item->Status = EFI_SUCCESS;
-    return EFI_ABORTED;
-  } else {
-    if (Tmp != NULL) {
-      if (Item->Data.Ptr != NULL) {
-        FreePool (Item->Data.Ptr);
-      }      
-      Item->Data.Ptr = Tmp;
-    }
-
-    CopyMem (Item->Data.Ptr, Data, DataSize);
-    Item->DataSize = DataSize;
-    Item->Status   = EFI_SUCCESS;
-    return EFI_SUCCESS;
-  }
-
+  return Ip4Config2SetDnsServerWorker (Instance, DataSize, Data);
 }
 
 /**
diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.h b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.h
index e74b9ae40744..ab7252564677 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.h
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Config2Impl.h
@@ -2,6 +2,7 @@
   Definitions for EFI IPv4 Configuration II Protocol implementation.
 
   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -27,7 +28,7 @@
 #define DHCP_TAG_PARA_LIST             55
 #define DHCP_TAG_NETMASK               1
 #define DHCP_TAG_ROUTER                3
-
+#define DHCP_TAG_DNS_SERVER            6
 
 #define DATA_ATTRIB_SET(Attrib, Bits)       (BOOLEAN)((Attrib) & (Bits))
 #define SET_DATA_ATTRIB(Attrib, Bits)       ((Attrib) |= (Bits))
@@ -207,6 +208,7 @@ struct _IP4_CONFIG2_INSTANCE {
 typedef struct {
   EFI_DHCP4_PACKET_OPTION Head;
   UINT8                   Route;
+  UINT8                   Dns;
 } IP4_CONFIG2_DHCP4_OPTION;
 #pragma pack()
 

From 17cc5459660dc1d49a85a2105ad34274f5df1895 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 06:50:12 +0000
Subject: [PATCH 074/525] MdeModulePkg UefiBootManagerLib: Do not assume perf
 entry count has no change

Current implementation assumes the performance entry count has no change from
multiple GetPerformanceMeasurement() while loops, it may cause the allocated buffer
for PerfEntriesAsDxeHandle at the first loop to be overflowed if the following loop has
the count changed.

This patch is also to sync the change at
commit R17851 "IntelFrameworkModulePkg GenericBdsLib: Resolve array size mismatch".

(Sync patch r18561 from main trunk.)

Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18789 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiBootManagerLib/BmPerformance.c        | 120 +++++-------------
 1 file changed, 35 insertions(+), 85 deletions(-)

diff --git a/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c b/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
index e45c0bd23a5b..0abd0194409c 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
+++ b/MdeModulePkg/Library/UefiBootManagerLib/BmPerformance.c
@@ -62,7 +62,7 @@ BmGetShortPdbFileName (
     for (Index = StartIndex; Index < EndIndex; Index++) {
       GaugeString[Index1] = PdbFileName[Index];
       Index1++;
-      if (Index1 == PERF_TOKEN_LENGTH - 1) {
+      if (Index1 == StringSize - 1) {
         break;
       }
     }
@@ -157,7 +157,7 @@ BmWriteBootToOsPerformanceData (
   UINT32                    LimitCount;
   EFI_HANDLE                *Handles;
   UINTN                     NoHandles;
-  CHAR8                     GaugeString[PERF_TOKEN_LENGTH];
+  CHAR8                     GaugeString[PERF_TOKEN_SIZE];
   UINT8                     *Ptr;
   UINT32                    Index;
   UINT64                    Ticker;
@@ -172,24 +172,14 @@ BmWriteBootToOsPerformanceData (
   UINT64                    StartValue;
   UINT64                    EndValue;
   BOOLEAN                   CountUp;
-  UINTN                     EntryIndex;
-  UINTN                     NumPerfEntries;
-  //
-  // List of flags indicating PerfEntry contains DXE handle
-  //
-  BOOLEAN                   *PerfEntriesAsDxeHandle;
   UINTN                     VarSize;
+  BOOLEAN                   Found;
 
   //
   // Record the performance data for End of BDS
   //
   PERF_END(NULL, "BDS", NULL, 0);
 
-  //
-  // Reset the entry count
-  //
-  mBmPerfHeader.Count = 0;
-
   //
   // Retrieve time stamp count as early as possible
   //
@@ -212,6 +202,11 @@ BmWriteBootToOsPerformanceData (
     CountUp            = FALSE;
   }
 
+  //
+  // Reset the entry count
+  //
+  mBmPerfHeader.Count = 0;
+
   if (mBmAcpiLowMemoryBase == 0x0FFFFFFFF) {
     VarSize = sizeof (EFI_PHYSICAL_ADDRESS);
     Status = gRT->GetVariable (
@@ -247,73 +242,10 @@ BmWriteBootToOsPerformanceData (
   Ptr        = (UINT8 *) ((UINT32) mBmAcpiLowMemoryBase + sizeof (PERF_HEADER));
   LimitCount = (UINT32) (PERF_DATA_MAX_LENGTH - sizeof (PERF_HEADER)) / sizeof (PERF_DATA);
 
-  NumPerfEntries = 0;
-  LogEntryKey    = 0;
-  while ((LogEntryKey = GetPerformanceMeasurement (
-                          LogEntryKey,
-                          &Handle,
-                          &Token,
-                          &Module,
-                          &StartTicker,
-                          &EndTicker)) != 0) {
-    NumPerfEntries++;
-  }
-  PerfEntriesAsDxeHandle = AllocateZeroPool (NumPerfEntries * sizeof (BOOLEAN));
-  ASSERT (PerfEntriesAsDxeHandle != NULL);
-  
   //
-  // Get DXE drivers performance
-  //
-  for (Index = 0; Index < NoHandles; Index++) {
-    Ticker = 0;
-    LogEntryKey = 0;
-    EntryIndex  = 0;
-    while ((LogEntryKey = GetPerformanceMeasurement (
-                            LogEntryKey,
-                            &Handle,
-                            &Token,
-                            &Module,
-                            &StartTicker,
-                            &EndTicker)) != 0) {
-      if (Handle == Handles[Index] && !PerfEntriesAsDxeHandle[EntryIndex]) {
-        PerfEntriesAsDxeHandle[EntryIndex] = TRUE;
-      }
-      EntryIndex++;
-      if ((Handle == Handles[Index]) && (EndTicker != 0)) {
-        if (StartTicker == 1) {
-          StartTicker = StartValue;
-        }
-        if (EndTicker == 1) {
-          EndTicker = StartValue;
-        }
-        Ticker += CountUp ? (EndTicker - StartTicker) : (StartTicker - EndTicker);
-      }
-    }
-
-    Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
-
-    if (Duration > 0) {
-
-      BmGetNameFromHandle (Handles[Index], GaugeString, PERF_TOKEN_LENGTH);
-
-      AsciiStrCpyS (mBmPerfData.Token, PERF_TOKEN_SIZE, GaugeString);
-      mBmPerfData.Duration = Duration;
-
-      CopyMem (Ptr, &mBmPerfData, sizeof (PERF_DATA));
-      Ptr += sizeof (PERF_DATA);
-
-      mBmPerfHeader.Count++;
-      if (mBmPerfHeader.Count == LimitCount) {
-        goto Done;
-      }
-    }
-  }
-
-  //
-  // Get inserted performance data
+  // Get performance data
   //
   LogEntryKey = 0;
-  EntryIndex  = 0;
   while ((LogEntryKey = GetPerformanceMeasurement (
                           LogEntryKey,
                           &Handle,
@@ -321,11 +253,7 @@ BmWriteBootToOsPerformanceData (
                           &Module,
                           &StartTicker,
                           &EndTicker)) != 0) {
-    if (!PerfEntriesAsDxeHandle[EntryIndex] && EndTicker != 0) {
-
-      ZeroMem (&mBmPerfData, sizeof (PERF_DATA));
-
-      AsciiStrnCpyS (mBmPerfData.Token, PERF_TOKEN_SIZE, Token, PERF_TOKEN_LENGTH);
+    if (EndTicker != 0) {
       if (StartTicker == 1) {
         StartTicker = StartValue;
       }
@@ -334,7 +262,31 @@ BmWriteBootToOsPerformanceData (
       }
       Ticker = CountUp ? (EndTicker - StartTicker) : (StartTicker - EndTicker);
 
-      mBmPerfData.Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
+      Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
+      if (Duration == 0) {
+        continue;
+      }
+
+      ZeroMem (&mBmPerfData, sizeof (PERF_DATA));
+
+      mBmPerfData.Duration = Duration;
+
+      //
+      // See if the Handle is in the handle buffer
+      //
+      Found = FALSE;
+      for (Index = 0; Index < NoHandles; Index++) {
+        if (Handle == Handles[Index]) {
+          BmGetNameFromHandle (Handles[Index], GaugeString, PERF_TOKEN_SIZE);
+          AsciiStrCpyS (mBmPerfData.Token, PERF_TOKEN_SIZE, GaugeString);
+          Found = TRUE;
+          break;
+        }
+      }
+
+      if (!Found) {
+        AsciiStrnCpyS (mBmPerfData.Token, PERF_TOKEN_SIZE, Token, PERF_TOKEN_LENGTH);
+      }
 
       CopyMem (Ptr, &mBmPerfData, sizeof (PERF_DATA));
       Ptr += sizeof (PERF_DATA);
@@ -344,13 +296,11 @@ BmWriteBootToOsPerformanceData (
         goto Done;
       }
     }
-    EntryIndex++;
   }
 
 Done:
 
   FreePool (Handles);
-  FreePool (PerfEntriesAsDxeHandle);
 
   mBmPerfHeader.Signiture = PERFORMANCE_SIGNATURE;
 

From 9a7067a328dfc9fbcc00260de363a756accb0f24 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 06:51:08 +0000
Subject: [PATCH 075/525] IntelFrameworkModulePkg GenericBdsLib: Do not assume
 perf entry count has no change

Current implementation assumes the performance entry count has no change from
multiple GetPerformanceMeasurement() while loops, it may cause the allocated buffer
for PerfEntriesAsDxeHandle at the first loop to be overflowed if the following loop has
the count changed.

This patch is also to sync the change at
commit R18417 "MdeModulePkg: Fix a performance data buffer overrun issue".

(Sync patch r18562 from main trunk.)

Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18790 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/GenericBdsLib/Performance.c       | 111 ++++++------------
 1 file changed, 33 insertions(+), 78 deletions(-)

diff --git a/IntelFrameworkModulePkg/Library/GenericBdsLib/Performance.c b/IntelFrameworkModulePkg/Library/GenericBdsLib/Performance.c
index 78039e79a578..e50345a59732 100644
--- a/IntelFrameworkModulePkg/Library/GenericBdsLib/Performance.c
+++ b/IntelFrameworkModulePkg/Library/GenericBdsLib/Performance.c
@@ -168,13 +168,8 @@ WriteBootToOsPerformanceData (
   UINT64                    StartValue;
   UINT64                    EndValue;
   BOOLEAN                   CountUp;
-  UINTN                     EntryIndex;
-  UINTN                     NumPerfEntries;
-  //
-  // List of flags indicating PerfEntry contains DXE handle
-  //
-  BOOLEAN                   *PerfEntriesAsDxeHandle;
   UINTN                     VarSize;
+  BOOLEAN                   Found;
 
   //
   // Record the performance data for End of BDS
@@ -203,6 +198,11 @@ WriteBootToOsPerformanceData (
     CountUp            = FALSE;
   }
 
+  //
+  // Reset the entry count
+  //
+  mPerfHeader.Count = 0;
+
   if (mAcpiLowMemoryBase == 0x0FFFFFFFF) {
     VarSize = sizeof (EFI_PHYSICAL_ADDRESS);
     Status = gRT->GetVariable (
@@ -238,73 +238,10 @@ WriteBootToOsPerformanceData (
   Ptr        = (UINT8 *) ((UINT32) mAcpiLowMemoryBase + sizeof (PERF_HEADER));
   LimitCount = (UINT32) (PERF_DATA_MAX_LENGTH - sizeof (PERF_HEADER)) / sizeof (PERF_DATA);
 
-  NumPerfEntries = 0;
-  LogEntryKey    = 0;
-  while ((LogEntryKey = GetPerformanceMeasurement (
-                          LogEntryKey,
-                          &Handle,
-                          &Token,
-                          &Module,
-                          &StartTicker,
-                          &EndTicker)) != 0) {
-    NumPerfEntries++;
-  }
-  PerfEntriesAsDxeHandle = AllocateZeroPool (NumPerfEntries * sizeof (BOOLEAN));
-  ASSERT (PerfEntriesAsDxeHandle != NULL);
-  
-  //
-  // Get DXE drivers performance
-  //
-  for (Index = 0; Index < NoHandles; Index++) {
-    Ticker = 0;
-    LogEntryKey = 0;
-    EntryIndex  = 0;
-    while ((LogEntryKey = GetPerformanceMeasurement (
-                            LogEntryKey,
-                            &Handle,
-                            &Token,
-                            &Module,
-                            &StartTicker,
-                            &EndTicker)) != 0) {
-      if (Handle == Handles[Index] && !PerfEntriesAsDxeHandle[EntryIndex]) {
-        PerfEntriesAsDxeHandle[EntryIndex] = TRUE;
-      }
-      EntryIndex++;
-      if ((Handle == Handles[Index]) && (EndTicker != 0)) {
-        if (StartTicker == 1) {
-          StartTicker = StartValue;
-        }
-        if (EndTicker == 1) {
-          EndTicker = StartValue;
-        }
-        Ticker += CountUp ? (EndTicker - StartTicker) : (StartTicker - EndTicker);
-      }
-    }
-
-    Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
-
-    if (Duration > 0) {
-
-      GetNameFromHandle (Handles[Index], GaugeString);
-
-      AsciiStrCpyS (mPerfData.Token, PERF_TOKEN_SIZE, GaugeString);
-      mPerfData.Duration = Duration;
-
-      CopyMem (Ptr, &mPerfData, sizeof (PERF_DATA));
-      Ptr += sizeof (PERF_DATA);
-
-      mPerfHeader.Count++;
-      if (mPerfHeader.Count == LimitCount) {
-        goto Done;
-      }
-    }
-  }
-
   //
-  // Get inserted performance data
+  // Get performance data
   //
   LogEntryKey = 0;
-  EntryIndex  = 0;
   while ((LogEntryKey = GetPerformanceMeasurement (
                           LogEntryKey,
                           &Handle,
@@ -312,11 +249,7 @@ WriteBootToOsPerformanceData (
                           &Module,
                           &StartTicker,
                           &EndTicker)) != 0) {
-    if (!PerfEntriesAsDxeHandle[EntryIndex] && EndTicker != 0) {
-
-      ZeroMem (&mPerfData, sizeof (PERF_DATA));
-
-      AsciiStrnCpyS (mPerfData.Token, PERF_TOKEN_SIZE, Token, PERF_TOKEN_LENGTH);
+    if (EndTicker != 0) {
       if (StartTicker == 1) {
         StartTicker = StartValue;
       }
@@ -325,7 +258,31 @@ WriteBootToOsPerformanceData (
       }
       Ticker = CountUp ? (EndTicker - StartTicker) : (StartTicker - EndTicker);
 
-      mPerfData.Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
+      Duration = (UINT32) DivU64x32 (Ticker, (UINT32) Freq);
+      if (Duration == 0) {
+        continue;
+      }
+
+      ZeroMem (&mPerfData, sizeof (PERF_DATA));
+
+      mPerfData.Duration = Duration;
+
+      //
+      // See if the Handle is in the handle buffer
+      //
+      Found = FALSE;
+      for (Index = 0; Index < NoHandles; Index++) {
+        if (Handle == Handles[Index]) {
+          GetNameFromHandle (Handles[Index], GaugeString);
+          AsciiStrCpyS (mPerfData.Token, PERF_TOKEN_SIZE, GaugeString);
+          Found = TRUE;
+          break;
+        }
+      }
+
+      if (!Found) {
+        AsciiStrnCpyS (mPerfData.Token, PERF_TOKEN_SIZE, Token, PERF_TOKEN_LENGTH);
+      }
 
       CopyMem (Ptr, &mPerfData, sizeof (PERF_DATA));
       Ptr += sizeof (PERF_DATA);
@@ -335,13 +292,11 @@ WriteBootToOsPerformanceData (
         goto Done;
       }
     }
-    EntryIndex++;
   }
 
 Done:
 
   FreePool (Handles);
-  FreePool (PerfEntriesAsDxeHandle);
 
   mPerfHeader.Signiture = PERFORMANCE_SIGNATURE;
 

From 472fdf0e4c2da40120ec489f9899e3bb3934328b Mon Sep 17 00:00:00 2001
From: Thomas Palmer <thomas.palmer@hpe.com>
Date: Mon, 16 Nov 2015 06:52:09 +0000
Subject: [PATCH 076/525] MdePkg: Create GetRandomNumber128 in RngLib

Declare GetRandomNumber128 in RngLib.h.
Create GetRandomNumber128 in BaseRngLib, which is simply calling
GetRandomNumber64 twice.

A GetRandomNumber128 function allows platforms with 128bit HWRNGs to
save on IO overhead that comes from having to prime the HWRNG device
before each read operation.
Using the HWRNG installed on the HP ProLiant m400 moonshot cartridge,
this will save about 50ms per RAW Entropy operation as compared with
calling GetRandomNumber64 twice.

(Sync patch r18590 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Thomas Palmer <thomas.palmer@hpe.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18791 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/RngLib.h     | 17 +++++++++++++++
 MdePkg/Library/BaseRngLib/BaseRng.c | 32 +++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)

diff --git a/MdePkg/Include/Library/RngLib.h b/MdePkg/Include/Library/RngLib.h
index 157a93139c24..ece43941688f 100644
--- a/MdePkg/Include/Library/RngLib.h
+++ b/MdePkg/Include/Library/RngLib.h
@@ -66,4 +66,21 @@ GetRandomNumber64 (
   OUT     UINT64                    *Rand
   );
 
+/**
+  Generates a 128-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 128-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber128 (
+  OUT     UINT64                    *Rand
+  );
+
 #endif  // __RNG_LIB_H__
diff --git a/MdePkg/Library/BaseRngLib/BaseRng.c b/MdePkg/Library/BaseRngLib/BaseRng.c
index 279df3013c9f..2c8df5628611 100644
--- a/MdePkg/Library/BaseRngLib/BaseRng.c
+++ b/MdePkg/Library/BaseRngLib/BaseRng.c
@@ -155,3 +155,35 @@ GetRandomNumber64 (
 
   return FALSE;
 }
+
+/**
+  Generates a 128-bit random number.
+
+  if Rand is NULL, then ASSERT().
+
+  @param[out] Rand     Buffer pointer to store the 128-bit random value.
+
+  @retval TRUE         Random number generated successfully.
+  @retval FALSE        Failed to generate the random number.
+
+**/
+BOOLEAN
+EFIAPI
+GetRandomNumber128 (
+  OUT     UINT64                    *Rand
+  )
+{
+  ASSERT (Rand != NULL);
+
+  //
+  // Read first 64 bits
+  //
+  if (!GetRandomNumber64 (Rand)) {
+    return FALSE;
+  }
+
+  //
+  // Read second 64 bits
+  //
+  return GetRandomNumber64 (++Rand);
+}

From 99806531f4d6b0e35b29d96ed97fe83e39556b3a Mon Sep 17 00:00:00 2001
From: Thomas Palmer <thomas.palmer@hpe.com>
Date: Mon, 16 Nov 2015 06:53:01 +0000
Subject: [PATCH 077/525] SecurityPkg: Integrate new RngLib into RngDxe

Use the new RngLib to provide the IA32/X64 random data for RngDxe.
Remove x86 specific functions from RdRand files.
Simplify RngDxe by using WriteUnaligned64 for all platforms.
Use GetRandomNumber128 in RngDxe to leverage 128 bit support provided
by some HW RNG devices.

(Sync patch r18591 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Thomas Palmer <thomas.palmer@hpe.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18792 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../RandomNumberGenerator/RngDxe/RdRand.c     | 256 ++----------------
 .../RandomNumberGenerator/RngDxe/RdRand.h     | 151 +----------
 .../RandomNumberGenerator/RngDxe/RngDxe.c     |  13 +-
 .../RandomNumberGenerator/RngDxe/RngDxe.inf   |  14 +-
 SecurityPkg/SecurityPkg.dsc                   |   3 +
 5 files changed, 28 insertions(+), 409 deletions(-)

diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.c b/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.c
index 7e618dc91f23..395b8867c836 100644
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.c
+++ b/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.c
@@ -2,6 +2,7 @@
   Support routines for RDRAND instruction access.
 
 Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -11,177 +12,11 @@ THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 **/
+#include <Library/RngLib.h>
 
 #include "RdRand.h"
 #include "AesCore.h"
 
-//
-// Bit mask used to determine if RdRand instruction is supported.
-//
-#define RDRAND_MASK    0x40000000
-
-/**
-  Determines whether or not RDRAND instruction is supported by the host hardware.
-
-  @retval EFI_SUCCESS          RDRAND instruction supported.
-  @retval EFI_UNSUPPORTED      RDRAND instruction not supported.
-
-**/
-EFI_STATUS
-EFIAPI
-IsRdRandSupported (
-  VOID
-  )
-{
-  EFI_STATUS  Status;
-  UINT32      RegEax;
-  UINT32      RegEbx;
-  UINT32      RegEcx;
-  UINT32      RegEdx;
-  BOOLEAN     IsIntelCpu;
-
-  Status     = EFI_UNSUPPORTED;
-  IsIntelCpu = FALSE;
-  
-  //
-  // Checks whether the current processor is an Intel product by CPUID.
-  //
-  AsmCpuid (0, &RegEax, &RegEbx, &RegEcx, &RegEdx);
-  if ((CompareMem ((CHAR8 *)(&RegEbx), "Genu", 4) == 0) &&
-      (CompareMem ((CHAR8 *)(&RegEdx), "ineI", 4) == 0) &&
-      (CompareMem ((CHAR8 *)(&RegEcx), "ntel", 4) == 0)) {
-    IsIntelCpu = TRUE;
-  }
-
-  if (IsIntelCpu) {
-    //
-    // Determine RDRAND support by examining bit 30 of the ECX register returned by CPUID.
-    // A value of 1 indicates that processor supports RDRAND instruction.
-    //
-    AsmCpuid (1, 0, 0, &RegEcx, 0);
-
-    if ((RegEcx & RDRAND_MASK) == RDRAND_MASK) {
-      Status = EFI_SUCCESS;
-    }
-  }
-
-  return Status;
-}
-
-/**
-  Calls RDRAND to obtain a 16-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand16 (
-  OUT UINT16       *Rand,
-  IN BOOLEAN       NeedRetry
-  )
-{
-  UINT32      Index;
-  UINT32      RetryCount;
-
-  if (NeedRetry) {
-    RetryCount = RETRY_LIMIT;
-  } else {
-    RetryCount = 1;
-  }
-
-  //
-  // Perform a single call to RDRAND, or enter a loop call until RDRAND succeeds.
-  //
-  for (Index = 0; Index < RetryCount; Index++) {
-    if (RdRand16Step (Rand)) {
-      return EFI_SUCCESS;
-    }
-  }
-  
-  return EFI_NOT_READY;
-}
-
-/**
-  Calls RDRAND to obtain a 32-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand32 (
-  OUT UINT32       *Rand,
-  IN BOOLEAN       NeedRetry
-  )
-{
-  UINT32      Index;
-  UINT32      RetryCount;
-
-  if (NeedRetry) {
-    RetryCount = RETRY_LIMIT;
-  } else {
-    RetryCount = 1;
-  }
-
-  //
-  // Perform a single call to RDRAND, or enter a loop call until RDRAND succeeds.
-  //
-  for (Index = 0; Index < RetryCount; Index++) {
-    if (RdRand32Step (Rand)) {
-      return EFI_SUCCESS;
-    }
-  }
-  
-  return EFI_NOT_READY;
-}
-
-/**
-  Calls RDRAND to obtain a 64-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand64 (
-  OUT UINT64       *Rand,
-  IN BOOLEAN       NeedRetry
-  )
-{
-  UINT32      Index;
-  UINT32      RetryCount;
-
-  if (NeedRetry) {
-    RetryCount = RETRY_LIMIT;
-  } else {
-    RetryCount = 1;
-  }
-
-  //
-  // Perform a single call to RDRAND, or enter a loop call until RDRAND succeeds.
-  //
-  for (Index = 0; Index < RetryCount; Index++) {
-    if (RdRand64Step (Rand)) {
-      return EFI_SUCCESS;
-    }
-  }
-  
-  return EFI_NOT_READY;
-}
-
 /**
   Calls RDRAND to fill a buffer of arbitrary size with random bytes.
 
@@ -199,80 +34,23 @@ RdRandGetBytes (
   OUT UINT8        *RandBuffer
   )
 {
-  EFI_STATUS  Status;
-  UINT8       *Start;
-  UINT8       *ResidualStart;
-  UINTN       *BlockStart;
-  UINTN       TempRand;
-  UINTN       Count;
-  UINTN       Residual;
-  UINTN       StartLen;
-  UINTN       BlockNum;
-  UINTN       Index;
-
-  ResidualStart = NULL;
-  TempRand      = 0;
+  BOOLEAN     IsRandom;
+  UINT64      TempRand[2];
 
-  //
-  // Compute the address of the first word aligned (32/64-bit) block in the 
-  // destination buffer, depending on whether we are in 32- or 64-bit mode.
-  //
-  Start = RandBuffer;
-  if (((UINT32)(UINTN)Start % (UINT32)sizeof(UINTN)) == 0) {
-    BlockStart = (UINTN *)Start;
-    Count      = Length;
-    StartLen   = 0;
-  } else {
-    BlockStart = (UINTN *)(((UINTN)Start & ~(UINTN)(sizeof(UINTN) - 1)) + (UINTN)sizeof(UINTN));
-    Count      = Length - (sizeof (UINTN) - (UINT32)((UINTN)Start % sizeof (UINTN)));
-    StartLen   = (UINT32)((UINTN)BlockStart - (UINTN)Start);
-  }
-
-  //
-  // Compute the number of word blocks and the remaining number of bytes.
-  //
-  Residual = Count % sizeof (UINTN);
-  BlockNum = Count / sizeof (UINTN);
-  if (Residual != 0) {
-    ResidualStart = (UINT8 *) (BlockStart + BlockNum);
-  }
-
-  //
-  // Obtain a temporary random number for use in the residuals. Failout if retry fails.
-  //
-  if (StartLen > 0) {
-    Status = RdRandWord ((UINTN *) &TempRand, TRUE);
-    if (EFI_ERROR (Status)) {
-      return Status;
-    }
-  }
-
-  //
-  // Populate the starting mis-aligned block.
-  //
-  for (Index = 0; Index < StartLen; Index++) {
-    Start[Index] = (UINT8)(TempRand & 0xff);
-    TempRand     = TempRand >> 8;
-  }
-
-  //
-  // Populate the central aligned block. Fail out if retry fails.
-  //
-  Status = RdRandGetWords (BlockNum, (UINTN *)(BlockStart));
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
-  //
-  // Populate the final mis-aligned block.
-  //
-  if (Residual > 0) {
-    Status = RdRandWord ((UINTN *)&TempRand, TRUE);
-    if (EFI_ERROR (Status)) {
-      return Status;
+  while (Length > 0) {
+    IsRandom = GetRandomNumber128 (TempRand);
+    if (!IsRandom) {
+      return EFI_NOT_READY;
     }
-    for (Index = 0; Index < Residual; Index++) {
-      ResidualStart[Index] = (UINT8)(TempRand & 0xff);
-      TempRand             = TempRand >> 8;
+    if (Length >= sizeof (TempRand)) {
+      WriteUnaligned64 ((UINT64*)RandBuffer, TempRand[0]);
+      RandBuffer += sizeof (UINT64);
+      WriteUnaligned64 ((UINT64*)RandBuffer, TempRand[1]);
+      RandBuffer += sizeof (UINT64);
+      Length -= sizeof (TempRand);
+    } else {
+      CopyMem (RandBuffer, TempRand, Length);
+      Length = 0;
     }
   }
 
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.h b/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.h
index 20fd9fbd3ffa..d6378778cf15 100644
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.h
+++ b/SecurityPkg/RandomNumberGenerator/RngDxe/RdRand.h
@@ -9,6 +9,7 @@
   Secure Key technology.
 
 Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -28,154 +29,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/TimerLib.h>
 #include <Protocol/Rng.h>
 
-//
-// The maximun number of retries to obtain one available random number. 
-//
-#define RETRY_LIMIT    10
-
-/**
-  Determines whether or not RDRAND instruction is supported by the host hardware.
-
-  @retval EFI_SUCCESS          RDRAND instruction supported.
-  @retval EFI_UNSUPPORTED      RDRAND instruction not supported.
-
-**/
-EFI_STATUS
-EFIAPI
-IsRdRandSupported (
-  VOID
-  );
-
-/**
-  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
-RdRand16Step (
-  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
-RdRand32Step (
-  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
-RdRand64Step  (
-  OUT UINT64   *Rand
-  );
-
-/**
-  Calls RDRAND to obtain a 16-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand16 (
-  OUT UINT16       *Rand,
-  IN BOOLEAN       NeedRetry
-  );
-
-/**
-  Calls RDRAND to obtain a 32-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand32 (
-  OUT UINT32       *Rand,
-  IN BOOLEAN       NeedRetry
-  );
-
-/**
-  Calls RDRAND to obtain a 64-bit random number.
-
-  @param[out]  Rand          Buffer pointer to store the random result.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        RDRAND call was successful.
-  @retval EFI_NOT_READY      Failed attempts to call RDRAND.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRand64 (
-  OUT UINT64       *Rand,
-  IN BOOLEAN       NeedRetry
-  );
-  
-/**
-  Calls RDRAND to request a word-length random number.
-
-  @param[out]  Rand          Buffer pointer to store the random number.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        Random word generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random word.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandWord (
-  OUT UINTN        *Rand,
-  IN BOOLEAN       NeedRetry
-  );
-
-/**
-  Calls RDRAND to request multiple word-length random numbers.
-
-  @param[in]   Length        Size of the buffer, in words, to fill with.
-  @param[out]  RandBuffer    Pointer to the buffer to store the random result.
-
-  @retval EFI_SUCCESS        Random words generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random words.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandGetWords (
-  IN UINTN         Length,
-  OUT UINTN        *RandBuffer
-  );
-
 /**
   Calls RDRAND to fill a buffer of arbitrary size with random bytes.
 
@@ -210,4 +63,4 @@ RdRandGenerateEntropy (
   OUT UINT8        *Entropy
   );
 
-#endif  // __RD_RAND_H__
\ No newline at end of file
+#endif  // __RD_RAND_H__
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.c b/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.c
index 98ef3b357fa5..32c46ab45f12 100644
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.c
+++ b/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.c
@@ -15,6 +15,7 @@
    - EFI_RNG_ALGORITHM_X9_31_AES_GUID         - Unsupported
 
 Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -156,7 +157,7 @@ RngGetRNG (
     if (RNGValueLength < 32) {
       return EFI_INVALID_PARAMETER;
     }
-    
+
     Status = RdRandGenerateEntropy (RNGValueLength, RNGValue);
     return Status;
   }
@@ -196,14 +197,6 @@ RngDriverEntry (
   EFI_STATUS    Status;
   EFI_HANDLE    Handle;
 
-  //
-  // Verify RdRand support on Platform.
-  //
-  Status = IsRdRandSupported ();
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
-
   //
   // Install UEFI RNG (Random Number Generator) Protocol
   //
@@ -214,6 +207,6 @@ RngDriverEntry (
                   &mRngRdRand,
                   NULL
                   );
-  
+
   return Status;
 }
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.inf b/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.inf
index d57c2d8c6f34..4d668a170ae1 100644
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.inf
+++ b/SecurityPkg/RandomNumberGenerator/RngDxe/RngDxe.inf
@@ -9,6 +9,7 @@
 #  Secure Key technology.
 #
 #  Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
+#  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution. The full text of the license may be found at
@@ -41,16 +42,6 @@
   AesCore.c
   AesCore.h
 
-[Sources.IA32]
-  IA32/RdRandWord.c
-  IA32/AsmRdRand.asm
-  IA32/GccRdRand.c          | GCC
-
-[Sources.X64]
-  X64/RdRandWord.c
-  X64/AsmRdRand.asm
-  X64/GccRdRand.c           | GCC
-
 [Packages]
   MdePkg/MdePkg.dec
   SecurityPkg/SecurityPkg.dec
@@ -62,6 +53,7 @@
   DebugLib	
   UefiDriverEntryPoint
   TimerLib
+  RngLib
 
 [Guids]
   gEfiRngAlgorithmSp80090Ctr256Guid   ## SOMETIMES_PRODUCES    ## GUID        # Unique ID of the algorithm for RNG
@@ -77,4 +69,4 @@
   XCODE:*_*_*_CC_FLAGS = -mmmx -msse
 
 [UserExtensions.TianoCore."ExtraFiles"]
-  RngDxeExtra.uni
\ No newline at end of file
+  RngDxeExtra.uni
diff --git a/SecurityPkg/SecurityPkg.dsc b/SecurityPkg/SecurityPkg.dsc
index 6e2ca5c0b724..0908b26a7c24 100644
--- a/SecurityPkg/SecurityPkg.dsc
+++ b/SecurityPkg/SecurityPkg.dsc
@@ -2,6 +2,7 @@
 #  Security Module Package for All Architectures.
 #
 # Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -61,6 +62,7 @@
   TcgPpVendorLib|SecurityPkg/Library/TcgPpVendorLibNull/TcgPpVendorLibNull.inf
   Tcg2PpVendorLib|SecurityPkg/Library/Tcg2PpVendorLibNull/Tcg2PpVendorLibNull.inf
   TrEEPpVendorLib|SecurityPkg/Library/TrEEPpVendorLibNull/TrEEPpVendorLibNull.inf
+  RngLib|MdePkg/Library/BaseRngLib/BaseRngLib.inf
 
 [LibraryClasses.common.PEIM]
   PeimEntryPoint|MdePkg/Library/PeimEntryPoint/PeimEntryPoint.inf
@@ -74,6 +76,7 @@
   Tpm12DeviceLib|SecurityPkg/Library/Tpm12DeviceLibDTpm/Tpm12DeviceLibDTpm.inf
   Tpm2DeviceLib|SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf
   Tcg2PhysicalPresenceLib|SecurityPkg/Library/PeiTcg2PhysicalPresenceLib/PeiTcg2PhysicalPresenceLib.inf
+  RngLib|MdePkg/Library/BaseRngLib/BaseRngLib.inf
 
 [LibraryClasses.common.DXE_DRIVER]
   HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf

From 89d58323cf55ce28357107edb4036c5d5eac0e55 Mon Sep 17 00:00:00 2001
From: Thomas Palmer <thomas.palmer@hpe.com>
Date: Mon, 16 Nov 2015 06:53:53 +0000
Subject: [PATCH 078/525] SecurityPkg: Clean up unused files in RngDxe

Clean up files in RngDxe/IA32 and RngDxe/X64 that are subsumed
by files in BaseRngLib.

(Sync patch r18592 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Thomas Palmer <thomas.palmer@hpe.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18793 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../RngDxe/IA32/AsmRdRand.asm                 |  67 -----------
 .../RngDxe/IA32/GccRdRand.c                   |  69 ------------
 .../RngDxe/IA32/RdRandWord.c                  | 104 ------------------
 .../RngDxe/X64/AsmRdRand.asm                  |  83 --------------
 .../RngDxe/X64/GccRdRand.c                    |  95 ----------------
 .../RngDxe/X64/RdRandWord.c                   |  70 ------------
 6 files changed, 488 deletions(-)
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/IA32/AsmRdRand.asm
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/IA32/GccRdRand.c
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/IA32/RdRandWord.c
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/X64/AsmRdRand.asm
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/X64/GccRdRand.c
 delete mode 100644 SecurityPkg/RandomNumberGenerator/RngDxe/X64/RdRandWord.c

diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/AsmRdRand.asm b/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/AsmRdRand.asm
deleted file mode 100644
index 37b38307e2ee..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/AsmRdRand.asm
+++ /dev/null
@@ -1,67 +0,0 @@
-;------------------------------------------------------------------------------
-;
-; Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-; This program and the accompanying materials
-; are licensed and made available under the terms and conditions of the BSD License
-; which accompanies this distribution.  The full text of the license may be found at
-; http://opensource.org/licenses/bsd-license.php.
-;
-; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-;
-; Module Name:
-;
-;   AsmRdRand.Asm
-;
-; Abstract:
-;
-;   Implementation for 16-, and 32- invocations of RDRAND instruction under 32bit platform.
-;
-; Notes:
-;
-;   Visual Studio coding practices do not use inline asm since multiple compilers and 
-;   architectures are supported assembler not recognizing rdrand instruction so using DB's.
-;
-;------------------------------------------------------------------------------
-
-    .586P
-    .model flat, C
-    .code
- 
-;------------------------------------------------------------------------------
-;  Generate a 16 bit random number
-;  Return TRUE if Rand generated successfully, or FALSE if not
-;
-;  BOOLEAN EFIAPI RdRand16Step (UINT16 *Rand);   ECX
-;------------------------------------------------------------------------------
-RdRand16Step  PROC
-    ; rdrand   ax                  ; generate a 16 bit RN into ax, CF=1 if RN generated ok, otherwise CF=0
-    db     0fh, 0c7h, 0f0h         ; rdrand r16:  "0f c7 /6  ModRM:r/m(w)"
-    jb     rn16_ok                 ; jmp if CF=1
-    xor    eax, eax                ; reg=0 if CF=0
-    ret                            ; return with failure status
-rn16_ok:
-    mov    [ecx], ax
-    mov    eax, 1
-    ret
-RdRand16Step ENDP
-
-;------------------------------------------------------------------------------
-;  Generate a 32 bit random number
-;    Return TRUE if Rand generated successfully, or FALSE if not
-;
-;  BOOLEAN EFIAPI RdRand32Step (UINT32 *Rand);   ECX
-;------------------------------------------------------------------------------
-RdRand32Step  PROC
-    ; rdrand   eax                 ; generate a 32 bit RN into eax, CF=1 if RN generated ok, otherwise CF=0
-    db     0fh, 0c7h, 0f0h         ; rdrand r32:  "0f c7 /6  ModRM:r/m(w)"
-    jb     rn32_ok                 ; jmp if CF=1
-    xor    eax, eax                ; reg=0 if CF=0
-    ret                            ; return with failure status
-rn32_ok:
-    mov    [ecx], eax
-    mov    eax,  1
-    ret
-RdRand32Step  ENDP
-
-    END
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/GccRdRand.c b/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/GccRdRand.c
deleted file mode 100644
index f42302afe35c..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/GccRdRand.c
+++ /dev/null
@@ -1,69 +0,0 @@
-/** @file
-  RDRAND Support Routines for GCC environment.
-
-Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials
-are licensed and made available under the terms and conditions of the BSD License
-which accompanies this distribution.  The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-/**
-  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
-RdRand16Step (
-  OUT UINT16       *Rand
-  )
-{
-  UINT8  Carry;
-
-  //
-  // Uses byte code for RDRAND instruction,
-  // in case that GCC version has no direct support on RDRAND assembly.
-  //
-  __asm__ __volatile__ (
-    ".byte 0x66; .byte 0x0f; .byte 0xc7; .byte 0xf0; setc %1"
-    :"=a"  (*Rand), 
-     "=qm" (Carry)
-    ); 
-
-  return (BOOLEAN) Carry;
-}
-
-/**
-  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
-RdRand32Step (
-  OUT UINT32       *Rand
-  )
-{
-  UINT8  Carry;
-
-  __asm__ __volatile__ (
-    ".byte 0x0f; .byte 0xc7; .byte 0xf0; setc %1"
-    :"=a"  (*Rand), 
-     "=qm" (Carry)
-    );
-
-  return (BOOLEAN) Carry;
-}
\ No newline at end of file
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/RdRandWord.c b/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/RdRandWord.c
deleted file mode 100644
index 125c53b3d3ad..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/IA32/RdRandWord.c
+++ /dev/null
@@ -1,104 +0,0 @@
-/** @file
-  RDRAND Support Routines.
-
-Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials
-are licensed and made available under the terms and conditions of the BSD License
-which accompanies this distribution.  The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include "RdRand.h"
-
-/**
-  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
-RdRand64Step  (
-  OUT UINT64   *Rand
-  )
-{
-  UINT32  RandLow;
-  UINT32  RandHigh;
-
-  //
-  // Generating a 64-bit rand on a 32-bit system by 
-  // mapping two 32-bit RDRAND instructions.
-  //
-  if (!RdRand32Step (&RandLow)) {
-    return FALSE;
-  }
-  if (!RdRand32Step (&RandHigh)) {
-    return FALSE;
-  }
-
-  *Rand = (UINT64) RandLow | LShiftU64 ((UINT64)RandHigh, 32);
-
-  return TRUE;
-}
-
-/**
-  Calls RDRAND to request a word-length random number.
-
-  @param[out]  Rand          Buffer pointer to store the random number.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        Random word generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random word.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandWord (
-  OUT UINTN        *Rand,
-  IN BOOLEAN       NeedRetry
-  )
-{
-  return RdRand32 (Rand, NeedRetry);
-}
-
-/**
-  Calls RDRAND to request multiple word-length random numbers.
-
-  @param[in]   Length        Size of the buffer, in words, to fill with.
-  @param[out]  RandBuffer    Pointer to the buffer to store the random result.
-
-  @retval EFI_SUCCESS        Random words generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random words.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandGetWords (
-  IN UINTN         Length,
-  OUT UINTN        *RandBuffer
-  )
-{
-  EFI_STATUS  Status;
-  UINT32      Index;
-
-  for (Index = 0; Index < Length; Index++) {
-    //
-    // Obtain one word-length (32-bit) Random Number with possible retry-loop.
-    //
-    Status = RdRand32 (RandBuffer, TRUE);
-    if (EFI_ERROR (Status)) {
-      return Status;
-    }
-    
-    RandBuffer++;
-  }
-
-  return EFI_SUCCESS;
-}
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/AsmRdRand.asm b/SecurityPkg/RandomNumberGenerator/RngDxe/X64/AsmRdRand.asm
deleted file mode 100644
index 8a4fe65d053a..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/AsmRdRand.asm
+++ /dev/null
@@ -1,83 +0,0 @@
-;------------------------------------------------------------------------------
-;
-; Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-; This program and the accompanying materials
-; are licensed and made available under the terms and conditions of the BSD License
-; which accompanies this distribution.  The full text of the license may be found at
-; http://opensource.org/licenses/bsd-license.php.
-;
-; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-;
-; Module Name:
-;
-;   AsmRdRand.Asm
-;
-; Abstract:
-;
-;   Implementation for 16-, 32-, and 64-bit invocations of RDRAND instruction under 64bit platform.
-;
-; Notes:
-;
-;   Visual Studio coding practices do not use inline asm since multiple compilers and 
-;   architectures are supported assembler not recognizing rdrand instruction so using DB's.
-;
-;------------------------------------------------------------------------------
-
-    .code
- 
-;------------------------------------------------------------------------------
-;  Generate a 16 bit random number
-;  Return TRUE if Rand generated successfully, or FALSE if not
-;
-;  BOOLEAN EFIAPI RdRand16Step (UINT16 *Rand);   RCX
-;------------------------------------------------------------------------------
-RdRand16Step  PROC
-    ; rdrand   ax                  ; generate a 16 bit RN into ax, CF=1 if RN generated ok, otherwise CF=0
-    db     0fh, 0c7h, 0f0h         ; rdrand r16:  "0f c7 /6  ModRM:r/m(w)"
-    jb     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
-RdRand16Step ENDP
-
-;------------------------------------------------------------------------------
-;  Generate a 32 bit random number
-;    Return TRUE if Rand generated successfully, or FALSE if not
-;
-;  BOOLEAN EFIAPI RdRand32Step (UINT32 *Rand);   RCX
-;------------------------------------------------------------------------------
-RdRand32Step  PROC
-    ; rdrand   eax                 ; generate a 32 bit RN into eax, CF=1 if RN generated ok, otherwise CF=0
-    db     0fh, 0c7h, 0f0h         ; rdrand r32:  "0f c7 /6  ModRM:r/m(w)"
-    jb     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
-RdRand32Step ENDP
-
-;------------------------------------------------------------------------------
-;  Generate a 64 bit random number
-;    Return TRUE if RN generated successfully, or FALSE if not
-;
-;  BOOLEAN EFIAPI RdRand64Step (UINT64 *Random);   RCX
-;------------------------------------------------------------------------------
-RdRand64Step  PROC
-    ; rdrand   rax                 ; generate a 64 bit RN into rax, CF=1 if RN generated ok, otherwise CF=0
-    db     048h, 0fh, 0c7h, 0f0h   ; rdrand r64: "REX.W + 0F C7 /6 ModRM:r/m(w)" 
-    jb     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
-RdRand64Step ENDP
-
-    END
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/GccRdRand.c b/SecurityPkg/RandomNumberGenerator/RngDxe/X64/GccRdRand.c
deleted file mode 100644
index d28336de4843..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/GccRdRand.c
+++ /dev/null
@@ -1,95 +0,0 @@
-/** @file
-  RDRAND Support Routines for GCC environment.
-
-Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials
-are licensed and made available under the terms and conditions of the BSD License
-which accompanies this distribution.  The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-/**
-  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
-RdRand16Step (
-  OUT UINT16       *Rand
-  )
-{
-  UINT8  Carry;
-
-  //
-  // Uses byte code for RDRAND instruction,
-  // in case that GCC version has no direct support on RDRAND assembly.
-  //
-  __asm__ __volatile__ (
-    ".byte 0x66; .byte 0x0f; .byte 0xc7; .byte 0xf0; setc %1"
-    :"=a"  (*Rand),
-     "=qm" (Carry)
-    ); 
-
-  return (BOOLEAN) Carry;
-}
-
-/**
-  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
-RdRand32Step (
-  OUT UINT32       *Rand
-  )
-{
-  UINT8  Carry;
-
-  __asm__ __volatile__ (
-    ".byte 0x0f; .byte 0xc7; .byte 0xf0; setc %1"
-    :"=a"  (*Rand), 
-     "=qm" (Carry)
-    );
-
-  return (BOOLEAN) Carry;
-}
-
-/**
-  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
-RdRand64Step  (
-  OUT UINT64   *Rand
-  )
-{
-  UINT8  Carry;
-
-  __asm__ __volatile__ (
-    ".byte 0x48; .byte 0x0f; .byte 0xc7; .byte 0xf0; setc %1"
-    :"=a"  (*Rand), 
-     "=qm" (Carry)
-    );
-  
-  return (BOOLEAN) Carry;
-}
diff --git a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/RdRandWord.c b/SecurityPkg/RandomNumberGenerator/RngDxe/X64/RdRandWord.c
deleted file mode 100644
index 946e5babaa85..000000000000
--- a/SecurityPkg/RandomNumberGenerator/RngDxe/X64/RdRandWord.c
+++ /dev/null
@@ -1,70 +0,0 @@
-/** @file
-  RDRAND Support Routines.
-
-Copyright (c) 2013, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials
-are licensed and made available under the terms and conditions of the BSD License
-which accompanies this distribution.  The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include "RdRand.h"
-
-/**
-  Calls RDRAND to request a word-length random number.
-
-  @param[out]  Rand          Buffer pointer to store the random number.
-  @param[in]   NeedRetry     Determine whether or not to loop retry.
-
-  @retval EFI_SUCCESS        Random word generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random word.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandWord (
-  OUT UINTN        *Rand,
-  IN BOOLEAN       NeedRetry
-  )
-{
-  return RdRand64 (Rand, NeedRetry);
-}
-
-/**
-  Calls RDRAND to request multiple word-length random numbers.
-
-  @param[in]   Length        Size of the buffer, in words, to fill with.
-  @param[out]  RandBuffer    Pointer to the buffer to store the random result.
-
-  @retval EFI_SUCCESS        Random words generation succeeded.
-  @retval EFI_NOT_READY      Failed to request random words.
-
-**/
-EFI_STATUS
-EFIAPI
-RdRandGetWords (
-  IN UINTN         Length,
-  OUT UINTN        *RandBuffer
-  )
-{
-  EFI_STATUS  Status;
-  UINT32      Index;
-
-  for (Index = 0; Index < Length; Index++) {
-    //
-    // Obtain one word-length (64-bit) Random Number with possible retry-loop.
-    //
-    Status = RdRand64 (RandBuffer, TRUE);
-    if (EFI_ERROR (Status)) {
-      return Status;
-    }
-    
-    RandBuffer++;
-  }
-
-  return EFI_SUCCESS;
-}
\ No newline at end of file

From ff113502bd44fe0bc5ec5397e3526bf4e9efb2fd Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Mon, 16 Nov 2015 06:54:44 +0000
Subject: [PATCH 079/525] Update register hot key logic, return
 EFI_ALREADY_START status if same hot key already existed.

In current case, if one key was requested to register twice, browser will override old hot key with new one. This behavior is not user friendly.
Now update the logic, return EFI_ALREADY_STARTED for this case. If user still want to override it, he must unregistered it first.

(Sync patch r18604 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18794 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/SetupBrowserDxe/Setup.c         | 24 +++++++++----------
 .../Universal/SetupBrowserDxe/Setup.h         |  1 +
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
index 579396293edf..43cfc87eeb3d 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
@@ -5890,6 +5890,7 @@ SetScope (
   @retval EFI_INVALID_PARAMETER  KeyData is NULL or HelpString is NULL on register.
   @retval EFI_NOT_FOUND          KeyData is not found to be unregistered.
   @retval EFI_UNSUPPORTED        Key represents a printable character. It is conflicted with Browser.
+  @retval EFI_ALREADY_STARTED    Key already been registered for one hot key.
 **/
 EFI_STATUS
 EFIAPI
@@ -5935,20 +5936,19 @@ RegisterHotKey (
       return EFI_NOT_FOUND;
     }
   }
-  
+
+  if (HotKey != NULL) {
+    return EFI_ALREADY_STARTED;
+  }
+
   //
-  // Register HotKey into List.
+  // Create new Key, and add it into List.
   //
-  if (HotKey == NULL) {
-    //
-    // Create new Key, and add it into List.
-    //
-    HotKey = AllocateZeroPool (sizeof (BROWSER_HOT_KEY));
-    ASSERT (HotKey != NULL);
-    HotKey->Signature = BROWSER_HOT_KEY_SIGNATURE;
-    HotKey->KeyData   = AllocateCopyPool (sizeof (EFI_INPUT_KEY), KeyData);
-    InsertTailList (&gBrowserHotKeyList, &HotKey->Link);
-  }
+  HotKey = AllocateZeroPool (sizeof (BROWSER_HOT_KEY));
+  ASSERT (HotKey != NULL);
+  HotKey->Signature = BROWSER_HOT_KEY_SIGNATURE;
+  HotKey->KeyData   = AllocateCopyPool (sizeof (EFI_INPUT_KEY), KeyData);
+  InsertTailList (&gBrowserHotKeyList, &HotKey->Link);
 
   //
   // Fill HotKey information.
diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
index 12381975355e..61e706a0b4c9 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
@@ -1308,6 +1308,7 @@ SetScope (
   @retval EFI_INVALID_PARAMETER  KeyData is NULL.
   @retval EFI_NOT_FOUND          KeyData is not found to be unregistered.
   @retval EFI_UNSUPPORTED        Key represents a printable character. It is conflicted with Browser.
+  @retval EFI_ALREADY_STARTED    Key already been registered for one hot key.
 **/
 EFI_STATUS
 EFIAPI

From fe25f37f5c000eb72fb325173dd9bb733689cb56 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Mon, 16 Nov 2015 06:55:32 +0000
Subject: [PATCH 080/525] NetworkPkg: remove unnecessary timeout event when
 setting IPv6 address.

Use Ip6Cfg->SetData() to set IP6 manual address is asynchronous process and the
registered data notify event will be singled when process is done. So it's not
necessary to create another timeout event for the address setting.

(Sync patch r18610 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18795 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/UefiPxeBcDxe/PxeBcDhcp6.c | 97 ++++++++++++++--------------
 1 file changed, 50 insertions(+), 47 deletions(-)

diff --git a/NetworkPkg/UefiPxeBcDxe/PxeBcDhcp6.c b/NetworkPkg/UefiPxeBcDxe/PxeBcDhcp6.c
index 35bdc57479ca..6ad5f5f1ac9f 100644
--- a/NetworkPkg/UefiPxeBcDxe/PxeBcDhcp6.c
+++ b/NetworkPkg/UefiPxeBcDxe/PxeBcDhcp6.c
@@ -1376,16 +1376,15 @@ PxeBcRegisterIp6Address (
   EFI_IP6_CONFIG_MANUAL_ADDRESS    CfgAddr;
   EFI_IPv6_ADDRESS                 GatewayAddr;
   UINTN                            DataSize;
-  EFI_EVENT                        TimeOutEvt;
   EFI_EVENT                        MappedEvt;
   EFI_STATUS                       Status;
-  UINT64                           DadTriggerTime;
-  EFI_IP6_CONFIG_DUP_ADDR_DETECT_TRANSMITS    DadXmits;
   BOOLEAN                          NoGateway;
+  EFI_IPv6_ADDRESS                 *Ip6Addr;
+  UINTN                            Index;
 
   Status     = EFI_SUCCESS;
-  TimeOutEvt = NULL;
   MappedEvt  = NULL;
+  Ip6Addr    = NULL;
   DataSize   = sizeof (EFI_IP6_CONFIG_POLICY);
   Ip6Cfg     = Private->Ip6Cfg;
   Ip6        = Private->Ip6;
@@ -1426,34 +1425,6 @@ PxeBcRegisterIp6Address (
     goto ON_EXIT;
   }
 
-  //
-  // Get Duplicate Address Detection Transmits count.
-  //
-  DataSize = sizeof (EFI_IP6_CONFIG_DUP_ADDR_DETECT_TRANSMITS);
-  Status = Ip6Cfg->GetData (
-                     Ip6Cfg,
-                     Ip6ConfigDataTypeDupAddrDetectTransmits,
-                     &DataSize,
-                     &DadXmits
-                     );
-  if (EFI_ERROR (Status)) {
-    goto ON_EXIT;
-  }
-
-  //
-  // Create a timer as setting address timeout event since DAD in IP6 driver.
-  //
-  Status = gBS->CreateEvent (
-                  EVT_TIMER,
-                  TPL_CALLBACK,
-                  NULL,
-                  NULL,
-                  &TimeOutEvt
-                  );
-  if (EFI_ERROR (Status)) {
-    goto ON_EXIT;
-  }
-
   //
   // Create a notify event to set address flag when DAD if IP6 driver succeeded.
   //
@@ -1468,6 +1439,7 @@ PxeBcRegisterIp6Address (
     goto ON_EXIT;
   }
 
+  Private->IsAddressOk = FALSE;
   Status = Ip6Cfg->RegisterDataNotify (
                      Ip6Cfg,
                      Ip6ConfigDataTypeManualAddress,
@@ -1485,23 +1457,54 @@ PxeBcRegisterIp6Address (
                      );
   if (EFI_ERROR(Status) && Status != EFI_NOT_READY) {
     goto ON_EXIT;
-  }
+  } else if (Status == EFI_NOT_READY) {
+    //
+    // Poll the network until the asynchronous process is finished.
+    //
+    while (!Private->IsAddressOk) {
+      Ip6->Poll (Ip6);
+    }
+    //
+    // Check whether the IP6 address setting is successed.
+    //
+    DataSize = 0;
+    Status = Ip6Cfg->GetData (
+                       Ip6Cfg,
+                       Ip6ConfigDataTypeManualAddress,
+                       &DataSize,
+                       NULL
+                       );
+    if (Status != EFI_BUFFER_TOO_SMALL || DataSize == 0) {
+      Status = EFI_DEVICE_ERROR;
+      goto ON_EXIT;
+    }
 
-  //
-  // Start the 5 secondes timer to wait for setting address.
-  //
-  Status = EFI_NO_MAPPING;
-  DadTriggerTime = TICKS_PER_SECOND * DadXmits.DupAddrDetectTransmits + PXEBC_DAD_ADDITIONAL_DELAY;
-  gBS->SetTimer (TimeOutEvt, TimerRelative, DadTriggerTime);
+    Ip6Addr = AllocatePool (DataSize);
+    if (Ip6Addr == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    Status = Ip6Cfg->GetData (
+                       Ip6Cfg,
+                       Ip6ConfigDataTypeManualAddress,
+                       &DataSize,
+                       (VOID*) Ip6Addr
+                       );
+    if (EFI_ERROR (Status)) {
+      Status = EFI_DEVICE_ERROR;
+      goto ON_EXIT;
+    }
 
-  while (EFI_ERROR (gBS->CheckEvent (TimeOutEvt))) {
-    Ip6->Poll (Ip6);
-    if (Private->IsAddressOk) {
-      Status = EFI_SUCCESS;
-      break;
+    for (Index = 0; Index < DataSize / sizeof (EFI_IPv6_ADDRESS); Index++) {
+      if (CompareMem (Ip6Addr + Index, Address, sizeof (EFI_IPv6_ADDRESS)) == 0) {
+        break;
+      }
+    }
+    if (Index == DataSize / sizeof (EFI_IPv6_ADDRESS)) {
+      Status = EFI_ABORTED;
+      goto ON_EXIT;
     }
   }
-
+  
   //
   // Set the default gateway address back if needed.
   //
@@ -1526,8 +1529,8 @@ PxeBcRegisterIp6Address (
               );
     gBS->CloseEvent (MappedEvt);
   }
-  if (TimeOutEvt != NULL) {
-    gBS->CloseEvent (TimeOutEvt);
+  if (Ip6Addr != NULL) {
+    FreePool (Ip6Addr);
   }
   return Status;
 }

From dbe8eed088d1aac38ea0bd65da053798b1dc4d20 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 06:56:27 +0000
Subject: [PATCH 081/525] MdeModulepkg VarCheckLib: Return NULL when no
 property set

to variable with wildcard name.

VarCheckLib has zeroed property for variable with wildcard name
and is waiting for property set. The code should return NULL
when no property set to variable with wildcard name, but not
return the zeroed property that will impact the functionality of
SetVariableCheck.

The issue does not appear with VarCheckUefiLib linked as the library
just has the expected property set.

(Sync patch r18611 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18796 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/VarCheckLib/VarCheckLib.c | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c b/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
index cf001547a509..3d1f8f6f4698 100644
--- a/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
+++ b/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
@@ -141,11 +141,19 @@ VariablePropertyGetWithWildcardName (
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 1]) &&
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 2]) &&
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 3])) {
-          return &mVarCheckVariableWithWildcardName[Index].VariableProperty;
+          if (mVarCheckVariableWithWildcardName[Index].VariableProperty.Revision != VAR_CHECK_VARIABLE_PROPERTY_REVISION) {
+            return NULL;
+          } else {
+            return &mVarCheckVariableWithWildcardName[Index].VariableProperty;
+          }
         }
       }
       if (StrCmp (mVarCheckVariableWithWildcardName[Index].Name, VariableName) == 0) {
-        return  &mVarCheckVariableWithWildcardName[Index].VariableProperty;
+        if (mVarCheckVariableWithWildcardName[Index].VariableProperty.Revision != VAR_CHECK_VARIABLE_PROPERTY_REVISION) {
+          return NULL;
+        } else {
+          return  &mVarCheckVariableWithWildcardName[Index].VariableProperty;
+        }
       }
     }
   }

From 5c0f43e4483246ede8efa2c1b676d1a0c7eb3143 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 06:57:24 +0000
Subject: [PATCH 082/525] MdeModulePkg VariableRuntimeDxe: Add the missing
 gEfiImageSecurityDatabaseGuid

Otherwise there will be build failure if without VarCheckUefiLib linked.

(Sync patch r18612 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18797 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
index 74b35ece09ba..62c1568a50e0 100644
--- a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
@@ -101,6 +101,10 @@
   gEdkiiFaultTolerantWriteGuid                  ## SOMETIMES_CONSUMES   ## HOB
   gEdkiiVarErrorFlagGuid                        ## CONSUMES             ## GUID
 
+  ## SOMETIMES_CONSUMES   ## Variable:L"DB"
+  ## SOMETIMES_CONSUMES   ## Variable:L"DBX"
+  gEfiImageSecurityDatabaseGuid
+
 [Pcd]
   gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize      ## CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase      ## SOMETIMES_CONSUMES

From 04bc6734f757245e970048d14aeeace549701b29 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 06:58:15 +0000
Subject: [PATCH 083/525] SecurityPkg AuthVariableLib: Add the missing
 gEfiAuthenticatedVariableGuid

There is no real build failure, as AuthVariableLib always links to variable driver.
But for code integrity, we should add it.

(Sync patch r18613 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18798 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
index d0c0cc230550..3709f7baae0b 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
+++ b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
@@ -81,6 +81,10 @@
   ## PRODUCES            ## Variable:L"VendorKeysNv"
   gEfiVendorKeysNvGuid
 
+  ## CONSUMES            ## Variable:L"AuthVarKeyDatabase"
+  ## PRODUCES            ## Variable:L"AuthVarKeyDatabase"
+  gEfiAuthenticatedVariableGuid
+
   gEfiCertTypeRsa2048Sha256Guid  ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the certificate.
   gEfiCertPkcs7Guid              ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the certificate.
   gEfiCertX509Guid               ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the signature.

From b5cf1b799efb64e59218333a5ae44b47a0f26876 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Mon, 16 Nov 2015 06:59:13 +0000
Subject: [PATCH 084/525] MdeModulePkg: reset DHCP child when leaving PXE
 LoadFile.

The DHCP4 can have only one configured child instance so we need to reset
the DHCP4 child when leaving PXE driver's LoadFile() function, otherwise the
other programs which also need to use DHCP4 (like HTTP boot) will be impacted.

(Sync patch r18615 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Sriram Subramanian <sriram-s@hpe.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18799 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
index 72923f1b38a4..89977e6690b9 100644
--- a/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
+++ b/MdeModulePkg/Universal/Network/UefiPxeBcDxe/PxeBcImpl.c
@@ -2902,9 +2902,14 @@ EfiPxeLoadFile (
   //
   if (Status == EFI_SUCCESS) {
     //
+    // The DHCP4 can have only one configured child instance so we need to stop
+    // reset the DHCP4 child before we return. Otherwise the other programs which 
+    // also need to use DHCP4 will be impacted.
     // The functionality of PXE Base Code protocol will not be stopped,
     // when downloading is successfully.
     //
+    Private->Dhcp4->Stop (Private->Dhcp4);
+    Private->Dhcp4->Configure (Private->Dhcp4, NULL);
     return EFI_SUCCESS;
 
   } else if (Status == EFI_BUFFER_TOO_SMALL) {

From cea2d2433b50493cb05bac564987f851141d5aa3 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Mon, 16 Nov 2015 07:17:05 +0000
Subject: [PATCH 085/525] NetworkPkg: reset DHCP child when leaving PXE
 LoadFile.

The DHCP4 can have only one configured child instance so we need to reset
the DHCP4 child when leaving PXE driver's LoadFile() function, otherwise the
other programs which also need to use DHCP4 (like HTTP boot) will be impacted.

(Sync patch r18616 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Sriram Subramanian <sriram-s@hpe.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18800 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c b/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
index 367a1356abcc..12e5566a7913 100644
--- a/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
+++ b/NetworkPkg/UefiPxeBcDxe/PxeBcImpl.c
@@ -2392,6 +2392,16 @@ EfiPxeLoadFile (
     //   3. unsupported.
     //
     PxeBc->Stop (PxeBc);
+  } else {
+    //
+    // The DHCP4 can have only one configured child instance so we need to stop
+    // reset the DHCP4 child before we return. Otherwise these programs which 
+    // also need to use DHCP4 will be impacted.
+    //
+    if (!PxeBc->Mode->UsingIpv6) {
+      Private->Dhcp4->Stop (Private->Dhcp4);
+      Private->Dhcp4->Configure (Private->Dhcp4, NULL);
+    }
   }
 
   return Status;

From 964f068d05422e6f7d33210ee7e80f02f883c694 Mon Sep 17 00:00:00 2001
From: "Cohen, Eugene" <eugene@hp.com>
Date: Mon, 16 Nov 2015 07:17:53 +0000
Subject: [PATCH 086/525] SecurityPkg : Fix
 Rsa2048Sha256GuidedSectionExtractLib issue

This issue causes section extraction overrun and possible hang due to bad output size calculation.

(Sync patch r18625 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Cohen, Eugene" <eugene@hp.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18801 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../DxeRsa2048Sha256GuidedSectionExtractLib.c                 | 4 ++--
 .../PeiRsa2048Sha256GuidedSectionExtractLib.c                 | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/SecurityPkg/Library/DxeRsa2048Sha256GuidedSectionExtractLib/DxeRsa2048Sha256GuidedSectionExtractLib.c b/SecurityPkg/Library/DxeRsa2048Sha256GuidedSectionExtractLib/DxeRsa2048Sha256GuidedSectionExtractLib.c
index 1f7a29904f3a..5f5d242d6ee7 100644
--- a/SecurityPkg/Library/DxeRsa2048Sha256GuidedSectionExtractLib/DxeRsa2048Sha256GuidedSectionExtractLib.c
+++ b/SecurityPkg/Library/DxeRsa2048Sha256GuidedSectionExtractLib/DxeRsa2048Sha256GuidedSectionExtractLib.c
@@ -86,7 +86,7 @@ Rsa2048Sha256GuidedSectionGetInfo (
     //
     *SectionAttribute  = ((EFI_GUID_DEFINED_SECTION2 *) InputSection)->Attributes;
     *ScratchBufferSize = 0;
-    *OutputBufferSize  = SECTION2_SIZE (InputSection) - ((EFI_GUID_DEFINED_SECTION2 *) InputSection)->DataOffset;
+    *OutputBufferSize  = SECTION2_SIZE (InputSection) - sizeof(RSA_2048_SHA_256_SECTION2_HEADER);
   } else {
     //
     // Check whether the input guid section is recognized.
@@ -101,7 +101,7 @@ Rsa2048Sha256GuidedSectionGetInfo (
     //
     *SectionAttribute  = ((EFI_GUID_DEFINED_SECTION *) InputSection)->Attributes;
     *ScratchBufferSize = 0;
-    *OutputBufferSize  = SECTION_SIZE (InputSection) - ((EFI_GUID_DEFINED_SECTION *) InputSection)->DataOffset;
+    *OutputBufferSize  = SECTION_SIZE (InputSection) - sizeof(RSA_2048_SHA_256_SECTION_HEADER);
   }
 
   return EFI_SUCCESS;
diff --git a/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c b/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
index e2a0fb670884..e448164a5a33 100644
--- a/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
+++ b/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
@@ -84,7 +84,7 @@ Rsa2048Sha256GuidedSectionGetInfo (
     //
     *SectionAttribute  = ((EFI_GUID_DEFINED_SECTION2 *) InputSection)->Attributes;
     *ScratchBufferSize = 0;
-    *OutputBufferSize  = SECTION2_SIZE (InputSection) - ((EFI_GUID_DEFINED_SECTION2 *) InputSection)->DataOffset;
+    *OutputBufferSize  = SECTION2_SIZE (InputSection) - sizeof(RSA_2048_SHA_256_SECTION2_HEADER);
   } else {
     //
     // Check whether the input guid section is recognized.
@@ -99,7 +99,7 @@ Rsa2048Sha256GuidedSectionGetInfo (
     //
     *SectionAttribute  = ((EFI_GUID_DEFINED_SECTION *) InputSection)->Attributes;
     *ScratchBufferSize = 0;
-    *OutputBufferSize  = SECTION_SIZE (InputSection) - ((EFI_GUID_DEFINED_SECTION *) InputSection)->DataOffset;
+    *OutputBufferSize  = SECTION_SIZE (InputSection) - sizeof(RSA_2048_SHA_256_SECTION_HEADER);
   }
 
   return EFI_SUCCESS;

From 7e37880a7fe0f485d00c5ffd046d6b81fd18e144 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 07:18:36 +0000
Subject: [PATCH 087/525] MdeModulePkg VarCheckLib: R18611 was thoughtless for
 property set

R18611 only updated the logic to return correct property
when no property set to variable with wildcard name.
But VariablePropertySet needs the pointer of property data for set.
So roll back the change in VariablePropertyGetWithWildcardName at R18611,
and check the property revision first in VariablePropertyGet and
SetVariableCheck before using the property data.

(Sync patch r18626 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18802 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/VarCheckLib/VarCheckLib.c         | 29 +++++++++++--------
 1 file changed, 17 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c b/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
index 3d1f8f6f4698..60c141a6b935 100644
--- a/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
+++ b/MdeModulePkg/Library/VarCheckLib/VarCheckLib.c
@@ -141,19 +141,11 @@ VariablePropertyGetWithWildcardName (
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 1]) &&
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 2]) &&
             VarCheckInternalIsHexaDecimalDigitCharacter (VariableName[NameLength + 3])) {
-          if (mVarCheckVariableWithWildcardName[Index].VariableProperty.Revision != VAR_CHECK_VARIABLE_PROPERTY_REVISION) {
-            return NULL;
-          } else {
-            return &mVarCheckVariableWithWildcardName[Index].VariableProperty;
-          }
+          return &mVarCheckVariableWithWildcardName[Index].VariableProperty;
         }
       }
       if (StrCmp (mVarCheckVariableWithWildcardName[Index].Name, VariableName) == 0) {
-        if (mVarCheckVariableWithWildcardName[Index].VariableProperty.Revision != VAR_CHECK_VARIABLE_PROPERTY_REVISION) {
-          return NULL;
-        } else {
-          return  &mVarCheckVariableWithWildcardName[Index].VariableProperty;
-        }
+        return  &mVarCheckVariableWithWildcardName[Index].VariableProperty;
       }
     }
   }
@@ -512,6 +504,9 @@ VarCheckLibVariablePropertySet (
 
   Status = EFI_SUCCESS;
 
+  //
+  // Get the pointer of property data for set.
+  //
   Property = VariablePropertyGetFunction (Name, Guid, FALSE);
   if (Property != NULL) {
     CopyMem (Property, VariableProperty, sizeof (*VariableProperty));
@@ -571,7 +566,12 @@ VarCheckLibVariablePropertyGet (
   }
 
   Property = VariablePropertyGetFunction (Name, Guid, TRUE);
-  if (Property != NULL) {
+  //
+  // Also check the property revision before using the property data.
+  // There is no property set to this variable(wildcard name)
+  // if the revision is not VAR_CHECK_VARIABLE_PROPERTY_REVISION.
+  //
+  if ((Property != NULL) && (Property->Revision == VAR_CHECK_VARIABLE_PROPERTY_REVISION)) {
     CopyMem (VariableProperty, Property, sizeof (*VariableProperty));
     return EFI_SUCCESS;
   }
@@ -619,7 +619,12 @@ VarCheckLibSetVariableCheck (
   }
 
   Property = VariablePropertyGetFunction (VariableName, VendorGuid, TRUE);
-  if (Property != NULL) {
+  //
+  // Also check the property revision before using the property data.
+  // There is no property set to this variable(wildcard name)
+  // if the revision is not VAR_CHECK_VARIABLE_PROPERTY_REVISION.
+  //
+  if ((Property != NULL) && (Property->Revision == VAR_CHECK_VARIABLE_PROPERTY_REVISION)) {
     if ((RequestSource != VarCheckFromTrusted) && ((Property->Property & VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY) != 0)) {
       DEBUG ((EFI_D_INFO, "Variable Check ReadOnly variable fail %r - %g:%s\n", EFI_WRITE_PROTECTED, VendorGuid, VariableName));
       return EFI_WRITE_PROTECTED;

From b0a3a913c1b9ce7f14324e3d73308f0bbbe9d35f Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Mon, 16 Nov 2015 08:02:03 +0000
Subject: [PATCH 088/525] MdeModulePkg SetupBrowserDxe: Save global variable
 values before nest function called.

The SendForm function can be called nest in it. This function also uses some global variables. So we must save global variable values before it been called again.

Old implementation miss to save some global variables, this patch fixed it.

(Sync patch r18650 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18803 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/SetupBrowserDxe/Setup.c | 8 ++++++++
 MdeModulePkg/Universal/SetupBrowserDxe/Setup.h | 8 +++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
index 43cfc87eeb3d..4a6758a5e489 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
@@ -5568,6 +5568,10 @@ SaveBrowserContext (
   Context->HiiHandle            = mCurrentHiiHandle;
   Context->FormId               = mCurrentFormId;
   CopyGuid (&Context->FormSetGuid, &mCurrentFormSetGuid);
+  Context->SystemLevelFormSet   = mSystemLevelFormSet;
+  Context->CurFakeQestId        = mCurFakeQestId;
+  Context->HiiPackageListUpdated = mHiiPackageListUpdated;
+  Context->FinishRetrieveCall   = mFinishRetrieveCall;
 
   //
   // Save the menu history data.
@@ -5625,6 +5629,10 @@ RestoreBrowserContext (
   mCurrentHiiHandle     = Context->HiiHandle;
   mCurrentFormId        = Context->FormId;
   CopyGuid (&mCurrentFormSetGuid, &Context->FormSetGuid);
+  mSystemLevelFormSet   = Context->SystemLevelFormSet;
+  mCurFakeQestId        = Context->CurFakeQestId;
+  mHiiPackageListUpdated = Context->HiiPackageListUpdated;
+  mFinishRetrieveCall   = Context->FinishRetrieveCall;
 
   //
   // Restore the menu history data.
diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
index 61e706a0b4c9..81e2a62df198 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
@@ -538,7 +538,10 @@ typedef struct {
   EFI_GUID                 FormSetGuid;
   EFI_FORM_ID              FormId;
   UI_MENU_SELECTION        *Selection;
-
+  FORM_BROWSER_FORMSET     *SystemLevelFormSet;
+  EFI_QUESTION_ID          CurFakeQestId;
+  BOOLEAN                  HiiPackageListUpdated;
+  BOOLEAN                  FinishRetrieveCall;
   LIST_ENTRY           FormHistoryList;
 } BROWSER_CONTEXT;
 
@@ -586,6 +589,9 @@ extern SETUP_DRIVER_PRIVATE_DATA mPrivateData;
 extern CHAR16            *gEmptyString;
 
 extern UI_MENU_SELECTION  *gCurrentSelection;
+extern BOOLEAN            mHiiPackageListUpdated;
+extern UINT16             mCurFakeQestId;
+extern BOOLEAN            mFinishRetrieveCall;
 
 //
 // Global Procedure Defines

From 25c087fae6279a6856a901dd045c148c1ae9c6d1 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 16 Nov 2015 08:02:59 +0000
Subject: [PATCH 089/525] MdeModulePkg: Update BootManagerMenuApp to not
 display itself

(Sync patch r18656 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18804 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BootManagerMenuApp/BootManagerMenu.c        | 17 +++++++++++++++--
 .../BootManagerMenuApp/BootManagerMenuApp.inf   |  1 +
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
index c5a35c070fe2..2f90883cbbfd 100644
--- a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
+++ b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
@@ -262,13 +262,18 @@ InitializeBootMenuData (
   OUT  BOOT_MENU_POPUP_DATA          *BootMenuData
   )
 {
+  EFI_STATUS                    Status;
   UINTN                         Index;
   UINTN                         StrIndex;
+  EFI_DEVICE_PATH_PROTOCOL      *ImageDevicePath;
       
   if (BootOption == NULL || BootMenuData == NULL) {
     return EFI_INVALID_PARAMETER;
-  } 
-  
+  }
+
+  Status = gBS->HandleProtocol (gImageHandle, &gEfiLoadedImageDevicePathProtocolGuid, (VOID **) &ImageDevicePath);
+  ASSERT_EFI_ERROR (Status);
+
   BootMenuData->TitleToken[0] = STRING_TOKEN (STR_BOOT_POPUP_MENU_TITLE_STRING);
   BootMenuData->PtrTokens     = AllocateZeroPool (BootOptionCount * sizeof (EFI_STRING_ID));
   ASSERT (BootMenuData->PtrTokens != NULL);
@@ -284,6 +289,14 @@ InitializeBootMenuData (
         !IsBootManagerMenu (&BootOption[Index])) {      
       continue;
     }
+
+    //
+    // Don't display myself
+    //
+    if (CompareMem (BootOption[Index].FilePath, ImageDevicePath, GetDevicePathSize (ImageDevicePath)) == 0) {
+      continue;
+    }
+
     ASSERT (BootOption[Index].Description != NULL);
     BootMenuData->PtrTokens[StrIndex++] = HiiSetString (
                                             gStringPackHandle, 
diff --git a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenuApp.inf b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenuApp.inf
index b4455054096d..dd60ef4cd882 100644
--- a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenuApp.inf
+++ b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenuApp.inf
@@ -52,6 +52,7 @@
 
 [Protocols]
   gEfiBootLogoProtocolGuid                      ## CONSUMES
+  gEfiLoadedImageDevicePathProtocolGuid         ## CONSUMES
 
 [Pcd]
   gEfiMdeModulePkgTokenSpaceGuid.PcdConOutRow                          ## PRODUCES

From 4e6613aa75d2d4f7084bfb07a086677201369d4d Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 16 Nov 2015 08:03:52 +0000
Subject: [PATCH 090/525] MdeModulePkg: Update UiApp to not display itself

(Sync patch r18657 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18805 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Application/UiApp/BootMngr/BootManager.c         | 12 ++++++++++++
 MdeModulePkg/Application/UiApp/Ui.h                  |  1 +
 MdeModulePkg/Application/UiApp/UiApp.inf             |  1 +
 3 files changed, 14 insertions(+)

diff --git a/MdeModulePkg/Application/UiApp/BootMngr/BootManager.c b/MdeModulePkg/Application/UiApp/BootMngr/BootManager.c
index 986413c19b4a..4390deef2455 100644
--- a/MdeModulePkg/Application/UiApp/BootMngr/BootManager.c
+++ b/MdeModulePkg/Application/UiApp/BootMngr/BootManager.c
@@ -219,7 +219,9 @@ EnumerateBootOptions  (
   VOID
   )
 {
+  EFI_STATUS                    Status;
   UINTN                         Index;
+  EFI_DEVICE_PATH_PROTOCOL      *ImageDevicePath;
   EFI_BOOT_MANAGER_LOAD_OPTION  *BootOption;
   UINTN                         BootOptionCount;
   EFI_STRING_ID                 Token;
@@ -240,6 +242,9 @@ EnumerateBootOptions  (
 
   DeviceType = (UINT16) -1;
 
+  Status = gBS->HandleProtocol (gImageHandle, &gEfiLoadedImageDevicePathProtocolGuid, (VOID **) &ImageDevicePath);
+  ASSERT_EFI_ERROR (Status);
+
   //
   // for better user experience
   // 1. User changes HD configuration (e.g.: unplug HDD), here we have a chance to remove the HDD boot option
@@ -289,6 +294,13 @@ EnumerateBootOptions  (
       continue;
     }
 
+    //
+    // Don't display myself
+    //
+    if (CompareMem (BootOption[Index].FilePath, ImageDevicePath, GetDevicePathSize (ImageDevicePath)) == 0) {
+      continue;
+    }
+
     //
     // Group the legacy boot option in the sub title created dynamically
     //
diff --git a/MdeModulePkg/Application/UiApp/Ui.h b/MdeModulePkg/Application/UiApp/Ui.h
index 413266d815d4..815987800707 100644
--- a/MdeModulePkg/Application/UiApp/Ui.h
+++ b/MdeModulePkg/Application/UiApp/Ui.h
@@ -30,6 +30,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Guid/HiiBootMaintenanceFormset.h>
 
 #include <Protocol/LoadFile.h>
+#include <Protocol/LoadedImage.h>
 #include <Protocol/DevicePath.h>
 #include <Protocol/HiiConfigRouting.h>
 #include <Protocol/Smbios.h>
diff --git a/MdeModulePkg/Application/UiApp/UiApp.inf b/MdeModulePkg/Application/UiApp/UiApp.inf
index 36d292e67634..9553c7bab569 100644
--- a/MdeModulePkg/Application/UiApp/UiApp.inf
+++ b/MdeModulePkg/Application/UiApp/UiApp.inf
@@ -123,6 +123,7 @@
   gEfiPciIoProtocolGuid                         ## CONSUMES
   gEfiDevicePathToTextProtocolGuid              ## CONSUMES
   gEfiBootLogoProtocolGuid                      ## CONSUMES
+  gEfiLoadedImageDevicePathProtocolGuid         ## CONSUMES
 
 [FeaturePcd]
 

From 4ad4fe2bd3bbfeab5ed100bd6363d654bcf33dd4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:04:49 +0000
Subject: [PATCH 091/525] Move Smbios table MAX length definition to Mde header
 filer.

So that other module can also refer to them.

(Sync patch r18674 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18806 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.h | 12 ------------
 MdePkg/Include/IndustryStandard/SmBios.h     | 12 ++++++++++++
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.h b/MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.h
index f87c8de8ca07..10cff8dd59f6 100644
--- a/MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.h
+++ b/MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.h
@@ -31,18 +31,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/UefiBootServicesTableLib.h>
 #include <Library/PcdLib.h>
 
-//
-// The length of the entire structure table (including all strings) must be reported
-// in the Structure Table Length field of the SMBIOS Structure Table Entry Point,
-// which is a WORD field limited to 65,535 bytes.
-//
-#define SMBIOS_TABLE_MAX_LENGTH 0xFFFF
-
-//
-// For SMBIOS 3.0, Structure table maximum size in Entry Point structure is DWORD field limited to 0xFFFFFFFF bytes.
-//
-#define SMBIOS_3_0_TABLE_MAX_LENGTH 0xFFFFFFFF
-
 #define SMBIOS_INSTANCE_SIGNATURE SIGNATURE_32 ('S', 'B', 'i', 's')
 typedef struct {
   UINT32                Signature;
diff --git a/MdePkg/Include/IndustryStandard/SmBios.h b/MdePkg/Include/IndustryStandard/SmBios.h
index 14b5208fc5e2..0959247f5432 100644
--- a/MdePkg/Include/IndustryStandard/SmBios.h
+++ b/MdePkg/Include/IndustryStandard/SmBios.h
@@ -38,6 +38,18 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 ///
 #define SMBIOS_STRING_MAX_LENGTH     64
 
+//
+// The length of the entire structure table (including all strings) must be reported
+// in the Structure Table Length field of the SMBIOS Structure Table Entry Point,
+// which is a WORD field limited to 65,535 bytes.
+//
+#define SMBIOS_TABLE_MAX_LENGTH 0xFFFF
+
+//
+// For SMBIOS 3.0, Structure table maximum size in Entry Point structure is DWORD field limited to 0xFFFFFFFF bytes.
+//
+#define SMBIOS_3_0_TABLE_MAX_LENGTH 0xFFFFFFFF
+
 ///
 /// Inactive type is added from SMBIOS 2.2. Reference SMBIOS 2.6, chapter 3.3.43.
 /// Upper-level software that interprets the SMBIOS structure-table should bypass an 

From 93e9f9955051c56b8cb0f44e2fa48ef156663216 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:05:37 +0000
Subject: [PATCH 092/525] Add suppressif around TCG hash seleciton checkbox in
 TCG2

Previous TCG2 configuration UI always add all TCG defined hash algorithm to let user select which one need be used.
This brings risk that user might select unsupported hash, and selection is rejected later.
So we enhance to UI to hide unsupported hash algorithm.

(Sync patch r18676 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18807 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr     | 16 +++++++
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c   | 48 +++++++++++++++++++
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h | 12 ++++-
 3 files changed, 75 insertions(+), 1 deletion(-)

diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr b/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
index fe0ef14c2f1b..b3504441d083 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
@@ -19,6 +19,12 @@ formset
   title     = STRING_TOKEN(STR_TCG2_TITLE),
   help      = STRING_TOKEN(STR_TCG2_HELP),
   classguid = EFI_HII_PLATFORM_SETUP_FORMSET_GUID,
+  
+  efivarstore TCG2_CONFIGURATION_INFO,
+    varid = TCG2_CONFIGURATION_INFO_VARSTORE_ID,
+    attribute = 0x02,  // EFI variable attribures  EFI_VARIABLE_BOOTSERVICE_ACCESS
+    name  = TCG2_CONFIGURATION_INFO,
+    guid  = TCG2_CONFIG_FORM_SET_GUID;
 
   efivarstore TCG2_CONFIGURATION,
     varid = TCG2_CONFIGURATION_VARSTORE_ID,
@@ -120,6 +126,7 @@ formset
 
     subtitle text = STRING_TOKEN(STR_NULL);
 
+  suppressif ideqval TCG2_CONFIGURATION_INFO.Sha1Supported == 0;
     checkbox name = TCG2ActivatePCRBank0,
             questionid = KEY_TPM2_PCR_BANKS_REQUEST_0,
             prompt     = STRING_TOKEN(STR_TCG2_PCR_BANK_SHA1),
@@ -127,7 +134,9 @@ formset
             flags      = INTERACTIVE,
             default    = 1,
     endcheckbox;
+  endif;
 
+  suppressif ideqval TCG2_CONFIGURATION_INFO.Sha256Supported == 0;
     checkbox name = TCG2ActivatePCRBank1,
             questionid = KEY_TPM2_PCR_BANKS_REQUEST_1,
             prompt     = STRING_TOKEN(STR_TCG2_PCR_BANK_SHA256),
@@ -135,7 +144,9 @@ formset
             flags      = INTERACTIVE,
             default    = 0,
     endcheckbox;
+  endif;
 
+  suppressif ideqval TCG2_CONFIGURATION_INFO.Sha384Supported == 0;
     checkbox name = TCG2ActivatePCRBank2,
             questionid = KEY_TPM2_PCR_BANKS_REQUEST_2,
             prompt     = STRING_TOKEN(STR_TCG2_PCR_BANK_SHA384),
@@ -143,7 +154,9 @@ formset
             flags      = INTERACTIVE,
             default    = 0,
     endcheckbox;
+  endif;
 
+  suppressif ideqval TCG2_CONFIGURATION_INFO.Sha512Supported == 0;
     checkbox name = TCG2ActivatePCRBank3,
             questionid = KEY_TPM2_PCR_BANKS_REQUEST_3,
             prompt     = STRING_TOKEN(STR_TCG2_PCR_BANK_SHA512),
@@ -151,7 +164,9 @@ formset
             flags      = INTERACTIVE,
             default    = 0,
     endcheckbox;
+  endif;
 
+  suppressif ideqval TCG2_CONFIGURATION_INFO.Sm3Supported == 0;
     checkbox name = TCG2ActivatePCRBank4,
             questionid = KEY_TPM2_PCR_BANKS_REQUEST_4,
             prompt     = STRING_TOKEN(STR_TCG2_PCR_BANK_SM3_256),
@@ -159,6 +174,7 @@ formset
             flags      = INTERACTIVE,
             default    = 0,
     endcheckbox;
+  endif;
 
     endif;
 
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
index 245376966ea3..0d2956074a40 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
@@ -386,6 +386,38 @@ FillBufferWithBootHashAlg (
   }
 }
 
+/**
+  Set ConfigInfo according to TpmAlgHash.
+
+  @param[in,out] Tcg2ConfigInfo       TCG2 config info.
+  @param[in]     TpmAlgHash           TpmAlgHash.
+
+**/
+VOID
+SetConfigInfo (
+  IN OUT TCG2_CONFIGURATION_INFO         *Tcg2ConfigInfo,
+  IN UINT32                              TpmAlgHash
+  )
+{
+  switch (TpmAlgHash) {
+  case TPM_ALG_SHA1:
+    Tcg2ConfigInfo->Sha1Supported = TRUE;
+    break;
+  case TPM_ALG_SHA256:
+    Tcg2ConfigInfo->Sha256Supported = TRUE;
+    break;
+  case TPM_ALG_SHA384:
+    Tcg2ConfigInfo->Sha384Supported = TRUE;
+    break;
+  case TPM_ALG_SHA512:
+    Tcg2ConfigInfo->Sha512Supported = TRUE;
+    break;
+  case TPM_ALG_SM3_256:
+    Tcg2ConfigInfo->Sm3Supported = TRUE;
+    break;
+  }
+}
+
 /**
   Fill Buffer With TCG2EventLogFormat.
 
@@ -471,6 +503,7 @@ InstallTcg2ConfigForm (
   UINTN                           Index;
   TPML_PCR_SELECTION              Pcrs;
   CHAR16                          TempBuffer[1024];
+  TCG2_CONFIGURATION_INFO         Tcg2ConfigInfo;
 
   DriverHandle = NULL;
   ConfigAccess = &PrivateData->ConfigAccess;
@@ -531,6 +564,7 @@ InstallTcg2ConfigForm (
     break;
   }
 
+  ZeroMem (&Tcg2ConfigInfo, sizeof(Tcg2ConfigInfo));
   Status = Tpm2GetCapabilityPcrs (&Pcrs);
   if (EFI_ERROR (Status)) {
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TPM2_ACTIVE_HASH_ALGO_CONTENT), L"[Unknown]", NULL);
@@ -547,6 +581,7 @@ InstallTcg2ConfigForm (
     TempBuffer[0] = 0;
     for (Index = 0; Index < Pcrs.count; Index++) {
       AppendBufferWithTpmAlgHash (TempBuffer, sizeof(TempBuffer), Pcrs.pcrSelections[Index].hash);
+      SetConfigInfo (&Tcg2ConfigInfo, Pcrs.pcrSelections[Index].hash);
     }
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TPM2_SUPPORTED_HASH_ALGO_CONTENT), TempBuffer, NULL);
   }
@@ -569,6 +604,19 @@ InstallTcg2ConfigForm (
   FillBufferWithBootHashAlg (TempBuffer, sizeof(TempBuffer), PrivateData->ProtocolCapability.ActivePcrBanks);
   HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_ACTIVE_PCR_BANKS_CONTENT), TempBuffer, NULL);
 
+  //
+  // Set ConfigInfo, to control the check box.
+  //
+  Status = gRT->SetVariable (
+                  TCG2_STORAGE_INFO_NAME,
+                  &gTcg2ConfigFormSetGuid,
+                  EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                  sizeof(Tcg2ConfigInfo),
+                  &Tcg2ConfigInfo
+                  );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "Tcg2ConfigDriver: Fail to set TCG2_STORAGE_INFO_NAME\n"));
+  }
   return EFI_SUCCESS;  
 }
 
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
index 65044c2bd5e9..c6b3d32f49a4 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
@@ -29,6 +29,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define EFI_TCG2_EVENT_LOG_FORMAT_ALL           (EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2 | EFI_TCG2_EVENT_LOG_FORMAT_TCG_2)
 
 #define TCG2_CONFIGURATION_VARSTORE_ID  0x0001
+#define TCG2_CONFIGURATION_INFO_VARSTORE_ID  0x0002
 #define TCG2_CONFIGURATION_FORM_ID      0x0001
 
 #define KEY_TPM_DEVICE                                 0x2000
@@ -57,6 +58,14 @@ typedef struct {
   UINT8   TpmDevice;
 } TCG2_CONFIGURATION;
 
+typedef struct {
+  UINT8  Sha1Supported;
+  UINT8  Sha256Supported;
+  UINT8  Sha384Supported;
+  UINT8  Sha512Supported;
+  UINT8  Sm3Supported;
+} TCG2_CONFIGURATION_INFO;
+
 //
 // Variable saved for S3, TPM detected, only valid in S3 path.
 // This variable is ReadOnly.
@@ -65,7 +74,8 @@ typedef struct {
   UINT8   TpmDeviceDetected;
 } TCG2_DEVICE_DETECTION;
 
-#define TCG2_STORAGE_NAME  L"TCG2_CONFIGURATION"
+#define TCG2_STORAGE_NAME           L"TCG2_CONFIGURATION"
+#define TCG2_STORAGE_INFO_NAME      L"TCG2_CONFIGURATION_INFO"
 #define TCG2_DEVICE_DETECTION_NAME  L"TCG2_DEVICE_DETECTION"
 
 #define TPM_INSTANCE_ID_LIST  { \

From 2f6dbfce6d8d261f4829cb921f4fb9923f24f9b6 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:06:55 +0000
Subject: [PATCH 093/525] Move Smbios measurement from TCG driver to Smbios
 driver.

This is patch to remove smbios measurement in TCG driver. There will be other patch to add it in Smbios driver.

The problem of current SMBIOS measurement is:
1) TCG drivers do not support SMBIOS3.0 table.
2) TCG drivers do not follow TCG platform spec on: "Platform configuration information that is automatically updated,
 such as clock registers, and system unique information, such as asset numbers or serial numbers,
 MUST NOT be measured into PCR [1], or any other PCR."

So we decide to move Smbios measurement from TCG drivers to Smbios driver.

(Sync patch r18677 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18808 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c   | 33 +----------------------------
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf |  4 ----
 SecurityPkg/Tcg/TcgDxe/TcgDxe.c     | 33 +----------------------------
 SecurityPkg/Tcg/TcgDxe/TcgDxe.inf   |  4 ----
 SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c   | 33 +----------------------------
 SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf |  4 ----
 6 files changed, 3 insertions(+), 108 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index 9ad970a47be6..7076772f30a3 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -15,11 +15,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <PiDxe.h>
 #include <IndustryStandard/Acpi.h>
 #include <IndustryStandard/PeImage.h>
-#include <IndustryStandard/SmBios.h>
 #include <IndustryStandard/TcpaAcpi.h>
 
 #include <Guid/GlobalVariable.h>
-#include <Guid/SmBios.h>
 #include <Guid/HobList.h>
 #include <Guid/TcgEventHob.h>
 #include <Guid/EventGroup.h>
@@ -1690,42 +1688,13 @@ MeasureHandoffTables (
   )
 {
   EFI_STATUS                        Status;
-  SMBIOS_TABLE_ENTRY_POINT          *SmbiosTable;
   TCG_PCR_EVENT_HDR                 TcgEvent;
   EFI_HANDOFF_TABLE_POINTERS        HandoffTables;
   UINTN                             ProcessorNum;
   EFI_CPU_PHYSICAL_LOCATION         *ProcessorLocBuf;
 
   ProcessorLocBuf = NULL;
-
-  //
-  // Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1]
-  //
-  Status = EfiGetSystemConfigurationTable (
-             &gEfiSmbiosTableGuid,
-             (VOID **) &SmbiosTable
-             );
-
-  if (!EFI_ERROR (Status) && SmbiosTable != NULL) {
-    TcgEvent.PCRIndex  = 1;
-    TcgEvent.EventType = EV_EFI_HANDOFF_TABLES;
-    TcgEvent.EventSize = sizeof (HandoffTables);
-
-    HandoffTables.NumberOfTables = 1;
-    HandoffTables.TableEntry[0].VendorGuid  = gEfiSmbiosTableGuid;
-    HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
-
-    DEBUG ((DEBUG_INFO, "The Smbios Table starts at: 0x%x\n", SmbiosTable->TableAddress));
-    DEBUG ((DEBUG_INFO, "The Smbios Table size: 0x%x\n", SmbiosTable->TableLength));
-
-    Status = TcgDxeHashLogExtendEvent (
-               0,
-               (UINT8*)(UINTN)SmbiosTable->TableAddress,
-               SmbiosTable->TableLength,
-               &TcgEvent,
-               (UINT8*)&HandoffTables
-               );
-  }
+  Status = EFI_SUCCESS;
 
   if (PcdGet8 (PcdTpmPlatformClass) == TCG_PLATFORM_TYPE_SERVER) {
     //
diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
index d6ac07ea6eeb..ca6741b3ad4d 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
@@ -61,10 +61,6 @@
   Tcg2PhysicalPresenceLib
 
 [Guids]
-  ## SOMETIMES_CONSUMES     ## SystemTable           # Smbios Table
-  ## SOMETIMES_CONSUMES     ## GUID                  # Handoff Table for measurement.
-  gEfiSmbiosTableGuid
-  
   ## SOMETIMES_CONSUMES     ## Variable:L"SecureBoot"
   ## SOMETIMES_CONSUMES     ## Variable:L"PK"
   ## SOMETIMES_CONSUMES     ## Variable:L"KEK"
diff --git a/SecurityPkg/Tcg/TcgDxe/TcgDxe.c b/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
index 4b9afe34a44d..80919414ab44 100644
--- a/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
+++ b/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
@@ -23,11 +23,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <IndustryStandard/Tpm12.h>
 #include <IndustryStandard/Acpi.h>
 #include <IndustryStandard/PeImage.h>
-#include <IndustryStandard/SmBios.h>
 #include <IndustryStandard/TcpaAcpi.h>
 
 #include <Guid/GlobalVariable.h>
-#include <Guid/SmBios.h>
 #include <Guid/HobList.h>
 #include <Guid/TcgEventHob.h>
 #include <Guid/EventGroup.h>
@@ -748,42 +746,13 @@ MeasureHandoffTables (
   )
 {
   EFI_STATUS                        Status;
-  SMBIOS_TABLE_ENTRY_POINT          *SmbiosTable;
   TCG_PCR_EVENT_HDR                 TcgEvent;
   EFI_HANDOFF_TABLE_POINTERS        HandoffTables;
   UINTN                             ProcessorNum;
   EFI_CPU_PHYSICAL_LOCATION         *ProcessorLocBuf;
 
   ProcessorLocBuf = NULL;
-
-  //
-  // Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1]
-  //
-  Status = EfiGetSystemConfigurationTable (
-             &gEfiSmbiosTableGuid,
-             (VOID **) &SmbiosTable
-             );
-
-  if (!EFI_ERROR (Status) && SmbiosTable != NULL) {
-    TcgEvent.PCRIndex  = 1;
-    TcgEvent.EventType = EV_EFI_HANDOFF_TABLES;
-    TcgEvent.EventSize = sizeof (HandoffTables);
-
-    HandoffTables.NumberOfTables = 1;
-    HandoffTables.TableEntry[0].VendorGuid  = gEfiSmbiosTableGuid;
-    HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
-
-    DEBUG ((DEBUG_INFO, "The Smbios Table starts at: 0x%x\n", SmbiosTable->TableAddress));
-    DEBUG ((DEBUG_INFO, "The Smbios Table size: 0x%x\n", SmbiosTable->TableLength));
-
-    Status = TcgDxeHashLogExtendEventI (
-               &mTcgDxeData,
-               (UINT8*)(UINTN)SmbiosTable->TableAddress,
-               SmbiosTable->TableLength,
-               &TcgEvent,
-               (UINT8*)&HandoffTables
-               );
-  }
+  Status = EFI_SUCCESS;
 
   if (PcdGet8 (PcdTpmPlatformClass) == TCG_PLATFORM_TYPE_SERVER) {
     //
diff --git a/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf b/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
index 39aeb8b950e4..0976304883f2 100644
--- a/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
+++ b/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
@@ -54,10 +54,6 @@
   ReportStatusCodeLib
 
 [Guids]
-  ## SOMETIMES_CONSUMES     ## SystemTable           # Smbios Table
-  ## SOMETIMES_CONSUMES     ## GUID                  # Handoff Table for measurement.
-  gEfiSmbiosTableGuid
-  
   gEfiGlobalVariableGuid                             ## SOMETIMES_CONSUMES  ## Variable:L"BootXXXX"
   gTcgEventEntryHobGuid                              ## SOMETIMES_CONSUMES  ## HOB
   gTpmErrorHobGuid                                   ## SOMETIMES_CONSUMES  ## HOB
diff --git a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
index 582f09f99f39..41e7207eaffa 100644
--- a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
+++ b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
@@ -15,11 +15,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <PiDxe.h>
 #include <IndustryStandard/Acpi.h>
 #include <IndustryStandard/PeImage.h>
-#include <IndustryStandard/SmBios.h>
 #include <IndustryStandard/TcpaAcpi.h>
 
 #include <Guid/GlobalVariable.h>
-#include <Guid/SmBios.h>
 #include <Guid/HobList.h>
 #include <Guid/TcgEventHob.h>
 #include <Guid/EventGroup.h>
@@ -1046,42 +1044,13 @@ MeasureHandoffTables (
   )
 {
   EFI_STATUS                        Status;
-  SMBIOS_TABLE_ENTRY_POINT          *SmbiosTable;
   TCG_PCR_EVENT_HDR                 TcgEvent;
   EFI_HANDOFF_TABLE_POINTERS        HandoffTables;
   UINTN                             ProcessorNum;
   EFI_CPU_PHYSICAL_LOCATION         *ProcessorLocBuf;
 
   ProcessorLocBuf = NULL;
-
-  //
-  // Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1]
-  //
-  Status = EfiGetSystemConfigurationTable (
-             &gEfiSmbiosTableGuid,
-             (VOID **) &SmbiosTable
-             );
-
-  if (!EFI_ERROR (Status) && SmbiosTable != NULL) {
-    TcgEvent.PCRIndex  = 1;
-    TcgEvent.EventType = EV_EFI_HANDOFF_TABLES;
-    TcgEvent.EventSize = sizeof (HandoffTables);
-
-    HandoffTables.NumberOfTables = 1;
-    HandoffTables.TableEntry[0].VendorGuid  = gEfiSmbiosTableGuid;
-    HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
-
-    DEBUG ((DEBUG_INFO, "The Smbios Table starts at: 0x%x\n", SmbiosTable->TableAddress));
-    DEBUG ((DEBUG_INFO, "The Smbios Table size: 0x%x\n", SmbiosTable->TableLength));
-
-    Status = TcgDxeHashLogExtendEvent (
-               0,
-               (UINT8*)(UINTN)SmbiosTable->TableAddress,
-               SmbiosTable->TableLength,
-               &TcgEvent,
-               (UINT8*)&HandoffTables
-               );
-  }
+  Status = EFI_SUCCESS;
 
   if (PcdGet8 (PcdTpmPlatformClass) == TCG_PLATFORM_TYPE_SERVER) {
     //
diff --git a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
index e564c8f2a561..258ab46db94d 100644
--- a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
+++ b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
@@ -60,10 +60,6 @@
   ReportStatusCodeLib
 
 [Guids]
-  ## SOMETIMES_CONSUMES     ## SystemTable           # Smbios Table
-  ## SOMETIMES_CONSUMES     ## GUID                  # Handoff Table for measurement.
-  gEfiSmbiosTableGuid
-  
   ## SOMETIMES_CONSUMES     ## Variable:L"SecureBoot"
   ## SOMETIMES_CONSUMES     ## Variable:L"PK"
   ## SOMETIMES_CONSUMES     ## Variable:L"KEK"

From e78223628741b988c3a26baade6b684ac27492a7 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:07:58 +0000
Subject: [PATCH 094/525] Do not deadloop if Microcode not found in
 FspTempRamInit.

We do not consider microcode not found as critical error, because Microcode might be applied later.

(Sync patch r18678 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Ma, Maurice" <maurice.ma@intel.com>
Reviewed-by: "Rangarajan, Ravi P" <ravi.p.rangarajan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18809 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SecPeiFspPlatformSecLibSample/Ia32/SecEntry.S    | 10 ++++++++++
 .../SecPeiFspPlatformSecLibSample/Ia32/SecEntry.asm  | 12 +++++++++++-
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.S b/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.S
index 24bc36b9c449..c0b84e075cac 100644
--- a/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.S
+++ b/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.S
@@ -210,12 +210,22 @@ FspHeaderFound:
   jmp  *%eax
 
 TempRamInitDone:
+  cmp  $0x8000000E, %eax   #Check if EFI_NOT_FOUND returned. Error code for Microcode Update not found.
+  je   CallSecFspInit      #If microcode not found, don't hang, but continue.
+
   cmp  $0x0, %eax
   jnz  FspApiFailed
 
   #   ECX: start of range
   #   EDX: end of range
+CallSecFspInit:
+  xorl    %eax, %eax
   movl    %edx, %esp
+
+  # Align the stack at DWORD
+  addl  $3, %esp
+  andl  $0xFFFFFFFC, %esp
+
   pushl   %edx
   pushl   %ecx
   pushl   %eax # zero - no hob list yet
diff --git a/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.asm b/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.asm
index 0e0c5c5883f7..3c2e43a89cde 100644
--- a/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.asm
+++ b/IntelFspWrapperPkg/Library/SecPeiFspPlatformSecLibSample/Ia32/SecEntry.asm
@@ -220,12 +220,22 @@ FspHeaderFound:
   jmp eax
 
 TempRamInitDone:
-  cmp eax, 0
+  cmp eax, 8000000Eh      ;Check if EFI_NOT_FOUND returned. Error code for Microcode Update not found.
+  je  CallSecFspInit      ;If microcode not found, don't hang, but continue.
+
+  cmp eax, 0              ;Check if EFI_SUCCESS retuned.
   jnz FspApiFailed
 
   ;   ECX: start of range
   ;   EDX: end of range
+CallSecFspInit:
+  xor     eax, eax
   mov     esp, edx
+
+  ; Align the stack at DWORD
+  add  esp,  3
+  and  esp, 0FFFFFFFCh
+
   push    edx
   push    ecx
   push    eax ; zero - no hob list yet

From 772941091a71af0e6b0bfbdd27b3bd958b82aa62 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:09:06 +0000
Subject: [PATCH 095/525] Fix issue that calling GetS3MemoryInfo() with wrong
 order.

(Sync patch r18679 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Ma, Maurice" <maurice.ma@intel.com>
Reviewed-by: "Rangarajan, Ravi P" <ravi.p.rangarajan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18810 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
index 82af87fea7a7..099980e52556 100644
--- a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
+++ b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
@@ -246,7 +246,7 @@ FspHobProcessForMemoryResource (
 
     S3PeiMemBase = 0;
     S3PeiMemSize = 0;
-    Status = GetS3MemoryInfo (&S3PeiMemBase, &S3PeiMemSize);
+    Status = GetS3MemoryInfo (&S3PeiMemSize, &S3PeiMemBase);
     ASSERT_EFI_ERROR (Status);
     DEBUG((DEBUG_INFO, "S3 memory %Xh - %Xh bytes\n", S3PeiMemBase, S3PeiMemSize));
 

From 4d38d07f9e8fe62d873fadc74d978a4db6a300b6 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:10:46 +0000
Subject: [PATCH 096/525] Move Smbios measurement from TCG driver to Smbios
 driver.

This is patch to add smbios measurement.

The problem of current SMBIOS measurement is:
1) TCG drivers do not support SMBIOS3.0 table.
2) TCG drivers do not follow TCG platform spec on: "Platform configuration information that is automatically updated,
 such as clock registers, and system unique information, such as asset numbers or serial numbers,
 MUST NOT be measured into PCR [1], or any other PCR."

So we decide to move Smbios measurement from TCG drivers to Smbios driver.

(Sync patch r18680 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18811 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dsc                 |   1 +
 .../SmbiosMeasurementDxe.c                    | 617 ++++++++++++++++++
 .../SmbiosMeasurementDxe.inf                  |  68 ++
 .../SmbiosMeasurementDxe.uni                  | Bin 0 -> 1988 bytes
 .../SmbiosMeasurementDxeExtra.uni             | Bin 0 -> 1358 bytes
 5 files changed, 686 insertions(+)
 create mode 100644 MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
 create mode 100644 MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
 create mode 100644 MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.uni
 create mode 100644 MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxeExtra.uni

diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index 3e04477318b9..c43093260453 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -310,6 +310,7 @@
   MdeModulePkg/Universal/MonotonicCounterRuntimeDxe/MonotonicCounterRuntimeDxe.inf
   MdeModulePkg/Universal/ResetSystemRuntimeDxe/ResetSystemRuntimeDxe.inf
   MdeModulePkg/Universal/SmbiosDxe/SmbiosDxe.inf
+  MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
 
   MdeModulePkg/Universal/Network/ArpDxe/ArpDxe.inf
   MdeModulePkg/Universal/Network/Dhcp4Dxe/Dhcp4Dxe.inf
diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
new file mode 100644
index 000000000000..21528276c11b
--- /dev/null
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -0,0 +1,617 @@
+/** @file
+  This driver measures SMBIOS table to TPM.
+  
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials                          
+are licensed and made available under the terms and conditions of the BSD License         
+which accompanies this distribution.  The full text of the license may be found at        
+http://opensource.org/licenses/bsd-license.php                                            
+                                                                                          
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
+
+**/
+
+#include <PiDxe.h>
+
+#include <Protocol/Smbios.h>
+#include <IndustryStandard/SmBios.h>
+#include <IndustryStandard/UefiTcgPlatform.h>
+#include <Guid/EventGroup.h>
+#include <Guid/SmBios.h>
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/TpmMeasurementLib.h>
+
+#define FIELD_SIZE_OF(TYPE, Field) ((UINTN)sizeof(((TYPE *)0)->Field))
+
+typedef struct {
+  UINT8  Type;
+  UINTN  Offset;
+  UINTN  Size;
+  UINT32 Flags;
+} SMBIOS_FILTER_TABLE;
+#define SMBIOS_FILTER_TABLE_FLAG_IS_STRING  BIT0
+
+typedef struct {
+  UINT8                Type;
+  SMBIOS_FILTER_TABLE  *Filter; // NULL means all fields
+  UINTN                FilterCount;
+} SMBIOS_FILTER_STRUCT;
+
+//
+// Platform Specific Policy
+//
+SMBIOS_FILTER_TABLE  mSmbiosFilterType1BlackList[] = {
+  {0x01, OFFSET_OF(SMBIOS_TABLE_TYPE1, SerialNumber),         FIELD_SIZE_OF(SMBIOS_TABLE_TYPE1, SerialNumber),         SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x01, OFFSET_OF(SMBIOS_TABLE_TYPE1, Uuid),                 FIELD_SIZE_OF(SMBIOS_TABLE_TYPE1, Uuid),                 0},
+  {0x01, OFFSET_OF(SMBIOS_TABLE_TYPE1, WakeUpType),           FIELD_SIZE_OF(SMBIOS_TABLE_TYPE1, WakeUpType),           0},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType2BlackList[] = {
+  {0x02, OFFSET_OF(SMBIOS_TABLE_TYPE2, SerialNumber),         FIELD_SIZE_OF(SMBIOS_TABLE_TYPE2, SerialNumber),         SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x02, OFFSET_OF(SMBIOS_TABLE_TYPE2, LocationInChassis),    FIELD_SIZE_OF(SMBIOS_TABLE_TYPE2, LocationInChassis),    SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType3BlackList[] = {
+  {0x03, OFFSET_OF(SMBIOS_TABLE_TYPE3, SerialNumber),         FIELD_SIZE_OF(SMBIOS_TABLE_TYPE3, SerialNumber),         SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x03, OFFSET_OF(SMBIOS_TABLE_TYPE3, AssetTag),             FIELD_SIZE_OF(SMBIOS_TABLE_TYPE3, AssetTag),             SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType4BlackList[] = {
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, SerialNumber),         FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, SerialNumber),         SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, AssetTag),             FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, AssetTag),             SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, PartNumber),           FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, PartNumber),           SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, CoreCount),            FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, CoreCount),            0},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, EnabledCoreCount),     FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, EnabledCoreCount),     0},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, ThreadCount),          FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, ThreadCount),          0},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, CoreCount2),           FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, CoreCount2),           0},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, EnabledCoreCount2),    FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, EnabledCoreCount2),    0},
+  {0x04, OFFSET_OF(SMBIOS_TABLE_TYPE4, ThreadCount2),         FIELD_SIZE_OF(SMBIOS_TABLE_TYPE4, ThreadCount2),         0},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType17BlackList[] = {
+  {0x11, OFFSET_OF(SMBIOS_TABLE_TYPE17, SerialNumber),        FIELD_SIZE_OF(SMBIOS_TABLE_TYPE17, SerialNumber),        SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x11, OFFSET_OF(SMBIOS_TABLE_TYPE17, AssetTag),            FIELD_SIZE_OF(SMBIOS_TABLE_TYPE17, AssetTag),            SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x11, OFFSET_OF(SMBIOS_TABLE_TYPE17, PartNumber),          FIELD_SIZE_OF(SMBIOS_TABLE_TYPE17, PartNumber),          SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType22BlackList[] = {
+  {0x16, OFFSET_OF(SMBIOS_TABLE_TYPE22, SerialNumber),        FIELD_SIZE_OF(SMBIOS_TABLE_TYPE22, SerialNumber),        SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x16, OFFSET_OF(SMBIOS_TABLE_TYPE22, SBDSSerialNumber),    FIELD_SIZE_OF(SMBIOS_TABLE_TYPE22, SBDSSerialNumber),    0},
+  {0x16, OFFSET_OF(SMBIOS_TABLE_TYPE22, SBDSManufactureDate), FIELD_SIZE_OF(SMBIOS_TABLE_TYPE22, SBDSManufactureDate), 0},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType23BlackList[] = {
+  {0x17, OFFSET_OF(SMBIOS_TABLE_TYPE23, ResetCount),          FIELD_SIZE_OF(SMBIOS_TABLE_TYPE23, ResetCount),          0},
+};
+SMBIOS_FILTER_TABLE  mSmbiosFilterType39BlackList[] = {
+  {0x27, OFFSET_OF(SMBIOS_TABLE_TYPE39, SerialNumber),        FIELD_SIZE_OF(SMBIOS_TABLE_TYPE39, SerialNumber),        SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x27, OFFSET_OF(SMBIOS_TABLE_TYPE39, AssetTagNumber),      FIELD_SIZE_OF(SMBIOS_TABLE_TYPE39, AssetTagNumber),      SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+  {0x27, OFFSET_OF(SMBIOS_TABLE_TYPE39, ModelPartNumber),     FIELD_SIZE_OF(SMBIOS_TABLE_TYPE39, ModelPartNumber),     SMBIOS_FILTER_TABLE_FLAG_IS_STRING},
+};
+
+SMBIOS_FILTER_STRUCT  mSmbiosFilterStandardTableBlackList[] = {
+  {0x01, mSmbiosFilterType1BlackList,  sizeof(mSmbiosFilterType1BlackList)/sizeof(mSmbiosFilterType1BlackList[0])},
+  {0x02, mSmbiosFilterType2BlackList,  sizeof(mSmbiosFilterType2BlackList)/sizeof(mSmbiosFilterType2BlackList[0])},
+  {0x03, mSmbiosFilterType3BlackList,  sizeof(mSmbiosFilterType3BlackList)/sizeof(mSmbiosFilterType3BlackList[0])},
+  {0x04, mSmbiosFilterType4BlackList,  sizeof(mSmbiosFilterType4BlackList)/sizeof(mSmbiosFilterType4BlackList[0])},
+  {0x0B, NULL, 0},
+  {0x0F, NULL, 0},
+  {0x11, mSmbiosFilterType17BlackList, sizeof(mSmbiosFilterType17BlackList)/sizeof(mSmbiosFilterType17BlackList[0])},
+  {0x12, NULL, 0},
+  {0x16, mSmbiosFilterType22BlackList, sizeof(mSmbiosFilterType22BlackList)/sizeof(mSmbiosFilterType22BlackList[0])},
+  {0x17, mSmbiosFilterType23BlackList, sizeof(mSmbiosFilterType23BlackList)/sizeof(mSmbiosFilterType23BlackList[0])},
+  {0x1F, NULL, 0},
+  {0x21, NULL, 0},
+  {0x27, mSmbiosFilterType39BlackList, sizeof(mSmbiosFilterType39BlackList)/sizeof(mSmbiosFilterType39BlackList[0])},
+};
+
+EFI_SMBIOS_PROTOCOL *mSmbios;
+UINTN               mMaxLen;
+
+/**
+
+  This function dump raw data.
+
+  @param  Data  raw data
+  @param  Size  raw data size
+
+**/
+VOID
+InternalDumpData (
+  IN UINT8  *Data,
+  IN UINTN  Size
+  )
+{
+  UINTN  Index;
+  for (Index = 0; Index < Size; Index++) {
+    DEBUG ((EFI_D_INFO, "%02x", (UINTN)Data[Index]));
+  }
+}
+
+/**
+
+  This function dump raw data with colume format.
+
+  @param  Data  raw data
+  @param  Size  raw data size
+
+**/
+VOID
+InternalDumpHex (
+  IN UINT8  *Data,
+  IN UINTN  Size
+  )
+{
+  UINTN   Index;
+  UINTN   Count;
+  UINTN   Left;
+
+#define COLUME_SIZE  (16 * 2)
+
+  Count = Size / COLUME_SIZE;
+  Left  = Size % COLUME_SIZE;
+  for (Index = 0; Index < Count; Index++) {
+    DEBUG ((EFI_D_INFO, "%04x: ", Index * COLUME_SIZE));
+    InternalDumpData (Data + Index * COLUME_SIZE, COLUME_SIZE);
+    DEBUG ((EFI_D_INFO, "\n"));
+  }
+
+  if (Left != 0) {
+    DEBUG ((EFI_D_INFO, "%04x: ", Index * COLUME_SIZE));
+    InternalDumpData (Data + Index * COLUME_SIZE, Left);
+    DEBUG ((EFI_D_INFO, "\n"));
+  }
+}
+
+
+/**
+
+  This function get filter structure by SMBIOS type.
+
+  @param  Type  SMBIOS type
+
+**/
+SMBIOS_FILTER_STRUCT *
+GetFilterStructByType (
+  IN UINT8 Type
+  )
+{
+  UINTN  Index;
+  for (Index = 0; Index < sizeof(mSmbiosFilterStandardTableBlackList)/sizeof(mSmbiosFilterStandardTableBlackList[0]); Index++) {
+    if (mSmbiosFilterStandardTableBlackList[Index].Type == Type) {
+      return &mSmbiosFilterStandardTableBlackList[Index];
+    }
+  }
+  return NULL;
+}
+
+/**
+
+  This function get SMBIOS string in SMBIOS table.
+
+  @param  Head      SMBIOS table head
+  @param  StringId  SMBIOS string ID
+  @param  StringLen length of SMBIOS string
+
+  @return SMBIOS string data
+**/
+CHAR8 *
+GetSmbiosStringById (
+  IN   EFI_SMBIOS_TABLE_HEADER          *Head,
+  IN   SMBIOS_TABLE_STRING              StringId,
+  OUT  UINTN                            *StringLen
+  )
+{
+  UINTN  Size;
+  UINTN  StrLen;
+  CHAR8  *CharInStr;
+  UINTN  StringsNumber;
+  CHAR8  *String;
+
+  CharInStr = (CHAR8 *)Head + Head->Length;
+  Size = Head->Length;
+  StringsNumber = 0;
+  StrLen = 0;
+  //
+  // look for the two consecutive zeros, check the string limit by the way.
+  //
+  String = NULL;
+  while (*CharInStr != 0 || *(CharInStr+1) != 0) { 
+    if (*CharInStr == 0) {
+      Size += 1;
+      CharInStr++;
+    }
+    String = CharInStr;
+
+    for (StrLen = 0 ; StrLen < mMaxLen; StrLen++) {
+      if (*(CharInStr+StrLen) == 0) {
+        break;
+      }
+    }
+    *StringLen = StrLen;
+
+    if (StrLen == mMaxLen) {
+      return NULL;
+    }
+
+    //
+    // forward the pointer
+    //
+    CharInStr += StrLen;
+    Size += StrLen;
+    StringsNumber += 1;
+    if (StringsNumber == StringId) {
+      break;
+    }
+  }
+
+  return String;
+}
+
+/**
+
+  This function update SMBIOS table based on policy.
+
+  @param  TableEntry      SMBIOS table
+  @param  TableEntrySize  SMBIOS table size
+
+**/
+VOID
+FilterSmbiosEntry (
+  IN OUT VOID   *TableEntry,
+  IN UINTN      TableEntrySize
+  )
+{
+  SMBIOS_FILTER_STRUCT  *FilterStruct;
+  SMBIOS_FILTER_TABLE   *Filter;
+  UINTN                 Index;
+  SMBIOS_TABLE_STRING   StringId;
+  CHAR8                 *String;
+  UINTN                 StringLen;
+
+  DEBUG ((EFI_D_INFO, "Smbios Table (Type - %d):\n", ((SMBIOS_STRUCTURE *)TableEntry)->Type));
+  InternalDumpHex (TableEntry, TableEntrySize);
+
+  FilterStruct = GetFilterStructByType (((SMBIOS_STRUCTURE *)TableEntry)->Type);
+  if (FilterStruct != NULL) {
+    if (FilterStruct->Filter == NULL || FilterStruct->FilterCount == 0) {
+      // zero all table entries, except header
+      ZeroMem ((UINT8 *)TableEntry + sizeof(SMBIOS_STRUCTURE), TableEntrySize - sizeof(SMBIOS_STRUCTURE));
+    } else {
+      Filter = FilterStruct->Filter;
+      for (Index = 0; Index < FilterStruct->FilterCount; Index++) {
+        if ((Filter[Index].Flags & SMBIOS_FILTER_TABLE_FLAG_IS_STRING) != 0) {
+          CopyMem (&StringId, (UINT8 *)TableEntry + Filter[Index].Offset, sizeof(StringId));
+          if (StringId != 0) {
+            // set ' ' for string field
+            String = GetSmbiosStringById (TableEntry, StringId, &StringLen);
+            //DEBUG ((EFI_D_INFO,"StrId(0x%x)-%a(%d)\n", StringId, String, StringLen));
+            SetMem (String, StringLen, ' ');
+          }
+        }
+        // zero non-string field
+        ZeroMem ((UINT8 *)TableEntry + Filter[Index].Offset, Filter[Index].Size);
+      }
+    }
+  }
+
+  DEBUG ((EFI_D_INFO, "Filter Smbios Table (Type - %d):\n", ((SMBIOS_STRUCTURE *)TableEntry)->Type));
+  InternalDumpHex (TableEntry, TableEntrySize);
+}
+
+/**
+
+  Get the full size of SMBIOS structure including optional strings that follow the formatted structure.
+
+  @param Head                   Pointer to the beginning of SMBIOS structure.
+  @param NumberOfStrings        The returned number of optional strings that follow the formatted structure.
+  
+  @return Size                  The returned size.
+**/
+UINTN
+GetSmbiosStructureSize (
+  IN   EFI_SMBIOS_TABLE_HEADER          *Head,
+  OUT  UINTN                            *NumberOfStrings
+  )
+{
+  UINTN  Size;
+  UINTN  StrLen;
+  CHAR8  *CharInStr;
+  UINTN  StringsNumber;
+
+  CharInStr = (CHAR8 *)Head + Head->Length;
+  Size = Head->Length;
+  StringsNumber = 0;
+  StrLen = 0;
+  //
+  // look for the two consecutive zeros, check the string limit by the way.
+  //
+  while (*CharInStr != 0 || *(CharInStr+1) != 0) { 
+    if (*CharInStr == 0) {
+      Size += 1;
+      CharInStr++;
+    }
+
+    for (StrLen = 0 ; StrLen < mMaxLen; StrLen++) {
+      if (*(CharInStr+StrLen) == 0) {
+        break;
+      }
+    }
+
+    if (StrLen == mMaxLen) {
+      return 0;
+    }
+
+    //
+    // forward the pointer
+    //
+    CharInStr += StrLen;
+    Size += StrLen;
+    StringsNumber += 1;
+  }
+
+  //
+  // count ending two zeros.
+  //
+  Size += 2;
+
+  if (NumberOfStrings != NULL) {
+    *NumberOfStrings = StringsNumber;
+  }
+  return Size;
+}
+
+/**
+
+  This function returns full SMBIOS table length.
+
+  @param  TableAddress      SMBIOS table based address
+  @param  TableMaximumSize  Maximum size of SMBIOS table
+
+  @return SMBIOS table length
+
+**/
+UINTN
+GetSmbiosTableLength (
+  IN VOID  *TableAddress,
+  IN UINTN TableMaximumSize
+  )
+{
+  VOID  *TableEntry;
+  VOID  *TableAddressEnd;
+  UINTN TableEntryLength;
+
+  TableAddressEnd = (VOID *)((UINTN)TableAddress + TableMaximumSize);
+  TableEntry = TableAddress;
+  while (TableEntry < TableAddressEnd) {
+    TableEntryLength = GetSmbiosStructureSize (TableEntry, NULL);
+    if (TableEntryLength == 0) {
+      break;
+    }
+    if (((SMBIOS_STRUCTURE *)TableEntry)->Type == 127) {
+      TableEntry = (VOID *)((UINTN)TableEntry + TableEntryLength);
+      break;
+    }
+    TableEntry = (VOID *)((UINTN)TableEntry + TableEntryLength);
+  }
+
+  return ((UINTN)TableEntry - (UINTN)TableAddress);
+}
+
+/**
+
+  This function updatess full SMBIOS table length.
+
+  @param  TableAddress      SMBIOS table based address
+  @param  TableLength       SMBIOS table length
+
+**/
+VOID
+FilterSmbiosTable (
+  IN OUT VOID  *TableAddress,
+  IN UINTN     TableLength
+  )
+{
+  VOID   *TableAddressEnd;
+  VOID   *TableEntry;
+  UINTN  TableEntryLength;
+
+  TableEntry = TableAddress;
+  TableAddressEnd = (VOID *)((UINTN)TableAddress + TableLength);
+  while ((UINTN)TableEntry < (UINTN)TableAddressEnd) {
+    TableEntryLength = GetSmbiosStructureSize (TableEntry, NULL);
+    if (TableEntryLength == 0) {
+      break;
+    }
+
+    FilterSmbiosEntry (TableEntry, TableEntryLength);
+
+    TableEntry = (VOID *)((UINTN)TableEntry + TableEntryLength);
+  }
+}
+
+/**
+  Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1]
+**/
+VOID
+EFIAPI
+MeasureSmbiosTable (
+  IN      EFI_EVENT                 Event,
+  IN      VOID                      *Context
+  )
+{
+  EFI_STATUS                        Status;
+  EFI_HANDOFF_TABLE_POINTERS        HandoffTables;
+  SMBIOS_TABLE_ENTRY_POINT          *SmbiosTable;
+  SMBIOS_TABLE_3_0_ENTRY_POINT      *Smbios3Table;
+  VOID                              *SmbiosTableAddress;
+  VOID                              *TableAddress;
+  UINTN                             TableLength;
+
+  SmbiosTable = NULL;
+  Smbios3Table = NULL;
+  SmbiosTableAddress = NULL;
+  TableLength = 0;
+
+  if (mSmbios->MajorVersion >= 3) {
+    Status = EfiGetSystemConfigurationTable (
+               &gEfiSmbios3TableGuid,
+               (VOID **) &Smbios3Table
+               );
+    if (!EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_INFO, "Smbios3Table:\n"));
+      DEBUG ((EFI_D_INFO, "  AnchorString                - '%c%c%c%c%c'\n",
+        Smbios3Table->AnchorString[0],
+        Smbios3Table->AnchorString[1],
+        Smbios3Table->AnchorString[2],
+        Smbios3Table->AnchorString[3],
+        Smbios3Table->AnchorString[4]
+        ));
+      DEBUG ((EFI_D_INFO, "  EntryPointStructureChecksum - 0x%02x\n", Smbios3Table->EntryPointStructureChecksum));
+      DEBUG ((EFI_D_INFO, "  EntryPointLength            - 0x%02x\n", Smbios3Table->EntryPointLength));
+      DEBUG ((EFI_D_INFO, "  MajorVersion                - 0x%02x\n", Smbios3Table->MajorVersion));
+      DEBUG ((EFI_D_INFO, "  MinorVersion                - 0x%02x\n", Smbios3Table->MinorVersion));
+      DEBUG ((EFI_D_INFO, "  DocRev                      - 0x%02x\n", Smbios3Table->DocRev));
+      DEBUG ((EFI_D_INFO, "  EntryPointRevision          - 0x%02x\n", Smbios3Table->EntryPointRevision));
+      DEBUG ((EFI_D_INFO, "  TableMaximumSize            - 0x%08x\n", Smbios3Table->TableMaximumSize));
+      DEBUG ((EFI_D_INFO, "  TableAddress                - 0x%016lx\n", Smbios3Table->TableAddress));
+    }
+  }
+    Status = EfiGetSystemConfigurationTable (
+               &gEfiSmbiosTableGuid,
+               (VOID **) &SmbiosTable
+               );
+    if (!EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_INFO, "SmbiosTable:\n"));
+      DEBUG ((EFI_D_INFO, "  AnchorString                - '%c%c%c%c'\n",
+        Smbios3Table->AnchorString[0],
+        Smbios3Table->AnchorString[1],
+        Smbios3Table->AnchorString[2],
+        Smbios3Table->AnchorString[3]
+        ));
+      DEBUG ((EFI_D_INFO, "  EntryPointStructureChecksum - 0x%02x\n", SmbiosTable->EntryPointStructureChecksum));
+      DEBUG ((EFI_D_INFO, "  EntryPointLength            - 0x%02x\n", SmbiosTable->EntryPointLength));
+      DEBUG ((EFI_D_INFO, "  MajorVersion                - 0x%02x\n", SmbiosTable->MajorVersion));
+      DEBUG ((EFI_D_INFO, "  MinorVersion                - 0x%02x\n", SmbiosTable->MinorVersion));
+      DEBUG ((EFI_D_INFO, "  MaxStructureSize            - 0x%08x\n", SmbiosTable->MaxStructureSize));
+      DEBUG ((EFI_D_INFO, "  EntryPointRevision          - 0x%02x\n", SmbiosTable->EntryPointRevision));
+      DEBUG ((EFI_D_INFO, "  FormattedArea               - '%c%c%c%c%c'\n",
+        SmbiosTable->FormattedArea[0],
+        SmbiosTable->FormattedArea[1],
+        SmbiosTable->FormattedArea[2],
+        SmbiosTable->FormattedArea[3],
+        SmbiosTable->FormattedArea[4]
+        ));
+      DEBUG ((EFI_D_INFO, "  IntermediateAnchorString    - '%c%c%c%c%c'\n",
+        SmbiosTable->IntermediateAnchorString[0],
+        SmbiosTable->IntermediateAnchorString[1],
+        SmbiosTable->IntermediateAnchorString[2],
+        SmbiosTable->IntermediateAnchorString[3],
+        SmbiosTable->IntermediateAnchorString[4]
+        ));
+      DEBUG ((EFI_D_INFO, "  IntermediateChecksum        - 0x%02x\n", SmbiosTable->IntermediateChecksum));
+      DEBUG ((EFI_D_INFO, "  TableLength                 - 0x%04x\n", SmbiosTable->TableLength));
+      DEBUG ((EFI_D_INFO, "  TableAddress                - 0x%08x\n", SmbiosTable->TableAddress));
+      DEBUG ((EFI_D_INFO, "  NumberOfSmbiosStructures    - 0x%04x\n", SmbiosTable->NumberOfSmbiosStructures));
+      DEBUG ((EFI_D_INFO, "  SmbiosBcdRevision           - 0x%02x\n", SmbiosTable->SmbiosBcdRevision));
+    }
+
+  if (Smbios3Table != NULL) {
+    SmbiosTableAddress = (VOID *)(UINTN)Smbios3Table->TableAddress;
+    TableLength = GetSmbiosTableLength (SmbiosTableAddress, Smbios3Table->TableMaximumSize);
+  } else if (SmbiosTable != NULL) {
+    SmbiosTableAddress = (VOID *)(UINTN)SmbiosTable->TableAddress;
+    TableLength = SmbiosTable->TableLength;
+  }
+
+  if (SmbiosTableAddress != NULL) {
+    DEBUG ((DEBUG_INFO, "The Smbios Table starts at: 0x%x\n", SmbiosTableAddress));
+    DEBUG ((DEBUG_INFO, "The Smbios Table size: 0x%x\n", TableLength));
+    InternalDumpHex ((UINT8 *)(UINTN)SmbiosTableAddress, TableLength);
+
+    TableAddress = AllocateCopyPool ((UINTN)TableLength, (VOID *)(UINTN)SmbiosTableAddress);
+    if (TableAddress == NULL) {
+      return ;
+    }
+
+    FilterSmbiosTable (TableAddress, TableLength);
+
+    DEBUG ((DEBUG_INFO, "The final Smbios Table starts at: 0x%x\n", TableAddress));
+    DEBUG ((DEBUG_INFO, "The final Smbios Table size: 0x%x\n", TableLength));
+    InternalDumpHex (TableAddress, TableLength);
+
+    HandoffTables.NumberOfTables = 1;
+    HandoffTables.TableEntry[0].VendorGuid  = gEfiSmbiosTableGuid;
+    HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
+    Status = TpmMeasureAndLogData (
+               1,                       // PCRIndex
+               EV_EFI_HANDOFF_TABLES,   // EventType
+               &HandoffTables,          // EventLog
+               sizeof (HandoffTables),  // LogLen
+               TableAddress,            // HashData
+               TableLength              // HashDataLen
+               );
+    if (EFI_ERROR (Status)) {
+      return ;
+    }
+  }
+
+  return ;
+}
+
+/**
+
+  Driver to produce Smbios measurement. 
+
+  @param ImageHandle     Module's image handle
+  @param SystemTable     Pointer of EFI_SYSTEM_TABLE
+
+  @retval EFI_SUCCESS    Smbios protocol installed
+  @retval Other          No protocol installed, unload driver.
+
+**/
+EFI_STATUS
+EFIAPI
+SmbiosMeasurementDriverEntryPoint (
+  IN EFI_HANDLE           ImageHandle,
+  IN EFI_SYSTEM_TABLE     *SystemTable
+  )
+{
+  EFI_STATUS            Status;
+  EFI_EVENT             Event;
+
+  Status = gBS->LocateProtocol (&gEfiSmbiosProtocolGuid, NULL, &mSmbios);
+  ASSERT_EFI_ERROR (Status);
+  DEBUG ((DEBUG_INFO, "The Smbios Table Version: %x.%x\n", mSmbios->MajorVersion, mSmbios->MinorVersion));
+  
+  if (mSmbios->MajorVersion < 2 || (mSmbios->MajorVersion == 2 && mSmbios->MinorVersion < 7)){
+    mMaxLen = SMBIOS_STRING_MAX_LENGTH;
+  } else if (mSmbios->MajorVersion < 3) {
+    //
+    // Reference SMBIOS 2.7, chapter 6.1.3, it will have no limit on the length of each individual text string.
+    // However, the length of the entire structure table (including all strings) must be reported
+    // in the Structure Table Length field of the SMBIOS Structure Table Entry Point,
+    // which is a WORD field limited to 65,535 bytes.
+    //
+    mMaxLen = SMBIOS_TABLE_MAX_LENGTH;
+  } else {
+    //
+    // SMBIOS 3.0 defines the Structure table maximum size as DWORD field limited to 0xFFFFFFFF bytes.
+    // Locate the end of string as long as possible.
+    //
+    mMaxLen = SMBIOS_3_0_TABLE_MAX_LENGTH;
+  }
+
+  //
+  // Measure Smbios tables
+  //
+  Status = EfiCreateEventReadyToBootEx (
+             TPL_CALLBACK,
+             MeasureSmbiosTable,
+             NULL,
+             &Event
+             );
+
+  return Status;
+}
diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
new file mode 100644
index 000000000000..6f894476e46d
--- /dev/null
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
@@ -0,0 +1,68 @@
+## @file
+# This driver measures SMBIOS table to TPM.
+#
+# This driver is a sample driver to follow TCG platform specification to
+# filter some fields in SMBIOS table.
+#   - Platform configuration information that is automatically updated,
+#     such as clock registers, and system unique information, such as
+#     asset numbers or serial numbers, MUST NOT be measured into PCR [1],
+#     or any other PCR.
+#
+# A platform may use its own policy to filter some fields in SMBIOS table.
+#
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SmbiosMeasurementDxe
+  MODULE_UNI_FILE                = SmbiosMeasurementDxe.uni
+  FILE_GUID                      = D27FED59-ABB4-4FED-BEAD-2A878C7E4A7E
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = SmbiosMeasurementDriverEntryPoint
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC ARM AARCH64
+#
+
+[Sources]
+  SmbiosMeasurementDxe.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  UefiBootServicesTableLib
+  MemoryAllocationLib
+  BaseMemoryLib
+  BaseLib
+  UefiLib
+  UefiDriverEntryPoint
+  DebugLib
+  TpmMeasurementLib
+
+[Protocols]
+  gEfiSmbiosProtocolGuid                            ## PRODUCES
+  
+[Guids]
+  gEfiSmbiosTableGuid                               ## SOMETIMES_PRODUCES ## SystemTable
+  gEfiSmbios3TableGuid                              ## SOMETIMES_PRODUCES ## SystemTable
+
+[Depex]
+  gEfiSmbiosProtocolGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  SmbiosMeasurementDxeExtra.uni
diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.uni b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.uni
new file mode 100644
index 0000000000000000000000000000000000000000..98b0f52a6a3968b18b637d33b0f3cb2f24a18e55
GIT binary patch
literal 1988
zcmds&U60aW5QXR3#Q#9p8#TM2Cf*oh1gYAnTLLAkR|d*wQa(~(b^pBjoGGP3Sl1Y@
z3~AqwnfJ^&GxL@o-|JSl3eO{c6?<i4n^|fjyKnc{l`Xa@duwJx%a~nb%~;JD`|NL7
zjojX~kJhx%BI{z`U>!J?=1WIv<5AmV-yI_XBejGWDYMO;aR$z41k(x;7rcj@8M7;d
z4eJ&ADJl}XVb#Y+zImL~Rm3Ki6?_&RG4t~YIE9Ww<=UOPbqo4%$5W`c<>OQaUc+kz
zCuMj7p13}M*F(mq_Sl}-GdpJ<?pUSFbtZE~nMa+u<{Fj;8s$-<seXB#R6W&jNF`oS
zua3R^ZADi2FX5yZb5M$$6{`ENOz@b)M7A5x+yu|Lvr@bnGiA4|c%NNmG_S>ob8F{R
z;_I}kr=4pa^<~*nTTaNTPAr(HKQf|9Yr#^?<T=AD&yTE2YFeIaQmGc}4|u4~IhT^_
zSHA%XZ{Z%Qo#8J;aVTzy#*M2U(04^#)g{JDipJiLs*pH;<9*EOFfVy7)v<%!`6UQ>
z@9JKZT-7-nD)HQJuX-xiBmd0R)li>N&-zjB*X#^nKD3J?OAVAMPZ=e)cNV~=P4`6h
zmUqMNOz1biMVEHb+F@*3k6GaP?b#(`z`in(Bb2!h>E{5Ct|Ldx)W>>P8M}-^tui)!
zt=0K2oUX77HS&lRyTYsE%r4mvK@~>i(L1cfU3-cd<0~IU&Ar~>tLUE@-(wMT-M?TL
zC07yHr#()I9+HbT-K3bUlixdiZR^fmIn{Hv@0kU)(YHhS`vOt~Mh~=rRRit0r9rl0
z{BHZ5`E3!_mY$t>*QgUNz!K9cr^}B0H{bQ@UeTYaQ7?4Sp+0Hv^M6Xw->dmw|3S)J
F{{*hWIG+Fj

literal 0
HcmV?d00001

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxeExtra.uni b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxeExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..4e081c44b8ab12ffaa6b76a2b7976925d8720162
GIT binary patch
literal 1358
zcmZvcTW`}q5QXO%iT|)lUjVfUAn}3_q9Fz%nu~H#%TwhfG_{mV<%H7k<ALwY+Ho3C
z<lXh`%$YN1CjRrgVGRpBFZc!fU^kZ8!oJ&6dxBMWLtEMe>)JNf;U;DOVL7KI&&sye
zvIkDVF7TOhzrgz!mYGLy@y+m?6BoE$x&0%)ij4?mwsH@q`#alt?A&hg4E7B4=j^ZT
zrM<E@cFMV3pe#5mCMQa3N`yGCtj^6joa7-U5lviF!-glfduLm>ch<Clz28?~@fpD(
z^9t_pUxT6?OHj&+ws=T|6qZvwmN3!XuBbj>5i8}(I4wY{@KdacmUdH4D`zGJOMFGo
ziVXLh)u)uss9S-KNLOJ8azrLE*V0*+C}JkhY_E@$Skw0^u1U{Zyk9)xQgQw1T1;90
ztu}*$5XB+trCb}{RrLg(hkcQ%Vt<1@c1WBb@Hyu6SeK~f4zEcOzb+IIqwRsNnw%}2
zc<a-wnTp!VKX;|;RG-t&#*y|LEEAZ|?Cj{K4$3W0rO3#>SOS|q)6=uhtmph!G@V1%
zmhU61ZRTriBYdUr*t+Zq_JA!SRNA+h=LC<TBlkFIj<wd<g)8(Ld(+?bc6z|+l6#@{
zJY%p+yavv!i@go1FnXSSz?-<srko>u<)f_8>l41p{*C=BH)5{;Us7a=RU~$`$EncU
zXwheyl(WVEvDB^HgMWP*ZkO$3KQH=f=nEw6t_yYhpbYjET!Y;Mbqs!jPZyRQPQlSm
u=$s~hPPbE5&6@guhQIhJTa8l(4OOjd|Nq9Ri&u`@@=4YgBPUh}<?|O5=F^q{

literal 0
HcmV?d00001


From bcdff59e3a033ce7b3e1046e69297a3e2cf3d0f1 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Mon, 16 Nov 2015 08:11:47 +0000
Subject: [PATCH 097/525] MdeModulePkg SetupBrowserDxe: Save global variable
 values before nest function called.

The SendForm function can be called nest in it. This function also uses some global variables. So we must save global variable values before it been called again.

Checked in the missing change for gBrowserFormSetList.

(Sync patch r18681 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18812 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/SetupBrowserDxe/Setup.c         | 29 +++++++++++++++++--
 .../Universal/SetupBrowserDxe/Setup.h         |  3 +-
 2 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
index 4a6758a5e489..cc9896959b6a 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.c
@@ -5541,8 +5541,9 @@ SaveBrowserContext (
   VOID
   )
 {
-  BROWSER_CONTEXT  *Context;
-  FORM_ENTRY_INFO     *MenuList;
+  BROWSER_CONTEXT      *Context;
+  FORM_ENTRY_INFO      *MenuList;
+  FORM_BROWSER_FORMSET *FormSet;
 
   gBrowserContextCount++;
   if (gBrowserContextCount == 1) {
@@ -5584,6 +5585,17 @@ SaveBrowserContext (
     InsertTailList(&Context->FormHistoryList, &MenuList->Link);
   }
 
+  //
+  // Save formset list.
+  //
+  InitializeListHead(&Context->FormSetList);
+  while (!IsListEmpty (&gBrowserFormSetList)) {
+    FormSet = FORM_BROWSER_FORMSET_FROM_LINK (gBrowserFormSetList.ForwardLink);
+    RemoveEntryList (&FormSet->Link);
+
+    InsertTailList(&Context->FormSetList, &FormSet->Link);
+  }
+
   //
   // Insert to FormBrowser context list
   //
@@ -5602,7 +5614,8 @@ RestoreBrowserContext (
 {
   LIST_ENTRY       *Link;
   BROWSER_CONTEXT  *Context;
-  FORM_ENTRY_INFO     *MenuList;
+  FORM_ENTRY_INFO      *MenuList;
+  FORM_BROWSER_FORMSET *FormSet;
 
   ASSERT (gBrowserContextCount != 0);
   gBrowserContextCount--;
@@ -5644,6 +5657,16 @@ RestoreBrowserContext (
     InsertTailList(&mPrivateData.FormBrowserEx2.FormViewHistoryHead, &MenuList->Link);
   }
 
+  //
+  // Restore the Formset data.
+  //
+  while (!IsListEmpty (&Context->FormSetList)) {
+    FormSet = FORM_BROWSER_FORMSET_FROM_LINK (Context->FormSetList.ForwardLink);
+    RemoveEntryList (&FormSet->Link);
+
+    InsertTailList(&gBrowserFormSetList, &FormSet->Link);
+  }
+
   //
   // Remove from FormBrowser context list
   //
diff --git a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
index 81e2a62df198..0abb09cf87b5 100644
--- a/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
+++ b/MdeModulePkg/Universal/SetupBrowserDxe/Setup.h
@@ -542,7 +542,8 @@ typedef struct {
   EFI_QUESTION_ID          CurFakeQestId;
   BOOLEAN                  HiiPackageListUpdated;
   BOOLEAN                  FinishRetrieveCall;
-  LIST_ENTRY           FormHistoryList;
+  LIST_ENTRY               FormHistoryList;
+  LIST_ENTRY               FormSetList;
 } BROWSER_CONTEXT;
 
 #define BROWSER_CONTEXT_FROM_LINK(a)  CR (a, BROWSER_CONTEXT, Link, BROWSER_CONTEXT_SIGNATURE)

From e42c0d6cf83cf42c2a1a209162e48a8ab33999de Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 16 Nov 2015 08:12:48 +0000
Subject: [PATCH 098/525] Publish FspHob to PEI Hob by default.

because most platforms use such logic.
PcdDataBaseHobGuid GuidHob is excluded because PCD database in FSP is different with the one in PEI.

(Sync patch r18687 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Ma, Maurice" <maurice.ma@intel.com>
Reviewed-by: "Rangarajan, Ravi P" <ravi.p.rangarajan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18813 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../FspHobProcessLibSample.c                  | 38 +++++++++++++++++++
 .../PeiFspHobProcessLibSample.inf             |  1 +
 2 files changed, 39 insertions(+)

diff --git a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
index 099980e52556..a96c151df4cd 100644
--- a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
+++ b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/FspHobProcessLibSample.c
@@ -25,6 +25,7 @@
 
 #include <Guid/GuidHobFspEas.h>
 #include <Guid/MemoryTypeInformation.h>
+#include <Guid/PcdDataBaseHobGuid.h>
 #include <Ppi/Capsule.h>
 
 //
@@ -334,6 +335,41 @@ FspHobProcessForMemoryResource (
   return EFI_SUCCESS;
 }
 
+/**
+  Process FSP HOB list
+
+  @param[in] FspHobList  Pointer to the HOB data structure produced by FSP.
+
+**/
+VOID
+ProcessFspHobList (
+  IN VOID                 *FspHobList
+  )
+{
+  EFI_PEI_HOB_POINTERS  FspHob;
+
+  FspHob.Raw = FspHobList;
+
+  //
+  // Add all the HOBs from FSP binary to FSP wrapper
+  //
+  while (!END_OF_HOB_LIST (FspHob)) {
+    if (FspHob.Header->HobType == EFI_HOB_TYPE_GUID_EXTENSION) {
+      //
+      // Skip FSP binary creates PcdDataBaseHobGuid
+      //
+      if (!CompareGuid(&FspHob.Guid->Name, &gPcdDataBaseHobGuid)) { 
+        BuildGuidDataHob (
+          &FspHob.Guid->Name,
+          GET_GUID_HOB_DATA(FspHob),
+          GET_GUID_HOB_DATA_SIZE(FspHob)
+        );
+      }
+    }
+    FspHob.Raw = GET_NEXT_HOB (FspHob);
+  }
+}
+
 /**
   BIOS process FspBobList for other data (not Memory Resource Descriptor).
 
@@ -347,6 +383,8 @@ FspHobProcessForOtherData (
   IN VOID                 *FspHobList
   )
 {
+  ProcessFspHobList (FspHobList);
+
   return EFI_SUCCESS;
 }
 
diff --git a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/PeiFspHobProcessLibSample.inf b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/PeiFspHobProcessLibSample.inf
index 12f922c0d965..c7f35f7bdfe8 100644
--- a/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/PeiFspHobProcessLibSample.inf
+++ b/IntelFspWrapperPkg/Library/PeiFspHobProcessLibSample/PeiFspHobProcessLibSample.inf
@@ -70,6 +70,7 @@
 [Guids]
   gFspReservedMemoryResourceHobGuid                       ## CONSUMES ## HOB
   gEfiMemoryTypeInformationGuid                           ## CONSUMES ## GUID
+  gPcdDataBaseHobGuid                                     ## CONSUMES ## HOB
 
 [Ppis]
   gEfiPeiCapsulePpiGuid                                   ## CONSUMES

From 1d5c1ea1c495cb9a2faa64bca18a898902cb167f Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:13:36 +0000
Subject: [PATCH 099/525] MdeModulePkg SmbiosMeasurementDxe: Use SMBIOS table
 and GUID correctly

1. Smbios3Table used as SmbiosTable wrongly after SmbiosTable got from configuration table.
2. Use correct VendorGuid and VendorTable to measure.

(Sync patch r18691 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18814 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmbiosMeasurementDxe.c                    | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index 21528276c11b..85963818dcdf 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -478,6 +478,8 @@ MeasureSmbiosTable (
       DEBUG ((EFI_D_INFO, "  TableAddress                - 0x%016lx\n", Smbios3Table->TableAddress));
     }
   }
+
+  if (Smbios3Table == NULL) {
     Status = EfiGetSystemConfigurationTable (
                &gEfiSmbiosTableGuid,
                (VOID **) &SmbiosTable
@@ -485,10 +487,10 @@ MeasureSmbiosTable (
     if (!EFI_ERROR (Status)) {
       DEBUG ((EFI_D_INFO, "SmbiosTable:\n"));
       DEBUG ((EFI_D_INFO, "  AnchorString                - '%c%c%c%c'\n",
-        Smbios3Table->AnchorString[0],
-        Smbios3Table->AnchorString[1],
-        Smbios3Table->AnchorString[2],
-        Smbios3Table->AnchorString[3]
+        SmbiosTable->AnchorString[0],
+        SmbiosTable->AnchorString[1],
+        SmbiosTable->AnchorString[2],
+        SmbiosTable->AnchorString[3]
         ));
       DEBUG ((EFI_D_INFO, "  EntryPointStructureChecksum - 0x%02x\n", SmbiosTable->EntryPointStructureChecksum));
       DEBUG ((EFI_D_INFO, "  EntryPointLength            - 0x%02x\n", SmbiosTable->EntryPointLength));
@@ -516,6 +518,7 @@ MeasureSmbiosTable (
       DEBUG ((EFI_D_INFO, "  NumberOfSmbiosStructures    - 0x%04x\n", SmbiosTable->NumberOfSmbiosStructures));
       DEBUG ((EFI_D_INFO, "  SmbiosBcdRevision           - 0x%02x\n", SmbiosTable->SmbiosBcdRevision));
     }
+  }
 
   if (Smbios3Table != NULL) {
     SmbiosTableAddress = (VOID *)(UINTN)Smbios3Table->TableAddress;
@@ -542,8 +545,13 @@ MeasureSmbiosTable (
     InternalDumpHex (TableAddress, TableLength);
 
     HandoffTables.NumberOfTables = 1;
-    HandoffTables.TableEntry[0].VendorGuid  = gEfiSmbiosTableGuid;
-    HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
+    if (Smbios3Table != NULL) {
+      CopyGuid (&(HandoffTables.TableEntry[0].VendorGuid), &gEfiSmbios3TableGuid);
+      HandoffTables.TableEntry[0].VendorTable = Smbios3Table;
+    } else {
+      CopyGuid (&(HandoffTables.TableEntry[0].VendorGuid), &gEfiSmbiosTableGuid);
+      HandoffTables.TableEntry[0].VendorTable = SmbiosTable;
+    }
     Status = TpmMeasureAndLogData (
                1,                       // PCRIndex
                EV_EFI_HANDOFF_TABLES,   // EventType

From fe76c80e960833a476394f3a75830c9543b7b0f5 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:14:30 +0000
Subject: [PATCH 100/525] MdeModulePkg SmbiosMeasurementDxe: Add (VOID **)
 typecast for GCC build failure

(Sync patch r18692 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18815 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index 85963818dcdf..e82b028116b4 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -589,7 +589,7 @@ SmbiosMeasurementDriverEntryPoint (
   EFI_STATUS            Status;
   EFI_EVENT             Event;
 
-  Status = gBS->LocateProtocol (&gEfiSmbiosProtocolGuid, NULL, &mSmbios);
+  Status = gBS->LocateProtocol (&gEfiSmbiosProtocolGuid, NULL, (VOID **) &mSmbios);
   ASSERT_EFI_ERROR (Status);
   DEBUG ((DEBUG_INFO, "The Smbios Table Version: %x.%x\n", mSmbios->MajorVersion, mSmbios->MinorVersion));
   

From 94780ec73fb2c6aad387c79e1b84ba5cbc303555 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:15:24 +0000
Subject: [PATCH 101/525] MdeModulePkg SmbiosMeasurementDxe: Use EFI_D_VERBOSE
 for internal dump functions

Use EFI_D_VERBOSE instead of EFI_D_INFO in InternalDumpData() and InternalDumpHex().
And also add DEBUG_CODE wrapper to InternalDumpHex() call.
It is to avoid the bother from the internal verbose debug information.

(Sync patch r18693 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18816 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmbiosMeasurementDxe.c                     | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index e82b028116b4..95a3aebefd74 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -125,7 +125,7 @@ InternalDumpData (
 {
   UINTN  Index;
   for (Index = 0; Index < Size; Index++) {
-    DEBUG ((EFI_D_INFO, "%02x", (UINTN)Data[Index]));
+    DEBUG ((EFI_D_VERBOSE, "%02x", (UINTN)Data[Index]));
   }
 }
 
@@ -152,15 +152,15 @@ InternalDumpHex (
   Count = Size / COLUME_SIZE;
   Left  = Size % COLUME_SIZE;
   for (Index = 0; Index < Count; Index++) {
-    DEBUG ((EFI_D_INFO, "%04x: ", Index * COLUME_SIZE));
+    DEBUG ((EFI_D_VERBOSE, "%04x: ", Index * COLUME_SIZE));
     InternalDumpData (Data + Index * COLUME_SIZE, COLUME_SIZE);
-    DEBUG ((EFI_D_INFO, "\n"));
+    DEBUG ((EFI_D_VERBOSE, "\n"));
   }
 
   if (Left != 0) {
-    DEBUG ((EFI_D_INFO, "%04x: ", Index * COLUME_SIZE));
+    DEBUG ((EFI_D_VERBOSE, "%04x: ", Index * COLUME_SIZE));
     InternalDumpData (Data + Index * COLUME_SIZE, Left);
-    DEBUG ((EFI_D_INFO, "\n"));
+    DEBUG ((EFI_D_VERBOSE, "\n"));
   }
 }
 
@@ -271,7 +271,7 @@ FilterSmbiosEntry (
   UINTN                 StringLen;
 
   DEBUG ((EFI_D_INFO, "Smbios Table (Type - %d):\n", ((SMBIOS_STRUCTURE *)TableEntry)->Type));
-  InternalDumpHex (TableEntry, TableEntrySize);
+  DEBUG_CODE (InternalDumpHex (TableEntry, TableEntrySize););
 
   FilterStruct = GetFilterStructByType (((SMBIOS_STRUCTURE *)TableEntry)->Type);
   if (FilterStruct != NULL) {
@@ -297,7 +297,7 @@ FilterSmbiosEntry (
   }
 
   DEBUG ((EFI_D_INFO, "Filter Smbios Table (Type - %d):\n", ((SMBIOS_STRUCTURE *)TableEntry)->Type));
-  InternalDumpHex (TableEntry, TableEntrySize);
+  DEBUG_CODE (InternalDumpHex (TableEntry, TableEntrySize););
 }
 
 /**
@@ -531,7 +531,7 @@ MeasureSmbiosTable (
   if (SmbiosTableAddress != NULL) {
     DEBUG ((DEBUG_INFO, "The Smbios Table starts at: 0x%x\n", SmbiosTableAddress));
     DEBUG ((DEBUG_INFO, "The Smbios Table size: 0x%x\n", TableLength));
-    InternalDumpHex ((UINT8 *)(UINTN)SmbiosTableAddress, TableLength);
+    DEBUG_CODE (InternalDumpHex ((UINT8 *)(UINTN)SmbiosTableAddress, TableLength););
 
     TableAddress = AllocateCopyPool ((UINTN)TableLength, (VOID *)(UINTN)SmbiosTableAddress);
     if (TableAddress == NULL) {
@@ -542,7 +542,7 @@ MeasureSmbiosTable (
 
     DEBUG ((DEBUG_INFO, "The final Smbios Table starts at: 0x%x\n", TableAddress));
     DEBUG ((DEBUG_INFO, "The final Smbios Table size: 0x%x\n", TableLength));
-    InternalDumpHex (TableAddress, TableLength);
+    DEBUG_CODE (InternalDumpHex (TableAddress, TableLength););
 
     HandoffTables.NumberOfTables = 1;
     if (Smbios3Table != NULL) {

From e9d4d6455347484ccf16ee772ee0cea29f0ed2ea Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:16:22 +0000
Subject: [PATCH 102/525] MdeModulePkg SmbiosMeasurementDxe: Remove the tailing
 whitespace

(Sync patch r18694 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18817 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmbiosMeasurementDxe.c                    | 26 +++++++++----------
 .../SmbiosMeasurementDxe.inf                  |  2 +-
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index 95a3aebefd74..9a73f299b1f6 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -1,14 +1,14 @@
 /** @file
   This driver measures SMBIOS table to TPM.
-  
+
 Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials                          
-are licensed and made available under the terms and conditions of the BSD License         
-which accompanies this distribution.  The full text of the license may be found at        
-http://opensource.org/licenses/bsd-license.php                                            
-                                                                                          
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 **/
 
@@ -217,7 +217,7 @@ GetSmbiosStringById (
   // look for the two consecutive zeros, check the string limit by the way.
   //
   String = NULL;
-  while (*CharInStr != 0 || *(CharInStr+1) != 0) { 
+  while (*CharInStr != 0 || *(CharInStr+1) != 0) {
     if (*CharInStr == 0) {
       Size += 1;
       CharInStr++;
@@ -306,7 +306,7 @@ FilterSmbiosEntry (
 
   @param Head                   Pointer to the beginning of SMBIOS structure.
   @param NumberOfStrings        The returned number of optional strings that follow the formatted structure.
-  
+
   @return Size                  The returned size.
 **/
 UINTN
@@ -327,7 +327,7 @@ GetSmbiosStructureSize (
   //
   // look for the two consecutive zeros, check the string limit by the way.
   //
-  while (*CharInStr != 0 || *(CharInStr+1) != 0) { 
+  while (*CharInStr != 0 || *(CharInStr+1) != 0) {
     if (*CharInStr == 0) {
       Size += 1;
       CharInStr++;
@@ -570,7 +570,7 @@ MeasureSmbiosTable (
 
 /**
 
-  Driver to produce Smbios measurement. 
+  Driver to produce Smbios measurement.
 
   @param ImageHandle     Module's image handle
   @param SystemTable     Pointer of EFI_SYSTEM_TABLE
@@ -592,7 +592,7 @@ SmbiosMeasurementDriverEntryPoint (
   Status = gBS->LocateProtocol (&gEfiSmbiosProtocolGuid, NULL, (VOID **) &mSmbios);
   ASSERT_EFI_ERROR (Status);
   DEBUG ((DEBUG_INFO, "The Smbios Table Version: %x.%x\n", mSmbios->MajorVersion, mSmbios->MinorVersion));
-  
+
   if (mSmbios->MajorVersion < 2 || (mSmbios->MajorVersion == 2 && mSmbios->MinorVersion < 7)){
     mMaxLen = SMBIOS_STRING_MAX_LENGTH;
   } else if (mSmbios->MajorVersion < 3) {
diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
index 6f894476e46d..3193a6df6ea4 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
@@ -56,7 +56,7 @@
 
 [Protocols]
   gEfiSmbiosProtocolGuid                            ## PRODUCES
-  
+
 [Guids]
   gEfiSmbiosTableGuid                               ## SOMETIMES_PRODUCES ## SystemTable
   gEfiSmbios3TableGuid                              ## SOMETIMES_PRODUCES ## SystemTable

From 62f3bd24e0e16203b568a7a637633e8cf6c1d40e Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:17:16 +0000
Subject: [PATCH 103/525] MdeModulePkg SmbiosMeasurementDxe: Correct the
 comments

1. Correct the return comments of entrypoint function.
2. Add parameters' comments for MeasureSmbiosTable().
3. Correct the Protocols and Guids usage comments in SmbiosMeasurementDxe.inf.

(Sync patch r18695 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18818 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmbiosMeasurementDxe/SmbiosMeasurementDxe.c          | 9 ++++++---
 .../SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf        | 6 +++---
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index 9a73f299b1f6..5aafabfcedaf 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -432,7 +432,11 @@ FilterSmbiosTable (
 }
 
 /**
-  Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1]
+  Measure SMBIOS with EV_EFI_HANDOFF_TABLES to PCR[1].
+
+  @param[in] Event      Event whose notification function is being invoked.
+  @param[in] Context    Pointer to the notification function's context.
+
 **/
 VOID
 EFIAPI
@@ -575,8 +579,7 @@ MeasureSmbiosTable (
   @param ImageHandle     Module's image handle
   @param SystemTable     Pointer of EFI_SYSTEM_TABLE
 
-  @retval EFI_SUCCESS    Smbios protocol installed
-  @retval Other          No protocol installed, unload driver.
+  @return Status returned from EfiCreateEventReadyToBootEx().
 
 **/
 EFI_STATUS
diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
index 3193a6df6ea4..c5a779cca7fe 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.inf
@@ -55,11 +55,11 @@
   TpmMeasurementLib
 
 [Protocols]
-  gEfiSmbiosProtocolGuid                            ## PRODUCES
+  gEfiSmbiosProtocolGuid                            ## CONSUMES
 
 [Guids]
-  gEfiSmbiosTableGuid                               ## SOMETIMES_PRODUCES ## SystemTable
-  gEfiSmbios3TableGuid                              ## SOMETIMES_PRODUCES ## SystemTable
+  gEfiSmbiosTableGuid                               ## SOMETIMES_CONSUMES ## SystemTable
+  gEfiSmbios3TableGuid                              ## SOMETIMES_CONSUMES ## SystemTable
 
 [Depex]
   gEfiSmbiosProtocolGuid

From 69015f48a9651c3c9b44c3e8e3baab7d98db5333 Mon Sep 17 00:00:00 2001
From: Nagaraj Hegde <nagaraj-p.hegde@hpe.com>
Date: Mon, 16 Nov 2015 08:18:01 +0000
Subject: [PATCH 104/525] NetworkPkg: HttpDxe sometimes free a pointer twice

In EfiHttpRequest, HostName was getting freed twice whenever
HttpTransmitTcp4 failed. Moved FreePool (HostName) after
HttpTransmitTcp4 call to avoid a double free.

(Sync patch r18709 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Nagaraj Hegde <nagaraj-p.hegde@hpe.com>
Reviewed-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18819 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 50c061743665..09ee379150a9 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -486,10 +486,6 @@ EfiHttpRequest (
     goto Error4;
   }
 
-  if (HostName != NULL) {
-    FreePool (HostName);
-  }
-
   //
   // Transmit the request message.
   //
@@ -505,6 +501,10 @@ EfiHttpRequest (
 
   DispatchDpc ();
 
+  if (HostName != NULL) {
+    FreePool (HostName);
+  }
+
   return EFI_SUCCESS;
 
 Error5:

From e95c0ce475df9d9e2a6f9e9e53a72b88f3801ed5 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 16 Nov 2015 08:18:40 +0000
Subject: [PATCH 105/525] MdeModulePkg SmbiosMeasurementDxe: NULL check to
 String from GetSmbiosStringById

When StringId is not 0, String returned from GetSmbiosStringById is expected to non-NULL.
Add ASSERT (String != NULL); to ensure this.

(Sync patch r18713 from main trunk.)

Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Shumin Qiu <shumin.qiu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18820 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
index 5aafabfcedaf..f9e0196677a9 100644
--- a/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
+++ b/MdeModulePkg/Universal/SmbiosMeasurementDxe/SmbiosMeasurementDxe.c
@@ -286,6 +286,7 @@ FilterSmbiosEntry (
           if (StringId != 0) {
             // set ' ' for string field
             String = GetSmbiosStringById (TableEntry, StringId, &StringLen);
+            ASSERT (String != NULL);
             //DEBUG ((EFI_D_INFO,"StrId(0x%x)-%a(%d)\n", StringId, String, StringLen));
             SetMem (String, StringLen, ' ');
           }

From 595df205dd889bf0a6bc3e92b50aa60d5e83f0c2 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 16 Nov 2015 08:19:27 +0000
Subject: [PATCH 106/525] MdeModulePkg: Fix a PCI resource dumping bug in
 PciBusDxe driver

The resource dumping logic contains a bug which cannot dump the
resource for hot plug controller correctly. The patch fixes this
bug.

(Sync patch r18718 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18821 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Bus/Pci/PciBusDxe/PciEnumeratorSupport.c  |  80 ++++++++-
 .../Bus/Pci/PciBusDxe/PciEnumeratorSupport.h  |  15 +-
 MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c       | 156 +++++++++---------
 3 files changed, 171 insertions(+), 80 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c b/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
index f46025e2f61c..b070eb1b5f4b 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.c
@@ -315,6 +315,81 @@ PciSearchDevice (
   return EFI_SUCCESS;
 }
 
+/**
+  Dump the PPB padding resource information.
+
+  @param PciIoDevice     PCI IO instance.
+  @param ResourceType    The desired resource type to dump.
+                         PciBarTypeUnknown means to dump all types of resources.
+**/
+VOID
+DumpPpbPaddingResource (
+  IN PCI_IO_DEVICE                    *PciIoDevice,
+  IN PCI_BAR_TYPE                     ResourceType
+  )
+{
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  PCI_BAR_TYPE                      Type;
+
+  if (PciIoDevice->ResourcePaddingDescriptors == NULL) {
+    return;
+  }
+
+  if (ResourceType == PciBarTypeIo16 || ResourceType == PciBarTypeIo32) {
+    ResourceType = PciBarTypeIo;
+  }
+
+  for (Descriptor = PciIoDevice->ResourcePaddingDescriptors; Descriptor->Desc != ACPI_END_TAG_DESCRIPTOR; Descriptor++) {
+
+    Type = PciBarTypeUnknown;
+    if (Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR && Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_IO) {
+      Type = PciBarTypeIo;
+    } else if (Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR && Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
+
+      if (Descriptor->AddrSpaceGranularity == 32) {
+        //
+        // prefechable
+        //
+        if (Descriptor->SpecificFlag == EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) {
+          Type = PciBarTypePMem32;
+        }
+
+        //
+        // Non-prefechable
+        //
+        if (Descriptor->SpecificFlag == 0) {
+          Type = PciBarTypeMem32;
+        }
+      }
+
+      if (Descriptor->AddrSpaceGranularity == 64) {
+        //
+        // prefechable
+        //
+        if (Descriptor->SpecificFlag == EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) {
+          Type = PciBarTypePMem64;
+        }
+
+        //
+        // Non-prefechable
+        //
+        if (Descriptor->SpecificFlag == 0) {
+          Type = PciBarTypeMem64;
+        }
+      }
+    }
+
+    if ((Type != PciBarTypeUnknown) && ((ResourceType == PciBarTypeUnknown) || (ResourceType == Type))) {
+      DEBUG ((
+        EFI_D_INFO,
+        "   Padding: Type = %s; Alignment = 0x%lx;\tLength = 0x%lx\n",
+        mBarTypeStr[Type], Descriptor->AddrRangeMax, Descriptor->AddrLen
+        ));
+    }
+  }
+
+}
+
 /**
   Dump the PCI BAR information.
 
@@ -577,7 +652,10 @@ GatherPpbInfo (
 
   GetResourcePaddingPpb (PciIoDevice);
 
-  DEBUG_CODE (DumpPciBars (PciIoDevice););
+  DEBUG_CODE (
+    DumpPpbPaddingResource (PciIoDevice, PciBarTypeUnknown);
+    DumpPciBars (PciIoDevice);
+  );
 
   return PciIoDevice;
 }
diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h b/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h
index a4489b895fc4..42306e9a47d9 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciEnumeratorSupport.h
@@ -1,7 +1,7 @@
 /** @file
   PCI emumeration support functions declaration for PCI Bus module.
 
-Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -460,4 +460,17 @@ ResetAllPpbBusNumber (
   IN UINT8                              StartBusNumber
   );
 
+/**
+  Dump the PPB padding resource information.
+
+  @param PciIoDevice     PCI IO instance.
+  @param ResourceType    The desired resource type to dump.
+                         PciBarTypeUnknown means to dump all types of resources.
+**/
+VOID
+DumpPpbPaddingResource (
+  IN PCI_IO_DEVICE                    *PciIoDevice,
+  IN PCI_BAR_TYPE                     ResourceType
+  );
+
 #endif
diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c b/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
index b3d91a8d3037..bfb7e5bee98a 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
@@ -1,7 +1,8 @@
 /** @file
   Internal library implementation for PCI Bus module.
 
-Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -187,19 +188,21 @@ DumpBridgeResource (
       BridgeResource->PciDev->PciBar[BridgeResource->Bar].BaseAddress,
       BridgeResource->Length, BridgeResource->Alignment
       ));
-    for ( Link = BridgeResource->ChildList.ForwardLink
-        ; Link != &BridgeResource->ChildList
-        ; Link = Link->ForwardLink
+    for ( Link = GetFirstNode (&BridgeResource->ChildList)
+        ; !IsNull (&BridgeResource->ChildList, Link)
+        ; Link = GetNextNode (&BridgeResource->ChildList, Link)
         ) {
       Resource = RESOURCE_NODE_FROM_LINK (Link);
       if (Resource->ResourceUsage == PciResUsageTypical) {
         Bar = Resource->Virtual ? Resource->PciDev->VfPciBar : Resource->PciDev->PciBar;
         DEBUG ((
-          EFI_D_INFO, " Base = 0x%lx;\tLength = 0x%lx;\tAlignment = 0x%lx;\tOwner = %s ",
+          EFI_D_INFO, "   Base = 0x%lx;\tLength = 0x%lx;\tAlignment = 0x%lx;\tOwner = %s [%02x|%02x|%02x:",
           Bar[Resource->Bar].BaseAddress, Resource->Length, Resource->Alignment,
           IS_PCI_BRIDGE (&Resource->PciDev->Pci)     ? L"PPB" :
           IS_CARDBUS_BRIDGE (&Resource->PciDev->Pci) ? L"P2C" :
-                                                       L"PCI"
+                                                       L"PCI",
+          Resource->PciDev->BusNumber, Resource->PciDev->DeviceNumber,
+          Resource->PciDev->FunctionNumber
           ));
 
         if ((!IS_PCI_BRIDGE (&Resource->PciDev->Pci) && !IS_CARDBUS_BRIDGE (&Resource->PciDev->Pci)) ||
@@ -209,24 +212,20 @@ DumpBridgeResource (
           //
           // The resource requirement comes from the device itself.
           //
-          DEBUG ((
-            EFI_D_INFO, " [%02x|%02x|%02x:%02x]\n",
-            Resource->PciDev->BusNumber, Resource->PciDev->DeviceNumber,
-            Resource->PciDev->FunctionNumber, Bar[Resource->Bar].Offset
-            ));
+          DEBUG ((EFI_D_INFO, "%02x]", Bar[Resource->Bar].Offset));
         } else {
           //
           // The resource requirement comes from the subordinate devices.
           //
-          DEBUG ((
-            EFI_D_INFO, " [%02x|%02x|%02x:**]\n",
-            Resource->PciDev->BusNumber, Resource->PciDev->DeviceNumber,
-            Resource->PciDev->FunctionNumber
-            ));
+          DEBUG ((EFI_D_INFO, "**]"));
         }
       } else {
-        DEBUG ((EFI_D_INFO, " Padding:Length = 0x%lx;\tAlignment = 0x%lx\n", Resource->Length, Resource->Alignment));
+        DEBUG ((EFI_D_INFO, "   Base = Padding;\tLength = 0x%lx;\tAlignment = 0x%lx", Resource->Length, Resource->Alignment));
       }
+      if (BridgeResource->ResType != Resource->ResType) {
+        DEBUG ((EFI_D_INFO, "; Type = %s", mBarTypeStr[MIN (Resource->ResType, PciBarTypeMaxType)]));
+      }
+      DEBUG ((EFI_D_INFO, "\n"));
     }
   }
 }
@@ -234,63 +233,61 @@ DumpBridgeResource (
 /**
   Find the corresponding resource node for the Device in child list of BridgeResource.
   
-  @param[in] Device         Pointer to PCI_IO_DEVICE.
-  @param[in] BridgeResource Pointer to PCI_RESOURCE_NODE.
+  @param[in]  Device          Pointer to PCI_IO_DEVICE.
+  @param[in]  BridgeResource  Pointer to PCI_RESOURCE_NODE.
+  @param[out] DeviceResources Pointer to a buffer to receive resources for the Device.
   
-  @return !NULL  The corresponding resource node for the Device.
-  @return NULL   No corresponding resource node for the Device.
+  @return Count of the resource descriptors returned.
 **/
-PCI_RESOURCE_NODE *
+UINTN
 FindResourceNode (
-  IN PCI_IO_DEVICE     *Device,
-  IN PCI_RESOURCE_NODE *BridgeResource
+  IN  PCI_IO_DEVICE     *Device,
+  IN  PCI_RESOURCE_NODE *BridgeResource,
+  OUT PCI_RESOURCE_NODE **DeviceResources OPTIONAL
   )
 {
   LIST_ENTRY               *Link;
   PCI_RESOURCE_NODE        *Resource;
+  UINTN                    Count;
 
+  Count = 0;
   for ( Link = BridgeResource->ChildList.ForwardLink
       ; Link != &BridgeResource->ChildList
       ; Link = Link->ForwardLink
       ) {
     Resource = RESOURCE_NODE_FROM_LINK (Link);
     if (Resource->PciDev == Device) {
-      return Resource;
+      if (DeviceResources != NULL) {
+        DeviceResources[Count] = Resource;
+      }
+      Count++;
     }
   }
 
-  return NULL;
+  return Count;
 }
 
 /**
   Dump the resource map of all the devices under Bridge.
   
-  @param[in] Bridge     Bridge device instance.
-  @param[in] IoNode     IO resource descriptor for the bridge device.
-  @param[in] Mem32Node  Mem32 resource descriptor for the bridge device.
-  @param[in] PMem32Node PMem32 resource descriptor for the bridge device.
-  @param[in] Mem64Node  Mem64 resource descriptor for the bridge device.
-  @param[in] PMem64Node PMem64 resource descriptor for the bridge device.
+  @param[in] Bridge        Bridge device instance.
+  @param[in] Resources     Resource descriptors for the bridge device.
+  @param[in] ResourceCount Count of resource descriptors.
 **/
 VOID
 DumpResourceMap (
   IN PCI_IO_DEVICE     *Bridge,
-  IN PCI_RESOURCE_NODE *IoNode,
-  IN PCI_RESOURCE_NODE *Mem32Node,
-  IN PCI_RESOURCE_NODE *PMem32Node,
-  IN PCI_RESOURCE_NODE *Mem64Node,
-  IN PCI_RESOURCE_NODE *PMem64Node
+  IN PCI_RESOURCE_NODE **Resources,
+  IN UINTN             ResourceCount
   )
 {
-  EFI_STATUS                       Status;
-  LIST_ENTRY                       *Link;
-  PCI_IO_DEVICE                    *Device;
-  PCI_RESOURCE_NODE                *ChildIoNode;
-  PCI_RESOURCE_NODE                *ChildMem32Node;
-  PCI_RESOURCE_NODE                *ChildPMem32Node;
-  PCI_RESOURCE_NODE                *ChildMem64Node;
-  PCI_RESOURCE_NODE                *ChildPMem64Node;
-  CHAR16                           *Str;
+  EFI_STATUS           Status;
+  LIST_ENTRY           *Link;
+  PCI_IO_DEVICE        *Device;
+  UINTN                Index;
+  CHAR16               *Str;
+  PCI_RESOURCE_NODE    **ChildResources;
+  UINTN                ChildResourceCount;
 
   DEBUG ((EFI_D_INFO, "PciBus: Resource Map for "));
 
@@ -319,11 +316,9 @@ DumpResourceMap (
     }
   }
 
-  DumpBridgeResource (IoNode);
-  DumpBridgeResource (Mem32Node);
-  DumpBridgeResource (PMem32Node);
-  DumpBridgeResource (Mem64Node);
-  DumpBridgeResource (PMem64Node);
+  for (Index = 0; Index < ResourceCount; Index++) {
+    DumpBridgeResource (Resources[Index]);
+  }
   DEBUG ((EFI_D_INFO, "\n"));
 
   for ( Link = Bridge->ChildList.ForwardLink
@@ -333,20 +328,19 @@ DumpResourceMap (
     Device = PCI_IO_DEVICE_FROM_LINK (Link);
     if (IS_PCI_BRIDGE (&Device->Pci)) {
 
-      ChildIoNode     = (IoNode     == NULL ? NULL : FindResourceNode (Device, IoNode));
-      ChildMem32Node  = (Mem32Node  == NULL ? NULL : FindResourceNode (Device, Mem32Node));
-      ChildPMem32Node = (PMem32Node == NULL ? NULL : FindResourceNode (Device, PMem32Node));
-      ChildMem64Node  = (Mem64Node  == NULL ? NULL : FindResourceNode (Device, Mem64Node));
-      ChildPMem64Node = (PMem64Node == NULL ? NULL : FindResourceNode (Device, PMem64Node));
-
-      DumpResourceMap (
-        Device,
-        ChildIoNode,
-        ChildMem32Node,
-        ChildPMem32Node,
-        ChildMem64Node,
-        ChildPMem64Node
-        );
+      ChildResourceCount = 0;
+      for (Index = 0; Index < ResourceCount; Index++) {
+        ChildResourceCount += FindResourceNode (Device, Resources[Index], NULL);
+      }
+      ChildResources = AllocatePool (sizeof (PCI_RESOURCE_NODE *) * ChildResourceCount);
+      ASSERT (ChildResources != NULL);
+      ChildResourceCount = 0;
+      for (Index = 0; Index < ResourceCount; Index++) {
+        ChildResourceCount += FindResourceNode (Device, Resources[Index], &ChildResources[ChildResourceCount]);
+      }
+
+      DumpResourceMap (Device, ChildResources, ChildResourceCount);
+      FreePool (ChildResources);
     }
   }
 }
@@ -806,11 +800,11 @@ PciHostBridgeResourceAllocator (
     // Create the entire system resource map from the information collected by
     // enumerator. Several resource tree was created
     //
-    IoBridge     = FindResourceNode (RootBridgeDev, &IoPool);
-    Mem32Bridge  = FindResourceNode (RootBridgeDev, &Mem32Pool);
-    PMem32Bridge = FindResourceNode (RootBridgeDev, &PMem32Pool);
-    Mem64Bridge  = FindResourceNode (RootBridgeDev, &Mem64Pool);
-    PMem64Bridge = FindResourceNode (RootBridgeDev, &PMem64Pool);
+    FindResourceNode (RootBridgeDev, &IoPool, &IoBridge);
+    FindResourceNode (RootBridgeDev, &Mem32Pool, &Mem32Bridge);
+    FindResourceNode (RootBridgeDev, &PMem32Pool, &PMem32Bridge);
+    FindResourceNode (RootBridgeDev, &Mem64Pool, &Mem64Bridge);
+    FindResourceNode (RootBridgeDev, &PMem64Pool, &PMem64Bridge);
 
     ASSERT (IoBridge     != NULL);
     ASSERT (Mem32Bridge  != NULL);
@@ -868,14 +862,13 @@ PciHostBridgeResourceAllocator (
     // Dump the resource map for current root bridge
     //
     DEBUG_CODE (
-      DumpResourceMap (
-        RootBridgeDev,
-        IoBridge,
-        Mem32Bridge,
-        PMem32Bridge,
-        Mem64Bridge,
-        PMem64Bridge
-        );
+      PCI_RESOURCE_NODE *Resources[5];
+      Resources[0] = IoBridge;
+      Resources[1] = Mem32Bridge;
+      Resources[2] = PMem32Bridge;
+      Resources[3] = Mem64Bridge;
+      Resources[4] = PMem64Bridge;
+      DumpResourceMap (RootBridgeDev, Resources, sizeof (Resources) / sizeof (Resources[0]));
     );
 
     FreePool (AcpiConfig);
@@ -1022,6 +1015,13 @@ PciScanBus (
                 Func
                 );
 
+      if (EFI_ERROR (Status) && Func == 0) {
+        //
+        // go to next device if there is no Function 0
+        //
+        break;
+      }
+
       if (EFI_ERROR (Status)) {
         continue;
       }

From aa498e38bf2f7e86b695587a3487bca830b9bbde Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 16 Nov 2015 08:20:17 +0000
Subject: [PATCH 107/525] MdeModulePkg: Fix a PciBusDxe hot plug bug

For a hot plug bridge with device attached, PciBusDxe driver reserves
the resources which equal to the total amount of padding resource
returned from HotPlug->GetResourcePadding() and the actual occupied
resource by the attached device. The behavior is incorrect.
Correct behavior is to reserve the bigger one between the padding
resource and the actual occupied resource.

(Sync patch r18719 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18822 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c       | 13 ++--
 .../Bus/Pci/PciBusDxe/PciResourceSupport.c    | 60 ++++++++++++-------
 2 files changed, 48 insertions(+), 25 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c b/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
index bfb7e5bee98a..12647be85fb3 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciLib.c
@@ -976,7 +976,8 @@ PciScanBus (
   UINT8                             Device;
   UINT8                             Func;
   UINT64                            Address;
-  UINTN                             SecondBus;
+  UINT8                             SecondBus;
+  UINT8                             PaddedSubBus;
   UINT16                            Register;
   UINTN                             HpIndex;
   PCI_IO_DEVICE                     *PciDevice;
@@ -1210,7 +1211,7 @@ PciScanBus (
 
           Status = PciScanBus (
                     PciDevice,
-                    (UINT8) (SecondBus),
+                    SecondBus,
                     SubBusNumber,
                     PaddedBusRange
                     );
@@ -1226,12 +1227,16 @@ PciScanBus (
           if ((Attributes == EfiPaddingPciRootBridge) &&
               (State & EFI_HPC_STATE_ENABLED) != 0    &&
               (State & EFI_HPC_STATE_INITIALIZED) != 0) {
-            *PaddedBusRange = (UINT8) ((UINT8) (BusRange) +*PaddedBusRange);
+            *PaddedBusRange = (UINT8) ((UINT8) (BusRange) + *PaddedBusRange);
           } else {
-            Status = PciAllocateBusNumber (PciDevice, *SubBusNumber, (UINT8) (BusRange), SubBusNumber);
+            //
+            // Reserve the larger one between the actual occupied bus number and padded bus number
+            //
+            Status = PciAllocateBusNumber (PciDevice, StartBusNumber, (UINT8) (BusRange), &PaddedSubBus);
             if (EFI_ERROR (Status)) {
               return Status;
             }
+            *SubBusNumber = MAX (PaddedSubBus, *SubBusNumber);
           }
         }
 
diff --git a/MdeModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c b/MdeModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c
index d8d988cbfc27..e12d59f1d01f 100644
--- a/MdeModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c
+++ b/MdeModulePkg/Bus/Pci/PciBusDxe/PciResourceSupport.c
@@ -1,7 +1,7 @@
 /** @file
   PCI resouces support functions implemntation for PCI Bus module.
 
-Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -196,6 +196,7 @@ CalculateApertureIo16 (
   PCI_RESOURCE_NODE       *Node;
   UINT64                  Offset;
   EFI_PCI_PLATFORM_POLICY PciPolicy;
+  UINT64                  PaddingAperture;
 
   if (!mPolicyDetermined) {
     //
@@ -228,21 +229,27 @@ CalculateApertureIo16 (
     mPolicyDetermined = TRUE;
   }
 
-  Aperture = 0;
+  Aperture        = 0;
+  PaddingAperture = 0;
 
   if (Bridge == NULL) {
     return ;
   }
 
-  CurrentLink = Bridge->ChildList.ForwardLink;
-
   //
   // Assume the bridge is aligned
   //
-  while (CurrentLink != &Bridge->ChildList) {
+  for ( CurrentLink = GetFirstNode (&Bridge->ChildList)
+      ; !IsNull (&Bridge->ChildList, CurrentLink)
+      ; CurrentLink = GetNextNode (&Bridge->ChildList, CurrentLink)
+      ) {
 
     Node = RESOURCE_NODE_FROM_LINK (CurrentLink);
-
+    if (Node->ResourceUsage == PciResUsagePadding) {
+      ASSERT (PaddingAperture == 0);
+      PaddingAperture = Node->Length;
+      continue;
+    }
     //
     // Consider the aperture alignment
     //
@@ -293,13 +300,10 @@ CalculateApertureIo16 (
     // Increment aperture by the length of node
     //
     Aperture += Node->Length;
-
-    CurrentLink = CurrentLink->ForwardLink;
   }
 
   //
-  // At last, adjust the aperture with the bridge's
-  // alignment
+  // Adjust the aperture with the bridge's alignment
   //
   Offset = Aperture & (Bridge->Alignment);
 
@@ -319,6 +323,12 @@ CalculateApertureIo16 (
       Bridge->Alignment = Node->Alignment;
     }
   }
+
+  //
+  // Hotplug controller needs padding resources.
+  // Use the larger one between the padding resource and actual occupied resource.
+  //
+  Bridge->Length = MAX (Bridge->Length, PaddingAperture);
 }
 
 /**
@@ -336,10 +346,11 @@ CalculateResourceAperture (
   UINT64            Aperture;
   LIST_ENTRY        *CurrentLink;
   PCI_RESOURCE_NODE *Node;
-
+  UINT64            PaddingAperture;
   UINT64            Offset;
 
-  Aperture = 0;
+  Aperture        = 0;
+  PaddingAperture = 0;
 
   if (Bridge == NULL) {
     return ;
@@ -351,14 +362,20 @@ CalculateResourceAperture (
     return ;
   }
 
-  CurrentLink = Bridge->ChildList.ForwardLink;
-
   //
   // Assume the bridge is aligned
   //
-  while (CurrentLink != &Bridge->ChildList) {
+  for ( CurrentLink = GetFirstNode (&Bridge->ChildList)
+      ; !IsNull (&Bridge->ChildList, CurrentLink)
+      ; CurrentLink = GetNextNode (&Bridge->ChildList, CurrentLink)
+      ) {
 
     Node = RESOURCE_NODE_FROM_LINK (CurrentLink);
+    if (Node->ResourceUsage == PciResUsagePadding) {
+      ASSERT (PaddingAperture == 0);
+      PaddingAperture = Node->Length;
+      continue;
+    }
 
     //
     // Apply padding resource if available
@@ -381,11 +398,6 @@ CalculateResourceAperture (
     // Increment aperture by the length of node
     //
     Aperture += Node->Length;
-
-    //
-    // Consider the aperture alignment
-    //
-    CurrentLink = CurrentLink->ForwardLink;
   }
 
   //
@@ -407,7 +419,7 @@ CalculateResourceAperture (
   }
 
   //
-  // At last, adjust the bridge's alignment to the first child's alignment
+  // Adjust the bridge's alignment to the first child's alignment
   // if the bridge has at least one child
   //
   CurrentLink = Bridge->ChildList.ForwardLink;
@@ -417,6 +429,12 @@ CalculateResourceAperture (
       Bridge->Alignment = Node->Alignment;
     }
   }
+
+  //
+  // Hotplug controller needs padding resources.
+  // Use the larger one between the padding resource and actual occupied resource.
+  //
+  Bridge->Length = MAX (Bridge->Length, PaddingAperture);
 }
 
 /**

From fd499fabd32969c702dde04b37fe782871c6ffce Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:50:47 +0000
Subject: [PATCH 108/525] UefiCpuPkg: Update CPU MP drivers to support single
 CPU configuration

Only perform AP detection if PcdCpuMaxLogicalProcessorNumber > 1
Only free AP related structures of they were allocated

(Sync patch r18629 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18824 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuDxe/CpuMp.c      | 49 +++++++++++++++++++---------------
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 34 +++++++++++++----------
 2 files changed, 48 insertions(+), 35 deletions(-)

diff --git a/UefiCpuPkg/CpuDxe/CpuMp.c b/UefiCpuPkg/CpuDxe/CpuMp.c
index 4ddcca208a36..da3686e2788e 100644
--- a/UefiCpuPkg/CpuDxe/CpuMp.c
+++ b/UefiCpuPkg/CpuDxe/CpuMp.c
@@ -1642,35 +1642,40 @@ InitializeMpSupport (
     return;
   }
 
-  if (gMaxLogicalProcessorNumber == 1) {
-    return;
-  }
 
-  gApStackSize = (UINTN) PcdGet32 (PcdCpuApStackSize);
-  ASSERT ((gApStackSize & (SIZE_4KB - 1)) == 0);
 
-  mApStackStart = AllocatePages (EFI_SIZE_TO_PAGES (gMaxLogicalProcessorNumber * gApStackSize));
-  ASSERT (mApStackStart != NULL);
+  InitMpSystemData ();
 
   //
-  // the first buffer of stack size used for common stack, when the amount of AP
-  // more than 1, we should never free the common stack which maybe used for AP reset.
+  // Only perform AP detection if PcdCpuMaxLogicalProcessorNumber is greater than 1
   //
-  mCommonStack = mApStackStart;
-  mTopOfApCommonStack = (UINT8*) mApStackStart + gApStackSize;
-  mApStackStart = mTopOfApCommonStack;
+  if (gMaxLogicalProcessorNumber > 1) {
 
-  InitMpSystemData ();
+    gApStackSize = (UINTN) PcdGet32 (PcdCpuApStackSize);
+    ASSERT ((gApStackSize & (SIZE_4KB - 1)) == 0);
+
+    mApStackStart = AllocatePages (EFI_SIZE_TO_PAGES (gMaxLogicalProcessorNumber * gApStackSize));
+    ASSERT (mApStackStart != NULL);
+
+    //
+    // the first buffer of stack size used for common stack, when the amount of AP
+    // more than 1, we should never free the common stack which maybe used for AP reset.
+    //
+    mCommonStack = mApStackStart;
+    mTopOfApCommonStack = (UINT8*) mApStackStart + gApStackSize;
+    mApStackStart = mTopOfApCommonStack;
 
-  PrepareAPStartupCode ();
+    PrepareAPStartupCode ();
 
-  StartApsStackless ();
+    StartApsStackless ();
+  }
 
   DEBUG ((DEBUG_INFO, "Detect CPU count: %d\n", mMpSystemData.NumberOfProcessors));
   if (mMpSystemData.NumberOfProcessors == 1) {
     FreeApStartupCode ();
-    FreePages (mCommonStack, EFI_SIZE_TO_PAGES (gMaxLogicalProcessorNumber * gApStackSize));
-    return;
+    if (mCommonStack != NULL) {
+      FreePages (mCommonStack, EFI_SIZE_TO_PAGES (gMaxLogicalProcessorNumber * gApStackSize));
+    }
   }
 
   mMpSystemData.CpuDatas = ReallocatePool (
@@ -1692,10 +1697,12 @@ InitializeMpSupport (
                   );
   ASSERT_EFI_ERROR (Status);
 
-  if (mMpSystemData.NumberOfProcessors < gMaxLogicalProcessorNumber) {
-    FreePages (mApStackStart, EFI_SIZE_TO_PAGES (
-                                (gMaxLogicalProcessorNumber - mMpSystemData.NumberOfProcessors) *
-                                gApStackSize));
+  if (mMpSystemData.NumberOfProcessors > 1 && mMpSystemData.NumberOfProcessors < gMaxLogicalProcessorNumber) {
+    if (mApStackStart != NULL) {
+      FreePages (mApStackStart, EFI_SIZE_TO_PAGES (
+                                  (gMaxLogicalProcessorNumber - mMpSystemData.NumberOfProcessors) *
+                                  gApStackSize));
+    }
   }
 
   Status = gBS->CreateEvent (
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index d5bc0c9b806a..8e35f288fe3c 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -357,22 +357,28 @@ CountProcessorNumber (
   // Store BSP's MTRR setting
   //
   MtrrGetAllMtrrs (&PeiCpuMpData->MtrrTable);
+
   //
-  // Send broadcast IPI to APs to wakeup APs
-  //
-  PeiCpuMpData->InitFlag = 1;
-  WakeUpAP (PeiCpuMpData, TRUE, 0, NULL, NULL);
-  //
-  // Wait for AP task to complete and then exit.
-  //
-  MicroSecondDelay (PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
-  PeiCpuMpData->InitFlag  = 0;
-  PeiCpuMpData->CpuCount += (UINT32) PeiCpuMpData->MpCpuExchangeInfo->NumApsExecuting;
-  ASSERT (PeiCpuMpData->CpuCount <= PcdGet32(PcdCpuMaxLogicalProcessorNumber));
-  //
-  // Sort BSP/Aps by CPU APIC ID in ascending order
+  // Only perform AP detection if PcdCpuMaxLogicalProcessorNumber is greater than 1
   //
-  SortApicId (PeiCpuMpData);
+  if (PcdGet32 (PcdCpuMaxLogicalProcessorNumber) > 1) {
+    //
+    // Send broadcast IPI to APs to wakeup APs
+    //
+    PeiCpuMpData->InitFlag = 1;
+    WakeUpAP (PeiCpuMpData, TRUE, 0, NULL, NULL);
+    //
+    // Wait for AP task to complete and then exit.
+    //
+    MicroSecondDelay (PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
+    PeiCpuMpData->InitFlag = 0;
+    PeiCpuMpData->CpuCount += (UINT32)PeiCpuMpData->MpCpuExchangeInfo->NumApsExecuting;
+    ASSERT (PeiCpuMpData->CpuCount <= PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+    //
+    // Sort BSP/Aps by CPU APIC ID in ascending order
+    //
+    SortApicId (PeiCpuMpData);
+  }
 
   DEBUG ((EFI_D_INFO, "CpuMpPei: Find %d processors in system.\n", PeiCpuMpData->CpuCount));
   return PeiCpuMpData->CpuCount;

From 7fe220343c3cf6bf0c77134c9039f8df91122b50 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:51:37 +0000
Subject: [PATCH 109/525] UefiCpuPkg: CpuDxe: Use PCD for AP detection timeout

Use PcdCpuApInitTimeOutInMicroSeconds instead of hardcoded 100ms for
the time to wait for all APs to respond to first INIT SIPI SIPI
wake request.

(Sync patch r18630 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18825 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuDxe/ApStartup.c | 4 ++--
 UefiCpuPkg/CpuDxe/CpuDxe.inf  | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/CpuDxe/ApStartup.c b/UefiCpuPkg/CpuDxe/ApStartup.c
index 38a9c0e6ea27..78fb26f9856a 100644
--- a/UefiCpuPkg/CpuDxe/ApStartup.c
+++ b/UefiCpuPkg/CpuDxe/ApStartup.c
@@ -452,9 +452,9 @@ StartApsStackless (
 {
   SendInitSipiSipiAllExcludingSelf ((UINT32)(UINTN)(VOID*) StartupCode);
   //
-  // Wait 100 milliseconds for APs to arrive at the ApEntryPoint routine
+  // Wait for APs to arrive at the ApEntryPoint routine
   //
-  MicroSecondDelay (100 * 1000);
+  MicroSecondDelay (PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
 
   return EFI_SUCCESS;
 }
diff --git a/UefiCpuPkg/CpuDxe/CpuDxe.inf b/UefiCpuPkg/CpuDxe/CpuDxe.inf
index a2519222268c..9db5303ae94a 100644
--- a/UefiCpuPkg/CpuDxe/CpuDxe.inf
+++ b/UefiCpuPkg/CpuDxe/CpuDxe.inf
@@ -84,8 +84,9 @@
   gEfiSecPlatformInformationPpiGuid             ## UNDEFINED # HOB
 
 [Pcd]
-  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber   ## CONSUMES
-  gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize                 ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber    ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize                  ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApInitTimeOutInMicroSeconds  ## CONSUMES
 
 [Depex]
   TRUE

From dd13ef90993c02fc78f074d1ac6c71a27172f71c Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:52:28 +0000
Subject: [PATCH 110/525] UefiCpuPkg: CpuDxe: Wait for APs to enter idle loop

Address a race condition in first call to StartupAllAPs() with
SingleThread set to TRUE in the MP initialization.  If the APs
have not entered their idle loop before StartupAllAPs() is called,
then some of the APs will be in an unexpected state, and
StartupAllAPs() will hang.  This is the hang condition that is
only seen when SingleThread parameter is set to TRUE and
StartupAllAPs() is called very shortly after mAPsAlreadyInitFinished
is set to TRUE that releases the APs to complete their initialization.

An internal function has been added to check if all APs are in the
sleeping state in their idle loop.  On the first call to
StartupAllAPs(), this internal function is used in a loop to make
sure the APs are in a state that is compatible with the use of
StartupAllAPs().  PcdCpuApInitTimeOutInMicroSeconds is used as the
maximum wait time for the APs to enter their idle loop.  If all
APs have not entered their idle loop within the timeout, then
an ASSERT() is generated.

(Sync patch r18631 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18826 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuDxe/CpuMp.c | 60 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/CpuDxe/CpuMp.c b/UefiCpuPkg/CpuDxe/CpuMp.c
index da3686e2788e..f3a5a24b0f66 100644
--- a/UefiCpuPkg/CpuDxe/CpuMp.c
+++ b/UefiCpuPkg/CpuDxe/CpuMp.c
@@ -312,6 +312,47 @@ CheckAndUpdateAllAPsToIdleState (
   }
 }
 
+/**
+  Check if all APs are in state CpuStateSleeping.
+
+  Return TRUE if all APs are in the CpuStateSleeping state.  Do not
+  check the state of the BSP or any disabled APs.
+
+  @retval TRUE   All APs are in CpuStateSleeping state.
+  @retval FALSE  One or more APs are not in CpuStateSleeping state.
+
+**/
+BOOLEAN
+CheckAllAPsSleeping (
+  VOID
+  )
+{
+  UINTN           ProcessorNumber;
+  CPU_DATA_BLOCK  *CpuData;
+
+  for (ProcessorNumber = 0; ProcessorNumber < mMpSystemData.NumberOfProcessors; ProcessorNumber++) {
+    CpuData = &mMpSystemData.CpuDatas[ProcessorNumber];
+    if (TestCpuStatusFlag (CpuData, PROCESSOR_AS_BSP_BIT)) {
+      //
+      // Skip BSP
+      //
+      continue;
+    }
+
+    if (!TestCpuStatusFlag (CpuData, PROCESSOR_ENABLED_BIT)) {
+      //
+      // Skip Disabled processors
+      //
+      continue;
+    }
+
+    if (GetApState (CpuData) != CpuStateSleeping) {
+      return FALSE;
+    }
+  }
+  return TRUE;
+}
+
 /**
   If the timeout expires before all APs returns from Procedure,
   we should forcibly terminate the executing AP and fill FailedList back
@@ -1634,7 +1675,8 @@ InitializeMpSupport (
   VOID
   )
 {
-  EFI_STATUS Status;
+  EFI_STATUS     Status;
+  UINTN          Timeout;
 
   gMaxLogicalProcessorNumber = (UINTN) PcdGet32 (PcdCpuMaxLogicalProcessorNumber);
   if (gMaxLogicalProcessorNumber < 1) {
@@ -1683,8 +1725,24 @@ InitializeMpSupport (
                              sizeof (CPU_DATA_BLOCK) * mMpSystemData.NumberOfProcessors,
                              mMpSystemData.CpuDatas);
 
+  //
+  // Release all APs to complete initialization and enter idle loop
+  //
   mAPsAlreadyInitFinished = TRUE;
 
+  //
+  // Wait for all APs to enter idle loop.
+  //
+  Timeout = 0;
+  do {
+    if (CheckAllAPsSleeping ()) {
+      break;
+    }
+    gBS->Stall (gPollInterval);
+    Timeout += gPollInterval;
+  } while (Timeout <= PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
+  ASSERT (Timeout <= PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
+
   //
   // Update CPU healthy information from Guided HOB
   //

From 63f8a5c091216aef574da1029236d4f21dec410d Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Tue, 17 Nov 2015 04:53:12 +0000
Subject: [PATCH 111/525] UefiCpuPkg: CpuDxe: broadcast MTRR changes to APs

The Quark_EDKII_v1.1.0/IA32FamilyCpuBasePkg/CpuArchDxe
driver applies any MTRR changes to APs, if the
EFI_MP_SERVICES_PROTOCOL is available. We should do the same.

Additionally, the broadcast should occur at MP startup as well,
not only when MTRR settings are changed. The inspiration is
taken from

  Quark_EDKII_v1.1.0/IA32FamilyCpuBasePkg/CpuMpDxe/

(see the EarlyMpInit() function and its call sites in
"ProcessorConfig.c").

(Sync patch r18632 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18827 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuDxe/CpuDxe.c | 26 ++++++++++++++++++++++++++
 UefiCpuPkg/CpuDxe/CpuMp.c  | 32 ++++++++++++++++++++++++++++++++
 UefiCpuPkg/CpuDxe/CpuMp.h  | 13 +++++++++++++
 3 files changed, 71 insertions(+)

diff --git a/UefiCpuPkg/CpuDxe/CpuDxe.c b/UefiCpuPkg/CpuDxe/CpuDxe.c
index c9df4e146ac3..daf97bd4a6cf 100644
--- a/UefiCpuPkg/CpuDxe/CpuDxe.c
+++ b/UefiCpuPkg/CpuDxe/CpuDxe.c
@@ -350,6 +350,9 @@ CpuSetMemoryAttributes (
 {
   RETURN_STATUS             Status;
   MTRR_MEMORY_CACHE_TYPE    CacheType;
+  EFI_STATUS                MpStatus;
+  EFI_MP_SERVICES_PROTOCOL  *MpService;
+  MTRR_SETTINGS             MtrrSettings;
 
   if (!IsMtrrSupported ()) {
     return EFI_UNSUPPORTED;
@@ -405,6 +408,29 @@ CpuSetMemoryAttributes (
              CacheType
              );
 
+  if (!RETURN_ERROR (Status)) {
+    MpStatus = gBS->LocateProtocol (
+                      &gEfiMpServiceProtocolGuid,
+                      NULL,
+                      (VOID **)&MpService
+                      );
+    //
+    // Synchronize the update with all APs
+    //
+    if (!EFI_ERROR (MpStatus)) {
+      MtrrGetAllMtrrs (&MtrrSettings);
+      MpStatus = MpService->StartupAllAPs (
+                              MpService,          // This
+                              SetMtrrsFromBuffer, // Procedure
+                              TRUE,               // SingleThread
+                              NULL,               // WaitEvent
+                              0,                  // TimeoutInMicrosecsond
+                              &MtrrSettings,      // ProcedureArgument
+                              NULL                // FailedCpuList
+                              );
+      ASSERT (MpStatus == EFI_SUCCESS || MpStatus == EFI_NOT_STARTED);
+    }
+  }
   return (EFI_STATUS) Status;
 }
 
diff --git a/UefiCpuPkg/CpuDxe/CpuMp.c b/UefiCpuPkg/CpuDxe/CpuMp.c
index f3a5a24b0f66..04c2f1f0ac12 100644
--- a/UefiCpuPkg/CpuDxe/CpuMp.c
+++ b/UefiCpuPkg/CpuDxe/CpuMp.c
@@ -1666,6 +1666,22 @@ ExitBootServicesCallback (
   SendInitIpiAllExcludingSelf ();
 }
 
+/**
+  A minimal wrapper function that allows MtrrSetAllMtrrs() to be passed to
+  EFI_MP_SERVICES_PROTOCOL.StartupAllAPs() as Procedure.
+
+  @param[in] Buffer  Pointer to an MTRR_SETTINGS object, to be passed to
+                     MtrrSetAllMtrrs().
+**/
+VOID
+EFIAPI
+SetMtrrsFromBuffer (
+  IN VOID *Buffer
+  )
+{
+  MtrrSetAllMtrrs (Buffer);
+}
+
 /**
   Initialize Multi-processor support.
 
@@ -1676,6 +1692,7 @@ InitializeMpSupport (
   )
 {
   EFI_STATUS     Status;
+  MTRR_SETTINGS  MtrrSettings;
   UINTN          Timeout;
 
   gMaxLogicalProcessorNumber = (UINTN) PcdGet32 (PcdCpuMaxLogicalProcessorNumber);
@@ -1748,6 +1765,21 @@ InitializeMpSupport (
   //
   CollectBistDataFromHob ();
 
+  //
+  // Synchronize MTRR settings to APs.
+  //
+  MtrrGetAllMtrrs (&MtrrSettings);
+  Status = mMpServicesTemplate.StartupAllAPs (
+                                 &mMpServicesTemplate, // This
+                                 SetMtrrsFromBuffer,   // Procedure
+                                 TRUE,                 // SingleThread
+                                 NULL,                 // WaitEvent
+                                 0,                    // TimeoutInMicrosecsond
+                                 &MtrrSettings,        // ProcedureArgument
+                                 NULL                  // FailedCpuList
+                                 );
+  ASSERT (Status == EFI_SUCCESS || Status == EFI_NOT_STARTED);
+
   Status = gBS->InstallMultipleProtocolInterfaces (
                   &mMpServiceHandle,
                   &gEfiMpServiceProtocolGuid,  &mMpServicesTemplate,
diff --git a/UefiCpuPkg/CpuDxe/CpuMp.h b/UefiCpuPkg/CpuDxe/CpuMp.h
index d2866e463bc9..503f3ae944fe 100644
--- a/UefiCpuPkg/CpuDxe/CpuMp.h
+++ b/UefiCpuPkg/CpuDxe/CpuMp.h
@@ -643,5 +643,18 @@ ResetApStackless (
   IN UINT32 ProcessorId
   );
 
+/**
+  A minimal wrapper function that allows MtrrSetAllMtrrs() to be passed to
+  EFI_MP_SERVICES_PROTOCOL.StartupAllAPs() as Procedure.
+
+  @param[in] Buffer  Pointer to an MTRR_SETTINGS object, to be passed to
+                     MtrrSetAllMtrrs().
+**/
+VOID
+EFIAPI
+SetMtrrsFromBuffer (
+  IN VOID *Buffer
+  );
+
 #endif // _CPU_MP_H_
 

From 01020000ffbf32b788d9865887b81cab73017cea Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:54:19 +0000
Subject: [PATCH 112/525] UefiCpuPkg: Add Cpuid.h include files for CPUID
 related defines

Move CPUID related defines from LocalApic.h to Cpuid.h
Update LocalApicLib instances to include Cpuid.h
Update CpuMpPei module to include Cpuid.h

(Sync patch r18633 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18828 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.h                |  1 +
 UefiCpuPkg/Include/Register/Cpuid.h           | 51 +++++++++++++++++++
 UefiCpuPkg/Include/Register/LocalApic.h       | 13 -----
 .../Library/BaseXApicLib/BaseXApicLib.c       |  1 +
 .../BaseXApicX2ApicLib/BaseXApicX2ApicLib.c   |  1 +
 5 files changed, 54 insertions(+), 13 deletions(-)
 create mode 100644 UefiCpuPkg/Include/Register/Cpuid.h

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index 19e649eb82ca..9325a12d4ceb 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -22,6 +22,7 @@
 #include <Ppi/SecPlatformInformation2.h>
 #include <Ppi/EndOfPeiPhase.h>
 
+#include <Register/Cpuid.h>
 #include <Register/LocalApic.h>
 
 #include <Library/BaseLib.h>
diff --git a/UefiCpuPkg/Include/Register/Cpuid.h b/UefiCpuPkg/Include/Register/Cpuid.h
new file mode 100644
index 000000000000..6730551ff8cd
--- /dev/null
+++ b/UefiCpuPkg/Include/Register/Cpuid.h
@@ -0,0 +1,51 @@
+/** @file
+CPUID Definitions.
+
+CPUID definitions based on contents of the Intel(R) 64 and IA-32 Architectures
+Software Developer's Manual, Volume 2A, CPUID instruction.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __CPUID_H__
+#define __CPUID_H__
+
+//
+// Definitions for CPUID instruction
+//
+#define CPUID_SIGNATURE                         0x0
+
+#define CPUID_VERSION_INFO                      0x1
+
+#define CPUID_CACHE_INFO                        0x2
+
+#define CPUID_SERIAL_NUMBER                     0x3
+
+#define CPUID_CACHE_PARAMS                      0x4
+
+#define CPUID_EXTENDED_TOPOLOGY                 0xB
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID  0x0
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT      0x1
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE     0x2
+
+#define CPUID_EXTENDED_FUNCTION                 0x80000000
+
+#define CPUID_EXTENDED_CPU_SIG                  0x80000001
+
+#define CPUID_BRAND_STRING1                     0x80000002
+
+#define CPUID_BRAND_STRING2                     0x80000003
+
+#define CPUID_BRAND_STRING3                     0x80000004
+
+#define CPUID_VIR_PHY_ADDRESS_SIZE              0x80000008
+
+#endif
diff --git a/UefiCpuPkg/Include/Register/LocalApic.h b/UefiCpuPkg/Include/Register/LocalApic.h
index cf335a69d95d..346cce675643 100644
--- a/UefiCpuPkg/Include/Register/LocalApic.h
+++ b/UefiCpuPkg/Include/Register/LocalApic.h
@@ -20,19 +20,6 @@
 //
 #define MSR_IA32_APIC_BASE_ADDRESS              0x1B
 
-//
-// Definitions for CPUID instruction
-//
-#define CPUID_SIGNATURE                         0x0
-#define CPUID_VERSION_INFO                      0x1
-#define CPUID_CACHE_PARAMS                      0x4
-#define CPUID_EXTENDED_TOPOLOGY                 0xB
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID 0x0
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT     0x1
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE    0x2
-#define CPUID_EXTENDED_FUNCTION                 0x80000000
-#define CPUID_VIR_PHY_ADDRESS_SIZE              0x80000008
-
 //
 // Definition for Local APIC registers and related values
 //
diff --git a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
index f219b07888c0..b73b1d3da930 100644
--- a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
@@ -14,6 +14,7 @@
 
 **/
 
+#include <Register/Cpuid.h>
 #include <Register/LocalApic.h>
 
 #include <Library/BaseLib.h>
diff --git a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
index 8c6e8d741564..9bbaca45dc6b 100644
--- a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
@@ -15,6 +15,7 @@
 
 **/
 
+#include <Register/Cpuid.h>
 #include <Register/LocalApic.h>
 
 #include <Library/BaseLib.h>

From 2e216411fadf5d4600aa15d27bea37707066f883 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:55:07 +0000
Subject: [PATCH 113/525] UefiCpuPkg: Add SMM Communication PPI and Handler
 Modules

Add modules that produce the SMM Communications PPI and
install a SW SMI handler for SMM Communication requests

(Sync patch r18634 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18829 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PiSmmCommunicationPei.c                   | 425 ++++++++++++++++++
 .../PiSmmCommunicationPei.inf                 |  70 +++
 .../PiSmmCommunicationPei.uni                 | Bin 0 -> 2066 bytes
 .../PiSmmCommunicationPeiExtra.uni            | Bin 0 -> 1370 bytes
 .../PiSmmCommunicationPrivate.h               |  30 ++
 .../PiSmmCommunicationSmm.c                   | 269 +++++++++++
 .../PiSmmCommunicationSmm.inf                 |  82 ++++
 .../PiSmmCommunicationSmm.uni                 | Bin 0 -> 3004 bytes
 .../PiSmmCommunicationSmmExtra.uni            | Bin 0 -> 1392 bytes
 UefiCpuPkg/UefiCpuPkg.dsc                     |   5 +
 10 files changed, 881 insertions(+)
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.c
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.uni
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPeiExtra.uni
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPrivate.h
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.c
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.uni
 create mode 100644 UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmmExtra.uni

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.c b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.c
new file mode 100644
index 000000000000..aaeaa0672939
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.c
@@ -0,0 +1,425 @@
+/** @file
+PiSmmCommunication PEI Driver.
+
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiPei.h>
+#include <PiDxe.h>
+#include <PiSmm.h>
+#include <Library/PeiServicesTablePointerLib.h>
+#include <Library/PeiServicesLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/HobLib.h>
+#include <Library/DebugLib.h>
+#include <Protocol/SmmCommunication.h>
+#include <Ppi/SmmCommunication.h>
+#include <Ppi/SmmAccess.h>
+#include <Ppi/SmmControl.h>
+#include <Guid/AcpiS3Context.h>
+
+#include "PiSmmCommunicationPrivate.h"
+
+/**
+  the whole picture is below:
+
+  +----------------------------------+
+  | ACPI_VARIABLE_HOB                |
+  |   SmramDescriptor                | <- DRAM
+  |     CpuStart                     |---
+  +----------------------------------+   |
+                                         |
+  +----------------------------------+<--
+  | SMM_S3_RESUME_STATE              |
+  |   Signature                      | <- SMRAM
+  |   Smst                           |---
+  +----------------------------------+   |
+                                         |
+  +----------------------------------+<--
+  | EFI_SMM_SYSTEM_TABLE2            |
+  |   NumberOfTableEntries           | <- SMRAM
+  |   SmmConfigurationTable          |---
+  +----------------------------------+   |
+                                         |
+  +----------------------------------+<--
+  | EFI_SMM_COMMUNICATION_CONTEXT    |
+  |   SwSmiNumber                    | <- SMRAM
+  |   BufferPtrAddress               |----------------
+  +----------------------------------+                |
+                                                      |
+  +----------------------------------+                |
+  | EFI_SMM_COMMUNICATION_ACPI_TABLE |                |
+  |   SwSmiNumber                    | <- AcpiTable   |
+  |   BufferPtrAddress               |---             |
+  +----------------------------------+   |            |
+                                         |            |
+  +----------------------------------+<---------------
+  | Communication Buffer Pointer     | <- AcpiNvs
+  +----------------------------------+---
+                                         |
+  +----------------------------------+<--
+  | EFI_SMM_COMMUNICATE_HEADER       |
+  |   HeaderGuid                     | <- DRAM
+  |   MessageLength                  |
+  +----------------------------------+
+
+**/
+
+#if defined (MDE_CPU_IA32)
+typedef struct {
+  EFI_TABLE_HEADER    Hdr;
+  UINT64              SmmFirmwareVendor;
+  UINT64              SmmFirmwareRevision;
+  UINT64              SmmInstallConfigurationTable;
+  UINT64              SmmIoMemRead;
+  UINT64              SmmIoMemWrite;
+  UINT64              SmmIoIoRead;
+  UINT64              SmmIoIoWrite;
+  UINT64              SmmAllocatePool;
+  UINT64              SmmFreePool;
+  UINT64              SmmAllocatePages;
+  UINT64              SmmFreePages;
+  UINT64              SmmStartupThisAp;
+  UINT64              CurrentlyExecutingCpu;
+  UINT64              NumberOfCpus;
+  UINT64              CpuSaveStateSize;
+  UINT64              CpuSaveState;
+  UINT64              NumberOfTableEntries;
+  UINT64              SmmConfigurationTable;
+} EFI_SMM_SYSTEM_TABLE2_64;
+
+typedef struct {
+  EFI_GUID                          VendorGuid;
+  UINT64                            VendorTable;
+} EFI_CONFIGURATION_TABLE64;
+#endif
+
+#if defined (MDE_CPU_X64)
+typedef EFI_SMM_SYSTEM_TABLE2 EFI_SMM_SYSTEM_TABLE2_64;
+typedef EFI_CONFIGURATION_TABLE EFI_CONFIGURATION_TABLE64;
+#endif
+
+/**
+  Communicates with a registered handler.
+
+  This function provides a service to send and receive messages from a registered UEFI service.
+
+  @param[in] This                The EFI_PEI_SMM_COMMUNICATION_PPI instance.
+  @param[in, out] CommBuffer     A pointer to the buffer to convey into SMRAM.
+  @param[in, out] CommSize       The size of the data buffer being passed in.On exit, the size of data
+                                 being returned. Zero if the handler does not wish to reply with any data.
+
+  @retval EFI_SUCCESS            The message was successfully posted.
+  @retval EFI_INVALID_PARAMETER  The CommBuffer was NULL.
+  @retval EFI_NOT_STARTED        The service is NOT started.
+**/
+EFI_STATUS
+EFIAPI
+Communicate (
+  IN CONST EFI_PEI_SMM_COMMUNICATION_PPI   *This,
+  IN OUT VOID                              *CommBuffer,
+  IN OUT UINTN                             *CommSize
+  );
+
+EFI_PEI_SMM_COMMUNICATION_PPI      mSmmCommunicationPpi = { Communicate };
+
+EFI_PEI_PPI_DESCRIPTOR mPpiList = {
+  (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
+  &gEfiPeiSmmCommunicationPpiGuid,
+  &mSmmCommunicationPpi
+};
+
+/**
+  Get SMM communication context.
+
+  @return SMM communication context.
+**/
+EFI_SMM_COMMUNICATION_CONTEXT *
+GetCommunicationContext (
+  VOID
+  )
+{
+  EFI_HOB_GUID_TYPE                *GuidHob;
+  EFI_SMM_COMMUNICATION_CONTEXT    *SmmCommunicationContext;
+
+  GuidHob = GetFirstGuidHob (&gEfiPeiSmmCommunicationPpiGuid);
+  ASSERT (GuidHob != NULL);
+
+  SmmCommunicationContext = (EFI_SMM_COMMUNICATION_CONTEXT *)GET_GUID_HOB_DATA (GuidHob);
+
+  return SmmCommunicationContext;
+}
+
+/**
+  Set SMM communication context.
+
+  @param SmmCommunicationContext SMM communication context.
+**/
+VOID
+SetCommunicationContext (
+  IN EFI_SMM_COMMUNICATION_CONTEXT    *SmmCommunicationContext
+  )
+{
+  EFI_PEI_HOB_POINTERS             Hob;
+  UINTN                            BufferSize;
+
+  BufferSize = sizeof (*SmmCommunicationContext);
+  Hob.Raw = BuildGuidHob (
+              &gEfiPeiSmmCommunicationPpiGuid,
+              BufferSize
+              );
+  ASSERT (Hob.Raw);
+
+  CopyMem ((VOID *)Hob.Raw, SmmCommunicationContext, sizeof(*SmmCommunicationContext));
+}
+
+/**
+  Get VendorTable by VendorGuid in Smst.
+
+  @param Signature  Signature of SMM_S3_RESUME_STATE
+  @param Smst       SMM system table
+  @param VendorGuid vendor guid
+
+  @return vendor table.
+**/
+VOID *
+InternalSmstGetVendorTableByGuid (
+  IN UINT64                                        Signature,
+  IN EFI_SMM_SYSTEM_TABLE2                         *Smst,
+  IN EFI_GUID                                      *VendorGuid
+  )
+{
+  EFI_CONFIGURATION_TABLE                       *SmmConfigurationTable;
+  UINTN                                         NumberOfTableEntries;
+  UINTN                                         Index;
+  EFI_SMM_SYSTEM_TABLE2_64                      *Smst64;
+  EFI_CONFIGURATION_TABLE64                     *SmmConfigurationTable64;
+
+  if ((sizeof(UINTN) == sizeof(UINT32)) && (Signature == SMM_S3_RESUME_SMM_64)) {
+    //
+    // 32 PEI + 64 DXE
+    //
+    Smst64 = (EFI_SMM_SYSTEM_TABLE2_64 *)Smst;
+    DEBUG ((EFI_D_INFO, "InitCommunicationContext - SmmConfigurationTable: %x\n", Smst64->SmmConfigurationTable));
+    DEBUG ((EFI_D_INFO, "InitCommunicationContext - NumberOfTableEntries: %x\n", Smst64->NumberOfTableEntries));
+    SmmConfigurationTable64 = (EFI_CONFIGURATION_TABLE64 *)(UINTN)Smst64->SmmConfigurationTable;
+    NumberOfTableEntries = (UINTN)Smst64->NumberOfTableEntries;
+    for (Index = 0; Index < NumberOfTableEntries; Index++) {
+      if (CompareGuid (&SmmConfigurationTable64[Index].VendorGuid, VendorGuid)) {
+        return (VOID *)(UINTN)SmmConfigurationTable64[Index].VendorTable;
+      }
+    }
+    return NULL;
+  } else {
+    DEBUG ((EFI_D_INFO, "InitCommunicationContext - SmmConfigurationTable: %x\n", Smst->SmmConfigurationTable));
+    DEBUG ((EFI_D_INFO, "InitCommunicationContext - NumberOfTableEntries: %x\n", Smst->NumberOfTableEntries));
+    SmmConfigurationTable = Smst->SmmConfigurationTable;
+    NumberOfTableEntries = Smst->NumberOfTableEntries;
+    for (Index = 0; Index < NumberOfTableEntries; Index++) {
+      if (CompareGuid (&SmmConfigurationTable[Index].VendorGuid, VendorGuid)) {
+        return (VOID *)SmmConfigurationTable[Index].VendorTable;
+      }
+    }
+    return NULL;
+  }
+}
+
+/**
+  Init SMM communication context.
+**/
+VOID
+InitCommunicationContext (
+  VOID
+  )
+{
+  EFI_SMRAM_DESCRIPTOR                          *SmramDescriptor;
+  SMM_S3_RESUME_STATE                           *SmmS3ResumeState;
+  VOID                                          *GuidHob;
+  EFI_SMM_COMMUNICATION_CONTEXT                 *SmmCommunicationContext;
+
+  GuidHob = GetFirstGuidHob (&gEfiAcpiVariableGuid);
+  ASSERT (GuidHob != NULL);
+  SmramDescriptor = (EFI_SMRAM_DESCRIPTOR *) GET_GUID_HOB_DATA (GuidHob);
+  SmmS3ResumeState = (SMM_S3_RESUME_STATE *)(UINTN)SmramDescriptor->CpuStart;
+
+  DEBUG ((EFI_D_INFO, "InitCommunicationContext - SmmS3ResumeState: %x\n", SmmS3ResumeState));
+  DEBUG ((EFI_D_INFO, "InitCommunicationContext - Smst: %x\n", SmmS3ResumeState->Smst));
+
+  SmmCommunicationContext = (EFI_SMM_COMMUNICATION_CONTEXT *)InternalSmstGetVendorTableByGuid (
+                                                               SmmS3ResumeState->Signature,
+                                                               (EFI_SMM_SYSTEM_TABLE2 *)(UINTN)SmmS3ResumeState->Smst,
+                                                               &gEfiPeiSmmCommunicationPpiGuid
+                                                               );
+  ASSERT (SmmCommunicationContext != NULL);
+
+  SetCommunicationContext (SmmCommunicationContext);
+
+  return ;
+}
+
+/**
+  Communicates with a registered handler.
+
+  This function provides a service to send and receive messages from a registered UEFI service.
+
+  @param[in] This                The EFI_PEI_SMM_COMMUNICATION_PPI instance.
+  @param[in, out] CommBuffer     A pointer to the buffer to convey into SMRAM.
+  @param[in, out] CommSize       The size of the data buffer being passed in.On exit, the size of data
+                                 being returned. Zero if the handler does not wish to reply with any data.
+
+  @retval EFI_SUCCESS            The message was successfully posted.
+  @retval EFI_INVALID_PARAMETER  The CommBuffer was NULL.
+  @retval EFI_NOT_STARTED        The service is NOT started.
+**/
+EFI_STATUS
+EFIAPI
+Communicate (
+  IN CONST EFI_PEI_SMM_COMMUNICATION_PPI   *This,
+  IN OUT VOID                              *CommBuffer,
+  IN OUT UINTN                             *CommSize
+  )
+{
+  EFI_STATUS                       Status;
+  PEI_SMM_CONTROL_PPI              *SmmControl;
+  PEI_SMM_ACCESS_PPI               *SmmAccess;
+  UINT8                            SmiCommand;
+  UINTN                            Size;
+  EFI_SMM_COMMUNICATION_CONTEXT    *SmmCommunicationContext;
+
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei Communicate Enter\n"));
+
+  if (CommBuffer == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Get needed resource
+  //
+  Status = PeiServicesLocatePpi (
+             &gPeiSmmControlPpiGuid,
+             0,
+             NULL,
+             (VOID **)&SmmControl
+             );
+  if (EFI_ERROR (Status)) {
+    return EFI_NOT_STARTED;
+  }
+
+  Status = PeiServicesLocatePpi (
+             &gPeiSmmAccessPpiGuid,
+             0,
+             NULL,
+             (VOID **)&SmmAccess
+             );
+  if (EFI_ERROR (Status)) {
+    return EFI_NOT_STARTED;
+  }
+
+  //
+  // Check SMRAM locked, it should be done after SMRAM lock.
+  //
+  if (!SmmAccess->LockState) {
+    DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei LockState - %x\n", (UINTN)SmmAccess->LockState));
+    return EFI_NOT_STARTED;
+  }
+
+  SmmCommunicationContext = GetCommunicationContext ();
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei BufferPtrAddress - 0x%016lx, BufferPtr: 0x%016lx\n", SmmCommunicationContext->BufferPtrAddress, *(EFI_PHYSICAL_ADDRESS *)(UINTN)SmmCommunicationContext->BufferPtrAddress));
+
+  //
+  // No need to check if BufferPtr is 0, because it is in PEI phase.
+  //
+  *(EFI_PHYSICAL_ADDRESS *)(UINTN)SmmCommunicationContext->BufferPtrAddress = (EFI_PHYSICAL_ADDRESS)(UINTN)CommBuffer;
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei CommBuffer - %x\n", (UINTN)CommBuffer));
+
+  //
+  // Send command
+  //
+  SmiCommand = (UINT8)SmmCommunicationContext->SwSmiNumber;
+  Size = sizeof(SmiCommand);
+  Status = SmmControl->Trigger (
+                         (EFI_PEI_SERVICES **)GetPeiServicesTablePointer (),
+                         SmmControl,
+                         (INT8 *)&SmiCommand,
+                         &Size,
+                         FALSE,
+                         0
+                         );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Setting BufferPtr to 0 means this transaction is done.
+  //
+  *(EFI_PHYSICAL_ADDRESS *)(UINTN)SmmCommunicationContext->BufferPtrAddress = 0;
+
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei Communicate Exit\n"));
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Entry Point for PI SMM communication PEIM.
+
+  @param  FileHandle              Handle of the file being invoked.
+  @param  PeiServices             Pointer to PEI Services table.
+
+  @retval EFI_SUCEESS
+  @return Others          Some error occurs.
+**/
+EFI_STATUS
+EFIAPI
+PiSmmCommunicationPeiEntryPoint (
+  IN EFI_PEI_FILE_HANDLE       FileHandle,
+  IN CONST EFI_PEI_SERVICES    **PeiServices
+  )
+{
+  EFI_STATUS                      Status;
+  PEI_SMM_ACCESS_PPI              *SmmAccess;
+  EFI_BOOT_MODE                   BootMode;
+  UINTN                           Index;
+
+  BootMode = GetBootModeHob ();
+  if (BootMode != BOOT_ON_S3_RESUME) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = PeiServicesLocatePpi (
+             &gPeiSmmAccessPpiGuid,
+             0,
+             NULL,
+             (VOID **)&SmmAccess
+             );
+  if (EFI_ERROR (Status)) {
+    return EFI_NOT_STARTED;
+  }
+
+  //
+  // Check SMRAM locked, it should be done before SMRAM lock.
+  //
+  if (SmmAccess->LockState) {
+    DEBUG ((EFI_D_INFO, "PiSmmCommunicationPei LockState - %x\n", (UINTN)SmmAccess->LockState));
+    return EFI_ACCESS_DENIED;
+  }
+
+  //
+  // Open all SMRAM
+  //
+  for (Index = 0; !EFI_ERROR (Status); Index++) {
+    Status = SmmAccess->Open ((EFI_PEI_SERVICES **)GetPeiServicesTablePointer (), SmmAccess, Index);
+  }
+
+  InitCommunicationContext ();
+
+  PeiServicesInstallPpi (&mPpiList);
+
+  return RETURN_SUCCESS;
+}
diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
new file mode 100644
index 000000000000..5cb596c5644d
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
@@ -0,0 +1,70 @@
+## @file
+# PI SMM Communication PEIM which produces PEI SMM Communication PPI.
+#
+# This PEIM retrieves the SMM communication context and produces PEI SMM
+# Communication PPIin the S3 boot mode.
+#
+# Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+#
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PiSmmCommunicationPei
+  MODULE_UNI_FILE                = PiSmmCommunicationPei.uni
+  FILE_GUID                      = 1C8B7F78-1699-40e6-AF33-9B995D16B043
+  MODULE_TYPE                    = PEIM
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = PiSmmCommunicationPeiEntryPoint
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  PiSmmCommunicationPei.c
+  PiSmmCommunicationPrivate.h
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  PeimEntryPoint
+  PeiServicesTablePointerLib
+  PeiServicesLib
+  BaseLib
+  BaseMemoryLib
+  HobLib
+  DebugLib
+
+[Guids]
+  gEfiAcpiVariableGuid               ## CONSUMES ## HOB
+
+[Ppis]
+  ## PRODUCES
+  ## UNDEFINED # HOB # SMM Configuration Table
+  gEfiPeiSmmCommunicationPpiGuid
+  gPeiSmmAccessPpiGuid               ## CONSUMES
+  gPeiSmmControlPpiGuid              ## CONSUMES
+
+# [BootMode]
+#   S3_RESUME                        ## CONSUMES
+
+[Depex]
+  gPeiSmmAccessPpiGuid AND
+  gPeiSmmControlPpiGuid AND
+  gEfiPeiMasterBootModePpiGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  PiSmmCommunicationPeiExtra.uni
diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.uni
new file mode 100644
index 0000000000000000000000000000000000000000..08af34e11b69fd4856a2cb42332ca51e2545652f
GIT binary patch
literal 2066
zcmc(gTW`}q5QXO%iT_}wFM!$vC{G9>5^BH#>L?chPbl|T%B6BbA%7nD&Ti~&s*to#
z$nsvtXU?3NUH|!AvzkS`Pk17GV`Ix~W+QuO4_MV+(-PXYeddYmtu1ZN^TQTc4y<Qu
z`Xw`2#@Nd0r%m1Nl<}42><{^30Pd=^yDO&rS4%#DSI7AXc=DU$VNILSUvIswu^X{h
zL@+oIf%X<4jO-U}M05+7ACDohI;@Xk$(&Y!)j9Zm{4SlxIsFj-`yv+hm2F&n6QUBs
zN2vOk{<%H1XS|V}m9rOi$~f6ZG-E7;91OJ~b5(ZgWL*~0&SOhi>AB*~oti^fy|RY2
z?DfHX_>51Sk2xrXibc#lI7{g{OtiOgnoO{qJ67_SF`D5!DBE*vB34y*Bfb+eWv9T`
z*V0Za*SxCa9@?s&BUiE7%^4R=l<6F=inTxyGi5!)%2&2_mz<37U4v@6VE$=`OW=C5
z{%=RC+7zNVWNsv1E9Q#256{A{@)B8RTfbv=e2zkW?y}ld#;dsjq3_}!6N65zS8RPl
zSyj@ST)cEAUNz>`m3{8CuJUb8UDR%=zhb2i_aRlc>%9ufl(*2N=oQZg?g`x%Elce^
zZQb1&37STzs=mW&LZx*X#ZKw2UDC&_2ZWG?gvySwXglPTkt$kkg<iNqt<X2zT(i@X
zTV!9@7q8TL)Vz)-F}q|v0aX~O^WI`6?pl-24py>}S8w$WTYdSB{v$hLu9K+S(MPW+
zV*6U+1a#e>P3lTMFZSL7x~Xf9yEHv1D`!D|bjwM*@1Uf7-vudVRwr)1Q%9)|cK>=#
z$fHiegxvRNb#hb<XJCnC1$OuUAE?%K-yFY5kNsify>id!RX1(oR!ud_T<uffc=S4r
g{?vxQ-T(UQ+(oMhwhMGu29(RTozw37-*{F30!%MLq5uE@

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPeiExtra.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPeiExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..ee10182a682b17cbccbeb5658c32a1cb7fbfe2b3
GIT binary patch
literal 1370
zcmZXUNpBND5QXcE#D5r>3!ubiJ0XOy$p9nbMP3A)B5!d<vOU(=NiaVi_+IraILMl=
zuIlPnuV0t@&+nGCEaH34FR~AIZK<toX^-s@QLPP#jBLa2qh)SyZA)x!Q#)WYya78>
zaxd`|U*r8EwjeelE63m3%J%qEW{L}K%i7Y%vR-M!`p%BNcV#zZM)nl+XV_Qv!d}{I
zX6Kdn#?F{01?HN$D&)5FvF6%jr42)6h*!WCvm7pazTEDdd(+-o$A<R4Qln-!hEeM0
z*^!@tl5?^RDCPMMWGvmE!&=JieC=3h5fKq9)k~SJL96knM73K=&Y5kUnRF}hwR=%i
zxMQw+o7#*~`*cTI&6$@>LamLnE>XlxnJHP}E~P|9AJqFg+~EcO<q4OX>%D6+XB4~B
z)246`qBsP-RBMl~Q_tX8*44d4CSAq<nw4-zV*Qh>hpbMO32Gk6nic!ALIZI+{G+To
z>A+pQ_5RM71$C95yVgz4pL3(F2kP&M%;3JD>rSgTLAl{8H7Tvm^TlFV4d|o3eP(Q1
z7e7JM2vudrL=!q~!Yp>BC)UHp#A}5577{u;CS&BteP-%tjSZ}Dh1$S&+?RJ&af|F5
z>*Ce-it^i360;uh1XN-4z4{PO+!a&JF<Ht{)sXdxT<!dU{mP1%>z^1GRl+G^`(EMH
z=m}a3=quH{ux7=v)=%$J%j1eYsX9lmiQX1zcU7o60A*O6;0o+Ms1xvGa(b}rG7C8R
suL$E7yYh}v7o3wl@{9(y%P+hldj0-?^>nK`Wkg;^SEyr`=&lNX0qm328~^|S

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPrivate.h b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPrivate.h
new file mode 100644
index 000000000000..3dd5ac6e3801
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPrivate.h
@@ -0,0 +1,30 @@
+/** @file
+PiSmmCommunication private data structure
+
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_COMMUNICATION_PRIVATE_H_
+#define _SMM_COMMUNICATION_PRIVATE_H_
+
+#pragma pack(push, 1)
+
+#define SMM_COMMUNICATION_SIGNATURE SIGNATURE_32 ('S','M','M','C')
+
+typedef struct {
+  UINT32                   Signature;
+  UINT32                   SwSmiNumber;
+  EFI_PHYSICAL_ADDRESS     BufferPtrAddress;
+} EFI_SMM_COMMUNICATION_CONTEXT;
+
+#pragma pack(pop)
+
+#endif
diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.c b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.c
new file mode 100644
index 000000000000..077eacce88d1
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.c
@@ -0,0 +1,269 @@
+/** @file
+PiSmmCommunication SMM Driver.
+
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiSmm.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/HobLib.h>
+#include <Library/DebugLib.h>
+#include <Library/SmmMemLib.h>
+#include <Library/PcdLib.h>
+#include <Protocol/SmmSwDispatch2.h>
+#include <Protocol/SmmReadyToLock.h>
+#include <Protocol/SmmCommunication.h>
+#include <Protocol/AcpiTable.h>
+#include <Ppi/SmmCommunication.h>
+#include <Guid/Acpi.h>
+
+#include "PiSmmCommunicationPrivate.h"
+
+EFI_SMM_COMMUNICATION_CONTEXT  mSmmCommunicationContext = {
+  SMM_COMMUNICATION_SIGNATURE
+};
+
+EFI_SMM_COMMUNICATION_ACPI_TABLE  mSmmCommunicationAcpiTable = {
+  {
+    {
+      EFI_ACPI_4_0_UEFI_ACPI_DATA_TABLE_SIGNATURE,
+      sizeof (EFI_SMM_COMMUNICATION_ACPI_TABLE),
+      0x1,   // Revision
+      0x0,   // Checksum
+      {0x0}, // OemId[6]
+      0x0,   // OemTableId
+      0x0,   // OemRevision
+      0x0,   // CreatorId
+      0x0    // CreatorRevision
+    },
+    {0x0},                                                      // Identifier
+    OFFSET_OF (EFI_SMM_COMMUNICATION_ACPI_TABLE, SwSmiNumber)   // DataOffset
+  },
+  0x0,                                                   // SwSmiNumber
+  0x0                                                    // BufferPtrAddress
+};
+
+/**
+  Set SMM communication context.
+**/
+VOID
+SetCommunicationContext (
+  VOID
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = gSmst->SmmInstallConfigurationTable (
+                    gSmst,
+                    &gEfiPeiSmmCommunicationPpiGuid,
+                    &mSmmCommunicationContext,
+                    sizeof(mSmmCommunicationContext)
+                    );
+  ASSERT_EFI_ERROR (Status);
+}
+
+/**
+  Dispatch function for a Software SMI handler.
+
+  @param DispatchHandle  The unique handle assigned to this handler by SmiHandlerRegister().
+  @param Context         Points to an optional handler context which was specified when the
+                         handler was registered.
+  @param CommBuffer      A pointer to a collection of data in memory that will
+                         be conveyed from a non-SMM environment into an SMM environment.
+  @param CommBufferSize  The size of the CommBuffer.
+
+  @retval EFI_SUCCESS Command is handled successfully.
+
+**/
+EFI_STATUS
+EFIAPI
+PiSmmCommunicationHandler (
+  IN EFI_HANDLE  DispatchHandle,
+  IN CONST VOID  *Context         OPTIONAL,
+  IN OUT VOID    *CommBuffer      OPTIONAL,
+  IN OUT UINTN   *CommBufferSize  OPTIONAL
+  )
+{
+  UINTN                            CommSize;
+  EFI_STATUS                       Status;
+  EFI_SMM_COMMUNICATE_HEADER       *CommunicateHeader;
+  EFI_PHYSICAL_ADDRESS             *BufferPtrAddress;
+
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler Enter\n"));
+
+  BufferPtrAddress = (EFI_PHYSICAL_ADDRESS *)(UINTN)mSmmCommunicationContext.BufferPtrAddress;
+  CommunicateHeader = (EFI_SMM_COMMUNICATE_HEADER *)(UINTN)*BufferPtrAddress;
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler CommunicateHeader - %x\n", CommunicateHeader));
+  if (CommunicateHeader == NULL) {
+    DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler is NULL, needn't to call dispatch function\n"));
+    Status = EFI_SUCCESS;
+  } else {
+    if (!SmmIsBufferOutsideSmmValid ((UINTN)CommunicateHeader, OFFSET_OF (EFI_SMM_COMMUNICATE_HEADER, Data))) {
+      DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler CommunicateHeader invalid - 0x%x\n", CommunicateHeader));
+      Status = EFI_SUCCESS;
+      goto Done;
+    }
+
+    CommSize = (UINTN)CommunicateHeader->MessageLength;
+    if (!SmmIsBufferOutsideSmmValid ((UINTN)&CommunicateHeader->Data[0], CommSize)) {
+      DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler CommunicateData invalid - 0x%x\n", &CommunicateHeader->Data[0]));
+      Status = EFI_SUCCESS;
+      goto Done;
+    }
+
+    //
+    // Call dispatch function
+    //
+    DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler Data - %x\n", &CommunicateHeader->Data[0]));
+    Status = gSmst->SmiManage (
+                      &CommunicateHeader->HeaderGuid,
+                      NULL,
+                      &CommunicateHeader->Data[0],
+                      &CommSize
+                      );
+  }
+
+Done:
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler %r\n", Status));
+  DEBUG ((EFI_D_INFO, "PiSmmCommunicationHandler Exit\n"));
+
+  return (Status == EFI_SUCCESS) ? EFI_SUCCESS : EFI_INTERRUPT_PENDING;
+}
+
+/**
+  Allocate EfiACPIMemoryNVS below 4G memory address.
+
+  This function allocates EfiACPIMemoryNVS below 4G memory address.
+
+  @param  Size         Size of memory to allocate.
+
+  @return Allocated address for output.
+
+**/
+VOID*
+AllocateAcpiNvsMemoryBelow4G (
+  IN   UINTN   Size
+  )
+{
+  UINTN                 Pages;
+  EFI_PHYSICAL_ADDRESS  Address;
+  EFI_STATUS            Status;
+  VOID*                 Buffer;
+
+  Pages = EFI_SIZE_TO_PAGES (Size);
+  Address = 0xffffffff;
+
+  Status  = gBS->AllocatePages (
+                   AllocateMaxAddress,
+                   EfiACPIMemoryNVS,
+                   Pages,
+                   &Address
+                   );
+  ASSERT_EFI_ERROR (Status);
+
+  Buffer = (VOID *) (UINTN) Address;
+  ZeroMem (Buffer, Size);
+
+  return Buffer;
+}
+
+/**
+  Entry Point for PI SMM communication SMM driver.
+
+  @param[in] ImageHandle  Image handle of this driver.
+  @param[in] SystemTable  A Pointer to the EFI System Table.
+
+  @retval EFI_SUCEESS
+  @return Others          Some error occurs.
+**/
+EFI_STATUS
+EFIAPI
+PiSmmCommunicationSmmEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_SMM_SW_DISPATCH2_PROTOCOL *SmmSwDispatch2;
+  EFI_SMM_SW_REGISTER_CONTEXT   SmmSwDispatchContext;
+  EFI_HANDLE                    DispatchHandle;
+  EFI_ACPI_TABLE_PROTOCOL       *AcpiTableProtocol;
+  UINTN                         TableKey;
+  UINT64                        OemTableId;
+  EFI_PHYSICAL_ADDRESS          *BufferPtrAddress;
+
+  CopyMem (
+    mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.OemId,
+    PcdGetPtr (PcdAcpiDefaultOemId),
+    sizeof (mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.OemId)
+    );
+  OemTableId = PcdGet64 (PcdAcpiDefaultOemTableId);
+  CopyMem (&mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.OemTableId, &OemTableId, sizeof (UINT64));
+  mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.OemRevision      = PcdGet32 (PcdAcpiDefaultOemRevision);
+  mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.CreatorId        = PcdGet32 (PcdAcpiDefaultCreatorId);
+  mSmmCommunicationAcpiTable.UefiAcpiDataTable.Header.CreatorRevision  = PcdGet32 (PcdAcpiDefaultCreatorRevision);
+
+  //
+  // Register software SMI handler
+  //
+  Status = gSmst->SmmLocateProtocol (
+                    &gEfiSmmSwDispatch2ProtocolGuid,
+                    NULL,
+                    (VOID **)&SmmSwDispatch2
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  SmmSwDispatchContext.SwSmiInputValue = (UINTN)-1;
+  Status = SmmSwDispatch2->Register (
+                             SmmSwDispatch2,
+                             PiSmmCommunicationHandler,
+                             &SmmSwDispatchContext,
+                             &DispatchHandle
+                             );
+  ASSERT_EFI_ERROR (Status);
+
+  DEBUG ((EFI_D_INFO, "SmmCommunication SwSmi: %x\n", (UINTN)SmmSwDispatchContext.SwSmiInputValue));
+
+  //
+  // Set ACPI table
+  //
+  Status = gBS->LocateProtocol (&gEfiAcpiTableProtocolGuid, NULL, (VOID **) &AcpiTableProtocol);
+  ASSERT_EFI_ERROR (Status);
+
+  mSmmCommunicationAcpiTable.SwSmiNumber = (UINT32)SmmSwDispatchContext.SwSmiInputValue;
+  BufferPtrAddress = AllocateAcpiNvsMemoryBelow4G (sizeof(EFI_PHYSICAL_ADDRESS));
+  ASSERT (BufferPtrAddress != NULL);
+  DEBUG ((EFI_D_INFO, "SmmCommunication BufferPtrAddress: 0x%016lx, BufferPtr: 0x%016lx\n", (EFI_PHYSICAL_ADDRESS)(UINTN)BufferPtrAddress, *BufferPtrAddress));
+  mSmmCommunicationAcpiTable.BufferPtrAddress = (EFI_PHYSICAL_ADDRESS)(UINTN)BufferPtrAddress;
+  CopyMem (&mSmmCommunicationAcpiTable.UefiAcpiDataTable.Identifier, &gEfiSmmCommunicationProtocolGuid, sizeof(gEfiSmmCommunicationProtocolGuid));
+
+  Status = AcpiTableProtocol->InstallAcpiTable (
+                                AcpiTableProtocol,
+                                &mSmmCommunicationAcpiTable,
+                                sizeof(mSmmCommunicationAcpiTable),
+                                &TableKey
+                                );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Save context
+  //
+  mSmmCommunicationContext.SwSmiNumber = (UINT32)SmmSwDispatchContext.SwSmiInputValue;
+  mSmmCommunicationContext.BufferPtrAddress = mSmmCommunicationAcpiTable.BufferPtrAddress;
+  SetCommunicationContext ();
+
+  return Status;
+}
diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
new file mode 100644
index 000000000000..9b03837cf3f1
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
@@ -0,0 +1,82 @@
+## @file
+# PI SMM Communication SMM driver that installs the SMM Communication ACPI Table.
+#
+# This SMM driver installs the SMM Communication ACPI Table defined in the UEFI spec
+# which provides a mechanism that can be used in the OS present environment by
+# non-firmware agents for inter-mode communication with SMM agents. It also saves
+# SMM communication context for use by SMM Communication PEIM in the S3 boot mode.
+#
+# Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PiSmmCommunicationSmm
+  MODULE_UNI_FILE                = PiSmmCommunicationSmm.uni
+  FILE_GUID                      = E21F35A8-42FF-4050-82D6-93F7CDFA7073
+  MODULE_TYPE                    = DXE_SMM_DRIVER
+  VERSION_STRING                 = 1.0
+  PI_SPECIFICATION_VERSION       = 0x0001000A
+  ENTRY_POINT                    = PiSmmCommunicationSmmEntryPoint
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  PiSmmCommunicationSmm.c
+  PiSmmCommunicationPrivate.h
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  UefiDriverEntryPoint
+  UefiBootServicesTableLib
+  UefiRuntimeServicesTableLib
+  SmmServicesTableLib
+  BaseLib
+  BaseMemoryLib
+  HobLib
+  DebugLib
+  SmmMemLib
+  PcdLib
+
+[Guids]
+  gEfiAcpi20TableGuid                ## SOMETIMES_CONSUMES  ## SystemTable
+  gEfiAcpi10TableGuid                ## SOMETIMES_CONSUMES  ## SystemTable
+  gEfiAcpiTableGuid                  ## SOMETIMES_CONSUMES  ## SystemTable
+
+[Ppis]
+  gEfiPeiSmmCommunicationPpiGuid     ## UNDEFINED # SMM Configuration Table
+
+[Protocols]
+  gEfiSmmSwDispatch2ProtocolGuid     ## CONSUMES
+  gEfiSmmCommunicationProtocolGuid   ## UNDEFINED # SMM Communication ACPI Table GUID
+  gEfiAcpiTableProtocolGuid          ## CONSUMES
+
+[Pcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemId             ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemTableId        ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemRevision       ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorId         ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision   ## CONSUMES
+
+[Depex]
+  gEfiSmmSwDispatch2ProtocolGuid AND
+  gEfiAcpiTableProtocolGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  PiSmmCommunicationSmmExtra.uni
diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.uni
new file mode 100644
index 0000000000000000000000000000000000000000..0ce635815c6b4b3257e5e107cc3cb846d570c1e7
GIT binary patch
literal 3004
zcmd6pTW=FF5QXO%iT_}wFMvqG?Fk`7LQ{x<CdwuPo=`4r8Y!1*H?;K61K$~Uvl~cT
zApxpZyI$Mlnd6x=WB>SGx4H%12Ry-E*|E)RZbx?4?l7vkuC@6l_JJqZYg^fZ=c_G|
z9NW;=v@3dr%*0a0&d`!Fy0#OS3XCl+qd&yLoWD4CR9bnR_6D{imOdIrj<UAFS>Wws
zZ|2%_%-eYWK8j!y_A1XUX(#MQf5q+w*0KZlVrHjEj5nx*ojckw-@sgoC(l?dee%zc
zci}7KLwP)-U-qdYAX_7(0#V6me@D<Eeo?>l9<gFgU#+ak>eB7R@sVAW5H5YT>ibKP
zI>%z_)`m8{)FrIP$SL01`<n68sz|SVFM&N@&6{)9h$RJs%9?A8w;iu|lc6W@9Xh|V
z63#r@*ICkBMEA`#=9r`3<i(2;itE_eC8ll9i0xP>_7n{x?5x~E?txuQmHtyKDqE)P
zUop9dr|#1}u}AipH{iv*_skyh-@e?zoPTLZ(V=gViSk&(b1al}D@KZ&;-9+rCRVc-
z*0i3z-1u=<9z|YG-G<mF#))H!nOHXjvpl;1iRLbx15;)ej!O1s{3&{c{+vZ~=Emqz
zZHU~>^=q{<K^D$<Rhjb47uSWNs4<d@yj!5DKq+LB6vtwv((DSp7CUH?AN%y*Z(%90
zmb3KN-Oj)ujq*mUJF=xZr(KW0ncG!df~h_U>oGH`gAsM)<2I^o&qQyEpE1|P-RJ}D
zbzSnTn6xGq&%J_+W6`^kPu<rw)~0Z-j{UOtGe$;WpTN59nHpM7cypiRt@iVlT+lhu
zvyQ#t+wi<-d(GL0uL&|e+NKToYq_Tfc1YV|ywFfYp$)TJNF=Vg!=D(fZ-q9YmDUPv
z)BEZ@++Yj#k$K_jxJC6FSQ4^B#@lF>j*eUJ(Gzx!$z~rZ$;fJyIzUz{KhwTrM#z<k
zssM5K+C|GgZS)k{RU^9aN;db&x7=@e8~o(0`?$vTHq2QPA5}#8?h9HvtRJAMMX$lW
z<BU$lK5|z*d&E)sG$r=2s>ZrsMVC-kKzDo3_sSpoMT|=Dh}hQML~)mIZuX1v^tRq3
z63^)|_;l+i-@?Spa<%%mcZw=F@-yY;J4Jwps>QeUE)ma+;uaFmwB2{zc&g~U`TsYG
Hm=!+()}`rs

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmmExtra.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmmExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..60a7d627dab28774284412ae1adc735204db53dd
GIT binary patch
literal 1392
zcmZXUTW`}q5QXO%iT_}Q7eH;o?Fk`7(ipI4F3Lr~Q<YoONJ$(yX(9Z0+V9NzLW(SV
zc4lYKoIN|<`@aoqSj791C$dj=Z7W;b!k*d_qMGXy8QO;D!cw=lwk0;Ri5;*hUYL*U
z5>N3p@jsx<SwAEz!{6G{_V^P<iVJPa+`_*_y~2k1ogIDc(r(C%>^bN!uy5>@y|%ZE
z&P(r|oiR>w%r#?G$ZY4|iff&jCJdD!UIAOoGPvw{GrM!{b^Bl~8`#HEjf&j}Ml0XX
zj{FpqjGb*jDfV|DW8wY`)>3ZgbH`kZh=^FJ-ipy0v<iPhRI8=rjM3JaNw)%DtLJ%z
zJH|S<iB0)xoz6(J8RLRUsI_s{1&Wv{b46A-ODU1k2i3Y3XV}KSJmFGt{pDKB_=?@>
zZdY&+qBsP-RBMl~T~Faz)YZ8}CSAq<nwfA$V*Q(}$E;4332Gk6n&#`%Tmx}B{G+To
z>A+dM_x?^91$C95xz=^|pK+p%N9ym1OyNGK>rSiJLAl{AG%2k1^VMQl_35LYec{`*
z4t|2B5vt0Lh$eK}m{IIXkFAT1iB|~KDI|1uOvccWdyLf4`qr?*6>1IJa$nwA$t|+)
z%!^mgE6Q(DNzA&$6HtZG^XdaUaaT+=M`S5SRYTTia<%d&_8T)|u0Ju(tAt&|_M^n9
z&=a)i(^sn5wtC62(ogqN!{drQD?3NGiS8C@ca^K#2W3$1;0o*>sAKSBa=NhWFbX*O
zSA=nkU3$l;3(m<NdPWV~;R&~hZomI;J?;B~+6h@BaEgDg&0clpZSQg2B^jrox(~MY
B*m(c|

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 5fcff1510dae..a4117a2e85ad 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -53,6 +53,8 @@
   ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseReportStatusCodeLibNull.inf
   CpuExceptionHandlerLib|MdeModulePkg/Library/CpuExceptionHandlerLibNull/CpuExceptionHandlerLibNull.inf
   SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
+  SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
+
 
 [LibraryClasses.common.PEIM]
   MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
@@ -72,6 +74,7 @@
 [LibraryClasses.common.DXE_SMM_DRIVER]
   SmmServicesTableLib|MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.inf
   MemoryAllocationLib|MdePkg/Library/SmmMemoryAllocationLib/SmmMemoryAllocationLib.inf
+  HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
 
 #
 # Drivers/Libraries within this package
@@ -93,5 +96,7 @@
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
+  UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
+  UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
   UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.inf
 

From 6f3361bd96e8f3b8968d2df14a7e3bac15f882d2 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:55:54 +0000
Subject: [PATCH 114/525] UefiCpuPkg: Add PlatformSecLib

Add PlatformSecLib class and PlatformSecLibNull instance
that is used by the SecCore.  PlatformSecLibNull should
not be used in a platform build.  Instead, it should be
used as a template for implementing a platform specific
instance of the PlatformSecLib library class.

(Sync patch r18635 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18830 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Library/PlatformSecLib.h   |  70 ++++++++++++++
 .../PlatformSecLibNull/PlatformSecLibNull.c   |  90 ++++++++++++++++++
 .../PlatformSecLibNull/PlatformSecLibNull.inf |  37 +++++++
 .../PlatformSecLibNull/PlatformSecLibNull.uni | Bin 0 -> 1644 bytes
 4 files changed, 197 insertions(+)
 create mode 100644 UefiCpuPkg/Include/Library/PlatformSecLib.h
 create mode 100644 UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.c
 create mode 100644 UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
 create mode 100644 UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.uni

diff --git a/UefiCpuPkg/Include/Library/PlatformSecLib.h b/UefiCpuPkg/Include/Library/PlatformSecLib.h
new file mode 100644
index 000000000000..0af7781771b5
--- /dev/null
+++ b/UefiCpuPkg/Include/Library/PlatformSecLib.h
@@ -0,0 +1,70 @@
+/** @file
+This library class defines interface for platform to perform platform
+specific initialization in SEC phase.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __PLATFORM_SEC_LIB_H__
+#define __PLATFORM_SEC_LIB_H__
+
+/**
+  A developer supplied function to perform platform specific operations.
+
+  It's a developer supplied function to perform any operations appropriate to a
+  given platform. It's invoked just before passing control to PEI core by SEC
+  core. Platform developer may modify the SecCoreData passed to PEI Core.
+  It returns a platform specific PPI list that platform wishes to pass to PEI core.
+  The Generic SEC core module will merge this list to join the final list passed to
+  PEI core.
+
+  @param  SecCoreData           The same parameter as passing to PEI core. It
+                                could be overridden by this function.
+
+  @return The platform specific PPI list to be passed to PEI core or
+          NULL if there is no need of such platform specific PPI list.
+
+**/
+EFI_PEI_PPI_DESCRIPTOR *
+EFIAPI
+SecPlatformMain (
+  IN OUT   EFI_SEC_PEI_HAND_OFF        *SecCoreData
+  );
+
+/**
+  This interface conveys state information out of the Security (SEC) phase into PEI.
+
+  @param  PeiServices               Pointer to the PEI Services Table.
+  @param  StructureSize             Pointer to the variable describing size of the input buffer.
+  @param  PlatformInformationRecord Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.
+
+  @retval EFI_SUCCESS           The data was successfully returned.
+  @retval EFI_BUFFER_TOO_SMALL  The buffer was too small.
+
+**/
+EFI_STATUS
+EFIAPI
+SecPlatformInformation (
+  IN CONST EFI_PEI_SERVICES                     **PeiServices,
+  IN OUT   UINT64                               *StructureSize,
+     OUT   EFI_SEC_PLATFORM_INFORMATION_RECORD  *PlatformInformationRecord
+  );
+
+/**
+  This interface disables temporary memory in SEC Phase.
+**/
+VOID
+EFIAPI
+SecPlatformDisableTemporaryMemory (
+  VOID
+  );
+
+#endif
diff --git a/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.c b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.c
new file mode 100644
index 000000000000..ad3e9090c63f
--- /dev/null
+++ b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.c
@@ -0,0 +1,90 @@
+/** @file
+Null instance of Platform Sec Lib.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiPei.h>
+
+#include <Ppi/SecPlatformInformation.h>
+
+/**
+  A developer supplied function to perform platform specific operations.
+
+  It's a developer supplied function to perform any operations appropriate to a
+  given platform. It's invoked just before passing control to PEI core by SEC
+  core. Platform developer may modify the SecCoreData passed to PEI Core.
+  It returns a platform specific PPI list that platform wishes to pass to PEI core.
+  The Generic SEC core module will merge this list to join the final list passed to
+  PEI core.
+
+  @param  SecCoreData           The same parameter as passing to PEI core. It
+                                could be overridden by this function.
+
+  @return The platform specific PPI list to be passed to PEI core or
+          NULL if there is no need of such platform specific PPI list.
+
+**/
+EFI_PEI_PPI_DESCRIPTOR *
+EFIAPI
+SecPlatformMain (
+  IN OUT   EFI_SEC_PEI_HAND_OFF        *SecCoreData
+  )
+{
+  return NULL;
+}
+
+/**
+  This interface conveys state information out of the Security (SEC) phase into PEI.
+
+  @param  PeiServices               Pointer to the PEI Services Table.
+  @param  StructureSize             Pointer to the variable describing size of the input buffer.
+  @param  PlatformInformationRecord Pointer to the EFI_SEC_PLATFORM_INFORMATION_RECORD.
+
+  @retval EFI_SUCCESS           The data was successfully returned.
+  @retval EFI_BUFFER_TOO_SMALL  The buffer was too small.
+
+**/
+EFI_STATUS
+EFIAPI
+SecPlatformInformation (
+  IN CONST EFI_PEI_SERVICES                     **PeiServices,
+  IN OUT   UINT64                               *StructureSize,
+     OUT   EFI_SEC_PLATFORM_INFORMATION_RECORD  *PlatformInformationRecord
+  )
+{
+  return EFI_SUCCESS;
+}
+
+/**
+  This interface disables temporary memory in SEC Phase.
+**/
+VOID
+EFIAPI
+SecPlatformDisableTemporaryMemory (
+  VOID
+  )
+{
+}
+
+/**
+  This function provides dummy function so that SecCore can pass build
+  validation. All real platform library instances need to implement the real
+  entry point in assembly.
+**/
+VOID
+EFIAPI
+_ModuleEntryPoint (
+  VOID
+  )
+{
+  return;
+}
diff --git a/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
new file mode 100644
index 000000000000..3f8868adee3e
--- /dev/null
+++ b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
@@ -0,0 +1,37 @@
+## @file
+#  Library functions for PlatformSecLib.
+#
+#  Null instance of Platform Sec Lib.
+#
+#  Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PlatformSecLibNull
+  MODULE_UNI_FILE                = PlatformSecLibNull.uni
+  FILE_GUID                      = 6695974D-968C-420b-80B9-7870CD20118F
+  MODULE_TYPE                    = SEC
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PlatformSecLib
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  PlatformSecLibNull.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
diff --git a/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.uni b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.uni
new file mode 100644
index 0000000000000000000000000000000000000000..352ede7190b859c7332adf9717d285c0fea895d8
GIT binary patch
literal 1644
zcmb`H-EPxB5QXO&iFa6~H-K6Pkhnnz;ZOq>kVK6m;0ifOlSXRl$}xq$Jn)@e|CBTc
zA&_OScV_m?nKNVm_};g^IqnBs&R*Ek)^={EcGvD;mG2#vnU$7vU$bA@7rU^zRoDyO
zw%%6YbvEW~j%SIdw2e(bn%4+Xi`iih!8+%1U<s+>w6IUH6rkKjbT#HKuYKq*!MKET
z3Hr*;KzDWz^!u!j?V&xgCw9ntO3sR$;-NDor}R`Mp~eVLTr=&^RC&p{Eq7^GJQo((
zGaJ~6J>OGp28XrR>yr2aPRg+XMO80YD<V{T4$C<a8<@y<?e$sV*{~N^vB+VxZS&}q
z*f^|fub~tbrw(7I7j=d!-qq`z?yBR?_f=kXvSAW(Z9MCSrI?BDy46QYgnl*W2K4C|
ztENZ&3|zX-fAw0-dETyeO}r3=74%XrO^2$U!SiNcoMp9Yn#?dwV*QP%T~@y;6V%j9
z&xqG#7qtfBRNYWkvs2NFr~aGJRE3HZU;6qY&X#nvzoY&Z%M9)dJKFI?pqz0xnl!8G
zd1DED#>~;kUh|CYJ^K_*9ja>0u%=Afl()nyJ+&cgg1tlNx{xy22@w;IJmO6gt!Ix_
zxI*o*4*Xub!<L(~5BSAv<TGj?lS#~m*i%r2G4k0@*onJr%9#<R7-bDnuZY#jPpoh8
zh`GMRq|OqmNbF;a)1jwmF=nom^O*0g(XCmX|CjZ>UABXEaxUnP{vXorGbkg@PeDr9
z#nc@<F-m2`{q8!TkNOf;^gidQ$<Z_%fhCr``hWNDf6U%r)}ZcBV6Vv-w~Ftp<Igqx
J&p&gh<0m{g{_g+)

literal 0
HcmV?d00001


From 31bb298261717028c59d712119c220fbdf07a7e8 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:56:43 +0000
Subject: [PATCH 115/525] UefiCpuPkg: Add SecCore module

Add SecCore module that uses the PlatformSecLib class for platform
specific actions.  The SecCore module also uses a new PCD to
configure the size of the stack used in the SEC phase.  If the
stack size PCD is set to 0, the stack is configured to use half
of the available temporary RAM.

(Sync patch r18636 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18831 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/SecCore/FindPeiCore.c       | 198 +++++++++++++++++
 UefiCpuPkg/SecCore/Ia32/ResetVec.asm16 | 106 +++++++++
 UefiCpuPkg/SecCore/Ia32/ResetVec.nasmb | 103 +++++++++
 UefiCpuPkg/SecCore/SecCore.inf         |  72 ++++++
 UefiCpuPkg/SecCore/SecCore.uni         | Bin 0 -> 2908 bytes
 UefiCpuPkg/SecCore/SecCoreExtra.uni    | Bin 0 -> 1316 bytes
 UefiCpuPkg/SecCore/SecMain.c           | 295 +++++++++++++++++++++++++
 UefiCpuPkg/SecCore/SecMain.h           | 109 +++++++++
 8 files changed, 883 insertions(+)
 create mode 100644 UefiCpuPkg/SecCore/FindPeiCore.c
 create mode 100644 UefiCpuPkg/SecCore/Ia32/ResetVec.asm16
 create mode 100644 UefiCpuPkg/SecCore/Ia32/ResetVec.nasmb
 create mode 100644 UefiCpuPkg/SecCore/SecCore.inf
 create mode 100644 UefiCpuPkg/SecCore/SecCore.uni
 create mode 100644 UefiCpuPkg/SecCore/SecCoreExtra.uni
 create mode 100644 UefiCpuPkg/SecCore/SecMain.c
 create mode 100644 UefiCpuPkg/SecCore/SecMain.h

diff --git a/UefiCpuPkg/SecCore/FindPeiCore.c b/UefiCpuPkg/SecCore/FindPeiCore.c
new file mode 100644
index 000000000000..60ccaa9667c7
--- /dev/null
+++ b/UefiCpuPkg/SecCore/FindPeiCore.c
@@ -0,0 +1,198 @@
+/** @file
+  Locate the entry point for the PEI Core
+
+  Copyright (c) 2008 - 2011, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiPei.h>
+#include <Library/BaseLib.h>
+#include <Library/PeCoffGetEntryPointLib.h>
+
+#include "SecMain.h"
+
+/**
+  Find core image base.
+
+  @param   BootFirmwareVolumePtr    Point to the boot firmware volume.
+  @param   SecCoreImageBase         The base address of the SEC core image.
+  @param   PeiCoreImageBase         The base address of the PEI core image.
+
+**/
+EFI_STATUS
+EFIAPI
+FindImageBase (
+  IN  EFI_FIRMWARE_VOLUME_HEADER       *BootFirmwareVolumePtr,
+  OUT EFI_PHYSICAL_ADDRESS             *SecCoreImageBase,
+  OUT EFI_PHYSICAL_ADDRESS             *PeiCoreImageBase
+  )
+{
+  EFI_PHYSICAL_ADDRESS        CurrentAddress;
+  EFI_PHYSICAL_ADDRESS        EndOfFirmwareVolume;
+  EFI_FFS_FILE_HEADER         *File;
+  UINT32                      Size;
+  EFI_PHYSICAL_ADDRESS        EndOfFile;
+  EFI_COMMON_SECTION_HEADER   *Section;
+  EFI_PHYSICAL_ADDRESS        EndOfSection;
+
+  *SecCoreImageBase = 0;
+  *PeiCoreImageBase = 0;
+
+  CurrentAddress = (EFI_PHYSICAL_ADDRESS)(UINTN) BootFirmwareVolumePtr;
+  EndOfFirmwareVolume = CurrentAddress + BootFirmwareVolumePtr->FvLength;
+
+  //
+  // Loop through the FFS files in the Boot Firmware Volume
+  //
+  for (EndOfFile = CurrentAddress + BootFirmwareVolumePtr->HeaderLength; ; ) {
+
+    CurrentAddress = (EndOfFile + 7) & 0xfffffffffffffff8ULL;
+    if (CurrentAddress > EndOfFirmwareVolume) {
+      return EFI_NOT_FOUND;
+    }
+
+    File = (EFI_FFS_FILE_HEADER*)(UINTN) CurrentAddress;
+    if (IS_FFS_FILE2 (File)) {
+      Size = FFS_FILE2_SIZE (File);
+      if (Size <= 0x00FFFFFF) {
+        return EFI_NOT_FOUND;
+      }
+    } else {
+      Size = FFS_FILE_SIZE (File);
+      if (Size < sizeof (EFI_FFS_FILE_HEADER)) {
+        return EFI_NOT_FOUND;
+      }
+    }
+
+    EndOfFile = CurrentAddress + Size;
+    if (EndOfFile > EndOfFirmwareVolume) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // Look for SEC Core / PEI Core files
+    //
+    if (File->Type != EFI_FV_FILETYPE_SECURITY_CORE &&
+        File->Type != EFI_FV_FILETYPE_PEI_CORE) {
+      continue;
+    }
+
+    //
+    // Loop through the FFS file sections within the FFS file
+    //
+    if (IS_FFS_FILE2 (File)) {
+      EndOfSection = (EFI_PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) File + sizeof (EFI_FFS_FILE_HEADER2));
+    } else {
+      EndOfSection = (EFI_PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) File + sizeof (EFI_FFS_FILE_HEADER));
+    }
+    for (;;) {
+      CurrentAddress = (EndOfSection + 3) & 0xfffffffffffffffcULL;
+      Section = (EFI_COMMON_SECTION_HEADER*)(UINTN) CurrentAddress;
+
+      if (IS_SECTION2 (Section)) {
+        Size = SECTION2_SIZE (Section);
+        if (Size <= 0x00FFFFFF) {
+          return EFI_NOT_FOUND;
+        }
+      } else {
+        Size = SECTION_SIZE (Section);
+        if (Size < sizeof (EFI_COMMON_SECTION_HEADER)) {
+          return EFI_NOT_FOUND;
+        }
+      }
+
+      EndOfSection = CurrentAddress + Size;
+      if (EndOfSection > EndOfFile) {
+        return EFI_NOT_FOUND;
+      }
+
+      //
+      // Look for executable sections
+      //
+      if (Section->Type == EFI_SECTION_PE32 || Section->Type == EFI_SECTION_TE) {
+        if (File->Type == EFI_FV_FILETYPE_SECURITY_CORE) {
+          if (IS_SECTION2 (Section)) {
+            *SecCoreImageBase = (PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) Section + sizeof (EFI_COMMON_SECTION_HEADER2));
+          } else {
+            *SecCoreImageBase = (PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) Section + sizeof (EFI_COMMON_SECTION_HEADER));
+          }
+        } else {
+          if (IS_SECTION2 (Section)) {
+            *PeiCoreImageBase = (PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) Section + sizeof (EFI_COMMON_SECTION_HEADER2));
+          } else {
+            *PeiCoreImageBase = (PHYSICAL_ADDRESS) (UINTN) ((UINT8 *) Section + sizeof (EFI_COMMON_SECTION_HEADER));
+          }
+        }
+        break;
+      }
+    }
+
+    //
+    // Both SEC Core and PEI Core images found
+    //
+    if (*SecCoreImageBase != 0 && *PeiCoreImageBase != 0) {
+      return EFI_SUCCESS;
+    }
+  }
+}
+
+/**
+  Find and return Pei Core entry point.
+
+  It also find SEC and PEI Core file debug information. It will report them if
+  remote debug is enabled.
+
+  @param   BootFirmwareVolumePtr    Point to the boot firmware volume.
+  @param   PeiCoreEntryPoint        The entry point of the PEI core.
+
+**/
+VOID
+EFIAPI
+FindAndReportEntryPoints (
+  IN  EFI_FIRMWARE_VOLUME_HEADER       *BootFirmwareVolumePtr,
+  OUT EFI_PEI_CORE_ENTRY_POINT         *PeiCoreEntryPoint
+  )
+{
+  EFI_STATUS                       Status;
+  EFI_PHYSICAL_ADDRESS             SecCoreImageBase;
+  EFI_PHYSICAL_ADDRESS             PeiCoreImageBase;
+  PE_COFF_LOADER_IMAGE_CONTEXT     ImageContext;
+
+  //
+  // Find SEC Core and PEI Core image base
+  //
+  Status = FindImageBase (BootFirmwareVolumePtr, &SecCoreImageBase, &PeiCoreImageBase);
+  ASSERT_EFI_ERROR (Status);
+
+  ZeroMem ((VOID *) &ImageContext, sizeof (PE_COFF_LOADER_IMAGE_CONTEXT));
+  //
+  // Report SEC Core debug information when remote debug is enabled
+  //
+  ImageContext.ImageAddress = SecCoreImageBase;
+  ImageContext.PdbPointer = PeCoffLoaderGetPdbPointer ((VOID*) (UINTN) ImageContext.ImageAddress);
+  PeCoffLoaderRelocateImageExtraAction (&ImageContext);
+
+  //
+  // Report PEI Core debug information when remote debug is enabled
+  //
+  ImageContext.ImageAddress = PeiCoreImageBase;
+  ImageContext.PdbPointer = PeCoffLoaderGetPdbPointer ((VOID*) (UINTN) ImageContext.ImageAddress);
+  PeCoffLoaderRelocateImageExtraAction (&ImageContext);
+
+  //
+  // Find PEI Core entry point
+  //
+  Status = PeCoffLoaderGetEntryPoint ((VOID *) (UINTN) PeiCoreImageBase, (VOID**) PeiCoreEntryPoint);
+  if (EFI_ERROR (Status)) {
+    *PeiCoreEntryPoint = 0;
+  }
+
+  return;
+}
diff --git a/UefiCpuPkg/SecCore/Ia32/ResetVec.asm16 b/UefiCpuPkg/SecCore/Ia32/ResetVec.asm16
new file mode 100644
index 000000000000..d90613c4d038
--- /dev/null
+++ b/UefiCpuPkg/SecCore/Ia32/ResetVec.asm16
@@ -0,0 +1,106 @@
+;------------------------------------------------------------------------------
+;
+; Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;  ResetVec.asm
+;
+; Abstract:
+;
+;  Reset Vector Data structure
+;  This structure is located at 0xFFFFFFC0
+;
+;------------------------------------------------------------------------------
+
+    .model  tiny
+    .686p
+    .stack  0h
+    .code
+
+;
+; The layout of this file is fixed. The build tool makes assumption of the layout.
+;
+
+    ORG     0h
+;
+; Reserved
+;
+ReservedData         DD 0eeeeeeeeh, 0eeeeeeeeh
+
+    ORG     10h
+;
+; This is located at 0xFFFFFFD0h
+;
+    mov     di, "AP"
+    jmp     ApStartup
+
+    ORG     20h
+;
+; Pointer to the entry point of the PEI core
+; It is located at 0xFFFFFFE0, and is fixed up by some build tool
+; So if the value 8..1 appears in the final FD image, tool failure occurs.
+;
+PeiCoreEntryPoint       DD      87654321h
+
+;
+; This is the handler for all kinds of exceptions. Since it's for debugging
+; purpose only, nothing except a dead loop would be done here. Developers could
+; analyze the cause of the exception if a debugger had been attached.
+;
+InterruptHandler    PROC
+    jmp     $
+    iret
+InterruptHandler    ENDP
+
+    ORG     30h
+;
+; For IA32, the reset vector must be at 0xFFFFFFF0, i.e., 4G-16 byte
+; Execution starts here upon power-on/platform-reset.
+;
+ResetHandler:
+    nop
+    nop
+ApStartup:
+    ;
+    ; Jmp Rel16 instruction
+    ; Use machine code directly in case of the assembler optimization
+    ; SEC entry point relative address will be fixed up by some build tool.
+    ;
+    ; Typically, SEC entry point is the function _ModuleEntryPoint() defined in
+    ; SecEntry.asm
+    ;
+    DB      0e9h
+    DW      -3
+
+
+    ORG     38h
+;
+; Ap reset vector segment address is at 0xFFFFFFF8
+; This will be fixed up by some build tool,
+; so if the value 1..8 appears in the final FD image,
+; tool failure occurs
+;
+ApSegAddress    dd      12345678h
+
+    ORG     3ch
+;
+; BFV Base is at 0xFFFFFFFC
+; This will be fixed up by some build tool,
+; so if the value 1..8 appears in the final FD image,
+; tool failure occurs.
+;
+BfvBase     DD      12345678h
+
+;
+; Nothing can go here, otherwise the layout of this file would change.
+;
+
+    END
diff --git a/UefiCpuPkg/SecCore/Ia32/ResetVec.nasmb b/UefiCpuPkg/SecCore/Ia32/ResetVec.nasmb
new file mode 100644
index 000000000000..2fcdc85e47aa
--- /dev/null
+++ b/UefiCpuPkg/SecCore/Ia32/ResetVec.nasmb
@@ -0,0 +1,103 @@
+;------------------------------------------------------------------------------
+;
+; Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;  ResetVec.nasmb
+;
+; Abstract:
+;
+;  Reset Vector Data structure
+;  This structure is located at 0xFFFFFFC0
+;
+;------------------------------------------------------------------------------
+
+;    .stack  0x0
+;    SECTION .text
+USE16
+
+;
+; The layout of this file is fixed. The build tool makes assumption of the layout.
+;
+
+    ORG     0h
+;
+; Reserved
+;
+ReservedData:            DD 0eeeeeeeeh, 0eeeeeeeeh
+
+    TIMES 0x10-($-$$) DB 0
+;
+; This is located at 0xFFFFFFD0h
+;
+    mov     di, "PA"
+    jmp     ApStartup
+
+    TIMES 0x20-($-$$) DB 0
+;
+; Pointer to the entry point of the PEI core
+; It is located at 0xFFFFFFE0, and is fixed up by some build tool
+; So if the value 8..1 appears in the final FD image, tool failure occurs.
+;
+PeiCoreEntryPoint:       DD      87654321h
+
+;
+; This is the handler for all kinds of exceptions. Since it's for debugging
+; purpose only, nothing except a dead loop would be done here. Developers could
+; analyze the cause of the exception if a debugger had been attached.
+;
+global ASM_PFX(InterruptHandler)
+ASM_PFX(InterruptHandler):
+    jmp     $
+    iret
+
+    TIMES 0x30-($-$$) DB 0
+;
+; For IA32, the reset vector must be at 0xFFFFFFF0, i.e., 4G-16 byte
+; Execution starts here upon power-on/platform-reset.
+;
+ResetHandler:
+    nop
+    nop
+ApStartup:
+    ;
+    ; Jmp Rel16 instruction
+    ; Use machine code directly in case of the assembler optimization
+    ; SEC entry point relative address will be fixed up by some build tool.
+    ;
+    ; Typically, SEC entry point is the function _ModuleEntryPoint() defined in
+    ; SecEntry.asm
+    ;
+    DB      0e9h
+    DW      -3
+
+
+    TIMES 0x38-($-$$) DB 0
+;
+; Ap reset vector segment address is at 0xFFFFFFF8
+; This will be fixed up by some build tool,
+; so if the value 1..8 appears in the final FD image,
+; tool failure occurs
+;
+ApSegAddress:    dd      12345678h
+
+    TIMES 0x3c-($-$$) DB 0
+;
+; BFV Base is at 0xFFFFFFFC
+; This will be fixed up by some build tool,
+; so if the value 1..8 appears in the final FD image,
+; tool failure occurs.
+;
+BfvBase:     DD      12345678h
+
+;
+; Nothing can go here, otherwise the layout of this file would change.
+;
diff --git a/UefiCpuPkg/SecCore/SecCore.inf b/UefiCpuPkg/SecCore/SecCore.inf
new file mode 100644
index 000000000000..bf08a4cc49a5
--- /dev/null
+++ b/UefiCpuPkg/SecCore/SecCore.inf
@@ -0,0 +1,72 @@
+## @file
+#  SecCore module that implements the SEC phase.
+#
+#  This is the first module taking control of the platform upon power-on/reset.
+#  It implements the first phase of the security phase. The entry point function is
+#  _ModuleEntryPoint in PlatformSecLib. The entry point function will switch to
+#  protected mode, setup flat memory model, enable temporary memory and
+#  call into SecStartup().
+#
+#  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SecCore
+  MODULE_UNI_FILE                = SecCore.uni
+  FILE_GUID                      = 1BA0062E-C779-4582-8566-336AE8F78F09
+  MODULE_TYPE                    = SEC
+  VERSION_STRING                 = 1.0
+
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  SecMain.c
+  SecMain.h
+  FindPeiCore.c
+
+[Sources.IA32]
+  Ia32/ResetVec.asm16 | MSFT
+  Ia32/ResetVec.asm16 | INTEL
+  Ia32/ResetVec.nasmb | GCC
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
+
+[LibraryClasses]
+  BaseMemoryLib
+  DebugLib
+  BaseLib
+  PlatformSecLib
+  PcdLib
+  DebugAgentLib
+  UefiCpuLib
+  PeCoffGetEntryPointLib
+  PeCoffExtraActionLib
+  CpuExceptionHandlerLib
+  ReportStatusCodeLib
+
+[Ppis]
+  gEfiSecPlatformInformationPpiGuid                    ## PRODUCES
+  gEfiTemporaryRamDonePpiGuid                          ## PRODUCES
+
+[Pcd]
+  gUefiCpuPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize  ## CONSUMES
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  SecCoreExtra.uni
diff --git a/UefiCpuPkg/SecCore/SecCore.uni b/UefiCpuPkg/SecCore/SecCore.uni
new file mode 100644
index 0000000000000000000000000000000000000000..dff756a3b322aea1a748929138498bb8d5e81e91
GIT binary patch
literal 2908
zcmd6p?Q0W35XR@T;Qw%>Us`Ds74d_JnA%f=+Jq!U{Un!{rp3IJOKR;uul}Cd-0d~g
zN(({>*}I*coq6V&*}47wt6>dG_&?&8*lRnsQ=8h@9@+z>TI(?z+8bL~&Rb$L-bQxr
zT8XXf#4^T&eKR|A=?uL&vL#ZjYgf-wY$Rw%e~GMK`iQ>zte*P5Fc!OoDn~9qoBlKV
z&g$GItPQ~?&pFR2^9Aul3_>TY$H;T+Bt&uMJA`Xt7of^*&m|4s#*TAUL7G_0G29$$
z6>W@n6OA|+f*=R|$}T|@b?eN;g_sLm=4*|G$0{C<**nL=3W=gt29_nKiG8zA$cs#+
zYhEs`gH(KloM~TYgO`x;k7x~u{Vqr@*gN$MEMZmg4T(mXSX2<65&Hs}c+faPBV>1M
zyS$5`mFGy&hTKVG>{@}5LVxNz#8n1rRj|BCQ<=??7W&oQ8Tz9Nq9J+#cVK9NmB2<1
zYqAmWY}-zyDq{WWl$?<%<#a;C;&_|rc6dIu$NZl2wzr-=v1g9D<=GfJU*Vh;n2X#h
z3(YmMXj|v2sM6ei5bX$5FKyqt_Nt63qKl_1Fh5~;215y>c!(z@1GCPO*wfl2@q`mL
zV=i8WLR?iVPW*`XDQiRC=AJ>>E$nOe$aOOCX6PxaMZQ$eTFom+g0C5tqLpyUN9->6
z(dyN+zE9o`kgAF!mdM40cbZU@o6(+vq3B(q56PFhkD?w>k%eF7C7utR$WT2({S&QC
zR9Bf%EoXkN2hNH5Qs6+buF4E1UP&u*@xptuYAmoT{oLcLvp1*a8XN2{kqp2-qUx@C
zuVdwef5A!dR6OtL*6IsgYuh`<CcQ+xug7@c&py%?m3D-7>P#QmA<q<fv=Fn<qWh<4
z=sS>L^^mdYV~wZm%6g6GzRxw=EwLr`nRVf6yGPBNcoMQh<SneqM%%r2nF+gO^4UjA
zI`SH{-mblW<@tdXAy>yq*Iq&tseLK!MC&cM=ulVkd2nqP(6_YV*v08qSvlbZ^}y2g
z?%Zbo5tdSBP2vtKO_=I~<!`?&KQpp*PL)i&a#Rg_*b>Sb<Nx_$*KQe;s-Z_Ts+3Nd
zf$QS>cTBN&-LIR${l5|1-<yDLJU8C}s`rT7-UZ^`yWI*Bzqy2de!F`?I46Gq&C20^

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/SecCore/SecCoreExtra.uni b/UefiCpuPkg/SecCore/SecCoreExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..15e22ed85253d9e1bad6286d049ddc91125cc6ea
GIT binary patch
literal 1316
zcmZvcS#Q%&5QXO%iT_}Q7eH;o_Jj~3X$@F3i?RrKs+^=vEoGCFwuB!Kd}po~Qcz^y
zxpQaEoH=*m-@jVcvWVw7zsNq=wPm)nD|>8@@ak;DZf0k;u^cP13#^%?L}m69&)j47
zoMyJRh3(j<Sn?}tZF{2hE-}kBoNw*mxeL1?CbFlXKVyAmFYKkg#yYKbZ|np+DKMAV
zf!EgArQ~N`vB^mrhKdlcfGuX~VaJo(opW#6JL}lc-v5W)7)F`*vn755N=|1hP|E)H
zL`ahq&NCubw)L|^p+$s8tW+<<T7p)0pW;=vl$>F$otbni@s&L<D%@e~Zc>}_R^BZc
zI?b_5CZX2KS(hkcrpT<)M@nqC>pHK)J)g6`IO0-sy>~5Uy#MVsgM$#oA?T%AJND{&
z3eUgqB{JzM{@0v@I}+<3L_K76tV~ezK-9Fz-xL~%Q$1f1_<Md^d+Rg2!3ydsK6kB~
z^q+I1tq1Dw@J!)8XX=itH$l1KDK#lq_4C<cSPht?zJ21|wl4bwO(Rs*I>wtYX%np2
zm7Z9SHO5~f)VGi@*)b6#NA6>3qV;aD3RkEN){gJBJE^!u_LXz->U%})+f)*>9{vPW
zVf4NFke#^8r<!A;6r-vk>Lanr{LcD?6EW96F)pfvE@Jyu;ne5}S`3&g)jYRm#j(~;
z-=3EH<$F?1j=m=P{z$vaLfru<!>WTzu=}7+z>kUP!Lo}LaP(gh#x3i@Cq`3nO7zGh
X8s6_2HNsa!GudS>=02BKs4JX5;;_nz

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/SecCore/SecMain.c b/UefiCpuPkg/SecCore/SecMain.c
new file mode 100644
index 000000000000..ec252cf719f5
--- /dev/null
+++ b/UefiCpuPkg/SecCore/SecMain.c
@@ -0,0 +1,295 @@
+/** @file
+  C functions in SEC
+
+  Copyright (c) 2008 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "SecMain.h"
+
+EFI_PEI_TEMPORARY_RAM_DONE_PPI gSecTemporaryRamDonePpi = {
+  SecTemporaryRamDone
+};
+
+EFI_SEC_PLATFORM_INFORMATION_PPI  mSecPlatformInformationPpi = { SecPlatformInformation };
+
+EFI_PEI_PPI_DESCRIPTOR            mPeiSecPlatformInformationPpi[] = {
+  {
+    EFI_PEI_PPI_DESCRIPTOR_PPI,
+    &gEfiTemporaryRamDonePpiGuid,
+    &gSecTemporaryRamDonePpi
+  },
+  {
+    (EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),
+    &gEfiSecPlatformInformationPpiGuid,
+    &mSecPlatformInformationPpi
+  }
+};
+
+//
+// These are IDT entries pointing to 10:FFFFFFE4h.
+//
+UINT64  mIdtEntryTemplate = 0xffff8e000010ffe4ULL;
+
+/**
+  Caller provided function to be invoked at the end of InitializeDebugAgent().
+
+  Entry point to the C language phase of SEC. After the SEC assembly
+  code has initialized some temporary memory and set up the stack,
+  the control is transferred to this function.
+
+  @param[in] Context    The first input parameter of InitializeDebugAgent().
+
+**/
+VOID
+EFIAPI
+SecStartupPhase2(
+  IN VOID                     *Context
+  );
+
+/**
+
+  Entry point to the C language phase of SEC. After the SEC assembly
+  code has initialized some temporary memory and set up the stack,
+  the control is transferred to this function.
+
+
+  @param SizeOfRam           Size of the temporary memory available for use.
+  @param TempRamBase         Base address of temporary ram
+  @param BootFirmwareVolume  Base address of the Boot Firmware Volume.
+**/
+VOID
+EFIAPI
+SecStartup (
+  IN UINT32                   SizeOfRam,
+  IN UINT32                   TempRamBase,
+  IN VOID                     *BootFirmwareVolume
+  )
+{
+  EFI_SEC_PEI_HAND_OFF        SecCoreData;
+  IA32_DESCRIPTOR             IdtDescriptor;
+  SEC_IDT_TABLE               IdtTableInStack;
+  UINT32                      Index;
+  UINT32                      PeiStackSize;
+  EFI_STATUS                  Status;
+
+  //
+  // Report Status Code to indicate entering SEC core
+  //
+  REPORT_STATUS_CODE (
+    EFI_PROGRESS_CODE,
+    EFI_SOFTWARE_SEC | EFI_SW_SEC_PC_ENTRY_POINT
+    );
+
+  PeiStackSize = PcdGet32 (PcdPeiTemporaryRamStackSize);
+  if (PeiStackSize == 0) {
+    PeiStackSize = (SizeOfRam >> 1);
+  }
+
+  ASSERT (PeiStackSize < SizeOfRam);
+
+  //
+  // Process all libraries constructor function linked to SecCore.
+  //
+  ProcessLibraryConstructorList ();
+
+  //
+  // Initialize floating point operating environment
+  // to be compliant with UEFI spec.
+  //
+  InitializeFloatingPointUnits ();
+
+  // |-------------------|---->
+  // |IDT Table          |
+  // |-------------------|
+  // |PeiService Pointer |    PeiStackSize
+  // |-------------------|
+  // |                   |
+  // |      Stack        |
+  // |-------------------|---->
+  // |                   |
+  // |                   |
+  // |      Heap         |    PeiTemporayRamSize
+  // |                   |
+  // |                   |
+  // |-------------------|---->  TempRamBase
+
+  IdtTableInStack.PeiService = 0;
+  for (Index = 0; Index < SEC_IDT_ENTRY_COUNT; Index ++) {
+    CopyMem ((VOID*)&IdtTableInStack.IdtTable[Index], (VOID*)&mIdtEntryTemplate, sizeof (UINT64));
+  }
+
+  IdtDescriptor.Base  = (UINTN) &IdtTableInStack.IdtTable;
+  IdtDescriptor.Limit = (UINT16)(sizeof (IdtTableInStack.IdtTable) - 1);
+
+  AsmWriteIdtr (&IdtDescriptor);
+
+  //
+  // Setup the default exception handlers
+  //
+  Status = InitializeCpuExceptionHandlers (NULL);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Update the base address and length of Pei temporary memory
+  //
+  SecCoreData.DataSize               = (UINT16) sizeof (EFI_SEC_PEI_HAND_OFF);
+  SecCoreData.BootFirmwareVolumeBase = BootFirmwareVolume;
+  SecCoreData.BootFirmwareVolumeSize = (UINTN)(0x100000000ULL - (UINTN) BootFirmwareVolume);
+  SecCoreData.TemporaryRamBase       = (VOID*)(UINTN) TempRamBase;
+  SecCoreData.TemporaryRamSize       = SizeOfRam;
+  SecCoreData.PeiTemporaryRamBase    = SecCoreData.TemporaryRamBase;
+  SecCoreData.PeiTemporaryRamSize    = SizeOfRam - PeiStackSize;
+  SecCoreData.StackBase              = (VOID*)(UINTN)(TempRamBase + SecCoreData.PeiTemporaryRamSize);
+  SecCoreData.StackSize              = PeiStackSize;
+
+  //
+  // Initialize Debug Agent to support source level debug in SEC/PEI phases before memory ready.
+  //
+  InitializeDebugAgent (DEBUG_AGENT_INIT_PREMEM_SEC, &SecCoreData, SecStartupPhase2);
+}
+
+/**
+  Caller provided function to be invoked at the end of InitializeDebugAgent().
+
+  Entry point to the C language phase of SEC. After the SEC assembly
+  code has initialized some temporary memory and set up the stack,
+  the control is transferred to this function.
+
+  @param[in] Context    The first input parameter of InitializeDebugAgent().
+
+**/
+VOID
+EFIAPI
+SecStartupPhase2(
+  IN VOID                     *Context
+  )
+{
+  EFI_SEC_PEI_HAND_OFF        *SecCoreData;
+  EFI_PEI_PPI_DESCRIPTOR      *PpiList;
+  UINT32                      Index;
+  EFI_PEI_PPI_DESCRIPTOR      *AllSecPpiList;
+  EFI_PEI_CORE_ENTRY_POINT    PeiCoreEntryPoint;
+
+  SecCoreData   = (EFI_SEC_PEI_HAND_OFF *) Context;
+  AllSecPpiList = (EFI_PEI_PPI_DESCRIPTOR *) SecCoreData->PeiTemporaryRamBase;
+  //
+  // Find Pei Core entry point. It will report SEC and Pei Core debug information if remote debug
+  // is enabled.
+  //
+  FindAndReportEntryPoints ((EFI_FIRMWARE_VOLUME_HEADER *) SecCoreData->BootFirmwareVolumeBase, &PeiCoreEntryPoint);
+  if (PeiCoreEntryPoint == NULL)
+  {
+    CpuDeadLoop ();
+  }
+
+  //
+  // Perform platform specific initialization before entering PeiCore.
+  //
+  PpiList = SecPlatformMain (SecCoreData);
+  if (PpiList != NULL) {
+    //
+    // Remove the terminal flag from the terminal PPI
+    //
+    CopyMem (AllSecPpiList, mPeiSecPlatformInformationPpi, sizeof (mPeiSecPlatformInformationPpi));
+    Index = sizeof (mPeiSecPlatformInformationPpi) / sizeof (EFI_PEI_PPI_DESCRIPTOR) - 1;
+    AllSecPpiList[Index].Flags = AllSecPpiList[Index].Flags & (~EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST);
+
+    //
+    // Append the platform additional PPI list
+    //
+    Index += 1;
+    while (((PpiList->Flags & EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST) != EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST)) {
+      CopyMem (&AllSecPpiList[Index], PpiList, sizeof (EFI_PEI_PPI_DESCRIPTOR));
+      Index++;
+      PpiList++;
+    }
+
+    //
+    // Add the terminal PPI
+    //
+    CopyMem (&AllSecPpiList[Index ++], PpiList, sizeof (EFI_PEI_PPI_DESCRIPTOR));
+
+    //
+    // Set PpiList to the total PPI
+    //
+    PpiList = AllSecPpiList;
+
+    //
+    // Adjust PEI TEMP RAM Range.
+    //
+    ASSERT (SecCoreData->PeiTemporaryRamSize > Index * sizeof (EFI_PEI_PPI_DESCRIPTOR));
+    SecCoreData->PeiTemporaryRamBase = (VOID *)((UINTN) SecCoreData->PeiTemporaryRamBase + Index * sizeof (EFI_PEI_PPI_DESCRIPTOR));
+    SecCoreData->PeiTemporaryRamSize = SecCoreData->PeiTemporaryRamSize - Index * sizeof (EFI_PEI_PPI_DESCRIPTOR);
+  } else {
+    //
+    // No addition PPI, PpiList directly point to the common PPI list.
+    //
+    PpiList = &mPeiSecPlatformInformationPpi[0];
+  }
+
+  //
+  // Report Status Code to indicate transferring to PEI core
+  //
+  REPORT_STATUS_CODE (
+    EFI_PROGRESS_CODE,
+    EFI_SOFTWARE_SEC | EFI_SW_SEC_PC_HANDOFF_TO_NEXT
+    );
+
+  //
+  // Transfer the control to the PEI core
+  //
+  ASSERT (PeiCoreEntryPoint != NULL);
+  (*PeiCoreEntryPoint) (SecCoreData, PpiList);
+
+  //
+  // Should not come here.
+  //
+  return;
+}
+
+/**
+  TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked
+  by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.
+
+  @retval EFI_SUCCESS           Use of Temporary RAM was disabled.
+  @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.
+
+**/
+EFI_STATUS
+EFIAPI
+SecTemporaryRamDone (
+  VOID
+  )
+{
+  BOOLEAN  State;
+
+  //
+  // Migrate DebugAgentContext.
+  //
+  InitializeDebugAgent (DEBUG_AGENT_INIT_POSTMEM_SEC, NULL, NULL);
+
+  //
+  // Disable interrupts and save current interrupt state
+  //
+  State = SaveAndDisableInterrupts();
+
+  //
+  // Disable Temporary RAM after Stack and Heap have been migrated at this point.
+  //
+  SecPlatformDisableTemporaryMemory ();
+
+  //
+  // Restore original interrupt state
+  //
+  SetInterruptState (State);
+
+  return EFI_SUCCESS;
+}
diff --git a/UefiCpuPkg/SecCore/SecMain.h b/UefiCpuPkg/SecCore/SecMain.h
new file mode 100644
index 000000000000..05175d299d6d
--- /dev/null
+++ b/UefiCpuPkg/SecCore/SecMain.h
@@ -0,0 +1,109 @@
+/** @file
+  Master header file for SecCore.
+
+  Copyright (c) 2008 - 2013, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SEC_CORE_H_
+#define _SEC_CORE_H_
+
+#include <PiPei.h>
+
+#include <Ppi/SecPlatformInformation.h>
+#include <Ppi/TemporaryRamDone.h>
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PcdLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PlatformSecLib.h>
+#include <Library/UefiCpuLib.h>
+#include <Library/PeCoffGetEntryPointLib.h>
+#include <Library/PeCoffExtraActionLib.h>
+#include <Library/DebugAgentLib.h>
+#include <Library/CpuExceptionHandlerLib.h>
+#include <Library/ReportStatusCodeLib.h>
+
+
+#define SEC_IDT_ENTRY_COUNT  34
+
+typedef struct _SEC_IDT_TABLE {
+  //
+  // Reserved 8 bytes preceding IDT to store EFI_PEI_SERVICES**, since IDT base
+  // address should be 8-byte alignment.
+  // Note: For IA32, only the 4 bytes immediately preceding IDT is used to store
+  // EFI_PEI_SERVICES**
+  //
+  UINT64            PeiService;
+  UINT64            IdtTable[SEC_IDT_ENTRY_COUNT];
+} SEC_IDT_TABLE;
+
+/**
+  TemporaryRamDone() disables the use of Temporary RAM. If present, this service is invoked
+  by the PEI Foundation after the EFI_PEI_PERMANANT_MEMORY_INSTALLED_PPI is installed.
+
+  @retval EFI_SUCCESS           Use of Temporary RAM was disabled.
+  @retval EFI_INVALID_PARAMETER Temporary RAM could not be disabled.
+
+**/
+EFI_STATUS
+EFIAPI
+SecTemporaryRamDone (
+  VOID
+  );
+
+/**
+  Entry point to the C language phase of SEC. After the SEC assembly
+  code has initialized some temporary memory and set up the stack,
+  the control is transferred to this function.
+
+  @param SizeOfRam           Size of the temporary memory available for use.
+  @param TempRamBase         Base address of temporary ram
+  @param BootFirmwareVolume  Base address of the Boot Firmware Volume.
+**/
+VOID
+EFIAPI
+SecStartup (
+  IN UINT32                   SizeOfRam,
+  IN UINT32                   TempRamBase,
+  IN VOID                     *BootFirmwareVolume
+  );
+
+/**
+  Find and return Pei Core entry point.
+
+  It also find SEC and PEI Core file debug information. It will report them if
+  remote debug is enabled.
+
+  @param  BootFirmwareVolumePtr  Point to the boot firmware volume.
+  @param  PeiCoreEntryPoint      Point to the PEI core entry point.
+
+**/
+VOID
+EFIAPI
+FindAndReportEntryPoints (
+  IN  EFI_FIRMWARE_VOLUME_HEADER       *BootFirmwareVolumePtr,
+  OUT EFI_PEI_CORE_ENTRY_POINT         *PeiCoreEntryPoint
+  );
+
+/**
+  Auto-generated function that calls the library constructors for all of the module's
+  dependent libraries.  This function must be called by the SEC Core once a stack has
+  been established.
+
+**/
+VOID
+EFIAPI
+ProcessLibraryConstructorList (
+  VOID
+  );
+
+#endif

From 5c5d01ab3c2be157f090745b17014f31ab6bf637 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:57:35 +0000
Subject: [PATCH 116/525] UefiCpuPkg: Add SecCore module and supporting library
 class and PCD

Add declaration of PlatformSecLib library class to DEC file
Add declaration of PcdPeiTemporaryRamStackSize PCD to DEC/UNI file
Add build of PlatformSecLibNull to DSC file
Add build of SecCore to DSC file

(Sync patch r18637 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18832 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.dec |   9 +++++++++
 UefiCpuPkg/UefiCpuPkg.dsc |   8 +++++++-
 UefiCpuPkg/UefiCpuPkg.uni | Bin 6628 -> 7222 bytes
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index 202e71990ffb..fe9b2a5f27cc 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -37,6 +37,11 @@
   ##  @libraryclass  Provides functions to manage the Local APIC on IA32 and X64 CPUs.
   ##
   LocalApicLib|Include/Library/LocalApicLib.h
+
+  ##  @libraryclass  Provides platform specific initialization functions in the SEC phase.
+  ##
+  PlatformSecLib|Include/Library/PlatformSecLib.h
+
   
 [Guids]
   gUefiCpuPkgTokenSpaceGuid      = { 0xac05bf33, 0x995a, 0x4ed4, { 0xaa, 0xb8, 0xef, 0x7a, 0xe8, 0xf, 0x5c, 0xb0 }}
@@ -62,6 +67,10 @@
   # @Prompt Configure stack size for Application Processor (AP)
   gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize|0x8000|UINT32|0x00000003
 
+  ## Specifies stack size in the temporary RAM. 0 means half of TemporaryRamSize.
+  # @Prompt Stack size in the temporary RAM.
+  gUefiCpuPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize|0|UINT32|0x10001003
+
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
   ## Specifies timeout value in microseconds for the BSP to detect all APs for the first time.
   # @Prompt Timeout for the BSP to detect all APs for the first time.
diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index a4117a2e85ad..68400e3cf8c8 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -54,8 +54,12 @@
   CpuExceptionHandlerLib|MdeModulePkg/Library/CpuExceptionHandlerLibNull/CpuExceptionHandlerLibNull.inf
   SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
   SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
+  PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
+  PeCoffExtraActionLib|MdePkg/Library/BasePeCoffExtraActionLibNull/BasePeCoffExtraActionLibNull.inf
 
-
+[LibraryClasses.common.SEC]
+  PlatformSecLib|UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
+  
 [LibraryClasses.common.PEIM]
   MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
   HobLib|MdePkg/Library/PeiHobLib/PeiHobLib.inf
@@ -96,7 +100,9 @@
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
+  UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
+  UefiCpuPkg/SecCore/SecCore.inf
   UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.inf
 
diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index 2f2d20f7fd87879dde9f9b1cd59a0503399a4a7c..4fe2faf981581025adcbbfd9829512e2328c889b 100644
GIT binary patch
delta 262
zcmaE2yv<_66UoVSVnMP245<v63?V==m!W_mpP`5$5r``pf`D}H<jwr<jKPx&1%)*g
zfU5Es6c|bvGJtA9G`bE2pdLpC-^m9hVhNafRKR(%fw;)z0zr`~qRnN{1KMf;#JND5
n6M=3i2C_4NtQ>|kAS)kC;_wGUFwpf?Kz(`)N({UVTwn|U`N%cl

delta 7
OcmdmH@x*w;6G;FMf&;Sv


From a6e7e7a74187c2890e069bc2aeef7da2e8eea986 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:58:22 +0000
Subject: [PATCH 117/525] UefiCpuPkg: Add SmmCpuFeaturesLib

Add SmmCpuFeaturesLib that provides CPU specific functions that are
used to initialize SMM and process SMIs.  A functional implementation
of this library class is provided that is based on the
Intel(R) 64 and IA-32 Architectures Software Developer's Manual

(Sync patch r18638 from main trunk.)

[jeff.fan@intel.com: Fix code style issues reported by ECC]
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18833 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Include/Library/SmmCpuFeaturesLib.h       | 366 ++++++++++++
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.c     | 562 ++++++++++++++++++
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf   |  39 ++
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni   | Bin 0 -> 1672 bytes
 4 files changed, 967 insertions(+)
 create mode 100644 UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
 create mode 100644 UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
 create mode 100644 UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
 create mode 100644 UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni

diff --git a/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h b/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
new file mode 100644
index 000000000000..d1c7a8ac965c
--- /dev/null
+++ b/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
@@ -0,0 +1,366 @@
+/** @file
+Library that provides CPU specific functions to support the PiSmmCpuDxeSmm module.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __SMM_FEATURES_LIB_H__
+#define __SMM_FEATURES_LIB_H__
+
+#include <Protocol/MpService.h>
+#include <Protocol/SmmCpu.h>
+#include <Register/SmramSaveStateMap.h>
+#include <CpuHotPlugData.h>
+
+///
+/// Enumeration of SMM registers that are accessed using the library functions
+/// SmmCpuFeaturesIsSmmRegisterSupported (), SmmCpuFeaturesGetSmmRegister (),
+/// and SmmCpuFeaturesSetSmmRegister ().
+///
+typedef enum {
+  ///
+  /// Read-write register to provides access to MSR_SMM_FEATURE_CONTROL if the
+  /// CPU supports this MSR.
+  ///
+  SmmRegFeatureControl,
+  ///
+  /// Read-only register that returns a non-zero value if the CPU is able to
+  /// respond to SMIs.
+  ///
+  SmmRegSmmEnable,
+  ///
+  /// Read-only register that returns a non-zero value if the CPU is able to
+  /// respond to SMIs, but is busy with other actions that are causing a delay
+  /// in responding to an SMI.  This register abstracts access to MSR_SMM_DELAYED
+  /// if the CPU supports this MSR.
+  ///
+  SmmRegSmmDelayed,
+  ///
+  /// Read-only register that returns a non-zero value if the CPU is able to
+  /// respond to SMIs, but is busy with other actions that are blocking its
+  /// ability to respond to an SMI.  This register abstracts access to
+  /// MSR_SMM_BLOCKED if the CPU supports this MSR.
+  ///
+  SmmRegSmmBlocked
+} SMM_REG_NAME;
+
+/**
+  Called during the very first SMI into System Management Mode to initialize
+  CPU features, including SMBASE, for the currently executing CPU.  Since this
+  is the first SMI, the SMRAM Save State Map is at the default address of
+  SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET.  The currently executing
+  CPU is specified by CpuIndex and CpuIndex can be used to access information
+  about the currently executing CPU in the ProcessorInfo array and the
+  HotPlugCpuData data structure.
+
+  @param[in] CpuIndex        The index of the CPU to initialize.  The value
+                             must be between 0 and the NumberOfCpus field in
+                             the System Management System Table (SMST).
+  @param[in] IsMonarch       TRUE if the CpuIndex is the index of the CPU that
+                             was elected as monarch during System Management
+                             Mode initialization.
+                             FALSE if the CpuIndex is not the index of the CPU
+                             that was elected as monarch during System
+                             Management Mode initialization.
+  @param[in] ProcessorInfo   Pointer to an array of EFI_PROCESSOR_INFORMATION
+                             structures.  ProcessorInfo[CpuIndex] contains the
+                             information for the currently executing CPU.
+  @param[in] CpuHotPlugData  Pointer to the CPU_HOT_PLUG_DATA structure that
+                             contains the ApidId and SmBase arrays.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesInitializeProcessor (
+  IN UINTN                      CpuIndex,
+  IN BOOLEAN                    IsMonarch,
+  IN EFI_PROCESSOR_INFORMATION  *ProcessorInfo,
+  IN CPU_HOT_PLUG_DATA          *CpuHotPlugData
+  );
+
+/**
+  This function updates the SMRAM save state on the currently executing CPU
+  to resume execution at a specific address after an RSM instruction.  This
+  function must evaluate the SMRAM save state to determine the execution mode
+  the RSM instruction resumes and update the resume execution address with
+  either NewInstructionPointer32 or NewInstructionPoint.  The auto HALT restart
+  flag in the SMRAM save state must always be cleared.  This function returns
+  the value of the instruction pointer from the SMRAM save state that was
+  replaced.  If this function returns 0, then the SMRAM save state was not
+  modified.
+
+  This function is called during the very first SMI on each CPU after
+  SmmCpuFeaturesInitializeProcessor() to set a flag in normal execution mode
+  to signal that the SMBASE of each CPU has been updated before the default
+  SMBASE address is used for the first SMI to the next CPU.
+
+  @param[in] CpuIndex                 The index of the CPU to hook.  The value
+                                      must be between 0 and the NumberOfCpus
+                                      field in the System Management System Table
+                                      (SMST).
+  @param[in] CpuState                 Pointer to SMRAM Save State Map for the
+                                      currently executing CPU.
+  @param[in] NewInstructionPointer32  Instruction pointer to use if resuming to
+                                      32-bit execution mode from 64-bit SMM.
+  @param[in] NewInstructionPointer    Instruction pointer to use if resuming to
+                                      same execution mode as SMM.
+
+  @retval 0    This function did modify the SMRAM save state.
+  @retval > 0  The original instruction pointer value from the SMRAM save state
+               before it was replaced.
+**/
+UINT64
+EFIAPI
+SmmCpuFeaturesHookReturnFromSmm (
+  IN UINTN                 CpuIndex,
+  IN SMRAM_SAVE_STATE_MAP  *CpuState,
+  IN UINT64                NewInstructionPointer32,
+  IN UINT64                NewInstructionPointer
+  );
+
+/**
+  Hook point in normal execution mode that allows the one CPU that was elected
+  as monarch during System Management Mode initialization to perform additional
+  initialization actions immediately after all of the CPUs have processed their
+  first SMI and called SmmCpuFeaturesInitializeProcessor() relocating SMBASE
+  into a buffer in SMRAM and called SmmCpuFeaturesHookReturnFromSmm().
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesSmmRelocationComplete (
+  VOID
+  );
+
+/**
+  Return the size, in bytes, of a custom SMI Handler in bytes.  If 0 is
+  returned, then a custom SMI handler is not provided by this library,
+  and the default SMI handler must be used.
+
+  @retval 0    Use the default SMI handler.
+  @retval > 0  Use the SMI handler installed by SmmCpuFeaturesInstallSmiHandler()
+               The caller is required to allocate enough SMRAM for each CPU to
+               support the size of the custom SMI handler.
+**/
+UINTN
+EFIAPI
+SmmCpuFeaturesGetSmiHandlerSize (
+  VOID
+  );
+
+/**
+  Install a custom SMI handler for the CPU specified by CpuIndex.  This function
+  is only called if SmmCpuFeaturesGetSmiHandlerSize() returns a size is greater
+  than zero and is called by the CPU that was elected as monarch during System
+  Management Mode initialization.
+
+  @param[in] CpuIndex   The index of the CPU to install the custom SMI handler.
+                        The value must be between 0 and the NumberOfCpus field
+                        in the System Management System Table (SMST).
+  @param[in] SmBase     The SMBASE address for the CPU specified by CpuIndex.
+  @param[in] SmiStack   The stack to use when an SMI is processed by the
+                        the CPU specified by CpuIndex.
+  @param[in] StackSize  The size, in bytes, if the stack used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtBase    The base address of the GDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtSize    The size, in bytes, of the GDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtBase    The base address of the IDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtSize    The size, in bytes, of the IDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] Cr3        The base address of the page tables to use when an SMI
+                        is processed by the CPU specified by CpuIndex.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesInstallSmiHandler (
+  IN UINTN   CpuIndex,
+  IN UINT32  SmBase,
+  IN VOID    *SmiStack,
+  IN UINTN   StackSize,
+  IN UINTN   GdtBase,
+  IN UINTN   GdtSize,
+  IN UINTN   IdtBase,
+  IN UINTN   IdtSize,
+  IN UINT32  Cr3
+  );
+
+/**
+  Determines if MTRR registers must be configured to set SMRAM cache-ability
+  when executing in System Management Mode.
+
+  @retval TRUE   MTRR registers must be configured to set SMRAM cache-ability.
+  @retval FALSE  MTRR registers do not need to be configured to set SMRAM
+                 cache-ability.
+**/
+BOOLEAN
+EFIAPI
+SmmCpuFeaturesNeedConfigureMtrrs (
+  VOID
+  );
+
+/**
+  Disable SMRR register if SMRR is supported and SmmCpuFeaturesNeedConfigureMtrrs()
+  returns TRUE.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesDisableSmrr (
+  VOID
+  );
+
+/**
+  Enable SMRR register if SMRR is supported and SmmCpuFeaturesNeedConfigureMtrrs()
+  returns TRUE.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesReenableSmrr (
+  VOID
+  );
+
+/**
+  Processor specific hook point each time a CPU enters System Management Mode.
+
+  @param[in] CpuIndex  The index of the CPU that has entered SMM.  The value
+                       must be between 0 and the NumberOfCpus field in the
+                       System Management System Table (SMST).
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesRendezvousEntry (
+  IN UINTN  CpuIndex
+  );
+
+/**
+  Processor specific hook point each time a CPU exits System Management Mode.
+
+  @param[in] CpuIndex  The index of the CPU that is exiting SMM.  The value must
+                       be between 0 and the NumberOfCpus field in the System
+                       Management System Table (SMST).
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesRendezvousExit (
+  IN UINTN  CpuIndex
+  );
+
+/**
+  Check to see if an SMM register is supported by a specified CPU.
+
+  @param[in] CpuIndex  The index of the CPU to check for SMM register support.
+                       The value must be between 0 and the NumberOfCpus field
+                       in the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to check for support.
+
+  @retval TRUE   The SMM register specified by RegName is supported by the CPU
+                 specified by CpuIndex.
+  @retval FALSE  The SMM register specified by RegName is not supported by the
+                 CPU specified by CpuIndex.
+**/
+BOOLEAN
+EFIAPI
+SmmCpuFeaturesIsSmmRegisterSupported (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName
+  );
+
+/**
+  Returns the current value of the SMM register for the specified CPU.
+  If the SMM register is not supported, then 0 is returned.
+
+  @param[in] CpuIndex  The index of the CPU to read the SMM register.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to read.
+
+  @return  The value of the SMM register specified by RegName from the CPU
+           specified by CpuIndex.
+**/
+UINT64
+EFIAPI
+SmmCpuFeaturesGetSmmRegister (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName
+  );
+
+/**
+  Sets the value of an SMM register on a specified CPU.
+  If the SMM register is not supported, then no action is performed.
+
+  @param[in] CpuIndex  The index of the CPU to write the SMM register.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to write.
+                       registers are read-only.
+  @param[in] Value     The value to write to the SMM register.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesSetSmmRegister (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName,
+  IN UINT64        Value
+  );
+
+/**
+  Read an SMM Save State register on the target processor.  If this function
+  returns EFI_UNSUPPORTED, then the caller is responsible for reading the
+  SMM Save Sate register.
+
+  @param[in]  CpuIndex  The index of the CPU to read the SMM Save State.  The
+                        value must be between 0 and the NumberOfCpus field in
+                        the System Management System Table (SMST).
+  @param[in]  Register  The SMM Save State register to read.
+  @param[in]  Width     The number of bytes to read from the CPU save state.
+  @param[out] Buffer    Upon return, this holds the CPU register value read
+                        from the save state.
+
+  @retval EFI_SUCCESS           The register was read from Save State.
+  @retval EFI_INVALID_PARAMTER  Buffer is NULL.
+  @retval EFI_UNSUPPORTED       This function does not support reading Register.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmCpuFeaturesReadSaveStateRegister (
+  IN  UINTN                        CpuIndex,
+  IN  EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN  UINTN                        Width,
+  OUT VOID                         *Buffer
+  );
+
+/**
+  Writes an SMM Save State register on the target processor.  If this function
+  returns EFI_UNSUPPORTED, then the caller is responsible for writing the
+  SMM Save Sate register.
+
+  @param[in] CpuIndex  The index of the CPU to write the SMM Save State.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] Register  The SMM Save State register to write.
+  @param[in] Width     The number of bytes to write to the CPU save state.
+  @param[in] Buffer    Upon entry, this holds the new CPU register value.
+
+  @retval EFI_SUCCESS           The register was written to Save State.
+  @retval EFI_INVALID_PARAMTER  Buffer is NULL.
+  @retval EFI_UNSUPPORTED       This function does not support writing Register.
+**/
+EFI_STATUS
+EFIAPI
+SmmCpuFeaturesWriteSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  IN CONST VOID                   *Buffer
+  );
+
+#endif
diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
new file mode 100644
index 000000000000..4f2f9b65fa37
--- /dev/null
+++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
@@ -0,0 +1,562 @@
+/** @file
+The CPU specific programming for PiSmmCpuDxeSmm module.
+
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiSmm.h>
+#include <Library/SmmCpuFeaturesLib.h>
+#include <Library/BaseLib.h>
+#include <Library/MtrrLib.h>
+#include <Library/PcdLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+#include <Register/Cpuid.h>
+#include <Register/SmramSaveStateMap.h>
+
+//
+// Machine Specific Registers (MSRs)
+//
+#define  SMM_FEATURES_LIB_IA32_MTRR_CAP            0x0FE
+#define  SMM_FEATURES_LIB_IA32_FEATURE_CONTROL     0x03A
+#define  SMM_FEATURES_LIB_IA32_SMRR_PHYSBASE       0x1F2
+#define  SMM_FEATURES_LIB_IA32_SMRR_PHYSMASK       0x1F3
+#define  SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSBASE  0x0A0
+#define  SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSMASK  0x0A1
+#define    EFI_MSR_SMRR_MASK                       0xFFFFF000
+#define    EFI_MSR_SMRR_PHYS_MASK_VALID            BIT11
+
+//
+// Set default value to assume SMRR is not supported
+//
+BOOLEAN  mSmrrSupported = FALSE;
+
+//
+// Set default value to assume IA-32 Architectural MSRs are used
+//
+UINT32  mSmrrPhysBaseMsr = SMM_FEATURES_LIB_IA32_SMRR_PHYSBASE;
+UINT32  mSmrrPhysMaskMsr = SMM_FEATURES_LIB_IA32_SMRR_PHYSMASK;
+
+//
+// Set default value to assume MTRRs need to be configured on each SMI
+//
+BOOLEAN  mNeedConfigureMtrrs = TRUE;
+
+//
+// Array for state of SMRR enable on all CPUs
+//
+BOOLEAN  *mSmrrEnabled;
+
+/**
+  The constructor function
+
+  @param[in]  ImageHandle  The firmware allocated handle for the EFI image.
+  @param[in]  SystemTable  A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS      The constructor always returns EFI_SUCCESS.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmCpuFeaturesLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  UINT32  RegEax;
+  UINT32  RegEdx;
+  UINTN   FamilyId;
+  UINTN   ModelId;
+
+  //
+  // Retrieve CPU Family and Model
+  //
+  AsmCpuid (CPUID_VERSION_INFO, &RegEax, NULL, NULL, &RegEdx);
+  FamilyId = (RegEax >> 8) & 0xf;
+  ModelId  = (RegEax >> 4) & 0xf;
+  if (FamilyId == 0x06 || FamilyId == 0x0f) {
+    ModelId = ModelId | ((RegEax >> 12) & 0xf0);
+  }
+
+  //
+  // Check CPUID(CPUID_VERSION_INFO).EDX[12] for MTRR capability
+  //
+  if ((RegEdx & BIT12) != 0) {
+    //
+    // Check MTRR_CAP MSR bit 11 for SMRR support
+    //
+    if ((AsmReadMsr64 (SMM_FEATURES_LIB_IA32_MTRR_CAP) & BIT11) != 0) {
+      mSmrrSupported = TRUE;
+    }
+  }
+
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 35.3 MSRs in the Intel(R) Atom(TM) Processor Family
+  //
+  // If CPU Family/Model is 06_1CH, 06_26H, 06_27H, 06_35H or 06_36H, then
+  // SMRR Physical Base and SMM Physical Mask MSRs are not available.
+  //
+  if (FamilyId == 0x06) {
+    if (ModelId == 0x1C || ModelId == 0x26 || ModelId == 0x27 || ModelId == 0x35 || ModelId == 0x36) {
+      mSmrrSupported = FALSE;
+    }
+  }
+
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 35.2 MSRs in the Intel(R) Core(TM) 2 Processor Family
+  //
+  // If CPU Family/Model is 06_0F or 06_17, then use Intel(R) Core(TM) 2
+  // Processor Family MSRs
+  //
+  if (FamilyId == 0x06) {
+    if (ModelId == 0x17 || ModelId == 0x0f) {
+      mSmrrPhysBaseMsr = SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSBASE;
+      mSmrrPhysMaskMsr = SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSMASK;
+    }
+  }
+
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 34.4.2 SMRAM Caching
+  //   An IA-32 processor does not automatically write back and invalidate its
+  //   caches before entering SMM or before exiting SMM. Because of this behavior,
+  //   care must be taken in the placement of the SMRAM in system memory and in
+  //   the caching of the SMRAM to prevent cache incoherence when switching back
+  //   and forth between SMM and protected mode operation.
+  //
+  // An IA-32 processor is a processor that does not support the Intel 64
+  // Architecture.  Support for the Intel 64 Architecture can be detected from
+  // CPUID(CPUID_EXTENDED_CPU_SIG).EDX[29]
+  //
+  // If an IA-32 processor is detected, then set mNeedConfigureMtrrs to TRUE,
+  // so caches are flushed on SMI entry and SMI exit, the interrupted code
+  // MTRRs are saved/restored, and MTRRs for SMM are loaded.
+  //
+  AsmCpuid (CPUID_EXTENDED_FUNCTION, &RegEax, NULL, NULL, NULL);
+  if (RegEax >= CPUID_EXTENDED_CPU_SIG) {
+    AsmCpuid (CPUID_EXTENDED_CPU_SIG, NULL, NULL, NULL, &RegEdx);
+    if ((RegEdx & BIT29) != 0) {
+      mNeedConfigureMtrrs = FALSE;
+    }
+  }
+
+  //
+  // Allocate array for state of SMRR enable on all CPUs
+  //
+  mSmrrEnabled = (BOOLEAN *)AllocatePool (sizeof (BOOLEAN) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+  ASSERT (mSmrrEnabled != NULL);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Called during the very first SMI into System Management Mode to initialize
+  CPU features, including SMBASE, for the currently executing CPU.  Since this
+  is the first SMI, the SMRAM Save State Map is at the default address of
+  SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET.  The currently executing
+  CPU is specified by CpuIndex and CpuIndex can be used to access information
+  about the currently executing CPU in the ProcessorInfo array and the
+  HotPlugCpuData data structure.
+
+  @param[in] CpuIndex        The index of the CPU to initialize.  The value
+                             must be between 0 and the NumberOfCpus field in
+                             the System Management System Table (SMST).
+  @param[in] IsMonarch       TRUE if the CpuIndex is the index of the CPU that
+                             was elected as monarch during System Management
+                             Mode initialization.
+                             FALSE if the CpuIndex is not the index of the CPU
+                             that was elected as monarch during System
+                             Management Mode initialization.
+  @param[in] ProcessorInfo   Pointer to an array of EFI_PROCESSOR_INFORMATION
+                             structures.  ProcessorInfo[CpuIndex] contains the
+                             information for the currently executing CPU.
+  @param[in] CpuHotPlugData  Pointer to the CPU_HOT_PLUG_DATA structure that
+                             contains the ApidId and SmBase arrays.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesInitializeProcessor (
+  IN UINTN                      CpuIndex,
+  IN BOOLEAN                    IsMonarch,
+  IN EFI_PROCESSOR_INFORMATION  *ProcessorInfo,
+  IN CPU_HOT_PLUG_DATA          *CpuHotPlugData
+  )
+{
+  SMRAM_SAVE_STATE_MAP  *CpuState;
+  UINT64                FeatureControl;
+
+  //
+  // Configure SMBASE.
+  //
+  CpuState = (SMRAM_SAVE_STATE_MAP *)(UINTN)(SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET);
+  CpuState->x86.SMBASE = (UINT32)CpuHotPlugData->SmBase[CpuIndex];
+
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 35.2 MSRs in the Intel(R) Core(TM) 2 Processor Family
+  //
+  // If Intel(R) Core(TM) Core(TM) 2 Processor Family MSRs are being used, then
+  // make sure SMRR Enable(BIT3) of MSR_FEATURE_CONTROL MSR(0x3A) is set before
+  // accessing SMRR base/mask MSRs.  If Lock(BIT0) of MSR_FEATURE_CONTROL MSR(0x3A)
+  // is set, then the MSR is locked and can not be modified.
+  //
+  if (mSmrrSupported && mSmrrPhysBaseMsr == SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSBASE) {
+    FeatureControl = AsmReadMsr64 (SMM_FEATURES_LIB_IA32_FEATURE_CONTROL);
+    if ((FeatureControl & BIT3) == 0) {
+      if ((FeatureControl & BIT0) == 0) {
+        AsmWriteMsr64 (SMM_FEATURES_LIB_IA32_FEATURE_CONTROL, FeatureControl | BIT3);
+      } else {
+        mSmrrSupported = FALSE;
+      }
+    }
+  }
+
+  //
+  // If SMRR is supported, then program SMRR base/mask MSRs.
+  // The EFI_MSR_SMRR_PHYS_MASK_VALID bit is not set until the first normal SMI.
+  // The code that initializes SMM environment is running in normal mode
+  // from SMRAM region.  If SMRR is enabled here, then the SMRAM region
+  // is protected and the normal mode code execution will fail.
+  //
+  if (mSmrrSupported) {
+    AsmWriteMsr64 (mSmrrPhysBaseMsr, CpuHotPlugData->SmrrBase | MTRR_CACHE_WRITE_BACK);
+    AsmWriteMsr64 (mSmrrPhysMaskMsr, (~(CpuHotPlugData->SmrrSize - 1) & EFI_MSR_SMRR_MASK));
+    mSmrrEnabled[CpuIndex] = FALSE;
+  }
+}
+
+/**
+  This function updates the SMRAM save state on the currently executing CPU
+  to resume execution at a specific address after an RSM instruction.  This
+  function must evaluate the SMRAM save state to determine the execution mode
+  the RSM instruction resumes and update the resume execution address with
+  either NewInstructionPointer32 or NewInstructionPoint.  The auto HALT restart
+  flag in the SMRAM save state must always be cleared.  This function returns
+  the value of the instruction pointer from the SMRAM save state that was
+  replaced.  If this function returns 0, then the SMRAM save state was not
+  modified.
+
+  This function is called during the very first SMI on each CPU after
+  SmmCpuFeaturesInitializeProcessor() to set a flag in normal execution mode
+  to signal that the SMBASE of each CPU has been updated before the default
+  SMBASE address is used for the first SMI to the next CPU.
+
+  @param[in] CpuIndex                 The index of the CPU to hook.  The value
+                                      must be between 0 and the NumberOfCpus
+                                      field in the System Management System Table
+                                      (SMST).
+  @param[in] CpuState                 Pointer to SMRAM Save State Map for the
+                                      currently executing CPU.
+  @param[in] NewInstructionPointer32  Instruction pointer to use if resuming to
+                                      32-bit execution mode from 64-bit SMM.
+  @param[in] NewInstructionPointer    Instruction pointer to use if resuming to
+                                      same execution mode as SMM.
+
+  @retval 0    This function did modify the SMRAM save state.
+  @retval > 0  The original instruction pointer value from the SMRAM save state
+               before it was replaced.
+**/
+UINT64
+EFIAPI
+SmmCpuFeaturesHookReturnFromSmm (
+  IN UINTN                 CpuIndex,
+  IN SMRAM_SAVE_STATE_MAP  *CpuState,
+  IN UINT64                NewInstructionPointer32,
+  IN UINT64                NewInstructionPointer
+  )
+{
+  return 0;
+}
+
+/**
+  Hook point in normal execution mode that allows the one CPU that was elected
+  as monarch during System Management Mode initialization to perform additional
+  initialization actions immediately after all of the CPUs have processed their
+  first SMI and called SmmCpuFeaturesInitializeProcessor() relocating SMBASE
+  into a buffer in SMRAM and called SmmCpuFeaturesHookReturnFromSmm().
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesSmmRelocationComplete (
+  VOID
+  )
+{
+}
+
+/**
+  Return the size, in bytes, of a custom SMI Handler in bytes.  If 0 is
+  returned, then a custom SMI handler is not provided by this library,
+  and the default SMI handler must be used.
+
+  @retval 0    Use the default SMI handler.
+  @retval > 0  Use the SMI handler installed by SmmCpuFeaturesInstallSmiHandler()
+               The caller is required to allocate enough SMRAM for each CPU to
+               support the size of the custom SMI handler.
+**/
+UINTN
+EFIAPI
+SmmCpuFeaturesGetSmiHandlerSize (
+  VOID
+  )
+{
+  return 0;
+}
+
+/**
+  Install a custom SMI handler for the CPU specified by CpuIndex.  This function
+  is only called if SmmCpuFeaturesGetSmiHandlerSize() returns a size is greater
+  than zero and is called by the CPU that was elected as monarch during System
+  Management Mode initialization.
+
+  @param[in] CpuIndex   The index of the CPU to install the custom SMI handler.
+                        The value must be between 0 and the NumberOfCpus field
+                        in the System Management System Table (SMST).
+  @param[in] SmBase     The SMBASE address for the CPU specified by CpuIndex.
+  @param[in] SmiStack   The stack to use when an SMI is processed by the
+                        the CPU specified by CpuIndex.
+  @param[in] StackSize  The size, in bytes, if the stack used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtBase    The base address of the GDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtSize    The size, in bytes, of the GDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtBase    The base address of the IDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtSize    The size, in bytes, of the IDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] Cr3        The base address of the page tables to use when an SMI
+                        is processed by the CPU specified by CpuIndex.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesInstallSmiHandler (
+  IN UINTN   CpuIndex,
+  IN UINT32  SmBase,
+  IN VOID    *SmiStack,
+  IN UINTN   StackSize,
+  IN UINTN   GdtBase,
+  IN UINTN   GdtSize,
+  IN UINTN   IdtBase,
+  IN UINTN   IdtSize,
+  IN UINT32  Cr3
+  )
+{
+}
+
+/**
+  Determines if MTRR registers must be configured to set SMRAM cache-ability
+  when executing in System Management Mode.
+
+  @retval TRUE   MTRR registers must be configured to set SMRAM cache-ability.
+  @retval FALSE  MTRR registers do not need to be configured to set SMRAM
+                 cache-ability.
+**/
+BOOLEAN
+EFIAPI
+SmmCpuFeaturesNeedConfigureMtrrs (
+  VOID
+  )
+{
+  return mNeedConfigureMtrrs;
+}
+
+/**
+  Disable SMRR register if SMRR is supported and SmmCpuFeaturesNeedConfigureMtrrs()
+  returns TRUE.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesDisableSmrr (
+  VOID
+  )
+{
+  if (mSmrrSupported && mNeedConfigureMtrrs) {
+    AsmWriteMsr64 (mSmrrPhysMaskMsr, AsmReadMsr64(mSmrrPhysMaskMsr) & ~EFI_MSR_SMRR_PHYS_MASK_VALID);
+  }
+}
+
+/**
+  Enable SMRR register if SMRR is supported and SmmCpuFeaturesNeedConfigureMtrrs()
+  returns TRUE.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesReenableSmrr (
+  VOID
+  )
+{
+  if (mSmrrSupported && mNeedConfigureMtrrs) {
+    AsmWriteMsr64 (mSmrrPhysMaskMsr, AsmReadMsr64(mSmrrPhysMaskMsr) | EFI_MSR_SMRR_PHYS_MASK_VALID);
+  }
+}
+
+/**
+  Processor specific hook point each time a CPU enters System Management Mode.
+
+  @param[in] CpuIndex  The index of the CPU that has entered SMM.  The value
+                       must be between 0 and the NumberOfCpus field in the
+                       System Management System Table (SMST).
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesRendezvousEntry (
+  IN UINTN  CpuIndex
+  )
+{
+  //
+  // If SMRR is supported and this is the first normal SMI, then enable SMRR
+  //
+  if (mSmrrSupported && !mSmrrEnabled[CpuIndex]) {
+    AsmWriteMsr64 (mSmrrPhysMaskMsr, AsmReadMsr64 (mSmrrPhysMaskMsr) | EFI_MSR_SMRR_PHYS_MASK_VALID);
+    mSmrrEnabled[CpuIndex] = TRUE;
+  }
+}
+
+/**
+  Processor specific hook point each time a CPU exits System Management Mode.
+
+  @param[in] CpuIndex  The index of the CPU that is exiting SMM.  The value must
+                       be between 0 and the NumberOfCpus field in the System
+                       Management System Table (SMST).
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesRendezvousExit (
+  IN UINTN  CpuIndex
+  )
+{
+}
+
+/**
+  Check to see if an SMM register is supported by a specified CPU.
+
+  @param[in] CpuIndex  The index of the CPU to check for SMM register support.
+                       The value must be between 0 and the NumberOfCpus field
+                       in the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to check for support.
+
+  @retval TRUE   The SMM register specified by RegName is supported by the CPU
+                 specified by CpuIndex.
+  @retval FALSE  The SMM register specified by RegName is not supported by the
+                 CPU specified by CpuIndex.
+**/
+BOOLEAN
+EFIAPI
+SmmCpuFeaturesIsSmmRegisterSupported (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName
+  )
+{
+  return FALSE;
+}
+
+/**
+  Returns the current value of the SMM register for the specified CPU.
+  If the SMM register is not supported, then 0 is returned.
+
+  @param[in] CpuIndex  The index of the CPU to read the SMM register.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to read.
+
+  @return  The value of the SMM register specified by RegName from the CPU
+           specified by CpuIndex.
+**/
+UINT64
+EFIAPI
+SmmCpuFeaturesGetSmmRegister (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName
+  )
+{
+  return 0;
+}
+
+/**
+  Sets the value of an SMM register on a specified CPU.
+  If the SMM register is not supported, then no action is performed.
+
+  @param[in] CpuIndex  The index of the CPU to write the SMM register.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] RegName   Identifies the SMM register to write.
+                       registers are read-only.
+  @param[in] Value     The value to write to the SMM register.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesSetSmmRegister (
+  IN UINTN         CpuIndex,
+  IN SMM_REG_NAME  RegName,
+  IN UINT64        Value
+  )
+{
+}
+
+/**
+  Read an SMM Save State register on the target processor.  If this function
+  returns EFI_UNSUPPORTED, then the caller is responsible for reading the
+  SMM Save Sate register.
+
+  @param[in]  CpuIndex  The index of the CPU to read the SMM Save State.  The
+                        value must be between 0 and the NumberOfCpus field in
+                        the System Management System Table (SMST).
+  @param[in]  Register  The SMM Save State register to read.
+  @param[in]  Width     The number of bytes to read from the CPU save state.
+  @param[out] Buffer    Upon return, this holds the CPU register value read
+                        from the save state.
+
+  @retval EFI_SUCCESS           The register was read from Save State.
+  @retval EFI_INVALID_PARAMTER  Buffer is NULL.
+  @retval EFI_UNSUPPORTED       This function does not support reading Register.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmCpuFeaturesReadSaveStateRegister (
+  IN  UINTN                        CpuIndex,
+  IN  EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN  UINTN                        Width,
+  OUT VOID                         *Buffer
+  )
+{
+  return EFI_UNSUPPORTED;
+}
+
+/**
+  Writes an SMM Save State register on the target processor.  If this function
+  returns EFI_UNSUPPORTED, then the caller is responsible for writing the
+  SMM Save Sate register.
+
+  @param[in] CpuIndex  The index of the CPU to write the SMM Save State.  The
+                       value must be between 0 and the NumberOfCpus field in
+                       the System Management System Table (SMST).
+  @param[in] Register  The SMM Save State register to write.
+  @param[in] Width     The number of bytes to write to the CPU save state.
+  @param[in] Buffer    Upon entry, this holds the new CPU register value.
+
+  @retval EFI_SUCCESS           The register was written to Save State.
+  @retval EFI_INVALID_PARAMTER  Buffer is NULL.
+  @retval EFI_UNSUPPORTED       This function does not support writing Register.
+**/
+EFI_STATUS
+EFIAPI
+SmmCpuFeaturesWriteSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  IN CONST VOID                   *Buffer
+  )
+{
+  return EFI_UNSUPPORTED;
+}
diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
new file mode 100644
index 000000000000..1735062b17e3
--- /dev/null
+++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
@@ -0,0 +1,39 @@
+## @file
+#  The CPU specific programming for PiSmmCpuDxeSmm module.
+#
+#  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SmmCpuFeaturesLib
+  MODULE_UNI_FILE                = SmmCpuFeaturesLib.uni
+  FILE_GUID                      = FC3DC10D-D271-422a-AFF3-CBCF70344431
+  MODULE_TYPE                    = DXE_SMM_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = SmmCpuFeaturesLib
+  CONSTRUCTOR                    = SmmCpuFeaturesLibConstructor
+
+[Sources]
+  SmmCpuFeaturesLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
+
+[LibraryClasses]
+  BaseLib
+  PcdLib
+  MemoryAllocationLib
+  DebugLib
+
+[Pcd]
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber        ## SOMETIMES_CONSUMES
diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni
new file mode 100644
index 0000000000000000000000000000000000000000..594062cd0bace29214e055fe8453f214cefff6bf
GIT binary patch
literal 1672
zcmd6n&2Q5{5XI+=#Q(5LFM!$vkT`%4A|D1UppKeEz^QVaw6WxT$Vs66=YikbZR{or
z2QCO%-rbp<ee>q+*uQ?ZtYwb(36Hb4c4fI0HnoTL0I&9jHp6z-wZ4s**S5mWh*NBa
zXJw@=?V2&QIZtj2EXV#5pW|F^1HaQHc56Mm0U>xC{-sUuDr>XKTj%exzp`79a!_Zs
z0r3%eA2UC<r#vrNo!wc_?1i1Oj^VHYv0yEP5)6$g-kjBfT+Z6;E273;duvLSQ@r09
zCq%xsj$PQBBkZJ3PV}J)j!X;AI`RemQaER1p2I|Yx10+)%{?pS%UKnm)zznXrGCL)
z#%kf233rFD(-R+)!Z#(ZU>q~*+}5)YcFjb(l<*Mi9g3KVZ(ix6-6eNepX+dEJ?u|=
zTxzaAycQXwaQCat$tgss5%f~7HMXiA!}I>V)LnPwJ41IQ);ElYtoD^rKc#5vz*PO}
z!JvUSZSE<nPTFu6uY8}Y$AY?wFTK`H&X)9C>p=ZAo-y1fblraTCMYxBohG|k^?a}h
zK7INqvG<H^`-~l<sY6xGL%cDaHewZdrAKzo9O17K>RX8E?1+egM^0F&qct{|g)7ts
zbI04VPAhKCzOXM|iO(pzO(ror#~*_#jKpWZz!G=)lygXwVw5#Ry(3m9zcGJgN6hsl
zMt5046_I_daBB1zE&BA8a`uk?1@wPvdG6Bmr0SgT1qJOcK}k420x7af*hnj>+D54%
wT>kW&_-{s7Te{@hcaFN@3@ov1aQa{V1si`^sd{8Ujq0C%buY)N{XZ-H4N)co@c;k-

literal 0
HcmV?d00001


From afc8be03f21338f32a30a34c08959c0c58ee5641 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 04:59:32 +0000
Subject: [PATCH 118/525] UefiCpuPkg: Add SmmCpuPlatformHookLib

Add SmmCpuPlatformHookLib that provides platform specific functions
that are used to initialize SMM and process SMIs.  A Null instance
of this library is provided that should work for most platforms.

(Sync patch r18639 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18834 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Include/Library/SmmCpuPlatformHookLib.h   | 109 ++++++++++++++++++
 .../SmmCpuPlatformHookLibNull.c               | 108 +++++++++++++++++
 .../SmmCpuPlatformHookLibNull.inf             |  40 +++++++
 .../SmmCpuPlatformHookLibNull.uni             | Bin 0 -> 1604 bytes
 4 files changed, 257 insertions(+)
 create mode 100644 UefiCpuPkg/Include/Library/SmmCpuPlatformHookLib.h
 create mode 100644 UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.c
 create mode 100644 UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
 create mode 100644 UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.uni

diff --git a/UefiCpuPkg/Include/Library/SmmCpuPlatformHookLib.h b/UefiCpuPkg/Include/Library/SmmCpuPlatformHookLib.h
new file mode 100644
index 000000000000..e40084edf91a
--- /dev/null
+++ b/UefiCpuPkg/Include/Library/SmmCpuPlatformHookLib.h
@@ -0,0 +1,109 @@
+/** @file
+  Public include file for the SMM CPU Platform Hook Library.
+
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __SMM_CPU_PLATFORM_HOOK_LIB_H__
+#define __SMM_CPU_PLATFORM_HOOK_LIB_H__
+
+///
+/// SMM Page Size Type
+///
+typedef enum {
+    SmmPageSize4K,
+    SmmPageSize2M,
+    SmmPageSize1G,
+    MaxSmmPageSizeType
+} SMM_PAGE_SIZE_TYPE;
+
+/**
+  Checks if platform produces a valid SMI.
+
+  This function checks if platform produces a valid SMI. This function is
+  called at SMM entry to detect if this is a spurious SMI. This function
+  must be implemented in an MP safe way because it is called by multiple CPU
+  threads.
+
+  @retval TRUE              There is a valid SMI
+  @retval FALSE             There is no valid SMI
+
+**/
+BOOLEAN
+EFIAPI
+PlatformValidSmi (
+  VOID
+  );
+
+/**
+  Clears platform top level SMI status bit.
+
+  This function clears platform top level SMI status bit.
+
+  @retval TRUE              The platform top level SMI status is cleared.
+  @retval FALSE             The platform top level SMI status cannot be cleared.
+
+**/
+BOOLEAN
+EFIAPI
+ClearTopLevelSmiStatus (
+  VOID
+  );
+
+/**
+  Performs platform specific way of SMM BSP election.
+
+  This function performs platform specific way of SMM BSP election.
+
+  @param  IsBsp             Output parameter. TRUE: the CPU this function executes
+                            on is elected to be the SMM BSP. FALSE: the CPU this
+                            function executes on is to be SMM AP.
+
+  @retval EFI_SUCCESS       The function executes successfully.
+  @retval EFI_NOT_READY     The function does not determine whether this CPU should be
+                            BSP or AP. This may occur if hardware init sequence to
+                            enable the determination is yet to be done, or the function
+                            chooses not to do BSP election and will let SMM CPU driver to
+                            use its default BSP election process.
+  @retval EFI_DEVICE_ERROR  The function cannot determine whether this CPU should be
+                            BSP or AP due to hardware error.
+
+**/
+EFI_STATUS
+EFIAPI
+PlatformSmmBspElection (
+  OUT BOOLEAN     *IsBsp
+  );
+
+/**
+  Get platform page table attribute .
+
+  This function gets page table attribute of platform.
+
+  @param  Address        Input parameter. Obtain the page table entries attribute on this address.
+  @param  PageSize       Output parameter. The size of the page.
+  @param  NumOfPages     Output parameter. Number of page.
+  @param  PageAttribute  Output parameter. Paging Attributes (WB, UC, etc).
+
+  @retval EFI_SUCCESS      The platform page table attribute from the address is determined.
+  @retval EFI_UNSUPPORTED  The platform does not support getting page table attribute for the address.
+
+**/
+EFI_STATUS
+EFIAPI
+GetPlatformPageTableAttribute (
+  IN  UINT64                Address,
+  OUT SMM_PAGE_SIZE_TYPE    *PageSize,
+  OUT UINTN                 *NumOfPages,
+  OUT UINTN                 *PageAttribute
+  );
+
+#endif
diff --git a/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.c b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.c
new file mode 100644
index 000000000000..efb61fa6f8c2
--- /dev/null
+++ b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.c
@@ -0,0 +1,108 @@
+/** @file
+SMM CPU Platform Hook NULL library instance.
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#include <PiSmm.h>
+#include <Library/SmmCpuPlatformHookLib.h>
+
+/**
+  Checks if platform produces a valid SMI.
+
+  This function checks if platform produces a valid SMI. This function is
+  called at SMM entry to detect if this is a spurious SMI. This function
+  must be implemented in an MP safe way because it is called by multiple CPU
+  threads.
+
+  @retval TRUE              There is a valid SMI
+  @retval FALSE             There is no valid SMI
+
+**/
+BOOLEAN
+EFIAPI
+PlatformValidSmi (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Clears platform top level SMI status bit.
+
+  This function clears platform top level SMI status bit.
+
+  @retval TRUE              The platform top level SMI status is cleared.
+  @retval FALSE             The platform top level SMI status cannot be cleared.
+
+**/
+BOOLEAN
+EFIAPI
+ClearTopLevelSmiStatus (
+  VOID
+  )
+{
+  return TRUE;
+}
+
+/**
+  Performs platform specific way of SMM BSP election.
+
+  This function performs platform specific way of SMM BSP election.
+
+  @param  IsBsp             Output parameter. TRUE: the CPU this function executes
+                            on is elected to be the SMM BSP. FALSE: the CPU this
+                            function executes on is to be SMM AP.
+
+  @retval EFI_SUCCESS       The function executes successfully.
+  @retval EFI_NOT_READY     The function does not determine whether this CPU should be
+                            BSP or AP. This may occur if hardware init sequence to
+                            enable the determination is yet to be done, or the function
+                            chooses not to do BSP election and will let SMM CPU driver to
+                            use its default BSP election process.
+  @retval EFI_DEVICE_ERROR  The function cannot determine whether this CPU should be
+                            BSP or AP due to hardware error.
+
+**/
+EFI_STATUS
+EFIAPI
+PlatformSmmBspElection (
+  OUT BOOLEAN     *IsBsp
+  )
+{
+  return EFI_NOT_READY;
+}
+
+/**
+  Get platform page table attribute.
+
+  This function gets page table attribute of platform.
+
+  @param  Address        Input parameter. Obtain the page table entries attribute on this address.
+  @param  PageSize       Output parameter. The size of the page.
+  @param  NumOfPages     Output parameter. Number of page.
+  @param  PageAttribute  Output parameter. Paging Attributes (WB, UC, etc).
+
+  @retval EFI_SUCCESS      The platform page table attribute from the address is determined.
+  @retval EFI_UNSUPPORTED  The platform does not support getting page table attribute for the address.
+
+**/
+EFI_STATUS
+EFIAPI
+GetPlatformPageTableAttribute (
+  IN  UINT64                Address,
+  IN OUT SMM_PAGE_SIZE_TYPE *PageSize,
+  IN OUT UINTN              *NumOfPages,
+  IN OUT UINTN              *PageAttribute
+  )
+{
+  return EFI_UNSUPPORTED;
+}
diff --git a/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
new file mode 100644
index 000000000000..4dea5fb4e1e3
--- /dev/null
+++ b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
@@ -0,0 +1,40 @@
+## @file
+#  SMM CPU Platform Hook NULL library instance.
+#
+#  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+################################################################################
+#
+# Defines Section - statements that will be processed to create a Makefile.
+#
+################################################################################
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SmmCpuPlatformHookLibNull
+  MODULE_UNI_FILE                = SmmCpuPlatformHookLibNull.uni
+  FILE_GUID                      = D6494E1B-E06F-4ab5-B64D-48B25AA9EB33
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = SmmCpuPlatformHookLib
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  SmmCpuPlatformHookLibNull.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
diff --git a/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.uni b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.uni
new file mode 100644
index 0000000000000000000000000000000000000000..9935934a35273bab9d569804e73a1f1326a1bee2
GIT binary patch
literal 1604
zcmc(fOK;Oq5QS%r#DBO-H-Op%kYIrj!f6b(D7BS`fE98cO)b*6a@<1yJn)@s$8M^y
zV1bb3`<l6D&YT(h*Uz5y%<(?qarV~EEwhy^?4dp2RJM_Q<Z*UviA|Uj?5UM_=2qAx
zCnv0O`^M@Fk5e9pPi9l>Deo=&%+|KyR?0jBzuQD;BOQZsg?EAX(k}3J_6YCC%+Kv9
z&r4QE_3oLyutU}nh$V<C)<P)2&?t@>t2MEl1=!`$VsHFz0jmY4H;i*UUt8aX_GS;e
zF^n?29ry*fOCLk|E2lYgiO0h4XRyxE=E~b{efCQ%m!6g4Wvo`9wb@H4-Ij7vNP3A=
zi?7@BI>HTWRVqbg)yvtnXCdsCiF8qo#Cpq8%)~cq^pQ2Ep6$IpRUfcF-Qm)5{qD7x
zF$#A#+l-h(lp2*@ily2s>nS|%*2S5075{TARgJ{@2VVDC?J85Lsot8__w!l<aVqa9
zt4=DZ#Vg;@>aj{)`4?X6F8LQ!w0BSa4JT8$&*{3|=v`1Qc(<BtXXSHZA*>SmD7N>E
zf&YFYG<B$|dCX}<r%hOeUg-(n&Vcn0pDjXLg^11$@fdmJn3XzOV~1I|LhUg3{a(An
zhMTib*o7MVh}s8460<YTBT$7A`{+Y<;;u8r9OES)MXkKv;j5cpm_J|<bA5?n9i_@5
zw9gGriyomxLSHH7VDDc*f1;k}E=>=b&RJ6*{f(sES5RW^>u(dX3&^{&1SmDe?@!MG
vb<~%zr1mMJI#1nj1eREK82`opuJe}}sTW4%qCQC){r6?{zcT8gl`8Zb&D-?w

literal 0
HcmV?d00001


From 90811cf59dad0d0b33c597a8987091ba327e4cce Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:00:16 +0000
Subject: [PATCH 119/525] UefiCpuPkg: Add SMM CPU Service Protocol

Add definition of the SMM CPU Service Protocol that is produced by
the PiSmmCpuDxeSmm module.

(Sync patch r18640 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18835 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Protocol/SmmCpuService.h | 209 ++++++++++++++++++++
 1 file changed, 209 insertions(+)
 create mode 100644 UefiCpuPkg/Include/Protocol/SmmCpuService.h

diff --git a/UefiCpuPkg/Include/Protocol/SmmCpuService.h b/UefiCpuPkg/Include/Protocol/SmmCpuService.h
new file mode 100644
index 000000000000..9aced54f4d6f
--- /dev/null
+++ b/UefiCpuPkg/Include/Protocol/SmmCpuService.h
@@ -0,0 +1,209 @@
+/** @file
+SMM CPU Service protocol definition.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_CPU_SERVICE_PROTOCOL_H_
+#define _SMM_CPU_SERVICE_PROTOCOL_H_
+
+//
+// Share some definitions with MP Services and CPU Arch Protocol
+//
+#include <Protocol/MpService.h>
+#include <Protocol/Cpu.h>
+
+#define EFI_SMM_CPU_SERVICE_PROTOCOL_GUID \
+  { \
+    0x1d202cab, 0xc8ab, 0x4d5c, { 0x94, 0xf7, 0x3c, 0xfc, 0xc0, 0xd3, 0xd3, 0x35 } \
+  }
+
+typedef struct _EFI_SMM_CPU_SERVICE_PROTOCOL EFI_SMM_CPU_SERVICE_PROTOCOL;
+
+//
+// Protocol functions
+//
+
+/**
+  Gets processor information on the requested processor at the
+  instant this call is made. This service may only be called from the BSP.
+
+  @param[in]  This                  A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL
+                                    instance.
+  @param[in]  ProcessorNumber       The handle number of processor.
+  @param[out] ProcessorInfoBuffer   A pointer to the buffer where information for
+                                    the requested processor is deposited.
+
+  @retval EFI_SUCCESS             Processor information was returned.
+  @retval EFI_DEVICE_ERROR        The calling processor is an AP.
+  @retval EFI_INVALID_PARAMETER   ProcessorInfoBuffer is NULL.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by
+                                  ProcessorNumber does not exist in the platform.
+**/
+typedef
+EFI_STATUS
+(EFIAPI * EFI_SMM_GET_PROCESSOR_INFO) (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber,
+  OUT      EFI_PROCESSOR_INFORMATION    *ProcessorInfoBuffer
+  );
+
+/**
+  This service switches the requested AP to be the BSP from that point onward.
+  This service changes the BSP for all purposes.   This call can only be performed
+  by the current BSP.
+
+  This service switches the requested AP to be the BSP from that point onward.
+  This service changes the BSP for all purposes. The new BSP can take over the
+  execution of the old BSP and continue seamlessly from where the old one left
+  off.
+
+  If the BSP cannot be switched prior to the return from this service, then
+  EFI_UNSUPPORTED must be returned.
+
+  @param[in] This              A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber   The handle number of AP that is to become the new
+                               BSP. The range is from 0 to the total number of
+                               logical processors minus 1.
+
+  @retval EFI_SUCCESS             BSP successfully switched.
+  @retval EFI_UNSUPPORTED         Switching the BSP cannot be completed prior to
+                                  this service returning.
+  @retval EFI_UNSUPPORTED         Switching the BSP is not supported.
+  @retval EFI_SUCCESS             The calling processor is an AP.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by
+                                  ProcessorNumber does not exist.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber specifies the current BSP or
+                                  a disabled AP.
+  @retval EFI_NOT_READY           The specified AP is busy.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI * EFI_SMM_SWITCH_BSP) (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber
+  );
+
+/**
+  Notify that a new processor has been added to the system.
+
+  The SMM CPU driver should add the processor to the SMM CPU list.
+
+  If the processor is disabled it won't participate any SMI handler during subsequent SMIs.
+
+  @param  This                      A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param  ProcessorId               The hardware ID of the processor.
+  @param  ProcessorNumber           The handle number of processor.
+  @param  ProcessorResource         A pointer to EFI_SMM_PROCESSOR_RESOURCE which holds the assigned resources.
+
+  @retval EFI_SUCCESS          The function completed successfully.
+  @retval EFI_ALREADY_STARTED  Processor already present.
+  @retval EFI_NOT_READY        Space for a new handle could not be allocated.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI *EFI_SMM_ADD_PROCESSOR) (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINT64                        ProcessorId,
+  OUT      UINTN                         *ProcessorNumber
+  );
+
+/**
+  Notify that a processor is hot-removed.
+
+  Remove a processor from the CPU list of the SMM CPU driver. After this API is called, the removed processor
+  must not respond to SMIs in the coherence domain.
+
+  @param  This                 A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param  ProcessorId          The hardware ID of the processor.
+
+  @retval EFI_SUCCESS          The function completed successfully.
+  @retval EFI_NOT_FOUND        Processor with the hardware ID specified by ProcessorId does not exist.
+  @retval EFI_NOT_READY        Specified AP is busy.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI *EFI_SMM_REMOVE_PROCESSOR) (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINTN                         ProcessorNumber
+  );
+
+/**
+  This return the handle number for the calling processor.  This service may be
+  called from the BSP and APs.
+
+  This service returns the processor handle number for the calling processor.
+  The returned value is in the range from 0 to the total number of logical
+  processors minus 1. This service may be called from the BSP and APs.
+  If ProcessorNumber is NULL, then EFI_INVALID_PARAMETER
+  is returned. Otherwise, the current processors handle number is returned in
+  ProcessorNumber, and EFI_SUCCESS is returned.
+
+  @param[in] This              A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber   The handle number of AP that is to become the new
+                               BSP. The range is from 0 to the total number of
+                               logical processors minus 1.
+
+  @retval EFI_SUCCESS             The current processor handle number was returned
+                                  in ProcessorNumber.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is NULL.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI * EFI_SMM_WHOAMI) (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  OUT      UINTN                        *ProcessorNumber
+  );
+
+/**
+  Register exception handler.
+
+  @param  This                  A pointer to the SMM_CPU_SERVICE_PROTOCOL instance.
+  @param  ExceptionType         Defines which interrupt or exception to hook. Type EFI_EXCEPTION_TYPE and
+                                the valid values for this parameter are defined in EFI_DEBUG_SUPPORT_PROTOCOL
+                                of the UEFI 2.0 specification.
+  @param  InterruptHandler      A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER
+                                that is called when a processor interrupt occurs.
+                                If this parameter is NULL, then the handler will be uninstalled.
+
+  @retval EFI_SUCCESS           The handler for the processor interrupt was successfully installed or uninstalled.
+  @retval EFI_ALREADY_STARTED   InterruptHandler is not NULL, and a handler for InterruptType was previously installed.
+  @retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not previously installed.
+  @retval EFI_UNSUPPORTED       The interrupt specified by InterruptType is not supported.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI *EFI_SMM_REGISTER_EXCEPTION_HANDLER) (
+  IN EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN EFI_EXCEPTION_TYPE            ExceptionType,
+  IN EFI_CPU_INTERRUPT_HANDLER     InterruptHandler
+  );
+
+//
+//  This protocol provides CPU services from SMM.
+//
+struct _EFI_SMM_CPU_SERVICE_PROTOCOL {
+  EFI_SMM_GET_PROCESSOR_INFO          GetProcessorInfo;
+  EFI_SMM_SWITCH_BSP                  SwitchBsp;
+  EFI_SMM_ADD_PROCESSOR               AddProcessor;
+  EFI_SMM_REMOVE_PROCESSOR            RemoveProcessor;
+  EFI_SMM_WHOAMI                      WhoAmI;
+  EFI_SMM_REGISTER_EXCEPTION_HANDLER  RegisterExceptionHandler;
+};
+
+extern EFI_GUID gEfiSmmCpuServiceProtocolGuid;
+
+#endif

From 3f509e3056409219dbffa6a802d4c163ec40f2f9 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:00:55 +0000
Subject: [PATCH 120/525] UefiCpuPkg: Add SMRAM Save State include file

Add SmramSaveStateMap.h file that defines the 32-bit and 64-bit CPU
SMRAM Save State Map.

(Sync patch r18641 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18836 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Include/Register/SmramSaveStateMap.h      | 190 ++++++++++++++++++
 1 file changed, 190 insertions(+)
 create mode 100644 UefiCpuPkg/Include/Register/SmramSaveStateMap.h

diff --git a/UefiCpuPkg/Include/Register/SmramSaveStateMap.h b/UefiCpuPkg/Include/Register/SmramSaveStateMap.h
new file mode 100644
index 000000000000..a7c7562df8e8
--- /dev/null
+++ b/UefiCpuPkg/Include/Register/SmramSaveStateMap.h
@@ -0,0 +1,190 @@
+/** @file
+SMRAM Save State Map Definitions.
+
+SMRAM Save State Map definitions based on contents of the
+Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  Volume 3C, Section 34.4 SMRAM
+  Volume 3C, Section 34.5 SMI Handler Execution Environment
+  Volume 3C, Section 34.7 Managing Synchronous and Asynchronous SMIs
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __SMRAM_SAVE_STATE_MAP_H__
+#define __SMRAM_SAVE_STATE_MAP_H__
+
+///
+/// Default SMBASE address
+///
+#define SMM_DEFAULT_SMBASE           0x30000
+
+///
+/// Offset of SMM handler from SMBASE
+///
+#define SMM_HANDLER_OFFSET           0x8000
+
+///
+/// Offset of SMRAM Save State Map from SMBASE
+///
+#define SMRAM_SAVE_STATE_MAP_OFFSET  0xfc00
+
+#pragma pack (1)
+
+///
+/// 32-bit SMRAM Save State Map
+///
+typedef struct {
+  UINT8   Reserved[0x200];  // 7c00h
+                            // Padded an extra 0x200 bytes so 32-bit and 64-bit
+                            // SMRAM Save State Maps are the same size
+  UINT8   Reserved1[0xf8];  // 7e00h
+  UINT32  SMBASE;           // 7ef8h
+  UINT32  SMMRevId;         // 7efch
+  UINT16  IORestart;        // 7f00h
+  UINT16  AutoHALTRestart;  // 7f02h
+  UINT8   Reserved2[0x9C];  // 7f08h
+  UINT32  IOMemAddr;        // 7fa0h
+  UINT32  IOMisc;           // 7fa4h
+  UINT32  _ES;              // 7fa8h
+  UINT32  _CS;              // 7fach
+  UINT32  _SS;              // 7fb0h
+  UINT32  _DS;              // 7fb4h
+  UINT32  _FS;              // 7fb8h
+  UINT32  _GS;              // 7fbch
+  UINT32  Reserved3;        // 7fc0h
+  UINT32  _TR;              // 7fc4h
+  UINT32  _DR7;             // 7fc8h
+  UINT32  _DR6;             // 7fcch
+  UINT32  _EAX;             // 7fd0h
+  UINT32  _ECX;             // 7fd4h
+  UINT32  _EDX;             // 7fd8h
+  UINT32  _EBX;             // 7fdch
+  UINT32  _ESP;             // 7fe0h
+  UINT32  _EBP;             // 7fe4h
+  UINT32  _ESI;             // 7fe8h
+  UINT32  _EDI;             // 7fech
+  UINT32  _EIP;             // 7ff0h
+  UINT32  _EFLAGS;          // 7ff4h
+  UINT32  _CR3;             // 7ff8h
+  UINT32  _CR0;             // 7ffch
+} SMRAM_SAVE_STATE_MAP32;
+
+///
+/// 64-bit SMRAM Save State Map
+///
+typedef struct {
+  UINT8   Reserved1[0x1d0];  // 7c00h
+  UINT32  GdtBaseHiDword;    // 7dd0h
+  UINT32  LdtBaseHiDword;    // 7dd4h
+  UINT32  IdtBaseHiDword;    // 7dd8h
+  UINT8   Reserved2[0xc];    // 7ddch
+  UINT64  IO_EIP;            // 7de8h
+  UINT8   Reserved3[0x50];   // 7df0h
+  UINT32  _CR4;              // 7e40h
+  UINT8   Reserved4[0x48];   // 7e44h
+  UINT32  GdtBaseLoDword;    // 7e8ch
+  UINT32  Reserved5;         // 7e90h
+  UINT32  IdtBaseLoDword;    // 7e94h
+  UINT32  Reserved6;         // 7e98h
+  UINT32  LdtBaseLoDword;    // 7e9ch
+  UINT8   Reserved7[0x38];   // 7ea0h
+  UINT64  EptVmxControl;     // 7ed8h
+  UINT32  EnEptVmxControl;   // 7ee0h
+  UINT8   Reserved8[0x14];   // 7ee4h
+  UINT32  SMBASE;            // 7ef8h
+  UINT32  SMMRevId;          // 7efch
+  UINT16  IORestart;         // 7f00h
+  UINT16  AutoHALTRestart;   // 7f02h
+  UINT8   Reserved9[0x18];   // 7f04h
+  UINT64  _R15;              // 7f1ch
+  UINT64  _R14;
+  UINT64  _R13;
+  UINT64  _R12;
+  UINT64  _R11;
+  UINT64  _R10;
+  UINT64  _R9;
+  UINT64  _R8;
+  UINT64  _RAX;              // 7f5ch
+  UINT64  _RCX;
+  UINT64  _RDX;
+  UINT64  _RBX;
+  UINT64  _RSP;
+  UINT64  _RBP;
+  UINT64  _RSI;
+  UINT64  _RDI;
+  UINT64  IOMemAddr;         // 7f9ch
+  UINT32  IOMisc;            // 7fa4h
+  UINT32  _ES;               // 7fa8h
+  UINT32  _CS;
+  UINT32  _SS;
+  UINT32  _DS;
+  UINT32  _FS;
+  UINT32  _GS;
+  UINT32  _LDTR;             // 7fc0h
+  UINT32  _TR;
+  UINT64  _DR7;              // 7fc8h
+  UINT64  _DR6;
+  UINT64  _RIP;              // 7fd8h
+  UINT64  IA32_EFER;         // 7fe0h
+  UINT64  _RFLAGS;           // 7fe8h
+  UINT64  _CR3;              // 7ff0h
+  UINT64  _CR0;              // 7ff8h
+} SMRAM_SAVE_STATE_MAP64;
+
+///
+/// Union of 32-bit and 64-bit SMRAM Save State Maps
+///
+typedef union  {
+  SMRAM_SAVE_STATE_MAP32  x86;
+  SMRAM_SAVE_STATE_MAP64  x64;
+} SMRAM_SAVE_STATE_MAP;
+
+///
+/// Minimum SMM Revision ID that supports IOMisc field in SMRAM Save State Map
+///
+#define SMRAM_SAVE_STATE_MIN_REV_ID_IOMISC  0x30004
+
+///
+/// SMRAM Save State Map IOMisc I/O Length Values
+///
+#define  SMM_IO_LENGTH_BYTE             0x01
+#define  SMM_IO_LENGTH_WORD             0x02
+#define  SMM_IO_LENGTH_DWORD            0x04
+
+///
+/// SMRAM Save State Map IOMisc I/O Instruction Type Values
+///
+#define  SMM_IO_TYPE_IN_IMMEDIATE       0x9
+#define  SMM_IO_TYPE_IN_DX              0x1
+#define  SMM_IO_TYPE_OUT_IMMEDIATE      0x8
+#define  SMM_IO_TYPE_OUT_DX             0x0
+#define  SMM_IO_TYPE_INS                0x3
+#define  SMM_IO_TYPE_OUTS               0x2
+#define  SMM_IO_TYPE_REP_INS            0x7
+#define  SMM_IO_TYPE_REP_OUTS           0x6
+
+///
+/// SMRAM Save State Map IOMisc structure
+///
+typedef union {
+  struct {
+    UINT32  SmiFlag:1;
+    UINT32  Length:3;
+    UINT32  Type:4;
+    UINT32  Reserved1:8;
+    UINT32  Port:16;
+  } Bits;
+  UINT32  Uint32;
+} SMRAM_SAVE_STATE_IOMISC;
+
+#pragma pack ()
+
+#endif

From 2c32377264945f4e43d02987a1398be6b4231ce7 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:01:42 +0000
Subject: [PATCH 121/525] UefiCpuPkg: Add ACPI CPU Data include file

Add AcpuCpuData.h that defines a data structure that is shared between
modules and is required for ACPI S3 support.
APState field removed between V1 and V2 patch.

(Sync patch r18642 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>

Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18837 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/AcpiCpuData.h | 71 ++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 UefiCpuPkg/Include/AcpiCpuData.h

diff --git a/UefiCpuPkg/Include/AcpiCpuData.h b/UefiCpuPkg/Include/AcpiCpuData.h
new file mode 100644
index 000000000000..a36725711cd8
--- /dev/null
+++ b/UefiCpuPkg/Include/AcpiCpuData.h
@@ -0,0 +1,71 @@
+/** @file
+Definitions for CPU S3 data.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _ACPI_CPU_DATA_H_
+#define _ACPI_CPU_DATA_H_
+
+//
+// Register types in register table
+//
+typedef enum _REGISTER_TYPE {
+  Msr,
+  ControlRegister,
+  MemoryMapped,
+  CacheControl
+} REGISTER_TYPE;
+
+//
+// Element of register table entry
+//
+typedef struct {
+  REGISTER_TYPE RegisterType;
+  UINT32        Index;
+  UINT8         ValidBitStart;
+  UINT8         ValidBitLength;
+  UINT64        Value;
+} CPU_REGISTER_TABLE_ENTRY;
+
+//
+// Register table definition, including current table length,
+// allocated size of this table, and pointer to the list of table entries.
+//
+typedef struct {
+  UINT32                   TableLength;
+  UINT32                   NumberBeforeReset;
+  UINT32                   AllocatedSize;
+  UINT32                   InitialApicId;
+  CPU_REGISTER_TABLE_ENTRY *RegisterTableEntry;
+} CPU_REGISTER_TABLE;
+
+typedef struct {
+  EFI_PHYSICAL_ADDRESS  StartupVector;
+  EFI_PHYSICAL_ADDRESS  GdtrProfile;
+  EFI_PHYSICAL_ADDRESS  IdtrProfile;
+  EFI_PHYSICAL_ADDRESS  StackAddress;
+  UINT32                StackSize;
+  UINT32                NumberOfCpus;
+  EFI_PHYSICAL_ADDRESS  MtrrTable;
+  //
+  // Physical address of a CPU_REGISTER_TABLE structure
+  //
+  EFI_PHYSICAL_ADDRESS  PreSmmInitRegisterTable;
+  //
+  // Physical address of a CPU_REGISTER_TABLE structure
+  //
+  EFI_PHYSICAL_ADDRESS  RegisterTable;
+  EFI_PHYSICAL_ADDRESS  ApMachineCheckHandlerBase;
+  UINT32                ApMachineCheckHandlerSize;
+} ACPI_CPU_DATA;
+
+#endif

From a5f9b8d642ca18a6f9a52cc90658c4dfb3d288e4 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:02:24 +0000
Subject: [PATCH 122/525] UefiCpuPkg: Add CPU Hot Plug Data include file

Add CpuHotPlugData.h that defines a data structure that is shared between
modules and is required for to support hot plug CPUs.

(Sync patch r18643 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18838 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/CpuHotPlugData.h | 33 +++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 UefiCpuPkg/Include/CpuHotPlugData.h

diff --git a/UefiCpuPkg/Include/CpuHotPlugData.h b/UefiCpuPkg/Include/CpuHotPlugData.h
new file mode 100644
index 000000000000..2a0d9fabd5b5
--- /dev/null
+++ b/UefiCpuPkg/Include/CpuHotPlugData.h
@@ -0,0 +1,33 @@
+/** @file
+Definition for a structure sharing information for CPU hot plug.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _CPU_HOT_PLUG_DATA_H_
+#define _CPU_HOT_PLUG_DATA_H_
+
+#define  CPU_HOT_PLUG_DATA_REVISION_1      0x00000001
+
+typedef struct {
+  UINT32    Revision;          // Used for version identification for this structure
+  UINT32    ArrayLength;       // The entries number of the following ApicId array and SmBase array
+  //
+  // Data required for SMBASE relocation
+  //
+  UINT64    *ApicId;           // Pointer to ApicId array
+  UINTN     *SmBase;           // Pointer to SmBase array
+  UINT32    Reserved;
+  UINT32    SmrrBase;
+  UINT32    SmrrSize;
+} CPU_HOT_PLUG_DATA;
+
+#endif

From fb0d7d0169376f20b98ded3a79e59f59015910ad Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:03:17 +0000
Subject: [PATCH 123/525] UefiCpuPkg: Update DEC/DSC files for new includes and
 libraries

Add SmmCpuPlatformHookLib library class declaration
Add SmmCpuFeaturesLib library class declaration
Add gEfiSmmCpuServiceProtocolGuid protocol declaration
Build SmmCpuPlatformHookLibNull library instance
Build SmmCpuFeaturesLib library instance

Changes between [PATCH v1] and [PATCH v2]:
1) Use module type specific CpuExceptionHandlerLib in DSC file
   instead of Null library instance

(Sync patch r18644 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18839 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.dec | 13 ++++++++++++-
 UefiCpuPkg/UefiCpuPkg.dsc | 10 ++++++++--
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index fe9b2a5f27cc..4f7065fca604 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -41,11 +41,22 @@
   ##  @libraryclass  Provides platform specific initialization functions in the SEC phase.
   ##
   PlatformSecLib|Include/Library/PlatformSecLib.h
-
   
+  ##  @libraryclass  Public include file for the SMM CPU Platform Hook Library.
+  ##
+  SmmCpuPlatformHookLib|Include/Library/SmmCpuPlatformHookLib.h
+  
+  ##  @libraryclass  Provides the CPU specific programming for PiSmmCpuDxeSmm module.
+  ##
+  SmmCpuFeaturesLib|Include/Library/SmmCpuFeaturesLib.h
+
 [Guids]
   gUefiCpuPkgTokenSpaceGuid      = { 0xac05bf33, 0x995a, 0x4ed4, { 0xaa, 0xb8, 0xef, 0x7a, 0xe8, 0xf, 0x5c, 0xb0 }}
 
+[Protocols]
+  ## Include/Protocol/SmmCpuService.h
+  gEfiSmmCpuServiceProtocolGuid  = { 0x1d202cab, 0xc8ab, 0x4d5c, { 0x94, 0xf7, 0x3c, 0xfc, 0xc0, 0xd3, 0xd3, 0x35 }}
+  
 #
 # [Error.gUefiCpuPkgTokenSpaceGuid]
 #   0x80000001 | Invalid value provided.
diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 68400e3cf8c8..961c970418d6 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -32,6 +32,7 @@
   BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
   CpuLib|MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
   DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
+  SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf  
   DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
   DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
   UefiCpuLib|UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.inf
@@ -51,14 +52,16 @@
   DebugAgentLib|MdeModulePkg/Library/DebugAgentLibNull/DebugAgentLibNull.inf
   LocalApicLib|UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.inf
   ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseReportStatusCodeLibNull.inf
-  CpuExceptionHandlerLib|MdeModulePkg/Library/CpuExceptionHandlerLibNull/CpuExceptionHandlerLibNull.inf
   SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
   SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
+  SmmCpuPlatformHookLib|UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
+  SmmCpuFeaturesLib|UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
   PeCoffExtraActionLib|MdePkg/Library/BasePeCoffExtraActionLibNull/BasePeCoffExtraActionLibNull.inf
 
 [LibraryClasses.common.SEC]
   PlatformSecLib|UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
+  CpuExceptionHandlerLib|UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
   
 [LibraryClasses.common.PEIM]
   MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
@@ -74,11 +77,13 @@
 [LibraryClasses.common.DXE_DRIVER]
   MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
   HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
+  CpuExceptionHandlerLib|UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.inf
 
 [LibraryClasses.common.DXE_SMM_DRIVER]
   SmmServicesTableLib|MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.inf
   MemoryAllocationLib|MdePkg/Library/SmmMemoryAllocationLib/SmmMemoryAllocationLib.inf
   HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
+  CpuExceptionHandlerLib|UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
 
 #
 # Drivers/Libraries within this package
@@ -101,8 +106,9 @@
   UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
+  UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
+  UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
   UefiCpuPkg/SecCore/SecCore.inf
   UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.inf
-

From b6d5be554045c818072df05636aa0e897c1b18b2 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:04:08 +0000
Subject: [PATCH 124/525] UefiCpuPkg: Add PiSmmCpuDxeSmm module no IA32/X64
 files

Add module that initializes a CPU for the SMM environment and
installs the first level SMI handler.  This module along with the
SMM IPL and SMM Core provide the services required for
DXE_SMM_DRIVERS to register hardware and software SMI handlers.

CPU specific features are abstracted through the SmmCpuFeaturesLib

Platform specific features are abstracted through the
SmmCpuPlatformHookLib

Several PCDs are added to enable/disable features and configure
settings for the PiSmmCpuDxeSmm module

Changes between [PATCH v1] and [PATCH v2]:
1) Swap PTE init order for QEMU compatibility.
   Current PTE initialization algorithm works on HW but breaks QEMU
   emulator.  Update the PTE initialization order to be compatible
   with both.
2) Update comment block that describes 32KB SMBASE alignment requirement
   to match contents of Intel(R) 64 and IA-32 Architectures Software
   Developer's Manual
3) Remove BUGBUG comment and call to ClearSmi() that is not required.
   SMI should be cleared by root SMI handler.

(Sync patch r18645 from main trunk.)

[jeff.fan@intel.com: Fix code style issues reported by ECC]

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Paolo Bonzini <pbonzini@redhat.com>

[pbonzini@redhat.com: InitPaging: prepare PT before filling in PDE]
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

Acked-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18840 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/CpuS3.c             |  491 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.c        |  486 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.h        |  181 ++
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c         | 1327 +++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c    | 1489 +++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h    |  699 ++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf  |  163 ++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni  |  Bin 0 -> 1868 bytes
 .../PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni    |  Bin 0 -> 1378 bytes
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c        | 1443 ++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h        |  134 ++
 .../PiSmmCpuDxeSmm/SmmProfileInternal.h       |  172 ++
 UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c    |  700 ++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/SyncTimer.c         |  116 ++
 UefiCpuPkg/UefiCpuPkg.dec                     |  108 +-
 UefiCpuPkg/UefiCpuPkg.uni                     |  Bin 7222 -> 21898 bytes
 16 files changed, 7503 insertions(+), 6 deletions(-)
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/CpuS3.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.h
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfileInternal.h
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/SyncTimer.c

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/CpuS3.c b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuS3.c
new file mode 100644
index 000000000000..bbff6e18b437
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuS3.c
@@ -0,0 +1,491 @@
+/** @file
+Code for Processor S3 restoration
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+typedef struct {
+  UINTN             Lock;
+  VOID              *StackStart;
+  UINTN             StackSize;
+  VOID              *ApFunction;
+  IA32_DESCRIPTOR   GdtrProfile;
+  IA32_DESCRIPTOR   IdtrProfile;
+  UINT32            BufferStart;
+  UINT32            Cr3;
+} MP_CPU_EXCHANGE_INFO;
+
+typedef struct {
+  UINT8 *RendezvousFunnelAddress;
+  UINTN PModeEntryOffset;
+  UINTN FlatJumpOffset;
+  UINTN Size;
+  UINTN LModeEntryOffset;
+  UINTN LongJumpOffset;
+} MP_ASSEMBLY_ADDRESS_MAP;
+
+/**
+  Get starting address and size of the rendezvous entry for APs.
+  Information for fixing a jump instruction in the code is also returned.
+
+  @param AddressMap  Output buffer for address map information.
+**/
+VOID *
+EFIAPI
+AsmGetAddressMap (
+  MP_ASSEMBLY_ADDRESS_MAP                     *AddressMap
+  );
+
+#define LEGACY_REGION_SIZE    (2 * 0x1000)
+#define LEGACY_REGION_BASE    (0xA0000 - LEGACY_REGION_SIZE)
+#define MSR_SPIN_LOCK_INIT_NUM 15
+
+ACPI_CPU_DATA                mAcpiCpuData;
+UINT32                       mNumberToFinish;
+MP_CPU_EXCHANGE_INFO         *mExchangeInfo;
+BOOLEAN                      mRestoreSmmConfigurationInS3 = FALSE;
+VOID                         *mGdtForAp = NULL;
+VOID                         *mIdtForAp = NULL;
+VOID                         *mMachineCheckHandlerForAp = NULL;
+MP_MSR_LOCK                  *mMsrSpinLocks = NULL;
+UINTN                        mMsrSpinLockCount = MSR_SPIN_LOCK_INIT_NUM;
+UINTN                        mMsrCount = 0;
+
+/**
+  Get MSR spin lock by MSR index.
+
+  @param  MsrIndex       MSR index value.
+
+  @return Pointer to MSR spin lock.
+
+**/
+SPIN_LOCK *
+GetMsrSpinLockByIndex (
+  IN UINT32      MsrIndex
+  )
+{
+  UINTN     Index;
+  for (Index = 0; Index < mMsrCount; Index++) {
+    if (MsrIndex == mMsrSpinLocks[Index].MsrIndex) {
+      return &mMsrSpinLocks[Index].SpinLock;
+    }
+  }
+  return NULL;
+}
+
+/**
+  Initialize MSR spin lock by MSR index.
+
+  @param  MsrIndex       MSR index value.
+
+**/
+VOID
+InitMsrSpinLockByIndex (
+  IN UINT32      MsrIndex
+  )
+{
+  UINTN    NewMsrSpinLockCount;
+
+  if (mMsrSpinLocks == NULL) {
+    mMsrSpinLocks = (MP_MSR_LOCK *) AllocatePool (sizeof (MP_MSR_LOCK) * mMsrSpinLockCount);
+    ASSERT (mMsrSpinLocks != NULL);
+  }
+  if (GetMsrSpinLockByIndex (MsrIndex) == NULL) {
+    //
+    // Initialize spin lock for MSR programming
+    //
+    mMsrSpinLocks[mMsrCount].MsrIndex = MsrIndex;
+    InitializeSpinLock (&mMsrSpinLocks[mMsrCount].SpinLock);
+    mMsrCount ++;
+    if (mMsrCount == mMsrSpinLockCount) {
+      //
+      // If MSR spin lock buffer is full, enlarge it
+      //
+      NewMsrSpinLockCount = mMsrSpinLockCount + MSR_SPIN_LOCK_INIT_NUM;
+      mMsrSpinLocks = ReallocatePool (
+                        sizeof (MP_MSR_LOCK) * mMsrSpinLockCount,
+                        sizeof (MP_MSR_LOCK) * NewMsrSpinLockCount,
+                        mMsrSpinLocks
+                        );
+      mMsrSpinLockCount = NewMsrSpinLockCount;
+    }
+  }
+}
+
+/**
+  Sync up the MTRR values for all processors.
+
+  @param MtrrTable  Table holding fixed/variable MTRR values to be loaded.
+**/
+VOID
+EFIAPI
+LoadMtrrData (
+  EFI_PHYSICAL_ADDRESS       MtrrTable
+  )
+/*++
+
+Routine Description:
+
+  Sync up the MTRR values for all processors.
+
+Arguments:
+
+Returns:
+    None
+
+--*/
+{
+  MTRR_SETTINGS   *MtrrSettings;
+
+  MtrrSettings = (MTRR_SETTINGS *) (UINTN) MtrrTable;
+  MtrrSetAllMtrrs (MtrrSettings);
+}
+
+/**
+  Programs registers for the calling processor.
+
+  This function programs registers for the calling processor.
+
+  @param  RegisterTable Pointer to register table of the running processor.
+
+**/
+VOID
+SetProcessorRegister (
+  IN CPU_REGISTER_TABLE        *RegisterTable
+  )
+{
+  CPU_REGISTER_TABLE_ENTRY  *RegisterTableEntry;
+  UINTN                     Index;
+  UINTN                     Value;
+  SPIN_LOCK                 *MsrSpinLock;
+
+  //
+  // Traverse Register Table of this logical processor
+  //
+  RegisterTableEntry = (CPU_REGISTER_TABLE_ENTRY *) (UINTN) RegisterTable->RegisterTableEntry;
+  for (Index = 0; Index < RegisterTable->TableLength; Index++, RegisterTableEntry++) {
+    //
+    // Check the type of specified register
+    //
+    switch (RegisterTableEntry->RegisterType) {
+    //
+    // The specified register is Control Register
+    //
+    case ControlRegister:
+      switch (RegisterTableEntry->Index) {
+      case 0:
+        Value = AsmReadCr0 ();
+        Value = (UINTN) BitFieldWrite64 (
+                          Value,
+                          RegisterTableEntry->ValidBitStart,
+                          RegisterTableEntry->ValidBitStart + RegisterTableEntry->ValidBitLength - 1,
+                          (UINTN) RegisterTableEntry->Value
+                          );
+        AsmWriteCr0 (Value);
+        break;
+      case 2:
+        Value = AsmReadCr2 ();
+        Value = (UINTN) BitFieldWrite64 (
+                          Value,
+                          RegisterTableEntry->ValidBitStart,
+                          RegisterTableEntry->ValidBitStart + RegisterTableEntry->ValidBitLength - 1,
+                          (UINTN) RegisterTableEntry->Value
+                          );
+        AsmWriteCr2 (Value);
+        break;
+      case 3:
+        Value = AsmReadCr3 ();
+        Value = (UINTN) BitFieldWrite64 (
+                          Value,
+                          RegisterTableEntry->ValidBitStart,
+                          RegisterTableEntry->ValidBitStart + RegisterTableEntry->ValidBitLength - 1,
+                          (UINTN) RegisterTableEntry->Value
+                          );
+        AsmWriteCr3 (Value);
+        break;
+      case 4:
+        Value = AsmReadCr4 ();
+        Value = (UINTN) BitFieldWrite64 (
+                          Value,
+                          RegisterTableEntry->ValidBitStart,
+                          RegisterTableEntry->ValidBitStart + RegisterTableEntry->ValidBitLength - 1,
+                          (UINTN) RegisterTableEntry->Value
+                          );
+        AsmWriteCr4 (Value);
+        break;
+      default:
+        break;
+      }
+      break;
+    //
+    // The specified register is Model Specific Register
+    //
+    case Msr:
+      //
+      // If this function is called to restore register setting after INIT signal,
+      // there is no need to restore MSRs in register table.
+      //
+      if (RegisterTableEntry->ValidBitLength >= 64) {
+        //
+        // If length is not less than 64 bits, then directly write without reading
+        //
+        AsmWriteMsr64 (
+          RegisterTableEntry->Index,
+          RegisterTableEntry->Value
+          );
+      } else {
+        //
+        // Get lock to avoid Package/Core scope MSRs programming issue in parallel execution mode
+        // to make sure MSR read/write operation is atomic.
+        //
+        MsrSpinLock = GetMsrSpinLockByIndex (RegisterTableEntry->Index);
+        AcquireSpinLock (MsrSpinLock);
+        //
+        // Set the bit section according to bit start and length
+        //
+        AsmMsrBitFieldWrite64 (
+          RegisterTableEntry->Index,
+          RegisterTableEntry->ValidBitStart,
+          RegisterTableEntry->ValidBitStart + RegisterTableEntry->ValidBitLength - 1,
+          RegisterTableEntry->Value
+          );
+        ReleaseSpinLock (MsrSpinLock);
+      }
+      break;
+    //
+    // Enable or disable cache
+    //
+    case CacheControl:
+      //
+      // If value of the entry is 0, then disable cache.  Otherwise, enable cache.
+      //
+      if (RegisterTableEntry->Value == 0) {
+        AsmDisableCache ();
+      } else {
+        AsmEnableCache ();
+      }
+      break;
+
+    default:
+      break;
+    }
+  }
+}
+
+/**
+  AP initialization before SMBASE relocation in the S3 boot path.
+**/
+VOID
+EarlyMPRendezvousProcedure (
+  VOID
+  )
+{
+  CPU_REGISTER_TABLE         *RegisterTableList;
+  UINT32                     InitApicId;
+  UINTN                      Index;
+
+  LoadMtrrData (mAcpiCpuData.MtrrTable);
+
+  //
+  // Find processor number for this CPU.
+  //
+  RegisterTableList = (CPU_REGISTER_TABLE *) (UINTN) mAcpiCpuData.PreSmmInitRegisterTable;
+  InitApicId = GetInitialApicId ();
+  for (Index = 0; Index < mAcpiCpuData.NumberOfCpus; Index++) {
+    if (RegisterTableList[Index].InitialApicId == InitApicId) {
+      SetProcessorRegister (&RegisterTableList[Index]);
+      break;
+    }
+  }
+
+  //
+  // Count down the number with lock mechanism.
+  //
+  InterlockedDecrement (&mNumberToFinish);
+}
+
+/**
+  AP initialization after SMBASE relocation in the S3 boot path.
+**/
+VOID
+MPRendezvousProcedure (
+  VOID
+  )
+{
+  CPU_REGISTER_TABLE         *RegisterTableList;
+  UINT32                     InitApicId;
+  UINTN                      Index;
+
+  ProgramVirtualWireMode ();
+  DisableLvtInterrupts ();
+
+  RegisterTableList = (CPU_REGISTER_TABLE *) (UINTN) mAcpiCpuData.RegisterTable;
+  InitApicId = GetInitialApicId ();
+  for (Index = 0; Index < mAcpiCpuData.NumberOfCpus; Index++) {
+    if (RegisterTableList[Index].InitialApicId == InitApicId) {
+      SetProcessorRegister (&RegisterTableList[Index]);
+      break;
+    }
+  }
+
+  //
+  // Count down the number with lock mechanism.
+  //
+  InterlockedDecrement (&mNumberToFinish);
+}
+
+/**
+  Prepares startup vector for APs.
+
+  This function prepares startup vector for APs.
+
+  @param  WorkingBuffer  The address of the work buffer.
+**/
+VOID
+PrepareApStartupVector (
+  EFI_PHYSICAL_ADDRESS  WorkingBuffer
+  )
+{
+  EFI_PHYSICAL_ADDRESS                        StartupVector;
+  MP_ASSEMBLY_ADDRESS_MAP                     AddressMap;
+
+  //
+  // Get the address map of startup code for AP,
+  // including code size, and offset of long jump instructions to redirect.
+  //
+  ZeroMem (&AddressMap, sizeof (AddressMap));
+  AsmGetAddressMap (&AddressMap);
+
+  StartupVector = WorkingBuffer;
+
+  //
+  // Copy AP startup code to startup vector, and then redirect the long jump
+  // instructions for mode switching.
+  //
+  CopyMem ((VOID *) (UINTN) StartupVector, AddressMap.RendezvousFunnelAddress, AddressMap.Size);
+  *(UINT32 *) (UINTN) (StartupVector + AddressMap.FlatJumpOffset + 3) = (UINT32) (StartupVector + AddressMap.PModeEntryOffset);
+  if (AddressMap.LongJumpOffset != 0) {
+    *(UINT32 *) (UINTN) (StartupVector + AddressMap.LongJumpOffset + 2) = (UINT32) (StartupVector + AddressMap.LModeEntryOffset);
+  }
+
+  //
+  // Get the start address of exchange data between BSP and AP.
+  //
+  mExchangeInfo = (MP_CPU_EXCHANGE_INFO *) (UINTN) (StartupVector + AddressMap.Size);
+  ZeroMem ((VOID *) mExchangeInfo, sizeof (MP_CPU_EXCHANGE_INFO));
+
+  CopyMem ((VOID *) (UINTN) &mExchangeInfo->GdtrProfile, (VOID *) (UINTN) mAcpiCpuData.GdtrProfile, sizeof (IA32_DESCRIPTOR));
+  CopyMem ((VOID *) (UINTN) &mExchangeInfo->IdtrProfile, (VOID *) (UINTN) mAcpiCpuData.IdtrProfile, sizeof (IA32_DESCRIPTOR));
+
+  //
+  // Copy AP's GDT, IDT and Machine Check handler from SMRAM to ACPI NVS memory
+  //
+  CopyMem ((VOID *) mExchangeInfo->GdtrProfile.Base, mGdtForAp, mExchangeInfo->GdtrProfile.Limit + 1);
+  CopyMem ((VOID *) mExchangeInfo->IdtrProfile.Base, mIdtForAp, mExchangeInfo->IdtrProfile.Limit + 1);
+  CopyMem ((VOID *)(UINTN) mAcpiCpuData.ApMachineCheckHandlerBase, mMachineCheckHandlerForAp, mAcpiCpuData.ApMachineCheckHandlerSize);
+
+  mExchangeInfo->StackStart  = (VOID *) (UINTN) mAcpiCpuData.StackAddress;
+  mExchangeInfo->StackSize   = mAcpiCpuData.StackSize;
+  mExchangeInfo->BufferStart = (UINT32) StartupVector;
+  mExchangeInfo->Cr3         = (UINT32) (AsmReadCr3 ());
+}
+
+/**
+  The function is invoked before SMBASE relocation in S3 path to restores CPU status.
+
+  The function is invoked before SMBASE relocation in S3 path. It does first time microcode load
+  and restores MTRRs for both BSP and APs.
+
+**/
+VOID
+EarlyInitializeCpu (
+  VOID
+  )
+{
+  CPU_REGISTER_TABLE         *RegisterTableList;
+  UINT32                     InitApicId;
+  UINTN                      Index;
+
+  LoadMtrrData (mAcpiCpuData.MtrrTable);
+
+  //
+  // Find processor number for this CPU.
+  //
+  RegisterTableList = (CPU_REGISTER_TABLE *) (UINTN) mAcpiCpuData.PreSmmInitRegisterTable;
+  InitApicId = GetInitialApicId ();
+  for (Index = 0; Index < mAcpiCpuData.NumberOfCpus; Index++) {
+    if (RegisterTableList[Index].InitialApicId == InitApicId) {
+      SetProcessorRegister (&RegisterTableList[Index]);
+      break;
+    }
+  }
+
+  ProgramVirtualWireMode ();
+
+  PrepareApStartupVector (mAcpiCpuData.StartupVector);
+
+  mNumberToFinish = mAcpiCpuData.NumberOfCpus - 1;
+  mExchangeInfo->ApFunction  = (VOID *) (UINTN) EarlyMPRendezvousProcedure;
+
+  //
+  // Send INIT IPI - SIPI to all APs
+  //
+  SendInitSipiSipiAllExcludingSelf ((UINT32)mAcpiCpuData.StartupVector);
+
+  while (mNumberToFinish > 0) {
+    CpuPause ();
+  }
+}
+
+/**
+  The function is invoked after SMBASE relocation in S3 path to restores CPU status.
+
+  The function is invoked after SMBASE relocation in S3 path. It restores configuration according to
+  data saved by normal boot path for both BSP and APs.
+
+**/
+VOID
+InitializeCpu (
+  VOID
+  )
+{
+  CPU_REGISTER_TABLE         *RegisterTableList;
+  UINT32                     InitApicId;
+  UINTN                      Index;
+
+  RegisterTableList = (CPU_REGISTER_TABLE *) (UINTN) mAcpiCpuData.RegisterTable;
+  InitApicId = GetInitialApicId ();
+  for (Index = 0; Index < mAcpiCpuData.NumberOfCpus; Index++) {
+    if (RegisterTableList[Index].InitialApicId == InitApicId) {
+      SetProcessorRegister (&RegisterTableList[Index]);
+      break;
+    }
+  }
+
+  mNumberToFinish = mAcpiCpuData.NumberOfCpus - 1;
+  //
+  // StackStart was updated when APs were waken up in EarlyInitializeCpu.
+  // Re-initialize StackAddress to original beginning address.
+  //
+  mExchangeInfo->StackStart  = (VOID *) (UINTN) mAcpiCpuData.StackAddress;
+  mExchangeInfo->ApFunction  = (VOID *) (UINTN) MPRendezvousProcedure;
+
+  //
+  // Send INIT IPI - SIPI to all APs
+  //
+  SendInitSipiSipiAllExcludingSelf ((UINT32)mAcpiCpuData.StartupVector);
+
+  while (mNumberToFinish > 0) {
+    CpuPause ();
+  }
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.c
new file mode 100644
index 000000000000..40f2a1719d5b
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.c
@@ -0,0 +1,486 @@
+/** @file
+Implementation of SMM CPU Services Protocol.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+//
+// SMM CPU Service Protocol instance
+//
+EFI_SMM_CPU_SERVICE_PROTOCOL  mSmmCpuService = {
+  SmmGetProcessorInfo,
+  SmmSwitchBsp,
+  SmmAddProcessor,
+  SmmRemoveProcessor,
+  SmmWhoAmI,
+  SmmRegisterExceptionHandler
+};
+
+/**
+  Get Package ID/Core ID/Thread ID of a processor.
+
+  APIC ID must be an initial APIC ID.
+
+  The algorithm below assumes the target system has symmetry across physical package boundaries
+  with respect to the number of logical processors per package, number of cores per package.
+
+  @param  ApicId    APIC ID of the target logical processor.
+  @param  Location    Returns the processor location information.
+**/
+VOID
+SmmGetProcessorLocation (
+  IN UINT32 ApicId,
+  OUT EFI_CPU_PHYSICAL_LOCATION *Location
+  )
+{
+  UINTN   ThreadBits;
+  UINTN   CoreBits;
+  UINT32  RegEax;
+  UINT32  RegEbx;
+  UINT32  RegEcx;
+  UINT32  RegEdx;
+  UINT32  MaxCpuIdIndex;
+  UINT32  SubIndex;
+  UINTN   LevelType;
+  UINT32  MaxLogicProcessorsPerPackage;
+  UINT32  MaxCoresPerPackage;
+  BOOLEAN TopologyLeafSupported;
+
+  ASSERT (Location != NULL);
+
+  ThreadBits            = 0;
+  CoreBits              = 0;
+  TopologyLeafSupported = FALSE;
+
+  //
+  // Check if the processor is capable of supporting more than one logical processor.
+  //
+  AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &RegEdx);
+  ASSERT ((RegEdx & BIT28) != 0);
+
+  //
+  // Assume three-level mapping of APIC ID: Package:Core:SMT.
+  //
+
+  //
+  // Get the max index of basic CPUID
+  //
+  AsmCpuid (CPUID_SIGNATURE, &MaxCpuIdIndex, NULL, NULL, NULL);
+
+  //
+  // If the extended topology enumeration leaf is available, it
+  // is the preferred mechanism for enumerating topology.
+  //
+  if (MaxCpuIdIndex >= CPUID_EXTENDED_TOPOLOGY) {
+    AsmCpuidEx (CPUID_EXTENDED_TOPOLOGY, 0, &RegEax, &RegEbx, &RegEcx, NULL);
+    //
+    // If CPUID.(EAX=0BH, ECX=0H):EBX returns zero and maximum input value for
+    // basic CPUID information is greater than 0BH, then CPUID.0BH leaf is not
+    // supported on that processor.
+    //
+    if ((RegEbx & 0xffff) != 0) {
+      TopologyLeafSupported = TRUE;
+
+      //
+      // Sub-leaf index 0 (ECX= 0 as input) provides enumeration parameters to extract
+      // the SMT sub-field of x2APIC ID.
+      //
+      LevelType = (RegEcx >> 8) & 0xff;
+      ASSERT (LevelType == CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT);
+      if ((RegEbx & 0xffff) > 1 ) {
+        ThreadBits = RegEax & 0x1f;
+      } else {
+        //
+        // HT is not supported
+        //
+        ThreadBits = 0;
+      }
+
+      //
+      // Software must not assume any "level type" encoding
+      // value to be related to any sub-leaf index, except sub-leaf 0.
+      //
+      SubIndex = 1;
+      do {
+        AsmCpuidEx (CPUID_EXTENDED_TOPOLOGY, SubIndex, &RegEax, NULL, &RegEcx, NULL);
+        LevelType = (RegEcx >> 8) & 0xff;
+        if (LevelType == CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE) {
+          CoreBits = (RegEax & 0x1f) - ThreadBits;
+          break;
+        }
+        SubIndex++;
+      } while (LevelType != CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID);
+    }
+  }
+
+  if (!TopologyLeafSupported) {
+    AsmCpuid (CPUID_VERSION_INFO, NULL, &RegEbx, NULL, NULL);
+    MaxLogicProcessorsPerPackage = (RegEbx >> 16) & 0xff;
+    if (MaxCpuIdIndex >= CPUID_CACHE_PARAMS) {
+      AsmCpuidEx (CPUID_CACHE_PARAMS, 0, &RegEax, NULL, NULL, NULL);
+      MaxCoresPerPackage = (RegEax >> 26) + 1;
+    } else {
+      //
+      // Must be a single-core processor.
+      //
+      MaxCoresPerPackage = 1;
+    }
+
+    ThreadBits = (UINTN) (HighBitSet32 (MaxLogicProcessorsPerPackage / MaxCoresPerPackage - 1) + 1);
+    CoreBits = (UINTN) (HighBitSet32 (MaxCoresPerPackage - 1) + 1);
+  }
+
+  Location->Thread = ApicId & ~((-1) << ThreadBits);
+  Location->Core = (ApicId >> ThreadBits) & ~((-1) << CoreBits);
+  Location->Package = (ApicId >> (ThreadBits+ CoreBits));
+}
+
+/**
+  Gets processor information on the requested processor at the instant this call is made.
+
+  @param[in]  This                 A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in]  ProcessorNumber      The handle number of processor.
+  @param[out] ProcessorInfoBuffer  A pointer to the buffer where information for
+                                   the requested processor is deposited.
+
+  @retval EFI_SUCCESS             Processor information was returned.
+  @retval EFI_INVALID_PARAMETER   ProcessorInfoBuffer is NULL.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is invalid.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by
+                                  ProcessorNumber does not exist in the platform.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmGetProcessorInfo (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber,
+  OUT      EFI_PROCESSOR_INFORMATION    *ProcessorInfoBuffer
+  )
+{
+  //
+  // Check parameter
+  //
+  if (ProcessorNumber >= mMaxNumberOfCpus || ProcessorInfoBuffer == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (gSmmCpuPrivate->ProcessorInfo[ProcessorNumber].ProcessorId == INVALID_APIC_ID) {
+    return EFI_NOT_FOUND;
+  }
+
+  //
+  // Fill in processor information
+  //
+  CopyMem (ProcessorInfoBuffer, &gSmmCpuPrivate->ProcessorInfo[ProcessorNumber], sizeof (EFI_PROCESSOR_INFORMATION));
+  return EFI_SUCCESS;
+}
+
+/**
+  This service switches the requested AP to be the BSP since the next SMI.
+
+  @param[in] This             A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber  The handle number of AP that is to become the new BSP.
+
+  @retval EFI_SUCCESS             BSP will be switched in next SMI.
+  @retval EFI_UNSUPPORTED         Switching the BSP or a processor to be hot-removed is not supported.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by ProcessorNumber does not exist.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is invalid.
+**/
+EFI_STATUS
+EFIAPI
+SmmSwitchBsp (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber
+  )
+{
+  //
+  // Check parameter
+  //
+  if (ProcessorNumber >= mMaxNumberOfCpus) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (gSmmCpuPrivate->ProcessorInfo[ProcessorNumber].ProcessorId == INVALID_APIC_ID) {
+    return EFI_NOT_FOUND;
+  }
+
+  if (gSmmCpuPrivate->Operation[ProcessorNumber] != SmmCpuNone ||
+      gSmst->CurrentlyExecutingCpu == ProcessorNumber) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Setting of the BSP for next SMI is pending until all SMI handlers are finished
+  //
+  gSmmCpuPrivate->Operation[ProcessorNumber] = SmmCpuSwitchBsp;
+  return EFI_SUCCESS;
+}
+
+/**
+  Notify that a processor was hot-added.
+
+  @param[in] This                A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorId         Local APIC ID of the hot-added processor.
+  @param[out] ProcessorNumber    The handle number of the hot-added processor.
+
+  @retval EFI_SUCCESS            The hot-addition of the specified processors was successfully notified.
+  @retval EFI_UNSUPPORTED        Hot addition of processor is not supported.
+  @retval EFI_NOT_FOUND          The processor with the handle specified by ProcessorNumber does not exist.
+  @retval EFI_INVALID_PARAMETER  ProcessorNumber is invalid.
+  @retval EFI_ALREADY_STARTED    The processor is already online in the system.
+**/
+EFI_STATUS
+EFIAPI
+SmmAddProcessor (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINT64                        ProcessorId,
+  OUT      UINTN                         *ProcessorNumber
+  )
+{
+  UINTN  Index;
+
+  if (!FeaturePcdGet (PcdCpuHotPlugSupport)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check parameter
+  //
+  if (ProcessorNumber == NULL || ProcessorId == INVALID_APIC_ID) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Check if the processor already exists
+  //
+
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId == ProcessorId) {
+      return EFI_ALREADY_STARTED;
+    }
+  }
+
+  //
+  // Check CPU hot plug data. The CPU RAS handler should have created the mapping
+  // of the APIC ID to SMBASE.
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (mCpuHotPlugData.ApicId[Index] == ProcessorId &&
+        gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId == INVALID_APIC_ID) {
+      gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId = ProcessorId;
+      gSmmCpuPrivate->ProcessorInfo[Index].StatusFlag = 0;
+      SmmGetProcessorLocation ((UINT32)ProcessorId, &gSmmCpuPrivate->ProcessorInfo[Index].Location);
+
+      *ProcessorNumber = Index;
+      gSmmCpuPrivate->Operation[Index] = SmmCpuAdd;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  Notify that a processor was hot-removed.
+
+  @param[in] This                A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber     The handle number of the hot-added processor.
+
+  @retval EFI_SUCCESS            The hot-removal of the specified processors was successfully notified.
+  @retval EFI_UNSUPPORTED        Hot removal of processor is not supported.
+  @retval EFI_UNSUPPORTED        Hot removal of BSP is not supported.
+  @retval EFI_UNSUPPORTED        Hot removal of a processor with pending hot-plug operation is not supported.
+  @retval EFI_INVALID_PARAMETER  ProcessorNumber is invalid.
+**/
+EFI_STATUS
+EFIAPI
+SmmRemoveProcessor (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINTN                         ProcessorNumber
+  )
+{
+  if (!FeaturePcdGet (PcdCpuHotPlugSupport)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check parameter
+  //
+  if (ProcessorNumber >= mMaxNumberOfCpus ||
+      gSmmCpuPrivate->ProcessorInfo[ProcessorNumber].ProcessorId == INVALID_APIC_ID) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Can't remove BSP
+  //
+  if (ProcessorNumber == gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (gSmmCpuPrivate->Operation[ProcessorNumber] != SmmCpuNone) {
+    return EFI_UNSUPPORTED;
+  }
+
+  gSmmCpuPrivate->ProcessorInfo[ProcessorNumber].ProcessorId = INVALID_APIC_ID;
+  mCpuHotPlugData.ApicId[ProcessorNumber] = INVALID_APIC_ID;
+
+  //
+  // Removal of the processor from the CPU list is pending until all SMI handlers are finished
+  //
+  gSmmCpuPrivate->Operation[ProcessorNumber] = SmmCpuRemove;
+  return EFI_SUCCESS;
+}
+
+/**
+  This return the handle number for the calling processor.
+
+  @param[in] This                 A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[out] ProcessorNumber      The handle number of currently executing processor.
+
+  @retval EFI_SUCCESS             The current processor handle number was returned
+                                  in ProcessorNumber.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmWhoAmI (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  OUT      UINTN                        *ProcessorNumber
+  )
+{
+  UINTN  Index;
+  UINT64 ApicId;
+
+  //
+  // Check parameter
+  //
+  if (ProcessorNumber == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  ApicId = GetApicId ();
+
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId == ApicId) {
+      *ProcessorNumber = Index;
+      return EFI_SUCCESS;
+    }
+  }
+  //
+  // This should not happen
+  //
+  ASSERT (FALSE);
+  return EFI_NOT_FOUND;
+}
+
+/**
+  Update the SMM CPU list per the pending operation.
+
+  This function is called after return from SMI handlers.
+**/
+VOID
+SmmCpuUpdate (
+  VOID
+  )
+{
+  UINTN   Index;
+
+  //
+  // Handle pending BSP switch operations
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (gSmmCpuPrivate->Operation[Index] == SmmCpuSwitchBsp) {
+      gSmmCpuPrivate->Operation[Index] = SmmCpuNone;
+      mSmmMpSyncData->SwitchBsp = TRUE;
+      mSmmMpSyncData->CandidateBsp[Index] = TRUE;
+    }
+  }
+
+  //
+  // Handle pending hot-add operations
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (gSmmCpuPrivate->Operation[Index] == SmmCpuAdd) {
+      gSmmCpuPrivate->Operation[Index] = SmmCpuNone;
+      mNumberOfCpus++;
+    }
+  }
+
+  //
+  // Handle pending hot-remove operations
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    if (gSmmCpuPrivate->Operation[Index] == SmmCpuRemove) {
+      gSmmCpuPrivate->Operation[Index] = SmmCpuNone;
+      mNumberOfCpus--;
+    }
+  }
+}
+
+/**
+  Register exception handler.
+
+  @param  This                  A pointer to the SMM_CPU_SERVICE_PROTOCOL instance.
+  @param  ExceptionType         Defines which interrupt or exception to hook. Type EFI_EXCEPTION_TYPE and
+                                the valid values for this parameter are defined in EFI_DEBUG_SUPPORT_PROTOCOL
+                                of the UEFI 2.0 specification.
+  @param  InterruptHandler      A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER
+                                that is called when a processor interrupt occurs.
+                                If this parameter is NULL, then the handler will be uninstalled.
+
+  @retval EFI_SUCCESS           The handler for the processor interrupt was successfully installed or uninstalled.
+  @retval EFI_ALREADY_STARTED   InterruptHandler is not NULL, and a handler for InterruptType was previously installed.
+  @retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not previously installed.
+  @retval EFI_UNSUPPORTED       The interrupt specified by InterruptType is not supported.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmRegisterExceptionHandler (
+    IN EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+    IN EFI_EXCEPTION_TYPE            ExceptionType,
+    IN EFI_CPU_INTERRUPT_HANDLER     InterruptHandler
+    )
+{
+  return RegisterCpuInterruptHandler (ExceptionType, InterruptHandler);
+}
+
+/**
+  Initialize SMM CPU Services.
+
+  It installs EFI SMM CPU Services Protocol.
+
+  @param ImageHandle The firmware allocated handle for the EFI image.
+
+  @retval EFI_SUCCESS    EFI SMM CPU Services Protocol was installed successfully.
+**/
+EFI_STATUS
+InitializeSmmCpuServices (
+  IN EFI_HANDLE  Handle
+  )
+{
+  EFI_STATUS Status;
+
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &Handle,
+                    &gEfiSmmCpuServiceProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mSmmCpuService
+                    );
+  ASSERT_EFI_ERROR (Status);
+  return Status;
+}
+
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.h b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.h
new file mode 100644
index 000000000000..9fe3f45b0266
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/CpuService.h
@@ -0,0 +1,181 @@
+/** @file
+Include file for SMM CPU Services protocol implementation.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _CPU_SERVICE_H_
+#define _CPU_SERVICE_H_
+
+typedef enum {
+  SmmCpuNone,
+  SmmCpuAdd,
+  SmmCpuRemove,
+  SmmCpuSwitchBsp
+} SMM_CPU_OPERATION;
+
+//
+// SMM CPU Service Protocol function prototypes.
+//
+
+/**
+  Gets processor information on the requested processor at the instant this call is made.
+
+  @param[in]  This                 A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in]  ProcessorNumber      The handle number of processor.
+  @param[out] ProcessorInfoBuffer  A pointer to the buffer where information for
+                                   the requested processor is deposited.
+
+  @retval EFI_SUCCESS             Processor information was returned.
+  @retval EFI_INVALID_PARAMETER   ProcessorInfoBuffer is NULL.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is invalid.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by
+                                  ProcessorNumber does not exist in the platform.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmGetProcessorInfo (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber,
+  OUT      EFI_PROCESSOR_INFORMATION    *ProcessorInfoBuffer
+  );
+
+/**
+  This service switches the requested AP to be the BSP since the next SMI.
+
+  @param[in] This             A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber  The handle number of AP that is to become the new BSP.
+
+  @retval EFI_SUCCESS             BSP will be switched in next SMI.
+  @retval EFI_UNSUPPORTED         Switching the BSP or a processor to be hot-removed is not supported.
+  @retval EFI_NOT_FOUND           The processor with the handle specified by ProcessorNumber does not exist.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is invalid.
+**/
+EFI_STATUS
+EFIAPI
+SmmSwitchBsp (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  IN       UINTN                        ProcessorNumber
+  );
+
+/**
+  Notify that a processor was hot-added.
+
+  @param[in] This                A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorId         Local APIC ID of the hot-added processor.
+  @param[out] ProcessorNumber    The handle number of the hot-added processor.
+
+  @retval EFI_SUCCESS            The hot-addition of the specified processors was successfully notified.
+  @retval EFI_UNSUPPORTED        Hot addition of processor is not supported.
+  @retval EFI_NOT_FOUND          The processor with the handle specified by ProcessorNumber does not exist.
+  @retval EFI_INVALID_PARAMETER  ProcessorNumber is invalid.
+  @retval EFI_ALREADY_STARTED    The processor is already online in the system.
+**/
+EFI_STATUS
+EFIAPI
+SmmAddProcessor (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINT64                        ProcessorId,
+  OUT      UINTN                         *ProcessorNumber
+  );
+
+/**
+  Notify that a processor was hot-removed.
+
+  @param[in] This                A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[in] ProcessorNumber     The handle number of the hot-added processor.
+
+  @retval EFI_SUCCESS            The hot-removal of the specified processors was successfully notified.
+  @retval EFI_UNSUPPORTED        Hot removal of processor is not supported.
+  @retval EFI_UNSUPPORTED        Hot removal of BSP is not supported.
+  @retval EFI_UNSUPPORTED        Hot removal of a processor with pending hot-plug operation is not supported.
+  @retval EFI_INVALID_PARAMETER  ProcessorNumber is invalid.
+**/
+EFI_STATUS
+EFIAPI
+SmmRemoveProcessor (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN       UINTN                         ProcessorNumber
+  );
+
+/**
+  This return the handle number for the calling processor.
+
+  @param[in] This                 A pointer to the EFI_SMM_CPU_SERVICE_PROTOCOL instance.
+  @param[out] ProcessorNumber      The handle number of currently executing processor.
+
+  @retval EFI_SUCCESS             The current processor handle number was returned
+                                  in ProcessorNumber.
+  @retval EFI_INVALID_PARAMETER   ProcessorNumber is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmWhoAmI (
+  IN CONST EFI_SMM_CPU_SERVICE_PROTOCOL *This,
+  OUT      UINTN                        *ProcessorNumber
+  );
+
+/**
+  Register exception handler.
+
+  @param  This                  A pointer to the SMM_CPU_SERVICE_PROTOCOL instance.
+  @param  ExceptionType         Defines which interrupt or exception to hook. Type EFI_EXCEPTION_TYPE and
+                                the valid values for this parameter are defined in EFI_DEBUG_SUPPORT_PROTOCOL
+                                of the UEFI 2.0 specification.
+  @param  InterruptHandler      A pointer to a function of type EFI_CPU_INTERRUPT_HANDLER
+                                that is called when a processor interrupt occurs.
+                                If this parameter is NULL, then the handler will be uninstalled.
+
+  @retval EFI_SUCCESS           The handler for the processor interrupt was successfully installed or uninstalled.
+  @retval EFI_ALREADY_STARTED   InterruptHandler is not NULL, and a handler for InterruptType was previously installed.
+  @retval EFI_INVALID_PARAMETER InterruptHandler is NULL, and a handler for InterruptType was not previously installed.
+  @retval EFI_UNSUPPORTED       The interrupt specified by InterruptType is not supported.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmRegisterExceptionHandler (
+  IN EFI_SMM_CPU_SERVICE_PROTOCOL  *This,
+  IN EFI_EXCEPTION_TYPE            ExceptionType,
+  IN EFI_CPU_INTERRUPT_HANDLER     InterruptHandler
+  );
+
+//
+// Internal function prototypes
+//
+
+/**
+  Update the SMM CPU list per the pending operation.
+
+  This function is called after return from SMI handlers.
+**/
+VOID
+SmmCpuUpdate (
+  VOID
+  );
+
+/**
+  Initialize SMM CPU Services.
+
+  It installs EFI SMM CPU Services Protocol.
+
+  @param ImageHandle The firmware allocated handle for the EFI image.
+
+  @retval EFI_SUCCESS    EFI SMM CPU Services Protocol was installed successfully.
+**/
+EFI_STATUS
+InitializeSmmCpuServices (
+  IN EFI_HANDLE  Handle
+  );
+
+#endif
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
new file mode 100644
index 000000000000..730c32df0a25
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -0,0 +1,1327 @@
+/** @file
+SMM MP service implementation
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+//
+// Slots for all MTRR( FIXED MTRR + VARIABLE MTRR + MTRR_LIB_IA32_MTRR_DEF_TYPE)
+//
+UINT64                                      gSmiMtrrs[MTRR_NUMBER_OF_FIXED_MTRR + 2 * MTRR_NUMBER_OF_VARIABLE_MTRR + 1];
+UINT64                                      gPhyMask;
+SMM_DISPATCHER_MP_SYNC_DATA                 *mSmmMpSyncData = NULL;
+UINTN                                       mSmmMpSyncDataSize;
+
+/**
+  Performs an atomic compare exchange operation to get semaphore.
+  The compare exchange operation must be performed using
+  MP safe mechanisms.
+
+  @param      Sem        IN:  32-bit unsigned integer
+                         OUT: original integer - 1
+  @return     Original integer - 1
+
+**/
+UINT32
+WaitForSemaphore (
+  IN OUT  volatile UINT32           *Sem
+  )
+{
+  UINT32                            Value;
+
+  do {
+    Value = *Sem;
+  } while (Value == 0 ||
+           InterlockedCompareExchange32 (
+             (UINT32*)Sem,
+             Value,
+             Value - 1
+             ) != Value);
+  return Value - 1;
+}
+
+
+/**
+  Performs an atomic compare exchange operation to release semaphore.
+  The compare exchange operation must be performed using
+  MP safe mechanisms.
+
+  @param      Sem        IN:  32-bit unsigned integer
+                         OUT: original integer + 1
+  @return     Original integer + 1
+
+**/
+UINT32
+ReleaseSemaphore (
+  IN OUT  volatile UINT32           *Sem
+  )
+{
+  UINT32                            Value;
+
+  do {
+    Value = *Sem;
+  } while (Value + 1 != 0 &&
+           InterlockedCompareExchange32 (
+             (UINT32*)Sem,
+             Value,
+             Value + 1
+             ) != Value);
+  return Value + 1;
+}
+
+/**
+  Performs an atomic compare exchange operation to lock semaphore.
+  The compare exchange operation must be performed using
+  MP safe mechanisms.
+
+  @param      Sem        IN:  32-bit unsigned integer
+                         OUT: -1
+  @return     Original integer
+
+**/
+UINT32
+LockdownSemaphore (
+  IN OUT  volatile UINT32           *Sem
+  )
+{
+  UINT32                            Value;
+
+  do {
+    Value = *Sem;
+  } while (InterlockedCompareExchange32 (
+             (UINT32*)Sem,
+             Value, (UINT32)-1
+             ) != Value);
+  return Value;
+}
+
+/**
+  Wait all APs to performs an atomic compare exchange operation to release semaphore.
+
+  @param   NumberOfAPs      AP number
+
+**/
+VOID
+WaitForAllAPs (
+  IN      UINTN                     NumberOfAPs
+  )
+{
+  UINTN                             BspIndex;
+
+  BspIndex = mSmmMpSyncData->BspIndex;
+  while (NumberOfAPs-- > 0) {
+    WaitForSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+  }
+}
+
+/**
+  Performs an atomic compare exchange operation to release semaphore
+  for each AP.
+
+**/
+VOID
+ReleaseAllAPs (
+  VOID
+  )
+{
+  UINTN                             Index;
+  UINTN                             BspIndex;
+
+  BspIndex = mSmmMpSyncData->BspIndex;
+  for (Index = mMaxNumberOfCpus; Index-- > 0;) {
+    if (Index != BspIndex && mSmmMpSyncData->CpuData[Index].Present) {
+      ReleaseSemaphore (&mSmmMpSyncData->CpuData[Index].Run);
+    }
+  }
+}
+
+/**
+  Checks if all CPUs (with certain exceptions) have checked in for this SMI run
+
+  @param   Exceptions     CPU Arrival exception flags.
+
+  @retval   TRUE  if all CPUs the have checked in.
+  @retval   FALSE  if at least one Normal AP hasn't checked in.
+
+**/
+BOOLEAN
+AllCpusInSmmWithExceptions (
+  SMM_CPU_ARRIVAL_EXCEPTIONS  Exceptions
+  )
+{
+  UINTN                             Index;
+  SMM_CPU_DATA_BLOCK                *CpuData;
+  EFI_PROCESSOR_INFORMATION         *ProcessorInfo;
+
+  ASSERT (mSmmMpSyncData->Counter <= mNumberOfCpus);
+
+  if (mSmmMpSyncData->Counter == mNumberOfCpus) {
+    return TRUE;
+  }
+
+  CpuData = mSmmMpSyncData->CpuData;
+  ProcessorInfo = gSmmCpuPrivate->ProcessorInfo;
+  for (Index = mMaxNumberOfCpus; Index-- > 0;) {
+    if (!CpuData[Index].Present && ProcessorInfo[Index].ProcessorId != INVALID_APIC_ID) {
+      if (((Exceptions & ARRIVAL_EXCEPTION_DELAYED) != 0) && SmmCpuFeaturesGetSmmRegister (Index, SmmRegSmmDelayed) != 0) {
+        continue;
+      }
+      if (((Exceptions & ARRIVAL_EXCEPTION_BLOCKED) != 0) && SmmCpuFeaturesGetSmmRegister (Index, SmmRegSmmBlocked) != 0) {
+        continue;
+      }
+      if (((Exceptions & ARRIVAL_EXCEPTION_SMI_DISABLED) != 0) && SmmCpuFeaturesGetSmmRegister (Index, SmmRegSmmEnable) != 0) {
+        continue;
+      }
+      return FALSE;
+    }
+  }
+
+
+  return TRUE;
+}
+
+
+/**
+  Given timeout constraint, wait for all APs to arrive, and insure when this function returns, no AP will execute normal mode code before
+  entering SMM, except SMI disabled APs.
+
+**/
+VOID
+SmmWaitForApArrival (
+  VOID
+  )
+{
+  UINT64                            Timer;
+  UINTN                             Index;
+
+  ASSERT (mSmmMpSyncData->Counter <= mNumberOfCpus);
+
+  //
+  // Platform implementor should choose a timeout value appropriately:
+  // - The timeout value should balance the SMM time constrains and the likelihood that delayed CPUs are excluded in the SMM run. Note
+  //   the SMI Handlers must ALWAYS take into account the cases that not all APs are available in an SMI run.
+  // - The timeout value must, in the case of 2nd timeout, be at least long enough to give time for all APs to receive the SMI IPI
+  //   and either enter SMM or buffer the SMI, to insure there is no CPU running normal mode code when SMI handling starts. This will
+  //   be TRUE even if a blocked CPU is brought out of the blocked state by a normal mode CPU (before the normal mode CPU received the
+  //   SMI IPI), because with a buffered SMI, and CPU will enter SMM immediately after it is brought out of the blocked state.
+  // - The timeout value must be longer than longest possible IO operation in the system
+  //
+
+  //
+  // Sync with APs 1st timeout
+  //
+  for (Timer = StartSyncTimer ();
+       !IsSyncTimerTimeout (Timer) &&
+       !AllCpusInSmmWithExceptions (ARRIVAL_EXCEPTION_BLOCKED | ARRIVAL_EXCEPTION_SMI_DISABLED );
+       ) {
+    CpuPause ();
+  }
+
+  //
+  // Not all APs have arrived, so we need 2nd round of timeout. IPIs should be sent to ALL none present APs,
+  // because:
+  // a) Delayed AP may have just come out of the delayed state. Blocked AP may have just been brought out of blocked state by some AP running
+  //    normal mode code. These APs need to be guaranteed to have an SMI pending to insure that once they are out of delayed / blocked state, they
+  //    enter SMI immediately without executing instructions in normal mode. Note traditional flow requires there are no APs doing normal mode
+  //    work while SMI handling is on-going.
+  // b) As a consequence of SMI IPI sending, (spurious) SMI may occur after this SMM run.
+  // c) ** NOTE **: Use SMI disabling feature VERY CAREFULLY (if at all) for traditional flow, because a processor in SMI-disabled state
+  //    will execute normal mode code, which breaks the traditional SMI handlers' assumption that no APs are doing normal
+  //    mode work while SMI handling is on-going.
+  // d) We don't add code to check SMI disabling status to skip sending IPI to SMI disabled APs, because:
+  //    - In traditional flow, SMI disabling is discouraged.
+  //    - In relaxed flow, CheckApArrival() will check SMI disabling status before calling this function.
+  //    In both cases, adding SMI-disabling checking code increases overhead.
+  //
+  if (mSmmMpSyncData->Counter < mNumberOfCpus) {
+    //
+    // Send SMI IPIs to bring outside processors in
+    //
+    for (Index = mMaxNumberOfCpus; Index-- > 0;) {
+      if (!mSmmMpSyncData->CpuData[Index].Present && gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId != INVALID_APIC_ID) {
+        SendSmiIpi ((UINT32)gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId);
+      }
+    }
+
+    //
+    // Sync with APs 2nd timeout.
+    //
+    for (Timer = StartSyncTimer ();
+         !IsSyncTimerTimeout (Timer) &&
+         !AllCpusInSmmWithExceptions (ARRIVAL_EXCEPTION_BLOCKED | ARRIVAL_EXCEPTION_SMI_DISABLED );
+         ) {
+      CpuPause ();
+    }
+  }
+
+  return;
+}
+
+
+/**
+  Replace OS MTRR's with SMI MTRR's.
+
+  @param    CpuIndex             Processor Index
+
+**/
+VOID
+ReplaceOSMtrrs (
+  IN      UINTN                     CpuIndex
+  )
+{
+  PROCESSOR_SMM_DESCRIPTOR       *Psd;
+  UINT64                         *SmiMtrrs;
+  MTRR_SETTINGS                  *BiosMtrr;
+
+  Psd = (PROCESSOR_SMM_DESCRIPTOR*)(mCpuHotPlugData.SmBase[CpuIndex] + SMM_PSD_OFFSET);
+  SmiMtrrs = (UINT64*)(UINTN)Psd->MtrrBaseMaskPtr;
+
+  SmmCpuFeaturesDisableSmrr ();
+
+  //
+  // Replace all MTRRs registers
+  //
+  BiosMtrr  = (MTRR_SETTINGS*)SmiMtrrs;
+  MtrrSetAllMtrrs(BiosMtrr);
+}
+
+/**
+  SMI handler for BSP.
+
+  @param     CpuIndex         BSP processor Index
+  @param     SyncMode         SMM MP sync mode
+
+**/
+VOID
+BSPHandler (
+  IN      UINTN                     CpuIndex,
+  IN      SMM_CPU_SYNC_MODE         SyncMode
+  )
+{
+  UINTN                             Index;
+  MTRR_SETTINGS                     Mtrrs;
+  UINTN                             ApCount;
+  BOOLEAN                           ClearTopLevelSmiResult;
+  UINTN                             PresentCount;
+
+  ASSERT (CpuIndex == mSmmMpSyncData->BspIndex);
+  ApCount = 0;
+
+  //
+  // Flag BSP's presence
+  //
+  mSmmMpSyncData->InsideSmm = TRUE;
+
+  //
+  // Initialize Debug Agent to start source level debug in BSP handler
+  //
+  InitializeDebugAgent (DEBUG_AGENT_INIT_ENTER_SMI, NULL, NULL);
+
+  //
+  // Mark this processor's presence
+  //
+  mSmmMpSyncData->CpuData[CpuIndex].Present = TRUE;
+
+  //
+  // Clear platform top level SMI status bit before calling SMI handlers. If
+  // we cleared it after SMI handlers are run, we would miss the SMI that
+  // occurs after SMI handlers are done and before SMI status bit is cleared.
+  //
+  ClearTopLevelSmiResult = ClearTopLevelSmiStatus();
+  ASSERT (ClearTopLevelSmiResult == TRUE);
+
+  //
+  // Set running processor index
+  //
+  gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu = CpuIndex;
+
+  //
+  // If Traditional Sync Mode or need to configure MTRRs: gather all available APs.
+  //
+  if (SyncMode == SmmCpuSyncModeTradition || SmmCpuFeaturesNeedConfigureMtrrs()) {
+
+    //
+    // Wait for APs to arrive
+    //
+    SmmWaitForApArrival();
+
+    //
+    // Lock the counter down and retrieve the number of APs
+    //
+    mSmmMpSyncData->AllCpusInSync = TRUE;
+    ApCount = LockdownSemaphore (&mSmmMpSyncData->Counter) - 1;
+
+    //
+    // Wait for all APs to get ready for programming MTRRs
+    //
+    WaitForAllAPs (ApCount);
+
+    if (SmmCpuFeaturesNeedConfigureMtrrs()) {
+      //
+      // Signal all APs it's time for backup MTRRs
+      //
+      ReleaseAllAPs ();
+
+      //
+      // WaitForSemaphore() may wait for ever if an AP happens to enter SMM at
+      // exactly this point. Please make sure PcdCpuSmmMaxSyncLoops has been set
+      // to a large enough value to avoid this situation.
+      // Note: For HT capable CPUs, threads within a core share the same set of MTRRs.
+      // We do the backup first and then set MTRR to avoid race condition for threads
+      // in the same core.
+      //
+      MtrrGetAllMtrrs(&Mtrrs);
+
+      //
+      // Wait for all APs to complete their MTRR saving
+      //
+      WaitForAllAPs (ApCount);
+
+      //
+      // Let all processors program SMM MTRRs together
+      //
+      ReleaseAllAPs ();
+
+      //
+      // WaitForSemaphore() may wait for ever if an AP happens to enter SMM at
+      // exactly this point. Please make sure PcdCpuSmmMaxSyncLoops has been set
+      // to a large enough value to avoid this situation.
+      //
+      ReplaceOSMtrrs (CpuIndex);
+
+      //
+      // Wait for all APs to complete their MTRR programming
+      //
+      WaitForAllAPs (ApCount);
+    }
+  }
+
+  //
+  // The BUSY lock is initialized to Acquired state
+  //
+  AcquireSpinLockOrFail (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
+
+  //
+  // Restore SMM Configuration in S3 boot path.
+  //
+  if (mRestoreSmmConfigurationInS3) {
+    //
+    // Configure SMM Code Access Check feature if available.
+    //
+    ConfigSmmCodeAccessCheck ();
+    mRestoreSmmConfigurationInS3 = FALSE;
+  }
+
+  //
+  // Invoke SMM Foundation EntryPoint with the processor information context.
+  //
+  gSmmCpuPrivate->SmmCoreEntry (&gSmmCpuPrivate->SmmCoreEntryContext);
+
+  //
+  // Make sure all APs have completed their pending none-block tasks
+  //
+  for (Index = mMaxNumberOfCpus; Index-- > 0;) {
+    if (Index != CpuIndex && mSmmMpSyncData->CpuData[Index].Present) {
+      AcquireSpinLock (&mSmmMpSyncData->CpuData[Index].Busy);
+      ReleaseSpinLock (&mSmmMpSyncData->CpuData[Index].Busy);;
+    }
+  }
+
+  //
+  // Perform the remaining tasks
+  //
+  PerformRemainingTasks ();
+
+  //
+  // If Relaxed-AP Sync Mode: gather all available APs after BSP SMM handlers are done, and
+  // make those APs to exit SMI synchronously. APs which arrive later will be excluded and
+  // will run through freely.
+  //
+  if (SyncMode != SmmCpuSyncModeTradition && !SmmCpuFeaturesNeedConfigureMtrrs()) {
+
+    //
+    // Lock the counter down and retrieve the number of APs
+    //
+    mSmmMpSyncData->AllCpusInSync = TRUE;
+    ApCount = LockdownSemaphore (&mSmmMpSyncData->Counter) - 1;
+    //
+    // Make sure all APs have their Present flag set
+    //
+    while (TRUE) {
+      PresentCount = 0;
+      for (Index = mMaxNumberOfCpus; Index-- > 0;) {
+        if (mSmmMpSyncData->CpuData[Index].Present) {
+          PresentCount ++;
+        }
+      }
+      if (PresentCount > ApCount) {
+        break;
+      }
+    }
+  }
+
+  //
+  // Notify all APs to exit
+  //
+  mSmmMpSyncData->InsideSmm = FALSE;
+  ReleaseAllAPs ();
+
+  //
+  // Wait for all APs to complete their pending tasks
+  //
+  WaitForAllAPs (ApCount);
+
+  if (SmmCpuFeaturesNeedConfigureMtrrs()) {
+    //
+    // Signal APs to restore MTRRs
+    //
+    ReleaseAllAPs ();
+
+    //
+    // Restore OS MTRRs
+    //
+    SmmCpuFeaturesReenableSmrr ();
+    MtrrSetAllMtrrs(&Mtrrs);
+
+    //
+    // Wait for all APs to complete MTRR programming
+    //
+    WaitForAllAPs (ApCount);
+  }
+
+  //
+  // Stop source level debug in BSP handler, the code below will not be
+  // debugged.
+  //
+  InitializeDebugAgent (DEBUG_AGENT_INIT_EXIT_SMI, NULL, NULL);
+
+  //
+  // Signal APs to Reset states/semaphore for this processor
+  //
+  ReleaseAllAPs ();
+
+  //
+  // Perform pending operations for hot-plug
+  //
+  SmmCpuUpdate ();
+
+  //
+  // Clear the Present flag of BSP
+  //
+  mSmmMpSyncData->CpuData[CpuIndex].Present = FALSE;
+
+  //
+  // Gather APs to exit SMM synchronously. Note the Present flag is cleared by now but
+  // WaitForAllAps does not depend on the Present flag.
+  //
+  WaitForAllAPs (ApCount);
+
+  //
+  // Reset BspIndex to -1, meaning BSP has not been elected.
+  //
+  if (FeaturePcdGet (PcdCpuSmmEnableBspElection)) {
+    mSmmMpSyncData->BspIndex = (UINT32)-1;
+  }
+
+  //
+  // Allow APs to check in from this point on
+  //
+  mSmmMpSyncData->Counter = 0;
+  mSmmMpSyncData->AllCpusInSync = FALSE;
+}
+
+/**
+  SMI handler for AP.
+
+  @param     CpuIndex         AP processor Index.
+  @param     ValidSmi         Indicates that current SMI is a valid SMI or not.
+  @param     SyncMode         SMM MP sync mode.
+
+**/
+VOID
+APHandler (
+  IN      UINTN                     CpuIndex,
+  IN      BOOLEAN                   ValidSmi,
+  IN      SMM_CPU_SYNC_MODE         SyncMode
+  )
+{
+  UINT64                            Timer;
+  UINTN                             BspIndex;
+  MTRR_SETTINGS                     Mtrrs;
+
+  //
+  // Timeout BSP
+  //
+  for (Timer = StartSyncTimer ();
+       !IsSyncTimerTimeout (Timer) &&
+       !mSmmMpSyncData->InsideSmm;
+       ) {
+    CpuPause ();
+  }
+
+  if (!mSmmMpSyncData->InsideSmm) {
+    //
+    // BSP timeout in the first round
+    //
+    if (mSmmMpSyncData->BspIndex != -1) {
+      //
+      // BSP Index is known
+      //
+      BspIndex = mSmmMpSyncData->BspIndex;
+      ASSERT (CpuIndex != BspIndex);
+
+      //
+      // Send SMI IPI to bring BSP in
+      //
+      SendSmiIpi ((UINT32)gSmmCpuPrivate->ProcessorInfo[BspIndex].ProcessorId);
+
+      //
+      // Now clock BSP for the 2nd time
+      //
+      for (Timer = StartSyncTimer ();
+           !IsSyncTimerTimeout (Timer) &&
+           !mSmmMpSyncData->InsideSmm;
+           ) {
+        CpuPause ();
+      }
+
+      if (!mSmmMpSyncData->InsideSmm) {
+        //
+        // Give up since BSP is unable to enter SMM
+        // and signal the completion of this AP
+        WaitForSemaphore (&mSmmMpSyncData->Counter);
+        return;
+      }
+    } else {
+      //
+      // Don't know BSP index. Give up without sending IPI to BSP.
+      //
+      WaitForSemaphore (&mSmmMpSyncData->Counter);
+      return;
+    }
+  }
+
+  //
+  // BSP is available
+  //
+  BspIndex = mSmmMpSyncData->BspIndex;
+  ASSERT (CpuIndex != BspIndex);
+
+  //
+  // Mark this processor's presence
+  //
+  mSmmMpSyncData->CpuData[CpuIndex].Present = TRUE;
+
+  if (SyncMode == SmmCpuSyncModeTradition || SmmCpuFeaturesNeedConfigureMtrrs()) {
+    //
+    // Notify BSP of arrival at this point
+    //
+    ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+  }
+
+  if (SmmCpuFeaturesNeedConfigureMtrrs()) {
+    //
+    // Wait for the signal from BSP to backup MTRRs
+    //
+    WaitForSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+    //
+    // Backup OS MTRRs
+    //
+    MtrrGetAllMtrrs(&Mtrrs);
+
+    //
+    // Signal BSP the completion of this AP
+    //
+    ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+
+    //
+    // Wait for BSP's signal to program MTRRs
+    //
+    WaitForSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+    //
+    // Replace OS MTRRs with SMI MTRRs
+    //
+    ReplaceOSMtrrs (CpuIndex);
+
+    //
+    // Signal BSP the completion of this AP
+    //
+    ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+  }
+
+  while (TRUE) {
+    //
+    // Wait for something to happen
+    //
+    WaitForSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+    //
+    // Check if BSP wants to exit SMM
+    //
+    if (!mSmmMpSyncData->InsideSmm) {
+      break;
+    }
+
+    //
+    // BUSY should be acquired by SmmStartupThisAp()
+    //
+    ASSERT (
+      !AcquireSpinLockOrFail (&mSmmMpSyncData->CpuData[CpuIndex].Busy)
+      );
+
+    //
+    // Invoke the scheduled procedure
+    //
+    (*mSmmMpSyncData->CpuData[CpuIndex].Procedure) (
+      (VOID*)mSmmMpSyncData->CpuData[CpuIndex].Parameter
+      );
+
+    //
+    // Release BUSY
+    //
+    ReleaseSpinLock (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
+  }
+
+  if (SmmCpuFeaturesNeedConfigureMtrrs()) {
+    //
+    // Notify BSP the readiness of this AP to program MTRRs
+    //
+    ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+
+    //
+    // Wait for the signal from BSP to program MTRRs
+    //
+    WaitForSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+    //
+    // Restore OS MTRRs
+    //
+    SmmCpuFeaturesReenableSmrr ();
+    MtrrSetAllMtrrs(&Mtrrs);
+  }
+
+  //
+  // Notify BSP the readiness of this AP to Reset states/semaphore for this processor
+  //
+  ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+
+  //
+  // Wait for the signal from BSP to Reset states/semaphore for this processor
+  //
+  WaitForSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+  //
+  // Reset states/semaphore for this processor
+  //
+  mSmmMpSyncData->CpuData[CpuIndex].Present = FALSE;
+
+  //
+  // Notify BSP the readiness of this AP to exit SMM
+  //
+  ReleaseSemaphore (&mSmmMpSyncData->CpuData[BspIndex].Run);
+
+}
+
+/**
+  Create 4G PageTable in SMRAM.
+
+  @param          ExtraPages       Additional page numbers besides for 4G memory
+  @return         PageTable Address
+
+**/
+UINT32
+Gen4GPageTable (
+  IN      UINTN                     ExtraPages
+  )
+{
+  VOID    *PageTable;
+  UINTN   Index;
+  UINT64  *Pte;
+  UINTN   PagesNeeded;
+  UINTN   Low2MBoundary;
+  UINTN   High2MBoundary;
+  UINTN   Pages;
+  UINTN   GuardPage;
+  UINT64  *Pdpte;
+  UINTN   PageIndex;
+  UINTN   PageAddress;
+
+  Low2MBoundary = 0;
+  High2MBoundary = 0;
+  PagesNeeded = 0;
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    //
+    // Add one more page for known good stack, then find the lower 2MB aligned address.
+    //
+    Low2MBoundary = (mSmmStackArrayBase + EFI_PAGE_SIZE) & ~(SIZE_2MB-1);
+    //
+    // Add two more pages for known good stack and stack guard page,
+    // then find the lower 2MB aligned address.
+    //
+    High2MBoundary = (mSmmStackArrayEnd - mSmmStackSize + EFI_PAGE_SIZE * 2) & ~(SIZE_2MB-1);
+    PagesNeeded = ((High2MBoundary - Low2MBoundary) / SIZE_2MB) + 1;
+  }
+  //
+  // Allocate the page table
+  //
+  PageTable = AllocatePages (ExtraPages + 5 + PagesNeeded);
+  ASSERT (PageTable != NULL);
+
+  PageTable = (VOID *)((UINTN)PageTable + EFI_PAGES_TO_SIZE (ExtraPages));
+  Pte = (UINT64*)PageTable;
+
+  //
+  // Zero out all page table entries first
+  //
+  ZeroMem (Pte, EFI_PAGES_TO_SIZE (1));
+
+  //
+  // Set Page Directory Pointers
+  //
+  for (Index = 0; Index < 4; Index++) {
+    Pte[Index] = (UINTN)PageTable + EFI_PAGE_SIZE * (Index + 1) + IA32_PG_P;
+  }
+  Pte += EFI_PAGE_SIZE / sizeof (*Pte);
+
+  //
+  // Fill in Page Directory Entries
+  //
+  for (Index = 0; Index < EFI_PAGE_SIZE * 4 / sizeof (*Pte); Index++) {
+    Pte[Index] = (Index << 21) + IA32_PG_PS + IA32_PG_RW + IA32_PG_P;
+  }
+
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    Pages = (UINTN)PageTable + EFI_PAGES_TO_SIZE (5);
+    GuardPage = mSmmStackArrayBase + EFI_PAGE_SIZE;
+    Pdpte = (UINT64*)PageTable;
+    for (PageIndex = Low2MBoundary; PageIndex <= High2MBoundary; PageIndex += SIZE_2MB) {
+      Pte = (UINT64*)(UINTN)(Pdpte[BitFieldRead32 ((UINT32)PageIndex, 30, 31)] & ~(EFI_PAGE_SIZE - 1));
+      Pte[BitFieldRead32 ((UINT32)PageIndex, 21, 29)] = (UINT64)Pages + IA32_PG_RW + IA32_PG_P;
+      //
+      // Fill in Page Table Entries
+      //
+      Pte = (UINT64*)Pages;
+      PageAddress = PageIndex;
+      for (Index = 0; Index < EFI_PAGE_SIZE / sizeof (*Pte); Index++) {
+        if (PageAddress == GuardPage) {
+          //
+          // Mark the guard page as non-present
+          //
+          Pte[Index] = PageAddress;
+          GuardPage += mSmmStackSize;
+          if (GuardPage > mSmmStackArrayEnd) {
+            GuardPage = 0;
+          }
+        } else {
+          Pte[Index] = PageAddress + IA32_PG_RW + IA32_PG_P;
+        }
+        PageAddress+= EFI_PAGE_SIZE;
+      }
+      Pages += EFI_PAGE_SIZE;
+    }
+  }
+
+  return (UINT32)(UINTN)PageTable;
+}
+
+/**
+  Set memory cache ability.
+
+  @param    PageTable              PageTable Address
+  @param    Address                Memory Address to change cache ability
+  @param    Cacheability           Cache ability to set
+
+**/
+VOID
+SetCacheability (
+  IN      UINT64                    *PageTable,
+  IN      UINTN                     Address,
+  IN      UINT8                     Cacheability
+  )
+{
+  UINTN   PTIndex;
+  VOID    *NewPageTableAddress;
+  UINT64  *NewPageTable;
+  UINTN   Index;
+
+  ASSERT ((Address & EFI_PAGE_MASK) == 0);
+
+  if (sizeof (UINTN) == sizeof (UINT64)) {
+    PTIndex = (UINTN)RShiftU64 (Address, 39) & 0x1ff;
+    ASSERT (PageTable[PTIndex] & IA32_PG_P);
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & gPhyMask);
+  }
+
+  PTIndex = (UINTN)RShiftU64 (Address, 30) & 0x1ff;
+  ASSERT (PageTable[PTIndex] & IA32_PG_P);
+  PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & gPhyMask);
+
+  //
+  // A perfect implementation should check the original cacheability with the
+  // one being set, and break a 2M page entry into pieces only when they
+  // disagreed.
+  //
+  PTIndex = (UINTN)RShiftU64 (Address, 21) & 0x1ff;
+  if ((PageTable[PTIndex] & IA32_PG_PS) != 0) {
+    //
+    // Allocate a page from SMRAM
+    //
+    NewPageTableAddress = AllocatePages (1);
+    ASSERT (NewPageTableAddress != NULL);
+
+    NewPageTable = (UINT64 *)NewPageTableAddress;
+
+    for (Index = 0; Index < 0x200; Index++) {
+      NewPageTable[Index] = PageTable[PTIndex];
+      if ((NewPageTable[Index] & IA32_PG_PAT_2M) != 0) {
+        NewPageTable[Index] &= ~((UINT64)IA32_PG_PAT_2M);
+        NewPageTable[Index] |= (UINT64)IA32_PG_PAT_4K;
+      }
+      NewPageTable[Index] |= (UINT64)(Index << EFI_PAGE_SHIFT);
+    }
+
+    PageTable[PTIndex] = ((UINTN)NewPageTableAddress & gPhyMask) | IA32_PG_P;
+  }
+
+  ASSERT (PageTable[PTIndex] & IA32_PG_P);
+  PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & gPhyMask);
+
+  PTIndex = (UINTN)RShiftU64 (Address, 12) & 0x1ff;
+  ASSERT (PageTable[PTIndex] & IA32_PG_P);
+  PageTable[PTIndex] &= ~((UINT64)((IA32_PG_PAT_4K | IA32_PG_CD | IA32_PG_WT)));
+  PageTable[PTIndex] |= (UINT64)Cacheability;
+}
+
+
+/**
+  Schedule a procedure to run on the specified CPU.
+
+  @param  Procedure                The address of the procedure to run
+  @param  CpuIndex                 Target CPU Index
+  @param  ProcArguments            The parameter to pass to the procedure
+
+  @retval EFI_INVALID_PARAMETER    CpuNumber not valid
+  @retval EFI_INVALID_PARAMETER    CpuNumber specifying BSP
+  @retval EFI_INVALID_PARAMETER    The AP specified by CpuNumber did not enter SMM
+  @retval EFI_INVALID_PARAMETER    The AP specified by CpuNumber is busy
+  @retval EFI_SUCCESS              The procedure has been successfully scheduled
+
+**/
+EFI_STATUS
+EFIAPI
+SmmStartupThisAp (
+  IN      EFI_AP_PROCEDURE          Procedure,
+  IN      UINTN                     CpuIndex,
+  IN OUT  VOID                      *ProcArguments OPTIONAL
+  )
+{
+  if (CpuIndex >= gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus ||
+      CpuIndex == gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu ||
+      !mSmmMpSyncData->CpuData[CpuIndex].Present ||
+      gSmmCpuPrivate->Operation[CpuIndex] == SmmCpuRemove ||
+      !AcquireSpinLockOrFail (&mSmmMpSyncData->CpuData[CpuIndex].Busy)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  mSmmMpSyncData->CpuData[CpuIndex].Procedure = Procedure;
+  mSmmMpSyncData->CpuData[CpuIndex].Parameter = ProcArguments;
+  ReleaseSemaphore (&mSmmMpSyncData->CpuData[CpuIndex].Run);
+
+  if (FeaturePcdGet (PcdCpuSmmBlockStartupThisAp)) {
+    AcquireSpinLock (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
+    ReleaseSpinLock (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  C function for SMI entry, each processor comes here upon SMI trigger.
+
+  @param    CpuIndex              CPU Index
+
+**/
+VOID
+EFIAPI
+SmiRendezvous (
+  IN      UINTN                     CpuIndex
+  )
+{
+  EFI_STATUS        Status;
+  BOOLEAN           ValidSmi;
+  BOOLEAN           IsBsp;
+  BOOLEAN           BspInProgress;
+  UINTN             Index;
+  UINTN             Cr2;
+
+  //
+  // Save Cr2 because Page Fault exception in SMM may override its value
+  //
+  Cr2 = AsmReadCr2 ();
+
+  //
+  // Perform CPU specific entry hooks
+  //
+  SmmCpuFeaturesRendezvousEntry (CpuIndex);
+
+  //
+  // Determine if this is a valid SMI
+  //
+  ValidSmi = PlatformValidSmi();
+
+  //
+  // Determine if BSP has been already in progress. Note this must be checked after
+  // ValidSmi because BSP may clear a valid SMI source after checking in.
+  //
+  BspInProgress = mSmmMpSyncData->InsideSmm;
+
+  if (!BspInProgress && !ValidSmi) {
+    //
+    // If we reach here, it means when we sampled the ValidSmi flag, SMI status had not
+    // been cleared by BSP in a new SMI run (so we have a truly invalid SMI), or SMI
+    // status had been cleared by BSP and an existing SMI run has almost ended. (Note
+    // we sampled ValidSmi flag BEFORE judging BSP-in-progress status.) In both cases, there
+    // is nothing we need to do.
+    //
+    goto Exit;
+  } else {
+    //
+    // Signal presence of this processor
+    //
+    if (ReleaseSemaphore (&mSmmMpSyncData->Counter) == 0) {
+      //
+      // BSP has already ended the synchronization, so QUIT!!!
+      //
+
+      //
+      // Wait for BSP's signal to finish SMI
+      //
+      while (mSmmMpSyncData->AllCpusInSync) {
+        CpuPause ();
+      }
+      goto Exit;
+    } else {
+
+      //
+      // The BUSY lock is initialized to Released state.
+      // This needs to be done early enough to be ready for BSP's SmmStartupThisAp() call.
+      // E.g., with Relaxed AP flow, SmmStartupThisAp() may be called immediately
+      // after AP's present flag is detected.
+      //
+      InitializeSpinLock (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
+    }
+
+    //
+    // Try to enable NX
+    //
+    if (mXdSupported) {
+      ActivateXd ();
+    }
+
+    if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+      ActivateSmmProfile (CpuIndex);
+    }
+
+    if (BspInProgress) {
+      //
+      // BSP has been elected. Follow AP path, regardless of ValidSmi flag
+      // as BSP may have cleared the SMI status
+      //
+      APHandler (CpuIndex, ValidSmi, mSmmMpSyncData->EffectiveSyncMode);
+    } else {
+      //
+      // We have a valid SMI
+      //
+
+      //
+      // Elect BSP
+      //
+      IsBsp = FALSE;
+      if (FeaturePcdGet (PcdCpuSmmEnableBspElection)) {
+        if (!mSmmMpSyncData->SwitchBsp || mSmmMpSyncData->CandidateBsp[CpuIndex]) {
+          //
+          // Call platform hook to do BSP election
+          //
+          Status = PlatformSmmBspElection (&IsBsp);
+          if (EFI_SUCCESS == Status) {
+            //
+            // Platform hook determines successfully
+            //
+            if (IsBsp) {
+              mSmmMpSyncData->BspIndex = (UINT32)CpuIndex;
+            }
+          } else {
+            //
+            // Platform hook fails to determine, use default BSP election method
+            //
+            InterlockedCompareExchange32 (
+              (UINT32*)&mSmmMpSyncData->BspIndex,
+              (UINT32)-1,
+              (UINT32)CpuIndex
+              );
+          }
+        }
+      }
+
+      //
+      // "mSmmMpSyncData->BspIndex == CpuIndex" means this is the BSP
+      //
+      if (mSmmMpSyncData->BspIndex == CpuIndex) {
+
+        //
+        // Clear last request for SwitchBsp.
+        //
+        if (mSmmMpSyncData->SwitchBsp) {
+          mSmmMpSyncData->SwitchBsp = FALSE;
+          for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+            mSmmMpSyncData->CandidateBsp[Index] = FALSE;
+          }
+        }
+
+        if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+          SmmProfileRecordSmiNum ();
+        }
+
+        //
+        // BSP Handler is always called with a ValidSmi == TRUE
+        //
+        BSPHandler (CpuIndex, mSmmMpSyncData->EffectiveSyncMode);
+
+      } else {
+        APHandler (CpuIndex, ValidSmi, mSmmMpSyncData->EffectiveSyncMode);
+      }
+    }
+
+    ASSERT (mSmmMpSyncData->CpuData[CpuIndex].Run == 0);
+
+    //
+    // Wait for BSP's signal to exit SMI
+    //
+    while (mSmmMpSyncData->AllCpusInSync) {
+      CpuPause ();
+    }
+  }
+
+Exit:
+  SmmCpuFeaturesRendezvousExit (CpuIndex);
+  //
+  // Restore Cr2
+  //
+  AsmWriteCr2 (Cr2);
+}
+
+
+/**
+  Initialize un-cacheable data.
+
+**/
+VOID
+EFIAPI
+InitializeMpSyncData (
+  VOID
+  )
+{
+  if (mSmmMpSyncData != NULL) {
+    ZeroMem (mSmmMpSyncData, mSmmMpSyncDataSize);
+    mSmmMpSyncData->CpuData = (SMM_CPU_DATA_BLOCK *)((UINT8 *)mSmmMpSyncData + sizeof (SMM_DISPATCHER_MP_SYNC_DATA));
+    mSmmMpSyncData->CandidateBsp = (BOOLEAN *)(mSmmMpSyncData->CpuData + gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus);
+    if (FeaturePcdGet (PcdCpuSmmEnableBspElection)) {
+      //
+      // Enable BSP election by setting BspIndex to -1
+      //
+      mSmmMpSyncData->BspIndex = (UINT32)-1;
+    }
+    mSmmMpSyncData->EffectiveSyncMode = (SMM_CPU_SYNC_MODE) PcdGet8 (PcdCpuSmmSyncMode);
+  }
+}
+
+/**
+  Initialize global data for MP synchronization.
+
+  @param Stacks       Base address of SMI stack buffer for all processors.
+  @param StackSize    Stack size for each processor in SMM.
+
+**/
+UINT32
+InitializeMpServiceData (
+  IN VOID        *Stacks,
+  IN UINTN       StackSize
+  )
+{
+  UINT32                    Cr3;
+  UINTN                     Index;
+  MTRR_SETTINGS             *Mtrr;
+  PROCESSOR_SMM_DESCRIPTOR  *Psd;
+  UINTN                     GdtTssTableSize;
+  UINT8                     *GdtTssTables;
+  IA32_SEGMENT_DESCRIPTOR   *GdtDescriptor;
+  UINTN                     TssBase;
+  UINTN                     GdtTableStepSize;
+
+  //
+  // Initialize physical address mask
+  // NOTE: Physical memory above virtual address limit is not supported !!!
+  //
+  AsmCpuid (0x80000008, (UINT32*)&Index, NULL, NULL, NULL);
+  gPhyMask = LShiftU64 (1, (UINT8)Index) - 1;
+  gPhyMask &= (1ull << 48) - EFI_PAGE_SIZE;
+
+  //
+  // Create page tables
+  //
+  Cr3 = SmmInitPageTable ();
+
+  GdtTssTables    = NULL;
+  GdtTssTableSize = 0;
+  GdtTableStepSize = 0;
+  //
+  // For X64 SMM, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
+  // on each SMI entry.
+  //
+  if (EFI_IMAGE_MACHINE_TYPE_SUPPORTED(EFI_IMAGE_MACHINE_X64)) {
+    GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE + 7) & ~7; // 8 bytes aligned
+    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
+    ASSERT (GdtTssTables != NULL);
+    GdtTableStepSize = GdtTssTableSize;
+
+    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
+      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE);
+      if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+        //
+        // Setup top of known good stack as IST1 for each processor.
+        //
+        *(UINTN *)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1 + TSS_X64_IST1_OFFSET) = (mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize);
+      }
+    }
+  } else if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+
+    //
+    // For IA32 SMM, if SMM Stack Guard feature is enabled, we use 2 TSS.
+    // in this case, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
+    // on each SMI entry.
+    //
+
+    //
+    // Enlarge GDT to contain 2 TSS descriptors
+    //
+    gcSmiGdtr.Limit += (UINT16)(2 * sizeof (IA32_SEGMENT_DESCRIPTOR));
+
+    GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE * 2 + 7) & ~7; // 8 bytes aligned
+    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
+    ASSERT (GdtTssTables != NULL);
+    GdtTableStepSize = GdtTssTableSize;
+
+    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
+      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE * 2);
+      //
+      // Fixup TSS descriptors
+      //
+      TssBase = (UINTN)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1);
+      GdtDescriptor = (IA32_SEGMENT_DESCRIPTOR *)(TssBase) - 2;
+      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
+      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
+      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
+
+      TssBase += TSS_SIZE;
+      GdtDescriptor++;
+      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
+      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
+      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
+      //
+      // Fixup TSS segments
+      //
+      // ESP as known good stack
+      //
+      *(UINTN *)(TssBase + TSS_IA32_ESP_OFFSET) =  mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize;
+      *(UINT32 *)(TssBase + TSS_IA32_CR3_OFFSET) = Cr3;
+    }
+  }
+
+  //
+  // Initialize PROCESSOR_SMM_DESCRIPTOR for each CPU
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    Psd = (PROCESSOR_SMM_DESCRIPTOR *)(VOID *)(UINTN)(mCpuHotPlugData.SmBase[Index] + SMM_PSD_OFFSET);
+    CopyMem (Psd, &gcPsd, sizeof (gcPsd));
+    if (EFI_IMAGE_MACHINE_TYPE_SUPPORTED (EFI_IMAGE_MACHINE_X64)) {
+      //
+      // For X64 SMM, set GDT to the copy allocated above.
+      //
+      Psd->SmmGdtPtr = (UINT64)(UINTN)(GdtTssTables + GdtTableStepSize * Index);
+    } else if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+      //
+      // For IA32 SMM, if SMM Stack Guard feature is enabled, set GDT to the copy allocated above.
+      //
+      Psd->SmmGdtPtr = (UINT64)(UINTN)(GdtTssTables + GdtTableStepSize * Index);
+      Psd->SmmGdtSize = gcSmiGdtr.Limit + 1;
+    }
+
+    //
+    // Install SMI handler
+    //
+    InstallSmiHandler (
+      Index,
+      (UINT32)mCpuHotPlugData.SmBase[Index],
+      (VOID*)((UINTN)Stacks + (StackSize * Index)),
+      StackSize,
+      (UINTN)Psd->SmmGdtPtr,
+      Psd->SmmGdtSize,
+      gcSmiIdtr.Base,
+      gcSmiIdtr.Limit + 1,
+      Cr3
+      );
+  }
+
+  //
+  // Initialize mSmmMpSyncData
+  //
+  mSmmMpSyncDataSize = sizeof (SMM_DISPATCHER_MP_SYNC_DATA) +
+                       (sizeof (SMM_CPU_DATA_BLOCK) + sizeof (BOOLEAN)) * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus;
+  mSmmMpSyncData = (SMM_DISPATCHER_MP_SYNC_DATA*) AllocatePages (EFI_SIZE_TO_PAGES (mSmmMpSyncDataSize));
+  ASSERT (mSmmMpSyncData != NULL);
+  InitializeMpSyncData ();
+
+  //
+  // Record current MTRR settings
+  //
+  ZeroMem(gSmiMtrrs, sizeof (gSmiMtrrs));
+  Mtrr =  (MTRR_SETTINGS*)gSmiMtrrs;
+  MtrrGetAllMtrrs (Mtrr);
+
+  return Cr3;
+}
+
+/**
+
+  Register the SMM Foundation entry point.
+
+  @param          This              Pointer to EFI_SMM_CONFIGURATION_PROTOCOL instance
+  @param          SmmEntryPoint     SMM Foundation EntryPoint
+
+  @retval         EFI_SUCCESS       Successfully to register SMM foundation entry point
+
+**/
+EFI_STATUS
+EFIAPI
+RegisterSmmEntry (
+  IN CONST EFI_SMM_CONFIGURATION_PROTOCOL  *This,
+  IN EFI_SMM_ENTRY_POINT                   SmmEntryPoint
+  )
+{
+  //
+  // Record SMM Foundation EntryPoint, later invoke it on SMI entry vector.
+  //
+  gSmmCpuPrivate->SmmCoreEntry = SmmEntryPoint;
+  return EFI_SUCCESS;
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
new file mode 100644
index 000000000000..0e39173cbbe8
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -0,0 +1,1489 @@
+/** @file
+Agent Module to load other modules to deploy SMM Entry Vector for X86 CPU.
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+//
+// SMM CPU Private Data structure that contains SMM Configuration Protocol
+// along its supporting fields.
+//
+SMM_CPU_PRIVATE_DATA  mSmmCpuPrivateData = {
+  SMM_CPU_PRIVATE_DATA_SIGNATURE,               // Signature
+  NULL,                                         // SmmCpuHandle
+  NULL,                                         // Pointer to ProcessorInfo array
+  NULL,                                         // Pointer to Operation array
+  NULL,                                         // Pointer to CpuSaveStateSize array
+  NULL,                                         // Pointer to CpuSaveState array
+  { {0} },                                      // SmmReservedSmramRegion
+  {
+    SmmStartupThisAp,                           // SmmCoreEntryContext.SmmStartupThisAp
+    0,                                          // SmmCoreEntryContext.CurrentlyExecutingCpu
+    0,                                          // SmmCoreEntryContext.NumberOfCpus
+    NULL,                                       // SmmCoreEntryContext.CpuSaveStateSize
+    NULL                                        // SmmCoreEntryContext.CpuSaveState
+  },
+  NULL,                                         // SmmCoreEntry
+  {
+    mSmmCpuPrivateData.SmmReservedSmramRegion,  // SmmConfiguration.SmramReservedRegions
+    RegisterSmmEntry                            // SmmConfiguration.RegisterSmmEntry
+  },
+};
+
+CPU_HOT_PLUG_DATA mCpuHotPlugData = {
+  CPU_HOT_PLUG_DATA_REVISION_1,                 // Revision
+  0,                                            // Array Length of SmBase and APIC ID
+  NULL,                                         // Pointer to APIC ID array
+  NULL,                                         // Pointer to SMBASE array
+  0,                                            // Reserved
+  0,                                            // SmrrBase
+  0                                             // SmrrSize
+};
+
+//
+// Global pointer used to access mSmmCpuPrivateData from outside and inside SMM
+//
+SMM_CPU_PRIVATE_DATA  *gSmmCpuPrivate = &mSmmCpuPrivateData;
+
+//
+// SMM Relocation variables
+//
+volatile BOOLEAN  *mRebased;
+volatile BOOLEAN  mIsBsp;
+
+///
+/// Handle for the SMM CPU Protocol
+///
+EFI_HANDLE  mSmmCpuHandle = NULL;
+
+///
+/// SMM CPU Protocol instance
+///
+EFI_SMM_CPU_PROTOCOL  mSmmCpu  = {
+  SmmReadSaveState,
+  SmmWriteSaveState
+};
+
+EFI_CPU_INTERRUPT_HANDLER   mExternalVectorTable[EXCEPTION_VECTOR_NUMBER];
+
+///
+/// SMM CPU Save State Protocol instance
+///
+EFI_SMM_CPU_SAVE_STATE_PROTOCOL  mSmmCpuSaveState = {
+  NULL
+};
+
+//
+// SMM stack information
+//
+UINTN mSmmStackArrayBase;
+UINTN mSmmStackArrayEnd;
+UINTN mSmmStackSize;
+
+//
+// Pointer to structure used during S3 Resume
+//
+SMM_S3_RESUME_STATE *mSmmS3ResumeState = NULL;
+
+UINTN mMaxNumberOfCpus = 1;
+UINTN mNumberOfCpus = 1;
+
+//
+// SMM ready to lock flag
+//
+BOOLEAN mSmmReadyToLock = FALSE;
+
+//
+// Global used to cache PCD for SMM Code Access Check enable
+//
+BOOLEAN                  mSmmCodeAccessCheckEnable = FALSE;
+
+//
+// Spin lock used to serialize setting of SMM Code Access Check feature
+//
+SPIN_LOCK                mConfigSmmCodeAccessCheckLock;
+
+/**
+  Initialize IDT to setup exception handlers for SMM.
+
+**/
+VOID
+InitializeSmmIdt (
+  VOID
+  )
+{
+  EFI_STATUS               Status;
+  BOOLEAN                  InterruptState;
+  IA32_DESCRIPTOR          DxeIdtr;
+  //
+  // Disable Interrupt and save DXE IDT table
+  //
+  InterruptState = SaveAndDisableInterrupts ();
+  AsmReadIdtr (&DxeIdtr);
+  //
+  // Load SMM temporary IDT table
+  //
+  AsmWriteIdtr (&gcSmiIdtr);
+  //
+  // Setup SMM default exception handlers, SMM IDT table
+  // will be updated and saved in gcSmiIdtr
+  //
+  Status = InitializeCpuExceptionHandlers (NULL);
+  ASSERT_EFI_ERROR (Status);
+  //
+  // Restore DXE IDT table and CPU interrupt
+  //
+  AsmWriteIdtr ((IA32_DESCRIPTOR *) &DxeIdtr);
+  SetInterruptState (InterruptState);
+}
+
+/**
+  Search module name by input IP address and output it.
+
+  @param CallerIpAddress   Caller instruction pointer.
+
+**/
+VOID
+DumpModuleInfoByIp (
+  IN  UINTN              CallerIpAddress
+  )
+{
+  UINTN                                Pe32Data;
+  EFI_IMAGE_DOS_HEADER                 *DosHdr;
+  EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION  Hdr;
+  VOID                                 *PdbPointer;
+  UINT64                               DumpIpAddress;
+
+  //
+  // Find Image Base
+  //
+  Pe32Data = CallerIpAddress & ~(SIZE_4KB - 1);
+  while (Pe32Data != 0) {
+    DosHdr = (EFI_IMAGE_DOS_HEADER *) Pe32Data;
+    if (DosHdr->e_magic == EFI_IMAGE_DOS_SIGNATURE) {
+      //
+      // DOS image header is present, so read the PE header after the DOS image header.
+      //
+      Hdr.Pe32 = (EFI_IMAGE_NT_HEADERS32 *)(Pe32Data + (UINTN) ((DosHdr->e_lfanew) & 0x0ffff));
+      //
+      // Make sure PE header address does not overflow and is less than the initial address.
+      //
+      if (((UINTN)Hdr.Pe32 > Pe32Data) && ((UINTN)Hdr.Pe32 < CallerIpAddress)) {
+        if (Hdr.Pe32->Signature == EFI_IMAGE_NT_SIGNATURE) {
+          //
+          // It's PE image.
+          //
+          break;
+        }
+      }
+    }
+
+    //
+    // Not found the image base, check the previous aligned address
+    //
+    Pe32Data -= SIZE_4KB;
+  }
+
+  DumpIpAddress = CallerIpAddress;
+  DEBUG ((EFI_D_ERROR, "It is invoked from the instruction before IP(0x%lx)", DumpIpAddress));
+
+  if (Pe32Data != 0) {
+    PdbPointer = PeCoffLoaderGetPdbPointer ((VOID *) Pe32Data);
+    if (PdbPointer != NULL) {
+      DEBUG ((EFI_D_ERROR, " in module (%a)", PdbPointer));
+    }
+  }
+}
+
+/**
+  Read information from the CPU save state.
+
+  @param  This      EFI_SMM_CPU_PROTOCOL instance
+  @param  Width     The number of bytes to read from the CPU save state.
+  @param  Register  Specifies the CPU register to read form the save state.
+  @param  CpuIndex  Specifies the zero-based index of the CPU save state.
+  @param  Buffer    Upon return, this holds the CPU register value read from the save state.
+
+  @retval EFI_SUCCESS   The register was read from Save State
+  @retval EFI_NOT_FOUND The register is not defined for the Save State of Processor
+  @retval EFI_INVALID_PARAMTER   This or Buffer is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmReadSaveState (
+  IN CONST EFI_SMM_CPU_PROTOCOL         *This,
+  IN UINTN                              Width,
+  IN EFI_SMM_SAVE_STATE_REGISTER        Register,
+  IN UINTN                              CpuIndex,
+  OUT VOID                              *Buffer
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Retrieve pointer to the specified CPU's SMM Save State buffer
+  //
+  if ((CpuIndex >= gSmst->NumberOfCpus) || (Buffer == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Check for special EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID) {
+    //
+    // The pseudo-register only supports the 64-bit size specified by Width.
+    //
+    if (Width != sizeof (UINT64)) {
+      return EFI_INVALID_PARAMETER;
+    }
+    //
+    // If the processor is in SMM at the time the SMI occurred,
+    // the pseudo register value for EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID is returned in Buffer.
+    // Otherwise, EFI_NOT_FOUND is returned.
+    //
+    if (mSmmMpSyncData->CpuData[CpuIndex].Present) {
+      *(UINT64 *)Buffer = gSmmCpuPrivate->ProcessorInfo[CpuIndex].ProcessorId;
+      return EFI_SUCCESS;
+    } else {
+      return EFI_NOT_FOUND;
+    }
+  }
+
+  if (!mSmmMpSyncData->CpuData[CpuIndex].Present) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = SmmCpuFeaturesReadSaveStateRegister (CpuIndex, Register, Width, Buffer);
+  if (Status == EFI_UNSUPPORTED) {
+    Status = ReadSaveStateRegister (CpuIndex, Register, Width, Buffer);
+  }
+  return Status;
+}
+
+/**
+  Write data to the CPU save state.
+
+  @param  This      EFI_SMM_CPU_PROTOCOL instance
+  @param  Width     The number of bytes to read from the CPU save state.
+  @param  Register  Specifies the CPU register to write to the save state.
+  @param  CpuIndex  Specifies the zero-based index of the CPU save state
+  @param  Buffer    Upon entry, this holds the new CPU register value.
+
+  @retval EFI_SUCCESS   The register was written from Save State
+  @retval EFI_NOT_FOUND The register is not defined for the Save State of Processor
+  @retval EFI_INVALID_PARAMTER   ProcessorIndex or Width is not correct
+
+**/
+EFI_STATUS
+EFIAPI
+SmmWriteSaveState (
+  IN CONST EFI_SMM_CPU_PROTOCOL         *This,
+  IN UINTN                              Width,
+  IN EFI_SMM_SAVE_STATE_REGISTER        Register,
+  IN UINTN                              CpuIndex,
+  IN CONST VOID                         *Buffer
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Retrieve pointer to the specified CPU's SMM Save State buffer
+  //
+  if ((CpuIndex >= gSmst->NumberOfCpus) || (Buffer == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Writes to EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID are ignored
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_PROCESSOR_ID) {
+    return EFI_SUCCESS;
+  }
+
+  if (!mSmmMpSyncData->CpuData[CpuIndex].Present) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = SmmCpuFeaturesWriteSaveStateRegister (CpuIndex, Register, Width, Buffer);
+  if (Status == EFI_UNSUPPORTED) {
+    Status = WriteSaveStateRegister (CpuIndex, Register, Width, Buffer);
+  }
+  return Status;
+}
+
+
+/**
+  C function for SMI handler. To change all processor's SMMBase Register.
+
+**/
+VOID
+EFIAPI
+SmmInitHandler (
+  VOID
+  )
+{
+  UINT32                            ApicId;
+  UINTN                             Index;
+
+  //
+  // Update SMM IDT entries' code segment and load IDT
+  //
+  AsmWriteIdtr (&gcSmiIdtr);
+  ApicId = GetApicId ();
+
+  ASSERT (mNumberOfCpus <= PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+
+  for (Index = 0; Index < mNumberOfCpus; Index++) {
+    if (ApicId == (UINT32)gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId) {
+      //
+      // Initialize SMM specific features on the currently executing CPU
+      //
+      SmmCpuFeaturesInitializeProcessor (
+        Index,
+        mIsBsp,
+        gSmmCpuPrivate->ProcessorInfo,
+        &mCpuHotPlugData
+        );
+
+      if (mIsBsp) {
+        //
+        // BSP rebase is already done above.
+        // Initialize private data during S3 resume
+        //
+        InitializeMpSyncData ();
+      }
+
+      //
+      // Hook return after RSM to set SMM re-based flag
+      //
+      SemaphoreHook (Index, &mRebased[Index]);
+
+      return;
+    }
+  }
+  ASSERT (FALSE);
+}
+
+/**
+  Relocate SmmBases for each processor.
+
+  Execute on first boot and all S3 resumes
+
+**/
+VOID
+EFIAPI
+SmmRelocateBases (
+  VOID
+  )
+{
+  UINT8                 BakBuf[BACK_BUF_SIZE];
+  SMRAM_SAVE_STATE_MAP  BakBuf2;
+  SMRAM_SAVE_STATE_MAP  *CpuStatePtr;
+  UINT8                 *U8Ptr;
+  UINT32                ApicId;
+  UINTN                 Index;
+  UINTN                 BspIndex;
+
+  //
+  // Make sure the reserved size is large enough for procedure SmmInitTemplate.
+  //
+  ASSERT (sizeof (BakBuf) >= gcSmmInitSize);
+
+  //
+  // Patch ASM code template with current CR0, CR3, and CR4 values
+  //
+  gSmmCr0 = (UINT32)AsmReadCr0 ();
+  gSmmCr3 = (UINT32)AsmReadCr3 ();
+  gSmmCr4 = (UINT32)AsmReadCr4 ();
+
+  //
+  // Patch GDTR for SMM base relocation
+  //
+  gcSmiInitGdtr.Base  = gcSmiGdtr.Base;
+  gcSmiInitGdtr.Limit = gcSmiGdtr.Limit;
+
+  U8Ptr = (UINT8*)(UINTN)(SMM_DEFAULT_SMBASE + SMM_HANDLER_OFFSET);
+  CpuStatePtr = (SMRAM_SAVE_STATE_MAP *)(UINTN)(SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET);
+
+  //
+  // Backup original contents at address 0x38000
+  //
+  CopyMem (BakBuf, U8Ptr, sizeof (BakBuf));
+  CopyMem (&BakBuf2, CpuStatePtr, sizeof (BakBuf2));
+
+  //
+  // Load image for relocation
+  //
+  CopyMem (U8Ptr, gcSmmInitTemplate, gcSmmInitSize);
+
+  //
+  // Retrieve the local APIC ID of current processor
+  //
+  ApicId = GetApicId ();
+
+  //
+  // Relocate SM bases for all APs
+  // This is APs' 1st SMI - rebase will be done here, and APs' default SMI handler will be overridden by gcSmmInitTemplate
+  //
+  mIsBsp   = FALSE;
+  BspIndex = (UINTN)-1;
+  for (Index = 0; Index < mNumberOfCpus; Index++) {
+    mRebased[Index] = FALSE;
+    if (ApicId != (UINT32)gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId) {
+      SendSmiIpi ((UINT32)gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId);
+      //
+      // Wait for this AP to finish its 1st SMI
+      //
+      while (!mRebased[Index]);
+    } else {
+      //
+      // BSP will be Relocated later
+      //
+      BspIndex = Index;
+    }
+  }
+
+  //
+  // Relocate BSP's SMM base
+  //
+  ASSERT (BspIndex != (UINTN)-1);
+  mIsBsp = TRUE;
+  SendSmiIpi (ApicId);
+  //
+  // Wait for the BSP to finish its 1st SMI
+  //
+  while (!mRebased[BspIndex]);
+
+  //
+  // Restore contents at address 0x38000
+  //
+  CopyMem (CpuStatePtr, &BakBuf2, sizeof (BakBuf2));
+  CopyMem (U8Ptr, BakBuf, sizeof (BakBuf));
+}
+
+/**
+  Perform SMM initialization for all processors in the S3 boot path.
+
+  For a native platform, MP initialization in the S3 boot path is also performed in this function.
+**/
+VOID
+EFIAPI
+SmmRestoreCpu (
+  VOID
+  )
+{
+  SMM_S3_RESUME_STATE           *SmmS3ResumeState;
+  IA32_DESCRIPTOR               Ia32Idtr;
+  IA32_DESCRIPTOR               X64Idtr;
+  IA32_IDT_GATE_DESCRIPTOR      IdtEntryTable[EXCEPTION_VECTOR_NUMBER];
+  EFI_STATUS                    Status;
+
+  DEBUG ((EFI_D_INFO, "SmmRestoreCpu()\n"));
+
+  //
+  // See if there is enough context to resume PEI Phase
+  //
+  if (mSmmS3ResumeState == NULL) {
+    DEBUG ((EFI_D_ERROR, "No context to return to PEI Phase\n"));
+    CpuDeadLoop ();
+  }
+
+  SmmS3ResumeState = mSmmS3ResumeState;
+  ASSERT (SmmS3ResumeState != NULL);
+
+  if (SmmS3ResumeState->Signature == SMM_S3_RESUME_SMM_64) {
+    //
+    // Save the IA32 IDT Descriptor
+    //
+    AsmReadIdtr ((IA32_DESCRIPTOR *) &Ia32Idtr);
+
+    //
+    // Setup X64 IDT table
+    //
+    ZeroMem (IdtEntryTable, sizeof (IA32_IDT_GATE_DESCRIPTOR) * 32);
+    X64Idtr.Base = (UINTN) IdtEntryTable;
+    X64Idtr.Limit = (UINT16) (sizeof (IA32_IDT_GATE_DESCRIPTOR) * 32 - 1);
+    AsmWriteIdtr ((IA32_DESCRIPTOR *) &X64Idtr);
+
+    //
+    // Setup the default exception handler
+    //
+    Status = InitializeCpuExceptionHandlers (NULL);
+    ASSERT_EFI_ERROR (Status);
+
+    //
+    // Initialize Debug Agent to support source level debug
+    //
+    InitializeDebugAgent (DEBUG_AGENT_INIT_THUNK_PEI_IA32TOX64, (VOID *)&Ia32Idtr, NULL);
+  }
+
+  //
+  // Do below CPU things for native platform only
+  //
+  if (!FeaturePcdGet(PcdFrameworkCompatibilitySupport)) {
+    //
+    // Skip initialization if mAcpiCpuData is not valid
+    //
+    if (mAcpiCpuData.NumberOfCpus > 0) {
+      //
+      // First time microcode load and restore MTRRs
+      //
+      EarlyInitializeCpu ();
+    }
+  }
+
+  //
+  // Restore SMBASE for BSP and all APs
+  //
+  SmmRelocateBases ();
+
+  //
+  // Do below CPU things for native platform only
+  //
+  if (!FeaturePcdGet(PcdFrameworkCompatibilitySupport)) {
+    //
+    // Skip initialization if mAcpiCpuData is not valid
+    //
+    if (mAcpiCpuData.NumberOfCpus > 0) {
+      //
+      // Restore MSRs for BSP and all APs
+      //
+      InitializeCpu ();
+    }
+  }
+
+  //
+  // Set a flag to restore SMM configuration in S3 path.
+  //
+  mRestoreSmmConfigurationInS3 = TRUE;
+
+  DEBUG (( EFI_D_INFO, "SMM S3 Return CS                = %x\n", SmmS3ResumeState->ReturnCs));
+  DEBUG (( EFI_D_INFO, "SMM S3 Return Entry Point       = %x\n", SmmS3ResumeState->ReturnEntryPoint));
+  DEBUG (( EFI_D_INFO, "SMM S3 Return Context1          = %x\n", SmmS3ResumeState->ReturnContext1));
+  DEBUG (( EFI_D_INFO, "SMM S3 Return Context2          = %x\n", SmmS3ResumeState->ReturnContext2));
+  DEBUG (( EFI_D_INFO, "SMM S3 Return Stack Pointer     = %x\n", SmmS3ResumeState->ReturnStackPointer));
+
+  //
+  // If SMM is in 32-bit mode, then use SwitchStack() to resume PEI Phase
+  //
+  if (SmmS3ResumeState->Signature == SMM_S3_RESUME_SMM_32) {
+    DEBUG ((EFI_D_INFO, "Call SwitchStack() to return to S3 Resume in PEI Phase\n"));
+
+    SwitchStack (
+      (SWITCH_STACK_ENTRY_POINT)(UINTN)SmmS3ResumeState->ReturnEntryPoint,
+      (VOID *)(UINTN)SmmS3ResumeState->ReturnContext1,
+      (VOID *)(UINTN)SmmS3ResumeState->ReturnContext2,
+      (VOID *)(UINTN)SmmS3ResumeState->ReturnStackPointer
+      );
+  }
+
+  //
+  // If SMM is in 64-bit mode, then use AsmDisablePaging64() to resume PEI Phase
+  //
+  if (SmmS3ResumeState->Signature == SMM_S3_RESUME_SMM_64) {
+    DEBUG ((EFI_D_INFO, "Call AsmDisablePaging64() to return to S3 Resume in PEI Phase\n"));
+    //
+    // Disable interrupt of Debug timer, since new IDT table is for IA32 and will not work in long mode.
+    //
+    SaveAndSetDebugTimerInterrupt (FALSE);
+    //
+    // Restore IA32 IDT table
+    //
+    AsmWriteIdtr ((IA32_DESCRIPTOR *) &Ia32Idtr);
+    AsmDisablePaging64 (
+      SmmS3ResumeState->ReturnCs,
+      (UINT32)SmmS3ResumeState->ReturnEntryPoint,
+      (UINT32)SmmS3ResumeState->ReturnContext1,
+      (UINT32)SmmS3ResumeState->ReturnContext2,
+      (UINT32)SmmS3ResumeState->ReturnStackPointer
+      );
+  }
+
+  //
+  // Can not resume PEI Phase
+  //
+  DEBUG ((EFI_D_ERROR, "No context to return to PEI Phase\n"));
+  CpuDeadLoop ();
+}
+
+/**
+  Copy register table from ACPI NVS memory into SMRAM.
+
+  @param[in] DestinationRegisterTableList  Points to destination register table.
+  @param[in] SourceRegisterTableList       Points to source register table.
+  @param[in] NumberOfCpus                  Number of CPUs.
+
+**/
+VOID
+CopyRegisterTable (
+  IN CPU_REGISTER_TABLE         *DestinationRegisterTableList,
+  IN CPU_REGISTER_TABLE         *SourceRegisterTableList,
+  IN UINT32                     NumberOfCpus
+  )
+{
+  UINTN                      Index;
+  UINTN                      Index1;
+  CPU_REGISTER_TABLE_ENTRY   *RegisterTableEntry;
+
+  CopyMem (DestinationRegisterTableList, SourceRegisterTableList, NumberOfCpus * sizeof (CPU_REGISTER_TABLE));
+  for (Index = 0; Index < NumberOfCpus; Index++) {
+    DestinationRegisterTableList[Index].RegisterTableEntry = AllocatePool (DestinationRegisterTableList[Index].AllocatedSize);
+    ASSERT (DestinationRegisterTableList[Index].RegisterTableEntry != NULL);
+    CopyMem (DestinationRegisterTableList[Index].RegisterTableEntry, SourceRegisterTableList[Index].RegisterTableEntry, DestinationRegisterTableList[Index].AllocatedSize);
+    //
+    // Go though all MSRs in register table to initialize MSR spin lock
+    //
+    RegisterTableEntry = DestinationRegisterTableList[Index].RegisterTableEntry;
+    for (Index1 = 0; Index1 < DestinationRegisterTableList[Index].TableLength; Index1++, RegisterTableEntry++) {
+      if ((RegisterTableEntry->RegisterType == Msr) && (RegisterTableEntry->ValidBitLength < 64)) {
+        //
+        // Initialize MSR spin lock only for those MSRs need bit field writing
+        //
+        InitMsrSpinLockByIndex (RegisterTableEntry->Index);
+      }
+    }
+  }
+}
+
+/**
+  SMM Ready To Lock event notification handler.
+
+  The CPU S3 data is copied to SMRAM for security and mSmmReadyToLock is set to
+  perform additional lock actions that must be performed from SMM on the next SMI.
+
+  @param[in] Protocol   Points to the protocol's unique identifier.
+  @param[in] Interface  Points to the interface instance.
+  @param[in] Handle     The handle on which the interface was installed.
+
+  @retval EFI_SUCCESS   Notification handler runs successfully.
+ **/
+EFI_STATUS
+EFIAPI
+SmmReadyToLockEventNotify (
+  IN CONST EFI_GUID  *Protocol,
+  IN VOID            *Interface,
+  IN EFI_HANDLE      Handle
+  )
+{
+  ACPI_CPU_DATA              *AcpiCpuData;
+  IA32_DESCRIPTOR            *Gdtr;
+  IA32_DESCRIPTOR            *Idtr;
+
+  //
+  // Prevent use of mAcpiCpuData by initialize NumberOfCpus to 0
+  //
+  mAcpiCpuData.NumberOfCpus = 0;
+
+  //
+  // If FrameworkCompatibilitySspport is enabled, then do not copy CPU S3 Data into SMRAM
+  //
+  if (FeaturePcdGet (PcdFrameworkCompatibilitySupport)) {
+    goto Done;
+  }
+
+  //
+  // If PcdCpuS3DataAddress was never set, then do not copy CPU S3 Data into SMRAM
+  //
+  AcpiCpuData = (ACPI_CPU_DATA *)(UINTN)PcdGet64 (PcdCpuS3DataAddress);
+  if (AcpiCpuData == 0) {
+    goto Done;
+  }
+
+  //
+  // For a native platform, copy the CPU S3 data into SMRAM for use on CPU S3 Resume.
+  //
+  CopyMem (&mAcpiCpuData, AcpiCpuData, sizeof (mAcpiCpuData));
+
+  mAcpiCpuData.MtrrTable = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePool (sizeof (MTRR_SETTINGS));
+  ASSERT (mAcpiCpuData.MtrrTable != 0);
+
+  CopyMem ((VOID *)(UINTN)mAcpiCpuData.MtrrTable, (VOID *)(UINTN)AcpiCpuData->MtrrTable, sizeof (MTRR_SETTINGS));
+
+  mAcpiCpuData.GdtrProfile = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePool (sizeof (IA32_DESCRIPTOR));
+  ASSERT (mAcpiCpuData.GdtrProfile != 0);
+
+  CopyMem ((VOID *)(UINTN)mAcpiCpuData.GdtrProfile, (VOID *)(UINTN)AcpiCpuData->GdtrProfile, sizeof (IA32_DESCRIPTOR));
+
+  mAcpiCpuData.IdtrProfile = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePool (sizeof (IA32_DESCRIPTOR));
+  ASSERT (mAcpiCpuData.IdtrProfile != 0);
+
+  CopyMem ((VOID *)(UINTN)mAcpiCpuData.IdtrProfile, (VOID *)(UINTN)AcpiCpuData->IdtrProfile, sizeof (IA32_DESCRIPTOR));
+
+  mAcpiCpuData.PreSmmInitRegisterTable = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePool (mAcpiCpuData.NumberOfCpus * sizeof (CPU_REGISTER_TABLE));
+  ASSERT (mAcpiCpuData.PreSmmInitRegisterTable != 0);
+
+  CopyRegisterTable (
+    (CPU_REGISTER_TABLE *)(UINTN)mAcpiCpuData.PreSmmInitRegisterTable,
+    (CPU_REGISTER_TABLE *)(UINTN)AcpiCpuData->PreSmmInitRegisterTable,
+    mAcpiCpuData.NumberOfCpus
+    );
+
+  mAcpiCpuData.RegisterTable = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePool (mAcpiCpuData.NumberOfCpus * sizeof (CPU_REGISTER_TABLE));
+  ASSERT (mAcpiCpuData.RegisterTable != 0);
+
+  CopyRegisterTable (
+    (CPU_REGISTER_TABLE *)(UINTN)mAcpiCpuData.RegisterTable,
+    (CPU_REGISTER_TABLE *)(UINTN)AcpiCpuData->RegisterTable,
+    mAcpiCpuData.NumberOfCpus
+    );
+
+  //
+  // Copy AP's GDT, IDT and Machine Check handler into SMRAM.
+  //
+  Gdtr = (IA32_DESCRIPTOR *)(UINTN)mAcpiCpuData.GdtrProfile;
+  Idtr = (IA32_DESCRIPTOR *)(UINTN)mAcpiCpuData.IdtrProfile;
+
+  mGdtForAp = AllocatePool ((Gdtr->Limit + 1) + (Idtr->Limit + 1) +  mAcpiCpuData.ApMachineCheckHandlerSize);
+  ASSERT (mGdtForAp != NULL);
+  mIdtForAp = (VOID *) ((UINTN)mGdtForAp + (Gdtr->Limit + 1));
+  mMachineCheckHandlerForAp = (VOID *) ((UINTN)mIdtForAp + (Idtr->Limit + 1));
+
+  CopyMem (mGdtForAp, (VOID *)Gdtr->Base, Gdtr->Limit + 1);
+  CopyMem (mIdtForAp, (VOID *)Idtr->Base, Idtr->Limit + 1);
+  CopyMem (mMachineCheckHandlerForAp, (VOID *)(UINTN)mAcpiCpuData.ApMachineCheckHandlerBase, mAcpiCpuData.ApMachineCheckHandlerSize);
+
+Done:
+  //
+  // Set SMM ready to lock flag and return
+  //
+  mSmmReadyToLock = TRUE;
+  return EFI_SUCCESS;
+}
+
+/**
+  The module Entry Point of the CPU SMM driver.
+
+  @param  ImageHandle    The firmware allocated handle for the EFI image.
+  @param  SystemTable    A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS    The entry point is executed successfully.
+  @retval Other          Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+PiCpuSmmEntry (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS                 Status;
+  EFI_MP_SERVICES_PROTOCOL   *MpServices;
+  UINTN                      NumberOfEnabledProcessors;
+  UINTN                      Index;
+  VOID                       *Buffer;
+  UINTN                      TileSize;
+  VOID                       *GuidHob;
+  EFI_SMRAM_DESCRIPTOR       *SmramDescriptor;
+  SMM_S3_RESUME_STATE        *SmmS3ResumeState;
+  UINT8                      *Stacks;
+  VOID                       *Registration;
+  UINT32                     RegEax;
+  UINT32                     RegEdx;
+  UINTN                      FamilyId;
+  UINTN                      ModelId;
+  UINT32                     Cr3;
+
+  //
+  // Initialize Debug Agent to support source level debug in SMM code
+  //
+  InitializeDebugAgent (DEBUG_AGENT_INIT_SMM, NULL, NULL);
+
+  //
+  // Report the start of CPU SMM initialization.
+  //
+  REPORT_STATUS_CODE (
+    EFI_PROGRESS_CODE,
+    EFI_COMPUTING_UNIT_HOST_PROCESSOR | EFI_CU_HP_PC_SMM_INIT
+    );
+
+  //
+  // Fix segment address of the long-mode-switch jump
+  //
+  if (sizeof (UINTN) == sizeof (UINT64)) {
+    gSmmJmpAddr.Segment = LONG_MODE_CODE_SEGMENT;
+  }
+
+  //
+  // Find out SMRR Base and SMRR Size
+  //
+  FindSmramInfo (&mCpuHotPlugData.SmrrBase, &mCpuHotPlugData.SmrrSize);
+
+  //
+  // Get MP Services Protocol
+  //
+  Status = SystemTable->BootServices->LocateProtocol (&gEfiMpServiceProtocolGuid, NULL, (VOID **)&MpServices);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Use MP Services Protocol to retrieve the number of processors and number of enabled processors
+  //
+  Status = MpServices->GetNumberOfProcessors (MpServices, &mNumberOfCpus, &NumberOfEnabledProcessors);
+  ASSERT_EFI_ERROR (Status);
+  ASSERT (mNumberOfCpus <= PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+
+  //
+  // If support CPU hot plug, PcdCpuSmmEnableBspElection should be set to TRUE.
+  // A constant BSP index makes no sense because it may be hot removed.
+  //
+  DEBUG_CODE (
+    if (FeaturePcdGet (PcdCpuHotPlugSupport)) {
+
+      ASSERT (FeaturePcdGet (PcdCpuSmmEnableBspElection));
+    }
+  );
+
+  //
+  // Save the PcdCpuSmmCodeAccessCheckEnable value into a global variable.
+  //
+  mSmmCodeAccessCheckEnable = PcdGetBool (PcdCpuSmmCodeAccessCheckEnable);
+  DEBUG ((EFI_D_INFO, "PcdCpuSmmCodeAccessCheckEnable = %d\n", mSmmCodeAccessCheckEnable));
+
+  //
+  // If support CPU hot plug, we need to allocate resources for possibly hot-added processors
+  //
+  if (FeaturePcdGet (PcdCpuHotPlugSupport)) {
+    mMaxNumberOfCpus = PcdGet32 (PcdCpuMaxLogicalProcessorNumber);
+  } else {
+    mMaxNumberOfCpus = mNumberOfCpus;
+  }
+  gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus = mMaxNumberOfCpus;
+
+  //
+  // The CPU save state and code for the SMI entry point are tiled within an SMRAM
+  // allocated buffer.  The minimum size of this buffer for a uniprocessor system
+  // is 32 KB, because the entry point is SMBASE + 32KB, and CPU save state area
+  // just below SMBASE + 64KB.  If more than one CPU is present in the platform,
+  // then the SMI entry point and the CPU save state areas can be tiles to minimize
+  // the total amount SMRAM required for all the CPUs.  The tile size can be computed
+  // by adding the   // CPU save state size, any extra CPU specific context, and
+  // the size of code that must be placed at the SMI entry point to transfer
+  // control to a C function in the native SMM execution mode.  This size is
+  // rounded up to the nearest power of 2 to give the tile size for a each CPU.
+  // The total amount of memory required is the maximum number of CPUs that
+  // platform supports times the tile size.  The picture below shows the tiling,
+  // where m is the number of tiles that fit in 32KB.
+  //
+  //  +-----------------------------+  <-- 2^n offset from Base of allocated buffer
+  //  |   CPU m+1 Save State        |
+  //  +-----------------------------+
+  //  |   CPU m+1 Extra Data        |
+  //  +-----------------------------+
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU 2m  SMI Entry         |
+  //  +#############################+  <-- Base of allocated buffer + 64 KB
+  //  |   CPU m-1 Save State        |
+  //  +-----------------------------+
+  //  |   CPU m-1 Extra Data        |
+  //  +-----------------------------+
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU 2m-1 SMI Entry        |
+  //  +=============================+  <-- 2^n offset from Base of allocated buffer
+  //  |   . . . . . . . . . . . .   |
+  //  +=============================+  <-- 2^n offset from Base of allocated buffer
+  //  |   CPU 2 Save State          |
+  //  +-----------------------------+
+  //  |   CPU 2 Extra Data          |
+  //  +-----------------------------+
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU m+1 SMI Entry         |
+  //  +=============================+  <-- Base of allocated buffer + 32 KB
+  //  |   CPU 1 Save State          |
+  //  +-----------------------------+
+  //  |   CPU 1 Extra Data          |
+  //  +-----------------------------+
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU m SMI Entry           |
+  //  +#############################+  <-- Base of allocated buffer + 32 KB == CPU 0 SMBASE + 64 KB
+  //  |   CPU 0 Save State          |
+  //  +-----------------------------+
+  //  |   CPU 0 Extra Data          |
+  //  +-----------------------------+
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU m-1 SMI Entry         |
+  //  +=============================+  <-- 2^n offset from Base of allocated buffer
+  //  |   . . . . . . . . . . . .   |
+  //  +=============================+  <-- 2^n offset from Base of allocated buffer
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU 1 SMI Entry           |
+  //  +=============================+  <-- 2^n offset from Base of allocated buffer
+  //  |   Padding                   |
+  //  +-----------------------------+
+  //  |   CPU 0 SMI Entry           |
+  //  +#############################+  <-- Base of allocated buffer == CPU 0 SMBASE + 32 KB
+  //
+
+  //
+  // Retrieve CPU Family
+  //
+  AsmCpuid (CPUID_VERSION_INFO, &RegEax, NULL, NULL, &RegEdx);
+  FamilyId = (RegEax >> 8) & 0xf;
+  ModelId = (RegEax >> 4) & 0xf;
+  if (FamilyId == 0x06 || FamilyId == 0x0f) {
+    ModelId = ModelId | ((RegEax >> 12) & 0xf0);
+  }
+
+  //
+  // Determine the mode of the CPU at the time an SMI occurs
+  //   Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  //   Volume 3C, Section 34.4.1.1
+  //
+  mSmmSaveStateRegisterLma = EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT;
+  if ((RegEdx & BIT29) != 0) {
+    mSmmSaveStateRegisterLma = EFI_SMM_SAVE_STATE_REGISTER_LMA_64BIT;
+  }
+  if (FamilyId == 0x06) {
+    if (ModelId == 0x17 || ModelId == 0x0f || ModelId == 0x1c) {
+      mSmmSaveStateRegisterLma = EFI_SMM_SAVE_STATE_REGISTER_LMA_64BIT;
+    }
+  }
+
+  //
+  // Compute tile size of buffer required to hold the CPU SMRAM Save State Map, extra CPU
+  // specific context in a PROCESSOR_SMM_DESCRIPTOR, and the SMI entry point.  This size
+  // is rounded up to nearest power of 2.
+  //
+  TileSize = sizeof (SMRAM_SAVE_STATE_MAP) + sizeof (PROCESSOR_SMM_DESCRIPTOR) + GetSmiHandlerSize () - 1;
+  TileSize = 2 * GetPowerOfTwo32 ((UINT32)TileSize);
+  DEBUG ((EFI_D_INFO, "SMRAM TileSize = %08x\n", TileSize));
+
+  //
+  // If the TileSize is larger than space available for the SMI Handler of CPU[i],
+  // the PROCESSOR_SMM_DESCRIPTOR of CPU[i+1] and the SMRAM Save State Map of CPU[i+1],
+  // the ASSERT().  If this ASSERT() is triggered, then the SMI Handler size must be
+  // reduced.
+  //
+  ASSERT (TileSize <= (SMRAM_SAVE_STATE_MAP_OFFSET + sizeof (SMRAM_SAVE_STATE_MAP) - SMM_HANDLER_OFFSET));
+
+  //
+  // Allocate buffer for all of the tiles.
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 34.11 SMBASE Relocation
+  //   For Pentium and Intel486 processors, the SMBASE values must be
+  //   aligned on a 32-KByte boundary or the processor will enter shutdown
+  //   state during the execution of a RSM instruction.
+  //
+  // Intel486 processors: FamilyId is 4
+  // Pentium processors : FamilyId is 5
+  //
+  if ((FamilyId == 4) || (FamilyId == 5)) {
+    Buffer = AllocateAlignedPages (EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1)), SIZE_32KB);
+  } else {
+    Buffer = AllocatePages (EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1)));
+  }
+  ASSERT (Buffer != NULL);
+
+  //
+  // Allocate buffer for pointers to array in  SMM_CPU_PRIVATE_DATA.
+  //
+  gSmmCpuPrivate->ProcessorInfo = (EFI_PROCESSOR_INFORMATION *)AllocatePool (sizeof (EFI_PROCESSOR_INFORMATION) * mMaxNumberOfCpus);
+  ASSERT (gSmmCpuPrivate->ProcessorInfo != NULL);
+
+  gSmmCpuPrivate->Operation = (SMM_CPU_OPERATION *)AllocatePool (sizeof (SMM_CPU_OPERATION) * mMaxNumberOfCpus);
+  ASSERT (gSmmCpuPrivate->Operation != NULL);
+
+  gSmmCpuPrivate->CpuSaveStateSize = (UINTN *)AllocatePool (sizeof (UINTN) * mMaxNumberOfCpus);
+  ASSERT (gSmmCpuPrivate->CpuSaveStateSize != NULL);
+
+  gSmmCpuPrivate->CpuSaveState = (VOID **)AllocatePool (sizeof (VOID *) * mMaxNumberOfCpus);
+  ASSERT (gSmmCpuPrivate->CpuSaveState != NULL);
+
+  mSmmCpuPrivateData.SmmCoreEntryContext.CpuSaveStateSize = gSmmCpuPrivate->CpuSaveStateSize;
+  mSmmCpuPrivateData.SmmCoreEntryContext.CpuSaveState     = gSmmCpuPrivate->CpuSaveState;
+  mSmmCpuSaveState.CpuSaveState = (EFI_SMM_CPU_STATE **)gSmmCpuPrivate->CpuSaveState;
+
+  //
+  // Allocate buffer for pointers to array in CPU_HOT_PLUG_DATA.
+  //
+  mCpuHotPlugData.ApicId = (UINT64 *)AllocatePool (sizeof (UINT64) * mMaxNumberOfCpus);
+  ASSERT (mCpuHotPlugData.ApicId != NULL);
+  mCpuHotPlugData.SmBase = (UINTN *)AllocatePool (sizeof (UINTN) * mMaxNumberOfCpus);
+  ASSERT (mCpuHotPlugData.SmBase != NULL);
+  mCpuHotPlugData.ArrayLength = (UINT32)mMaxNumberOfCpus;
+
+  //
+  // Retrieve APIC ID of each enabled processor from the MP Services protocol.
+  // Also compute the SMBASE address, CPU Save State address, and CPU Save state
+  // size for each CPU in the platform
+  //
+  for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
+    mCpuHotPlugData.SmBase[Index]          = (UINTN)Buffer + Index * TileSize - SMM_HANDLER_OFFSET;
+    gSmmCpuPrivate->CpuSaveStateSize[Index] = sizeof(SMRAM_SAVE_STATE_MAP);
+    gSmmCpuPrivate->CpuSaveState[Index]     = (VOID *)(mCpuHotPlugData.SmBase[Index] + SMRAM_SAVE_STATE_MAP_OFFSET);
+    gSmmCpuPrivate->Operation[Index] = SmmCpuNone;
+
+    if (Index < mNumberOfCpus) {
+      Status = MpServices->GetProcessorInfo (MpServices, Index, &gSmmCpuPrivate->ProcessorInfo[Index]);
+      ASSERT_EFI_ERROR (Status);
+      mCpuHotPlugData.ApicId[Index] = gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId;
+
+      DEBUG ((EFI_D_INFO, "CPU[%03x]  APIC ID=%04x  SMBASE=%08x  SaveState=%08x  Size=%08x\n",
+        Index,
+        (UINT32)gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId,
+        mCpuHotPlugData.SmBase[Index],
+        gSmmCpuPrivate->CpuSaveState[Index],
+        gSmmCpuPrivate->CpuSaveStateSize[Index]
+        ));
+    } else {
+      gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId = INVALID_APIC_ID;
+      mCpuHotPlugData.ApicId[Index] = INVALID_APIC_ID;
+    }
+  }
+
+  //
+  // Allocate SMI stacks for all processors.
+  //
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    //
+    // 2 more pages is allocated for each processor.
+    // one is guard page and the other is known good stack.
+    //
+    // +-------------------------------------------+-----+-------------------------------------------+
+    // | Known Good Stack | Guard Page | SMM Stack | ... | Known Good Stack | Guard Page | SMM Stack |
+    // +-------------------------------------------+-----+-------------------------------------------+
+    // |                                           |     |                                           |
+    // |<-------------- Processor 0 -------------->|     |<-------------- Processor n -------------->|
+    //
+    mSmmStackSize = EFI_PAGES_TO_SIZE (EFI_SIZE_TO_PAGES (PcdGet32 (PcdCpuSmmStackSize)) + 2);
+    Stacks = (UINT8 *) AllocatePages (gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus * (EFI_SIZE_TO_PAGES (PcdGet32 (PcdCpuSmmStackSize)) + 2));
+    ASSERT (Stacks != NULL);
+    mSmmStackArrayBase = (UINTN)Stacks;
+    mSmmStackArrayEnd = mSmmStackArrayBase + gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus * mSmmStackSize - 1;
+  } else {
+    mSmmStackSize = PcdGet32 (PcdCpuSmmStackSize);
+    Stacks = (UINT8 *) AllocatePages (EFI_SIZE_TO_PAGES (gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus * mSmmStackSize));
+    ASSERT (Stacks != NULL);
+  }
+
+  //
+  // Set SMI stack for SMM base relocation
+  //
+  gSmmInitStack = (UINTN) (Stacks + mSmmStackSize - sizeof (UINTN));
+
+  //
+  // Initialize IDT
+  //
+  InitializeSmmIdt ();
+
+  //
+  // Relocate SMM Base addresses to the ones allocated from SMRAM
+  //
+  mRebased = (BOOLEAN *)AllocateZeroPool (sizeof (BOOLEAN) * mMaxNumberOfCpus);
+  ASSERT (mRebased != NULL);
+  SmmRelocateBases ();
+
+  //
+  // Call hook for BSP to perform extra actions in normal mode after all
+  // SMM base addresses have been relocated on all CPUs
+  //
+  SmmCpuFeaturesSmmRelocationComplete ();
+
+  //
+  // SMM Time initialization
+  //
+  InitializeSmmTimer ();
+
+  //
+  // Initialize MP globals
+  //
+  Cr3 = InitializeMpServiceData (Stacks, mSmmStackSize);
+
+  //
+  // Fill in SMM Reserved Regions
+  //
+  gSmmCpuPrivate->SmmReservedSmramRegion[0].SmramReservedStart = 0;
+  gSmmCpuPrivate->SmmReservedSmramRegion[0].SmramReservedSize  = 0;
+
+  //
+  // Install the SMM Configuration Protocol onto a new handle on the handle database.
+  // The entire SMM Configuration Protocol is allocated from SMRAM, so only a pointer
+  // to an SMRAM address will be present in the handle database
+  //
+  Status = SystemTable->BootServices->InstallMultipleProtocolInterfaces (
+                                        &gSmmCpuPrivate->SmmCpuHandle,
+                                        &gEfiSmmConfigurationProtocolGuid, &gSmmCpuPrivate->SmmConfiguration,
+                                        NULL
+                                        );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Install the SMM CPU Protocol into SMM protocol database
+  //
+  Status = gSmst->SmmInstallProtocolInterface (
+                    &mSmmCpuHandle,
+                    &gEfiSmmCpuProtocolGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &mSmmCpu
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Expose address of CPU Hot Plug Data structure if CPU hot plug is supported.
+  //
+  if (FeaturePcdGet (PcdCpuHotPlugSupport)) {
+    PcdSet64 (PcdCpuHotPlugDataAddress, (UINT64)(UINTN)&mCpuHotPlugData);
+  }
+
+  //
+  // Initialize SMM CPU Services Support
+  //
+  Status = InitializeSmmCpuServices (mSmmCpuHandle);
+  ASSERT_EFI_ERROR (Status);
+
+  if (FeaturePcdGet (PcdFrameworkCompatibilitySupport)) {
+    //
+    // Install Framework SMM Save State Protocol into UEFI protocol database for backward compatibility
+    //
+    Status = SystemTable->BootServices->InstallMultipleProtocolInterfaces (
+                                          &gSmmCpuPrivate->SmmCpuHandle,
+                                          &gEfiSmmCpuSaveStateProtocolGuid,
+                                          &mSmmCpuSaveState,
+                                          NULL
+                                          );
+    ASSERT_EFI_ERROR (Status);
+    //
+    // The SmmStartupThisAp service in Framework SMST should always be non-null.
+    // Update SmmStartupThisAp pointer in PI SMST here so that PI/Framework SMM thunk
+    // can have it ready when constructing Framework SMST.
+    //
+    gSmst->SmmStartupThisAp = SmmStartupThisAp;
+  }
+
+  //
+  // register SMM Ready To Lock Protocol notification
+  //
+  Status = gSmst->SmmRegisterProtocolNotify (
+                    &gEfiSmmReadyToLockProtocolGuid,
+                    SmmReadyToLockEventNotify,
+                    &Registration
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  GuidHob = GetFirstGuidHob (&gEfiAcpiVariableGuid);
+  if (GuidHob != NULL) {
+    SmramDescriptor = (EFI_SMRAM_DESCRIPTOR *) GET_GUID_HOB_DATA (GuidHob);
+
+    DEBUG ((EFI_D_INFO, "SMM S3 SMRAM Structure = %x\n", SmramDescriptor));
+    DEBUG ((EFI_D_INFO, "SMM S3 Structure = %x\n", SmramDescriptor->CpuStart));
+
+    SmmS3ResumeState = (SMM_S3_RESUME_STATE *)(UINTN)SmramDescriptor->CpuStart;
+    ZeroMem (SmmS3ResumeState, sizeof (SMM_S3_RESUME_STATE));
+
+    mSmmS3ResumeState = SmmS3ResumeState;
+    SmmS3ResumeState->Smst = (EFI_PHYSICAL_ADDRESS)(UINTN)gSmst;
+
+    SmmS3ResumeState->SmmS3ResumeEntryPoint = (EFI_PHYSICAL_ADDRESS)(UINTN)SmmRestoreCpu;
+
+    SmmS3ResumeState->SmmS3StackSize = SIZE_32KB;
+    SmmS3ResumeState->SmmS3StackBase = (EFI_PHYSICAL_ADDRESS)(UINTN)AllocatePages (EFI_SIZE_TO_PAGES ((UINTN)SmmS3ResumeState->SmmS3StackSize));
+    if (SmmS3ResumeState->SmmS3StackBase == 0) {
+      SmmS3ResumeState->SmmS3StackSize = 0;
+    }
+
+    SmmS3ResumeState->SmmS3Cr0 = gSmmCr0;
+    SmmS3ResumeState->SmmS3Cr3 = Cr3;
+    SmmS3ResumeState->SmmS3Cr4 = gSmmCr4;
+
+    if (sizeof (UINTN) == sizeof (UINT64)) {
+      SmmS3ResumeState->Signature = SMM_S3_RESUME_SMM_64;
+    }
+    if (sizeof (UINTN) == sizeof (UINT32)) {
+      SmmS3ResumeState->Signature = SMM_S3_RESUME_SMM_32;
+    }
+  }
+
+  //
+  // Check XD and BTS features
+  //
+  CheckProcessorFeature ();
+
+  //
+  // Initialize SMM Profile feature
+  //
+  InitSmmProfile (Cr3);
+
+  //
+  // Patch SmmS3ResumeState->SmmS3Cr3
+  //
+  InitSmmS3Cr3 ();
+
+  DEBUG ((EFI_D_INFO, "SMM CPU Module exit from SMRAM with EFI_SUCCESS\n"));
+
+  return EFI_SUCCESS;
+}
+
+/**
+
+  Find out SMRAM information including SMRR base and SMRR size.
+
+  @param          SmrrBase          SMRR base
+  @param          SmrrSize          SMRR size
+
+**/
+VOID
+FindSmramInfo (
+  OUT UINT32   *SmrrBase,
+  OUT UINT32   *SmrrSize
+  )
+{
+  EFI_STATUS                        Status;
+  UINTN                             Size;
+  EFI_SMM_ACCESS2_PROTOCOL          *SmmAccess;
+  EFI_SMRAM_DESCRIPTOR              *CurrentSmramRange;
+  EFI_SMRAM_DESCRIPTOR              *SmramRanges;
+  UINTN                             SmramRangeCount;
+  UINTN                             Index;
+  UINT64                            MaxSize;
+  BOOLEAN                           Found;
+
+  //
+  // Get SMM Access Protocol
+  //
+  Status = gBS->LocateProtocol (&gEfiSmmAccess2ProtocolGuid, NULL, (VOID **)&SmmAccess);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Get SMRAM information
+  //
+  Size = 0;
+  Status = SmmAccess->GetCapabilities (SmmAccess, &Size, NULL);
+  ASSERT (Status == EFI_BUFFER_TOO_SMALL);
+
+  SmramRanges = (EFI_SMRAM_DESCRIPTOR *)AllocatePool (Size);
+  ASSERT (SmramRanges != NULL);
+
+  Status = SmmAccess->GetCapabilities (SmmAccess, &Size, SmramRanges);
+  ASSERT_EFI_ERROR (Status);
+
+  SmramRangeCount = Size / sizeof (EFI_SMRAM_DESCRIPTOR);
+
+  //
+  // Find the largest SMRAM range between 1MB and 4GB that is at least 256K - 4K in size
+  //
+  CurrentSmramRange = NULL;
+  for (Index = 0, MaxSize = SIZE_256KB - EFI_PAGE_SIZE; Index < SmramRangeCount; Index++) {
+    //
+    // Skip any SMRAM region that is already allocated, needs testing, or needs ECC initialization
+    //
+    if ((SmramRanges[Index].RegionState & (EFI_ALLOCATED | EFI_NEEDS_TESTING | EFI_NEEDS_ECC_INITIALIZATION)) != 0) {
+      continue;
+    }
+
+    if (SmramRanges[Index].CpuStart >= BASE_1MB) {
+      if ((SmramRanges[Index].CpuStart + SmramRanges[Index].PhysicalSize) <= BASE_4GB) {
+        if (SmramRanges[Index].PhysicalSize >= MaxSize) {
+          MaxSize = SmramRanges[Index].PhysicalSize;
+          CurrentSmramRange = &SmramRanges[Index];
+        }
+      }
+    }
+  }
+
+  ASSERT (CurrentSmramRange != NULL);
+
+  *SmrrBase = (UINT32)CurrentSmramRange->CpuStart;
+  *SmrrSize = (UINT32)CurrentSmramRange->PhysicalSize;
+
+  do {
+    Found = FALSE;
+    for (Index = 0; Index < SmramRangeCount; Index++) {
+      if (SmramRanges[Index].CpuStart < *SmrrBase && *SmrrBase == (SmramRanges[Index].CpuStart + SmramRanges[Index].PhysicalSize)) {
+        *SmrrBase = (UINT32)SmramRanges[Index].CpuStart;
+        *SmrrSize = (UINT32)(*SmrrSize + SmramRanges[Index].PhysicalSize);
+        Found = TRUE;
+      } else if ((*SmrrBase + *SmrrSize) == SmramRanges[Index].CpuStart && SmramRanges[Index].PhysicalSize > 0) {
+        *SmrrSize = (UINT32)(*SmrrSize + SmramRanges[Index].PhysicalSize);
+        Found = TRUE;
+      }
+    }
+  } while (Found);
+
+  DEBUG ((EFI_D_INFO, "SMRR Base: 0x%x, SMRR Size: 0x%x\n", *SmrrBase, *SmrrSize));
+}
+
+/**
+Configure SMM Code Access Check feature on an AP.
+SMM Feature Control MSR will be locked after configuration.
+
+@param[in,out] Buffer  Pointer to private data buffer.
+**/
+VOID
+EFIAPI
+ConfigSmmCodeAccessCheckOnCurrentProcessor (
+  IN OUT VOID  *Buffer
+  )
+{
+  UINTN   CpuIndex;
+  UINT64  SmmFeatureControlMsr;
+  UINT64  NewSmmFeatureControlMsr;
+
+  //
+  // Retrieve the CPU Index from the context passed in
+  //
+  CpuIndex = *(UINTN *)Buffer;
+
+  //
+  // Get the current SMM Feature Control MSR value
+  //
+  SmmFeatureControlMsr = SmmCpuFeaturesGetSmmRegister (CpuIndex, SmmRegFeatureControl);
+
+  //
+  // Compute the new SMM Feature Control MSR value
+  //
+  NewSmmFeatureControlMsr = SmmFeatureControlMsr;
+  if (mSmmCodeAccessCheckEnable) {
+    NewSmmFeatureControlMsr |= SMM_CODE_CHK_EN_BIT;
+  }
+  if (FeaturePcdGet (PcdCpuSmmFeatureControlMsrLock)) {
+    NewSmmFeatureControlMsr |= SMM_FEATURE_CONTROL_LOCK_BIT;
+  }
+
+  //
+  // Only set the SMM Feature Control MSR value if the new value is different than the current value
+  //
+  if (NewSmmFeatureControlMsr != SmmFeatureControlMsr) {
+    SmmCpuFeaturesSetSmmRegister (CpuIndex, SmmRegFeatureControl, NewSmmFeatureControlMsr);
+  }
+
+  //
+  // Release the spin lock user to serialize the updates to the SMM Feature Control MSR
+  //
+  ReleaseSpinLock (&mConfigSmmCodeAccessCheckLock);
+}
+
+/**
+Configure SMM Code Access Check feature for all processors.
+SMM Feature Control MSR will be locked after configuration.
+**/
+VOID
+ConfigSmmCodeAccessCheck (
+  VOID
+  )
+{
+  UINTN       Index;
+  EFI_STATUS  Status;
+
+  //
+  // Check to see if the Feature Control MSR is supported on this CPU
+  //
+  Index = gSmst->CurrentlyExecutingCpu;
+  if (!SmmCpuFeaturesIsSmmRegisterSupported (Index, SmmRegFeatureControl)) {
+    mSmmCodeAccessCheckEnable = FALSE;
+    return;
+  }
+
+  //
+  // Check to see if the CPU supports the SMM Code Access Check feature
+  // Do not access this MSR unless the CPU supports the SmmRegFeatureControl
+  //
+  if ((AsmReadMsr64 (EFI_MSR_SMM_MCA_CAP) & SMM_CODE_ACCESS_CHK_BIT) == 0) {
+    mSmmCodeAccessCheckEnable = FALSE;
+  }
+
+  //
+  // If the SMM Code Access Check feature is disabled and the Feature Control MSR
+  // is not being locked, then no additional work is required
+  //
+  if (!mSmmCodeAccessCheckEnable && !FeaturePcdGet (PcdCpuSmmFeatureControlMsrLock)) {
+    return;
+  }
+
+  //
+  // Initialize the lock used to serialize the MSR programming in BSP and all APs
+  //
+  InitializeSpinLock (&mConfigSmmCodeAccessCheckLock);
+
+  //
+  // Acquire Config SMM Code Access Check spin lock.  The BSP will release the
+  // spin lock when it is done executing ConfigSmmCodeAccessCheckOnCurrentProcessor().
+  //
+  AcquireSpinLock (&mConfigSmmCodeAccessCheckLock);
+
+  //
+  // Enable SMM Code Access Check feature on the BSP.
+  //
+  ConfigSmmCodeAccessCheckOnCurrentProcessor (&Index);
+
+  //
+  // Enable SMM Code Access Check feature for the APs.
+  //
+  for (Index = 0; Index < gSmst->NumberOfCpus; Index++) {
+    if (Index != gSmst->CurrentlyExecutingCpu) {
+
+      //
+      // Acquire Config SMM Code Access Check spin lock.  The AP will release the
+      // spin lock when it is done executing ConfigSmmCodeAccessCheckOnCurrentProcessor().
+      //
+      AcquireSpinLock (&mConfigSmmCodeAccessCheckLock);
+
+      //
+      // Call SmmStartupThisAp() to enable SMM Code Access Check on an AP.
+      //
+      Status = gSmst->SmmStartupThisAp (ConfigSmmCodeAccessCheckOnCurrentProcessor, Index, &Index);
+      ASSERT_EFI_ERROR (Status);
+
+      //
+      // Wait for the AP to release the Config SMM Code Access Check spin lock.
+      //
+      while (!AcquireSpinLockOrFail (&mConfigSmmCodeAccessCheckLock)) {
+        CpuPause ();
+      }
+
+      //
+      // Release the Config SMM Code Access Check spin lock.
+      //
+      ReleaseSpinLock (&mConfigSmmCodeAccessCheckLock);
+    }
+  }
+}
+
+/**
+  Perform the remaining tasks.
+
+**/
+VOID
+PerformRemainingTasks (
+  VOID
+  )
+{
+  if (mSmmReadyToLock) {
+    //
+    // Start SMM Profile feature
+    //
+    if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+      SmmProfileStart ();
+    }
+    //
+    // Create a mix of 2MB and 4KB page table. Update some memory ranges absent and execute-disable.
+    //
+    InitPaging ();
+    //
+    // Configure SMM Code Access Check feature if available.
+    //
+    ConfigSmmCodeAccessCheck ();
+
+    //
+    // Clean SMM ready to lock flag
+    //
+    mSmmReadyToLock = FALSE;
+  }
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
new file mode 100644
index 000000000000..9ea11894cdd5
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -0,0 +1,699 @@
+/** @file
+Agent Module to load other modules to deploy SMM Entry Vector for X86 CPU.
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _CPU_PISMMCPUDXESMM_H_
+#define _CPU_PISMMCPUDXESMM_H_
+
+#include <PiSmm.h>
+
+#include <Protocol/MpService.h>
+#include <Protocol/SmmConfiguration.h>
+#include <Protocol/SmmCpu.h>
+#include <Protocol/SmmAccess2.h>
+#include <Protocol/SmmCpuSaveState.h>
+#include <Protocol/SmmReadyToLock.h>
+#include <Protocol/SmmCpuService.h>
+
+#include <Guid/AcpiS3Context.h>
+
+#include <Library/BaseLib.h>
+#include <Library/IoLib.h>
+#include <Library/TimerLib.h>
+#include <Library/SmmLib.h>
+#include <Library/SynchronizationLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PcdLib.h>
+#include <Library/CacheMaintenanceLib.h>
+#include <Library/MtrrLib.h>
+#include <Library/SmmCpuPlatformHookLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Library/DebugAgentLib.h>
+#include <Library/HobLib.h>
+#include <Library/LocalApicLib.h>
+#include <Library/UefiCpuLib.h>
+#include <Library/CpuExceptionHandlerLib.h>
+#include <Library/ReportStatusCodeLib.h>
+#include <Library/SmmCpuFeaturesLib.h>
+#include <Library/PeCoffGetEntryPointLib.h>
+
+#include <AcpiCpuData.h>
+#include <CpuHotPlugData.h>
+
+#include <Register/Cpuid.h>
+
+#include "CpuService.h"
+#include "SmmProfile.h"
+
+//
+// MSRs required for configuration of SMM Code Access Check
+//
+#define EFI_MSR_SMM_MCA_CAP                    0x17D
+#define  SMM_CODE_ACCESS_CHK_BIT               BIT58
+
+#define  SMM_FEATURE_CONTROL_LOCK_BIT          BIT0
+#define  SMM_CODE_CHK_EN_BIT                   BIT2
+
+///
+/// Page Table Entry
+///
+#define IA32_PG_P                   BIT0
+#define IA32_PG_RW                  BIT1
+#define IA32_PG_WT                  BIT3
+#define IA32_PG_CD                  BIT4
+#define IA32_PG_A                   BIT5
+#define IA32_PG_PS                  BIT7
+#define IA32_PG_PAT_2M              BIT12
+#define IA32_PG_PAT_4K              IA32_PG_PS
+#define IA32_PG_PMNT                BIT62
+#define IA32_PG_NX                  BIT63
+
+//
+// Size of Task-State Segment defined in IA32 Manual
+//
+#define TSS_SIZE              104
+#define TSS_X64_IST1_OFFSET   36
+#define TSS_IA32_CR3_OFFSET   28
+#define TSS_IA32_ESP_OFFSET   56
+
+//
+// Code select value
+//
+#define PROTECT_MODE_CODE_SEGMENT          0x08
+#define LONG_MODE_CODE_SEGMENT             0x38
+
+//
+// The size 0x20 must be bigger than
+// the size of template code of SmmInit. Currently,
+// the size of SmmInit requires the 0x16 Bytes buffer
+// at least.
+//
+#define BACK_BUF_SIZE  0x20
+
+#define EXCEPTION_VECTOR_NUMBER     0x20
+
+#define INVALID_APIC_ID 0xFFFFFFFFFFFFFFFFULL
+
+typedef UINT32                              SMM_CPU_ARRIVAL_EXCEPTIONS;
+#define ARRIVAL_EXCEPTION_BLOCKED           0x1
+#define ARRIVAL_EXCEPTION_DELAYED           0x2
+#define ARRIVAL_EXCEPTION_SMI_DISABLED      0x4
+
+//
+// Private structure for the SMM CPU module that is stored in DXE Runtime memory
+// Contains the SMM Configuration Protocols that is produced.
+// Contains a mix of DXE and SMM contents.  All the fields must be used properly.
+//
+#define SMM_CPU_PRIVATE_DATA_SIGNATURE  SIGNATURE_32 ('s', 'c', 'p', 'u')
+
+typedef struct {
+  UINTN                           Signature;
+
+  EFI_HANDLE                      SmmCpuHandle;
+
+  EFI_PROCESSOR_INFORMATION       *ProcessorInfo;
+  SMM_CPU_OPERATION               *Operation;
+  UINTN                           *CpuSaveStateSize;
+  VOID                            **CpuSaveState;
+
+  EFI_SMM_RESERVED_SMRAM_REGION   SmmReservedSmramRegion[1];
+  EFI_SMM_ENTRY_CONTEXT           SmmCoreEntryContext;
+  EFI_SMM_ENTRY_POINT             SmmCoreEntry;
+
+  EFI_SMM_CONFIGURATION_PROTOCOL  SmmConfiguration;
+} SMM_CPU_PRIVATE_DATA;
+
+extern SMM_CPU_PRIVATE_DATA  *gSmmCpuPrivate;
+extern CPU_HOT_PLUG_DATA      mCpuHotPlugData;
+extern UINTN                  mMaxNumberOfCpus;
+extern UINTN                  mNumberOfCpus;
+extern BOOLEAN                mRestoreSmmConfigurationInS3;
+extern EFI_SMM_CPU_PROTOCOL   mSmmCpu;
+
+///
+/// The mode of the CPU at the time an SMI occurs
+///
+extern UINT8  mSmmSaveStateRegisterLma;
+
+
+//
+// SMM CPU Protocol function prototypes.
+//
+
+/**
+  Read information from the CPU save state.
+
+  @param  This      EFI_SMM_CPU_PROTOCOL instance
+  @param  Width     The number of bytes to read from the CPU save state.
+  @param  Register  Specifies the CPU register to read form the save state.
+  @param  CpuIndex  Specifies the zero-based index of the CPU save state
+  @param  Buffer    Upon return, this holds the CPU register value read from the save state.
+
+  @retval EFI_SUCCESS   The register was read from Save State
+  @retval EFI_NOT_FOUND The register is not defined for the Save State of Processor
+  @retval EFI_INVALID_PARAMTER   This or Buffer is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+SmmReadSaveState (
+  IN CONST EFI_SMM_CPU_PROTOCOL         *This,
+  IN UINTN                              Width,
+  IN EFI_SMM_SAVE_STATE_REGISTER        Register,
+  IN UINTN                              CpuIndex,
+  OUT VOID                              *Buffer
+  );
+
+/**
+  Write data to the CPU save state.
+
+  @param  This      EFI_SMM_CPU_PROTOCOL instance
+  @param  Width     The number of bytes to read from the CPU save state.
+  @param  Register  Specifies the CPU register to write to the save state.
+  @param  CpuIndex  Specifies the zero-based index of the CPU save state
+  @param  Buffer    Upon entry, this holds the new CPU register value.
+
+  @retval EFI_SUCCESS   The register was written from Save State
+  @retval EFI_NOT_FOUND The register is not defined for the Save State of Processor
+  @retval EFI_INVALID_PARAMTER   ProcessorIndex or Width is not correct
+
+**/
+EFI_STATUS
+EFIAPI
+SmmWriteSaveState (
+  IN CONST EFI_SMM_CPU_PROTOCOL         *This,
+  IN UINTN                              Width,
+  IN EFI_SMM_SAVE_STATE_REGISTER        Register,
+  IN UINTN                              CpuIndex,
+  IN CONST VOID                         *Buffer
+  );
+
+/**
+Read a CPU Save State register on the target processor.
+
+This function abstracts the differences that whether the CPU Save State register is in the
+IA32 CPU Save State Map or X64 CPU Save State Map.
+
+This function supports reading a CPU Save State register in SMBase relocation handler.
+
+@param[in]  CpuIndex       Specifies the zero-based index of the CPU save state.
+@param[in]  RegisterIndex  Index into mSmmCpuWidthOffset[] look up table.
+@param[in]  Width          The number of bytes to read from the CPU save state.
+@param[out] Buffer         Upon return, this holds the CPU register value read from the save state.
+
+@retval EFI_SUCCESS           The register was read from Save State.
+@retval EFI_NOT_FOUND         The register is not defined for the Save State of Processor.
+@retval EFI_INVALID_PARAMTER  This or Buffer is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+ReadSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  OUT VOID                        *Buffer
+  );
+
+/**
+Write value to a CPU Save State register on the target processor.
+
+This function abstracts the differences that whether the CPU Save State register is in the
+IA32 CPU Save State Map or X64 CPU Save State Map.
+
+This function supports writing a CPU Save State register in SMBase relocation handler.
+
+@param[in] CpuIndex       Specifies the zero-based index of the CPU save state.
+@param[in] RegisterIndex  Index into mSmmCpuWidthOffset[] look up table.
+@param[in] Width          The number of bytes to read from the CPU save state.
+@param[in] Buffer         Upon entry, this holds the new CPU register value.
+
+@retval EFI_SUCCESS           The register was written to Save State.
+@retval EFI_NOT_FOUND         The register is not defined for the Save State of Processor.
+@retval EFI_INVALID_PARAMTER  ProcessorIndex or Width is not correct.
+
+**/
+EFI_STATUS
+EFIAPI
+WriteSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  IN CONST VOID                   *Buffer
+  );
+
+//
+//
+//
+typedef struct {
+  UINT32                            Offset;
+  UINT16                            Segment;
+  UINT16                            Reserved;
+} IA32_FAR_ADDRESS;
+
+extern IA32_FAR_ADDRESS             gSmmJmpAddr;
+
+extern CONST UINT8                  gcSmmInitTemplate[];
+extern CONST UINT16                 gcSmmInitSize;
+extern UINT32                       gSmmCr0;
+extern UINT32                       gSmmCr3;
+extern UINT32                       gSmmCr4;
+extern UINTN                        gSmmInitStack;
+
+/**
+  Semaphore operation for all processor relocate SMMBase.
+**/
+VOID
+EFIAPI
+SmmRelocationSemaphoreComplete (
+  VOID
+  );
+
+///
+/// The type of SMM CPU Information
+///
+typedef struct {
+  SPIN_LOCK                         Busy;
+  volatile EFI_AP_PROCEDURE         Procedure;
+  volatile VOID                     *Parameter;
+  volatile UINT32                   Run;
+  volatile BOOLEAN                  Present;
+} SMM_CPU_DATA_BLOCK;
+
+typedef enum {
+  SmmCpuSyncModeTradition,
+  SmmCpuSyncModeRelaxedAp,
+  SmmCpuSyncModeMax
+} SMM_CPU_SYNC_MODE;
+
+typedef struct {
+  //
+  // Pointer to an array. The array should be located immediately after this structure
+  // so that UC cache-ability can be set together.
+  //
+  SMM_CPU_DATA_BLOCK            *CpuData;
+  volatile UINT32               Counter;
+  volatile UINT32               BspIndex;
+  volatile BOOLEAN              InsideSmm;
+  volatile BOOLEAN              AllCpusInSync;
+  volatile SMM_CPU_SYNC_MODE    EffectiveSyncMode;
+  volatile BOOLEAN              SwitchBsp;
+  volatile BOOLEAN              *CandidateBsp;
+} SMM_DISPATCHER_MP_SYNC_DATA;
+
+typedef struct {
+  SPIN_LOCK    SpinLock;
+  UINT32       MsrIndex;
+} MP_MSR_LOCK;
+
+#define SMM_PSD_OFFSET              0xfb00
+
+typedef struct {
+  UINT64                            Signature;              // Offset 0x00
+  UINT16                            Reserved1;              // Offset 0x08
+  UINT16                            Reserved2;              // Offset 0x0A
+  UINT16                            Reserved3;              // Offset 0x0C
+  UINT16                            SmmCs;                  // Offset 0x0E
+  UINT16                            SmmDs;                  // Offset 0x10
+  UINT16                            SmmSs;                  // Offset 0x12
+  UINT16                            SmmOtherSegment;        // Offset 0x14
+  UINT16                            Reserved4;              // Offset 0x16
+  UINT64                            Reserved5;              // Offset 0x18
+  UINT64                            Reserved6;              // Offset 0x20
+  UINT64                            Reserved7;              // Offset 0x28
+  UINT64                            SmmGdtPtr;              // Offset 0x30
+  UINT32                            SmmGdtSize;             // Offset 0x38
+  UINT32                            Reserved8;              // Offset 0x3C
+  UINT64                            Reserved9;              // Offset 0x40
+  UINT64                            Reserved10;             // Offset 0x48
+  UINT16                            Reserved11;             // Offset 0x50
+  UINT16                            Reserved12;             // Offset 0x52
+  UINT32                            Reserved13;             // Offset 0x54
+  UINT64                            MtrrBaseMaskPtr;        // Offset 0x58
+} PROCESSOR_SMM_DESCRIPTOR;
+
+extern IA32_DESCRIPTOR                     gcSmiGdtr;
+extern IA32_DESCRIPTOR                     gcSmiIdtr;
+extern VOID                                *gcSmiIdtrPtr;
+extern CONST PROCESSOR_SMM_DESCRIPTOR      gcPsd;
+extern UINT64                              gPhyMask;
+extern ACPI_CPU_DATA                       mAcpiCpuData;
+extern SMM_DISPATCHER_MP_SYNC_DATA         *mSmmMpSyncData;
+extern VOID                                *mGdtForAp;
+extern VOID                                *mIdtForAp;
+extern VOID                                *mMachineCheckHandlerForAp;
+extern UINTN                               mSmmStackArrayBase;
+extern UINTN                               mSmmStackArrayEnd;
+extern UINTN                               mSmmStackSize;
+extern EFI_SMM_CPU_SERVICE_PROTOCOL        mSmmCpuService;
+extern IA32_DESCRIPTOR                     gcSmiInitGdtr;
+
+/**
+  Create 4G PageTable in SMRAM.
+
+  @param          ExtraPages       Additional page numbers besides for 4G memory
+  @return         PageTable Address
+
+**/
+UINT32
+Gen4GPageTable (
+  IN      UINTN                     ExtraPages
+  );
+
+
+/**
+  Initialize global data for MP synchronization.
+
+  @param Stacks       Base address of SMI stack buffer for all processors.
+  @param StackSize    Stack size for each processor in SMM.
+
+**/
+UINT32
+InitializeMpServiceData (
+  IN VOID        *Stacks,
+  IN UINTN       StackSize
+  );
+
+/**
+  Initialize Timer for SMM AP Sync.
+
+**/
+VOID
+InitializeSmmTimer (
+  VOID
+  );
+
+/**
+  Start Timer for SMM AP Sync.
+
+**/
+UINT64
+EFIAPI
+StartSyncTimer (
+  VOID
+  );
+
+/**
+  Check if the SMM AP Sync timer is timeout.
+
+  @param Timer  The start timer from the begin.
+
+**/
+BOOLEAN
+EFIAPI
+IsSyncTimerTimeout (
+  IN      UINT64                    Timer
+  );
+
+/**
+  Initialize IDT for SMM Stack Guard.
+
+**/
+VOID
+EFIAPI
+InitializeIDTSmmStackGuard (
+  VOID
+  );
+
+/**
+
+  Register the SMM Foundation entry point.
+
+  @param          This              Pointer to EFI_SMM_CONFIGURATION_PROTOCOL instance
+  @param          SmmEntryPoint     SMM Foundation EntryPoint
+
+  @retval         EFI_SUCCESS       Successfully to register SMM foundation entry point
+
+**/
+EFI_STATUS
+EFIAPI
+RegisterSmmEntry (
+  IN CONST EFI_SMM_CONFIGURATION_PROTOCOL  *This,
+  IN EFI_SMM_ENTRY_POINT                   SmmEntryPoint
+  );
+
+/**
+  Create PageTable for SMM use.
+
+  @return     PageTable Address
+
+**/
+UINT32
+SmmInitPageTable (
+  VOID
+  );
+
+/**
+  Schedule a procedure to run on the specified CPU.
+
+  @param   Procedure        The address of the procedure to run
+  @param   CpuIndex         Target CPU number
+  @param   ProcArguments    The parameter to pass to the procedure
+
+  @retval   EFI_INVALID_PARAMETER    CpuNumber not valid
+  @retval   EFI_INVALID_PARAMETER    CpuNumber specifying BSP
+  @retval   EFI_INVALID_PARAMETER    The AP specified by CpuNumber did not enter SMM
+  @retval   EFI_INVALID_PARAMETER    The AP specified by CpuNumber is busy
+  @retval   EFI_SUCCESS - The procedure has been successfully scheduled
+
+**/
+EFI_STATUS
+EFIAPI
+SmmStartupThisAp (
+  IN      EFI_AP_PROCEDURE          Procedure,
+  IN      UINTN                     CpuIndex,
+  IN OUT  VOID                      *ProcArguments OPTIONAL
+  );
+
+/**
+  Schedule a procedure to run on the specified CPU in a blocking fashion.
+
+  @param  Procedure                The address of the procedure to run
+  @param  CpuIndex                 Target CPU Index
+  @param  ProcArguments            The parameter to pass to the procedure
+
+  @retval EFI_INVALID_PARAMETER    CpuNumber not valid
+  @retval EFI_INVALID_PARAMETER    CpuNumber specifying BSP
+  @retval EFI_INVALID_PARAMETER    The AP specified by CpuNumber did not enter SMM
+  @retval EFI_INVALID_PARAMETER    The AP specified by CpuNumber is busy
+  @retval EFI_SUCCESS              The procedure has been successfully scheduled
+
+**/
+EFI_STATUS
+EFIAPI
+SmmBlockingStartupThisAp (
+  IN      EFI_AP_PROCEDURE          Procedure,
+  IN      UINTN                     CpuIndex,
+  IN OUT  VOID                      *ProcArguments OPTIONAL
+  );
+
+/**
+  Initialize MP synchronization data.
+
+**/
+VOID
+EFIAPI
+InitializeMpSyncData (
+  VOID
+  );
+
+/**
+
+  Find out SMRAM information including SMRR base and SMRR size.
+
+  @param          SmrrBase          SMRR base
+  @param          SmrrSize          SMRR size
+
+**/
+VOID
+FindSmramInfo (
+  OUT UINT32   *SmrrBase,
+  OUT UINT32   *SmrrSize
+  );
+
+/**
+  The function is invoked before SMBASE relocation in S3 path to restores CPU status.
+
+  The function is invoked before SMBASE relocation in S3 path. It does first time microcode load
+  and restores MTRRs for both BSP and APs.
+
+**/
+VOID
+EarlyInitializeCpu (
+  VOID
+  );
+
+/**
+  The function is invoked after SMBASE relocation in S3 path to restores CPU status.
+
+  The function is invoked after SMBASE relocation in S3 path. It restores configuration according to
+  data saved by normal boot path for both BSP and APs.
+
+**/
+VOID
+InitializeCpu (
+  VOID
+  );
+
+/**
+  Page Fault handler for SMM use.
+
+  @param  InterruptType    Defines the type of interrupt or exception that
+                           occurred on the processor.This parameter is processor architecture specific.
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+**/
+VOID
+EFIAPI
+SmiPFHandler (
+    IN EFI_EXCEPTION_TYPE   InterruptType,
+    IN EFI_SYSTEM_CONTEXT   SystemContext
+  );
+
+/**
+  Perform the remaining tasks.
+
+**/
+VOID
+PerformRemainingTasks (
+  VOID
+  );
+
+/**
+  Initialize MSR spin lock by MSR index.
+
+  @param  MsrIndex       MSR index value.
+
+**/
+VOID
+InitMsrSpinLockByIndex (
+  IN UINT32      MsrIndex
+  );
+
+/**
+  Hook return address of SMM Save State so that semaphore code
+  can be executed immediately after AP exits SMM to indicate to
+  the BSP that an AP has exited SMM after SMBASE relocation.
+
+  @param[in] CpuIndex     The processor index.
+  @param[in] RebasedFlag  A pointer to a flag that is set to TRUE
+                          immediately after AP exits SMM.
+
+**/
+VOID
+SemaphoreHook (
+  IN UINTN             CpuIndex,
+  IN volatile BOOLEAN  *RebasedFlag
+  );
+
+/**
+Configure SMM Code Access Check feature for all processors.
+SMM Feature Control MSR will be locked after configuration.
+**/
+VOID
+ConfigSmmCodeAccessCheck (
+  VOID
+  );
+
+/**
+  Hook the code executed immediately after an RSM instruction on the currently
+  executing CPU.  The mode of code executed immediately after RSM must be
+  detected, and the appropriate hook must be selected.  Always clear the auto
+  HALT restart flag if it is set.
+
+  @param[in] CpuIndex                 The processor index for the currently
+                                      executing CPU.
+  @param[in] CpuState                 Pointer to SMRAM Save State Map for the
+                                      currently executing CPU.
+  @param[in] NewInstructionPointer32  Instruction pointer to use if resuming to
+                                      32-bit mode from 64-bit SMM.
+  @param[in] NewInstructionPointer    Instruction pointer to use if resuming to
+                                      same mode as SMM.
+
+  @retval The value of the original instruction pointer before it was hooked.
+
+**/
+UINT64
+EFIAPI
+HookReturnFromSmm (
+  IN UINTN              CpuIndex,
+  SMRAM_SAVE_STATE_MAP  *CpuState,
+  UINT64                NewInstructionPointer32,
+  UINT64                NewInstructionPointer
+  );
+
+/**
+  Get the size of the SMI Handler in bytes.
+
+  @retval The size, in bytes, of the SMI Handler.
+
+**/
+UINTN
+EFIAPI
+GetSmiHandlerSize (
+  VOID
+  );
+
+/**
+  Install the SMI handler for the CPU specified by CpuIndex.  This function
+  is called by the CPU that was elected as monarch during System Management
+  Mode initialization.
+
+  @param[in] CpuIndex   The index of the CPU to install the custom SMI handler.
+                        The value must be between 0 and the NumberOfCpus field
+                        in the System Management System Table (SMST).
+  @param[in] SmBase     The SMBASE address for the CPU specified by CpuIndex.
+  @param[in] SmiStack   The stack to use when an SMI is processed by the
+                        the CPU specified by CpuIndex.
+  @param[in] StackSize  The size, in bytes, if the stack used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtBase    The base address of the GDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtSize    The size, in bytes, of the GDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtBase    The base address of the IDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtSize    The size, in bytes, of the IDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] Cr3        The base address of the page tables to use when an SMI
+                        is processed by the CPU specified by CpuIndex.
+**/
+VOID
+EFIAPI
+InstallSmiHandler (
+  IN UINTN   CpuIndex,
+  IN UINT32  SmBase,
+  IN VOID    *SmiStack,
+  IN UINTN   StackSize,
+  IN UINTN   GdtBase,
+  IN UINTN   GdtSize,
+  IN UINTN   IdtBase,
+  IN UINTN   IdtSize,
+  IN UINT32  Cr3
+  );
+
+/**
+  Search module name by input IP address and output it.
+
+  @param CallerIpAddress   Caller instruction pointer.
+
+**/
+VOID
+DumpModuleInfoByIp (
+  IN  UINTN              CallerIpAddress
+  );
+#endif
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
new file mode 100644
index 000000000000..45ab16c07f2b
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
@@ -0,0 +1,163 @@
+## @file
+# CPU SMM driver.
+#
+# This SMM driver performs SMM initialization, deploy SMM Entry Vector,
+# provides CPU specific services in SMM.
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PiSmmCpuDxeSmm
+  MODULE_UNI_FILE                = PiSmmCpuDxeSmm.uni
+  FILE_GUID                      = A3FF0EF5-0C28-42f5-B544-8C7DE1E80014
+  MODULE_TYPE                    = DXE_SMM_DRIVER
+  VERSION_STRING                 = 1.0
+  PI_SPECIFICATION_VERSION       = 0x0001000A
+  ENTRY_POINT                    = PiCpuSmmEntry
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  PiSmmCpuDxeSmm.c
+  PiSmmCpuDxeSmm.h
+  MpService.c
+  SyncTimer.c
+  CpuS3.c
+  CpuService.c
+  CpuService.h
+  SmmProfile.c
+  SmmProfile.h
+  SmmProfileInternal.h
+  SmramSaveState.c
+
+[Sources.Ia32]
+  Ia32/Semaphore.c
+  Ia32/PageTbl.c
+  Ia32/SmmProfileArch.c
+  Ia32/SmmProfileArch.h
+  Ia32/SmmInit.asm      | MSFT
+  Ia32/SmiEntry.asm     | MSFT
+  Ia32/SmiException.asm | MSFT
+  Ia32/MpFuncs.asm      | MSFT
+
+  Ia32/SmmInit.asm      | INTEL
+  Ia32/SmiEntry.asm     | INTEL
+  Ia32/SmiException.asm | INTEL
+  Ia32/MpFuncs.asm      | INTEL
+
+  Ia32/SmmInit.S        | GCC
+  Ia32/SmiEntry.S       | GCC
+  Ia32/SmiException.S   | GCC
+  Ia32/MpFuncs.S        | GCC
+
+[Sources.X64]
+  X64/Semaphore.c
+  X64/PageTbl.c
+  X64/SmmProfileArch.c
+  X64/SmmProfileArch.h
+  X64/SmmInit.asm      | MSFT
+  X64/SmiEntry.asm     | MSFT
+  X64/SmiException.asm | MSFT
+  X64/MpFuncs.asm      | MSFT
+
+  X64/SmmInit.asm      | INTEL
+  X64/SmiEntry.asm     | INTEL
+  X64/SmiException.asm | INTEL
+  X64/MpFuncs.asm      | INTEL
+
+  X64/SmmInit.S        | GCC
+  X64/SmiEntry.S       | GCC
+  X64/SmiException.S   | GCC
+  X64/MpFuncs.S        | GCC
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
+  IntelFrameworkPkg/IntelFrameworkPkg.dec
+
+[LibraryClasses]
+  UefiDriverEntryPoint
+  UefiRuntimeServicesTableLib
+  CacheMaintenanceLib
+  PcdLib
+  DebugLib
+  BaseLib
+  SynchronizationLib
+  BaseMemoryLib
+  MtrrLib
+  SmmLib
+  IoLib
+  TimerLib
+  SmmServicesTableLib
+  MemoryAllocationLib
+  DebugAgentLib
+  HobLib
+  PciLib
+  LocalApicLib
+  UefiCpuLib
+  SmmCpuPlatformHookLib
+  CpuExceptionHandlerLib
+  UefiLib
+  DxeServicesTableLib
+  CpuLib
+  ReportStatusCodeLib
+  SmmCpuFeaturesLib
+  PeCoffGetEntryPointLib
+
+[Protocols]
+  gEfiSmmAccess2ProtocolGuid               ## CONSUMES
+  gEfiMpServiceProtocolGuid                ## CONSUMES
+  gEfiSmmConfigurationProtocolGuid         ## PRODUCES
+  gEfiSmmCpuProtocolGuid                   ## PRODUCES
+  gEfiSmmReadyToLockProtocolGuid           ## NOTIFY
+  gEfiSmmCpuServiceProtocolGuid            ## PRODUCES
+  gEfiSmmCpuSaveStateProtocolGuid          ## SOMETIMES_PRODUCES
+
+[Guids]
+  gEfiAcpiVariableGuid                     ## SOMETIMES_CONSUMES ## HOB # it is used for S3 boot.
+  gEfiGlobalVariableGuid                   ## SOMETIMES_PRODUCES ## Variable:L"SmmProfileData"
+  gEfiAcpi20TableGuid                      ## SOMETIMES_CONSUMES ## SystemTable
+  gEfiAcpi10TableGuid                      ## SOMETIMES_CONSUMES ## SystemTable
+
+[FeaturePcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdFrameworkCompatibilitySupport  ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmDebug                         ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmBlockStartupThisAp            ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmEnableBspElection             ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugSupport                   ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackGuard                    ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileEnable                 ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileRingBuffer             ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmFeatureControlMsrLock         ## CONSUMES
+
+[Pcd]
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber        ## SOMETIMES_CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileSize                   ## SOMETIMES_CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackSize                     ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmApSyncTimeout                 ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuS3DataAddress                    ## SOMETIMES_CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugDataAddress               ## SOMETIMES_PRODUCES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmCodeAccessCheckEnable         ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmSyncMode                      ## CONSUMES
+
+[Depex]
+  gEfiMpServiceProtocolGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  PiSmmCpuDxeSmmExtra.uni
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni
new file mode 100644
index 0000000000000000000000000000000000000000..6a5b8c972fe8c4b881826cee4b4a1253706a8fbe
GIT binary patch
literal 1868
zcmchYTW`}q5QXO%iT_}wFMyf^kaz$gMA90tfF{a?!c&zvmqsc{6sLjm<ALwY#&!dV
zP+yScUGL89nKNg`_OG9Ht6RkVh%2(!HnEvq+1T#eJ$7X~v9|S@yY`VQvXQOu+2FIX
zTH#mv_v{jTcHl&0OFucW1?Ru+_|0t2$u;)?4m10~tkr`3V~;%M^cCxyTj(*?HCWpF
z1a`_w*vADo#ayws0c(VZxaC=8&L_p9%u_6x^OJA7^%bu?|9u&sfW0KXbeWR<8t(_3
ze#rdP9&<hCsk&V~v1gu5;=IS?BQ|2Z^s&sjhNXdB9woNeubi1GpgN4G!%J&g$6ggV
z@2f{pValli%14ZI&PMRP1V!tVYk_U)wj1)9lTpNuSSenpjW`UPMHxpGlVWpMP`Ek1
zPD^*~Y`E270~<1G@7h@iyJQk#h3?2v#7ulchv-=>7Sydg*Q85NS%28!QgZy}y_qup
zo$U-ZLX;Yze-$fZt*nRe%zIIFiA;Si{u3;rMq>RPuRmGsDihRHw+^@G7h4U)X<bw>
z0)Nf5v={y+s>g!5@?W{uHSd@y_T3m6J43jS=(=4?4U|jnT$6lOKJP4sRhvF)*;~ej
zzwZf}MyRT}$8JKW^?8b2>AsyY$LyB~Wfc-SJI15y$St1K(Hbkv!WC+Tx#?@IZojwZ
z*u|^m5hFXttK-bh*iS$eM$4mjSc$v#6tjn~d=xc!y}?(}zc9bYBIf$8#M>w#i`YIF
zI3;?57H#@UF;Dk?_w)s=yROposOX&V1_kXdKxuKl4^nIwu#r|$wSiJSxE#8UsH5J5
zDYYLks`JzhRj|aeQhd?&eWxpT<fV#sK~%Ndg^K&Q{hQbS`5$CxkY|4Qk5GP-4*e0T
N)J^Z%UH%9`-QW0^A&vk5

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..cd71f57ed9548ffcd85e3a329e49d9354364477e
GIT binary patch
literal 1378
zcmZ9MTW`}q5QXO%iT_}Q7eKAUMZ6${NE!ncO&sMS%2SnFQ%gx4IZ4~_<ALw&`jQ~a
z-r1SiGiT3^_wS#kH7($M%@f!cyR+0*wy@{+46kB+JVRUaT-nwR*0Cqz-V@lhWj3=3
zYf}4-f6j`b?JZ}%v8C;pPq5^_B6mY<;l5>sa`f@79o^cc-IE#EOVD32zOy&>*4|@X
zR<jRwfgKl^D{NKBVX5zg^{J~E5^2Fu8RF%!#Vm)*jyJal$33)9*0zCtuJ&KE8^I`b
z``MD8fub5~P|E%7$ym7g4AvR3t&1HCEdo4ZrFtpWs!&HP>N-+#hG*lLNw*STtLH_9
z2W*|x#HM^z^}q^6bL^6dueC1f_)`!wS!tz@l*l;wdR?0{>@dGR<5F{cbXv^#irx8c
zQ#c4w9K2qtwPUVbPvLobE`do`@xLSD&q%DF$oikvxiVhOBU#g8eO727PWux@)k%BK
z;-l;649lyl{M>0Bvj3bDZNlJG{T-eu+~;)Nc_akop10Jb9JQbC7Qw1dA0_sUZ_B#O
zV>As=RpSV6Os9>pBB%7&dW;eN8lgUgn9h#K7&_zxOC7CmgHgCbZ7{aoT(gUcTVOwl
zi&x?*YTlxfnDy|-pb8^#)d$SPT|U(uk)<3}^;uuZ)yiLtKZuCA{=}%L;&&0*O@&jV
z$7s=~uT-;RVa2i5Pd8E1`Q>|2b&hTm-7V7YwotbZ%Anf8E!YXDWAGz#da&$bc^v&K
z!Z<K4UB{>kF3BFcj0Twcul4Wkc+?T9*X8lIjQ?ZGyRN=pbgDPh(WoBRU6OMes{0R^
Ch}L=l

literal 0
HcmV?d00001

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
new file mode 100644
index 000000000000..8ddde9acb55c
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
@@ -0,0 +1,1443 @@
+/** @file
+Enable SMM profile.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+#include "SmmProfileInternal.h"
+
+UINT32                    mSmmProfileCr3;
+
+SMM_PROFILE_HEADER        *mSmmProfileBase;
+MSR_DS_AREA_STRUCT        *mMsrDsAreaBase;
+//
+// The buffer to store SMM profile data.
+//
+UINTN                     mSmmProfileSize;
+
+//
+// The buffer to enable branch trace store.
+//
+UINTN                     mMsrDsAreaSize   = SMM_PROFILE_DTS_SIZE;
+
+//
+// The flag indicates if execute-disable is supported by processor.
+//
+BOOLEAN                   mXdSupported     = FALSE;
+
+//
+// The flag indicates if execute-disable is enabled on processor.
+//
+BOOLEAN                   mXdEnabled       = FALSE;
+
+//
+// The flag indicates if BTS is supported by processor.
+//
+BOOLEAN                   mBtsSupported     = FALSE;
+
+//
+// The flag indicates if SMM profile starts to record data.
+//
+BOOLEAN                   mSmmProfileStart = FALSE;
+
+//
+// Record the page fault exception count for one instruction execution.
+//
+UINTN                     *mPFEntryCount;
+
+UINT64                    (*mLastPFEntryValue)[MAX_PF_ENTRY_COUNT];
+UINT64                    *(*mLastPFEntryPointer)[MAX_PF_ENTRY_COUNT];
+
+MSR_DS_AREA_STRUCT        **mMsrDsArea;
+BRANCH_TRACE_RECORD       **mMsrBTSRecord;
+UINTN                     mBTSRecordNumber;
+PEBS_RECORD               **mMsrPEBSRecord;
+
+//
+// These memory ranges are always present, they does not generate the access type of page fault exception,
+// but they possibly generate instruction fetch type of page fault exception.
+//
+MEMORY_PROTECTION_RANGE   *mProtectionMemRange     = NULL;
+UINTN                     mProtectionMemRangeCount = 0;
+
+//
+// Some predefined memory ranges.
+//
+MEMORY_PROTECTION_RANGE mProtectionMemRangeTemplate[] = {
+  //
+  // SMRAM range (to be fixed in runtime).
+  // It is always present and instruction fetches are allowed.
+  //
+  {{0x00000000, 0x00000000},TRUE,FALSE},
+
+  //
+  // SMM profile data range( to be fixed in runtime).
+  // It is always present and instruction fetches are not allowed.
+  //
+  {{0x00000000, 0x00000000},TRUE,TRUE},
+
+  //
+  // Future extended range could be added here.
+  //
+
+  //
+  // PCI MMIO ranges (to be added in runtime).
+  // They are always present and instruction fetches are not allowed.
+  //
+};
+
+//
+// These memory ranges are mapped by 4KB-page instead of 2MB-page.
+//
+MEMORY_RANGE              *mSplitMemRange          = NULL;
+UINTN                     mSplitMemRangeCount      = 0;
+
+//
+// SMI command port.
+//
+UINT32                    mSmiCommandPort;
+
+/**
+  Disable branch trace store.
+
+**/
+VOID
+DisableBTS (
+  VOID
+  )
+{
+  AsmMsrAnd64 (MSR_DEBUG_CTL, ~((UINT64)(MSR_DEBUG_CTL_BTS | MSR_DEBUG_CTL_TR)));
+}
+
+/**
+  Enable branch trace store.
+
+**/
+VOID
+EnableBTS (
+  VOID
+  )
+{
+  AsmMsrOr64 (MSR_DEBUG_CTL, (MSR_DEBUG_CTL_BTS | MSR_DEBUG_CTL_TR));
+}
+
+/**
+  Get CPU Index from APIC ID.
+
+**/
+UINTN
+GetCpuIndex (
+  VOID
+  )
+{
+  UINTN     Index;
+  UINT32    ApicId;
+
+  ApicId = GetApicId ();
+
+  for (Index = 0; Index < PcdGet32 (PcdCpuMaxLogicalProcessorNumber); Index++) {
+    if (gSmmCpuPrivate->ProcessorInfo[Index].ProcessorId == ApicId) {
+      return Index;
+    }
+  }
+  ASSERT (FALSE);
+  return 0;
+}
+
+/**
+  Get the source of IP after execute-disable exception is triggered.
+
+  @param  CpuIndex        The index of CPU.
+  @param  DestinationIP   The destination address.
+
+**/
+UINT64
+GetSourceFromDestinationOnBts (
+  UINTN  CpuIndex,
+  UINT64 DestinationIP
+  )
+{
+  BRANCH_TRACE_RECORD  *CurrentBTSRecord;
+  UINTN                Index;
+  BOOLEAN              FirstMatch;
+
+  FirstMatch = FALSE;
+
+  CurrentBTSRecord = (BRANCH_TRACE_RECORD *)mMsrDsArea[CpuIndex]->BTSIndex;
+  for (Index = 0; Index < mBTSRecordNumber; Index++) {
+    if ((UINTN)CurrentBTSRecord < (UINTN)mMsrBTSRecord[CpuIndex]) {
+      //
+      // Underflow
+      //
+      CurrentBTSRecord = (BRANCH_TRACE_RECORD *)((UINTN)mMsrDsArea[CpuIndex]->BTSAbsoluteMaximum - 1);
+      CurrentBTSRecord --;
+    }
+    if (CurrentBTSRecord->LastBranchTo == DestinationIP) {
+      //
+      // Good! find 1st one, then find 2nd one.
+      //
+      if (!FirstMatch) {
+        //
+        // The first one is DEBUG exception
+        //
+        FirstMatch = TRUE;
+      } else {
+        //
+        // Good find proper one.
+        //
+        return CurrentBTSRecord->LastBranchFrom;
+      }
+    }
+    CurrentBTSRecord--;
+  }
+
+  return 0;
+}
+
+/**
+  SMM profile specific INT 1 (single-step) exception handler.
+
+  @param  InterruptType    Defines the type of interrupt or exception that
+                           occurred on the processor.This parameter is processor architecture specific.
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+**/
+VOID
+EFIAPI
+DebugExceptionHandler (
+    IN EFI_EXCEPTION_TYPE   InterruptType,
+    IN EFI_SYSTEM_CONTEXT   SystemContext
+  )
+{
+  UINTN  CpuIndex;
+  UINTN  PFEntry;
+
+  if (!mSmmProfileStart) {
+    return;
+  }
+  CpuIndex = GetCpuIndex ();
+
+  //
+  // Clear last PF entries
+  //
+  for (PFEntry = 0; PFEntry < mPFEntryCount[CpuIndex]; PFEntry++) {
+    *mLastPFEntryPointer[CpuIndex][PFEntry] = mLastPFEntryValue[CpuIndex][PFEntry];
+  }
+
+  //
+  // Reset page fault exception count for next page fault.
+  //
+  mPFEntryCount[CpuIndex] = 0;
+
+  //
+  // Flush TLB
+  //
+  CpuFlushTlb ();
+
+  //
+  // Clear TF in EFLAGS
+  //
+  ClearTrapFlag (SystemContext);
+}
+
+/**
+  Check if the memory address will be mapped by 4KB-page.
+
+  @param  Address  The address of Memory.
+  @param  Nx       The flag indicates if the memory is execute-disable.
+
+**/
+BOOLEAN
+IsAddressValid (
+  IN EFI_PHYSICAL_ADDRESS   Address,
+  IN BOOLEAN                *Nx
+  )
+{
+  UINTN  Index;
+
+  *Nx = FALSE;
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    //
+    // Check configuration
+    //
+    for (Index = 0; Index < mProtectionMemRangeCount; Index++) {
+      if ((Address >= mProtectionMemRange[Index].Range.Base) && (Address < mProtectionMemRange[Index].Range.Top)) {
+        *Nx = mProtectionMemRange[Index].Nx;
+        return mProtectionMemRange[Index].Present;
+      }
+    }
+    *Nx = TRUE;
+    return FALSE;
+
+  } else {
+    if ((Address < mCpuHotPlugData.SmrrBase) ||
+        (Address >= mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize)) {
+      *Nx = TRUE;
+    }
+    return TRUE;
+  }
+}
+
+/**
+  Check if the memory address will be mapped by 4KB-page.
+
+  @param  Address  The address of Memory.
+
+**/
+BOOLEAN
+IsAddressSplit (
+  IN EFI_PHYSICAL_ADDRESS   Address
+  )
+{
+  UINTN  Index;
+
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    //
+    // Check configuration
+    //
+    for (Index = 0; Index < mSplitMemRangeCount; Index++) {
+      if ((Address >= mSplitMemRange[Index].Base) && (Address < mSplitMemRange[Index].Top)) {
+        return TRUE;
+      }
+    }
+  } else {
+    if (Address < mCpuHotPlugData.SmrrBase) {
+      if ((mCpuHotPlugData.SmrrBase - Address) < BASE_2MB) {
+        return TRUE;
+      }
+    } else if (Address > (mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize - BASE_2MB))  {
+      if ((Address - (mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize - BASE_2MB)) < BASE_2MB) {
+        return TRUE;
+      }
+    }
+  }
+  //
+  // Return default
+  //
+  return FALSE;
+}
+
+/**
+  Initialize the protected memory ranges and the 4KB-page mapped memory ranges.
+
+**/
+VOID
+InitProtectedMemRange (
+  VOID
+  )
+{
+  UINTN                            Index;
+  UINTN                            NumberOfDescriptors;
+  UINTN                            NumberOfMmioDescriptors;
+  UINTN                            NumberOfProtectRange;
+  UINTN                            NumberOfSpliteRange;
+  EFI_GCD_MEMORY_SPACE_DESCRIPTOR  *MemorySpaceMap;
+  UINTN                            TotalSize;
+  EFI_STATUS                       Status;
+  EFI_PHYSICAL_ADDRESS             ProtectBaseAddress;
+  EFI_PHYSICAL_ADDRESS             ProtectEndAddress;
+  EFI_PHYSICAL_ADDRESS             Top2MBAlignedAddress;
+  EFI_PHYSICAL_ADDRESS             Base2MBAlignedAddress;
+  UINT64                           High4KBPageSize;
+  UINT64                           Low4KBPageSize;
+
+  NumberOfDescriptors      = 0;
+  NumberOfMmioDescriptors  = 0;
+  NumberOfSpliteRange      = 0;
+  MemorySpaceMap           = NULL;
+
+  //
+  // Get MMIO ranges from GCD and add them into protected memory ranges.
+  //
+  Status = gDS->GetMemorySpaceMap (
+                &NumberOfDescriptors,
+                &MemorySpaceMap
+                );
+  for (Index = 0; Index < NumberOfDescriptors; Index++) {
+    if (MemorySpaceMap[Index].GcdMemoryType == EfiGcdMemoryTypeMemoryMappedIo) {
+      NumberOfMmioDescriptors++;
+    }
+  }
+
+  if (NumberOfMmioDescriptors != 0) {
+    TotalSize = NumberOfMmioDescriptors * sizeof (MEMORY_PROTECTION_RANGE) + sizeof (mProtectionMemRangeTemplate);
+    mProtectionMemRange = (MEMORY_PROTECTION_RANGE *) AllocateZeroPool (TotalSize);
+    ASSERT (mProtectionMemRange != NULL);
+    mProtectionMemRangeCount = TotalSize / sizeof (MEMORY_PROTECTION_RANGE);
+
+    //
+    // Copy existing ranges.
+    //
+    CopyMem (mProtectionMemRange, mProtectionMemRangeTemplate, sizeof (mProtectionMemRangeTemplate));
+
+    //
+    // Create split ranges which come from protected ranges.
+    //
+    TotalSize = (TotalSize / sizeof (MEMORY_PROTECTION_RANGE)) * sizeof (MEMORY_RANGE);
+    mSplitMemRange = (MEMORY_RANGE *) AllocateZeroPool (TotalSize);
+    ASSERT (mSplitMemRange != NULL);
+
+    //
+    // Create MMIO ranges which are set to present and execution-disable.
+    //
+    NumberOfProtectRange    = sizeof (mProtectionMemRangeTemplate) / sizeof (MEMORY_PROTECTION_RANGE);
+    for (Index = 0; Index < NumberOfDescriptors; Index++) {
+      if (MemorySpaceMap[Index].GcdMemoryType != EfiGcdMemoryTypeMemoryMappedIo) {
+        continue;
+      }
+      mProtectionMemRange[NumberOfProtectRange].Range.Base = MemorySpaceMap[Index].BaseAddress;
+      mProtectionMemRange[NumberOfProtectRange].Range.Top  = MemorySpaceMap[Index].BaseAddress + MemorySpaceMap[Index].Length;
+      mProtectionMemRange[NumberOfProtectRange].Present    = TRUE;
+      mProtectionMemRange[NumberOfProtectRange].Nx         = TRUE;
+      NumberOfProtectRange++;
+    }
+  }
+
+  //
+  // According to protected ranges, create the ranges which will be mapped by 2KB page.
+  //
+  NumberOfSpliteRange  = 0;
+  NumberOfProtectRange = mProtectionMemRangeCount;
+  for (Index = 0; Index < NumberOfProtectRange; Index++) {
+    //
+    // If MMIO base address is not 2MB alignment, make 2MB alignment for create 4KB page in page table.
+    //
+    ProtectBaseAddress = mProtectionMemRange[Index].Range.Base;
+    ProtectEndAddress  = mProtectionMemRange[Index].Range.Top;
+    if (((ProtectBaseAddress & (SIZE_2MB - 1)) != 0) || ((ProtectEndAddress  & (SIZE_2MB - 1)) != 0)) {
+      //
+      // Check if it is possible to create 4KB-page for not 2MB-aligned range and to create 2MB-page for 2MB-aligned range.
+      // A mix of 4KB and 2MB page could save SMRAM space.
+      //
+      Top2MBAlignedAddress  = ProtectEndAddress & ~(SIZE_2MB - 1);
+      Base2MBAlignedAddress = (ProtectBaseAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1);
+      if ((Top2MBAlignedAddress > Base2MBAlignedAddress) &&
+          ((Top2MBAlignedAddress - Base2MBAlignedAddress) >= SIZE_2MB)) {
+        //
+        // There is an range which could be mapped by 2MB-page.
+        //
+        High4KBPageSize = ((ProtectEndAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1)) - (ProtectEndAddress & ~(SIZE_2MB - 1));
+        Low4KBPageSize  = ((ProtectBaseAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1)) - (ProtectBaseAddress & ~(SIZE_2MB - 1));
+        if (High4KBPageSize != 0) {
+          //
+          // Add not 2MB-aligned range to be mapped by 4KB-page.
+          //
+          mSplitMemRange[NumberOfSpliteRange].Base = ProtectEndAddress & ~(SIZE_2MB - 1);
+          mSplitMemRange[NumberOfSpliteRange].Top  = (ProtectEndAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1);
+          NumberOfSpliteRange++;
+        }
+        if (Low4KBPageSize != 0) {
+          //
+          // Add not 2MB-aligned range to be mapped by 4KB-page.
+          //
+          mSplitMemRange[NumberOfSpliteRange].Base = ProtectBaseAddress & ~(SIZE_2MB - 1);
+          mSplitMemRange[NumberOfSpliteRange].Top  = (ProtectBaseAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1);
+          NumberOfSpliteRange++;
+        }
+      } else {
+        //
+        // The range could only be mapped by 4KB-page.
+        //
+        mSplitMemRange[NumberOfSpliteRange].Base = ProtectBaseAddress & ~(SIZE_2MB - 1);
+        mSplitMemRange[NumberOfSpliteRange].Top  = (ProtectEndAddress + SIZE_2MB - 1) & ~(SIZE_2MB - 1);
+        NumberOfSpliteRange++;
+      }
+    }
+  }
+
+  mSplitMemRangeCount = NumberOfSpliteRange;
+
+  DEBUG ((EFI_D_INFO, "SMM Profile Memory Ranges:\n"));
+  for (Index = 0; Index < mProtectionMemRangeCount; Index++) {
+    DEBUG ((EFI_D_INFO, "mProtectionMemRange[%d].Base = %lx\n", Index, mProtectionMemRange[Index].Range.Base));
+    DEBUG ((EFI_D_INFO, "mProtectionMemRange[%d].Top  = %lx\n", Index, mProtectionMemRange[Index].Range.Top));
+  }
+  for (Index = 0; Index < mSplitMemRangeCount; Index++) {
+    DEBUG ((EFI_D_INFO, "mSplitMemRange[%d].Base = %lx\n", Index, mSplitMemRange[Index].Base));
+    DEBUG ((EFI_D_INFO, "mSplitMemRange[%d].Top  = %lx\n", Index, mSplitMemRange[Index].Top));
+  }
+}
+
+/**
+  Update page table according to protected memory ranges and the 4KB-page mapped memory ranges.
+
+**/
+VOID
+InitPaging (
+  VOID
+  )
+{
+  UINT64                            *Pml4;
+  UINT64                            *Pde;
+  UINT64                            *Pte;
+  UINT64                            *Pt;
+  UINTN                             Address;
+  UINTN                             Level1;
+  UINTN                             Level2;
+  UINTN                             Level3;
+  UINTN                             Level4;
+  UINTN                             NumberOfPdpEntries;
+  UINTN                             NumberOfPml4Entries;
+  UINTN                             SizeOfMemorySpace;
+  BOOLEAN                           Nx;
+
+  if (sizeof (UINTN) == sizeof (UINT64)) {
+    Pml4 = (UINT64*)(UINTN)mSmmProfileCr3;
+    SizeOfMemorySpace = HighBitSet64 (gPhyMask) + 1;
+    //
+    // Calculate the table entries of PML4E and PDPTE.
+    //
+    if (SizeOfMemorySpace <= 39 ) {
+      NumberOfPml4Entries = 1;
+      NumberOfPdpEntries = (UINT32)LShiftU64 (1, (SizeOfMemorySpace - 30));
+    } else {
+      NumberOfPml4Entries = (UINT32)LShiftU64 (1, (SizeOfMemorySpace - 39));
+      NumberOfPdpEntries = 512;
+    }
+  } else {
+    NumberOfPml4Entries = 1;
+    NumberOfPdpEntries  = 4;
+  }
+
+  //
+  // Go through page table and change 2MB-page into 4KB-page.
+  //
+  for (Level1 = 0; Level1 < NumberOfPml4Entries; Level1++) {
+    if (sizeof (UINTN) == sizeof (UINT64)) {
+      if ((Pml4[Level1] & IA32_PG_P) == 0) {
+        //
+        // If Pml4 entry does not exist, skip it
+        //
+        continue;
+      }
+      Pde = (UINT64 *)(UINTN)(Pml4[Level1] & PHYSICAL_ADDRESS_MASK);
+    } else {
+      Pde = (UINT64*)(UINTN)mSmmProfileCr3;
+    }
+    for (Level2 = 0; Level2 < NumberOfPdpEntries; Level2++, Pde++) {
+      if ((*Pde & IA32_PG_P) == 0) {
+        //
+        // If PDE entry does not exist, skip it
+        //
+        continue;
+      }
+      Pte = (UINT64 *)(UINTN)(*Pde & PHYSICAL_ADDRESS_MASK);
+      if (Pte == 0) {
+        continue;
+      }
+      for (Level3 = 0; Level3 < SIZE_4KB / sizeof (*Pte); Level3++, Pte++) {
+        if ((*Pte & IA32_PG_P) == 0) {
+          //
+          // If PTE entry does not exist, skip it
+          //
+          continue;
+        }
+        Address = (((Level2 << 9) + Level3) << 21);
+
+        //
+        // If it is 2M page, check IsAddressSplit()
+        //
+        if (((*Pte & IA32_PG_PS) != 0) && IsAddressSplit (Address)) {
+          //
+          // Based on current page table, create 4KB page table for split area.
+          //
+          ASSERT (Address == (*Pte & PHYSICAL_ADDRESS_MASK));
+
+          Pt = AllocatePages (1);
+          ASSERT (Pt != NULL);
+
+          // Split it
+          for (Level4 = 0; Level4 < SIZE_4KB / sizeof(*Pt); Level4++) {
+            Pt[Level4] = Address + ((Level4 << 12) | IA32_PG_RW | IA32_PG_P);
+          } // end for PT
+          *Pte = (UINTN)Pt | IA32_PG_RW | IA32_PG_P;
+        } // end if IsAddressSplit
+      } // end for PTE
+    } // end for PDE
+  }
+
+  //
+  // Go through page table and set several page table entries to absent or execute-disable.
+  //
+  DEBUG ((EFI_D_INFO, "Patch page table start ...\n"));
+  for (Level1 = 0; Level1 < NumberOfPml4Entries; Level1++) {
+    if (sizeof (UINTN) == sizeof (UINT64)) {
+      if ((Pml4[Level1] & IA32_PG_P) == 0) {
+        //
+        // If Pml4 entry does not exist, skip it
+        //
+        continue;
+      }
+      Pde = (UINT64 *)(UINTN)(Pml4[Level1] & PHYSICAL_ADDRESS_MASK);
+    } else {
+      Pde = (UINT64*)(UINTN)mSmmProfileCr3;
+    }
+    for (Level2 = 0; Level2 < NumberOfPdpEntries; Level2++, Pde++) {
+      if ((*Pde & IA32_PG_P) == 0) {
+        //
+        // If PDE entry does not exist, skip it
+        //
+        continue;
+      }
+      Pte = (UINT64 *)(UINTN)(*Pde & PHYSICAL_ADDRESS_MASK);
+      if (Pte == 0) {
+        continue;
+      }
+      for (Level3 = 0; Level3 < SIZE_4KB / sizeof (*Pte); Level3++, Pte++) {
+        if ((*Pte & IA32_PG_P) == 0) {
+          //
+          // If PTE entry does not exist, skip it
+          //
+          continue;
+        }
+        Address = (((Level2 << 9) + Level3) << 21);
+
+        if ((*Pte & IA32_PG_PS) != 0) {
+          // 2MB page
+
+          if (!IsAddressValid (Address, &Nx)) {
+            //
+            // Patch to remove Present flag and RW flag
+            //
+            *Pte = *Pte & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+          }
+          if (Nx && mXdSupported) {
+            *Pte = *Pte | IA32_PG_NX;
+          }
+        } else {
+          // 4KB page
+          Pt = (UINT64 *)(UINTN)(*Pte & PHYSICAL_ADDRESS_MASK);
+          if (Pt == 0) {
+            continue;
+          }
+          for (Level4 = 0; Level4 < SIZE_4KB / sizeof(*Pt); Level4++, Pt++) {
+            if (!IsAddressValid (Address, &Nx)) {
+              *Pt = *Pt & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+            }
+            if (Nx && mXdSupported) {
+              *Pt = *Pt | IA32_PG_NX;
+            }
+            Address += SIZE_4KB;
+          } // end for PT
+        } // end if PS
+      } // end for PTE
+    } // end for PDE
+  }
+
+  //
+  // Flush TLB
+  //
+  CpuFlushTlb ();
+  DEBUG ((EFI_D_INFO, "Patch page table done!\n"));
+  //
+  // Set execute-disable flag
+  //
+  mXdEnabled = TRUE;
+
+  return ;
+}
+
+/**
+  To find FADT in ACPI tables.
+
+  @param AcpiTableGuid   The GUID used to find ACPI table in UEFI ConfigurationTable.
+
+  @return  FADT table pointer.
+**/
+EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE  *
+FindAcpiFadtTableByAcpiGuid (
+  IN EFI_GUID  *AcpiTableGuid
+  )
+{
+  EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER  *Rsdp;
+  EFI_ACPI_DESCRIPTION_HEADER                   *Rsdt;
+  EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE     *Fadt;
+  UINTN                                         Index;
+  UINT32                                        Data32;
+  Rsdp  = NULL;
+  Rsdt  = NULL;
+  Fadt  = NULL;
+  //
+  // found ACPI table RSD_PTR from system table
+  //
+  for (Index = 0; Index < gST->NumberOfTableEntries; Index++) {
+    if (CompareGuid (&(gST->ConfigurationTable[Index].VendorGuid), AcpiTableGuid)) {
+      //
+      // A match was found.
+      //
+      Rsdp = gST->ConfigurationTable[Index].VendorTable;
+      break;
+    }
+  }
+
+  if (Rsdp == NULL) {
+    return NULL;
+  }
+
+  Rsdt = (EFI_ACPI_DESCRIPTION_HEADER *)(UINTN) Rsdp->RsdtAddress;
+  if (Rsdt == NULL || Rsdt->Signature != EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {
+    return NULL;
+  }
+
+  for (Index = sizeof (EFI_ACPI_DESCRIPTION_HEADER); Index < Rsdt->Length; Index = Index + sizeof (UINT32)) {
+
+    Data32  = *(UINT32 *) ((UINT8 *) Rsdt + Index);
+    Fadt    = (EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *) (UINT32 *) (UINTN) Data32;
+    if (Fadt->Header.Signature == EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE) {
+      break;
+    }
+  }
+
+  if (Fadt == NULL || Fadt->Header.Signature != EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE) {
+    return NULL;
+  }
+
+  return Fadt;
+}
+
+/**
+  To find FADT in ACPI tables.
+
+  @return  FADT table pointer.
+**/
+EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE  *
+FindAcpiFadtTable (
+  VOID
+  )
+{
+  EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *Fadt;
+
+  Fadt = FindAcpiFadtTableByAcpiGuid (&gEfiAcpi20TableGuid);
+  if (Fadt != NULL) {
+    return Fadt;
+  }
+
+  return FindAcpiFadtTableByAcpiGuid (&gEfiAcpi10TableGuid);
+}
+
+/**
+  To get system port address of the SMI Command Port in FADT table.
+
+**/
+VOID
+GetSmiCommandPort (
+  VOID
+  )
+{
+  EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *Fadt;
+
+  Fadt = FindAcpiFadtTable ();
+  ASSERT (Fadt != NULL);
+
+  mSmiCommandPort = Fadt->SmiCmd;
+  DEBUG ((EFI_D_INFO, "mSmiCommandPort = %x\n", mSmiCommandPort));
+}
+
+/**
+  Updates page table to make some memory ranges (like system memory) absent
+  and make some memory ranges (like MMIO) present and execute disable. It also
+  update 2MB-page to 4KB-page for some memory ranges.
+
+**/
+VOID
+SmmProfileStart (
+  VOID
+  )
+{
+  //
+  // The flag indicates SMM profile starts to work.
+  //
+  mSmmProfileStart = TRUE;
+}
+
+/**
+  Initialize SMM profile in SmmReadyToLock protocol callback function.
+
+  @param  Protocol   Points to the protocol's unique identifier.
+  @param  Interface  Points to the interface instance.
+  @param  Handle     The handle on which the interface was installed.
+
+  @retval EFI_SUCCESS SmmReadyToLock protocol callback runs successfully.
+**/
+EFI_STATUS
+EFIAPI
+InitSmmProfileCallBack (
+  IN CONST EFI_GUID  *Protocol,
+  IN VOID            *Interface,
+  IN EFI_HANDLE      Handle
+  )
+{
+  EFI_STATUS         Status;
+
+  //
+  // Save to variable so that SMM profile data can be found.
+  //
+  Status = gRT->SetVariable (
+                  SMM_PROFILE_NAME,
+                  &gEfiCallerIdGuid,
+                  EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+                  sizeof(mSmmProfileBase),
+                  &mSmmProfileBase
+                  );
+
+  //
+  // Get Software SMI from FADT
+  //
+  GetSmiCommandPort ();
+
+  //
+  // Initialize protected memory range for patching page table later.
+  //
+  InitProtectedMemRange ();
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialize SMM profile data structures.
+
+**/
+VOID
+InitSmmProfileInternal (
+  VOID
+  )
+{
+  EFI_STATUS                 Status;
+  EFI_PHYSICAL_ADDRESS       Base;
+  VOID                       *Registration;
+  UINTN                      Index;
+  UINTN                      MsrDsAreaSizePerCpu;
+  UINTN                      TotalSize;
+
+  mPFEntryCount = (UINTN *)AllocateZeroPool (sizeof (UINTN) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+  ASSERT (mPFEntryCount != NULL);
+  mLastPFEntryValue = (UINT64  (*)[MAX_PF_ENTRY_COUNT])AllocateZeroPool (
+                                                         sizeof (mLastPFEntryValue[0]) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+  ASSERT (mLastPFEntryValue != NULL);
+  mLastPFEntryPointer = (UINT64 *(*)[MAX_PF_ENTRY_COUNT])AllocateZeroPool (
+                                                           sizeof (mLastPFEntryPointer[0]) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+  ASSERT (mLastPFEntryPointer != NULL);
+
+  //
+  // Allocate memory for SmmProfile below 4GB.
+  // The base address
+  //
+  mSmmProfileSize = PcdGet32 (PcdCpuSmmProfileSize);
+  ASSERT ((mSmmProfileSize & 0xFFF) == 0);
+
+  if (mBtsSupported) {
+    TotalSize = mSmmProfileSize + mMsrDsAreaSize;
+  } else {
+    TotalSize = mSmmProfileSize;
+  }
+
+  Base = 0xFFFFFFFF;
+  Status = gBS->AllocatePages (
+                  AllocateMaxAddress,
+                  EfiReservedMemoryType,
+                  EFI_SIZE_TO_PAGES (TotalSize),
+                  &Base
+                  );
+  ASSERT_EFI_ERROR (Status);
+  ZeroMem ((VOID *)(UINTN)Base, TotalSize);
+  mSmmProfileBase = (SMM_PROFILE_HEADER *)(UINTN)Base;
+
+  //
+  // Initialize SMM profile data header.
+  //
+  mSmmProfileBase->HeaderSize     = sizeof (SMM_PROFILE_HEADER);
+  mSmmProfileBase->MaxDataEntries = (UINT64)((mSmmProfileSize - sizeof(SMM_PROFILE_HEADER)) / sizeof (SMM_PROFILE_ENTRY));
+  mSmmProfileBase->MaxDataSize    = MultU64x64 (mSmmProfileBase->MaxDataEntries, sizeof(SMM_PROFILE_ENTRY));
+  mSmmProfileBase->CurDataEntries = 0;
+  mSmmProfileBase->CurDataSize    = 0;
+  mSmmProfileBase->TsegStart      = mCpuHotPlugData.SmrrBase;
+  mSmmProfileBase->TsegSize       = mCpuHotPlugData.SmrrSize;
+  mSmmProfileBase->NumSmis        = 0;
+  mSmmProfileBase->NumCpus        = gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus;
+
+  if (mBtsSupported) {
+    mMsrDsArea = (MSR_DS_AREA_STRUCT **)AllocateZeroPool (sizeof (MSR_DS_AREA_STRUCT *) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+    ASSERT (mMsrDsArea != NULL);
+    mMsrBTSRecord = (BRANCH_TRACE_RECORD **)AllocateZeroPool (sizeof (BRANCH_TRACE_RECORD *) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+    ASSERT (mMsrBTSRecord != NULL);
+    mMsrPEBSRecord = (PEBS_RECORD **)AllocateZeroPool (sizeof (PEBS_RECORD *) * PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
+    ASSERT (mMsrPEBSRecord != NULL);
+
+    mMsrDsAreaBase  = (MSR_DS_AREA_STRUCT *)((UINTN)Base + mSmmProfileSize);
+    MsrDsAreaSizePerCpu = mMsrDsAreaSize / PcdGet32 (PcdCpuMaxLogicalProcessorNumber);
+    mBTSRecordNumber    = (MsrDsAreaSizePerCpu - sizeof(PEBS_RECORD) * PEBS_RECORD_NUMBER - sizeof(MSR_DS_AREA_STRUCT)) / sizeof(BRANCH_TRACE_RECORD);
+    for (Index = 0; Index < PcdGet32 (PcdCpuMaxLogicalProcessorNumber); Index++) {
+      mMsrDsArea[Index]     = (MSR_DS_AREA_STRUCT *)((UINTN)mMsrDsAreaBase + MsrDsAreaSizePerCpu * Index);
+      mMsrBTSRecord[Index]  = (BRANCH_TRACE_RECORD *)((UINTN)mMsrDsArea[Index] + sizeof(MSR_DS_AREA_STRUCT));
+      mMsrPEBSRecord[Index] = (PEBS_RECORD *)((UINTN)mMsrDsArea[Index] + MsrDsAreaSizePerCpu - sizeof(PEBS_RECORD) * PEBS_RECORD_NUMBER);
+
+      mMsrDsArea[Index]->BTSBufferBase          = (UINTN)mMsrBTSRecord[Index];
+      mMsrDsArea[Index]->BTSIndex               = mMsrDsArea[Index]->BTSBufferBase;
+      mMsrDsArea[Index]->BTSAbsoluteMaximum     = mMsrDsArea[Index]->BTSBufferBase + mBTSRecordNumber * sizeof(BRANCH_TRACE_RECORD) + 1;
+      mMsrDsArea[Index]->BTSInterruptThreshold  = mMsrDsArea[Index]->BTSAbsoluteMaximum + 1;
+
+      mMsrDsArea[Index]->PEBSBufferBase         = (UINTN)mMsrPEBSRecord[Index];
+      mMsrDsArea[Index]->PEBSIndex              = mMsrDsArea[Index]->PEBSBufferBase;
+      mMsrDsArea[Index]->PEBSAbsoluteMaximum    = mMsrDsArea[Index]->PEBSBufferBase + PEBS_RECORD_NUMBER * sizeof(PEBS_RECORD) + 1;
+      mMsrDsArea[Index]->PEBSInterruptThreshold = mMsrDsArea[Index]->PEBSAbsoluteMaximum + 1;
+    }
+  }
+
+  mProtectionMemRange      = mProtectionMemRangeTemplate;
+  mProtectionMemRangeCount = sizeof (mProtectionMemRangeTemplate) / sizeof (MEMORY_PROTECTION_RANGE);
+
+  //
+  // Update TSeg entry.
+  //
+  mProtectionMemRange[0].Range.Base = mCpuHotPlugData.SmrrBase;
+  mProtectionMemRange[0].Range.Top  = mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize;
+
+  //
+  // Update SMM profile entry.
+  //
+  mProtectionMemRange[1].Range.Base = (EFI_PHYSICAL_ADDRESS)(UINTN)mSmmProfileBase;
+  mProtectionMemRange[1].Range.Top  = (EFI_PHYSICAL_ADDRESS)(UINTN)mSmmProfileBase + TotalSize;
+
+  //
+  // Allocate memory reserved for creating 4KB pages.
+  //
+  InitPagesForPFHandler ();
+
+  //
+  // Start SMM profile when SmmReadyToLock protocol is installed.
+  //
+  Status = gSmst->SmmRegisterProtocolNotify (
+                    &gEfiSmmReadyToLockProtocolGuid,
+                    InitSmmProfileCallBack,
+                    &Registration
+                    );
+  ASSERT_EFI_ERROR (Status);
+
+  return ;
+}
+
+/**
+  Check if XD feature is supported by a processor.
+
+**/
+VOID
+CheckFeatureSupported (
+  VOID
+  )
+{
+  UINT32                 RegEax;
+  UINT32                 RegEdx;
+
+  if (mXdSupported) {
+    AsmCpuid (CPUID_EXTENDED_FUNCTION, &RegEax, NULL, NULL, NULL);
+    if (RegEax <= CPUID_EXTENDED_FUNCTION) {
+      //
+      // Extended CPUID functions are not supported on this processor.
+      //
+      mXdSupported = FALSE;
+    }
+
+    AsmCpuid (CPUID_EXTENDED_CPU_SIG, NULL, NULL, NULL, &RegEdx);
+    if ((RegEdx & CPUID1_EDX_XD_SUPPORT) == 0) {
+      //
+      // Execute Disable Bit feature is not supported on this processor.
+      //
+      mXdSupported = FALSE;
+    }
+  }
+
+  if (mBtsSupported) {
+    AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &RegEdx);
+    if ((RegEdx & CPUID1_EDX_BTS_AVAILABLE) != 0) {
+      //
+      // Per IA32 manuals:
+      // When CPUID.1:EDX[21] is set, the following BTS facilities are available:
+      // 1. The BTS_UNAVAILABLE flag in the IA32_MISC_ENABLE MSR indicates the
+      //    availability of the BTS facilities, including the ability to set the BTS and
+      //    BTINT bits in the MSR_DEBUGCTLA MSR.
+      // 2. The IA32_DS_AREA MSR can be programmed to point to the DS save area.
+      //
+      if ((AsmMsrBitFieldRead64 (MSR_IA32_MISC_ENABLE, 11, 11) == 0) &&
+          (AsmMsrBitFieldRead64 (MSR_IA32_MISC_ENABLE, 12, 12) == 0)) {
+        //
+        // BTS facilities is supported.
+        //
+        mBtsSupported = FALSE;
+      }
+    }
+  }
+}
+
+/**
+  Check if XD and BTS features are supported by all processors.
+
+**/
+VOID
+CheckProcessorFeature (
+  VOID
+  )
+{
+  EFI_STATUS                        Status;
+  EFI_MP_SERVICES_PROTOCOL          *MpServices;
+
+  Status = gBS->LocateProtocol (&gEfiMpServiceProtocolGuid, NULL, (VOID **)&MpServices);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // First detect if XD and BTS are supported
+  //
+  mXdSupported  = TRUE;
+  mBtsSupported = TRUE;
+
+  //
+  // Check if XD and BTS are supported on all processors.
+  //
+  CheckFeatureSupported ();
+
+  //
+  //Check on other processors if BSP supports this
+  //
+  if (mXdSupported || mBtsSupported) {
+    MpServices->StartupAllAPs (
+                  MpServices,
+                  (EFI_AP_PROCEDURE) CheckFeatureSupported,
+                  TRUE,
+                  NULL,
+                  0,
+                  NULL,
+                  NULL
+                  );
+  }
+}
+
+/**
+  Enable XD feature.
+
+**/
+VOID
+ActivateXd (
+  VOID
+  )
+{
+  UINT64           MsrRegisters;
+
+  MsrRegisters = AsmReadMsr64 (MSR_EFER);
+  if ((MsrRegisters & MSR_EFER_XD) != 0) {
+    return ;
+  }
+  MsrRegisters |= MSR_EFER_XD;
+  AsmWriteMsr64 (MSR_EFER, MsrRegisters);
+}
+
+/**
+  Enable single step.
+
+**/
+VOID
+ActivateSingleStepDB (
+  VOID
+  )
+{
+  UINTN    Dr6;
+
+  Dr6 = AsmReadDr6 ();
+  if ((Dr6 & DR6_SINGLE_STEP) != 0) {
+    return;
+  }
+  Dr6 |= DR6_SINGLE_STEP;
+  AsmWriteDr6 (Dr6);
+}
+
+/**
+  Enable last branch.
+
+**/
+VOID
+ActivateLBR (
+  VOID
+  )
+{
+  UINT64  DebugCtl;
+
+  DebugCtl = AsmReadMsr64 (MSR_DEBUG_CTL);
+  if ((DebugCtl & MSR_DEBUG_CTL_LBR) != 0) {
+    return ;
+  }
+  AsmWriteMsr64 (MSR_LER_FROM_LIP, 0);
+  AsmWriteMsr64 (MSR_LER_TO_LIP, 0);
+  DebugCtl |= MSR_DEBUG_CTL_LBR;
+  AsmWriteMsr64 (MSR_DEBUG_CTL, DebugCtl);
+}
+
+/**
+  Enable branch trace store.
+
+  @param  CpuIndex  The index of the processor.
+
+**/
+VOID
+ActivateBTS (
+  IN      UINTN                     CpuIndex
+  )
+{
+  UINT64  DebugCtl;
+
+  DebugCtl = AsmReadMsr64 (MSR_DEBUG_CTL);
+  if ((DebugCtl & MSR_DEBUG_CTL_BTS) != 0) {
+    return ;
+  }
+
+  AsmWriteMsr64 (MSR_DS_AREA, (UINT64)(UINTN)mMsrDsArea[CpuIndex]);
+  DebugCtl |= (UINT64)(MSR_DEBUG_CTL_BTS | MSR_DEBUG_CTL_TR);
+  DebugCtl &= ~((UINT64)MSR_DEBUG_CTL_BTINT);
+  AsmWriteMsr64 (MSR_DEBUG_CTL, DebugCtl);
+}
+
+/**
+  Increase SMI number in each SMI entry.
+
+**/
+VOID
+SmmProfileRecordSmiNum (
+  VOID
+  )
+{
+  if (mSmmProfileStart) {
+    mSmmProfileBase->NumSmis++;
+  }
+}
+
+/**
+  Initialize processor environment for SMM profile.
+
+  @param  CpuIndex  The index of the processor.
+
+**/
+VOID
+ActivateSmmProfile (
+  IN UINTN CpuIndex
+  )
+{
+  //
+  // Enable Single Step DB#
+  //
+  ActivateSingleStepDB ();
+
+  if (mBtsSupported) {
+    //
+    // We can not get useful information from LER, so we have to use BTS.
+    //
+    ActivateLBR ();
+
+    //
+    // Enable BTS
+    //
+    ActivateBTS (CpuIndex);
+  }
+}
+
+/**
+  Initialize SMM profile in SMM CPU entry point.
+
+  @param[in] Cr3  The base address of the page tables to use in SMM.
+
+**/
+VOID
+InitSmmProfile (
+  UINT32  Cr3
+  )
+{
+  //
+  // Save Cr3
+  //
+  mSmmProfileCr3 = Cr3;
+
+  //
+  // Skip SMM profile initialization if feature is disabled
+  //
+  if (!FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    return;
+  }
+
+  //
+  // Initialize SmmProfile here
+  //
+  InitSmmProfileInternal ();
+
+  //
+  // Initialize profile IDT.
+  //
+  InitIdtr ();
+}
+
+/**
+  Update page table to map the memory correctly in order to make the instruction
+  which caused page fault execute successfully. And it also save the original page
+  table to be restored in single-step exception.
+
+  @param  PageTable           PageTable Address.
+  @param  PFAddress           The memory address which caused page fault exception.
+  @param  CpuIndex            The index of the processor.
+  @param  ErrorCode           The Error code of exception.
+
+**/
+VOID
+RestorePageTableBelow4G (
+  UINT64        *PageTable,
+  UINT64        PFAddress,
+  UINTN         CpuIndex,
+  UINTN         ErrorCode
+  )
+{
+  UINTN         PTIndex;
+  UINTN         PFIndex;
+
+  //
+  // PML4
+  //
+  if (sizeof(UINT64) == sizeof(UINTN)) {
+    PTIndex = (UINTN)BitFieldRead64 (PFAddress, 39, 47);
+    ASSERT (PageTable[PTIndex] != 0);
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+  }
+
+  //
+  // PDPTE
+  //
+  PTIndex = (UINTN)BitFieldRead64 (PFAddress, 30, 38);
+  ASSERT (PageTable[PTIndex] != 0);
+  PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+
+  //
+  // PD
+  //
+  PTIndex = (UINTN)BitFieldRead64 (PFAddress, 21, 29);
+  if ((PageTable[PTIndex] & IA32_PG_PS) != 0) {
+    //
+    // Large page
+    //
+
+    //
+    // Record old entries with non-present status
+    // Old entries include the memory which instruction is at and the memory which instruction access.
+    //
+    //
+    ASSERT (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT);
+    if (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT) {
+      PFIndex = mPFEntryCount[CpuIndex];
+      mLastPFEntryValue[CpuIndex][PFIndex]   = PageTable[PTIndex];
+      mLastPFEntryPointer[CpuIndex][PFIndex] = &PageTable[PTIndex];
+      mPFEntryCount[CpuIndex]++;
+    }
+
+    //
+    // Set new entry
+    //
+    PageTable[PTIndex] = (PFAddress & ~((1ull << 21) - 1));
+    PageTable[PTIndex] |= (UINT64)IA32_PG_PS;
+    PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+    if ((ErrorCode & IA32_PF_EC_ID) != 0) {
+      PageTable[PTIndex] &= ~IA32_PG_NX;
+    }
+  } else {
+    //
+    // Small page
+    //
+    ASSERT (PageTable[PTIndex] != 0);
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+
+    //
+    // 4K PTE
+    //
+    PTIndex = (UINTN)BitFieldRead64 (PFAddress, 12, 20);
+
+    //
+    // Record old entries with non-present status
+    // Old entries include the memory which instruction is at and the memory which instruction access.
+    //
+    //
+    ASSERT (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT);
+    if (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT) {
+      PFIndex = mPFEntryCount[CpuIndex];
+      mLastPFEntryValue[CpuIndex][PFIndex]   = PageTable[PTIndex];
+      mLastPFEntryPointer[CpuIndex][PFIndex] = &PageTable[PTIndex];
+      mPFEntryCount[CpuIndex]++;
+    }
+
+    //
+    // Set new entry
+    //
+    PageTable[PTIndex] = (PFAddress & ~((1ull << 12) - 1));
+    PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+    if ((ErrorCode & IA32_PF_EC_ID) != 0) {
+      PageTable[PTIndex] &= ~IA32_PG_NX;
+    }
+  }
+}
+
+/**
+  The Page fault handler to save SMM profile data.
+
+  @param  Rip        The RIP when exception happens.
+  @param  ErrorCode  The Error code of exception.
+
+**/
+VOID
+SmmProfilePFHandler (
+  UINTN Rip,
+  UINTN ErrorCode
+  )
+{
+  UINT64                *PageTable;
+  UINT64                PFAddress;
+  UINTN                 CpuIndex;
+  UINTN                 Index;
+  UINT64                InstructionAddress;
+  UINTN                 MaxEntryNumber;
+  UINTN                 CurrentEntryNumber;
+  BOOLEAN               IsValidPFAddress;
+  SMM_PROFILE_ENTRY     *SmmProfileEntry;
+  UINT64                SmiCommand;
+  EFI_STATUS            Status;
+  UINTN                 SwSmiCpuIndex;
+  UINT8                 SoftSmiValue;
+  EFI_SMM_SAVE_STATE_IO_INFO    IoInfo;
+
+  if (!mSmmProfileStart) {
+    //
+    // If SMM profile does not start, call original page fault handler.
+    //
+    SmiDefaultPFHandler ();
+    return;
+  }
+
+  if (mBtsSupported) {
+    DisableBTS ();
+  }
+
+  IsValidPFAddress  = FALSE;
+  PageTable         = (UINT64 *)AsmReadCr3 ();
+  PFAddress         = AsmReadCr2 ();
+  CpuIndex          = GetCpuIndex ();
+
+  if (PFAddress <= 0xFFFFFFFF) {
+    RestorePageTableBelow4G (PageTable, PFAddress, CpuIndex, ErrorCode);
+  } else {
+    RestorePageTableAbove4G (PageTable, PFAddress, CpuIndex, ErrorCode, &IsValidPFAddress);
+  }
+
+  if (!IsValidPFAddress) {
+    InstructionAddress = Rip;
+    if ((ErrorCode & IA32_PF_EC_ID) != 0 && (mBtsSupported)) {
+      //
+      // If it is instruction fetch failure, get the correct IP from BTS.
+      //
+      InstructionAddress = GetSourceFromDestinationOnBts (CpuIndex, Rip);
+      if (InstructionAddress == 0) {
+        //
+        // It indicates the instruction which caused page fault is not a jump instruction,
+        // set instruction address same as the page fault address.
+        //
+        InstructionAddress = PFAddress;
+      }
+    }
+
+    //
+    // Try to find which CPU trigger SWSMI
+    //
+    SwSmiCpuIndex = 0;
+    //
+    // Indicate it is not software SMI
+    //
+    SmiCommand    = 0xFFFFFFFFFFFFFFFFULL;
+    for (Index = 0; Index < gSmst->NumberOfCpus; Index++) {
+      Status = SmmReadSaveState(&mSmmCpu, sizeof(IoInfo), EFI_SMM_SAVE_STATE_REGISTER_IO, Index, &IoInfo);
+      if (EFI_ERROR (Status)) {
+        continue;
+      }
+      if (IoInfo.IoPort == mSmiCommandPort) {
+        //
+        // Great! Find it.
+        //
+        SwSmiCpuIndex = Index;
+        //
+        // A software SMI triggered by SMI command port has been found, get SmiCommand from SMI command port.
+        //
+        SoftSmiValue = IoRead8 (mSmiCommandPort);
+        SmiCommand = (UINT64)SoftSmiValue;
+        break;
+      }
+    }
+
+    SmmProfileEntry = (SMM_PROFILE_ENTRY *)(UINTN)(mSmmProfileBase + 1);
+    //
+    // Check if there is already a same entry in profile data.
+    //
+    for (Index = 0; Index < (UINTN) mSmmProfileBase->CurDataEntries; Index++) {
+      if ((SmmProfileEntry[Index].ErrorCode   == (UINT64)ErrorCode) &&
+          (SmmProfileEntry[Index].Address     == PFAddress) &&
+          (SmmProfileEntry[Index].CpuNum      == (UINT64)CpuIndex) &&
+          (SmmProfileEntry[Index].Instruction == InstructionAddress) &&
+          (SmmProfileEntry[Index].SmiCmd      == SmiCommand)) {
+        //
+        // Same record exist, need not save again.
+        //
+        break;
+      }
+    }
+    if (Index == mSmmProfileBase->CurDataEntries) {
+      CurrentEntryNumber = (UINTN) mSmmProfileBase->CurDataEntries;
+      MaxEntryNumber     = (UINTN) mSmmProfileBase->MaxDataEntries;
+      if (FeaturePcdGet (PcdCpuSmmProfileRingBuffer)) {
+        CurrentEntryNumber = CurrentEntryNumber % MaxEntryNumber;
+      }
+      if (CurrentEntryNumber < MaxEntryNumber) {
+        //
+        // Log the new entry
+        //
+        SmmProfileEntry[CurrentEntryNumber].SmiNum      = mSmmProfileBase->NumSmis;
+        SmmProfileEntry[CurrentEntryNumber].ErrorCode   = (UINT64)ErrorCode;
+        SmmProfileEntry[CurrentEntryNumber].ApicId      = (UINT64)GetApicId ();
+        SmmProfileEntry[CurrentEntryNumber].CpuNum      = (UINT64)CpuIndex;
+        SmmProfileEntry[CurrentEntryNumber].Address     = PFAddress;
+        SmmProfileEntry[CurrentEntryNumber].Instruction = InstructionAddress;
+        SmmProfileEntry[CurrentEntryNumber].SmiCmd      = SmiCommand;
+        //
+        // Update current entry index and data size in the header.
+        //
+        mSmmProfileBase->CurDataEntries++;
+        mSmmProfileBase->CurDataSize = MultU64x64 (mSmmProfileBase->CurDataEntries, sizeof (SMM_PROFILE_ENTRY));
+      }
+    }
+  }
+  //
+  // Flush TLB
+  //
+  CpuFlushTlb ();
+
+  if (mBtsSupported) {
+    EnableBTS ();
+  }
+}
+
+/**
+  Replace INT1 exception handler to restore page table to absent/execute-disable state
+  in order to trigger page fault again to save SMM profile data..
+
+**/
+VOID
+InitIdtr (
+  VOID
+  )
+{
+  SmmRegisterExceptionHandler (&mSmmCpuService, EXCEPT_IA32_DEBUG, DebugExceptionHandler);
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
new file mode 100644
index 000000000000..45484674589d
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
@@ -0,0 +1,134 @@
+/** @file
+SMM profile header file.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_PROFILE_H_
+#define _SMM_PROFILE_H_
+
+#include "SmmProfileInternal.h"
+
+///
+/// MSR Register Index
+///
+#define MSR_IA32_MISC_ENABLE                  0x1A0
+
+//
+// External functions
+//
+
+/**
+  Initialize processor environment for SMM profile.
+
+  @param  CpuIndex  The index of the processor.
+
+**/
+VOID
+ActivateSmmProfile (
+  IN UINTN CpuIndex
+  );
+
+/**
+  Initialize SMM profile in SMM CPU entry point.
+
+  @param[in] Cr3  The base address of the page tables to use in SMM.
+
+**/
+VOID
+InitSmmProfile (
+  UINT32  Cr3
+  );
+
+/**
+  Increase SMI number in each SMI entry.
+
+**/
+VOID
+SmmProfileRecordSmiNum (
+  VOID
+  );
+
+/**
+  The Page fault handler to save SMM profile data.
+
+  @param  Rip        The RIP when exception happens.
+  @param  ErrorCode  The Error code of exception.
+
+**/
+VOID
+SmmProfilePFHandler (
+  UINTN Rip,
+  UINTN ErrorCode
+  );
+
+/**
+  Updates page table to make some memory ranges (like system memory) absent
+  and make some memory ranges (like MMIO) present and execute disable. It also
+  update 2MB-page to 4KB-page for some memory ranges.
+
+**/
+VOID
+SmmProfileStart (
+  VOID
+  );
+
+/**
+  Page fault IDT handler for SMM Profile.
+
+**/
+VOID
+EFIAPI
+PageFaultIdtHandlerSmmProfile (
+  VOID
+  );
+
+
+/**
+  Check if XD feature is supported by a processor.
+
+**/
+VOID
+CheckFeatureSupported (
+  VOID
+  );
+
+/**
+  Enable XD feature.
+
+**/
+VOID
+ActivateXd (
+  VOID
+  );
+
+/**
+  Update page table according to protected memory ranges and the 4KB-page mapped memory ranges.
+
+**/
+VOID
+InitPaging (
+  VOID
+  );
+
+/**
+  Check if XD and BTS features are supported by all processors.
+
+**/
+VOID
+CheckProcessorFeature (
+  VOID
+  );
+
+extern BOOLEAN    mXdSupported;
+extern BOOLEAN    mXdEnabled;
+
+#endif // _SMM_PROFILE_H_
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfileInternal.h b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfileInternal.h
new file mode 100644
index 000000000000..de6eb0aceb9c
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfileInternal.h
@@ -0,0 +1,172 @@
+/** @file
+SMM profile internal header file.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_PROFILE_INTERNAL_H_
+#define _SMM_PROFILE_INTERNAL_H_
+
+#include <Guid/GlobalVariable.h>
+#include <Guid/Acpi.h>
+#include <Protocol/SmmReadyToLock.h>
+#include <Library/UefiRuntimeServicesTableLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/CpuLib.h>
+#include <IndustryStandard/Acpi.h>
+
+#include "SmmProfileArch.h"
+
+//
+// Configure the SMM_PROFILE DTS region size
+//
+#define SMM_PROFILE_DTS_SIZE       (4 * 1024 * 1024) // 4M
+
+#define MAX_PF_PAGE_COUNT           0x2
+
+#define PEBS_RECORD_NUMBER          0x2
+
+#define MAX_PF_ENTRY_COUNT          10
+
+//
+// This MACRO just enable unit test for the profile
+// Please disable it.
+//
+
+#define IA32_PF_EC_P                (1u << 0)
+#define IA32_PF_EC_WR               (1u << 1)
+#define IA32_PF_EC_US               (1u << 2)
+#define IA32_PF_EC_RSVD             (1u << 3)
+#define IA32_PF_EC_ID               (1u << 4)
+
+#define SMM_PROFILE_NAME            L"SmmProfileData"
+
+//
+// CPU generic definition
+//
+#define   CPUID1_EDX_XD_SUPPORT      0x100000
+#define   MSR_EFER                   0xc0000080
+#define   MSR_EFER_XD                0x800
+
+#define   CPUID1_EDX_BTS_AVAILABLE   0x200000
+
+#define   DR6_SINGLE_STEP            0x4000
+#define   RFLAG_TF                   0x100
+
+#define MSR_DEBUG_CTL                0x1D9
+#define   MSR_DEBUG_CTL_LBR          0x1
+#define   MSR_DEBUG_CTL_TR           0x40
+#define   MSR_DEBUG_CTL_BTS          0x80
+#define   MSR_DEBUG_CTL_BTINT        0x100
+#define MSR_LASTBRANCH_TOS           0x1C9
+#define MSR_LER_FROM_LIP             0x1DD
+#define MSR_LER_TO_LIP               0x1DE
+#define MSR_DS_AREA                  0x600
+
+typedef struct {
+  EFI_PHYSICAL_ADDRESS   Base;
+  EFI_PHYSICAL_ADDRESS   Top;
+} MEMORY_RANGE;
+
+typedef struct {
+  MEMORY_RANGE   Range;
+  BOOLEAN        Present;
+  BOOLEAN        Nx;
+} MEMORY_PROTECTION_RANGE;
+
+typedef struct {
+  UINT64  HeaderSize;
+  UINT64  MaxDataEntries;
+  UINT64  MaxDataSize;
+  UINT64  CurDataEntries;
+  UINT64  CurDataSize;
+  UINT64  TsegStart;
+  UINT64  TsegSize;
+  UINT64  NumSmis;
+  UINT64  NumCpus;
+} SMM_PROFILE_HEADER;
+
+typedef struct {
+  UINT64  SmiNum;
+  UINT64  CpuNum;
+  UINT64  ApicId;
+  UINT64  ErrorCode;
+  UINT64  Instruction;
+  UINT64  Address;
+  UINT64  SmiCmd;
+} SMM_PROFILE_ENTRY;
+
+extern SMM_S3_RESUME_STATE       *mSmmS3ResumeState;
+extern UINTN                     gSmiExceptionHandlers[];
+extern BOOLEAN                   mXdSupported;
+extern UINTN                     *mPFEntryCount;
+extern UINT64                    (*mLastPFEntryValue)[MAX_PF_ENTRY_COUNT];
+extern UINT64                    *(*mLastPFEntryPointer)[MAX_PF_ENTRY_COUNT];
+
+//
+// Internal functions
+//
+
+/**
+  Update IDT table to replace page fault handler and INT 1 handler.
+
+**/
+VOID
+InitIdtr (
+  VOID
+  );
+
+/**
+  Check if the memory address will be mapped by 4KB-page.
+
+  @param  Address  The address of Memory.
+
+**/
+BOOLEAN
+IsAddressSplit (
+  IN EFI_PHYSICAL_ADDRESS   Address
+  );
+
+/**
+  Check if the memory address will be mapped by 4KB-page.
+
+  @param  Address  The address of Memory.
+  @param  Nx       The flag indicates if the memory is execute-disable.
+
+**/
+BOOLEAN
+IsAddressValid (
+  IN EFI_PHYSICAL_ADDRESS   Address,
+  IN BOOLEAN                *Nx
+  );
+
+/**
+  Page Fault handler for SMM use.
+
+**/
+VOID
+SmiDefaultPFHandler (
+  VOID
+  );
+
+/**
+  Clear TF in FLAGS.
+
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+
+**/
+VOID
+ClearTrapFlag (
+  IN OUT EFI_SYSTEM_CONTEXT   SystemContext
+  );
+
+#endif // _SMM_PROFILE_H_
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c
new file mode 100644
index 000000000000..539c0294cd6e
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmramSaveState.c
@@ -0,0 +1,700 @@
+/** @file
+Provides services to access SMRAM Save State Map
+
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiSmm.h>
+
+#include <Library/SmmCpuFeaturesLib.h>
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/DebugLib.h>
+#include <Register/Cpuid.h>
+#include <Register/SmramSaveStateMap.h>
+
+//
+// EFER register LMA bit
+//
+#define LMA BIT10
+
+///
+/// Macro used to simplify the lookup table entries of type CPU_SMM_SAVE_STATE_LOOKUP_ENTRY
+///
+#define SMM_CPU_OFFSET(Field) OFFSET_OF (SMRAM_SAVE_STATE_MAP, Field)
+
+///
+/// Macro used to simplify the lookup table entries of type CPU_SMM_SAVE_STATE_REGISTER_RANGE
+///
+#define SMM_REGISTER_RANGE(Start, End) { Start, End, End - Start + 1 }
+
+///
+/// Structure used to describe a range of registers
+///
+typedef struct {
+  EFI_SMM_SAVE_STATE_REGISTER  Start;
+  EFI_SMM_SAVE_STATE_REGISTER  End;
+  UINTN                        Length;
+} CPU_SMM_SAVE_STATE_REGISTER_RANGE;
+
+///
+/// Structure used to build a lookup table to retrieve the widths and offsets
+/// associated with each supported EFI_SMM_SAVE_STATE_REGISTER value
+///
+
+#define SMM_SAVE_STATE_REGISTER_SMMREVID_INDEX        1
+#define SMM_SAVE_STATE_REGISTER_IOMISC_INDEX          2
+#define SMM_SAVE_STATE_REGISTER_IOMEMADDR_INDEX       3
+#define SMM_SAVE_STATE_REGISTER_MAX_INDEX             4
+
+typedef struct {
+  UINT8   Width32;
+  UINT8   Width64;
+  UINT16  Offset32;
+  UINT16  Offset64Lo;
+  UINT16  Offset64Hi;
+  BOOLEAN Writeable;
+} CPU_SMM_SAVE_STATE_LOOKUP_ENTRY;
+
+///
+/// Structure used to build a lookup table for the IOMisc width information
+///
+typedef struct {
+  UINT8                        Width;
+  EFI_SMM_SAVE_STATE_IO_WIDTH  IoWidth;
+} CPU_SMM_SAVE_STATE_IO_WIDTH;
+
+///
+/// Variables from SMI Handler
+///
+extern UINT32           gSmbase;
+extern volatile UINT32  gSmiStack;
+extern UINT32           gSmiCr3;
+extern volatile UINT8   gcSmiHandlerTemplate[];
+extern CONST UINT16     gcSmiHandlerSize;
+
+//
+// Variables used by SMI Handler
+//
+IA32_DESCRIPTOR  gSmiHandlerIdtr;
+
+///
+/// Table used by GetRegisterIndex() to convert an EFI_SMM_SAVE_STATE_REGISTER
+/// value to an index into a table of type CPU_SMM_SAVE_STATE_LOOKUP_ENTRY
+///
+CONST CPU_SMM_SAVE_STATE_REGISTER_RANGE mSmmCpuRegisterRanges[] = {
+  SMM_REGISTER_RANGE (EFI_SMM_SAVE_STATE_REGISTER_GDTBASE, EFI_SMM_SAVE_STATE_REGISTER_LDTINFO),
+  SMM_REGISTER_RANGE (EFI_SMM_SAVE_STATE_REGISTER_ES,      EFI_SMM_SAVE_STATE_REGISTER_RIP),
+  SMM_REGISTER_RANGE (EFI_SMM_SAVE_STATE_REGISTER_RFLAGS,  EFI_SMM_SAVE_STATE_REGISTER_CR4),
+  { (EFI_SMM_SAVE_STATE_REGISTER)0, (EFI_SMM_SAVE_STATE_REGISTER)0, 0 }
+};
+
+///
+/// Lookup table used to retrieve the widths and offsets associated with each
+/// supported EFI_SMM_SAVE_STATE_REGISTER value
+///
+CONST CPU_SMM_SAVE_STATE_LOOKUP_ENTRY mSmmCpuWidthOffset[] = {
+  {0, 0, 0, 0, 0, FALSE},                                                                                                     //  Reserved
+
+  //
+  // Internally defined CPU Save State Registers. Not defined in PI SMM CPU Protocol.
+  //
+  {4, 4, SMM_CPU_OFFSET (x86.SMMRevId)  , SMM_CPU_OFFSET (x64.SMMRevId)  , 0                                 , FALSE}, // SMM_SAVE_STATE_REGISTER_SMMREVID_INDEX  = 1
+  {4, 4, SMM_CPU_OFFSET (x86.IOMisc)    , SMM_CPU_OFFSET (x64.IOMisc)    , 0                                 , FALSE}, // SMM_SAVE_STATE_REGISTER_IOMISC_INDEX    = 2
+  {4, 8, SMM_CPU_OFFSET (x86.IOMemAddr) , SMM_CPU_OFFSET (x64.IOMemAddr) , SMM_CPU_OFFSET (x64.IOMemAddr) + 4, FALSE}, // SMM_SAVE_STATE_REGISTER_IOMEMADDR_INDEX = 3
+
+  //
+  // CPU Save State registers defined in PI SMM CPU Protocol.
+  //
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64.GdtBaseLoDword) , SMM_CPU_OFFSET (x64.GdtBaseHiDword), FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_GDTBASE  = 4
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64.IdtBaseLoDword) , SMM_CPU_OFFSET (x64.IdtBaseHiDword), FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_IDTBASE  = 5
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64.LdtBaseLoDword) , SMM_CPU_OFFSET (x64.LdtBaseHiDword), FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_LDTBASE  = 6
+  {0, 0, 0                            , 0                                   , 0                                  , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_GDTLIMIT = 7
+  {0, 0, 0                            , 0                                   , 0                                  , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_IDTLIMIT = 8
+  {0, 0, 0                            , 0                                   , 0                                  , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_LDTLIMIT = 9
+  {0, 0, 0                            , 0                                   , 0                                  , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_LDTINFO  = 10
+
+  {4, 4, SMM_CPU_OFFSET (x86._ES)     , SMM_CPU_OFFSET (x64._ES)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_ES       = 20
+  {4, 4, SMM_CPU_OFFSET (x86._CS)     , SMM_CPU_OFFSET (x64._CS)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_CS       = 21
+  {4, 4, SMM_CPU_OFFSET (x86._SS)     , SMM_CPU_OFFSET (x64._SS)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_SS       = 22
+  {4, 4, SMM_CPU_OFFSET (x86._DS)     , SMM_CPU_OFFSET (x64._DS)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_DS       = 23
+  {4, 4, SMM_CPU_OFFSET (x86._FS)     , SMM_CPU_OFFSET (x64._FS)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_FS       = 24
+  {4, 4, SMM_CPU_OFFSET (x86._GS)     , SMM_CPU_OFFSET (x64._GS)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_GS       = 25
+  {0, 4, 0                            , SMM_CPU_OFFSET (x64._LDTR)   , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_LDTR_SEL = 26
+  {4, 4, SMM_CPU_OFFSET (x86._TR)     , SMM_CPU_OFFSET (x64._TR)     , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_TR_SEL   = 27
+  {4, 8, SMM_CPU_OFFSET (x86._DR7)    , SMM_CPU_OFFSET (x64._DR7)    , SMM_CPU_OFFSET (x64._DR7)    + 4, FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_DR7      = 28
+  {4, 8, SMM_CPU_OFFSET (x86._DR6)    , SMM_CPU_OFFSET (x64._DR6)    , SMM_CPU_OFFSET (x64._DR6)    + 4, FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_DR6      = 29
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R8)     , SMM_CPU_OFFSET (x64._R8)     + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R8       = 30
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R9)     , SMM_CPU_OFFSET (x64._R9)     + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R9       = 31
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R10)    , SMM_CPU_OFFSET (x64._R10)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R10      = 32
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R11)    , SMM_CPU_OFFSET (x64._R11)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R11      = 33
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R12)    , SMM_CPU_OFFSET (x64._R12)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R12      = 34
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R13)    , SMM_CPU_OFFSET (x64._R13)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R13      = 35
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R14)    , SMM_CPU_OFFSET (x64._R14)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R14      = 36
+  {0, 8, 0                            , SMM_CPU_OFFSET (x64._R15)    , SMM_CPU_OFFSET (x64._R15)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_R15      = 37
+  {4, 8, SMM_CPU_OFFSET (x86._EAX)    , SMM_CPU_OFFSET (x64._RAX)    , SMM_CPU_OFFSET (x64._RAX)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RAX      = 38
+  {4, 8, SMM_CPU_OFFSET (x86._EBX)    , SMM_CPU_OFFSET (x64._RBX)    , SMM_CPU_OFFSET (x64._RBX)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RBX      = 39
+  {4, 8, SMM_CPU_OFFSET (x86._ECX)    , SMM_CPU_OFFSET (x64._RCX)    , SMM_CPU_OFFSET (x64._RCX)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RCX      = 40
+  {4, 8, SMM_CPU_OFFSET (x86._EDX)    , SMM_CPU_OFFSET (x64._RDX)    , SMM_CPU_OFFSET (x64._RDX)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RDX      = 41
+  {4, 8, SMM_CPU_OFFSET (x86._ESP)    , SMM_CPU_OFFSET (x64._RSP)    , SMM_CPU_OFFSET (x64._RSP)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RSP      = 42
+  {4, 8, SMM_CPU_OFFSET (x86._EBP)    , SMM_CPU_OFFSET (x64._RBP)    , SMM_CPU_OFFSET (x64._RBP)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RBP      = 43
+  {4, 8, SMM_CPU_OFFSET (x86._ESI)    , SMM_CPU_OFFSET (x64._RSI)    , SMM_CPU_OFFSET (x64._RSI)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RSI      = 44
+  {4, 8, SMM_CPU_OFFSET (x86._EDI)    , SMM_CPU_OFFSET (x64._RDI)    , SMM_CPU_OFFSET (x64._RDI)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RDI      = 45
+  {4, 8, SMM_CPU_OFFSET (x86._EIP)    , SMM_CPU_OFFSET (x64._RIP)    , SMM_CPU_OFFSET (x64._RIP)    + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RIP      = 46
+
+  {4, 8, SMM_CPU_OFFSET (x86._EFLAGS) , SMM_CPU_OFFSET (x64._RFLAGS) , SMM_CPU_OFFSET (x64._RFLAGS) + 4, TRUE },  //  EFI_SMM_SAVE_STATE_REGISTER_RFLAGS   = 51
+  {4, 8, SMM_CPU_OFFSET (x86._CR0)    , SMM_CPU_OFFSET (x64._CR0)    , SMM_CPU_OFFSET (x64._CR0)    + 4, FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_CR0      = 52
+  {4, 8, SMM_CPU_OFFSET (x86._CR3)    , SMM_CPU_OFFSET (x64._CR3)    , SMM_CPU_OFFSET (x64._CR3)    + 4, FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_CR3      = 53
+  {0, 4, 0                            , SMM_CPU_OFFSET (x64._CR4)    , 0                               , FALSE},  //  EFI_SMM_SAVE_STATE_REGISTER_CR4      = 54
+};
+
+///
+/// Lookup table for the IOMisc width information
+///
+CONST CPU_SMM_SAVE_STATE_IO_WIDTH mSmmCpuIoWidth[] = {
+  { 0, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  },  // Undefined           = 0
+  { 1, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  },  // SMM_IO_LENGTH_BYTE  = 1
+  { 2, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT16 },  // SMM_IO_LENGTH_WORD  = 2
+  { 0, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  },  // Undefined           = 3
+  { 4, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT32 },  // SMM_IO_LENGTH_DWORD = 4
+  { 0, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  },  // Undefined           = 5
+  { 0, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  },  // Undefined           = 6
+  { 0, EFI_SMM_SAVE_STATE_IO_WIDTH_UINT8  }   // Undefined           = 7
+};
+
+///
+/// Lookup table for the IOMisc type information
+///
+CONST EFI_SMM_SAVE_STATE_IO_TYPE mSmmCpuIoType[] = {
+  EFI_SMM_SAVE_STATE_IO_TYPE_OUTPUT,     // SMM_IO_TYPE_OUT_DX        = 0
+  EFI_SMM_SAVE_STATE_IO_TYPE_INPUT,      // SMM_IO_TYPE_IN_DX         = 1
+  EFI_SMM_SAVE_STATE_IO_TYPE_STRING,     // SMM_IO_TYPE_OUTS          = 2
+  EFI_SMM_SAVE_STATE_IO_TYPE_STRING,     // SMM_IO_TYPE_INS           = 3
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 4
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 5
+  EFI_SMM_SAVE_STATE_IO_TYPE_REP_PREFIX, // SMM_IO_TYPE_REP_OUTS      = 6
+  EFI_SMM_SAVE_STATE_IO_TYPE_REP_PREFIX, // SMM_IO_TYPE_REP_INS       = 7
+  EFI_SMM_SAVE_STATE_IO_TYPE_OUTPUT,     // SMM_IO_TYPE_OUT_IMMEDIATE = 8
+  EFI_SMM_SAVE_STATE_IO_TYPE_INPUT,      // SMM_IO_TYPE_OUT_IMMEDIATE = 9
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 10
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 11
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 12
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 13
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0,         // Undefined                 = 14
+  (EFI_SMM_SAVE_STATE_IO_TYPE)0          // Undefined                 = 15
+};
+
+///
+/// The mode of the CPU at the time an SMI occurs
+///
+UINT8  mSmmSaveStateRegisterLma;
+
+/**
+  Read information from the CPU save state.
+
+  @param  Register  Specifies the CPU register to read form the save state.
+
+  @retval 0   Register is not valid
+  @retval >0  Index into mSmmCpuWidthOffset[] associated with Register
+
+**/
+UINTN
+GetRegisterIndex (
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register
+  )
+{
+  UINTN  Index;
+  UINTN  Offset;
+
+  for (Index = 0, Offset = SMM_SAVE_STATE_REGISTER_MAX_INDEX; mSmmCpuRegisterRanges[Index].Length != 0; Index++) {
+    if (Register >= mSmmCpuRegisterRanges[Index].Start && Register <= mSmmCpuRegisterRanges[Index].End) {
+      return Register - mSmmCpuRegisterRanges[Index].Start + Offset;
+    }
+    Offset += mSmmCpuRegisterRanges[Index].Length;
+  }
+  return 0;
+}
+
+/**
+  Read a CPU Save State register on the target processor.
+
+  This function abstracts the differences that whether the CPU Save State register is in the
+  IA32 CPU Save State Map or X64 CPU Save State Map.
+
+  This function supports reading a CPU Save State register in SMBase relocation handler.
+
+  @param[in]  CpuIndex       Specifies the zero-based index of the CPU save state.
+  @param[in]  RegisterIndex  Index into mSmmCpuWidthOffset[] look up table.
+  @param[in]  Width          The number of bytes to read from the CPU save state.
+  @param[out] Buffer         Upon return, this holds the CPU register value read from the save state.
+
+  @retval EFI_SUCCESS           The register was read from Save State.
+  @retval EFI_NOT_FOUND         The register is not defined for the Save State of Processor.
+  @retval EFI_INVALID_PARAMTER  This or Buffer is NULL.
+
+**/
+EFI_STATUS
+ReadSaveStateRegisterByIndex (
+  IN UINTN   CpuIndex,
+  IN UINTN   RegisterIndex,
+  IN UINTN   Width,
+  OUT VOID   *Buffer
+  )
+{
+  SMRAM_SAVE_STATE_MAP  *CpuSaveState;
+
+  if (RegisterIndex == 0) {
+    return EFI_NOT_FOUND;
+  }
+
+  CpuSaveState = gSmst->CpuSaveState[CpuIndex];
+
+  if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
+    //
+    // If 32-bit mode width is zero, then the specified register can not be accessed
+    //
+    if (mSmmCpuWidthOffset[RegisterIndex].Width32 == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // If Width is bigger than the 32-bit mode width, then the specified register can not be accessed
+    //
+    if (Width > mSmmCpuWidthOffset[RegisterIndex].Width32) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    //
+    // Write return buffer
+    //
+    ASSERT(CpuSaveState != NULL);
+    CopyMem(Buffer, (UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset32, Width);
+  } else {
+    //
+    // If 64-bit mode width is zero, then the specified register can not be accessed
+    //
+    if (mSmmCpuWidthOffset[RegisterIndex].Width64 == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // If Width is bigger than the 64-bit mode width, then the specified register can not be accessed
+    //
+    if (Width > mSmmCpuWidthOffset[RegisterIndex].Width64) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    //
+    // Write lower 32-bits of return buffer
+    //
+    CopyMem(Buffer, (UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset64Lo, MIN(4, Width));
+    if (Width >= 4) {
+      //
+      // Write upper 32-bits of return buffer
+      //
+      CopyMem((UINT8 *)Buffer + 4, (UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset64Hi, Width - 4);
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Read a CPU Save State register on the target processor.
+
+  This function abstracts the differences that whether the CPU Save State register is in the
+  IA32 CPU Save State Map or X64 CPU Save State Map.
+
+  This function supports reading a CPU Save State register in SMBase relocation handler.
+
+  @param[in]  CpuIndex       Specifies the zero-based index of the CPU save state.
+  @param[in]  RegisterIndex  Index into mSmmCpuWidthOffset[] look up table.
+  @param[in]  Width          The number of bytes to read from the CPU save state.
+  @param[out] Buffer         Upon return, this holds the CPU register value read from the save state.
+
+  @retval EFI_SUCCESS           The register was read from Save State.
+  @retval EFI_NOT_FOUND         The register is not defined for the Save State of Processor.
+  @retval EFI_INVALID_PARAMTER  This or Buffer is NULL.
+
+**/
+EFI_STATUS
+EFIAPI
+ReadSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  OUT VOID                        *Buffer
+  )
+{
+  UINT32                      SmmRevId;
+  SMRAM_SAVE_STATE_IOMISC     IoMisc;
+  EFI_SMM_SAVE_STATE_IO_INFO  *IoInfo;
+  VOID                        *IoMemAddr;
+
+  //
+  // Check for special EFI_SMM_SAVE_STATE_REGISTER_LMA
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_LMA) {
+    //
+    // Only byte access is supported for this register
+    //
+    if (Width != 1) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    *(UINT8 *)Buffer = mSmmSaveStateRegisterLma;
+
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Check for special EFI_SMM_SAVE_STATE_REGISTER_IO
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_IO) {
+    //
+    // Get SMM Revision ID
+    //
+    ReadSaveStateRegisterByIndex (CpuIndex, SMM_SAVE_STATE_REGISTER_SMMREVID_INDEX, sizeof(SmmRevId), &SmmRevId);
+
+    //
+    // See if the CPU supports the IOMisc register in the save state
+    //
+    if (SmmRevId < SMRAM_SAVE_STATE_MIN_REV_ID_IOMISC) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // Get the IOMisc register value
+    //
+    ReadSaveStateRegisterByIndex (CpuIndex, SMM_SAVE_STATE_REGISTER_IOMISC_INDEX, sizeof(IoMisc.Uint32), &IoMisc.Uint32);
+
+    //
+    // Check for the SMI_FLAG in IOMisc
+    //
+    if (IoMisc.Bits.SmiFlag == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // Compute index for the I/O Length and I/O Type lookup tables
+    //
+    if (mSmmCpuIoWidth[IoMisc.Bits.Length].Width == 0 || mSmmCpuIoType[IoMisc.Bits.Type] == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // Zero the IoInfo structure that will be returned in Buffer
+    //
+    IoInfo = (EFI_SMM_SAVE_STATE_IO_INFO *)Buffer;
+    ZeroMem (IoInfo, sizeof(EFI_SMM_SAVE_STATE_IO_INFO));
+
+    //
+    // Use lookup tables to help fill in all the fields of the IoInfo structure
+    //
+    IoInfo->IoPort = (UINT16)IoMisc.Bits.Port;
+    IoInfo->IoWidth = mSmmCpuIoWidth[IoMisc.Bits.Length].IoWidth;
+    IoInfo->IoType = mSmmCpuIoType[IoMisc.Bits.Type];
+    if (IoInfo->IoType == EFI_SMM_SAVE_STATE_IO_TYPE_INPUT || IoInfo->IoType == EFI_SMM_SAVE_STATE_IO_TYPE_OUTPUT) {
+      ReadSaveStateRegister (CpuIndex, EFI_SMM_SAVE_STATE_REGISTER_RAX, mSmmCpuIoWidth[IoMisc.Bits.Length].Width, &IoInfo->IoData);
+    }
+    else {
+      ReadSaveStateRegisterByIndex(CpuIndex, SMM_SAVE_STATE_REGISTER_IOMEMADDR_INDEX, sizeof(IoMemAddr), &IoMemAddr);
+      CopyMem(&IoInfo->IoData, IoMemAddr, mSmmCpuIoWidth[IoMisc.Bits.Length].Width);
+    }
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Convert Register to a register lookup table index
+  //
+  return ReadSaveStateRegisterByIndex (CpuIndex, GetRegisterIndex (Register), Width, Buffer);
+}
+
+/**
+  Write value to a CPU Save State register on the target processor.
+
+  This function abstracts the differences that whether the CPU Save State register is in the
+  IA32 CPU Save State Map or X64 CPU Save State Map.
+
+  This function supports writing a CPU Save State register in SMBase relocation handler.
+
+  @param[in] CpuIndex       Specifies the zero-based index of the CPU save state.
+  @param[in] RegisterIndex  Index into mSmmCpuWidthOffset[] look up table.
+  @param[in] Width          The number of bytes to read from the CPU save state.
+  @param[in] Buffer         Upon entry, this holds the new CPU register value.
+
+  @retval EFI_SUCCESS           The register was written to Save State.
+  @retval EFI_NOT_FOUND         The register is not defined for the Save State of Processor.
+  @retval EFI_INVALID_PARAMTER  ProcessorIndex or Width is not correct.
+
+**/
+EFI_STATUS
+EFIAPI
+WriteSaveStateRegister (
+  IN UINTN                        CpuIndex,
+  IN EFI_SMM_SAVE_STATE_REGISTER  Register,
+  IN UINTN                        Width,
+  IN CONST VOID                   *Buffer
+  )
+{
+  UINTN                 RegisterIndex;
+  SMRAM_SAVE_STATE_MAP  *CpuSaveState;
+
+  //
+  // Writes to EFI_SMM_SAVE_STATE_REGISTER_LMA are ignored
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_LMA) {
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Writes to EFI_SMM_SAVE_STATE_REGISTER_IO are not supported
+  //
+  if (Register == EFI_SMM_SAVE_STATE_REGISTER_IO) {
+    return EFI_NOT_FOUND;
+  }
+
+  //
+  // Convert Register to a register lookup table index
+  //
+  RegisterIndex = GetRegisterIndex (Register);
+  if (RegisterIndex == 0) {
+    return EFI_NOT_FOUND;
+  }
+
+  CpuSaveState = gSmst->CpuSaveState[CpuIndex];
+
+  //
+  // Do not write non-writable SaveState, because it will cause exception.
+  //
+  if (!mSmmCpuWidthOffset[RegisterIndex].Writeable) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check CPU mode
+  //
+  if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
+    //
+    // If 32-bit mode width is zero, then the specified register can not be accessed
+    //
+    if (mSmmCpuWidthOffset[RegisterIndex].Width32 == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // If Width is bigger than the 32-bit mode width, then the specified register can not be accessed
+    //
+    if (Width > mSmmCpuWidthOffset[RegisterIndex].Width32) {
+      return EFI_INVALID_PARAMETER;
+    }
+    //
+    // Write SMM State register
+    //
+    ASSERT (CpuSaveState != NULL);
+    CopyMem((UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset32, Buffer, Width);
+  } else {
+    //
+    // If 64-bit mode width is zero, then the specified register can not be accessed
+    //
+    if (mSmmCpuWidthOffset[RegisterIndex].Width64 == 0) {
+      return EFI_NOT_FOUND;
+    }
+
+    //
+    // If Width is bigger than the 64-bit mode width, then the specified register can not be accessed
+    //
+    if (Width > mSmmCpuWidthOffset[RegisterIndex].Width64) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    //
+    // Write lower 32-bits of SMM State register
+    //
+    CopyMem((UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset64Lo, Buffer, MIN (4, Width));
+    if (Width >= 4) {
+      //
+      // Write upper 32-bits of SMM State register
+      //
+      CopyMem((UINT8 *)CpuSaveState + mSmmCpuWidthOffset[RegisterIndex].Offset64Hi, (UINT8 *)Buffer + 4, Width - 4);
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Hook the code executed immediately after an RSM instruction on the currently
+  executing CPU.  The mode of code executed immediately after RSM must be
+  detected, and the appropriate hook must be selected.  Always clear the auto
+  HALT restart flag if it is set.
+
+  @param[in] CpuIndex                 The processor index for the currently
+                                      executing CPU.
+  @param[in] CpuState                 Pointer to SMRAM Save State Map for the
+                                      currently executing CPU.
+  @param[in] NewInstructionPointer32  Instruction pointer to use if resuming to
+                                      32-bit mode from 64-bit SMM.
+  @param[in] NewInstructionPointer    Instruction pointer to use if resuming to
+                                      same mode as SMM.
+
+  @retval The value of the original instruction pointer before it was hooked.
+
+**/
+UINT64
+EFIAPI
+HookReturnFromSmm (
+  IN UINTN              CpuIndex,
+  SMRAM_SAVE_STATE_MAP  *CpuState,
+  UINT64                NewInstructionPointer32,
+  UINT64                NewInstructionPointer
+  )
+{
+  UINT64  OriginalInstructionPointer;
+
+  OriginalInstructionPointer = SmmCpuFeaturesHookReturnFromSmm (
+                                 CpuIndex,
+                                 CpuState,
+                                 NewInstructionPointer32,
+                                 NewInstructionPointer
+                                 );
+  if (OriginalInstructionPointer != 0) {
+    return OriginalInstructionPointer;
+  }
+
+  if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
+    OriginalInstructionPointer = (UINT64)CpuState->x86._EIP;
+    CpuState->x86._EIP = (UINT32)NewInstructionPointer;
+    //
+    // Clear the auto HALT restart flag so the RSM instruction returns
+    // program control to the instruction following the HLT instruction.
+    //
+    if ((CpuState->x86.AutoHALTRestart & BIT0) != 0) {
+      CpuState->x86.AutoHALTRestart &= ~BIT0;
+    }
+  } else {
+    OriginalInstructionPointer = CpuState->x64._RIP;
+    if ((CpuState->x64.IA32_EFER & LMA) == 0) {
+      CpuState->x64._RIP = (UINT32)NewInstructionPointer32;
+    } else {
+      CpuState->x64._RIP = (UINT32)NewInstructionPointer;
+    }
+    //
+    // Clear the auto HALT restart flag so the RSM instruction returns
+    // program control to the instruction following the HLT instruction.
+    //
+    if ((CpuState->x64.AutoHALTRestart & BIT0) != 0) {
+      CpuState->x64.AutoHALTRestart &= ~BIT0;
+    }
+  }
+  return OriginalInstructionPointer;
+}
+
+/**
+  Get the size of the SMI Handler in bytes.
+
+  @retval The size, in bytes, of the SMI Handler.
+
+**/
+UINTN
+EFIAPI
+GetSmiHandlerSize (
+  VOID
+  )
+{
+  UINTN  Size;
+
+  Size = SmmCpuFeaturesGetSmiHandlerSize ();
+  if (Size != 0) {
+    return Size;
+  }
+  return gcSmiHandlerSize;
+}
+
+/**
+  Install the SMI handler for the CPU specified by CpuIndex.  This function
+  is called by the CPU that was elected as monarch during System Management
+  Mode initialization.
+
+  @param[in] CpuIndex   The index of the CPU to install the custom SMI handler.
+                        The value must be between 0 and the NumberOfCpus field
+                        in the System Management System Table (SMST).
+  @param[in] SmBase     The SMBASE address for the CPU specified by CpuIndex.
+  @param[in] SmiStack   The stack to use when an SMI is processed by the
+                        the CPU specified by CpuIndex.
+  @param[in] StackSize  The size, in bytes, if the stack used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtBase    The base address of the GDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] GdtSize    The size, in bytes, of the GDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtBase    The base address of the IDT to use when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] IdtSize    The size, in bytes, of the IDT used when an SMI is
+                        processed by the CPU specified by CpuIndex.
+  @param[in] Cr3        The base address of the page tables to use when an SMI
+                        is processed by the CPU specified by CpuIndex.
+**/
+VOID
+EFIAPI
+InstallSmiHandler (
+  IN UINTN   CpuIndex,
+  IN UINT32  SmBase,
+  IN VOID    *SmiStack,
+  IN UINTN   StackSize,
+  IN UINTN   GdtBase,
+  IN UINTN   GdtSize,
+  IN UINTN   IdtBase,
+  IN UINTN   IdtSize,
+  IN UINT32  Cr3
+  )
+{
+  if (SmmCpuFeaturesGetSmiHandlerSize () != 0) {
+    //
+    // Install SMI handler provided by library
+    //
+    SmmCpuFeaturesInstallSmiHandler (
+      CpuIndex,
+      SmBase,
+      SmiStack,
+      StackSize,
+      GdtBase,
+      GdtSize,
+      IdtBase,
+      IdtSize,
+      Cr3
+      );
+    return;
+  }
+
+  //
+  // Initialize values in template before copy
+  //
+  gSmiStack             = (UINT32)((UINTN)SmiStack + StackSize - sizeof (UINTN));
+  gSmiCr3               = Cr3;
+  gSmbase               = SmBase;
+  gSmiHandlerIdtr.Base  = IdtBase;
+  gSmiHandlerIdtr.Limit = (UINT16)(IdtSize - 1);
+
+  //
+  // Set the value at the top of the CPU stack to the CPU Index
+  //
+  *(UINTN*)(UINTN)gSmiStack = CpuIndex;
+
+  //
+  // Copy template to CPU specific SMI handler location
+  //
+  CopyMem (
+    (VOID*)(UINTN)(SmBase + SMM_HANDLER_OFFSET),
+    (VOID*)gcSmiHandlerTemplate,
+    gcSmiHandlerSize
+    );
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SyncTimer.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SyncTimer.c
new file mode 100644
index 000000000000..5a632eaa2487
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SyncTimer.c
@@ -0,0 +1,116 @@
+/** @file
+SMM Timer feature support
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+UINT64   mTimeoutTicker = 0;
+//
+//  Number of counts in a roll-over cycle of the performance counter.
+//
+UINT64   mCycle = 0;
+//
+// Flag to indicate the performance counter is count-up or count-down.
+//
+BOOLEAN  mCountDown;
+
+/**
+  Initialize Timer for SMM AP Sync.
+
+**/
+VOID
+InitializeSmmTimer (
+  VOID
+  )
+{
+  UINT64  TimerFrequency;
+  UINT64  Start;
+  UINT64  End;
+
+  TimerFrequency = GetPerformanceCounterProperties (&Start, &End);
+  mTimeoutTicker = DivU64x32 (
+                     MultU64x64(TimerFrequency, PcdGet64 (PcdCpuSmmApSyncTimeout)),
+                     1000 * 1000
+                     );
+  if (End < Start) {
+    mCountDown = TRUE;
+    mCycle = Start - End;
+  } else {
+    mCountDown = FALSE;
+    mCycle = End - Start;
+  }
+}
+
+/**
+  Start Timer for SMM AP Sync.
+
+**/
+UINT64
+EFIAPI
+StartSyncTimer (
+  VOID
+  )
+{
+  return GetPerformanceCounter ();
+}
+
+
+/**
+  Check if the SMM AP Sync timer is timeout.
+
+  @param Timer  The start timer from the begin.
+
+**/
+BOOLEAN
+EFIAPI
+IsSyncTimerTimeout (
+  IN      UINT64                    Timer
+  )
+{
+  UINT64  CurrentTimer;
+  UINT64  Delta;
+
+  CurrentTimer = GetPerformanceCounter ();
+  //
+  // We need to consider the case that CurrentTimer is equal to Timer
+  // when some timer runs too slow and CPU runs fast. We think roll over
+  // condition does not happen on this case.
+  //
+  if (mCountDown) {
+    //
+    // The performance counter counts down.  Check for roll over condition.
+    //
+    if (CurrentTimer <= Timer) {
+      Delta = Timer - CurrentTimer;
+    } else {
+      //
+      // Handle one roll-over.
+      //
+      Delta = mCycle - (CurrentTimer - Timer) + 1;
+    }
+  } else {
+    //
+    // The performance counter counts up.  Check for roll over condition.
+    //
+    if (CurrentTimer >= Timer) {
+      Delta = CurrentTimer - Timer;
+    } else {
+      //
+      // Handle one roll-over.
+      //
+      Delta = mCycle - (Timer - CurrentTimer) + 1;
+    }
+  }
+
+  return (BOOLEAN) (Delta >= mTimeoutTicker);
+}
diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index 4f7065fca604..e783a7b53616 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -41,11 +41,11 @@
   ##  @libraryclass  Provides platform specific initialization functions in the SEC phase.
   ##
   PlatformSecLib|Include/Library/PlatformSecLib.h
-  
+
   ##  @libraryclass  Public include file for the SMM CPU Platform Hook Library.
   ##
   SmmCpuPlatformHookLib|Include/Library/SmmCpuPlatformHookLib.h
-  
+
   ##  @libraryclass  Provides the CPU specific programming for PiSmmCpuDxeSmm module.
   ##
   SmmCpuFeaturesLib|Include/Library/SmmCpuFeaturesLib.h
@@ -56,23 +56,82 @@
 [Protocols]
   ## Include/Protocol/SmmCpuService.h
   gEfiSmmCpuServiceProtocolGuid  = { 0x1d202cab, 0xc8ab, 0x4d5c, { 0x94, 0xf7, 0x3c, 0xfc, 0xc0, 0xd3, 0xd3, 0x35 }}
-  
+
 #
 # [Error.gUefiCpuPkgTokenSpaceGuid]
 #   0x80000001 | Invalid value provided.
 #
 
+[PcdsFeatureFlag]
+  ## Indicates if SMM Profile will be enabled.
+  #  If enabled, instruction executions in and data accesses to memory outside of SMRAM will be logged.
+  #  This PCD is only for validation purpose. It should be set to false in production.<BR><BR>
+  #   TRUE  - SMM Profile will be enabled.<BR>
+  #   FALSE - SMM Profile will be disabled.<BR>
+  # @Prompt Enable SMM Profile.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileEnable|FALSE|BOOLEAN|0x32132109
+
+  ## Indicates if the SMM profile log buffer is a ring buffer.
+  #  If disabled, no additional log can be done when the buffer is full.<BR><BR>
+  #   TRUE  - the SMM profile log buffer is a ring buffer.<BR>
+  #   FALSE - the SMM profile log buffer is a normal buffer.<BR>
+  # @Prompt The SMM profile log buffer is a ring buffer.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileRingBuffer|FALSE|BOOLEAN|0x3213210a
+
+  ## Indicates if SMM Startup AP in a blocking fashion.
+  #   TRUE  - SMM Startup AP in a blocking fashion.<BR>
+  #   FALSE - SMM Startup AP in a non-blocking fashion.<BR>
+  # @Prompt SMM Startup AP in a blocking fashion.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmBlockStartupThisAp|FALSE|BOOLEAN|0x32132108
+
+  ## Indicates if SMM Stack Guard will be enabled.
+  #  If enabled, stack overflow in SMM can be caught which eases debugging.<BR><BR>
+  #   TRUE  - SMM Stack Guard will be enabled.<BR>
+  #   FALSE - SMM Stack Guard will be disabled.<BR>
+  # @Prompt Enable SMM Stack Guard.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackGuard|FALSE|BOOLEAN|0x1000001C
+
+  ## Indicates if BSP election in SMM will be enabled.
+  #  If enabled, a BSP will be dynamically elected among all processors in each SMI.
+  #  Otherwise, processor 0 is always as BSP in each SMI.<BR><BR>
+  #   TRUE  - BSP election in SMM will be enabled.<BR>
+  #   FALSE - BSP election in SMM will be disabled.<BR>
+  # @Prompt Enable BSP election in SMM.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmEnableBspElection|TRUE|BOOLEAN|0x32132106
+
+  ## Indicates if CPU SMM hot-plug will be enabled.<BR><BR>
+  #   TRUE  - SMM CPU hot-plug will be enabled.<BR>
+  #   FALSE - SMM CPU hot-plug will be disabled.<BR>
+  # @Prompt SMM CPU hot-plug.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugSupport|FALSE|BOOLEAN|0x3213210C
+
+  ## Indicates if SMM Debug will be enabled.
+  #  If enabled, hardware breakpoints in SMRAM can be set outside of SMM mode and take effect in SMM.<BR><BR>
+  #   TRUE  - SMM Debug will be enabled.<BR>
+  #   FALSE - SMM Debug will be disabled.<BR>
+  # @Prompt Enable SMM Debug.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmDebug|FALSE|BOOLEAN|0x1000001B
+
+  ## Indicates if lock SMM Feature Control MSR.<BR><BR>
+  #   TRUE  - SMM Feature Control MSR will be locked.<BR>
+  #   FALSE - SMM Feature Control MSR will not be locked.<BR>
+  # @Prompt Lock SMM Feature Control MSR.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmFeatureControlMsrLock|TRUE|BOOLEAN|0x3213210B
+
 [PcdsFixedAtBuild, PcdsPatchableInModule]
-  ## This value is the CPU Local Apic base address, which aligns the address on a 4-KByte boundary.
-  # @Prompt Configure base address of CPU Local Apic
+  ## This value is the CPU Local APIC base address, which aligns the address on a 4-KByte boundary.
+  # @Prompt Configure base address of CPU Local APIC
   # @Expression  0x80000001 | (gUefiCpuPkgTokenSpaceGuid.PcdCpuLocalApicBaseAddress & 0xfff) == 0
   gUefiCpuPkgTokenSpaceGuid.PcdCpuLocalApicBaseAddress|0xfee00000|UINT32|0x00000001
+
   ## Specifies delay value in microseconds after sending out an INIT IPI.
   # @Prompt Configure delay value after send an INIT IPI
   gUefiCpuPkgTokenSpaceGuid.PcdCpuInitIpiDelayInMicroSeconds|10000|UINT32|0x30000002
+
   ## Specifies max supported number of Logical Processors.
-  # @Prompt Configure max supported number of Logical Processorss
+  # @Prompt Configure max supported number of Logical Processors
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber|64|UINT32|0x00000002
+
   ## This value specifies the Application Processor (AP) stack size, used for Mp Service, which must
   ## aligns the address on a 4-KByte boundary.
   # @Prompt Configure stack size for Application Processor (AP)
@@ -82,6 +141,32 @@
   # @Prompt Stack size in the temporary RAM.
   gUefiCpuPkgTokenSpaceGuid.PcdPeiTemporaryRamStackSize|0|UINT32|0x10001003
 
+  ## Specifies buffer size in bytes to save SMM profile data. The value should be a multiple of 4KB.
+  # @Prompt SMM profile data buffer size.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmProfileSize|0x200000|UINT32|0x32132107
+
+  ## Specifies stack size in bytes for each processor in SMM.
+  # @Prompt Processor stack size in SMM.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmStackSize|0x2000|UINT32|0x32132105
+
+  ## Specifies timeout value in microseconds for the BSP in SMM to wait for all APs to come into SMM.
+  # @Prompt AP synchronization timeout value in SMM.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmApSyncTimeout|1000000|UINT64|0x32132104
+
+  ## Indicates if SMM Code Access Check is enabled.
+  #  If enabled, the SMM handler cannot execute the code outside SMM regions.
+  #  This PCD is suggested to TRUE in production image.<BR><BR>
+  #   TRUE  - SMM Code Access Check will be enabled.<BR>
+  #   FALSE - SMM Code Access Check will be disabled.<BR>
+  # @Prompt SMM Code Access Check.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmCodeAccessCheckEnable|TRUE|BOOLEAN|0x60000013
+
+  ## Indicates the CPU synchronization method used when processing an SMI.
+  #   0x00  - Traditional CPU synchronization method.<BR>
+  #   0x01  - Relaxed CPU synchronization method.<BR>
+  # @Prompt SMM CPU Synchronization Method.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmSyncMode|0x00|UINT8|0x60000014
+
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
   ## Specifies timeout value in microseconds for the BSP to detect all APs for the first time.
   # @Prompt Timeout for the BSP to detect all APs for the first time.
@@ -93,5 +178,16 @@
   # @Prompt Microcode Region size.
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchRegionSize|0x0|UINT64|0x00000006
 
+[PcdsDynamic, PcdsDynamicEx]
+  ## Contains the pointer to a CPU S3 data buffer of structure ACPI_CPU_DATA.
+  # @Prompt The pointer to a CPU S3 data buffer.
+  # @ValidList   0x80000001 | 0
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuS3DataAddress|0x0|UINT64|0x60000010
+
+  ## Contains the pointer to a CPU Hot Plug Data structure if CPU hot-plug is supported.
+  # @Prompt The pointer to CPU Hot Plug Data.
+  # @ValidList   0x80000001 | 0
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuHotPlugDataAddress|0x0|UINT64|0x60000011
+
 [UserExtensions.TianoCore."ExtraFiles"]
   UefiCpuPkgExtra.uni
diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index 4fe2faf981581025adcbbfd9829512e2328c889b..f7ab84c5a246356d85cba9e5c88b15bd7c5e80fe 100644
GIT binary patch
literal 21898
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

delta 34
qcmeBL&A82C0}~6Q!e&O6NXE@!tWOv>o3Y<x+bqN<!L#^)9TNb%j|y)9


From 7e9775fff95d31a046ced3e8111765f52a4cf9fd Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:05:10 +0000
Subject: [PATCH 125/525] UefiCpuPkg: Add PiSmmCpuDxeSmm module IA32 files

Add module that initializes a CPU for the SMM environment and
installs the first level SMI handler.  This module along with the
SMM IPL and SMM Core provide the services required for
DXE_SMM_DRIVERS to register hardware and software SMI handlers.

CPU specific features are abstracted through the SmmCpuFeaturesLib

Platform specific features are abstracted through the
SmmCpuPlatformHookLib

Several PCDs are added to enable/disable features and configure
settings for the PiSmmCpuDxeSmm module

(Sync patch r18646 from main trunk.)

[jeff.fan@intel.com: Fix code style issues reported by ECC]
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18841 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.S      | 165 ++++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.asm    | 168 ++++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c      | 132 +++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/Semaphore.c    |  48 +
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S     | 191 ++++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm   | 193 ++++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S | 911 ++++++++++++++++++
 .../PiSmmCpuDxeSmm/Ia32/SmiException.asm      | 738 ++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.S      |  84 ++
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.asm    |  94 ++
 .../PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c      |  80 ++
 .../PiSmmCpuDxeSmm/Ia32/SmmProfileArch.h      |  97 ++
 12 files changed, 2901 insertions(+)
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/Semaphore.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.h

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.S
new file mode 100644
index 000000000000..75aa312a6e8a
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.S
@@ -0,0 +1,165 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   MpFuncs.S
+#
+# Abstract:
+#
+#   This is the assembly code for Multi-processor S3 support
+#
+#------------------------------------------------------------------------------
+
+.equ                   VacantFlag,       0x0
+.equ                   NotVacantFlag,    0xff
+
+.equ                   LockLocation,     RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+.equ                   StackStart,       RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x04
+.equ                   StackSize,        RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x08
+.equ                   RendezvousProc,   RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x0C
+.equ                   GdtrProfile,      RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x10
+.equ                   IdtrProfile,      RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x16
+.equ                   BufferStart,      RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x1C
+
+#-------------------------------------------------------------------------------------
+#RendezvousFunnelProc  procedure follows. All APs execute their procedure. This
+#procedure serializes all the AP processors through an Init sequence. It must be
+#noted that APs arrive here very raw...ie: real mode, no stack.
+#ALSO THIS PROCEDURE IS EXECUTED BY APs ONLY ON 16 BIT MODE. HENCE THIS PROC
+#IS IN MACHINE CODE.
+#-------------------------------------------------------------------------------------
+#RendezvousFunnelProc (&WakeUpBuffer,MemAddress);
+
+ASM_GLOBAL ASM_PFX(RendezvousFunnelProc)
+ASM_PFX(RendezvousFunnelProc):
+RendezvousFunnelProcStart:
+
+# At this point CS = 0x(vv00) and ip= 0x0.
+
+        .byte 0x8c,0xc8               # mov        ax,  cs
+        .byte 0x8e,0xd8               # mov        ds,  ax
+        .byte 0x8e,0xc0               # mov        es,  ax
+        .byte 0x8e,0xd0               # mov        ss,  ax
+        .byte 0x33,0xc0               # xor        ax,  ax
+        .byte 0x8e,0xe0               # mov        fs,  ax
+        .byte 0x8e,0xe8               # mov        gs,  ax
+
+flat32Start:
+
+        .byte 0xBE
+        .word BufferStart
+        .byte 0x66,0x8B,0x14          # mov        edx,dword ptr [si]          ; EDX is keeping the start address of wakeup buffer
+
+        .byte 0xBE
+        .word GdtrProfile
+        .byte 0x66                    # db         66h
+        .byte 0x2E,0xF,0x1,0x14       # lgdt       fword ptr cs:[si]
+
+        .byte 0xBE
+        .word IdtrProfile
+        .byte 0x66                    # db         66h
+        .byte 0x2E,0xF,0x1,0x1C       # lidt       fword ptr cs:[si]
+
+        .byte 0x33,0xC0               # xor        ax,  ax
+        .byte 0x8E,0xD8               # mov        ds,  ax
+
+        .byte 0xF,0x20,0xC0           # mov        eax, cr0                    ; Get control register 0
+        .byte 0x66,0x83,0xC8,0x1      # or         eax, 000000001h             ; Set PE bit (bit #0)
+        .byte 0xF,0x22,0xC0           # mov        cr0, eax
+
+FLAT32_JUMP:
+
+        .byte 0x66,0x67,0xEA          # far jump
+        .long 0x0                     # 32-bit offset
+        .word 0x20                    # 16-bit selector
+
+PMODE_ENTRY:                          # protected mode entry point
+
+        movw        $0x8,%ax
+        .byte       0x66
+        movw        %ax,%ds
+        .byte       0x66
+        movw        %ax,%es
+        .byte       0x66
+        movw        %ax,%fs
+        .byte       0x66
+        movw        %ax,%gs
+        .byte       0x66
+        movw        %ax,%ss           # Flat mode setup.
+
+        movl        %edx,%esi
+
+        movl        %esi,%edi
+        addl        $LockLocation, %edi
+        movb        $NotVacantFlag, %al
+TestLock:
+        xchgb       (%edi), %al
+        cmpb        $NotVacantFlag, %al
+        jz          TestLock
+
+ProgramStack:
+
+        movl        %esi,%edi
+        addl        $StackSize, %edi
+        movl        (%edi),%eax
+        movl        %esi,%edi
+        addl        $StackStart, %edi
+        addl        (%edi),%eax
+        movl        %eax,%esp
+        movl        %eax,(%edi)
+
+Releaselock:
+
+        movb        $VacantFlag, %al
+        movl        %esi,%edi
+        addl        $LockLocation, %edi
+        xchgb       (%edi), %al
+
+        #
+        # Call assembly function to initialize FPU.
+        #
+        lea         ASM_PFX(InitializeFloatingPointUnits), %ebx
+        call        *%ebx
+        #
+        # Call C Function
+        #
+        movl        %esi,%edi
+        addl        $RendezvousProc, %edi
+        movl        (%edi),%eax
+
+        testl       %eax,%eax
+        jz          GoToSleep
+        call        *%eax                         # Call C function
+
+GoToSleep:
+        cli
+        hlt
+        jmp         GoToSleep
+
+RendezvousFunnelProcEnd:
+#-------------------------------------------------------------------------------------
+#  AsmGetAddressMap (&AddressMap);
+#-------------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(AsmGetAddressMap)
+ASM_PFX(AsmGetAddressMap):
+
+        pushal
+        movl        %esp,%ebp
+
+        movl        0x24(%ebp), %ebx
+        movl        $RendezvousFunnelProcStart, (%ebx)
+        movl        $(PMODE_ENTRY - RendezvousFunnelProcStart), 0x4(%ebx)
+        movl        $(FLAT32_JUMP - RendezvousFunnelProcStart), 0x8(%ebx)
+        movl        $(RendezvousFunnelProcEnd - RendezvousFunnelProcStart), 0x0c(%ebx)
+
+        popal
+        ret
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.asm
new file mode 100644
index 000000000000..70e24a827048
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/MpFuncs.asm
@@ -0,0 +1,168 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   MpFuncs.asm
+;
+; Abstract:
+;
+;   This is the assembly code for Multi-processor S3 support
+;
+;-------------------------------------------------------------------------------
+
+.686p
+.model  flat,C
+.code
+
+EXTERN  InitializeFloatingPointUnits:PROC
+
+VacantFlag             Equ   00h
+NotVacantFlag          Equ   0ffh
+
+LockLocation        equ        RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+StackStart          equ        LockLocation + 4h
+StackSize           equ        LockLocation + 8h
+RendezvousProc      equ        LockLocation + 0Ch
+GdtrProfile         equ        LockLocation + 10h
+IdtrProfile         equ        LockLocation + 16h
+BufferStart         equ        LockLocation + 1Ch
+
+;-------------------------------------------------------------------------------------
+;RendezvousFunnelProc  procedure follows. All APs execute their procedure. This
+;procedure serializes all the AP processors through an Init sequence. It must be
+;noted that APs arrive here very raw...ie: real mode, no stack.
+;ALSO THIS PROCEDURE IS EXECUTED BY APs ONLY ON 16 BIT MODE. HENCE THIS PROC
+;IS IN MACHINE CODE.
+;-------------------------------------------------------------------------------------
+;RendezvousFunnelProc (&WakeUpBuffer,MemAddress);
+
+RendezvousFunnelProc   PROC  near C  PUBLIC
+RendezvousFunnelProcStart::
+
+; At this point CS = 0x(vv00) and ip= 0x0.
+
+        db 8ch,  0c8h                 ; mov        ax,  cs
+        db 8eh,  0d8h                 ; mov        ds,  ax
+        db 8eh,  0c0h                 ; mov        es,  ax
+        db 8eh,  0d0h                 ; mov        ss,  ax
+        db 33h,  0c0h                 ; xor        ax,  ax
+        db 8eh,  0e0h                 ; mov        fs,  ax
+        db 8eh,  0e8h                 ; mov        gs,  ax
+
+flat32Start::
+
+        db 0BEh
+        dw BufferStart                ; mov        si, BufferStart
+        db 66h,  8Bh, 14h             ; mov        edx,dword ptr [si]          ; EDX is keeping the start address of wakeup buffer
+
+        db 0BEh
+        dw GdtrProfile                ; mov        si, GdtrProfile
+        db 66h                        ; db         66h
+        db 2Eh,  0Fh, 01h, 14h        ; lgdt       fword ptr cs:[si]
+
+        db 0BEh
+        dw IdtrProfile                ; mov        si, IdtrProfile
+        db 66h                        ; db         66h
+        db 2Eh,  0Fh, 01h, 1Ch        ; lidt       fword ptr cs:[si]
+
+        db 33h,  0C0h                 ; xor        ax,  ax
+        db 8Eh,  0D8h                 ; mov        ds,  ax
+
+        db 0Fh,  20h, 0C0h            ; mov        eax, cr0                    ; Get control register 0
+        db 66h,  83h, 0C8h, 01h       ; or         eax, 000000001h             ; Set PE bit (bit #0)
+        db 0Fh,  22h, 0C0h            ; mov        cr0, eax
+
+FLAT32_JUMP::
+
+        db 66h,  67h, 0EAh            ; far jump
+        dd 0h                         ; 32-bit offset
+        dw 20h                        ; 16-bit selector
+
+PMODE_ENTRY::                         ; protected mode entry point
+
+        mov         ax,  8h
+        mov         ds,  ax
+        mov         es,  ax
+        mov         fs,  ax
+        mov         gs,  ax
+        mov         ss,  ax           ; Flat mode setup.
+
+        mov         esi, edx
+
+        mov         edi, esi
+        add         edi, LockLocation
+        mov         al,  NotVacantFlag
+TestLock::
+        xchg        byte ptr [edi], al
+        cmp         al, NotVacantFlag
+        jz          TestLock
+
+ProgramStack::
+
+        mov         edi, esi
+        add         edi, StackSize
+        mov         eax, dword ptr [edi]
+        mov         edi, esi
+        add         edi, StackStart
+        add         eax, dword ptr [edi]
+        mov         esp, eax
+        mov         dword ptr [edi], eax
+
+Releaselock::
+
+        mov         al,  VacantFlag
+        mov         edi, esi
+        add         edi, LockLocation
+        xchg        byte ptr [edi], al
+
+        ;
+        ; Call assembly function to initialize FPU.
+        ;
+        mov         ebx, InitializeFloatingPointUnits
+        call        ebx
+        ;
+        ; Call C Function
+        ;
+        mov         edi, esi
+        add         edi, RendezvousProc
+        mov         eax, dword ptr [edi]
+
+        test        eax, eax
+        jz          GoToSleep
+        call        eax                           ; Call C function
+
+GoToSleep::
+        cli
+        hlt
+        jmp         $-2
+
+RendezvousFunnelProc   ENDP
+RendezvousFunnelProcEnd::
+;-------------------------------------------------------------------------------------
+;  AsmGetAddressMap (&AddressMap);
+;-------------------------------------------------------------------------------------
+AsmGetAddressMap   PROC  near C  PUBLIC
+
+        pushad
+        mov         ebp,esp
+
+        mov         ebx, dword ptr [ebp+24h]
+        mov         dword ptr [ebx], RendezvousFunnelProcStart
+        mov         dword ptr [ebx+4h], PMODE_ENTRY - RendezvousFunnelProcStart
+        mov         dword ptr [ebx+8h], FLAT32_JUMP - RendezvousFunnelProcStart
+        mov         dword ptr [ebx+0ch], RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+
+        popad
+        ret
+
+AsmGetAddressMap   ENDP
+
+END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
new file mode 100644
index 000000000000..edebaabb47bd
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
@@ -0,0 +1,132 @@
+/** @file
+Page table manipulation functions for IA-32 processors
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+SPIN_LOCK                           mPFLock;
+
+/**
+  Create PageTable for SMM use.
+
+  @return     PageTable Address
+
+**/
+UINT32
+SmmInitPageTable (
+  VOID
+  )
+{
+  UINTN                             PageFaultHandlerHookAddress;
+  IA32_IDT_GATE_DESCRIPTOR          *IdtEntry;
+
+  //
+  // Initialize spin lock
+  //
+  InitializeSpinLock (&mPFLock);
+
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    //
+    // Set own Page Fault entry instead of the default one, because SMM Profile
+    // feature depends on IRET instruction to do Single Step
+    //
+    PageFaultHandlerHookAddress = (UINTN)PageFaultIdtHandlerSmmProfile;
+    IdtEntry  = (IA32_IDT_GATE_DESCRIPTOR *) gcSmiIdtr.Base;
+    IdtEntry += EXCEPT_IA32_PAGE_FAULT;
+    IdtEntry->Bits.OffsetLow      = (UINT16)PageFaultHandlerHookAddress;
+    IdtEntry->Bits.Reserved_0     = 0;
+    IdtEntry->Bits.GateType       = IA32_IDT_GATE_TYPE_INTERRUPT_32;
+    IdtEntry->Bits.OffsetHigh     = (UINT16)(PageFaultHandlerHookAddress >> 16);
+  } else {
+    //
+    // Register SMM Page Fault Handler
+    //
+    SmmRegisterExceptionHandler (&mSmmCpuService, EXCEPT_IA32_PAGE_FAULT, SmiPFHandler);
+  }
+
+  //
+  // Additional SMM IDT initialization for SMM stack guard
+  //
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    InitializeIDTSmmStackGuard ();
+  }
+  return Gen4GPageTable (0);
+}
+
+/**
+  Page Fault handler for SMM use.
+
+**/
+VOID
+SmiDefaultPFHandler (
+  VOID
+  )
+{
+  CpuDeadLoop ();
+}
+
+/**
+  ThePage Fault handler wrapper for SMM use.
+
+  @param  InterruptType    Defines the type of interrupt or exception that
+                           occurred on the processor.This parameter is processor architecture specific.
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+**/
+VOID
+EFIAPI
+SmiPFHandler (
+    IN EFI_EXCEPTION_TYPE   InterruptType,
+    IN EFI_SYSTEM_CONTEXT   SystemContext
+  )
+{
+  UINTN             PFAddress;
+
+  ASSERT (InterruptType == EXCEPT_IA32_PAGE_FAULT);
+
+  AcquireSpinLock (&mPFLock);
+
+  PFAddress = AsmReadCr2 ();
+
+  if ((FeaturePcdGet (PcdCpuSmmStackGuard)) &&
+      (PFAddress >= mCpuHotPlugData.SmrrBase) &&
+      (PFAddress < (mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize))) {
+    DEBUG ((EFI_D_ERROR, "SMM stack overflow!\n"));
+    CpuDeadLoop ();
+  }
+
+  //
+  // If a page fault occurs in SMM range
+  //
+  if ((PFAddress < mCpuHotPlugData.SmrrBase) ||
+      (PFAddress >= mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize)) {
+    if ((SystemContext.SystemContextIa32->ExceptionData & IA32_PF_EC_ID) != 0) {
+      DEBUG ((EFI_D_ERROR, "Code executed on IP(0x%x) out of SMM range after SMM is locked!\n", PFAddress));
+      DEBUG_CODE (
+        DumpModuleInfoByIp (*(UINTN *)(UINTN)SystemContext.SystemContextIa32->Esp);
+      );
+      CpuDeadLoop ();
+    }
+  }
+
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    SmmProfilePFHandler (
+      SystemContext.SystemContextIa32->Eip,
+      SystemContext.SystemContextIa32->ExceptionData
+      );
+  } else {
+    SmiDefaultPFHandler ();
+  }
+
+  ReleaseSpinLock (&mPFLock);
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/Semaphore.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/Semaphore.c
new file mode 100644
index 000000000000..02a866b43008
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/Semaphore.c
@@ -0,0 +1,48 @@
+/** @file
+Semaphore mechanism to indicate to the BSP that an AP has exited SMM
+after SMBASE relocation.
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+UINTN             mSmmRelocationOriginalAddress;
+volatile BOOLEAN  *mRebasedFlag;
+
+/**
+  Hook return address of SMM Save State so that semaphore code
+  can be executed immediately after AP exits SMM to indicate to
+  the BSP that an AP has exited SMM after SMBASE relocation.
+
+  @param[in] CpuIndex     The processor index.
+  @param[in] RebasedFlag  A pointer to a flag that is set to TRUE
+                          immediately after AP exits SMM.
+
+**/
+VOID
+SemaphoreHook (
+  IN UINTN             CpuIndex,
+  IN volatile BOOLEAN  *RebasedFlag
+  )
+{
+  SMRAM_SAVE_STATE_MAP  *CpuState;
+
+  mRebasedFlag = RebasedFlag;
+
+  CpuState = (SMRAM_SAVE_STATE_MAP *)(UINTN)(SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET);
+  mSmmRelocationOriginalAddress = (UINTN)HookReturnFromSmm (
+                                           CpuIndex,
+                                           CpuState,
+                                           (UINT64)(UINTN)&SmmRelocationSemaphoreComplete,
+                                           (UINT64)(UINTN)&SmmRelocationSemaphoreComplete
+                                           );
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
new file mode 100644
index 000000000000..6fcf41a677d6
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
@@ -0,0 +1,191 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmiEntry.S
+#
+# Abstract:
+#
+#   Code template of the SMI handler for a particular processor
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL  ASM_PFX(gcSmiHandlerTemplate)
+ASM_GLOBAL  ASM_PFX(gcSmiHandlerSize)
+ASM_GLOBAL  ASM_PFX(gSmiCr3)
+ASM_GLOBAL  ASM_PFX(gSmiStack)
+ASM_GLOBAL  ASM_PFX(gSmbase)
+ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
+ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmStackGuard))
+ASM_GLOBAL  ASM_PFX(gSmiHandlerIdtr)
+
+.equ            DSC_OFFSET, 0xfb00
+.equ            DSC_GDTPTR, 0x30
+.equ            DSC_GDTSIZ, 0x38
+.equ            DSC_CS, 14
+.equ            DSC_DS, 16
+.equ            DSC_SS, 18
+.equ            DSC_OTHERSEG, 20
+
+.equ            PROTECT_MODE_CS, 0x08
+.equ            PROTECT_MODE_DS, 0x20
+.equ            TSS_SEGMENT,     0x40
+
+    .text
+
+ASM_PFX(gcSmiHandlerTemplate):
+
+_SmiEntryPoint:
+    .byte 0xbb                          # mov bx, imm16
+    .word _GdtDesc - _SmiEntryPoint + 0x8000
+    .byte 0x2e,0xa1                     # mov ax, cs:[offset16]
+    .word DSC_OFFSET + DSC_GDTSIZ
+    decl    %eax
+    movl    %eax, %cs:(%edi)            # mov cs:[bx], ax
+    .byte 0x66,0x2e,0xa1                # mov eax, cs:[offset16]
+    .word   DSC_OFFSET + DSC_GDTPTR
+    movw    %ax, %cs:2(%edi)
+    movw    %ax, %bp                    # ebp = GDT base
+    .byte 0x66
+    lgdt    %cs:(%edi)
+# Patch ProtectedMode Segment
+    .byte   0xb8                        # mov ax, imm16
+    .word   PROTECT_MODE_CS             # set AX for segment directly
+    movl    %eax, %cs:-2(%edi)          # mov cs:[bx - 2], ax
+# Patch ProtectedMode entry
+    .byte 0x66, 0xbf                    # mov edi, SMBASE
+ASM_PFX(gSmbase): .space 4
+    .byte 0x67
+    lea     ((Start32bit - _SmiEntryPoint) + 0x8000)(%edi), %ax
+    movw     %ax, %cs:-6(%edi)
+    movl    %cr0, %ebx
+    .byte 0x66
+    andl    $0x9ffafff3, %ebx
+    .byte 0x66
+    orl     $0x23, %ebx
+    movl    %ebx, %cr0
+    .byte 0x66,0xea
+    .space  4
+    .space  2
+_GdtDesc:   .space 4
+            .space 2
+
+Start32bit:
+    movw    $PROTECT_MODE_DS, %ax
+    movl    %eax,%ds
+    movl    %eax,%es
+    movl    %eax,%fs
+    movl    %eax,%gs
+    movl    %eax,%ss
+    .byte   0xbc                          # mov esp, imm32
+ASM_PFX(gSmiStack): .space 4
+    movl    $ASM_PFX(gSmiHandlerIdtr), %eax
+    lidt    (%eax)
+    jmp     ProtFlatMode
+
+ProtFlatMode:
+    .byte   0xb8                           # mov eax, imm32
+ASM_PFX(gSmiCr3): .space 4
+    movl    %eax, %cr3
+#
+# Need to test for CR4 specific bit support
+#
+    movl    $1, %eax
+    cpuid                                  # use CPUID to determine if specific CR4 bits are supported
+    xorl    %eax, %eax                     # Clear EAX
+    testl   $BIT2, %edx                    # Check for DE capabilities
+    jz      L8
+    orl     $BIT3, %eax
+L8:
+    testl   $BIT6, %edx                    # Check for PAE capabilities
+    jz      L9
+    orl     $BIT5, %eax
+L9:
+    testl   $BIT7, %edx                    # Check for MCE capabilities
+    jz      L10
+    orl     $BIT6, %eax
+L10:
+    testl   $BIT24, %edx                   # Check for FXSR capabilities
+    jz      L11
+    orl     $BIT9, %eax
+L11:
+    testl   $BIT25, %edx                   # Check for SSE capabilities
+    jz      L12
+    orl     $BIT10, %eax
+L12:                                       # as cr4.PGE is not set here, refresh cr3
+    movl    %eax, %cr4                     # in PreModifyMtrrs() to flush TLB.
+    movl    %cr0, %ebx
+    orl     $0x080000000, %ebx             # enable paging
+    movl    %ebx, %cr0
+    leal    DSC_OFFSET(%edi),%ebx
+    movw    DSC_DS(%ebx),%ax
+    movl    %eax, %ds
+    movw    DSC_OTHERSEG(%ebx),%ax
+    movl    %eax, %es
+    movl    %eax, %fs
+    movl    %eax, %gs
+    movw    DSC_SS(%ebx),%ax
+    movl    %eax, %ss
+
+    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmStackGuard))
+    jz      L5
+
+# Load TSS
+    movb    $0x89, (TSS_SEGMENT + 5)(%ebp) # clear busy flag
+    movl    $TSS_SEGMENT, %eax
+    ltrw    %ax
+L5:
+
+#   jmp     _SmiHandler                 # instruction is not needed
+
+_SmiHandler:
+    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
+    jz      L3
+
+L6:
+    call    L1
+L1:
+    popl    %ebp
+    movl    $0x80000001, %eax
+    cpuid
+    btl     $29, %edx                   # check cpuid to identify X64 or IA32
+    leal    (0x7fc8 - (L1 - _SmiEntryPoint))(%ebp), %edi
+    leal    4(%edi), %esi
+    jnc     L2
+    addl    $4, %esi
+L2:
+    movl    (%esi), %ecx
+    movl    (%edi), %edx
+L7:
+    movl    %ecx, %dr6
+    movl    %edx, %dr7                  # restore DR6 & DR7 before running C code
+L3:
+
+    pushl   (%esp)
+
+    movl    $ASM_PFX(SmiRendezvous), %eax
+    call    *%eax
+    popl    %ecx
+
+
+    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
+    jz      L4
+
+    movl    %dr6, %ecx
+    movl    %dr7, %edx
+    movl    %ecx, (%esi)
+    movl    %edx, (%edi)
+L4:
+
+    rsm
+
+ASM_PFX(gcSmiHandlerSize):    .word      . - _SmiEntryPoint
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
new file mode 100644
index 000000000000..b628fe8bd88c
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
@@ -0,0 +1,193 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmiEntry.asm
+;
+; Abstract:
+;
+;   Code template of the SMI handler for a particular processor
+;
+;-------------------------------------------------------------------------------
+
+    .686p
+    .model  flat,C
+    .xmm
+
+DSC_OFFSET    EQU     0fb00h
+DSC_GDTPTR    EQU     30h
+DSC_GDTSIZ    EQU     38h
+DSC_CS        EQU     14
+DSC_DS        EQU     16
+DSC_SS        EQU     18
+DSC_OTHERSEG  EQU     20
+
+PROTECT_MODE_CS EQU   08h
+PROTECT_MODE_DS EQU   20h
+TSS_SEGMENT     EQU   40h
+
+SmiRendezvous   PROTO   C
+
+EXTERNDEF   gcSmiHandlerTemplate:BYTE
+EXTERNDEF   gcSmiHandlerSize:WORD
+EXTERNDEF   gSmiCr3:DWORD
+EXTERNDEF   gSmiStack:DWORD
+EXTERNDEF   gSmbase:DWORD
+EXTERNDEF   FeaturePcdGet (PcdCpuSmmDebug):BYTE
+EXTERNDEF   FeaturePcdGet (PcdCpuSmmStackGuard):BYTE
+EXTERNDEF   gSmiHandlerIdtr:FWORD
+
+    .code
+
+gcSmiHandlerTemplate    LABEL   BYTE
+
+_SmiEntryPoint:
+    DB      0bbh                        ; mov bx, imm16
+    DW      offset _GdtDesc - _SmiEntryPoint + 8000h
+    DB      2eh, 0a1h                   ; mov ax, cs:[offset16]
+    DW      DSC_OFFSET + DSC_GDTSIZ
+    dec     eax
+    mov     cs:[edi], eax               ; mov cs:[bx], ax
+    DB      66h, 2eh, 0a1h              ; mov eax, cs:[offset16]
+    DW      DSC_OFFSET + DSC_GDTPTR
+    mov     cs:[edi + 2], ax            ; mov cs:[bx + 2], eax
+    mov     bp, ax                      ; ebp = GDT base
+    DB      66h
+    lgdt    fword ptr cs:[edi]          ; lgdt fword ptr cs:[bx]
+; Patch ProtectedMode Segment
+    DB      0b8h                        ; mov ax, imm16
+    DW      PROTECT_MODE_CS             ; set AX for segment directly
+    mov     cs:[edi - 2], eax           ; mov cs:[bx - 2], ax
+; Patch ProtectedMode entry
+    DB      66h, 0bfh                   ; mov edi, SMBASE
+gSmbase    DD    ?
+    DB      67h
+    lea     ax, [edi + (@32bit - _SmiEntryPoint) + 8000h]
+    mov     cs:[edi - 6], ax            ; mov cs:[bx - 6], eax
+    mov     ebx, cr0
+    DB      66h
+    and     ebx, 9ffafff3h
+    DB      66h
+    or      ebx, 23h
+    mov     cr0, ebx
+    DB      66h, 0eah
+    DD      ?
+    DW      ?
+_GdtDesc    FWORD   ?
+
+@32bit:
+    mov     ax, PROTECT_MODE_DS
+    mov     ds, ax
+    mov     es, ax
+    mov     fs, ax
+    mov     gs, ax
+    mov     ss, ax
+    DB      0bch                   ; mov esp, imm32
+gSmiStack   DD      ?
+    mov     eax, offset gSmiHandlerIdtr
+    lidt    fword ptr [eax]
+    jmp     ProtFlatMode
+
+ProtFlatMode:
+    DB      0b8h                        ; mov eax, imm32
+gSmiCr3     DD      ?
+    mov     cr3, eax
+;
+; Need to test for CR4 specific bit support
+;
+    mov     eax, 1
+    cpuid                               ; use CPUID to determine if specific CR4 bits are supported
+    xor     eax, eax                    ; Clear EAX
+    test    edx, BIT2                   ; Check for DE capabilities
+    jz      @f
+    or      eax, BIT3
+@@:
+    test    edx, BIT6                   ; Check for PAE capabilities
+    jz      @f
+    or      eax, BIT5
+@@:
+    test    edx, BIT7                   ; Check for MCE capabilities
+    jz      @f
+    or      eax, BIT6
+@@:
+    test    edx, BIT24                  ; Check for FXSR capabilities
+    jz      @f
+    or      eax, BIT9
+@@:
+    test    edx, BIT25                  ; Check for SSE capabilities
+    jz      @f
+    or      eax, BIT10
+@@:                                     ; as cr4.PGE is not set here, refresh cr3
+    mov     cr4, eax                    ; in PreModifyMtrrs() to flush TLB.
+    mov     ebx, cr0
+    or      ebx, 080000000h             ; enable paging
+    mov     cr0, ebx
+    lea     ebx, [edi + DSC_OFFSET]
+    mov     ax, [ebx + DSC_DS]
+    mov     ds, eax
+    mov     ax, [ebx + DSC_OTHERSEG]
+    mov     es, eax
+    mov     fs, eax
+    mov     gs, eax
+    mov     ax, [ebx + DSC_SS]
+    mov     ss, eax
+
+    cmp     FeaturePcdGet (PcdCpuSmmStackGuard), 0
+    jz      @F
+
+; Load TSS
+    mov     byte ptr [ebp + TSS_SEGMENT + 5], 89h ; clear busy flag
+    mov     eax, TSS_SEGMENT
+    ltr     ax
+@@:
+;   jmp     _SmiHandler                 ; instruction is not needed
+
+_SmiHandler PROC
+    cmp     FeaturePcdGet (PcdCpuSmmDebug), 0
+    jz      @3
+    call    @1
+@1:
+    pop     ebp
+    mov     eax, 80000001h
+    cpuid
+    bt      edx, 29                     ; check cpuid to identify X64 or IA32
+    lea     edi, [ebp - (@1 - _SmiEntryPoint) + 7fc8h]
+    lea     esi, [edi + 4]
+    jnc     @2
+    add     esi, 4
+@2:
+    mov     ecx, [esi]
+    mov     edx, [edi]
+@5:
+    mov     dr6, ecx
+    mov     dr7, edx                    ; restore DR6 & DR7 before running C code
+@3:
+    mov     ecx, [esp]                  ; CPU Index
+
+    push    ecx
+    mov     eax, SmiRendezvous
+    call    eax
+    pop     ecx
+
+    cmp     FeaturePcdGet (PcdCpuSmmDebug), 0
+    jz      @4
+
+    mov     ecx, dr6
+    mov     edx, dr7
+    mov     [esi], ecx
+    mov     [edi], edx
+@4:
+    rsm
+_SmiHandler ENDP
+
+gcSmiHandlerSize    DW      $ - _SmiEntryPoint
+
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
new file mode 100644
index 000000000000..69dfd946de48
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
@@ -0,0 +1,911 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmiException.S
+#
+# Abstract:
+#
+#   Exception handlers used in SM mode
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL  ASM_PFX(SmiPFHandler)
+ASM_GLOBAL  ASM_PFX(PageFaultStubFunction)
+ASM_GLOBAL  ASM_PFX(gSmiMtrrs)
+ASM_GLOBAL  ASM_PFX(gcSmiIdtr)
+ASM_GLOBAL  ASM_PFX(gcSmiGdtr)
+ASM_GLOBAL  ASM_PFX(gcPsd)
+ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmProfileEnable))
+
+    .data
+
+NullSeg:    .quad 0                     # reserved by architecture
+CodeSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+ProtModeCodeSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+ProtModeSsSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x93
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+DataSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x93
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+CodeSeg16:
+            .word -1
+            .word 0
+            .byte 0
+            .byte 0x9b
+            .byte 0x8f
+            .byte 0
+DataSeg16:
+            .word -1
+            .word 0
+            .byte 0
+            .byte 0x93
+            .byte 0x8f
+            .byte 0
+CodeSeg64:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xaf                  # LimitHigh
+            .byte 0                     # BaseHigh
+.equ  GDT_SIZE, .- NullSeg
+
+TssSeg:
+            .word      TSS_DESC_SIZE       # LimitLow
+            .word      0                   # BaseLow
+            .byte      0                   # BaseMid
+            .byte      0x89
+            .byte      0x80                # LimitHigh
+            .byte      0                   # BaseHigh
+ExceptionTssSeg:
+            .word      TSS_DESC_SIZE       # LimitLow
+            .word      0                   # BaseLow
+            .byte      0                   # BaseMid
+            .byte      0x89
+            .byte      0x80                # LimitHigh
+            .byte      0                   # BaseHigh
+
+.equ  CODE_SEL,          CodeSeg32 - NullSeg
+.equ  DATA_SEL,          DataSeg32 - NullSeg
+.equ  TSS_SEL,           TssSeg - NullSeg
+.equ  EXCEPTION_TSS_SEL, ExceptionTssSeg - NullSeg
+
+# IA32 TSS fields
+.equ  TSS_ESP0,          4
+.equ  TSS_SS0,           8
+.equ  TSS_ESP1,          12
+.equ  TSS_SS1,           16
+.equ  TSS_ESP2,          20
+.equ  TSS_SS2,           24
+.equ  TSS_CR3,           28
+.equ  TSS_EIP,           32
+.equ  TSS_EFLAGS,        36
+.equ  TSS_EAX,           40
+.equ  TSS_ECX,           44
+.equ  TSS_EDX,           48
+.equ  TSS_EBX,           52
+.equ  TSS_ESP,           56
+.equ  TSS_EBP,           60
+.equ  TSS_ESI,           64
+.equ  TSS_EDI,           68
+.equ  TSS_ES,            72
+.equ  TSS_CS,            76
+.equ  TSS_SS,            80
+.equ  TSS_DS,            84
+.equ  TSS_FS,            88
+.equ  TSS_GS,            92
+.equ  TSS_LDT,           96
+
+# Create 2 TSS segments just after GDT
+TssDescriptor:
+            .word      0                   # PreviousTaskLink
+            .word      0                   # Reserved
+            .long      0                   # ESP0
+            .word      0                   # SS0
+            .word      0                   # Reserved
+            .long      0                   # ESP1
+            .word      0                   # SS1
+            .word      0                   # Reserved
+            .long      0                   # ESP2
+            .word      0                   # SS2
+            .word      0                   # Reserved
+            .long      0                   # CR3
+            .long      0                   # EIP
+            .long      0                   # EFLAGS
+            .long      0                   # EAX
+            .long      0                   # ECX
+            .long      0                   # EDX
+            .long      0                   # EBX
+            .long      0                   # ESP
+            .long      0                   # EBP
+            .long      0                   # ESI
+            .long      0                   # EDI
+            .word      0                   # ES
+            .word      0                   # Reserved
+            .word      0                   # CS
+            .word      0                   # Reserved
+            .word      0                   # SS
+            .word      0                   # Reserved
+            .word      0                   # DS
+            .word      0                   # Reserved
+            .word      0                   # FS
+            .word      0                   # Reserved
+            .word      0                   # GS
+            .word      0                   # Reserved
+            .word      0                   # LDT Selector
+            .word      0                   # Reserved
+            .word      0                   # T
+            .word      0                   # I/O Map Base
+.equ TSS_DESC_SIZE, . - TssDescriptor
+
+ExceptionTssDescriptor:
+            .word      0                   # PreviousTaskLink
+            .word      0                   # Reserved
+            .long      0                   # ESP0
+            .word      0                   # SS0
+            .word      0                   # Reserved
+            .long      0                   # ESP1
+            .word      0                   # SS1
+            .word      0                   # Reserved
+            .long      0                   # ESP2
+            .word      0                   # SS2
+            .word      0                   # Reserved
+            .long      0                   # CR3
+            .long      PFHandlerEntry      # EIP
+            .long      00000002            # EFLAGS
+            .long      0                   # EAX
+            .long      0                   # ECX
+            .long      0                   # EDX
+            .long      0                   # EBX
+            .long      0                   # ESP
+            .long      0                   # EBP
+            .long      0                   # ESI
+            .long      0                   # EDI
+            .word      DATA_SEL            # ES
+            .word      0                   # Reserved
+            .word      CODE_SEL            # CS
+            .word      0                   # Reserved
+            .word      DATA_SEL            # SS
+            .word      0                   # Reserved
+            .word      DATA_SEL            # DS
+            .word      0                   # Reserved
+            .word      DATA_SEL            # FS
+            .word      0                   # Reserved
+            .word      DATA_SEL            # GS
+            .word      0                   # Reserved
+            .word      0                   # LDT Selector
+            .word      0                   # Reserved
+            .word      0                   # T
+            .word      0                   # I/O Map Base
+
+ASM_PFX(gcPsd):
+            .ascii  "PSDSIG  "
+            .word      PSD_SIZE
+            .word 2
+            .word      1 << 2
+            .word      CODE_SEL
+            .word      DATA_SEL
+            .word      DATA_SEL
+            .word      DATA_SEL
+            .word 0
+            .long 0
+            .long 0
+            .long 0
+            .long 0
+            .quad 0
+            .long      NullSeg
+            .long 0
+            .long      GDT_SIZE
+            .long 0
+            .space 24, 0
+            .long      ASM_PFX(gSmiMtrrs)
+            .long 0
+.equ  PSD_SIZE,  . - ASM_PFX(gcPsd)
+
+ASM_PFX(gcSmiGdtr):  .word      GDT_SIZE - 1
+                     .long      NullSeg
+
+ASM_PFX(gcSmiIdtr):  .word      IDT_SIZE - 1
+                     .long      _SmiIDT
+
+_SmiIDT:
+# The following segment repeats 32 times:
+# No. 1
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 2
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 3
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 4
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 5
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 6
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 7
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 8
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 9
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 10
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 11
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 12
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 13
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 14
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 15
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 16
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 17
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 18
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 19
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 20
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 21
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 22
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 23
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 24
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 25
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 26
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 27
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 28
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 29
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 30
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 31
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+# No. 32
+    .word 0                             # Offset 0:15
+    .word      CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+
+.equ  IDT_SIZE, . - _SmiIDT
+
+TaskGateDescriptor:
+    .word      0                        # Reserved
+    .word      EXCEPTION_TSS_SEL        # TSS Segment selector
+    .byte      0                        # Reserved
+    .byte      0x85                     # Task Gate, present, DPL = 0
+    .word      0                        # Reserved
+
+    .text
+
+#------------------------------------------------------------------------------
+# PageFaultIdtHandlerSmmProfile is the entry point for all exceptions
+#
+# Stack:
+#+---------------------+
+#+    EFlags           +
+#+---------------------+
+#+    CS               +
+#+---------------------+
+#+    EIP              +
+#+---------------------+
+#+    Error Code       +
+#+---------------------+
+#+    Vector Number    +
+#+---------------------+
+#+    EBP              +
+#+---------------------+ <-- EBP
+#
+# RSP set to odd multiple of 8 means ErrCode PRESENT
+#------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(PageFaultIdtHandlerSmmProfile)
+ASM_PFX(PageFaultIdtHandlerSmmProfile):
+    pushl   $0x0e               # Page Fault
+    pushl   %ebp
+    movl    %esp, %ebp
+
+
+    #
+    # Align stack to make sure that EFI_FX_SAVE_STATE_IA32 of EFI_SYSTEM_CONTEXT_IA32
+    # is 16-byte aligned
+    #
+    andl    $0xfffffff0, %esp
+    subl    $12, %esp
+
+## UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    pushl   %eax
+    pushl   %ecx
+    pushl   %edx
+    pushl   %ebx
+    leal    (6*4)(%ebp), %ecx
+    pushl   %ecx                          # ESP
+    pushl   (%ebp)                        # EBP
+    pushl   %esi
+    pushl   %edi
+
+## UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+    movl    %ss, %eax
+    pushl   %eax
+    movzwl  (4*4)(%ebp), %eax
+    pushl   %eax
+    movl    %ds, %eax
+    pushl   %eax
+    movl    %es, %eax
+    pushl   %eax
+    movl    %fs, %eax
+    pushl   %eax
+    movl    %gs, %eax
+    pushl   %eax
+
+## UINT32  Eip;
+    movl    (3*4)(%ebp), %eax
+    pushl   %eax
+
+## UINT32  Gdtr[2], Idtr[2];
+    subl    $8, %esp
+    sidt    (%esp)
+    movl    2(%esp), %eax
+    xchgl   (%esp), %eax
+    andl    $0xffff, %eax
+    movl    %eax, 4(%esp)
+
+    subl    $8, %esp
+    sgdt    (%esp)
+    movl    2(%esp), %eax
+    xchgl   (%esp), %eax
+    andl    $0xffff, %eax
+    movl    %eax, 4(%esp)
+
+## UINT32  Ldtr, Tr;
+    xorl    %eax, %eax
+    strw    %ax
+    pushl   %eax
+    sldtw   %ax
+    pushl   %eax
+
+## UINT32  EFlags;
+    movl    (5*4)(%ebp), %eax
+    pushl   %eax
+
+## UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    movl    %cr4, %eax
+    orl     $0x208, %eax
+    movl    %eax, %cr4
+    pushl   %eax
+    movl    %cr3, %eax
+    pushl   %eax
+    movl    %cr2, %eax
+    pushl   %eax
+    xorl    %eax, %eax
+    pushl   %eax
+    movl    %cr0, %eax
+    pushl   %eax
+
+## UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    movl    %dr7, %eax
+    pushl   %eax
+    movl    %dr6, %eax
+    pushl   %eax
+    movl    %dr3, %eax
+    pushl   %eax
+    movl    %dr2, %eax
+    pushl   %eax
+    movl    %dr1, %eax
+    pushl   %eax
+    movl    %dr0, %eax
+    pushl   %eax
+
+## FX_SAVE_STATE_IA32 FxSaveState;
+    subl    $512, %esp
+    movl    %esp, %edi
+    .byte   0x0f, 0xae, 0x07                  #fxsave [edi]
+
+# UEFI calling convention for IA32 requires that Direction flag in EFLAGs is clear
+    cld
+
+## UINT32  ExceptionData;
+    pushl   (2*4)(%ebp)
+
+## call into exception handler
+
+## Prepare parameter and call
+    movl    %esp, %edx
+    pushl   %edx
+    movl    (1*4)(%ebp), %edx
+    pushl   %edx
+
+    #
+    # Call External Exception Handler
+    #
+    movl    $ASM_PFX(SmiPFHandler), %eax
+    call    *%eax
+    addl    $8, %esp
+    jmp     L4
+
+L4:
+## UINT32  ExceptionData;
+    addl    $4, %esp
+
+## FX_SAVE_STATE_IA32 FxSaveState;
+    movl    %esp, %esi
+    .byte   0xf, 0xae, 0xe                 # fxrstor [esi]
+    addl    $512, %esp
+
+## UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+## Skip restoration of DRx registers to support debuggers
+## that set breakpoints in interrupt/exception context
+    addl    $4*6, %esp
+
+## UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    popl    %eax
+    movl    %eax, %cr0
+    addl    $4, %esp                       # not for Cr1
+    popl    %eax
+    movl    %eax, %cr2
+    popl    %eax
+    movl    %eax, %cr3
+    popl    %eax
+    movl    %eax, %cr4
+
+## UINT32  EFlags;
+    popl    (5*4)(%ebp)
+
+## UINT32  Ldtr, Tr;
+## UINT32  Gdtr[2], Idtr[2];
+## Best not let anyone mess with these particular registers...
+    addl    $24, %esp
+
+## UINT32  Eip;
+    popl    (3*4)(%ebp)
+
+## UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+## NOTE - modified segment registers could hang the debugger...  We
+##        could attempt to insulate ourselves against this possibility,
+##        but that poses risks as well.
+##
+    popl    %gs
+    popl    %fs
+    popl    %es
+    popl    %ds
+    popl    (4*4)(%ebp)
+    popl    %ss
+
+## UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    popl    %edi
+    popl    %esi
+    addl    $4, %esp                      # not for ebp
+    addl    $4, %esp                      # not for esp
+    popl    %ebx
+    popl    %edx
+    popl    %ecx
+    popl    %eax
+
+    movl    %ebp, %esp
+    popl    %ebp
+
+# Enable TF bit after page fault handler runs
+    btsl    $8, 16(%esp)                  # EFLAGS
+
+    addl    $8, %esp                      # skip INT# & ErrCode
+Return:
+    iret
+#
+# Page Fault Exception Handler entry when SMM Stack Guard is enabled
+# Executiot starts here after a task switch
+#
+PFHandlerEntry:
+#
+# Get this processor's TSS
+#
+    subl    $8, %esp
+    sgdt    2(%esp)
+    movl    4(%esp), %eax                 # GDT base
+    addl    $8, %esp
+    movl    (TSS_SEL+2)(%eax), %ecx
+    shll    $8, %ecx
+    movb    (TSS_SEL+7)(%eax), %cl
+    rorl    $8, %ecx                      # ecx = TSS base
+
+    movl    %esp, %ebp
+
+    #
+    # Align stack to make sure that EFI_FX_SAVE_STATE_IA32 of EFI_SYSTEM_CONTEXT_IA32
+    # is 16-byte aligned
+    #
+    andl    $0xfffffff0, %esp
+    subl    $12, %esp
+
+## UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    pushl   TSS_EAX(%ecx)
+    pushl   TSS_ECX(%ecx)
+    pushl   TSS_EDX(%ecx)
+    pushl   TSS_EBX(%ecx)
+    pushl   TSS_ESP(%ecx)
+    pushl   TSS_EBP(%ecx)
+    pushl   TSS_ESI(%ecx)
+    pushl   TSS_EDI(%ecx)
+
+## UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+    movzwl  TSS_SS(%ecx), %eax
+    pushl   %eax
+    movzwl  TSS_CS(%ecx), %eax
+    pushl   %eax
+    movzwl  TSS_DS(%ecx), %eax
+    pushl   %eax
+    movzwl  TSS_ES(%ecx), %eax
+    pushl   %eax
+    movzwl  TSS_FS(%ecx), %eax
+    pushl   %eax
+    movzwl  TSS_GS(%ecx), %eax
+    pushl   %eax
+
+## UINT32  Eip;
+    pushl   TSS_EIP(%ecx)
+
+## UINT32  Gdtr[2], Idtr[2];
+    subl    $8, %esp
+    sidt    (%esp)
+    movl    2(%esp), %eax
+    xchgl   (%esp), %eax
+    andl    $0xFFFF, %eax
+    movl    %eax, 4(%esp)
+
+    subl    $8, %esp
+    sgdt    (%esp)
+    movl    2(%esp), %eax
+    xchgl   (%esp), %eax
+    andl    $0xFFFF, %eax
+    movl    %eax, 4(%esp)
+
+## UINT32  Ldtr, Tr;
+    movl    $TSS_SEL, %eax
+    pushl   %eax
+    movzwl  TSS_LDT(%ecx), %eax
+    pushl   %eax
+
+## UINT32  EFlags;
+    pushl   TSS_EFLAGS(%ecx)
+
+## UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    movl    %cr4, %eax
+    orl     $0x208, %eax
+    movl    %eax, %cr4
+    pushl   %eax
+    movl    %cr3, %eax
+    pushl   %eax
+    movl    %cr2, %eax
+    pushl   %eax
+    xorl    %eax, %eax
+    pushl   %eax
+    movl    %cr0, %eax
+    pushl   %eax
+
+## UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    movl    %dr7, %eax
+    pushl   %eax
+    movl    %dr6, %eax
+    pushl   %eax
+    movl    %dr3, %eax
+    pushl   %eax
+    movl    %dr2, %eax
+    pushl   %eax
+    movl    %dr1, %eax
+    pushl   %eax
+    movl    %dr0, %eax
+    pushl   %eax
+
+## FX_SAVE_STATE_IA32 FxSaveState;
+## Clear TS bit in CR0 to avoid Device Not Available Exception (#NM)
+## when executing fxsave/fxrstor instruction
+    clts
+    subl    $512, %esp
+    movl    %esp, %edi
+    .byte   0x0f, 0xae, 0x07                   #fxsave [edi]
+
+# UEFI calling convention for IA32 requires that Direction flag in EFLAGs is clear
+    cld
+
+## UINT32  ExceptionData;
+    pushl   (%ebp)
+
+## call into exception handler
+    movl    %ecx, %ebx
+    movl    $ASM_PFX(SmiPFHandler), %eax
+
+## Prepare parameter and call
+    movl    %esp, %edx
+    pushl   %edx
+    movl    $14, %edx
+    pushl   %edx
+
+    #
+    # Call External Exception Handler
+    #
+    call    *%eax
+    addl    $8, %esp
+
+    movl    %ebx, %ecx
+## UINT32  ExceptionData;
+    addl    $4, %esp
+
+## FX_SAVE_STATE_IA32 FxSaveState;
+    movl    %esp, %esi
+    .byte   0xf, 0xae, 0xe                     # fxrstor [esi]
+    addl    $512, %esp
+
+## UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+## Skip restoration of DRx registers to support debuggers
+## that set breakpoints in interrupt/exception context
+    addl    $4*6, %esp
+
+## UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    popl    %eax
+    movl    %eax, %cr0
+    addl    $4, %esp                           # not for Cr1
+    popl    %eax
+    movl    %eax, %cr2
+    popl    %eax
+    movl    %eax, TSS_CR3(%ecx)
+    popl    %eax
+    movl    %eax, %cr4
+
+## UINT32  EFlags;
+    popl    TSS_EFLAGS(%ecx)
+
+## UINT32  Ldtr, Tr;
+## UINT32  Gdtr[2], Idtr[2];
+## Best not let anyone mess with these particular registers...
+    addl    $24, %esp
+
+## UINT32  Eip;
+    popl    TSS_EIP(%ecx)
+
+## UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+## NOTE - modified segment registers could hang the debugger...  We
+##        could attempt to insulate ourselves against this possibility,
+##        but that poses risks as well.
+##
+    popl    %eax
+    movw    %ax, TSS_GS(%ecx)
+    popl    %eax
+    movw    %ax, TSS_FS(%ecx)
+    popl    %eax
+    movw    %ax, TSS_ES(%ecx)
+    popl    %eax
+    movw    %ax, TSS_DS(%ecx)
+    popl    %eax
+    movw    %ax, TSS_CS(%ecx)
+    popl    %eax
+    movw    %ax, TSS_SS(%ecx)
+
+## UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    popl    TSS_EDI(%ecx)
+    popl    TSS_ESI(%ecx)
+    addl    $4, %esp                           # not for ebp
+    addl    $4, %esp                           # not for esp
+    popl    TSS_EBX(%ecx)
+    popl    TSS_EDX(%ecx)
+    popl    TSS_ECX(%ecx)
+    popl    TSS_EAX(%ecx)
+
+    movl    %ebp, %esp
+
+# Set single step DB# if SMM profile is enabled and page fault exception happens
+    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmProfileEnable))
+    jz      Done2
+# Create return context for iret in stub function
+     movl   TSS_ESP(%ecx), %eax                   # Get old stack pointer
+     movl   TSS_EIP(%ecx), %ebx
+     movl   %ebx, -0xc(%eax)                      # create EIP in old stack
+     movzwl TSS_CS(%ecx), %ebx
+     movl   %ebx, -0x8(%eax)                      # create CS in old stack
+     movl   TSS_EFLAGS(%ecx), %ebx
+     btsl   $8,%ebx
+     movl   %ebx, -0x4(%eax)                      # create eflags in old stack
+     movl   TSS_ESP(%ecx), %eax                   # Get old stack pointer
+     subl   $12, %eax                             # minus 12 byte
+     movl   %eax, TSS_ESP(%ecx)                   # Set new stack pointer
+
+# Replace the EIP of interrupted task with stub function
+    movl    $ASM_PFX(PageFaultStubFunction), %eax
+    movl   %eax, TSS_EIP(%ecx)
+# Jump to the iret so next page fault handler as a task will start again after iret.
+
+Done2:
+
+    addl    $4, %esp                            # skip ErrCode
+
+    jmp     Return
+
+ASM_PFX(PageFaultStubFunction):
+#
+# we need clean TS bit in CR0 to execute
+# x87 FPU/MMX/SSE/SSE2/SSE3/SSSE3/SSE4 instructions.
+#
+    clts
+    iret
+
+ASM_GLOBAL ASM_PFX(InitializeIDTSmmStackGuard)
+ASM_PFX(InitializeIDTSmmStackGuard):
+    pushl   %ebx
+#
+# If SMM Stack Guard feature is enabled, the Page Fault Exception entry in IDT
+# is a Task Gate Descriptor so that when a Page Fault Exception occurs,
+# the processors can use a known good stack in case stack ran out.
+#
+    leal    _SmiIDT + 14 * 8, %ebx
+    leal    TaskGateDescriptor, %edx
+    movl    (%edx), %eax
+    movl    %eax, (%ebx)
+    movl    4(%edx), %eax
+    movl    %eax, 4(%ebx)
+
+    popl    %ebx
+    ret
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
new file mode 100644
index 000000000000..65a120e1e78a
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
@@ -0,0 +1,738 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmiException.asm
+;
+; Abstract:
+;
+;   Exception handlers used in SM mode
+;
+;-------------------------------------------------------------------------------
+
+    .686p
+    .model  flat,C
+
+EXTERNDEF   SmiPFHandler:PROC
+EXTERNDEF   PageFaultStubFunction:PROC
+EXTERNDEF   gSmiMtrrs:QWORD
+EXTERNDEF   gcSmiIdtr:FWORD
+EXTERNDEF   gcSmiGdtr:FWORD
+EXTERNDEF   gcPsd:BYTE
+EXTERNDEF   FeaturePcdGet (PcdCpuSmmProfileEnable):BYTE
+
+
+    .data
+
+NullSeg     DQ      0                   ; reserved by architecture
+CodeSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+ProtModeCodeSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+ProtModeSsSeg32     LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      93h
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+DataSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      93h
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+CodeSeg16   LABEL   QWORD
+            DW      -1
+            DW      0
+            DB      0
+            DB      9bh
+            DB      8fh
+            DB      0
+DataSeg16   LABEL   QWORD
+            DW      -1
+            DW      0
+            DB      0
+            DB      93h
+            DB      8fh
+            DB      0
+CodeSeg64   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0afh                ; LimitHigh
+            DB      0                   ; BaseHigh
+GDT_SIZE = $ - offset NullSeg
+
+TssSeg      LABEL   QWORD
+            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      89h
+            DB      080h                ; LimitHigh
+            DB      0                   ; BaseHigh
+ExceptionTssSeg     LABEL   QWORD
+            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      89h
+            DB      080h                ; LimitHigh
+            DB      0                   ; BaseHigh
+
+CODE_SEL          = offset CodeSeg32 - offset NullSeg
+DATA_SEL          = offset DataSeg32 - offset NullSeg
+TSS_SEL           = offset TssSeg - offset NullSeg
+EXCEPTION_TSS_SEL = offset ExceptionTssSeg - offset NullSeg
+
+IA32_TSS STRUC
+                    DW ?
+                    DW ?
+  ESP0              DD ?
+  SS0               DW ?
+                    DW ?
+  ESP1              DD ?
+  SS1               DW ?
+                    DW ?
+  ESP2              DD ?
+  SS2               DW ?
+                    DW ?
+  _CR3              DD ?
+  EIP               DD ?
+  EFLAGS            DD ?
+  _EAX              DD ?
+  _ECX              DD ?
+  _EDX              DD ?
+  _EBX              DD ?
+  _ESP              DD ?
+  _EBP              DD ?
+  _ESI              DD ?
+  _EDI              DD ?
+  _ES               DW ?
+                    DW ?
+  _CS               DW ?
+                    DW ?
+  _SS               DW ?
+                    DW ?
+  _DS               DW ?
+                    DW ?
+  _FS               DW ?
+                    DW ?
+  _GS               DW ?
+                    DW ?
+  LDT               DW ?
+                    DW ?
+                    DW ?
+                    DW ?
+IA32_TSS ENDS
+
+; Create 2 TSS segments just after GDT
+TssDescriptor LABEL BYTE
+            DW      0                   ; PreviousTaskLink
+            DW      0                   ; Reserved
+            DD      0                   ; ESP0
+            DW      0                   ; SS0
+            DW      0                   ; Reserved
+            DD      0                   ; ESP1
+            DW      0                   ; SS1
+            DW      0                   ; Reserved
+            DD      0                   ; ESP2
+            DW      0                   ; SS2
+            DW      0                   ; Reserved
+            DD      0                   ; CR3
+            DD      0                   ; EIP
+            DD      0                   ; EFLAGS
+            DD      0                   ; EAX
+            DD      0                   ; ECX
+            DD      0                   ; EDX
+            DD      0                   ; EBX
+            DD      0                   ; ESP
+            DD      0                   ; EBP
+            DD      0                   ; ESI
+            DD      0                   ; EDI
+            DW      0                   ; ES
+            DW      0                   ; Reserved
+            DW      0                   ; CS
+            DW      0                   ; Reserved
+            DW      0                   ; SS
+            DW      0                   ; Reserved
+            DW      0                   ; DS
+            DW      0                   ; Reserved
+            DW      0                   ; FS
+            DW      0                   ; Reserved
+            DW      0                   ; GS
+            DW      0                   ; Reserved
+            DW      0                   ; LDT Selector
+            DW      0                   ; Reserved
+            DW      0                   ; T
+            DW      0                   ; I/O Map Base
+TSS_DESC_SIZE = $ - offset TssDescriptor
+
+ExceptionTssDescriptor LABEL BYTE
+            DW      0                   ; PreviousTaskLink
+            DW      0                   ; Reserved
+            DD      0                   ; ESP0
+            DW      0                   ; SS0
+            DW      0                   ; Reserved
+            DD      0                   ; ESP1
+            DW      0                   ; SS1
+            DW      0                   ; Reserved
+            DD      0                   ; ESP2
+            DW      0                   ; SS2
+            DW      0                   ; Reserved
+            DD      0                   ; CR3
+            DD      offset PFHandlerEntry ; EIP
+            DD      00000002            ; EFLAGS
+            DD      0                   ; EAX
+            DD      0                   ; ECX
+            DD      0                   ; EDX
+            DD      0                   ; EBX
+            DD      0                   ; ESP
+            DD      0                   ; EBP
+            DD      0                   ; ESI
+            DD      0                   ; EDI
+            DW      DATA_SEL            ; ES
+            DW      0                   ; Reserved
+            DW      CODE_SEL            ; CS
+            DW      0                   ; Reserved
+            DW      DATA_SEL            ; SS
+            DW      0                   ; Reserved
+            DW      DATA_SEL            ; DS
+            DW      0                   ; Reserved
+            DW      DATA_SEL            ; FS
+            DW      0                   ; Reserved
+            DW      DATA_SEL            ; GS
+            DW      0                   ; Reserved
+            DW      0                   ; LDT Selector
+            DW      0                   ; Reserved
+            DW      0                   ; T
+            DW      0                   ; I/O Map Base
+
+gcPsd     LABEL   BYTE
+            DB      'PSDSIG  '
+            DW      PSD_SIZE
+            DW      2
+            DW      1 SHL 2
+            DW      CODE_SEL
+            DW      DATA_SEL
+            DW      DATA_SEL
+            DW      DATA_SEL
+            DW      0
+            DQ      0
+            DQ      0
+            DQ      0
+            DQ      offset NullSeg
+            DD      GDT_SIZE
+            DD      0
+            DB      24 dup (0)
+            DQ      offset gSmiMtrrs
+PSD_SIZE  = $ - offset gcPsd
+
+gcSmiGdtr   LABEL   FWORD
+    DW      GDT_SIZE - 1
+    DD      offset NullSeg
+
+gcSmiIdtr   LABEL   FWORD
+    DW      IDT_SIZE - 1
+    DD      offset _SmiIDT
+
+_SmiIDT     LABEL   QWORD
+REPEAT      32
+    DW      0                           ; Offset 0:15
+    DW      CODE_SEL                    ; Segment selector
+    DB      0                           ; Unused
+    DB      8eh                         ; Interrupt Gate, Present
+    DW      0                           ; Offset 16:31
+            ENDM
+IDT_SIZE = $ - offset _SmiIDT
+
+TaskGateDescriptor LABEL DWORD
+    DW      0                           ; Reserved
+    DW      EXCEPTION_TSS_SEL           ; TSS Segment selector
+    DB      0                           ; Reserved
+    DB      85h                         ; Task Gate, present, DPL = 0
+    DW      0                           ; Reserved
+
+
+    .code
+;------------------------------------------------------------------------------
+; PageFaultIdtHandlerSmmProfile is the entry point page fault only
+;
+;
+; Stack:
+; +---------------------+
+; +    EFlags           +
+; +---------------------+
+; +    CS               +
+; +---------------------+
+; +    EIP              +
+; +---------------------+
+; +    Error Code       +
+; +---------------------+
+; +    Vector Number    +
+; +---------------------+
+; +    EBP              +
+; +---------------------+ <-- EBP
+;
+;
+;------------------------------------------------------------------------------
+PageFaultIdtHandlerSmmProfile PROC
+    push    0eh                         ; Page Fault
+
+    push    ebp
+    mov     ebp, esp
+
+
+    ;
+    ; Align stack to make sure that EFI_FX_SAVE_STATE_IA32 of EFI_SYSTEM_CONTEXT_IA32
+    ; is 16-byte aligned
+    ;
+    and     esp, 0fffffff0h
+    sub     esp, 12
+
+;; UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    push    eax
+    push    ecx
+    push    edx
+    push    ebx
+    lea     ecx, [ebp + 6 * 4]
+    push    ecx                          ; ESP
+    push    dword ptr [ebp]              ; EBP
+    push    esi
+    push    edi
+
+;; UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+    mov     eax, ss
+    push    eax
+    movzx   eax, word ptr [ebp + 4 * 4]
+    push    eax
+    mov     eax, ds
+    push    eax
+    mov     eax, es
+    push    eax
+    mov     eax, fs
+    push    eax
+    mov     eax, gs
+    push    eax
+
+;; UINT32  Eip;
+    mov     eax, [ebp + 3 * 4]
+    push    eax
+
+;; UINT32  Gdtr[2], Idtr[2];
+    sub     esp, 8
+    sidt    [esp]
+    mov     eax, [esp + 2]
+    xchg    eax, [esp]
+    and     eax, 0FFFFh
+    mov     [esp+4], eax
+
+    sub     esp, 8
+    sgdt    [esp]
+    mov     eax, [esp + 2]
+    xchg    eax, [esp]
+    and     eax, 0FFFFh
+    mov     [esp+4], eax
+
+;; UINT32  Ldtr, Tr;
+    xor     eax, eax
+    str     ax
+    push    eax
+    sldt    ax
+    push    eax
+
+;; UINT32  EFlags;
+    mov     eax, [ebp + 5 * 4]
+    push    eax
+
+;; UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    mov     eax, cr4
+    or      eax, 208h
+    mov     cr4, eax
+    push    eax
+    mov     eax, cr3
+    push    eax
+    mov     eax, cr2
+    push    eax
+    xor     eax, eax
+    push    eax
+    mov     eax, cr0
+    push    eax
+
+;; UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    mov     eax, dr7
+    push    eax
+    mov     eax, dr6
+    push    eax
+    mov     eax, dr3
+    push    eax
+    mov     eax, dr2
+    push    eax
+    mov     eax, dr1
+    push    eax
+    mov     eax, dr0
+    push    eax
+
+;; FX_SAVE_STATE_IA32 FxSaveState;
+    sub     esp, 512
+    mov     edi, esp
+    db      0fh, 0aeh, 07h ;fxsave [edi]
+
+; UEFI calling convention for IA32 requires that Direction flag in EFLAGs is clear
+    cld
+
+;; UINT32  ExceptionData;
+    push    dword ptr [ebp + 2 * 4]
+
+;; call into exception handler
+
+;; Prepare parameter and call
+    mov     edx, esp
+    push    edx
+    mov     edx, dword ptr [ebp + 1 * 4]
+    push    edx
+
+    ;
+    ; Call External Exception Handler
+    ;
+    mov     eax, SmiPFHandler
+    call    eax
+    add     esp, 8
+
+;; UINT32  ExceptionData;
+    add     esp, 4
+
+;; FX_SAVE_STATE_IA32 FxSaveState;
+    mov     esi, esp
+    db      0fh, 0aeh, 0eh ; fxrstor [esi]
+    add     esp, 512
+
+;; UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+;; Skip restoration of DRx registers to support debuggers
+;; that set breakpoint in interrupt/exception context
+    add     esp, 4 * 6
+
+;; UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    pop     eax
+    mov     cr0, eax
+    add     esp, 4    ; not for Cr1
+    pop     eax
+    mov     cr2, eax
+    pop     eax
+    mov     cr3, eax
+    pop     eax
+    mov     cr4, eax
+
+;; UINT32  EFlags;
+    pop     dword ptr [ebp + 5 * 4]
+
+;; UINT32  Ldtr, Tr;
+;; UINT32  Gdtr[2], Idtr[2];
+;; Best not let anyone mess with these particular registers...
+    add     esp, 24
+
+;; UINT32  Eip;
+    pop     dword ptr [ebp + 3 * 4]
+
+;; UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+;; NOTE - modified segment registers could hang the debugger...  We
+;;        could attempt to insulate ourselves against this possibility,
+;;        but that poses risks as well.
+;;
+    pop     gs
+    pop     fs
+    pop     es
+    pop     ds
+    pop     dword ptr [ebp + 4 * 4]
+    pop     ss
+
+;; UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    pop     edi
+    pop     esi
+    add     esp, 4   ; not for ebp
+    add     esp, 4   ; not for esp
+    pop     ebx
+    pop     edx
+    pop     ecx
+    pop     eax
+
+    mov     esp, ebp
+    pop     ebp
+
+; Enable TF bit after page fault handler runs
+    bts     dword ptr [esp + 16], 8  ; EFLAGS
+
+    add     esp, 8                      ; skip INT# & ErrCode
+Return:
+    iretd
+;
+; Page Fault Exception Handler entry when SMM Stack Guard is enabled
+; Executiot starts here after a task switch
+;
+PFHandlerEntry::
+;
+; Get this processor's TSS
+;
+    sub     esp, 8
+    sgdt    [esp + 2]
+    mov     eax, [esp + 4]              ; GDT base
+    add     esp, 8
+    mov     ecx, [eax + TSS_SEL + 2]
+    shl     ecx, 8
+    mov     cl, [eax + TSS_SEL + 7]
+    ror     ecx, 8                      ; ecx = TSS base
+
+    mov     ebp, esp
+
+    ;
+    ; Align stack to make sure that EFI_FX_SAVE_STATE_IA32 of EFI_SYSTEM_CONTEXT_IA32
+    ; is 16-byte aligned
+    ;
+    and     esp, 0fffffff0h
+    sub     esp, 12
+
+;; UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    push    (IA32_TSS ptr [ecx])._EAX
+    push    (IA32_TSS ptr [ecx])._ECX
+    push    (IA32_TSS ptr [ecx])._EDX
+    push    (IA32_TSS ptr [ecx])._EBX
+    push    (IA32_TSS ptr [ecx])._ESP
+    push    (IA32_TSS ptr [ecx])._EBP
+    push    (IA32_TSS ptr [ecx])._ESI
+    push    (IA32_TSS ptr [ecx])._EDI
+
+;; UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+    movzx   eax, (IA32_TSS ptr [ecx])._SS
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx])._CS
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx])._DS
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx])._ES
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx])._FS
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx])._GS
+    push    eax
+
+;; UINT32  Eip;
+    push    (IA32_TSS ptr [ecx]).EIP
+
+;; UINT32  Gdtr[2], Idtr[2];
+    sub     esp, 8
+    sidt    [esp]
+    mov     eax, [esp + 2]
+    xchg    eax, [esp]
+    and     eax, 0FFFFh
+    mov     [esp+4], eax
+
+    sub     esp, 8
+    sgdt    [esp]
+    mov     eax, [esp + 2]
+    xchg    eax, [esp]
+    and     eax, 0FFFFh
+    mov     [esp+4], eax
+
+;; UINT32  Ldtr, Tr;
+    mov     eax, TSS_SEL
+    push    eax
+    movzx   eax, (IA32_TSS ptr [ecx]).LDT
+    push    eax
+
+;; UINT32  EFlags;
+    push    (IA32_TSS ptr [ecx]).EFLAGS
+
+;; UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    mov     eax, cr4
+    or      eax, 208h
+    mov     cr4, eax
+    push    eax
+    mov     eax, cr3
+    push    eax
+    mov     eax, cr2
+    push    eax
+    xor     eax, eax
+    push    eax
+    mov     eax, cr0
+    push    eax
+
+;; UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    mov     eax, dr7
+    push    eax
+    mov     eax, dr6
+    push    eax
+    mov     eax, dr3
+    push    eax
+    mov     eax, dr2
+    push    eax
+    mov     eax, dr1
+    push    eax
+    mov     eax, dr0
+    push    eax
+
+;; FX_SAVE_STATE_IA32 FxSaveState;
+;; Clear TS bit in CR0 to avoid Device Not Available Exception (#NM)
+;; when executing fxsave/fxrstor instruction
+    clts
+    sub     esp, 512
+    mov     edi, esp
+    db      0fh, 0aeh, 07h ;fxsave [edi]
+
+; UEFI calling convention for IA32 requires that Direction flag in EFLAGs is clear
+    cld
+
+;; UINT32  ExceptionData;
+    push    dword ptr [ebp]
+
+;; call into exception handler
+    mov     ebx, ecx
+    mov     eax, SmiPFHandler
+
+;; Prepare parameter and call
+    mov     edx, esp
+    push    edx
+    mov     edx, 14
+    push    edx
+
+    ;
+    ; Call External Exception Handler
+    ;
+    call    eax
+    add     esp, 8
+
+    mov     ecx, ebx
+;; UINT32  ExceptionData;
+    add     esp, 4
+
+;; FX_SAVE_STATE_IA32 FxSaveState;
+    mov     esi, esp
+    db      0fh, 0aeh, 0eh ; fxrstor [esi]
+    add     esp, 512
+
+;; UINT32  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+;; Skip restoration of DRx registers to support debuggers
+;; that set breakpoints in interrupt/exception context
+    add     esp, 4 * 6
+
+;; UINT32  Cr0, Cr1, Cr2, Cr3, Cr4;
+    pop     eax
+    mov     cr0, eax
+    add     esp, 4    ; not for Cr1
+    pop     eax
+    mov     cr2, eax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._CR3, eax
+    pop     eax
+    mov     cr4, eax
+
+;; UINT32  EFlags;
+    pop     (IA32_TSS ptr [ecx]).EFLAGS
+
+;; UINT32  Ldtr, Tr;
+;; UINT32  Gdtr[2], Idtr[2];
+;; Best not let anyone mess with these particular registers...
+    add     esp, 24
+
+;; UINT32  Eip;
+    pop     (IA32_TSS ptr [ecx]).EIP
+
+;; UINT32  Gs, Fs, Es, Ds, Cs, Ss;
+;; NOTE - modified segment registers could hang the debugger...  We
+;;        could attempt to insulate ourselves against this possibility,
+;;        but that poses risks as well.
+;;
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._GS, ax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._FS, ax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._ES, ax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._DS, ax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._CS, ax
+    pop     eax
+    mov     (IA32_TSS ptr [ecx])._SS, ax
+
+;; UINT32  Edi, Esi, Ebp, Esp, Ebx, Edx, Ecx, Eax;
+    pop     (IA32_TSS ptr [ecx])._EDI
+    pop     (IA32_TSS ptr [ecx])._ESI
+    add     esp, 4   ; not for ebp
+    add     esp, 4   ; not for esp
+    pop     (IA32_TSS ptr [ecx])._EBX
+    pop     (IA32_TSS ptr [ecx])._EDX
+    pop     (IA32_TSS ptr [ecx])._ECX
+    pop     (IA32_TSS ptr [ecx])._EAX
+
+    mov     esp, ebp
+
+; Set single step DB# if SMM profile is enabled and page fault exception happens
+    cmp     FeaturePcdGet (PcdCpuSmmProfileEnable), 0
+    jz      @Done2
+
+; Create return context for iretd in stub function
+    mov    eax, (IA32_TSS ptr [ecx])._ESP        ; Get old stack pointer
+    mov    ebx, (IA32_TSS ptr [ecx]).EIP
+    mov    [eax - 0ch], ebx                      ; create EIP in old stack
+    movzx  ebx, (IA32_TSS ptr [ecx])._CS
+    mov    [eax - 08h], ebx                      ; create CS in old stack
+    mov    ebx, (IA32_TSS ptr [ecx]).EFLAGS
+    bts    ebx, 8
+    mov    [eax - 04h], ebx                      ; create eflags in old stack
+    mov    eax, (IA32_TSS ptr [ecx])._ESP        ; Get old stack pointer
+    sub    eax, 0ch                              ; minus 12 byte
+    mov    (IA32_TSS ptr [ecx])._ESP, eax        ; Set new stack pointer
+; Replace the EIP of interrupted task with stub function
+    mov    eax, PageFaultStubFunction
+    mov    (IA32_TSS ptr [ecx]).EIP, eax
+; Jump to the iretd so next page fault handler as a task will start again after iretd.
+@Done2:
+    add     esp, 4                      ; skip ErrCode
+
+    jmp     Return
+PageFaultIdtHandlerSmmProfile ENDP
+
+PageFaultStubFunction   PROC
+;
+; we need clean TS bit in CR0 to execute
+; x87 FPU/MMX/SSE/SSE2/SSE3/SSSE3/SSE4 instructions.
+;
+    clts
+    iretd
+PageFaultStubFunction   ENDP
+
+InitializeIDTSmmStackGuard   PROC    USES    ebx
+;
+; If SMM Stack Guard feature is enabled, the Page Fault Exception entry in IDT
+; is a Task Gate Descriptor so that when a Page Fault Exception occurs,
+; the processors can use a known good stack in case stack is ran out.
+;
+    lea     ebx, _SmiIDT + 14 * 8
+    lea     edx, TaskGateDescriptor
+    mov     eax, [edx]
+    mov     [ebx], eax
+    mov     eax, [edx + 4]
+    mov     [ebx + 4], eax
+    ret
+InitializeIDTSmmStackGuard   ENDP
+
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.S
new file mode 100644
index 000000000000..e8db33a45a4d
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.S
@@ -0,0 +1,84 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmmInit.S
+#
+# Abstract:
+#
+#   Functions for relocating SMBASE's for all processors
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL   ASM_PFX(gSmmCr0)
+ASM_GLOBAL   ASM_PFX(gSmmCr3)
+ASM_GLOBAL   ASM_PFX(gSmmCr4)
+ASM_GLOBAL   ASM_PFX(gcSmmInitTemplate)
+ASM_GLOBAL   ASM_PFX(gcSmmInitSize)
+ASM_GLOBAL   ASM_PFX(gSmmJmpAddr)
+ASM_GLOBAL   ASM_PFX(SmmRelocationSemaphoreComplete)
+ASM_GLOBAL   ASM_PFX(gSmmInitStack)
+ASM_GLOBAL   ASM_PFX(gcSmiInitGdtr)
+
+.equ            PROTECT_MODE_CS, 0x08
+.equ            PROTECT_MODE_DS, 0x20
+
+    .text
+
+ASM_PFX(gcSmiInitGdtr):
+            .word      0
+            .quad      0
+
+SmmStartup:
+    .byte   0x66,0xb8
+ASM_PFX(gSmmCr3):    .space     4
+    movl    %eax, %cr3
+    .byte   0x67,0x66
+    lgdt    %cs:(ASM_PFX(gcSmiInitGdtr) - SmmStartup)(%ebp)
+    .byte   0x66,0xb8
+ASM_PFX(gSmmCr4):    .space     4
+    movl    %eax, %cr4
+    .byte   0x66,0xb8
+ASM_PFX(gSmmCr0):    .space     4
+    .byte   0xbf, PROTECT_MODE_DS, 0      # mov di, PROTECT_MODE_DS
+    movl    %eax, %cr0
+    .byte   0x66,0xea                     # jmp far [ptr48]
+ASM_PFX(gSmmJmpAddr): .long Start32bit
+    .word   PROTECT_MODE_CS
+Start32bit:
+    movl    %edi,%ds
+    movl    %edi,%es
+    movl    %edi,%fs
+    movl    %edi,%gs
+    movl    %edi,%ss
+    .byte   0xbc                        # mov esp, imm32
+ASM_PFX(gSmmInitStack):  .space  4
+    call    ASM_PFX(SmmInitHandler)
+    rsm
+
+ASM_PFX(gcSmmInitTemplate):
+
+_SmmInitTemplate:
+    .byte 0x66
+    movl    $SmmStartup, %ebp
+    .byte 0x66, 0x81, 0xed, 0, 0, 3, 0  # sub ebp, 0x30000
+    jmp     *%bp                        # jmp ebp actually
+
+ASM_PFX(gcSmmInitSize):   .word  . - ASM_PFX(gcSmmInitTemplate)
+
+
+ASM_PFX(SmmRelocationSemaphoreComplete):
+    pushl   %eax
+    movl    ASM_PFX(mRebasedFlag), %eax
+    movb    $1, (%eax)
+    popl    %eax
+    jmp     *ASM_PFX(mSmmRelocationOriginalAddress)
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.asm
new file mode 100644
index 000000000000..9ba2aebe6925
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmInit.asm
@@ -0,0 +1,94 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmmInit.Asm
+;
+; Abstract:
+;
+;   Functions for relocating SMBASE's for all processors
+;
+;-------------------------------------------------------------------------------
+
+    .686p
+    .xmm
+    .model  flat,C
+
+SmmInitHandler  PROTO   C
+
+EXTERNDEF   C   gSmmCr0:DWORD
+EXTERNDEF   C   gSmmCr3:DWORD
+EXTERNDEF   C   gSmmCr4:DWORD
+EXTERNDEF   C   gcSmmInitTemplate:BYTE
+EXTERNDEF   C   gcSmmInitSize:WORD
+EXTERNDEF   C   gSmmJmpAddr:QWORD
+EXTERNDEF   C   mRebasedFlag:PTR BYTE
+EXTERNDEF   C   mSmmRelocationOriginalAddress:DWORD
+EXTERNDEF   C   gSmmInitStack:DWORD
+EXTERNDEF   C   gcSmiInitGdtr:FWORD
+
+PROTECT_MODE_CS EQU   08h
+PROTECT_MODE_DS EQU   20h
+
+    .code
+
+gcSmiInitGdtr   LABEL   FWORD
+            DW      0
+            DQ      0
+
+SmmStartup  PROC
+    DB      66h, 0b8h
+gSmmCr3     DD      ?
+    mov     cr3, eax
+    DB      67h, 66h
+    lgdt    fword ptr cs:[ebp + (offset gcSmiInitGdtr - SmmStartup)]
+    DB      66h, 0b8h
+gSmmCr4     DD      ?
+    mov     cr4, eax
+    DB      66h, 0b8h
+gSmmCr0     DD      ?
+    DB      0bfh, PROTECT_MODE_DS, 0    ; mov di, PROTECT_MODE_DS
+    mov     cr0, eax
+    DB      66h, 0eah                   ; jmp far [ptr48]
+gSmmJmpAddr LABEL   QWORD
+    DD      @32bit
+    DW      PROTECT_MODE_CS
+@32bit:
+    mov     ds, edi
+    mov     es, edi
+    mov     fs, edi
+    mov     gs, edi
+    mov     ss, edi
+    DB      0bch                        ; mov esp, imm32
+gSmmInitStack  DD ?
+    call    SmmInitHandler
+    rsm
+SmmStartup  ENDP
+
+gcSmmInitTemplate   LABEL   BYTE
+
+_SmmInitTemplate    PROC
+    DB      66h
+    mov     ebp, SmmStartup
+    DB      66h, 81h, 0edh, 00h, 00h, 03h, 00  ; sub ebp, 30000h
+    jmp     bp                          ; jmp ebp actually
+_SmmInitTemplate    ENDP
+
+gcSmmInitSize   DW  $ - gcSmmInitTemplate
+
+SmmRelocationSemaphoreComplete PROC
+    push    eax
+    mov     eax, mRebasedFlag
+    mov     byte ptr [eax], 1
+    pop     eax
+    jmp     [mSmmRelocationOriginalAddress]
+SmmRelocationSemaphoreComplete ENDP
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
new file mode 100644
index 000000000000..85756d0710cf
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
@@ -0,0 +1,80 @@
+/** @file
+IA-32 processor specific functions to enable SMM profile.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+#include "SmmProfileInternal.h"
+
+/**
+  Create SMM page table for S3 path.
+
+**/
+VOID
+InitSmmS3Cr3 (
+  VOID
+  )
+{
+  mSmmS3ResumeState->SmmS3Cr3 = Gen4GPageTable (0);
+
+  return ;
+}
+
+/**
+  Allocate pages for creating 4KB-page based on 2MB-page when page fault happens.
+  32-bit firmware does not need it.
+
+**/
+VOID
+InitPagesForPFHandler (
+  VOID
+  )
+{
+}
+
+/**
+  Update page table to map the memory correctly in order to make the instruction
+  which caused page fault execute successfully. And it also save the original page
+  table to be restored in single-step exception. 32-bit firmware does not need it.
+
+  @param  PageTable           PageTable Address.
+  @param  PFAddress           The memory address which caused page fault exception.
+  @param  CpuIndex            The index of the processor.
+  @param  ErrorCode           The Error code of exception.
+  @param  IsValidPFAddress    The flag indicates if SMM profile data need be added.
+
+**/
+VOID
+RestorePageTableAbove4G (
+  UINT64        *PageTable,
+  UINT64        PFAddress,
+  UINTN         CpuIndex,
+  UINTN         ErrorCode,
+  BOOLEAN       *IsValidPFAddress
+  )
+{
+}
+
+/**
+  Clear TF in FLAGS.
+
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+
+**/
+VOID
+ClearTrapFlag (
+  IN OUT EFI_SYSTEM_CONTEXT   SystemContext
+  )
+{
+  SystemContext.SystemContextIa32->Eflags &= (UINTN) ~BIT8;
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.h b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.h
new file mode 100644
index 000000000000..3e15bffc60a5
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.h
@@ -0,0 +1,97 @@
+/** @file
+IA-32 processor specific header file to enable SMM profile.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_PROFILE_ARCH_H_
+#define _SMM_PROFILE_ARCH_H_
+
+#pragma pack (1)
+
+typedef struct _MSR_DS_AREA_STRUCT {
+  UINT32  BTSBufferBase;
+  UINT32  BTSIndex;
+  UINT32  BTSAbsoluteMaximum;
+  UINT32  BTSInterruptThreshold;
+  UINT32  PEBSBufferBase;
+  UINT32  PEBSIndex;
+  UINT32  PEBSAbsoluteMaximum;
+  UINT32  PEBSInterruptThreshold;
+  UINT32  PEBSCounterReset[4];
+  UINT32  Reserved;
+} MSR_DS_AREA_STRUCT;
+
+typedef struct _BRANCH_TRACE_RECORD {
+  UINT32  LastBranchFrom;
+  UINT32  LastBranchTo;
+  UINT32  Rsvd0 : 4;
+  UINT32  BranchPredicted : 1;
+  UINT32  Rsvd1 : 27;
+} BRANCH_TRACE_RECORD;
+
+typedef struct _PEBS_RECORD {
+  UINT32  Eflags;
+  UINT32  LinearIP;
+  UINT32  Eax;
+  UINT32  Ebx;
+  UINT32  Ecx;
+  UINT32  Edx;
+  UINT32  Esi;
+  UINT32  Edi;
+  UINT32  Ebp;
+  UINT32  Esp;
+} PEBS_RECORD;
+
+#pragma pack ()
+
+#define PHYSICAL_ADDRESS_MASK       ((1ull << 32) - SIZE_4KB)
+
+/**
+  Update page table to map the memory correctly in order to make the instruction
+  which caused page fault execute successfully. And it also save the original page
+  table to be restored in single-step exception. 32-bit firmware does not need it.
+
+  @param  PageTable           PageTable Address.
+  @param  PFAddress           The memory address which caused page fault exception.
+  @param  CpuIndex            The index of the processor.
+  @param  ErrorCode           The Error code of exception.
+  @param  IsValidPFAddress    The flag indicates if SMM profile data need be added.
+
+**/
+VOID
+RestorePageTableAbove4G (
+  UINT64        *PageTable,
+  UINT64        PFAddress,
+  UINTN         CpuIndex,
+  UINTN         ErrorCode,
+  BOOLEAN       *IsValidPFAddress
+  );
+
+/**
+  Create SMM page table for S3 path.
+
+**/
+VOID
+InitSmmS3Cr3 (
+  VOID
+  );
+
+/**
+  Allocate pages for creating 4KB-page based on 2MB-page when page fault happens.
+
+**/
+VOID
+InitPagesForPFHandler (
+  VOID
+  );
+
+#endif // _SMM_PROFILE_ARCH_H_

From 05aebe5da37b680a03a92121a05937dc9cc83667 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:06:29 +0000
Subject: [PATCH 126/525] UefiCpuPkg: Add PiSmmCpuDxeSmm module X64 files

Add module that initializes a CPU for the SMM environment and
installs the first level SMI handler.  This module along with the
SMM IPL and SMM Core provide the services required for
DXE_SMM_DRIVERS to register hardware and software SMI handlers.

CPU specific features are abstracted through the SmmCpuFeaturesLib

Platform specific features are abstracted through the
SmmCpuPlatformHookLib

Several PCDs are added to enable/disable features and configure
settings for the PiSmmCpuDxeSmm module

(Sync patch r18647 from main trunk.)

[jeff.fan@intel.com: Fix code style issues reported by ECC]
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18842 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.S       | 204 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.asm     | 206 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c       | 692 ++++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/Semaphore.c     |  67 ++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S      | 217 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm    | 221 ++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S  | 610 +++++++++++++++
 .../PiSmmCpuDxeSmm/X64/SmiException.asm       | 413 +++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.S       | 141 ++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.asm     | 132 ++++
 .../PiSmmCpuDxeSmm/X64/SmmProfileArch.c       | 316 ++++++++
 .../PiSmmCpuDxeSmm/X64/SmmProfileArch.h       | 105 +++
 12 files changed, 3324 insertions(+)
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/Semaphore.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.S
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.asm
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.h

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.S
new file mode 100644
index 000000000000..d7cbc8cdc50b
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.S
@@ -0,0 +1,204 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   MpFuncs.S
+#
+# Abstract:
+#
+#   This is the assembly code for Multi-processor S3 support
+#
+#------------------------------------------------------------------------------
+
+.equ                   VacantFlag,       0x0
+.equ                   NotVacantFlag,    0xff
+
+.equ                   LockLocation,              RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+.equ                   StackStartAddressLocation, RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x08
+.equ                   StackSizeLocation,         RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x10
+.equ                   CProcedureLocation,        RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x18
+.equ                   GdtrLocation,              RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x20
+.equ                   IdtrLocation,              RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x2A
+.equ                   BufferStartLocation,       RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x34
+.equ                   Cr3OffsetLocation,         RendezvousFunnelProcEnd - RendezvousFunnelProcStart + 0x38
+
+#-------------------------------------------------------------------------------------
+#RendezvousFunnelProc  procedure follows. All APs execute their procedure. This
+#procedure serializes all the AP processors through an Init sequence. It must be
+#noted that APs arrive here very raw...ie: real mode, no stack.
+#ALSO THIS PROCEDURE IS EXECUTED BY APs ONLY ON 16 BIT MODE. HENCE THIS PROC
+#IS IN MACHINE CODE.
+#-------------------------------------------------------------------------------------
+#RendezvousFunnelProc (&WakeUpBuffer,MemAddress);
+
+.code:
+
+ASM_GLOBAL ASM_PFX(RendezvousFunnelProc)
+ASM_PFX(RendezvousFunnelProc):
+RendezvousFunnelProcStart:
+
+# At this point CS = 0x(vv00) and ip= 0x0.
+
+        .byte 0x8c,0xc8               # mov        ax,  cs
+        .byte 0x8e,0xd8               # mov        ds,  ax
+        .byte 0x8e,0xc0               # mov        es,  ax
+        .byte 0x8e,0xd0               # mov        ss,  ax
+        .byte 0x33,0xc0               # xor        ax,  ax
+        .byte 0x8e,0xe0               # mov        fs,  ax
+        .byte 0x8e,0xe8               # mov        gs,  ax
+
+flat32Start:
+
+        .byte 0xBE
+        .word BufferStartLocation
+        .byte 0x66,0x8B,0x14          # mov        edx,dword ptr [si]          ; EDX is keeping the start address of wakeup buffer
+
+        .byte 0xBE
+        .word Cr3OffsetLocation
+        .byte 0x66,0x8B,0xC           # mov        ecx,dword ptr [si]          ; ECX is keeping the value of CR3
+
+        .byte 0xBE
+        .word GdtrLocation
+        .byte 0x66                    # db         66h
+        .byte 0x2E,0xF,0x1,0x14       # lgdt       fword ptr cs:[si]
+
+        .byte 0xBE
+        .word IdtrLocation
+        .byte 0x66                    # db         66h
+        .byte 0x2E,0xF,0x1,0x1C       # lidt       fword ptr cs:[si]
+
+        .byte 0x33,0xC0               # xor        ax,  ax
+        .byte 0x8E,0xD8               # mov        ds,  ax
+
+        .byte 0xF,0x20,0xC0           # mov        eax, cr0                    ; Get control register 0
+        .byte 0x66,0x83,0xC8,0x1      # or         eax, 000000001h             ; Set PE bit (bit #0)
+        .byte 0xF,0x22,0xC0           # mov        cr0, eax
+
+FLAT32_JUMP:
+
+        .byte 0x66,0x67,0xEA          # far jump
+        .long 0x0                     # 32-bit offset
+        .word 0x20                    # 16-bit selector
+
+PMODE_ENTRY:                          # protected mode entry point
+
+        .byte 0x66,0xB8,0x18,0x0      # mov        ax,  18h
+        .byte 0x66,0x8E,0xD8          # mov        ds,  ax
+        .byte 0x66,0x8E,0xC0          # mov        es,  ax
+        .byte 0x66,0x8E,0xE0          # mov        fs,  ax
+        .byte 0x66,0x8E,0xE8          # mov        gs,  ax
+        .byte 0x66,0x8E,0xD0          # mov        ss,  ax                     ; Flat mode setup.
+
+        .byte 0xF,0x20,0xE0           # mov        eax, cr4
+        .byte 0xF,0xBA,0xE8,0x5       # bts        eax, 5
+        .byte 0xF,0x22,0xE0           # mov        cr4, eax
+
+        .byte 0xF,0x22,0xD9           # mov        cr3, ecx
+
+        .byte 0x8B,0xF2               # mov        esi, edx                    ; Save wakeup buffer address
+
+        .byte 0xB9
+        .long 0xC0000080              # mov        ecx, 0c0000080h             ; EFER MSR number.
+        .byte 0xF,0x32                # rdmsr                                  ; Read EFER.
+        .byte 0xF,0xBA,0xE8,0x8       # bts        eax, 8                      ; Set LME=1.
+        .byte 0xF,0x30                # wrmsr                                  ; Write EFER.
+
+        .byte 0xF,0x20,0xC0           # mov        eax, cr0                    ; Read CR0.
+        .byte 0xF,0xBA,0xE8,0x1F      # bts        eax, 31                     ; Set PG=1.
+        .byte 0xF,0x22,0xC0           # mov        cr0, eax                    ; Write CR0.
+
+LONG_JUMP:
+
+        .byte 0x67,0xEA               # far jump
+        .long 0x0                     # 32-bit offset
+        .word 0x38                    # 16-bit selector
+
+LongModeStart:
+
+        movw        $0x30,%ax
+        .byte       0x66
+        movw        %ax,%ds
+        .byte       0x66
+        movw        %ax,%es
+        .byte       0x66
+        movw        %ax,%ss
+
+        movl %esi,%edi
+        addl $LockLocation, %edi
+        movb $NotVacantFlag, %al
+TestLock:
+        xchgb (%edi), %al
+        cmpb $NotVacantFlag, %al
+        jz   TestLock
+
+ProgramStack:
+
+        movl %esi,%edi
+        addl $StackSizeLocation, %edi
+        movq (%edi), %rax
+        movl %esi,%edi
+        addl $StackStartAddressLocation, %edi
+        addq (%edi), %rax
+        movq %rax, %rsp
+        movq %rax, (%edi)
+
+Releaselock:
+
+        movb $VacantFlag, %al
+        movl %esi,%edi
+        addl $LockLocation, %edi
+        xchgb (%edi), %al
+
+        #
+        # Call assembly function to initialize FPU.
+        #
+        movabsq     $ASM_PFX(InitializeFloatingPointUnits), %rax
+        subq        $0x20, %rsp
+        call        *%rax
+        addq        $0x20, %rsp
+        #
+        # Call C Function
+        #
+        movl        %esi,%edi
+        addl        $CProcedureLocation, %edi
+        movq        (%edi), %rax
+
+        testq       %rax, %rax
+        jz          GoToSleep
+
+        subq        $0x20, %rsp
+        call        *%rax
+        addq        $0x20, %rsp
+
+GoToSleep:
+        cli
+        hlt
+        jmp         .-2
+
+RendezvousFunnelProcEnd:
+
+
+#-------------------------------------------------------------------------------------
+#  AsmGetAddressMap (&AddressMap);
+#-------------------------------------------------------------------------------------
+# comments here for definition of address map
+ASM_GLOBAL ASM_PFX(AsmGetAddressMap)
+ASM_PFX(AsmGetAddressMap):
+        movabsq      $RendezvousFunnelProcStart, %rax
+        movq         %rax, (%rcx)
+        movq         $(PMODE_ENTRY - RendezvousFunnelProcStart), 0x08(%rcx)
+        movq         $(FLAT32_JUMP - RendezvousFunnelProcStart), 0x10(%rcx)
+        movq         $(RendezvousFunnelProcEnd - RendezvousFunnelProcStart), 0x18(%rcx)
+        movq         $(LongModeStart - RendezvousFunnelProcStart), 0x20(%rcx)
+        movq         $(LONG_JUMP - RendezvousFunnelProcStart), 0x28(%rcx)
+        ret
+
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.asm
new file mode 100644
index 000000000000..2c5a7c9bc2db
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/MpFuncs.asm
@@ -0,0 +1,206 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   MpFuncs.asm
+;
+; Abstract:
+;
+;   This is the assembly code for Multi-processor S3 support
+;
+;-------------------------------------------------------------------------------
+
+EXTERN  InitializeFloatingPointUnits:PROC
+
+VacantFlag             Equ   00h
+NotVacantFlag          Equ   0ffh
+
+LockLocation                  equ        RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+StackStartAddressLocation     equ        LockLocation + 08h
+StackSizeLocation             equ        LockLocation + 10h
+CProcedureLocation            equ        LockLocation + 18h
+GdtrLocation                  equ        LockLocation + 20h
+IdtrLocation                  equ        LockLocation + 2Ah
+BufferStartLocation           equ        LockLocation + 34h
+Cr3OffsetLocation             equ        LockLocation + 38h
+
+;-------------------------------------------------------------------------------------
+;RendezvousFunnelProc  procedure follows. All APs execute their procedure. This
+;procedure serializes all the AP processors through an Init sequence. It must be
+;noted that APs arrive here very raw...ie: real mode, no stack.
+;ALSO THIS PROCEDURE IS EXECUTED BY APs ONLY ON 16 BIT MODE. HENCE THIS PROC
+;IS IN MACHINE CODE.
+;-------------------------------------------------------------------------------------
+;RendezvousFunnelProc (&WakeUpBuffer,MemAddress);
+
+;text      SEGMENT
+.code
+
+RendezvousFunnelProc   PROC
+RendezvousFunnelProcStart::
+
+; At this point CS = 0x(vv00) and ip= 0x0.
+
+        db 8ch,  0c8h                 ; mov        ax,  cs
+        db 8eh,  0d8h                 ; mov        ds,  ax
+        db 8eh,  0c0h                 ; mov        es,  ax
+        db 8eh,  0d0h                 ; mov        ss,  ax
+        db 33h,  0c0h                 ; xor        ax,  ax
+        db 8eh,  0e0h                 ; mov        fs,  ax
+        db 8eh,  0e8h                 ; mov        gs,  ax
+
+flat32Start::
+
+        db 0BEh
+        dw BufferStartLocation        ; mov        si, BufferStartLocation
+        db 66h,  8Bh, 14h             ; mov        edx,dword ptr [si]          ; EDX is keeping the start address of wakeup buffer
+
+        db 0BEh
+        dw Cr3OffsetLocation          ; mov        si, Cr3Location
+        db 66h,  8Bh, 0Ch             ; mov        ecx,dword ptr [si]          ; ECX is keeping the value of CR3
+
+        db 0BEh
+        dw GdtrLocation               ; mov        si, GdtrProfile
+        db 66h                        ; db         66h
+        db 2Eh,  0Fh, 01h, 14h        ; lgdt       fword ptr cs:[si]
+
+        db 0BEh
+        dw IdtrLocation               ; mov        si, IdtrProfile
+        db 66h                        ; db         66h
+        db 2Eh,  0Fh, 01h, 1Ch        ; lidt       fword ptr cs:[si]
+
+        db 33h,  0C0h                 ; xor        ax,  ax
+        db 8Eh,  0D8h                 ; mov        ds,  ax
+
+        db 0Fh,  20h, 0C0h            ; mov        eax, cr0                    ; Get control register 0
+        db 66h,  83h, 0C8h, 01h       ; or         eax, 000000001h             ; Set PE bit (bit #0)
+        db 0Fh,  22h, 0C0h            ; mov        cr0, eax
+
+FLAT32_JUMP::
+
+        db 66h,  67h, 0EAh            ; far jump
+        dd 0h                         ; 32-bit offset
+        dw 20h                        ; 16-bit selector
+
+PMODE_ENTRY::                         ; protected mode entry point
+
+        db 66h,  0B8h, 18h,  00h      ; mov        ax,  18h
+        db 66h,  8Eh,  0D8h           ; mov        ds,  ax
+        db 66h,  8Eh,  0C0h           ; mov        es,  ax
+        db 66h,  8Eh,  0E0h           ; mov        fs,  ax
+        db 66h,  8Eh,  0E8h           ; mov        gs,  ax
+        db 66h,  8Eh,  0D0h           ; mov        ss,  ax                     ; Flat mode setup.
+
+        db 0Fh,  20h,  0E0h           ; mov        eax, cr4
+        db 0Fh,  0BAh, 0E8h, 05h      ; bts        eax, 5
+        db 0Fh,  22h,  0E0h           ; mov        cr4, eax
+
+        db 0Fh,  22h,  0D9h           ; mov        cr3, ecx
+
+        db 8Bh,  0F2h                 ; mov        esi, edx                    ; Save wakeup buffer address
+
+        db 0B9h
+        dd 0C0000080h                 ; mov        ecx, 0c0000080h             ; EFER MSR number.
+        db 0Fh,  32h                  ; rdmsr                                  ; Read EFER.
+        db 0Fh,  0BAh, 0E8h, 08h      ; bts        eax, 8                      ; Set LME=1.
+        db 0Fh,  30h                  ; wrmsr                                  ; Write EFER.
+
+        db 0Fh,  20h,  0C0h           ; mov        eax, cr0                    ; Read CR0.
+        db 0Fh,  0BAh, 0E8h, 1Fh      ; bts        eax, 31                     ; Set PG=1.
+        db 0Fh,  22h,  0C0h           ; mov        cr0, eax                    ; Write CR0.
+
+LONG_JUMP::
+
+        db 67h,  0EAh                 ; far jump
+        dd 0h                         ; 32-bit offset
+        dw 38h                        ; 16-bit selector
+
+LongModeStart::
+
+        mov         ax,  30h
+        mov         ds,  ax
+        mov         es,  ax
+        mov         ss,  ax
+
+        mov  edi, esi
+        add  edi, LockLocation
+        mov  al,  NotVacantFlag
+TestLock::
+        xchg byte ptr [edi], al
+        cmp  al, NotVacantFlag
+        jz   TestLock
+
+ProgramStack::
+
+        mov  edi, esi
+        add  edi, StackSizeLocation
+        mov  rax, qword ptr [edi]
+        mov  edi, esi
+        add  edi, StackStartAddressLocation
+        add  rax, qword ptr [edi]
+        mov  rsp, rax
+        mov  qword ptr [edi], rax
+
+Releaselock::
+
+        mov  al,  VacantFlag
+        mov  edi, esi
+        add  edi, LockLocation
+        xchg byte ptr [edi], al
+
+        ;
+        ; Call assembly function to initialize FPU.
+        ;
+        mov         rax, InitializeFloatingPointUnits
+        sub         rsp, 20h
+        call        rax
+        add         rsp, 20h
+
+        ;
+        ; Call C Function
+        ;
+        mov         edi, esi
+        add         edi, CProcedureLocation
+        mov         rax, qword ptr [edi]
+
+        test        rax, rax
+        jz          GoToSleep
+
+        sub         rsp, 20h
+        call        rax
+        add         rsp, 20h
+
+GoToSleep::
+        cli
+        hlt
+        jmp         $-2
+
+RendezvousFunnelProcEnd::
+RendezvousFunnelProc   ENDP
+
+
+;-------------------------------------------------------------------------------------
+;  AsmGetAddressMap (&AddressMap);
+;-------------------------------------------------------------------------------------
+; comments here for definition of address map
+AsmGetAddressMap   PROC
+        mov         rax, offset RendezvousFunnelProcStart
+        mov         qword ptr [rcx], rax
+        mov         qword ptr [rcx+8h], PMODE_ENTRY - RendezvousFunnelProcStart
+        mov         qword ptr [rcx+10h], FLAT32_JUMP - RendezvousFunnelProcStart
+        mov         qword ptr [rcx+18h], RendezvousFunnelProcEnd - RendezvousFunnelProcStart
+        mov         qword ptr [rcx+20h], LongModeStart - RendezvousFunnelProcStart
+        mov         qword ptr [rcx+28h], LONG_JUMP - RendezvousFunnelProcStart
+        ret
+
+AsmGetAddressMap   ENDP
+
+END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
new file mode 100644
index 000000000000..a7d790fd8aa0
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
@@ -0,0 +1,692 @@
+/** @file
+Page Fault (#PF) handler for X64 processors
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+#define PAGE_TABLE_PAGES            8
+#define ACC_MAX_BIT                 BIT3
+LIST_ENTRY                          mPagePool = INITIALIZE_LIST_HEAD_VARIABLE (mPagePool);
+SPIN_LOCK                           mPFLock;
+BOOLEAN                             m1GPageTableSupport = FALSE;
+
+/**
+  Check if 1-GByte pages is supported by processor or not.
+
+  @retval TRUE   1-GByte pages is supported.
+  @retval FALSE  1-GByte pages is not supported.
+
+**/
+BOOLEAN
+Is1GPageSupport (
+  VOID
+  )
+{
+  UINT32         RegEax;
+  UINT32         RegEdx;
+
+  AsmCpuid (0x80000000, &RegEax, NULL, NULL, NULL);
+  if (RegEax >= 0x80000001) {
+    AsmCpuid (0x80000001, NULL, NULL, NULL, &RegEdx);
+    if ((RegEdx & BIT26) != 0) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Set sub-entries number in entry.
+
+  @param[in, out] Entry        Pointer to entry
+  @param[in]      SubEntryNum  Sub-entries number based on 0:
+                               0 means there is 1 sub-entry under this entry
+                               0x1ff means there is 512 sub-entries under this entry
+
+**/
+VOID
+SetSubEntriesNum (
+  IN OUT UINT64               *Entry,
+  IN     UINT64               SubEntryNum
+  )
+{
+  //
+  // Sub-entries number is saved in BIT52 to BIT60 (reserved field) in Entry
+  //
+  *Entry = BitFieldWrite64 (*Entry, 52, 60, SubEntryNum);
+}
+
+/**
+  Return sub-entries number in entry.
+
+  @param[in] Entry        Pointer to entry
+
+  @return Sub-entries number based on 0:
+          0 means there is 1 sub-entry under this entry
+          0x1ff means there is 512 sub-entries under this entry
+**/
+UINT64
+GetSubEntriesNum (
+  IN UINT64            *Entry
+  )
+{
+  //
+  // Sub-entries number is saved in BIT52 to BIT60 (reserved field) in Entry
+  //
+  return BitFieldRead64 (*Entry, 52, 60);
+}
+
+/**
+  Create PageTable for SMM use.
+
+  @return The address of PML4 (to set CR3).
+
+**/
+UINT32
+SmmInitPageTable (
+  VOID
+  )
+{
+  EFI_PHYSICAL_ADDRESS              Pages;
+  UINT64                            *PTEntry;
+  LIST_ENTRY                        *FreePage;
+  UINTN                             Index;
+  UINTN                             PageFaultHandlerHookAddress;
+  IA32_IDT_GATE_DESCRIPTOR          *IdtEntry;
+
+  //
+  // Initialize spin lock
+  //
+  InitializeSpinLock (&mPFLock);
+
+  m1GPageTableSupport = Is1GPageSupport ();
+  //
+  // Generate PAE page table for the first 4GB memory space
+  //
+  Pages = Gen4GPageTable (PAGE_TABLE_PAGES + 1);
+
+  //
+  // Set IA32_PG_PMNT bit to mask this entry
+  //
+  PTEntry = (UINT64*)(UINTN)Pages;
+  for (Index = 0; Index < 4; Index++) {
+    PTEntry[Index] |= IA32_PG_PMNT;
+  }
+
+  //
+  // Fill Page-Table-Level4 (PML4) entry
+  //
+  PTEntry = (UINT64*)(UINTN)(Pages - EFI_PAGES_TO_SIZE (PAGE_TABLE_PAGES + 1));
+  *PTEntry = Pages + IA32_PG_P;
+  ZeroMem (PTEntry + 1, EFI_PAGE_SIZE - sizeof (*PTEntry));
+  //
+  // Set sub-entries number
+  //
+  SetSubEntriesNum (PTEntry, 3);
+
+  //
+  // Add remaining pages to page pool
+  //
+  FreePage = (LIST_ENTRY*)(PTEntry + EFI_PAGE_SIZE / sizeof (*PTEntry));
+  while ((UINTN)FreePage < Pages) {
+    InsertTailList (&mPagePool, FreePage);
+    FreePage += EFI_PAGE_SIZE / sizeof (*FreePage);
+  }
+
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    //
+    // Set own Page Fault entry instead of the default one, because SMM Profile
+    // feature depends on IRET instruction to do Single Step
+    //
+    PageFaultHandlerHookAddress = (UINTN)PageFaultIdtHandlerSmmProfile;
+    IdtEntry  = (IA32_IDT_GATE_DESCRIPTOR *) gcSmiIdtr.Base;
+    IdtEntry += EXCEPT_IA32_PAGE_FAULT;
+    IdtEntry->Bits.OffsetLow      = (UINT16)PageFaultHandlerHookAddress;
+    IdtEntry->Bits.Reserved_0     = 0;
+    IdtEntry->Bits.GateType       = IA32_IDT_GATE_TYPE_INTERRUPT_32;
+    IdtEntry->Bits.OffsetHigh     = (UINT16)(PageFaultHandlerHookAddress >> 16);
+    IdtEntry->Bits.OffsetUpper    = (UINT32)(PageFaultHandlerHookAddress >> 32);
+    IdtEntry->Bits.Reserved_1     = 0;
+  } else {
+    //
+    // Register Smm Page Fault Handler
+    //
+    SmmRegisterExceptionHandler (&mSmmCpuService, EXCEPT_IA32_PAGE_FAULT, SmiPFHandler);
+  }
+
+  //
+  // Additional SMM IDT initialization for SMM stack guard
+  //
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    InitializeIDTSmmStackGuard ();
+  }
+
+  //
+  // Return the address of PML4 (to set CR3)
+  //
+  return (UINT32)(UINTN)PTEntry;
+}
+
+/**
+  Set access record in entry.
+
+  @param[in, out] Entry        Pointer to entry
+  @param[in]      Acc          Access record value
+
+**/
+VOID
+SetAccNum (
+  IN OUT UINT64               *Entry,
+  IN     UINT64               Acc
+  )
+{
+  //
+  // Access record is saved in BIT9 to BIT11 (reserved field) in Entry
+  //
+  *Entry = BitFieldWrite64 (*Entry, 9, 11, Acc);
+}
+
+/**
+  Return access record in entry.
+
+  @param[in] Entry        Pointer to entry
+
+  @return Access record value.
+
+**/
+UINT64
+GetAccNum (
+  IN UINT64            *Entry
+  )
+{
+  //
+  // Access record is saved in BIT9 to BIT11 (reserved field) in Entry
+  //
+  return BitFieldRead64 (*Entry, 9, 11);
+}
+
+/**
+  Return and update the access record in entry.
+
+  @param[in, out]  Entry    Pointer to entry
+
+  @return Access record value.
+
+**/
+UINT64
+GetAndUpdateAccNum (
+  IN OUT UINT64      *Entry
+  )
+{
+  UINT64         Acc;
+
+  Acc = GetAccNum (Entry);
+  if ((*Entry & IA32_PG_A) != 0) {
+    //
+    // If this entry has been accessed, clear access flag in Entry and update access record
+    // to the initial value 7, adding ACC_MAX_BIT is to make it larger than others
+    //
+    *Entry &= ~(UINT64)(UINTN)IA32_PG_A;
+    SetAccNum (Entry, 0x7);
+    return (0x7 + ACC_MAX_BIT);
+  } else {
+    if (Acc != 0) {
+      //
+      // If the access record is not the smallest value 0, minus 1 and update the access record field
+      //
+      SetAccNum (Entry, Acc - 1);
+    }
+  }
+  return Acc;
+}
+
+/**
+  Reclaim free pages for PageFault handler.
+
+  Search the whole entries tree to find the leaf entry that has the smallest
+  access record value. Insert the page pointed by this leaf entry into the
+  page pool. And check its upper entries if need to be inserted into the page
+  pool or not.
+
+**/
+VOID
+ReclaimPages (
+  VOID
+  )
+{
+  UINT64                       *Pml4;
+  UINT64                       *Pdpt;
+  UINT64                       *Pdt;
+  UINTN                        Pml4Index;
+  UINTN                        PdptIndex;
+  UINTN                        PdtIndex;
+  UINTN                        MinPml4;
+  UINTN                        MinPdpt;
+  UINTN                        MinPdt;
+  UINT64                       MinAcc;
+  UINT64                       Acc;
+  UINT64                       SubEntriesNum;
+  BOOLEAN                      PML4EIgnore;
+  BOOLEAN                      PDPTEIgnore;
+  UINT64                       *ReleasePageAddress;
+
+  Pml4 = NULL;
+  Pdpt = NULL;
+  Pdt  = NULL;
+  MinAcc  = (UINT64)-1;
+  MinPml4 = (UINTN)-1;
+  MinPdpt = (UINTN)-1;
+  MinPdt  = (UINTN)-1;
+  Acc     = 0;
+  ReleasePageAddress = 0;
+
+  //
+  // First, find the leaf entry has the smallest access record value
+  //
+  Pml4 = (UINT64*)(UINTN)(AsmReadCr3 () & gPhyMask);
+  for (Pml4Index = 0; Pml4Index < EFI_PAGE_SIZE / sizeof (*Pml4); Pml4Index++) {
+    if ((Pml4[Pml4Index] & IA32_PG_P) == 0 || (Pml4[Pml4Index] & IA32_PG_PMNT) != 0) {
+      //
+      // If the PML4 entry is not present or is masked, skip it
+      //
+      continue;
+    }
+    Pdpt = (UINT64*)(UINTN)(Pml4[Pml4Index] & gPhyMask);
+    PML4EIgnore = FALSE;
+    for (PdptIndex = 0; PdptIndex < EFI_PAGE_SIZE / sizeof (*Pdpt); PdptIndex++) {
+      if ((Pdpt[PdptIndex] & IA32_PG_P) == 0 || (Pdpt[PdptIndex] & IA32_PG_PMNT) != 0) {
+        //
+        // If the PDPT entry is not present or is masked, skip it
+        //
+        if ((Pdpt[PdptIndex] & IA32_PG_PMNT) != 0) {
+          //
+          // If the PDPT entry is masked, we will ignore checking the PML4 entry
+          //
+          PML4EIgnore = TRUE;
+        }
+        continue;
+      }
+      if ((Pdpt[PdptIndex] & IA32_PG_PS) == 0) {
+        //
+        // It's not 1-GByte pages entry, it should be a PDPT entry,
+        // we will not check PML4 entry more
+        //
+        PML4EIgnore = TRUE;
+        Pdt =  (UINT64*)(UINTN)(Pdpt[PdptIndex] & gPhyMask);
+        PDPTEIgnore = FALSE;
+        for (PdtIndex = 0; PdtIndex < EFI_PAGE_SIZE / sizeof(*Pdt); PdtIndex++) {
+          if ((Pdt[PdtIndex] & IA32_PG_P) == 0 || (Pdt[PdtIndex] & IA32_PG_PMNT) != 0) {
+            //
+            // If the PD entry is not present or is masked, skip it
+            //
+            if ((Pdt[PdtIndex] & IA32_PG_PMNT) != 0) {
+              //
+              // If the PD entry is masked, we will not PDPT entry more
+              //
+              PDPTEIgnore = TRUE;
+            }
+            continue;
+          }
+          if ((Pdt[PdtIndex] & IA32_PG_PS) == 0) {
+            //
+            // It's not 2 MByte page table entry, it should be PD entry
+            // we will find the entry has the smallest access record value
+            //
+            PDPTEIgnore = TRUE;
+            Acc = GetAndUpdateAccNum (Pdt + PdtIndex);
+            if (Acc < MinAcc) {
+              //
+              // If the PD entry has the smallest access record value,
+              // save the Page address to be released
+              //
+              MinAcc  = Acc;
+              MinPml4 = Pml4Index;
+              MinPdpt = PdptIndex;
+              MinPdt  = PdtIndex;
+              ReleasePageAddress = Pdt + PdtIndex;
+            }
+          }
+        }
+        if (!PDPTEIgnore) {
+          //
+          // If this PDPT entry has no PDT entries pointer to 4 KByte pages,
+          // it should only has the entries point to 2 MByte Pages
+          //
+          Acc = GetAndUpdateAccNum (Pdpt + PdptIndex);
+          if (Acc < MinAcc) {
+            //
+            // If the PDPT entry has the smallest access record value,
+            // save the Page address to be released
+            //
+            MinAcc  = Acc;
+            MinPml4 = Pml4Index;
+            MinPdpt = PdptIndex;
+            MinPdt  = (UINTN)-1;
+            ReleasePageAddress = Pdpt + PdptIndex;
+          }
+        }
+      }
+    }
+    if (!PML4EIgnore) {
+      //
+      // If PML4 entry has no the PDPT entry pointer to 2 MByte pages,
+      // it should only has the entries point to 1 GByte Pages
+      //
+      Acc = GetAndUpdateAccNum (Pml4 + Pml4Index);
+      if (Acc < MinAcc) {
+        //
+        // If the PML4 entry has the smallest access record value,
+        // save the Page address to be released
+        //
+        MinAcc  = Acc;
+        MinPml4 = Pml4Index;
+        MinPdpt = (UINTN)-1;
+        MinPdt  = (UINTN)-1;
+        ReleasePageAddress = Pml4 + Pml4Index;
+      }
+    }
+  }
+  //
+  // Make sure one PML4/PDPT/PD entry is selected
+  //
+  ASSERT (MinAcc != (UINT64)-1);
+
+  //
+  // Secondly, insert the page pointed by this entry into page pool and clear this entry
+  //
+  InsertTailList (&mPagePool, (LIST_ENTRY*)(UINTN)(*ReleasePageAddress & gPhyMask));
+  *ReleasePageAddress = 0;
+
+  //
+  // Lastly, check this entry's upper entries if need to be inserted into page pool
+  // or not
+  //
+  while (TRUE) {
+    if (MinPdt != (UINTN)-1) {
+      //
+      // If 4 KByte Page Table is released, check the PDPT entry
+      //
+      Pdpt = (UINT64*)(UINTN)(Pml4[MinPml4] & gPhyMask);
+      SubEntriesNum = GetSubEntriesNum(Pdpt + MinPdpt);
+      if (SubEntriesNum == 0) {
+        //
+        // Release the empty Page Directory table if there was no more 4 KByte Page Table entry
+        // clear the Page directory entry
+        //
+        InsertTailList (&mPagePool, (LIST_ENTRY*)(UINTN)(Pdpt[MinPdpt] & gPhyMask));
+        Pdpt[MinPdpt] = 0;
+        //
+        // Go on checking the PML4 table
+        //
+        MinPdt = (UINTN)-1;
+        continue;
+      }
+      //
+      // Update the sub-entries filed in PDPT entry and exit
+      //
+      SetSubEntriesNum (Pdpt + MinPdpt, SubEntriesNum - 1);
+      break;
+    }
+    if (MinPdpt != (UINTN)-1) {
+      //
+      // One 2MB Page Table is released or Page Directory table is released, check the PML4 entry
+      //
+      SubEntriesNum = GetSubEntriesNum (Pml4 + MinPml4);
+      if (SubEntriesNum == 0) {
+        //
+        // Release the empty PML4 table if there was no more 1G KByte Page Table entry
+        // clear the Page directory entry
+        //
+        InsertTailList (&mPagePool, (LIST_ENTRY*)(UINTN)(Pml4[MinPml4] & gPhyMask));
+        Pml4[MinPml4] = 0;
+        MinPdpt = (UINTN)-1;
+        continue;
+      }
+      //
+      // Update the sub-entries filed in PML4 entry and exit
+      //
+      SetSubEntriesNum (Pml4 + MinPml4, SubEntriesNum - 1);
+      break;
+    }
+    //
+    // PLM4 table has been released before, exit it
+    //
+    break;
+  }
+}
+
+/**
+  Allocate free Page for PageFault handler use.
+
+  @return Page address.
+
+**/
+UINT64
+AllocPage (
+  VOID
+  )
+{
+  UINT64                            RetVal;
+
+  if (IsListEmpty (&mPagePool)) {
+    //
+    // If page pool is empty, reclaim the used pages and insert one into page pool
+    //
+    ReclaimPages ();
+  }
+
+  //
+  // Get one free page and remove it from page pool
+  //
+  RetVal = (UINT64)(UINTN)mPagePool.ForwardLink;
+  RemoveEntryList (mPagePool.ForwardLink);
+  //
+  // Clean this page and return
+  //
+  ZeroMem ((VOID*)(UINTN)RetVal, EFI_PAGE_SIZE);
+  return RetVal;
+}
+
+/**
+  Page Fault handler for SMM use.
+
+**/
+VOID
+SmiDefaultPFHandler (
+  VOID
+  )
+{
+  UINT64                            *PageTable;
+  UINT64                            *Pml4;
+  UINT64                            PFAddress;
+  UINTN                             StartBit;
+  UINTN                             EndBit;
+  UINT64                            PTIndex;
+  UINTN                             Index;
+  SMM_PAGE_SIZE_TYPE                PageSize;
+  UINTN                             NumOfPages;
+  UINTN                             PageAttribute;
+  EFI_STATUS                        Status;
+  UINT64                            *UpperEntry;
+
+  //
+  // Set default SMM page attribute
+  //
+  PageSize = SmmPageSize2M;
+  NumOfPages = 1;
+  PageAttribute = 0;
+
+  EndBit = 0;
+  Pml4 = (UINT64*)(AsmReadCr3 () & gPhyMask);
+  PFAddress = AsmReadCr2 ();
+
+  Status = GetPlatformPageTableAttribute (PFAddress, &PageSize, &NumOfPages, &PageAttribute);
+  //
+  // If platform not support page table attribute, set default SMM page attribute
+  //
+  if (Status != EFI_SUCCESS) {
+    PageSize = SmmPageSize2M;
+    NumOfPages = 1;
+    PageAttribute = 0;
+  }
+  if (PageSize >= MaxSmmPageSizeType) {
+    PageSize = SmmPageSize2M;
+  }
+  if (NumOfPages > 512) {
+    NumOfPages = 512;
+  }
+
+  switch (PageSize) {
+  case SmmPageSize4K:
+    //
+    // BIT12 to BIT20 is Page Table index
+    //
+    EndBit = 12;
+    break;
+  case SmmPageSize2M:
+    //
+    // BIT21 to BIT29 is Page Directory index
+    //
+    EndBit = 21;
+    PageAttribute |= (UINTN)IA32_PG_PS;
+    break;
+  case SmmPageSize1G:
+    if (!m1GPageTableSupport) {
+      DEBUG ((EFI_D_ERROR, "1-GByte pages is not supported!"));
+      ASSERT (FALSE);
+    }
+    //
+    // BIT30 to BIT38 is Page Directory Pointer Table index
+    //
+    EndBit = 30;
+    PageAttribute |= (UINTN)IA32_PG_PS;
+    break;
+  default:
+    ASSERT (FALSE);
+  }
+
+  //
+  // If execute-disable is enabled, set NX bit
+  //
+  if (mXdEnabled) {
+    PageAttribute |= IA32_PG_NX;
+  }
+
+  for (Index = 0; Index < NumOfPages; Index++) {
+    PageTable  = Pml4;
+    UpperEntry = NULL;
+    for (StartBit = 39; StartBit > EndBit; StartBit -= 9) {
+      PTIndex = BitFieldRead64 (PFAddress, StartBit, StartBit + 8);
+      if ((PageTable[PTIndex] & IA32_PG_P) == 0) {
+        //
+        // If the entry is not present, allocate one page from page pool for it
+        //
+        PageTable[PTIndex] = AllocPage () | IA32_PG_RW | IA32_PG_P;
+      } else {
+        //
+        // Save the upper entry address
+        //
+        UpperEntry = PageTable + PTIndex;
+      }
+      //
+      // BIT9 to BIT11 of entry is used to save access record,
+      // initialize value is 7
+      //
+      PageTable[PTIndex] |= (UINT64)IA32_PG_A;
+      SetAccNum (PageTable + PTIndex, 7);
+      PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & gPhyMask);
+    }
+
+    PTIndex = BitFieldRead64 (PFAddress, StartBit, StartBit + 8);
+    if ((PageTable[PTIndex] & IA32_PG_P) != 0) {
+      //
+      // Check if the entry has already existed, this issue may occur when the different
+      // size page entries created under the same entry
+      //
+      DEBUG ((EFI_D_ERROR, "PageTable = %lx, PTIndex = %x, PageTable[PTIndex] = %lx\n", PageTable, PTIndex, PageTable[PTIndex]));
+      DEBUG ((EFI_D_ERROR, "New page table overlapped with old page table!\n"));
+      ASSERT (FALSE);
+    }
+    //
+    // Fill the new entry
+    //
+    PageTable[PTIndex] = (PFAddress & gPhyMask & ~((1ull << EndBit) - 1)) |
+                         PageAttribute | IA32_PG_A | IA32_PG_RW | IA32_PG_P;
+    if (UpperEntry != NULL) {
+      SetSubEntriesNum (UpperEntry, GetSubEntriesNum (UpperEntry) + 1);
+    }
+    //
+    // Get the next page address if we need to create more page tables
+    //
+    PFAddress += (1ull << EndBit);
+  }
+}
+
+/**
+  ThePage Fault handler wrapper for SMM use.
+
+  @param  InterruptType    Defines the type of interrupt or exception that
+                           occurred on the processor.This parameter is processor architecture specific.
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+**/
+VOID
+EFIAPI
+SmiPFHandler (
+    IN EFI_EXCEPTION_TYPE   InterruptType,
+    IN EFI_SYSTEM_CONTEXT   SystemContext
+  )
+{
+  UINTN             PFAddress;
+
+  ASSERT (InterruptType == EXCEPT_IA32_PAGE_FAULT);
+
+  AcquireSpinLock (&mPFLock);
+
+  PFAddress = AsmReadCr2 ();
+
+  //
+  // If a page fault occurs in SMRAM range, it should be in a SMM stack guard page.
+  //
+  if ((FeaturePcdGet (PcdCpuSmmStackGuard)) &&
+      (PFAddress >= mCpuHotPlugData.SmrrBase) &&
+      (PFAddress < (mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize))) {
+    DEBUG ((EFI_D_ERROR, "SMM stack overflow!\n"));
+    CpuDeadLoop ();
+  }
+
+  //
+  // If a page fault occurs in SMM range
+  //
+  if ((PFAddress < mCpuHotPlugData.SmrrBase) ||
+      (PFAddress >= mCpuHotPlugData.SmrrBase + mCpuHotPlugData.SmrrSize)) {
+    if ((SystemContext.SystemContextX64->ExceptionData & IA32_PF_EC_ID) != 0) {
+      DEBUG ((EFI_D_ERROR, "Code executed on IP(0x%lx) out of SMM range after SMM is locked!\n", PFAddress));
+      DEBUG_CODE (
+        DumpModuleInfoByIp (*(UINTN *)(UINTN)SystemContext.SystemContextX64->Rsp);
+      );
+      CpuDeadLoop ();
+    }
+  }
+
+  if (FeaturePcdGet (PcdCpuSmmProfileEnable)) {
+    SmmProfilePFHandler (
+      SystemContext.SystemContextX64->Rip,
+      SystemContext.SystemContextX64->ExceptionData
+      );
+  } else {
+    SmiDefaultPFHandler ();
+  }
+
+  ReleaseSpinLock (&mPFLock);
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/Semaphore.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/Semaphore.c
new file mode 100644
index 000000000000..6dbcb086aa4d
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/Semaphore.c
@@ -0,0 +1,67 @@
+/** @file
+Semaphore mechanism to indicate to the BSP that an AP has exited SMM
+after SMBASE relocation.
+
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+extern  UINT32    mSmmRelocationOriginalAddressPtr32;
+extern  UINT32    mRebasedFlagAddr32;
+
+UINTN             mSmmRelocationOriginalAddress;
+volatile BOOLEAN  *mRebasedFlag;
+
+/**
+AP Semaphore operation in 32-bit mode while BSP runs in 64-bit mode.
+**/
+VOID
+SmmRelocationSemaphoreComplete32 (
+  VOID
+  );
+
+/**
+  Hook return address of SMM Save State so that semaphore code
+  can be executed immediately after AP exits SMM to indicate to
+  the BSP that an AP has exited SMM after SMBASE relocation.
+
+  @param[in] CpuIndex     The processor index.
+  @param[in] RebasedFlag  A pointer to a flag that is set to TRUE
+                          immediately after AP exits SMM.
+
+**/
+VOID
+SemaphoreHook (
+  IN UINTN             CpuIndex,
+  IN volatile BOOLEAN  *RebasedFlag
+  )
+{
+  SMRAM_SAVE_STATE_MAP  *CpuState;
+  UINTN                 TempValue;
+
+  mRebasedFlag       = RebasedFlag;
+  mRebasedFlagAddr32 = (UINT32)(UINTN)mRebasedFlag;
+
+  CpuState = (SMRAM_SAVE_STATE_MAP *)(UINTN)(SMM_DEFAULT_SMBASE + SMRAM_SAVE_STATE_MAP_OFFSET);
+  mSmmRelocationOriginalAddress = HookReturnFromSmm (
+                                    CpuIndex,
+                                    CpuState,
+                                    (UINT64)(UINTN)&SmmRelocationSemaphoreComplete32,
+                                    (UINT64)(UINTN)&SmmRelocationSemaphoreComplete
+                                    );
+
+  //
+  // Use temp value to fix ICC complier warning
+  //
+  TempValue = (UINTN)&mSmmRelocationOriginalAddress;
+  mSmmRelocationOriginalAddressPtr32 = (UINT32)TempValue;
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
new file mode 100644
index 000000000000..831559357f15
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
@@ -0,0 +1,217 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmiEntry.S
+#
+# Abstract:
+#
+#   Code template of the SMI handler for a particular processor
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL  ASM_PFX(gcSmiHandlerTemplate)
+ASM_GLOBAL  ASM_PFX(gcSmiHandlerSize)
+ASM_GLOBAL  ASM_PFX(gSmiCr3)
+ASM_GLOBAL  ASM_PFX(gSmiStack)
+ASM_GLOBAL  ASM_PFX(gSmbase)
+ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
+ASM_GLOBAL  ASM_PFX(gSmiHandlerIdtr)
+
+#
+# Constants relating to PROCESSOR_SMM_DESCRIPTOR
+#
+.equ            DSC_OFFSET, 0xfb00
+.equ            DSC_GDTPTR, 0x30
+.equ            DSC_GDTSIZ, 0x38
+.equ            DSC_CS, 14
+.equ            DSC_DS, 16
+.equ            DSC_SS, 18
+.equ            DSC_OTHERSEG, 20
+#
+# Constants relating to CPU State Save Area
+#
+.equ            SSM_DR6,   0xffd0
+.equ            SSM_DR7,   0xffc8
+
+.equ            PROTECT_MODE_CS, 0x08
+.equ            PROTECT_MODE_DS, 0x20
+.equ            LONG_MODE_CS, 0x38
+.equ            TSS_SEGMENT, 0x40
+.equ            GDT_SIZE, 0x50
+
+    .text
+
+ASM_PFX(gcSmiHandlerTemplate):
+
+_SmiEntryPoint:
+    #
+    # The encoding of BX in 16-bit addressing mode is the same as of RDI in 64-
+    # bit addressing mode. And that coincidence has been used in the following
+    # "64-bit like" 16-bit code. Be aware that once RDI is referenced as a
+    # base address register, it is actually BX that is referenced.
+    #
+    .byte 0xbb                          # mov bx, imm16
+    .word _GdtDesc - _SmiEntryPoint + 0x8000
+    #
+    # fix GDT descriptor
+    #
+    .byte 0x2e,0xa1                     # mov ax, cs:[offset16]
+    .word      DSC_OFFSET + DSC_GDTSIZ
+    .byte 0x48                          # dec ax
+    .byte 0x2e
+    movl    %eax, (%rdi)                # mov cs:[bx], ax
+    .byte 0x66,0x2e,0xa1                # mov eax, cs:[offset16]
+    .word      DSC_OFFSET + DSC_GDTPTR
+    .byte 0x2e
+    movw    %ax, 2(%rdi)
+    .byte 0x66,0x2e
+    lgdt    (%rdi)
+    #
+    # Patch ProtectedMode Segment
+    #
+    .byte 0xb8
+    .word PROTECT_MODE_CS
+    .byte 0x2e
+    movl    %eax, -2(%rdi)
+    #
+    # Patch ProtectedMode entry
+    #
+    .byte 0x66, 0xbf                    # mov edi, SMBASE
+ASM_PFX(gSmbase): .space 4
+    lea     ((ProtectedMode - _SmiEntryPoint) + 0x8000)(%edi), %ax
+    .byte 0x2e
+    movw    %ax, -6(%rdi)
+    #
+    # Switch into ProtectedMode
+    #
+    movq    %cr0, %rbx
+    .byte 0x66
+    andl    $0x9ffafff3, %ebx
+    .byte 0x66
+    orl     $0x00000023, %ebx
+
+    movq    %rbx, %cr0
+    .byte 0x66, 0xea
+    .space 6
+
+_GdtDesc:    .space  6
+
+ProtectedMode:
+    movw    $PROTECT_MODE_DS, %ax
+    movl    %eax, %ds
+    movl    %eax, %es
+    movl    %eax, %fs
+    movl    %eax, %gs
+    movl    %eax, %ss
+    .byte   0xbc                       # mov esp, imm32
+ASM_PFX(gSmiStack):   .space  4
+    jmp     ProtFlatMode
+
+ProtFlatMode:
+    .byte   0xb8
+ASM_PFX(gSmiCr3):    .space  4
+    movq    %rax, %cr3
+    movl    $0x668,%eax                 # as cr4.PGE is not set here, refresh cr3
+    movq    %rax, %cr4                  # in PreModifyMtrrs() to flush TLB.
+# Load TSS
+    subl    $8, %esp                    # reserve room in stack
+    sgdt    (%rsp)
+    movl    2(%rsp), %eax               # eax = GDT base
+    addl    $8, %esp
+    movl    %eax, %edx
+    addl    $GDT_SIZE, %edx
+    movb    %dl, (TSS_SEGMENT + 2)(%rax)
+    movb    %dh, (TSS_SEGMENT + 3)(%rax)
+    .byte   0xc1, 0xea, 0x10             # shr     edx, 16
+    movb    %dl, (TSS_SEGMENT + 4)(%rax)
+    movb    %dh, (TSS_SEGMENT + 7)(%rax)
+    movl    %eax, %edx
+    movb    $0x89, %dl
+    movb    %dl, (TSS_SEGMENT + 5)(%rax) # clear busy flag
+    movl    $TSS_SEGMENT, %eax
+    ltr     %ax
+
+    #
+    # Switch to LongMode
+    #
+    pushq    $LONG_MODE_CS                # push cs hardcore here
+    call     Base                         # push return address for retf later
+Base:
+    addl    $(LongMode - Base), (%rsp)  # offset for far retf, seg is the 1st arg
+    movl    $0xc0000080, %ecx
+    rdmsr
+    orb     $1,%ah
+    wrmsr
+    movq    %cr0, %rbx
+    btsl    $31, %ebx
+    movq    %rbx, %cr0
+    retf
+LongMode:                               # long mode (64-bit code) starts here
+    movabsq $ASM_PFX(gSmiHandlerIdtr), %rax
+    lidt    (%rax)
+    lea     (DSC_OFFSET)(%rdi), %ebx
+    movw    DSC_DS(%rbx), %ax
+    movl    %eax,%ds
+    movw    DSC_OTHERSEG(%rbx), %ax
+    movl    %eax,%es
+    movl    %eax,%fs
+    movl    %eax,%gs
+    movw    DSC_SS(%rbx), %ax
+    movl    %eax,%ss
+#   jmp     _SmiHandler                 ; instruction is not needed
+
+_SmiHandler:
+    movabsq $ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug)), %rax
+    cmpb    $0, (%rax)
+    jz      L1
+
+    .byte   0x48, 0x8b, 0x0d            # mov rcx, [rip + disp32]
+    .long   SSM_DR6 - (. + 4 - _SmiEntryPoint + 0x8000)
+    .byte   0x48, 0x8b, 0x15            # mov rdx, [rip + disp32]
+    .long   SSM_DR7 - (. + 4 - _SmiEntryPoint + 0x8000)
+    movq    %rcx, %dr6
+    movq    %rdx, %dr7
+L1:
+
+    movabsq $ASM_PFX(SmiRendezvous), %rax
+    movq    (%rsp), %rcx
+    # Save FP registers
+
+    subq    $0x208, %rsp
+    .byte   0x48                        # FXSAVE64
+    fxsave  (%rsp)
+
+    addq    $-0x20, %rsp
+    call    *%rax
+    addq    $0x20, %rsp
+
+    #
+    # Restore FP registers
+    #
+    .byte   0x48                        # FXRSTOR64
+    fxrstor (%rsp)
+
+    movabsq $ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug)), %rax
+    cmpb    $0, (%rax)
+    jz      L2
+
+    movq    %dr7, %rdx
+    movq    %dr6, %rcx
+    .byte   0x48, 0x89, 0x15            # mov [rip + disp32], rdx
+    .long   SSM_DR7 - (. + 4 - _SmiEntryPoint + 0x8000)
+    .byte   0x48, 0x89, 0x0d            # mov [rip + disp32], rcx
+    .long   SSM_DR6 - (. + 4 - _SmiEntryPoint + 0x8000)
+L2:
+    rsm
+
+ASM_PFX(gcSmiHandlerSize):    .word      . - _SmiEntryPoint
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
new file mode 100644
index 000000000000..c556bf5f5b28
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
@@ -0,0 +1,221 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmiEntry.asm
+;
+; Abstract:
+;
+;   Code template of the SMI handler for a particular processor
+;
+;-------------------------------------------------------------------------------
+
+;
+; Variables referenced by C code
+;
+EXTERNDEF   SmiRendezvous:PROC
+EXTERNDEF   gcSmiHandlerTemplate:BYTE
+EXTERNDEF   gcSmiHandlerSize:WORD
+EXTERNDEF   gSmiCr3:DWORD
+EXTERNDEF   gSmiStack:DWORD
+EXTERNDEF   gSmbase:DWORD
+EXTERNDEF   FeaturePcdGet (PcdCpuSmmDebug):BYTE
+EXTERNDEF   gSmiHandlerIdtr:FWORD
+
+
+;
+; Constants relating to PROCESSOR_SMM_DESCRIPTOR
+;
+DSC_OFFSET    EQU     0fb00h
+DSC_GDTPTR    EQU     30h
+DSC_GDTSIZ    EQU     38h
+DSC_CS        EQU     14
+DSC_DS        EQU     16
+DSC_SS        EQU     18
+DSC_OTHERSEG  EQU     20
+;
+; Constants relating to CPU State Save Area
+;
+SSM_DR6         EQU     0ffd0h
+SSM_DR7         EQU     0ffc8h
+
+PROTECT_MODE_CS EQU     08h
+PROTECT_MODE_DS EQU     20h
+LONG_MODE_CS    EQU     38h
+TSS_SEGMENT     EQU     40h
+GDT_SIZE        EQU     50h
+
+    .code
+
+gcSmiHandlerTemplate    LABEL   BYTE
+
+_SmiEntryPoint:
+    ;
+    ; The encoding of BX in 16-bit addressing mode is the same as of RDI in 64-
+    ; bit addressing mode. And that coincidence has been used in the following
+    ; "64-bit like" 16-bit code. Be aware that once RDI is referenced as a
+    ; base address register, it is actually BX that is referenced.
+    ;
+    DB      0bbh                        ; mov bx, imm16
+    DW      offset _GdtDesc - _SmiEntryPoint + 8000h  ; bx = GdtDesc offset
+; fix GDT descriptor
+    DB      2eh, 0a1h                   ; mov ax, cs:[offset16]
+    DW      DSC_OFFSET + DSC_GDTSIZ
+    DB      48h                         ; dec ax
+    DB      2eh
+    mov     [rdi], eax                  ; mov cs:[bx], ax
+    DB      66h, 2eh, 0a1h              ; mov eax, cs:[offset16]
+    DW      DSC_OFFSET + DSC_GDTPTR
+    DB      2eh
+    mov     [rdi + 2], ax               ; mov cs:[bx + 2], eax
+    DB      66h, 2eh
+    lgdt    fword ptr [rdi]             ; lgdt fword ptr cs:[bx]
+; Patch ProtectedMode Segment
+    DB      0b8h                        ; mov ax, imm16
+    DW      PROTECT_MODE_CS             ; set AX for segment directly
+    DB      2eh
+    mov     [rdi - 2], eax              ; mov cs:[bx - 2], ax
+; Patch ProtectedMode entry
+    DB      66h, 0bfh                   ; mov edi, SMBASE
+gSmbase    DD    ?
+    lea     ax, [edi + (@ProtectedMode - _SmiEntryPoint) + 8000h]
+    DB      2eh
+    mov     [rdi - 6], ax               ; mov cs:[bx - 6], eax
+; Switch into @ProtectedMode
+    mov     rbx, cr0
+    DB      66h
+    and     ebx, 9ffafff3h
+    DB      66h
+    or      ebx, 00000023h
+
+    mov     cr0, rbx
+    DB      66h, 0eah
+    DD      ?
+    DW      ?
+
+_GdtDesc    FWORD   ?
+@ProtectedMode:
+    mov     ax, PROTECT_MODE_DS
+    mov     ds, ax
+    mov     es, ax
+    mov     fs, ax
+    mov     gs, ax
+    mov     ss, ax
+    DB      0bch                   ; mov esp, imm32
+gSmiStack   DD      ?
+    jmp     ProtFlatMode
+
+ProtFlatMode:
+    DB      0b8h                        ; mov eax, offset gSmiCr3
+gSmiCr3     DD      ?
+    mov     cr3, rax
+    mov     eax, 668h                   ; as cr4.PGE is not set here, refresh cr3
+    mov     cr4, rax                    ; in PreModifyMtrrs() to flush TLB.
+; Load TSS
+    sub     esp, 8                      ; reserve room in stack
+    sgdt    fword ptr [rsp]
+    mov     eax, [rsp + 2]              ; eax = GDT base
+    add     esp, 8
+    mov     edx, eax
+    add     edx, GDT_SIZE
+    mov     [rax + TSS_SEGMENT + 2], dl
+    mov     [rax + TSS_SEGMENT + 3], dh
+    DB      0c1h, 0eah, 10h             ; shr     edx, 16
+    mov     [rax + TSS_SEGMENT + 4], dl
+    mov     [rax + TSS_SEGMENT + 7], dh
+    mov     edx, eax
+    mov     dl, 89h
+    mov     [rax + TSS_SEGMENT + 5], dl ; clear busy flag
+    mov     eax, TSS_SEGMENT
+    ltr     ax
+
+; Switch into @LongMode
+    push    LONG_MODE_CS                ; push cs hardcore here
+    call    Base                       ; push return address for retf later
+Base:
+    add     dword ptr [rsp], @LongMode - Base; offset for far retf, seg is the 1st arg
+    mov     ecx, 0c0000080h
+    rdmsr
+    or      ah, 1
+    wrmsr
+    mov     rbx, cr0
+    bts     ebx, 31
+    mov     cr0, rbx
+    retf
+@LongMode:                              ; long mode (64-bit code) starts here
+    mov     rax, offset gSmiHandlerIdtr
+    lidt    fword ptr [rax]
+    lea     ebx, [rdi + DSC_OFFSET]
+    mov     ax, [rbx + DSC_DS]
+    mov     ds, eax
+    mov     ax, [rbx + DSC_OTHERSEG]
+    mov     es, eax
+    mov     fs, eax
+    mov     gs, eax
+    mov     ax, [rbx + DSC_SS]
+    mov     ss, eax
+;   jmp     _SmiHandler                 ; instruction is not needed
+
+_SmiHandler:
+;
+; The following lines restore DR6 & DR7 before running C code. They are useful
+; when you want to enable hardware breakpoints in SMM.
+;
+; NOTE: These lines might not be appreciated in runtime since they might
+;       conflict with OS debugging facilities. Turn them off in RELEASE.
+;
+    mov     rax, offset FeaturePcdGet (PcdCpuSmmDebug) ;Get absolute address. Avoid RIP relative addressing
+    cmp     byte ptr [rax], 0
+    jz      @1
+
+    DB      48h, 8bh, 0dh               ; mov rcx, [rip + disp32]
+    DD      SSM_DR6 - ($ + 4 - _SmiEntryPoint + 8000h)
+    DB      48h, 8bh, 15h               ; mov rdx, [rip + disp32]
+    DD      SSM_DR7 - ($ + 4 - _SmiEntryPoint + 8000h)
+    mov     dr6, rcx
+    mov     dr7, rdx
+@1:
+    mov     rcx, [rsp]                  ; rcx <- CpuIndex
+    mov     rax, SmiRendezvous          ; rax <- absolute addr of SmiRedezvous
+
+    ;
+    ; Save FP registers
+    ;
+    sub     rsp, 208h
+    DB      48h                         ; FXSAVE64
+    fxsave  [rsp]
+
+    add     rsp, -20h
+    call    rax
+    add     rsp, 20h
+
+    ;
+    ; Restore FP registers
+    ;
+    DB      48h                         ; FXRSTOR64
+    fxrstor [rsp]
+
+    mov     rax, offset FeaturePcdGet (PcdCpuSmmDebug) ;Get absolute address. Avoid RIP relative addressing
+    cmp     byte ptr [rax], 0
+    jz      @2
+
+    mov     rdx, dr7
+    mov     rcx, dr6
+    DB      48h, 89h, 15h               ; mov [rip + disp32], rdx
+    DD      SSM_DR7 - ($ + 4 - _SmiEntryPoint + 8000h)
+    DB      48h, 89h, 0dh               ; mov [rip + disp32], rcx
+    DD      SSM_DR6 - ($ + 4 - _SmiEntryPoint + 8000h)
+@2:
+    rsm
+
+gcSmiHandlerSize    DW      $ - _SmiEntryPoint
+
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
new file mode 100644
index 000000000000..6dbcaa5b6714
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
@@ -0,0 +1,610 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmiException.S
+#
+# Abstract:
+#
+#   Exception handlers used in SM mode
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL  ASM_PFX(SmiPFHandler)
+ASM_GLOBAL  ASM_PFX(gSmiMtrrs)
+ASM_GLOBAL  ASM_PFX(gcSmiIdtr)
+ASM_GLOBAL  ASM_PFX(gcSmiGdtr)
+ASM_GLOBAL  ASM_PFX(gcPsd)
+
+    .data
+
+NullSeg:    .quad 0                     # reserved by architecture
+CodeSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+ProtModeCodeSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+ProtModeSsSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x93
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+DataSeg32:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x93
+            .byte 0xcf                  # LimitHigh
+            .byte 0                     # BaseHigh
+CodeSeg16:
+            .word -1
+            .word 0
+            .byte 0
+            .byte 0x9b
+            .byte 0x8f
+            .byte 0
+DataSeg16:
+            .word -1
+            .word 0
+            .byte 0
+            .byte 0x93
+            .byte 0x8f
+            .byte 0
+CodeSeg64:
+            .word -1                    # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x9b
+            .byte 0xaf                  # LimitHigh
+            .byte 0                     # BaseHigh
+# TSS Segment for X64 specially
+TssSeg:
+            .word TSS_DESC_SIZE         # LimitLow
+            .word 0                     # BaseLow
+            .byte 0                     # BaseMid
+            .byte 0x89
+            .byte 0xDB                  # LimitHigh
+            .byte 0                     # BaseHigh
+            .long 0                     # BaseUpper
+            .long 0                     # Reserved
+.equ  GDT_SIZE, .- NullSeg
+
+TssDescriptor:
+            .space 104, 0
+.equ  TSS_DESC_SIZE, .- TssDescriptor
+
+#
+# This structure serves as a template for all processors.
+#
+ASM_PFX(gcPsd):
+            .ascii  "PSDSIG  "
+            .word      PSD_SIZE
+            .word 2
+            .word      1 << 2
+            .word      CODE_SEL
+            .word      DATA_SEL
+            .word      DATA_SEL
+            .word      DATA_SEL
+            .word 0
+            .quad 0
+            .quad 0
+            .quad 0                     # fixed in InitializeMpServiceData()
+            .quad      NullSeg
+            .long      GDT_SIZE
+            .long 0
+            .space 24, 0
+            .quad      ASM_PFX(gSmiMtrrs)
+.equ  PSD_SIZE,  . - ASM_PFX(gcPsd)
+
+#
+# CODE & DATA segments for SMM runtime
+#
+.equ  CODE_SEL,    CodeSeg64 - NullSeg
+.equ  DATA_SEL,    DataSeg32 - NullSeg
+.equ  CODE32_SEL,  CodeSeg32 - NullSeg
+
+ASM_PFX(gcSmiGdtr):
+    .word      GDT_SIZE - 1
+    .quad      NullSeg
+
+ASM_PFX(gcSmiIdtr):
+    .word      IDT_SIZE - 1
+    .quad      _SmiIDT
+
+
+#
+# Here is the IDT. There are 32 (not 255) entries in it since only processor
+# generated exceptions will be handled.
+#
+_SmiIDT:
+# The following segment repeats 32 times:
+# No. 1
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 2
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 3
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 4
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 5
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 6
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 7
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 8
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 9
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 10
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 11
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 12
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 13
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 14
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 15
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 16
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 17
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 18
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 19
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 20
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 21
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 22
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 23
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 24
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 25
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 26
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 27
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 28
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 29
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 30
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 31
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+# No. 32
+    .word 0                             # Offset 0:15
+    .word CODE_SEL
+    .byte 0                             # Unused
+    .byte 0x8e                          # Interrupt Gate, Present
+    .word 0                             # Offset 16:31
+    .quad 0                             # Offset 32:63
+
+_SmiIDTEnd:
+
+.equ  IDT_SIZE, (_SmiIDTEnd - _SmiIDT)
+
+    .text
+
+#------------------------------------------------------------------------------
+# _SmiExceptionEntryPoints is the collection of exception entry points followed
+# by a common exception handler.
+#
+# Stack frame would be as follows as specified in IA32 manuals:
+# +---------------------+ <-- 16-byte aligned ensured by processor
+# +    Old SS           +
+# +---------------------+
+# +    Old RSP          +
+# +---------------------+
+# +    RFlags           +
+# +---------------------+
+# +    CS               +
+# +---------------------+
+# +    RIP              +
+# +---------------------+
+# +    Error Code       +
+# +---------------------+
+# +   Vector Number     +
+# +---------------------+
+# +    RBP              +
+# +---------------------+ <-- RBP, 16-byte aligned
+#
+# RSP set to odd multiple of 8 at @CommonEntryPoint means ErrCode PRESENT
+#------------------------------------------------------------------------------
+ASM_GLOBAL ASM_PFX(PageFaultIdtHandlerSmmProfile)
+ASM_PFX(PageFaultIdtHandlerSmmProfile):
+    pushq   $0x0e                    # Page Fault
+    .byte   0x40, 0xf6, 0xc4, 0x08    #test    spl, 8
+    jnz     L1
+    pushq   (%rsp)
+    movq    $0, 8(%rsp)
+L1:
+    pushq   %rbp
+    movq    %rsp, %rbp
+
+    #
+    # Since here the stack pointer is 16-byte aligned, so
+    # EFI_FX_SAVE_STATE_X64 of EFI_SYSTEM_CONTEXT_x64
+    # is 16-byte aligned
+    #
+
+## UINT64  Rdi, Rsi, Rbp, Rsp, Rbx, Rdx, Rcx, Rax;
+## UINT64  R8, R9, R10, R11, R12, R13, R14, R15;
+    pushq   %r15
+    pushq   %r14
+    pushq   %r13
+    pushq   %r12
+    pushq   %r11
+    pushq   %r10
+    pushq   %r9
+    pushq   %r8
+    pushq   %rax
+    pushq   %rcx
+    pushq   %rdx
+    pushq   %rbx
+    pushq   48(%rbp)                   # RSP
+    pushq   (%rbp)                     # RBP
+    pushq   %rsi
+    pushq   %rdi
+
+## UINT64  Gs, Fs, Es, Ds, Cs, Ss;  insure high 16 bits of each is zero
+    movzwq 56(%rbp), %rax
+    pushq   %rax                       # for ss
+    movzwq  32(%rbp), %rax
+    pushq   %rax                       # for cs
+    movq    %ds, %rax
+    pushq   %rax
+    movq    %es, %rax
+    pushq   %rax
+    movq    %fs, %rax
+    pushq   %rax
+    movq    %gs, %rax
+    pushq   %rax
+
+## UINT64  Rip;
+    pushq   24(%rbp)
+
+## UINT64  Gdtr[2], Idtr[2];
+    subq    $16, %rsp
+    sidt    (%rsp)
+    subq    $16, %rsp
+    sgdt    (%rsp)
+
+## UINT64  Ldtr, Tr;
+    xorq    %rax, %rax
+    strw    %ax
+    pushq   %rax
+    sldtw   %ax
+    pushq   %rax
+
+## UINT64  RFlags;
+    pushq   40(%rbp)
+
+## UINT64  Cr0, Cr1, Cr2, Cr3, Cr4, Cr8;
+    movq    %cr8, %rax
+    pushq   %rax
+    movq    %cr4, %rax
+    orq     $0x208, %rax
+    movq    %rax, %cr4
+    pushq   %rax
+    movq    %cr3, %rax
+    pushq   %rax
+    movq    %cr2, %rax
+    pushq   %rax
+    xorq    %rax, %rax
+    pushq   %rax
+    movq    %cr0, %rax
+    pushq   %rax
+
+## UINT64  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    movq    %dr7, %rax
+    pushq   %rax
+    movq    %dr6, %rax
+    pushq   %rax
+    movq    %dr3, %rax
+    pushq   %rax
+    movq    %dr2, %rax
+    pushq   %rax
+    movq    %dr1, %rax
+    pushq   %rax
+    movq    %dr0, %rax
+    pushq   %rax
+
+## FX_SAVE_STATE_X64 FxSaveState;
+
+    subq    $512, %rsp
+    movq    %rsp, %rdi
+    .byte   0xf, 0xae, 0x7                  # fxsave [rdi]
+
+# UEFI calling convention for x64 requires that Direction flag in EFLAGs is clear
+    cld
+
+## UINT32  ExceptionData;
+    pushq   16(%rbp)
+
+## call into exception handler
+    movq    8(%rbp), %rcx
+    movabsq $ASM_PFX(SmiPFHandler), %rax
+
+## Prepare parameter and call
+    movq    %rsp, %rdx
+    #
+    # Per X64 calling convention, allocate maximum parameter stack space
+    # and make sure RSP is 16-byte aligned
+    #
+    subq    $4 * 8 + 8, %rsp
+    call    *%rax
+    addq    $4 * 8 + 8, %rsp
+    jmp     L5
+
+L5:
+## UINT64  ExceptionData;
+    addq    $8, %rsp
+
+## FX_SAVE_STATE_X64 FxSaveState;
+
+    movq    %rsp, %rsi
+    .byte   0xf, 0xae, 0xe                 # fxrstor [rsi]
+    addq    $512, %rsp
+
+## UINT64  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+## Skip restoration of DRx registers to support debuggers
+## that set breakpoints in interrupt/exception context
+    addq    $8 * 6, %rsp
+
+## UINT64  Cr0, Cr1, Cr2, Cr3, Cr4, Cr8;
+    popq    %rax
+    movq    %rax, %cr0
+    addq    $8, %rsp                      # not for Cr1
+    popq    %rax
+    movq    %rax, %cr2
+    popq    %rax
+    movq    %rax, %cr3
+    popq    %rax
+    movq    %rax, %cr4
+    popq    %rax
+    movq    %rax, %cr8
+
+## UINT64  RFlags;
+    popq    40(%rbp)
+
+## UINT64  Ldtr, Tr;
+## UINT64  Gdtr[2], Idtr[2];
+## Best not let anyone mess with these particular registers...
+    addq    $48, %rsp
+
+## UINT64  Rip;
+    popq    24(%rbp)
+
+## UINT64  Gs, Fs, Es, Ds, Cs, Ss;
+    popq    %rax
+    # mov   gs, rax ; not for gs
+    popq    %rax
+    # mov   fs, rax ; not for fs
+    # (X64 will not use fs and gs, so we do not restore it)
+    popq    %rax
+    movq    %rax, %es
+    popq    %rax
+    movq    %rax, %ds
+    popq    32(%rbp)                      # for cs
+    popq    56(%rbp)                      # for ss
+
+## UINT64  Rdi, Rsi, Rbp, Rsp, Rbx, Rdx, Rcx, Rax;
+## UINT64  R8, R9, R10, R11, R12, R13, R14, R15;
+    popq    %rdi
+    popq    %rsi
+    addq    $8, %rsp                      # not for rbp
+    popq    48(%rbp)                      # for rsp
+    popq    %rbx
+    popq    %rdx
+    popq    %rcx
+    popq    %rax
+    popq    %r8
+    popq    %r9
+    popq    %r10
+    popq    %r11
+    popq    %r12
+    popq    %r13
+    popq    %r14
+    popq    %r15
+
+    movq    %rbp, %rsp
+
+# Enable TF bit after page fault handler runs
+    btsl    $8, 40(%rsp)                 #RFLAGS
+
+    popq    %rbp
+    addq    $16, %rsp                    # skip INT# & ErrCode
+    iretq
+
+ASM_GLOBAL ASM_PFX(InitializeIDTSmmStackGuard)
+ASM_PFX(InitializeIDTSmmStackGuard):
+# If SMM Stack Guard feature is enabled, set the IST field of
+# the interrupt gate for Page Fault Exception to be 1
+#
+    movabsq  $_SmiIDT + 14 * 16, %rax
+    movb     $1, 4(%rax)
+    ret
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
new file mode 100644
index 000000000000..3d841c654676
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
@@ -0,0 +1,413 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmiException.asm
+;
+; Abstract:
+;
+;   Exception handlers used in SM mode
+;
+;-------------------------------------------------------------------------------
+
+EXTERNDEF   SmiPFHandler:PROC
+EXTERNDEF   gSmiMtrrs:QWORD
+EXTERNDEF   gcSmiIdtr:FWORD
+EXTERNDEF   gcSmiGdtr:FWORD
+EXTERNDEF   gcPsd:BYTE
+
+    .const
+
+NullSeg     DQ      0                   ; reserved by architecture
+CodeSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+ProtModeCodeSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+ProtModeSsSeg32     LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      93h
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+DataSeg32   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      93h
+            DB      0cfh                ; LimitHigh
+            DB      0                   ; BaseHigh
+CodeSeg16   LABEL   QWORD
+            DW      -1
+            DW      0
+            DB      0
+            DB      9bh
+            DB      8fh
+            DB      0
+DataSeg16   LABEL   QWORD
+            DW      -1
+            DW      0
+            DB      0
+            DB      93h
+            DB      8fh
+            DB      0
+CodeSeg64   LABEL   QWORD
+            DW      -1                  ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      9bh
+            DB      0afh                ; LimitHigh
+            DB      0                   ; BaseHigh
+; TSS Segment for X64 specially
+TssSeg      LABEL   QWORD
+            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      0                   ; BaseLow
+            DB      0                   ; BaseMid
+            DB      89h
+            DB      080h                ; LimitHigh
+            DB      0                   ; BaseHigh
+            DD      0                   ; BaseUpper
+            DD      0                   ; Reserved
+GDT_SIZE = $ - offset NullSeg
+
+; Create TSS Descriptor just after GDT
+TssDescriptor LABEL BYTE
+            DD      0                   ; Reserved
+            DQ      0                   ; RSP0
+            DQ      0                   ; RSP1
+            DQ      0                   ; RSP2
+            DD      0                   ; Reserved
+            DD      0                   ; Reserved
+            DQ      0                   ; IST1
+            DQ      0                   ; IST2
+            DQ      0                   ; IST3
+            DQ      0                   ; IST4
+            DQ      0                   ; IST5
+            DQ      0                   ; IST6
+            DQ      0                   ; IST7
+            DD      0                   ; Reserved
+            DD      0                   ; Reserved
+            DW      0                   ; Reserved
+            DW      0                   ; I/O Map Base Address
+TSS_DESC_SIZE = $ - offset TssDescriptor
+
+;
+; This structure serves as a template for all processors.
+;
+gcPsd     LABEL   BYTE
+            DB      'PSDSIG  '
+            DW      PSD_SIZE
+            DW      2
+            DW      1 SHL 2
+            DW      CODE_SEL
+            DW      DATA_SEL
+            DW      DATA_SEL
+            DW      DATA_SEL
+            DW      0
+            DQ      0
+            DQ      0
+            DQ      0                   ; fixed in InitializeMpServiceData()
+            DQ      offset NullSeg
+            DD      GDT_SIZE
+            DD      0
+            DB      24 dup (0)
+            DQ      offset gSmiMtrrs
+PSD_SIZE  = $ - offset gcPsd
+
+;
+; CODE & DATA segments for SMM runtime
+;
+CODE_SEL    = offset CodeSeg64 - offset NullSeg
+DATA_SEL    = offset DataSeg32 - offset NullSeg
+CODE32_SEL  = offset CodeSeg32 - offset NullSeg
+
+gcSmiGdtr   LABEL   FWORD
+    DW      GDT_SIZE - 1
+    DQ      offset NullSeg
+
+gcSmiIdtr   LABEL   FWORD
+    DW      IDT_SIZE - 1
+    DQ      offset _SmiIDT
+
+    .data
+
+;
+; Here is the IDT. There are 32 (not 255) entries in it since only processor
+; generated exceptions will be handled.
+;
+_SmiIDT:
+REPEAT      32
+    DW      0                           ; Offset 0:15
+    DW      CODE_SEL                    ; Segment selector
+    DB      0                           ; Unused
+    DB      8eh                         ; Interrupt Gate, Present
+    DW      0                           ; Offset 16:31
+    DQ      0                           ; Offset 32:63
+            ENDM
+_SmiIDTEnd:
+
+IDT_SIZE = (offset _SmiIDTEnd - offset _SmiIDT)
+
+    .code
+
+;------------------------------------------------------------------------------
+; _SmiExceptionEntryPoints is the collection of exception entry points followed
+; by a common exception handler.
+;
+; Stack frame would be as follows as specified in IA32 manuals:
+;
+; +---------------------+ <-- 16-byte aligned ensured by processor
+; +    Old SS           +
+; +---------------------+
+; +    Old RSP          +
+; +---------------------+
+; +    RFlags           +
+; +---------------------+
+; +    CS               +
+; +---------------------+
+; +    RIP              +
+; +---------------------+
+; +    Error Code       +
+; +---------------------+
+; +   Vector Number     +
+; +---------------------+
+; +    RBP              +
+; +---------------------+ <-- RBP, 16-byte aligned
+;
+; RSP set to odd multiple of 8 at @CommonEntryPoint means ErrCode PRESENT
+;------------------------------------------------------------------------------
+PageFaultIdtHandlerSmmProfile    PROC
+    push    0eh                         ; Page Fault
+    test    spl, 8                      ; odd multiple of 8 => ErrCode present
+    jnz     @F
+    push    [rsp]                       ; duplicate INT# if no ErrCode
+    mov     qword ptr [rsp + 8], 0
+@@:
+    push    rbp
+    mov     rbp, rsp
+
+    ;
+    ; Since here the stack pointer is 16-byte aligned, so
+    ; EFI_FX_SAVE_STATE_X64 of EFI_SYSTEM_CONTEXT_x64
+    ; is 16-byte aligned
+    ;
+
+;; UINT64  Rdi, Rsi, Rbp, Rsp, Rbx, Rdx, Rcx, Rax;
+;; UINT64  R8, R9, R10, R11, R12, R13, R14, R15;
+    push    r15
+    push    r14
+    push    r13
+    push    r12
+    push    r11
+    push    r10
+    push    r9
+    push    r8
+    push    rax
+    push    rcx
+    push    rdx
+    push    rbx
+    push    qword ptr [rbp + 48]  ; RSP
+    push    qword ptr [rbp]       ; RBP
+    push    rsi
+    push    rdi
+
+;; UINT64  Gs, Fs, Es, Ds, Cs, Ss;  insure high 16 bits of each is zero
+    movzx   rax, word ptr [rbp + 56]
+    push    rax                      ; for ss
+    movzx   rax, word ptr [rbp + 32]
+    push    rax                      ; for cs
+    mov     rax, ds
+    push    rax
+    mov     rax, es
+    push    rax
+    mov     rax, fs
+    push    rax
+    mov     rax, gs
+    push    rax
+
+;; UINT64  Rip;
+    push    qword ptr [rbp + 24]
+
+;; UINT64  Gdtr[2], Idtr[2];
+    sub     rsp, 16
+    sidt    fword ptr [rsp]
+    sub     rsp, 16
+    sgdt    fword ptr [rsp]
+
+;; UINT64  Ldtr, Tr;
+    xor     rax, rax
+    str     ax
+    push    rax
+    sldt    ax
+    push    rax
+
+;; UINT64  RFlags;
+    push    qword ptr [rbp + 40]
+
+;; UINT64  Cr0, Cr1, Cr2, Cr3, Cr4, Cr8;
+    mov     rax, cr8
+    push    rax
+    mov     rax, cr4
+    or      rax, 208h
+    mov     cr4, rax
+    push    rax
+    mov     rax, cr3
+    push    rax
+    mov     rax, cr2
+    push    rax
+    xor     rax, rax
+    push    rax
+    mov     rax, cr0
+    push    rax
+
+;; UINT64  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+    mov     rax, dr7
+    push    rax
+    mov     rax, dr6
+    push    rax
+    mov     rax, dr3
+    push    rax
+    mov     rax, dr2
+    push    rax
+    mov     rax, dr1
+    push    rax
+    mov     rax, dr0
+    push    rax
+
+;; FX_SAVE_STATE_X64 FxSaveState;
+
+    sub rsp, 512
+    mov rdi, rsp
+    db 0fh, 0aeh, 00000111y ;fxsave [rdi]
+
+; UEFI calling convention for x64 requires that Direction flag in EFLAGs is clear
+    cld
+
+;; UINT32  ExceptionData;
+    push    qword ptr [rbp + 16]
+
+;; call into exception handler
+    mov     rcx, [rbp + 8]
+    mov     rax, SmiPFHandler
+
+;; Prepare parameter and call
+    mov     rdx, rsp
+    ;
+    ; Per X64 calling convention, allocate maximum parameter stack space
+    ; and make sure RSP is 16-byte aligned
+    ;
+    sub     rsp, 4 * 8 + 8
+    call    rax
+    add     rsp, 4 * 8 + 8
+    jmp     @F
+
+@@:
+;; UINT64  ExceptionData;
+    add     rsp, 8
+
+;; FX_SAVE_STATE_X64 FxSaveState;
+
+    mov rsi, rsp
+    db 0fh, 0aeh, 00001110y ; fxrstor [rsi]
+    add rsp, 512
+
+;; UINT64  Dr0, Dr1, Dr2, Dr3, Dr6, Dr7;
+;; Skip restoration of DRx registers to support debuggers
+;; that set breakpoints in interrupt/exception context
+  add     rsp, 8 * 6
+
+;; UINT64  Cr0, Cr1, Cr2, Cr3, Cr4, Cr8;
+    pop     rax
+    mov     cr0, rax
+    add     rsp, 8   ; not for Cr1
+    pop     rax
+    mov     cr2, rax
+    pop     rax
+    mov     cr3, rax
+    pop     rax
+    mov     cr4, rax
+    pop     rax
+    mov     cr8, rax
+
+;; UINT64  RFlags;
+    pop     qword ptr [rbp + 40]
+
+;; UINT64  Ldtr, Tr;
+;; UINT64  Gdtr[2], Idtr[2];
+;; Best not let anyone mess with these particular registers...
+    add     rsp, 48
+
+;; UINT64  Rip;
+    pop     qword ptr [rbp + 24]
+
+;; UINT64  Gs, Fs, Es, Ds, Cs, Ss;
+    pop     rax
+    ; mov     gs, rax ; not for gs
+    pop     rax
+    ; mov     fs, rax ; not for fs
+    ; (X64 will not use fs and gs, so we do not restore it)
+    pop     rax
+    mov     es, rax
+    pop     rax
+    mov     ds, rax
+    pop     qword ptr [rbp + 32]  ; for cs
+    pop     qword ptr [rbp + 56]  ; for ss
+
+;; UINT64  Rdi, Rsi, Rbp, Rsp, Rbx, Rdx, Rcx, Rax;
+;; UINT64  R8, R9, R10, R11, R12, R13, R14, R15;
+    pop     rdi
+    pop     rsi
+    add     rsp, 8               ; not for rbp
+    pop     qword ptr [rbp + 48] ; for rsp
+    pop     rbx
+    pop     rdx
+    pop     rcx
+    pop     rax
+    pop     r8
+    pop     r9
+    pop     r10
+    pop     r11
+    pop     r12
+    pop     r13
+    pop     r14
+    pop     r15
+
+    mov     rsp, rbp
+
+; Enable TF bit after page fault handler runs
+    bts     dword ptr [rsp + 40], 8  ;RFLAGS
+
+    pop     rbp
+    add     rsp, 16           ; skip INT# & ErrCode
+    iretq
+PageFaultIdtHandlerSmmProfile ENDP
+
+InitializeIDTSmmStackGuard   PROC
+;
+; If SMM Stack Guard feature is enabled, set the IST field of
+; the interrupt gate for Page Fault Exception to be 1
+;
+    lea     rax, _SmiIDT + 14 * 16
+    mov     byte ptr [rax + 4], 1
+    ret
+InitializeIDTSmmStackGuard   ENDP
+
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.S
new file mode 100644
index 000000000000..5e352f57c379
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.S
@@ -0,0 +1,141 @@
+#------------------------------------------------------------------------------
+#
+# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+# Module Name:
+#
+#   SmmInit.S
+#
+# Abstract:
+#
+#   Functions for relocating SMBASE's for all processors
+#
+#------------------------------------------------------------------------------
+
+ASM_GLOBAL   ASM_PFX(gSmmCr0)
+ASM_GLOBAL   ASM_PFX(gSmmCr3)
+ASM_GLOBAL   ASM_PFX(gSmmCr4)
+ASM_GLOBAL   ASM_PFX(gSmmJmpAddr)
+ASM_GLOBAL   ASM_PFX(gcSmmInitTemplate)
+ASM_GLOBAL   ASM_PFX(gcSmmInitSize)
+ASM_GLOBAL   ASM_PFX(mRebasedFlagAddr32)
+ASM_GLOBAL   ASM_PFX(SmmRelocationSemaphoreComplete)
+ASM_GLOBAL   ASM_PFX(SmmRelocationSemaphoreComplete32)
+ASM_GLOBAL   ASM_PFX(mSmmRelocationOriginalAddressPtr32)
+ASM_GLOBAL   ASM_PFX(gSmmInitStack)
+ASM_GLOBAL   ASM_PFX(gcSmiInitGdtr)
+
+
+    .text
+
+ASM_PFX(gcSmiInitGdtr):
+            .word      0
+            .quad      0
+
+SmmStartup:
+    .byte 0x66,0xb8                     # mov eax, imm32
+ASM_PFX(gSmmCr3):    .space     4
+    movq    %rax, %cr3
+    .byte 0x66,0x2e
+    lgdt    (ASM_PFX(gcSmiInitGdtr) - SmmStartup)(%ebp)
+    .byte 0x66,0xb8                     # mov eax, imm32
+ASM_PFX(gSmmCr4):    .space     4
+    orb     $2, %ah                     # enable XMM registers access
+    movq    %rax, %cr4
+    .byte 0x66
+    movl    $0xc0000080,%ecx            # IA32_EFER MSR
+    rdmsr
+    orb     $1,%ah                      # set LME bit
+    wrmsr
+    .byte 0x66,0xb8                     # mov eax, imm32
+ASM_PFX(gSmmCr0):    .space     4
+    movq    %rax, %cr0
+    .byte 0x66,0xea                     # far jmp to long mode
+ASM_PFX(gSmmJmpAddr): .quad      LongMode
+LongMode:                               # long-mode starts here
+    .byte 0x48,0xbc                     # mov rsp, imm64
+ASM_PFX(gSmmInitStack):  .space  8
+    andw  $0xfff0, %sp                  # make sure RSP is 16-byte aligned
+    #
+    # Accoring to X64 calling convention, XMM0~5 are volatile, we need to save
+    # them before calling C-function.
+    #
+    subq     $0x60, %rsp
+    movdqa   %xmm0, 0x0(%rsp)
+    movdqa   %xmm1, 0x10(%rsp)
+    movdqa   %xmm2, 0x20(%rsp)
+    movdqa   %xmm3, 0x30(%rsp)
+    movdqa   %xmm4, 0x40(%rsp)
+    movdqa   %xmm5, 0x50(%rsp)
+
+
+    addq  $-0x20, %rsp
+    call  ASM_PFX(SmmInitHandler)
+    addq  $0x20, %rsp
+    #
+    # Restore XMM0~5 after calling C-function.
+    #
+    movdqa  0x0(%rsp), %xmm0
+    movdqa  0x10(%rsp), %xmm1
+    movdqa  0x20(%rsp), %xmm2
+    movdqa  0x30(%rsp), %xmm3
+    movdqa  0x40(%rsp), %xmm4
+    movdqa  0x50(%rsp), %xmm5
+
+    rsm
+
+ASM_PFX(gcSmmInitTemplate):
+
+_SmmInitTemplate:
+    .byte 0x66,0x2e,0x8b,0x2e           # mov ebp, cs:[@F]
+    .word L1 - _SmmInitTemplate + 0x8000
+    .byte 0x66, 0x81, 0xed, 0, 0, 3, 0  # sub ebp, 0x30000
+    jmp     *%bp                        # jmp ebp actually
+L1:
+    .quad      SmmStartup
+
+ASM_PFX(gcSmmInitSize):   .word  . - ASM_PFX(gcSmmInitTemplate)
+
+ASM_PFX(SmmRelocationSemaphoreComplete):
+    # Create a simple stack frame to store RAX and the original RSM location
+    pushq   %rax  # Used to store return address
+    pushq   %rax
+
+    # Load the original RSM location onto stack
+    movabsq $ASM_PFX(mSmmRelocationOriginalAddress), %rax
+    movq    (%rax), %rax
+    movq    %rax, 0x08(%rsp)
+
+    # Update rebase flag
+    movabsq $ASM_PFX(mRebasedFlag), %rax
+    movq    (%rax), %rax
+    movb    $1, (%rax)
+
+    #restore RAX and return to original RSM location
+    popq    %rax
+    retq
+
+#
+# Semaphore code running in 32-bit mode
+#
+ASM_PFX(SmmRelocationSemaphoreComplete32):
+    #
+    # movb $1, ()
+    #
+    .byte   0xc6, 0x05
+ASM_PFX(mRebasedFlagAddr32):
+    .long   0
+    .byte   1
+    #
+    # jmpd ()
+    #
+    .byte   0xff, 0x25
+ASM_PFX(mSmmRelocationOriginalAddressPtr32):
+    .long   0
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.asm
new file mode 100644
index 000000000000..9182f0293a6f
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmInit.asm
@@ -0,0 +1,132 @@
+;------------------------------------------------------------------------------ ;
+; Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+; This program and the accompanying materials
+; are licensed and made available under the terms and conditions of the BSD License
+; which accompanies this distribution.  The full text of the license may be found at
+; http://opensource.org/licenses/bsd-license.php.
+;
+; THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+; WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+;
+; Module Name:
+;
+;   SmmInit.Asm
+;
+; Abstract:
+;
+;   Functions for relocating SMBASE's for all processors
+;
+;-------------------------------------------------------------------------------
+
+EXTERNDEF   SmmInitHandler:PROC
+EXTERNDEF   gSmmCr0:DWORD
+EXTERNDEF   gSmmCr3:DWORD
+EXTERNDEF   gSmmCr4:DWORD
+EXTERNDEF   gSmmJmpAddr:QWORD
+EXTERNDEF   gcSmmInitTemplate:BYTE
+EXTERNDEF   gcSmmInitSize:WORD
+EXTERNDEF   mRebasedFlag:PTR BYTE
+EXTERNDEF   mSmmRelocationOriginalAddress:QWORD
+EXTERNDEF   mRebasedFlagAddr32:DWORD
+EXTERNDEF   mSmmRelocationOriginalAddressPtr32:DWORD
+EXTERNDEF   gSmmInitStack:QWORD
+EXTERNDEF   gcSmiInitGdtr:FWORD
+
+    .code
+
+gcSmiInitGdtr   LABEL   FWORD
+            DW      0
+            DQ      0
+
+SmmStartup  PROC
+    DB      66h, 0b8h                   ; mov eax, imm32
+gSmmCr3     DD      ?
+    mov     cr3, rax
+    DB      66h, 2eh
+    lgdt    fword ptr [ebp + (offset gcSmiInitGdtr - SmmStartup)]
+    DB      66h, 0b8h                   ; mov eax, imm32
+gSmmCr4     DD      ?
+    or      ah,  2                      ; enable XMM registers access
+    mov     cr4, rax
+    DB      66h
+    mov     ecx, 0c0000080h             ; IA32_EFER MSR
+    rdmsr
+    or      ah, 1                       ; set LME bit
+    wrmsr
+    DB      66h, 0b8h                   ; mov eax, imm32
+gSmmCr0     DD      ?
+    mov     cr0, rax                    ; enable protected mode & paging
+    DB      66h, 0eah                   ; far jmp to long mode
+gSmmJmpAddr DQ      @LongMode
+@LongMode:                              ; long-mode starts here
+    DB      48h, 0bch                   ; mov rsp, imm64
+gSmmInitStack   DQ      ?
+    and     sp, 0fff0h                  ; make sure RSP is 16-byte aligned
+    ;
+    ; Accoring to X64 calling convention, XMM0~5 are volatile, we need to save
+    ; them before calling C-function.
+    ;
+    sub     rsp, 60h
+    movdqa  [rsp], xmm0
+    movdqa  [rsp + 10h], xmm1
+    movdqa  [rsp + 20h], xmm2
+    movdqa  [rsp + 30h], xmm3
+    movdqa  [rsp + 40h], xmm4
+    movdqa  [rsp + 50h], xmm5
+
+    add     rsp, -20h
+    call    SmmInitHandler
+    add     rsp, 20h
+
+    ;
+    ; Restore XMM0~5 after calling C-function.
+    ;
+    movdqa  xmm0, [rsp]
+    movdqa  xmm1, [rsp + 10h]
+    movdqa  xmm2, [rsp + 20h]
+    movdqa  xmm3, [rsp + 30h]
+    movdqa  xmm4, [rsp + 40h]
+    movdqa  xmm5, [rsp + 50h]
+
+    rsm
+SmmStartup  ENDP
+
+gcSmmInitTemplate   LABEL   BYTE
+
+_SmmInitTemplate    PROC
+    DB      66h, 2eh, 8bh, 2eh          ; mov ebp, cs:[@F]
+    DW      @L1 - _SmmInitTemplate + 8000h
+    DB      66h, 81h, 0edh, 00h, 00h, 03h, 00  ; sub ebp, 30000h
+    jmp     bp                          ; jmp ebp actually
+@L1:
+    DQ      SmmStartup
+_SmmInitTemplate    ENDP
+
+gcSmmInitSize   DW  $ - gcSmmInitTemplate
+
+SmmRelocationSemaphoreComplete PROC
+    push    rax
+    mov     rax, mRebasedFlag
+    mov     byte ptr [rax], 1
+    pop     rax
+    jmp     [mSmmRelocationOriginalAddress]
+SmmRelocationSemaphoreComplete ENDP
+
+;
+; Semaphore code running in 32-bit mode
+;
+SmmRelocationSemaphoreComplete32 PROC
+    ;
+    ; mov byte ptr [], 1
+    ;
+    db      0c6h, 05h
+mRebasedFlagAddr32    dd      0
+    db      1
+    ;
+    ; jmp dword ptr []
+    ;
+    db      0ffh, 25h
+mSmmRelocationOriginalAddressPtr32    dd      0
+SmmRelocationSemaphoreComplete32 ENDP
+
+    END
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
new file mode 100644
index 000000000000..c4ec12debb1c
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
@@ -0,0 +1,316 @@
+/** @file
+X64 processor specific functions to enable SMM profile.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+#include "SmmProfileInternal.h"
+
+//
+// Current page index.
+//
+UINTN                     mPFPageIndex;
+
+//
+// Pool for dynamically creating page table in page fault handler.
+//
+UINT64                    mPFPageBuffer;
+
+//
+// Store the uplink information for each page being used.
+//
+UINT64                    *mPFPageUplink[MAX_PF_PAGE_COUNT];
+
+/**
+  Create SMM page table for S3 path.
+
+**/
+VOID
+InitSmmS3Cr3 (
+  VOID
+  )
+{
+  EFI_PHYSICAL_ADDRESS              Pages;
+  UINT64                            *PTEntry;
+
+  //
+  // Generate PAE page table for the first 4GB memory space
+  //
+  Pages = Gen4GPageTable (1);
+
+  //
+  // Fill Page-Table-Level4 (PML4) entry
+  //
+  PTEntry = (UINT64*)(UINTN)(Pages - EFI_PAGES_TO_SIZE (1));
+  *PTEntry = Pages + IA32_PG_P;
+  ZeroMem (PTEntry + 1, EFI_PAGE_SIZE - sizeof (*PTEntry));
+
+  //
+  // Return the address of PML4 (to set CR3)
+  //
+  mSmmS3ResumeState->SmmS3Cr3 = (UINT32)(UINTN)PTEntry;
+
+  return ;
+}
+
+/**
+  Allocate pages for creating 4KB-page based on 2MB-page when page fault happens.
+
+**/
+VOID
+InitPagesForPFHandler (
+  VOID
+  )
+{
+  VOID          *Address;
+
+  //
+  // Pre-Allocate memory for page fault handler
+  //
+  Address = NULL;
+  Address = AllocatePages (MAX_PF_PAGE_COUNT);
+  ASSERT_EFI_ERROR (Address != NULL);
+
+  mPFPageBuffer =  (UINT64)(UINTN) Address;
+  mPFPageIndex = 0;
+  ZeroMem ((VOID *) (UINTN) mPFPageBuffer, EFI_PAGE_SIZE * MAX_PF_PAGE_COUNT);
+  ZeroMem (mPFPageUplink, sizeof (mPFPageUplink));
+
+  return;
+}
+
+/**
+  Allocate one page for creating 4KB-page based on 2MB-page.
+
+  @param  Uplink   The address of Page-Directory entry.
+
+**/
+VOID
+AcquirePage (
+  UINT64          *Uplink
+  )
+{
+  UINT64          Address;
+
+  //
+  // Get the buffer
+  //
+  Address = mPFPageBuffer + EFI_PAGES_TO_SIZE (mPFPageIndex);
+  ZeroMem ((VOID *) (UINTN) Address, EFI_PAGE_SIZE);
+
+  //
+  // Cut the previous uplink if it exists and wasn't overwritten
+  //
+  if ((mPFPageUplink[mPFPageIndex] != NULL) && ((*mPFPageUplink[mPFPageIndex] & PHYSICAL_ADDRESS_MASK) == Address)) {
+    *mPFPageUplink[mPFPageIndex] = 0;
+  }
+
+  //
+  // Link & Record the current uplink
+  //
+  *Uplink = Address | IA32_PG_P | IA32_PG_RW;
+  mPFPageUplink[mPFPageIndex] = Uplink;
+
+  mPFPageIndex = (mPFPageIndex + 1) % MAX_PF_PAGE_COUNT;
+}
+
+/**
+  Update page table to map the memory correctly in order to make the instruction
+  which caused page fault execute successfully. And it also save the original page
+  table to be restored in single-step exception.
+
+  @param  PageTable           PageTable Address.
+  @param  PFAddress           The memory address which caused page fault exception.
+  @param  CpuIndex            The index of the processor.
+  @param  ErrorCode           The Error code of exception.
+  @param  IsValidPFAddress    The flag indicates if SMM profile data need be added.
+
+**/
+VOID
+RestorePageTableAbove4G (
+  UINT64        *PageTable,
+  UINT64        PFAddress,
+  UINTN         CpuIndex,
+  UINTN         ErrorCode,
+  BOOLEAN       *IsValidPFAddress
+  )
+{
+  UINTN         PTIndex;
+  UINT64        Address;
+  BOOLEAN       Nx;
+  BOOLEAN       Existed;
+  UINTN         Index;
+  UINTN         PFIndex;
+
+  ASSERT ((PageTable != NULL) && (IsValidPFAddress != NULL));
+
+  //
+  // If page fault address is 4GB above.
+  //
+
+  //
+  // Check if page fault address has existed in page table.
+  // If it exists in page table but page fault is generated,
+  // there are 2 possible reasons: 1. present flag is set to 0; 2. instruction fetch in protected memory range.
+  //
+  Existed = FALSE;
+  PageTable = (UINT64*)(AsmReadCr3 () & PHYSICAL_ADDRESS_MASK);
+  PTIndex = BitFieldRead64 (PFAddress, 39, 47);
+  if ((PageTable[PTIndex] & IA32_PG_P) != 0) {
+    // PML4E
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+    PTIndex = BitFieldRead64 (PFAddress, 30, 38);
+    if ((PageTable[PTIndex] & IA32_PG_P) != 0) {
+      // PDPTE
+      PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+      PTIndex = BitFieldRead64 (PFAddress, 21, 29);
+      // PD
+      if ((PageTable[PTIndex] & IA32_PG_PS) != 0) {
+        //
+        // 2MB page
+        //
+        Address = (UINT64)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+        if ((Address & PHYSICAL_ADDRESS_MASK & ~((1ull << 21) - 1)) == ((PFAddress & PHYSICAL_ADDRESS_MASK & ~((1ull << 21) - 1)))) {
+          Existed = TRUE;
+        }
+      } else {
+        //
+        // 4KB page
+        //
+        PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+        if (PageTable != 0) {
+          //
+          // When there is a valid entry to map to 4KB page, need not create a new entry to map 2MB.
+          //
+          PTIndex = BitFieldRead64 (PFAddress, 12, 20);
+          Address = (UINT64)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+          if ((Address & PHYSICAL_ADDRESS_MASK & ~((1ull << 12) - 1)) == (PFAddress & PHYSICAL_ADDRESS_MASK & ~((1ull << 12) - 1))) {
+            Existed = TRUE;
+          }
+        }
+      }
+    }
+  }
+
+  //
+  // If page entry does not existed in page table at all, create a new entry.
+  //
+  if (!Existed) {
+
+    if (IsAddressValid (PFAddress, &Nx)) {
+      //
+      // If page fault address above 4GB is in protected range but it causes a page fault exception,
+      // Will create a page entry for this page fault address, make page table entry as present/rw and execution-disable.
+      // this access is not saved into SMM profile data.
+      //
+      *IsValidPFAddress = TRUE;
+    }
+
+    //
+    // Create one entry in page table for page fault address.
+    //
+    SmiDefaultPFHandler ();
+    //
+    // Find the page table entry created just now.
+    //
+    PageTable = (UINT64*)(AsmReadCr3 () & PHYSICAL_ADDRESS_MASK);
+    PFAddress = AsmReadCr2 ();
+    // PML4E
+    PTIndex = BitFieldRead64 (PFAddress, 39, 47);
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+    // PDPTE
+    PTIndex = BitFieldRead64 (PFAddress, 30, 38);
+    PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+    // PD
+    PTIndex = BitFieldRead64 (PFAddress, 21, 29);
+    Address = PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK;
+    //
+    // Check if 2MB-page entry need be changed to 4KB-page entry.
+    //
+    if (IsAddressSplit (Address)) {
+      AcquirePage (&PageTable[PTIndex]);
+
+      // PTE
+      PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
+      for (Index = 0; Index < 512; Index++) {
+        PageTable[Index] = Address | IA32_PG_RW | IA32_PG_P;
+        if (!IsAddressValid (Address, &Nx)) {
+          PageTable[Index] = PageTable[Index] & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+        }
+        if (Nx && mXdSupported) {
+          PageTable[Index] = PageTable[Index] | IA32_PG_NX;
+        }
+        if (Address == (PFAddress & PHYSICAL_ADDRESS_MASK & ~((1ull << 12) - 1))) {
+          PTIndex = Index;
+        }
+        Address += SIZE_4KB;
+      } // end for PT
+    } else {
+      //
+      // Update 2MB page entry.
+      //
+      if (!IsAddressValid (Address, &Nx)) {
+        //
+        // Patch to remove present flag and rw flag.
+        //
+        PageTable[PTIndex] = PageTable[PTIndex] & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+      }
+      //
+      // Set XD bit to 1
+      //
+      if (Nx && mXdSupported) {
+        PageTable[PTIndex] = PageTable[PTIndex] | IA32_PG_NX;
+      }
+    }
+  }
+
+  //
+  // Record old entries with non-present status
+  // Old entries include the memory which instruction is at and the memory which instruction access.
+  //
+  //
+  ASSERT (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT);
+  if (mPFEntryCount[CpuIndex] < MAX_PF_ENTRY_COUNT) {
+    PFIndex = mPFEntryCount[CpuIndex];
+    mLastPFEntryValue[CpuIndex][PFIndex]   = PageTable[PTIndex];
+    mLastPFEntryPointer[CpuIndex][PFIndex] = &PageTable[PTIndex];
+    mPFEntryCount[CpuIndex]++;
+  }
+
+  //
+  // Add present flag or clear XD flag to make page fault handler succeed.
+  //
+  PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+  if ((ErrorCode & IA32_PF_EC_ID) != 0) {
+    //
+    // If page fault is caused by instruction fetch, clear XD bit in the entry.
+    //
+    PageTable[PTIndex] &= ~IA32_PG_NX;
+  }
+
+  return;
+}
+
+/**
+  Clear TF in FLAGS.
+
+  @param  SystemContext    A pointer to the processor context when
+                           the interrupt occurred on the processor.
+
+**/
+VOID
+ClearTrapFlag (
+  IN OUT EFI_SYSTEM_CONTEXT   SystemContext
+  )
+{
+  SystemContext.SystemContextX64->Rflags &= (UINTN) ~BIT8;
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.h b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.h
new file mode 100644
index 000000000000..32f33139bfc9
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.h
@@ -0,0 +1,105 @@
+/** @file
+X64 processor specific header file to enable SMM profile.
+
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SMM_PROFILE_ARCH_H_
+#define _SMM_PROFILE_ARCH_H_
+
+#pragma pack (1)
+
+typedef struct _MSR_DS_AREA_STRUCT {
+  UINT64  BTSBufferBase;
+  UINT64  BTSIndex;
+  UINT64  BTSAbsoluteMaximum;
+  UINT64  BTSInterruptThreshold;
+  UINT64  PEBSBufferBase;
+  UINT64  PEBSIndex;
+  UINT64  PEBSAbsoluteMaximum;
+  UINT64  PEBSInterruptThreshold;
+  UINT64  PEBSCounterReset[2];
+  UINT64  Reserved;
+} MSR_DS_AREA_STRUCT;
+
+typedef struct _BRANCH_TRACE_RECORD {
+  UINT64  LastBranchFrom;
+  UINT64  LastBranchTo;
+  UINT64  Rsvd0 : 4;
+  UINT64  BranchPredicted : 1;
+  UINT64  Rsvd1 : 59;
+} BRANCH_TRACE_RECORD;
+
+typedef struct _PEBS_RECORD {
+  UINT64  Rflags;
+  UINT64  LinearIP;
+  UINT64  Rax;
+  UINT64  Rbx;
+  UINT64  Rcx;
+  UINT64  Rdx;
+  UINT64  Rsi;
+  UINT64  Rdi;
+  UINT64  Rbp;
+  UINT64  Rsp;
+  UINT64  R8;
+  UINT64  R9;
+  UINT64  R10;
+  UINT64  R11;
+  UINT64  R12;
+  UINT64  R13;
+  UINT64  R14;
+  UINT64  R15;
+} PEBS_RECORD;
+
+#pragma pack ()
+
+#define PHYSICAL_ADDRESS_MASK       ((1ull << 52) - SIZE_4KB)
+
+/**
+  Update page table to map the memory correctly in order to make the instruction
+  which caused page fault execute successfully. And it also save the original page
+  table to be restored in single-step exception.
+
+  @param  PageTable           PageTable Address.
+  @param  PFAddress           The memory address which caused page fault exception.
+  @param  CpuIndex            The index of the processor.
+  @param  ErrorCode           The Error code of exception.
+  @param  IsValidPFAddress    The flag indicates if SMM profile data need be added.
+
+**/
+VOID
+RestorePageTableAbove4G (
+  UINT64        *PageTable,
+  UINT64        PFAddress,
+  UINTN         CpuIndex,
+  UINTN         ErrorCode,
+  BOOLEAN       *IsValidPFAddress
+  );
+
+/**
+  Create SMM page table for S3 path.
+
+**/
+VOID
+InitSmmS3Cr3 (
+  VOID
+  );
+
+/**
+  Allocate pages for creating 4KB-page based on 2MB-page when page fault happens.
+
+**/
+VOID
+InitPagesForPFHandler (
+  VOID
+  );
+
+#endif // _SMM_PROFILE_ARCH_H_

From 41edf829e9f98d3947bb614ce7fabc51f2cc74d9 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:07:49 +0000
Subject: [PATCH 127/525] UefiCpuPkg: Add PiSmmCpuDxeSmm module to DSC file

Add the PiSmmCpuDxeSmm module to the UefiCpuPkg DSC file along
with this modules dependent libraries.

(Sync patch r18648 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18843 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.dsc | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 961c970418d6..10197d4c876c 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -32,7 +32,7 @@
   BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
   CpuLib|MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
   DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
-  SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf  
+  SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
   DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
   DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
   UefiCpuLib|UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.inf
@@ -54,6 +54,10 @@
   ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseReportStatusCodeLibNull.inf
   SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
   SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
+  CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
+  SmmLib|MdePkg/Library/SmmLibNull/SmmLibNull.inf
+  PciLib|MdePkg/Library/BasePciLibPciExpress/BasePciLibPciExpress.inf
+  PciExpressLib|MdePkg/Library/BasePciExpressLib/BasePciExpressLib.inf
   SmmCpuPlatformHookLib|UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
   SmmCpuFeaturesLib|UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
@@ -62,7 +66,7 @@
 [LibraryClasses.common.SEC]
   PlatformSecLib|UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
   CpuExceptionHandlerLib|UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
-  
+
 [LibraryClasses.common.PEIM]
   MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
   HobLib|MdePkg/Library/PeiHobLib/PeiHobLib.inf
@@ -95,20 +99,21 @@
   UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/SecPeiDxeTimerLibUefiCpu.inf
 
 [Components.IA32, Components.X64]
-  UefiCpuPkg/CpuMpPei/CpuMpPei.inf
   UefiCpuPkg/CpuDxe/CpuDxe.inf
   UefiCpuPkg/CpuIo2Smm/CpuIo2Smm.inf
+  UefiCpuPkg/CpuMpPei/CpuMpPei.inf
   UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.inf
-  UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
-  UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.inf
   UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.inf
-  UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
+  UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.inf
+  UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.inf
   UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
+  UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
   UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.inf
   UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf
   UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.inf
   UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.inf
   UefiCpuPkg/SecCore/SecCore.inf
+  UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
   UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.inf

From 86e35c4168b5407b61f9fd53e2092dcb59926d01 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:09:20 +0000
Subject: [PATCH 128/525] UefiCpuPkg: PiSmmCpuDxeSmm: Remove unused references
 to SmmLib

The PiSmmCpuDxeSmm module does not use any services from the SmmLib.
This change removes the SmmLib from PiSmmCpuDxeSmm module and also
removes the lib mapping in the UefiCpuPkg DSC file because no other
modules in the UefiCpuPkg use the SmmLib.

Removal of SmmLib is now possible because the only API call to it,
ClearSmi(), was ultimately removed from PiSmmCpuDxeSmm -- see the
"BUGBUG" comment in git commit 529a5a86.

(Sync patch r18673 from main trunk.)

Cc: "Yao, Jiewen" <jiewen.yao@intel.com>
Cc: Jeff Fan <jeff.fan@intel.com>

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: "Yao, Jiewen" <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18844 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h   | 1 -
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf | 1 -
 UefiCpuPkg/UefiCpuPkg.dsc                    | 1 -
 3 files changed, 3 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index 9ea11894cdd5..162bdadf0bce 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -30,7 +30,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/BaseLib.h>
 #include <Library/IoLib.h>
 #include <Library/TimerLib.h>
-#include <Library/SmmLib.h>
 #include <Library/SynchronizationLib.h>
 #include <Library/DebugLib.h>
 #include <Library/BaseMemoryLib.h>
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
index 45ab16c07f2b..f559947ee420 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
@@ -101,7 +101,6 @@
   SynchronizationLib
   BaseMemoryLib
   MtrrLib
-  SmmLib
   IoLib
   TimerLib
   SmmServicesTableLib
diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 10197d4c876c..756645f728d4 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -55,7 +55,6 @@
   SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
   SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
   CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
-  SmmLib|MdePkg/Library/SmmLibNull/SmmLibNull.inf
   PciLib|MdePkg/Library/BasePciLibPciExpress/BasePciLibPciExpress.inf
   PciExpressLib|MdePkg/Library/BasePciExpressLib/BasePciExpressLib.inf
   SmmCpuPlatformHookLib|UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.inf

From e5240a6e42757b8637c8c56589f3978c6d4a7e41 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:10:07 +0000
Subject: [PATCH 129/525] UefiCpuPkg: PiSmmCpuDxeSmm: Replace PcdSet## with
 PcdSet##S

PcdSet## has no error status returned, then the caller has no idea about
whether the set operation is successful or not.  PcdSet##S were added to
return error status and PcdSet## APIs were put in ifndef
DISABLE_NEW_DEPRECATED_INTERFACES condition.  To adopt PcdSet##S and
further code development with DISABLE_NEW_DEPRECATED_INTERFACES defined,
we need to Replace PcdSet## usage with PcdSet##S.

Normally, DynamicDefault PCD set is expected to be success, but DynamicHii
PCD set failure is a legal case.  So for DynamicDefault, we add assert
when set failure. For DynamicHii, we add logic to handle it.

(Sync patch r18686 from main trunk.)

Cc: "Yao, Jiewen" <jiewen.yao@intel.com>
Cc: Jeff Fan <jeff.fan@intel.com>

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18845 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index 0e39173cbbe8..e210c8d44659 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -1140,7 +1140,8 @@ PiCpuSmmEntry (
   // Expose address of CPU Hot Plug Data structure if CPU hot plug is supported.
   //
   if (FeaturePcdGet (PcdCpuHotPlugSupport)) {
-    PcdSet64 (PcdCpuHotPlugDataAddress, (UINT64)(UINTN)&mCpuHotPlugData);
+    Status = PcdSet64S (PcdCpuHotPlugDataAddress, (UINT64)(UINTN)&mCpuHotPlugData);
+    ASSERT_EFI_ERROR (Status);
   }
 
   //

From a8f7592e4e1ae1f80f6ee847a91c7012ea3073cc Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:10:45 +0000
Subject: [PATCH 130/525] UefiCpuPkg: SmmCpuFeaturesLib: Add
 MSR_SMM_FEATURE_CONTROL support

Add support for the reading and writing MSR_SMM_FEATURE_CONTROL
through the SmmCpuFeaturesIsSmmRegisterSupported(),
SmmCpuFeaturesGetSmmRegister(), and SmmCpuFeaturesSetSmmRegister()
functions.  This MSR is supported if the Family/Model is 06_3C,
06_45, or 06_46.

(Sync patch r18690 from main trunk.)

Cc: "Yao, Jiewen" <jiewen.yao@intel.com>
Cc: Jeff Fan <jeff.fan@intel.com>

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: "Yao, Jiewen" <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18846 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.c     | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
index 4f2f9b65fa37..0c1610d9777c 100644
--- a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
+++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
@@ -33,12 +33,18 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define  SMM_FEATURES_LIB_IA32_CORE_SMRR_PHYSMASK  0x0A1
 #define    EFI_MSR_SMRR_MASK                       0xFFFFF000
 #define    EFI_MSR_SMRR_PHYS_MASK_VALID            BIT11
+#define  SMM_FEATURES_LIB_SMM_FEATURE_CONTROL      0x4E0
 
 //
 // Set default value to assume SMRR is not supported
 //
 BOOLEAN  mSmrrSupported = FALSE;
 
+//
+// Set default value to assume MSR_SMM_FEATURE_CONTROL is not supported
+//
+BOOLEAN  mSmmFeatureControlSupported = FALSE;
+
 //
 // Set default value to assume IA-32 Architectural MSRs are used
 //
@@ -125,6 +131,20 @@ SmmCpuFeaturesLibConstructor (
     }
   }
 
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 35.10.1 MSRs in 4th Generation Intel(R) Core(TM)
+  // Processor Family
+  //
+  // If CPU Family/Model is 06_3C, 06_45, or 06_46 then use 4th Generation
+  // Intel(R) Core(TM) Processor Family MSRs
+  //
+  if (FamilyId == 0x06) {
+    if (ModelId == 0x3C || ModelId == 0x45 || ModelId == 0x46) {
+      mSmmFeatureControlSupported = TRUE;
+    }
+  }
+
   //
   // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
   // Volume 3C, Section 34.4.2 SMRAM Caching
@@ -457,6 +477,9 @@ SmmCpuFeaturesIsSmmRegisterSupported (
   IN SMM_REG_NAME  RegName
   )
 {
+  if (mSmmFeatureControlSupported && RegName == SmmRegFeatureControl) {
+    return TRUE;
+  }
   return FALSE;
 }
 
@@ -479,6 +502,9 @@ SmmCpuFeaturesGetSmmRegister (
   IN SMM_REG_NAME  RegName
   )
 {
+  if (mSmmFeatureControlSupported && RegName == SmmRegFeatureControl) {
+    return AsmReadMsr64 (SMM_FEATURES_LIB_SMM_FEATURE_CONTROL);
+  }
   return 0;
 }
 
@@ -501,6 +527,9 @@ SmmCpuFeaturesSetSmmRegister (
   IN UINT64        Value
   )
 {
+  if (mSmmFeatureControlSupported && RegName == SmmRegFeatureControl) {
+    AsmWriteMsr64 (SMM_FEATURES_LIB_SMM_FEATURE_CONTROL, Value);
+  }
 }
 
 /**

From 0d0f9ed1cd6416299b9717d2820914fec7e5e0f1 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:11:24 +0000
Subject: [PATCH 131/525] UefiCpuPkg: CpuDxe: Update GDT to be consistent with
 DxeIplPeim

The PiSmmCpuDxeSmm module makes some assumptions about GDT selectors
that are based on the GDT layout from the DxeIplPeim.  For example,
the protected mode entry code and (where appropriate) the long mode
entry code in the UefiCpuPkg/PiSmmCpuDxeSmm/*/MpFuncs.* assembly
files, which are used during S3 resume, open-code segment selector
values that depend on DxeIplPeim's GDT layout.

This updates the CpuDxe module to use the same GDT layout as the
DxeIplPeim.  This enables modules that are dispatched after
CpuDxe to find, and potentially save and restore, a GDT layout that
matches that of DxeIplPeim.  The DxeIplPeim has a 2 GDT entries for
data selectors that are identical.  These are LINEAR_SEL (GDT Offset
0x08)and LINEAR_DATA64_SEL (GDT offset 0x30).  LINEAL_SEL is used for
for IA32 DXE and the LINEAR_DATA64_SEL is used for X64 DXE. This
duplicate data selector was added to the CpuDxe module to keep the
GDT and all selectors consistent.

Using a consistent GDT also improves debug experience.

(Sync patch r18710 from main trunk.)

Reported-by: Laszlo Ersek <lersek@redhat.com>
Analyzed-by: Laszlo Ersek <lersek@redhat.com>
Link: http://article.gmane.org/gmane.comp.bios.edk2.devel/3568
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18847 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuDxe/CpuGdt.c | 83 +++++++++++++++++++++-----------------
 UefiCpuPkg/CpuDxe/CpuGdt.h | 10 +++--
 2 files changed, 53 insertions(+), 40 deletions(-)

diff --git a/UefiCpuPkg/CpuDxe/CpuGdt.c b/UefiCpuPkg/CpuDxe/CpuGdt.c
index 35a87a6e453e..9ef2fdfefbcb 100644
--- a/UefiCpuPkg/CpuDxe/CpuGdt.c
+++ b/UefiCpuPkg/CpuDxe/CpuGdt.c
@@ -2,7 +2,7 @@
   C based implemention of IA32 interrupt handling only
   requiring a minimal assembly interrupt entry point.
 
-  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -35,10 +35,10 @@ STATIC GDT_ENTRIES GdtTemplate = {
   // LINEAR_SEL
   //
   {
-    0x0FFFF,        // limit 0xFFFFF
-    0x0,            // base 0
-    0x0,
-    0x092,          // present, ring 0, data, expand-up, writable
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x092,          // present, ring 0, data, read/write
     0x0CF,          // page-granular, 32-bit
     0x0,
   },
@@ -46,10 +46,10 @@ STATIC GDT_ENTRIES GdtTemplate = {
   // LINEAR_CODE_SEL
   //
   {
-    0x0FFFF,        // limit 0xFFFFF
-    0x0,            // base 0
-    0x0,
-    0x09A,          // present, ring 0, data, expand-up, writable
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x09F,          // present, ring 0, code, execute/read, conforming, accessed
     0x0CF,          // page-granular, 32-bit
     0x0,
   },
@@ -57,10 +57,10 @@ STATIC GDT_ENTRIES GdtTemplate = {
   // SYS_DATA_SEL
   //
   {
-    0x0FFFF,        // limit 0xFFFFF
-    0x0,            // base 0
-    0x0,
-    0x092,          // present, ring 0, data, expand-up, writable
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x093,          // present, ring 0, data, read/write, accessed
     0x0CF,          // page-granular, 32-bit
     0x0,
   },
@@ -68,45 +68,56 @@ STATIC GDT_ENTRIES GdtTemplate = {
   // SYS_CODE_SEL
   //
   {
-    0x0FFFF,        // limit 0xFFFFF
-    0x0,            // base 0
-    0x0,
-    0x09A,          // present, ring 0, data, expand-up, writable
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x09A,          // present, ring 0, code, execute/read
     0x0CF,          // page-granular, 32-bit
     0x0,
   },
   //
-  // LINEAR_CODE64_SEL
+  // SPARE4_SEL
   //
   {
-    0x0FFFF,        // limit 0xFFFFF
-    0x0,            // base 0
-    0x0,
-    0x09B,          // present, ring 0, code, expand-up, writable
-    0x0AF,          // LimitHigh (CS.L=1, CS.D=0)
-    0x0,            // base (high)
+    0x0,            // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x0,            // type
+    0x0,            // limit 19:16, flags
+    0x0,            // base 31:24
   },
   //
-  // SPARE4_SEL
+  // LINEAR_DATA64_SEL
   //
   {
-    0x0,            // limit 0
-    0x0,            // base 0
-    0x0,
-    0x0,            // present, ring 0, data, expand-up, writable
-    0x0,            // page-granular, 32-bit
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x092,          // present, ring 0, data, read/write
+    0x0CF,          // page-granular, 32-bit
     0x0,
   },
   //
+  // LINEAR_CODE64_SEL
+  //
+  {
+    0x0FFFF,        // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x09A,          // present, ring 0, code, execute/read
+    0x0AF,          // page-granular, 64-bit code
+    0x0,            // base (high)
+  },
+  //
   // SPARE5_SEL
   //
   {
-    0x0,            // limit 0
-    0x0,            // base 0
-    0x0,
-    0x0,            // present, ring 0, data, expand-up, writable
-    0x0,            // page-granular, 32-bit
-    0x0,
+    0x0,            // limit 15:0
+    0x0,            // base 15:0
+    0x0,            // base 23:16
+    0x0,            // type
+    0x0,            // limit 19:16, flags
+    0x0,            // base 31:24
   },
 };
 
diff --git a/UefiCpuPkg/CpuDxe/CpuGdt.h b/UefiCpuPkg/CpuDxe/CpuGdt.h
index 7ecec5d5d9f7..2a007516024b 100644
--- a/UefiCpuPkg/CpuDxe/CpuGdt.h
+++ b/UefiCpuPkg/CpuDxe/CpuGdt.h
@@ -2,7 +2,7 @@
   C based implemention of IA32 interrupt handling only
   requiring a minimal assembly interrupt entry point.
 
-  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -42,8 +42,9 @@ struct _GDT_ENTRIES {
   GDT_ENTRY LinearCode;
   GDT_ENTRY SysData;
   GDT_ENTRY SysCode;
-  GDT_ENTRY LinearCode64;
   GDT_ENTRY Spare4;
+  GDT_ENTRY LinearData64;
+  GDT_ENTRY LinearCode64;
   GDT_ENTRY Spare5;
 } GDT_ENTRIES;
 
@@ -54,8 +55,9 @@ struct _GDT_ENTRIES {
 #define LINEAR_CODE_SEL   OFFSET_OF (GDT_ENTRIES, LinearCode)
 #define SYS_DATA_SEL      OFFSET_OF (GDT_ENTRIES, SysData)
 #define SYS_CODE_SEL      OFFSET_OF (GDT_ENTRIES, SysCode)
-#define LINEAR_CODE64_SEL OFFSET_OF (GDT_ENTRIES, LinearCode64)
 #define SPARE4_SEL        OFFSET_OF (GDT_ENTRIES, Spare4)
+#define LINEAR_DATA64_SEL OFFSET_OF (GDT_ENTRIES, LinearData64)
+#define LINEAR_CODE64_SEL OFFSET_OF (GDT_ENTRIES, LinearCode64)
 #define SPARE5_SEL        OFFSET_OF (GDT_ENTRIES, Spare5)
 
 #if defined (MDE_CPU_IA32)
@@ -63,7 +65,7 @@ struct _GDT_ENTRIES {
 #define CPU_DATA_SEL LINEAR_SEL
 #elif defined (MDE_CPU_X64)
 #define CPU_CODE_SEL LINEAR_CODE64_SEL
-#define CPU_DATA_SEL LINEAR_SEL
+#define CPU_DATA_SEL LINEAR_DATA64_SEL
 #else
 #error CPU type not supported for CPU GDT initialization!
 #endif

From b6f16ba332354607f73f5cb871ec0907d5923070 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:12:32 +0000
Subject: [PATCH 132/525] UefiCpuPkg: LocalApicLib: Add API to set
 SoftwareEnable bit

The LocalApicLib does not provide a function to manage the state of the
Local APIC SoftwareEnable bit in the Spurious Vector register.  There
are cases where this bit needs to be managed without side effects to.
other Local APIC registers.  One use case is in the DebugAgent in the
SourceLevelDebugPkg.

(Sync patch r18711 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18848 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Library/LocalApicLib.h     | 16 +++++++-
 .../Library/BaseXApicLib/BaseXApicLib.c       | 38 +++++++++++++++++--
 .../BaseXApicX2ApicLib/BaseXApicX2ApicLib.c   | 38 +++++++++++++++++--
 3 files changed, 83 insertions(+), 9 deletions(-)

diff --git a/UefiCpuPkg/Include/Library/LocalApicLib.h b/UefiCpuPkg/Include/Library/LocalApicLib.h
index b92b99e11519..cd4e613ef5f8 100644
--- a/UefiCpuPkg/Include/Library/LocalApicLib.h
+++ b/UefiCpuPkg/Include/Library/LocalApicLib.h
@@ -4,7 +4,7 @@
   Local APIC library assumes local APIC is enabled. It does not
   handles cases where local APIC is disabled.
 
-  Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -227,6 +227,20 @@ SendInitSipiSipiAllExcludingSelf (
   IN UINT32          StartupRoutine
   );
 
+/**
+  Initialize the state of the SoftwareEnable bit in the Local APIC
+  Spurious Interrupt Vector register.
+
+  @param  Enable  If TRUE, then set SoftwareEnable to 1
+                  If FALSE, then set SoftwareEnable to 0.
+
+**/
+VOID
+EFIAPI
+InitializeLocalApicSoftwareEnable (
+  IN BOOLEAN  Enable
+  );
+
 /**
   Programming Virtual Wire Mode.
 
diff --git a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
index b73b1d3da930..7090cd4911ff 100644
--- a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
@@ -563,6 +563,39 @@ SendInitSipiSipiAllExcludingSelf (
   SendIpi (IcrLow.Uint32, 0);
 }
 
+/**
+  Initialize the state of the SoftwareEnable bit in the Local APIC
+  Spurious Interrupt Vector register.
+
+  @param  Enable  If TRUE, then set SoftwareEnable to 1
+                  If FALSE, then set SoftwareEnable to 0.
+
+**/
+VOID
+EFIAPI
+InitializeLocalApicSoftwareEnable (
+  IN BOOLEAN  Enable
+  )
+{
+  LOCAL_APIC_SVR  Svr;
+
+  //
+  // Set local APIC software-enabled bit.
+  //
+  Svr.Uint32 = ReadLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET);
+  if (Enable) {
+    if (Svr.Bits.SoftwareEnable == 0) {
+      Svr.Bits.SoftwareEnable = 1;
+      WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+    }
+  } else {
+    if (Svr.Bits.SoftwareEnable == 1) {
+      Svr.Bits.SoftwareEnable = 0;
+      WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+    }
+  }
+}
+
 /**
   Programming Virtual Wire Mode.
 
@@ -679,7 +712,6 @@ InitializeApicTimer (
   IN UINT8   Vector
   )
 {
-  LOCAL_APIC_SVR       Svr;
   LOCAL_APIC_DCR       Dcr;
   LOCAL_APIC_LVT_TIMER LvtTimer;
   UINT32               Divisor;
@@ -687,9 +719,7 @@ InitializeApicTimer (
   //
   // Ensure local APIC is in software-enabled state.
   //
-  Svr.Uint32 = ReadLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET);
-  Svr.Bits.SoftwareEnable = 1;
-  WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+  InitializeLocalApicSoftwareEnable (TRUE);
 
   //
   // Program init-count register.
diff --git a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
index 9bbaca45dc6b..bc3d0a57e246 100644
--- a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
@@ -658,6 +658,39 @@ SendInitSipiSipiAllExcludingSelf (
   SendIpi (IcrLow.Uint32, 0);
 }
 
+/**
+  Initialize the state of the SoftwareEnable bit in the Local APIC
+  Spurious Interrupt Vector register.
+
+  @param  Enable  If TRUE, then set SoftwareEnable to 1
+                  If FALSE, then set SoftwareEnable to 0.
+
+**/
+VOID
+EFIAPI
+InitializeLocalApicSoftwareEnable (
+  IN BOOLEAN  Enable
+  )
+{
+  LOCAL_APIC_SVR  Svr;
+
+  //
+  // Set local APIC software-enabled bit.
+  //
+  Svr.Uint32 = ReadLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET);
+  if (Enable) {
+    if (Svr.Bits.SoftwareEnable == 0) {
+      Svr.Bits.SoftwareEnable = 1;
+      WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+    }
+  } else {
+    if (Svr.Bits.SoftwareEnable == 1) {
+      Svr.Bits.SoftwareEnable = 0;
+      WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+    }
+  }
+}
+
 /**
   Programming Virtual Wire Mode.
 
@@ -774,7 +807,6 @@ InitializeApicTimer (
   IN UINT8   Vector
   )
 {
-  LOCAL_APIC_SVR       Svr;
   LOCAL_APIC_DCR       Dcr;
   LOCAL_APIC_LVT_TIMER LvtTimer;
   UINT32               Divisor;
@@ -782,9 +814,7 @@ InitializeApicTimer (
   //
   // Ensure local APIC is in software-enabled state.
   //
-  Svr.Uint32 = ReadLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET);
-  Svr.Bits.SoftwareEnable = 1;
-  WriteLocalApicReg (XAPIC_SPURIOUS_VECTOR_OFFSET, Svr.Uint32);
+  InitializeLocalApicSoftwareEnable (TRUE);
 
   //
   // Program init-count register.

From e92b7ed5ced134bff7fe259798f5459aadfa8f82 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Tue, 17 Nov 2015 05:13:43 +0000
Subject: [PATCH 133/525] UefiCpuPkg/PiSmmCpuDxeSmm: Shouldn't use
 gSmst->CurrentlyExecutingCpu

In ConfigSmmCodeAccessCheck(), we used gSmst->CurrentlyExecutingCpu to get the
current SMM BSP. But ConfigSmmCodeAccessCheck() maybe invoked before executing
SmmCoreEntry() and gSmst->CurrentlyExecutingCpu hasn't been updated to the
latest value. The code flow is as below:

  BSPHandler()
    gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu = CpuIndex;
    //
    // when mRestoreSmmConfigurationInS3 is set:
    //
    ConfigSmmCodeAccessCheck()
      //
      // reads gSmst->CurrentlyExecutingCpu to early
      //
    gSmmCpuPrivate->SmmCoreEntry (&gSmmCpuPrivate->SmmCoreEntryContext)
      //
      // sets gSmst->CurrentlyExecutingCpu with CopyMem() too late
      //
      CopyMem (&gSmmCoreSmst.SmmStartupThisAp,
        SmmEntryContext, sizeof (EFI_SMM_ENTRY_CONTEXT));

Instead, we should use
gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu directly.

(Sync patch r18715 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18849 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index e210c8d44659..c351875262b4 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -1386,7 +1386,7 @@ ConfigSmmCodeAccessCheck (
   //
   // Check to see if the Feature Control MSR is supported on this CPU
   //
-  Index = gSmst->CurrentlyExecutingCpu;
+  Index = gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu;
   if (!SmmCpuFeaturesIsSmmRegisterSupported (Index, SmmRegFeatureControl)) {
     mSmmCodeAccessCheckEnable = FALSE;
     return;
@@ -1428,7 +1428,7 @@ ConfigSmmCodeAccessCheck (
   // Enable SMM Code Access Check feature for the APs.
   //
   for (Index = 0; Index < gSmst->NumberOfCpus; Index++) {
-    if (Index != gSmst->CurrentlyExecutingCpu) {
+    if (Index != gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu) {
 
       //
       // Acquire Config SMM Code Access Check spin lock.  The AP will release the

From 6a3eb62baf07b2d102a4f946b5d25bfac24e39d0 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 17 Nov 2015 05:14:39 +0000
Subject: [PATCH 134/525] UefiCpuPkg: PiSmmCpuDxeSmm: Remove Framework
 compatibility

The PiSmmCpuDxeSmm module is using PcdFrameworkCompatibilitySupport to
provide compatibility with the SMM support in the IntelFrameworkPkg.
This change removes the Framework compatibility and requires all SMM
modules that provide SMI handlers to follow the PI Specification.

(Sync patch r18726 from main trunk.)

Cc: Jeff Fan <jeff.fan@intel.com>

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18850 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c   | 60 +++-----------------
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h   |  1 -
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf |  3 -
 3 files changed, 8 insertions(+), 56 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index c351875262b4..de681c0a3069 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -76,13 +76,6 @@ EFI_SMM_CPU_PROTOCOL  mSmmCpu  = {
 
 EFI_CPU_INTERRUPT_HANDLER   mExternalVectorTable[EXCEPTION_VECTOR_NUMBER];
 
-///
-/// SMM CPU Save State Protocol instance
-///
-EFI_SMM_CPU_SAVE_STATE_PROTOCOL  mSmmCpuSaveState = {
-  NULL
-};
-
 //
 // SMM stack information
 //
@@ -530,18 +523,13 @@ SmmRestoreCpu (
   }
 
   //
-  // Do below CPU things for native platform only
+  // Skip initialization if mAcpiCpuData is not valid
   //
-  if (!FeaturePcdGet(PcdFrameworkCompatibilitySupport)) {
+  if (mAcpiCpuData.NumberOfCpus > 0) {
     //
-    // Skip initialization if mAcpiCpuData is not valid
+    // First time microcode load and restore MTRRs
     //
-    if (mAcpiCpuData.NumberOfCpus > 0) {
-      //
-      // First time microcode load and restore MTRRs
-      //
-      EarlyInitializeCpu ();
-    }
+    EarlyInitializeCpu ();
   }
 
   //
@@ -550,18 +538,13 @@ SmmRestoreCpu (
   SmmRelocateBases ();
 
   //
-  // Do below CPU things for native platform only
+  // Skip initialization if mAcpiCpuData is not valid
   //
-  if (!FeaturePcdGet(PcdFrameworkCompatibilitySupport)) {
+  if (mAcpiCpuData.NumberOfCpus > 0) {
     //
-    // Skip initialization if mAcpiCpuData is not valid
+    // Restore MSRs for BSP and all APs
     //
-    if (mAcpiCpuData.NumberOfCpus > 0) {
-      //
-      // Restore MSRs for BSP and all APs
-      //
-      InitializeCpu ();
-    }
+    InitializeCpu ();
   }
 
   //
@@ -686,13 +669,6 @@ SmmReadyToLockEventNotify (
   //
   mAcpiCpuData.NumberOfCpus = 0;
 
-  //
-  // If FrameworkCompatibilitySspport is enabled, then do not copy CPU S3 Data into SMRAM
-  //
-  if (FeaturePcdGet (PcdFrameworkCompatibilitySupport)) {
-    goto Done;
-  }
-
   //
   // If PcdCpuS3DataAddress was never set, then do not copy CPU S3 Data into SMRAM
   //
@@ -1009,7 +985,6 @@ PiCpuSmmEntry (
 
   mSmmCpuPrivateData.SmmCoreEntryContext.CpuSaveStateSize = gSmmCpuPrivate->CpuSaveStateSize;
   mSmmCpuPrivateData.SmmCoreEntryContext.CpuSaveState     = gSmmCpuPrivate->CpuSaveState;
-  mSmmCpuSaveState.CpuSaveState = (EFI_SMM_CPU_STATE **)gSmmCpuPrivate->CpuSaveState;
 
   //
   // Allocate buffer for pointers to array in CPU_HOT_PLUG_DATA.
@@ -1150,25 +1125,6 @@ PiCpuSmmEntry (
   Status = InitializeSmmCpuServices (mSmmCpuHandle);
   ASSERT_EFI_ERROR (Status);
 
-  if (FeaturePcdGet (PcdFrameworkCompatibilitySupport)) {
-    //
-    // Install Framework SMM Save State Protocol into UEFI protocol database for backward compatibility
-    //
-    Status = SystemTable->BootServices->InstallMultipleProtocolInterfaces (
-                                          &gSmmCpuPrivate->SmmCpuHandle,
-                                          &gEfiSmmCpuSaveStateProtocolGuid,
-                                          &mSmmCpuSaveState,
-                                          NULL
-                                          );
-    ASSERT_EFI_ERROR (Status);
-    //
-    // The SmmStartupThisAp service in Framework SMST should always be non-null.
-    // Update SmmStartupThisAp pointer in PI SMST here so that PI/Framework SMM thunk
-    // can have it ready when constructing Framework SMST.
-    //
-    gSmst->SmmStartupThisAp = SmmStartupThisAp;
-  }
-
   //
   // register SMM Ready To Lock Protocol notification
   //
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index 162bdadf0bce..cfbf2ca6dae3 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -21,7 +21,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Protocol/SmmConfiguration.h>
 #include <Protocol/SmmCpu.h>
 #include <Protocol/SmmAccess2.h>
-#include <Protocol/SmmCpuSaveState.h>
 #include <Protocol/SmmReadyToLock.h>
 #include <Protocol/SmmCpuService.h>
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
index f559947ee420..a293a88e9914 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
@@ -89,7 +89,6 @@
   MdePkg/MdePkg.dec
   MdeModulePkg/MdeModulePkg.dec
   UefiCpuPkg/UefiCpuPkg.dec
-  IntelFrameworkPkg/IntelFrameworkPkg.dec
 
 [LibraryClasses]
   UefiDriverEntryPoint
@@ -126,7 +125,6 @@
   gEfiSmmCpuProtocolGuid                   ## PRODUCES
   gEfiSmmReadyToLockProtocolGuid           ## NOTIFY
   gEfiSmmCpuServiceProtocolGuid            ## PRODUCES
-  gEfiSmmCpuSaveStateProtocolGuid          ## SOMETIMES_PRODUCES
 
 [Guids]
   gEfiAcpiVariableGuid                     ## SOMETIMES_CONSUMES ## HOB # it is used for S3 boot.
@@ -135,7 +133,6 @@
   gEfiAcpi10TableGuid                      ## SOMETIMES_CONSUMES ## SystemTable
 
 [FeaturePcd]
-  gEfiMdeModulePkgTokenSpaceGuid.PcdFrameworkCompatibilitySupport  ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmDebug                         ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmBlockStartupThisAp            ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmEnableBspElection             ## CONSUMES

From 0499b7bfda33b1e78cda8176c9f7a68d85605a69 Mon Sep 17 00:00:00 2001
From: Zhang Chao <chao.b.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:03:37 +0000
Subject: [PATCH 135/525] SecurityPkg: Remove temp return solution in
 PeiRsa2048Sha256 Section Lib

PeiCore supports EFI_PEI_SECURITY_PPI to handle section extraction failure. The wrong returning status is no longer needed.

(Sync patch r18732 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Chao <chao.b.zhang@intel.com>
Reviewed-by: Gao Liming <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18869 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PeiRsa2048Sha256GuidedSectionExtractLib.c               | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c b/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
index e448164a5a33..473370300a0e 100644
--- a/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
+++ b/SecurityPkg/Library/PeiRsa2048Sha256GuidedSectionExtractLib/PeiRsa2048Sha256GuidedSectionExtractLib.c
@@ -357,12 +357,6 @@ Rsa2048Sha256GuidedSectionHandler (
     FreePool (HashContext);
   }
 
-  //
-  // Temp solution until PeiCore checks AUTH Status.
-  //
-  if ((*AuthenticationStatus & (EFI_AUTH_STATUS_TEST_FAILED | EFI_AUTH_STATUS_NOT_TESTED)) != 0) {
-    Status = EFI_ACCESS_DENIED;
-  }
   DEBUG ((DEBUG_VERBOSE, "PeiRsa2048Sha256: Status = %r  AuthenticationStatus = %08x\n", Status, *AuthenticationStatus));
 
   return Status;

From f065557152aa598aa1bbd399aa970a82a4b9aa8a Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 18 Nov 2015 08:04:29 +0000
Subject: [PATCH 136/525] Add error handling for TPM in S3 resume failure.

If TPM2_Startup(TPM_SU_STATE) to return an error, the system
 firmware that resumes from S3 MUST deal with a TPM2_Startup
 error appropriately.
For example, issuing a TPM2_Startup(TPM_SU_CLEAR) command and
 configuring the device securely by taking actions like extending
 a separator with an error digest (0x01) into PCRs 0 through 7.

(Sync patch r18760 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18870 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c | 50 +++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
index ec94c24e4c40..3743bfbb1117 100644
--- a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
+++ b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
@@ -827,6 +827,33 @@ PeimEntryMP (
   return Status;
 }
 
+/**
+  Measure and log Separator event with error, and extend the measurement result into a specific PCR.
+
+  @param[in] PCRIndex         PCR index.  
+
+  @retval EFI_SUCCESS         Operation completed successfully.
+  @retval EFI_DEVICE_ERROR    The operation was unsuccessful.
+
+**/
+EFI_STATUS
+MeasureSeparatorEventWithError (
+  IN      TPM_PCRINDEX              PCRIndex
+  )
+{
+  TCG_PCR_EVENT_HDR                 TcgEvent;
+  UINT32                            EventData;
+
+  //
+  // Use EventData 0x1 to indicate there is error.
+  //
+  EventData = 0x1;
+  TcgEvent.PCRIndex  = PCRIndex;
+  TcgEvent.EventType = EV_SEPARATOR;
+  TcgEvent.EventSize = (UINT32)sizeof (EventData);
+  return HashLogExtendEvent(0,(UINT8 *)&EventData, TcgEvent.EventSize, &TcgEvent,(UINT8 *)&EventData);
+}
+
 /**
   Entry point of this module.
 
@@ -846,6 +873,8 @@ PeimEntryMA (
   EFI_STATUS                        Status;
   EFI_STATUS                        Status2;
   EFI_BOOT_MODE                     BootMode;
+  TPM_PCRINDEX                      PcrIndex;
+  BOOLEAN                           S3ErrorReport;
 
   if (CompareGuid (PcdGetPtr(PcdTpmInstanceGuid), &gEfiTpmDeviceInstanceNoneGuid) ||
       CompareGuid (PcdGetPtr(PcdTpmInstanceGuid), &gEfiTpmDeviceInstanceTpm12Guid)){
@@ -884,11 +913,15 @@ PeimEntryMA (
       goto Done;
     }
 
+    S3ErrorReport = FALSE;
     if (PcdGet8 (PcdTpm2InitializationPolicy) == 1) {
       if (BootMode == BOOT_ON_S3_RESUME) {
         Status = Tpm2Startup (TPM_SU_STATE);
         if (EFI_ERROR (Status) ) {
           Status = Tpm2Startup (TPM_SU_CLEAR);
+          if (!EFI_ERROR(Status)) {
+            S3ErrorReport = TRUE;
+          }
         }
       } else {
         Status = Tpm2Startup (TPM_SU_CLEAR);
@@ -902,6 +935,23 @@ PeimEntryMA (
     // Update Tpm2HashMask according to PCR bank.
     //
     SetTpm2HashMask ();
+
+    if (S3ErrorReport) {
+      //
+      // The system firmware that resumes from S3 MUST deal with a
+      // TPM2_Startup error appropriately.
+      // For example, issue a TPM2_Startup(TPM_SU_CLEAR) command and
+      // configuring the device securely by taking actions like extending a
+      // separator with an error digest (0x01) into PCRs 0 through 7.
+      //
+      for (PcrIndex = 0; PcrIndex < 8; PcrIndex++) {
+        Status = MeasureSeparatorEventWithError (PcrIndex);
+        if (EFI_ERROR (Status)) {
+          DEBUG ((EFI_D_ERROR, "Separator Event with Error not Measured. Error!\n"));
+        }
+      }
+    }
+
     //
     // TpmSelfTest is optional on S3 path, skip it to save S3 time
     //

From 65a512014904ce251bb183f41812595c0f8b256f Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Wed, 18 Nov 2015 08:05:27 +0000
Subject: [PATCH 137/525] MdePkg: Add more DataBits support to Port80 output

The BasePostCodeLibPort80 instance just prints UINT8 to IoPort 80. Some boards
may support 16bit or 32bit. To support them, new PCD PcdPort80DataWidth is
introduced to specify the width of data bits to Port80.

(Sync patch r18765 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18871 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BasePostCodeLibPort80.inf                 |   5 ++--
 .../Library/BasePostCodeLibPort80/PostCode.c  |  24 +++++++++++++++---
 MdePkg/MdePkg.dec                             |   5 ++++
 MdePkg/MdePkg.uni                             | Bin 69604 -> 70116 bytes
 4 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort80.inf b/MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort80.inf
index e2f0be551d46..ebe115872883 100644
--- a/MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort80.inf
+++ b/MdePkg/Library/BasePostCodeLibPort80/BasePostCodeLibPort80.inf
@@ -3,7 +3,7 @@
 #
 #  Post Code Library that writes post code values to I/O port 0x80.
 #
-#  Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -40,8 +40,9 @@
 [LibraryClasses]
   IoLib
   PcdLib
+  DebugLib
 
 
 [Pcd]
   gEfiMdePkgTokenSpaceGuid.PcdPostCodePropertyMask  ## CONSUMES
-
+  gEfiMdePkgTokenSpaceGuid.PcdPort80DataWidth ## CONSUMES
diff --git a/MdePkg/Library/BasePostCodeLibPort80/PostCode.c b/MdePkg/Library/BasePostCodeLibPort80/PostCode.c
index 925c7404bc39..f1fdbabce4b4 100644
--- a/MdePkg/Library/BasePostCodeLibPort80/PostCode.c
+++ b/MdePkg/Library/BasePostCodeLibPort80/PostCode.c
@@ -1,7 +1,7 @@
 /** @file
   Post Code Library instance that writes post code values to I/O port 0x80.
 
-  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials                          
   are licensed and made available under the terms and conditions of the BSD License         
   which accompanies this distribution.  The full text of the license may be found at        
@@ -17,6 +17,7 @@
 #include <Library/PostCodeLib.h>
 #include <Library/PcdLib.h>
 #include <Library/IoLib.h>
+#include <Library/DebugLib.h>
 
 /**
   Sends an 32-bit value to a POST card.
@@ -42,7 +43,24 @@ PostCode (
   IN UINT32  Value
   )
 {
-  IoWrite8 (0x80, (UINT8)(Value));
+  switch (PcdGet8 (PcdPort80DataWidth)) {
+  case 8:
+    IoWrite8 (0x80, (UINT8)(Value));
+    break;
+  case 16:
+    IoWrite16 (0x80, (UINT16)(Value));
+    break;
+  case 32:
+    IoWrite32 (0x80, Value);
+    break;
+  default:
+    //
+    // Assert on the invalid data width
+    //
+    ASSERT (FALSE);
+    break;
+  }
+  
   return Value;
 }
 
@@ -78,7 +96,7 @@ PostCodeWithDescription (
   IN CONST CHAR8  *Description  OPTIONAL
   )
 {
-  IoWrite8 (0x80, (UINT8)(Value));
+  PostCode (Value);
   return Value;
 }
 
diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
index 337059a6a602..7ab0cbbcfbfb 100644
--- a/MdePkg/MdePkg.dec
+++ b/MdePkg/MdePkg.dec
@@ -1938,6 +1938,11 @@
   # @Expression  0x80000002 | (gEfiMdePkgTokenSpaceGuid.PcdPostCodePropertyMask & 0xFC) == 0
   gEfiMdePkgTokenSpaceGuid.PcdPostCodePropertyMask|0|UINT8|0x0000000b
 
+  ## The bit width of data to be written to Port80. The default value is 8.
+  # @Prompt Port80 Data Width
+  # @ValidList  0x80000001 | 8, 16, 32
+  gEfiMdePkgTokenSpaceGuid.PcdPort80DataWidth|8|UINT8|0x0000002d
+
   ## This value is used to configure X86 Processor FSB clock.
   # @Prompt FSB Clock.
   gEfiMdePkgTokenSpaceGuid.PcdFSBClock|200000000|UINT32|0x0000000c
diff --git a/MdePkg/MdePkg.uni b/MdePkg/MdePkg.uni
index 38211344e0ae01e984d5d9b916e42f4f8b4c1c66..5a5126213e4f72ea8c47772aebf5e31e007bbc46 100644
GIT binary patch
delta 257
zcmaDdpXJG7mWC~iPxvRx?GKO*V8~}EVklv-U@%~CVMqkB5*fl7G8s~Utc=NqV&?J)
zc?Gx%1tc|&YvM(*nlSl%is|GHt2pYDfaaAjC@_@6%muRZ8Pb4c3e-jgpnN`%pTv*~
zR#ybpQ3B-U0r?O)WS8mzMMD@ez^YS#WE#+%QidF`EoDG<4v+^jDU+d?L4g<OIgkb=
J23`g(1^^oLG@}3j

delta 11
ScmaE|nB~cQmWC~iPxt{N6a_l~


From f295c2f6be7acef091e06582095c8d3f0811ea8c Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Wed, 18 Nov 2015 08:06:21 +0000
Subject: [PATCH 138/525] MdeModulePkg PeiCore: PEI dispatcher need retry to
 process NOT_DISPATCHED FV

A corner case like below will cause a NOT_DISPATCHED FV has no opportunity to
be dispatched.
  1. FV_RECOVERY has SecCore, PeiCore and some other PEI modules, a module will
    report FVMAIN_COMPACT and FV_RECOVERY2 in sequence.
  2. FVMAIN_COMPACT has a FV image file with GUIDED FV image section in it.
  3. FV_RECOVERY2 has DxeIpl and other PEI modules, the DxeIpl will install
     SectionExtractionPpi
  If ALL the PEIMs in FV_RECOVERY and FV_RECOVERY2 have DEPEX satisfied and
  executed in one loop, PeimNeedingDispatch will be always FALSE, FVMAIN_COMPACT
  will have no opportunity to be decompressed and dispatched as DxeIpl executes
  after the first processing to FVMAIN_COMPACT.

The patch is to set PeimNeedingDispatch to TRUE when ProcessFvFile() not successfully,
then the NOT_DISPATCHED FV could have another opportunity to be processed.

(Sync patch r18781 from main trunk.)

Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Eugene Cohen <eugene@hp.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18872 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Pei/Dispatcher/Dispatcher.c | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Core/Pei/Dispatcher/Dispatcher.c b/MdeModulePkg/Core/Pei/Dispatcher/Dispatcher.c
index 7480b662c579..e7e795d123d6 100644
--- a/MdeModulePkg/Core/Pei/Dispatcher/Dispatcher.c
+++ b/MdeModulePkg/Core/Pei/Dispatcher/Dispatcher.c
@@ -1056,7 +1056,7 @@ PeiDispatcher (
             ASSERT_EFI_ERROR (Status);
             if (FvFileInfo.FileType == EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE) {
               //
-              // For Fv type file, Produce new FV PPI and FV hob
+              // For Fv type file, Produce new FvInfo PPI and FV hob
               //
               Status = ProcessFvFile (Private, &Private->Fv[FvCount], PeimFileHandle);
               if (Status == EFI_SUCCESS) {
@@ -1065,6 +1065,13 @@ PeiDispatcher (
                 //
                 Private->Fv[FvCount].PeimState[PeimCount]++;
                 Private->PeimDispatchOnThisPass = TRUE;
+              } else {
+                //
+                // The related GuidedSectionExtraction/Decompress PPI for the
+                // encapsulated FV image section may be installed in the rest
+                // of this do-while loop, so need to make another pass.
+                //
+                Private->PeimNeedingDispatch = TRUE;
               }
             } else {
               //
@@ -1192,11 +1199,11 @@ PeiDispatcher (
     Private->CurrentPeimFvCount = 0;
 
     //
-    // PeimNeedingDispatch being TRUE means we found a PEIM that did not get
+    // PeimNeedingDispatch being TRUE means we found a PEIM/FV that did not get
     //  dispatched. So we need to make another pass
     //
-    // PeimDispatchOnThisPass being TRUE means we dispatched a PEIM on this
-    //  pass. If we did not dispatch a PEIM there is no point in trying again
+    // PeimDispatchOnThisPass being TRUE means we dispatched a PEIM/FV on this
+    //  pass. If we did not dispatch a PEIM/FV there is no point in trying again
     //  as it will fail the next time too (nothing has changed).
     //
   } while (Private->PeimNeedingDispatch && Private->PeimDispatchOnThisPass);

From ba82c72fc4d4f9230d3bf5d0a69b14e44d5105cf Mon Sep 17 00:00:00 2001
From: Nagaraj Hegde <nagaraj-p.hegde@hpe.com>
Date: Wed, 18 Nov 2015 08:34:44 +0000
Subject: [PATCH 139/525] NetworkPkg:Missing CloseEvent() in HttpResponseWorker

Two additional scenarios in which CloseEvent() needs to be called:
When sending a request to http server using HTTP Head method, if the process
is success, we did a response call, and then go to exit without close the
event in Rxtoken in wrap structure and in httpinstance struceure, so
another call() to response using http get method to receive http header,
those events are not closed either..

(Sync patch r18735 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Nagaraj Hegde <nagaraj-p.hegde@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Zhang Lubo <lubo.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18873 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 09ee379150a9..de3ec9c28400 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -1131,6 +1131,18 @@ HttpResponseWorker (
   }
   Token->Status = Status;
   gBS->SignalEvent (Token->Event);
+
+  if (Wrap != NULL) {
+    if (Wrap->TcpWrap.RxToken.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
+    }
+  }
+  
+  if (HttpInstance->RxToken.CompletionToken.Event != NULL) {
+    gBS->CloseEvent (HttpInstance->RxToken.CompletionToken.Event);
+    HttpInstance->RxToken.CompletionToken.Event = NULL;
+  }  
+  
   FreePool (Wrap);
   return Status;
 

From 0e772049c65ad249b70808b456fc7f8ad694b275 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:36:42 +0000
Subject: [PATCH 140/525] NetworkPkg:Enable Http Boot over Ipv6 stack

Add new features to support Http boot over ipv6 stack.

(Sync patch r18743 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18874 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpBootDxe/HttpBootClient.c       |  234 ++-
 .../HttpBootDxe/HttpBootComponentName.c       |    5 +-
 NetworkPkg/HttpBootDxe/HttpBootDhcp4.c        |   12 +-
 NetworkPkg/HttpBootDxe/HttpBootDhcp4.h        |   11 +
 NetworkPkg/HttpBootDxe/HttpBootDhcp6.c        |  984 +++++++++++++
 NetworkPkg/HttpBootDxe/HttpBootDhcp6.h        |  198 +++
 NetworkPkg/HttpBootDxe/HttpBootDxe.c          |  903 ++++++++++--
 NetworkPkg/HttpBootDxe/HttpBootDxe.h          |  159 ++-
 NetworkPkg/HttpBootDxe/HttpBootDxe.inf        |    9 +
 NetworkPkg/HttpBootDxe/HttpBootDxe.uni        |  Bin 2008 -> 2040 bytes
 NetworkPkg/HttpBootDxe/HttpBootImpl.c         |  109 +-
 NetworkPkg/HttpBootDxe/HttpBootImpl.h         |    2 +-
 NetworkPkg/HttpBootDxe/HttpBootSupport.c      |  292 +++-
 NetworkPkg/HttpBootDxe/HttpBootSupport.h      |   70 +
 NetworkPkg/HttpDxe/HttpDns.c                  |  207 ++-
 NetworkPkg/HttpDxe/HttpDns.h                  |   20 +
 NetworkPkg/HttpDxe/HttpDriver.c               |  806 ++++++++---
 NetworkPkg/HttpDxe/HttpDriver.h               |  143 +-
 NetworkPkg/HttpDxe/HttpDxe.inf                |    5 +
 NetworkPkg/HttpDxe/HttpDxe.uni                |  Bin 1822 -> 1854 bytes
 NetworkPkg/HttpDxe/HttpImpl.c                 |  374 ++---
 NetworkPkg/HttpDxe/HttpProto.c                | 1249 ++++++++++++++---
 NetworkPkg/HttpDxe/HttpProto.h                |  193 ++-
 23 files changed, 5071 insertions(+), 914 deletions(-)
 create mode 100644 NetworkPkg/HttpBootDxe/HttpBootDhcp6.c
 create mode 100644 NetworkPkg/HttpBootDxe/HttpBootDhcp6.h

diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.c b/NetworkPkg/HttpBootDxe/HttpBootClient.c
index 5669c5f37ce1..b81b03c96070 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.c
@@ -54,14 +54,27 @@ HttpBootUpdateDevicePath (
     Node->Ipv4.StaticIpAddress = FALSE;
     CopyMem (&Node->Ipv4.GatewayIpAddress, &Private->GatewayIp, sizeof (EFI_IPv4_ADDRESS));
     CopyMem (&Node->Ipv4.SubnetMask, &Private->SubnetMask, sizeof (EFI_IPv4_ADDRESS));
-    
-    TmpDevicePath = AppendDevicePathNode (Private->ParentDevicePath, (EFI_DEVICE_PATH_PROTOCOL*) Node);
-    FreePool (Node);
-    if (TmpDevicePath == NULL) {
+  } else {
+    Node = AllocateZeroPool (sizeof (IPv6_DEVICE_PATH));
+    if (Node == NULL) {
       return EFI_OUT_OF_RESOURCES;
     }
-  } else {
-    ASSERT (FALSE);
+    Node->Ipv6.Header.Type     = MESSAGING_DEVICE_PATH;
+    Node->Ipv6.Header.SubType  = MSG_IPv6_DP;
+    SetDevicePathNodeLength (Node, sizeof (IPv6_DEVICE_PATH));
+    Node->Ipv6.PrefixLength    = IP6_PREFIX_LENGTH;
+    Node->Ipv6.RemotePort      = Private->Port;
+    Node->Ipv6.Protocol        = EFI_IP_PROTO_TCP; 
+    Node->Ipv6.IpAddressOrigin = 0;
+    CopyMem (&Node->Ipv6.LocalIpAddress, &Private->StationIp.v6, sizeof (EFI_IPv6_ADDRESS));
+    CopyMem (&Node->Ipv6.RemoteIpAddress, &Private->ServerIp.v6, sizeof (EFI_IPv6_ADDRESS));
+    CopyMem (&Node->Ipv6.GatewayIpAddress, &Private->GatewayIp.v6, sizeof (EFI_IPv6_ADDRESS));
+  }
+  
+  TmpDevicePath = AppendDevicePathNode (Private->ParentDevicePath, (EFI_DEVICE_PATH_PROTOCOL*) Node);
+  FreePool (Node);
+  if (TmpDevicePath == NULL) {
+    return EFI_OUT_OF_RESOURCES;
   }
 
   //
@@ -85,21 +98,39 @@ HttpBootUpdateDevicePath (
     return EFI_OUT_OF_RESOURCES;
   }
 
-  //
-  // Reinstall the device path protocol of the child handle.
-  //
-  Status = gBS->ReinstallProtocolInterface (
-                  Private->ChildHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  Private->DevicePath,
-                  NewDevicePath
-                  );
-  if (EFI_ERROR (Status)) {
-    return Status;
+  if (!Private->UsingIpv6) {
+    //
+    // Reinstall the device path protocol of the child handle.
+    //
+    Status = gBS->ReinstallProtocolInterface (
+                    Private->Ip4Nic->Controller,
+                    &gEfiDevicePathProtocolGuid,
+                    Private->Ip4Nic->DevicePath,
+                    NewDevicePath
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    FreePool (Private->Ip4Nic->DevicePath);
+    Private->Ip4Nic->DevicePath = NewDevicePath;
+  } else {
+    //
+    // Reinstall the device path protocol of the child handle.
+    //
+    Status = gBS->ReinstallProtocolInterface (
+                    Private->Ip6Nic->Controller,
+                    &gEfiDevicePathProtocolGuid,
+                    Private->Ip6Nic->DevicePath,
+                    NewDevicePath
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    FreePool (Private->Ip6Nic->DevicePath);
+    Private->Ip6Nic->DevicePath = NewDevicePath;
   }
   
-  FreePool (Private->DevicePath);
-  Private->DevicePath = NewDevicePath;
   return EFI_SUCCESS;
 }
 
@@ -113,7 +144,7 @@ HttpBootUpdateDevicePath (
 
 **/
 EFI_STATUS
-HttpBootExtractUriInfo (
+HttpBootDhcp4ExtractUriInfo (
   IN     HTTP_BOOT_PRIVATE_DATA   *Private
   )
 {
@@ -192,6 +223,159 @@ HttpBootExtractUriInfo (
   return Status;
 }
 
+/**
+  Parse the boot file URI information from the selected Dhcp6 offer packet.
+
+  @param[in]    Private        The pointer to the driver's private data.
+
+  @retval EFI_SUCCESS          Successfully parsed out all the boot information.
+  @retval Others               Failed to parse out the boot information.
+
+**/
+EFI_STATUS
+HttpBootDhcp6ExtractUriInfo (
+  IN     HTTP_BOOT_PRIVATE_DATA   *Private
+  )
+{
+  HTTP_BOOT_DHCP6_PACKET_CACHE    *SelectOffer;
+  HTTP_BOOT_DHCP6_PACKET_CACHE    *HttpOffer;
+  UINT32                          SelectIndex;
+  UINT32                          ProxyIndex;
+  EFI_DHCP6_PACKET_OPTION         *Option;
+  EFI_IPv6_ADDRESS                IpAddr;
+  CHAR8                           *HostName;
+  CHAR16                          *HostNameStr;
+  EFI_STATUS                      Status;
+
+  ASSERT (Private != NULL);
+  ASSERT (Private->SelectIndex != 0);
+  SelectIndex = Private->SelectIndex - 1;
+  ASSERT (SelectIndex < HTTP_BOOT_OFFER_MAX_NUM);
+
+  Status   = EFI_SUCCESS;
+  HostName = NULL;
+  //
+  // SelectOffer contains the IP address configuration and name server configuration.
+  // HttpOffer contains the boot file URL.
+  //
+  SelectOffer = &Private->OfferBuffer[SelectIndex].Dhcp6;
+  if ((SelectOffer->OfferType == HttpOfferTypeDhcpIpUri) || (SelectOffer->OfferType == HttpOfferTypeDhcpNameUriDns)) {
+    HttpOffer = SelectOffer;
+  } else {
+    ASSERT (Private->SelectProxyType != HttpOfferTypeMax);
+    ProxyIndex = Private->OfferIndex[Private->SelectProxyType][0];
+    HttpOffer = &Private->OfferBuffer[ProxyIndex].Dhcp6;
+  }
+
+  //
+  //  Set the Local station address to IP layer.
+  //
+  Status = HttpBootSetIp6Address (Private);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  
+  //
+  // Configure the default DNS server if server assigned.
+  //
+  if ((SelectOffer->OfferType == HttpOfferTypeDhcpNameUriDns) || (SelectOffer->OfferType == HttpOfferTypeDhcpDns)) {
+    Option = SelectOffer->OptList[HTTP_BOOT_DHCP6_IDX_DNS_SERVER];
+    ASSERT (Option != NULL);
+    Status = HttpBootSetIp6Dns (
+               Private,
+               HTONS (Option->OpLen),
+               Option->Data
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
+  
+  //
+  // Extract the HTTP server Ip frome URL. This is used to Check route table 
+  // whether can send message to HTTP Server Ip through the GateWay.
+  //
+  Status = HttpUrlGetIp6 (
+             (CHAR8*) HttpOffer->OptList[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data,
+             HttpOffer->UriParser,
+             &IpAddr
+             );
+  
+  if (EFI_ERROR (Status)) {
+    //
+    // The Http server address is expressed by Name Ip, so perform DNS resolution
+    //
+    Status = HttpUrlGetHostName (
+               (CHAR8*) HttpOffer->OptList[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data,
+               HttpOffer->UriParser,
+               &HostName
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    HostNameStr = AllocateZeroPool ((AsciiStrLen (HostName) + 1) * sizeof (CHAR16));
+    if (HostNameStr == NULL) {
+      Status = EFI_OUT_OF_RESOURCES;
+      goto Error;
+    }
+    
+    AsciiStrToUnicodeStr (HostName, HostNameStr);
+    Status = HttpBootDns (Private, HostNameStr, &IpAddr);
+    FreePool (HostNameStr);
+    if (EFI_ERROR (Status)) {
+      goto Error;
+    }  
+  } 
+  
+  CopyMem (&Private->ServerIp.v6, &IpAddr, sizeof (EFI_IPv6_ADDRESS));  
+    
+  //
+  // register the IPv6 gateway address to the network device.
+  //
+  Status = HttpBootSetIp6Gateway (Private);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  
+  //
+  // Extract the port from URL, and use default HTTP port 80 if not provided.
+  //
+  Status = HttpUrlGetPort (
+             (CHAR8*) HttpOffer->OptList[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data,
+             HttpOffer->UriParser,
+             &Private->Port
+             );
+  if (EFI_ERROR (Status) || Private->Port == 0) {
+    Private->Port = 80;
+  }
+  
+  //
+  // Record the URI of boot file from the selected HTTP offer.
+  //
+  Private->BootFileUriParser = HttpOffer->UriParser;
+  Private->BootFileUri = (CHAR8*) HttpOffer->OptList[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data;
+
+  
+  //
+  // All boot informations are valid here.
+  //
+  AsciiPrint ("\n  URI: %a", Private->BootFileUri);
+  //
+  // Update the device path to include the IP and boot URI information.
+  //
+  Status = HttpBootUpdateDevicePath (Private);
+
+Error:
+  
+  if (HostName != NULL) {
+    FreePool (HostName);
+  }
+    
+  return Status;
+}
+
+
 /**
   Discover all the boot information for boot file.
 
@@ -218,9 +402,9 @@ HttpBootDiscoverBootInfo (
   }
 
   if (!Private->UsingIpv6) {
-    Status = HttpBootExtractUriInfo (Private);
+    Status = HttpBootDhcp4ExtractUriInfo (Private);
   } else {
-    ASSERT (FALSE);
+    Status = HttpBootDhcp6ExtractUriInfo (Private);
   }
 
   return Status;
@@ -247,12 +431,14 @@ HttpBootCreateHttpIo (
 
   ZeroMem (&ConfigData, sizeof (HTTP_IO_CONFIG_DATA));
   if (!Private->UsingIpv6) {
-    ConfigData.Config4.HttpVersion = HttpVersion11;
+    ConfigData.Config4.HttpVersion    = HttpVersion11;
     ConfigData.Config4.RequestTimeOut = HTTP_BOOT_REQUEST_TIMEOUT;
     IP4_COPY_ADDRESS (&ConfigData.Config4.LocalIp, &Private->StationIp.v4);
     IP4_COPY_ADDRESS (&ConfigData.Config4.SubnetMask, &Private->SubnetMask.v4);
   } else {
-    ASSERT (FALSE);
+    ConfigData.Config6.HttpVersion    = HttpVersion11;
+    ConfigData.Config6.RequestTimeOut = HTTP_BOOT_REQUEST_TIMEOUT;
+    IP6_COPY_ADDRESS (&ConfigData.Config6.LocalIp, &Private->StationIp.v6);
   }
 
   Status = HttpIoCreateIo (
diff --git a/NetworkPkg/HttpBootDxe/HttpBootComponentName.c b/NetworkPkg/HttpBootDxe/HttpBootComponentName.c
index 0708598c4faf..2c39089da3f7 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootComponentName.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootComponentName.c
@@ -151,7 +151,10 @@ HttpBootDxeComponentNameGetControllerName (
   
   NicHandle = HttpBootGetNicByIp4Children (ControllerHandle);
   if (NicHandle == NULL) {
-    return EFI_UNSUPPORTED;
+    NicHandle = HttpBootGetNicByIp6Children(ControllerHandle);
+    if (NicHandle == NULL) {
+      return EFI_UNSUPPORTED;
+    }
   }
 
   //
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDhcp4.c b/NetworkPkg/HttpBootDxe/HttpBootDhcp4.c
index 217c60823370..9a947a6ea63c 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDhcp4.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootDhcp4.c
@@ -319,7 +319,7 @@ HttpBootParseDhcp4Packet (
   }
 
   //
-  // The offer with "HttpClient" is a Http offer.
+  // The offer with "HTTPClient" is a Http offer.
   //
   Option = Options[HTTP_BOOT_DHCP4_TAG_INDEX_CLASS_ID];
   if ((Option != NULL) && (Option->Length >= 9) &&
@@ -461,13 +461,13 @@ HttpBootCacheDhcp4Offer (
 }
 
 /**
-  Select an DHCPv4 offer, and record SelectIndex and SelectProxyType.
+  Select an DHCPv4 or DHCP6 offer, and record SelectIndex and SelectProxyType.
 
   @param[in]  Private             Pointer to HTTP boot driver private data.
 
 **/
 VOID
-HttpBootSelectDhcp4Offer (
+HttpBootSelectDhcpOffer (
   IN HTTP_BOOT_PRIVATE_DATA  *Private
   )
 {
@@ -590,7 +590,7 @@ HttpBootDhcp4CallBack (
     // Select offer according to the priority in UEFI spec, and record the SelectIndex 
     // and SelectProxyType.
     //
-    HttpBootSelectDhcp4Offer (Private);
+    HttpBootSelectDhcpOffer (Private);
 
     if (Private->SelectIndex == 0) {
       Status = EFI_ABORTED;
@@ -689,7 +689,7 @@ HttpBootRegisterIp4Dns (
 
 **/
 EFI_STATUS
-HttpBootSetIpPolicy (
+HttpBootSetIp4Policy (
   IN HTTP_BOOT_PRIVATE_DATA         *Private
   )
 {
@@ -752,7 +752,7 @@ HttpBootDhcp4Dora (
   Dhcp4 = Private->Dhcp4;
   ASSERT (Dhcp4 != NULL);
 
-  Status = HttpBootSetIpPolicy (Private);
+  Status = HttpBootSetIp4Policy (Private);
   if (EFI_ERROR (Status)) {
     return Status;
   }
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDhcp4.h b/NetworkPkg/HttpBootDxe/HttpBootDhcp4.h
index 200501666b2a..2bc46deafd41 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDhcp4.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootDhcp4.h
@@ -245,6 +245,17 @@ typedef struct {
   EFI_DHCP4_PACKET_OPTION     *OptList[HTTP_BOOT_DHCP4_TAG_INDEX_MAX];
 } HTTP_BOOT_DHCP4_PACKET_CACHE;
 
+/**
+  Select an DHCPv4 or DHCP6 offer, and record SelectIndex and SelectProxyType.
+
+  @param[in]  Private             Pointer to HTTP boot driver private data.
+
+**/
+VOID
+HttpBootSelectDhcpOffer (
+  IN HTTP_BOOT_PRIVATE_DATA  *Private
+  );
+
 /**
   Start the D.O.R.A DHCPv4 process to acquire the IPv4 address and other Http boot information.
 
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDhcp6.c b/NetworkPkg/HttpBootDxe/HttpBootDhcp6.c
new file mode 100644
index 000000000000..e5cf894714e1
--- /dev/null
+++ b/NetworkPkg/HttpBootDxe/HttpBootDhcp6.c
@@ -0,0 +1,984 @@
+/** @file
+  Functions implementation related with DHCPv6 for HTTP boot driver.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under 
+the terms and conditions of the BSD License that accompanies this distribution.  
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.                                          
+    
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "HttpBootDxe.h"
+
+/**
+  Build the options buffer for the DHCPv6 request packet.
+
+  @param[in]  Private             The pointer to HTTP BOOT driver private data.
+  @param[out] OptList             The pointer to the option pointer array.
+  @param[in]  Buffer              The pointer to the buffer to contain the option list.
+
+  @return     Index               The count of the built-in options.
+
+**/
+UINT32
+HttpBootBuildDhcp6Options (
+  IN  HTTP_BOOT_PRIVATE_DATA       *Private,
+  OUT EFI_DHCP6_PACKET_OPTION      **OptList,
+  IN  UINT8                        *Buffer
+  )
+{
+  HTTP_BOOT_DHCP6_OPTION_ENTRY     OptEnt;
+  UINT16                           Value;
+  UINT32                           Index;
+
+  Index      = 0;
+  OptList[0] = (EFI_DHCP6_PACKET_OPTION *) Buffer;
+
+  //
+  // Append client option request option
+  //
+  OptList[Index]->OpCode     = HTONS (HTTP_BOOT_DHCP6_OPT_ORO);
+  OptList[Index]->OpLen      = HTONS (8);
+  OptEnt.Oro                 = (HTTP_BOOT_DHCP6_OPTION_ORO *) OptList[Index]->Data;
+  OptEnt.Oro->OpCode[0]      = HTONS(HTTP_BOOT_DHCP6_OPT_BOOT_FILE_URL);
+  OptEnt.Oro->OpCode[1]      = HTONS(HTTP_BOOT_DHCP6_OPT_BOOT_FILE_PARAM);
+  OptEnt.Oro->OpCode[2]      = HTONS(HTTP_BOOT_DHCP6_OPT_DNS_SERVERS);
+  OptEnt.Oro->OpCode[3]      = HTONS(HTTP_BOOT_DHCP6_OPT_VENDOR_CLASS);
+  Index++;
+  OptList[Index]             = GET_NEXT_DHCP6_OPTION (OptList[Index - 1]);
+
+  //
+  // Append client network device interface option
+  //
+  OptList[Index]->OpCode     = HTONS (HTTP_BOOT_DHCP6_OPT_UNDI);
+  OptList[Index]->OpLen      = HTONS ((UINT16)3);
+  OptEnt.Undi                = (HTTP_BOOT_DHCP6_OPTION_UNDI *) OptList[Index]->Data;
+
+  if (Private->Nii != NULL) {
+    OptEnt.Undi->Type        = Private->Nii->Type;
+    OptEnt.Undi->MajorVer    = Private->Nii->MajorVer;
+    OptEnt.Undi->MinorVer    = Private->Nii->MinorVer;
+  } else {
+    OptEnt.Undi->Type        = DEFAULT_UNDI_TYPE;
+    OptEnt.Undi->MajorVer    = DEFAULT_UNDI_MAJOR;
+    OptEnt.Undi->MinorVer    = DEFAULT_UNDI_MINOR;
+  }
+
+  Index++;
+  OptList[Index]             = GET_NEXT_DHCP6_OPTION (OptList[Index - 1]);
+
+  //
+  // Append client system architecture option
+  //
+  OptList[Index]->OpCode     = HTONS (HTTP_BOOT_DHCP6_OPT_ARCH);
+  OptList[Index]->OpLen      = HTONS ((UINT16) sizeof (HTTP_BOOT_DHCP6_OPTION_ARCH));
+  OptEnt.Arch                = (HTTP_BOOT_DHCP6_OPTION_ARCH *) OptList[Index]->Data;
+  Value                      = HTONS (EFI_HTTP_BOOT_CLIENT_SYSTEM_ARCHITECTURE);
+  CopyMem (&OptEnt.Arch->Type, &Value, sizeof (UINT16));
+  Index++;
+  OptList[Index]             = GET_NEXT_DHCP6_OPTION (OptList[Index - 1]);
+
+  //
+  // Append vendor class identify option.
+  //
+  OptList[Index]->OpCode       = HTONS (HTTP_BOOT_DHCP6_OPT_VENDOR_CLASS);
+  OptList[Index]->OpLen        = HTONS ((UINT16) sizeof (HTTP_BOOT_DHCP6_OPTION_VENDOR_CLASS));
+  OptEnt.VendorClass           = (HTTP_BOOT_DHCP6_OPTION_VENDOR_CLASS *) OptList[Index]->Data;
+  OptEnt.VendorClass->Vendor   = HTONL (HTTP_BOOT_DHCP6_ENTERPRISE_NUM);
+  OptEnt.VendorClass->ClassLen = HTONS ((UINT16) sizeof (HTTP_BOOT_CLASS_ID));
+  CopyMem (
+    &OptEnt.VendorClass->ClassId,
+    DEFAULT_CLASS_ID_DATA,
+    sizeof (HTTP_BOOT_CLASS_ID)
+    );
+  HttpBootUintnToAscDecWithFormat (
+    EFI_HTTP_BOOT_CLIENT_SYSTEM_ARCHITECTURE,
+    OptEnt.VendorClass->ClassId.ArchitectureType,
+    sizeof (OptEnt.VendorClass->ClassId.ArchitectureType)
+    );
+
+  if (Private->Nii != NULL) {
+    CopyMem (
+      OptEnt.VendorClass->ClassId.InterfaceName,
+      Private->Nii->StringId,
+      sizeof (OptEnt.VendorClass->ClassId.InterfaceName)
+      );
+    HttpBootUintnToAscDecWithFormat (
+      Private->Nii->MajorVer,
+      OptEnt.VendorClass->ClassId.UndiMajor,
+      sizeof (OptEnt.VendorClass->ClassId.UndiMajor)
+      );
+    HttpBootUintnToAscDecWithFormat (
+      Private->Nii->MinorVer,
+      OptEnt.VendorClass->ClassId.UndiMinor,
+      sizeof (OptEnt.VendorClass->ClassId.UndiMinor)
+      );
+  }
+
+  Index++;
+
+  return Index;
+}
+
+/**
+  Parse out a DHCPv6 option by OptTag, and find the position in buffer.
+
+  @param[in]  Buffer        The pointer to the option buffer.
+  @param[in]  Length        Length of the option buffer.
+  @param[in]  OptTag        The required option tag.
+
+  @retval     NULL          Failed to parse the required option.
+  @retval     Others        The postion of the required option in buffer.
+
+**/
+EFI_DHCP6_PACKET_OPTION *
+HttpBootParseDhcp6Options (
+  IN UINT8                       *Buffer,
+  IN UINT32                      Length,
+  IN UINT16                      OptTag
+  )
+{
+  EFI_DHCP6_PACKET_OPTION        *Option;
+  UINT32                         Offset;
+
+  Option  = (EFI_DHCP6_PACKET_OPTION *) Buffer;
+  Offset  = 0;
+
+  //
+  // OpLen and OpCode here are both stored in network order.
+  //
+  while (Offset < Length) {
+
+    if (NTOHS (Option->OpCode) == OptTag) {
+
+      return Option;
+    }
+
+    Offset += (NTOHS(Option->OpLen) + 4);
+    Option  = (EFI_DHCP6_PACKET_OPTION *) (Buffer + Offset);
+  }
+
+  return NULL;
+
+}
+
+/**
+  Parse the cached DHCPv6 packet, including all the options.
+
+  @param[in]  Cache6           The pointer to a cached DHCPv6 packet.
+
+  @retval     EFI_SUCCESS      Parsed the DHCPv6 packet successfully.
+  @retval     EFI_DEVICE_ERROR Failed to parse and invalid the packet.
+
+**/
+EFI_STATUS
+HttpBootParseDhcp6Packet (
+  IN  HTTP_BOOT_DHCP6_PACKET_CACHE    *Cache6
+  )
+{
+  EFI_DHCP6_PACKET               *Offer;
+  EFI_DHCP6_PACKET_OPTION        **Options;
+  EFI_DHCP6_PACKET_OPTION        *Option;
+  HTTP_BOOT_OFFER_TYPE           OfferType;
+  EFI_IPv6_ADDRESS               IpAddr;
+  BOOLEAN                        IsProxyOffer;
+  BOOLEAN                        IsHttpOffer;
+  BOOLEAN                        IsDnsOffer;
+  BOOLEAN                        IpExpressedUri;
+  EFI_STATUS                     Status;
+  UINT32                         Offset;
+  UINT32                         Length;
+  
+  IsDnsOffer     = FALSE;
+  IpExpressedUri = FALSE;
+  IsProxyOffer   = TRUE;
+  IsHttpOffer    = FALSE;
+  Offer        = &Cache6->Packet.Offer;
+  Options      = Cache6->OptList;
+  
+  ZeroMem (Cache6->OptList, sizeof (Cache6->OptList));
+
+  Option  = (EFI_DHCP6_PACKET_OPTION *) (Offer->Dhcp6.Option);
+  Offset  = 0;
+  Length  = GET_DHCP6_OPTION_SIZE (Offer);
+
+  //
+  // OpLen and OpCode here are both stored in network order, since they are from original packet.
+  //
+  while (Offset < Length) {
+
+    if (NTOHS (Option->OpCode) == HTTP_BOOT_DHCP6_OPT_IA_NA) {
+      Options[HTTP_BOOT_DHCP6_IDX_IA_NA] = Option;
+    } else if (NTOHS (Option->OpCode) == HTTP_BOOT_DHCP6_OPT_BOOT_FILE_URL) {
+      //
+      // The server sends this option to inform the client about an URL to a boot file.
+      //
+      Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL] = Option;
+    } else if (NTOHS (Option->OpCode) == HTTP_BOOT_DHCP6_OPT_BOOT_FILE_PARAM) {
+      Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_PARAM] = Option;
+    } else if (NTOHS (Option->OpCode) == HTTP_BOOT_DHCP6_OPT_VENDOR_CLASS) {
+      Options[HTTP_BOOT_DHCP6_IDX_VENDOR_CLASS] = Option;
+    } else if (NTOHS (Option->OpCode) == HTTP_BOOT_DHCP6_OPT_DNS_SERVERS) {
+      Options[HTTP_BOOT_DHCP6_IDX_DNS_SERVER] = Option;
+    }
+
+    Offset += (NTOHS (Option->OpLen) + 4);
+    Option  = (EFI_DHCP6_PACKET_OPTION *) (Offer->Dhcp6.Option + Offset);
+  }
+  //
+  // The offer with assigned client address is NOT a proxy offer.
+  // An ia_na option, embeded with valid ia_addr option and a status_code of success.
+  //
+  Option = Options[HTTP_BOOT_DHCP6_IDX_IA_NA];
+  if (Option != NULL) {
+    Option = HttpBootParseDhcp6Options (
+               Option->Data + 12,
+               NTOHS (Option->OpLen),
+               HTTP_BOOT_DHCP6_OPT_STATUS_CODE
+               );
+    if ((Option != NULL && Option->Data[0] == 0) || (Option == NULL)) {
+      IsProxyOffer = FALSE;
+    }
+  }
+
+  //
+  // The offer with "HTTPClient" is a Http offer.
+  //
+  Option = Options[HTTP_BOOT_DHCP6_IDX_VENDOR_CLASS];
+
+  if (Option != NULL &&
+      NTOHS(Option->OpLen) >= 10 &&
+      CompareMem (Option->Data, DEFAULT_CLASS_ID_DATA, 10) == 0) {
+      IsHttpOffer = TRUE;
+  }
+
+  //
+  // The offer with Domain Server is a DNS offer.
+  //
+  Option = Options[HTTP_BOOT_DHCP6_IDX_DNS_SERVER];
+  if (Option != NULL) {
+    IsDnsOffer = TRUE;
+  }
+
+  //
+  // Http offer must have a boot URI.
+  //
+  if (IsHttpOffer && Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL] == NULL) {
+    return EFI_DEVICE_ERROR;
+  }
+ 
+  //
+  // Try to retrieve the IP of HTTP server from URI. 
+  //
+  if (IsHttpOffer) {
+    Status = HttpParseUrl (
+               (CHAR8*) Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data,
+               (UINT32) AsciiStrLen ((CHAR8*) Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data),
+               FALSE,
+               &Cache6->UriParser
+               );
+    if (EFI_ERROR (Status)) {
+      return EFI_DEVICE_ERROR;
+    }
+
+    Status = HttpUrlGetIp6 (
+               (CHAR8*) Options[HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL]->Data,
+               Cache6->UriParser,
+               &IpAddr
+               );
+    IpExpressedUri = !EFI_ERROR (Status);
+  }
+
+  //
+  // Determine offer type of the DHCPv6 packet.
+  //
+  if (IsHttpOffer) {
+    if (IpExpressedUri) {
+      OfferType = IsProxyOffer ? HttpOfferTypeProxyIpUri : HttpOfferTypeDhcpIpUri;
+    } else {
+      if (!IsProxyOffer) {
+        OfferType = IsDnsOffer ? HttpOfferTypeDhcpNameUriDns : HttpOfferTypeDhcpNameUri;
+      } else {
+        OfferType = HttpOfferTypeProxyNameUri;
+      }
+    }
+
+  } else {
+    if (!IsProxyOffer) {
+      OfferType = IsDnsOffer ? HttpOfferTypeDhcpDns : HttpOfferTypeDhcpOnly;
+    } else {
+      return EFI_DEVICE_ERROR;
+    }
+  }
+  
+  Cache6->OfferType = OfferType;
+  return EFI_SUCCESS;
+}
+
+/**
+  Cache the DHCPv6 packet.
+
+  @param[in]  Dst          The pointer to the cache buffer for DHCPv6 packet.
+  @param[in]  Src          The pointer to the DHCPv6 packet to be cached.
+
+**/
+VOID
+HttpBootCacheDhcp6Packet (
+  IN EFI_DHCP6_PACKET          *Dst,
+  IN EFI_DHCP6_PACKET          *Src
+  )
+{
+  ASSERT (Dst->Size >= Src->Length);
+
+  CopyMem (&Dst->Dhcp6, &Src->Dhcp6, Src->Length);
+  Dst->Length = Src->Length;
+}
+
+/**
+  Cache all the received DHCPv6 offers, and set OfferIndex and OfferCount.
+
+  @param[in]  Private               The pointer to HTTP_BOOT_PRIVATE_DATA.
+  @param[in]  RcvdOffer             The pointer to the received offer packet.
+
+**/
+VOID
+HttpBootCacheDhcp6Offer (
+  IN HTTP_BOOT_PRIVATE_DATA  *Private,
+  IN EFI_DHCP6_PACKET        *RcvdOffer
+  )
+{
+  HTTP_BOOT_DHCP6_PACKET_CACHE   *Cache6;
+  EFI_DHCP6_PACKET               *Offer;
+  HTTP_BOOT_OFFER_TYPE           OfferType;
+
+  Cache6 = &Private->OfferBuffer[Private->OfferNum].Dhcp6;
+  Offer  = &Cache6->Packet.Offer;
+
+  //
+  // Cache the content of DHCPv6 packet firstly.
+  //
+  HttpBootCacheDhcp6Packet(Offer, RcvdOffer);
+
+  //
+  // Validate the DHCPv6 packet, and parse the options and offer type.
+  //
+  if (EFI_ERROR (HttpBootParseDhcp6Packet (Cache6))) {
+    return ;
+  }
+
+  //
+  // Determine whether cache the current offer by type, and record OfferIndex and OfferCount.
+  //
+  OfferType = Cache6->OfferType;
+  ASSERT (OfferType < HttpOfferTypeMax);
+  ASSERT (Private->OfferCount[OfferType] < HTTP_BOOT_OFFER_MAX_NUM);
+  Private->OfferIndex[OfferType][Private->OfferCount[OfferType]] = Private->OfferNum;
+  Private->OfferCount[OfferType]++;
+  Private->OfferNum++;  
+}
+
+/**
+  EFI_DHCP6_CALLBACK is provided by the consumer of the EFI DHCPv6 Protocol driver
+  to intercept events that occurred in the configuration process.
+
+  @param[in]  This              The pointer to the EFI DHCPv6 Protocol.
+  @param[in]  Context           The pointer to the context set by EFI_DHCP6_PROTOCOL.Configure().
+  @param[in]  CurrentState      The current operational state of the EFI DHCPv Protocol driver.
+  @param[in]  Dhcp6Event        The event that occurs in the current state, which usually means a
+                                state transition.
+  @param[in]  Packet            The DHCPv6 packet that is going to be sent or was already received.
+  @param[out] NewPacket         The packet that is used to replace the Packet above.
+
+  @retval EFI_SUCCESS           Told the EFI DHCPv6 Protocol driver to continue the DHCP process.
+  @retval EFI_NOT_READY         Only used in the Dhcp6Selecting state. The EFI DHCPv6 Protocol
+                                driver will continue to wait for more packets.
+  @retval EFI_ABORTED           Told the EFI DHCPv6 Protocol driver to abort the current process.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootDhcp6CallBack (
+  IN  EFI_DHCP6_PROTOCOL           *This,
+  IN  VOID                         *Context,
+  IN  EFI_DHCP6_STATE              CurrentState,
+  IN  EFI_DHCP6_EVENT              Dhcp6Event,
+  IN  EFI_DHCP6_PACKET             *Packet,
+  OUT EFI_DHCP6_PACKET             **NewPacket     OPTIONAL
+  )
+{
+   HTTP_BOOT_PRIVATE_DATA          *Private;
+   EFI_DHCP6_PACKET                *SelectAd;
+   EFI_STATUS                      Status;
+   if ((Dhcp6Event != Dhcp6RcvdAdvertise) && (Dhcp6Event != Dhcp6SelectAdvertise)) {
+     return EFI_SUCCESS;
+   }
+
+   ASSERT (Packet != NULL);
+   
+   Private     = (HTTP_BOOT_PRIVATE_DATA *) Context;
+   Status = EFI_SUCCESS;
+   switch (Dhcp6Event) {
+    
+   case Dhcp6RcvdAdvertise:
+     Status = EFI_NOT_READY;
+     if (Private->OfferNum < HTTP_BOOT_OFFER_MAX_NUM) {
+       //
+       // Cache the dhcp offers to OfferBuffer[] for select later, and record
+       // the OfferIndex and OfferCount.
+       //
+       HttpBootCacheDhcp6Offer (Private, Packet);
+     }
+     break;
+
+   case Dhcp6SelectAdvertise:
+     //
+     // Select offer by the default policy or by order, and record the SelectIndex
+     // and SelectProxyType.
+     //
+     HttpBootSelectDhcpOffer (Private);
+
+     if (Private->SelectIndex == 0) {
+       Status = EFI_ABORTED;
+     } else {
+       ASSERT (NewPacket != NULL);
+       SelectAd   = &Private->OfferBuffer[Private->SelectIndex - 1].Dhcp6.Packet.Offer;
+       *NewPacket = AllocateZeroPool (SelectAd->Size);
+       ASSERT (*NewPacket != NULL);
+       CopyMem (*NewPacket, SelectAd, SelectAd->Size);
+     }
+     break;
+     
+   default:
+     break;
+  }
+
+  return Status;   
+}
+
+/**
+  Check whether IP driver could route the message which will be sent to ServerIp address.
+  
+  This function will check the IP6 route table every 1 seconds until specified timeout is expired, if a valid
+  route is found in IP6 route table, the address will be filed in GatewayAddr and return.
+
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+  @param[in]  TimeOutInSecond     Timeout value in seconds.
+  @param[out] GatewayAddr         Pointer to store the gateway IP address.
+
+  @retval     EFI_SUCCESS         Found a valid gateway address successfully.
+  @retval     EFI_TIMEOUT         The operation is time out.
+  @retval     Other               Unexpect error happened.
+  
+**/
+EFI_STATUS
+HttpBootCheckRouteTable (
+  IN  HTTP_BOOT_PRIVATE_DATA        *Private,
+  IN  UINTN                         TimeOutInSecond,
+  OUT EFI_IPv6_ADDRESS              *GatewayAddr
+  )
+{
+  EFI_STATUS                       Status;
+  EFI_IP6_PROTOCOL                 *Ip6;
+  EFI_IP6_MODE_DATA                Ip6ModeData;
+  UINTN                            Index;
+  EFI_EVENT                        TimeOutEvt;
+  UINTN                            RetryCount;
+  BOOLEAN                          GatewayIsFound;
+
+  ASSERT (GatewayAddr != NULL);
+  ASSERT (Private != NULL);
+
+  Ip6            = Private->Ip6;
+  GatewayIsFound = FALSE;
+  RetryCount     = 0;
+  TimeOutEvt     = NULL;
+  Status         = EFI_SUCCESS;
+  ZeroMem (GatewayAddr, sizeof (EFI_IPv6_ADDRESS));
+
+  while (TRUE) {
+    Status = Ip6->GetModeData (Ip6, &Ip6ModeData, NULL, NULL);
+    if (EFI_ERROR (Status)) {
+      goto ON_EXIT;
+    }
+    
+    //
+    // Find out the gateway address which can route the message which send to ServerIp.
+    //
+    for (Index = 0; Index < Ip6ModeData.RouteCount; Index++) {
+      if (NetIp6IsNetEqual (&Private->ServerIp.v6, &Ip6ModeData.RouteTable[Index].Destination, Ip6ModeData.RouteTable[Index].PrefixLength)) {
+        IP6_COPY_ADDRESS (GatewayAddr, &Ip6ModeData.RouteTable[Index].Gateway);
+        GatewayIsFound = TRUE;
+        break;
+      }
+    }
+
+    if (Ip6ModeData.AddressList != NULL) {
+      FreePool (Ip6ModeData.AddressList);
+    }
+    if (Ip6ModeData.GroupTable != NULL) {
+      FreePool (Ip6ModeData.GroupTable);
+    }
+    if (Ip6ModeData.RouteTable != NULL) {
+      FreePool (Ip6ModeData.RouteTable);
+    }
+    if (Ip6ModeData.NeighborCache != NULL) {
+      FreePool (Ip6ModeData.NeighborCache);
+    }
+    if (Ip6ModeData.PrefixTable != NULL) {
+      FreePool (Ip6ModeData.PrefixTable);
+    }
+    if (Ip6ModeData.IcmpTypeList != NULL) {
+      FreePool (Ip6ModeData.IcmpTypeList);
+    }
+    
+    if (GatewayIsFound || RetryCount == TimeOutInSecond) {
+      break;
+    }
+    
+    RetryCount++;
+    
+    //
+    // Delay 1 second then recheck it again.
+    //
+    if (TimeOutEvt == NULL) {
+      Status = gBS->CreateEvent (
+                      EVT_TIMER,
+                      TPL_CALLBACK,
+                      NULL,
+                      NULL,
+                      &TimeOutEvt
+                      );
+      if (EFI_ERROR (Status)) {
+        goto ON_EXIT;
+      }
+    }
+
+    Status = gBS->SetTimer (TimeOutEvt, TimerRelative, TICKS_PER_SECOND);
+    if (EFI_ERROR (Status)) {
+      goto ON_EXIT;
+    }
+    while (EFI_ERROR (gBS->CheckEvent (TimeOutEvt))) {
+      Ip6->Poll (Ip6);
+    }
+  }
+  
+ON_EXIT:
+  if (TimeOutEvt != NULL) {
+    gBS->CloseEvent (TimeOutEvt);
+  }
+  
+  if (GatewayIsFound) {
+    Status = EFI_SUCCESS;
+  } else if (RetryCount == TimeOutInSecond) {
+    Status = EFI_TIMEOUT;
+  }
+
+  return Status; 
+}
+
+/**
+  Set the IP6 policy to Automatic.
+
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         Switch the IP policy succesfully.
+  @retval     Others              Unexpect error happened.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Policy (
+  IN HTTP_BOOT_PRIVATE_DATA        *Private
+  )
+{
+  EFI_IP6_CONFIG_POLICY            Policy;
+  EFI_IP6_CONFIG_PROTOCOL          *Ip6Config;
+  EFI_STATUS                       Status;
+  UINTN                            DataSize;
+
+  Ip6Config       = Private->Ip6Config;
+  DataSize        = sizeof (EFI_IP6_CONFIG_POLICY);
+  
+  //
+  // Get and store the current policy of IP6 driver.
+  //
+  Status = Ip6Config->GetData (
+                        Ip6Config,
+                        Ip6ConfigDataTypePolicy,
+                        &DataSize,
+                        &Policy
+                        );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if (Policy == Ip6ConfigPolicyManual) {
+    Policy = Ip6ConfigPolicyAutomatic;
+    Status = Ip6Config->SetData (
+                          Ip6Config,
+                          Ip6ConfigDataTypePolicy,
+                          sizeof(EFI_IP6_CONFIG_POLICY),
+                          &Policy
+                          );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  This function will register the default DNS addresses to the network device.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+  @param[in]  DataLength          Size of the buffer pointed to by DnsServerData in bytes.
+  @param[in]  DnsServerData       Point a list of DNS server address in an array
+                                  of EFI_IPv6_ADDRESS instances.
+
+  @retval     EFI_SUCCESS         The DNS configuration has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Dns (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private,
+  IN UINTN                          DataLength,
+  IN VOID                           *DnsServerData
+  )
+{
+  EFI_IP6_CONFIG_PROTOCOL        *Ip6Config;
+  
+  ASSERT (Private->UsingIpv6);
+
+  Ip6Config = Private->Ip6Config;
+  
+  return Ip6Config->SetData (
+                      Ip6Config,
+                      Ip6ConfigDataTypeDnsServer,
+                      DataLength,
+                      DnsServerData
+                      );
+}
+
+/**
+  This function will register the IPv6 gateway address to the network device.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         The new IP configuration has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Gateway (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+  )
+{
+  EFI_IP6_CONFIG_PROTOCOL           *Ip6Config;
+  EFI_STATUS                        Status;
+
+  ASSERT (Private->UsingIpv6);
+  Ip6Config = Private->Ip6Config;
+ 
+  //
+  // Set the default gateway address. 
+  //
+  if (!Private->NoGateway && !NetIp6IsUnspecifiedAddr (&Private->GatewayIp.v6)) {
+    Status = Ip6Config->SetData (
+                          Ip6Config,
+                          Ip6ConfigDataTypeGateway,
+                          sizeof (EFI_IPv6_ADDRESS),
+                          &Private->GatewayIp.v6
+                          );
+    if (EFI_ERROR(Status)) {
+      return Status;
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  This function will register the station IP address.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         The new IP address has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Address (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+)
+{
+  EFI_STATUS                         Status;
+  EFI_IP6_PROTOCOL                   *Ip6;
+  EFI_IP6_CONFIG_PROTOCOL            *Ip6Cfg;
+  EFI_IP6_CONFIG_POLICY              Policy;
+  EFI_IP6_CONFIG_MANUAL_ADDRESS      CfgAddr;
+  EFI_IPv6_ADDRESS                   *Ip6Addr;
+  EFI_IPv6_ADDRESS                   GatewayAddr;
+  EFI_IP6_CONFIG_DATA                Ip6CfgData;
+  EFI_EVENT                          MappedEvt; 
+  UINTN                              DataSize;
+  BOOLEAN                            IsAddressOk;
+  UINTN                              Index;
+
+  ASSERT (Private->UsingIpv6);
+  
+  MappedEvt   = NULL;
+  IsAddressOk = FALSE;
+  Ip6Addr     = NULL;
+  Ip6Cfg      = Private->Ip6Config;
+  Ip6         = Private->Ip6;
+  
+  ZeroMem (&CfgAddr, sizeof (EFI_IP6_CONFIG_MANUAL_ADDRESS));
+  CopyMem (&CfgAddr, &Private->StationIp.v6, sizeof (EFI_IPv6_ADDRESS));
+  ZeroMem (&Ip6CfgData, sizeof (EFI_IP6_CONFIG_DATA));
+  
+  Ip6CfgData.AcceptIcmpErrors    = TRUE;
+  Ip6CfgData.DefaultProtocol     = IP6_ICMP;
+  Ip6CfgData.HopLimit            = HTTP_BOOT_DEFAULT_HOPLIMIT;
+  Ip6CfgData.ReceiveTimeout      = HTTP_BOOT_DEFAULT_LIFETIME;
+  Ip6CfgData.TransmitTimeout     = HTTP_BOOT_DEFAULT_LIFETIME;
+    
+  Status = Ip6->Configure (Ip6, &Ip6CfgData);
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+
+  //
+  // Retrieve the gateway address from IP6 route table.
+  //
+  Status = HttpBootCheckRouteTable (Private, HTTP_BOOT_IP6_ROUTE_TABLE_TIMEOUT, &GatewayAddr);
+  if (EFI_ERROR (Status)) {
+    Private->NoGateway = TRUE;
+  } else {
+    IP6_COPY_ADDRESS (&Private->GatewayIp.v6, &GatewayAddr);
+  }
+
+  //
+  // Set the new address by Ip6ConfigProtocol manually.
+  //
+  Policy = Ip6ConfigPolicyManual;
+  Status = Ip6Cfg->SetData (
+                     Ip6Cfg,
+                     Ip6ConfigDataTypePolicy,
+                     sizeof(EFI_IP6_CONFIG_POLICY),
+                     &Policy
+                     );
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+  
+  //
+  // Create a notify event to set address flag when DAD if IP6 driver succeeded.
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  HttpBootCommonNotify,
+                  &IsAddressOk,
+                  &MappedEvt
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+  
+  //
+  // Set static host ip6 address. This is a asynchronous process.
+  //
+  Status = Ip6Cfg->RegisterDataNotify (
+                     Ip6Cfg,
+                     Ip6ConfigDataTypeManualAddress,
+                     MappedEvt
+                     );
+  if (EFI_ERROR(Status)) {
+    goto ON_EXIT;
+  }
+
+  Status = Ip6Cfg->SetData (
+                     Ip6Cfg,
+                     Ip6ConfigDataTypeManualAddress,
+                     sizeof (EFI_IP6_CONFIG_MANUAL_ADDRESS),
+                     &CfgAddr
+                     ); 
+  if (EFI_ERROR (Status) && Status != EFI_NOT_READY) {
+    goto ON_EXIT;
+  } else if (Status == EFI_NOT_READY) {
+    //
+    // Poll the network until the asynchronous process is finished.
+    //
+    while (!IsAddressOk) {
+      Ip6->Poll (Ip6);
+    }
+    //
+    // Check whether the Ip6 Address setting is successed.
+    //
+    DataSize = 0;
+    Status = Ip6Cfg->GetData (
+                       Ip6Cfg,
+                       Ip6ConfigDataTypeManualAddress,
+                       &DataSize,
+                       NULL
+                       );
+    if (Status != EFI_BUFFER_TOO_SMALL || DataSize == 0) {
+      Status = EFI_DEVICE_ERROR;
+      goto ON_EXIT;
+    }
+    
+    Ip6Addr = AllocatePool (DataSize);
+    if (Ip6Addr == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    Status = Ip6Cfg->GetData (
+                       Ip6Cfg,
+                       Ip6ConfigDataTypeManualAddress,
+                       &DataSize,
+                       (VOID *) Ip6Addr
+                       );
+    if (EFI_ERROR (Status)) {
+      Status = EFI_DEVICE_ERROR;
+      goto ON_EXIT;
+    }
+
+    for (Index = 0; Index < DataSize / sizeof (EFI_IPv6_ADDRESS); Index ++) {
+      if (CompareMem (Ip6Addr + Index, &CfgAddr, sizeof (EFI_IPv6_ADDRESS)) == 0) {
+        break;
+      }
+    }
+    if (Index == DataSize / sizeof (EFI_IPv6_ADDRESS)) {
+      Status = EFI_ABORTED;
+      goto ON_EXIT;
+    } 
+  }
+    
+ON_EXIT:
+  if (MappedEvt != NULL) {
+    Ip6Cfg->UnregisterDataNotify (
+              Ip6Cfg,
+              Ip6ConfigDataTypeManualAddress,
+              MappedEvt
+              );
+    gBS->CloseEvent (MappedEvt);
+  }
+
+  if (Ip6Addr != NULL) {
+    FreePool (Ip6Addr);
+  }
+  
+  return Status;    
+}
+
+/**
+  Start the S.A.R.R DHCPv6 process to acquire the IPv6 address and other Http boot information.
+
+  @param[in]  Private           Pointer to HTTP_BOOT private data.
+
+  @retval EFI_SUCCESS           The S.A.R.R process successfully finished.
+  @retval Others                Failed to finish the S.A.R.R process.
+
+**/
+EFI_STATUS
+HttpBootDhcp6Sarr (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+  )
+{
+  EFI_DHCP6_PROTOCOL               *Dhcp6;
+  EFI_DHCP6_CONFIG_DATA            Config;
+  EFI_DHCP6_MODE_DATA              Mode;
+  EFI_DHCP6_RETRANSMISSION         *Retransmit;
+  EFI_DHCP6_PACKET_OPTION          *OptList[HTTP_BOOT_DHCP6_OPTION_MAX_NUM];
+  UINT32                           OptCount;
+  UINT8                            Buffer[HTTP_BOOT_DHCP6_OPTION_MAX_SIZE];
+  EFI_STATUS                       Status;
+
+  Dhcp6 = Private->Dhcp6;
+  ASSERT (Dhcp6 != NULL);
+
+  //
+  // Build options list for the request packet.
+  //
+  OptCount = HttpBootBuildDhcp6Options (Private, OptList, Buffer);
+  ASSERT (OptCount >0);
+  
+  Retransmit = AllocateZeroPool (sizeof (EFI_DHCP6_RETRANSMISSION));
+  if (Retransmit == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  
+  ZeroMem (&Mode, sizeof (EFI_DHCP6_MODE_DATA));
+  ZeroMem (&Config, sizeof (EFI_DHCP6_CONFIG_DATA));
+  
+  Config.OptionCount           = OptCount;
+  Config.OptionList            = OptList;
+  Config.Dhcp6Callback         = HttpBootDhcp6CallBack;
+  Config.CallbackContext       = Private;
+  Config.IaInfoEvent           = NULL;
+  Config.RapidCommit           = FALSE;
+  Config.ReconfigureAccept     = FALSE;
+  Config.IaDescriptor.IaId     = NET_RANDOM (NetRandomInitSeed ());
+  Config.IaDescriptor.Type     = EFI_DHCP6_IA_TYPE_NA;
+  Config.SolicitRetransmission = Retransmit;
+  Retransmit->Irt              = 4;
+  Retransmit->Mrc              = 4;
+  Retransmit->Mrt              = 32;
+  Retransmit->Mrd              = 60;
+  
+  //
+  // Configure the DHCPv6 instance for HTTP boot.
+  //
+  Status = Dhcp6->Configure (Dhcp6, &Config);
+  FreePool (Retransmit);
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+  //
+  // Initialize the record fields for DHCPv6 offer in private data.
+  //
+  Private->OfferNum      = 0;
+  Private->SelectIndex   = 0;
+  ZeroMem (Private->OfferCount, sizeof (Private->OfferCount));
+  ZeroMem (Private->OfferIndex, sizeof (Private->OfferIndex));
+  
+  //
+  // Start DHCPv6 S.A.R.R. process to acquire IPv6 address.
+  //
+  Status = Dhcp6->Start (Dhcp6);
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+  
+  //
+  // Get the acquired IPv6 address and store them.
+  //
+  Status = Dhcp6->GetModeData (Dhcp6, &Mode, NULL);
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
+  
+  ASSERT (Mode.Ia->State == Dhcp6Bound);
+  CopyMem (&Private->StationIp.v6, &Mode.Ia->IaAddress[0].IpAddress, sizeof (EFI_IPv6_ADDRESS));
+  
+  AsciiPrint ("\n  Station IPv6 address is ");
+  HttpBootShowIp6Addr (&Private->StationIp.v6);
+  AsciiPrint ("\n");
+  
+ON_EXIT:
+  if (EFI_ERROR (Status)) {
+    Dhcp6->Stop (Dhcp6);
+    Dhcp6->Configure (Dhcp6, NULL);
+  } else {
+    ZeroMem (&Config, sizeof (EFI_DHCP6_CONFIG_DATA));
+    ZeroMem (&Mode, sizeof (EFI_DHCP6_MODE_DATA));
+    Dhcp6->Configure (Dhcp6, &Config);
+  }
+
+  return Status; 
+    
+}
+
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDhcp6.h b/NetworkPkg/HttpBootDxe/HttpBootDhcp6.h
new file mode 100644
index 000000000000..59ca19e464ff
--- /dev/null
+++ b/NetworkPkg/HttpBootDxe/HttpBootDhcp6.h
@@ -0,0 +1,198 @@
+/** @file
+  Functions declaration related with DHCPv6 for HTTP boot driver.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under 
+the terms and conditions of the BSD License that accompanies this distribution.  
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.                                          
+    
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+
+#ifndef __EFI_HTTP_BOOT_DHCP6_H__
+#define __EFI_HTTP_BOOT_DHCP6_H__
+
+#define HTTP_BOOT_OFFER_MAX_NUM                16
+#define HTTP_BOOT_DHCP6_OPTION_MAX_NUM         16
+#define HTTP_BOOT_DHCP6_OPTION_MAX_SIZE        312
+#define HTTP_BOOT_DHCP6_PACKET_MAX_SIZE        1472
+#define HTTP_BOOT_IP6_ROUTE_TABLE_TIMEOUT      10
+#define HTTP_BOOT_DEFAULT_HOPLIMIT             64
+#define HTTP_BOOT_DEFAULT_LIFETIME             50000
+
+
+#define HTTP_BOOT_DHCP6_OPT_CLIENT_ID         1
+#define HTTP_BOOT_DHCP6_OPT_SERVER_ID         2
+#define HTTP_BOOT_DHCP6_OPT_IA_NA             3
+#define HTTP_BOOT_DHCP6_OPT_IA_TA             4
+#define HTTP_BOOT_DHCP6_OPT_IAADDR            5
+#define HTTP_BOOT_DHCP6_OPT_ORO               6
+#define HTTP_BOOT_DHCP6_OPT_PREFERENCE        7
+#define HTTP_BOOT_DHCP6_OPT_ELAPSED_TIME      8
+#define HTTP_BOOT_DHCP6_OPT_REPLAY_MSG        9
+#define HTTP_BOOT_DHCP6_OPT_AUTH              11
+#define HTTP_BOOT_DHCP6_OPT_UNICAST           12
+#define HTTP_BOOT_DHCP6_OPT_STATUS_CODE       13
+#define HTTP_BOOT_DHCP6_OPT_RAPID_COMMIT      14
+#define HTTP_BOOT_DHCP6_OPT_USER_CLASS        15
+#define HTTP_BOOT_DHCP6_OPT_VENDOR_CLASS      16
+#define HTTP_BOOT_DHCP6_OPT_VENDOR_OPTS       17
+#define HTTP_BOOT_DHCP6_OPT_INTERFACE_ID      18
+#define HTTP_BOOT_DHCP6_OPT_RECONFIG_MSG      19
+#define HTTP_BOOT_DHCP6_OPT_RECONFIG_ACCEPT   20
+#define HTTP_BOOT_DHCP6_OPT_DNS_SERVERS       23
+#define HTTP_BOOT_DHCP6_OPT_BOOT_FILE_URL     59    // Assigned by IANA, RFC 5970
+#define HTTP_BOOT_DHCP6_OPT_BOOT_FILE_PARAM   60    // Assigned by IANA, RFC 5970
+#define HTTP_BOOT_DHCP6_OPT_ARCH              61    // Assigned by IANA, RFC 5970
+#define HTTP_BOOT_DHCP6_OPT_UNDI              62    // Assigned by IANA, RFC 5970
+#define HTTP_BOOT_DHCP6_ENTERPRISE_NUM        343   // TODO: IANA TBD: temporarily using Intel's
+#define HTTP_BOOT_DHCP6_MAX_BOOT_FILE_SIZE    65535 //   It's a limitation of bit length, 65535*512 bytes.
+
+#define HTTP_BOOT_DHCP6_IDX_IA_NA             0
+#define HTTP_BOOT_DHCP6_IDX_BOOT_FILE_URL     1
+#define HTTP_BOOT_DHCP6_IDX_BOOT_FILE_PARAM   2
+#define HTTP_BOOT_DHCP6_IDX_VENDOR_CLASS      3
+#define HTTP_BOOT_DHCP6_IDX_DNS_SERVER        4
+#define HTTP_BOOT_DHCP6_IDX_MAX               5
+
+#pragma pack(1)
+typedef struct {
+  UINT16 OpCode[256];
+} HTTP_BOOT_DHCP6_OPTION_ORO;
+
+typedef struct {
+  UINT8 Type;
+  UINT8 MajorVer;
+  UINT8 MinorVer;
+} HTTP_BOOT_DHCP6_OPTION_UNDI;
+
+typedef struct {
+  UINT16 Type;
+} HTTP_BOOT_DHCP6_OPTION_ARCH;
+
+typedef struct {
+  UINT8 ClassIdentifier[10];
+  UINT8 ArchitecturePrefix[5];
+  UINT8 ArchitectureType[5];
+  UINT8 Lit3[1];
+  UINT8 InterfaceName[4];
+  UINT8 Lit4[1];
+  UINT8 UndiMajor[3];
+  UINT8 UndiMinor[3];
+} HTTP_BOOT_CLASS_ID;
+
+typedef struct {
+  UINT32             Vendor;
+  UINT16             ClassLen;
+  HTTP_BOOT_CLASS_ID ClassId;
+} HTTP_BOOT_DHCP6_OPTION_VENDOR_CLASS;
+
+#pragma pack()
+
+typedef union {
+  HTTP_BOOT_DHCP6_OPTION_ORO            *Oro;
+  HTTP_BOOT_DHCP6_OPTION_UNDI           *Undi;
+  HTTP_BOOT_DHCP6_OPTION_ARCH           *Arch;
+  HTTP_BOOT_DHCP6_OPTION_VENDOR_CLASS   *VendorClass;
+} HTTP_BOOT_DHCP6_OPTION_ENTRY;
+
+typedef union {
+  EFI_DHCP6_PACKET        Offer;
+  EFI_DHCP6_PACKET        Ack;
+  UINT8                   Buffer[HTTP_BOOT_DHCP6_PACKET_MAX_SIZE];
+} HTTP_BOOT_DHCP6_PACKET;
+
+typedef struct {
+  HTTP_BOOT_DHCP6_PACKET      Packet;
+  HTTP_BOOT_OFFER_TYPE        OfferType;
+  EFI_DHCP6_PACKET_OPTION     *OptList[HTTP_BOOT_DHCP6_IDX_MAX];
+  VOID                        *UriParser;
+} HTTP_BOOT_DHCP6_PACKET_CACHE;
+
+#define GET_NEXT_DHCP6_OPTION(Opt) \
+  (EFI_DHCP6_PACKET_OPTION *) ((UINT8 *) (Opt) + \
+  sizeof (EFI_DHCP6_PACKET_OPTION) + (NTOHS ((Opt)->OpLen)) - 1)
+
+#define GET_DHCP6_OPTION_SIZE(Pkt)  \
+  ((Pkt)->Length - sizeof (EFI_DHCP6_HEADER))
+
+/**
+  Start the S.A.R.R DHCPv6 process to acquire the IPv6 address and other Http boot information.
+
+  @param[in]  Private           Pointer to HTTP_BOOT private data.
+
+  @retval EFI_SUCCESS           The S.A.R.R process successfully finished.
+  @retval Others                Failed to finish the S.A.R.R process.
+
+**/
+EFI_STATUS
+HttpBootDhcp6Sarr (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+  );
+
+/**
+  Set the IP6 policy to Automatic.
+
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         Switch the IP policy succesfully.
+  @retval     Others              Unexpect error happened.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Policy (
+  IN HTTP_BOOT_PRIVATE_DATA        *Private
+  );
+
+/**
+  This function will register the default DNS addresses to the network device.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+  @param[in]  DataLength          Size of the buffer pointed to by DnsServerData in bytes.
+  @param[in]  DnsServerData       Point a list of DNS server address in an array
+                                  of EFI_IPv6_ADDRESS instances.
+
+  @retval     EFI_SUCCESS         The DNS configuration has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Dns (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private,
+  IN UINTN                          DataLength,
+  IN VOID                           *DnsServerData
+  );
+
+/**
+  This function will register the IPv6 gateway address to the network device.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         The new IP configuration has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Gateway (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+  );
+
+/**
+  This function will register the station IP address.
+  
+  @param[in]  Private             The pointer to HTTP_BOOT_PRIVATE_DATA.
+
+  @retval     EFI_SUCCESS         The new IP address has been configured successfully.
+  @retval     Others              Failed to configure the address.
+
+**/
+EFI_STATUS
+HttpBootSetIp6Address (
+  IN HTTP_BOOT_PRIVATE_DATA         *Private
+  );
+
+#endif
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDxe.c b/NetworkPkg/HttpBootDxe/HttpBootDxe.c
index 49be59b8c8e3..a7fc8a8e2e63 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDxe.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootDxe.c
@@ -26,6 +26,15 @@ EFI_DRIVER_BINDING_PROTOCOL gHttpBootIp4DxeDriverBinding = {
   NULL
 };
 
+EFI_DRIVER_BINDING_PROTOCOL gHttpBootIp6DxeDriverBinding = {
+  HttpBootIp6DxeDriverBindingSupported,
+  HttpBootIp6DxeDriverBindingStart,
+  HttpBootIp6DxeDriverBindingStop,
+  HTTP_BOOT_DXE_VERSION,
+  NULL,
+  NULL
+};
+
 /**
   Destroy the HTTP child based on IPv4 stack.
 
@@ -45,11 +54,11 @@ HttpBootDestroyIp4Children (
 
   if (Private->Dhcp4Child != NULL) {
     gBS->CloseProtocol (
-          Private->Dhcp4Child,
-          &gEfiDhcp4ProtocolGuid,
-          This->DriverBindingHandle,
-          Private->Controller
-          );
+           Private->Dhcp4Child,
+           &gEfiDhcp4ProtocolGuid,
+           This->DriverBindingHandle,
+           Private->Controller
+           );
 
     NetLibDestroyServiceChild (
       Private->Controller,
@@ -64,25 +73,102 @@ HttpBootDestroyIp4Children (
     Private->HttpCreated = FALSE;
   }
 
-  gBS->CloseProtocol (
-         Private->Controller,
-         &gEfiCallerIdGuid,
-         This->DriverBindingHandle,
-         Private->ChildHandle
-         );
+  if (Private->Ip4Nic != NULL) {
+    
+    gBS->CloseProtocol (
+           Private->Controller,
+           &gEfiCallerIdGuid,
+           This->DriverBindingHandle,
+           Private->Ip4Nic->Controller
+           );
+    
+    gBS->UninstallMultipleProtocolInterfaces (
+           Private->Ip4Nic->Controller,
+           &gEfiLoadFileProtocolGuid,
+           &Private->Ip4Nic->LoadFile,
+           &gEfiDevicePathProtocolGuid,
+           Private->Ip4Nic->DevicePath,
+           NULL
+           );
+    FreePool (Private->Ip4Nic);
+    Private->Ip4Nic = NULL;
+  }
+
+}
+
+/**
+  Destroy the HTTP child based on IPv6 stack.
+
+  @param[in]  This              Pointer to the EFI_DRIVER_BINDING_PROTOCOL.
+  @param[in]  Private           Pointer to HTTP_BOOT_PRIVATE_DATA.
+
+**/
+VOID
+HttpBootDestroyIp6Children (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN HTTP_BOOT_PRIVATE_DATA       *Private
+  )
+{
+  ASSERT (This != NULL);
+  ASSERT (Private != NULL);
+  ASSERT (Private->UsingIpv6 == TRUE);
+  
+  if (Private->Ip6Child != NULL) {
+    gBS->CloseProtocol (
+           Private->Ip6Child,
+           &gEfiIp6ProtocolGuid,
+           This->DriverBindingHandle,
+           Private->Controller
+           );
+
+    NetLibDestroyServiceChild (
+      Private->Controller,
+      This->DriverBindingHandle,
+      &gEfiIp6ServiceBindingProtocolGuid,
+      Private->Ip6Child
+      );
+  }
+
+  if (Private->Dhcp6Child != NULL) {
+    gBS->CloseProtocol (
+           Private->Dhcp6Child,
+           &gEfiDhcp6ProtocolGuid,
+           This->DriverBindingHandle,
+           Private->Controller
+           );
 
-  gBS->UninstallMultipleProtocolInterfaces (
-         Private->ChildHandle,
-         &gEfiLoadFileProtocolGuid,
-         &Private->LoadFile,
-         &gEfiDevicePathProtocolGuid,
-         Private->DevicePath,
-         NULL
-         );
+    NetLibDestroyServiceChild (
+      Private->Controller,
+      This->DriverBindingHandle,
+      &gEfiDhcp6ServiceBindingProtocolGuid,
+      Private->Dhcp6Child
+      );
+  }
 
-  if (Private->DevicePath != NULL) {
-    FreePool (Private->DevicePath);
-    Private->DevicePath = NULL;
+  if (Private->HttpCreated) {
+    HttpIoDestroyIo(&Private->HttpIo);
+    Private->HttpCreated = FALSE;
+  }
+  
+  if (Private->Ip6Nic != NULL) {
+    
+    gBS->CloseProtocol (
+           Private->Controller,
+           &gEfiCallerIdGuid,
+           This->DriverBindingHandle,
+           Private->Ip6Nic->Controller
+           );
+    
+    gBS->UninstallMultipleProtocolInterfaces (
+           Private->Ip6Nic->Controller,
+           &gEfiLoadFileProtocolGuid,
+           &Private->Ip6Nic->LoadFile,
+           &gEfiDevicePathProtocolGuid,
+           Private->Ip6Nic->DevicePath,
+           NULL
+           );
+    FreePool (Private->Ip6Nic);
+    Private->Ip6Nic = NULL;
   }
 }
 
@@ -142,37 +228,37 @@ HttpBootIp4DxeDriverBindingSupported (
   // Try to open the DHCP4, HTTP4 and Device Path protocol.
   //
   Status = gBS->OpenProtocol (
-                   ControllerHandle,
-                   &gEfiDhcp4ServiceBindingProtocolGuid,
-                   NULL,
-                   This->DriverBindingHandle,
-                   ControllerHandle,
-                   EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                   );
+                  ControllerHandle,
+                  &gEfiDhcp4ServiceBindingProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
   if (EFI_ERROR (Status)) {
     return Status;
   }
 
   Status = gBS->OpenProtocol (
-                   ControllerHandle,
-                   &gEfiHttpServiceBindingProtocolGuid,
-                   NULL,
-                   This->DriverBindingHandle,
-                   ControllerHandle,
-                   EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                   );
+                  ControllerHandle,
+                  &gEfiHttpServiceBindingProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
   if (EFI_ERROR (Status)) {
     return Status;
   }
 
   Status = gBS->OpenProtocol (
-                   ControllerHandle,
-                   &gEfiDevicePathProtocolGuid,
-                   NULL,
-                   This->DriverBindingHandle,
-                   ControllerHandle,
-                   EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                   );
+                  ControllerHandle,
+                  &gEfiDevicePathProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
 
   return Status;
 }
@@ -235,25 +321,83 @@ HttpBootIp4DxeDriverBindingStart (
                   ControllerHandle,
                   EFI_OPEN_PROTOCOL_GET_PROTOCOL
                   );
+
   if (!EFI_ERROR (Status)) {
-    return EFI_ALREADY_STARTED;
-  }
+      Private = HTTP_BOOT_PRIVATE_DATA_FROM_ID(Id);
+  } else {
+    //
+    // Initialize the private data structure.
+    //
+    Private = AllocateZeroPool (sizeof (HTTP_BOOT_PRIVATE_DATA));
+    if (Private == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    Private->Signature = HTTP_BOOT_PRIVATE_DATA_SIGNATURE;
+    Private->Controller = ControllerHandle;
+    Private->Image = This->ImageHandle;
+    InitializeListHead (&Private->CacheList);
+    //
+    // Get the NII interface if it exists, it's not required.
+    //
+    Status = gBS->OpenProtocol (
+                    ControllerHandle,
+                    &gEfiNetworkInterfaceIdentifierProtocolGuid_31,
+                    (VOID **) &Private->Nii,
+                    This->DriverBindingHandle,
+                    ControllerHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      Private->Nii = NULL;
+    }
 
-  //
-  // Initialize the private data structure.
-  //
-  Private = AllocateZeroPool (sizeof (HTTP_BOOT_PRIVATE_DATA));
-  if (Private == NULL) {
+    //
+    // Open Device Path Protocol to prepare for appending IP and URI node.
+    //
+    Status = gBS->OpenProtocol (
+                    ControllerHandle,
+                    &gEfiDevicePathProtocolGuid,
+                    (VOID **) &Private->ParentDevicePath,
+                    This->DriverBindingHandle,
+                    ControllerHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+
+    //
+    // Install a protocol with Caller Id Guid to the NIC, this is just to build the relationship between
+    // NIC handle and the private data.
+    //
+    Status = gBS->InstallProtocolInterface (
+                    &ControllerHandle,
+                    &gEfiCallerIdGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &Private->Id
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+      
+  }
+  
+  if (Private->Ip4Nic != NULL) {
+    //
+    // Already created before
+    //
+    return EFI_SUCCESS;
+  }
+  
+  Private->Ip4Nic = AllocateZeroPool (sizeof (HTTP_BOOT_VIRTUAL_NIC));
+  if (Private->Ip4Nic == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
-  Private->Signature = HTTP_BOOT_PRIVATE_DATA_SIGNATURE;
-  Private->Controller = ControllerHandle;
-  Private->Image = This->ImageHandle;
-  Private->UsingIpv6 = FALSE;
-  InitializeListHead (&Private->CacheList);
-
+  Private->Ip4Nic->Private   = Private;
+  Private->Ip4Nic->Signature = HTTP_BOOT_VIRTUAL_NIC_SIGNATURE;
+  
   //
-  // Create DHCP child instance.
+  // Create DHCP4 child instance.
   //
   Status = NetLibCreateServiceChild (
              ControllerHandle,
@@ -264,7 +408,7 @@ HttpBootIp4DxeDriverBindingStart (
   if (EFI_ERROR (Status)) {
     goto ON_ERROR;
   }
-
+  
   Status = gBS->OpenProtocol (
                   Private->Dhcp4Child,
                   &gEfiDhcp4ProtocolGuid,
@@ -276,7 +420,7 @@ HttpBootIp4DxeDriverBindingStart (
   if (EFI_ERROR (Status)) {
     goto ON_ERROR;
   }
-
+  
   //
   // Get the Ip4Config2 protocol, it's required to configure the default gateway address.
   //
@@ -291,37 +435,7 @@ HttpBootIp4DxeDriverBindingStart (
   if (EFI_ERROR (Status)) {
     goto ON_ERROR;
   }
-
-  //
-  // Get the NII interface if it exists, it's not required.
-  //
-  Status = gBS->OpenProtocol (
-                  ControllerHandle,
-                  &gEfiNetworkInterfaceIdentifierProtocolGuid_31,
-                  (VOID **) &Private->Nii,
-                  This->DriverBindingHandle,
-                  ControllerHandle,
-                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
-                  );
-  if (EFI_ERROR (Status)) {
-    Private->Nii = NULL;
-  }
-
-  //
-  // Open Device Path Protocol to prepare for appending IP and URI node.
-  //
-  Status = gBS->OpenProtocol (
-                  ControllerHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  (VOID **) &Private->ParentDevicePath,
-                  This->DriverBindingHandle,
-                  ControllerHandle,
-                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
-                  );
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
-
+  
   //
   // Append IPv4 device path node.
   //
@@ -340,7 +454,7 @@ HttpBootIp4DxeDriverBindingStart (
     Status = EFI_OUT_OF_RESOURCES;
     goto ON_ERROR;
   }
-
+  
   //
   // Append URI device path node.
   //
@@ -352,62 +466,49 @@ HttpBootIp4DxeDriverBindingStart (
   Node->DevPath.Type = MESSAGING_DEVICE_PATH;
   Node->DevPath.SubType = MSG_URI_DP;
   SetDevicePathNodeLength (Node, sizeof (EFI_DEVICE_PATH_PROTOCOL));
-  Private->DevicePath = AppendDevicePathNode (DevicePath, (EFI_DEVICE_PATH_PROTOCOL*) Node);
+  Private->Ip4Nic->DevicePath = AppendDevicePathNode (DevicePath, (EFI_DEVICE_PATH_PROTOCOL*) Node);
   FreePool (Node);
   FreePool (DevicePath);
-  if (Private->DevicePath == NULL) {
+  if (Private->Ip4Nic->DevicePath == NULL) {
     Status = EFI_OUT_OF_RESOURCES;
     goto ON_ERROR;
   }
-
+  
   //
   // Create a child handle for the HTTP boot and install DevPath and Load file protocol on it.
   //
-  CopyMem (&Private->LoadFile, &gHttpBootDxeLoadFile, sizeof (Private->LoadFile));
+  CopyMem (&Private->Ip4Nic->LoadFile, &gHttpBootDxeLoadFile, sizeof (EFI_LOAD_FILE_PROTOCOL));
   Status = gBS->InstallMultipleProtocolInterfaces (
-                  &Private->ChildHandle,
+                  &Private->Ip4Nic->Controller,
                   &gEfiLoadFileProtocolGuid,
-                  &Private->LoadFile,
+                  &Private->Ip4Nic->LoadFile,
                   &gEfiDevicePathProtocolGuid,
-                  Private->DevicePath,
+                  Private->Ip4Nic->DevicePath,
                   NULL
                   );
   if (EFI_ERROR (Status)) {
     goto ON_ERROR;
   }
-
-  //
-  // Install a protocol with Caller Id Guid to the NIC, this is just to build the relationship between
-  // NIC handle and the private data.
-  //
-  Status = gBS->InstallProtocolInterface (
-                  &ControllerHandle,
-                  &gEfiCallerIdGuid,
-                  EFI_NATIVE_INTERFACE,
-                  &Private->Id
-                  );
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
-
+  
   //
   // Open the Caller Id child to setup a parent-child relationship between
-  // real NIC handle and the HTTP boot child handle.
+  // real NIC handle and the HTTP boot Ipv4 NIC handle.
   //
   Status = gBS->OpenProtocol (
                   ControllerHandle,
                   &gEfiCallerIdGuid,
                   (VOID **) &Id,
                   This->DriverBindingHandle,
-                  Private->ChildHandle,
+                  Private->Ip4Nic->Controller,
                   EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
                   );
   if (EFI_ERROR (Status)) {
     goto ON_ERROR;
   }
-
+  
   return EFI_SUCCESS;
 
+    
 ON_ERROR:
   
   HttpBootDestroyIp4Children (This, Private);
@@ -416,6 +517,7 @@ HttpBootIp4DxeDriverBindingStart (
   return Status;
 }
 
+
 /**
   Stops a device controller or a bus controller.
   
@@ -509,51 +611,560 @@ HttpBootIp4DxeDriverBindingStop (
   // Destory all child instance and uninstall protocol interface.
   //
   HttpBootDestroyIp4Children (This, Private);
+  
+  if (Private->Ip4Nic == NULL && Private->Ip6Nic == NULL) {
+    //
+    // Release the cached data.
+    //
+    HttpBootFreeCacheList (Private);
+    
+    gBS->UninstallProtocolInterface (
+           NicHandle,
+           &gEfiCallerIdGuid,
+           &Private->Id
+           );
+    FreePool (Private);
 
-  //
-  // Release the cached data.
-  //
-  HttpBootFreeCacheList (Private);
-
-  gBS->UninstallProtocolInterface (
-         NicHandle,
-         &gEfiCallerIdGuid,
-         &Private->Id
-         );
-  FreePool (Private);
+  }
 
   return EFI_SUCCESS;
 }
 
 /**
-  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.
+  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.
 
-  @param[in]  ImageHandle       The firmware allocated handle for the UEFI image.
-  @param[in]  SystemTable       A pointer to the EFI System Table.
+  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.
 
-  @retval EFI_SUCCESS           The operation completed successfully.
-  @retval Others                An unexpected error occurred.
+  @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.
 **/
 EFI_STATUS
 EFIAPI
-HttpBootDxeDriverEntryPoint (
-  IN EFI_HANDLE        ImageHandle,
-  IN EFI_SYSTEM_TABLE  *SystemTable
+HttpBootIp6DxeDriverBindingSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
   )
 {
+  EFI_STATUS                    Status;
+  
   //
-  // Install UEFI Driver Model protocol(s).
+  // Try to open the DHCP6, HTTP and Device Path protocol.
   //
-  return EfiLibInstallDriverBindingComponentName2 (
-           ImageHandle,
-           SystemTable,
-           &gHttpBootIp4DxeDriverBinding,
-           ImageHandle,
-           &gHttpBootDxeComponentName,
-           &gHttpBootDxeComponentName2
-           );
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiDhcp6ServiceBindingProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiHttpServiceBindingProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiDevicePathProtocolGuid,
+                  NULL,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                  );
+
+  return Status;
+
+}
+
+/**
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootIp6DxeDriverBindingStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
+  )
+{
+  EFI_STATUS                 Status;
+  HTTP_BOOT_PRIVATE_DATA     *Private;
+  EFI_DEV_PATH               *Node;
+  EFI_DEVICE_PATH_PROTOCOL   *DevicePath;
+  UINT32                     *Id;
+  
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiCallerIdGuid,
+                  (VOID **) &Id,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                  );
+  
+  if (!EFI_ERROR (Status)) {
+      Private = HTTP_BOOT_PRIVATE_DATA_FROM_ID(Id);
+  } else {
+    //
+    // Initialize the private data structure.
+    //
+    Private = AllocateZeroPool (sizeof (HTTP_BOOT_PRIVATE_DATA));
+    if (Private == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    Private->Signature = HTTP_BOOT_PRIVATE_DATA_SIGNATURE;
+    Private->Controller = ControllerHandle;
+    Private->Image = This->ImageHandle;
+    InitializeListHead (&Private->CacheList);
+    //
+    // Get the NII interface if it exists, it's not required.
+    //
+    Status = gBS->OpenProtocol (
+                    ControllerHandle,
+                    &gEfiNetworkInterfaceIdentifierProtocolGuid_31,
+                    (VOID **) &Private->Nii,
+                    This->DriverBindingHandle,
+                    ControllerHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      Private->Nii = NULL;
+    }
+
+    //
+    // Open Device Path Protocol to prepare for appending IP and URI node.
+    //
+    Status = gBS->OpenProtocol (
+                    ControllerHandle,
+                    &gEfiDevicePathProtocolGuid,
+                    (VOID **) &Private->ParentDevicePath,
+                    This->DriverBindingHandle,
+                    ControllerHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+
+    //
+    // Install a protocol with Caller Id Guid to the NIC, this is just to build the relationship between
+    // NIC handle and the private data.
+    //
+    Status = gBS->InstallProtocolInterface (
+                    &ControllerHandle,
+                    &gEfiCallerIdGuid,
+                    EFI_NATIVE_INTERFACE,
+                    &Private->Id
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+      
+  }
+  
+  if (Private->Ip6Nic != NULL) {
+    //
+    // Already created before
+    //
+    return EFI_SUCCESS;
+  }
+  
+  Private->Ip6Nic = AllocateZeroPool (sizeof (HTTP_BOOT_VIRTUAL_NIC));
+  if (Private->Ip6Nic == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  Private->Ip6Nic->Private   = Private;
+  Private->Ip6Nic->Signature = HTTP_BOOT_VIRTUAL_NIC_SIGNATURE;
+
+  //
+  // Create Dhcp6 child and open Dhcp6 protocol
+  Status = NetLibCreateServiceChild (
+             ControllerHandle,
+             This->DriverBindingHandle,
+             &gEfiDhcp6ServiceBindingProtocolGuid,
+             &Private->Dhcp6Child
+             );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  Status = gBS->OpenProtocol (
+                  Private->Dhcp6Child,
+                  &gEfiDhcp6ProtocolGuid,
+                  (VOID **) &Private->Dhcp6,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  //
+  // Create Ip6 child and open Ip6 protocol for background ICMP packets.
+  //
+  Status = NetLibCreateServiceChild (
+              ControllerHandle,
+              This->DriverBindingHandle,
+              &gEfiIp6ServiceBindingProtocolGuid,
+              &Private->Ip6Child
+              );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  Status = gBS->OpenProtocol (
+                  Private->Ip6Child,
+                  &gEfiIp6ProtocolGuid,
+                  (VOID **) &Private->Ip6,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  //
+  // Locate Ip6Config protocol, it's required to configure the default gateway address.
+  //
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiIp6ConfigProtocolGuid,
+                  (VOID **) &Private->Ip6Config,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  //
+  // Append IPv6 device path node.
+  //
+  Node = AllocateZeroPool (sizeof (IPv6_DEVICE_PATH));
+  if (Node == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_ERROR;
+  }
+  Node->Ipv6.Header.Type = MESSAGING_DEVICE_PATH;
+  Node->Ipv6.Header.SubType = MSG_IPv6_DP;
+  Node->Ipv6.PrefixLength = IP6_PREFIX_LENGTH;
+  SetDevicePathNodeLength (Node, sizeof (IPv6_DEVICE_PATH));
+  DevicePath = AppendDevicePathNode(Private->ParentDevicePath, (EFI_DEVICE_PATH*) Node);
+  FreePool(Node);
+  if (DevicePath == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_ERROR;
+  }
+
+  //
+  // Append URI device path node.
+  //
+  Node = AllocateZeroPool (sizeof (EFI_DEVICE_PATH_PROTOCOL));
+  if (Node == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_ERROR;
+  }
+  Node->DevPath.Type = MESSAGING_DEVICE_PATH;
+  Node->DevPath.SubType = MSG_URI_DP;
+  SetDevicePathNodeLength (Node, sizeof (EFI_DEVICE_PATH_PROTOCOL));
+  Private->Ip6Nic->DevicePath = AppendDevicePathNode (DevicePath, (EFI_DEVICE_PATH_PROTOCOL*) Node);
+  FreePool (Node);
+  FreePool (DevicePath);
+  if (Private->Ip6Nic->DevicePath == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_ERROR;
+  }
+
+  //
+  // Create a child handle for the HTTP boot and install DevPath and Load file protocol on it.
+  //
+  CopyMem (&Private->Ip6Nic->LoadFile, &gHttpBootDxeLoadFile, sizeof (Private->LoadFile));
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &Private->Ip6Nic->Controller,
+                  &gEfiLoadFileProtocolGuid,
+                  &Private->Ip6Nic->LoadFile,
+                  &gEfiDevicePathProtocolGuid,
+                  Private->Ip6Nic->DevicePath,
+                  NULL
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  //
+  // Open the Caller Id child to setup a parent-child relationship between
+  // real NIC handle and the HTTP boot child handle.
+  //
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiCallerIdGuid,
+                  (VOID **) &Id,
+                  This->DriverBindingHandle,
+                  Private->Ip6Nic->Controller,
+                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                  );
+  if (EFI_ERROR (Status)) {
+    goto ON_ERROR;
+  }
+
+  return EFI_SUCCESS;
+   
+ON_ERROR:
+  
+ HttpBootDestroyIp6Children(This, Private);
+ FreePool (Private);
+
+ return Status;
+ 
+}
+
+/**
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootIp6DxeDriverBindingStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN UINTN                        NumberOfChildren,
+  IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
+  )
+{
+  EFI_STATUS                      Status;
+  EFI_LOAD_FILE_PROTOCOL          *LoadFile;
+  HTTP_BOOT_PRIVATE_DATA          *Private;
+  EFI_HANDLE                      NicHandle;
+  UINT32                          *Id;
+
+  //
+  // Try to get the Load File Protocol from the controller handle.
+  //
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiLoadFileProtocolGuid,
+                  (VOID **) &LoadFile,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                  );
+  if (EFI_ERROR (Status)) {
+    //
+    // If failed, try to find the NIC handle for this controller.
+    //
+    NicHandle = HttpBootGetNicByIp6Children (ControllerHandle);
+    if (NicHandle == NULL) {
+      return EFI_SUCCESS;
+    }
+
+    //
+    // Try to retrieve the private data by the Caller Id Guid.
+    //
+    Status = gBS->OpenProtocol (
+                    NicHandle,
+                    &gEfiCallerIdGuid,
+                    (VOID **) &Id,
+                    This->DriverBindingHandle,
+                    ControllerHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    Private = HTTP_BOOT_PRIVATE_DATA_FROM_ID (Id);
+  } else {
+    Private = HTTP_BOOT_PRIVATE_DATA_FROM_LOADFILE (LoadFile);
+    NicHandle = Private->Controller;
+  }
+
+  //
+  // Disable the HTTP boot function.
+  //
+  Status = HttpBootStop (Private);
+  if (Status != EFI_SUCCESS && Status != EFI_NOT_STARTED) {
+    return Status;
+  }
+
+  //
+  // Destory all child instance and uninstall protocol interface.
+  //
+  HttpBootDestroyIp6Children (This, Private);
+
+  if (Private->Ip4Nic == NULL && Private->Ip6Nic == NULL) {
+    //
+    // Release the cached data.
+    //
+    HttpBootFreeCacheList (Private);
+        
+    gBS->UninstallProtocolInterface (
+           NicHandle,
+           &gEfiCallerIdGuid,
+           &Private->Id
+           );
+    FreePool (Private);
+
+  }
+
+  return EFI_SUCCESS;
+}
+/**
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootDxeDriverEntryPoint (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS   Status;
+  //
+  // Install UEFI Driver Model protocol(s).
+  //
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gHttpBootIp4DxeDriverBinding,
+             ImageHandle,
+             &gHttpBootDxeComponentName,
+             &gHttpBootDxeComponentName2
+             );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gHttpBootIp6DxeDriverBinding,
+             NULL,
+             &gHttpBootDxeComponentName,
+             &gHttpBootDxeComponentName2
+             );
+  if (EFI_ERROR (Status)) {
+    gBS->UninstallMultipleProtocolInterfaces(
+           ImageHandle,
+           &gEfiDriverBindingProtocolGuid,
+           &gHttpBootIp4DxeDriverBinding,
+           &gEfiComponentName2ProtocolGuid,
+           &gHttpBootDxeComponentName2,
+           &gEfiComponentNameProtocolGuid,
+           &gHttpBootDxeComponentName,
+           NULL
+           );
+  }
+  return Status;
 }
 
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDxe.h b/NetworkPkg/HttpBootDxe/HttpBootDxe.h
index 08415f6e0c3c..452c8f4906db 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDxe.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootDxe.h
@@ -41,9 +41,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //
 #include <Protocol/NetworkInterfaceIdentifier.h>
 #include <Protocol/Dhcp4.h>
+#include <Protocol/Dhcp6.h>
+#include <Protocol/Dns6.h>
 #include <Protocol/Http.h>
 #include <Protocol/Ip4Config2.h>
-
+#include <Protocol/Ip6Config.h>
 //
 // Produced Protocols
 //
@@ -65,29 +67,45 @@ extern EFI_COMPONENT_NAME_PROTOCOL  gHttpBootDxeComponentName;
 // Private data structure
 //
 typedef struct _HTTP_BOOT_PRIVATE_DATA      HTTP_BOOT_PRIVATE_DATA;
+typedef struct _HTTP_BOOT_VIRTUAL_NIC       HTTP_BOOT_VIRTUAL_NIC;
 
 //
 // Include files with internal function prototypes
 //
 #include "HttpBootComponentName.h"
 #include "HttpBootDhcp4.h"
+#include "HttpBootDhcp6.h"
 #include "HttpBootImpl.h"
 #include "HttpBootSupport.h"
 #include "HttpBootClient.h"
 
 typedef union {
   HTTP_BOOT_DHCP4_PACKET_CACHE              Dhcp4;
+  HTTP_BOOT_DHCP6_PACKET_CACHE              Dhcp6;
 } HTTP_BOOT_DHCP_PACKET_CACHE;
 
+struct _HTTP_BOOT_VIRTUAL_NIC {
+  UINT32                                    Signature;
+  EFI_HANDLE                                Controller;
+  EFI_LOAD_FILE_PROTOCOL                    LoadFile;
+  EFI_DEVICE_PATH_PROTOCOL                  *DevicePath;
+  HTTP_BOOT_PRIVATE_DATA                    *Private;
+};
+
 struct _HTTP_BOOT_PRIVATE_DATA {
   UINT32                                    Signature;
   EFI_HANDLE                                Controller;
   EFI_HANDLE                                Image;
 
+  HTTP_BOOT_VIRTUAL_NIC                     *Ip4Nic;
+  HTTP_BOOT_VIRTUAL_NIC                     *Ip6Nic;
+
   //
   // Cousumed children
   //
+  EFI_HANDLE                                Ip6Child;
   EFI_HANDLE                                Dhcp4Child;
+  EFI_HANDLE                                Dhcp6Child;
   HTTP_IO                                   HttpIo;
   BOOLEAN                                   HttpCreated;
 
@@ -95,14 +113,13 @@ struct _HTTP_BOOT_PRIVATE_DATA {
   // Consumed protocol
   //
   EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL *Nii;
+  EFI_IP6_PROTOCOL                          *Ip6;
   EFI_IP4_CONFIG2_PROTOCOL                  *Ip4Config2;
+  EFI_IP6_CONFIG_PROTOCOL                   *Ip6Config;
   EFI_DHCP4_PROTOCOL                        *Dhcp4;
+  EFI_DHCP6_PROTOCOL                        *Dhcp6;
   EFI_DEVICE_PATH_PROTOCOL                  *ParentDevicePath;
 
-  //
-  // Produced children
-  //
-  EFI_HANDLE                                ChildHandle;
   
   //
   // Produced protocol
@@ -119,10 +136,12 @@ struct _HTTP_BOOT_PRIVATE_DATA {
   EFI_IP_ADDRESS                            StationIp;
   EFI_IP_ADDRESS                            SubnetMask;
   EFI_IP_ADDRESS                            GatewayIp;
+  EFI_IP_ADDRESS                            ServerIp;
   UINT16                                    Port;
   CHAR8                                     *BootFileUri;
   VOID                                      *BootFileUriParser;
   UINTN                                     BootFileSize;
+  BOOLEAN                                   NoGateway;
 
   //
   // Cached HTTP data
@@ -167,9 +186,10 @@ struct _HTTP_BOOT_PRIVATE_DATA {
 };
 
 #define HTTP_BOOT_PRIVATE_DATA_SIGNATURE          SIGNATURE_32 ('H', 'B', 'P', 'D')
+#define HTTP_BOOT_VIRTUAL_NIC_SIGNATURE           SIGNATURE_32 ('H', 'B', 'V', 'N')
 #define HTTP_BOOT_PRIVATE_DATA_FROM_LOADFILE(a)   CR (a, HTTP_BOOT_PRIVATE_DATA, LoadFile, HTTP_BOOT_PRIVATE_DATA_SIGNATURE)
 #define HTTP_BOOT_PRIVATE_DATA_FROM_ID(a)         CR (a, HTTP_BOOT_PRIVATE_DATA, Id, HTTP_BOOT_PRIVATE_DATA_SIGNATURE)
-
+#define HTTP_BOOT_VIRTUAL_NIC_FROM_LOADFILE(a)    CR (a, HTTP_BOOT_VIRTUAL_NIC, LoadFile, HTTP_BOOT_VIRTUAL_NIC_SIGNATURE)
 extern EFI_LOAD_FILE_PROTOCOL               gHttpBootDxeLoadFile;
 
 /**
@@ -300,4 +320,131 @@ HttpBootIp4DxeDriverBindingStop (
   IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
   );
 
+/**
+  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.
+**/
+EFI_STATUS
+EFIAPI
+HttpBootIp6DxeDriverBindingSupported (
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootIp6DxeDriverBindingStart (
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpBootIp6DxeDriverBindingStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN UINTN                        NumberOfChildren,
+  IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
+  );
 #endif
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDxe.inf b/NetworkPkg/HttpBootDxe/HttpBootDxe.inf
index 18f8f796f0cb..e24b568ddc88 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDxe.inf
+++ b/NetworkPkg/HttpBootDxe/HttpBootDxe.inf
@@ -35,6 +35,8 @@
   HttpBootImpl.c
   HttpBootDhcp4.h
   HttpBootDhcp4.c
+  HttpBootDhcp6.h
+  HttpBootDhcp6.c
   HttpBootSupport.h
   HttpBootSupport.c
   HttpBootClient.h
@@ -62,6 +64,13 @@
   gEfiDhcp4ServiceBindingProtocolGuid             ## TO_START
   gEfiDhcp4ProtocolGuid                           ## TO_START
   gEfiIp4Config2ProtocolGuid                      ## TO_START
+  gEfiDhcp6ServiceBindingProtocolGuid             ## TO_START
+  gEfiDhcp6ProtocolGuid                           ## TO_START
+  gEfiDns6ServiceBindingProtocolGuid              ## SOMETIMES_CONSUMES
+  gEfiDns6ProtocolGuid                            ## SOMETIMES_CONSUMES
+  gEfiIp6ServiceBindingProtocolGuid               ## TO_START
+  gEfiIp6ProtocolGuid                             ## TO_START
+  gEfiIp6ConfigProtocolGuid                       ## TO_START
   gEfiNetworkInterfaceIdentifierProtocolGuid_31   ## SOMETIMES_CONSUMES
 
 [UserExtensions.TianoCore."ExtraFiles"]
diff --git a/NetworkPkg/HttpBootDxe/HttpBootDxe.uni b/NetworkPkg/HttpBootDxe/HttpBootDxe.uni
index 68a33794b27664cc8e6c615017d8eb3b8ce6fe20..fe743df852821e3069aa7411f3ca1f91d394da02 100644
GIT binary patch
delta 44
ncmcb?|AT)+0V8idLlJ`lgC|1(Lm7kF=3K^5HdLX>``IM{2FMDe

delta 16
Xcmeyte}jKR0psQd#vr!IkJ!ZkJCFu0

diff --git a/NetworkPkg/HttpBootDxe/HttpBootImpl.c b/NetworkPkg/HttpBootDxe/HttpBootImpl.c
index eee63c21d3a9..9ea0d7f95f93 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootImpl.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootImpl.c
@@ -18,6 +18,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   Enable the use of UEFI HTTP boot function.
 
   @param[in]    Private            The pointer to the driver's private data.
+  @param[in]    UsingIpv6          Specifies the type of IP addresses that are to be
+                                   used during the session that is being started.
+                                   Set to TRUE for IPv6, and FALSE for IPv4.
 
   @retval EFI_SUCCESS              HTTP boot was successfully enabled.
   @retval EFI_INVALID_PARAMETER    Private is NULL.
@@ -26,10 +29,12 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 **/
 EFI_STATUS
 HttpBootStart (
-  IN HTTP_BOOT_PRIVATE_DATA           *Private
+  IN HTTP_BOOT_PRIVATE_DATA           *Private,
+  IN BOOLEAN                          UsingIpv6
   )
 {
-  UINTN          Index;
+  UINTN                Index;
+  EFI_STATUS           Status;
 
   if (Private == NULL) {
     return EFI_INVALID_PARAMETER;
@@ -39,25 +44,47 @@ HttpBootStart (
     return EFI_ALREADY_STARTED;
   }
 
+  //
+  // Detect whether using ipv6 or not, and set it to the private data.
+  //
+  if (UsingIpv6 && Private->Ip6Nic != NULL) {
+    Private->UsingIpv6 = TRUE;
+  } else if (!UsingIpv6 && Private->Ip4Nic != NULL) {
+    Private->UsingIpv6 = FALSE;
+  } else {
+    return EFI_UNSUPPORTED;
+  }
+  
+  //
+  // Init the content of cached DHCP offer list.
+  //
+  ZeroMem (Private->OfferBuffer, sizeof (Private->OfferBuffer));
   if (!Private->UsingIpv6) {
-    //
-    // Init the content of cached DHCP offer list.
-    //
-    ZeroMem (Private->OfferBuffer, sizeof (Private->OfferBuffer));
     for (Index = 0; Index < HTTP_BOOT_OFFER_MAX_NUM; Index++) {
       Private->OfferBuffer[Index].Dhcp4.Packet.Offer.Size = HTTP_BOOT_DHCP4_PACKET_MAX_SIZE;
     }
   } else {
-    ASSERT (FALSE);
+    for (Index = 0; Index < HTTP_BOOT_OFFER_MAX_NUM; Index++) {
+      Private->OfferBuffer[Index].Dhcp6.Packet.Offer.Size = HTTP_BOOT_DHCP6_PACKET_MAX_SIZE;
+    }
   }
 
+  if (Private->UsingIpv6) {
+    //
+    // Set Ip6 policy to Automatic to start the Ip6 router discovery.
+    //
+    Status = HttpBootSetIp6Policy (Private);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
   Private->Started = TRUE;
 
   return EFI_SUCCESS;
 }
 
 /**
-  Attempt to complete a DHCPv4 D.O.R.A sequence to retrieve the boot resource information.
+  Attempt to complete a DHCPv4 D.O.R.A or DHCPv6 S.R.A.A sequence to retrieve the boot resource information.
 
   @param[in]    Private            The pointer to the driver's private data.
 
@@ -86,9 +113,15 @@ HttpBootDhcp (
   Status = EFI_DEVICE_ERROR;
 
   if (!Private->UsingIpv6) {
+    //
+    // Start D.O.R.A process to get a IPv4 address and other boot information.
+    //
     Status = HttpBootDhcp4Dora (Private);
   } else {
-    ASSERT (FALSE);
+     //
+    // Start S.A.R.R process to get a IPv6 address and other boot information.
+    //
+    Status = HttpBootDhcp6Sarr (Private);
   }
 
   return Status;
@@ -241,7 +274,7 @@ HttpBootStop (
   Private->BootFileUriParser = NULL;
   Private->BootFileSize = 0;
   Private->SelectIndex = 0;
-  Private->SelectProxyType = HttpOfferTypeMax;
+  Private->SelectProxyType = HttpOfferTypeMax; 
 
   if (!Private->UsingIpv6) {
     //
@@ -256,7 +289,17 @@ HttpBootStop (
       }
     }
   } else {
-    ASSERT (FALSE);
+    //
+    // Stop and release the DHCP6 child.
+    //
+    Private->Dhcp6->Stop (Private->Dhcp6);
+    Private->Dhcp6->Configure (Private->Dhcp6, NULL);
+    
+    for (Index = 0; Index < HTTP_BOOT_OFFER_MAX_NUM; Index++) {
+      if (Private->OfferBuffer[Index].Dhcp6.UriParser) {
+        HttpUrlFreeParser (Private->OfferBuffer[Index].Dhcp6.UriParser);
+      }
+    }
   }
   
   ZeroMem (Private->OfferBuffer, sizeof (Private->OfferBuffer));
@@ -309,7 +352,9 @@ HttpBootDxeLoadFile (
   )
 {
   HTTP_BOOT_PRIVATE_DATA        *Private;
+  HTTP_BOOT_VIRTUAL_NIC         *VirtualNic;
   BOOLEAN                       MediaPresent;
+  BOOLEAN                       UsingIpv6;
   EFI_STATUS                    Status;
 
   if (This == NULL || BufferSize == NULL) {
@@ -323,8 +368,10 @@ HttpBootDxeLoadFile (
     return EFI_UNSUPPORTED;
   }
 
-  Private = HTTP_BOOT_PRIVATE_DATA_FROM_LOADFILE (This);
-
+  VirtualNic = HTTP_BOOT_VIRTUAL_NIC_FROM_LOADFILE (This);
+  Private = VirtualNic->Private;
+  UsingIpv6 = FALSE;
+  
   //
   // Check media status before HTTP boot start
   //
@@ -334,10 +381,26 @@ HttpBootDxeLoadFile (
     return EFI_NO_MEDIA;
   }
 
+  //
+  // Check whether the virtual nic is using IPv6 or not.
+  //
+  if (VirtualNic == Private->Ip6Nic) {
+    UsingIpv6 = TRUE;
+  }
+  
   //
   // Initialize HTTP boot and load the boot file.
   //
-  Status = HttpBootStart (Private);
+  Status = HttpBootStart (Private, UsingIpv6);
+  if (Status == EFI_ALREADY_STARTED && UsingIpv6 != Private->UsingIpv6) {
+    //
+    // Http boot Driver has already been started but not on the required IP version, restart it.
+    //
+    Status = HttpBootStop (Private);
+    if (!EFI_ERROR (Status)) {
+      Status = HttpBootStart (Private, UsingIpv6);
+    }
+  }
   if (Status == EFI_SUCCESS || Status == EFI_ALREADY_STARTED) {
     Status = HttpBootLoadFile (Private, BufferSize, Buffer);
   }
@@ -345,11 +408,19 @@ HttpBootDxeLoadFile (
   if (Status != EFI_SUCCESS && Status != EFI_BUFFER_TOO_SMALL) {
     HttpBootStop (Private);
   } else {
-    //
-    // Stop and release the DHCP4 child.
-    //
-    Private->Dhcp4->Stop (Private->Dhcp4);
-    Private->Dhcp4->Configure (Private->Dhcp4, NULL);
+    if (!Private->UsingIpv6) {
+      //
+      // Stop and release the DHCP4 child.
+      //
+      Private->Dhcp4->Stop (Private->Dhcp4);
+      Private->Dhcp4->Configure (Private->Dhcp4, NULL);
+    } else {
+      //
+      // Stop and release the DHCP6 child.
+      //
+      Private->Dhcp6->Stop (Private->Dhcp6);
+      Private->Dhcp6->Configure (Private->Dhcp6, NULL);
+    }
   }
 
   return Status;
diff --git a/NetworkPkg/HttpBootDxe/HttpBootImpl.h b/NetworkPkg/HttpBootDxe/HttpBootImpl.h
index a2e9f5a3281c..70663381752c 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootImpl.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootImpl.h
@@ -15,7 +15,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define __EFI_HTTP_BOOT_IMPL_H__
 
 /**
-  Attempt to complete a DHCPv4 D.O.R.A sequence to retrieve the boot resource information.
+  Attempt to complete a DHCPv4 D.O.R.A or DHCPv6 S.R.A.A sequence to retrieve the boot resource information.
 
   @param[in]    Private            The pointer to the driver's private data.
 
diff --git a/NetworkPkg/HttpBootDxe/HttpBootSupport.c b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
index 761643141f91..d08111f66107 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootSupport.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
@@ -42,6 +42,31 @@ HttpBootGetNicByIp4Children (
   return NicHandle;
 }
 
+/**
+  Get the Nic handle using any child handle in the IPv6 stack.
+
+  @param[in]  ControllerHandle    Pointer to child handle over IPv6.
+
+  @return NicHandle               The pointer to the Nic handle.
+  @return NULL                    Can't find the Nic handle.
+
+**/
+EFI_HANDLE
+HttpBootGetNicByIp6Children (
+  IN EFI_HANDLE                 ControllerHandle
+  )
+{
+  EFI_HANDLE                    NicHandle;
+  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiHttpProtocolGuid);
+  if (NicHandle == NULL) {
+    NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiDhcp6ProtocolGuid);
+    if (NicHandle == NULL) {
+      return NULL;
+    }
+  }
+
+  return NicHandle;
+}
 
 /**
   This function is to convert UINTN to ASCII string with the required formatting.
@@ -89,6 +114,242 @@ HttpBootShowIp4Addr (
   }
 }
 
+/**
+  This function is to display the IPv6 address.
+
+  @param[in]  Ip        The pointer to the IPv6 address.
+
+**/
+VOID
+HttpBootShowIp6Addr (
+  IN EFI_IPv6_ADDRESS   *Ip
+  )
+{
+  UINTN                 Index;
+
+  for (Index = 0; Index < 16; Index++) {
+
+    if (Ip->Addr[Index] != 0) {
+      AsciiPrint ("%x", Ip->Addr[Index]);
+    }
+    Index++;
+    if (Index > 15) {
+      return;
+    }
+    if (((Ip->Addr[Index] & 0xf0) == 0) && (Ip->Addr[Index - 1] != 0)) {
+      AsciiPrint ("0");
+    }
+    AsciiPrint ("%x", Ip->Addr[Index]);
+    if (Index < 15) {
+      AsciiPrint (":");
+    }
+  }
+}
+
+/**
+  Notify the callback function when an event is triggered.
+
+  @param[in]  Event           The triggered event.
+  @param[in]  Context         The opaque parameter to the function.
+
+**/
+VOID
+EFIAPI
+HttpBootCommonNotify (
+  IN EFI_EVENT           Event,
+  IN VOID                *Context
+  )
+{
+  *((BOOLEAN *) Context) = TRUE;
+}
+
+/**
+  Retrieve the host address using the EFI_DNS6_PROTOCOL.
+
+  @param[in]  Private             The pointer to the driver's private data.
+  @param[in]  HostName            Pointer to buffer containing hostname.
+  @param[out] IpAddress           On output, pointer to buffer containing IPv6 address.
+
+  @retval EFI_SUCCESS             Operation succeeded.
+  @retval EFI_DEVICE_ERROR        An unexpected network error occurred.
+  @retval Others                  Other errors as indicated.  
+**/
+EFI_STATUS
+HttpBootDns (
+  IN     HTTP_BOOT_PRIVATE_DATA   *Private,
+  IN     CHAR16                   *HostName,
+     OUT EFI_IPv6_ADDRESS         *IpAddress 
+  )
+{
+  EFI_STATUS                      Status;
+  EFI_DNS6_PROTOCOL               *Dns6;
+  EFI_DNS6_CONFIG_DATA            Dns6ConfigData;
+  EFI_DNS6_COMPLETION_TOKEN       Token;
+  EFI_HANDLE                      Dns6Handle;
+  EFI_IP6_CONFIG_PROTOCOL         *Ip6Config;
+  EFI_IPv6_ADDRESS                *DnsServerList;
+  UINTN                           DnsServerListCount;
+  UINTN                           DataSize;
+  BOOLEAN                         IsDone;  
+  
+  DnsServerList       = NULL;
+  DnsServerListCount  = 0;
+  Dns6                = NULL;
+  Dns6Handle          = NULL;
+  ZeroMem (&Token, sizeof (EFI_DNS6_COMPLETION_TOKEN));
+  
+  //
+  // Get DNS server list from EFI IPv6 Configuration protocol.
+  //
+  Status = gBS->HandleProtocol (Private->Controller, &gEfiIp6ConfigProtocolGuid, (VOID **) &Ip6Config);
+  if (!EFI_ERROR (Status)) {
+    //
+    // Get the required size.
+    //
+    DataSize = 0;
+    Status = Ip6Config->GetData (Ip6Config, Ip6ConfigDataTypeDnsServer, &DataSize, NULL);
+    if (Status == EFI_BUFFER_TOO_SMALL) {
+      DnsServerList = AllocatePool (DataSize);
+      if (DnsServerList == NULL) {
+        return EFI_OUT_OF_RESOURCES;
+      }  
+
+      Status = Ip6Config->GetData (Ip6Config, Ip6ConfigDataTypeDnsServer, &DataSize, DnsServerList);
+      if (EFI_ERROR (Status)) {
+        FreePool (DnsServerList);
+        DnsServerList = NULL;
+      } else {
+        DnsServerListCount = DataSize / sizeof (EFI_IPv6_ADDRESS);
+      }
+    }
+  }
+  //
+  // Create a DNSv6 child instance and get the protocol.
+  //
+  Status = NetLibCreateServiceChild (
+             Private->Controller,
+             Private->Image,
+             &gEfiDns6ServiceBindingProtocolGuid,
+             &Dns6Handle
+             );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  } 
+  
+  Status = gBS->OpenProtocol (
+                  Dns6Handle,
+                  &gEfiDns6ProtocolGuid,
+                  (VOID **) &Dns6,
+                  Private->Image,
+                  Private->Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  //
+  // Configure DNS6 instance for the DNS server address and protocol.
+  //
+  ZeroMem (&Dns6ConfigData, sizeof (EFI_DNS6_CONFIG_DATA));
+  Dns6ConfigData.DnsServerCount = (UINT32)DnsServerListCount;
+  Dns6ConfigData.DnsServerList  = DnsServerList;
+  Dns6ConfigData.EnableDnsCache = TRUE;
+  Dns6ConfigData.Protocol       = EFI_IP_PROTO_UDP;
+  IP6_COPY_ADDRESS (&Dns6ConfigData.StationIp,&Private->StationIp.v6);
+  Status = Dns6->Configure (
+                    Dns6,
+                    &Dns6ConfigData
+                    );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+  
+  Token.Status = EFI_NOT_READY;
+  IsDone       = FALSE;
+  //
+  // Create event to set the  IsDone flag when name resolution is finished.
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  HttpBootCommonNotify,
+                  &IsDone,
+                  &Token.Event
+                  );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  //
+  // Start asynchronous name resolution.
+  //
+  Status = Dns6->HostNameToIp (Dns6, HostName, &Token);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  while (!IsDone) {
+    Dns6->Poll (Dns6);
+  }
+  
+  //
+  // Name resolution is done, check result.
+  //
+  Status = Token.Status;  
+  if (!EFI_ERROR (Status)) {
+    if (Token.RspData.H2AData == NULL) {
+      Status = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+    if (Token.RspData.H2AData->IpCount == 0 || Token.RspData.H2AData->IpList == NULL) {
+      Status = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+    //
+    // We just return the first IPv6 address from DNS protocol.
+    //
+    IP6_COPY_ADDRESS (IpAddress, Token.RspData.H2AData->IpList);
+    Status = EFI_SUCCESS;
+  }
+Exit:
+
+  if (Token.Event != NULL) {
+    gBS->CloseEvent (Token.Event);
+  }
+  if (Token.RspData.H2AData != NULL) {
+    if (Token.RspData.H2AData->IpList != NULL) {
+      FreePool (Token.RspData.H2AData->IpList);
+    }
+    FreePool (Token.RspData.H2AData);
+  }
+
+  if (Dns6 != NULL) {
+    Dns6->Configure (Dns6, NULL);
+    
+    gBS->CloseProtocol (
+           Dns6Handle,
+           &gEfiDns6ProtocolGuid,
+           Private->Image,
+           Private->Controller
+           );
+  }
+
+  if (Dns6Handle != NULL) {
+    NetLibDestroyServiceChild (
+      Private->Controller,
+      Private->Image,
+      &gEfiDns6ServiceBindingProtocolGuid,
+      Dns6Handle
+      );
+  }
+
+  if (DnsServerList != NULL) {
+    FreePool (DnsServerList);
+  }
+  
+  return Status;  
+}
 /**
   Create a HTTP_IO_HEADER to hold the HTTP header items.
 
@@ -100,7 +361,7 @@ HttpBootShowIp4Addr (
 HTTP_IO_HEADER *
 HttpBootCreateHeader (
   UINTN                     MaxHeaderCount
-)
+  )
 {
   HTTP_IO_HEADER        *HttpIoHeader;
 
@@ -254,23 +515,6 @@ HttpBootSetHeader (
   return EFI_SUCCESS;
 }
 
-/**
-  Notify the callback function when an event is triggered.
-
-  @param[in]  Event           The triggered event.
-  @param[in]  Context         The opaque parameter to the function.
-
-**/
-VOID
-EFIAPI
-HttpIoCommonNotify (
-  IN EFI_EVENT           Event,
-  IN VOID                *Context
-  )
-{
-  *((BOOLEAN *) Context) = TRUE;
-}
-
 /**
   Create a HTTP_IO to access the HTTP service. It will create and configure
   a HTTP child handle.
@@ -301,6 +545,7 @@ HttpIoCreateIo (
   EFI_STATUS                Status;
   EFI_HTTP_CONFIG_DATA      HttpConfigData;
   EFI_HTTPv4_ACCESS_POINT   Http4AccessPoint;
+  EFI_HTTPv6_ACCESS_POINT   Http6AccessPoint;
   EFI_HTTP_PROTOCOL         *Http;
   EFI_EVENT                 Event;
   
@@ -359,7 +604,10 @@ HttpIoCreateIo (
     IP4_COPY_ADDRESS (&Http4AccessPoint.LocalSubnet, &ConfigData->Config4.SubnetMask);
     HttpConfigData.AccessPoint.IPv4Node = &Http4AccessPoint;   
   } else {
-    ASSERT (FALSE);
+    HttpConfigData.LocalAddressIsIPv6 = TRUE;
+    Http6AccessPoint.LocalPort        = ConfigData->Config6.LocalPort;
+    IP6_COPY_ADDRESS (&Http6AccessPoint.LocalAddress, &ConfigData->Config6.LocalIp);
+    HttpConfigData.AccessPoint.IPv6Node = &Http6AccessPoint;
   }
   
   Status = Http->Configure (Http, &HttpConfigData);
@@ -373,7 +621,7 @@ HttpIoCreateIo (
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
                   TPL_NOTIFY,
-                  HttpIoCommonNotify,
+                  HttpBootCommonNotify,
                   &HttpIo->IsTxDone,
                   &Event
                   );
@@ -386,7 +634,7 @@ HttpIoCreateIo (
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
                   TPL_NOTIFY,
-                  HttpIoCommonNotify,
+                  HttpBootCommonNotify,
                   &HttpIo->IsRxDone,
                   &Event
                   );
@@ -579,7 +827,7 @@ HttpIoRecvResponse (
   //
   // Store the received data into the wrapper.
   //
-  Status = HttpIo->ReqToken.Status;
+  Status = HttpIo->RspToken.Status;
   if (!EFI_ERROR (Status)) {
     ResponseData->HeaderCount = HttpIo->RspToken.Message->HeaderCount;
     ResponseData->Headers     = HttpIo->RspToken.Message->Headers;
diff --git a/NetworkPkg/HttpBootDxe/HttpBootSupport.h b/NetworkPkg/HttpBootDxe/HttpBootSupport.h
index bef80e81d874..d5956720a7cf 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootSupport.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootSupport.h
@@ -29,6 +29,20 @@ HttpBootGetNicByIp4Children (
   IN EFI_HANDLE                 ControllerHandle
   );
 
+/**
+  Get the Nic handle using any child handle in the IPv6 stack.
+
+  @param[in]  ControllerHandle    Pointer to child handle over IPv6.
+
+  @return NicHandle               The pointer to the Nic handle.
+  @return NULL                    Can't find the Nic handle.
+
+**/
+EFI_HANDLE
+HttpBootGetNicByIp6Children (
+  IN EFI_HANDLE                 ControllerHandle
+  );
+
 /**
   This function is to convert UINTN to ASCII string with the required formatting.
 
@@ -56,6 +70,17 @@ HttpBootShowIp4Addr (
   IN EFI_IPv4_ADDRESS   *Ip
   );
 
+/**
+  This function is to display the IPv6 address.
+
+  @param[in]  Ip        The pointer to the IPv6 address.
+
+**/
+VOID
+HttpBootShowIp6Addr (
+  IN EFI_IPv6_ADDRESS   *Ip
+  );
+
 //
 // A wrapper structure to hold the HTTP headers.
 //
@@ -122,11 +147,24 @@ typedef struct {
   UINT16                    LocalPort;
 } HTTP4_IO_CONFIG_DATA;
 
+//
+// HTTP_IO configuration data for IPv6
+//
+typedef struct {
+  EFI_HTTP_VERSION          HttpVersion;
+  UINT32                    RequestTimeOut;  // In milliseconds.
+  BOOLEAN                   UseDefaultAddress;
+  EFI_IPv6_ADDRESS          LocalIp;
+  UINT16                    LocalPort;
+} HTTP6_IO_CONFIG_DATA;
+
+
 //
 // HTTP_IO configuration
 //
 typedef union {
   HTTP4_IO_CONFIG_DATA       Config4;
+  HTTP6_IO_CONFIG_DATA       Config6;
 } HTTP_IO_CONFIG_DATA;
 
 //
@@ -160,6 +198,38 @@ typedef struct {
   CHAR8                       *Body;
 } HTTP_IO_RESOPNSE_DATA;
 
+/**
+  Retrieve the host address using the EFI_DNS6_PROTOCOL.
+
+  @param[in]  Private             The pointer to the driver's private data.
+  @param[in]  HostName            Pointer to buffer containing hostname.
+  @param[out] IpAddress           On output, pointer to buffer containing IPv6 address.
+
+  @retval EFI_SUCCESS             Operation succeeded.
+  @retval EFI_DEVICE_ERROR        An unexpected network error occurred.
+  @retval Others                  Other errors as indicated.  
+**/
+EFI_STATUS
+HttpBootDns (
+  IN     HTTP_BOOT_PRIVATE_DATA   *Private,
+  IN     CHAR16                   *HostName,
+     OUT EFI_IPv6_ADDRESS         *IpAddress 
+  );
+
+/**
+  Notify the callback function when an event is triggered.
+
+  @param[in]  Event           The triggered event.
+  @param[in]  Context         The opaque parameter to the function.
+
+**/
+VOID
+EFIAPI
+HttpBootCommonNotify (
+  IN EFI_EVENT           Event,
+  IN VOID                *Context
+  );
+
 /**
   Create a HTTP_IO to access the HTTP service. It will create and configure
   a HTTP child handle.
diff --git a/NetworkPkg/HttpDxe/HttpDns.c b/NetworkPkg/HttpDxe/HttpDns.c
index daebc173b5e9..0f5fe1807270 100644
--- a/NetworkPkg/HttpDxe/HttpDns.c
+++ b/NetworkPkg/HttpDxe/HttpDns.c
@@ -194,11 +194,11 @@ HttpDns4 (
     Dns4->Configure (Dns4, NULL);
     
     gBS->CloseProtocol (
-          Dns4Handle,
-          &gEfiDns4ProtocolGuid,
-          Service->ImageHandle,
-          Service->ControllerHandle
-          );
+           Dns4Handle,
+           &gEfiDns4ProtocolGuid,
+           Service->ImageHandle,
+           Service->ControllerHandle
+           );
   }
 
   if (Dns4Handle != NULL) {
@@ -216,3 +216,200 @@ HttpDns4 (
   
   return Status;
 }
+
+/**
+  Retrieve the host address using the EFI_DNS6_PROTOCOL.
+
+  @param[in]  HttpInstance        Pointer to HTTP_PROTOCOL instance.
+  @param[in]  HostName            Pointer to buffer containing hostname.
+  @param[out] IpAddress           On output, pointer to buffer containing IPv6 address.
+
+  @retval EFI_SUCCESS             Operation succeeded.
+  @retval EFI_OUT_OF_RESOURCES    Failed to allocate needed resources.
+  @retval EFI_DEVICE_ERROR        An unexpected network error occurred.
+  @retval Others                  Other errors as indicated.
+  
+**/
+EFI_STATUS
+HttpDns6 (
+  IN     HTTP_PROTOCOL            *HttpInstance,
+  IN     CHAR16                   *HostName,
+     OUT EFI_IPv6_ADDRESS         *IpAddress                
+  )
+{
+  EFI_STATUS                      Status;
+  HTTP_SERVICE                    *Service;
+  EFI_DNS6_PROTOCOL               *Dns6;
+  EFI_DNS6_CONFIG_DATA            Dns6ConfigData;
+  EFI_DNS6_COMPLETION_TOKEN       Token;
+  EFI_HANDLE                      Dns6Handle;
+  EFI_IP6_CONFIG_PROTOCOL         *Ip6Config;
+  EFI_IPv6_ADDRESS                *DnsServerList;
+  UINTN                           DnsServerListCount;
+  UINTN                           DataSize;
+  BOOLEAN                         IsDone;
+  
+
+  Service = HttpInstance->Service;
+  ASSERT (Service != NULL);
+
+  DnsServerList       = NULL;
+  DnsServerListCount  = 0;
+  Dns6                = NULL;
+  Dns6Handle          = NULL;
+  ZeroMem (&Token, sizeof (EFI_DNS6_COMPLETION_TOKEN));
+  
+  //
+  // Get DNS server list from EFI IPv6 Configuration protocol.
+  //
+  Status = gBS->HandleProtocol (Service->ControllerHandle, &gEfiIp6ConfigProtocolGuid, (VOID **) &Ip6Config);
+  if (!EFI_ERROR (Status)) {
+    //
+    // Get the required size.
+    //
+    DataSize = 0;
+    Status = Ip6Config->GetData (Ip6Config, Ip6ConfigDataTypeDnsServer, &DataSize, NULL);
+    if (Status == EFI_BUFFER_TOO_SMALL) {
+      DnsServerList = AllocatePool (DataSize);
+      if (DnsServerList == NULL) {
+        return EFI_OUT_OF_RESOURCES;
+      }  
+
+      Status = Ip6Config->GetData (Ip6Config, Ip6ConfigDataTypeDnsServer, &DataSize, DnsServerList);
+      if (EFI_ERROR (Status)) {
+        FreePool (DnsServerList);
+        DnsServerList = NULL;
+      } else {
+        DnsServerListCount = DataSize / sizeof (EFI_IPv6_ADDRESS);
+      }
+    }
+  }
+
+  //
+  // Create a DNSv6 child instance and get the protocol.
+  //
+  Status = NetLibCreateServiceChild (
+             Service->ControllerHandle,
+             Service->ImageHandle,
+             &gEfiDns6ServiceBindingProtocolGuid,
+             &Dns6Handle
+             );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  } 
+  
+  Status = gBS->OpenProtocol (
+                  Dns6Handle,
+                  &gEfiDns6ProtocolGuid,
+                  (VOID **) &Dns6,
+                  Service->ImageHandle,
+                  Service->ControllerHandle,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  //
+  // Configure DNS6 instance for the DNS server address and protocol.
+  //
+  ZeroMem (&Dns6ConfigData, sizeof (EFI_DNS6_CONFIG_DATA));
+  Dns6ConfigData.DnsServerCount = (UINT32)DnsServerListCount;
+  Dns6ConfigData.DnsServerList  = DnsServerList;
+  Dns6ConfigData.EnableDnsCache = TRUE;
+  Dns6ConfigData.Protocol       = EFI_IP_PROTO_UDP;
+  IP6_COPY_ADDRESS (&Dns6ConfigData.StationIp, &HttpInstance->Ipv6Node.LocalAddress);
+  Status = Dns6->Configure (
+                   Dns6,
+                   &Dns6ConfigData
+                   );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  Token.Status = EFI_NOT_READY;
+  IsDone       = FALSE;
+  //
+  // Create event to set the  IsDone flag when name resolution is finished.
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_NOTIFY,
+                  HttpCommonNotify,
+                  &IsDone,
+                  &Token.Event
+                  );
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  //
+  // Start asynchronous name resolution.
+  //
+  Status = Dns6->HostNameToIp (Dns6, HostName, &Token);
+  if (EFI_ERROR (Status)) {
+    goto Exit;
+  }
+
+  while (!IsDone) {
+    Dns6->Poll (Dns6);
+  }
+
+  //
+  // Name resolution is done, check result.
+  //
+  Status = Token.Status;  
+  if (!EFI_ERROR (Status)) {
+    if (Token.RspData.H2AData == NULL) {
+      Status = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+    if (Token.RspData.H2AData->IpCount == 0 || Token.RspData.H2AData->IpList == NULL) {
+      Status = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+    //
+    // We just return the first IPv6 address from DNS protocol.
+    //
+    IP6_COPY_ADDRESS (IpAddress, Token.RspData.H2AData->IpList);
+    Status = EFI_SUCCESS;
+  }
+  
+Exit:
+
+  if (Token.Event != NULL) {
+    gBS->CloseEvent (Token.Event);
+  }
+  if (Token.RspData.H2AData != NULL) {
+    if (Token.RspData.H2AData->IpList != NULL) {
+      FreePool (Token.RspData.H2AData->IpList);
+    }
+    FreePool (Token.RspData.H2AData);
+  }
+
+  if (Dns6 != NULL) {
+    Dns6->Configure (Dns6, NULL);
+    
+    gBS->CloseProtocol (
+           Dns6Handle,
+           &gEfiDns6ProtocolGuid,
+           Service->ImageHandle,
+           Service->ControllerHandle
+           );
+  }
+
+  if (Dns6Handle != NULL) {
+    NetLibDestroyServiceChild (
+      Service->ControllerHandle,
+      Service->ImageHandle,
+      &gEfiDns6ServiceBindingProtocolGuid,
+      Dns6Handle
+      );
+  }
+
+  if (DnsServerList != NULL) {
+    FreePool (DnsServerList);
+  }
+  
+  return Status;  
+}
diff --git a/NetworkPkg/HttpDxe/HttpDns.h b/NetworkPkg/HttpDxe/HttpDns.h
index 0fb418635ca5..fa0c8f4a99f3 100644
--- a/NetworkPkg/HttpDxe/HttpDns.h
+++ b/NetworkPkg/HttpDxe/HttpDns.h
@@ -35,4 +35,24 @@ HttpDns4 (
      OUT EFI_IPv4_ADDRESS         *IpAddress                
   );
 
+/**
+  Retrieve the host address using the EFI_DNS6_PROTOCOL.
+
+  @param[in]  HttpInstance        Pointer to HTTP_PROTOCOL instance.
+  @param[in]  HostName            Pointer to buffer containing hostname.
+  @param[out] IpAddress           On output, pointer to buffer containing IPv6 address.
+
+  @retval EFI_SUCCESS             Operation succeeded.
+  @retval EFI_OUT_OF_RESOURCES    Failed to allocate needed resources.
+  @retval EFI_DEVICE_ERROR        An unexpected network error occurred.
+  @retval Others                  Other errors as indicated.
+  
+**/
+EFI_STATUS
+HttpDns6 (
+  IN     HTTP_PROTOCOL            *HttpInstance,
+  IN     CHAR16                   *HostName,
+     OUT EFI_IPv6_ADDRESS         *IpAddress                
+  );
+
 #endif
\ No newline at end of file
diff --git a/NetworkPkg/HttpDxe/HttpDriver.c b/NetworkPkg/HttpDxe/HttpDriver.c
index bd1d04e78cc4..2518f4e707b6 100644
--- a/NetworkPkg/HttpDxe/HttpDriver.c
+++ b/NetworkPkg/HttpDxe/HttpDriver.c
@@ -20,15 +20,25 @@ EFI_HTTP_UTILITIES_PROTOCOL *mHttpUtilities = NULL;
 ///
 /// Driver Binding Protocol instance
 ///
-EFI_DRIVER_BINDING_PROTOCOL gHttpDxeDriverBinding = {
-  HttpDxeDriverBindingSupported,
-  HttpDxeDriverBindingStart,
-  HttpDxeDriverBindingStop,
+EFI_DRIVER_BINDING_PROTOCOL gHttpDxeIp4DriverBinding = {
+  HttpDxeIp4DriverBindingSupported,
+  HttpDxeIp4DriverBindingStart,
+  HttpDxeIp4DriverBindingStop,
   HTTP_DRIVER_VERSION,
   NULL,
   NULL
 };
 
+EFI_DRIVER_BINDING_PROTOCOL gHttpDxeIp6DriverBinding = {
+  HttpDxeIp6DriverBindingSupported,
+  HttpDxeIp6DriverBindingStart,
+  HttpDxeIp6DriverBindingStop,
+  HTTP_DRIVER_VERSION,
+  NULL,
+  NULL
+};
+
+
 /**
   Create a HTTP driver service binding private instance.
 
@@ -73,33 +83,59 @@ HttpCreateService (
 /**
   Release all the resource used the HTTP service binding instance.
 
-  @param  HttpService        The HTTP private instance.
-
+  @param[in]  HttpService        The HTTP private instance.
+  @param[in]  UsingIpv6          Indicate use TCP4 protocol or TCP6 protocol.
+                                 if TRUE, use Tcp6 protocol.
+                                 if FALSE, use Tcp4 protocl.
 **/
 VOID
 HttpCleanService (
-  IN HTTP_SERVICE     *HttpService
+  IN HTTP_SERVICE     *HttpService,
+  IN BOOLEAN          UsingIpv6
   )
-{
+{ 
+  
   if (HttpService == NULL) {
     return ;
   }
-
-  if (HttpService->TcpChildHandle != NULL) {
-    gBS->CloseProtocol (
-           HttpService->TcpChildHandle,
-           &gEfiTcp4ProtocolGuid,
-           HttpService->ImageHandle,
-           HttpService->ControllerHandle
-           );
-
-    NetLibDestroyServiceChild (
-      HttpService->ControllerHandle,
-      HttpService->ImageHandle,
-      &gEfiTcp4ServiceBindingProtocolGuid,
-      HttpService->TcpChildHandle
-      );
+  if (!UsingIpv6) {
+    if (HttpService->Tcp4ChildHandle != NULL) {
+      gBS->CloseProtocol (
+             HttpService->Tcp4ChildHandle,
+             &gEfiTcp4ProtocolGuid,
+             HttpService->ImageHandle,
+             HttpService->ControllerHandle
+             );
+    
+      NetLibDestroyServiceChild (
+        HttpService->ControllerHandle,
+        HttpService->ImageHandle,
+        &gEfiTcp4ServiceBindingProtocolGuid,
+        HttpService->Tcp4ChildHandle
+        );
+      
+      HttpService->Tcp4ChildHandle = NULL;
+    }
+  } else {
+    if (HttpService->Tcp6ChildHandle != NULL) {
+      gBS->CloseProtocol (
+             HttpService->Tcp6ChildHandle,
+             &gEfiTcp6ProtocolGuid,
+             HttpService->ImageHandle,
+             HttpService->ControllerHandle
+             );
+    
+      NetLibDestroyServiceChild (
+        HttpService->ControllerHandle,
+        HttpService->ImageHandle,
+        &gEfiTcp6ServiceBindingProtocolGuid,
+        HttpService->Tcp6ChildHandle
+        );
+      
+      HttpService->Tcp6ChildHandle = NULL;
+    }
   }
+  
 }
 
 /**
@@ -107,7 +143,7 @@ HttpCleanService (
   in the system.
 
   @param[in]     Event         Not used.
-  @param[in]     Context       The pointer to the IP4 config2 instance data.
+  @param[in]     Context       The pointer to the IP4 config2 instance data or IP6 Config instance data.
 
 **/
 VOID
@@ -122,7 +158,7 @@ HttpUtilitiesInstalledCallback (
          NULL, 
          (VOID **) &mHttpUtilities
          );
-		 
+ 
   //
   // Close the event if Http utilities protocol is loacted.
   //
@@ -150,6 +186,7 @@ HttpDxeDriverEntryPoint (
   IN EFI_SYSTEM_TABLE  *SystemTable
   )
 { 
+  EFI_STATUS     Status;
   VOID           *Registration;
 
   gBS->LocateProtocol (
@@ -174,14 +211,39 @@ HttpDxeDriverEntryPoint (
   //
   // Install UEFI Driver Model protocol(s).
   //
-  return EfiLibInstallDriverBindingComponentName2 (
-           ImageHandle,
-           SystemTable,
-           &gHttpDxeDriverBinding,
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gHttpDxeIp4DriverBinding,
+             ImageHandle,
+             &gHttpDxeComponentName,
+             &gHttpDxeComponentName2
+             );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gHttpDxeIp6DriverBinding,
+             NULL,
+             &gHttpDxeComponentName,
+             &gHttpDxeComponentName2
+             );
+  if (EFI_ERROR (Status)) {
+    gBS->UninstallMultipleProtocolInterfaces (
            ImageHandle,
+           &gEfiDriverBindingProtocolGuid,
+           &gHttpDxeIp4DriverBinding,
+           &gEfiComponentName2ProtocolGuid,
+           &gHttpDxeComponentName2,
+           &gEfiComponentNameProtocolGuid,
            &gHttpDxeComponentName,
-           &gHttpDxeComponentName2
+           NULL
            );
+  }
+  return Status;
 }
 
 /**
@@ -223,6 +285,309 @@ HttpDestroyChildEntryInHandleBuffer (
   return ServiceBinding->DestroyChild (ServiceBinding, HttpInstance->Handle);
 }
 
+/**
+  Test to see if this driver supports ControllerHandle. This is the worker function for
+  HttpDxeIp4(6)DriverBindingSupported.
+
+  @param[in]  This                The pointer to the driver binding protocol.
+  @param[in]  ControllerHandle    The handle of device to be tested.
+  @param[in]  RemainingDevicePath Optional parameter used to pick a specific child
+                                  device to be started.
+  @param[in]  IpVersion           IP_VERSION_4 or IP_VERSION_6.
+  
+  @retval EFI_SUCCESS         This driver supports this device.
+  @retval EFI_UNSUPPORTED     This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL,
+  IN UINT8                        IpVersion
+  )
+{
+  EFI_STATUS                      Status;
+  EFI_GUID                        *TcpServiceBindingProtocolGuid;
+
+  if (IpVersion == IP_VERSION_4) {
+    TcpServiceBindingProtocolGuid = &gEfiTcp4ServiceBindingProtocolGuid;
+  } else {
+    TcpServiceBindingProtocolGuid = &gEfiTcp6ServiceBindingProtocolGuid;
+  }
+
+  Status = gBS->OpenProtocol (
+                ControllerHandle,
+                TcpServiceBindingProtocolGuid,
+                NULL,
+                This->DriverBindingHandle,
+                ControllerHandle,
+                EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                );
+
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Start this driver on ControllerHandle. This is the worker function for
+  HttpDxeIp4(6)DriverBindingStart.
+
+  @param[in]  This                 The pointer to the driver binding protocol.
+  @param[in]  ControllerHandle     The handle of device to be started.
+  @param[in]  RemainingDevicePath  Optional parameter used to pick a specific child
+                                   device to be started.
+  @param[in]  IpVersion            IP_VERSION_4 or IP_VERSION_6.
+
+
+  @retval EFI_SUCCESS          This driver is installed to ControllerHandle.
+  @retval EFI_ALREADY_STARTED  This driver is already running on ControllerHandle.
+  @retval other                This driver does not support this device.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL,
+  IN UINT8                        IpVersion
+  )
+{
+  EFI_STATUS                      Status;
+  EFI_SERVICE_BINDING_PROTOCOL    *ServiceBinding;
+  HTTP_SERVICE                    *HttpService;
+  VOID                            *Interface;
+  BOOLEAN                         UsingIpv6;
+
+  UsingIpv6 = FALSE;
+
+  //
+  // Test for the Http service binding protocol
+  //
+  Status = gBS->OpenProtocol (
+                  ControllerHandle,
+                  &gEfiHttpServiceBindingProtocolGuid,
+                  (VOID **) &ServiceBinding,
+                  This->DriverBindingHandle,
+                  ControllerHandle,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                  );
+
+  if (!EFI_ERROR (Status)) {
+    HttpService = HTTP_SERVICE_FROM_PROTOCOL (ServiceBinding);
+  } else {
+    Status = HttpCreateService (ControllerHandle, This->DriverBindingHandle, &HttpService);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    ASSERT (HttpService != NULL);
+      
+    //
+    // Install the HttpServiceBinding Protocol onto Controller
+    //
+    Status = gBS->InstallMultipleProtocolInterfaces (
+                    &ControllerHandle,
+                    &gEfiHttpServiceBindingProtocolGuid,
+                    &HttpService->ServiceBinding,
+                    NULL
+                    );
+    
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+  }
+
+  if (IpVersion == IP_VERSION_4) {
+    
+    if (HttpService->Tcp4ChildHandle == NULL) {
+      //
+      // Create a TCP4 child instance, but do not configure it. This will establish the parent-child relationship.
+      //
+      Status = NetLibCreateServiceChild (
+                 ControllerHandle,
+                 This->DriverBindingHandle,
+                 &gEfiTcp4ServiceBindingProtocolGuid,
+                 &HttpService->Tcp4ChildHandle
+                 );
+      
+      if (EFI_ERROR (Status)) {
+        goto ON_ERROR;
+      }
+      
+      Status = gBS->OpenProtocol (
+                      HttpService->Tcp4ChildHandle,
+                      &gEfiTcp4ProtocolGuid,
+                      &Interface,
+                      This->DriverBindingHandle,
+                      ControllerHandle,
+                      EFI_OPEN_PROTOCOL_BY_DRIVER
+                      );
+                      
+      if (EFI_ERROR (Status)) {
+        goto ON_ERROR;
+      }
+      
+    } else {
+      return EFI_ALREADY_STARTED;
+    }
+
+  } else {
+    UsingIpv6 = TRUE;
+    
+    if (HttpService->Tcp6ChildHandle == NULL) {
+      //
+      // Create a TCP6 child instance, but do not configure it. This will establish the parent-child relationship.
+      //
+      Status = NetLibCreateServiceChild (
+                 ControllerHandle,
+                 This->DriverBindingHandle,
+                 &gEfiTcp6ServiceBindingProtocolGuid,
+                 &HttpService->Tcp6ChildHandle
+                 );
+      
+      if (EFI_ERROR (Status)) {
+        goto ON_ERROR;
+      }
+      
+      Status = gBS->OpenProtocol (
+                      HttpService->Tcp6ChildHandle,
+                      &gEfiTcp6ProtocolGuid,
+                      &Interface,
+                      This->DriverBindingHandle,
+                      ControllerHandle,
+                      EFI_OPEN_PROTOCOL_BY_DRIVER
+                      );
+                      
+      if (EFI_ERROR (Status)) {
+        goto ON_ERROR;
+      }
+      
+    } else {
+      return EFI_ALREADY_STARTED;
+    }
+
+  }
+
+  return EFI_SUCCESS;
+  
+ON_ERROR:
+    
+  if (HttpService != NULL) {
+    HttpCleanService (HttpService, UsingIpv6);
+    if (HttpService->Tcp4ChildHandle == NULL && HttpService->Tcp6ChildHandle == NULL) {
+      FreePool (HttpService);
+    }
+  }
+      
+  return Status;
+
+
+}
+
+/**
+  Stop this driver on ControllerHandle. This is the worker function for
+  HttpDxeIp4(6)DriverBindingStop.
+
+  @param[in]  This              Protocol instance pointer.
+  @param[in]  ControllerHandle  Handle of device to stop driver on.
+  @param[in]  NumberOfChildren  Number of Handles in ChildHandleBuffer. If number of
+                                children is zero stop the entire bus driver.
+  @param[in]  ChildHandleBuffer List of Child Handles to Stop.
+  @param[in]  IpVersion         IP_VERSION_4 or IP_VERSION_6.
+
+  @retval EFI_SUCCESS           This driver was removed ControllerHandle.
+  @retval EFI_DEVICE_ERROR      An unexpected system or network error occurred.
+  @retval Others                This driver was not removed from this device
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN UINTN                        NumberOfChildren,
+  IN EFI_HANDLE                   *ChildHandleBuffer,
+  IN UINT8                        IpVersion
+  )
+{
+  EFI_HANDLE                                 NicHandle;
+  EFI_STATUS                                 Status;
+  EFI_SERVICE_BINDING_PROTOCOL               *ServiceBinding;
+  HTTP_SERVICE                               *HttpService;
+  LIST_ENTRY                                 *List;
+  HTTP_DESTROY_CHILD_IN_HANDLE_BUF_CONTEXT   Context;
+  BOOLEAN                                    UsingIpv6;
+
+  //
+  // HTTP driver opens TCP4(6) child, So, Controller is a TCP4(6)
+  // child handle. Locate the Nic handle first. Then get the
+  // HTTP private data back.
+  //
+  if (IpVersion == IP_VERSION_4) {
+    UsingIpv6 = FALSE;
+    NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiTcp4ProtocolGuid);
+  } else {
+    UsingIpv6 = TRUE;
+    NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiTcp6ProtocolGuid);
+  }
+
+  if (NicHandle == NULL) {
+    return EFI_SUCCESS;
+  }
+
+  Status = gBS->OpenProtocol (
+                  NicHandle,
+                  &gEfiHttpServiceBindingProtocolGuid,
+                  (VOID **) &ServiceBinding,
+                  This->DriverBindingHandle,
+                  NicHandle,
+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                  );
+
+  if (!EFI_ERROR (Status)) {
+    
+    HttpService = HTTP_SERVICE_FROM_PROTOCOL (ServiceBinding);
+    
+    if (NumberOfChildren != 0) {
+      //
+      // Destroy the HTTP child instance in ChildHandleBuffer.
+      //
+      List = &HttpService->ChildrenList;
+      Context.ServiceBinding    = ServiceBinding;
+      Context.NumberOfChildren  = NumberOfChildren;
+      Context.ChildHandleBuffer = ChildHandleBuffer;
+      Status = NetDestroyLinkList (
+                 List,
+                 HttpDestroyChildEntryInHandleBuffer,
+                 &Context,
+                 NULL
+                 );
+    } else {
+    
+      HttpCleanService (HttpService, UsingIpv6);
+      
+      if (HttpService->Tcp4ChildHandle == NULL && HttpService->Tcp6ChildHandle == NULL) {
+        gBS->UninstallProtocolInterface (
+               NicHandle,
+               &gEfiHttpServiceBindingProtocolGuid,
+               ServiceBinding
+               );
+        FreePool (HttpService);
+      }
+      Status = EFI_SUCCESS;
+    }  
+  }
+  
+  return Status;
+
+}
+
 /**
   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.
@@ -267,41 +632,18 @@ HttpDestroyChildEntryInHandleBuffer (
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingSupported (
+HttpDxeIp4DriverBindingSupported (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN EFI_HANDLE                   ControllerHandle,
   IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
   )
 {
-  EFI_STATUS       Status;
-
-  //
-  // Test for the HttpServiceBinding protocol.
-  //
-  Status = gBS->OpenProtocol (
-                  ControllerHandle,
-                  &gEfiHttpServiceBindingProtocolGuid,
-                  NULL,
-                  This->DriverBindingHandle,
-                  ControllerHandle,
-                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                  );
-  if (!EFI_ERROR (Status)) {
-    return EFI_ALREADY_STARTED;
-  }
-
-  //
-  // Test for the Tcp4 Protocol
-  //
-  return gBS->OpenProtocol (
-                ControllerHandle,
-                &gEfiTcp4ServiceBindingProtocolGuid,
-                NULL,
-                This->DriverBindingHandle,
-                ControllerHandle,
-                EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                );
-  
+  return HttpDxeSupported (
+           This,
+           ControllerHandle,
+           RemainingDevicePath,
+           IP_VERSION_4
+           );
 }
 
 /**
@@ -342,90 +684,173 @@ HttpDxeDriverBindingSupported (
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingStart (
+HttpDxeIp4DriverBindingStart (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN EFI_HANDLE                   ControllerHandle,
   IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
   )
 {
-  EFI_STATUS                      Status;
-  HTTP_SERVICE                    *HttpService;
-  VOID                            *Interface;
+  return HttpDxeStart (
+           This,
+           ControllerHandle,
+           RemainingDevicePath,
+           IP_VERSION_4
+           );
+}
+
+/**
+  Stops a device controller or a bus controller.
   
-  //
-  // Test for the Http service binding protocol
-  //
-  Status = gBS->OpenProtocol (
-                  ControllerHandle,
-                  &gEfiHttpServiceBindingProtocolGuid,
-                  NULL,
-                  This->DriverBindingHandle,
-                  ControllerHandle,
-                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
-                  );
+  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.
 
-  if (Status == EFI_SUCCESS) {
-    return EFI_ALREADY_STARTED;
-  }
+  @retval EFI_SUCCESS           The device was stopped.
+  @retval EFI_DEVICE_ERROR      The device could not be stopped due to a device error.
 
-  Status = HttpCreateService (ControllerHandle, This->DriverBindingHandle, &HttpService);
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp4DriverBindingStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN UINTN                        NumberOfChildren,
+  IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
+  )
+{
+  return HttpDxeStop (
+           This,
+           ControllerHandle,
+           NumberOfChildren,
+           ChildHandleBuffer,
+           IP_VERSION_4
+           );
+}
 
-  ASSERT (HttpService != NULL);
+/**
+  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.
 
-  //
-  // Create a TCP child instance, but do not configure it. This will establish the parent-child relationship.
-  //
-  Status = NetLibCreateServiceChild (
-             ControllerHandle,
-             This->DriverBindingHandle,
-             &gEfiTcp4ServiceBindingProtocolGuid,
-             &HttpService->TcpChildHandle
-             );
+  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.
 
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+  @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.
 
-  Status = gBS->OpenProtocol (
-                  HttpService->TcpChildHandle,
-                  &gEfiTcp4ProtocolGuid,
-                  &Interface,
-                  This->DriverBindingHandle,
-                  ControllerHandle,
-                  EFI_OPEN_PROTOCOL_BY_DRIVER
-                  );
-                  
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+  @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.
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp6DriverBindingSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
+  )
+{  
+  return HttpDxeSupported (
+           This,
+           ControllerHandle,
+           RemainingDevicePath,
+           IP_VERSION_6
+           );
 
-  //
-  // Install the HttpServiceBinding Protocol onto Controller
-  //
-  Status = gBS->InstallMultipleProtocolInterfaces (
-                  &ControllerHandle,
-                  &gEfiHttpServiceBindingProtocolGuid,
-                  &HttpService->ServiceBinding,
-                  NULL
-                  );
+}
 
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+/**
+  Starts a device controller or a bus controller.
 
-  return EFI_SUCCESS;
+  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.  
 
-ON_ERROR:
+  @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.
 
-  if (HttpService != NULL) {
-    HttpCleanService (HttpService);
-    FreePool (HttpService);
-  }
-  
-  return Status;
+  @retval EFI_SUCCESS              The device was started.
+  @retval EFI_ALREADY_STARTED      This device is already running on ControllerHandle.
+  @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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp6DriverBindingStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
+  )
+{
+  return HttpDxeStart (
+           This,
+           ControllerHandle,
+           RemainingDevicePath,
+           IP_VERSION_6
+           );
 }
 
 /**
@@ -456,78 +881,21 @@ HttpDxeDriverBindingStart (
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingStop (
+HttpDxeIp6DriverBindingStop (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN EFI_HANDLE                   ControllerHandle,
   IN UINTN                        NumberOfChildren,
   IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
   )
 {
-  EFI_HANDLE                                 NicHandle;
-  EFI_STATUS                                 Status;
-  EFI_SERVICE_BINDING_PROTOCOL               *ServiceBinding;
-  HTTP_SERVICE                               *HttpService;
-  LIST_ENTRY                                 *List;
-  HTTP_DESTROY_CHILD_IN_HANDLE_BUF_CONTEXT   Context;
-  
-  //
-  // HTTP driver opens TCP child, So, Controller is a TCP
-  // child handle. Locate the Nic handle first. Then get the
-  // HTTP private data back.
-  //
-  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiTcp4ProtocolGuid);
-  if (NicHandle == NULL) {
-    return EFI_SUCCESS;
-  }
-
-  Status = gBS->OpenProtocol (
-                  NicHandle,
-                  &gEfiHttpServiceBindingProtocolGuid,
-                  (VOID **) &ServiceBinding,
-                  This->DriverBindingHandle,
-                  NicHandle,
-                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
-                  );
-
-  if (EFI_ERROR (Status)) {
-    return EFI_DEVICE_ERROR;
-  }
-
-  HttpService = HTTP_SERVICE_FROM_PROTOCOL (ServiceBinding);
-
-  if (!IsListEmpty (&HttpService->ChildrenList)) {
-    //
-    // Destroy the HTTP child instance in ChildHandleBuffer.
-    //
-    List = &HttpService->ChildrenList;
-    Context.ServiceBinding    = ServiceBinding;
-    Context.NumberOfChildren  = NumberOfChildren;
-    Context.ChildHandleBuffer = ChildHandleBuffer;
-    Status = NetDestroyLinkList (
-               List,
-               HttpDestroyChildEntryInHandleBuffer,
-               &Context,
-               NULL
-               );
-  }
-
-  if (NumberOfChildren == 0 && IsListEmpty (&HttpService->ChildrenList)) {
-    gBS->UninstallProtocolInterface (
-           NicHandle,
-           &gEfiHttpServiceBindingProtocolGuid,
-           ServiceBinding
+  return HttpDxeStop (
+           This,
+           ControllerHandle,
+           NumberOfChildren,
+           ChildHandleBuffer,
+           IP_VERSION_6
            );
-
-    HttpCleanService (HttpService);
-   
-    FreePool (HttpService);
-
-    Status = EFI_SUCCESS;
-  }
-
-  return Status;
 }
-
 /**
   Creates a child handle and installs a protocol.
 
@@ -557,7 +925,6 @@ HttpServiceBindingCreateChild (
   HTTP_SERVICE         *HttpService;
   HTTP_PROTOCOL        *HttpInstance;
   EFI_STATUS           Status;
-  VOID                 *Interface;
   EFI_TPL              OldTpl;
 
   if ((This == NULL) || (ChildHandle == NULL)) {
@@ -569,6 +936,12 @@ HttpServiceBindingCreateChild (
   if (HttpInstance == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
+  
+  HttpInstance->Signature = HTTP_PROTOCOL_SIGNATURE;
+  HttpInstance->Service   = HttpService;
+  CopyMem (&HttpInstance->Http, &mEfiHttpTemplate, sizeof (HttpInstance->Http));
+  NetMapInit (&HttpInstance->TxTokens);
+  NetMapInit (&HttpInstance->RxTokens);
 
   //
   // Install HTTP protocol onto ChildHandle
@@ -584,27 +957,7 @@ HttpServiceBindingCreateChild (
     goto ON_ERROR;
   }
 
-  HttpInstance->Handle = *ChildHandle;
-
-  Status = HttpInitProtocol (HttpService, HttpInstance);
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
-
-  //
-  // Open the default Tcp4 protocol by child.
-  //
-  Status = gBS->OpenProtocol (
-                  HttpService->TcpChildHandle,
-                  &gEfiTcp4ProtocolGuid,
-                  (VOID **) &Interface,
-                  gHttpDxeDriverBinding.DriverBindingHandle,
-                  HttpInstance->Handle,
-                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
-                  );
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+  HttpInstance->Handle    = *ChildHandle;
 
   //
   // Add it to the HTTP service's child list.
@@ -619,8 +972,9 @@ HttpServiceBindingCreateChild (
   return EFI_SUCCESS;
   
 ON_ERROR:
-
-  HttpCleanProtocol (HttpInstance);
+ 
+  NetMapClean (&HttpInstance->TxTokens);
+  NetMapClean (&HttpInstance->RxTokens);
   FreePool (HttpInstance);
 
   return Status;
@@ -664,8 +1018,8 @@ HttpServiceBindingDestroyChild (
                   ChildHandle,
                   &gEfiHttpProtocolGuid,
                   (VOID **) &Http,
-                  gHttpDxeDriverBinding.DriverBindingHandle,
-                  ChildHandle,
+                  NULL,
+                  NULL,
                   EFI_OPEN_PROTOCOL_GET_PROTOCOL
                   );
   if (EFI_ERROR (Status)) {
@@ -681,16 +1035,6 @@ HttpServiceBindingDestroyChild (
     return EFI_SUCCESS;
   }
 
-  //
-  // Close the Tcp4 protocol.
-  //
-  gBS->CloseProtocol (
-         HttpService->TcpChildHandle,
-         &gEfiTcp4ProtocolGuid,
-         gHttpDxeDriverBinding.DriverBindingHandle,
-         ChildHandle
-         );
-  
   HttpInstance->InDestroy = TRUE;
 
   //
@@ -706,11 +1050,11 @@ HttpServiceBindingDestroyChild (
     HttpInstance->InDestroy = FALSE;
     return Status;
   }
-
-  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
-
+  
   HttpCleanProtocol (HttpInstance);
-
+  
+  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+  
   RemoveEntryList (&HttpInstance->Link);
   HttpService->ChildrenNumber--;
 
diff --git a/NetworkPkg/HttpDxe/HttpDriver.h b/NetworkPkg/HttpDxe/HttpDriver.h
index eea8d5169e71..8fda6b2be470 100644
--- a/NetworkPkg/HttpDxe/HttpDriver.h
+++ b/NetworkPkg/HttpDxe/HttpDriver.h
@@ -43,8 +43,12 @@
 //
 #include <Protocol/HttpUtilities.h>
 #include <Protocol/Tcp4.h>
+#include <Protocol/Tcp6.h>
 #include <Protocol/Dns4.h>
+#include <Protocol/Dns6.h>
 #include <Protocol/Ip4Config2.h>
+#include <Protocol/Ip6Config.h>
+
 
 //
 // Produced Protocols
@@ -59,7 +63,9 @@
 //
 // Protocol instances
 //
-extern EFI_DRIVER_BINDING_PROTOCOL  gHttpDxeDriverBinding;
+extern EFI_DRIVER_BINDING_PROTOCOL  gHttpDxeIp4DriverBinding;
+extern EFI_DRIVER_BINDING_PROTOCOL  gHttpDxeIp6DriverBinding;
+
 extern EFI_COMPONENT_NAME2_PROTOCOL gHttpDxeComponentName2;
 extern EFI_COMPONENT_NAME_PROTOCOL  gHttpDxeComponentName;
 
@@ -123,7 +129,7 @@ typedef struct {
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingSupported (
+HttpDxeIp4DriverBindingSupported (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN EFI_HANDLE                   ControllerHandle,
   IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
@@ -166,7 +172,7 @@ HttpDxeDriverBindingSupported (
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingStart (
+HttpDxeIp4DriverBindingStart (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN EFI_HANDLE                   ControllerHandle,
   IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
@@ -200,13 +206,142 @@ HttpDxeDriverBindingStart (
 **/
 EFI_STATUS
 EFIAPI
-HttpDxeDriverBindingStop (
+HttpDxeIp4DriverBindingStop (
   IN EFI_DRIVER_BINDING_PROTOCOL  *This,
   IN  EFI_HANDLE                  ControllerHandle,
   IN  UINTN                       NumberOfChildren,
   IN  EFI_HANDLE                  *ChildHandleBuffer OPTIONAL
   );
 
+/**
+  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.
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp6DriverBindingSupported (
+  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_ALREADY_STARTED      This device is already running on ControllerHandle.
+  @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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp6DriverBindingStart (
+  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.
+
+**/
+EFI_STATUS
+EFIAPI
+HttpDxeIp6DriverBindingStop (
+  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
+  IN EFI_HANDLE                   ControllerHandle,
+  IN UINTN                        NumberOfChildren,
+  IN EFI_HANDLE                   *ChildHandleBuffer OPTIONAL
+  );
+
 /**
   Creates a child handle and installs a protocol.
 
diff --git a/NetworkPkg/HttpDxe/HttpDxe.inf b/NetworkPkg/HttpDxe/HttpDxe.inf
index 0d3bd00cf7b7..bf2cbee5f7c9 100644
--- a/NetworkPkg/HttpDxe/HttpDxe.inf
+++ b/NetworkPkg/HttpDxe/HttpDxe.inf
@@ -56,9 +56,14 @@
   gEfiHttpUtilitiesProtocolGuid                    ## CONSUMES
   gEfiTcp4ServiceBindingProtocolGuid               ## TO_START
   gEfiTcp4ProtocolGuid                             ## TO_START
+  gEfiTcp6ServiceBindingProtocolGuid               ## TO_START
+  gEfiTcp6ProtocolGuid                             ## TO_START
   gEfiDns4ServiceBindingProtocolGuid               ## SOMETIMES_CONSUMES
   gEfiDns4ProtocolGuid                             ## SOMETIMES_CONSUMES
+  gEfiDns6ServiceBindingProtocolGuid               ## SOMETIMES_CONSUMES
+  gEfiDns6ProtocolGuid                             ## SOMETIMES_CONSUMES
   gEfiIp4Config2ProtocolGuid                       ## SOMETIMES_CONSUMES
+  gEfiIp6ConfigProtocolGuid                        ## SOMETIMES_CONSUMES
 
 [UserExtensions.TianoCore."ExtraFiles"]
   HttpDxeExtra.uni
\ No newline at end of file
diff --git a/NetworkPkg/HttpDxe/HttpDxe.uni b/NetworkPkg/HttpDxe/HttpDxe.uni
index f9c2ac812e573faa9e5ff1e6d2ecd630be2ff395..d6792dd41eb4c2642d65eb7e01c0833b43f92761 100644
GIT binary patch
delta 63
zcmbQow~ueaC*FL9A_fHpPlf=7G6u7a?<LvPP(*-o#SA43i44gM*$jFNN({UVTwn|U
D?<EW^

delta 34
mcmdnTH;-?^r_D@^Vr*i?3?&SS49N`H40;So47?0nU<?4CvIchm

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index de3ec9c28400..fc9d691f2299 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -50,6 +50,8 @@ EfiHttpGetModeData (
   )
 {
   HTTP_PROTOCOL                 *HttpInstance;
+  EFI_HTTPv4_ACCESS_POINT       *Http4AccessPoint;
+  EFI_HTTPv6_ACCESS_POINT       *Http6AccessPoint;
 
   if ((This == NULL) || (HttpConfigData == NULL)) {
     return EFI_INVALID_PARAMETER;
@@ -57,24 +59,32 @@ EfiHttpGetModeData (
   
   HttpInstance = HTTP_INSTANCE_FROM_PROTOCOL (This);
   ASSERT (HttpInstance != NULL);
-
+  
   if (HttpInstance->State < HTTP_STATE_HTTP_CONFIGED) {
     return EFI_NOT_STARTED;
   }
 
-  if (HttpConfigData->AccessPoint.IPv4Node == NULL) {
-    return EFI_INVALID_PARAMETER;
-  }
-
   HttpConfigData->HttpVersion        = HttpInstance->HttpVersion;
   HttpConfigData->TimeOutMillisec    = HttpInstance->TimeOutMillisec;
   HttpConfigData->LocalAddressIsIPv6 = HttpInstance->LocalAddressIsIPv6;
 
-  CopyMem (
-    HttpConfigData->AccessPoint.IPv4Node,
-    &HttpInstance->IPv4Node,
-    sizeof (HttpInstance->IPv4Node)
+  if (HttpInstance->LocalAddressIsIPv6) {
+    Http6AccessPoint = AllocateZeroPool (sizeof (EFI_HTTPv6_ACCESS_POINT));
+    CopyMem (
+      Http6AccessPoint,
+      &HttpInstance->Ipv6Node,
+      sizeof (HttpInstance->Ipv6Node)
     );
+    HttpConfigData->AccessPoint.IPv6Node = Http6AccessPoint;
+  } else {
+    Http4AccessPoint = AllocateZeroPool (sizeof (EFI_HTTPv4_ACCESS_POINT));
+    CopyMem (
+      Http4AccessPoint,
+      &HttpInstance->IPv4Node,
+      sizeof (HttpInstance->IPv4Node)
+      );
+    HttpConfigData->AccessPoint.IPv4Node = Http4AccessPoint;
+  }
 
   return EFI_SUCCESS;
 }
@@ -119,8 +129,13 @@ EfiHttpConfigure (
 {
   HTTP_PROTOCOL                 *HttpInstance;
   EFI_STATUS                    Status;
-
-  if (This == NULL) {
+  
+  //
+  // Check input parameters.
+  //
+  if (This == NULL || 
+     (HttpConfigData != NULL && ((HttpConfigData->LocalAddressIsIPv6 && HttpConfigData->AccessPoint.IPv6Node == NULL) ||
+                                 (!HttpConfigData->LocalAddressIsIPv6 && HttpConfigData->AccessPoint.IPv4Node == NULL)))) {
     return EFI_INVALID_PARAMETER;
   }
 
@@ -128,18 +143,7 @@ EfiHttpConfigure (
   ASSERT (HttpInstance != NULL && HttpInstance->Service != NULL);
 
   if (HttpConfigData != NULL) {
-    //
-    // Check input parameters.
-    //
-    if (HttpConfigData->LocalAddressIsIPv6) {
-      if (HttpConfigData->AccessPoint.IPv6Node == NULL) {
-        return EFI_INVALID_PARAMETER;
-      }
-    } else {
-      if (HttpConfigData->AccessPoint.IPv4Node == NULL) {
-        return EFI_INVALID_PARAMETER;
-      }
-    }
+
     //
     // Now configure this HTTP instance.
     //
@@ -150,33 +154,38 @@ EfiHttpConfigure (
     HttpInstance->HttpVersion        = HttpConfigData->HttpVersion;
     HttpInstance->TimeOutMillisec    = HttpConfigData->TimeOutMillisec;
     HttpInstance->LocalAddressIsIPv6 = HttpConfigData->LocalAddressIsIPv6;
-
-    if (HttpConfigData->LocalAddressIsIPv6) {
-      return EFI_UNSUPPORTED;
+    
+    if (HttpConfigData->LocalAddressIsIPv6) { 
+      CopyMem (
+        &HttpInstance->Ipv6Node,
+        HttpConfigData->AccessPoint.IPv6Node,
+        sizeof (HttpInstance->Ipv6Node)
+        );
     } else {
       CopyMem (
         &HttpInstance->IPv4Node,
         HttpConfigData->AccessPoint.IPv4Node,
         sizeof (HttpInstance->IPv4Node)
         );
-
-      HttpInstance->State = HTTP_STATE_HTTP_CONFIGED;
-      return EFI_SUCCESS;
     }
+    //
+    // Creat Tcp child
+    //
+    Status = HttpInitProtocol (HttpInstance, HttpInstance->LocalAddressIsIPv6);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    HttpInstance->State = HTTP_STATE_HTTP_CONFIGED;
+    return EFI_SUCCESS;
 
   } else {
-    if (HttpInstance->LocalAddressIsIPv6) {
-      return EFI_UNSUPPORTED;
-    } else {
-      HttpCleanProtocol (HttpInstance);
-      Status = HttpInitProtocol (HttpInstance->Service, HttpInstance);
-      if (EFI_ERROR (Status)) {
-        return Status;
-      }
-
-      HttpInstance->State = HTTP_STATE_UNCONFIGED;
-      return EFI_SUCCESS;
-    }
+    //
+    // Reset all the resources related to HttpInsance.
+    //
+    HttpCleanProtocol (HttpInstance);
+    HttpInstance->State = HTTP_STATE_UNCONFIGED;
+    return EFI_SUCCESS;
   }
 }
  
@@ -264,10 +273,6 @@ EfiHttpRequest (
     return EFI_NOT_STARTED;
   }
 
-  if (HttpInstance->LocalAddressIsIPv6) {
-    return EFI_UNSUPPORTED;
-  }
-
   //
   // Check whether the token already existed.
   //
@@ -292,7 +297,8 @@ EfiHttpRequest (
     }
     FreePool (HttpInstance->Url);
     HttpInstance->Url = Url;    
-  }  
+  } 
+
 
   UnicodeStrToAsciiStr (Request->Url, Url);
   UrlParser = NULL;
@@ -341,7 +347,7 @@ EfiHttpRequest (
         Wrap->HttpToken    = Token;
         Wrap->HttpInstance = HttpInstance;
 
-        Status = HttpCreateTcp4TxEvent (Wrap);
+        Status = HttpCreateTcpTxEvent (Wrap);
         if (EFI_ERROR (Status)) {
           goto Error1;
         }
@@ -380,24 +386,35 @@ EfiHttpRequest (
 
   if (Configure) {
     //
-    // Parse Url for IPv4 address, if failed, perform DNS resolution.
+    // Parse Url for IPv4 or IPv6 address, if failed, perform DNS resolution.
     //
-    Status = NetLibAsciiStrToIp4 (HostName, &HttpInstance->RemoteAddr);
+    if (!HttpInstance->LocalAddressIsIPv6) {
+      Status = NetLibAsciiStrToIp4 (HostName, &HttpInstance->RemoteAddr);
+    } else {
+      Status = NetLibAsciiStrToIp6 (HostName, &HttpInstance->RemoteIpv6Addr);
+    }
+
     if (EFI_ERROR (Status)) {
-      HostNameStr = AllocateZeroPool ((AsciiStrLen (HostName) + 1) * sizeof (UINT16));
+      HostNameStr = AllocateZeroPool ((AsciiStrLen (HostName) + 1) * sizeof (CHAR16));
       if (HostNameStr == NULL) {
         Status = EFI_OUT_OF_RESOURCES;
         goto Error1;
       }
-
+      
       AsciiStrToUnicodeStr (HostName, HostNameStr);
-      Status = HttpDns4 (HttpInstance, HostNameStr, &HttpInstance->RemoteAddr);
+      if (!HttpInstance->LocalAddressIsIPv6) {
+        Status = HttpDns4 (HttpInstance, HostNameStr, &HttpInstance->RemoteAddr);
+      } else {
+        Status = HttpDns6 (HttpInstance, HostNameStr, &HttpInstance->RemoteIpv6Addr);
+      }
+      
       FreePool (HostNameStr);
       if (EFI_ERROR (Status)) {
         goto Error1;
       }
     }
 
+
     //
     // Save the RemotePort and RemoteHost.
     //
@@ -411,7 +428,7 @@ EfiHttpRequest (
     //
     // The request URL is different from previous calls to Request(), close existing TCP instance.
     //
-    ASSERT (HttpInstance->Tcp4 != NULL);
+    ASSERT (HttpInstance->Tcp4 != NULL &&HttpInstance->Tcp6 != NULL);
     HttpCloseConnection (HttpInstance);
     EfiHttpCancel (This, NULL);
   }
@@ -430,25 +447,16 @@ EfiHttpRequest (
   Wrap->TcpWrap.Method = Request->Method;
 
   if (Configure) {
-    //
-    // Configure TCP instance.
-    //
-    Status = HttpConfigureTcp4 (HttpInstance, Wrap);
-    if (EFI_ERROR (Status)) {
-      goto Error1;
-    }
-    //
-    // Connect TCP.
-    //
-    Status = HttpConnectTcp4 (HttpInstance);
+    Status = HttpInitTcp (HttpInstance, Wrap);
     if (EFI_ERROR (Status)) {
       goto Error2;
     }
+
   } else {
     //
     // For the new HTTP token, create TX TCP token events.    
     //
-    Status = HttpCreateTcp4TxEvent (Wrap);
+    Status = HttpCreateTcpTxEvent (Wrap);
     if (EFI_ERROR (Status)) {
       goto Error1;
     }
@@ -489,7 +497,7 @@ EfiHttpRequest (
   //
   // Transmit the request message.
   //
-  Status = HttpTransmitTcp4 (
+  Status = HttpTransmitTcp (
              HttpInstance,
              Wrap,
              (UINT8*) RequestStr,
@@ -500,11 +508,11 @@ EfiHttpRequest (
   }
 
   DispatchDpc ();
-
+  
   if (HostName != NULL) {
     FreePool (HostName);
   }
-
+  
   return EFI_SUCCESS;
 
 Error5:
@@ -518,15 +526,19 @@ EfiHttpRequest (
 Error3:
   HttpCloseConnection (HttpInstance);
 
-
 Error2:
-  HttpCloseTcp4ConnCloseEvent (HttpInstance);
-  if (NULL != Wrap->TcpWrap.TxToken.CompletionToken.Event) {
-    gBS->CloseEvent (Wrap->TcpWrap.TxToken.CompletionToken.Event);
-    Wrap->TcpWrap.TxToken.CompletionToken.Event = NULL;
+  HttpCloseTcpConnCloseEvent (HttpInstance);
+  if (NULL != Wrap->TcpWrap.Tx4Token.CompletionToken.Event) {
+    gBS->CloseEvent (Wrap->TcpWrap.Tx4Token.CompletionToken.Event);
+    Wrap->TcpWrap.Tx4Token.CompletionToken.Event = NULL;
+  }
+  if (NULL != Wrap->TcpWrap.Tx6Token.CompletionToken.Event) {
+    gBS->CloseEvent (Wrap->TcpWrap.Tx6Token.CompletionToken.Event);
+    Wrap->TcpWrap.Tx6Token.CompletionToken.Event = NULL;
   }
 
 Error1:
+
   if (HostName != NULL) {
     FreePool (HostName);
   }
@@ -542,7 +554,7 @@ EfiHttpRequest (
 }
 
 /**
-  Cancel a TxToken or RxToken. 
+  Cancel a user's Token. 
  
   @param[in]  Map                The HTTP instance's token queue.
   @param[in]  Item               Object container for one HTTP token and token's wrap.
@@ -563,6 +575,7 @@ HttpCancelTokens (
 
   EFI_HTTP_TOKEN            *Token;
   HTTP_TOKEN_WRAP           *Wrap;
+  HTTP_PROTOCOL             *HttpInstance;
 
   Token = (EFI_HTTP_TOKEN *) Context;
 
@@ -576,24 +589,41 @@ HttpCancelTokens (
 
   Wrap = (HTTP_TOKEN_WRAP *) Item->Value;
   ASSERT (Wrap != NULL);
+  HttpInstance = Wrap->HttpInstance;
 
   //
   // Free resources.
   //
   NetMapRemoveItem (Map, Item, NULL); 
   
-  if (Wrap->TcpWrap.TxToken.CompletionToken.Event != NULL) {
-    gBS->CloseEvent (Wrap->TcpWrap.TxToken.CompletionToken.Event);
-  }
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    if (Wrap->TcpWrap.Tx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Tx4Token.CompletionToken.Event);
+    }
+    
+    if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
+    }
+    
+    if (Wrap->TcpWrap.Rx4Token.Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Wrap->TcpWrap.Rx4Token.Packet.RxData->FragmentTable[0].FragmentBuffer);
+    }
 
-  if (Wrap->TcpWrap.RxToken.CompletionToken.Event != NULL) {
-    gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
-  }
+  } else {
+    if (Wrap->TcpWrap.Tx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Tx6Token.CompletionToken.Event);
+    }
+
+    if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
+    }
 
-  if (Wrap->TcpWrap.RxToken.Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
-    FreePool (Wrap->TcpWrap.RxToken.Packet.RxData->FragmentTable[0].FragmentBuffer);
+    if (Wrap->TcpWrap.Rx6Token.Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Wrap->TcpWrap.Rx6Token.Packet.RxData->FragmentTable[0].FragmentBuffer);
+    }
   }
 
+
   FreePool (Wrap);
 
   //
@@ -748,7 +778,7 @@ HttpBodyParserCallback (
   Wrap->HttpInstance->NextMsg = Data;
 
   //
-  // Free TxToken since already received corrsponding HTTP response.
+  // Free Tx4Token or Tx6Token since already received corrsponding HTTP response.
   //
   FreePool (Wrap);
 
@@ -762,7 +792,7 @@ HttpBodyParserCallback (
 
   @retval EFI_SUCCESS             Allocation succeeded.
   @retval EFI_OUT_OF_RESOURCES    Failed to complete the opration due to lack of resources.
-  @retval EFI_NOT_READY           Can't find a corresponding TxToken or 
+  @retval EFI_NOT_READY           Can't find a corresponding Tx4Token/Tx6Token or 
                                   the EFI_HTTP_UTILITIES_PROTOCOL is not available.
 
 **/
@@ -773,12 +803,9 @@ HttpResponseWorker (
 {
   EFI_STATUS                    Status;
   EFI_HTTP_MESSAGE              *HttpMsg;
-  EFI_TCP4_IO_TOKEN             *RxToken;
-  EFI_TCP4_PROTOCOL             *Tcp4;
   CHAR8                         *EndofHeader;
   CHAR8                         *HttpHeaders;
   UINTN                         SizeofHeaders;
-  CHAR8                         *Buffer;
   UINTN                         BufferSize;
   UINTN                         StatusCode;
   CHAR8                         *Tmp;
@@ -797,23 +824,21 @@ HttpResponseWorker (
   
   HttpInstance = Wrap->HttpInstance;
   Token = Wrap->HttpToken;
-
   HttpMsg = Token->Message;
 
-  Tcp4 = HttpInstance->Tcp4;
-  ASSERT (Tcp4 != NULL);
-  HttpMsg->Headers = NULL;
-  HttpHeaders   = NULL;
-  SizeofHeaders = 0;
-  Buffer        = NULL;
-  BufferSize    = 0;
-  EndofHeader   = NULL;
+  HttpInstance->EndofHeader = NULL;
+  HttpInstance->HttpHeaders = NULL;
+  HttpMsg->Headers          = NULL;
+  HttpHeaders               = NULL;
+  SizeofHeaders             = 0;
+  BufferSize                = 0;
+  EndofHeader               = NULL;
  
   if (HttpMsg->Data.Response != NULL) {
     //
     // Need receive the HTTP headers, prepare buffer.
     //
-    Status = HttpCreateTcp4RxEventForHeader (HttpInstance);
+    Status = HttpCreateTcpRxEventForHeader (HttpInstance);
     if (EFI_ERROR (Status)) {
       goto Error;
     }
@@ -844,70 +869,15 @@ HttpResponseWorker (
       // Check whether we cached the whole HTTP headers.
       //
       EndofHeader = AsciiStrStr (HttpHeaders, HTTP_END_OF_HDR_STR); 
-    }
-    
-    RxToken = &HttpInstance->RxToken;
-    RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer = AllocateZeroPool (DEF_BUF_LEN);
-    if (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer == NULL) {
-      Status = EFI_OUT_OF_RESOURCES;
-      goto Error;
-    }
-
-    //
-    // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
-    //
-    while (EndofHeader == NULL) {   
-      HttpInstance->IsRxDone = FALSE;
-      RxToken->Packet.RxData->DataLength = DEF_BUF_LEN;
-      RxToken->Packet.RxData->FragmentTable[0].FragmentLength = DEF_BUF_LEN;
-      Status = Tcp4->Receive (Tcp4, RxToken);
-      if (EFI_ERROR (Status)) {
-        DEBUG ((EFI_D_ERROR, "Tcp4 receive failed: %r\n", Status));
-        goto Error;
-      }
-      
-      while (!HttpInstance->IsRxDone) {
-       Tcp4->Poll (Tcp4);
-      }    
-
-      Status = RxToken->CompletionToken.Status;
-      if (EFI_ERROR (Status)) {
-        goto Error;
-      }
-
-      //
-      // Append the response string.
-      //
-      BufferSize = SizeofHeaders + RxToken->Packet.RxData->FragmentTable[0].FragmentLength;
-      Buffer = AllocateZeroPool (BufferSize);
-      if (Buffer == NULL) {
-        Status = EFI_OUT_OF_RESOURCES;
-        goto Error;
-      }
-
-      if (HttpHeaders != NULL) {
-        CopyMem (Buffer, HttpHeaders, SizeofHeaders);
-        FreePool (HttpHeaders);
-      }
-
-      CopyMem (
-        Buffer + SizeofHeaders,
-        RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer,
-        RxToken->Packet.RxData->FragmentTable[0].FragmentLength
-        );
-      HttpHeaders   = Buffer;
-      SizeofHeaders = BufferSize;
+    }   
 
-      //
-      // Check whether we received end of HTTP headers.
-      //
-      EndofHeader = AsciiStrStr (HttpHeaders, HTTP_END_OF_HDR_STR); 
-    };
+    HttpInstance->EndofHeader = &EndofHeader;
+    HttpInstance->HttpHeaders = &HttpHeaders;
 
-    //
-    // Skip the CRLF after the HTTP headers.
-    //
-    EndofHeader = EndofHeader + AsciiStrLen (HTTP_END_OF_HDR_STR);
+    Status = HttpTcpReceiveHeader (HttpInstance, &SizeofHeaders, &BufferSize);
+    if (EFI_ERROR (Status)) {
+      goto Error;
+    }
 
     //
     // Cache the part of body.
@@ -928,9 +898,6 @@ HttpResponseWorker (
       HttpInstance->CacheLen = BodyLen;
     }
 
-    FreePool (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer);
-    RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
-
     //
     // Search for Status Code.
     //
@@ -998,7 +965,7 @@ HttpResponseWorker (
     }
 
     //
-    // The first TxToken not transmitted yet, insert back and return error.
+    // The first Tx Token not transmitted yet, insert back and return error.
     //
     if (!ValueInItem->TcpWrap.IsTxDone) {
       goto Error2;
@@ -1109,16 +1076,8 @@ HttpResponseWorker (
   //
   // We still need receive more data when there is no cache data and MsgParser is not NULL;
   //
-  RxToken = &Wrap->TcpWrap.RxToken;
-
-  RxToken->Packet.RxData->DataLength = (UINT32) HttpMsg->BodyLength;
-  RxToken->Packet.RxData->FragmentTable[0].FragmentLength = (UINT32) HttpMsg->BodyLength;
-  RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer = (VOID *) HttpMsg->Body;
-
-  RxToken->CompletionToken.Status = EFI_NOT_READY;
-  Status = Tcp4->Receive (Tcp4, RxToken);
+  Status = HttpTcpReceiveBody (Wrap, HttpMsg);
   if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_ERROR, "Tcp4 receive failed: %r\n", Status));
     goto Error;
   }
 
@@ -1131,18 +1090,7 @@ HttpResponseWorker (
   }
   Token->Status = Status;
   gBS->SignalEvent (Token->Event);
-
-  if (Wrap != NULL) {
-    if (Wrap->TcpWrap.RxToken.CompletionToken.Event != NULL) {
-      gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
-    }
-  }
-  
-  if (HttpInstance->RxToken.CompletionToken.Event != NULL) {
-    gBS->CloseEvent (HttpInstance->RxToken.CompletionToken.Event);
-    HttpInstance->RxToken.CompletionToken.Event = NULL;
-  }  
-  
+  HttpCloseTcpRxEvent (Wrap);
   FreePool (Wrap);
   return Status;
 
@@ -1150,28 +1098,7 @@ HttpResponseWorker (
   NetMapInsertHead (&HttpInstance->TxTokens, ValueInItem->HttpToken, ValueInItem);
 
 Error:
-  if (Wrap != NULL) {
-    if (Wrap->TcpWrap.RxToken.CompletionToken.Event != NULL) {
-      gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
-    }
-    RxToken = &Wrap->TcpWrap.RxToken;
-    if (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
-      FreePool (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer);
-      RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
-    }
-    FreePool (Wrap);
-  }
-
-  if (HttpInstance->RxToken.CompletionToken.Event != NULL) {
-    gBS->CloseEvent (HttpInstance->RxToken.CompletionToken.Event);
-    HttpInstance->RxToken.CompletionToken.Event = NULL;
-  }
-
-  RxToken = &HttpInstance->RxToken;
-  if (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
-    FreePool (RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer);
-    RxToken->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
-  }
+  HttpTcpTokenCleanup (Wrap);
   
   if (HttpHeaders != NULL) {
     FreePool (HttpHeaders);
@@ -1269,10 +1196,6 @@ EfiHttpResponse (
     return EFI_NOT_STARTED;
   }
 
-  if (HttpInstance->LocalAddressIsIPv6) {
-    return EFI_UNSUPPORTED;
-  }  
-
   //
   // Check whether the token already existed.
   //
@@ -1288,7 +1211,7 @@ EfiHttpResponse (
   Wrap->HttpInstance = HttpInstance;
   Wrap->HttpToken    = Token;
 
-  Status = HttpCreateTcp4RxEvent (Wrap);
+  Status = HttpCreateTcpRxEvent (Wrap);
   if (EFI_ERROR (Status)) {
     goto Error;
   }
@@ -1309,8 +1232,12 @@ EfiHttpResponse (
 
 Error:
   if (Wrap != NULL) {
-    if (Wrap->TcpWrap.RxToken.CompletionToken.Event != NULL) {
-      gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
+    if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
+    }
+
+    if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
     }
     FreePool (Wrap);
   }  
@@ -1344,8 +1271,8 @@ EfiHttpPoll (
   IN  EFI_HTTP_PROTOCOL         *This
   )
 {
-  HTTP_PROTOCOL                 *HttpInstance;
   EFI_STATUS                    Status;
+  HTTP_PROTOCOL                 *HttpInstance;
 
   if (This == NULL) {
     return EFI_INVALID_PARAMETER;
@@ -1354,17 +1281,18 @@ EfiHttpPoll (
   HttpInstance = HTTP_INSTANCE_FROM_PROTOCOL (This);
   ASSERT (HttpInstance != NULL);
 
-  if (HttpInstance->LocalAddressIsIPv6) {
-    return EFI_UNSUPPORTED;
-  }
-
-  if (HttpInstance->Tcp4 == NULL || HttpInstance->State != HTTP_STATE_TCP_CONNECTED) {
+  if (HttpInstance->State != HTTP_STATE_TCP_CONNECTED || (HttpInstance->Tcp4 == NULL && 
+                                                          HttpInstance->Tcp6 == NULL)) {
     return EFI_NOT_STARTED;
   }
-
-  Status = HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
-
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    Status = HttpInstance->Tcp6->Poll (HttpInstance->Tcp6);
+  } else {
+    Status = HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+  }
+  
   DispatchDpc ();
-
+ 
   return Status;
 }
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 13d5748378e3..c4ffef2bc236 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -37,7 +37,7 @@ HttpCommonNotify (
 }
 
 /**
-  The notify function associated with TxToken for Tcp4->Transmit().
+  The notify function associated with Tx4Token for Tcp4->Transmit() or Tx6Token for Tcp6->Transmit().
 
   @param[in]  Context The context.
 
@@ -49,25 +49,46 @@ HttpTcpTransmitNotifyDpc (
   )
 {
   HTTP_TOKEN_WRAP          *Wrap;
+  HTTP_PROTOCOL            *HttpInstance;
 
   if (Context == NULL) {
     return ;
   }
+  
+  Wrap         = (HTTP_TOKEN_WRAP *) Context;
+  HttpInstance = Wrap->HttpInstance;
+  
+  if (!HttpInstance->LocalAddressIsIPv6) {
+      Wrap->HttpToken->Status = Wrap->TcpWrap.Tx4Token.CompletionToken.Status;
+      gBS->SignalEvent (Wrap->HttpToken->Event);
+
+      //
+      // Free resources.
+      //
+      if (Wrap->TcpWrap.Tx4Token.Packet.TxData->FragmentTable[0].FragmentBuffer != NULL) {
+        FreePool (Wrap->TcpWrap.Tx4Token.Packet.TxData->FragmentTable[0].FragmentBuffer);
+      }
 
-  Wrap = (HTTP_TOKEN_WRAP *) Context;
-  Wrap->HttpToken->Status = Wrap->TcpWrap.TxToken.CompletionToken.Status;
-  gBS->SignalEvent (Wrap->HttpToken->Event);
+      if (Wrap->TcpWrap.Tx4Token.CompletionToken.Event != NULL) {
+        gBS->CloseEvent (Wrap->TcpWrap.Tx4Token.CompletionToken.Event);
+      }
+      
+  } else {
+    Wrap->HttpToken->Status = Wrap->TcpWrap.Tx6Token.CompletionToken.Status;
+    gBS->SignalEvent (Wrap->HttpToken->Event);
+    
+    //
+    // Free resources.
+    //
+    if (Wrap->TcpWrap.Tx6Token.Packet.TxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Wrap->TcpWrap.Tx6Token.Packet.TxData->FragmentTable[0].FragmentBuffer);
+    }
 
-  //
-  // Free resources.
-  //
-  if (Wrap->TcpWrap.TxToken.Packet.TxData->FragmentTable[0].FragmentBuffer != NULL) {
-    FreePool (Wrap->TcpWrap.TxToken.Packet.TxData->FragmentTable[0].FragmentBuffer);
+    if (Wrap->TcpWrap.Tx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Tx6Token.CompletionToken.Event);
+    }   
   }
 
-  if (Wrap->TcpWrap.TxToken.CompletionToken.Event != NULL) {
-    gBS->CloseEvent (Wrap->TcpWrap.TxToken.CompletionToken.Event);
-  }
 
   Wrap->TcpWrap.IsTxDone = TRUE;
 
@@ -98,9 +119,8 @@ HttpTcpTransmitNotify (
   QueueDpc (TPL_CALLBACK, HttpTcpTransmitNotifyDpc, Context);
 }
 
-
 /**
-  The notify function associated with RxToken for Tcp4->Receive ().
+  The notify function associated with Rx4Token for Tcp4->Receive () or Rx6Token for Tcp6->Receive().
 
   @param[in]  Context The context.
 
@@ -116,25 +136,41 @@ HttpTcpReceiveNotifyDpc (
   UINTN                    Length;
   EFI_STATUS               Status;
   HTTP_PROTOCOL            *HttpInstance;
+  BOOLEAN                  UsingIpv6;
 
   if (Context == NULL) {
     return ;
   }
 
   Wrap = (HTTP_TOKEN_WRAP *) Context;
-  gBS->CloseEvent (Wrap->TcpWrap.RxToken.CompletionToken.Event);
-  if (EFI_ERROR (Wrap->TcpWrap.RxToken.CompletionToken.Status)) {
-    return ;
-  }
-
   HttpInstance = Wrap->HttpInstance;
+  UsingIpv6    = HttpInstance->LocalAddressIsIPv6;
+  
+  if (UsingIpv6) {
+    gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
+    
+    if (EFI_ERROR (Wrap->TcpWrap.Rx6Token.CompletionToken.Status)) {
+      return ;
+    }
+
+  } else {
+    gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
+    
+    if (EFI_ERROR (Wrap->TcpWrap.Rx4Token.CompletionToken.Status)) {
+      return ;
+    }
+  }
 
   //
   // Check whether we receive a complete HTTP message.
   //
   ASSERT (HttpInstance->MsgParser != NULL);
+  if (UsingIpv6) {
+    Length = (UINTN) Wrap->TcpWrap.Rx6Data.FragmentTable[0].FragmentLength;
+  } else {
+    Length = (UINTN) Wrap->TcpWrap.Rx4Data.FragmentTable[0].FragmentLength;
+  }
 
-  Length = (UINTN) Wrap->TcpWrap.RxData.FragmentTable[0].FragmentLength;
   Status = HttpParseMessageBody (
              HttpInstance->MsgParser,
              Length,
@@ -179,7 +215,12 @@ HttpTcpReceiveNotifyDpc (
 
 
   Wrap->TcpWrap.IsRxDone = TRUE;
-  Wrap->HttpToken->Status = Wrap->TcpWrap.RxToken.CompletionToken.Status;
+  if (UsingIpv6) {
+    Wrap->HttpToken->Status = Wrap->TcpWrap.Rx6Token.CompletionToken.Status;
+  } else {
+    Wrap->HttpToken->Status = Wrap->TcpWrap.Rx4Token.CompletionToken.Status;
+  }
+  
 
   gBS->SignalEvent (Wrap->HttpToken->Event);
 
@@ -211,9 +252,8 @@ HttpTcpReceiveNotify (
   QueueDpc (TPL_CALLBACK, HttpTcpReceiveNotifyDpc, Context);
 }
 
-
 /**
-  Create events for the TCP4 connection token and TCP4 close token.
+  Create events for the TCP connection token and TCP close token.
 
   @param[in]  HttpInstance       Pointer to HTTP_PROTOCOL structure.
 
@@ -222,11 +262,13 @@ HttpTcpReceiveNotify (
 
 **/
 EFI_STATUS
-HttpCreateTcp4ConnCloseEvent (
+HttpCreateTcpConnCloseEvent (
   IN  HTTP_PROTOCOL        *HttpInstance
   )
 {
   EFI_STATUS               Status;
+
+  if (!HttpInstance->LocalAddressIsIPv6) {
     //
     // Create events for variuos asynchronous operations.
     //
@@ -234,66 +276,109 @@ HttpCreateTcp4ConnCloseEvent (
                     EVT_NOTIFY_SIGNAL,
                     TPL_NOTIFY,
                     HttpCommonNotify,
-                    &HttpInstance->IsConnDone,
-                    &HttpInstance->ConnToken.CompletionToken.Event
+                    &HttpInstance->IsTcp4ConnDone,
+                    &HttpInstance->Tcp4ConnToken.CompletionToken.Event
                     );
     if (EFI_ERROR (Status)) {
       goto ERROR;
     }
 
     //
-    // Initialize CloseToken
+    // Initialize Tcp4CloseToken
     //
     Status = gBS->CreateEvent (
                     EVT_NOTIFY_SIGNAL,
                     TPL_NOTIFY,
                     HttpCommonNotify,
-                    &HttpInstance->IsCloseDone,
-                    &HttpInstance->CloseToken.CompletionToken.Event
+                    &HttpInstance->IsTcp4CloseDone,
+                    &HttpInstance->Tcp4CloseToken.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ERROR;
+    }
+    
+  } else {
+    //
+    // Create events for variuos asynchronous operations.
+    //
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpCommonNotify,
+                    &HttpInstance->IsTcp6ConnDone,
+                    &HttpInstance->Tcp6ConnToken.CompletionToken.Event
                     );
     if (EFI_ERROR (Status)) {
       goto ERROR;
     }
 
- 
+    //
+    // Initialize Tcp6CloseToken
+    //
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpCommonNotify,
+                    &HttpInstance->IsTcp6CloseDone,
+                    &HttpInstance->Tcp6CloseToken.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      goto ERROR;
+    }
+  }
+     
   return EFI_SUCCESS;
 
 ERROR:
   //
   // Error handling
   //
-  HttpCloseTcp4ConnCloseEvent (HttpInstance);
+  HttpCloseTcpConnCloseEvent (HttpInstance);
 
   return Status;
 }
 
 
 /**
-  Close events in the TCP4 connection token and TCP4 close token.
+  Close events in the TCP connection token and TCP close token.
 
   @param[in]  HttpInstance   Pointer to HTTP_PROTOCOL structure.
 
 **/
 VOID
-HttpCloseTcp4ConnCloseEvent (
+HttpCloseTcpConnCloseEvent (
   IN  HTTP_PROTOCOL        *HttpInstance
   )
 {
   ASSERT (HttpInstance != NULL);
 
-  if (NULL != HttpInstance->ConnToken.CompletionToken.Event) {
-    gBS->CloseEvent (HttpInstance->ConnToken.CompletionToken.Event);
-    HttpInstance->ConnToken.CompletionToken.Event = NULL;
-  }
+  if (HttpInstance->LocalAddressIsIPv6) {
+    if (NULL != HttpInstance->Tcp6ConnToken.CompletionToken.Event) {
+      gBS->CloseEvent (HttpInstance->Tcp6ConnToken.CompletionToken.Event);
+      HttpInstance->Tcp6ConnToken.CompletionToken.Event = NULL;
+    }
 
-  if (NULL != HttpInstance->CloseToken.CompletionToken.Event) {
-    gBS->CloseEvent(HttpInstance->CloseToken.CompletionToken.Event);
-    HttpInstance->CloseToken.CompletionToken.Event = NULL;
-  }  
+    if (NULL != HttpInstance->Tcp6CloseToken.CompletionToken.Event) {
+      gBS->CloseEvent(HttpInstance->Tcp6CloseToken.CompletionToken.Event);
+      HttpInstance->Tcp6CloseToken.CompletionToken.Event = NULL;
+    }
+
+  } else {
+    if (NULL != HttpInstance->Tcp4ConnToken.CompletionToken.Event) {
+      gBS->CloseEvent (HttpInstance->Tcp4ConnToken.CompletionToken.Event);
+      HttpInstance->Tcp4ConnToken.CompletionToken.Event = NULL;
+    }
+
+    if (NULL != HttpInstance->Tcp4CloseToken.CompletionToken.Event) {
+      gBS->CloseEvent(HttpInstance->Tcp4CloseToken.CompletionToken.Event);
+      HttpInstance->Tcp4CloseToken.CompletionToken.Event = NULL;
+    }
+  }
+  
 }
 
 /**
-  Create event for the TCP4 transmit token.
+  Create event for the TCP transmit token.
 
   @param[in]  Wrap               Point to HTTP token's wrap data.
 
@@ -302,7 +387,7 @@ HttpCloseTcp4ConnCloseEvent (
 
 **/
 EFI_STATUS
-HttpCreateTcp4TxEvent (
+HttpCreateTcpTxEvent (
   IN  HTTP_TOKEN_WRAP      *Wrap
   )
 {
@@ -313,28 +398,50 @@ HttpCreateTcp4TxEvent (
   HttpInstance = Wrap->HttpInstance;
   TcpWrap      = &Wrap->TcpWrap;
 
-  Status = gBS->CreateEvent (
-                  EVT_NOTIFY_SIGNAL,
-                  TPL_NOTIFY,
-                  HttpTcpTransmitNotify,
-                  Wrap,
-                  &TcpWrap->TxToken.CompletionToken.Event
-                  );
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpTcpTransmitNotify,
+                    Wrap,
+                    &TcpWrap->Tx4Token.CompletionToken.Event
+                    );
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+    
+      TcpWrap->Tx4Data.Push = TRUE;
+      TcpWrap->Tx4Data.Urgent = FALSE;
+      TcpWrap->Tx4Data.FragmentCount = 1;
+      TcpWrap->Tx4Token.Packet.TxData = &Wrap->TcpWrap.Tx4Data;
+      TcpWrap->Tx4Token.CompletionToken.Status = EFI_NOT_READY;
 
-  TcpWrap->TxData.Push = TRUE;
-  TcpWrap->TxData.Urgent = FALSE;
-  TcpWrap->TxData.FragmentCount = 1;
-  TcpWrap->TxToken.Packet.TxData = &Wrap->TcpWrap.TxData;
-  TcpWrap->TxToken.CompletionToken.Status = EFI_NOT_READY;
+  } else {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpTcpTransmitNotify,
+                    Wrap,
+                    &TcpWrap->Tx6Token.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
 
+    TcpWrap->Tx6Data.Push   = TRUE;
+    TcpWrap->Tx6Data.Urgent = FALSE;
+    TcpWrap->Tx6Data.FragmentCount  = 1;
+    TcpWrap->Tx6Token.Packet.TxData = &Wrap->TcpWrap.Tx6Data;
+    TcpWrap->Tx6Token.CompletionToken.Status =EFI_NOT_READY;
+    
+    
+  }
+  
   return EFI_SUCCESS;
 }
 
 /**
-  Create event for the TCP4 receive token which is used to receive HTTP header.
+  Create event for the TCP receive token which is used to receive HTTP header.
 
   @param[in]  HttpInstance       Pointer to HTTP_PROTOCOL structure.
 
@@ -343,33 +450,52 @@ HttpCreateTcp4TxEvent (
 
 **/
 EFI_STATUS
-HttpCreateTcp4RxEventForHeader (
+HttpCreateTcpRxEventForHeader (
   IN  HTTP_PROTOCOL        *HttpInstance
   )
 {
   EFI_STATUS               Status;
 
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpCommonNotify,
+                    &HttpInstance->IsRxDone,
+                    &HttpInstance->Rx4Token.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    HttpInstance->Rx4Data.FragmentCount = 1;
+    HttpInstance->Rx4Token.Packet.RxData = &HttpInstance->Rx4Data;
+    HttpInstance->Rx4Token.CompletionToken.Status = EFI_NOT_READY;
 
-  Status = gBS->CreateEvent (
-                  EVT_NOTIFY_SIGNAL,
-                  TPL_NOTIFY,
-                  HttpCommonNotify,
-                  &HttpInstance->IsRxDone,
-                  &HttpInstance->RxToken.CompletionToken.Event
-                  );
-  if (EFI_ERROR (Status)) {
-    return Status;
+  } else {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpCommonNotify,
+                    &HttpInstance->IsRxDone,
+                    &HttpInstance->Rx6Token.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+
+    HttpInstance->Rx6Data.FragmentCount  =1;
+    HttpInstance->Rx6Token.Packet.RxData = &HttpInstance->Rx6Data;
+    HttpInstance->Rx6Token.CompletionToken.Status = EFI_NOT_READY;
+    
   }
 
-  HttpInstance->RxData.FragmentCount = 1;
-  HttpInstance->RxToken.Packet.RxData = &HttpInstance->RxData;
-  HttpInstance->RxToken.CompletionToken.Status = EFI_NOT_READY;
 
   return EFI_SUCCESS;
 }
 
 /**
-  Create event for the TCP4 receive token which is used to receive HTTP body.
+  Create event for the TCP receive token which is used to receive HTTP body.
 
   @param[in]  Wrap               Point to HTTP token's wrap data.
 
@@ -378,7 +504,7 @@ HttpCreateTcp4RxEventForHeader (
 
 **/
 EFI_STATUS
-HttpCreateTcp4RxEvent (
+HttpCreateTcpRxEvent (
   IN  HTTP_TOKEN_WRAP      *Wrap 
   )
 {
@@ -388,30 +514,91 @@ HttpCreateTcp4RxEvent (
 
   HttpInstance = Wrap->HttpInstance;
   TcpWrap      = &Wrap->TcpWrap;
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpTcpReceiveNotify,
+                    Wrap,
+                    &TcpWrap->Rx4Token.CompletionToken.Event
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    
+    TcpWrap->Rx4Data.FragmentCount = 1;
+    TcpWrap->Rx4Token.Packet.RxData = &Wrap->TcpWrap.Rx4Data;
+    TcpWrap->Rx4Token.CompletionToken.Status = EFI_NOT_READY;
 
-  Status = gBS->CreateEvent (
-                  EVT_NOTIFY_SIGNAL,
-                  TPL_NOTIFY,
-                  HttpTcpReceiveNotify,
-                  Wrap,
-                  &TcpWrap->RxToken.CompletionToken.Event
-                  );
-  if (EFI_ERROR (Status)) {
-    return Status;
+  } else {
+    Status = gBS->CreateEvent (
+                    EVT_NOTIFY_SIGNAL,
+                    TPL_NOTIFY,
+                    HttpTcpReceiveNotify,
+                    Wrap,
+                    &TcpWrap->Rx6Token.CompletionToken.Event
+                    );  
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+
+    TcpWrap->Rx6Data.FragmentCount = 1;
+    TcpWrap->Rx6Token.Packet.RxData = &Wrap->TcpWrap.Rx6Data;
+    TcpWrap->Rx6Token.CompletionToken.Status = EFI_NOT_READY;
   }
+  
+  return EFI_SUCCESS;
+}
 
-  TcpWrap->RxData.FragmentCount = 1;
-  TcpWrap->RxToken.Packet.RxData = &Wrap->TcpWrap.RxData;
-  TcpWrap->RxToken.CompletionToken.Status = EFI_NOT_READY;
+/**
+  Close Events for Tcp Receive Tokens for HTTP body and HTTP header.
 
-  return EFI_SUCCESS;
+  @param[in]  Wrap               Pointer to HTTP token's wrap data.
+  
+**/
+VOID
+HttpCloseTcpRxEvent (
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  )
+{
+  HTTP_PROTOCOL            *HttpInstance;
+  EFI_TCP4_IO_TOKEN        *Rx4Token;
+  EFI_TCP6_IO_TOKEN        *Rx6Token;
+
+  HttpInstance   = Wrap->HttpInstance;
+  Rx4Token       = NULL;
+  Rx6Token       = NULL;
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    if (Wrap != NULL) {
+      if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+        gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
+      } 
+    }
+
+    if (HttpInstance->Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (HttpInstance->Rx6Token.CompletionToken.Event);
+      HttpInstance->Rx6Token.CompletionToken.Event = NULL;
+    }
+  } else {
+    if (Wrap != NULL) {
+      if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+        gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
+      }
+    }
+    
+    if (HttpInstance->Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (HttpInstance->Rx4Token.CompletionToken.Event);
+      HttpInstance->Rx4Token.CompletionToken.Event = NULL;
+    }
+  }
 }
 
 /**
   Intiialize the HTTP_PROTOCOL structure to the unconfigured state.
 
-  @param[in]       HttpSb               The HTTP service private instance.
   @param[in, out]  HttpInstance         Pointer to HTTP_PROTOCOL structure.
+  @param[in]       IpVersion            Indicate us TCP4 protocol or TCP6 protocol.
 
   @retval EFI_SUCCESS       HTTP_PROTOCOL structure is initialized successfully.                                          
   @retval Others            Other error as indicated.
@@ -419,95 +606,198 @@ HttpCreateTcp4RxEvent (
 **/
 EFI_STATUS
 HttpInitProtocol (
-  IN     HTTP_SERVICE            *HttpSb,
-  IN OUT HTTP_PROTOCOL           *HttpInstance
+  IN OUT HTTP_PROTOCOL           *HttpInstance,
+  IN     BOOLEAN                 IpVersion
   )
 {
   EFI_STATUS                     Status;
   VOID                           *Interface;
+  BOOLEAN                        UsingIpv6;
+  
+  ASSERT (HttpInstance != NULL);
+  UsingIpv6 = IpVersion;
+  
+  if (!UsingIpv6) {
+    //
+    // Create TCP4 child.
+    //
+    Status = NetLibCreateServiceChild (
+               HttpInstance->Service->ControllerHandle,
+               HttpInstance->Service->ImageHandle,
+               &gEfiTcp4ServiceBindingProtocolGuid,
+               &HttpInstance->Tcp4ChildHandle
+               );
 
-  ASSERT ((HttpSb != NULL) && (HttpInstance != NULL));
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
 
-  HttpInstance->Signature = HTTP_PROTOCOL_SIGNATURE;
-  CopyMem (&HttpInstance->Http, &mEfiHttpTemplate, sizeof (HttpInstance->Http));
-  HttpInstance->Service = HttpSb;
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Tcp4ChildHandle,
+                    &gEfiTcp4ProtocolGuid,
+                    (VOID **) &Interface,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Service->ControllerHandle,
+                    EFI_OPEN_PROTOCOL_BY_DRIVER
+                    );
+                    
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
 
-  //
-  // Create TCP child.
-  //
-  Status = NetLibCreateServiceChild (
-             HttpInstance->Service->ControllerHandle,
-             HttpInstance->Service->ImageHandle,
-             &gEfiTcp4ServiceBindingProtocolGuid,
-             &HttpInstance->TcpChildHandle
-             );
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Tcp4ChildHandle,
+                    &gEfiTcp4ProtocolGuid,
+                    (VOID **) &HttpInstance->Tcp4,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Handle,
+                    EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                    );
+    if (EFI_ERROR(Status)) {
+      goto ON_ERROR;
+    }
 
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Service->Tcp4ChildHandle,
+                    &gEfiTcp4ProtocolGuid,
+                    (VOID **) &Interface,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Handle,
+                    EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                    );
+    if (EFI_ERROR(Status)) {
+      goto ON_ERROR;
+    }
+  } else {
+    //
+    // Create TCP6 Child.
+    //
+    Status = NetLibCreateServiceChild (
+               HttpInstance->Service->ControllerHandle,
+               HttpInstance->Service->ImageHandle,
+               &gEfiTcp6ServiceBindingProtocolGuid,
+               &HttpInstance->Tcp6ChildHandle
+               );
 
-  Status = gBS->OpenProtocol (
-                  HttpInstance->TcpChildHandle,
-                  &gEfiTcp4ProtocolGuid,
-                  (VOID **) &Interface,
-                  HttpInstance->Service->ImageHandle,
-                  HttpInstance->Service->ControllerHandle,
-                  EFI_OPEN_PROTOCOL_BY_DRIVER
-                  );
-                  
-  if (EFI_ERROR (Status)) {
-    goto ON_ERROR;
-  }
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
 
-  Status = gBS->OpenProtocol (
-                  HttpInstance->TcpChildHandle,
-                  &gEfiTcp4ProtocolGuid,
-                  (VOID **) &HttpInstance->Tcp4,
-                  HttpInstance->Service->ImageHandle,
-                  HttpInstance->Handle,
-                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
-                  );
-  if (EFI_ERROR(Status)) {
-    goto ON_ERROR;
-  }
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Tcp6ChildHandle,
+                    &gEfiTcp6ProtocolGuid,
+                    (VOID **) &Interface,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Service->ControllerHandle,
+                    EFI_OPEN_PROTOCOL_BY_DRIVER
+                    );
+    
+    if (EFI_ERROR (Status)) {
+      goto ON_ERROR;
+    }
+
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Tcp6ChildHandle,
+                    &gEfiTcp6ProtocolGuid,
+                    (VOID **) &HttpInstance->Tcp6,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Handle,
+                    EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                    );
+    
+    if (EFI_ERROR(Status)) {
+      goto ON_ERROR;
+    }      
+
+    Status = gBS->OpenProtocol (
+                    HttpInstance->Service->Tcp6ChildHandle,
+                    &gEfiTcp6ProtocolGuid,
+                    (VOID **) &Interface,
+                    HttpInstance->Service->ImageHandle,
+                    HttpInstance->Handle,
+                    EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                    );
 
+    if (EFI_ERROR(Status)) {
+      goto ON_ERROR;
+    }
+  }
+  
   HttpInstance->Url = AllocateZeroPool (HTTP_URL_BUFFER_LEN);
   if (HttpInstance->Url == NULL) {
     Status = EFI_OUT_OF_RESOURCES;
     goto ON_ERROR;
   }
 
-  NetMapInit (&HttpInstance->TxTokens);
-  NetMapInit (&HttpInstance->RxTokens);
-
   return EFI_SUCCESS;
 
 ON_ERROR:
   
-  if (HttpInstance->TcpChildHandle != NULL) {
+  if (HttpInstance->Tcp4ChildHandle != NULL) {
     gBS->CloseProtocol (
-           HttpInstance->TcpChildHandle,
+           HttpInstance->Tcp4ChildHandle,
            &gEfiTcp4ProtocolGuid,
            HttpInstance->Service->ImageHandle,
            HttpInstance->Service->ControllerHandle
            );
 
     gBS->CloseProtocol (
-           HttpInstance->TcpChildHandle,
+           HttpInstance->Tcp4ChildHandle,
            &gEfiTcp4ProtocolGuid,
            HttpInstance->Service->ImageHandle,
            HttpInstance->Handle
-           );
+           );    
     
     NetLibDestroyServiceChild (
       HttpInstance->Service->ControllerHandle,
       HttpInstance->Service->ImageHandle,
       &gEfiTcp4ServiceBindingProtocolGuid,
-      HttpInstance->TcpChildHandle
+      HttpInstance->Tcp4ChildHandle
       );
   }
+  
+  if (HttpInstance->Service->Tcp4ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Service->Tcp4ChildHandle,
+           &gEfiTcp4ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+  }
+  
+  if (HttpInstance->Tcp6ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Service->ControllerHandle
+           );
 
-  return Status;
+    gBS->CloseProtocol (
+           HttpInstance->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+    
+    NetLibDestroyServiceChild (
+      HttpInstance->Service->ControllerHandle,
+      HttpInstance->Service->ImageHandle,
+      &gEfiTcp6ServiceBindingProtocolGuid,
+      HttpInstance->Tcp6ChildHandle
+      );
+  }
+  
+  if (HttpInstance->Service->Tcp6ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Service->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+  }
+
+  return EFI_UNSUPPORTED;
   
 }
 
@@ -524,7 +814,7 @@ HttpCleanProtocol (
 {
   HttpCloseConnection (HttpInstance);
   
-  HttpCloseTcp4ConnCloseEvent (HttpInstance);
+  HttpCloseTcpConnCloseEvent (HttpInstance);
 
   if (HttpInstance->CacheBody != NULL) {
     FreePool (HttpInstance->CacheBody);
@@ -541,25 +831,25 @@ HttpCleanProtocol (
     HttpFreeMsgParser (HttpInstance->MsgParser);
     HttpInstance->MsgParser = NULL;
   }
-
+  
   if (HttpInstance->Url != NULL) {
     FreePool (HttpInstance->Url);
     HttpInstance->Url = NULL;
   }
-
+  
   NetMapClean (&HttpInstance->TxTokens);
   NetMapClean (&HttpInstance->RxTokens);
 
-  if (HttpInstance->TcpChildHandle != NULL) {
+  if (HttpInstance->Tcp4ChildHandle != NULL) {
     gBS->CloseProtocol (
-           HttpInstance->TcpChildHandle,
+           HttpInstance->Tcp4ChildHandle,
            &gEfiTcp4ProtocolGuid,
            HttpInstance->Service->ImageHandle,
            HttpInstance->Service->ControllerHandle
            );
 
     gBS->CloseProtocol (
-           HttpInstance->TcpChildHandle,
+           HttpInstance->Tcp4ChildHandle,
            &gEfiTcp4ProtocolGuid,
            HttpInstance->Service->ImageHandle,
            HttpInstance->Handle
@@ -569,9 +859,51 @@ HttpCleanProtocol (
       HttpInstance->Service->ControllerHandle,
       HttpInstance->Service->ImageHandle,
       &gEfiTcp4ServiceBindingProtocolGuid,
-      HttpInstance->TcpChildHandle
+      HttpInstance->Tcp4ChildHandle
+      );
+  }
+
+  if (HttpInstance->Service->Tcp4ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Service->Tcp4ChildHandle,
+           &gEfiTcp4ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+  }  
+
+  if (HttpInstance->Tcp6ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Service->ControllerHandle
+           );
+
+    gBS->CloseProtocol (
+           HttpInstance->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+    
+    NetLibDestroyServiceChild (
+      HttpInstance->Service->ControllerHandle,
+      HttpInstance->Service->ImageHandle,
+      &gEfiTcp6ServiceBindingProtocolGuid,
+      HttpInstance->Tcp6ChildHandle
       );
   }
+  
+  if (HttpInstance->Service->Tcp6ChildHandle != NULL) {
+    gBS->CloseProtocol (
+           HttpInstance->Service->Tcp6ChildHandle,
+           &gEfiTcp6ProtocolGuid,
+           HttpInstance->Service->ImageHandle,
+           HttpInstance->Handle
+           );
+  }
+  
 }
 
 /**
@@ -590,27 +922,40 @@ HttpCreateConnection (
 {
   EFI_STATUS                    Status;
 
-  //
-  // Create events for variuos asynchronous operations.
-  //
-  HttpInstance->IsConnDone = FALSE;
-
   //
   // Connect to Http server
   //
-  HttpInstance->ConnToken.CompletionToken.Status = EFI_NOT_READY;
-  Status = HttpInstance->Tcp4->Connect (HttpInstance->Tcp4, &HttpInstance->ConnToken);
-  if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_ERROR, "HttpCreateConnection: Tcp4->Connect() = %r\n", Status));
-    return Status;
-  }
-
-  while (!HttpInstance->IsConnDone) {
-    HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
-  }
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    HttpInstance->IsTcp4ConnDone = FALSE;
+    HttpInstance->Tcp4ConnToken.CompletionToken.Status = EFI_NOT_READY;
+    Status = HttpInstance->Tcp4->Connect (HttpInstance->Tcp4, &HttpInstance->Tcp4ConnToken);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "HttpCreateConnection: Tcp4->Connect() = %r\n", Status));
+      return Status;
+    }
+    
+    while (!HttpInstance->IsTcp4ConnDone) {
+      HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+    }
+    
+    Status = HttpInstance->Tcp4ConnToken.CompletionToken.Status;
+    
+  } else {
+    HttpInstance->IsTcp6ConnDone = FALSE;
+    HttpInstance->Tcp6ConnToken.CompletionToken.Status = EFI_NOT_READY;
+    Status = HttpInstance->Tcp6->Connect (HttpInstance->Tcp6, &HttpInstance->Tcp6ConnToken);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "HttpCreateConnection: Tcp6->Connect() = %r\n", Status));
+      return Status;
+    }
 
-  Status = HttpInstance->ConnToken.CompletionToken.Status;
+    while(!HttpInstance->IsTcp6ConnDone) {
+      HttpInstance->Tcp6->Poll (HttpInstance->Tcp6);
+    }
 
+    Status = HttpInstance->Tcp6ConnToken.CompletionToken.Status;   
+  }
+  
   if (!EFI_ERROR (Status)) {
     HttpInstance->State = HTTP_STATE_TCP_CONNECTED;
   }
@@ -635,17 +980,32 @@ HttpCloseConnection (
   EFI_STATUS                Status;
 
   if (HttpInstance->State == HTTP_STATE_TCP_CONNECTED) {
-    HttpInstance->CloseToken.AbortOnClose = TRUE;
-    HttpInstance->IsCloseDone             = FALSE;
-    
-    Status = HttpInstance->Tcp4->Close (HttpInstance->Tcp4, &HttpInstance->CloseToken);
-    if (EFI_ERROR (Status)) {
-      return Status;
-    }
 
-    while (!HttpInstance->IsCloseDone) {
-      HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+    if (HttpInstance->LocalAddressIsIPv6) {
+      HttpInstance->Tcp6CloseToken.AbortOnClose = TRUE;
+      HttpInstance->IsTcp6CloseDone             = FALSE;
+      Status = HttpInstance->Tcp6->Close (HttpInstance->Tcp6, &HttpInstance->Tcp6CloseToken);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+
+      while (!HttpInstance->IsTcp6CloseDone) {
+        HttpInstance->Tcp6->Poll (HttpInstance->Tcp6);
+      }
+      
+    } else {
+      HttpInstance->Tcp4CloseToken.AbortOnClose = TRUE;
+      HttpInstance->IsTcp4CloseDone             = FALSE;
+      Status = HttpInstance->Tcp4->Close (HttpInstance->Tcp4, &HttpInstance->Tcp4CloseToken);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+
+      while (!HttpInstance->IsTcp4CloseDone) {
+        HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
+      }
     }
+
   }
 
   HttpInstance->State = HTTP_STATE_TCP_CLOSED;
@@ -716,12 +1076,82 @@ HttpConfigureTcp4 (
     return Status;
   }
 
-  Status = HttpCreateTcp4ConnCloseEvent (HttpInstance);
+  Status = HttpCreateTcpConnCloseEvent (HttpInstance);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  Status = HttpCreateTcpTxEvent (Wrap);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  HttpInstance->State = HTTP_STATE_TCP_CONFIGED;
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Configure TCP6 protocol child.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+  @param[in]  Wrap               The HTTP token's wrap data.
+
+  @retval EFI_SUCCESS            The TCP6 protocol child is configured.
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpConfigureTcp6 (
+  IN  HTTP_PROTOCOL        *HttpInstance,
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  )
+{
+  EFI_STATUS               Status;
+  EFI_TCP6_CONFIG_DATA     *Tcp6CfgData;
+  EFI_TCP6_ACCESS_POINT    *Tcp6Ap;
+  EFI_TCP6_OPTION          *Tcp6Option;
+  
+  ASSERT (HttpInstance != NULL);
+  
+  Tcp6CfgData = &HttpInstance->Tcp6CfgData;
+  ZeroMem (Tcp6CfgData, sizeof (EFI_TCP6_CONFIG_DATA));
+
+  Tcp6CfgData->TrafficClass  = 0;
+  Tcp6CfgData->HopLimit      = 255;
+  Tcp6CfgData->ControlOption = &HttpInstance->Tcp6Option;
+  
+  Tcp6Ap  = &Tcp6CfgData->AccessPoint;
+  Tcp6Ap->ActiveFlag  = TRUE;
+  Tcp6Ap->StationPort = HttpInstance->Ipv6Node.LocalPort;
+  Tcp6Ap->RemotePort  = HttpInstance->RemotePort;
+  IP6_COPY_ADDRESS (&Tcp6Ap->StationAddress, &HttpInstance->Ipv6Node.LocalAddress);
+  IP6_COPY_ADDRESS (&Tcp6Ap->RemoteAddress , &HttpInstance->RemoteIpv6Addr);
+
+  Tcp6Option = Tcp6CfgData->ControlOption;
+  Tcp6Option->ReceiveBufferSize  = HTTP_BUFFER_SIZE_DEAULT;
+  Tcp6Option->SendBufferSize     = HTTP_BUFFER_SIZE_DEAULT;
+  Tcp6Option->MaxSynBackLog      = HTTP_MAX_SYN_BACK_LOG;
+  Tcp6Option->ConnectionTimeout  = HTTP_CONNECTION_TIMEOUT;
+  Tcp6Option->DataRetries        = HTTP_DATA_RETRIES;
+  Tcp6Option->FinTimeout         = HTTP_FIN_TIMEOUT;
+  Tcp6Option->KeepAliveProbes    = HTTP_KEEP_ALIVE_PROBES;
+  Tcp6Option->KeepAliveTime      = HTTP_KEEP_ALIVE_TIME;
+  Tcp6Option->KeepAliveInterval  = HTTP_KEEP_ALIVE_INTERVAL;
+  Tcp6Option->EnableNagle        = TRUE;
+
+  Status = HttpInstance->Tcp6->Configure (HttpInstance->Tcp6, Tcp6CfgData);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "HttpConfigureTcp6 - %r\n", Status));
+    return Status;
+  }
+  
+  Status = HttpCreateTcpConnCloseEvent (HttpInstance);
   if (EFI_ERROR (Status)) {
     return Status;
   }
 
-  Status = HttpCreateTcp4TxEvent (Wrap);
+  Status = HttpCreateTcpTxEvent (Wrap);
   if (EFI_ERROR (Status)) {
     return Status;
   }
@@ -729,10 +1159,11 @@ HttpConfigureTcp4 (
   HttpInstance->State = HTTP_STATE_TCP_CONFIGED;
 
   return EFI_SUCCESS;
+ 
 }
 
 /**
-  Check existing TCP connection, if in error state, receover TCP4 connection.
+  Check existing TCP connection, if in error state, recover TCP4 connection.
 
   @param[in]  HttpInstance       The HTTP instance private data.
 
@@ -775,7 +1206,105 @@ HttpConnectTcp4 (
 }
 
 /**
-  Send the HTTP message through TCP4.
+  Check existing TCP connection, if in error state, recover TCP6 connection.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+
+  @retval EFI_SUCCESS            The TCP connection is established.
+  @retval EFI_NOT_READY          TCP6 protocol child is not created or configured.
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpConnectTcp6 (
+  IN  HTTP_PROTOCOL        *HttpInstance
+  )
+{
+  EFI_STATUS                Status;
+  EFI_TCP6_CONNECTION_STATE Tcp6State;
+
+  if (HttpInstance->State != HTTP_STATE_TCP_CONFIGED || HttpInstance->Tcp6 == NULL) {
+    return EFI_NOT_READY;
+  }
+
+  Status = HttpInstance->Tcp6->GetModeData (
+                                 HttpInstance->Tcp6,
+                                 &Tcp6State,
+                                 NULL,
+                                 NULL,
+                                 NULL,
+                                 NULL
+                                 );
+  
+  if (EFI_ERROR(Status)){
+     DEBUG ((EFI_D_ERROR, "Tcp6 GetModeData fail - %x\n", Status));
+     return Status;
+  }
+
+  if (Tcp6State > Tcp6StateEstablished) {
+    HttpCloseConnection (HttpInstance);
+  }
+
+  return HttpCreateConnection (HttpInstance);
+}
+
+/**
+  Initialize TCP related data.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+  @param[in]  Wrap               The HTTP token's wrap data.
+
+  @retval EFI_SUCCESS            The initialization of TCP instance is done. 
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpInitTcp (
+  IN  HTTP_PROTOCOL    *HttpInstance,
+  IN  HTTP_TOKEN_WRAP  *Wrap
+  )
+{
+  EFI_STATUS           Status;
+  ASSERT (HttpInstance != NULL);
+
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    //
+    // Configure TCP instance.
+    //
+    Status = HttpConfigureTcp4 (HttpInstance, Wrap);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    //
+    // Connect TCP.
+    //
+    Status = HttpConnectTcp4 (HttpInstance);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  } else {
+    //
+    // Configure TCP instance.
+    //
+    Status = HttpConfigureTcp6 (HttpInstance, Wrap);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    //
+    // Connect TCP.
+    //
+    Status = HttpConnectTcp6 (HttpInstance);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
+  
+  return EFI_SUCCESS;
+  
+}
+
+/**
+  Send the HTTP message through TCP4 or TCP6.
 
   @param[in]  HttpInstance       The HTTP instance private data.
   @param[in]  Wrap               The HTTP token's wrap data.
@@ -787,7 +1316,7 @@ HttpConnectTcp4 (
 
 **/
 EFI_STATUS
-HttpTransmitTcp4 (
+HttpTransmitTcp (
   IN  HTTP_PROTOCOL    *HttpInstance,
   IN  HTTP_TOKEN_WRAP  *Wrap,
   IN  UINT8            *TxString,
@@ -795,23 +1324,44 @@ HttpTransmitTcp4 (
   )
 {
   EFI_STATUS                    Status;
-  EFI_TCP4_IO_TOKEN             *TxToken;
+  EFI_TCP4_IO_TOKEN             *Tx4Token;
   EFI_TCP4_PROTOCOL             *Tcp4;
+  EFI_TCP6_IO_TOKEN             *Tx6Token;
+  EFI_TCP6_PROTOCOL             *Tcp6;
   
-  Tcp4 = HttpInstance->Tcp4;
-  TxToken = &Wrap->TcpWrap.TxToken;
+  if (!HttpInstance->LocalAddressIsIPv6) {     
+    Tcp4 = HttpInstance->Tcp4;
+    Tx4Token = &Wrap->TcpWrap.Tx4Token;
+    
+    Tx4Token->Packet.TxData->DataLength = (UINT32) TxStringLen;
+    Tx4Token->Packet.TxData->FragmentTable[0].FragmentLength = (UINT32) TxStringLen;
+    Tx4Token->Packet.TxData->FragmentTable[0].FragmentBuffer = (VOID *) TxString;
+    Tx4Token->CompletionToken.Status = EFI_NOT_READY;  
+    
+    Wrap->TcpWrap.IsTxDone = FALSE;
+    Status  = Tcp4->Transmit (Tcp4, Tx4Token);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "Transmit failed: %r\n", Status));
+      return Status;
+    }
 
-  TxToken->Packet.TxData->DataLength = (UINT32) TxStringLen;
-  TxToken->Packet.TxData->FragmentTable[0].FragmentLength = (UINT32) TxStringLen;
-  TxToken->Packet.TxData->FragmentTable[0].FragmentBuffer = (VOID *) TxString;
-  TxToken->CompletionToken.Status = EFI_NOT_READY;  
+  } else {
+    Tcp6 = HttpInstance->Tcp6;
+    Tx6Token = &Wrap->TcpWrap.Tx6Token;
 
-  Wrap->TcpWrap.IsTxDone = FALSE;
-  Status  = Tcp4->Transmit (Tcp4, TxToken);
-  if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_ERROR, "Transmit failed: %r\n", Status));
-    return Status;
+    Tx6Token->Packet.TxData->DataLength = (UINT32) TxStringLen;
+    Tx6Token->Packet.TxData->FragmentTable[0].FragmentLength = (UINT32) TxStringLen;
+    Tx6Token->Packet.TxData->FragmentTable[0].FragmentBuffer = (VOID *) TxString;
+    Tx6Token->CompletionToken.Status = EFI_NOT_READY;
+
+    Wrap->TcpWrap.IsTxDone = FALSE;
+    Status = Tcp6->Transmit (Tcp6, Tx6Token);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "Transmit failed: %r\n", Status));
+      return Status;
+    }
   }
+  
 
   return Status;
 }
@@ -919,7 +1469,7 @@ HttpMappingToStatusCode (
 
 /**
   Check whether the user's token or event has already
-  been enqueue on HTTP TxToken or RxToken list.
+  been enqueue on HTTP Tx or Rx Token list.
 
   @param[in]  Map                The container of either user's transmit or receive
                                  token.
@@ -953,9 +1503,9 @@ HttpTokenExist (
 }
 
 /**
-  Check whether the HTTP message associated with TxToken is already sent out.
+  Check whether the HTTP message associated with Tx4Token or Tx6Token is already sent out.
 
-  @param[in]  Map                The container of TxToken.
+  @param[in]  Map                The container of Tx4Token or Tx6Token.
   @param[in]  Item               Current item to check against.
   @param[in]  Context            The Token to check againist.
 
@@ -985,7 +1535,7 @@ HttpTcpNotReady (
 /**
   Transmit the HTTP mssage by processing the associated HTTP token.
 
-  @param[in]  Map                The container of TxToken.
+  @param[in]  Map                The container of Tx4Token or Tx6Token.
   @param[in]  Item               Current item to check against.
   @param[in]  Context            The Token to check againist.
 
@@ -1038,7 +1588,7 @@ HttpTcpTransmit (
   //
   // Transmit the request message.
   //
-  Status = HttpTransmitTcp4 (
+  Status = HttpTransmitTcp (
              ValueInItem->HttpInstance,
              ValueInItem,
              (UINT8*) RequestStr,
@@ -1051,7 +1601,7 @@ HttpTcpTransmit (
 /**
   Receive the HTTP response by processing the associated HTTP token.
 
-  @param[in]  Map                The container of RxToken.
+  @param[in]  Map                The container of Rx4Token or Rx6Token.
   @param[in]  Item               Current item to check against.
   @param[in]  Context            The Token to check againist.
 
@@ -1074,6 +1624,319 @@ HttpTcpReceive (
   return HttpResponseWorker ((HTTP_TOKEN_WRAP *) Item->Value);
 }
 
+/**
+  Receive the HTTP header by processing the associated HTTP token.
+
+  @param[in]       HttpInstance     The HTTP instance private data.
+  @param[in, out]  SizeofHeaders    The HTTP header length.
+  @param[in, out]  BufferSize       The size of buffer to cacahe the header message.
+  
+  @retval EFI_SUCCESS               The HTTP header is received.                          
+  @retval Others                    Other errors as indicated.
+
+**/
+EFI_STATUS
+HttpTcpReceiveHeader (
+  IN  HTTP_PROTOCOL         *HttpInstance,
+  IN  OUT UINTN             *SizeofHeaders,
+  IN  OUT UINTN             *BufferSize
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_TCP4_IO_TOKEN             *Rx4Token;
+  EFI_TCP4_PROTOCOL             *Tcp4;
+  EFI_TCP6_IO_TOKEN             *Rx6Token;
+  EFI_TCP6_PROTOCOL             *Tcp6;
+  CHAR8                         **EndofHeader;
+  CHAR8                         **HttpHeaders;
+  CHAR8                         *Buffer;
+
+  ASSERT (HttpInstance != NULL);
+
+  EndofHeader = HttpInstance->EndofHeader;
+  HttpHeaders = HttpInstance->HttpHeaders;
+  Tcp4 = HttpInstance->Tcp4;
+  Tcp6 = HttpInstance->Tcp6;
+  Buffer      = NULL;
+  Rx4Token    = NULL;
+  Rx6Token    = NULL;
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    ASSERT (Tcp6 != NULL);
+  } else {
+    ASSERT (Tcp4 != NULL);
+  }
+
+  if (!HttpInstance->LocalAddressIsIPv6) {
+    Rx4Token = &HttpInstance->Rx4Token;
+    Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = AllocateZeroPool (DEF_BUF_LEN);
+    if (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer == NULL) {
+      Status = EFI_OUT_OF_RESOURCES;
+      return Status;
+    }
+  
+    //
+    // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
+    //
+    while (*EndofHeader == NULL) {   
+      HttpInstance->IsRxDone = FALSE;
+      Rx4Token->Packet.RxData->DataLength = DEF_BUF_LEN;
+      Rx4Token->Packet.RxData->FragmentTable[0].FragmentLength = DEF_BUF_LEN;
+      Status = Tcp4->Receive (Tcp4, Rx4Token);
+      if (EFI_ERROR (Status)) {
+        DEBUG ((EFI_D_ERROR, "Tcp4 receive failed: %r\n", Status));
+        return Status;
+      }
+      
+      while (!HttpInstance->IsRxDone) {
+       Tcp4->Poll (Tcp4);
+      }    
+  
+      Status = Rx4Token->CompletionToken.Status;
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+  
+      //
+      // Append the response string.
+      //
+      *BufferSize = (*SizeofHeaders) + Rx4Token->Packet.RxData->FragmentTable[0].FragmentLength;
+      Buffer      = AllocateZeroPool (*BufferSize);
+      if (Buffer == NULL) {
+        Status = EFI_OUT_OF_RESOURCES;
+        return Status;
+      }
+  
+      if (*HttpHeaders != NULL) {
+        CopyMem (Buffer, *HttpHeaders, (*SizeofHeaders));
+        FreePool (*HttpHeaders);
+      }
+  
+      CopyMem (
+        Buffer + (*SizeofHeaders),
+        Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer,
+        Rx4Token->Packet.RxData->FragmentTable[0].FragmentLength
+        );
+      *HttpHeaders    = Buffer;
+      *SizeofHeaders  = *BufferSize;
+  
+      //
+      // Check whether we received end of HTTP headers.
+      //
+      *EndofHeader = AsciiStrStr (*HttpHeaders, HTTP_END_OF_HDR_STR); 
+    }
+    FreePool (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+    Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+    
+  } else {
+    Rx6Token = &HttpInstance->Rx6Token;
+    Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = AllocateZeroPool (DEF_BUF_LEN);
+    if (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer == NULL) {
+      Status = EFI_OUT_OF_RESOURCES;
+      return Status;
+    }
+  
+    //
+    // Receive the HTTP headers only when EFI_HTTP_RESPONSE_DATA is not NULL.
+    //
+    while (*EndofHeader == NULL) {   
+      HttpInstance->IsRxDone = FALSE;
+      Rx6Token->Packet.RxData->DataLength = DEF_BUF_LEN;
+      Rx6Token->Packet.RxData->FragmentTable[0].FragmentLength = DEF_BUF_LEN;
+      Status = Tcp6->Receive (Tcp6, Rx6Token);
+      if (EFI_ERROR (Status)) {
+        DEBUG ((EFI_D_ERROR, "Tcp6 receive failed: %r\n", Status));
+        return Status;
+      }
+      
+      while (!HttpInstance->IsRxDone) {
+       Tcp6->Poll (Tcp6);
+      }    
+  
+      Status = Rx6Token->CompletionToken.Status;
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+  
+      //
+      // Append the response string.
+      //
+      *BufferSize = (*SizeofHeaders) + Rx6Token->Packet.RxData->FragmentTable[0].FragmentLength;
+      Buffer      = AllocateZeroPool (*BufferSize);
+      if (Buffer == NULL) {
+        Status = EFI_OUT_OF_RESOURCES;
+        return Status;
+      }
+  
+      if (*HttpHeaders != NULL) {
+        CopyMem (Buffer, *HttpHeaders, (*SizeofHeaders));
+        FreePool (*HttpHeaders);
+      }
+  
+      CopyMem (
+        Buffer + (*SizeofHeaders),
+        Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer,
+        Rx6Token->Packet.RxData->FragmentTable[0].FragmentLength
+        );
+      *HttpHeaders     = Buffer;
+      *SizeofHeaders  = *BufferSize;
+  
+      //
+      // Check whether we received end of HTTP headers.
+      //
+      *EndofHeader = AsciiStrStr (*HttpHeaders, HTTP_END_OF_HDR_STR);
+  
+    }
+    FreePool (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+    Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;    
+  }     
+
+  //
+  // Skip the CRLF after the HTTP headers.
+  //
+  *EndofHeader = *EndofHeader + AsciiStrLen (HTTP_END_OF_HDR_STR);  
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Receive the HTTP body by processing the associated HTTP token.
+
+  @param[in]  Wrap               The HTTP token's wrap data.
+  @param[in]  HttpMsg            The HTTP message data.
+
+  @retval EFI_SUCCESS            The HTTP body is received.                          
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpTcpReceiveBody (
+  IN  HTTP_TOKEN_WRAP       *Wrap,
+  IN  EFI_HTTP_MESSAGE      *HttpMsg
+  )
+{
+  EFI_STATUS                Status;
+  HTTP_PROTOCOL             *HttpInstance;
+  EFI_TCP6_PROTOCOL         *Tcp6;
+  EFI_TCP6_IO_TOKEN         *Rx6Token;
+  EFI_TCP4_PROTOCOL         *Tcp4;
+  EFI_TCP4_IO_TOKEN         *Rx4Token;
+  
+  HttpInstance   = Wrap->HttpInstance;
+  Tcp4 = HttpInstance->Tcp4;
+  Tcp6 = HttpInstance->Tcp6;
+  Rx4Token       = NULL;
+  Rx6Token       = NULL;
+
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    ASSERT (Tcp6 != NULL);
+  } else {
+    ASSERT (Tcp4 != NULL);
+  }
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    Rx6Token = &Wrap->TcpWrap.Rx6Token;
+    Rx6Token ->Packet.RxData->DataLength = (UINT32) HttpMsg->BodyLength;
+    Rx6Token ->Packet.RxData->FragmentTable[0].FragmentLength = (UINT32) HttpMsg->BodyLength;
+    Rx6Token ->Packet.RxData->FragmentTable[0].FragmentBuffer = (VOID *) HttpMsg->Body;
+    Rx6Token->CompletionToken.Status = EFI_NOT_READY;
+
+    Status = Tcp6->Receive (Tcp6, Rx6Token);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "Tcp6 receive failed: %r\n", Status));
+      return Status;
+    }
+      
+  } else {
+    Rx4Token = &Wrap->TcpWrap.Rx4Token;
+    Rx4Token->Packet.RxData->DataLength = (UINT32) HttpMsg->BodyLength;
+    Rx4Token->Packet.RxData->FragmentTable[0].FragmentLength = (UINT32) HttpMsg->BodyLength;
+    Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = (VOID *) HttpMsg->Body;
+    
+    Rx4Token->CompletionToken.Status = EFI_NOT_READY;
+    Status = Tcp4->Receive (Tcp4, Rx4Token);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "Tcp4 receive failed: %r\n", Status));
+      return Status;
+    }
+  }
+
+  return EFI_SUCCESS;
+
+}
+
+/**
+  Clean up Tcp Tokens while the Tcp transmission error occurs.
+
+  @param[in]  Wrap               Pointer to HTTP token's wrap data.
+  
+**/
+VOID
+HttpTcpTokenCleanup (
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  )
+{ 
+  HTTP_PROTOCOL            *HttpInstance;
+  EFI_TCP4_IO_TOKEN        *Rx4Token;
+  EFI_TCP6_IO_TOKEN        *Rx6Token;
+
+  HttpInstance   = Wrap->HttpInstance;
+  Rx4Token       = NULL;
+  Rx6Token       = NULL;
+  
+  if (HttpInstance->LocalAddressIsIPv6) {
+    if (Wrap != NULL) {
+      if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+        gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
+      }
+
+      Rx6Token = &Wrap->TcpWrap.Rx6Token;
+      if (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+        FreePool (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+        Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+      }
+      FreePool (Wrap); 
+    }
+
+    if (HttpInstance->Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (HttpInstance->Rx6Token.CompletionToken.Event);
+      HttpInstance->Rx6Token.CompletionToken.Event = NULL;
+    }
+
+    Rx6Token = &HttpInstance->Rx6Token;
+    if (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+      Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+    }
+    
+  } else {
+    if (Wrap != NULL) {
+      if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+        gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
+      }
+      Rx4Token = &Wrap->TcpWrap.Rx4Token;
+      if (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+        FreePool (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+        Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+      }
+      FreePool (Wrap);
+    }
+    
+    if (HttpInstance->Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (HttpInstance->Rx4Token.CompletionToken.Event);
+      HttpInstance->Rx4Token.CompletionToken.Event = NULL;
+    }
+    
+    Rx4Token = &HttpInstance->Rx4Token;
+    if (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+      Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+    }
+  }
+
+}
+
 /**
   Generate HTTP request string.
 
diff --git a/NetworkPkg/HttpDxe/HttpProto.h b/NetworkPkg/HttpDxe/HttpProto.h
index c37b80c8ec74..a15e0a87be53 100644
--- a/NetworkPkg/HttpDxe/HttpProto.h
+++ b/NetworkPkg/HttpDxe/HttpProto.h
@@ -27,6 +27,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   HTTP_SERVICE_SIGNATURE \
   )
 
+
 //
 // The state of HTTP protocol. It starts from UNCONFIGED.
 //
@@ -58,18 +59,23 @@ typedef struct _HTTP_SERVICE {
   EFI_SERVICE_BINDING_PROTOCOL  ServiceBinding;
   EFI_HANDLE                    ImageHandle;
   EFI_HANDLE                    ControllerHandle;
+  EFI_HANDLE                    Tcp4ChildHandle;
+  EFI_HANDLE                    Tcp6ChildHandle;
   LIST_ENTRY                    ChildrenList;
   UINTN                         ChildrenNumber;
-  EFI_HANDLE                    TcpChildHandle;
   INTN                          State;
 } HTTP_SERVICE;
 
 typedef struct {
-  EFI_TCP4_IO_TOKEN             TxToken;
-  EFI_TCP4_TRANSMIT_DATA        TxData;
+  EFI_TCP4_IO_TOKEN             Tx4Token;
+  EFI_TCP4_TRANSMIT_DATA        Tx4Data;
+  EFI_TCP6_IO_TOKEN             Tx6Token;
+  EFI_TCP6_TRANSMIT_DATA        Tx6Data;
+  EFI_TCP4_IO_TOKEN             Rx4Token;
+  EFI_TCP4_RECEIVE_DATA         Rx4Data;
+  EFI_TCP6_IO_TOKEN             Rx6Token;
+  EFI_TCP6_RECEIVE_DATA         Rx6Data;
   BOOLEAN                       IsTxDone;
-  EFI_TCP4_IO_TOKEN             RxToken;
-  EFI_TCP4_RECEIVE_DATA         RxData;
   BOOLEAN                       IsRxDone;
   UINTN                         BodyLen;
   EFI_HTTP_METHOD               Method;
@@ -84,26 +90,43 @@ typedef struct _HTTP_PROTOCOL {
   BOOLEAN                       InDestroy;
   INTN                          State;
 
-  EFI_HANDLE                    TcpChildHandle;
+  EFI_HANDLE                    Tcp4ChildHandle;
   EFI_TCP4_PROTOCOL             *Tcp4;
   EFI_TCP4_CONFIG_DATA          Tcp4CfgData;
   EFI_TCP4_OPTION               Tcp4Option;
 
-  EFI_TCP4_CONNECTION_TOKEN     ConnToken;
-  BOOLEAN                       IsConnDone;
-  EFI_TCP4_CLOSE_TOKEN          CloseToken;
-  BOOLEAN                       IsCloseDone;
-
+  EFI_TCP4_CONNECTION_TOKEN     Tcp4ConnToken;
+  BOOLEAN                       IsTcp4ConnDone;
+  EFI_TCP4_CLOSE_TOKEN          Tcp4CloseToken;
+  BOOLEAN                       IsTcp4CloseDone;
   CHAR8                         *RemoteHost;
   UINT16                        RemotePort;
   EFI_IPv4_ADDRESS              RemoteAddr;
+  
+  EFI_HANDLE                    Tcp6ChildHandle;
+  EFI_TCP6_PROTOCOL             *Tcp6;
+  EFI_TCP6_CONFIG_DATA          Tcp6CfgData;
+  EFI_TCP6_OPTION               Tcp6Option;
+  
+  EFI_TCP6_CONNECTION_TOKEN     Tcp6ConnToken;
+  BOOLEAN                       IsTcp6ConnDone;
+  EFI_TCP6_CLOSE_TOKEN          Tcp6CloseToken;
+  BOOLEAN                       IsTcp6CloseDone;
+  EFI_IPv6_ADDRESS              RemoteIpv6Addr;
+
+
+  
   //
-  // RxToken used for receiving HTTP header.
+  // Rx4Token or Rx6Token used for receiving HTTP header.
   //
-  EFI_TCP4_IO_TOKEN             RxToken;
-  EFI_TCP4_RECEIVE_DATA         RxData;
+  EFI_TCP4_IO_TOKEN             Rx4Token;
+  EFI_TCP4_RECEIVE_DATA         Rx4Data;
+  EFI_TCP6_IO_TOKEN             Rx6Token;
+  EFI_TCP6_RECEIVE_DATA         Rx6Data;
   BOOLEAN                       IsRxDone;
 
+  CHAR8                         **EndofHeader;
+  CHAR8                         **HttpHeaders;
   CHAR8                         *CacheBody;
   CHAR8                         *NextMsg;
   UINTN                         CacheLen;
@@ -119,6 +142,7 @@ typedef struct _HTTP_PROTOCOL {
   BOOLEAN                       LocalAddressIsIPv6;
 
   EFI_HTTPv4_ACCESS_POINT       IPv4Node;
+  EFI_HTTPv6_ACCESS_POINT       Ipv6Node;
 
   NET_MAP                       TxTokens;
   NET_MAP                       RxTokens;
@@ -158,7 +182,7 @@ HttpCommonNotify (
   );
 
 /**
-  Create events for the TCP4 connection token and TCP4 close token.
+  Create events for the TCP connection token and TCP close token.
 
   @param[in]  HttpInstance       Pointer to HTTP_PROTOCOL structure.
 
@@ -167,23 +191,23 @@ HttpCommonNotify (
 
 **/
 EFI_STATUS
-HttpCreateTcp4ConnCloseEvent (
+HttpCreateTcpConnCloseEvent (
   IN  HTTP_PROTOCOL        *HttpInstance
   );
 
 /**
-  Close events in the TCP4 connection token and TCP4 close token.
+  Close events in the TCP connection token and TCP close token.
 
   @param[in]  HttpInstance   Pointer to HTTP_PROTOCOL structure.
 
 **/
 VOID
-HttpCloseTcp4ConnCloseEvent (
+HttpCloseTcpConnCloseEvent (
   IN  HTTP_PROTOCOL        *HttpInstance
   );
 
 /**
-  Create event for the TCP4 transmit token.
+  Create event for the TCP transmit token.
 
   @param[in]  Wrap               Point to HTTP token's wrap data.
 
@@ -192,12 +216,12 @@ HttpCloseTcp4ConnCloseEvent (
 
 **/
 EFI_STATUS
-HttpCreateTcp4TxEvent (
+HttpCreateTcpTxEvent (
   IN  HTTP_TOKEN_WRAP      *Wrap
   );
 
 /**
-  Create event for the TCP4 receive token which is used to receive HTTP header.
+  Create event for the TCP receive token which is used to receive HTTP header.
 
   @param[in]  HttpInstance       Pointer to HTTP_PROTOCOL structure.
 
@@ -206,12 +230,12 @@ HttpCreateTcp4TxEvent (
 
 **/
 EFI_STATUS
-HttpCreateTcp4RxEventForHeader (
+HttpCreateTcpRxEventForHeader (
   IN  HTTP_PROTOCOL        *HttpInstance
   );
 
 /**
-  Create event for the TCP4 receive token which is used to receive HTTP body.
+  Create event for the TCP receive token which is used to receive HTTP body.
 
   @param[in]  Wrap               Point to HTTP token's wrap data.
 
@@ -220,15 +244,26 @@ HttpCreateTcp4RxEventForHeader (
 
 **/
 EFI_STATUS
-HttpCreateTcp4RxEvent (
+HttpCreateTcpRxEvent (
   IN  HTTP_TOKEN_WRAP      *Wrap 
   );
 
+/**
+  Close Events for Tcp Receive Tokens for HTTP body and HTTP header.
+
+  @param[in]  Wrap               Pointer to HTTP token's wrap data.
+  
+**/
+VOID
+HttpCloseTcpRxEvent (
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  );
+
 /**
   Intiialize the HTTP_PROTOCOL structure to the unconfigured state.
 
-  @param[in]       HttpSb               The HTTP service private instance.
   @param[in, out]  HttpInstance         Pointer to HTTP_PROTOCOL structure.
+  @param[in]       IpVersion            Indicate us TCP4 protocol or TCP6 protocol.
 
   @retval EFI_SUCCESS       HTTP_PROTOCOL structure is initialized successfully.                                          
   @retval Others            Other error as indicated.
@@ -236,8 +271,8 @@ HttpCreateTcp4RxEvent (
 **/
 EFI_STATUS
 HttpInitProtocol (
-  IN     HTTP_SERVICE            *HttpSb,
-  IN OUT HTTP_PROTOCOL           *HttpInstance
+  IN OUT HTTP_PROTOCOL           *HttpInstance,
+  IN     BOOLEAN                 IpVersion
   );
 
 /**
@@ -295,6 +330,22 @@ HttpConfigureTcp4 (
   IN  HTTP_TOKEN_WRAP      *Wrap
   );
 
+/**
+  Configure TCP6 protocol child.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+  @param[in]  Wrap               The HTTP token's wrap data.
+
+  @retval EFI_SUCCESS            The TCP6 protocol child is configured.
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpConfigureTcp6 (
+  IN  HTTP_PROTOCOL        *HttpInstance,
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  );
+
 /**
   Check existing TCP connection, if in error state, receover TCP4 connection.
 
@@ -311,7 +362,22 @@ HttpConnectTcp4 (
   );
 
 /**
-  Send the HTTP message through TCP4.
+  Check existing TCP connection, if in error state, recover TCP6 connection.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+
+  @retval EFI_SUCCESS            The TCP connection is established.
+  @retval EFI_NOT_READY          TCP6 protocol child is not created or configured.
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpConnectTcp6 (
+  IN  HTTP_PROTOCOL        *HttpInstance
+  );
+
+/**
+  Send the HTTP message through TCP4 or TCP6.
 
   @param[in]  HttpInstance       The HTTP instance private data.
   @param[in]  Wrap               The HTTP token's wrap data.
@@ -323,7 +389,7 @@ HttpConnectTcp4 (
 
 **/
 EFI_STATUS
-HttpTransmitTcp4 (
+HttpTransmitTcp (
   IN  HTTP_PROTOCOL    *HttpInstance,
   IN  HTTP_TOKEN_WRAP  *Wrap,
   IN  UINT8            *TxString,
@@ -346,7 +412,7 @@ HttpMappingToStatusCode (
 
 /**
   Check whether the user's token or event has already
-  been enqueue on HTTP TxToken or RxToken list.
+  been enqueue on HTTP Tx or Rx Token list.
 
   @param[in]  Map                The container of either user's transmit or receive
                                  token.
@@ -367,7 +433,7 @@ HttpTokenExist (
   );
 
 /**
-  Check whether the HTTP message associated with TxToken is already sent out.
+  Check whether the HTTP message associated with TxToken or Tx6Token is already sent out.
 
   @param[in]  Map                The container of TxToken.
   @param[in]  Item               Current item to check against.
@@ -385,10 +451,26 @@ HttpTcpNotReady (
   IN VOID                   *Context
   );
 
+/**
+  Initialize TCP related data.
+
+  @param[in]  HttpInstance       The HTTP instance private data.
+  @param[in]  Wrap               The HTTP token's wrap data.
+
+  @retval EFI_SUCCESS            The initialization of TCP instance is done. 
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpInitTcp (
+  IN  HTTP_PROTOCOL    *HttpInstance,
+  IN  HTTP_TOKEN_WRAP  *Wrap
+  );
+
 /**
   Transmit the HTTP mssage by processing the associated HTTP token.
 
-  @param[in]  Map                The container of TxToken.
+  @param[in]  Map                The container of TxToken or Tx6Token.
   @param[in]  Item               Current item to check against.
   @param[in]  Context            The Token to check againist.
 
@@ -408,7 +490,7 @@ HttpTcpTransmit (
 /**
   Receive the HTTP response by processing the associated HTTP token.
 
-  @param[in]  Map                The container of RxToken.
+  @param[in]  Map                The container of Rx4Token or Rx6Token.
   @param[in]  Item               Current item to check against.
   @param[in]  Context            The Token to check againist.
 
@@ -425,6 +507,51 @@ HttpTcpReceive (
   IN VOID                   *Context
   );
 
+/**
+  Receive the HTTP header by processing the associated HTTP token.
+
+  @param[in]       HttpInstance    The HTTP instance private data.
+  @param[in, out]  SizeofHeaders   The HTTP header length.
+  @param[in, out]  BufferSize      The size of buffer to cacahe the header message.
+
+  @retval EFI_SUCCESS              The HTTP header is received.                          
+  @retval Others                   Other errors as indicated.
+
+**/
+EFI_STATUS
+HttpTcpReceiveHeader (
+  IN  HTTP_PROTOCOL         *HttpInstance,
+  IN  OUT UINTN             *SizeofHeaders,
+  IN  OUT UINTN             *BufferSize
+  );
+
+/**
+  Receive the HTTP body by processing the associated HTTP token.
+
+  @param[in]  Wrap               The HTTP token's wrap data.
+  @param[in]  HttpMsg            The HTTP message data.
+
+  @retval EFI_SUCCESS            The HTTP body is received.                          
+  @retval Others                 Other error as indicated.
+
+**/
+EFI_STATUS
+HttpTcpReceiveBody (
+  IN  HTTP_TOKEN_WRAP       *Wrap,
+  IN  EFI_HTTP_MESSAGE      *HttpMsg
+  );
+
+/**
+  Clean up Tcp Tokens while the Tcp transmission error occurs.
+
+  @param[in]  Wrap               Pointer to HTTP token's wrap data.
+  
+**/
+VOID
+HttpTcpTokenCleanup (
+  IN  HTTP_TOKEN_WRAP      *Wrap
+  );
+
 /**
   Generate HTTP request string.
 

From 234dee51b1e1d7e42143b0a93832eccaced455ea Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:37:41 +0000
Subject: [PATCH 141/525] MdeModulePkg:Fix a bug that HttpLib can not parse
 Ipv6 address correctly.

When parsing the authority component of the input URL, it can not distinguish
the ":" is the flag that indicates the port or the separator between
the ipv6 address.

(Sync patch r18744 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>
Reviewed-by: Gary Ching-Pang Lin <glin@suse.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18875 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c | 33 +++++++++++++++++---
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
index aeb52d008857..500b3c72b38f 100644
--- a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
+++ b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
@@ -70,6 +70,7 @@ typedef enum {
   UrlParserUserInfo,
   UrlParserHostStart,     // "@"
   UrlParserHost,
+  UrlParserHostIpv6,      // "["(Ipv6 address) "]"
   UrlParserPortStart,     // ":"
   UrlParserPort,
   UrlParserStateMax
@@ -138,13 +139,16 @@ UriPercentDecode (
 
   @param[in]       Char           Next character.
   @param[in]       State          Current value of the parser state machine.
+  @param[in]       IsRightBracket TRUE if there is an sign ']' in the authority component and 
+                                  indicates the next part is ':' before Port.                                
 
   @return          Updated state value.
 **/
 HTTP_URL_PARSE_STATE
 NetHttpParseAuthorityChar (
   IN  CHAR8                  Char,
-  IN  HTTP_URL_PARSE_STATE   State
+  IN  HTTP_URL_PARSE_STATE   State,
+  IN  BOOLEAN                *IsRightBracket
   )
 {
 
@@ -169,12 +173,27 @@ NetHttpParseAuthorityChar (
     break;
 
   case UrlParserHost:
-  case UrlParserHostStart:
+  case UrlParserHostStart:  
+    if (Char == '[') {
+      return UrlParserHostIpv6;
+    }
+    
     if (Char == ':') {
       return UrlParserPortStart;
     }
+    
     return UrlParserHost;
-
+    
+  case UrlParserHostIpv6:  
+    if (Char == ']') {
+      *IsRightBracket = TRUE;
+    }
+    
+    if (Char == ':' && *IsRightBracket == TRUE) {
+      return UrlParserPortStart;
+    }
+    return UrlParserHostIpv6;
+    
   case UrlParserPort:
   case UrlParserPortStart:
     return UrlParserPort;
@@ -210,6 +229,7 @@ NetHttpParseAuthority (
   HTTP_URL_PARSE_STATE  State;
   UINT32                Field;
   UINT32                OldField;
+  BOOLEAN               IsrightBracket;
   
   ASSERT ((UrlParser->FieldBitMap & BIT (HTTP_URI_FIELD_AUTHORITY)) != 0);
 
@@ -222,12 +242,13 @@ NetHttpParseAuthority (
     State = UrlParserHost;
   }
 
+  IsrightBracket = FALSE;
   Field = HTTP_URI_FIELD_MAX;
   OldField = Field;
   Authority = Url + UrlParser->FieldData[HTTP_URI_FIELD_AUTHORITY].Offset;
   Length = UrlParser->FieldData[HTTP_URI_FIELD_AUTHORITY].Length;
   for (Char = Authority; Char < Authority + Length; Char++) {
-    State = NetHttpParseAuthorityChar (*Char, State);
+    State = NetHttpParseAuthorityChar (*Char, State, &IsrightBracket);
     switch (State) {
     case UrlParserStateMax:
       return EFI_INVALID_PARAMETER;
@@ -243,6 +264,10 @@ NetHttpParseAuthority (
     case UrlParserHost:
       Field = HTTP_URI_FIELD_HOST;
       break;
+
+    case UrlParserHostIpv6:
+      Field = HTTP_URI_FIELD_HOST;
+      break;
       
     case UrlParserPort:
       Field = HTTP_URI_FIELD_PORT;

From 13d4db31c299c657400de060f2836c8cc6b8bdbc Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:38:44 +0000
Subject: [PATCH 142/525] NetworkPkg:Fix the issue that cannot parse ipv6
 address correctly.

If there is a ipv6 expressed url, the NetLibAsciiStrToIp6 cannot get the Ipv6
address from the host name, because the host name contains left and right
bracket which cannot be used to configure the Tcp6 connection.

(Sync patch r18745 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18876 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index fc9d691f2299..37064d15bc97 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -391,7 +391,7 @@ EfiHttpRequest (
     if (!HttpInstance->LocalAddressIsIPv6) {
       Status = NetLibAsciiStrToIp4 (HostName, &HttpInstance->RemoteAddr);
     } else {
-      Status = NetLibAsciiStrToIp6 (HostName, &HttpInstance->RemoteIpv6Addr);
+      Status = HttpUrlGetIp6 (Url, UrlParser, &HttpInstance->RemoteIpv6Addr);
     }
 
     if (EFI_ERROR (Status)) {

From 627c5e88d43b42d4bf3fee6d36a4f85964bbd2f7 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:39:33 +0000
Subject: [PATCH 143/525] NetworkPkg: Report Http Errors to screen when http
 layer occurs an error

Http server will return error status in http header when http connection
cannot be established,so the http boot driver should print the error code
code to the screen and the users can know what happened.

(Sync patch r18761 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Sriram Subramanian <sriram-s@hpe.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18877 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpBootDxe/HttpBootSupport.c | 151 ++++++++++++++++++++++-
 1 file changed, 150 insertions(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootSupport.c b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
index d08111f66107..1fc4e768806c 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootSupport.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
@@ -146,6 +146,149 @@ HttpBootShowIp6Addr (
   }
 }
 
+/**
+  This function is to display the HTTP error status.
+
+  @param[in]      StatusCode      The status code value in HTTP message.
+
+**/
+VOID
+HttpBootPrintErrorMessage (
+  EFI_HTTP_STATUS_CODE            StatusCode
+  )
+{
+  AsciiPrint ("\n");
+
+  switch (StatusCode) {
+  case HTTP_STATUS_300_MULTIPLE_CHIOCES:
+    AsciiPrint ("\n  Redirection: 300 Multiple Choices");
+    break; 
+    
+  case HTTP_STATUS_301_MOVED_PERMANENTLY:
+    AsciiPrint ("\n  Redirection: 301 Moved Permanently");
+    break; 
+    
+  case HTTP_STATUS_302_FOUND:
+    AsciiPrint ("\n  Redirection: 302 Found");
+    break; 
+    
+  case HTTP_STATUS_303_SEE_OTHER:
+    AsciiPrint ("\n  Redirection: 303 See Other");
+    break; 
+
+  case HTTP_STATUS_304_NOT_MODIFIED:
+    AsciiPrint ("\n  Redirection: 304 Not Modified");
+    break; 
+
+  case HTTP_STATUS_305_USE_PROXY:
+    AsciiPrint ("\n  Redirection: 305 Use Proxy");
+    break; 
+
+  case HTTP_STATUS_307_TEMPORARY_REDIRECT:
+    AsciiPrint ("\n  Redirection: 307 Temporary Redirect");
+    break; 
+
+  case HTTP_STATUS_400_BAD_REQUEST:
+    AsciiPrint ("\n  Client Error: 400 Bad Request");
+    break;
+    
+  case HTTP_STATUS_401_UNAUTHORIZED:
+    AsciiPrint ("\n  Client Error: 401 Unauthorized");
+    break;
+    
+  case HTTP_STATUS_402_PAYMENT_REQUIRED:
+    AsciiPrint ("\n  Client Error: 402 Payment Required");
+    break;
+
+  case HTTP_STATUS_403_FORBIDDEN:
+    AsciiPrint ("\n  Client Error: 403 Forbidden");
+    break;
+
+  case HTTP_STATUS_404_NOT_FOUND:
+    AsciiPrint ("\n  Client Error: 404 Not Found");
+    break;
+
+  case HTTP_STATUS_405_METHOD_NOT_ALLOWED:
+    AsciiPrint ("\n  Client Error: 405 Method Not Allowed");
+    break;
+
+  case HTTP_STATUS_406_NOT_ACCEPTABLE:
+    AsciiPrint ("\n  Client Error: 406 Not Acceptable");
+    break;
+
+  case HTTP_STATUS_407_PROXY_AUTHENTICATION_REQUIRED:
+    AsciiPrint ("\n  Client Error: 407 Proxy Authentication Required");
+    break;
+
+  case HTTP_STATUS_408_REQUEST_TIME_OUT:
+    AsciiPrint ("\n  Client Error: 408 Request Timeout");
+    break;
+
+  case HTTP_STATUS_409_CONFLICT:
+    AsciiPrint ("\n  Client Error: 409 Conflict");
+    break;
+
+  case HTTP_STATUS_410_GONE:
+    AsciiPrint ("\n  Client Error: 410 Gone");
+    break;
+
+  case HTTP_STATUS_411_LENGTH_REQUIRED:
+    AsciiPrint ("\n  Client Error: 411 Length Required");
+    break;
+
+  case HTTP_STATUS_412_PRECONDITION_FAILED:
+    AsciiPrint ("\n  Client Error: 412 Precondition Failed");
+    break;
+
+  case HTTP_STATUS_413_REQUEST_ENTITY_TOO_LARGE:
+    AsciiPrint ("\n  Client Error: 413 Request Entity Too Large");
+    break;
+
+  case HTTP_STATUS_414_REQUEST_URI_TOO_LARGE:
+    AsciiPrint ("\n  Client Error: 414 Request URI Too Long");
+    break;
+
+  case HTTP_STATUS_415_UNSUPPORTED_MEDIA_TYPE:
+    AsciiPrint ("\n  Client Error: 415 Unsupported Media Type");
+    break;
+
+  case HTTP_STATUS_416_REQUESTED_RANGE_NOT_SATISFIED:
+    AsciiPrint ("\n  Client Error: 416 Requested Range Not Satisfiable");
+    break;
+
+  case HTTP_STATUS_417_EXPECTATION_FAILED:
+    AsciiPrint ("\n  Client Error: 417 Expectation Failed");
+    break;
+
+  case HTTP_STATUS_500_INTERNAL_SERVER_ERROR:
+    AsciiPrint ("\n  Server Error: 500 Internal Server Error");
+    break;
+
+  case HTTP_STATUS_501_NOT_IMPLEMENTED:
+    AsciiPrint ("\n  Server Error: 501 Not Implemented");
+    break;
+
+  case HTTP_STATUS_502_BAD_GATEWAY:
+    AsciiPrint ("\n  Server Error: 502 Bad Gateway");
+    break;
+
+  case HTTP_STATUS_503_SERVICE_UNAVAILABLE:
+    AsciiPrint ("\n  Server Error: 503 Service Unavailable");
+    break;
+
+  case HTTP_STATUS_504_GATEWAY_TIME_OUT:
+    AsciiPrint ("\n  Server Error: 504 Gateway Timeout");
+    break;
+
+  case HTTP_STATUS_505_HTTP_VERSION_NOT_SUPPORTED:
+    AsciiPrint ("\n  Server Error: 505 HTTP Version Not Supported");
+    break;
+
+  default: ;
+  
+  }
+}
+
 /**
   Notify the callback function when an event is triggered.
 
@@ -787,6 +930,7 @@ HttpIoRecvResponse (
 {
   EFI_STATUS                 Status;
   EFI_HTTP_PROTOCOL          *Http;
+  EFI_HTTP_STATUS_CODE       StatusCode;
 
   if (HttpIo == NULL || HttpIo->Http == NULL || ResponseData == NULL) {
     return EFI_INVALID_PARAMETER;
@@ -818,7 +962,7 @@ HttpIoRecvResponse (
   }
 
   //
-  // Poll the network until transmit finish.
+  // Poll the network until receive finish.
   //
   while (!HttpIo->IsRxDone) {
     Http->Poll (Http);
@@ -833,6 +977,11 @@ HttpIoRecvResponse (
     ResponseData->Headers     = HttpIo->RspToken.Message->Headers;
     ResponseData->BodyLength  = HttpIo->RspToken.Message->BodyLength;
   }
+  
+  if (RecvMsgHeader) {
+    StatusCode = HttpIo->RspToken.Message->Data.Response->StatusCode;
+    HttpBootPrintErrorMessage (StatusCode);
+  }
 
   return Status;
 }

From dfa8506445ed92a3fa1505422820d84217dbdd83 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Wed, 18 Nov 2015 08:40:26 +0000
Subject: [PATCH 144/525] NetworkPkg: Httpboot will fail the 2nd time result by
 wrong TCP state.

If the 2nd boot quickly after the first succeed boot, it will function well.
But if you wait for some time after 1nd succeed boot and boot again, the
TCP state may change from established to closed wait as the http server send
fin flag, then boot fail occurred.

(Sync patch r18783 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18878 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c  | 25 ++++++++++++++--------
 NetworkPkg/HttpDxe/HttpProto.c | 38 ++++++++++++++++++++++------------
 NetworkPkg/HttpDxe/HttpProto.h |  4 +++-
 3 files changed, 44 insertions(+), 23 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 37064d15bc97..ce28f07efa1f 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -318,7 +318,11 @@ EfiHttpRequest (
   if (EFI_ERROR (Status)) {
     RemotePort = HTTP_DEFAULT_PORT;
   }
-
+  //
+  // If Configure is TRUE, it indicates the first time to call Request();
+  // If ReConfigure is TRUE, it indicates the request URL is not same
+  // with the previous call to Request();
+  //
   Configure   = TRUE;
   ReConfigure = TRUE;  
 
@@ -428,7 +432,11 @@ EfiHttpRequest (
     //
     // The request URL is different from previous calls to Request(), close existing TCP instance.
     //
-    ASSERT (HttpInstance->Tcp4 != NULL &&HttpInstance->Tcp6 != NULL);
+    if (!HttpInstance->LocalAddressIsIPv6) {
+      ASSERT (HttpInstance->Tcp4 != NULL);
+    } else {
+      ASSERT (HttpInstance->Tcp6 != NULL);
+    }
     HttpCloseConnection (HttpInstance);
     EfiHttpCancel (This, NULL);
   }
@@ -446,13 +454,12 @@ EfiHttpRequest (
   Wrap->HttpInstance   = HttpInstance;
   Wrap->TcpWrap.Method = Request->Method;
 
-  if (Configure) {
-    Status = HttpInitTcp (HttpInstance, Wrap);
-    if (EFI_ERROR (Status)) {
-      goto Error2;
-    }
+  Status = HttpInitTcp (HttpInstance, Wrap, Configure);
+  if (EFI_ERROR (Status)) {
+    goto Error2;
+  }  
 
-  } else {
+  if (!Configure) {
     //
     // For the new HTTP token, create TX TCP token events.    
     //
@@ -461,7 +468,7 @@ EfiHttpRequest (
       goto Error1;
     }
   }
-
+  
   //
   // Create request message.
   //
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index c4ffef2bc236..22aed253cb36 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -1181,7 +1181,7 @@ HttpConnectTcp4 (
   EFI_TCP4_CONNECTION_STATE Tcp4State;
 
 
-  if (HttpInstance->State != HTTP_STATE_TCP_CONFIGED || HttpInstance->Tcp4 == NULL) {
+  if (HttpInstance->State < HTTP_STATE_TCP_CONFIGED || HttpInstance->Tcp4 == NULL) {
     return EFI_NOT_READY;
   }
 
@@ -1198,9 +1198,11 @@ HttpConnectTcp4 (
     return Status;
   }
 
-  if (Tcp4State > Tcp4StateEstablished) {
+  if (Tcp4State == Tcp4StateEstablished) {
+    return EFI_SUCCESS;
+  } else if (Tcp4State > Tcp4StateEstablished ) {
     HttpCloseConnection(HttpInstance);
-  }  
+  }
 
   return HttpCreateConnection (HttpInstance);
 }
@@ -1223,7 +1225,7 @@ HttpConnectTcp6 (
   EFI_STATUS                Status;
   EFI_TCP6_CONNECTION_STATE Tcp6State;
 
-  if (HttpInstance->State != HTTP_STATE_TCP_CONFIGED || HttpInstance->Tcp6 == NULL) {
+  if (HttpInstance->State < HTTP_STATE_TCP_CONFIGED || HttpInstance->Tcp6 == NULL) {
     return EFI_NOT_READY;
   }
 
@@ -1241,8 +1243,10 @@ HttpConnectTcp6 (
      return Status;
   }
 
-  if (Tcp6State > Tcp6StateEstablished) {
-    HttpCloseConnection (HttpInstance);
+  if (Tcp6State == Tcp6StateEstablished) {
+    return EFI_SUCCESS;
+  } else if (Tcp6State > Tcp6StateEstablished ) {
+    HttpCloseConnection(HttpInstance);
   }
 
   return HttpCreateConnection (HttpInstance);
@@ -1253,6 +1257,7 @@ HttpConnectTcp6 (
 
   @param[in]  HttpInstance       The HTTP instance private data.
   @param[in]  Wrap               The HTTP token's wrap data.
+  @param[in]  Configure          The Flag indicates whether the first time to initialize Tcp.
 
   @retval EFI_SUCCESS            The initialization of TCP instance is done. 
   @retval Others                 Other error as indicated.
@@ -1261,7 +1266,8 @@ HttpConnectTcp6 (
 EFI_STATUS
 HttpInitTcp (
   IN  HTTP_PROTOCOL    *HttpInstance,
-  IN  HTTP_TOKEN_WRAP  *Wrap
+  IN  HTTP_TOKEN_WRAP  *Wrap,
+  IN  BOOLEAN          Configure
   )
 {
   EFI_STATUS           Status;
@@ -1271,10 +1277,13 @@ HttpInitTcp (
     //
     // Configure TCP instance.
     //
-    Status = HttpConfigureTcp4 (HttpInstance, Wrap);
-    if (EFI_ERROR (Status)) {
-      return Status;
+    if (Configure) {
+      Status = HttpConfigureTcp4 (HttpInstance, Wrap);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
     }
+
     //
     // Connect TCP.
     //
@@ -1286,10 +1295,13 @@ HttpInitTcp (
     //
     // Configure TCP instance.
     //
-    Status = HttpConfigureTcp6 (HttpInstance, Wrap);
-    if (EFI_ERROR (Status)) {
-      return Status;
+    if (Configure) {
+      Status = HttpConfigureTcp6 (HttpInstance, Wrap);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
     }
+
     //
     // Connect TCP.
     //
diff --git a/NetworkPkg/HttpDxe/HttpProto.h b/NetworkPkg/HttpDxe/HttpProto.h
index a15e0a87be53..e43a2dc01c54 100644
--- a/NetworkPkg/HttpDxe/HttpProto.h
+++ b/NetworkPkg/HttpDxe/HttpProto.h
@@ -456,6 +456,7 @@ HttpTcpNotReady (
 
   @param[in]  HttpInstance       The HTTP instance private data.
   @param[in]  Wrap               The HTTP token's wrap data.
+  @param[in]  Configure          The Flag indicates whether the first time to initialize Tcp.
 
   @retval EFI_SUCCESS            The initialization of TCP instance is done. 
   @retval Others                 Other error as indicated.
@@ -464,7 +465,8 @@ HttpTcpNotReady (
 EFI_STATUS
 HttpInitTcp (
   IN  HTTP_PROTOCOL    *HttpInstance,
-  IN  HTTP_TOKEN_WRAP  *Wrap
+  IN  HTTP_TOKEN_WRAP  *Wrap,
+  IN  BOOLEAN          Configure
   );
 
 /**

From 25e3b3522b9a5028002e8fc1c5a5b6915b9709f7 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:50:23 +0000
Subject: [PATCH 145/525] MdeModulePkg: Add PlatformLogo protocol definition.

(Sync patch r18769 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18879 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Protocol/PlatformLogo.h | 86 ++++++++++++++++++++
 MdeModulePkg/MdeModulePkg.dec                |  3 +
 2 files changed, 89 insertions(+)
 create mode 100644 MdeModulePkg/Include/Protocol/PlatformLogo.h

diff --git a/MdeModulePkg/Include/Protocol/PlatformLogo.h b/MdeModulePkg/Include/Protocol/PlatformLogo.h
new file mode 100644
index 000000000000..9ac87f1748d3
--- /dev/null
+++ b/MdeModulePkg/Include/Protocol/PlatformLogo.h
@@ -0,0 +1,86 @@
+/** @file
+  The Platform Logo Protocol defines the interface to get the Platform logo
+  image with the display attribute.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under 
+the terms and conditions of the BSD License that accompanies this distribution.  
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.                                          
+    
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef __PLATFORM_LOGO_H__
+#define __PLATFORM_LOGO_H__
+
+//
+// GUID for EDKII Platform Logo Protocol
+//
+#define EDKII_PLATFORM_LOGO_PROTOCOL_GUID \
+  { 0x9b517978, 0xeba1, 0x44e7, { 0xba, 0x65, 0x7c, 0x2c, 0xd0, 0x8b, 0xf8, 0xe9 } }
+
+typedef struct _EDKII_PLATFORM_LOGO_PROTOCOL EDKII_PLATFORM_LOGO_PROTOCOL;
+
+typedef enum {
+  ImageFormatUnknown,
+  ImageFormatBmp,
+  ImageFormatJpeg,
+  ImageFormatTiff,
+  ImageFormatGif
+} IMAGE_FORMAT;
+
+typedef enum {
+  EdkiiPlatformLogoDisplayAttributeLeftTop,
+  EdkiiPlatformLogoDisplayAttributeCenterTop,
+  EdkiiPlatformLogoDisplayAttributeRightTop,
+  EdkiiPlatformLogoDisplayAttributeCenterRight,
+  EdkiiPlatformLogoDisplayAttributeRightBottom,
+  EdkiiPlatformLogoDisplayAttributeCenterBottom,
+  EdkiiPlatformLogoDisplayAttributeLeftBottom,
+  EdkiiPlatformLogoDisplayAttributeCenterLeft,
+  EdkiiPlatformLogoDisplayAttributeCenter
+} EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE;
+
+/**
+
+  Load a platform logo image and return its data and attributes.
+
+  @param This              The pointer to this protocol instance.
+  @param Instance          The visible image instance is found.
+  @param Format            The format of the image. Examples: BMP, JPEG.
+  @param ImageData         The image data for the badge file. Currently only 
+                           supports the .bmp file format. 
+  @param ImageSize         The size of the image returned.
+  @param Attribute         The display attributes of the image returned.
+  @param CoordinateX       The X coordinate of the image.
+  @param CoordinateY       The Y coordinate of the image.
+
+  @retval EFI_SUCCESS      The image was fetched successfully.
+  @retval EFI_NOT_FOUND    The specified image could not be found.
+
+**/
+typedef
+EFI_STATUS
+(EFIAPI *EDKII_PLATFORM_LOGO_GET_IMAGE)(
+  IN     EDKII_PLATFORM_LOGO_PROTOCOL          *This,
+  IN OUT UINT32                                *Instance,
+     OUT IMAGE_FORMAT                          *Format,
+     OUT UINT8                                 **ImageData,
+     OUT UINTN                                 *ImageSize,
+     OUT EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE *Attribute,
+     OUT UINTN                                 *CoordinateX,
+     OUT UINTN                                 *CoordinateY
+);
+
+
+struct _EDKII_PLATFORM_LOGO_PROTOCOL {
+  EDKII_PLATFORM_LOGO_GET_IMAGE GetImage;
+};
+
+
+extern EFI_GUID gEdkiiPlatformLogoProtocolGuid;
+
+#endif
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 3dfcd6a77f64..08148e39d938 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -449,6 +449,9 @@
   ## Include/Protocol/SmmReadyToBoot.h
   gEdkiiSmmReadyToBootProtocolGuid = { 0x6e057ecf, 0xfa99, 0x4f39, { 0x95, 0xbc, 0x59, 0xf9, 0x92, 0x1d, 0x17, 0xe4 } }
 
+  ## Include/Protocol/PlatformLogo.h
+  gEdkiiPlatformLogoProtocolGuid = { 0x9b517978, 0xeba1, 0x44e7, { 0xba, 0x65, 0x7c, 0x2c, 0xd0, 0x8b, 0xf8, 0xe9 } }
+
 #
 # [Error.gEfiMdeModulePkgTokenSpaceGuid]
 #   0x80000001 | Invalid value provided.

From 6aaf1ccb97ea99817ca27600289e47d25acf9615 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:51:42 +0000
Subject: [PATCH 146/525] MdeModulePkg: Add ImageDecoderLib to provide image
 decoding service.

The library itself doesn't provide any image decoding capabilities but
manages the different image decoders.

(Sync patch r18770 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18880 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Include/Library/ImageDecoderLib.h         |  76 +++++++++++
 .../Library/ImageDecoderLib/ImageDecoderLib.c | 121 ++++++++++++++++++
 .../ImageDecoderLib/ImageDecoderLib.inf       |  42 ++++++
 MdeModulePkg/MdeModulePkg.dec                 |   4 +
 MdeModulePkg/MdeModulePkg.dsc                 |   2 +
 5 files changed, 245 insertions(+)
 create mode 100644 MdeModulePkg/Include/Library/ImageDecoderLib.h
 create mode 100644 MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
 create mode 100644 MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf

diff --git a/MdeModulePkg/Include/Library/ImageDecoderLib.h b/MdeModulePkg/Include/Library/ImageDecoderLib.h
new file mode 100644
index 000000000000..928a09483aea
--- /dev/null
+++ b/MdeModulePkg/Include/Library/ImageDecoderLib.h
@@ -0,0 +1,76 @@
+/** @file
+  This library provides image decoding service by managing the different
+  image decoding libraries.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#ifndef __IMAGE_DECODER_LIB_H__
+#define __IMAGE_DECODER_LIB_H__
+#include <Protocol/PlatformLogo.h>
+
+typedef
+EFI_STATUS
+(EFIAPI *DECODE_IMAGE)(
+  IN  IMAGE_FORMAT                  ImageFormat,
+  IN  UINT8                         *Image,
+  IN  UINTN                         ImageSize,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
+  OUT UINTN                         *GopBltSize,
+  OUT UINTN                         *PixelWidth,
+  OUT UINTN                         *PixelHeight
+  );
+
+/**
+  Convert a graphics image to a callee allocated GOP blt buffer.
+
+  @param  ImageFormat   Format of the image file.
+  @param  Image         Pointer to image file.
+  @param  ImageSize     Number of bytes in Image.
+  @param  GopBlt        Buffer containing GOP version of Image.
+  @param  GopBltSize    Size of GopBlt in bytes.
+  @param  PixelWidth    Width of GopBlt/Image in pixels.
+  @param  PixelHeight   Height of GopBlt/Image in pixels.
+
+  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
+  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
+  @retval EFI_INVALID_PARAMETER Image is NULL or ImageSize is 0.
+  @retval EFI_UNSUPPORTED       Image is not supported.
+  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
+
+**/
+EFI_STATUS
+EFIAPI
+DecodeImage (
+  IN  IMAGE_FORMAT                  ImageFormat,
+  IN  UINT8                         *Image,
+  IN  UINTN                         ImageSize,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
+  OUT UINTN                         *GopBltSize,
+  OUT UINTN                         *PixelWidth,
+  OUT UINTN                         *PixelHeight
+  );
+
+/**
+  Register an image decoder.
+
+  @param Decoder  An image decoder.
+
+  @retval EFI_SUCCESS          The decoder was successfully registered.
+  @retval EFI_OUT_OF_RESOURCES No enough resource to register the decoder.
+
+**/
+EFI_STATUS
+EFIAPI
+RegisterImageDecoder (
+  IN  DECODE_IMAGE     Decoder
+  );
+
+#endif
diff --git a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
new file mode 100644
index 000000000000..4a6219bbb138
--- /dev/null
+++ b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
@@ -0,0 +1,121 @@
+/** @file
+  This library provides image decoding service by managing the different
+  image decoding libraries.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Uefi.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Library/ImageDecoderLib.h>
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+
+typedef struct {
+  UINT32       Signature;
+  DECODE_IMAGE Decoder;
+  LIST_ENTRY   Link;
+} IMAGE_DECODER_ENTRY;
+#define IMAGE_DECODER_ENTRY_SIGNATURE  SIGNATURE_32 ('i', 'm', 'g', 'd')
+#define IMAGE_DECODER_ENTRY_FROM_LINK(Link) \
+        CR (Link, IMAGE_DECODER_ENTRY, Link, IMAGE_DECODER_ENTRY_SIGNATURE)
+
+LIST_ENTRY mImageDecoderLibDecoders = INITIALIZE_LIST_HEAD_VARIABLE (mImageDecoderLibDecoders);
+
+/**
+  Convert a graphics image to a callee allocated GOP blt buffer.
+
+  @param  ImageFormat   Format of the image file.
+  @param  Image         Pointer to image file.
+  @param  ImageSize     Number of bytes in Image.
+  @param  GopBlt        Buffer containing GOP version of Image.
+  @param  GopBltSize    Size of GopBlt in bytes.
+  @param  PixelWidth    Width of GopBlt/Image in pixels.
+  @param  PixelHeight   Height of GopBlt/Image in pixels.
+
+  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
+  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
+  @retval EFI_INVALID_PARAMETER Image is NULL or ImageSize is 0.
+  @retval EFI_UNSUPPORTED       Image is not supported.
+  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
+
+**/
+EFI_STATUS
+EFIAPI
+DecodeImage (
+  IN  IMAGE_FORMAT                  ImageFormat,
+  IN  UINT8                         *Image,
+  IN  UINTN                         ImageSize,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
+  OUT UINTN                         *GopBltSize,
+  OUT UINTN                         *PixelWidth,
+  OUT UINTN                         *PixelHeight
+  )
+{
+  IMAGE_DECODER_ENTRY               *Entry;
+  LIST_ENTRY                        *Link;
+  EFI_STATUS                        Status;
+
+  if ((GopBlt == NULL) || (GopBltSize == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((Image == NULL) || (ImageSize == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  for ( Link = GetFirstNode (&mImageDecoderLibDecoders)
+      ; !IsNull (&mImageDecoderLibDecoders, Link)
+      ; Link = GetNextNode (&mImageDecoderLibDecoders, Link)
+      ) {
+    Entry = IMAGE_DECODER_ENTRY_FROM_LINK (Link);
+    Status = Entry->Decoder (ImageFormat, Image, ImageSize, GopBlt, GopBltSize, PixelWidth, PixelHeight);
+    if (!EFI_ERROR (Status)) {
+      break;
+    }
+  }
+
+  if (IsNull (&mImageDecoderLibDecoders, Link)) {
+    return EFI_UNSUPPORTED;
+  } else {
+    return EFI_SUCCESS;
+  }
+}
+
+/**
+  Register an image decoder.
+
+  @param Decoder  An image decoder.
+
+  @retval EFI_SUCCESS          The decoder was successfully registered.
+  @retval EFI_OUT_OF_RESOURCES No enough resource to register the decoder.
+
+**/
+EFI_STATUS
+EFIAPI
+RegisterImageDecoder (
+  IN  DECODE_IMAGE     Decoder
+  )
+{
+  IMAGE_DECODER_ENTRY  *Entry;
+
+  Entry = AllocatePool (sizeof (IMAGE_DECODER_ENTRY));
+  if (Entry == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Entry->Signature = IMAGE_DECODER_ENTRY_SIGNATURE;
+  Entry->Decoder   = Decoder;
+  InsertTailList (&mImageDecoderLibDecoders, &Entry->Link);
+
+  return EFI_SUCCESS;
+}
\ No newline at end of file
diff --git a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
new file mode 100644
index 000000000000..5d2ee7b429b5
--- /dev/null
+++ b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
@@ -0,0 +1,42 @@
+## @file
+#  This library provides image decoding service by managing the different
+#  image decoding libraries.
+#  
+#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials are licensed and made available under
+#  the terms and conditions of the BSD License that accompanies this distribution.
+#  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#  
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = ImageDecoderLib
+  FILE_GUID                      = 5ACDA5F7-AE20-4A17-90C1-7D087F730202
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = ImageDecoderLib|DXE_DRIVER UEFI_APPLICATION
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  ImageDecoderLib.c
+  
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  MemoryAllocationLib
+  UefiLib
+  BaseMemoryLib
+  DebugLib
\ No newline at end of file
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 08148e39d938..c35f533adc9b 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -131,6 +131,10 @@
   #
   PlatformVarCleanupLib|Include/Library/PlatformVarCleanupLib.h
 
+  ## @libraryclass  Provides image decoding service.
+  #
+  ImageDecoderLib|Include/Library/ImageDecoderLib.h
+
 [Guids]
   ## MdeModule package token space guid
   # Include/Guid/MdeModulePkgTokenSpace.h
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index c43093260453..a57c7ebdebd9 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -47,6 +47,7 @@
   PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
   SortLib|MdeModulePkg/Library/BaseSortLib/BaseSortLib.inf
+  ImageDecoderLib|MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
   #
   # UEFI & PI
   #
@@ -276,6 +277,7 @@
   MdeModulePkg/Library/PeiDxeDebugLibReportStatusCode/PeiDxeDebugLibReportStatusCode.inf
   MdeModulePkg/Library/UefiBootManagerLib/UefiBootManagerLib.inf
   MdeModulePkg/Library/PlatformBootManagerLibNull/PlatformBootManagerLibNull.inf
+  MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
   MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
   MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf
   MdeModulePkg/Library/VarCheckLib/VarCheckLib.inf

From 8fa0a25d5ac17e7c121550e5aff1e57caa0b239c Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:52:41 +0000
Subject: [PATCH 147/525] MdeModulePkg: Add BmpImageDecoderLib to provide BMP
 decoding capability

(Sync patch r18771 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18881 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BmpImageDecoderLib/BmpImageDecoderLib.c   | 272 ++++++++++++++++++
 .../BmpImageDecoderLib/BmpImageDecoderLib.inf |  42 +++
 MdeModulePkg/MdeModulePkg.dsc                 |   1 +
 3 files changed, 315 insertions(+)
 create mode 100644 MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
 create mode 100644 MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf

diff --git a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
new file mode 100644
index 000000000000..86dcc918c2c6
--- /dev/null
+++ b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
@@ -0,0 +1,272 @@
+/** @file
+  This library provides BMP image decoding capability.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Uefi.h>
+#include <IndustryStandard/Bmp.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Library/BaseLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+#include <Library/ImageDecoderLib.h>
+
+/**
+  Convert a *.BMP graphics image to a callee allocated GOP blt buffer.
+
+  @param  ImageFormat   Format of the image file.
+  @param  BmpImage      Pointer to BMP file
+  @param  BmpImageSize  Number of bytes in BmpImage
+  @param  GopBlt        Buffer containing GOP version of BmpImage.
+  @param  GopBltSize    Size of GopBlt in bytes.
+  @param  PixelHeight   Height of GopBlt/BmpImage in pixels
+  @param  PixelWidth    Width of GopBlt/BmpImage in pixels
+
+  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
+  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
+  @retval EFI_UNSUPPORTED       BmpImage is not a valid *.BMP image
+  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
+
+**/
+EFI_STATUS
+EFIAPI
+BmpImageDecoderLibConvertBmpToGopBlt (
+  IN  IMAGE_FORMAT                  ImageFormat,
+  IN  UINT8                         *BmpImage,
+  IN  UINTN                         BmpImageSize,
+  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
+  OUT UINTN                         *GopBltSize,
+  OUT UINTN                         *PixelWidth,
+  OUT UINTN                         *PixelHeight
+  )
+{
+  UINT8                         *Image;
+  UINT8                         *ImageHeader;
+  BMP_IMAGE_HEADER              *BmpHeader;
+  BMP_COLOR_MAP                 *BmpColorMap;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
+  UINT64                        BltBufferSize;
+  UINTN                         Index;
+  UINTN                         Height;
+  UINTN                         Width;
+  UINTN                         ImageIndex;
+  UINT32                        DataSizePerLine;
+  UINT32                        ColorMapNum;
+
+  ASSERT ((GopBlt != NULL) && (GopBltSize != NULL));
+
+  if (ImageFormat != ImageFormatBmp) {
+    return EFI_UNSUPPORTED;
+  }
+
+  if (sizeof (BMP_IMAGE_HEADER) > BmpImageSize) {
+    return EFI_UNSUPPORTED;
+  }
+
+  BmpHeader = (BMP_IMAGE_HEADER *) BmpImage;
+
+  if (BmpHeader->CharB != 'B' || BmpHeader->CharM != 'M') {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Doesn't support compress.
+  //
+  if (BmpHeader->CompressionType != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Only support BITMAPINFOHEADER format.
+  // BITMAPFILEHEADER + BITMAPINFOHEADER = BMP_IMAGE_HEADER
+  //
+  if (BmpHeader->HeaderSize != sizeof (BMP_IMAGE_HEADER) - OFFSET_OF(BMP_IMAGE_HEADER, HeaderSize)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // The data size in each line must be 4 byte alignment.
+  //
+  DataSizePerLine = ((BmpHeader->PixelWidth * BmpHeader->BitPerPixel + 31) >> 3) & (~0x3);
+  BltBufferSize = MultU64x32 (DataSizePerLine, BmpHeader->PixelHeight);
+  if (BltBufferSize > (UINT32) ~0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((BmpHeader->Size != BmpImageSize) || 
+      (BmpHeader->Size < BmpHeader->ImageOffset) ||
+      (BmpHeader->Size - BmpHeader->ImageOffset !=  BmpHeader->PixelHeight * DataSizePerLine)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Calculate Color Map offset in the image.
+  //
+  Image       = BmpImage;
+  BmpColorMap = (BMP_COLOR_MAP *) (Image + sizeof (BMP_IMAGE_HEADER));
+  if (BmpHeader->ImageOffset < sizeof (BMP_IMAGE_HEADER)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (BmpHeader->ImageOffset > sizeof (BMP_IMAGE_HEADER)) {
+    switch (BmpHeader->BitPerPixel) {
+      case 1:
+        ColorMapNum = 2;
+        break;
+      case 4:
+        ColorMapNum = 16;
+        break;
+      case 8:
+        ColorMapNum = 256;
+        break;
+      default:
+        ColorMapNum = 0;
+        break;
+      }
+    //
+    // BMP file may has padding data between the bmp header section and the bmp data section.
+    //
+    if (BmpHeader->ImageOffset - sizeof (BMP_IMAGE_HEADER) < sizeof (BMP_COLOR_MAP) * ColorMapNum) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Calculate graphics image data address in the image
+  //
+  Image         = ((UINT8 *) BmpImage) + BmpHeader->ImageOffset;
+  ImageHeader   = Image;
+
+  //
+  // Calculate the BltBuffer needed size.
+  //
+  BltBufferSize = MultU64x32 ((UINT64) BmpHeader->PixelWidth, BmpHeader->PixelHeight);
+  //
+  // Ensure the BltBufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
+  //
+  if (BltBufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
+    return EFI_UNSUPPORTED;
+  }
+  BltBufferSize = MultU64x32 (BltBufferSize, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
+
+  *GopBltSize = (UINTN) BltBufferSize;
+  *GopBlt     = AllocatePool (*GopBltSize);
+  if (*GopBlt == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  *PixelWidth   = BmpHeader->PixelWidth;
+  *PixelHeight  = BmpHeader->PixelHeight;
+
+  //
+  // Convert image from BMP to Blt buffer format
+  //
+  BltBuffer = *GopBlt;
+  for (Height = 0; Height < BmpHeader->PixelHeight; Height++) {
+    Blt = &BltBuffer[(BmpHeader->PixelHeight - Height - 1) * BmpHeader->PixelWidth];
+    for (Width = 0; Width < BmpHeader->PixelWidth; Width++, Image++, Blt++) {
+      switch (BmpHeader->BitPerPixel) {
+      case 1:
+        //
+        // Convert 1-bit (2 colors) BMP to 24-bit color
+        //
+        for (Index = 0; Index < 8 && Width < BmpHeader->PixelWidth; Index++) {
+          Blt->Red    = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Red;
+          Blt->Green  = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Green;
+          Blt->Blue   = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Blue;
+          Blt++;
+          Width++;
+        }
+
+        Blt--;
+        Width--;
+        break;
+
+      case 4:
+        //
+        // Convert 4-bit (16 colors) BMP Palette to 24-bit color
+        //
+        Index       = (*Image) >> 4;
+        Blt->Red    = BmpColorMap[Index].Red;
+        Blt->Green  = BmpColorMap[Index].Green;
+        Blt->Blue   = BmpColorMap[Index].Blue;
+        if (Width < (BmpHeader->PixelWidth - 1)) {
+          Blt++;
+          Width++;
+          Index       = (*Image) & 0x0f;
+          Blt->Red    = BmpColorMap[Index].Red;
+          Blt->Green  = BmpColorMap[Index].Green;
+          Blt->Blue   = BmpColorMap[Index].Blue;
+        }
+        break;
+
+      case 8:
+        //
+        // Convert 8-bit (256 colors) BMP Palette to 24-bit color
+        //
+        Blt->Red    = BmpColorMap[*Image].Red;
+        Blt->Green  = BmpColorMap[*Image].Green;
+        Blt->Blue   = BmpColorMap[*Image].Blue;
+        break;
+
+      case 24:
+        //
+        // It is 24-bit BMP.
+        //
+        Blt->Blue   = *Image++;
+        Blt->Green  = *Image++;
+        Blt->Red    = *Image;
+        break;
+
+      default:
+        //
+        // Other bit format BMP is not supported.
+        //
+        return EFI_UNSUPPORTED;
+        break;
+      };
+
+    }
+
+    ImageIndex = (UINTN) (Image - ImageHeader);
+    if ((ImageIndex % 4) != 0) {
+      //
+      // Bmp Image starts each row on a 32-bit boundary!
+      //
+      Image = Image + (4 - (ImageIndex % 4));
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialize BmpImageDecoderLib library.
+
+  @param ImageHandle     The image handle.
+  @param SystemTable     The system table.
+
+  @retval EFI_SUCCESS    The BmpImageDecoderLib library is initialized correctly.
+  @return Other value if failed to initialize the BmpImageDecoderLib library.
+**/
+EFI_STATUS
+EFIAPI
+BmpImageDecoderLibConstructor (
+  IN EFI_HANDLE                            ImageHandle,
+  IN EFI_SYSTEM_TABLE                      *SystemTable
+)
+{
+  RegisterImageDecoder (BmpImageDecoderLibConvertBmpToGopBlt);
+  return EFI_SUCCESS;
+}
+
diff --git a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
new file mode 100644
index 000000000000..2d1c16084e39
--- /dev/null
+++ b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
@@ -0,0 +1,42 @@
+## @file
+#  This library provides BMP image decoding capability.
+#  
+#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials are licensed and made available under
+#  the terms and conditions of the BSD License that accompanies this distribution.
+#  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#  
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BmpImageDecoderLib
+  FILE_GUID                      = DF414223-F17C-4022-A1F4-4062612AB00D
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = NULL|DXE_DRIVER UEFI_APPLICATION
+  CONSTRUCTOR                    = BmpImageDecoderLibConstructor
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  BmpImageDecoderLib.c
+  
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  MemoryAllocationLib
+  BaseMemoryLib
+  DebugLib
+  ImageDecoderLib
\ No newline at end of file
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index a57c7ebdebd9..e15782044018 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -278,6 +278,7 @@
   MdeModulePkg/Library/UefiBootManagerLib/UefiBootManagerLib.inf
   MdeModulePkg/Library/PlatformBootManagerLibNull/PlatformBootManagerLibNull.inf
   MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
+  MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
   MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
   MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf
   MdeModulePkg/Library/VarCheckLib/VarCheckLib.inf

From 0d56f058ed2ae43f997425d4902e9250693102f9 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:53:30 +0000
Subject: [PATCH 148/525] MdeModulePkg: Add BootLogoLib to provide interfaces
 about logo display.

(Sync patch r18772 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18882 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Library/BootLogoLib.h    |  82 +++
 .../Library/BootLogoLib/BootLogoLib.c         | 584 ++++++++++++++++++
 .../Library/BootLogoLib/BootLogoLib.inf       |  59 ++
 MdeModulePkg/MdeModulePkg.dec                 |   4 +
 MdeModulePkg/MdeModulePkg.dsc                 |   1 +
 5 files changed, 730 insertions(+)
 create mode 100644 MdeModulePkg/Include/Library/BootLogoLib.h
 create mode 100644 MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
 create mode 100644 MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf

diff --git a/MdeModulePkg/Include/Library/BootLogoLib.h b/MdeModulePkg/Include/Library/BootLogoLib.h
new file mode 100644
index 000000000000..363740537107
--- /dev/null
+++ b/MdeModulePkg/Include/Library/BootLogoLib.h
@@ -0,0 +1,82 @@
+/** @file
+  This library is only intended to be used by PlatformBootManagerLib
+  to show progress bar and LOGO.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _BOOT_LOGO_LIB_H_
+#define _BOOT_LOGO_LIB_H_
+
+#include <Protocol/PlatformLogo.h>
+
+/**
+  Show LOGO on all consoles.
+
+  @param[in]  ImageFormat Format of the image file.
+  @param[in]  LogoFile    The file name of logo to display.
+  @param[in]  Attribute   The display attributes of the image returned.
+  @param[in]  CoordinateX The X coordinate of the image.
+  @param[in]  CoordinateY The Y coordinate of the image.
+
+  @retval EFI_SUCCESS     Logo was displayed.
+  @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
+**/
+EFI_STATUS
+EFIAPI
+BootLogoEnableLogo (
+  IN  IMAGE_FORMAT                          ImageFormat,
+  IN  EFI_GUID                              *Logo,
+  IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
+  IN  UINTN                                 CoordinateX,
+  IN  UINTN                                 CoordinateY
+  );
+
+
+/**
+  Use SystemTable ConOut to turn on video based Simple Text Out consoles. The 
+  Simple Text Out screens will now be synced up with all non-video output devices.
+
+  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
+
+**/
+EFI_STATUS
+EFIAPI
+BootLogoDisableLogo (
+  VOID
+  );
+
+/**
+
+  Update progress bar with title above it. It only works in Graphics mode.
+
+  @param TitleForeground Foreground color for Title.
+  @param TitleBackground Background color for Title.
+  @param Title           Title above progress bar.
+  @param ProgressColor   Progress bar color.
+  @param Progress        Progress (0-100)
+  @param PreviousValue   The previous value of the progress.
+
+  @retval  EFI_STATUS    Successly update the progress bar
+
+**/
+EFI_STATUS
+EFIAPI
+BootLogoUpdateProgress (
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
+  IN CHAR16                        *Title,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
+  IN UINTN                         Progress,
+  IN UINTN                         PreviousValue
+  );
+
+#endif
diff --git a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
new file mode 100644
index 000000000000..312adb04db42
--- /dev/null
+++ b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
@@ -0,0 +1,584 @@
+/** @file
+  This library is only intended to be used by PlatformBootManagerLib
+  to show progress bar and LOGO.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials are licensed and made available under
+the terms and conditions of the BSD License that accompanies this distribution.
+The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php.
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiDxe.h>
+#include <Protocol/SimpleTextOut.h>
+#include <Protocol/PlatformLogo.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Protocol/UgaDraw.h>
+#include <Protocol/BootLogo.h>
+#include <Library/BaseLib.h>
+#include <Library/UefiLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DxeServicesLib.h>
+#include <Library/PcdLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/DebugLib.h>
+#include <Library/ImageDecoderLib.h>
+
+/**
+  Show LOGO on all consoles.
+
+  @param[in]  ImageFormat Format of the image file.
+  @param[in]  LogoFile    The file name of logo to display.
+  @param[in]  Attribute   The display attributes of the image returned.
+  @param[in]  CoordinateX The X coordinate of the image.
+  @param[in]  CoordinateY The Y coordinate of the image.
+
+  @retval EFI_SUCCESS     Logo was displayed.
+  @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
+**/
+EFI_STATUS
+EFIAPI
+BootLogoEnableLogo (
+  IN  IMAGE_FORMAT                          ImageFormat,
+  IN  EFI_GUID                              *Logo,
+  IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
+  IN  UINTN                                 CoordinateX,
+  IN  UINTN                                 CoordinateY
+  )
+{
+  EFI_STATUS                    Status;
+  EDKII_PLATFORM_LOGO_PROTOCOL  *PlatformLogo;
+  UINT32                        SizeOfX;
+  UINT32                        SizeOfY;
+  INTN                          DestX;
+  INTN                          DestY;
+  UINT8                         *ImageData;
+  UINTN                         ImageSize;
+  UINTN                         BltSize;
+  UINT32                        Instance;
+  UINTN                         Height;
+  UINTN                         Width;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
+  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;
+  UINT32                        ColorDepth;
+  UINT32                        RefreshRate;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;
+  EFI_BOOT_LOGO_PROTOCOL        *BootLogo;
+  UINTN                         NumberOfLogos;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *LogoBlt;
+  UINTN                         LogoDestX;
+  UINTN                         LogoDestY;
+  UINTN                         LogoHeight;
+  UINTN                         LogoWidth;
+  UINTN                         NewDestX;
+  UINTN                         NewDestY;
+  UINTN                         NewHeight;
+  UINTN                         NewWidth;
+  UINTN                         BufferSize;
+
+  UgaDraw = NULL;
+  //
+  // Try to open GOP first
+  //
+  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
+  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
+    GraphicsOutput = NULL;
+    //
+    // Open GOP failed, try to open UGA
+    //
+    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
+    if (EFI_ERROR (Status)) {
+      UgaDraw = NULL;
+    }
+  }
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status  = gBS->LocateProtocol (&gEdkiiPlatformLogoProtocolGuid, NULL, (VOID **) &PlatformLogo);
+  if (EFI_ERROR (Status)) {
+    PlatformLogo = NULL;
+  }
+
+  if ((Logo == NULL) && (PlatformLogo == NULL)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Try to open Boot Logo Protocol.
+  //
+  Status = gBS->LocateProtocol (&gEfiBootLogoProtocolGuid, NULL, (VOID **) &BootLogo);
+  if (EFI_ERROR (Status)) {
+    BootLogo = NULL;
+  }
+
+  //
+  // Erase Cursor from screen
+  //
+  gST->ConOut->EnableCursor (gST->ConOut, FALSE);
+
+  if (GraphicsOutput != NULL) {
+    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
+    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
+
+  } else {
+    ASSERT (UgaDraw != NULL);
+    Status = UgaDraw->GetMode (UgaDraw, &SizeOfX, &SizeOfY, &ColorDepth, &RefreshRate);
+    if (EFI_ERROR (Status)) {
+      return EFI_UNSUPPORTED;
+    }
+  }
+
+  Blt = NULL;
+  NumberOfLogos = 0;
+  LogoDestX = 0;
+  LogoDestY = 0;
+  LogoHeight = 0;
+  LogoWidth = 0;
+  NewDestX = 0;
+  NewDestY = 0;
+  NewHeight = 0;
+  NewWidth = 0;
+  Instance = 0;
+  while (TRUE) {
+    ImageData = NULL;
+    ImageSize = 0;
+
+    if (PlatformLogo != NULL) {
+      //
+      // Get image from OEMBadging protocol.
+      //
+      Status = PlatformLogo->GetImage (
+                               PlatformLogo,
+                               &Instance,
+                               &ImageFormat,
+                               &ImageData,
+                               &ImageSize,
+                               &Attribute,
+                               &CoordinateX,
+                               &CoordinateY
+                               );
+      if (EFI_ERROR (Status)) {
+        break;
+      }
+
+    } else {
+      //
+      // Get the specified image from FV.
+      //
+      Status = GetSectionFromAnyFv (Logo, EFI_SECTION_RAW, 0, (VOID **) &ImageData, &ImageSize);
+      if (EFI_ERROR (Status)) {
+        return EFI_UNSUPPORTED;
+      }
+    }
+
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+
+    Status = DecodeImage (ImageFormat, ImageData, ImageSize, &Blt, &BltSize, &Width, &Height);
+    FreePool (ImageData);
+    if (EFI_ERROR (Status)) {
+      if (Logo != NULL) {
+        //
+        // Directly return failure for single LOGO
+        //
+        return Status;
+      } else {
+        continue;
+      }
+    }
+
+    //
+    // Calculate the display position according to Attribute.
+    //
+    switch (Attribute) {
+    case EdkiiPlatformLogoDisplayAttributeLeftTop:
+      DestX = CoordinateX;
+      DestY = CoordinateY;
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeCenterTop:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = CoordinateY;
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeRightTop:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = CoordinateY;;
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeCenterRight:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeRightBottom:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeCenterBottom:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeLeftBottom:
+      DestX = CoordinateX;
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeCenterLeft:
+      DestX = CoordinateX;
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    case EdkiiPlatformLogoDisplayAttributeCenter:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    default:
+      ASSERT (FALSE);
+      break;
+    }
+
+    if ((DestX >= 0) && (DestY >= 0)) {
+      if (GraphicsOutput != NULL) {
+        Status = GraphicsOutput->Blt (
+                                   GraphicsOutput,
+                                   Blt,
+                                   EfiBltBufferToVideo,
+                                   0,
+                                   0,
+                                   (UINTN) DestX,
+                                   (UINTN) DestY,
+                                   Width,
+                                   Height,
+                                   Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                                   );
+      } else {
+        ASSERT (UgaDraw != NULL);
+        Status = UgaDraw->Blt (
+                            UgaDraw,
+                            (EFI_UGA_PIXEL *) Blt,
+                            EfiUgaBltBufferToVideo,
+                            0,
+                            0,
+                            (UINTN) DestX,
+                            (UINTN) DestY,
+                            Width,
+                            Height,
+                            Width * sizeof (EFI_UGA_PIXEL)
+                            );
+      }
+
+      //
+      // Report displayed Logo information.
+      //
+      if (!EFI_ERROR (Status)) {
+        NumberOfLogos++;
+
+        if (LogoWidth == 0) {
+          //
+          // The first Logo.
+          //
+          LogoDestX = (UINTN) DestX;
+          LogoDestY = (UINTN) DestY;
+          LogoWidth = Width;
+          LogoHeight = Height;
+        } else {
+          //
+          // Merge new logo with old one.
+          //
+          NewDestX = MIN ((UINTN) DestX, LogoDestX);
+          NewDestY = MIN ((UINTN) DestY, LogoDestY);
+          NewWidth = MAX ((UINTN) DestX + Width, LogoDestX + LogoWidth) - NewDestX;
+          NewHeight = MAX ((UINTN) DestY + Height, LogoDestY + LogoHeight) - NewDestY;
+
+          LogoDestX = NewDestX;
+          LogoDestY = NewDestY;
+          LogoWidth = NewWidth;
+          LogoHeight = NewHeight;
+        }
+      }
+    }
+
+    if (PlatformLogo == NULL) {
+      break;
+    }
+  }
+
+  if (BootLogo == NULL || NumberOfLogos == 0) {
+    //
+    // No logo displayed.
+    //
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+
+    return Status;
+  }
+
+  //
+  // Advertise displayed Logo information.
+  //
+  if (NumberOfLogos == 1) {
+    //
+    // Only one logo displayed, use its Blt buffer directly for BootLogo protocol.
+    //
+    LogoBlt = Blt;
+    Status = EFI_SUCCESS;
+  } else {
+    //
+    // More than one Logo displayed, get merged BltBuffer using VideoToBuffer operation. 
+    //
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+
+    //
+    // Ensure the LogoHeight * LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
+    //
+    if (LogoHeight > MAX_UINTN / LogoWidth / sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)) {
+      return EFI_UNSUPPORTED;
+    }
+    BufferSize = LogoWidth * LogoHeight * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL);
+
+    LogoBlt = AllocatePool (BufferSize);
+    if (LogoBlt == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          LogoBlt,
+                          EfiBltVideoToBltBuffer,
+                          LogoDestX,
+                          LogoDestY,
+                          0,
+                          0,
+                          LogoWidth,
+                          LogoHeight,
+                          LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) LogoBlt,
+                          EfiUgaVideoToBltBuffer,
+                          LogoDestX,
+                          LogoDestY,
+                          0,
+                          0,
+                          LogoWidth,
+                          LogoHeight,
+                          LogoWidth * sizeof (EFI_UGA_PIXEL)
+                          );
+    }
+  }
+
+  if (!EFI_ERROR (Status)) {
+    BootLogo->SetBootLogo (BootLogo, LogoBlt, LogoDestX, LogoDestY, LogoWidth, LogoHeight);
+  }
+  FreePool (LogoBlt);
+
+  return Status;
+}
+
+/**
+  Use SystemTable Conout to turn on video based Simple Text Out consoles. The 
+  Simple Text Out screens will now be synced up with all non video output devices
+
+  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
+
+**/
+EFI_STATUS
+EFIAPI
+BootLogoDisableLogo (
+  VOID
+  )
+{
+
+  //
+  // Enable Cursor on Screen
+  //
+  gST->ConOut->EnableCursor (gST->ConOut, TRUE);
+  return EFI_SUCCESS;
+}
+
+
+/**
+
+  Update progress bar with title above it. It only works in Graphics mode.
+
+  @param TitleForeground Foreground color for Title.
+  @param TitleBackground Background color for Title.
+  @param Title           Title above progress bar.
+  @param ProgressColor   Progress bar color.
+  @param Progress        Progress (0-100)
+  @param PreviousValue   The previous value of the progress.
+
+  @retval  EFI_STATUS       Success update the progress bar
+
+**/
+EFI_STATUS
+EFIAPI
+BootLogoUpdateProgress (
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
+  IN CHAR16                        *Title,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
+  IN UINTN                         Progress,
+  IN UINTN                         PreviousValue
+  )
+{
+  EFI_STATUS                     Status;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL   *GraphicsOutput;
+  EFI_UGA_DRAW_PROTOCOL          *UgaDraw;
+  UINT32                         SizeOfX;
+  UINT32                         SizeOfY;
+  UINT32                         ColorDepth;
+  UINT32                         RefreshRate;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Color;
+  UINTN                          BlockHeight;
+  UINTN                          BlockWidth;
+  UINTN                          BlockNum;
+  UINTN                          PosX;
+  UINTN                          PosY;
+  UINTN                          Index;
+
+  if (Progress > 100) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  UgaDraw = NULL;
+  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
+  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
+    GraphicsOutput = NULL;
+
+    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
+    if (EFI_ERROR (Status)) {
+      UgaDraw = NULL;
+    }
+  }
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  SizeOfX = 0;
+  SizeOfY = 0;
+  if (GraphicsOutput != NULL) {
+    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
+    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
+  } else if (UgaDraw != NULL) {
+    Status = UgaDraw->GetMode (
+                        UgaDraw,
+                        &SizeOfX,
+                        &SizeOfY,
+                        &ColorDepth,
+                        &RefreshRate
+                        );
+    if (EFI_ERROR (Status)) {
+      return EFI_UNSUPPORTED;
+    }
+  } else {
+    return EFI_UNSUPPORTED;
+  }
+
+  BlockWidth  = SizeOfX / 100;
+  BlockHeight = SizeOfY / 50;
+
+  BlockNum    = Progress;
+
+  PosX        = 0;
+  PosY        = SizeOfY * 48 / 50;
+
+  if (BlockNum == 0) {
+    //
+    // Clear progress area
+    //
+    SetMem (&Color, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0x0);
+
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          &Color,
+                          EfiBltVideoFill,
+                          0,
+                          0,
+                          0,
+                          PosY - EFI_GLYPH_HEIGHT - 1,
+                          SizeOfX,
+                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
+                          SizeOfX * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) &Color,
+                          EfiUgaVideoFill,
+                          0,
+                          0,
+                          0,
+                          PosY - EFI_GLYPH_HEIGHT - 1,
+                          SizeOfX,
+                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
+                          SizeOfX * sizeof (EFI_UGA_PIXEL)
+                          );
+    } else {
+      return EFI_UNSUPPORTED;
+    }
+  }
+  //
+  // Show progress by drawing blocks
+  //
+  for (Index = PreviousValue; Index < BlockNum; Index++) {
+    PosX = Index * BlockWidth;
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          &ProgressColor,
+                          EfiBltVideoFill,
+                          0,
+                          0,
+                          PosX,
+                          PosY,
+                          BlockWidth - 1,
+                          BlockHeight,
+                          (BlockWidth) * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) &ProgressColor,
+                          EfiUgaVideoFill,
+                          0,
+                          0,
+                          PosX,
+                          PosY,
+                          BlockWidth - 1,
+                          BlockHeight,
+                          (BlockWidth) * sizeof (EFI_UGA_PIXEL)
+                          );
+    } else {
+      return EFI_UNSUPPORTED;
+    }
+  }
+
+  PrintXY (
+    (SizeOfX - StrLen (Title) * EFI_GLYPH_WIDTH) / 2,
+    PosY - EFI_GLYPH_HEIGHT - 1,
+    &TitleForeground,
+    &TitleBackground,
+    Title
+    );
+
+  return EFI_SUCCESS;
+}
diff --git a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
new file mode 100644
index 000000000000..51e68edfea7a
--- /dev/null
+++ b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
@@ -0,0 +1,59 @@
+## @file
+#  This library is only intended to be used by PlatformBootManagerLib
+#  to show progress bar and logo.
+#  
+#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials are licensed and made available under
+#  the terms and conditions of the BSD License that accompanies this distribution.
+#  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#  
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BootLogoLib
+  FILE_GUID                      = F5AE5B5C-42E8-4A9B-829D-5B631CD5367A
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = BootLogoLib|DXE_DRIVER UEFI_APPLICATION
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  BootLogoLib.c
+  
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  UefiBootServicesTableLib
+  MemoryAllocationLib
+  UefiLib
+  BaseMemoryLib
+  DebugLib
+  PrintLib
+  PcdLib
+  DxeServicesLib
+  ImageDecoderLib
+
+[Guids]
+
+[Protocols]
+  gEfiGraphicsOutputProtocolGuid                # PROTOCOL SOMETIMES_CONSUMES
+  gEfiUgaDrawProtocolGuid |PcdUgaConsumeSupport # PROTOCOL SOMETIMES_CONSUMES
+  gEfiBootLogoProtocolGuid                      # PROTOCOL SOMETIMES_CONSUMES  
+  gEfiUserManagerProtocolGuid                   # PROTOCOL CONSUMES
+  gEdkiiPlatformLogoProtocolGuid                # PROTOCOL CONSUMES
+
+[FeaturePcd]
+  gEfiMdePkgTokenSpaceGuid.PcdUgaConsumeSupport
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index c35f533adc9b..f00d6f030ad5 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -135,6 +135,10 @@
   #
   ImageDecoderLib|Include/Library/ImageDecoderLib.h
 
+  ## @libraryclass  Provides interfaces about logo display.
+  #
+  BootLogoLib|Include/Library/BootLogoLib.h
+
 [Guids]
   ## MdeModule package token space guid
   # Include/Guid/MdeModulePkgTokenSpace.h
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index e15782044018..b80be9d67619 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -278,6 +278,7 @@
   MdeModulePkg/Library/UefiBootManagerLib/UefiBootManagerLib.inf
   MdeModulePkg/Library/PlatformBootManagerLibNull/PlatformBootManagerLibNull.inf
   MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
+  MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
   MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
   MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
   MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf

From fd3eb25595fdd3e42d6a30b145261cc3aa5c8045 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:54:23 +0000
Subject: [PATCH 149/525] Nt32Pkg: Use BootLogoLib for logo and progress bar
 drawing.

(Sync patch r18773 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18883 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PlatformBootManagerLib/MemoryTest.c       | 833 +-----------------
 .../PlatformBootManager.c                     |   6 +-
 .../PlatformBootManager.h                     |   6 +-
 .../PlatformBootManagerLib.inf                |   2 +-
 Nt32Pkg/Nt32Pkg.dsc                           |   7 +-
 5 files changed, 14 insertions(+), 840 deletions(-)

diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c b/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
index 9f57466e8c18..93ecc7d88cf3 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
@@ -23,179 +23,6 @@ EFI_GUID       mPlatformBootManagerStringPackGuid = {
 //
 // BDS Platform Functions
 //
-/**
-
-  Show progress bar with title above it. It only works in Graphics mode.
-
-
-  @param TitleForeground Foreground color for Title.
-  @param TitleBackground Background color for Title.
-  @param Title           Title above progress bar.
-  @param ProgressColor   Progress bar color.
-  @param Progress        Progress (0-100)
-  @param PreviousValue   The previous value of the progress.
-
-  @retval  EFI_STATUS       Success update the progress bar
-
-**/
-EFI_STATUS
-PlatformBootManagerShowProgress (
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
-  IN CHAR16                        *Title,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
-  IN UINTN                         Progress,
-  IN UINTN                         PreviousValue
-  )
-{
-  EFI_STATUS                     Status;
-  EFI_GRAPHICS_OUTPUT_PROTOCOL   *GraphicsOutput;
-  EFI_UGA_DRAW_PROTOCOL          *UgaDraw;
-  UINT32                         SizeOfX;
-  UINT32                         SizeOfY;
-  UINT32                         ColorDepth;
-  UINT32                         RefreshRate;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Color;
-  UINTN                          BlockHeight;
-  UINTN                          BlockWidth;
-  UINTN                          BlockNum;
-  UINTN                          PosX;
-  UINTN                          PosY;
-  UINTN                          Index;
-
-  if (Progress > 100) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  UgaDraw = NULL;
-  Status = gBS->HandleProtocol (
-                  gST->ConsoleOutHandle,
-                  &gEfiGraphicsOutputProtocolGuid,
-                  (VOID **) &GraphicsOutput
-                  );
-  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
-    GraphicsOutput = NULL;
-
-    Status = gBS->HandleProtocol (
-                    gST->ConsoleOutHandle,
-                    &gEfiUgaDrawProtocolGuid,
-                    (VOID **) &UgaDraw
-                    );
-  }
-  if (EFI_ERROR (Status)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  SizeOfX = 0;
-  SizeOfY = 0;
-  if (GraphicsOutput != NULL) {
-    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
-    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
-  } else if (UgaDraw != NULL) {
-    Status = UgaDraw->GetMode (
-                        UgaDraw,
-                        &SizeOfX,
-                        &SizeOfY,
-                        &ColorDepth,
-                        &RefreshRate
-                        );
-    if (EFI_ERROR (Status)) {
-      return EFI_UNSUPPORTED;
-    }
-  } else {
-    return EFI_UNSUPPORTED;
-  }
-
-  BlockWidth  = SizeOfX / 100;
-  BlockHeight = SizeOfY / 50;
-
-  BlockNum    = Progress;
-
-  PosX        = 0;
-  PosY        = SizeOfY * 48 / 50;
-
-  if (BlockNum == 0) {
-    //
-    // Clear progress area
-    //
-    SetMem (&Color, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0x0);
-
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          &Color,
-                          EfiBltVideoFill,
-                          0,
-                          0,
-                          0,
-                          PosY - EFI_GLYPH_HEIGHT - 1,
-                          SizeOfX,
-                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
-                          SizeOfX * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) &Color,
-                          EfiUgaVideoFill,
-                          0,
-                          0,
-                          0,
-                          PosY - EFI_GLYPH_HEIGHT - 1,
-                          SizeOfX,
-                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
-                          SizeOfX * sizeof (EFI_UGA_PIXEL)
-                          );
-    } else {
-      return EFI_UNSUPPORTED;
-    }
-  }
-  //
-  // Show progress by drawing blocks
-  //
-  for (Index = PreviousValue; Index < BlockNum; Index++) {
-    PosX = Index * BlockWidth;
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          &ProgressColor,
-                          EfiBltVideoFill,
-                          0,
-                          0,
-                          PosX,
-                          PosY,
-                          BlockWidth - 1,
-                          BlockHeight,
-                          (BlockWidth) * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) &ProgressColor,
-                          EfiUgaVideoFill,
-                          0,
-                          0,
-                          PosX,
-                          PosY,
-                          BlockWidth - 1,
-                          BlockHeight,
-                          (BlockWidth) * sizeof (EFI_UGA_PIXEL)
-                          );
-    } else {
-      return EFI_UNSUPPORTED;
-    }
-  }
-
-  PrintXY (
-    (SizeOfX - StrLen (Title) * EFI_GLYPH_WIDTH) / 2,
-    PosY - EFI_GLYPH_HEIGHT - 1,
-    &TitleForeground,
-    &TitleBackground,
-    Title
-    );
-
-  return EFI_SUCCESS;
-}
 
 /**
   Perform the memory test base on the memory test intensive level,
@@ -346,7 +173,7 @@ PlatformBootManagerMemoryTest (
 
         TmpStr = HiiGetString (gStringPackHandle, STRING_TOKEN (STR_PERFORM_MEM_TEST), NULL);
         if (TmpStr != NULL) {
-          PlatformBootManagerShowProgress (
+          BootLogoUpdateProgress (
             Foreground,
             Background,
             TmpStr,
@@ -370,7 +197,7 @@ PlatformBootManagerMemoryTest (
           if (!FeaturePcdGet(PcdBootlogoOnlyEnable)) {
             TmpStr = HiiGetString (gStringPackHandle, STRING_TOKEN (STR_PERFORM_MEM_TEST), NULL);
             if (TmpStr != NULL) {
-              PlatformBootManagerShowProgress (
+              BootLogoUpdateProgress (
                 Foreground,
                 Background,
                 TmpStr,
@@ -414,7 +241,7 @@ PlatformBootManagerMemoryTest (
     }
 
     PrintXY (10, 10, NULL, NULL, StrTotalMemory);
-    PlatformBootManagerShowProgress (
+    BootLogoUpdateProgress (
       Foreground,
       Background,
       StrTotalMemory,
@@ -430,657 +257,3 @@ PlatformBootManagerMemoryTest (
   FreePool (Pos);
   return ReturnStatus;
 }
-
-/**
-  Convert a *.BMP graphics image to a GOP blt buffer. If a NULL Blt buffer
-  is passed in a GopBlt buffer will be allocated by this routine. If a GopBlt
-  buffer is passed in it will be used if it is big enough.
-
-  @param  BmpImage      Pointer to BMP file
-  @param  BmpImageSize  Number of bytes in BmpImage
-  @param  GopBlt        Buffer containing GOP version of BmpImage.
-  @param  GopBltSize    Size of GopBlt in bytes.
-  @param  PixelHeight   Height of GopBlt/BmpImage in pixels
-  @param  PixelWidth    Width of GopBlt/BmpImage in pixels
-
-  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
-  @retval EFI_UNSUPPORTED       BmpImage is not a valid *.BMP image
-  @retval EFI_BUFFER_TOO_SMALL  The passed in GopBlt buffer is not big enough.
-                                GopBltSize will contain the required size.
-  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
-
-**/
-EFI_STATUS
-PlatformBootManagerConvertBmpToGopBlt (
-  IN     VOID      *BmpImage,
-  IN     UINTN     BmpImageSize,
-  IN OUT VOID      **GopBlt,
-  IN OUT UINTN     *GopBltSize,
-     OUT UINTN     *PixelHeight,
-     OUT UINTN     *PixelWidth
-  )
-{
-  UINT8                         *Image;
-  UINT8                         *ImageHeader;
-  BMP_IMAGE_HEADER              *BmpHeader;
-  BMP_COLOR_MAP                 *BmpColorMap;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
-  UINT64                        BltBufferSize;
-  UINTN                         Index;
-  UINTN                         Height;
-  UINTN                         Width;
-  UINTN                         ImageIndex;
-  UINT32                        DataSizePerLine;
-  BOOLEAN                       IsAllocated;
-  UINT32                        ColorMapNum;
-
-  if (sizeof (BMP_IMAGE_HEADER) > BmpImageSize) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  BmpHeader = (BMP_IMAGE_HEADER *) BmpImage;
-
-  if (BmpHeader->CharB != 'B' || BmpHeader->CharM != 'M') {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Doesn't support compress.
-  //
-  if (BmpHeader->CompressionType != 0) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Only support BITMAPINFOHEADER format.
-  // BITMAPFILEHEADER + BITMAPINFOHEADER = BMP_IMAGE_HEADER
-  //
-  if (BmpHeader->HeaderSize != sizeof (BMP_IMAGE_HEADER) - OFFSET_OF(BMP_IMAGE_HEADER, HeaderSize)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // The data size in each line must be 4 byte alignment.
-  //
-  DataSizePerLine = ((BmpHeader->PixelWidth * BmpHeader->BitPerPixel + 31) >> 3) & (~0x3);
-  BltBufferSize = MultU64x32 (DataSizePerLine, BmpHeader->PixelHeight);
-  if (BltBufferSize > (UINT32) ~0) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  if ((BmpHeader->Size != BmpImageSize) || 
-      (BmpHeader->Size < BmpHeader->ImageOffset) ||
-      (BmpHeader->Size - BmpHeader->ImageOffset !=  BmpHeader->PixelHeight * DataSizePerLine)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  //
-  // Calculate Color Map offset in the image.
-  //
-  Image       = BmpImage;
-  BmpColorMap = (BMP_COLOR_MAP *) (Image + sizeof (BMP_IMAGE_HEADER));
-  if (BmpHeader->ImageOffset < sizeof (BMP_IMAGE_HEADER)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  if (BmpHeader->ImageOffset > sizeof (BMP_IMAGE_HEADER)) {
-    switch (BmpHeader->BitPerPixel) {
-      case 1:
-        ColorMapNum = 2;
-        break;
-      case 4:
-        ColorMapNum = 16;
-        break;
-      case 8:
-        ColorMapNum = 256;
-        break;
-      default:
-        ColorMapNum = 0;
-        break;
-      }
-    //
-    // BMP file may has padding data between the bmp header section and the bmp data section.
-    //
-    if (BmpHeader->ImageOffset - sizeof (BMP_IMAGE_HEADER) < sizeof (BMP_COLOR_MAP) * ColorMapNum) {
-      return EFI_INVALID_PARAMETER;
-    }
-  }
-
-  //
-  // Calculate graphics image data address in the image
-  //
-  Image         = ((UINT8 *) BmpImage) + BmpHeader->ImageOffset;
-  ImageHeader   = Image;
-
-  //
-  // Calculate the BltBuffer needed size.
-  //
-  BltBufferSize = MultU64x32 ((UINT64) BmpHeader->PixelWidth, BmpHeader->PixelHeight);
-  //
-  // Ensure the BltBufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
-  //
-  if (BltBufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
-    return EFI_UNSUPPORTED;
-  }
-  BltBufferSize = MultU64x32 (BltBufferSize, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
-
-  IsAllocated   = FALSE;
-  if (*GopBlt == NULL) {
-    //
-    // GopBlt is not allocated by caller.
-    //
-    *GopBltSize = (UINTN) BltBufferSize;
-    *GopBlt     = AllocatePool (*GopBltSize);
-    IsAllocated = TRUE;
-    if (*GopBlt == NULL) {
-      return EFI_OUT_OF_RESOURCES;
-    }
-  } else {
-    //
-    // GopBlt has been allocated by caller.
-    //
-    if (*GopBltSize < (UINTN) BltBufferSize) {
-      *GopBltSize = (UINTN) BltBufferSize;
-      return EFI_BUFFER_TOO_SMALL;
-    }
-  }
-
-  *PixelWidth   = BmpHeader->PixelWidth;
-  *PixelHeight  = BmpHeader->PixelHeight;
-
-  //
-  // Convert image from BMP to Blt buffer format
-  //
-  BltBuffer = *GopBlt;
-  for (Height = 0; Height < BmpHeader->PixelHeight; Height++) {
-    Blt = &BltBuffer[(BmpHeader->PixelHeight - Height - 1) * BmpHeader->PixelWidth];
-    for (Width = 0; Width < BmpHeader->PixelWidth; Width++, Image++, Blt++) {
-      switch (BmpHeader->BitPerPixel) {
-      case 1:
-        //
-        // Convert 1-bit (2 colors) BMP to 24-bit color
-        //
-        for (Index = 0; Index < 8 && Width < BmpHeader->PixelWidth; Index++) {
-          Blt->Red    = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Red;
-          Blt->Green  = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Green;
-          Blt->Blue   = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Blue;
-          Blt++;
-          Width++;
-        }
-
-        Blt--;
-        Width--;
-        break;
-
-      case 4:
-        //
-        // Convert 4-bit (16 colors) BMP Palette to 24-bit color
-        //
-        Index       = (*Image) >> 4;
-        Blt->Red    = BmpColorMap[Index].Red;
-        Blt->Green  = BmpColorMap[Index].Green;
-        Blt->Blue   = BmpColorMap[Index].Blue;
-        if (Width < (BmpHeader->PixelWidth - 1)) {
-          Blt++;
-          Width++;
-          Index       = (*Image) & 0x0f;
-          Blt->Red    = BmpColorMap[Index].Red;
-          Blt->Green  = BmpColorMap[Index].Green;
-          Blt->Blue   = BmpColorMap[Index].Blue;
-        }
-        break;
-
-      case 8:
-        //
-        // Convert 8-bit (256 colors) BMP Palette to 24-bit color
-        //
-        Blt->Red    = BmpColorMap[*Image].Red;
-        Blt->Green  = BmpColorMap[*Image].Green;
-        Blt->Blue   = BmpColorMap[*Image].Blue;
-        break;
-
-      case 24:
-        //
-        // It is 24-bit BMP.
-        //
-        Blt->Blue   = *Image++;
-        Blt->Green  = *Image++;
-        Blt->Red    = *Image;
-        break;
-
-      default:
-        //
-        // Other bit format BMP is not supported.
-        //
-        if (IsAllocated) {
-          FreePool (*GopBlt);
-          *GopBlt = NULL;
-        }
-        return EFI_UNSUPPORTED;
-        break;
-      };
-
-    }
-
-    ImageIndex = (UINTN) (Image - ImageHeader);
-    if ((ImageIndex % 4) != 0) {
-      //
-      // Bmp Image starts each row on a 32-bit boundary!
-      //
-      Image = Image + (4 - (ImageIndex % 4));
-    }
-  }
-
-  return EFI_SUCCESS;
-}
-
-/**
-  Use SystemTable Conout to stop video based Simple Text Out consoles from going
-  to the video device. Put up LogoFile on every video device that is a console.
-
-  @param[in]  LogoFile   File name of logo to display on the center of the screen.
-
-  @retval EFI_SUCCESS     ConsoleControl has been flipped to graphics and logo displayed.
-  @retval EFI_UNSUPPORTED Logo not found
-
-**/
-EFI_STATUS
-PlatformBootManagerEnableQuietBoot (
-  IN  EFI_GUID  *LogoFile
-  )
-{
-  EFI_STATUS                    Status;
-  EFI_OEM_BADGING_PROTOCOL      *Badging;
-  UINT32                        SizeOfX;
-  UINT32                        SizeOfY;
-  INTN                          DestX;
-  INTN                          DestY;
-  UINT8                         *ImageData;
-  UINTN                         ImageSize;
-  UINTN                         BltSize;
-  UINT32                        Instance;
-  EFI_BADGING_FORMAT            Format;
-  EFI_BADGING_DISPLAY_ATTRIBUTE Attribute;
-  UINTN                         CoordinateX;
-  UINTN                         CoordinateY;
-  UINTN                         Height;
-  UINTN                         Width;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
-  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;
-  UINT32                        ColorDepth;
-  UINT32                        RefreshRate;
-  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;
-  EFI_BOOT_LOGO_PROTOCOL        *BootLogo;
-  UINTN                         NumberOfLogos;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *LogoBlt;
-  UINTN                         LogoDestX;
-  UINTN                         LogoDestY;
-  UINTN                         LogoHeight;
-  UINTN                         LogoWidth;
-  UINTN                         NewDestX;
-  UINTN                         NewDestY;
-  UINTN                         NewHeight;
-  UINTN                         NewWidth;
-  UINT64                        BufferSize;
-
-  UgaDraw = NULL;
-  //
-  // Try to open GOP first
-  //
-  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
-  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
-    GraphicsOutput = NULL;
-    //
-    // Open GOP failed, try to open UGA
-    //
-    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
-  }
-  if (EFI_ERROR (Status)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Try to open Boot Logo Protocol.
-  //
-  BootLogo = NULL;
-  gBS->LocateProtocol (&gEfiBootLogoProtocolGuid, NULL, (VOID **) &BootLogo);
-
-  //
-  // Erase Cursor from screen
-  //
-  gST->ConOut->EnableCursor (gST->ConOut, FALSE);
-
-  Badging = NULL;
-  Status  = gBS->LocateProtocol (&gEfiOEMBadgingProtocolGuid, NULL, (VOID **) &Badging);
-
-  if (GraphicsOutput != NULL) {
-    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
-    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
-
-  } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
-    Status = UgaDraw->GetMode (UgaDraw, &SizeOfX, &SizeOfY, &ColorDepth, &RefreshRate);
-    if (EFI_ERROR (Status)) {
-      return EFI_UNSUPPORTED;
-    }
-  } else {
-    return EFI_UNSUPPORTED;
-  }
-
-  Blt = NULL;
-  NumberOfLogos = 0;
-  LogoDestX = 0;
-  LogoDestY = 0;
-  LogoHeight = 0;
-  LogoWidth = 0;
-  NewDestX = 0;
-  NewDestY = 0;
-  NewHeight = 0;
-  NewWidth = 0;
-  Instance = 0;
-  while (1) {
-    ImageData = NULL;
-    ImageSize = 0;
-
-    if (Badging != NULL) {
-      //
-      // Get image from OEMBadging protocol.
-      //
-      Status = Badging->GetImage (
-                          Badging,
-                          &Instance,
-                          &Format,
-                          &ImageData,
-                          &ImageSize,
-                          &Attribute,
-                          &CoordinateX,
-                          &CoordinateY
-                          );
-      if (EFI_ERROR (Status)) {
-        goto Done;
-      }
-
-      //
-      // Currently only support BMP format.
-      //
-      if (Format != EfiBadgingFormatBMP) {
-        if (ImageData != NULL) {
-          FreePool (ImageData);
-        }
-        continue;
-      }
-    } else {
-      //
-      // Get the specified image from FV.
-      //
-      Status = GetSectionFromAnyFv (LogoFile, EFI_SECTION_RAW, 0, (VOID **) &ImageData, &ImageSize);
-      if (EFI_ERROR (Status)) {
-        return EFI_UNSUPPORTED;
-      }
-
-      CoordinateX = 0;
-      CoordinateY = 0;
-      if (!FeaturePcdGet(PcdBootlogoOnlyEnable)) {
-        Attribute   = EfiBadgingDisplayAttributeCenter;
-      } else {
-        Attribute   = EfiBadgingDisplayAttributeCustomized;
-      } 
-    }
-
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-    Blt = NULL;
-    Status = PlatformBootManagerConvertBmpToGopBlt (
-              ImageData,
-              ImageSize,
-              (VOID **) &Blt,
-              &BltSize,
-              &Height,
-              &Width
-              );
-    if (EFI_ERROR (Status)) {
-      FreePool (ImageData);
-
-      if (Badging == NULL) {
-        return Status;
-      } else {
-        continue;
-      }
-    }
-
-    //
-    // Calculate the display position according to Attribute.
-    //
-    switch (Attribute) {
-    case EfiBadgingDisplayAttributeLeftTop:
-      DestX = CoordinateX;
-      DestY = CoordinateY;
-      break;
-
-    case EfiBadgingDisplayAttributeCenterTop:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = CoordinateY;
-      break;
-
-    case EfiBadgingDisplayAttributeRightTop:
-      DestX = (SizeOfX - Width - CoordinateX);
-      DestY = CoordinateY;;
-      break;
-
-    case EfiBadgingDisplayAttributeCenterRight:
-      DestX = (SizeOfX - Width - CoordinateX);
-      DestY = (SizeOfY - Height) / 2;
-      break;
-
-    case EfiBadgingDisplayAttributeRightBottom:
-      DestX = (SizeOfX - Width - CoordinateX);
-      DestY = (SizeOfY - Height - CoordinateY);
-      break;
-
-    case EfiBadgingDisplayAttributeCenterBottom:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = (SizeOfY - Height - CoordinateY);
-      break;
-
-    case EfiBadgingDisplayAttributeLeftBottom:
-      DestX = CoordinateX;
-      DestY = (SizeOfY - Height - CoordinateY);
-      break;
-
-    case EfiBadgingDisplayAttributeCenterLeft:
-      DestX = CoordinateX;
-      DestY = (SizeOfY - Height) / 2;
-      break;
-
-    case EfiBadgingDisplayAttributeCenter:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = (SizeOfY - Height) / 2;
-      break;
-
-    case EfiBadgingDisplayAttributeCustomized:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = ((SizeOfY * 382) / 1000) - Height / 2;
-      break;
-
-    default:
-      DestX = CoordinateX;
-      DestY = CoordinateY;
-      break;
-    }
-
-    if ((DestX >= 0) && (DestY >= 0)) {
-      if (GraphicsOutput != NULL) {
-        Status = GraphicsOutput->Blt (
-                            GraphicsOutput,
-                            Blt,
-                            EfiBltBufferToVideo,
-                            0,
-                            0,
-                            (UINTN) DestX,
-                            (UINTN) DestY,
-                            Width,
-                            Height,
-                            Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                            );
-      } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
-        Status = UgaDraw->Blt (
-                            UgaDraw,
-                            (EFI_UGA_PIXEL *) Blt,
-                            EfiUgaBltBufferToVideo,
-                            0,
-                            0,
-                            (UINTN) DestX,
-                            (UINTN) DestY,
-                            Width,
-                            Height,
-                            Width * sizeof (EFI_UGA_PIXEL)
-                            );
-      } else {
-        Status = EFI_UNSUPPORTED;
-      }
-
-      //
-      // Report displayed Logo information.
-      //
-      if (!EFI_ERROR (Status)) {
-        NumberOfLogos++;
-
-        if (LogoWidth == 0) {
-          //
-          // The first Logo.
-          //
-          LogoDestX = (UINTN) DestX;
-          LogoDestY = (UINTN) DestY;
-          LogoWidth = Width;
-          LogoHeight = Height;
-        } else {
-          //
-          // Merge new logo with old one.
-          //
-          NewDestX = MIN ((UINTN) DestX, LogoDestX);
-          NewDestY = MIN ((UINTN) DestY, LogoDestY);
-          NewWidth = MAX ((UINTN) DestX + Width, LogoDestX + LogoWidth) - NewDestX;
-          NewHeight = MAX ((UINTN) DestY + Height, LogoDestY + LogoHeight) - NewDestY;
-
-          LogoDestX = NewDestX;
-          LogoDestY = NewDestY;
-          LogoWidth = NewWidth;
-          LogoHeight = NewHeight;
-        }
-      }
-    }
-
-    FreePool (ImageData);
-
-    if (Badging == NULL) {
-      break;
-    }
-  }
-
-Done:
-  if (BootLogo == NULL || NumberOfLogos == 0) {
-    //
-    // No logo displayed.
-    //
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-
-    return Status;
-  }
-
-  //
-  // Advertise displayed Logo information.
-  //
-  if (NumberOfLogos == 1) {
-    //
-    // Only one logo displayed, use its Blt buffer directly for BootLogo protocol.
-    //
-    LogoBlt = Blt;
-    Status = EFI_SUCCESS;
-  } else {
-    //
-    // More than one Logo displayed, get merged BltBuffer using VideoToBuffer operation. 
-    //
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-
-    //
-    // Ensure the LogoHeight * LogoWidth doesn't overflow
-    //
-    if (LogoHeight > DivU64x64Remainder ((UINTN) ~0, LogoWidth, NULL)) {
-      return EFI_UNSUPPORTED;
-    }
-    BufferSize = MultU64x64 (LogoWidth, LogoHeight);
-
-    //
-    // Ensure the BufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
-    //
-    if (BufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
-      return EFI_UNSUPPORTED;
-    }
-
-    LogoBlt = AllocateZeroPool ((UINTN)BufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
-    if (LogoBlt == NULL) {
-      return EFI_OUT_OF_RESOURCES;
-    }
-
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          LogoBlt,
-                          EfiBltVideoToBltBuffer,
-                          LogoDestX,
-                          LogoDestY,
-                          0,
-                          0,
-                          LogoWidth,
-                          LogoHeight,
-                          LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) LogoBlt,
-                          EfiUgaVideoToBltBuffer,
-                          LogoDestX,
-                          LogoDestY,
-                          0,
-                          0,
-                          LogoWidth,
-                          LogoHeight,
-                          LogoWidth * sizeof (EFI_UGA_PIXEL)
-                          );
-    } else {
-      Status = EFI_UNSUPPORTED;
-    }
-  }
-
-  if (!EFI_ERROR (Status)) {
-    BootLogo->SetBootLogo (BootLogo, LogoBlt, LogoDestX, LogoDestY, LogoWidth, LogoHeight);
-  }
-  FreePool (LogoBlt);
-
-  return Status;
-}
-
-/**
-  Use SystemTable Conout to turn on video based Simple Text Out consoles. The 
-  Simple Text Out screens will now be synced up with all non video output devices
-
-  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
-
-**/
-EFI_STATUS
-PlatformBootManagerDisableQuietBoot (
-  VOID
-  )
-{
-  //
-  // Enable Cursor on Screen
-  //
-  gST->ConOut->EnableCursor (gST->ConOut, TRUE);
-  return EFI_SUCCESS;
-}
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
index e944105b3925..82f7647c7039 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
@@ -38,14 +38,14 @@ PlatformBootManagerDiagnostics (
   // from the graphic lib
   //
   if (QuietBoot) {
-    PlatformBootManagerEnableQuietBoot (PcdGetPtr(PcdLogoFile));
+    BootLogoEnableLogo (ImageFormatBmp, PcdGetPtr(PcdLogoFile), EdkiiPlatformLogoDisplayAttributeCenter, 0, 0);
 
     //
     // Perform system diagnostic
     //
     Status = PlatformBootManagerMemoryTest (MemoryTestLevel);
     if (EFI_ERROR (Status)) {
-      PlatformBootManagerDisableQuietBoot ();
+      BootLogoDisableLogo ();
     }
 
     return;
@@ -271,7 +271,7 @@ PlatformBootManagerWaitCallback (
   Black.Blue = Black.Green = Black.Red = Black.Reserved = 0;
   White.Blue = White.Green = White.Red = White.Reserved = 0xFF;
 
-  PlatformBootManagerShowProgress (
+  BootLogoUpdateProgress (
     White,
     Black,
     L"Start boot option",
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
index 7e0fae847fb6..e2c6681702fd 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
@@ -15,16 +15,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define _PLATFORM_BOOT_MANAGER_H
 
 #include <PiDxe.h>
-#include <IndustryStandard/Bmp.h>
 #include <Guid/WinNtSystemConfig.h>
 #include <Protocol/GenericMemoryTest.h>
 #include <Protocol/WinNtThunk.h>
 #include <Protocol/WinNtIo.h>
 #include <Protocol/LoadedImage.h>
-#include <Protocol/UgaDraw.h>
-#include <Protocol/GraphicsOutput.h>
-#include <Protocol/OEMBadging.h>
-#include <Protocol/BootLogo.h>
 
 #include <Library/DebugLib.h>
 #include <Library/BaseMemoryLib.h>
@@ -40,6 +35,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/HiiLib.h>
 #include <Library/PrintLib.h>
 #include <Library/DxeServicesLib.h>
+#include <Library/BootLogoLib.h>
 
 
 typedef struct {
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
index 9b1eeaba02ed..71e8738a6a9d 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
@@ -52,6 +52,7 @@
   DevicePathLib
   HiiLib
   PrintLib
+  BootLogoLib
 
 [Guids]
   gEfiWinNtSystemConfigGuid
@@ -60,7 +61,6 @@
   gEfiGenericMemTestProtocolGuid  ## CONSUMES
   gEfiGraphicsOutputProtocolGuid  ## CONSUMES
   gEfiUgaDrawProtocolGuid         ## CONSUMES
-  gEfiOEMBadgingProtocolGuid      ## CONSUMES
   gEfiBootLogoProtocolGuid        ## CONSUMES
 
 [Pcd]
diff --git a/Nt32Pkg/Nt32Pkg.dsc b/Nt32Pkg/Nt32Pkg.dsc
index 21e1f69353bf..a9df9b11dc65 100644
--- a/Nt32Pkg/Nt32Pkg.dsc
+++ b/Nt32Pkg/Nt32Pkg.dsc
@@ -117,6 +117,8 @@
   TimerLib|MdePkg/Library/BaseTimerLibNullTemplate/BaseTimerLibNullTemplate.inf
   SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
   CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
+  ImageDecoderLib|MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
+  BootLogoLib|MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
   #
   # Platform
   #
@@ -440,7 +442,10 @@
   NetworkPkg/HttpDxe/HttpDxe.inf
   NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesDxe.inf
 
-  MdeModulePkg/Universal/BdsDxe/BdsDxe.inf
+  MdeModulePkg/Universal/BdsDxe/BdsDxe.inf {
+    <LibraryClasses>
+      NULL|MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
+  }
   MdeModulePkg/Application/UiApp/UiApp.inf
   MdeModulePkg/Universal/DriverHealthManagerDxe/DriverHealthManagerDxe.inf
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf

From d6ca0be1685b76bbe5d0ee507c6250f00bf435d5 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:55:06 +0000
Subject: [PATCH 150/525] MdeModulePkg/BmpImageDecoderLib: Support
 ImageFormatUnknown type

Enhance the library to handle unknown image format.

(Sync patch r18774 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18884 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
index 86dcc918c2c6..28afd4fa9a9b 100644
--- a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
+++ b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
@@ -65,7 +65,7 @@ BmpImageDecoderLibConvertBmpToGopBlt (
 
   ASSERT ((GopBlt != NULL) && (GopBltSize != NULL));
 
-  if (ImageFormat != ImageFormatBmp) {
+  if ((ImageFormat != ImageFormatBmp) && (ImageFormat != ImageFormatUnknown)) {
     return EFI_UNSUPPORTED;
   }
 

From 9688300b28a17aea7f392f9d0d31abdda2cd0998 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:56:06 +0000
Subject: [PATCH 151/525] MdeModulePkg: Change PlatformLogo.GetImage use INTN
 for minus value

The parameter name is also changed from Coordinate* to Offset* to
reflect that it's the offset to the location specified by Attribute.
For example, when the Attribute is Center, OffsetX and OffsetY are
used to specify the offset to the Center. OffsetX = 100 means
100 pixels right to the Center.

(Sync patch r18866 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18885 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Protocol/PlatformLogo.h | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Include/Protocol/PlatformLogo.h b/MdeModulePkg/Include/Protocol/PlatformLogo.h
index 9ac87f1748d3..8c1d3cad40f7 100644
--- a/MdeModulePkg/Include/Protocol/PlatformLogo.h
+++ b/MdeModulePkg/Include/Protocol/PlatformLogo.h
@@ -55,8 +55,8 @@ typedef enum {
                            supports the .bmp file format. 
   @param ImageSize         The size of the image returned.
   @param Attribute         The display attributes of the image returned.
-  @param CoordinateX       The X coordinate of the image.
-  @param CoordinateY       The Y coordinate of the image.
+  @param OffsetX           The X offset of the image regarding the Attribute.
+  @param OffsetY           The Y offset of the image regarding the Attribute.
 
   @retval EFI_SUCCESS      The image was fetched successfully.
   @retval EFI_NOT_FOUND    The specified image could not be found.
@@ -71,8 +71,8 @@ EFI_STATUS
      OUT UINT8                                 **ImageData,
      OUT UINTN                                 *ImageSize,
      OUT EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE *Attribute,
-     OUT UINTN                                 *CoordinateX,
-     OUT UINTN                                 *CoordinateY
+     OUT INTN                                  *OffsetX,
+     OUT INTN                                  *OffsetY
 );
 
 

From ca8497a5f7b79f25952945d9c5a13d5762c20f88 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 18 Nov 2015 08:56:57 +0000
Subject: [PATCH 152/525] MdeModulePkg: Change BootLogoEnableLogo use INTN for
 minus value

The parameter name is also changed from Coordinate* to Offset* to
reflect that it's the offset to the location specified by Attribute.
For example, when the Attribute is Center, OffsetX and OffsetY are
used to specify the offset to the Center. OffsetX = 100 means
100 pixels right to the Center.

(Sync patch r18867 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18886 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Library/BootLogoLib.h    |  8 +--
 .../Library/BootLogoLib/BootLogoLib.c         | 63 +++++++++----------
 2 files changed, 34 insertions(+), 37 deletions(-)

diff --git a/MdeModulePkg/Include/Library/BootLogoLib.h b/MdeModulePkg/Include/Library/BootLogoLib.h
index 363740537107..b39d61b7c3e5 100644
--- a/MdeModulePkg/Include/Library/BootLogoLib.h
+++ b/MdeModulePkg/Include/Library/BootLogoLib.h
@@ -24,8 +24,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param[in]  ImageFormat Format of the image file.
   @param[in]  LogoFile    The file name of logo to display.
   @param[in]  Attribute   The display attributes of the image returned.
-  @param[in]  CoordinateX The X coordinate of the image.
-  @param[in]  CoordinateY The Y coordinate of the image.
+  @param[in]  OffsetX     The X offset of the image regarding the Attribute.
+  @param[in]  OffsetY     The Y offset of the image regarding the Attribute.
 
   @retval EFI_SUCCESS     Logo was displayed.
   @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
@@ -36,8 +36,8 @@ BootLogoEnableLogo (
   IN  IMAGE_FORMAT                          ImageFormat,
   IN  EFI_GUID                              *Logo,
   IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
-  IN  UINTN                                 CoordinateX,
-  IN  UINTN                                 CoordinateY
+  IN  INTN                                  OffsetX,
+  IN  INTN                                  OffsetY
   );
 
 
diff --git a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
index 312adb04db42..f824ae13c286 100644
--- a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
+++ b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
@@ -35,8 +35,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   @param[in]  ImageFormat Format of the image file.
   @param[in]  LogoFile    The file name of logo to display.
   @param[in]  Attribute   The display attributes of the image returned.
-  @param[in]  CoordinateX The X coordinate of the image.
-  @param[in]  CoordinateY The Y coordinate of the image.
+  @param[in]  OffsetX     The X offset of the image regarding the Attribute.
+  @param[in]  OffsetY     The Y offset of the image regarding the Attribute.
 
   @retval EFI_SUCCESS     Logo was displayed.
   @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
@@ -47,8 +47,8 @@ BootLogoEnableLogo (
   IN  IMAGE_FORMAT                          ImageFormat,
   IN  EFI_GUID                              *Logo,
   IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
-  IN  UINTN                                 CoordinateX,
-  IN  UINTN                                 CoordinateY
+  IN  INTN                                  OffsetX,
+  IN  INTN                                  OffsetY
   )
 {
   EFI_STATUS                    Status;
@@ -160,8 +160,8 @@ BootLogoEnableLogo (
                                &ImageData,
                                &ImageSize,
                                &Attribute,
-                               &CoordinateX,
-                               &CoordinateY
+                               &OffsetX,
+                               &OffsetY
                                );
       if (EFI_ERROR (Status)) {
         break;
@@ -199,48 +199,42 @@ BootLogoEnableLogo (
     //
     switch (Attribute) {
     case EdkiiPlatformLogoDisplayAttributeLeftTop:
-      DestX = CoordinateX;
-      DestY = CoordinateY;
+      DestX = 0;
+      DestY = 0;
       break;
-
     case EdkiiPlatformLogoDisplayAttributeCenterTop:
       DestX = (SizeOfX - Width) / 2;
-      DestY = CoordinateY;
+      DestY = 0;
       break;
-
     case EdkiiPlatformLogoDisplayAttributeRightTop:
-      DestX = (SizeOfX - Width - CoordinateX);
-      DestY = CoordinateY;;
+      DestX = SizeOfX - Width;
+      DestY = 0;
       break;
 
-    case EdkiiPlatformLogoDisplayAttributeCenterRight:
-      DestX = (SizeOfX - Width - CoordinateX);
+    case EdkiiPlatformLogoDisplayAttributeCenterLeft:
+      DestX = 0;
       DestY = (SizeOfY - Height) / 2;
       break;
-
-    case EdkiiPlatformLogoDisplayAttributeRightBottom:
-      DestX = (SizeOfX - Width - CoordinateX);
-      DestY = (SizeOfY - Height - CoordinateY);
-      break;
-
-    case EdkiiPlatformLogoDisplayAttributeCenterBottom:
+    case EdkiiPlatformLogoDisplayAttributeCenter:
       DestX = (SizeOfX - Width) / 2;
-      DestY = (SizeOfY - Height - CoordinateY);
-      break;
-
-    case EdkiiPlatformLogoDisplayAttributeLeftBottom:
-      DestX = CoordinateX;
-      DestY = (SizeOfY - Height - CoordinateY);
+      DestY = (SizeOfY - Height) / 2;
       break;
-
-    case EdkiiPlatformLogoDisplayAttributeCenterLeft:
-      DestX = CoordinateX;
+    case EdkiiPlatformLogoDisplayAttributeCenterRight:
+      DestX = SizeOfX - Width;
       DestY = (SizeOfY - Height) / 2;
       break;
 
-    case EdkiiPlatformLogoDisplayAttributeCenter:
+    case EdkiiPlatformLogoDisplayAttributeLeftBottom:
+      DestX = 0;
+      DestY = SizeOfY - Height;
+      break;
+    case EdkiiPlatformLogoDisplayAttributeCenterBottom:
       DestX = (SizeOfX - Width) / 2;
-      DestY = (SizeOfY - Height) / 2;
+      DestY = SizeOfY - Height;
+      break;
+    case EdkiiPlatformLogoDisplayAttributeRightBottom:
+      DestX = SizeOfX - Width;
+      DestY = SizeOfY - Height;
       break;
 
     default:
@@ -248,6 +242,9 @@ BootLogoEnableLogo (
       break;
     }
 
+    DestX += OffsetX;
+    DestY += OffsetY;
+
     if ((DestX >= 0) && (DestY >= 0)) {
       if (GraphicsOutput != NULL) {
         Status = GraphicsOutput->Blt (

From 8021dff6657c6330d80e38c53c256cd96e43b35f Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 18 Nov 2015 13:06:17 +0000
Subject: [PATCH 153/525] External link to BaseTools Win binary r103(main trunk
 r18767)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18892 6f19259b-4bc3-4df7-8a09-765794883524

From 04d5cc639b207b0d3b9922acc7c669fffe25ef79 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Thu, 19 Nov 2015 02:32:03 +0000
Subject: [PATCH 154/525] MdeModulePkg PeiCore: PeiInstallPeiMemory improper
 ASSERT test on second call

The ASSERT (PrivateData->PeiMemoryInstalled) in if (PrivateData->PeiMemoryInstalled)
condition is useless, it should be ASSERT (FALSE) to follow the code's expectation.

(Sync patch r18887 from main trunk.)

Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18901 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Pei/Memory/MemoryServices.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Core/Pei/Memory/MemoryServices.c b/MdeModulePkg/Core/Pei/Memory/MemoryServices.c
index 36bdc73ebdc5..2f9b9dea3149 100644
--- a/MdeModulePkg/Core/Pei/Memory/MemoryServices.c
+++ b/MdeModulePkg/Core/Pei/Memory/MemoryServices.c
@@ -96,7 +96,7 @@ PeiInstallPeiMemory (
   // 
   if (PrivateData->PeiMemoryInstalled) {
     DEBUG ((EFI_D_ERROR, "ERROR: PeiInstallPeiMemory is called more than once!\n"));
-    ASSERT (PrivateData->PeiMemoryInstalled);
+    ASSERT (FALSE);
     return EFI_SUCCESS;
   }
   

From b324f3af6461691f004d2aac7727e59f9548b3ef Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 20 Nov 2015 03:11:40 +0000
Subject: [PATCH 155/525] Rollback the changes from r18879 - r18886.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18911 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Library/BootLogoLib.h    |  82 --
 .../Include/Library/ImageDecoderLib.h         |  76 --
 MdeModulePkg/Include/Protocol/PlatformLogo.h  |  86 --
 .../BmpImageDecoderLib/BmpImageDecoderLib.c   | 272 ------
 .../BmpImageDecoderLib/BmpImageDecoderLib.inf |  42 -
 .../Library/BootLogoLib/BootLogoLib.c         | 581 ------------
 .../Library/BootLogoLib/BootLogoLib.inf       |  59 --
 .../Library/ImageDecoderLib/ImageDecoderLib.c | 121 ---
 .../ImageDecoderLib/ImageDecoderLib.inf       |  42 -
 MdeModulePkg/MdeModulePkg.dec                 |  11 -
 MdeModulePkg/MdeModulePkg.dsc                 |   4 -
 .../PlatformBootManagerLib/MemoryTest.c       | 833 +++++++++++++++++-
 .../PlatformBootManager.c                     |   6 +-
 .../PlatformBootManager.h                     |   6 +-
 .../PlatformBootManagerLib.inf                |   2 +-
 Nt32Pkg/Nt32Pkg.dsc                           |   7 +-
 16 files changed, 840 insertions(+), 1390 deletions(-)
 delete mode 100644 MdeModulePkg/Include/Library/BootLogoLib.h
 delete mode 100644 MdeModulePkg/Include/Library/ImageDecoderLib.h
 delete mode 100644 MdeModulePkg/Include/Protocol/PlatformLogo.h
 delete mode 100644 MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
 delete mode 100644 MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
 delete mode 100644 MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
 delete mode 100644 MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
 delete mode 100644 MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
 delete mode 100644 MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf

diff --git a/MdeModulePkg/Include/Library/BootLogoLib.h b/MdeModulePkg/Include/Library/BootLogoLib.h
deleted file mode 100644
index b39d61b7c3e5..000000000000
--- a/MdeModulePkg/Include/Library/BootLogoLib.h
+++ /dev/null
@@ -1,82 +0,0 @@
-/** @file
-  This library is only intended to be used by PlatformBootManagerLib
-  to show progress bar and LOGO.
-
-Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under
-the terms and conditions of the BSD License that accompanies this distribution.
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#ifndef _BOOT_LOGO_LIB_H_
-#define _BOOT_LOGO_LIB_H_
-
-#include <Protocol/PlatformLogo.h>
-
-/**
-  Show LOGO on all consoles.
-
-  @param[in]  ImageFormat Format of the image file.
-  @param[in]  LogoFile    The file name of logo to display.
-  @param[in]  Attribute   The display attributes of the image returned.
-  @param[in]  OffsetX     The X offset of the image regarding the Attribute.
-  @param[in]  OffsetY     The Y offset of the image regarding the Attribute.
-
-  @retval EFI_SUCCESS     Logo was displayed.
-  @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
-**/
-EFI_STATUS
-EFIAPI
-BootLogoEnableLogo (
-  IN  IMAGE_FORMAT                          ImageFormat,
-  IN  EFI_GUID                              *Logo,
-  IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
-  IN  INTN                                  OffsetX,
-  IN  INTN                                  OffsetY
-  );
-
-
-/**
-  Use SystemTable ConOut to turn on video based Simple Text Out consoles. The 
-  Simple Text Out screens will now be synced up with all non-video output devices.
-
-  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
-
-**/
-EFI_STATUS
-EFIAPI
-BootLogoDisableLogo (
-  VOID
-  );
-
-/**
-
-  Update progress bar with title above it. It only works in Graphics mode.
-
-  @param TitleForeground Foreground color for Title.
-  @param TitleBackground Background color for Title.
-  @param Title           Title above progress bar.
-  @param ProgressColor   Progress bar color.
-  @param Progress        Progress (0-100)
-  @param PreviousValue   The previous value of the progress.
-
-  @retval  EFI_STATUS    Successly update the progress bar
-
-**/
-EFI_STATUS
-EFIAPI
-BootLogoUpdateProgress (
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
-  IN CHAR16                        *Title,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
-  IN UINTN                         Progress,
-  IN UINTN                         PreviousValue
-  );
-
-#endif
diff --git a/MdeModulePkg/Include/Library/ImageDecoderLib.h b/MdeModulePkg/Include/Library/ImageDecoderLib.h
deleted file mode 100644
index 928a09483aea..000000000000
--- a/MdeModulePkg/Include/Library/ImageDecoderLib.h
+++ /dev/null
@@ -1,76 +0,0 @@
-/** @file
-  This library provides image decoding service by managing the different
-  image decoding libraries.
-
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under
-the terms and conditions of the BSD License that accompanies this distribution.
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-#ifndef __IMAGE_DECODER_LIB_H__
-#define __IMAGE_DECODER_LIB_H__
-#include <Protocol/PlatformLogo.h>
-
-typedef
-EFI_STATUS
-(EFIAPI *DECODE_IMAGE)(
-  IN  IMAGE_FORMAT                  ImageFormat,
-  IN  UINT8                         *Image,
-  IN  UINTN                         ImageSize,
-  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
-  OUT UINTN                         *GopBltSize,
-  OUT UINTN                         *PixelWidth,
-  OUT UINTN                         *PixelHeight
-  );
-
-/**
-  Convert a graphics image to a callee allocated GOP blt buffer.
-
-  @param  ImageFormat   Format of the image file.
-  @param  Image         Pointer to image file.
-  @param  ImageSize     Number of bytes in Image.
-  @param  GopBlt        Buffer containing GOP version of Image.
-  @param  GopBltSize    Size of GopBlt in bytes.
-  @param  PixelWidth    Width of GopBlt/Image in pixels.
-  @param  PixelHeight   Height of GopBlt/Image in pixels.
-
-  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
-  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
-  @retval EFI_INVALID_PARAMETER Image is NULL or ImageSize is 0.
-  @retval EFI_UNSUPPORTED       Image is not supported.
-  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
-
-**/
-EFI_STATUS
-EFIAPI
-DecodeImage (
-  IN  IMAGE_FORMAT                  ImageFormat,
-  IN  UINT8                         *Image,
-  IN  UINTN                         ImageSize,
-  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
-  OUT UINTN                         *GopBltSize,
-  OUT UINTN                         *PixelWidth,
-  OUT UINTN                         *PixelHeight
-  );
-
-/**
-  Register an image decoder.
-
-  @param Decoder  An image decoder.
-
-  @retval EFI_SUCCESS          The decoder was successfully registered.
-  @retval EFI_OUT_OF_RESOURCES No enough resource to register the decoder.
-
-**/
-EFI_STATUS
-EFIAPI
-RegisterImageDecoder (
-  IN  DECODE_IMAGE     Decoder
-  );
-
-#endif
diff --git a/MdeModulePkg/Include/Protocol/PlatformLogo.h b/MdeModulePkg/Include/Protocol/PlatformLogo.h
deleted file mode 100644
index 8c1d3cad40f7..000000000000
--- a/MdeModulePkg/Include/Protocol/PlatformLogo.h
+++ /dev/null
@@ -1,86 +0,0 @@
-/** @file
-  The Platform Logo Protocol defines the interface to get the Platform logo
-  image with the display attribute.
-
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under 
-the terms and conditions of the BSD License that accompanies this distribution.  
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.                                          
-    
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#ifndef __PLATFORM_LOGO_H__
-#define __PLATFORM_LOGO_H__
-
-//
-// GUID for EDKII Platform Logo Protocol
-//
-#define EDKII_PLATFORM_LOGO_PROTOCOL_GUID \
-  { 0x9b517978, 0xeba1, 0x44e7, { 0xba, 0x65, 0x7c, 0x2c, 0xd0, 0x8b, 0xf8, 0xe9 } }
-
-typedef struct _EDKII_PLATFORM_LOGO_PROTOCOL EDKII_PLATFORM_LOGO_PROTOCOL;
-
-typedef enum {
-  ImageFormatUnknown,
-  ImageFormatBmp,
-  ImageFormatJpeg,
-  ImageFormatTiff,
-  ImageFormatGif
-} IMAGE_FORMAT;
-
-typedef enum {
-  EdkiiPlatformLogoDisplayAttributeLeftTop,
-  EdkiiPlatformLogoDisplayAttributeCenterTop,
-  EdkiiPlatformLogoDisplayAttributeRightTop,
-  EdkiiPlatformLogoDisplayAttributeCenterRight,
-  EdkiiPlatformLogoDisplayAttributeRightBottom,
-  EdkiiPlatformLogoDisplayAttributeCenterBottom,
-  EdkiiPlatformLogoDisplayAttributeLeftBottom,
-  EdkiiPlatformLogoDisplayAttributeCenterLeft,
-  EdkiiPlatformLogoDisplayAttributeCenter
-} EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE;
-
-/**
-
-  Load a platform logo image and return its data and attributes.
-
-  @param This              The pointer to this protocol instance.
-  @param Instance          The visible image instance is found.
-  @param Format            The format of the image. Examples: BMP, JPEG.
-  @param ImageData         The image data for the badge file. Currently only 
-                           supports the .bmp file format. 
-  @param ImageSize         The size of the image returned.
-  @param Attribute         The display attributes of the image returned.
-  @param OffsetX           The X offset of the image regarding the Attribute.
-  @param OffsetY           The Y offset of the image regarding the Attribute.
-
-  @retval EFI_SUCCESS      The image was fetched successfully.
-  @retval EFI_NOT_FOUND    The specified image could not be found.
-
-**/
-typedef
-EFI_STATUS
-(EFIAPI *EDKII_PLATFORM_LOGO_GET_IMAGE)(
-  IN     EDKII_PLATFORM_LOGO_PROTOCOL          *This,
-  IN OUT UINT32                                *Instance,
-     OUT IMAGE_FORMAT                          *Format,
-     OUT UINT8                                 **ImageData,
-     OUT UINTN                                 *ImageSize,
-     OUT EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE *Attribute,
-     OUT INTN                                  *OffsetX,
-     OUT INTN                                  *OffsetY
-);
-
-
-struct _EDKII_PLATFORM_LOGO_PROTOCOL {
-  EDKII_PLATFORM_LOGO_GET_IMAGE GetImage;
-};
-
-
-extern EFI_GUID gEdkiiPlatformLogoProtocolGuid;
-
-#endif
diff --git a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
deleted file mode 100644
index 28afd4fa9a9b..000000000000
--- a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.c
+++ /dev/null
@@ -1,272 +0,0 @@
-/** @file
-  This library provides BMP image decoding capability.
-
-Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under
-the terms and conditions of the BSD License that accompanies this distribution.
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Uefi.h>
-#include <IndustryStandard/Bmp.h>
-#include <Protocol/GraphicsOutput.h>
-#include <Library/BaseLib.h>
-#include <Library/MemoryAllocationLib.h>
-#include <Library/DebugLib.h>
-#include <Library/ImageDecoderLib.h>
-
-/**
-  Convert a *.BMP graphics image to a callee allocated GOP blt buffer.
-
-  @param  ImageFormat   Format of the image file.
-  @param  BmpImage      Pointer to BMP file
-  @param  BmpImageSize  Number of bytes in BmpImage
-  @param  GopBlt        Buffer containing GOP version of BmpImage.
-  @param  GopBltSize    Size of GopBlt in bytes.
-  @param  PixelHeight   Height of GopBlt/BmpImage in pixels
-  @param  PixelWidth    Width of GopBlt/BmpImage in pixels
-
-  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
-  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
-  @retval EFI_UNSUPPORTED       BmpImage is not a valid *.BMP image
-  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
-
-**/
-EFI_STATUS
-EFIAPI
-BmpImageDecoderLibConvertBmpToGopBlt (
-  IN  IMAGE_FORMAT                  ImageFormat,
-  IN  UINT8                         *BmpImage,
-  IN  UINTN                         BmpImageSize,
-  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
-  OUT UINTN                         *GopBltSize,
-  OUT UINTN                         *PixelWidth,
-  OUT UINTN                         *PixelHeight
-  )
-{
-  UINT8                         *Image;
-  UINT8                         *ImageHeader;
-  BMP_IMAGE_HEADER              *BmpHeader;
-  BMP_COLOR_MAP                 *BmpColorMap;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
-  UINT64                        BltBufferSize;
-  UINTN                         Index;
-  UINTN                         Height;
-  UINTN                         Width;
-  UINTN                         ImageIndex;
-  UINT32                        DataSizePerLine;
-  UINT32                        ColorMapNum;
-
-  ASSERT ((GopBlt != NULL) && (GopBltSize != NULL));
-
-  if ((ImageFormat != ImageFormatBmp) && (ImageFormat != ImageFormatUnknown)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  if (sizeof (BMP_IMAGE_HEADER) > BmpImageSize) {
-    return EFI_UNSUPPORTED;
-  }
-
-  BmpHeader = (BMP_IMAGE_HEADER *) BmpImage;
-
-  if (BmpHeader->CharB != 'B' || BmpHeader->CharM != 'M') {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Doesn't support compress.
-  //
-  if (BmpHeader->CompressionType != 0) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Only support BITMAPINFOHEADER format.
-  // BITMAPFILEHEADER + BITMAPINFOHEADER = BMP_IMAGE_HEADER
-  //
-  if (BmpHeader->HeaderSize != sizeof (BMP_IMAGE_HEADER) - OFFSET_OF(BMP_IMAGE_HEADER, HeaderSize)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // The data size in each line must be 4 byte alignment.
-  //
-  DataSizePerLine = ((BmpHeader->PixelWidth * BmpHeader->BitPerPixel + 31) >> 3) & (~0x3);
-  BltBufferSize = MultU64x32 (DataSizePerLine, BmpHeader->PixelHeight);
-  if (BltBufferSize > (UINT32) ~0) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  if ((BmpHeader->Size != BmpImageSize) || 
-      (BmpHeader->Size < BmpHeader->ImageOffset) ||
-      (BmpHeader->Size - BmpHeader->ImageOffset !=  BmpHeader->PixelHeight * DataSizePerLine)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  //
-  // Calculate Color Map offset in the image.
-  //
-  Image       = BmpImage;
-  BmpColorMap = (BMP_COLOR_MAP *) (Image + sizeof (BMP_IMAGE_HEADER));
-  if (BmpHeader->ImageOffset < sizeof (BMP_IMAGE_HEADER)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  if (BmpHeader->ImageOffset > sizeof (BMP_IMAGE_HEADER)) {
-    switch (BmpHeader->BitPerPixel) {
-      case 1:
-        ColorMapNum = 2;
-        break;
-      case 4:
-        ColorMapNum = 16;
-        break;
-      case 8:
-        ColorMapNum = 256;
-        break;
-      default:
-        ColorMapNum = 0;
-        break;
-      }
-    //
-    // BMP file may has padding data between the bmp header section and the bmp data section.
-    //
-    if (BmpHeader->ImageOffset - sizeof (BMP_IMAGE_HEADER) < sizeof (BMP_COLOR_MAP) * ColorMapNum) {
-      return EFI_INVALID_PARAMETER;
-    }
-  }
-
-  //
-  // Calculate graphics image data address in the image
-  //
-  Image         = ((UINT8 *) BmpImage) + BmpHeader->ImageOffset;
-  ImageHeader   = Image;
-
-  //
-  // Calculate the BltBuffer needed size.
-  //
-  BltBufferSize = MultU64x32 ((UINT64) BmpHeader->PixelWidth, BmpHeader->PixelHeight);
-  //
-  // Ensure the BltBufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
-  //
-  if (BltBufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
-    return EFI_UNSUPPORTED;
-  }
-  BltBufferSize = MultU64x32 (BltBufferSize, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
-
-  *GopBltSize = (UINTN) BltBufferSize;
-  *GopBlt     = AllocatePool (*GopBltSize);
-  if (*GopBlt == NULL) {
-    return EFI_OUT_OF_RESOURCES;
-  }
-
-  *PixelWidth   = BmpHeader->PixelWidth;
-  *PixelHeight  = BmpHeader->PixelHeight;
-
-  //
-  // Convert image from BMP to Blt buffer format
-  //
-  BltBuffer = *GopBlt;
-  for (Height = 0; Height < BmpHeader->PixelHeight; Height++) {
-    Blt = &BltBuffer[(BmpHeader->PixelHeight - Height - 1) * BmpHeader->PixelWidth];
-    for (Width = 0; Width < BmpHeader->PixelWidth; Width++, Image++, Blt++) {
-      switch (BmpHeader->BitPerPixel) {
-      case 1:
-        //
-        // Convert 1-bit (2 colors) BMP to 24-bit color
-        //
-        for (Index = 0; Index < 8 && Width < BmpHeader->PixelWidth; Index++) {
-          Blt->Red    = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Red;
-          Blt->Green  = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Green;
-          Blt->Blue   = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Blue;
-          Blt++;
-          Width++;
-        }
-
-        Blt--;
-        Width--;
-        break;
-
-      case 4:
-        //
-        // Convert 4-bit (16 colors) BMP Palette to 24-bit color
-        //
-        Index       = (*Image) >> 4;
-        Blt->Red    = BmpColorMap[Index].Red;
-        Blt->Green  = BmpColorMap[Index].Green;
-        Blt->Blue   = BmpColorMap[Index].Blue;
-        if (Width < (BmpHeader->PixelWidth - 1)) {
-          Blt++;
-          Width++;
-          Index       = (*Image) & 0x0f;
-          Blt->Red    = BmpColorMap[Index].Red;
-          Blt->Green  = BmpColorMap[Index].Green;
-          Blt->Blue   = BmpColorMap[Index].Blue;
-        }
-        break;
-
-      case 8:
-        //
-        // Convert 8-bit (256 colors) BMP Palette to 24-bit color
-        //
-        Blt->Red    = BmpColorMap[*Image].Red;
-        Blt->Green  = BmpColorMap[*Image].Green;
-        Blt->Blue   = BmpColorMap[*Image].Blue;
-        break;
-
-      case 24:
-        //
-        // It is 24-bit BMP.
-        //
-        Blt->Blue   = *Image++;
-        Blt->Green  = *Image++;
-        Blt->Red    = *Image;
-        break;
-
-      default:
-        //
-        // Other bit format BMP is not supported.
-        //
-        return EFI_UNSUPPORTED;
-        break;
-      };
-
-    }
-
-    ImageIndex = (UINTN) (Image - ImageHeader);
-    if ((ImageIndex % 4) != 0) {
-      //
-      // Bmp Image starts each row on a 32-bit boundary!
-      //
-      Image = Image + (4 - (ImageIndex % 4));
-    }
-  }
-
-  return EFI_SUCCESS;
-}
-
-/**
-  Initialize BmpImageDecoderLib library.
-
-  @param ImageHandle     The image handle.
-  @param SystemTable     The system table.
-
-  @retval EFI_SUCCESS    The BmpImageDecoderLib library is initialized correctly.
-  @return Other value if failed to initialize the BmpImageDecoderLib library.
-**/
-EFI_STATUS
-EFIAPI
-BmpImageDecoderLibConstructor (
-  IN EFI_HANDLE                            ImageHandle,
-  IN EFI_SYSTEM_TABLE                      *SystemTable
-)
-{
-  RegisterImageDecoder (BmpImageDecoderLibConvertBmpToGopBlt);
-  return EFI_SUCCESS;
-}
-
diff --git a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf b/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
deleted file mode 100644
index 2d1c16084e39..000000000000
--- a/MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
+++ /dev/null
@@ -1,42 +0,0 @@
-## @file
-#  This library provides BMP image decoding capability.
-#  
-#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-#  This program and the accompanying materials are licensed and made available under
-#  the terms and conditions of the BSD License that accompanies this distribution.
-#  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php.
-#  
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#  
-##
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = BmpImageDecoderLib
-  FILE_GUID                      = DF414223-F17C-4022-A1F4-4062612AB00D
-  MODULE_TYPE                    = DXE_DRIVER
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = NULL|DXE_DRIVER UEFI_APPLICATION
-  CONSTRUCTOR                    = BmpImageDecoderLibConstructor
-
-#
-# The following information is for reference only and not required by the build tools.
-#
-#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
-#
-
-[Sources]
-  BmpImageDecoderLib.c
-  
-[Packages]
-  MdePkg/MdePkg.dec
-  MdeModulePkg/MdeModulePkg.dec
-
-[LibraryClasses]
-  BaseLib
-  MemoryAllocationLib
-  BaseMemoryLib
-  DebugLib
-  ImageDecoderLib
\ No newline at end of file
diff --git a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
deleted file mode 100644
index f824ae13c286..000000000000
--- a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.c
+++ /dev/null
@@ -1,581 +0,0 @@
-/** @file
-  This library is only intended to be used by PlatformBootManagerLib
-  to show progress bar and LOGO.
-
-Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under
-the terms and conditions of the BSD License that accompanies this distribution.
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <PiDxe.h>
-#include <Protocol/SimpleTextOut.h>
-#include <Protocol/PlatformLogo.h>
-#include <Protocol/GraphicsOutput.h>
-#include <Protocol/UgaDraw.h>
-#include <Protocol/BootLogo.h>
-#include <Library/BaseLib.h>
-#include <Library/UefiLib.h>
-#include <Library/BaseMemoryLib.h>
-#include <Library/UefiBootServicesTableLib.h>
-#include <Library/DxeServicesLib.h>
-#include <Library/PcdLib.h>
-#include <Library/MemoryAllocationLib.h>
-#include <Library/DebugLib.h>
-#include <Library/ImageDecoderLib.h>
-
-/**
-  Show LOGO on all consoles.
-
-  @param[in]  ImageFormat Format of the image file.
-  @param[in]  LogoFile    The file name of logo to display.
-  @param[in]  Attribute   The display attributes of the image returned.
-  @param[in]  OffsetX     The X offset of the image regarding the Attribute.
-  @param[in]  OffsetY     The Y offset of the image regarding the Attribute.
-
-  @retval EFI_SUCCESS     Logo was displayed.
-  @retval EFI_UNSUPPORTED Logo was not found or cannot be displayed.
-**/
-EFI_STATUS
-EFIAPI
-BootLogoEnableLogo (
-  IN  IMAGE_FORMAT                          ImageFormat,
-  IN  EFI_GUID                              *Logo,
-  IN  EDKII_PLATFORM_LOGO_DISPLAY_ATTRIBUTE Attribute,
-  IN  INTN                                  OffsetX,
-  IN  INTN                                  OffsetY
-  )
-{
-  EFI_STATUS                    Status;
-  EDKII_PLATFORM_LOGO_PROTOCOL  *PlatformLogo;
-  UINT32                        SizeOfX;
-  UINT32                        SizeOfY;
-  INTN                          DestX;
-  INTN                          DestY;
-  UINT8                         *ImageData;
-  UINTN                         ImageSize;
-  UINTN                         BltSize;
-  UINT32                        Instance;
-  UINTN                         Height;
-  UINTN                         Width;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
-  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;
-  UINT32                        ColorDepth;
-  UINT32                        RefreshRate;
-  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;
-  EFI_BOOT_LOGO_PROTOCOL        *BootLogo;
-  UINTN                         NumberOfLogos;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *LogoBlt;
-  UINTN                         LogoDestX;
-  UINTN                         LogoDestY;
-  UINTN                         LogoHeight;
-  UINTN                         LogoWidth;
-  UINTN                         NewDestX;
-  UINTN                         NewDestY;
-  UINTN                         NewHeight;
-  UINTN                         NewWidth;
-  UINTN                         BufferSize;
-
-  UgaDraw = NULL;
-  //
-  // Try to open GOP first
-  //
-  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
-  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
-    GraphicsOutput = NULL;
-    //
-    // Open GOP failed, try to open UGA
-    //
-    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
-    if (EFI_ERROR (Status)) {
-      UgaDraw = NULL;
-    }
-  }
-  if (EFI_ERROR (Status)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  Status  = gBS->LocateProtocol (&gEdkiiPlatformLogoProtocolGuid, NULL, (VOID **) &PlatformLogo);
-  if (EFI_ERROR (Status)) {
-    PlatformLogo = NULL;
-  }
-
-  if ((Logo == NULL) && (PlatformLogo == NULL)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  //
-  // Try to open Boot Logo Protocol.
-  //
-  Status = gBS->LocateProtocol (&gEfiBootLogoProtocolGuid, NULL, (VOID **) &BootLogo);
-  if (EFI_ERROR (Status)) {
-    BootLogo = NULL;
-  }
-
-  //
-  // Erase Cursor from screen
-  //
-  gST->ConOut->EnableCursor (gST->ConOut, FALSE);
-
-  if (GraphicsOutput != NULL) {
-    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
-    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
-
-  } else {
-    ASSERT (UgaDraw != NULL);
-    Status = UgaDraw->GetMode (UgaDraw, &SizeOfX, &SizeOfY, &ColorDepth, &RefreshRate);
-    if (EFI_ERROR (Status)) {
-      return EFI_UNSUPPORTED;
-    }
-  }
-
-  Blt = NULL;
-  NumberOfLogos = 0;
-  LogoDestX = 0;
-  LogoDestY = 0;
-  LogoHeight = 0;
-  LogoWidth = 0;
-  NewDestX = 0;
-  NewDestY = 0;
-  NewHeight = 0;
-  NewWidth = 0;
-  Instance = 0;
-  while (TRUE) {
-    ImageData = NULL;
-    ImageSize = 0;
-
-    if (PlatformLogo != NULL) {
-      //
-      // Get image from OEMBadging protocol.
-      //
-      Status = PlatformLogo->GetImage (
-                               PlatformLogo,
-                               &Instance,
-                               &ImageFormat,
-                               &ImageData,
-                               &ImageSize,
-                               &Attribute,
-                               &OffsetX,
-                               &OffsetY
-                               );
-      if (EFI_ERROR (Status)) {
-        break;
-      }
-
-    } else {
-      //
-      // Get the specified image from FV.
-      //
-      Status = GetSectionFromAnyFv (Logo, EFI_SECTION_RAW, 0, (VOID **) &ImageData, &ImageSize);
-      if (EFI_ERROR (Status)) {
-        return EFI_UNSUPPORTED;
-      }
-    }
-
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-
-    Status = DecodeImage (ImageFormat, ImageData, ImageSize, &Blt, &BltSize, &Width, &Height);
-    FreePool (ImageData);
-    if (EFI_ERROR (Status)) {
-      if (Logo != NULL) {
-        //
-        // Directly return failure for single LOGO
-        //
-        return Status;
-      } else {
-        continue;
-      }
-    }
-
-    //
-    // Calculate the display position according to Attribute.
-    //
-    switch (Attribute) {
-    case EdkiiPlatformLogoDisplayAttributeLeftTop:
-      DestX = 0;
-      DestY = 0;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeCenterTop:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = 0;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeRightTop:
-      DestX = SizeOfX - Width;
-      DestY = 0;
-      break;
-
-    case EdkiiPlatformLogoDisplayAttributeCenterLeft:
-      DestX = 0;
-      DestY = (SizeOfY - Height) / 2;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeCenter:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = (SizeOfY - Height) / 2;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeCenterRight:
-      DestX = SizeOfX - Width;
-      DestY = (SizeOfY - Height) / 2;
-      break;
-
-    case EdkiiPlatformLogoDisplayAttributeLeftBottom:
-      DestX = 0;
-      DestY = SizeOfY - Height;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeCenterBottom:
-      DestX = (SizeOfX - Width) / 2;
-      DestY = SizeOfY - Height;
-      break;
-    case EdkiiPlatformLogoDisplayAttributeRightBottom:
-      DestX = SizeOfX - Width;
-      DestY = SizeOfY - Height;
-      break;
-
-    default:
-      ASSERT (FALSE);
-      break;
-    }
-
-    DestX += OffsetX;
-    DestY += OffsetY;
-
-    if ((DestX >= 0) && (DestY >= 0)) {
-      if (GraphicsOutput != NULL) {
-        Status = GraphicsOutput->Blt (
-                                   GraphicsOutput,
-                                   Blt,
-                                   EfiBltBufferToVideo,
-                                   0,
-                                   0,
-                                   (UINTN) DestX,
-                                   (UINTN) DestY,
-                                   Width,
-                                   Height,
-                                   Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                                   );
-      } else {
-        ASSERT (UgaDraw != NULL);
-        Status = UgaDraw->Blt (
-                            UgaDraw,
-                            (EFI_UGA_PIXEL *) Blt,
-                            EfiUgaBltBufferToVideo,
-                            0,
-                            0,
-                            (UINTN) DestX,
-                            (UINTN) DestY,
-                            Width,
-                            Height,
-                            Width * sizeof (EFI_UGA_PIXEL)
-                            );
-      }
-
-      //
-      // Report displayed Logo information.
-      //
-      if (!EFI_ERROR (Status)) {
-        NumberOfLogos++;
-
-        if (LogoWidth == 0) {
-          //
-          // The first Logo.
-          //
-          LogoDestX = (UINTN) DestX;
-          LogoDestY = (UINTN) DestY;
-          LogoWidth = Width;
-          LogoHeight = Height;
-        } else {
-          //
-          // Merge new logo with old one.
-          //
-          NewDestX = MIN ((UINTN) DestX, LogoDestX);
-          NewDestY = MIN ((UINTN) DestY, LogoDestY);
-          NewWidth = MAX ((UINTN) DestX + Width, LogoDestX + LogoWidth) - NewDestX;
-          NewHeight = MAX ((UINTN) DestY + Height, LogoDestY + LogoHeight) - NewDestY;
-
-          LogoDestX = NewDestX;
-          LogoDestY = NewDestY;
-          LogoWidth = NewWidth;
-          LogoHeight = NewHeight;
-        }
-      }
-    }
-
-    if (PlatformLogo == NULL) {
-      break;
-    }
-  }
-
-  if (BootLogo == NULL || NumberOfLogos == 0) {
-    //
-    // No logo displayed.
-    //
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-
-    return Status;
-  }
-
-  //
-  // Advertise displayed Logo information.
-  //
-  if (NumberOfLogos == 1) {
-    //
-    // Only one logo displayed, use its Blt buffer directly for BootLogo protocol.
-    //
-    LogoBlt = Blt;
-    Status = EFI_SUCCESS;
-  } else {
-    //
-    // More than one Logo displayed, get merged BltBuffer using VideoToBuffer operation. 
-    //
-    if (Blt != NULL) {
-      FreePool (Blt);
-    }
-
-    //
-    // Ensure the LogoHeight * LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
-    //
-    if (LogoHeight > MAX_UINTN / LogoWidth / sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)) {
-      return EFI_UNSUPPORTED;
-    }
-    BufferSize = LogoWidth * LogoHeight * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL);
-
-    LogoBlt = AllocatePool (BufferSize);
-    if (LogoBlt == NULL) {
-      return EFI_OUT_OF_RESOURCES;
-    }
-
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          LogoBlt,
-                          EfiBltVideoToBltBuffer,
-                          LogoDestX,
-                          LogoDestY,
-                          0,
-                          0,
-                          LogoWidth,
-                          LogoHeight,
-                          LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) LogoBlt,
-                          EfiUgaVideoToBltBuffer,
-                          LogoDestX,
-                          LogoDestY,
-                          0,
-                          0,
-                          LogoWidth,
-                          LogoHeight,
-                          LogoWidth * sizeof (EFI_UGA_PIXEL)
-                          );
-    }
-  }
-
-  if (!EFI_ERROR (Status)) {
-    BootLogo->SetBootLogo (BootLogo, LogoBlt, LogoDestX, LogoDestY, LogoWidth, LogoHeight);
-  }
-  FreePool (LogoBlt);
-
-  return Status;
-}
-
-/**
-  Use SystemTable Conout to turn on video based Simple Text Out consoles. The 
-  Simple Text Out screens will now be synced up with all non video output devices
-
-  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
-
-**/
-EFI_STATUS
-EFIAPI
-BootLogoDisableLogo (
-  VOID
-  )
-{
-
-  //
-  // Enable Cursor on Screen
-  //
-  gST->ConOut->EnableCursor (gST->ConOut, TRUE);
-  return EFI_SUCCESS;
-}
-
-
-/**
-
-  Update progress bar with title above it. It only works in Graphics mode.
-
-  @param TitleForeground Foreground color for Title.
-  @param TitleBackground Background color for Title.
-  @param Title           Title above progress bar.
-  @param ProgressColor   Progress bar color.
-  @param Progress        Progress (0-100)
-  @param PreviousValue   The previous value of the progress.
-
-  @retval  EFI_STATUS       Success update the progress bar
-
-**/
-EFI_STATUS
-EFIAPI
-BootLogoUpdateProgress (
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
-  IN CHAR16                        *Title,
-  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
-  IN UINTN                         Progress,
-  IN UINTN                         PreviousValue
-  )
-{
-  EFI_STATUS                     Status;
-  EFI_GRAPHICS_OUTPUT_PROTOCOL   *GraphicsOutput;
-  EFI_UGA_DRAW_PROTOCOL          *UgaDraw;
-  UINT32                         SizeOfX;
-  UINT32                         SizeOfY;
-  UINT32                         ColorDepth;
-  UINT32                         RefreshRate;
-  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Color;
-  UINTN                          BlockHeight;
-  UINTN                          BlockWidth;
-  UINTN                          BlockNum;
-  UINTN                          PosX;
-  UINTN                          PosY;
-  UINTN                          Index;
-
-  if (Progress > 100) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  UgaDraw = NULL;
-  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
-  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
-    GraphicsOutput = NULL;
-
-    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
-    if (EFI_ERROR (Status)) {
-      UgaDraw = NULL;
-    }
-  }
-  if (EFI_ERROR (Status)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  SizeOfX = 0;
-  SizeOfY = 0;
-  if (GraphicsOutput != NULL) {
-    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
-    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
-  } else if (UgaDraw != NULL) {
-    Status = UgaDraw->GetMode (
-                        UgaDraw,
-                        &SizeOfX,
-                        &SizeOfY,
-                        &ColorDepth,
-                        &RefreshRate
-                        );
-    if (EFI_ERROR (Status)) {
-      return EFI_UNSUPPORTED;
-    }
-  } else {
-    return EFI_UNSUPPORTED;
-  }
-
-  BlockWidth  = SizeOfX / 100;
-  BlockHeight = SizeOfY / 50;
-
-  BlockNum    = Progress;
-
-  PosX        = 0;
-  PosY        = SizeOfY * 48 / 50;
-
-  if (BlockNum == 0) {
-    //
-    // Clear progress area
-    //
-    SetMem (&Color, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0x0);
-
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          &Color,
-                          EfiBltVideoFill,
-                          0,
-                          0,
-                          0,
-                          PosY - EFI_GLYPH_HEIGHT - 1,
-                          SizeOfX,
-                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
-                          SizeOfX * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) &Color,
-                          EfiUgaVideoFill,
-                          0,
-                          0,
-                          0,
-                          PosY - EFI_GLYPH_HEIGHT - 1,
-                          SizeOfX,
-                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
-                          SizeOfX * sizeof (EFI_UGA_PIXEL)
-                          );
-    } else {
-      return EFI_UNSUPPORTED;
-    }
-  }
-  //
-  // Show progress by drawing blocks
-  //
-  for (Index = PreviousValue; Index < BlockNum; Index++) {
-    PosX = Index * BlockWidth;
-    if (GraphicsOutput != NULL) {
-      Status = GraphicsOutput->Blt (
-                          GraphicsOutput,
-                          &ProgressColor,
-                          EfiBltVideoFill,
-                          0,
-                          0,
-                          PosX,
-                          PosY,
-                          BlockWidth - 1,
-                          BlockHeight,
-                          (BlockWidth) * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
-                          );
-    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
-      Status = UgaDraw->Blt (
-                          UgaDraw,
-                          (EFI_UGA_PIXEL *) &ProgressColor,
-                          EfiUgaVideoFill,
-                          0,
-                          0,
-                          PosX,
-                          PosY,
-                          BlockWidth - 1,
-                          BlockHeight,
-                          (BlockWidth) * sizeof (EFI_UGA_PIXEL)
-                          );
-    } else {
-      return EFI_UNSUPPORTED;
-    }
-  }
-
-  PrintXY (
-    (SizeOfX - StrLen (Title) * EFI_GLYPH_WIDTH) / 2,
-    PosY - EFI_GLYPH_HEIGHT - 1,
-    &TitleForeground,
-    &TitleBackground,
-    Title
-    );
-
-  return EFI_SUCCESS;
-}
diff --git a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf b/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
deleted file mode 100644
index 51e68edfea7a..000000000000
--- a/MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
+++ /dev/null
@@ -1,59 +0,0 @@
-## @file
-#  This library is only intended to be used by PlatformBootManagerLib
-#  to show progress bar and logo.
-#  
-#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-#  This program and the accompanying materials are licensed and made available under
-#  the terms and conditions of the BSD License that accompanies this distribution.
-#  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php.
-#  
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#  
-##
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = BootLogoLib
-  FILE_GUID                      = F5AE5B5C-42E8-4A9B-829D-5B631CD5367A
-  MODULE_TYPE                    = DXE_DRIVER
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = BootLogoLib|DXE_DRIVER UEFI_APPLICATION
-
-#
-# The following information is for reference only and not required by the build tools.
-#
-#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
-#
-
-[Sources]
-  BootLogoLib.c
-  
-[Packages]
-  MdePkg/MdePkg.dec
-  MdeModulePkg/MdeModulePkg.dec
-
-[LibraryClasses]
-  BaseLib
-  UefiBootServicesTableLib
-  MemoryAllocationLib
-  UefiLib
-  BaseMemoryLib
-  DebugLib
-  PrintLib
-  PcdLib
-  DxeServicesLib
-  ImageDecoderLib
-
-[Guids]
-
-[Protocols]
-  gEfiGraphicsOutputProtocolGuid                # PROTOCOL SOMETIMES_CONSUMES
-  gEfiUgaDrawProtocolGuid |PcdUgaConsumeSupport # PROTOCOL SOMETIMES_CONSUMES
-  gEfiBootLogoProtocolGuid                      # PROTOCOL SOMETIMES_CONSUMES  
-  gEfiUserManagerProtocolGuid                   # PROTOCOL CONSUMES
-  gEdkiiPlatformLogoProtocolGuid                # PROTOCOL CONSUMES
-
-[FeaturePcd]
-  gEfiMdePkgTokenSpaceGuid.PcdUgaConsumeSupport
diff --git a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
deleted file mode 100644
index 4a6219bbb138..000000000000
--- a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.c
+++ /dev/null
@@ -1,121 +0,0 @@
-/** @file
-  This library provides image decoding service by managing the different
-  image decoding libraries.
-
-Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials are licensed and made available under
-the terms and conditions of the BSD License that accompanies this distribution.
-The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php.
-
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Uefi.h>
-#include <Protocol/GraphicsOutput.h>
-#include <Library/ImageDecoderLib.h>
-#include <Library/BaseLib.h>
-#include <Library/MemoryAllocationLib.h>
-#include <Library/DebugLib.h>
-
-typedef struct {
-  UINT32       Signature;
-  DECODE_IMAGE Decoder;
-  LIST_ENTRY   Link;
-} IMAGE_DECODER_ENTRY;
-#define IMAGE_DECODER_ENTRY_SIGNATURE  SIGNATURE_32 ('i', 'm', 'g', 'd')
-#define IMAGE_DECODER_ENTRY_FROM_LINK(Link) \
-        CR (Link, IMAGE_DECODER_ENTRY, Link, IMAGE_DECODER_ENTRY_SIGNATURE)
-
-LIST_ENTRY mImageDecoderLibDecoders = INITIALIZE_LIST_HEAD_VARIABLE (mImageDecoderLibDecoders);
-
-/**
-  Convert a graphics image to a callee allocated GOP blt buffer.
-
-  @param  ImageFormat   Format of the image file.
-  @param  Image         Pointer to image file.
-  @param  ImageSize     Number of bytes in Image.
-  @param  GopBlt        Buffer containing GOP version of Image.
-  @param  GopBltSize    Size of GopBlt in bytes.
-  @param  PixelWidth    Width of GopBlt/Image in pixels.
-  @param  PixelHeight   Height of GopBlt/Image in pixels.
-
-  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
-  @retval EFI_INVALID_PARAMETER GopBlt or GopBltSize is NULL.
-  @retval EFI_INVALID_PARAMETER Image is NULL or ImageSize is 0.
-  @retval EFI_UNSUPPORTED       Image is not supported.
-  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
-
-**/
-EFI_STATUS
-EFIAPI
-DecodeImage (
-  IN  IMAGE_FORMAT                  ImageFormat,
-  IN  UINT8                         *Image,
-  IN  UINTN                         ImageSize,
-  OUT EFI_GRAPHICS_OUTPUT_BLT_PIXEL **GopBlt,
-  OUT UINTN                         *GopBltSize,
-  OUT UINTN                         *PixelWidth,
-  OUT UINTN                         *PixelHeight
-  )
-{
-  IMAGE_DECODER_ENTRY               *Entry;
-  LIST_ENTRY                        *Link;
-  EFI_STATUS                        Status;
-
-  if ((GopBlt == NULL) || (GopBltSize == NULL)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  if ((Image == NULL) || (ImageSize == 0)) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  for ( Link = GetFirstNode (&mImageDecoderLibDecoders)
-      ; !IsNull (&mImageDecoderLibDecoders, Link)
-      ; Link = GetNextNode (&mImageDecoderLibDecoders, Link)
-      ) {
-    Entry = IMAGE_DECODER_ENTRY_FROM_LINK (Link);
-    Status = Entry->Decoder (ImageFormat, Image, ImageSize, GopBlt, GopBltSize, PixelWidth, PixelHeight);
-    if (!EFI_ERROR (Status)) {
-      break;
-    }
-  }
-
-  if (IsNull (&mImageDecoderLibDecoders, Link)) {
-    return EFI_UNSUPPORTED;
-  } else {
-    return EFI_SUCCESS;
-  }
-}
-
-/**
-  Register an image decoder.
-
-  @param Decoder  An image decoder.
-
-  @retval EFI_SUCCESS          The decoder was successfully registered.
-  @retval EFI_OUT_OF_RESOURCES No enough resource to register the decoder.
-
-**/
-EFI_STATUS
-EFIAPI
-RegisterImageDecoder (
-  IN  DECODE_IMAGE     Decoder
-  )
-{
-  IMAGE_DECODER_ENTRY  *Entry;
-
-  Entry = AllocatePool (sizeof (IMAGE_DECODER_ENTRY));
-  if (Entry == NULL) {
-    return EFI_OUT_OF_RESOURCES;
-  }
-
-  Entry->Signature = IMAGE_DECODER_ENTRY_SIGNATURE;
-  Entry->Decoder   = Decoder;
-  InsertTailList (&mImageDecoderLibDecoders, &Entry->Link);
-
-  return EFI_SUCCESS;
-}
\ No newline at end of file
diff --git a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf b/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
deleted file mode 100644
index 5d2ee7b429b5..000000000000
--- a/MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
+++ /dev/null
@@ -1,42 +0,0 @@
-## @file
-#  This library provides image decoding service by managing the different
-#  image decoding libraries.
-#  
-#  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
-#  This program and the accompanying materials are licensed and made available under
-#  the terms and conditions of the BSD License that accompanies this distribution.
-#  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php.
-#  
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#  
-##
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = ImageDecoderLib
-  FILE_GUID                      = 5ACDA5F7-AE20-4A17-90C1-7D087F730202
-  MODULE_TYPE                    = DXE_DRIVER
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = ImageDecoderLib|DXE_DRIVER UEFI_APPLICATION
-
-#
-# The following information is for reference only and not required by the build tools.
-#
-#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
-#
-
-[Sources]
-  ImageDecoderLib.c
-  
-[Packages]
-  MdePkg/MdePkg.dec
-  MdeModulePkg/MdeModulePkg.dec
-
-[LibraryClasses]
-  BaseLib
-  MemoryAllocationLib
-  UefiLib
-  BaseMemoryLib
-  DebugLib
\ No newline at end of file
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index f00d6f030ad5..3dfcd6a77f64 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -131,14 +131,6 @@
   #
   PlatformVarCleanupLib|Include/Library/PlatformVarCleanupLib.h
 
-  ## @libraryclass  Provides image decoding service.
-  #
-  ImageDecoderLib|Include/Library/ImageDecoderLib.h
-
-  ## @libraryclass  Provides interfaces about logo display.
-  #
-  BootLogoLib|Include/Library/BootLogoLib.h
-
 [Guids]
   ## MdeModule package token space guid
   # Include/Guid/MdeModulePkgTokenSpace.h
@@ -457,9 +449,6 @@
   ## Include/Protocol/SmmReadyToBoot.h
   gEdkiiSmmReadyToBootProtocolGuid = { 0x6e057ecf, 0xfa99, 0x4f39, { 0x95, 0xbc, 0x59, 0xf9, 0x92, 0x1d, 0x17, 0xe4 } }
 
-  ## Include/Protocol/PlatformLogo.h
-  gEdkiiPlatformLogoProtocolGuid = { 0x9b517978, 0xeba1, 0x44e7, { 0xba, 0x65, 0x7c, 0x2c, 0xd0, 0x8b, 0xf8, 0xe9 } }
-
 #
 # [Error.gEfiMdeModulePkgTokenSpaceGuid]
 #   0x80000001 | Invalid value provided.
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index b80be9d67619..c43093260453 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -47,7 +47,6 @@
   PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
   SortLib|MdeModulePkg/Library/BaseSortLib/BaseSortLib.inf
-  ImageDecoderLib|MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
   #
   # UEFI & PI
   #
@@ -277,9 +276,6 @@
   MdeModulePkg/Library/PeiDxeDebugLibReportStatusCode/PeiDxeDebugLibReportStatusCode.inf
   MdeModulePkg/Library/UefiBootManagerLib/UefiBootManagerLib.inf
   MdeModulePkg/Library/PlatformBootManagerLibNull/PlatformBootManagerLibNull.inf
-  MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
-  MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
-  MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
   MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
   MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf
   MdeModulePkg/Library/VarCheckLib/VarCheckLib.inf
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c b/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
index 93ecc7d88cf3..9f57466e8c18 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/MemoryTest.c
@@ -23,6 +23,179 @@ EFI_GUID       mPlatformBootManagerStringPackGuid = {
 //
 // BDS Platform Functions
 //
+/**
+
+  Show progress bar with title above it. It only works in Graphics mode.
+
+
+  @param TitleForeground Foreground color for Title.
+  @param TitleBackground Background color for Title.
+  @param Title           Title above progress bar.
+  @param ProgressColor   Progress bar color.
+  @param Progress        Progress (0-100)
+  @param PreviousValue   The previous value of the progress.
+
+  @retval  EFI_STATUS       Success update the progress bar
+
+**/
+EFI_STATUS
+PlatformBootManagerShowProgress (
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleForeground,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL TitleBackground,
+  IN CHAR16                        *Title,
+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL ProgressColor,
+  IN UINTN                         Progress,
+  IN UINTN                         PreviousValue
+  )
+{
+  EFI_STATUS                     Status;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL   *GraphicsOutput;
+  EFI_UGA_DRAW_PROTOCOL          *UgaDraw;
+  UINT32                         SizeOfX;
+  UINT32                         SizeOfY;
+  UINT32                         ColorDepth;
+  UINT32                         RefreshRate;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL  Color;
+  UINTN                          BlockHeight;
+  UINTN                          BlockWidth;
+  UINTN                          BlockNum;
+  UINTN                          PosX;
+  UINTN                          PosY;
+  UINTN                          Index;
+
+  if (Progress > 100) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  UgaDraw = NULL;
+  Status = gBS->HandleProtocol (
+                  gST->ConsoleOutHandle,
+                  &gEfiGraphicsOutputProtocolGuid,
+                  (VOID **) &GraphicsOutput
+                  );
+  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
+    GraphicsOutput = NULL;
+
+    Status = gBS->HandleProtocol (
+                    gST->ConsoleOutHandle,
+                    &gEfiUgaDrawProtocolGuid,
+                    (VOID **) &UgaDraw
+                    );
+  }
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  SizeOfX = 0;
+  SizeOfY = 0;
+  if (GraphicsOutput != NULL) {
+    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
+    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
+  } else if (UgaDraw != NULL) {
+    Status = UgaDraw->GetMode (
+                        UgaDraw,
+                        &SizeOfX,
+                        &SizeOfY,
+                        &ColorDepth,
+                        &RefreshRate
+                        );
+    if (EFI_ERROR (Status)) {
+      return EFI_UNSUPPORTED;
+    }
+  } else {
+    return EFI_UNSUPPORTED;
+  }
+
+  BlockWidth  = SizeOfX / 100;
+  BlockHeight = SizeOfY / 50;
+
+  BlockNum    = Progress;
+
+  PosX        = 0;
+  PosY        = SizeOfY * 48 / 50;
+
+  if (BlockNum == 0) {
+    //
+    // Clear progress area
+    //
+    SetMem (&Color, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL), 0x0);
+
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          &Color,
+                          EfiBltVideoFill,
+                          0,
+                          0,
+                          0,
+                          PosY - EFI_GLYPH_HEIGHT - 1,
+                          SizeOfX,
+                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
+                          SizeOfX * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) &Color,
+                          EfiUgaVideoFill,
+                          0,
+                          0,
+                          0,
+                          PosY - EFI_GLYPH_HEIGHT - 1,
+                          SizeOfX,
+                          SizeOfY - (PosY - EFI_GLYPH_HEIGHT - 1),
+                          SizeOfX * sizeof (EFI_UGA_PIXEL)
+                          );
+    } else {
+      return EFI_UNSUPPORTED;
+    }
+  }
+  //
+  // Show progress by drawing blocks
+  //
+  for (Index = PreviousValue; Index < BlockNum; Index++) {
+    PosX = Index * BlockWidth;
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          &ProgressColor,
+                          EfiBltVideoFill,
+                          0,
+                          0,
+                          PosX,
+                          PosY,
+                          BlockWidth - 1,
+                          BlockHeight,
+                          (BlockWidth) * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) &ProgressColor,
+                          EfiUgaVideoFill,
+                          0,
+                          0,
+                          PosX,
+                          PosY,
+                          BlockWidth - 1,
+                          BlockHeight,
+                          (BlockWidth) * sizeof (EFI_UGA_PIXEL)
+                          );
+    } else {
+      return EFI_UNSUPPORTED;
+    }
+  }
+
+  PrintXY (
+    (SizeOfX - StrLen (Title) * EFI_GLYPH_WIDTH) / 2,
+    PosY - EFI_GLYPH_HEIGHT - 1,
+    &TitleForeground,
+    &TitleBackground,
+    Title
+    );
+
+  return EFI_SUCCESS;
+}
 
 /**
   Perform the memory test base on the memory test intensive level,
@@ -173,7 +346,7 @@ PlatformBootManagerMemoryTest (
 
         TmpStr = HiiGetString (gStringPackHandle, STRING_TOKEN (STR_PERFORM_MEM_TEST), NULL);
         if (TmpStr != NULL) {
-          BootLogoUpdateProgress (
+          PlatformBootManagerShowProgress (
             Foreground,
             Background,
             TmpStr,
@@ -197,7 +370,7 @@ PlatformBootManagerMemoryTest (
           if (!FeaturePcdGet(PcdBootlogoOnlyEnable)) {
             TmpStr = HiiGetString (gStringPackHandle, STRING_TOKEN (STR_PERFORM_MEM_TEST), NULL);
             if (TmpStr != NULL) {
-              BootLogoUpdateProgress (
+              PlatformBootManagerShowProgress (
                 Foreground,
                 Background,
                 TmpStr,
@@ -241,7 +414,7 @@ PlatformBootManagerMemoryTest (
     }
 
     PrintXY (10, 10, NULL, NULL, StrTotalMemory);
-    BootLogoUpdateProgress (
+    PlatformBootManagerShowProgress (
       Foreground,
       Background,
       StrTotalMemory,
@@ -257,3 +430,657 @@ PlatformBootManagerMemoryTest (
   FreePool (Pos);
   return ReturnStatus;
 }
+
+/**
+  Convert a *.BMP graphics image to a GOP blt buffer. If a NULL Blt buffer
+  is passed in a GopBlt buffer will be allocated by this routine. If a GopBlt
+  buffer is passed in it will be used if it is big enough.
+
+  @param  BmpImage      Pointer to BMP file
+  @param  BmpImageSize  Number of bytes in BmpImage
+  @param  GopBlt        Buffer containing GOP version of BmpImage.
+  @param  GopBltSize    Size of GopBlt in bytes.
+  @param  PixelHeight   Height of GopBlt/BmpImage in pixels
+  @param  PixelWidth    Width of GopBlt/BmpImage in pixels
+
+  @retval EFI_SUCCESS           GopBlt and GopBltSize are returned.
+  @retval EFI_UNSUPPORTED       BmpImage is not a valid *.BMP image
+  @retval EFI_BUFFER_TOO_SMALL  The passed in GopBlt buffer is not big enough.
+                                GopBltSize will contain the required size.
+  @retval EFI_OUT_OF_RESOURCES  No enough buffer to allocate.
+
+**/
+EFI_STATUS
+PlatformBootManagerConvertBmpToGopBlt (
+  IN     VOID      *BmpImage,
+  IN     UINTN     BmpImageSize,
+  IN OUT VOID      **GopBlt,
+  IN OUT UINTN     *GopBltSize,
+     OUT UINTN     *PixelHeight,
+     OUT UINTN     *PixelWidth
+  )
+{
+  UINT8                         *Image;
+  UINT8                         *ImageHeader;
+  BMP_IMAGE_HEADER              *BmpHeader;
+  BMP_COLOR_MAP                 *BmpColorMap;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *BltBuffer;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
+  UINT64                        BltBufferSize;
+  UINTN                         Index;
+  UINTN                         Height;
+  UINTN                         Width;
+  UINTN                         ImageIndex;
+  UINT32                        DataSizePerLine;
+  BOOLEAN                       IsAllocated;
+  UINT32                        ColorMapNum;
+
+  if (sizeof (BMP_IMAGE_HEADER) > BmpImageSize) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  BmpHeader = (BMP_IMAGE_HEADER *) BmpImage;
+
+  if (BmpHeader->CharB != 'B' || BmpHeader->CharM != 'M') {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Doesn't support compress.
+  //
+  if (BmpHeader->CompressionType != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Only support BITMAPINFOHEADER format.
+  // BITMAPFILEHEADER + BITMAPINFOHEADER = BMP_IMAGE_HEADER
+  //
+  if (BmpHeader->HeaderSize != sizeof (BMP_IMAGE_HEADER) - OFFSET_OF(BMP_IMAGE_HEADER, HeaderSize)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // The data size in each line must be 4 byte alignment.
+  //
+  DataSizePerLine = ((BmpHeader->PixelWidth * BmpHeader->BitPerPixel + 31) >> 3) & (~0x3);
+  BltBufferSize = MultU64x32 (DataSizePerLine, BmpHeader->PixelHeight);
+  if (BltBufferSize > (UINT32) ~0) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((BmpHeader->Size != BmpImageSize) || 
+      (BmpHeader->Size < BmpHeader->ImageOffset) ||
+      (BmpHeader->Size - BmpHeader->ImageOffset !=  BmpHeader->PixelHeight * DataSizePerLine)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Calculate Color Map offset in the image.
+  //
+  Image       = BmpImage;
+  BmpColorMap = (BMP_COLOR_MAP *) (Image + sizeof (BMP_IMAGE_HEADER));
+  if (BmpHeader->ImageOffset < sizeof (BMP_IMAGE_HEADER)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (BmpHeader->ImageOffset > sizeof (BMP_IMAGE_HEADER)) {
+    switch (BmpHeader->BitPerPixel) {
+      case 1:
+        ColorMapNum = 2;
+        break;
+      case 4:
+        ColorMapNum = 16;
+        break;
+      case 8:
+        ColorMapNum = 256;
+        break;
+      default:
+        ColorMapNum = 0;
+        break;
+      }
+    //
+    // BMP file may has padding data between the bmp header section and the bmp data section.
+    //
+    if (BmpHeader->ImageOffset - sizeof (BMP_IMAGE_HEADER) < sizeof (BMP_COLOR_MAP) * ColorMapNum) {
+      return EFI_INVALID_PARAMETER;
+    }
+  }
+
+  //
+  // Calculate graphics image data address in the image
+  //
+  Image         = ((UINT8 *) BmpImage) + BmpHeader->ImageOffset;
+  ImageHeader   = Image;
+
+  //
+  // Calculate the BltBuffer needed size.
+  //
+  BltBufferSize = MultU64x32 ((UINT64) BmpHeader->PixelWidth, BmpHeader->PixelHeight);
+  //
+  // Ensure the BltBufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
+  //
+  if (BltBufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
+    return EFI_UNSUPPORTED;
+  }
+  BltBufferSize = MultU64x32 (BltBufferSize, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
+
+  IsAllocated   = FALSE;
+  if (*GopBlt == NULL) {
+    //
+    // GopBlt is not allocated by caller.
+    //
+    *GopBltSize = (UINTN) BltBufferSize;
+    *GopBlt     = AllocatePool (*GopBltSize);
+    IsAllocated = TRUE;
+    if (*GopBlt == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+  } else {
+    //
+    // GopBlt has been allocated by caller.
+    //
+    if (*GopBltSize < (UINTN) BltBufferSize) {
+      *GopBltSize = (UINTN) BltBufferSize;
+      return EFI_BUFFER_TOO_SMALL;
+    }
+  }
+
+  *PixelWidth   = BmpHeader->PixelWidth;
+  *PixelHeight  = BmpHeader->PixelHeight;
+
+  //
+  // Convert image from BMP to Blt buffer format
+  //
+  BltBuffer = *GopBlt;
+  for (Height = 0; Height < BmpHeader->PixelHeight; Height++) {
+    Blt = &BltBuffer[(BmpHeader->PixelHeight - Height - 1) * BmpHeader->PixelWidth];
+    for (Width = 0; Width < BmpHeader->PixelWidth; Width++, Image++, Blt++) {
+      switch (BmpHeader->BitPerPixel) {
+      case 1:
+        //
+        // Convert 1-bit (2 colors) BMP to 24-bit color
+        //
+        for (Index = 0; Index < 8 && Width < BmpHeader->PixelWidth; Index++) {
+          Blt->Red    = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Red;
+          Blt->Green  = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Green;
+          Blt->Blue   = BmpColorMap[((*Image) >> (7 - Index)) & 0x1].Blue;
+          Blt++;
+          Width++;
+        }
+
+        Blt--;
+        Width--;
+        break;
+
+      case 4:
+        //
+        // Convert 4-bit (16 colors) BMP Palette to 24-bit color
+        //
+        Index       = (*Image) >> 4;
+        Blt->Red    = BmpColorMap[Index].Red;
+        Blt->Green  = BmpColorMap[Index].Green;
+        Blt->Blue   = BmpColorMap[Index].Blue;
+        if (Width < (BmpHeader->PixelWidth - 1)) {
+          Blt++;
+          Width++;
+          Index       = (*Image) & 0x0f;
+          Blt->Red    = BmpColorMap[Index].Red;
+          Blt->Green  = BmpColorMap[Index].Green;
+          Blt->Blue   = BmpColorMap[Index].Blue;
+        }
+        break;
+
+      case 8:
+        //
+        // Convert 8-bit (256 colors) BMP Palette to 24-bit color
+        //
+        Blt->Red    = BmpColorMap[*Image].Red;
+        Blt->Green  = BmpColorMap[*Image].Green;
+        Blt->Blue   = BmpColorMap[*Image].Blue;
+        break;
+
+      case 24:
+        //
+        // It is 24-bit BMP.
+        //
+        Blt->Blue   = *Image++;
+        Blt->Green  = *Image++;
+        Blt->Red    = *Image;
+        break;
+
+      default:
+        //
+        // Other bit format BMP is not supported.
+        //
+        if (IsAllocated) {
+          FreePool (*GopBlt);
+          *GopBlt = NULL;
+        }
+        return EFI_UNSUPPORTED;
+        break;
+      };
+
+    }
+
+    ImageIndex = (UINTN) (Image - ImageHeader);
+    if ((ImageIndex % 4) != 0) {
+      //
+      // Bmp Image starts each row on a 32-bit boundary!
+      //
+      Image = Image + (4 - (ImageIndex % 4));
+    }
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Use SystemTable Conout to stop video based Simple Text Out consoles from going
+  to the video device. Put up LogoFile on every video device that is a console.
+
+  @param[in]  LogoFile   File name of logo to display on the center of the screen.
+
+  @retval EFI_SUCCESS     ConsoleControl has been flipped to graphics and logo displayed.
+  @retval EFI_UNSUPPORTED Logo not found
+
+**/
+EFI_STATUS
+PlatformBootManagerEnableQuietBoot (
+  IN  EFI_GUID  *LogoFile
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_OEM_BADGING_PROTOCOL      *Badging;
+  UINT32                        SizeOfX;
+  UINT32                        SizeOfY;
+  INTN                          DestX;
+  INTN                          DestY;
+  UINT8                         *ImageData;
+  UINTN                         ImageSize;
+  UINTN                         BltSize;
+  UINT32                        Instance;
+  EFI_BADGING_FORMAT            Format;
+  EFI_BADGING_DISPLAY_ATTRIBUTE Attribute;
+  UINTN                         CoordinateX;
+  UINTN                         CoordinateY;
+  UINTN                         Height;
+  UINTN                         Width;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Blt;
+  EFI_UGA_DRAW_PROTOCOL         *UgaDraw;
+  UINT32                        ColorDepth;
+  UINT32                        RefreshRate;
+  EFI_GRAPHICS_OUTPUT_PROTOCOL  *GraphicsOutput;
+  EFI_BOOT_LOGO_PROTOCOL        *BootLogo;
+  UINTN                         NumberOfLogos;
+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL *LogoBlt;
+  UINTN                         LogoDestX;
+  UINTN                         LogoDestY;
+  UINTN                         LogoHeight;
+  UINTN                         LogoWidth;
+  UINTN                         NewDestX;
+  UINTN                         NewDestY;
+  UINTN                         NewHeight;
+  UINTN                         NewWidth;
+  UINT64                        BufferSize;
+
+  UgaDraw = NULL;
+  //
+  // Try to open GOP first
+  //
+  Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiGraphicsOutputProtocolGuid, (VOID **) &GraphicsOutput);
+  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {
+    GraphicsOutput = NULL;
+    //
+    // Open GOP failed, try to open UGA
+    //
+    Status = gBS->HandleProtocol (gST->ConsoleOutHandle, &gEfiUgaDrawProtocolGuid, (VOID **) &UgaDraw);
+  }
+  if (EFI_ERROR (Status)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Try to open Boot Logo Protocol.
+  //
+  BootLogo = NULL;
+  gBS->LocateProtocol (&gEfiBootLogoProtocolGuid, NULL, (VOID **) &BootLogo);
+
+  //
+  // Erase Cursor from screen
+  //
+  gST->ConOut->EnableCursor (gST->ConOut, FALSE);
+
+  Badging = NULL;
+  Status  = gBS->LocateProtocol (&gEfiOEMBadgingProtocolGuid, NULL, (VOID **) &Badging);
+
+  if (GraphicsOutput != NULL) {
+    SizeOfX = GraphicsOutput->Mode->Info->HorizontalResolution;
+    SizeOfY = GraphicsOutput->Mode->Info->VerticalResolution;
+
+  } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
+    Status = UgaDraw->GetMode (UgaDraw, &SizeOfX, &SizeOfY, &ColorDepth, &RefreshRate);
+    if (EFI_ERROR (Status)) {
+      return EFI_UNSUPPORTED;
+    }
+  } else {
+    return EFI_UNSUPPORTED;
+  }
+
+  Blt = NULL;
+  NumberOfLogos = 0;
+  LogoDestX = 0;
+  LogoDestY = 0;
+  LogoHeight = 0;
+  LogoWidth = 0;
+  NewDestX = 0;
+  NewDestY = 0;
+  NewHeight = 0;
+  NewWidth = 0;
+  Instance = 0;
+  while (1) {
+    ImageData = NULL;
+    ImageSize = 0;
+
+    if (Badging != NULL) {
+      //
+      // Get image from OEMBadging protocol.
+      //
+      Status = Badging->GetImage (
+                          Badging,
+                          &Instance,
+                          &Format,
+                          &ImageData,
+                          &ImageSize,
+                          &Attribute,
+                          &CoordinateX,
+                          &CoordinateY
+                          );
+      if (EFI_ERROR (Status)) {
+        goto Done;
+      }
+
+      //
+      // Currently only support BMP format.
+      //
+      if (Format != EfiBadgingFormatBMP) {
+        if (ImageData != NULL) {
+          FreePool (ImageData);
+        }
+        continue;
+      }
+    } else {
+      //
+      // Get the specified image from FV.
+      //
+      Status = GetSectionFromAnyFv (LogoFile, EFI_SECTION_RAW, 0, (VOID **) &ImageData, &ImageSize);
+      if (EFI_ERROR (Status)) {
+        return EFI_UNSUPPORTED;
+      }
+
+      CoordinateX = 0;
+      CoordinateY = 0;
+      if (!FeaturePcdGet(PcdBootlogoOnlyEnable)) {
+        Attribute   = EfiBadgingDisplayAttributeCenter;
+      } else {
+        Attribute   = EfiBadgingDisplayAttributeCustomized;
+      } 
+    }
+
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+    Blt = NULL;
+    Status = PlatformBootManagerConvertBmpToGopBlt (
+              ImageData,
+              ImageSize,
+              (VOID **) &Blt,
+              &BltSize,
+              &Height,
+              &Width
+              );
+    if (EFI_ERROR (Status)) {
+      FreePool (ImageData);
+
+      if (Badging == NULL) {
+        return Status;
+      } else {
+        continue;
+      }
+    }
+
+    //
+    // Calculate the display position according to Attribute.
+    //
+    switch (Attribute) {
+    case EfiBadgingDisplayAttributeLeftTop:
+      DestX = CoordinateX;
+      DestY = CoordinateY;
+      break;
+
+    case EfiBadgingDisplayAttributeCenterTop:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = CoordinateY;
+      break;
+
+    case EfiBadgingDisplayAttributeRightTop:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = CoordinateY;;
+      break;
+
+    case EfiBadgingDisplayAttributeCenterRight:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    case EfiBadgingDisplayAttributeRightBottom:
+      DestX = (SizeOfX - Width - CoordinateX);
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EfiBadgingDisplayAttributeCenterBottom:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EfiBadgingDisplayAttributeLeftBottom:
+      DestX = CoordinateX;
+      DestY = (SizeOfY - Height - CoordinateY);
+      break;
+
+    case EfiBadgingDisplayAttributeCenterLeft:
+      DestX = CoordinateX;
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    case EfiBadgingDisplayAttributeCenter:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = (SizeOfY - Height) / 2;
+      break;
+
+    case EfiBadgingDisplayAttributeCustomized:
+      DestX = (SizeOfX - Width) / 2;
+      DestY = ((SizeOfY * 382) / 1000) - Height / 2;
+      break;
+
+    default:
+      DestX = CoordinateX;
+      DestY = CoordinateY;
+      break;
+    }
+
+    if ((DestX >= 0) && (DestY >= 0)) {
+      if (GraphicsOutput != NULL) {
+        Status = GraphicsOutput->Blt (
+                            GraphicsOutput,
+                            Blt,
+                            EfiBltBufferToVideo,
+                            0,
+                            0,
+                            (UINTN) DestX,
+                            (UINTN) DestY,
+                            Width,
+                            Height,
+                            Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                            );
+      } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
+        Status = UgaDraw->Blt (
+                            UgaDraw,
+                            (EFI_UGA_PIXEL *) Blt,
+                            EfiUgaBltBufferToVideo,
+                            0,
+                            0,
+                            (UINTN) DestX,
+                            (UINTN) DestY,
+                            Width,
+                            Height,
+                            Width * sizeof (EFI_UGA_PIXEL)
+                            );
+      } else {
+        Status = EFI_UNSUPPORTED;
+      }
+
+      //
+      // Report displayed Logo information.
+      //
+      if (!EFI_ERROR (Status)) {
+        NumberOfLogos++;
+
+        if (LogoWidth == 0) {
+          //
+          // The first Logo.
+          //
+          LogoDestX = (UINTN) DestX;
+          LogoDestY = (UINTN) DestY;
+          LogoWidth = Width;
+          LogoHeight = Height;
+        } else {
+          //
+          // Merge new logo with old one.
+          //
+          NewDestX = MIN ((UINTN) DestX, LogoDestX);
+          NewDestY = MIN ((UINTN) DestY, LogoDestY);
+          NewWidth = MAX ((UINTN) DestX + Width, LogoDestX + LogoWidth) - NewDestX;
+          NewHeight = MAX ((UINTN) DestY + Height, LogoDestY + LogoHeight) - NewDestY;
+
+          LogoDestX = NewDestX;
+          LogoDestY = NewDestY;
+          LogoWidth = NewWidth;
+          LogoHeight = NewHeight;
+        }
+      }
+    }
+
+    FreePool (ImageData);
+
+    if (Badging == NULL) {
+      break;
+    }
+  }
+
+Done:
+  if (BootLogo == NULL || NumberOfLogos == 0) {
+    //
+    // No logo displayed.
+    //
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+
+    return Status;
+  }
+
+  //
+  // Advertise displayed Logo information.
+  //
+  if (NumberOfLogos == 1) {
+    //
+    // Only one logo displayed, use its Blt buffer directly for BootLogo protocol.
+    //
+    LogoBlt = Blt;
+    Status = EFI_SUCCESS;
+  } else {
+    //
+    // More than one Logo displayed, get merged BltBuffer using VideoToBuffer operation. 
+    //
+    if (Blt != NULL) {
+      FreePool (Blt);
+    }
+
+    //
+    // Ensure the LogoHeight * LogoWidth doesn't overflow
+    //
+    if (LogoHeight > DivU64x64Remainder ((UINTN) ~0, LogoWidth, NULL)) {
+      return EFI_UNSUPPORTED;
+    }
+    BufferSize = MultU64x64 (LogoWidth, LogoHeight);
+
+    //
+    // Ensure the BufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow
+    //
+    if (BufferSize > DivU64x32 ((UINTN) ~0, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {
+      return EFI_UNSUPPORTED;
+    }
+
+    LogoBlt = AllocateZeroPool ((UINTN)BufferSize * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));
+    if (LogoBlt == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+
+    if (GraphicsOutput != NULL) {
+      Status = GraphicsOutput->Blt (
+                          GraphicsOutput,
+                          LogoBlt,
+                          EfiBltVideoToBltBuffer,
+                          LogoDestX,
+                          LogoDestY,
+                          0,
+                          0,
+                          LogoWidth,
+                          LogoHeight,
+                          LogoWidth * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)
+                          );
+    } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {
+      Status = UgaDraw->Blt (
+                          UgaDraw,
+                          (EFI_UGA_PIXEL *) LogoBlt,
+                          EfiUgaVideoToBltBuffer,
+                          LogoDestX,
+                          LogoDestY,
+                          0,
+                          0,
+                          LogoWidth,
+                          LogoHeight,
+                          LogoWidth * sizeof (EFI_UGA_PIXEL)
+                          );
+    } else {
+      Status = EFI_UNSUPPORTED;
+    }
+  }
+
+  if (!EFI_ERROR (Status)) {
+    BootLogo->SetBootLogo (BootLogo, LogoBlt, LogoDestX, LogoDestY, LogoWidth, LogoHeight);
+  }
+  FreePool (LogoBlt);
+
+  return Status;
+}
+
+/**
+  Use SystemTable Conout to turn on video based Simple Text Out consoles. The 
+  Simple Text Out screens will now be synced up with all non video output devices
+
+  @retval EFI_SUCCESS     UGA devices are back in text mode and synced up.
+
+**/
+EFI_STATUS
+PlatformBootManagerDisableQuietBoot (
+  VOID
+  )
+{
+  //
+  // Enable Cursor on Screen
+  //
+  gST->ConOut->EnableCursor (gST->ConOut, TRUE);
+  return EFI_SUCCESS;
+}
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
index 82f7647c7039..e944105b3925 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.c
@@ -38,14 +38,14 @@ PlatformBootManagerDiagnostics (
   // from the graphic lib
   //
   if (QuietBoot) {
-    BootLogoEnableLogo (ImageFormatBmp, PcdGetPtr(PcdLogoFile), EdkiiPlatformLogoDisplayAttributeCenter, 0, 0);
+    PlatformBootManagerEnableQuietBoot (PcdGetPtr(PcdLogoFile));
 
     //
     // Perform system diagnostic
     //
     Status = PlatformBootManagerMemoryTest (MemoryTestLevel);
     if (EFI_ERROR (Status)) {
-      BootLogoDisableLogo ();
+      PlatformBootManagerDisableQuietBoot ();
     }
 
     return;
@@ -271,7 +271,7 @@ PlatformBootManagerWaitCallback (
   Black.Blue = Black.Green = Black.Red = Black.Reserved = 0;
   White.Blue = White.Green = White.Red = White.Reserved = 0xFF;
 
-  BootLogoUpdateProgress (
+  PlatformBootManagerShowProgress (
     White,
     Black,
     L"Start boot option",
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
index e2c6681702fd..7e0fae847fb6 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManager.h
@@ -15,11 +15,16 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define _PLATFORM_BOOT_MANAGER_H
 
 #include <PiDxe.h>
+#include <IndustryStandard/Bmp.h>
 #include <Guid/WinNtSystemConfig.h>
 #include <Protocol/GenericMemoryTest.h>
 #include <Protocol/WinNtThunk.h>
 #include <Protocol/WinNtIo.h>
 #include <Protocol/LoadedImage.h>
+#include <Protocol/UgaDraw.h>
+#include <Protocol/GraphicsOutput.h>
+#include <Protocol/OEMBadging.h>
+#include <Protocol/BootLogo.h>
 
 #include <Library/DebugLib.h>
 #include <Library/BaseMemoryLib.h>
@@ -35,7 +40,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/HiiLib.h>
 #include <Library/PrintLib.h>
 #include <Library/DxeServicesLib.h>
-#include <Library/BootLogoLib.h>
 
 
 typedef struct {
diff --git a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
index 71e8738a6a9d..9b1eeaba02ed 100644
--- a/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
+++ b/Nt32Pkg/Library/PlatformBootManagerLib/PlatformBootManagerLib.inf
@@ -52,7 +52,6 @@
   DevicePathLib
   HiiLib
   PrintLib
-  BootLogoLib
 
 [Guids]
   gEfiWinNtSystemConfigGuid
@@ -61,6 +60,7 @@
   gEfiGenericMemTestProtocolGuid  ## CONSUMES
   gEfiGraphicsOutputProtocolGuid  ## CONSUMES
   gEfiUgaDrawProtocolGuid         ## CONSUMES
+  gEfiOEMBadgingProtocolGuid      ## CONSUMES
   gEfiBootLogoProtocolGuid        ## CONSUMES
 
 [Pcd]
diff --git a/Nt32Pkg/Nt32Pkg.dsc b/Nt32Pkg/Nt32Pkg.dsc
index a9df9b11dc65..21e1f69353bf 100644
--- a/Nt32Pkg/Nt32Pkg.dsc
+++ b/Nt32Pkg/Nt32Pkg.dsc
@@ -117,8 +117,6 @@
   TimerLib|MdePkg/Library/BaseTimerLibNullTemplate/BaseTimerLibNullTemplate.inf
   SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
   CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
-  ImageDecoderLib|MdeModulePkg/Library/ImageDecoderLib/ImageDecoderLib.inf
-  BootLogoLib|MdeModulePkg/Library/BootLogoLib/BootLogoLib.inf
   #
   # Platform
   #
@@ -442,10 +440,7 @@
   NetworkPkg/HttpDxe/HttpDxe.inf
   NetworkPkg/HttpUtilitiesDxe/HttpUtilitiesDxe.inf
 
-  MdeModulePkg/Universal/BdsDxe/BdsDxe.inf {
-    <LibraryClasses>
-      NULL|MdeModulePkg/Library/BmpImageDecoderLib/BmpImageDecoderLib.inf
-  }
+  MdeModulePkg/Universal/BdsDxe/BdsDxe.inf
   MdeModulePkg/Application/UiApp/UiApp.inf
   MdeModulePkg/Universal/DriverHealthManagerDxe/DriverHealthManagerDxe.inf
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf

From b787ece3293b19f7f340ddfe2070d020beb0a6fc Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 20 Nov 2015 05:19:05 +0000
Subject: [PATCH 156/525] UefiCpuPkg: Not touch SmmFeatureControl if
 Code_Access_Chk not Set

Bit SMM_Code_Access_Chk (SMM-RO) in MSR_SMM_MCA_CAP is defined in SDM.
If set to 1 indicates that the SMM code access restriction is supported and the
MSR_SMM_FEATURE_CONTROL is supported.

If this bit is not set, we needn't to access register SmmFetureControl.
Otherwise, #GP exception may happen.

(Sync patch r18905 from main trunk.)

Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18912 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index de681c0a3069..532ac0974b7d 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -1309,9 +1309,9 @@ ConfigSmmCodeAccessCheckOnCurrentProcessor (
   NewSmmFeatureControlMsr = SmmFeatureControlMsr;
   if (mSmmCodeAccessCheckEnable) {
     NewSmmFeatureControlMsr |= SMM_CODE_CHK_EN_BIT;
-  }
-  if (FeaturePcdGet (PcdCpuSmmFeatureControlMsrLock)) {
-    NewSmmFeatureControlMsr |= SMM_FEATURE_CONTROL_LOCK_BIT;
+    if (FeaturePcdGet (PcdCpuSmmFeatureControlMsrLock)) {
+      NewSmmFeatureControlMsr |= SMM_FEATURE_CONTROL_LOCK_BIT;
+    }
   }
 
   //
@@ -1354,13 +1354,6 @@ ConfigSmmCodeAccessCheck (
   //
   if ((AsmReadMsr64 (EFI_MSR_SMM_MCA_CAP) & SMM_CODE_ACCESS_CHK_BIT) == 0) {
     mSmmCodeAccessCheckEnable = FALSE;
-  }
-
-  //
-  // If the SMM Code Access Check feature is disabled and the Feature Control MSR
-  // is not being locked, then no additional work is required
-  //
-  if (!mSmmCodeAccessCheckEnable && !FeaturePcdGet (PcdCpuSmmFeatureControlMsrLock)) {
     return;
   }
 

From 181abae03616d46ffe577a8fab09b087ea3df218 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 20 Nov 2015 05:19:55 +0000
Subject: [PATCH 157/525] UefiCpuPkg/SmmFeatureLib: Check SmmFeatureControl by
 Code_Access_Chk

Bit SMM_Code_Access_Chk (SMM-RO) in MSR_SMM_MCA_CAP is defined in SDM.
If set to 1 indicates that the SMM code access restriction is supported and the
MSR_SMM_FEATURE_CONTROL is supported.

If this bit is not set, we needn't to access register SmmFetureControl.
Otherwise, #GP exception may happen.
We need to check if SmmFeatureControl support or not by checking
SMM_Code_Access_Chk (SMM-RO) in MSR_SMM_MCA_CAP.

Because MSR_SMM_MCA_CAP is SMM-RO register, we should move this check from
SmmCpuFeaturesLibConstructor (non-SMM) to SmmCpuFeaturesInitializeProcessor
(SMM).

(Sync patch r18906 from main trunk.)

Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18913 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.c     | 54 ++++++++++++++-----
 1 file changed, 40 insertions(+), 14 deletions(-)

diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
index 0c1610d9777c..b839d3192f56 100644
--- a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
+++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
@@ -35,6 +35,12 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define    EFI_MSR_SMRR_PHYS_MASK_VALID            BIT11
 #define  SMM_FEATURES_LIB_SMM_FEATURE_CONTROL      0x4E0
 
+//
+// MSRs required for configuration of SMM Code Access Check
+//
+#define SMM_FEATURES_LIB_IA32_MCA_CAP              0x17D
+#define   SMM_CODE_ACCESS_CHK_BIT                  BIT58
+
 //
 // Set default value to assume SMRR is not supported
 //
@@ -131,20 +137,6 @@ SmmCpuFeaturesLibConstructor (
     }
   }
 
-  //
-  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
-  // Volume 3C, Section 35.10.1 MSRs in 4th Generation Intel(R) Core(TM)
-  // Processor Family
-  //
-  // If CPU Family/Model is 06_3C, 06_45, or 06_46 then use 4th Generation
-  // Intel(R) Core(TM) Processor Family MSRs
-  //
-  if (FamilyId == 0x06) {
-    if (ModelId == 0x3C || ModelId == 0x45 || ModelId == 0x46) {
-      mSmmFeatureControlSupported = TRUE;
-    }
-  }
-
   //
   // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
   // Volume 3C, Section 34.4.2 SMRAM Caching
@@ -214,6 +206,10 @@ SmmCpuFeaturesInitializeProcessor (
 {
   SMRAM_SAVE_STATE_MAP  *CpuState;
   UINT64                FeatureControl;
+  UINT32                RegEax;
+  UINT32                RegEdx;
+  UINTN                 FamilyId;
+  UINTN                 ModelId;
 
   //
   // Configure SMBASE.
@@ -253,6 +249,36 @@ SmmCpuFeaturesInitializeProcessor (
     AsmWriteMsr64 (mSmrrPhysMaskMsr, (~(CpuHotPlugData->SmrrSize - 1) & EFI_MSR_SMRR_MASK));
     mSmrrEnabled[CpuIndex] = FALSE;
   }
+
+  //
+  // Retrieve CPU Family and Model
+  //
+  AsmCpuid (CPUID_VERSION_INFO, &RegEax, NULL, NULL, &RegEdx);
+  FamilyId = (RegEax >> 8) & 0xf;
+  ModelId  = (RegEax >> 4) & 0xf;
+  if (FamilyId == 0x06 || FamilyId == 0x0f) {
+    ModelId = ModelId | ((RegEax >> 12) & 0xf0);
+  }
+
+  //
+  // Intel(R) 64 and IA-32 Architectures Software Developer's Manual
+  // Volume 3C, Section 35.10.1 MSRs in 4th Generation Intel(R) Core(TM)
+  // Processor Family.
+  //
+  // If CPU Family/Model is 06_3C, 06_45, or 06_46 then use 4th Generation
+  // Intel(R) Core(TM) Processor Family MSRs.
+  //
+  if (FamilyId == 0x06) {
+    if (ModelId == 0x3C || ModelId == 0x45 || ModelId == 0x46) {
+      //
+      // Check to see if the CPU supports the SMM Code Access Check feature
+      // Do not access this MSR unless the CPU supports the SmmRegFeatureControl
+      //
+      if ((AsmReadMsr64 (SMM_FEATURES_LIB_IA32_MCA_CAP) & SMM_CODE_ACCESS_CHK_BIT) != 0) {
+        mSmmFeatureControlSupported = TRUE;
+      }
+    }
+  }
 }
 
 /**

From 1acb4a137e46d4ce8013d7712ca25f2f13294fc3 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 25 Nov 2015 06:42:16 +0000
Subject: [PATCH 158/525] MdeModulePkg/UefiBootManagerLib: Always create
 MemoryTypeInfo variable

Align to old BDS behavior (IntelFrameworkModulePkg/BDS) to always create
MemoryTypeInfo variable regardless of the PcdResetOnMemoryTypeInformationChange
value.

(Sync patch r18926 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18939 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c  |  8 +++-----
 MdeModulePkg/Library/UefiBootManagerLib/BmMisc.c  | 15 ++++++++++-----
 .../Library/UefiBootManagerLib/InternalBm.h       |  9 +++++++--
 3 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c b/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
index 8f14cf6d3f81..4afd9c25ff2e 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
+++ b/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
@@ -1689,11 +1689,9 @@ EfiBootManagerBoot (
   // 6. Adjust the different type memory page number just before booting
   //    and save the updated info into the variable for next boot to use
   //
-  if ((BootOption->Attributes & LOAD_OPTION_CATEGORY) == LOAD_OPTION_CATEGORY_BOOT) {
-    if (PcdGetBool (PcdResetOnMemoryTypeInformationChange)) {
-      BmSetMemoryTypeInformationVariable ();
-    }
-  }
+  BmSetMemoryTypeInformationVariable (
+    (BOOLEAN) ((BootOption->Attributes & LOAD_OPTION_CATEGORY) == LOAD_OPTION_CATEGORY_BOOT)
+    );
 
   DEBUG_CODE_BEGIN();
     if (BootOption->Description == NULL) {
diff --git a/MdeModulePkg/Library/UefiBootManagerLib/BmMisc.c b/MdeModulePkg/Library/UefiBootManagerLib/BmMisc.c
index 97d1a48cd5a2..e675904857bb 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/BmMisc.c
+++ b/MdeModulePkg/Library/UefiBootManagerLib/BmMisc.c
@@ -122,11 +122,16 @@ BmMatchDevicePaths (
 
 /**
   This routine adjust the memory information for different memory type and 
-  save them into the variables for next boot.
+  save them into the variables for next boot. It resets the system when
+  memory information is updated and the current boot option belongs to
+  boot category instead of application category.
+
+  @param Boot  TRUE if current boot option belongs to boot category instead of
+               application category.
 **/
 VOID
 BmSetMemoryTypeInformationVariable (
-  VOID
+  IN BOOLEAN                    Boot
   )
 {
   EFI_STATUS                   Status;
@@ -267,11 +272,11 @@ BmSetMemoryTypeInformationVariable (
 
     if (!EFI_ERROR (Status)) {
       //
-      // If the Memory Type Information settings have been modified, then reset the platform
-      // so the new Memory Type Information setting will be used to guarantee that an S4
+      // If the Memory Type Information settings have been modified and the boot option belongs to boot category,
+      // then reset the platform so the new Memory Type Information setting will be used to guarantee that an S4
       // entry/resume cycle will not fail.
       //
-      if (MemoryTypeInformationModified) {
+      if (MemoryTypeInformationModified && Boot && PcdGetBool (PcdResetOnMemoryTypeInformationChange)) {
         DEBUG ((EFI_D_INFO, "Memory Type Information settings change. Warm Reset!!!\n"));
         gRT->ResetSystem (EfiResetWarm, EFI_SUCCESS, 0, NULL);
       }
diff --git a/MdeModulePkg/Library/UefiBootManagerLib/InternalBm.h b/MdeModulePkg/Library/UefiBootManagerLib/InternalBm.h
index d415442e2399..c808ed2ffe21 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/InternalBm.h
+++ b/MdeModulePkg/Library/UefiBootManagerLib/InternalBm.h
@@ -232,11 +232,16 @@ BmGetImageHeader (
 
 /**
   This routine adjust the memory information for different memory type and 
-  save them into the variables for next boot.
+  save them into the variables for next boot. It resets the system when
+  memory information is updated and the current boot option belongs to
+  boot category instead of application category.
+
+  @param Boot  TRUE if current boot option belongs to boot category instead of
+               application category.
 **/
 VOID
 BmSetMemoryTypeInformationVariable (
-  VOID
+  IN BOOLEAN                    Boot
   );
 
 /**

From 4c98fa255a6c6307ad2d12ec86c9333bcdcb106e Mon Sep 17 00:00:00 2001
From: "Zeng, Star" <star.zeng@intel.com>
Date: Wed, 25 Nov 2015 06:42:46 +0000
Subject: [PATCH 159/525] Check InternalAllocPoolByIndex status before refer
 buffer.

Original code refers FreePoolHdr without check Status. It is obvious wrong and has risk.

Aslo, if InternalAllocPoolByIndex() returns an error, then *FreePoolHdr is assigned to an uninitialized value. So we init Hdr be NULL.

(Sync patch r18932 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Zeng, Star" <star.zeng@intel.com>
Reviewed-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Fan, Jeff" <jeff.fan@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18940 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/PiSmmCore/Pool.c | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Core/PiSmmCore/Pool.c b/MdeModulePkg/Core/PiSmmCore/Pool.c
index 34dcc93f1ab4..761988e4162b 100644
--- a/MdeModulePkg/Core/PiSmmCore/Pool.c
+++ b/MdeModulePkg/Core/PiSmmCore/Pool.c
@@ -1,7 +1,7 @@
 /** @file
   SMM Memory pool management functions.
 
-  Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials are licensed and made available 
   under the terms and conditions of the BSD License which accompanies this 
   distribution.  The full text of the license may be found at        
@@ -120,6 +120,7 @@ InternalAllocPoolByIndex (
 
   ASSERT (PoolIndex <= MAX_POOL_INDEX);
   Status = EFI_SUCCESS;
+  Hdr = NULL;
   if (PoolIndex == MAX_POOL_INDEX) {
     Status = SmmInternalAllocatePages (AllocateAnyPages, EfiRuntimeServicesData, EFI_SIZE_TO_PAGES (MAX_POOL_SIZE << 1), &Address);
     if (EFI_ERROR (Status)) {
@@ -228,7 +229,9 @@ SmmInternalAllocatePool (
   }
 
   Status = InternalAllocPoolByIndex (PoolIndex, &FreePoolHdr);
-  *Buffer = &FreePoolHdr->Header + 1;
+  if (!EFI_ERROR(Status)) {
+    *Buffer = &FreePoolHdr->Header + 1;
+  }
   return Status;
 }
 

From 3630da170ebf995a43e540196f7aed09d95c2f4c Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 25 Nov 2015 06:43:11 +0000
Subject: [PATCH 160/525] UefiCpuPkg/CpuMpPei: Set X2APIC flag if one x2APIC ID
 larger than 254

If there are any logical processor reporting an APIC ID of 255 or greater, set
X2ApicEnable flag.

GetInitialApicId() will return x2APIC ID if CPUID leaf B supported.

(Sync patch r18933 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18941 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 21 ++++++++++++++++-----
 UefiCpuPkg/CpuMpPei/CpuMpPei.h |  2 ++
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 8e35f288fe3c..8ed52436c98f 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -146,11 +146,20 @@ ApCFunction (
   PeiCpuMpData = ExchangeInfo->PeiCpuMpData;
   if (PeiCpuMpData->InitFlag) {
     //
-    // This is first time AP wakeup, get BIST inforamtion from AP stack
+    // This is first time AP wakeup, get BIST information from AP stack
     //
     BistData = *(UINTN *) (PeiCpuMpData->Buffer + NumApsExecuting * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
-    PeiCpuMpData->CpuData[NumApsExecuting].ApicId        = GetInitialApicId ();
     PeiCpuMpData->CpuData[NumApsExecuting].Health.Uint32 = (UINT32) BistData;
+    PeiCpuMpData->CpuData[NumApsExecuting].ApicId = GetInitialApicId ();
+    if (PeiCpuMpData->CpuData[NumApsExecuting].ApicId >= 0xFF) {
+      //
+      // Set x2APIC mode if there are any logical processor reporting
+      // an APIC ID of 255 or greater.
+      //
+      AcquireSpinLock(&PeiCpuMpData->MpLock);
+      PeiCpuMpData->X2ApicEnable = TRUE;
+      ReleaseSpinLock(&PeiCpuMpData->MpLock);
+    }
     //
     // Sync BSP's Mtrr table to all wakeup APs and load microcode on APs.
     //
@@ -363,15 +372,16 @@ CountProcessorNumber (
   //
   if (PcdGet32 (PcdCpuMaxLogicalProcessorNumber) > 1) {
     //
-    // Send broadcast IPI to APs to wakeup APs
+    // Send 1st broadcast IPI to APs to wakeup APs
     //
-    PeiCpuMpData->InitFlag = 1;
+    PeiCpuMpData->InitFlag     = TRUE;
+    PeiCpuMpData->X2ApicEnable = FALSE;
     WakeUpAP (PeiCpuMpData, TRUE, 0, NULL, NULL);
     //
     // Wait for AP task to complete and then exit.
     //
     MicroSecondDelay (PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
-    PeiCpuMpData->InitFlag = 0;
+    PeiCpuMpData->InitFlag  = FALSE;
     PeiCpuMpData->CpuCount += (UINT32)PeiCpuMpData->MpCpuExchangeInfo->NumApsExecuting;
     ASSERT (PeiCpuMpData->CpuCount <= PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
     //
@@ -439,6 +449,7 @@ PrepareAPStartupVector (
   PeiCpuMpData->CpuData[0].ApicId        = GetInitialApicId ();
   PeiCpuMpData->CpuData[0].Health.Uint32 = 0;
   PeiCpuMpData->EndOfPeiFlag             = FALSE;
+  InitializeSpinLock(&PeiCpuMpData->MpLock);
   CopyMem (&PeiCpuMpData->AddressMap, &AddressMap, sizeof (MP_ASSEMBLY_ADDRESS_MAP));
 
   //
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index 9325a12d4ceb..de9011329c08 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -124,6 +124,7 @@ typedef struct {
 // PEI CPU MP Data save in memory
 //
 struct _PEI_CPU_MP_DATA {
+  SPIN_LOCK                      MpLock;
   UINT32                         CpuCount;
   UINT32                         BspNumber;
   UINTN                          Buffer;
@@ -137,6 +138,7 @@ struct _PEI_CPU_MP_DATA {
   volatile UINT32                FinishedCount;
   BOOLEAN                        EndOfPeiFlag;
   BOOLEAN                        InitFlag;
+  BOOLEAN                        X2ApicEnable;
   CPU_EXCHANGE_ROLE_INFO         BSPInfo;
   CPU_EXCHANGE_ROLE_INFO         APInfo;
   MTRR_SETTINGS                  MtrrTable;

From 7e215c2d8ed8b1ea3b7e53a32769d64e3edccc2b Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 25 Nov 2015 06:43:39 +0000
Subject: [PATCH 161/525] UefiCpuPkg/CpuMpPei: Enable x2APIC mode on BSP/APs

If x2APIC flag is set, enable x2APIC mode on all APs and BSP. Before we wakeup
APs to enable x2APIC mode, we should wait all APs have finished initialization.

(Sync patch r18934 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18942 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 39 ++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 8ed52436c98f..c22252220316 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -101,6 +101,20 @@ SortApicId (
   }
 }
 
+/**
+  Enable x2APIC mode on APs.
+
+  @param Buffer  Pointer to private data buffer.
+**/
+VOID
+EFIAPI
+ApFuncEnableX2Apic (
+  IN OUT VOID  *Buffer
+  )
+{
+  SetApicMode (LOCAL_APIC_MODE_X2APIC);
+}
+
 /**
   Get CPU MP Data pointer from the Guided HOB.
 
@@ -385,6 +399,31 @@ CountProcessorNumber (
     PeiCpuMpData->CpuCount += (UINT32)PeiCpuMpData->MpCpuExchangeInfo->NumApsExecuting;
     ASSERT (PeiCpuMpData->CpuCount <= PcdGet32 (PcdCpuMaxLogicalProcessorNumber));
     //
+    // Wait for all APs finished the initialization
+    //
+    while (PeiCpuMpData->FinishedCount < (PeiCpuMpData->CpuCount - 1)) {
+      CpuPause ();
+    }
+
+    if (PeiCpuMpData->X2ApicEnable) {
+      DEBUG ((EFI_D_INFO, "Force x2APIC mode!\n"));
+      //
+      // Send 2nd broadcast IPI to all APs to enable x2APIC mode
+      //
+      WakeUpAP (PeiCpuMpData, TRUE, 0, ApFuncEnableX2Apic, NULL);
+      //
+      // Wait for all known APs finished
+      //
+      while (PeiCpuMpData->FinishedCount < (PeiCpuMpData->CpuCount - 1)) {
+        CpuPause ();
+      }
+      //
+      // Enable x2APIC on BSP
+      //
+      SetApicMode (LOCAL_APIC_MODE_X2APIC);
+    }
+    DEBUG ((EFI_D_INFO, "APIC MODE is %d\n", GetApicMode ()));
+    //
     // Sort BSP/Aps by CPU APIC ID in ascending order
     //
     SortApicId (PeiCpuMpData);

From 94b76c954e6d37a95b8ab2753384b97d40bf4bfd Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 08:54:22 +0000
Subject: [PATCH 162/525] Uninstall LoadedImage protocol if SMM driver returns
 error and is unloaded.

Original code does not uninstall LoadedImage protocol if SMM driver returns error and is unloaded.
It causes a wrong LoadedImage protocol existing in system.

(Sync patch r18936 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18947 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/PiSmmCore/Dispatcher.c | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/MdeModulePkg/Core/PiSmmCore/Dispatcher.c b/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
index 81e8a0dc827a..cbaf549066e3 100644
--- a/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
+++ b/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
@@ -881,6 +881,20 @@ SmmDispatcher (
       if (EFI_ERROR(Status)){
         UnregisterSmramProfileImage (DriverEntry, TRUE);
         SmmFreePages(DriverEntry->ImageBuffer, DriverEntry->NumberOfPage);
+        //
+        // Uninstall LoadedImage
+        //
+        Status = gBS->UninstallProtocolInterface (
+                        DriverEntry->ImageHandle,
+                        &gEfiLoadedImageProtocolGuid,
+                        DriverEntry->LoadedImage
+                        );
+        if (!EFI_ERROR (Status)) {
+          if (DriverEntry->LoadedImage->FilePath != NULL) {
+            gBS->FreePool (DriverEntry->LoadedImage->FilePath);
+          }
+          gBS->FreePool (DriverEntry->LoadedImage);
+        }
       }
 
       REPORT_STATUS_CODE_WITH_EXTENDED_DATA (

From a3a09c3812661a14f57eb47f1e9ece7594be4cf2 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 08:54:57 +0000
Subject: [PATCH 163/525] Install LoadedImage protocol for PiSmmCore.

PiSmmCore installs LoadedImage for each SMM driver. However itself is missing.
So we follow DxeCore style, let PiSmmCore installs LoadedImage protocol for itself,
then the SMM image information is complete.

(Sync patch r18945 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@18948 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/PiSmmCore/Dispatcher.c | 33 +++++++++++++++-
 MdeModulePkg/Core/PiSmmCore/PiSmmCore.c  | 49 ++++++++++++++++++++++++
 MdeModulePkg/Core/PiSmmCore/PiSmmCore.h  |  2 +
 3 files changed, 82 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Core/PiSmmCore/Dispatcher.c b/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
index cbaf549066e3..1f85ae8def61 100644
--- a/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
+++ b/MdeModulePkg/Core/PiSmmCore/Dispatcher.c
@@ -103,7 +103,8 @@ BOOLEAN  gRequestDispatch = FALSE;
 //
 EFI_FV_FILETYPE mSmmFileTypes[] = {
   EFI_FV_FILETYPE_SMM,
-  EFI_FV_FILETYPE_COMBINED_SMM_DXE
+  EFI_FV_FILETYPE_COMBINED_SMM_DXE,
+  EFI_FV_FILETYPE_SMM_CORE,
   //
   // Note: DXE core will process the FV image file, so skip it in SMM core
   // EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE
@@ -1283,6 +1284,7 @@ SmmDriverDispatchHandler (
     //
     // Discover Drivers in FV and add them to the Discovered Driver List.
     // Process EFI_FV_FILETYPE_SMM type and then EFI_FV_FILETYPE_COMBINED_SMM_DXE
+    //  EFI_FV_FILETYPE_SMM_CORE is processed to produce a Loaded Image protocol for the core
     //
     for (SmmTypeIndex = 0; SmmTypeIndex < sizeof (mSmmFileTypes)/sizeof (EFI_FV_FILETYPE); SmmTypeIndex++) {
       //
@@ -1300,7 +1302,34 @@ SmmDriverDispatchHandler (
                                   &Size
                                   );
         if (!EFI_ERROR (GetNextFileStatus)) {
-          SmmAddToDriverList (Fv, FvHandle, &NameGuid);
+          if (Type == EFI_FV_FILETYPE_SMM_CORE) {
+            //
+            // If this is the SMM core fill in it's DevicePath & DeviceHandle
+            //
+            if (mSmmCoreLoadedImage->FilePath == NULL) {
+              //
+              // Maybe one special FV contains only one SMM_CORE module, so its device path must
+              // be initialized completely.
+              //
+              EfiInitializeFwVolDevicepathNode (&mFvDevicePath.File, &NameGuid);
+              SetDevicePathEndNode (&mFvDevicePath.End);
+
+              //
+              // Make an EfiBootServicesData buffer copy of FilePath
+              //
+              Status = gBS->AllocatePool (
+                              EfiBootServicesData,
+                              GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *)&mFvDevicePath),
+                              (VOID **)&mSmmCoreLoadedImage->FilePath
+                              );
+              ASSERT_EFI_ERROR (Status);
+              CopyMem (mSmmCoreLoadedImage->FilePath, &mFvDevicePath, GetDevicePathSize ((EFI_DEVICE_PATH_PROTOCOL *)&mFvDevicePath));
+
+              mSmmCoreLoadedImage->DeviceHandle = FvHandle;
+            }
+          } else {
+            SmmAddToDriverList (Fv, FvHandle, &NameGuid);
+          }
         }
       } while (!EFI_ERROR (GetNextFileStatus));
     }
diff --git a/MdeModulePkg/Core/PiSmmCore/PiSmmCore.c b/MdeModulePkg/Core/PiSmmCore/PiSmmCore.c
index 496638a17ed1..aaa7efd8e07d 100644
--- a/MdeModulePkg/Core/PiSmmCore/PiSmmCore.c
+++ b/MdeModulePkg/Core/PiSmmCore/PiSmmCore.c
@@ -87,6 +87,8 @@ SMM_CORE_SMI_HANDLERS  mSmmCoreSmiHandlers[] = {
 UINTN                           mFullSmramRangeCount;
 EFI_SMRAM_DESCRIPTOR            *mFullSmramRanges;
 
+EFI_LOADED_IMAGE_PROTOCOL       *mSmmCoreLoadedImage;
+
 /**
   Place holder function until all the SMM System Table Service are available.
 
@@ -516,6 +518,51 @@ SmmEntryPoint (
   PERF_END (NULL, "SMM", NULL, 0) ;
 }
 
+/**
+  Install LoadedImage protocol for SMM Core.
+**/
+VOID
+SmmCoreInstallLoadedImage (
+  VOID
+  )
+{
+  EFI_STATUS                 Status;
+  EFI_HANDLE                 Handle;
+
+  //
+  // Allocate a Loaded Image Protocol in EfiBootServicesData
+  //
+  Status = gBS->AllocatePool (EfiBootServicesData, sizeof(EFI_LOADED_IMAGE_PROTOCOL), (VOID **)&mSmmCoreLoadedImage);
+  ASSERT_EFI_ERROR (Status);
+
+  ZeroMem (mSmmCoreLoadedImage, sizeof (EFI_LOADED_IMAGE_PROTOCOL));
+  //
+  // Fill in the remaining fields of the Loaded Image Protocol instance.
+  // Note: ImageBase is an SMRAM address that can not be accessed outside of SMRAM if SMRAM window is closed.
+  //
+  mSmmCoreLoadedImage->Revision      = EFI_LOADED_IMAGE_PROTOCOL_REVISION;
+  mSmmCoreLoadedImage->ParentHandle  = gSmmCorePrivate->SmmIplImageHandle;
+  mSmmCoreLoadedImage->SystemTable   = gST;
+
+  mSmmCoreLoadedImage->ImageBase     = (VOID *)(UINTN)gSmmCorePrivate->PiSmmCoreImageBase;
+  mSmmCoreLoadedImage->ImageSize     = gSmmCorePrivate->PiSmmCoreImageSize;
+  mSmmCoreLoadedImage->ImageCodeType = EfiRuntimeServicesCode;
+  mSmmCoreLoadedImage->ImageDataType = EfiRuntimeServicesData;
+
+  //
+  // Create a new image handle in the UEFI handle database for the SMM Driver
+  //
+  Handle = NULL;
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &Handle,
+                  &gEfiLoadedImageProtocolGuid, mSmmCoreLoadedImage,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return ;
+}
+
 /**
   The Entry Point for SMM Core
 
@@ -582,5 +629,7 @@ SmmMain (
 
   RegisterSmramProfileHandler ();
 
+  SmmCoreInstallLoadedImage ();
+
   return EFI_SUCCESS;
 }
diff --git a/MdeModulePkg/Core/PiSmmCore/PiSmmCore.h b/MdeModulePkg/Core/PiSmmCore/PiSmmCore.h
index e34bd8a640f3..0e9c92abef9a 100644
--- a/MdeModulePkg/Core/PiSmmCore/PiSmmCore.h
+++ b/MdeModulePkg/Core/PiSmmCore/PiSmmCore.h
@@ -959,6 +959,8 @@ SmramProfileReadyToLock (
 extern UINTN                    mFullSmramRangeCount;
 extern EFI_SMRAM_DESCRIPTOR     *mFullSmramRanges;
 
+extern EFI_LOADED_IMAGE_PROTOCOL  *mSmmCoreLoadedImage;
+
 //
 // Page management
 //

From 15bf315a1e829fd8a32c9002aace328cd130fe11 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Mon, 30 Nov 2015 02:52:10 +0000
Subject: [PATCH 164/525] Sync two missing files when sync BaseTools from main
 trunk r18767.

Reported-by: Mike Maslenkin <mike.maslenkin@gmail.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19006 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Scripts/PatchCheck.py               | 607 ++++++++++++++++++
 .../Source/Python/Common/MultipleWorkspace.py | 148 +++++
 2 files changed, 755 insertions(+)
 create mode 100644 BaseTools/Scripts/PatchCheck.py
 create mode 100644 BaseTools/Source/Python/Common/MultipleWorkspace.py

diff --git a/BaseTools/Scripts/PatchCheck.py b/BaseTools/Scripts/PatchCheck.py
new file mode 100644
index 000000000000..340a9972b838
--- /dev/null
+++ b/BaseTools/Scripts/PatchCheck.py
@@ -0,0 +1,607 @@
+## @file
+#  Check a patch for various format issues
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials are licensed and made
+#  available under the terms and conditions of the BSD License which
+#  accompanies this distribution. The full text of the license may be
+#  found at http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
+#  BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
+#  EXPRESS OR IMPLIED.
+#
+
+from __future__ import print_function
+
+VersionNumber = '0.1'
+__copyright__ = "Copyright (c) 2015, Intel Corporation  All rights reserved."
+
+import email
+import argparse
+import os
+import re
+import subprocess
+import sys
+
+class Verbose:
+    SILENT, ONELINE, NORMAL = range(3)
+    level = NORMAL
+
+class CommitMessageCheck:
+    """Checks the contents of a git commit message."""
+
+    def __init__(self, subject, message):
+        self.ok = True
+
+        if subject is None and  message is None:
+            self.error('Commit message is missing!')
+            return
+
+        self.subject = subject
+        self.msg = message
+
+        self.check_contributed_under()
+        self.check_signed_off_by()
+        self.check_misc_signatures()
+        self.check_overall_format()
+        self.report_message_result()
+
+    url = 'https://github.com/tianocore/tianocore.github.io/wiki/Commit-Message-Format'
+
+    def report_message_result(self):
+        if Verbose.level < Verbose.NORMAL:
+            return
+        if self.ok:
+            # All checks passed
+            return_code = 0
+            print('The commit message format passed all checks.')
+        else:
+            return_code = 1
+        if not self.ok:
+            print(self.url)
+
+    def error(self, *err):
+        if self.ok and Verbose.level > Verbose.ONELINE:
+            print('The commit message format is not valid:')
+        self.ok = False
+        if Verbose.level < Verbose.NORMAL:
+            return
+        count = 0
+        for line in err:
+            prefix = (' *', '  ')[count > 0]
+            print(prefix, line)
+            count += 1
+
+    def check_contributed_under(self):
+        cu_msg='Contributed-under: TianoCore Contribution Agreement 1.0'
+        if self.msg.find(cu_msg) < 0:
+            self.error('Missing Contributed-under! (Note: this must be ' +
+                       'added by the code contributor!)')
+
+    @staticmethod
+    def make_signature_re(sig, re_input=False):
+        if re_input:
+            sub_re = sig
+        else:
+            sub_re = sig.replace('-', r'[-\s]+')
+        re_str = (r'^(?P<tag>' + sub_re +
+                  r')(\s*):(\s*)(?P<value>\S.*?)(?:\s*)$')
+        try:
+            return re.compile(re_str, re.MULTILINE|re.IGNORECASE)
+        except Exception:
+            print("Tried to compile re:", re_str)
+            raise
+
+    sig_block_re = \
+        re.compile(r'''^
+                        (?: (?P<tag>[^:]+) \s* : \s*
+                            (?P<value>\S.*?) )
+                            |
+                        (?: \[ (?P<updater>[^:]+) \s* : \s*
+                               (?P<note>.+?) \s* \] )
+                    \s* $''',
+                   re.VERBOSE | re.MULTILINE)
+
+    def find_signatures(self, sig):
+        if not sig.endswith('-by') and sig != 'Cc':
+            sig += '-by'
+        regex = self.make_signature_re(sig)
+
+        sigs = regex.findall(self.msg)
+
+        bad_case_sigs = filter(lambda m: m[0] != sig, sigs)
+        for s in bad_case_sigs:
+            self.error("'" +s[0] + "' should be '" + sig + "'")
+
+        for s in sigs:
+            if s[1] != '':
+                self.error('There should be no spaces between ' + sig +
+                           " and the ':'")
+            if s[2] != ' ':
+                self.error("There should be a space after '" + sig + ":'")
+
+            self.check_email_address(s[3])
+
+        return sigs
+
+    email_re1 = re.compile(r'(?:\s*)(.*?)(\s*)<(.+)>\s*$',
+                           re.MULTILINE|re.IGNORECASE)
+
+    def check_email_address(self, email):
+        email = email.strip()
+        mo = self.email_re1.match(email)
+        if mo is None:
+            self.error("Email format is invalid: " + email.strip())
+            return
+
+        name = mo.group(1).strip()
+        if name == '':
+            self.error("Name is not provided with email address: " +
+                       email)
+        else:
+            quoted = len(name) > 2 and name[0] == '"' and name[-1] == '"'
+            if name.find(',') >= 0 and not quoted:
+                self.error('Add quotes (") around name with a comma: ' +
+                           name)
+
+        if mo.group(2) == '':
+            self.error("There should be a space between the name and " +
+                       "email address: " + email)
+
+        if mo.group(3).find(' ') >= 0:
+            self.error("The email address cannot contain a space: " +
+                       mo.group(3))
+
+    def check_signed_off_by(self):
+        sob='Signed-off-by'
+        if self.msg.find(sob) < 0:
+            self.error('Missing Signed-off-by! (Note: this must be ' +
+                       'added by the code contributor!)')
+            return
+
+        sobs = self.find_signatures('Signed-off')
+
+        if len(sobs) == 0:
+            self.error('Invalid Signed-off-by format!')
+            return
+
+    sig_types = (
+        'Reviewed',
+        'Reported',
+        'Tested',
+        'Suggested',
+        'Acked',
+        'Cc'
+        )
+
+    def check_misc_signatures(self):
+        for sig in self.sig_types:
+            self.find_signatures(sig)
+
+    def check_overall_format(self):
+        lines = self.msg.splitlines()
+
+        if len(lines) >= 1 and lines[0].endswith('\r\n'):
+            empty_line = '\r\n'
+        else:
+            empty_line = '\n'
+
+        lines.insert(0, empty_line)
+        lines.insert(0, self.subject + empty_line)
+
+        count = len(lines)
+
+        if count <= 0:
+            self.error('Empty commit message!')
+            return
+
+        if count >= 1 and len(lines[0]) > 76:
+            self.error('First line of commit message (subject line) ' +
+                       'is too long.')
+
+        if count >= 1 and len(lines[0].strip()) == 0:
+            self.error('First line of commit message (subject line) ' +
+                       'is empty.')
+
+        if count >= 2 and lines[1].strip() != '':
+            self.error('Second line of commit message should be ' +
+                       'empty.')
+
+        for i in range(2, count):
+            if (len(lines[i]) > 76 and
+                len(lines[i].split()) > 1 and
+                not lines[i].startswith('git-svn-id:')):
+                self.error('Line %d of commit message is too long.' % (i + 1))
+
+        last_sig_line = None
+        for i in range(count - 1, 0, -1):
+            line = lines[i]
+            mo = self.sig_block_re.match(line)
+            if mo is None:
+                if line.strip() == '':
+                    break
+                elif last_sig_line is not None:
+                    err2 = 'Add empty line before "%s"?' % last_sig_line
+                    self.error('The line before the signature block ' +
+                               'should be empty', err2)
+                else:
+                    self.error('The signature block was not found')
+                break
+            last_sig_line = line.strip()
+
+(START, PRE_PATCH, PATCH) = range(3)
+
+class GitDiffCheck:
+    """Checks the contents of a git diff."""
+
+    def __init__(self, diff):
+        self.ok = True
+        self.format_ok = True
+        self.lines = diff.splitlines(True)
+        self.count = len(self.lines)
+        self.line_num = 0
+        self.state = START
+        while self.line_num < self.count and self.format_ok:
+            line_num = self.line_num
+            self.run()
+            assert(self.line_num > line_num)
+        self.report_message_result()
+
+    def report_message_result(self):
+        if Verbose.level < Verbose.NORMAL:
+            return
+        if self.ok:
+            print('The code passed all checks.')
+
+    def run(self):
+        line = self.lines[self.line_num]
+
+        if self.state in (PRE_PATCH, PATCH):
+            if line.startswith('diff --git'):
+                self.state = START
+        if self.state == PATCH:
+            if line.startswith('@@ '):
+                self.state = PRE_PATCH
+            elif len(line) >= 1 and line[0] not in ' -+' and \
+                 not line.startswith(r'\ No newline '):
+                for line in self.lines[self.line_num + 1:]:
+                    if line.startswith('diff --git'):
+                        self.format_error('diff found after end of patch')
+                        break
+                self.line_num = self.count
+                return
+
+        if self.state == START:
+            if line.startswith('diff --git'):
+                self.state = PRE_PATCH
+                self.set_filename(None)
+            elif len(line.rstrip()) != 0:
+                self.format_error("didn't find diff command")
+            self.line_num += 1
+        elif self.state == PRE_PATCH:
+            if line.startswith('+++ b/'):
+                self.set_filename(line[6:].rstrip())
+            if line.startswith('@@ '):
+                self.state = PATCH
+            else:
+                ok = False
+                for pfx in self.pre_patch_prefixes:
+                    if line.startswith(pfx):
+                        ok = True
+                if not ok:
+                    self.format_error("didn't find diff hunk marker (@@)")
+            self.line_num += 1
+        elif self.state == PATCH:
+            if line.startswith('-'):
+                pass
+            elif line.startswith('+'):
+                self.check_added_line(line[1:])
+            elif line.startswith(r'\ No newline '):
+                pass
+            elif not line.startswith(' '):
+                self.format_error("unexpected patch line")
+            self.line_num += 1
+
+    pre_patch_prefixes = (
+        '--- ',
+        '+++ ',
+        'index ',
+        'new file ',
+        'deleted file ',
+        'old mode ',
+        'new mode ',
+        'similarity index ',
+        'rename ',
+        'Binary files ',
+        )
+
+    line_endings = ('\r\n', '\n\r', '\n', '\r')
+
+    def set_filename(self, filename):
+        self.hunk_filename = filename
+        if filename:
+            self.force_crlf = not filename.endswith('.sh')
+        else:
+            self.force_crlf = True
+
+    def added_line_error(self, msg, line):
+        lines = [ msg ]
+        if self.hunk_filename is not None:
+            lines.append('File: ' + self.hunk_filename)
+        lines.append('Line: ' + line)
+
+        self.error(*lines)
+
+    def check_added_line(self, line):
+        eol = ''
+        for an_eol in self.line_endings:
+            if line.endswith(an_eol):
+                eol = an_eol
+                line = line[:-len(eol)]
+
+        stripped = line.rstrip()
+
+        if self.force_crlf and eol != '\r\n':
+            self.added_line_error('Line ending (%s) is not CRLF' % repr(eol),
+                                  line)
+        if '\t' in line:
+            self.added_line_error('Tab character used', line)
+        if len(stripped) < len(line):
+            self.added_line_error('Trailing whitespace found', line)
+
+    split_diff_re = re.compile(r'''
+                                   (?P<cmd>
+                                       ^ diff \s+ --git \s+ a/.+ \s+ b/.+ $
+                                   )
+                                   (?P<index>
+                                       ^ index \s+ .+ $
+                                   )
+                               ''',
+                               re.IGNORECASE | re.VERBOSE | re.MULTILINE)
+
+    def format_error(self, err):
+        self.format_ok = False
+        err = 'Patch format error: ' + err
+        err2 = 'Line: ' + self.lines[self.line_num].rstrip()
+        self.error(err, err2)
+
+    def error(self, *err):
+        if self.ok and Verbose.level > Verbose.ONELINE:
+            print('Code format is not valid:')
+        self.ok = False
+        if Verbose.level < Verbose.NORMAL:
+            return
+        count = 0
+        for line in err:
+            prefix = (' *', '  ')[count > 0]
+            print(prefix, line)
+            count += 1
+
+class CheckOnePatch:
+    """Checks the contents of a git email formatted patch.
+
+    Various checks are performed on both the commit message and the
+    patch content.
+    """
+
+    def __init__(self, name, patch):
+        self.patch = patch
+        self.find_patch_pieces()
+
+        msg_check = CommitMessageCheck(self.commit_subject, self.commit_msg)
+        msg_ok = msg_check.ok
+
+        diff_ok = True
+        if self.diff is not None:
+            diff_check = GitDiffCheck(self.diff)
+            diff_ok = diff_check.ok
+
+        self.ok = msg_ok and diff_ok
+
+        if Verbose.level == Verbose.ONELINE:
+            if self.ok:
+                result = 'ok'
+            else:
+                result = list()
+                if not msg_ok:
+                    result.append('commit message')
+                if not diff_ok:
+                    result.append('diff content')
+                result = 'bad ' + ' and '.join(result)
+            print(name, result)
+
+
+    git_diff_re = re.compile(r'''
+                                 ^ diff \s+ --git \s+ a/.+ \s+ b/.+ $
+                             ''',
+                             re.IGNORECASE | re.VERBOSE | re.MULTILINE)
+
+    stat_re = \
+        re.compile(r'''
+                       (?P<commit_message> [\s\S\r\n]* )
+                       (?P<stat>
+                           ^ --- $ [\r\n]+
+                           (?: ^ \s+ .+ \s+ \| \s+ \d+ \s+ \+* \-*
+                               $ [\r\n]+ )+
+                           [\s\S\r\n]+
+                       )
+                   ''',
+                   re.IGNORECASE | re.VERBOSE | re.MULTILINE)
+
+    def find_patch_pieces(self):
+        if sys.version_info < (3, 0):
+            patch = self.patch.encode('ascii', 'ignore')
+        else:
+            patch = self.patch
+
+        self.commit_msg = None
+        self.stat = None
+        self.commit_subject = None
+        self.commit_prefix = None
+        self.diff = None
+
+        if patch.startswith('diff --git'):
+            self.diff = patch
+            return
+
+        pmail = email.message_from_string(patch)
+        parts = list(pmail.walk())
+        assert(len(parts) == 1)
+        assert(parts[0].get_content_type() == 'text/plain')
+        content = parts[0].get_payload(decode=True).decode('utf-8', 'ignore')
+
+        mo = self.git_diff_re.search(content)
+        if mo is not None:
+            self.diff = content[mo.start():]
+            content = content[:mo.start()]
+
+        mo = self.stat_re.search(content)
+        if mo is None:
+            self.commit_msg = content
+        else:
+            self.stat = mo.group('stat')
+            self.commit_msg = mo.group('commit_message')
+
+        self.commit_subject = pmail['subject'].replace('\r\n', '')
+        self.commit_subject = self.commit_subject.replace('\n', '')
+
+        pfx_start = self.commit_subject.find('[')
+        if pfx_start >= 0:
+            pfx_end = self.commit_subject.find(']')
+            if pfx_end > pfx_start:
+                self.commit_prefix = self.commit_subject[pfx_start + 1 : pfx_end]
+                self.commit_subject = self.commit_subject[pfx_end + 1 :].lstrip()
+
+
+class CheckGitCommits:
+    """Reads patches from git based on the specified git revision range.
+
+    The patches are read from git, and then checked.
+    """
+
+    def __init__(self, rev_spec, max_count):
+        commits = self.read_commit_list_from_git(rev_spec, max_count)
+        if len(commits) == 1 and Verbose.level > Verbose.ONELINE:
+            commits = [ rev_spec ]
+        self.ok = True
+        blank_line = False
+        for commit in commits:
+            if Verbose.level > Verbose.ONELINE:
+                if blank_line:
+                    print()
+                else:
+                    blank_line = True
+                print('Checking git commit:', commit)
+            patch = self.read_patch_from_git(commit)
+            self.ok &= CheckOnePatch(commit, patch).ok
+
+    def read_commit_list_from_git(self, rev_spec, max_count):
+        # Run git to get the commit patch
+        cmd = [ 'rev-list', '--abbrev-commit', '--no-walk' ]
+        if max_count is not None:
+            cmd.append('--max-count=' + str(max_count))
+        cmd.append(rev_spec)
+        out = self.run_git(*cmd)
+        return out.split()
+
+    def read_patch_from_git(self, commit):
+        # Run git to get the commit patch
+        return self.run_git('show', '--pretty=email', commit)
+
+    def run_git(self, *args):
+        cmd = [ 'git' ]
+        cmd += args
+        p = subprocess.Popen(cmd,
+                     stdout=subprocess.PIPE,
+                     stderr=subprocess.STDOUT)
+        return p.communicate()[0].decode('utf-8', 'ignore')
+
+class CheckOnePatchFile:
+    """Performs a patch check for a single file.
+
+    stdin is used when the filename is '-'.
+    """
+
+    def __init__(self, patch_filename):
+        if patch_filename == '-':
+            patch = sys.stdin.read()
+            patch_filename = 'stdin'
+        else:
+            f = open(patch_filename, 'rb')
+            patch = f.read().decode('utf-8', 'ignore')
+            f.close()
+        if Verbose.level > Verbose.ONELINE:
+            print('Checking patch file:', patch_filename)
+        self.ok = CheckOnePatch(patch_filename, patch).ok
+
+class CheckOneArg:
+    """Performs a patch check for a single command line argument.
+
+    The argument will be handed off to a file or git-commit based
+    checker.
+    """
+
+    def __init__(self, param, max_count=None):
+        self.ok = True
+        if param == '-' or os.path.exists(param):
+            checker = CheckOnePatchFile(param)
+        else:
+            checker = CheckGitCommits(param, max_count)
+        self.ok = checker.ok
+
+class PatchCheckApp:
+    """Checks patches based on the command line arguments."""
+
+    def __init__(self):
+        self.parse_options()
+        patches = self.args.patches
+
+        if len(patches) == 0:
+            patches = [ 'HEAD' ]
+
+        self.ok = True
+        self.count = None
+        for patch in patches:
+            self.process_one_arg(patch)
+
+        if self.count is not None:
+            self.process_one_arg('HEAD')
+
+        if self.ok:
+            self.retval = 0
+        else:
+            self.retval = -1
+
+    def process_one_arg(self, arg):
+        if len(arg) >= 2 and arg[0] == '-':
+            try:
+                self.count = int(arg[1:])
+                return
+            except ValueError:
+                pass
+        self.ok &= CheckOneArg(arg, self.count).ok
+        self.count = None
+
+    def parse_options(self):
+        parser = argparse.ArgumentParser(description=__copyright__)
+        parser.add_argument('--version', action='version',
+                            version='%(prog)s ' + VersionNumber)
+        parser.add_argument('patches', nargs='*',
+                            help='[patch file | git rev list]')
+        group = parser.add_mutually_exclusive_group()
+        group.add_argument("--oneline",
+                           action="store_true",
+                           help="Print one result per line")
+        group.add_argument("--silent",
+                           action="store_true",
+                           help="Print nothing")
+        self.args = parser.parse_args()
+        if self.args.oneline:
+            Verbose.level = Verbose.ONELINE
+        if self.args.silent:
+            Verbose.level = Verbose.SILENT
+
+if __name__ == "__main__":
+    sys.exit(PatchCheckApp().retval)
diff --git a/BaseTools/Source/Python/Common/MultipleWorkspace.py b/BaseTools/Source/Python/Common/MultipleWorkspace.py
new file mode 100644
index 000000000000..feb1f8d5ebe6
--- /dev/null
+++ b/BaseTools/Source/Python/Common/MultipleWorkspace.py
@@ -0,0 +1,148 @@
+## @file
+# manage multiple workspace file.
+#
+# This file is required to make Python interpreter treat the directory
+# as containing package.
+#
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+
+import Common.LongFilePathOs as os
+from Common.DataType import TAB_WORKSPACE
+
+## MultipleWorkspace
+#
+# This class manage multiple workspace behavior
+# 
+# @param class:
+#
+# @var WORKSPACE:      defined the current WORKSPACE
+# @var PACKAGES_PATH:  defined the other WORKSAPCE, if current WORKSPACE is invalid, search valid WORKSPACE from PACKAGES_PATH
+# 
+class MultipleWorkspace(object):
+    WORKSPACE = ''
+    PACKAGES_PATH = None
+    
+    ## convertPackagePath()
+    #
+    #   Convert path to match workspace.
+    #
+    #   @param  cls          The class pointer
+    #   @param  Ws           The current WORKSPACE
+    #   @param  Path         Path to be converted to match workspace.
+    #
+    @classmethod
+    def convertPackagePath(cls, Ws, Path):
+        if str(os.path.normcase (Path)).startswith(Ws):
+            return os.path.join(Ws, os.path.relpath(Path, Ws))
+        return Path
+
+    ## setWs()
+    #
+    #   set WORKSPACE and PACKAGES_PATH environment
+    #
+    #   @param  cls          The class pointer
+    #   @param  Ws           initialize WORKSPACE variable
+    #   @param  PackagesPath initialize PackagesPath variable
+    #
+    @classmethod
+    def setWs(cls, Ws, PackagesPath=None):
+        cls.WORKSPACE = Ws
+        if PackagesPath:
+            cls.PACKAGES_PATH = [cls.convertPackagePath (Ws, os.path.normpath(Path.strip())) for Path in PackagesPath.split(os.pathsep)]
+        else:
+            cls.PACKAGES_PATH = []
+    
+    ## join()
+    #
+    #   rewrite os.path.join function
+    #
+    #   @param  cls       The class pointer
+    #   @param  Ws        the current WORKSPACE
+    #   @param  *p        path of the inf/dec/dsc/fdf/conf file
+    #   @retval Path      the absolute path of specified file
+    #
+    @classmethod
+    def join(cls, Ws, *p):
+        Path = os.path.join(Ws, *p)
+        if not os.path.exists(Path):
+            for Pkg in cls.PACKAGES_PATH:
+                Path = os.path.join(Pkg, *p)
+                if os.path.exists(Path):
+                    return Path
+            Path = os.path.join(Ws, *p)
+        return Path
+    
+    ## relpath()
+    #
+    #   rewrite os.path.relpath function
+    #
+    #   @param  cls       The class pointer
+    #   @param  Path      path of the inf/dec/dsc/fdf/conf file
+    #   @param  Ws        the current WORKSPACE
+    #   @retval Path      the relative path of specified file
+    #
+    @classmethod
+    def relpath(cls, Path, Ws):
+        for Pkg in cls.PACKAGES_PATH:
+            if Path.lower().startswith(Pkg.lower()):
+                Path = os.path.relpath(Path, Pkg)
+                return Path
+        if Path.lower().startswith(Ws.lower()):
+            Path = os.path.relpath(Path, Ws)
+        return Path
+    
+    ## getWs()
+    #
+    #   get valid workspace for the path
+    #
+    #   @param  cls       The class pointer
+    #   @param  Ws        the current WORKSPACE
+    #   @param  Path      path of the inf/dec/dsc/fdf/conf file
+    #   @retval Ws        the valid workspace relative to the specified file path
+    #
+    @classmethod
+    def getWs(cls, Ws, Path):
+        absPath = os.path.join(Ws, Path)
+        if not os.path.exists(absPath):
+            for Pkg in cls.PACKAGES_PATH:
+                absPath = os.path.join(Pkg, Path)
+                if os.path.exists(absPath):
+                    return Pkg
+        return Ws
+    
+    ## handleWsMacro()
+    #
+    #   handle the $(WORKSPACE) tag, if current workspace is invalid path relative the tool, replace it.
+    #
+    #   @param  cls       The class pointer
+    #   @retval PathStr   Path string include the $(WORKSPACE)
+    #
+    @classmethod
+    def handleWsMacro(cls, PathStr):
+        if TAB_WORKSPACE in PathStr:
+            Path = PathStr.replace(TAB_WORKSPACE, cls.WORKSPACE).strip()
+            if not os.path.exists(Path):
+                for Pkg in cls.PACKAGES_PATH:
+                    Path = PathStr.replace(TAB_WORKSPACE, Pkg).strip()
+                    if os.path.exists(Path):
+                        return Path
+        return PathStr
+    
+    ## getPkgPath()
+    #
+    #   get all package pathes.
+    #
+    #   @param  cls       The class pointer
+    #
+    @classmethod
+    def getPkgPath(cls):
+        return cls.PACKAGES_PATH
+            
\ No newline at end of file

From 564fc1ffa38b802c553039292b1d74d2dd6f485e Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:13:42 +0000
Subject: [PATCH 165/525] MdePkg SerialIo.h: Fix typo "buts" to "bits"

(Sync patch r18907 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19008 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Protocol/SerialIo.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/MdePkg/Include/Protocol/SerialIo.h b/MdePkg/Include/Protocol/SerialIo.h
index c66abef818c0..31cd46614ed0 100644
--- a/MdePkg/Include/Protocol/SerialIo.h
+++ b/MdePkg/Include/Protocol/SerialIo.h
@@ -4,7 +4,7 @@
   Abstraction of a basic serial device. Targeted at 16550 UART, but
   could be much more generic.
 
-  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials                          
   are licensed and made available under the terms and conditions of the BSD License         
   which accompanies this distribution.  The full text of the license may be found at        
@@ -105,7 +105,7 @@ EFI_STATUS
 
 /**
   Sets the baud rate, receive FIFO depth, transmit/receice time out, parity, 
-  data buts, and stop bits on a serial device.
+  data bits, and stop bits on a serial device.
 
   @param  This             Protocol instance pointer.
   @param  BaudRate         The requested baud rate. A BaudRate value of 0 will use the

From 960da7f74c795d4ac26732a944aeb0d71915c4b6 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:14:14 +0000
Subject: [PATCH 166/525] MdePkg SerialPortLib:  Fix typo in SerialPortWrite()

The "read" word in SerialPortWrite() header comment block should be
"write".

(Sync patch r18908 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19009 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/SerialPortLib.h                       | 4 ++--
 MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/MdePkg/Include/Library/SerialPortLib.h b/MdePkg/Include/Library/SerialPortLib.h
index 8f957864d858..1b129a71c1d8 100644
--- a/MdePkg/Include/Library/SerialPortLib.h
+++ b/MdePkg/Include/Library/SerialPortLib.h
@@ -1,7 +1,7 @@
 /** @file
   This library class provides common serial I/O port functions.
 
-Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -46,7 +46,7 @@ SerialPortInitialize (
 
   @retval 0                NumberOfBytes is 0.
   @retval >0               The number of bytes written to the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
+                           If this value is less than NumberOfBytes, then the write operation failed.
 
 **/
 UINTN
diff --git a/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c b/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
index d44fa523c2d8..72ae23815b37 100644
--- a/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
+++ b/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
@@ -1,7 +1,7 @@
 /** @file
   Null Serial Port library instance with empty functions.
 
-  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -50,7 +50,7 @@ SerialPortInitialize (
 
   @retval 0                NumberOfBytes is 0.
   @retval >0               The number of bytes written to the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
+                           If this value is less than NumberOfBytes, then the write operation failed.
 
 **/
 UINTN

From f7c016a6ae6e8f2a5464b5f0afd9f65014925903 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:14:42 +0000
Subject: [PATCH 167/525] PcAtChipsetPkg SerialIoLib:  Fix typo in
 SerialPortWrite()

The "read" word in SerialPortWrite() header comment block should be
"write".

(Sync patch r18909 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19010 6f19259b-4bc3-4df7-8a09-765794883524
---
 PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c b/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
index 6bf705312d88..b364a5c8ab2c 100644
--- a/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
+++ b/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
@@ -1,7 +1,7 @@
 /** @file
   UART Serial Port library functions
 
-  Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -118,7 +118,7 @@ SerialPortInitialize (
 
   @retval 0                NumberOfBytes is 0.
   @retval >0               The number of bytes written to the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
+                           If this value is less than NumberOfBytes, then the write operation failed.
 
 **/
 UINTN

From 714246d34b1f6541d9294e501b01f05083794876 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:15:07 +0000
Subject: [PATCH 168/525] MdeModulePkg BaseSerialPortLib16550: Fix typo in
 SerialPortWrite()

The "read" word in SerialPortWrite() header comment block should be
"write".

(Sync patch r18910 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19011 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c b/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
index 3209115a3f88..5b6608d40082 100644
--- a/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
+++ b/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
@@ -574,7 +574,7 @@ SerialPortInitialize (
 
   @retval 0                NumberOfBytes is 0.
   @retval >0               The number of bytes written to the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
+                           If this value is less than NumberOfBytes, then the write operation failed.
 
 **/
 UINTN

From 5b57cac303683249163eb55e6a8bce30ff03a6d3 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:15:41 +0000
Subject: [PATCH 169/525] MdeModulePkg: TerminalDxe: avoid checking
 uninitialized variable

The SerialIo->GetControl() function is not required to set the
Control output parameter on error. Make sure we apply the
EFI_SERIAL_INPUT_BUFFER_EMPTY optimization in
TerminalConInTimerHandler() only if the SerialIo->GetControl()
function call set that bit in the Control variable.

(Sync patch r18962 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Feng Tian <feng.tian@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Suggested-by: Laszlo Ersek <lersek@redhat.com>
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19012 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c b/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c
index c216ed900fc5..3be877b4661e 100644
--- a/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c
+++ b/MdeModulePkg/Universal/Console/TerminalDxe/TerminalConIn.c
@@ -2,7 +2,7 @@
   Implementation for EFI_SIMPLE_TEXT_INPUT_PROTOCOL protocol.
 
 (C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>
-Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -562,10 +562,11 @@ TerminalConInTimerHandler (
   }
   //
   // Check whether serial buffer is empty.
+  // Skip the key transfer loop only if the SerialIo protocol instance
+  // successfully reports EFI_SERIAL_INPUT_BUFFER_EMPTY.
   //
   Status = SerialIo->GetControl (SerialIo, &Control);
-
-  if ((Control & EFI_SERIAL_INPUT_BUFFER_EMPTY) == 0) {
+  if (EFI_ERROR (Status) || ((Control & EFI_SERIAL_INPUT_BUFFER_EMPTY) == 0)) {
     //
     // Fetch all the keys in the serial buffer,
     // and insert the byte stream into RawFIFO.

From caba346f89d3bad2f0eef8db4a81b305d32557d6 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:16:14 +0000
Subject: [PATCH 170/525] MdePkg SerialPortLib: Upstream
 Get(Set)Control/SetAttributes interfaces

The extended interfaces GetControl/SetControl/SetAttributes are from
EmbeddedPkg/Include/Library/SerialPortExtLib.h.

(Sync patch r18963 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19013 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/SerialPortLib.h        | 80 +++++++++++++++++
 .../BaseSerialPortLibNull.c                   | 85 +++++++++++++++++++
 2 files changed, 165 insertions(+)

diff --git a/MdePkg/Include/Library/SerialPortLib.h b/MdePkg/Include/Library/SerialPortLib.h
index 1b129a71c1d8..965a2d964b02 100644
--- a/MdePkg/Include/Library/SerialPortLib.h
+++ b/MdePkg/Include/Library/SerialPortLib.h
@@ -2,6 +2,7 @@
   This library class provides common serial I/O port functions.
 
 Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2012 - 2014, ARM Ltd. All rights reserved.
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -15,6 +16,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #ifndef __SERIAL_PORT_LIB__
 #define __SERIAL_PORT_LIB__
 
+#include <Uefi/UefiBaseType.h>
+#include <Protocol/SerialIo.h>
+
 /**
   Initialize the serial device hardware.
   
@@ -97,4 +101,80 @@ SerialPortPoll (
   VOID
   );
 
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  );
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  );
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  );
+
 #endif
diff --git a/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c b/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
index 72ae23815b37..e29fdf55bbfb 100644
--- a/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
+++ b/MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.c
@@ -110,3 +110,88 @@ SerialPortPoll (
   return FALSE;
 }
 
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+

From 877d347b3e6b0ad5fd505e492448657212edb5c1 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:16:39 +0000
Subject: [PATCH 171/525] PcAtChipsetPkg SerialIoLib: Implement
 Get(Set)Control/SetAttributes

(Sync patch r18964 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19014 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/SerialIoLib/SerialPortLib.c       | 276 ++++++++++++++++++
 1 file changed, 276 insertions(+)

diff --git a/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c b/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
index b364a5c8ab2c..8656785347b2 100644
--- a/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
+++ b/PcAtChipsetPkg/Library/SerialIoLib/SerialPortLib.c
@@ -39,6 +39,12 @@
 #define LSR_TXRDY               0x20
 #define LSR_RXDA                0x01
 #define DLAB                    0x01
+#define MCR_DTRC                0x01
+#define MCR_RTS                 0x02
+#define MSR_CTS                 0x10
+#define MSR_DSR                 0x20
+#define MSR_RI                  0x40
+#define MSR_DCD                 0x80
 
 //---------------------------------------------
 // UART Settings
@@ -219,3 +225,273 @@ SerialPortPoll (
   return (BOOLEAN) ((Data & LSR_RXDA) != 0);
 }
 
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  UINT8 Mcr;
+
+  //
+  // First determine the parameter is invalid.
+  //
+  if ((Control & (~(EFI_SERIAL_REQUEST_TO_SEND | EFI_SERIAL_DATA_TERMINAL_READY))) != 0) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  //
+  // Read the Modem Control Register.
+  //
+  Mcr = IoRead8 ((UINT16) gUartBase + MCR_OFFSET);
+  Mcr &= (~(MCR_DTRC | MCR_RTS));
+
+  if ((Control & EFI_SERIAL_DATA_TERMINAL_READY) == EFI_SERIAL_DATA_TERMINAL_READY) {
+    Mcr |= MCR_DTRC;
+  }
+
+  if ((Control & EFI_SERIAL_REQUEST_TO_SEND) == EFI_SERIAL_REQUEST_TO_SEND) {
+    Mcr |= MCR_RTS;
+  }
+
+  //
+  // Write the Modem Control Register.
+  //
+  IoWrite8 ((UINT16) gUartBase + MCR_OFFSET, Mcr);
+
+  return RETURN_SUCCESS;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  UINT8 Msr;
+  UINT8 Mcr;
+  UINT8 Lsr;
+
+  *Control = 0;
+
+  //
+  // Read the Modem Status Register.
+  //
+  Msr = IoRead8 ((UINT16) gUartBase + MSR_OFFSET);
+
+  if ((Msr & MSR_CTS) == MSR_CTS) {
+    *Control |= EFI_SERIAL_CLEAR_TO_SEND;
+  }
+
+  if ((Msr & MSR_DSR) == MSR_DSR) {
+    *Control |= EFI_SERIAL_DATA_SET_READY;
+  }
+
+  if ((Msr & MSR_RI) == MSR_RI) {
+    *Control |= EFI_SERIAL_RING_INDICATE;
+  }
+
+  if ((Msr & MSR_DCD) == MSR_DCD) {
+    *Control |= EFI_SERIAL_CARRIER_DETECT;
+  }
+
+  //
+  // Read the Modem Control Register.
+  //
+  Mcr = IoRead8 ((UINT16) gUartBase + MCR_OFFSET);
+
+  if ((Mcr & MCR_DTRC) == MCR_DTRC) {
+    *Control |= EFI_SERIAL_DATA_TERMINAL_READY;
+  }
+
+  if ((Mcr & MCR_RTS) == MCR_RTS) {
+    *Control |= EFI_SERIAL_REQUEST_TO_SEND;
+  }
+
+  //
+  // Read the Line Status Register.
+  //
+  Lsr = IoRead8 ((UINT16) gUartBase + LSR_OFFSET);
+
+  if ((Lsr & LSR_TXRDY) == LSR_TXRDY) {
+    *Control |= EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
+  }
+
+  if ((Lsr & LSR_RXDA) == 0) {
+    *Control |= EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+
+  return RETURN_SUCCESS;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  UINTN Divisor;
+  UINT8 OutputData;
+  UINT8 LcrData;
+  UINT8 LcrParity;
+  UINT8 LcrStop;
+
+  //
+  // Check for default settings and fill in actual values.
+  //
+  if (*BaudRate == 0) {
+    *BaudRate = gBps;
+  }
+
+  if (*DataBits == 0) {
+    *DataBits = gData;
+  }
+
+  if (*Parity == DefaultParity) {
+    *Parity = NoParity;
+  }
+
+  if (*StopBits == DefaultStopBits) {
+    *StopBits = OneStopBit;
+  }
+
+  if ((*DataBits < 5) || (*DataBits > 8)) {
+    return RETURN_INVALID_PARAMETER;
+  }
+
+  if ((*Parity < NoParity) || (*Parity > SpaceParity)) {
+    return RETURN_INVALID_PARAMETER;
+  }
+
+  if ((*StopBits < OneStopBit) || (*StopBits > TwoStopBits)) {
+    return RETURN_INVALID_PARAMETER;
+  }
+
+  //
+  // Map 5..8 to 0..3
+  //
+  LcrData = (UINT8) (*DataBits - (UINT8) 5);
+
+  switch (*Parity) {
+    case NoParity:
+      LcrParity = 0;
+      break;
+
+    case EvenParity:
+      LcrParity = 3;
+      break;
+
+    case OddParity:
+      LcrParity = 1;
+      break;
+
+    case SpaceParity:
+      LcrParity = 7;
+      break;
+
+    case MarkParity:
+      LcrParity = 5;
+      break;
+
+    default:
+      break;
+  }
+
+  switch (*StopBits) {
+    case OneStopBit:
+      LcrStop = 0;
+      break;
+
+    case OneFiveStopBits:
+    case TwoStopBits:
+      LcrStop = 1;
+      break;
+
+    default:
+      break;
+  }
+
+  //
+  // Calculate divisor for baud generator
+  //
+  Divisor = 115200 / (UINTN) *BaudRate;
+
+  //
+  // Set communications format
+  //
+  OutputData = (UINT8) ((DLAB << 7) | (gBreakSet << 6) | (LcrParity << 3) | (LcrStop << 2) | LcrData);
+  IoWrite8 ((UINTN) (gUartBase + LCR_OFFSET), OutputData);
+
+  //
+  // Configure baud rate
+  //
+  IoWrite8 ((UINTN) (gUartBase + BAUD_HIGH_OFFSET), (UINT8) (Divisor >> 8));
+  IoWrite8 ((UINTN) (gUartBase + BAUD_LOW_OFFSET), (UINT8) (Divisor & 0xff));
+
+  //
+  // Switch back to bank 0
+  //
+  OutputData = (UINT8) ((~DLAB << 7) | (gBreakSet << 6) | (LcrParity << 3) | (LcrStop << 2) | LcrData);
+  IoWrite8 ((UINTN) (gUartBase + LCR_OFFSET), OutputData);
+
+  return RETURN_SUCCESS;
+}
+

From f840bd9cbe2c46bab903186b6b8562b2bb35eaba Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:17:04 +0000
Subject: [PATCH 172/525] MdeModulePkg BaseSerialPortLib16550:Implement
 Get(Set)Control/SetAttributes

(Sync patch r18965 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Feng Tian <feng.tian@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19015 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BaseSerialPortLib16550.c                  | 337 ++++++++++++++++++
 1 file changed, 337 insertions(+)

diff --git a/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c b/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
index 5b6608d40082..f4fc31913bea 100644
--- a/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
+++ b/MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.c
@@ -40,6 +40,7 @@
 #define R_UART_LCR            3
 #define   B_UART_LCR_DLAB     BIT7
 #define R_UART_MCR            4
+#define   B_UART_MCR_DTRC     BIT0
 #define   B_UART_MCR_RTS      BIT1
 #define R_UART_LSR            5
 #define   B_UART_LSR_RXRDY    BIT0
@@ -48,6 +49,8 @@
 #define R_UART_MSR            6
 #define   B_UART_MSR_CTS      BIT4
 #define   B_UART_MSR_DSR      BIT5
+#define   B_UART_MSR_RI       BIT6
+#define   B_UART_MSR_DCD      BIT7
 
 //
 // 4-byte structure for each PCI node in PcdSerialPciDeviceInfo
@@ -761,3 +764,337 @@ SerialPortPoll (
   
   return FALSE;
 }
+
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  UINTN SerialRegisterBase;
+  UINT8 Mcr;
+
+  //
+  // First determine the parameter is invalid.
+  //
+  if ((Control & (~(EFI_SERIAL_REQUEST_TO_SEND | EFI_SERIAL_DATA_TERMINAL_READY |
+                    EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE))) != 0) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  SerialRegisterBase = GetSerialRegisterBase ();
+  if (SerialRegisterBase ==0) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  //
+  // Read the Modem Control Register.
+  //
+  Mcr = SerialPortReadRegister (SerialRegisterBase, R_UART_MCR);
+  Mcr &= (~(B_UART_MCR_DTRC | B_UART_MCR_RTS));
+
+  if ((Control & EFI_SERIAL_DATA_TERMINAL_READY) == EFI_SERIAL_DATA_TERMINAL_READY) {
+    Mcr |= B_UART_MCR_DTRC;
+  }
+
+  if ((Control & EFI_SERIAL_REQUEST_TO_SEND) == EFI_SERIAL_REQUEST_TO_SEND) {
+    Mcr |= B_UART_MCR_RTS;
+  }
+
+  //
+  // Write the Modem Control Register.
+  //
+  SerialPortWriteRegister (SerialRegisterBase, R_UART_MCR, Mcr);
+
+  return RETURN_SUCCESS;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  UINTN SerialRegisterBase;
+  UINT8 Msr;
+  UINT8 Mcr;
+  UINT8 Lsr;
+
+  SerialRegisterBase = GetSerialRegisterBase ();
+  if (SerialRegisterBase ==0) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  *Control = 0;
+
+  //
+  // Read the Modem Status Register.
+  //
+  Msr = SerialPortReadRegister (SerialRegisterBase, R_UART_MSR);
+
+  if ((Msr & B_UART_MSR_CTS) == B_UART_MSR_CTS) {
+    *Control |= EFI_SERIAL_CLEAR_TO_SEND;
+  }
+
+  if ((Msr & B_UART_MSR_DSR) == B_UART_MSR_DSR) {
+    *Control |= EFI_SERIAL_DATA_SET_READY;
+  }
+
+  if ((Msr & B_UART_MSR_RI) == B_UART_MSR_RI) {
+    *Control |= EFI_SERIAL_RING_INDICATE;
+  }
+
+  if ((Msr & B_UART_MSR_DCD) == B_UART_MSR_DCD) {
+    *Control |= EFI_SERIAL_CARRIER_DETECT;
+  }
+
+  //
+  // Read the Modem Control Register.
+  //
+  Mcr = SerialPortReadRegister (SerialRegisterBase, R_UART_MCR);
+
+  if ((Mcr & B_UART_MCR_DTRC) == B_UART_MCR_DTRC) {
+    *Control |= EFI_SERIAL_DATA_TERMINAL_READY;
+  }
+
+  if ((Mcr & B_UART_MCR_RTS) == B_UART_MCR_RTS) {
+    *Control |= EFI_SERIAL_REQUEST_TO_SEND;
+  }
+
+  if (PcdGetBool (PcdSerialUseHardwareFlowControl)) {
+    *Control |= EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+  }
+
+  //
+  // Read the Line Status Register.
+  //
+  Lsr = SerialPortReadRegister (SerialRegisterBase, R_UART_LSR);
+
+  if ((Lsr & (B_UART_LSR_TEMT | B_UART_LSR_TXRDY)) == (B_UART_LSR_TEMT | B_UART_LSR_TXRDY)) {
+    *Control |= EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
+  }
+
+  if ((Lsr & B_UART_LSR_RXRDY) == 0) {
+    *Control |= EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+
+  return RETURN_SUCCESS;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  UINTN     SerialRegisterBase;
+  UINT32    SerialBaudRate;
+  UINTN     Divisor;
+  UINT8     Lcr;
+  UINT8     LcrData;
+  UINT8     LcrParity;
+  UINT8     LcrStop;
+
+  SerialRegisterBase = GetSerialRegisterBase ();
+  if (SerialRegisterBase ==0) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  //
+  // Check for default settings and fill in actual values.
+  //
+  if (*BaudRate == 0) {
+    *BaudRate = PcdGet32 (PcdSerialBaudRate);
+  }
+  SerialBaudRate = (UINT32) *BaudRate;
+
+  if (*DataBits == 0) {
+    LcrData = (UINT8) (PcdGet8 (PcdSerialLineControl) & 0x3);
+    *DataBits = LcrData + 5;
+  } else {
+    if ((*DataBits < 5) || (*DataBits > 8)) {
+      return RETURN_INVALID_PARAMETER;
+    }
+    //
+    // Map 5..8 to 0..3
+    //
+    LcrData = (UINT8) (*DataBits - (UINT8) 5);
+  }
+
+  if (*Parity == DefaultParity) {
+    LcrParity = (UINT8) ((PcdGet8 (PcdSerialLineControl) >> 3) & 0x7);
+    switch (LcrParity) {
+      case 0:
+        *Parity = NoParity;
+        break;
+
+      case 3:
+        *Parity = EvenParity;
+        break;
+
+      case 1:
+        *Parity = OddParity;
+        break;
+
+      case 7:
+        *Parity = SpaceParity;
+        break;
+
+      case 5:
+        *Parity = MarkParity;
+        break;
+
+      default:
+        break;
+    }
+  } else {
+    if ((*Parity < NoParity) || (*Parity > SpaceParity)) {
+      return RETURN_INVALID_PARAMETER;
+    }
+    switch (*Parity) {
+      case NoParity:
+        LcrParity = 0;
+        break;
+
+      case EvenParity:
+        LcrParity = 3;
+        break;
+
+      case OddParity:
+        LcrParity = 1;
+        break;
+
+      case SpaceParity:
+        LcrParity = 7;
+        break;
+
+      case MarkParity:
+        LcrParity = 5;
+        break;
+
+      default:
+        break;
+    }
+  }
+
+  if (*StopBits == DefaultStopBits) {
+    LcrStop = (UINT8) ((PcdGet8 (PcdSerialLineControl) >> 2) & 0x1);
+    switch (LcrStop) {
+      case 0:
+        *StopBits = OneStopBit;
+        break;
+
+      case 1:
+        if (*DataBits == 5) {
+          *StopBits = OneFiveStopBits;
+        } else {
+          *StopBits = TwoStopBits;
+        }
+        break;
+
+      default:
+        break;
+    }
+  } else {
+    if ((*StopBits < OneStopBit) || (*StopBits > TwoStopBits)) {
+      return RETURN_INVALID_PARAMETER;
+    }
+    switch (*StopBits) {
+      case OneStopBit:
+        LcrStop = 0;
+        break;
+
+      case OneFiveStopBits:
+      case TwoStopBits:
+        LcrStop = 1;
+        break;
+
+      default:
+        break;
+    }
+  }
+
+  //
+  // Calculate divisor for baud generator
+  //    Ref_Clk_Rate / Baud_Rate / 16
+  //
+  Divisor = PcdGet32 (PcdSerialClockRate) / (SerialBaudRate * 16);
+  if ((PcdGet32 (PcdSerialClockRate) % (SerialBaudRate * 16)) >= SerialBaudRate * 8) {
+    Divisor++;
+  }
+
+  //
+  // Configure baud rate
+  //
+  SerialPortWriteRegister (SerialRegisterBase, R_UART_LCR, B_UART_LCR_DLAB);
+  SerialPortWriteRegister (SerialRegisterBase, R_UART_BAUD_HIGH, (UINT8) (Divisor >> 8));
+  SerialPortWriteRegister (SerialRegisterBase, R_UART_BAUD_LOW, (UINT8) (Divisor & 0xff));
+
+  //
+  // Clear DLAB and configure Data Bits, Parity, and Stop Bits.
+  // Strip reserved bits from line control value
+  //
+  Lcr = (UINT8) ((LcrParity << 3) | (LcrStop << 2) | LcrData);
+  SerialPortWriteRegister (SerialRegisterBase, R_UART_LCR, (UINT8) (Lcr & 0x3F));
+
+  return RETURN_SUCCESS;
+}
+

From 6e191400ecaf98dc7cdb9750fbf9af7cbc48b15a Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:17:29 +0000
Subject: [PATCH 173/525] MdeModulePkg: Upstream SerialDxe from EmbeddedPkg

This Serial driver layers on top of a Serial Port Library instance
to produce serial IO protocol.

There is also another SerialDxe implementation in CorebootPayloadPkg,
but SerialDxe from EmbeddedPkg should be better that also consumes
the extended interfaces GetControl/SetControl/SetAttributes in
EmbeddedPkg/Include/Library/SerialPortExtLib.h for serial IO protocol.
And the extended interfaces GetControl/SetControl/SetAttributes in
EmbeddedPkg/Include/Library/SerialPortExtLib.h has been upstream to
MdePkg/Include/Library/SerialPortLib.h.

(Sync patch r18966 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Feng Tian <feng.tian@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19016 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dsc                 |   2 +
 .../Universal/SerialDxe/SerialDxe.inf         |  49 ++
 .../Universal/SerialDxe/SerialDxe.uni         | Bin 0 -> 1892 bytes
 .../Universal/SerialDxe/SerialDxeExtra.uni    | Bin 0 -> 1324 bytes
 MdeModulePkg/Universal/SerialDxe/SerialIo.c   | 526 ++++++++++++++++++
 5 files changed, 577 insertions(+)
 create mode 100644 MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 create mode 100644 MdeModulePkg/Universal/SerialDxe/SerialDxe.uni
 create mode 100644 MdeModulePkg/Universal/SerialDxe/SerialDxeExtra.uni
 create mode 100644 MdeModulePkg/Universal/SerialDxe/SerialIo.c

diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index c43093260453..602b4bba818f 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -370,6 +370,8 @@
   
   MdeModulePkg/Universal/PropertiesTableAttributesDxe/PropertiesTableAttributesDxe.inf
 
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
+
 [Components.IA32, Components.X64, Components.IPF]  
   MdeModulePkg/Universal/Network/UefiPxeBcDxe/UefiPxeBcDxe.inf
   MdeModulePkg/Universal/DebugSupportDxe/DebugSupportDxe.inf
diff --git a/MdeModulePkg/Universal/SerialDxe/SerialDxe.inf b/MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
new file mode 100644
index 000000000000..145101b708df
--- /dev/null
+++ b/MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
@@ -0,0 +1,49 @@
+## @file
+#  Serial driver that layers on top of a Serial Port Library instance.
+#
+#  Copyright (c) 2008 - 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SerialDxe
+  FILE_GUID                      = D3987D4B-971A-435F-8CAF-4967EB627241
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+
+  ENTRY_POINT                    = SerialDxeInitialize
+
+[Sources.common]
+  SerialIo.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+
+[LibraryClasses]
+  UefiDriverEntryPoint
+  UefiBootServicesTableLib
+  DebugLib
+  PcdLib
+  SerialPortLib
+
+[Protocols]
+  gEfiSerialIoProtocolGuid      ## PRODUCES
+  gEfiDevicePathProtocolGuid    ## PRODUCES
+
+[Pcd]
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity   ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits ## CONSUMES
+
+[Depex]
+  TRUE
diff --git a/MdeModulePkg/Universal/SerialDxe/SerialDxe.uni b/MdeModulePkg/Universal/SerialDxe/SerialDxe.uni
new file mode 100644
index 0000000000000000000000000000000000000000..9df8bea8aaae0a1f5a77571fc823eb758a43dd0e
GIT binary patch
literal 1892
zcmdUv-HX#u5XI+N@P7#17nR*s1wll_){Pp}P3Z@#Pm;FVZeZI=8h7nKzw7VJZIf0i
z_@)waKju!(oH;W$cegETS;YH@C$iTzwcM`k!tUEWtUBwnE3jtRBb)g8+HH}Qc8R^j
ze#N|Y>x$jd7K|nHH{VSeGv0lyF6V`R{So{T>x_4eU(WX{PBP{(sLhJczt8K9XT5fv
zX6Pez9+1UD=BM_U=Q*pB&F+akvt!l?nU-WKjfGI4oJOgevs$1*WNpsnp?U;tsa^2h
z%C%QrCV0NIj`i%-0o4XD%JGiCFTkC7j5&L0Jz-W&FML0S_0r~e>TK;*nQ=0AR&`gb
zsyIRs8}&o(l~WzXsm9mWlTCzc*6O#6>Z|J_`|d1+T{Dp`1yRL%%Tmn5H?Q;weWy;_
zX3(MEPT8xw)J1_y-9b05#h6jJ``PCB3sG1>FU3+%O8XH!ck3cm#eRxCR7jkE;G?^+
z%V}Siprtx~wE2FyQ9z8!9bMH&C6##Lw^H{i<RkyWvuhHmpq{N?v|nKv!F)o`?MH8d
za>-jOGO+g+!=_93r1p-nZJ*dDC>f!p<^k4({u;81UEiUdF~`^=YyqLxKB1puJo=8D
zvQi&wY%mK~s14?h@3lML;dIWqP*aZ>**RW4XLg1?0aX~ONAIx{ci9wkfUkTMHF&+n
zSJA&Pf8a#Sb^qc`l#oSipDUaiJwb~u-K3bO2meX>i?*D*G}U`l^~{3W=np9UzJip3
zF$67U*CzLH(nhTTe!qK;sG;t_jJjux>N<7830Pv<V61QE-}+xSDh>WDe|1lv%+*=l
Rs$z#U_&@S*Qip8^`~=5~DT)99

literal 0
HcmV?d00001

diff --git a/MdeModulePkg/Universal/SerialDxe/SerialDxeExtra.uni b/MdeModulePkg/Universal/SerialDxe/SerialDxeExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..bfb8420d055ce7cbf6dbdd8268a9d7d99257d2ac
GIT binary patch
literal 1324
zcmZvcTW`}q5QXO%iT|()FM!$vkdP2Uh=v%jC{2_mDm+C_LQ_k*R89&FKOXqbtS?PL
zmiIDy_RQI{WB>Wxv5p1ar#!*l*`?*SwD0!N9uU>qIkSRjM!aXY%z~ZT#%3PL?H7@`
z<93c)+rqZYGh2K7J=nGFK&h>Gt3H_4uWj#p7j^|E*kjnA(7&)}Jg*oXm$T>g(vBFX
zCFhc{7z#MlX6(;BW1E!|Gz%g9kz2|Nv}}0``{CN#_Qtw4w736JH$qYF=eY*Ifkio1
zuvF*UfsiK|nr9$ZDAC%Ueexm@k*dbUZJkHEq$Z#;XSY0(GWl8YYxmqS8G18tOWG-|
z_T8{Us|DjqNzAo6xCJQ_GOzuS6C3Wk+1KT+d(2M{v@|#M)4iC{{(IUS4Pumr=$CSB
znalerI`7_#T$TDu;_-&0`4-H5O^3cjFZZCP<^E0SfD|>=72x0TT-$4}VpUl5R`|l5
zZgcvA`{~^CeoJJE@;Nnkn7s|l6>sCn$Ua$ungP|*w~w?Z_Jw(hlL0T)kBFw!*O*b_
z{*LX8J|P~6MTW-vlzL7;oI7)$k?L4&i(b59ZP9mquG!HYO&6?-weJ~&U4R<8vNPf-
ztm5c<_8~KAS4=raV1-fEi249l*}u_$W<|>N{Uv3Vc#6cn);tY+iWdW_NjZDgt~ECP
z>95oAxMGj$dWqjn^lnnRJAh?apI`!aAJ#GaiA~TY=XDp6N#BTAZs-?YE4u$<@X{wt
Vi&67UR)4mh*Q@>u1qk7)_b(`Z%trtK

literal 0
HcmV?d00001

diff --git a/MdeModulePkg/Universal/SerialDxe/SerialIo.c b/MdeModulePkg/Universal/SerialDxe/SerialIo.c
new file mode 100644
index 000000000000..de928d1719e9
--- /dev/null
+++ b/MdeModulePkg/Universal/SerialDxe/SerialIo.c
@@ -0,0 +1,526 @@
+/** @file
+  Serial driver that layers on top of a Serial Port Library instance.
+
+  Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
+  Copyright (c) 2013-2014, ARM Ltd. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/SerialPortLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PcdLib.h>
+
+#include <Protocol/SerialIo.h>
+#include <Protocol/DevicePath.h>
+
+typedef struct {
+  VENDOR_DEVICE_PATH        Guid;
+  UART_DEVICE_PATH          Uart;
+  EFI_DEVICE_PATH_PROTOCOL  End;
+} SERIAL_DEVICE_PATH;
+
+/**
+  Reset the serial device.
+
+  @param  This              Protocol instance pointer.
+
+  @retval EFI_SUCCESS       The device was reset.
+  @retval EFI_DEVICE_ERROR  The serial device could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialReset (
+  IN EFI_SERIAL_IO_PROTOCOL *This
+  );
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param  This             Protocol instance pointer.
+  @param  BaudRate         The requested baud rate. A BaudRate value of 0 will use the the
+                           device's default interface speed.
+  @param  ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
+                           serial interface. A ReceiveFifoDepth value of 0 will use
+                           the device's default FIFO depth.
+  @param  Timeout          The requested time out for a single character in microseconds.
+                           This timeout applies to both the transmit and receive side of the
+                           interface. A Timeout value of 0 will use the device's default time
+                           out value.
+  @param  Parity           The type of parity to use on this serial device. A Parity value of
+                           DefaultParity will use the device's default parity value.
+  @param  DataBits         The number of data bits to use on the serial device. A DataBits
+                           value of 0 will use the device's default data bit setting.
+  @param  StopBits         The number of stop bits to use on this serial device. A StopBits
+                           value of DefaultStopBits will use the device's default number of
+                           stop bits.
+
+  @retval EFI_SUCCESS      The device was reset.
+  @retval EFI_DEVICE_ERROR The serial device could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetAttributes (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN UINT64                 BaudRate,
+  IN UINT32                 ReceiveFifoDepth,
+  IN UINT32                 Timeout,
+  IN EFI_PARITY_TYPE        Parity,
+  IN UINT8                  DataBits,
+  IN EFI_STOP_BITS_TYPE     StopBits
+  );
+
+/**
+  Set the control bits on a serial device
+
+  @param  This             Protocol instance pointer.
+  @param  Control          Set the bits of Control that are settable.
+
+  @retval EFI_SUCCESS      The new control bits were set on the serial device.
+  @retval EFI_UNSUPPORTED  The serial device does not support this operation.
+  @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetControl (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN UINT32                 Control
+  );
+
+/**
+  Retrieves the status of the control bits on a serial device
+
+  @param  This              Protocol instance pointer.
+  @param  Control           A pointer to return the current Control signals from the serial device.
+
+  @retval EFI_SUCCESS       The control bits were read from the serial device.
+  @retval EFI_DEVICE_ERROR  The serial device is not functioning correctly.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialGetControl (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  OUT UINT32                *Control
+  );
+
+/**
+  Writes data to a serial device.
+
+  @param  This              Protocol instance pointer.
+  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
+                            data actually written.
+  @param  Buffer            The buffer of 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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialWrite (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN OUT UINTN              *BufferSize,
+  IN VOID                   *Buffer
+  );
+
+/**
+  Reads data from a serial device.
+
+  @param  This              Protocol instance pointer.
+  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
+                            data returned in Buffer.
+  @param  Buffer            The buffer to return the data into.
+
+  @retval EFI_SUCCESS       The data was read.
+  @retval EFI_DEVICE_ERROR  The device reported an error.
+  @retval EFI_TIMEOUT       The data write was stopped due to a timeout.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialRead (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN OUT UINTN              *BufferSize,
+  OUT VOID                  *Buffer
+  );
+
+EFI_HANDLE mSerialHandle = NULL;
+
+SERIAL_DEVICE_PATH mSerialDevicePath = {
+  {
+    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, { sizeof (VENDOR_DEVICE_PATH), 0} },
+    EFI_CALLER_ID_GUID  // Use the driver's GUID
+  },
+  {
+    { MESSAGING_DEVICE_PATH, MSG_UART_DP, { sizeof (UART_DEVICE_PATH), 0} },
+    0,                  // Reserved
+    0,                  // BaudRate
+    0,                  // DataBits
+    0,                  // Parity
+    0                   // StopBits
+  },
+  { END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE, { sizeof (EFI_DEVICE_PATH_PROTOCOL), 0 } }
+};
+
+//
+// Template used to initialize the Serial IO protocols.
+//
+EFI_SERIAL_IO_MODE mSerialIoMode = {
+  0, // ControlMask
+  0, // Timeout
+  0, // BaudRate
+  1, // ReceiveFifoDepth
+  0, // DataBits
+  0, // Parity
+  0  // StopBits
+};
+
+EFI_SERIAL_IO_PROTOCOL mSerialIoTemplate = {
+  SERIAL_IO_INTERFACE_REVISION,
+  SerialReset,
+  SerialSetAttributes,
+  SerialSetControl,
+  SerialGetControl,
+  SerialWrite,
+  SerialRead,
+  &mSerialIoMode
+};
+
+/**
+  Reset the serial device.
+
+  @param  This              Protocol instance pointer.
+
+  @retval EFI_SUCCESS       The device was reset.
+  @retval EFI_DEVICE_ERROR  The serial device could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialReset (
+  IN EFI_SERIAL_IO_PROTOCOL *This
+  )
+{
+  EFI_STATUS    Status;
+  EFI_TPL       Tpl;
+
+  Status = SerialPortInitialize ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Set the Serial I/O mode and update the device path
+  //
+
+  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  //
+  // Set the Serial I/O mode
+  //
+  This->Mode->ReceiveFifoDepth  = 1;
+  This->Mode->Timeout           = 0;
+  This->Mode->BaudRate          = PcdGet64 (PcdUartDefaultBaudRate);
+  This->Mode->DataBits          = (UINT32) PcdGet8 (PcdUartDefaultDataBits);
+  This->Mode->Parity            = (UINT32) PcdGet8 (PcdUartDefaultParity);
+  This->Mode->StopBits          = (UINT32) PcdGet8 (PcdUartDefaultStopBits);
+
+  //
+  // Check if the device path has actually changed
+  //
+  if (mSerialDevicePath.Uart.BaudRate == This->Mode->BaudRate &&
+      mSerialDevicePath.Uart.DataBits == (UINT8) This->Mode->DataBits &&
+      mSerialDevicePath.Uart.Parity   == (UINT8) This->Mode->Parity &&
+      mSerialDevicePath.Uart.StopBits == (UINT8) This->Mode->StopBits
+     ) {
+    gBS->RestoreTPL (Tpl);
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Update the device path
+  //
+  mSerialDevicePath.Uart.BaudRate = This->Mode->BaudRate;
+  mSerialDevicePath.Uart.DataBits = (UINT8) This->Mode->DataBits;
+  mSerialDevicePath.Uart.Parity   = (UINT8) This->Mode->Parity;
+  mSerialDevicePath.Uart.StopBits = (UINT8) This->Mode->StopBits;
+
+  Status = gBS->ReinstallProtocolInterface (
+                  mSerialHandle,
+                  &gEfiDevicePathProtocolGuid,
+                  &mSerialDevicePath,
+                  &mSerialDevicePath
+                  );
+
+  gBS->RestoreTPL (Tpl);
+
+  return Status;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param  This             Protocol instance pointer.
+  @param  BaudRate         The requested baud rate. A BaudRate value of 0 will use the the
+                           device's default interface speed.
+  @param  ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
+                           serial interface. A ReceiveFifoDepth value of 0 will use
+                           the device's default FIFO depth.
+  @param  Timeout          The requested time out for a single character in microseconds.
+                           This timeout applies to both the transmit and receive side of the
+                           interface. A Timeout value of 0 will use the device's default time
+                           out value.
+  @param  Parity           The type of parity to use on this serial device. A Parity value of
+                           DefaultParity will use the device's default parity value.
+  @param  DataBits         The number of data bits to use on the serial device. A DataBits
+                           value of 0 will use the device's default data bit setting.
+  @param  StopBits         The number of stop bits to use on this serial device. A StopBits
+                           value of DefaultStopBits will use the device's default number of
+                           stop bits.
+
+  @retval EFI_SUCCESS      The device was reset.
+  @retval EFI_DEVICE_ERROR The serial device could not be reset.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetAttributes (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN UINT64                 BaudRate,
+  IN UINT32                 ReceiveFifoDepth,
+  IN UINT32                 Timeout,
+  IN EFI_PARITY_TYPE        Parity,
+  IN UINT8                  DataBits,
+  IN EFI_STOP_BITS_TYPE     StopBits
+  )
+{
+  EFI_STATUS    Status;
+  EFI_TPL       Tpl;
+
+  Status = SerialPortSetAttributes (&BaudRate, &ReceiveFifoDepth, &Timeout, &Parity, &DataBits, &StopBits);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Set the Serial I/O mode and update the device path
+  //
+
+  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  //
+  // Set the Serial I/O mode
+  //
+  This->Mode->ReceiveFifoDepth  = ReceiveFifoDepth;
+  This->Mode->Timeout           = Timeout;
+  This->Mode->BaudRate          = BaudRate;
+  This->Mode->DataBits          = (UINT32) DataBits;
+  This->Mode->Parity            = (UINT32) Parity;
+  This->Mode->StopBits          = (UINT32) StopBits;
+
+  //
+  // Check if the device path has actually changed
+  //
+  if (mSerialDevicePath.Uart.BaudRate == BaudRate &&
+      mSerialDevicePath.Uart.DataBits == DataBits &&
+      mSerialDevicePath.Uart.Parity   == (UINT8) Parity &&
+      mSerialDevicePath.Uart.StopBits == (UINT8) StopBits
+     ) {
+    gBS->RestoreTPL (Tpl);
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Update the device path
+  //
+  mSerialDevicePath.Uart.BaudRate = BaudRate;
+  mSerialDevicePath.Uart.DataBits = DataBits;
+  mSerialDevicePath.Uart.Parity   = (UINT8) Parity;
+  mSerialDevicePath.Uart.StopBits = (UINT8) StopBits;
+
+  Status = gBS->ReinstallProtocolInterface (
+                  mSerialHandle,
+                  &gEfiDevicePathProtocolGuid,
+                  &mSerialDevicePath,
+                  &mSerialDevicePath
+                  );
+
+  gBS->RestoreTPL (Tpl);
+
+  return Status;
+}
+
+/**
+  Set the control bits on a serial device
+
+  @param  This             Protocol instance pointer.
+  @param  Control          Set the bits of Control that are settable.
+
+  @retval EFI_SUCCESS      The new control bits were set on the serial device.
+  @retval EFI_UNSUPPORTED  The serial device does not support this operation.
+  @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetControl (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN UINT32                 Control
+  )
+{
+  return SerialPortSetControl (Control);
+}
+
+/**
+  Retrieves the status of the control bits on a serial device
+
+  @param  This              Protocol instance pointer.
+  @param  Control           A pointer to return the current Control signals from the serial device.
+
+  @retval EFI_SUCCESS       The control bits were read from the serial device.
+  @retval EFI_DEVICE_ERROR  The serial device is not functioning correctly.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialGetControl (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  OUT UINT32                *Control
+  )
+{
+  return SerialPortGetControl (Control);
+}
+
+/**
+  Writes data to a serial device.
+
+  @param  This              Protocol instance pointer.
+  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
+                            data actually written.
+  @param  Buffer            The buffer of 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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialWrite (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN OUT UINTN              *BufferSize,
+  IN VOID                   *Buffer
+  )
+{
+  UINTN Count;
+
+  Count = SerialPortWrite (Buffer, *BufferSize);
+
+  if (Count != *BufferSize) {
+    *BufferSize = Count;
+    return EFI_TIMEOUT;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Reads data from a serial device.
+
+  @param  This              Protocol instance pointer.
+  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
+                            data returned in Buffer.
+  @param  Buffer            The buffer to return the data into.
+
+  @retval EFI_SUCCESS       The data was read.
+  @retval EFI_DEVICE_ERROR  The device reported an error.
+  @retval EFI_TIMEOUT       The data write was stopped due to a timeout.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialRead (
+  IN EFI_SERIAL_IO_PROTOCOL *This,
+  IN OUT UINTN              *BufferSize,
+  OUT VOID                  *Buffer
+  )
+{
+  UINTN Count;
+
+  Count = 0;
+
+  if (SerialPortPoll ()) {
+    Count = SerialPortRead (Buffer, *BufferSize);
+  }
+
+  if (Count != *BufferSize) {
+    *BufferSize = Count;
+    return EFI_TIMEOUT;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialization for the Serial Io Protocol.
+
+  @param[in] ImageHandle    The firmware allocated handle for the EFI image.
+  @param[in] SystemTable    A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS       The entry point is executed successfully.
+  @retval other             Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialDxeInitialize (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS            Status;
+
+  Status = SerialPortInitialize ();
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  mSerialIoMode.BaudRate = PcdGet64 (PcdUartDefaultBaudRate);
+  mSerialIoMode.DataBits = (UINT32) PcdGet8 (PcdUartDefaultDataBits);
+  mSerialIoMode.Parity   = (UINT32) PcdGet8 (PcdUartDefaultParity);
+  mSerialIoMode.StopBits = (UINT32) PcdGet8 (PcdUartDefaultStopBits);
+  mSerialDevicePath.Uart.BaudRate = PcdGet64 (PcdUartDefaultBaudRate);
+  mSerialDevicePath.Uart.DataBits = PcdGet8 (PcdUartDefaultDataBits);
+  mSerialDevicePath.Uart.Parity   = PcdGet8 (PcdUartDefaultParity);
+  mSerialDevicePath.Uart.StopBits = PcdGet8 (PcdUartDefaultStopBits);
+
+  //
+  // Make a new handle with Serial IO protocol and its device path on it.
+  //
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &mSerialHandle,
+                  &gEfiSerialIoProtocolGuid,   &mSerialIoTemplate,
+                  &gEfiDevicePathProtocolGuid, &mSerialDevicePath,
+                  NULL
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return Status;
+}
+

From 07b3c219af6d777984145de4d7d6faab4b40418b Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:17:57 +0000
Subject: [PATCH 174/525] EmulatorPkg: Use SerialDxe in MdeModulePkg instead of
 EmbeddedPkg

It is also to add GetControl/SetControl/SetAttributes implementation
for DxeEmuSerialPortLib.

(Sync patch r18967 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Andrew Fish <afish@apple.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19017 6f19259b-4bc3-4df7-8a09-765794883524
---
 EmulatorPkg/EmulatorPkg.dsc                   |  3 +-
 EmulatorPkg/EmulatorPkg.fdf                   |  2 +-
 .../DxeEmuSerialPortLib/DxeEmuSerialPortLib.c | 91 ++++++++++++++++++-
 3 files changed, 92 insertions(+), 4 deletions(-)

diff --git a/EmulatorPkg/EmulatorPkg.dsc b/EmulatorPkg/EmulatorPkg.dsc
index 8eff20edae8d..27a78d55709c 100644
--- a/EmulatorPkg/EmulatorPkg.dsc
+++ b/EmulatorPkg/EmulatorPkg.dsc
@@ -87,7 +87,6 @@
   SecurityManagementLib|MdeModulePkg/Library/DxeSecurityManagementLib/DxeSecurityManagementLib.inf
   TimerLib|MdePkg/Library/BaseTimerLibNullTemplate/BaseTimerLibNullTemplate.inf
   SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
-  SerialPortExtLib|EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
   CapsuleLib|MdeModulePkg/Library/DxeCapsuleLibNull/DxeCapsuleLibNull.inf
   #
   # Platform
@@ -325,7 +324,7 @@
   MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf {
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf {
    <LibraryClasses>
       DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
       SerialPortLib|EmulatorPkg/Library/DxeEmuSerialPortLib/DxeEmuSerialPortLib.inf
diff --git a/EmulatorPkg/EmulatorPkg.fdf b/EmulatorPkg/EmulatorPkg.fdf
index a0023893bb70..985a78ee2f1f 100644
--- a/EmulatorPkg/EmulatorPkg.fdf
+++ b/EmulatorPkg/EmulatorPkg.fdf
@@ -161,7 +161,7 @@ INF  MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
 INF  MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
 INF  MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
 
-INF  EmbeddedPkg/SerialDxe/SerialDxe.inf
+INF  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 INF  MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
 INF  MdeModulePkg/Universal/DevicePathDxe/DevicePathDxe.inf
 INF  MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIoDxe.inf
diff --git a/EmulatorPkg/Library/DxeEmuSerialPortLib/DxeEmuSerialPortLib.c b/EmulatorPkg/Library/DxeEmuSerialPortLib/DxeEmuSerialPortLib.c
index 792bd62a1c67..2bf5961bf030 100644
--- a/EmulatorPkg/Library/DxeEmuSerialPortLib/DxeEmuSerialPortLib.c
+++ b/EmulatorPkg/Library/DxeEmuSerialPortLib/DxeEmuSerialPortLib.c
@@ -2,7 +2,7 @@
   Serial Port Lib that thunks back to Emulator services to write to StdErr.
   All read functions are stubed out.
 
-  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   Portions copyright (c) 2011, Apple Inc. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -116,3 +116,92 @@ SerialPortPoll (
   return gEmuThunk->PollStdIn ();
 }
 
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  *Control = 0;
+  if (!SerialPortPoll ()) {
+    *Control = EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+  return RETURN_SUCCESS;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+

From 051eb0c5f8c3b526af7be6cbcbf4314797d71899 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:18:40 +0000
Subject: [PATCH 175/525] CorebootPayloadPkg: Use SerialDxe in MdeModulePkg

1. Update fdf and dsc to use SerialDxe in MdeModulePkg.
2. Separate the code that gets SerialRegBase and SerialRegAccessType
   by CbParseLib from CorebootPayloadPkg/Library/SerialPortLib to
   PlatformHookLib, and then leverage BaseSerialPortLib16550 in
   MdeModulePkg.
3. Remove CorebootPayloadPkg/SerialDxe and
   CorebootPayloadPkg/Library/SerialPortLib.

(Sync patch r18968 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Maurice Ma <maurice.ma@intel.com>
Cc: Prince Agyeman <prince.agyeman@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Maurice Ma <maurice.ma@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19018 6f19259b-4bc3-4df7-8a09-765794883524
---
 CorebootPayloadPkg/CorebootPayloadPkg.fdf     |   4 +-
 CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc |  11 +-
 .../CorebootPayloadPkgIa32X64.dsc             |  11 +-
 .../Library/PlatformBdsLib/BdsPlatform.h      |   5 +-
 .../Library/PlatformHookLib/PlatformHookLib.c |  56 +++
 .../PlatformHookLib.inf}                      |  36 +-
 .../Library/SerialPortLib/SerialPortLib.c     | 316 --------------
 CorebootPayloadPkg/SerialDxe/SerialDxe.inf    |  55 ---
 CorebootPayloadPkg/SerialDxe/SerialIo.c       | 392 ------------------
 9 files changed, 92 insertions(+), 794 deletions(-)
 create mode 100644 CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.c
 rename CorebootPayloadPkg/Library/{SerialPortLib/SerialPortLib.inf => PlatformHookLib/PlatformHookLib.inf} (54%)
 delete mode 100644 CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.c
 delete mode 100644 CorebootPayloadPkg/SerialDxe/SerialDxe.inf
 delete mode 100644 CorebootPayloadPkg/SerialDxe/SerialIo.c

diff --git a/CorebootPayloadPkg/CorebootPayloadPkg.fdf b/CorebootPayloadPkg/CorebootPayloadPkg.fdf
index 810dcb1655e6..c160e4346187 100644
--- a/CorebootPayloadPkg/CorebootPayloadPkg.fdf
+++ b/CorebootPayloadPkg/CorebootPayloadPkg.fdf
@@ -3,7 +3,7 @@
 #
 # Provides drivers and definitions to create uefi payload for coreboot. 
 #
-# Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under 
 # the terms and conditions of the BSD License that accompanies this distribution.  
 # The full text of the license may be found at
@@ -116,7 +116,7 @@ INF DuetPkg/PciBusNoEnumerationDxe/PciBusNoEnumeration.inf
 #
 # ISA Support
 #
-INF CorebootPayloadPkg/SerialDxe/SerialDxe.inf
+INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
 #
 # Console Support
diff --git a/CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc b/CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc
index 00a584234f2f..2c37e443fa78 100644
--- a/CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc
+++ b/CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc
@@ -3,7 +3,7 @@
 #
 # Provides drivers and definitions to create uefi payload for coreboot. 
 #
-# Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under 
 # the terms and conditions of the BSD License that accompanies this distribution.  
 # The full text of the license may be found at
@@ -116,7 +116,8 @@
   #
   TimerLib|CorebootPayloadPkg/Library/AcpiTimerLib/AcpiTimerLib.inf
   ResetSystemLib|CorebootPayloadPkg/Library/ResetSystemLib/ResetSystemLib.inf
-  SerialPortLib|CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.inf
+  SerialPortLib|MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.inf
+  PlatformHookLib|CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.inf
   PlatformBdsLib|CorebootPayloadPkg/Library/PlatformBdsLib/PlatformBdsLib.inf
   
   #
@@ -214,6 +215,10 @@
   gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugLoadImageMethod|0x2
 !endif
 
+[PcdsPatchableInModule.common]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio|FALSE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0x03F8
+
 ################################################################################
 #
 # Pcd Dynamic Section - list of all EDK II PCD Entries defined by this Platform
@@ -340,7 +345,7 @@
   #
   # ISA Support
   #
-  CorebootPayloadPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
   
   #
   # Console Support
diff --git a/CorebootPayloadPkg/CorebootPayloadPkgIa32X64.dsc b/CorebootPayloadPkg/CorebootPayloadPkgIa32X64.dsc
index ecd12fbf8514..cfaf3048f8de 100644
--- a/CorebootPayloadPkg/CorebootPayloadPkgIa32X64.dsc
+++ b/CorebootPayloadPkg/CorebootPayloadPkgIa32X64.dsc
@@ -3,7 +3,7 @@
 #
 # Provides drivers and definitions to create uefi payload for coreboot. 
 #
-# Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under 
 # the terms and conditions of the BSD License that accompanies this distribution.  
 # The full text of the license may be found at
@@ -116,7 +116,8 @@
   #
   TimerLib|CorebootPayloadPkg/Library/AcpiTimerLib/AcpiTimerLib.inf
   ResetSystemLib|CorebootPayloadPkg/Library/ResetSystemLib/ResetSystemLib.inf
-  SerialPortLib|CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.inf
+  SerialPortLib|MdeModulePkg/Library/BaseSerialPortLib16550/BaseSerialPortLib16550.inf
+  PlatformHookLib|CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.inf
   PlatformBdsLib|CorebootPayloadPkg/Library/PlatformBdsLib/PlatformBdsLib.inf
   
   #
@@ -216,6 +217,10 @@
   gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugLoadImageMethod|0x2
 !endif
 
+[PcdsPatchableInModule.common]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio|FALSE
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0x03F8
+
 ################################################################################
 #
 # Pcd Dynamic Section - list of all EDK II PCD Entries defined by this Platform
@@ -342,7 +347,7 @@
   #
   # ISA Support
   #
-  CorebootPayloadPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
   
   #
   # Console Support
diff --git a/CorebootPayloadPkg/Library/PlatformBdsLib/BdsPlatform.h b/CorebootPayloadPkg/Library/PlatformBdsLib/BdsPlatform.h
index 975a7718678e..641e1cbf01bc 100644
--- a/CorebootPayloadPkg/Library/PlatformBdsLib/BdsPlatform.h
+++ b/CorebootPayloadPkg/Library/PlatformBdsLib/BdsPlatform.h
@@ -1,7 +1,7 @@
 /** @file
   Head file for BDS Platform specific code
 
-Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -29,7 +29,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/DevicePathLib.h>
 
 #include <Protocol/PciIo.h>
-#include <Protocol/SerialIo.h>
 
 #include <Guid/GlobalVariable.h>
 extern BDS_CONSOLE_CONNECT_ENTRY  gPlatformConsole[];
@@ -94,7 +93,7 @@ extern VENDOR_DEVICE_PATH         gUartDeviceVenderNode;
         (UINT8) ((sizeof (VENDOR_DEVICE_PATH)) >> 8) \
       } \
     }, \
-    EFI_SERIAL_IO_PROTOCOL_GUID \
+    {0xD3987D4B, 0x971A, 0x435F, {0x8C, 0xAF, 0x49, 0x67, 0xEB, 0x62, 0x72, 0x41}} \
   }
     
 #define gUart \
diff --git a/CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.c b/CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.c
new file mode 100644
index 000000000000..10fd332fe546
--- /dev/null
+++ b/CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.c
@@ -0,0 +1,56 @@
+/** @file
+  Platform Hook Library instance for UART device upon coreboot.
+
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Base.h>
+#include <Uefi/UefiBaseType.h>
+#include <Library/PlatformHookLib.h>
+#include <Library/CbParseLib.h>
+#include <Library/PcdLib.h>
+
+/**
+  Performs platform specific initialization required for the CPU to access
+  the hardware associated with a SerialPortLib instance.  This function does
+  not intiailzie the serial port hardware itself.  Instead, it initializes
+  hardware devices that are required for the CPU to access the serial port
+  hardware.  This function may be called more than once.
+
+  @retval RETURN_SUCCESS       The platform specific initialization succeeded.
+  @retval RETURN_DEVICE_ERROR  The platform specific initialization could not be completed.
+
+**/
+RETURN_STATUS
+EFIAPI
+PlatformHookSerialPortInitialize (
+  VOID
+  )
+{
+  RETURN_STATUS     Status;
+  UINT32            SerialRegBase;
+  UINT32            SerialRegAccessType;
+
+  Status = CbParseSerialInfo (&SerialRegBase, &SerialRegAccessType, NULL);
+  if (RETURN_ERROR (Status)) {
+    return Status;
+  }
+
+  if (SerialRegAccessType == 2) { //MMIO
+    PcdSetBoolS (PcdSerialUseMmio, TRUE);
+  } else { //IO
+    PcdSetBoolS (PcdSerialUseMmio, FALSE);
+  }
+  PcdSet64S (PcdSerialRegisterBase, (UINT64) SerialRegBase);
+
+  return RETURN_SUCCESS;
+}
+
diff --git a/CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.inf b/CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.inf
similarity index 54%
rename from CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.inf
rename to CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.inf
index c7e48f8bc14d..e5db75fa95b0 100644
--- a/CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.inf
+++ b/CorebootPayloadPkg/Library/PlatformHookLib/PlatformHookLib.inf
@@ -1,12 +1,12 @@
 ## @file
-#   SerialPortLib instance for UART device upon coreboot
+#  Platform Hook Library instance for UART device upon coreboot.
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
-#  Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution.  The full text of the license may be found at
+#  which accompanies this distribution. The full text of the license may be found at
 #  http://opensource.org/licenses/bsd-license.php
-#
 #  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
 #  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #
@@ -14,29 +14,25 @@
 
 [Defines]
   INF_VERSION                    = 0x00010005
-  BASE_NAME                      = SerialPortLib
+  BASE_NAME                      = PlatformHookLib
   FILE_GUID                      = 40A2CBC6-CFB8-447b-A90E-198E88FD345E
   MODULE_TYPE                    = BASE
   VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = SerialPortLib
-  
-  CONSTRUCTOR                    = SerialPortInitialize
-  
+  LIBRARY_CLASS                  = PlatformHookLib
+
 [Sources]
-  SerialPortLib.c
-  
+  PlatformHookLib.c
+
+[LibraryClasses]
+  CbParseLib
+  PcdLib
+
 [Packages]
   MdePkg/MdePkg.dec
   MdeModulePkg/MdeModulePkg.dec
   CorebootModulePkg/CorebootModulePkg.dec
 
-[LibraryClasses]
-  BaseLib
-  PcdLib
-  IoLib
-  CbParseLib
-  
 [Pcd]
-  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialBaudRate
-  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialLineControl
-  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialFifoControl
\ No newline at end of file
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseMmio       ## PRODUCES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase  ## PRODUCES
+
diff --git a/CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.c b/CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.c
deleted file mode 100644
index 0d87e62b1b06..000000000000
--- a/CorebootPayloadPkg/Library/SerialPortLib/SerialPortLib.c
+++ /dev/null
@@ -1,316 +0,0 @@
-/** @file
-  SerialPortLib instance for UART device upon coreboot
-
-  Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Uefi/UefiBaseType.h>
-#include <Library/SerialPortLib.h>
-#include <Library/PcdLib.h>
-#include <Library/IoLib.h>
-#include <Library/CbParseLib.h>
-
-//
-// 16550 UART register offsets and bitfields
-//
-#define R_UART_RXBUF          0
-#define R_UART_TXBUF          0
-#define R_UART_BAUD_LOW       0
-#define R_UART_BAUD_HIGH      1
-#define R_UART_FCR            2
-#define   B_UART_FCR_FIFOE    BIT0
-#define   B_UART_FCR_FIFO64   BIT5
-#define R_UART_LCR            3
-#define   B_UART_LCR_DLAB     BIT7
-#define R_UART_MCR            4
-#define   B_UART_MCR_RTS      BIT1
-#define R_UART_LSR            5
-#define   B_UART_LSR_RXRDY    BIT0
-#define   B_UART_LSR_TXRDY    BIT5
-#define   B_UART_LSR_TEMT     BIT6
-#define R_UART_MSR            6
-#define   B_UART_MSR_CTS      BIT4
-#define   B_UART_MSR_DSR      BIT5
-
-UINT32 mSerialRegBase = 0;
-UINT32 mSerialRegAccessType = 0;
-
-/**
-  Read an 8-bit 16550 register.  If PcdSerialUseMmio is TRUE, then the value is read from 
-  MMIO space.  If PcdSerialUseMmio is FALSE, then the value is read from I/O space.  The
-  parameter Offset is added to the base address of the 16550 registers that is specified 
-  by PcdSerialRegisterBase. 
-  
-  @param  Offset  The offset of the 16550 register to read.
-
-  @return The value read from the 16550 register.
-
-**/
-UINT8
-SerialPortReadRegister (
-  UINTN  Offset
-  )
-{
-  if (mSerialRegAccessType == 2) { //MMIO
-    return MmioRead8 (mSerialRegBase + Offset);
-  } else { //IO
-    return IoRead8 ((UINT16)mSerialRegBase + Offset);
-  }
-}
-
-/**
-  Write an 8-bit 16550 register.  If PcdSerialUseMmio is TRUE, then the value is written to
-  MMIO space.  If PcdSerialUseMmio is FALSE, then the value is written to I/O space.  The
-  parameter Offset is added to the base address of the 16550 registers that is specified 
-  by PcdSerialRegisterBase. 
-  
-  @param  Offset  The offset of the 16550 register to write.
-  @param  Value   The value to write to the 16550 register specified by Offset.
-
-  @return The value written to the 16550 register.
-
-**/
-UINT8
-SerialPortWriteRegister (
-  UINTN  Offset,
-  UINT8  Value
-  )
-{
-  if (mSerialRegAccessType == 2) { //MMIO
-    return MmioWrite8 (mSerialRegBase + Offset, Value);
-  } else {// IO
-    return IoWrite8 ((UINT16)mSerialRegBase + Offset, Value);
-  }
-}
-
-/**
-  Initialize the serial device hardware.
-  
-  If no initialization is required, then return RETURN_SUCCESS.
-  If the serial device was successfully initialized, then return RETURN_SUCCESS.
-  If the serial device could not be initialized, then return RETURN_DEVICE_ERROR.
-  
-  @retval RETURN_SUCCESS        The serial device was initialized.
-  @retval RETURN_DEVICE_ERROR   The serial device could not be initialized.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortInitialize (
-  VOID
-  )
-{
-  RETURN_STATUS  Status;
-  UINTN          Divisor;
-  BOOLEAN        Initialized;
-  
-  Status = CbParseSerialInfo (&mSerialRegBase, &mSerialRegAccessType, NULL);
-  if (RETURN_ERROR (Status)) {
-    return Status;
-  }
-
-  //
-  // See if the serial port is already initialized
-  //
-  Initialized = TRUE;
-  if ((SerialPortReadRegister (R_UART_FCR) & (B_UART_FCR_FIFOE | B_UART_FCR_FIFO64)) !=
-      (PcdGet8 (PcdSerialFifoControl)      & (B_UART_FCR_FIFOE | B_UART_FCR_FIFO64))     ) {
-    Initialized = FALSE;
-  }
-
-  if ((SerialPortReadRegister (R_UART_LCR) & 0x3F) != (PcdGet8 (PcdSerialLineControl) & 0x3F)) {
-    Initialized = FALSE;
-  }
-  SerialPortWriteRegister (R_UART_LCR, (UINT8)(SerialPortReadRegister (R_UART_LCR) | B_UART_LCR_DLAB));
-  Divisor =  SerialPortReadRegister (R_UART_BAUD_HIGH) << 8;
-  Divisor |= SerialPortReadRegister (R_UART_BAUD_LOW);
-  SerialPortWriteRegister (R_UART_LCR, (UINT8)(SerialPortReadRegister (R_UART_LCR) & ~B_UART_LCR_DLAB));
-  if (Divisor != 115200 / PcdGet32 (PcdSerialBaudRate)) {
-    Initialized = FALSE;
-  }
-  if (Initialized) {
-    return RETURN_SUCCESS;
-  }
-  
-  //
-  // Configure baud rate
-  //
-  Divisor = 115200 / PcdGet32 (PcdSerialBaudRate);
-  SerialPortWriteRegister (R_UART_LCR, B_UART_LCR_DLAB);
-  SerialPortWriteRegister (R_UART_BAUD_HIGH, (UINT8) (Divisor >> 8));
-  SerialPortWriteRegister (R_UART_BAUD_LOW, (UINT8) (Divisor & 0xff));
-
-  //
-  // Clear DLAB and configure Data Bits, Parity, and Stop Bits.
-  // Strip reserved bits from PcdSerialLineControl
-  //
-  SerialPortWriteRegister (R_UART_LCR, (UINT8)(PcdGet8 (PcdSerialLineControl) & 0x3F));
-
-  //
-  // Enable and reset FIFOs
-  // Strip reserved bits from PcdSerialFifoControl
-  //
-  SerialPortWriteRegister (R_UART_FCR, (UINT8)(PcdGet8 (PcdSerialFifoControl) & 0x27));
-
-  //
-  // Put Modem Control Register(MCR) into its reset state of 0x00.
-  //  
-  SerialPortWriteRegister (R_UART_MCR, 0x00);
-  
-  return RETURN_SUCCESS;
-}
-
-/**
-  Write data from buffer to serial device. 
- 
-  Writes NumberOfBytes data bytes from Buffer to the serial device.  
-  The number of bytes actually written to the serial device is returned.
-  If the return value is less than NumberOfBytes, then the write operation failed.
-
-  If Buffer is NULL, then ASSERT(). 
-
-  If NumberOfBytes is zero, then return 0.
-
-  @param  Buffer           Pointer to the data buffer to be written.
-  @param  NumberOfBytes    Number of bytes to written to the serial device.
-
-  @retval 0                NumberOfBytes is 0.
-  @retval >0               The number of bytes written to the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
-
-**/
-UINTN
-EFIAPI
-SerialPortWrite (
-  IN UINT8     *Buffer,
-  IN UINTN     NumberOfBytes
-)
-{
-  UINTN    Result;
-  UINTN    Index;
-  UINTN    FifoSize;
-
-  if (Buffer == NULL) {
-    return 0;
-  }
-
-  if (NumberOfBytes == 0) {
-    //
-    // Flush the hardware
-    //
-
-    //
-    // Wait for both the transmit FIFO and shift register empty.
-    //
-    while ((SerialPortReadRegister (R_UART_LSR) & B_UART_LSR_TEMT) == 0);
-
-    return 0;
-  }
-
-  //
-  // Compute the maximum size of the Tx FIFO
-  //
-  FifoSize = 1;
-  if ((PcdGet8 (PcdSerialFifoControl) & B_UART_FCR_FIFOE) != 0) {
-    if ((PcdGet8 (PcdSerialFifoControl) & B_UART_FCR_FIFO64) == 0) {
-      FifoSize = 16;
-    } else {
-      FifoSize = 64;
-    }
-  }
-
-  Result = NumberOfBytes;
-  while (NumberOfBytes != 0) {
-    //
-    // Wait for the serial port to be ready, to make sure both the transmit FIFO
-    // and shift register empty.
-    //
-    while ((SerialPortReadRegister (R_UART_LSR) & B_UART_LSR_TEMT) == 0);
-
-    //
-    // Fill then entire Tx FIFO
-    //
-    for (Index = 0; Index < FifoSize && NumberOfBytes != 0; Index++, NumberOfBytes--, Buffer++) {
-
-      //
-      // Write byte to the transmit buffer.
-      //
-      SerialPortWriteRegister (R_UART_TXBUF, *Buffer);
-    }
-  }
-  return Result;
-}
-
-/**
-  Reads data from a serial device into a buffer.
-
-  @param  Buffer           Pointer to the data buffer to store the data read from the serial device.
-  @param  NumberOfBytes    Number of bytes to read from the serial device.
-
-  @retval 0                NumberOfBytes is 0.
-  @retval >0               The number of bytes read from the serial device.  
-                           If this value is less than NumberOfBytes, then the read operation failed.
-
-**/
-UINTN
-EFIAPI
-SerialPortRead (
-  OUT UINT8     *Buffer,
-  IN  UINTN     NumberOfBytes
-)
-{
-  UINTN  Result;
-
-  if (NULL == Buffer) {
-    return 0;
-  }
-  
-  for (Result = 0; NumberOfBytes-- != 0; Result++, Buffer++) {
-    //
-    // Wait for the serial port to have some data.
-    //
-    while ((SerialPortReadRegister (R_UART_LSR) & B_UART_LSR_RXRDY) == 0);
-        
-    //
-    // Read byte from the receive buffer.
-    //
-    *Buffer = SerialPortReadRegister (R_UART_RXBUF);
-  }
-  
-  return Result;
-}
-
-/**
-  Polls a serial device to see if there is any data waiting to be read.
-
-  Polls aserial device to see if there is any data waiting to be read.
-  If there is data waiting to be read from the serial device, then TRUE is returned.
-  If there is no data waiting to be read from the serial device, then FALSE is returned.
-
-  @retval TRUE             Data is waiting to be read from the serial device.
-  @retval FALSE            There is no data waiting to be read from the serial device.
-
-**/
-BOOLEAN
-EFIAPI
-SerialPortPoll (
-  VOID
-  )
-{
-  //
-  // Read the serial port status
-  //
-  if ((SerialPortReadRegister (R_UART_LSR) & B_UART_LSR_RXRDY) != 0) {
-    return TRUE;
-  }  
-  
-  return FALSE;
-}
diff --git a/CorebootPayloadPkg/SerialDxe/SerialDxe.inf b/CorebootPayloadPkg/SerialDxe/SerialDxe.inf
deleted file mode 100644
index 04d993534e93..000000000000
--- a/CorebootPayloadPkg/SerialDxe/SerialDxe.inf
+++ /dev/null
@@ -1,55 +0,0 @@
-#/** @file
-#  
-#  Convert SerialLib into SerialIo protocol
-#  
-#  Copyright (c) 2008 - 2014, Intel Corporation. All rights reserved.<BR>
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution.  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php
-#  
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#  
-#**/
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = SerialDxe
-  FILE_GUID                      = D3987D4B-971A-435F-8CAF-4967EB627241
-  MODULE_TYPE                    = DXE_DRIVER
-  VERSION_STRING                 = 1.0
-
-  ENTRY_POINT                    = SerialDxeInitialize
-
-[Sources.common]
-  SerialIo.c
-
-[Packages]
-  MdePkg/MdePkg.dec
-  MdeModulePkg/MdeModulePkg.dec
-
-[LibraryClasses]
-  BaseLib
-  ReportStatusCodeLib
-  MemoryAllocationLib
-  UefiLib
-  UefiBootServicesTableLib
-  BaseMemoryLib
-  DebugLib
-  UefiDriverEntryPoint
-  SerialPortLib
-  
-
-[Protocols]
-  gEfiSerialIoProtocolGuid    
-  gEfiDevicePathProtocolGuid
-
-[FixedPcd]
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits
-
-[Depex] 
-  TRUE
diff --git a/CorebootPayloadPkg/SerialDxe/SerialIo.c b/CorebootPayloadPkg/SerialDxe/SerialIo.c
deleted file mode 100644
index cdede321669d..000000000000
--- a/CorebootPayloadPkg/SerialDxe/SerialIo.c
+++ /dev/null
@@ -1,392 +0,0 @@
-/** @file
-  Serial IO Abstraction for GDB stub. This allows an EFI consoles that shows up on the system 
-  running GDB. One console for error information and another console for user input/output.
-  
-  Basic packet format is $packet-data#checksum. So every command has 4 bytes of overhead: $,
-  #, 0, 0. The 0 and 0 are the ascii characters for the checksum. 
-  
-
-  Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
-  Copyright (c) 2013, ARM Ltd. All rights reserved.<BR>
-  Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
-  
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <PiDxe.h>
-#include <Library/UefiLib.h>
-#include <Library/UefiBootServicesTableLib.h>
-#include <Library/DebugLib.h>
-#include <Library/SerialPortLib.h>
-#include <Library/PcdLib.h>
-
-#include <Protocol/SerialIo.h>
-
-typedef struct {
-  VENDOR_DEVICE_PATH        Guid;
-  UART_DEVICE_PATH          Uart;
-  EFI_DEVICE_PATH_PROTOCOL  End;
-} SIMPLE_TEXT_OUT_DEVICE_PATH;
-
-SIMPLE_TEXT_OUT_DEVICE_PATH mDevicePath = {
-  {
-    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, { sizeof (VENDOR_DEVICE_PATH), 0} },
-    EFI_SERIAL_IO_PROTOCOL_GUID // Use the drivers GUID
-  },
-  {
-    { MESSAGING_DEVICE_PATH, MSG_UART_DP, { sizeof (UART_DEVICE_PATH), 0} },
-    0,        // Reserved
-    FixedPcdGet64 (PcdUartDefaultBaudRate),   // BaudRate
-    FixedPcdGet8 (PcdUartDefaultDataBits),    // DataBits
-    FixedPcdGet8 (PcdUartDefaultParity),      // Parity (N)
-    FixedPcdGet8 (PcdUartDefaultStopBits)     // StopBits
-  },
-  { END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE, { sizeof (EFI_DEVICE_PATH_PROTOCOL), 0 } }
-};
-
-EFI_HANDLE  gHandle = NULL;
-
-/**
-  Reset the serial device.
-
-  @param  This              Protocol instance pointer.
-                            
-  @retval EFI_SUCCESS       The device was reset.
-  @retval EFI_DEVICE_ERROR  The serial device could not be reset.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialReset (
-  IN EFI_SERIAL_IO_PROTOCOL  *This
-  )
-{
-  EFI_STATUS  Status;
-  EFI_TPL     Tpl;
-
-  Status = SerialPortInitialize ();
-  if (EFI_ERROR(Status)) {
-    return Status;
-  }
-
-  //
-  // Set the Serial I/O mode and update the device path
-  //
-
-  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
-
-  //
-  // Set the Serial I/O mode
-  //
-  This->Mode->ReceiveFifoDepth  = 0;
-  This->Mode->Timeout           = 1000000;
-  This->Mode->BaudRate          = PcdGet64 (PcdUartDefaultBaudRate);
-  This->Mode->DataBits          = (UINT32)PcdGet8 (PcdUartDefaultDataBits);
-  This->Mode->Parity            = (UINT32)PcdGet8 (PcdUartDefaultParity);
-  This->Mode->StopBits          = (UINT32)PcdGet8 (PcdUartDefaultStopBits);
-
-  //
-  // Check if the device path has actually changed
-  //
-  if (mDevicePath.Uart.BaudRate == This->Mode->BaudRate &&
-      mDevicePath.Uart.DataBits == (UINT8)This->Mode->DataBits &&
-      mDevicePath.Uart.Parity   == (UINT8)This->Mode->Parity &&
-      mDevicePath.Uart.StopBits == (UINT8)This->Mode->StopBits
-     ) {
-    gBS->RestoreTPL (Tpl);
-    return EFI_SUCCESS;
-  }
-
-  //
-  // Update the device path
-  //
-  mDevicePath.Uart.BaudRate = This->Mode->BaudRate;
-  mDevicePath.Uart.DataBits = (UINT8)This->Mode->DataBits;
-  mDevicePath.Uart.Parity   = (UINT8)This->Mode->Parity;
-  mDevicePath.Uart.StopBits = (UINT8)This->Mode->StopBits;
-
-  Status = gBS->ReinstallProtocolInterface (
-                  gHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  &mDevicePath,
-                  &mDevicePath
-                  );
-
-  gBS->RestoreTPL (Tpl);
-
-  return Status;
-}
-
-
-/**
-  Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
-  data buts, and stop bits on a serial device.
-
-  @param  This             Protocol instance pointer.
-  @param  BaudRate         The requested baud rate. A BaudRate value of 0 will use the the
-                           device's default interface speed.
-  @param  ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
-                           serial interface. A ReceiveFifoDepth value of 0 will use
-                           the device's default FIFO depth.
-  @param  Timeout          The requested time out for a single character in microseconds.
-                           This timeout applies to both the transmit and receive side of the
-                           interface. A Timeout value of 0 will use the device's default time
-                           out value.
-  @param  Parity           The type of parity to use on this serial device. A Parity value of
-                           DefaultParity will use the device's default parity value.
-  @param  DataBits         The number of data bits to use on the serial device. A DataBits
-                           value of 0 will use the device's default data bit setting.
-  @param  StopBits         The number of stop bits to use on this serial device. A StopBits
-                           value of DefaultStopBits will use the device's default number of
-                           stop bits.
-
-  @retval EFI_SUCCESS      The device was reset.
-  @retval EFI_DEVICE_ERROR The serial device could not be reset.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialSetAttributes (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN UINT64                  BaudRate,
-  IN UINT32                  ReceiveFifoDepth,
-  IN UINT32                  Timeout,
-  IN EFI_PARITY_TYPE         Parity,
-  IN UINT8                   DataBits,
-  IN EFI_STOP_BITS_TYPE      StopBits
-  )
-{
-  EFI_STATUS  Status;
-  EFI_TPL     Tpl;
-
-  //
-  // Set the Serial I/O mode and update the device path
-  //
-
-  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
-
-  //
-  // Set the Serial I/O mode
-  //
-  This->Mode->BaudRate          = BaudRate;
-  This->Mode->ReceiveFifoDepth  = ReceiveFifoDepth;
-  This->Mode->Timeout           = Timeout;
-  This->Mode->Parity            = (UINT32)Parity;
-  This->Mode->DataBits          = (UINT32)DataBits;
-  This->Mode->StopBits          = (UINT32)StopBits;
-
-  //
-  // Check if the device path has actually changed
-  //
-  if (mDevicePath.Uart.BaudRate == BaudRate &&
-      mDevicePath.Uart.Parity   == (UINT8)Parity &&
-      mDevicePath.Uart.DataBits == DataBits &&
-      mDevicePath.Uart.StopBits == (UINT8)StopBits
-     ) {
-    gBS->RestoreTPL (Tpl);
-    return EFI_SUCCESS;
-  }
-
-  //
-  // Update the device path
-  //
-  mDevicePath.Uart.BaudRate = BaudRate;
-  mDevicePath.Uart.DataBits = DataBits;
-  mDevicePath.Uart.Parity   = (UINT8) Parity;
-  mDevicePath.Uart.StopBits = (UINT8) StopBits;
-
-  Status = gBS->ReinstallProtocolInterface (
-                  gHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  &mDevicePath,
-                  &mDevicePath
-                  );
-
-  gBS->RestoreTPL (Tpl);
-
-  return Status;
-}
-
-
-/**
-  Set the control bits on a serial device
-
-  @param  This             Protocol instance pointer.
-  @param  Control          Set the bits of Control that are settable.
-
-  @retval EFI_SUCCESS      The new control bits were set on the serial device.
-  @retval EFI_UNSUPPORTED  The serial device does not support this operation.
-  @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialSetControl (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN UINT32                  Control
-  )
-{
-  return EFI_UNSUPPORTED;
-}
-
-
-/**
-  Retrieves the status of the control bits on a serial device
-
-  @param  This              Protocol instance pointer.
-  @param  Control           A pointer to return the current Control signals from the serial device.
-                            
-  @retval EFI_SUCCESS       The control bits were read from the serial device.
-  @retval EFI_DEVICE_ERROR  The serial device is not functioning correctly.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialGetControl (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  OUT UINT32                 *Control
-  )
-{
-  if (SerialPortPoll ()) {
-    // If a character is pending don't set EFI_SERIAL_INPUT_BUFFER_EMPTY
-    *Control = EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
-  } else {
-    *Control = EFI_SERIAL_INPUT_BUFFER_EMPTY | EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
-  }
-  return EFI_SUCCESS;
-}
-
-
-/**
-  Writes data to a serial device.
-
-  @param  This              Protocol instance pointer.
-  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
-                            data actually written.
-  @param  Buffer            The buffer of 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.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialWrite (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN OUT UINTN               *BufferSize,
-  IN VOID                    *Buffer
-  )
-{
-  UINTN Count;
-  
-  Count = SerialPortWrite (Buffer, *BufferSize);
-
-  if (Count != *BufferSize) {
-    *BufferSize = Count;
-    return EFI_TIMEOUT;
-  }
-
-  return EFI_SUCCESS;
-}
-
-/**
-  Reads data from a serial device.
-
-  @param  This              Protocol instance pointer.
-  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
-                            data returned in Buffer.
-  @param  Buffer            The buffer to return the data into.
-
-  @retval EFI_SUCCESS       The data was read.
-  @retval EFI_DEVICE_ERROR  The device reported an error.
-  @retval EFI_TIMEOUT       The data write was stopped due to a timeout.
-
-**/
-
-EFI_STATUS
-EFIAPI
-SerialRead (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN OUT UINTN               *BufferSize,
-  OUT VOID                   *Buffer
-  )
-{
-  UINTN Count = 0;
-
-  if (SerialPortPoll()) {
-    Count = SerialPortRead (Buffer, *BufferSize);
-  }
-
-  if (Count != *BufferSize) {
-    *BufferSize = Count;
-    return EFI_TIMEOUT;
-  }
-
-  return EFI_SUCCESS;
-}
-
-// 
-// Template used to initialize the GDB Serial IO protocols
-//
-EFI_SERIAL_IO_MODE gSerialIoMode = {
-  0,                                          // ControlMask
-  0,                                          // Timeout
-  FixedPcdGet64 (PcdUartDefaultBaudRate),     // BaudRate
-  1,                                          // ReceiveFifoDepth
-  FixedPcdGet8 (PcdUartDefaultDataBits),      // DataBits
-  FixedPcdGet8 (PcdUartDefaultParity),        // Parity
-  FixedPcdGet8 (PcdUartDefaultStopBits)       // StopBits
-};
-
-
-EFI_SERIAL_IO_PROTOCOL gSerialIoTemplate = {
-  SERIAL_IO_INTERFACE_REVISION,
-  SerialReset,
-  SerialSetAttributes,
-  SerialSetControl,
-  SerialGetControl,
-  SerialWrite,
-  SerialRead,
-  &gSerialIoMode
-};
-
-/**
-  Initialize the state information for the Serial Io Protocol
-
-  @param  ImageHandle   of the loaded driver
-  @param  SystemTable   Pointer to the System Table
-
-  @retval EFI_SUCCESS           Protocol registered
-  @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
-  @retval EFI_DEVICE_ERROR      Hardware problems
-
-**/
-EFI_STATUS
-EFIAPI
-SerialDxeInitialize (
-  IN EFI_HANDLE         ImageHandle,
-  IN EFI_SYSTEM_TABLE   *SystemTable
-  )
-{
-  EFI_STATUS      Status;
-
-  // Make a new handle with Serial IO protocol and its device path on it.
-  Status = gBS->InstallMultipleProtocolInterfaces (
-                  &gHandle, 
-                  &gEfiSerialIoProtocolGuid,   &gSerialIoTemplate,
-                  &gEfiDevicePathProtocolGuid, &mDevicePath, 
-                  NULL
-                  );
-  ASSERT_EFI_ERROR (Status);
-  
-  return Status;
-}
-

From 39760729116b476ecc2366ae6bfc349f6b23580e Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:19:06 +0000
Subject: [PATCH 176/525] Omap35xxPkg SerialPortLib: Implement
 Get(Set)Control/SetAttributes

(Sync patch r18969 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19019 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/SerialPortLib/SerialPortLib.c     | 90 +++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/Omap35xxPkg/Library/SerialPortLib/SerialPortLib.c b/Omap35xxPkg/Library/SerialPortLib/SerialPortLib.c
index 58f70d5512fb..7ac12c729f57 100644
--- a/Omap35xxPkg/Library/SerialPortLib/SerialPortLib.c
+++ b/Omap35xxPkg/Library/SerialPortLib/SerialPortLib.c
@@ -3,6 +3,7 @@
 
 
   Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -122,3 +123,92 @@ SerialPortPoll (
   }
 }
 
+/**
+  Sets the control bits on a serial device.
+
+  @param[in] Control            Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param[out] Control           A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  *Control = 0;
+  if (!SerialPortPoll ()) {
+    *Control = EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+  return RETURN_SUCCESS;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+

From ca38bc2a80ade6ae190c40ccd26668b834673ccc Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:19:26 +0000
Subject: [PATCH 177/525] BeagleBoardPkg: Use SerialDxe in MdeModulePkg instead
 of EmbeddedPkg

It is also to remove the reference to TemplateSerialPortExtLib in
EmbeddedPkg.

(Sync patch r18970 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19020 6f19259b-4bc3-4df7-8a09-765794883524
---
 BeagleBoardPkg/BeagleBoardPkg.dsc | 4 ++--
 BeagleBoardPkg/BeagleBoardPkg.fdf | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/BeagleBoardPkg/BeagleBoardPkg.dsc b/BeagleBoardPkg/BeagleBoardPkg.dsc
index 533849228aad..b90576ee76d3 100644
--- a/BeagleBoardPkg/BeagleBoardPkg.dsc
+++ b/BeagleBoardPkg/BeagleBoardPkg.dsc
@@ -2,6 +2,7 @@
 # Beagle board package.
 #
 # Copyright (c) 2009 - 2010, Apple Inc. All rights reserved.<BR>
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
 #    are licensed and made available under the terms and conditions of the BSD License
@@ -87,7 +88,6 @@
   PrePiLib|EmbeddedPkg/Library/PrePiLib/PrePiLib.inf
 
   SerialPortLib|Omap35xxPkg/Library/SerialPortLib/SerialPortLib.inf
-  SerialPortExtLib|EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
   SemihostLib|ArmPkg/Library/SemihostLib/SemihostLib.inf
 
   RealTimeClockLib|Omap35xxPkg/Library/RealTimeClockLib/RealTimeClockLib.inf
@@ -401,7 +401,7 @@
   MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
 #
 # This version uses semi-hosting console
diff --git a/BeagleBoardPkg/BeagleBoardPkg.fdf b/BeagleBoardPkg/BeagleBoardPkg.fdf
index fb1dc26de349..b17ad7d0248e 100644
--- a/BeagleBoardPkg/BeagleBoardPkg.fdf
+++ b/BeagleBoardPkg/BeagleBoardPkg.fdf
@@ -1,6 +1,7 @@
 # FLASH layout file for Beagle board.
 #
 # Copyright (c) 2009, Apple Inc. All rights reserved.<BR>
+# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
 #    are licensed and made available under the terms and conditions of the BSD License
@@ -110,7 +111,7 @@ FvNameGuid         = d0dd3e90-343d-4cb3-8f69-772214989282
   INF MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
 
   INF EmbeddedPkg/ResetRuntimeDxe/ResetRuntimeDxe.inf

From 9b3a440fdb13a3d6a9328ae2e89ffcb4e2804d16 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:20:15 +0000
Subject: [PATCH 178/525] ArmPlatformPkg: Use SerialDxe in MdeModulePkg instead
 of EmbeddedPkg

It is also to integrate PL011SerialPortExtLib to PL011SerialPortLib.

(Sync patch r18971 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19021 6f19259b-4bc3-4df7-8a09-765794883524
---
 ArmPlatformPkg/ArmJunoPkg/ArmJuno.dsc         |   3 +-
 ArmPlatformPkg/ArmJunoPkg/ArmJuno.fdf         |   3 +-
 .../ArmVExpressPkg/ArmVExpress-CTA15-A7.dsc   |   3 +-
 .../ArmVExpressPkg/ArmVExpress-CTA15-A7.fdf   |   3 +-
 .../ArmVExpress-FVP-AArch64.dsc               |   3 +-
 .../ArmVExpress-FVP-AArch64.fdf               |   3 +-
 .../ArmVExpress-RTSM-A15_MPCore.dsc           |   3 +-
 .../ArmVExpress-RTSM-A15_MPCore.fdf           |   3 +-
 .../ArmVExpressPkg/ArmVExpress.dsc.inc        |   1 -
 .../PL011SerialPortExtLib.c                   | 137 ------------------
 .../PL011SerialPortExtLib.inf                 |  43 ------
 .../PL011SerialPortLib/PL011SerialPortLib.c   | 117 ++++++++++++++-
 12 files changed, 131 insertions(+), 191 deletions(-)
 delete mode 100644 ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.c
 delete mode 100644 ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.inf

diff --git a/ArmPlatformPkg/ArmJunoPkg/ArmJuno.dsc b/ArmPlatformPkg/ArmJunoPkg/ArmJuno.dsc
index f5af4267fee6..ba838c706361 100644
--- a/ArmPlatformPkg/ArmJunoPkg/ArmJuno.dsc
+++ b/ArmPlatformPkg/ArmJunoPkg/ArmJuno.dsc
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2013-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -218,7 +219,7 @@
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf {
     <LibraryClasses>
diff --git a/ArmPlatformPkg/ArmJunoPkg/ArmJuno.fdf b/ArmPlatformPkg/ArmJunoPkg/ArmJuno.fdf
index c8f5831093a7..51b1180e7a47 100644
--- a/ArmPlatformPkg/ArmJunoPkg/ArmJuno.fdf
+++ b/ArmPlatformPkg/ArmJunoPkg/ArmJuno.fdf
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2013-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -123,7 +124,7 @@ FvNameGuid         = B73FE497-B92E-416e-8326-45AD0D270092
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.dsc b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.dsc
index c76d729a0d88..5503bbc30002 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.dsc
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.dsc
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2012-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -247,7 +248,7 @@
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
 
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.fdf b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.fdf
index 576b3408e008..5f4f5aaf4998 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.fdf
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-CTA15-A7.fdf
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2012-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -91,7 +92,7 @@ FvNameGuid         = 73dcb643-3862-4904-9076-a94af1890243
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.dsc b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.dsc
index 3f363064b23f..5751167549b8 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.dsc
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.dsc
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -267,7 +268,7 @@
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
 
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.fdf b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.fdf
index 1d92d6f34832..d527da0738ca 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.fdf
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-FVP-AArch64.fdf
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2011 - 2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -155,7 +156,7 @@ FvNameGuid         = 87940482-fc81-41c3-87e6-399cf85ac8a0
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.dsc b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.dsc
index 72103e26568c..a8e326902e11 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.dsc
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.dsc
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -259,7 +260,7 @@
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
 
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.fdf b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.fdf
index b65dd9d533a8..ee50af2115d5 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.fdf
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress-RTSM-A15_MPCore.fdf
@@ -1,5 +1,6 @@
 #
 #  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -156,7 +157,7 @@ FvNameGuid         = 12c68be9-0996-49d3-8c5b-4957379027ee
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress.dsc.inc b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress.dsc.inc
index dc69bbbf747c..05cf0badf7c4 100644
--- a/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress.dsc.inc
+++ b/ArmPlatformPkg/ArmVExpressPkg/ArmVExpress.dsc.inc
@@ -90,7 +90,6 @@
   # ARM PL011 UART Driver
   PL011UartLib|ArmPlatformPkg/Drivers/PL011Uart/PL011Uart.inf
   SerialPortLib|ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortLib.inf
-  SerialPortExtLib|ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.inf
   # ARM SP804 Dual Timer Driver
   TimerLib|ArmPlatformPkg/Library/SP804TimerLib/SP804TimerLib.inf
 
diff --git a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.c b/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.c
deleted file mode 100644
index 44fe78f4f46b..000000000000
--- a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.c
+++ /dev/null
@@ -1,137 +0,0 @@
-/** @file
-  Serial I/O Port library functions with no library constructor/destructor
-
-  Copyright (c) 2012-2014, ARM Ltd. All rights reserved.<BR>
-
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Base.h>
-
-#include <Library/IoLib.h>
-#include <Library/PcdLib.h>
-#include <Library/SerialPortExtLib.h>
-
-#include <Drivers/PL011Uart.h>
-
-/**
-  Set new attributes to PL011.
-
-  @param  BaudRate                The baud rate of the serial device. If the baud rate is not supported,
-                                  the speed will be reduced down to the nearest supported one and the
-                                  variable's value will be updated accordingly.
-  @param  ReceiveFifoDepth        The number of characters the device will buffer on input. If the specified
-                                  value is not supported, the variable's value will be reduced down to the
-                                  nearest supported one.
-  @param  Timeout                 If applicable, the number of microseconds the device will wait
-                                  before timing out a Read or a Write operation.
-  @param  Parity                  If applicable, this is the EFI_PARITY_TYPE that is computed or checked
-                                  as each character is transmitted or received. If the device does not
-                                  support parity, the value is the default parity value.
-  @param  DataBits                The number of data bits in each character
-  @param  StopBits                If applicable, the EFI_STOP_BITS_TYPE number of stop bits per character.
-                                  If the device does not support stop bits, the value is the default stop
-                                  bit value.
-
-  @retval EFI_SUCCESS             All attributes were set correctly on the serial device.
-  @retval EFI_INVALID_PARAMETERS  One or more of the attributes has an unsupported value.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetAttributes (
-  IN OUT UINT64              *BaudRate,
-  IN OUT UINT32              *ReceiveFifoDepth,
-  IN OUT UINT32              *Timeout,
-  IN OUT EFI_PARITY_TYPE     *Parity,
-  IN OUT UINT8               *DataBits,
-  IN OUT EFI_STOP_BITS_TYPE  *StopBits
-  )
-{
-  return PL011UartInitializePort (
-        (UINTN)PcdGet64 (PcdSerialRegisterBase),
-        BaudRate,
-        ReceiveFifoDepth,
-        Parity,
-        DataBits,
-        StopBits);
-}
-
-/**
-
-  Assert or deassert the control signals on a serial port.
-  The following control signals are set according their bit settings :
-  . Request to Send
-  . Data Terminal Ready
-
-  @param[in]  Control  The following bits are taken into account :
-                       . EFI_SERIAL_REQUEST_TO_SEND : assert/deassert the
-                         "Request To Send" control signal if this bit is
-                         equal to one/zero.
-                       . EFI_SERIAL_DATA_TERMINAL_READY : assert/deassert
-                         the "Data Terminal Ready" control signal if this
-                         bit is equal to one/zero.
-                       . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : enable/disable
-                         the hardware loopback if this bit is equal to
-                         one/zero.
-                       . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : not supported.
-                       . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : enable/
-                         disable the hardware flow control based on CTS (Clear
-                         To Send) and RTS (Ready To Send) control signals.
-
-  @retval  RETURN_SUCCESS      The new control bits were set on the serial device.
-  @retval  RETURN_UNSUPPORTED  The serial device does not support this operation.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetControl (
-  IN UINT32  Control
-  )
-{
-  return PL011UartSetControl ((UINTN)PcdGet64 (PcdSerialRegisterBase), Control);
-}
-
-/**
-
-  Retrieve the status of the control bits on a serial device.
-
-  @param[out]  Control  Status of the control bits on a serial device :
-
-                        . EFI_SERIAL_DATA_CLEAR_TO_SEND, EFI_SERIAL_DATA_SET_READY,
-                          EFI_SERIAL_RING_INDICATE, EFI_SERIAL_CARRIER_DETECT,
-                          EFI_SERIAL_REQUEST_TO_SEND, EFI_SERIAL_DATA_TERMINAL_READY
-                          are all related to the DTE (Data Terminal Equipment) and
-                          DCE (Data Communication Equipment) modes of operation of
-                          the serial device.
-                        . EFI_SERIAL_INPUT_BUFFER_EMPTY : equal to one if the receive
-                          buffer is empty, 0 otherwise.
-                        . EFI_SERIAL_OUTPUT_BUFFER_EMPTY : equal to one if the transmit
-                          buffer is empty, 0 otherwise.
-                        . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : equal to one if the
-                          hardware loopback is enabled (the ouput feeds the receive
-                          buffer), 0 otherwise.
-                        . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : equal to one if a
-                          loopback is accomplished by software, 0 otherwise.
-                        . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : equal to one if the
-                          hardware flow control based on CTS (Clear To Send) and RTS
-                          (Ready To Send) control signals is enabled, 0 otherwise.
-
-  @retval RETURN_SUCCESS  The control bits were read from the serial device.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortGetControl (
-  OUT UINT32  *Control
-  )
-{
-  return PL011UartGetControl ((UINTN)PcdGet64 (PcdSerialRegisterBase), Control);
-}
diff --git a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.inf b/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.inf
deleted file mode 100644
index 723cc97d1b06..000000000000
--- a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortExtLib.inf
+++ /dev/null
@@ -1,43 +0,0 @@
-#/** @file
-#
-#  Component description file for PL011SerialPortLib module
-#
-#  Copyright (c) 2011-2012, ARM Ltd. All rights reserved.<BR>
-#
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution.  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php
-#
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#
-#**/
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = PL011SerialPortExtLib
-  FILE_GUID                      = 2be281f1-c506-4558-bd98-d6930e6de9d6
-  MODULE_TYPE                    = BASE
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = SerialPortExtLib
-
-[Sources.common]
-  PL011SerialPortExtLib.c
-
-[LibraryClasses]
-  PL011UartLib
-  PcdLib
-
-[Packages]
-  EmbeddedPkg/EmbeddedPkg.dec
-  MdePkg/MdePkg.dec
-  MdeModulePkg/MdeModulePkg.dec
-  ArmPlatformPkg/ArmPlatformPkg.dec
-
-[Pcd]
-  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits
diff --git a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortLib.c b/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortLib.c
index d4f7fc96f6d4..7497b5eb7f19 100644
--- a/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortLib.c
+++ b/ArmPlatformPkg/Library/PL011SerialPortLib/PL011SerialPortLib.c
@@ -2,7 +2,8 @@
   Serial I/O Port library functions with no library constructor/destructor
 
   Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
-  Copyright (c) 2012 - 2013, ARM Ltd. All rights reserved.<BR>
+  Copyright (c) 2012 - 2014, ARM Ltd. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -19,7 +20,6 @@
 #include <Library/IoLib.h>
 #include <Library/PcdLib.h>
 #include <Library/SerialPortLib.h>
-#include <Library/SerialPortExtLib.h>
 
 #include <Drivers/PL011Uart.h>
 
@@ -110,4 +110,117 @@ SerialPortPoll (
 {
   return PL011UartPoll ((UINTN)PcdGet64 (PcdSerialRegisterBase));
 }
+/**
+  Set new attributes to PL011.
+
+  @param  BaudRate                The baud rate of the serial device. If the baud rate is not supported,
+                                  the speed will be reduced down to the nearest supported one and the
+                                  variable's value will be updated accordingly.
+  @param  ReceiveFifoDepth        The number of characters the device will buffer on input. If the specified
+                                  value is not supported, the variable's value will be reduced down to the
+                                  nearest supported one.
+  @param  Timeout                 If applicable, the number of microseconds the device will wait
+                                  before timing out a Read or a Write operation.
+  @param  Parity                  If applicable, this is the EFI_PARITY_TYPE that is computed or checked
+                                  as each character is transmitted or received. If the device does not
+                                  support parity, the value is the default parity value.
+  @param  DataBits                The number of data bits in each character
+  @param  StopBits                If applicable, the EFI_STOP_BITS_TYPE number of stop bits per character.
+                                  If the device does not support stop bits, the value is the default stop
+                                  bit value.
+
+  @retval EFI_SUCCESS             All attributes were set correctly on the serial device.
+  @retval EFI_INVALID_PARAMETERS  One or more of the attributes has an unsupported value.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64              *BaudRate,
+  IN OUT UINT32              *ReceiveFifoDepth,
+  IN OUT UINT32              *Timeout,
+  IN OUT EFI_PARITY_TYPE     *Parity,
+  IN OUT UINT8               *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE  *StopBits
+  )
+{
+  return PL011UartInitializePort (
+        (UINTN)PcdGet64 (PcdSerialRegisterBase),
+        BaudRate,
+        ReceiveFifoDepth,
+        Parity,
+        DataBits,
+        StopBits);
+}
+
+/**
+
+  Assert or deassert the control signals on a serial port.
+  The following control signals are set according their bit settings :
+  . Request to Send
+  . Data Terminal Ready
+
+  @param[in]  Control  The following bits are taken into account :
+                       . EFI_SERIAL_REQUEST_TO_SEND : assert/deassert the
+                         "Request To Send" control signal if this bit is
+                         equal to one/zero.
+                       . EFI_SERIAL_DATA_TERMINAL_READY : assert/deassert
+                         the "Data Terminal Ready" control signal if this
+                         bit is equal to one/zero.
+                       . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : enable/disable
+                         the hardware loopback if this bit is equal to
+                         one/zero.
+                       . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : not supported.
+                       . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : enable/
+                         disable the hardware flow control based on CTS (Clear
+                         To Send) and RTS (Ready To Send) control signals.
+
+  @retval  RETURN_SUCCESS      The new control bits were set on the serial device.
+  @retval  RETURN_UNSUPPORTED  The serial device does not support this operation.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32  Control
+  )
+{
+  return PL011UartSetControl ((UINTN)PcdGet64 (PcdSerialRegisterBase), Control);
+}
+
+/**
 
+  Retrieve the status of the control bits on a serial device.
+
+  @param[out]  Control  Status of the control bits on a serial device :
+
+                        . EFI_SERIAL_DATA_CLEAR_TO_SEND, EFI_SERIAL_DATA_SET_READY,
+                          EFI_SERIAL_RING_INDICATE, EFI_SERIAL_CARRIER_DETECT,
+                          EFI_SERIAL_REQUEST_TO_SEND, EFI_SERIAL_DATA_TERMINAL_READY
+                          are all related to the DTE (Data Terminal Equipment) and
+                          DCE (Data Communication Equipment) modes of operation of
+                          the serial device.
+                        . EFI_SERIAL_INPUT_BUFFER_EMPTY : equal to one if the receive
+                          buffer is empty, 0 otherwise.
+                        . EFI_SERIAL_OUTPUT_BUFFER_EMPTY : equal to one if the transmit
+                          buffer is empty, 0 otherwise.
+                        . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : equal to one if the
+                          hardware loopback is enabled (the output feeds the receive
+                          buffer), 0 otherwise.
+                        . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : equal to one if a
+                          loopback is accomplished by software, 0 otherwise.
+                        . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : equal to one if the
+                          hardware flow control based on CTS (Clear To Send) and RTS
+                          (Ready To Send) control signals is enabled, 0 otherwise.
+
+  @retval RETURN_SUCCESS  The control bits were read from the serial device.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32  *Control
+  )
+{
+  return PL011UartGetControl ((UINTN)PcdGet64 (PcdSerialRegisterBase), Control);
+}

From 3ab4039f64099df02026da8952a28c1f6ab42df6 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:20:39 +0000
Subject: [PATCH 179/525] OvmfPkg XenConsoleSerialPortLib: Implement
 Get(Set)Control/SetAttributes

(Sync patch r18972 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19022 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../XenConsoleSerialPortLib.c                 | 95 +++++++++++++++++++
 1 file changed, 95 insertions(+)

diff --git a/OvmfPkg/Library/XenConsoleSerialPortLib/XenConsoleSerialPortLib.c b/OvmfPkg/Library/XenConsoleSerialPortLib/XenConsoleSerialPortLib.c
index 4ccb38d585fd..295696312413 100644
--- a/OvmfPkg/Library/XenConsoleSerialPortLib/XenConsoleSerialPortLib.c
+++ b/OvmfPkg/Library/XenConsoleSerialPortLib/XenConsoleSerialPortLib.c
@@ -2,6 +2,7 @@
   Xen console SerialPortLib instance
 
   Copyright (c) 2015, Linaro Ltd. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -205,3 +206,97 @@ SerialPortPoll (
   return mXenConsoleInterface &&
     mXenConsoleInterface->in_cons != mXenConsoleInterface->in_prod;
 }
+
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  if (!mXenConsoleInterface) {
+    return RETURN_UNSUPPORTED;
+  }
+
+  *Control = 0;
+  if (!SerialPortPoll ()) {
+    *Control = EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+  return RETURN_SUCCESS;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+

From 5cfecbc9d59aeb81a2547dfe3e2045d459558270 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:21:14 +0000
Subject: [PATCH 180/525] ArmVirtPkg: Use SerialDxe in MdeModulePkg instead of
 EmbeddedPkg

Beyond just changing the directly related lines in the FDF and DSC files,
we have to adapt the EarlyFdtPL011SerialPortLib and FdtPL011SerialPortLib
instances as well, in the same patch. This is because the EmbeddedPkg
driver expects the SerialPortSetAttributes(),
SerialPortSetControl() and SerialPortGetControl() functions from
SerialPortExtLib, while the MdeModulePkg driver expects them from
SerialPortLib itself.

We cannot implement these functions in ArmVirtPkg's SerialPortLib
instances *before* flipping the driver, because it would cause double
function definitions in the EmbeddedPkg driver. We also can't implement
the functions *after* flipping the driver, because it would cause
unresolved function references in the MdeModulePkg driver. Therefore
we have to implement the functions simultaneously with the driver
replacement.

(Sync patch r18973 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19023 6f19259b-4bc3-4df7-8a09-765794883524
---
 ArmVirtPkg/ArmVirt.dsc.inc                    |  1 -
 ArmVirtPkg/ArmVirtQemu.dsc                    |  2 +-
 ArmVirtPkg/ArmVirtQemu.fdf                    |  2 +-
 ArmVirtPkg/ArmVirtXen.dsc                     |  3 +-
 ArmVirtPkg/ArmVirtXen.fdf                     |  3 +-
 .../EarlyFdtPL011SerialPortLib.c              | 88 ++++++++++++++++++-
 .../FdtPL011SerialPortLib.c                   | 87 ++++++++++++++++++
 7 files changed, 180 insertions(+), 6 deletions(-)

diff --git a/ArmVirtPkg/ArmVirt.dsc.inc b/ArmVirtPkg/ArmVirt.dsc.inc
index 8372c5813cb3..72f583ed274e 100644
--- a/ArmVirtPkg/ArmVirt.dsc.inc
+++ b/ArmVirtPkg/ArmVirt.dsc.inc
@@ -91,7 +91,6 @@
   # ARM PL011 UART Driver
   PL011UartLib|ArmPlatformPkg/Drivers/PL011Uart/PL011Uart.inf
   SerialPortLib|ArmVirtPkg/Library/FdtPL011SerialPortLib/FdtPL011SerialPortLib.inf
-  SerialPortExtLib|EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf
 
   #
   # Uncomment (and comment out the next line) For RealView Debugger. The Standard IO window
diff --git a/ArmVirtPkg/ArmVirtQemu.dsc b/ArmVirtPkg/ArmVirtQemu.dsc
index f1af96827fde..efb4fdd35d44 100644
--- a/ArmVirtPkg/ArmVirtQemu.dsc
+++ b/ArmVirtPkg/ArmVirtQemu.dsc
@@ -280,7 +280,7 @@
   MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
 
diff --git a/ArmVirtPkg/ArmVirtQemu.fdf b/ArmVirtPkg/ArmVirtQemu.fdf
index 89a4015e595b..738e3db57045 100644
--- a/ArmVirtPkg/ArmVirtQemu.fdf
+++ b/ArmVirtPkg/ArmVirtQemu.fdf
@@ -134,7 +134,7 @@ READ_LOCK_STATUS   = TRUE
   INF MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitterDxe.inf
   INF MdeModulePkg/Universal/Console/GraphicsConsoleDxe/GraphicsConsoleDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmVirtPkg/ArmVirtXen.dsc b/ArmVirtPkg/ArmVirtXen.dsc
index 5c19afca30b9..42976dd0164b 100644
--- a/ArmVirtPkg/ArmVirtXen.dsc
+++ b/ArmVirtPkg/ArmVirtXen.dsc
@@ -1,6 +1,7 @@
 #
 #  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
 #  Copyright (c) 2014, Linaro Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -197,7 +198,7 @@
 
   MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
   MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
+  MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabaseDxe.inf
 
diff --git a/ArmVirtPkg/ArmVirtXen.fdf b/ArmVirtPkg/ArmVirtXen.fdf
index 97cab4b058f2..729014753fa1 100644
--- a/ArmVirtPkg/ArmVirtXen.fdf
+++ b/ArmVirtPkg/ArmVirtXen.fdf
@@ -1,6 +1,7 @@
 #
 #  Copyright (c) 2011-2015, ARM Limited. All rights reserved.
 #  Copyright (c) 2014, Linaro Limited. All rights reserved.
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -134,7 +135,7 @@ READ_LOCK_STATUS   = TRUE
   #
   INF MdeModulePkg/Universal/Console/ConPlatformDxe/ConPlatformDxe.inf
   INF MdeModulePkg/Universal/Console/TerminalDxe/TerminalDxe.inf
-  INF EmbeddedPkg/SerialDxe/SerialDxe.inf
+  INF MdeModulePkg/Universal/SerialDxe/SerialDxe.inf
 
   INF ArmPkg/Drivers/ArmGic/ArmGicDxe.inf
   INF ArmPkg/Drivers/TimerDxe/TimerDxe.inf
diff --git a/ArmVirtPkg/Library/FdtPL011SerialPortLib/EarlyFdtPL011SerialPortLib.c b/ArmVirtPkg/Library/FdtPL011SerialPortLib/EarlyFdtPL011SerialPortLib.c
index ba6d277d4571..c8bfb2972eb9 100644
--- a/ArmVirtPkg/Library/FdtPL011SerialPortLib/EarlyFdtPL011SerialPortLib.c
+++ b/ArmVirtPkg/Library/FdtPL011SerialPortLib/EarlyFdtPL011SerialPortLib.c
@@ -4,6 +4,7 @@
   Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
   Copyright (c) 2012 - 2013, ARM Ltd. All rights reserved.<BR>
   Copyright (c) 2014, Linaro Ltd. All rights reserved.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -19,7 +20,6 @@
 
 #include <Library/PcdLib.h>
 #include <Library/SerialPortLib.h>
-#include <Library/SerialPortExtLib.h>
 #include <libfdt.h>
 
 #include <Drivers/PL011Uart.h>
@@ -183,3 +183,89 @@ SerialPortPoll (
 {
   return FALSE;
 }
+
+/**
+  Sets the control bits on a serial device.
+
+  @param[in] Control            Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param[out] Control           A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
diff --git a/ArmVirtPkg/Library/FdtPL011SerialPortLib/FdtPL011SerialPortLib.c b/ArmVirtPkg/Library/FdtPL011SerialPortLib/FdtPL011SerialPortLib.c
index aced6666a913..b73ab8f48a9d 100644
--- a/ArmVirtPkg/Library/FdtPL011SerialPortLib/FdtPL011SerialPortLib.c
+++ b/ArmVirtPkg/Library/FdtPL011SerialPortLib/FdtPL011SerialPortLib.c
@@ -5,6 +5,7 @@
   Copyright (c) 2012 - 2013, ARM Ltd. All rights reserved.<BR>
   Copyright (c) 2014, Linaro Ltd. All rights reserved.<BR>
   Copyright (c) 2014, Red Hat, Inc.<BR>
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -148,3 +149,89 @@ SerialPortPoll (
   }
   return FALSE;
 }
+
+/**
+  Sets the baud rate, receive FIFO depth, transmit/receice time out, parity,
+  data bits, and stop bits on a serial device.
+
+  @param BaudRate           The requested baud rate. A BaudRate value of 0 will use the
+                            device's default interface speed.
+                            On output, the value actually set.
+  @param ReveiveFifoDepth   The requested depth of the FIFO on the receive side of the
+                            serial interface. A ReceiveFifoDepth value of 0 will use
+                            the device's default FIFO depth.
+                            On output, the value actually set.
+  @param Timeout            The requested time out for a single character in microseconds.
+                            This timeout applies to both the transmit and receive side of the
+                            interface. A Timeout value of 0 will use the device's default time
+                            out value.
+                            On output, the value actually set.
+  @param Parity             The type of parity to use on this serial device. A Parity value of
+                            DefaultParity will use the device's default parity value.
+                            On output, the value actually set.
+  @param DataBits           The number of data bits to use on the serial device. A DataBits
+                            vaule of 0 will use the device's default data bit setting.
+                            On output, the value actually set.
+  @param StopBits           The number of stop bits to use on this serial device. A StopBits
+                            value of DefaultStopBits will use the device's default number of
+                            stop bits.
+                            On output, the value actually set.
+
+  @retval RETURN_SUCCESS            The new attributes were set on the serial device.
+  @retval RETURN_UNSUPPORTED        The serial device does not support this operation.
+  @retval RETURN_INVALID_PARAMETER  One or more of the attributes has an unsupported value.
+  @retval RETURN_DEVICE_ERROR       The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetAttributes (
+  IN OUT UINT64             *BaudRate,
+  IN OUT UINT32             *ReceiveFifoDepth,
+  IN OUT UINT32             *Timeout,
+  IN OUT EFI_PARITY_TYPE    *Parity,
+  IN OUT UINT8              *DataBits,
+  IN OUT EFI_STOP_BITS_TYPE *StopBits
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Sets the control bits on a serial device.
+
+  @param Control                Sets the bits of Control that are settable.
+
+  @retval RETURN_SUCCESS        The new control bits were set on the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortSetControl (
+  IN UINT32 Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+
+/**
+  Retrieve the status of the control bits on a serial device.
+
+  @param Control                A pointer to return the current control signals from the serial device.
+
+  @retval RETURN_SUCCESS        The control bits were read from the serial device.
+  @retval RETURN_UNSUPPORTED    The serial device does not support this operation.
+  @retval RETURN_DEVICE_ERROR   The serial device is not functioning correctly.
+
+**/
+RETURN_STATUS
+EFIAPI
+SerialPortGetControl (
+  OUT UINT32 *Control
+  )
+{
+  return RETURN_UNSUPPORTED;
+}
+

From 7b8985705ba2a0a8e9b5766eb7cb0a70dd41a103 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Mon, 30 Nov 2015 03:22:01 +0000
Subject: [PATCH 181/525] EmbeddedPkg: Remove SerialDxe and SerialPortExtLib
 libraries

(Sync patch r18974 from main trunk.)

Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19024 6f19259b-4bc3-4df7-8a09-765794883524
---
 EmbeddedPkg/EmbeddedPkg.dsc                   |   6 +-
 .../Include/Library/SerialPortExtLib.h        | 116 ------
 .../SerialPortExtLibNull.c                    |  48 ---
 .../SerialPortExtLibNull.inf                  |  30 --
 .../TemplateSerialPortExtLib.c                |  79 ----
 .../TemplateSerialPortExtLib.inf              |  36 --
 EmbeddedPkg/SerialDxe/SerialDxe.inf           |  55 ---
 EmbeddedPkg/SerialDxe/SerialIo.c              | 391 ------------------
 8 files changed, 1 insertion(+), 760 deletions(-)
 delete mode 100644 EmbeddedPkg/Include/Library/SerialPortExtLib.h
 delete mode 100644 EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.c
 delete mode 100644 EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf
 delete mode 100644 EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.c
 delete mode 100644 EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
 delete mode 100644 EmbeddedPkg/SerialDxe/SerialDxe.inf
 delete mode 100644 EmbeddedPkg/SerialDxe/SerialIo.c

diff --git a/EmbeddedPkg/EmbeddedPkg.dsc b/EmbeddedPkg/EmbeddedPkg.dsc
index 6719eea37471..a5507ed220d5 100644
--- a/EmbeddedPkg/EmbeddedPkg.dsc
+++ b/EmbeddedPkg/EmbeddedPkg.dsc
@@ -2,7 +2,7 @@
 # Embedded Package
 #
 #
-# Copyright (c) 2007, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 # Copyright (c) 2012-2015, ARM Ltd. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
@@ -68,7 +68,6 @@
   PrePiLib|EmbeddedPkg/Library/PrePiLib/PrePiLib.inf
 
   SerialPortLib|MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
-  SerialPortExtLib|EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
   RealTimeClockLib|EmbeddedPkg/Library/TemplateRealTimeClockLib/TemplateRealTimeClockLib.inf
   EfiResetSystemLib|EmbeddedPkg/Library/TemplateResetSystemLib/TemplateResetSystemLib.inf
   GdbSerialLib|EmbeddedPkg/Library/GdbSerialLib/GdbSerialLib.inf
@@ -249,8 +248,6 @@
   EmbeddedPkg/Library/GdbSerialLib/GdbSerialLib.inf
   EmbeddedPkg/Library/PrePiExtractGuidedSectionLib/PrePiExtractGuidedSectionLib.inf
   EmbeddedPkg/Library/PrePiLib/PrePiLib.inf
-  MdePkg/Library/BaseSerialPortLibNull/BaseSerialPortLibNull.inf
-  EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf
   EmbeddedPkg/Library/TemplateResetSystemLib/TemplateResetSystemLib.inf
   EmbeddedPkg/Library/TemplateRealTimeClockLib/TemplateRealTimeClockLib.inf
   EmbeddedPkg/Library/LzmaHobCustomDecompressLib/LzmaHobCustomDecompressLib.inf
@@ -261,7 +258,6 @@
   EmbeddedPkg/EmbeddedMonotonicCounter/EmbeddedMonotonicCounter.inf
   EmbeddedPkg/RealTimeClockRuntimeDxe/RealTimeClockRuntimeDxe.inf
   EmbeddedPkg/ResetRuntimeDxe/ResetRuntimeDxe.inf
-  EmbeddedPkg/SerialDxe/SerialDxe.inf
   EmbeddedPkg/SimpleTextInOutSerial/SimpleTextInOutSerial.inf
   EmbeddedPkg/MetronomeDxe/MetronomeDxe.inf {
     <LibraryClasses>
diff --git a/EmbeddedPkg/Include/Library/SerialPortExtLib.h b/EmbeddedPkg/Include/Library/SerialPortExtLib.h
deleted file mode 100644
index 0d0abb35ff54..000000000000
--- a/EmbeddedPkg/Include/Library/SerialPortExtLib.h
+++ /dev/null
@@ -1,116 +0,0 @@
-/** @file
-
-  Serial I/O port control interface extension.
-
-  This library provides an extension to the library providing common
-  serial I/O port functions that is defined in MdePkg. The aim is to
-  provide more control over the functionalities of a serial port. The
-  extension covers all the needs of the UEFI Serial I/O Protocol.
-  Though, its use is not restricted to the UEFI Serial I/O Protocol.
-  It could for example be used in the PEI phase of the boot sequence
-  as well.
-
-  Copyright (c) 2012 - 2014, ARM Ltd. All rights reserved.
-
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#ifndef __SERIAL_PORT_EXT_LIB_H__
-#define __SERIAL_PORT_EXT_LIB_H__
-
-#include <Uefi/UefiBaseType.h>
-#include <Protocol/SerialIo.h>
-
-/**
-
-  Assert or deassert the control signals on a serial port.
-  The following control signals are set according their bit settings :
-  . Request to Send
-  . Data Terminal Ready
-
-  @param[in]  Control  The following bits are taken into account :
-                       . EFI_SERIAL_REQUEST_TO_SEND : assert/deassert the
-                         "Request To Send" control signal if this bit is
-                         equal to one/zero.
-                       . EFI_SERIAL_DATA_TERMINAL_READY : assert/deassert
-                         the "Data Terminal Ready" control signal if this
-                         bit is equal to one/zero.
-                       . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : enable/disable
-                         the hardware loopback if this bit is equal to
-                         one/zero.
-                       . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : not supported.
-                       . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : enable/
-                         disable the hardware flow control based on CTS (Clear
-                         To Send) and RTS (Ready To Send) control signals.
-
-  @retval  RETURN_SUCCESS      The new control bits were set on the serial device.
-  @retval  RETURN_UNSUPPORTED  The serial device does not support this operation.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetControl (
-  IN UINT32  Control
-  );
-
-/**
-
-  Retrieve the status of the control bits on a serial device.
-
-  @param[out]  Control  Status of the control bits on a serial device :
-
-                        . EFI_SERIAL_DATA_CLEAR_TO_SEND, EFI_SERIAL_DATA_SET_READY,
-                          EFI_SERIAL_RING_INDICATE, EFI_SERIAL_CARRIER_DETECT,
-                          EFI_SERIAL_REQUEST_TO_SEND, EFI_SERIAL_DATA_TERMINAL_READY
-                          are all related to the DTE (Data Terminal Equipment) and
-                          DCE (Data Communication Equipment) modes of operation of
-                          the serial device.
-                        . EFI_SERIAL_INPUT_BUFFER_EMPTY : equal to one if the receive
-                          buffer is empty, 0 otherwise.
-                        . EFI_SERIAL_OUTPUT_BUFFER_EMPTY : equal to one if the transmit
-                          buffer is empty, 0 otherwise.
-                        . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : equal to one if the
-                          hardware loopback is enabled (the ouput feeds the receive
-                          buffer), 0 otherwise.
-                        . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : equal to one if a
-                          loopback is accomplished by software, 0 otherwise.
-                        . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : equal to one if the
-                          hardware flow control based on CTS (Clear To Send) and RTS
-                          (Ready To Send) control signals is enabled, 0 otherwise.
-
-  @retval RETURN_SUCCESS       The control bits were read from the serial device.
-  @retval RETURN_DEVICE_ERROR  The serial device is not functioning correctly.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortGetControl (
-  OUT UINT32  *Control
-  );
-
-/**
-  Set the serial device attributes.
-
-  @return    Always return EFI_UNSUPPORTED.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetAttributes (
-  IN OUT UINT64              *BaudRate,
-  IN OUT UINT32              *ReceiveFifoDepth,
-  IN OUT UINT32              *Timeout,
-  IN OUT EFI_PARITY_TYPE     *Parity,
-  IN OUT UINT8               *DataBits,
-  IN OUT EFI_STOP_BITS_TYPE  *StopBits
-  );
-
-#endif
-
diff --git a/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.c b/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.c
deleted file mode 100644
index fb7dea54a684..000000000000
--- a/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.c
+++ /dev/null
@@ -1,48 +0,0 @@
-/** @file
-
-  Copyright (c) 2014, Linaro Ltd. All rights reserved.<BR>
-
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Library/SerialPortExtLib.h>
-
-RETURN_STATUS
-EFIAPI
-SerialPortSetAttributes (
-  IN OUT UINT64              *BaudRate,
-  IN OUT UINT32              *ReceiveFifoDepth,
-  IN OUT UINT32              *Timeout,
-  IN OUT EFI_PARITY_TYPE     *Parity,
-  IN OUT UINT8               *DataBits,
-  IN OUT EFI_STOP_BITS_TYPE  *StopBits
-  )
-{
-  return RETURN_SUCCESS;
-}
-
-RETURN_STATUS
-EFIAPI
-SerialPortSetControl (
-  IN UINT32                  Control
-  )
-{
-  return RETURN_SUCCESS;
-}
-
-RETURN_STATUS
-EFIAPI
-SerialPortGetControl (
-  OUT UINT32                  *Control
-  )
-{
-  *Control = 0;
-  return RETURN_SUCCESS;
-}
diff --git a/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf b/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf
deleted file mode 100644
index a1ac3febd586..000000000000
--- a/EmbeddedPkg/Library/SerialPortExtLibNull/SerialPortExtLibNull.inf
+++ /dev/null
@@ -1,30 +0,0 @@
-#/** @file
-#
-#  Component description file for PL011SerialPortLib module
-#
-#  Copyright (c) 2011-2014, ARM Ltd. All rights reserved.<BR>
-#
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution.  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php
-#
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#
-#**/
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = SerialPortExtLibNull
-  FILE_GUID                      = BD396D28-085E-477A-A5DE-A8D91DD1F752
-  MODULE_TYPE                    = BASE
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = SerialPortExtLib
-
-[Sources.common]
-  SerialPortExtLibNull.c
-
-[Packages]
-  MdePkg/MdePkg.dec
-  EmbeddedPkg/EmbeddedPkg.dec
diff --git a/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.c b/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.c
deleted file mode 100644
index f0f8465cb6d4..000000000000
--- a/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.c
+++ /dev/null
@@ -1,79 +0,0 @@
-/** @file
-  Extended Serial I/O Port library functions
-
-  Copyright (c) 2012, ARM Ltd. All rights reserved.
-
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <Base.h>
-
-#include <Library/SerialPortLib.h>
-#include <Library/SerialPortExtLib.h>
-
-/**
-  Set the serial device control bits.
-
-  @return    Always return RETURN_UNSUPPORTED.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetControl (
-    IN UINT32                   Control
-  )
-{
-  return RETURN_UNSUPPORTED;
-}
-
-/**
-  Get the serial device control bits.
-
-  @param  Control  Control signals read from the serial device.
-
-  @retval EFI_SUCCESS             The control bits were read from the serial device.
-  @retval EFI_DEVICE_ERROR        The serial device is not functioning correctly.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortGetControl (
-  OUT UINT32  *Control
-  )
-{
-  if (SerialPortPoll ()) {
-    // If a character is pending don't set EFI_SERIAL_INPUT_BUFFER_EMPTY
-    *Control = EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
-  } else {
-    *Control = EFI_SERIAL_INPUT_BUFFER_EMPTY | EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
-  }
-  return RETURN_SUCCESS;
-}
-
-/**
-  Set the serial device attributes.
-
-  @return    Always return RETURN_UNSUPPORTED.
-
-**/
-RETURN_STATUS
-EFIAPI
-SerialPortSetAttributes (
-  IN OUT UINT64              *BaudRate,
-  IN OUT UINT32              *ReceiveFifoDepth,
-  IN OUT UINT32              *Timeout,
-  IN OUT EFI_PARITY_TYPE     *Parity,
-  IN OUT UINT8               *DataBits,
-  IN OUT EFI_STOP_BITS_TYPE  *StopBits
-  )
-{
-  return RETURN_UNSUPPORTED;
-}
-
diff --git a/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf b/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
deleted file mode 100644
index 2e95405af452..000000000000
--- a/EmbeddedPkg/Library/TemplateSerialPortExtLib/TemplateSerialPortExtLib.inf
+++ /dev/null
@@ -1,36 +0,0 @@
-#/** @file
-# Template for Extended Serial Port Library for UEFI drivers
-#
-# Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>
-# Copyright (c) 2012, ARM Ltd. All rights reserved.<BR>
-#
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution. The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#
-#
-#**/
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = TemplateSerialPortExtLib
-  FILE_GUID                      = 231fe752-40ac-40b0-8d23-4e341309b964
-  MODULE_TYPE                    = BASE
-  VERSION_STRING                 = 1.0
-  LIBRARY_CLASS                  = SerialPortExtLib
-
-
-#
-#  VALID_ARCHITECTURES           = ARM IA32 X64 IPF EBC
-#
-
-[Sources.common]
-  TemplateSerialPortExtLib.c
-
-[Packages]
-  MdePkg/MdePkg.dec
-  EmbeddedPkg/EmbeddedPkg.dec
-
diff --git a/EmbeddedPkg/SerialDxe/SerialDxe.inf b/EmbeddedPkg/SerialDxe/SerialDxe.inf
deleted file mode 100644
index aed458df6385..000000000000
--- a/EmbeddedPkg/SerialDxe/SerialDxe.inf
+++ /dev/null
@@ -1,55 +0,0 @@
-#/** @file
-#
-#  Convert SerialLib into SerialIo protocol
-#
-#  Copyright (c) 2008, Intel Corporation. All rights reserved.<BR>
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution.  The full text of the license may be found at
-#  http://opensource.org/licenses/bsd-license.php
-#
-#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#
-#**/
-
-[Defines]
-  INF_VERSION                    = 0x00010005
-  BASE_NAME                      = SerialDxe
-  FILE_GUID                      = D3987D4B-971A-435F-8CAF-4967EB627241
-  MODULE_TYPE                    = DXE_DRIVER
-  VERSION_STRING                 = 1.0
-
-  ENTRY_POINT                    = SerialDxeInitialize
-
-[Sources.common]
-  SerialIo.c
-
-[Packages]
-  MdePkg/MdePkg.dec
-  EmbeddedPkg/EmbeddedPkg.dec
-
-[LibraryClasses]
-  BaseLib
-  ReportStatusCodeLib
-  MemoryAllocationLib
-  UefiLib
-  UefiBootServicesTableLib
-  BaseMemoryLib
-  DebugLib
-  UefiDriverEntryPoint
-  SerialPortLib
-  SerialPortExtLib
-
-[Protocols]
-  gEfiSerialIoProtocolGuid
-  gEfiDevicePathProtocolGuid
-
-[FixedPcd]
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity
-  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits
-
-[Depex]
-  TRUE
diff --git a/EmbeddedPkg/SerialDxe/SerialIo.c b/EmbeddedPkg/SerialDxe/SerialIo.c
deleted file mode 100644
index 7a849b7a0139..000000000000
--- a/EmbeddedPkg/SerialDxe/SerialIo.c
+++ /dev/null
@@ -1,391 +0,0 @@
-/** @file
-  Serial IO Abstraction for GDB stub. This allows an EFI consoles that shows up on the system
-  running GDB. One console for error information and another console for user input/output.
-
-  Basic packet format is $packet-data#checksum. So every command has 4 bytes of overhead: $,
-  #, 0, 0. The 0 and 0 are the ascii characters for the checksum.
-
-  Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
-  Copyright (c) 2013-2014, ARM Ltd. All rights reserved.<BR>
-
-  This program and the accompanying materials
-  are licensed and made available under the terms and conditions of the BSD License
-  which accompanies this distribution.  The full text of the license may be found at
-  http://opensource.org/licenses/bsd-license.php
-
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
-**/
-
-#include <PiDxe.h>
-#include <Library/UefiLib.h>
-#include <Library/UefiBootServicesTableLib.h>
-#include <Library/DebugLib.h>
-#include <Library/SerialPortLib.h>
-#include <Library/SerialPortExtLib.h>
-#include <Library/PcdLib.h>
-
-#include <Protocol/SerialIo.h>
-
-typedef struct {
-  VENDOR_DEVICE_PATH        Guid;
-  UART_DEVICE_PATH          Uart;
-  EFI_DEVICE_PATH_PROTOCOL  End;
-} SIMPLE_TEXT_OUT_DEVICE_PATH;
-
-SIMPLE_TEXT_OUT_DEVICE_PATH mDevicePath = {
-  {
-    { HARDWARE_DEVICE_PATH, HW_VENDOR_DP, { sizeof (VENDOR_DEVICE_PATH), 0} },
-    EFI_CALLER_ID_GUID // Use the drivers GUID
-  },
-  {
-    { MESSAGING_DEVICE_PATH, MSG_UART_DP, { sizeof (UART_DEVICE_PATH), 0} },
-    0,        // Reserved
-    FixedPcdGet64 (PcdUartDefaultBaudRate),   // BaudRate
-    FixedPcdGet8 (PcdUartDefaultDataBits),    // DataBits
-    FixedPcdGet8 (PcdUartDefaultParity),      // Parity (N)
-    FixedPcdGet8 (PcdUartDefaultStopBits)     // StopBits
-  },
-  { END_DEVICE_PATH_TYPE, END_ENTIRE_DEVICE_PATH_SUBTYPE, { sizeof (EFI_DEVICE_PATH_PROTOCOL), 0 } }
-};
-
-EFI_HANDLE  gHandle = NULL;
-
-/**
-  Reset the serial device.
-
-  @param  This              Protocol instance pointer.
-
-  @retval EFI_SUCCESS       The device was reset.
-  @retval EFI_DEVICE_ERROR  The serial device could not be reset.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialReset (
-  IN EFI_SERIAL_IO_PROTOCOL  *This
-  )
-{
-  EFI_STATUS  Status;
-  EFI_TPL     Tpl;
-
-  Status = SerialPortInitialize ();
-  if (EFI_ERROR(Status)) {
-    return Status;
-  }
-
-  //
-  // Set the Serial I/O mode and update the device path
-  //
-
-  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
-
-  //
-  // Set the Serial I/O mode
-  //
-  This->Mode->ReceiveFifoDepth  = 0;
-  This->Mode->Timeout           = 1000000;
-  This->Mode->BaudRate          = PcdGet64 (PcdUartDefaultBaudRate);
-  This->Mode->DataBits          = (UINT32)PcdGet8 (PcdUartDefaultDataBits);
-  This->Mode->Parity            = (UINT32)PcdGet8 (PcdUartDefaultParity);
-  This->Mode->StopBits          = (UINT32)PcdGet8 (PcdUartDefaultStopBits);
-
-  //
-  // Check if the device path has actually changed
-  //
-  if (mDevicePath.Uart.BaudRate == This->Mode->BaudRate &&
-      mDevicePath.Uart.DataBits == (UINT8)This->Mode->DataBits &&
-      mDevicePath.Uart.Parity   == (UINT8)This->Mode->Parity &&
-      mDevicePath.Uart.StopBits == (UINT8)This->Mode->StopBits
-     ) {
-    gBS->RestoreTPL (Tpl);
-    return EFI_SUCCESS;
-  }
-
-  //
-  // Update the device path
-  //
-  mDevicePath.Uart.BaudRate = This->Mode->BaudRate;
-  mDevicePath.Uart.DataBits = (UINT8)This->Mode->DataBits;
-  mDevicePath.Uart.Parity   = (UINT8)This->Mode->Parity;
-  mDevicePath.Uart.StopBits = (UINT8)This->Mode->StopBits;
-
-  Status = gBS->ReinstallProtocolInterface (
-                  gHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  &mDevicePath,
-                  &mDevicePath
-                  );
-
-  gBS->RestoreTPL (Tpl);
-
-  return Status;
-}
-
-
-/**
-  Sets the baud rate, receive FIFO depth, transmit/receive time out, parity,
-  data buts, and stop bits on a serial device.
-
-  @param  This             Protocol instance pointer.
-  @param  BaudRate         The requested baud rate. A BaudRate value of 0 will use the the
-                           device's default interface speed.
-  @param  ReceiveFifoDepth The requested depth of the FIFO on the receive side of the
-                           serial interface. A ReceiveFifoDepth value of 0 will use
-                           the device's default FIFO depth.
-  @param  Timeout          The requested time out for a single character in microseconds.
-                           This timeout applies to both the transmit and receive side of the
-                           interface. A Timeout value of 0 will use the device's default time
-                           out value.
-  @param  Parity           The type of parity to use on this serial device. A Parity value of
-                           DefaultParity will use the device's default parity value.
-  @param  DataBits         The number of data bits to use on the serial device. A DataBits
-                           value of 0 will use the device's default data bit setting.
-  @param  StopBits         The number of stop bits to use on this serial device. A StopBits
-                           value of DefaultStopBits will use the device's default number of
-                           stop bits.
-
-  @retval EFI_SUCCESS      The device was reset.
-  @retval EFI_DEVICE_ERROR The serial device could not be reset.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialSetAttributes (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN UINT64                  BaudRate,
-  IN UINT32                  ReceiveFifoDepth,
-  IN UINT32                  Timeout,
-  IN EFI_PARITY_TYPE         Parity,
-  IN UINT8                   DataBits,
-  IN EFI_STOP_BITS_TYPE      StopBits
-  )
-{
-  RETURN_STATUS  ReturnStatus;
-  EFI_STATUS     Status;
-  EFI_TPL        Tpl;
-
-  ReturnStatus = SerialPortSetAttributes (&BaudRate, &ReceiveFifoDepth, &Timeout, &Parity, &DataBits, &StopBits);
-  if (RETURN_ERROR (ReturnStatus)) {
-    return EFI_DEVICE_ERROR;
-  }
-
-  //
-  // Set the Serial I/O mode and update the device path
-  //
-
-  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
-
-  //
-  // Set the Serial I/O mode
-  //
-  This->Mode->BaudRate          = BaudRate;
-  This->Mode->ReceiveFifoDepth  = ReceiveFifoDepth;
-  This->Mode->Timeout           = Timeout;
-  This->Mode->Parity            = (UINT32)Parity;
-  This->Mode->DataBits          = (UINT32)DataBits;
-  This->Mode->StopBits          = (UINT32)StopBits;
-
-  //
-  // Check if the device path has actually changed
-  //
-  if (mDevicePath.Uart.BaudRate == BaudRate &&
-      mDevicePath.Uart.Parity   == (UINT8)Parity &&
-      mDevicePath.Uart.DataBits == DataBits &&
-      mDevicePath.Uart.StopBits == (UINT8)StopBits
-     ) {
-    gBS->RestoreTPL (Tpl);
-    return EFI_SUCCESS;
-  }
-
-  //
-  // Update the device path
-  //
-  mDevicePath.Uart.BaudRate = BaudRate;
-  mDevicePath.Uart.DataBits = DataBits;
-  mDevicePath.Uart.Parity   = (UINT8) Parity;
-  mDevicePath.Uart.StopBits = (UINT8) StopBits;
-
-  Status = gBS->ReinstallProtocolInterface (
-                  gHandle,
-                  &gEfiDevicePathProtocolGuid,
-                  &mDevicePath,
-                  &mDevicePath
-                  );
-
-  gBS->RestoreTPL (Tpl);
-
-  return Status;
-}
-
-
-/**
-  Set the control bits on a serial device
-
-  @param  This             Protocol instance pointer.
-  @param  Control          Set the bits of Control that are settable.
-
-  @retval EFI_SUCCESS      The new control bits were set on the serial device.
-  @retval EFI_UNSUPPORTED  The serial device does not support this operation.
-  @retval EFI_DEVICE_ERROR The serial device is not functioning correctly.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialSetControl (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN UINT32                  Control
-  )
-{
-  return SerialPortSetControl(Control);
-}
-
-
-/**
-  Retrieves the status of the control bits on a serial device
-
-  @param  This              Protocol instance pointer.
-  @param  Control           A pointer to return the current Control signals from the serial device.
-
-  @retval EFI_SUCCESS       The control bits were read from the serial device.
-  @retval EFI_DEVICE_ERROR  The serial device is not functioning correctly.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialGetControl (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  OUT UINT32                 *Control
-  )
-{
-  return SerialPortGetControl(Control);
-}
-
-
-/**
-  Writes data to a serial device.
-
-  @param  This              Protocol instance pointer.
-  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
-                            data actually written.
-  @param  Buffer            The buffer of 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.
-
-**/
-EFI_STATUS
-EFIAPI
-SerialWrite (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN OUT UINTN               *BufferSize,
-  IN VOID                    *Buffer
-  )
-{
-  UINTN Count;
-
-  Count = SerialPortWrite (Buffer, *BufferSize);
-
-  if (Count != *BufferSize) {
-    *BufferSize = Count;
-    return EFI_TIMEOUT;
-  }
-
-  return EFI_SUCCESS;
-}
-
-/**
-  Reads data from a serial device.
-
-  @param  This              Protocol instance pointer.
-  @param  BufferSize        On input, the size of the Buffer. On output, the amount of
-                            data returned in Buffer.
-  @param  Buffer            The buffer to return the data into.
-
-  @retval EFI_SUCCESS       The data was read.
-  @retval EFI_DEVICE_ERROR  The device reported an error.
-  @retval EFI_TIMEOUT       The data write was stopped due to a timeout.
-
-**/
-
-EFI_STATUS
-EFIAPI
-SerialRead (
-  IN EFI_SERIAL_IO_PROTOCOL  *This,
-  IN OUT UINTN               *BufferSize,
-  OUT VOID                   *Buffer
-  )
-{
-  UINTN Count = 0;
-
-  if (SerialPortPoll()) {
-    Count = SerialPortRead (Buffer, *BufferSize);
-  }
-
-  if (Count != *BufferSize) {
-    *BufferSize = Count;
-    return EFI_TIMEOUT;
-  }
-
-  return EFI_SUCCESS;
-}
-
-//
-// Template used to initialize the GDB Serial IO protocols
-//
-EFI_SERIAL_IO_MODE gSerialIoMode = {
-  0,                                          // ControlMask
-  0,                                          // Timeout
-  FixedPcdGet64 (PcdUartDefaultBaudRate),     // BaudRate
-  1,                                          // ReceiveFifoDepth
-  FixedPcdGet8 (PcdUartDefaultDataBits),      // DataBits
-  FixedPcdGet8 (PcdUartDefaultParity),        // Parity
-  FixedPcdGet8 (PcdUartDefaultStopBits)       // StopBits
-};
-
-
-EFI_SERIAL_IO_PROTOCOL gSerialIoTemplate = {
-  SERIAL_IO_INTERFACE_REVISION,
-  SerialReset,
-  SerialSetAttributes,
-  SerialSetControl,
-  SerialGetControl,
-  SerialWrite,
-  SerialRead,
-  &gSerialIoMode
-};
-
-/**
-  Initialize the state information for the Serial Io Protocol
-
-  @param  ImageHandle   of the loaded driver
-  @param  SystemTable   Pointer to the System Table
-
-  @retval EFI_SUCCESS           Protocol registered
-  @retval EFI_OUT_OF_RESOURCES  Cannot allocate protocol data structure
-  @retval EFI_DEVICE_ERROR      Hardware problems
-
-**/
-EFI_STATUS
-EFIAPI
-SerialDxeInitialize (
-  IN EFI_HANDLE         ImageHandle,
-  IN EFI_SYSTEM_TABLE   *SystemTable
-  )
-{
-  EFI_STATUS      Status;
-
-  // Make a new handle with Serial IO protocol and its device path on it.
-  Status = gBS->InstallMultipleProtocolInterfaces (
-                  &gHandle,
-                  &gEfiSerialIoProtocolGuid,   &gSerialIoTemplate,
-                  &gEfiDevicePathProtocolGuid, &mDevicePath,
-                  NULL
-                  );
-  ASSERT_EFI_ERROR (Status);
-
-  return Status;
-}
-

From d76a00635f5061a96b6d17c1b68de9d2732fce55 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Mon, 30 Nov 2015 03:22:27 +0000
Subject: [PATCH 182/525] NetworkPkg:Fix NULL pointer dereference issues.

Revise some errors that some Null pointers may be dereferenced.

(Sync patch r18961 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19025 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c  | 18 ++++++++++--
 NetworkPkg/HttpDxe/HttpImpl.h  |  1 +
 NetworkPkg/HttpDxe/HttpProto.c | 52 +++++++++++++++-------------------
 3 files changed, 40 insertions(+), 31 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index ce28f07efa1f..f26d6f4f3faa 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -39,6 +39,7 @@ EFI_HTTP_PROTOCOL  mEfiHttpTemplate = {
                                   This is NULL.
                                   HttpConfigData is NULL.
                                   HttpConfigData->AccessPoint is NULL.
+  @retval EFI_OUT_OF_RESOURCES    Could not allocate enough system resources.
   @retval EFI_NOT_STARTED         The HTTP instance is not configured.
 
 **/
@@ -70,6 +71,9 @@ EfiHttpGetModeData (
 
   if (HttpInstance->LocalAddressIsIPv6) {
     Http6AccessPoint = AllocateZeroPool (sizeof (EFI_HTTPv6_ACCESS_POINT));
+    if (Http6AccessPoint == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
     CopyMem (
       Http6AccessPoint,
       &HttpInstance->Ipv6Node,
@@ -78,6 +82,9 @@ EfiHttpGetModeData (
     HttpConfigData->AccessPoint.IPv6Node = Http6AccessPoint;
   } else {
     Http4AccessPoint = AllocateZeroPool (sizeof (EFI_HTTPv4_ACCESS_POINT));
+    if (Http4AccessPoint == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
     CopyMem (
       Http4AccessPoint,
       &HttpInstance->IPv4Node,
@@ -886,6 +893,8 @@ HttpResponseWorker (
       goto Error;
     }
 
+    ASSERT (HttpHeaders != NULL);
+
     //
     // Cache the part of body.
     //
@@ -1288,14 +1297,19 @@ EfiHttpPoll (
   HttpInstance = HTTP_INSTANCE_FROM_PROTOCOL (This);
   ASSERT (HttpInstance != NULL);
 
-  if (HttpInstance->State != HTTP_STATE_TCP_CONNECTED || (HttpInstance->Tcp4 == NULL && 
-                                                          HttpInstance->Tcp6 == NULL)) {
+  if (HttpInstance->State != HTTP_STATE_TCP_CONNECTED) {
     return EFI_NOT_STARTED;
   }
   
   if (HttpInstance->LocalAddressIsIPv6) {
+    if (HttpInstance->Tcp6 == NULL) {
+      return EFI_NOT_STARTED;
+    }
     Status = HttpInstance->Tcp6->Poll (HttpInstance->Tcp6);
   } else {
+    if (HttpInstance->Tcp4 == NULL) {
+      return EFI_NOT_STARTED;
+    }
     Status = HttpInstance->Tcp4->Poll (HttpInstance->Tcp4);
   }
   
diff --git a/NetworkPkg/HttpDxe/HttpImpl.h b/NetworkPkg/HttpDxe/HttpImpl.h
index 49c8af1b2100..afbe9822835f 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.h
+++ b/NetworkPkg/HttpDxe/HttpImpl.h
@@ -44,6 +44,7 @@
                                   This is NULL.
                                   HttpConfigData is NULL.
                                   HttpConfigData->AccessPoint is NULL.
+  @retval EFI_OUT_OF_RESOURCES    Could not allocate enough system resources.
   @retval EFI_NOT_STARTED         The HTTP instance is not configured.
 
 **/
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 22aed253cb36..d4ab74f0094d 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -565,15 +565,14 @@ HttpCloseTcpRxEvent (
   EFI_TCP4_IO_TOKEN        *Rx4Token;
   EFI_TCP6_IO_TOKEN        *Rx6Token;
 
+  ASSERT (Wrap != NULL);
   HttpInstance   = Wrap->HttpInstance;
   Rx4Token       = NULL;
   Rx6Token       = NULL;
   
   if (HttpInstance->LocalAddressIsIPv6) {
-    if (Wrap != NULL) {
-      if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
-        gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
-      } 
+    if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
     }
 
     if (HttpInstance->Rx6Token.CompletionToken.Event != NULL) {
@@ -581,10 +580,8 @@ HttpCloseTcpRxEvent (
       HttpInstance->Rx6Token.CompletionToken.Event = NULL;
     }
   } else {
-    if (Wrap != NULL) {
-      if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
-        gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
-      }
+    if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
     }
     
     if (HttpInstance->Rx4Token.CompletionToken.Event != NULL) {
@@ -1893,23 +1890,22 @@ HttpTcpTokenCleanup (
   EFI_TCP4_IO_TOKEN        *Rx4Token;
   EFI_TCP6_IO_TOKEN        *Rx6Token;
 
+  ASSERT (Wrap != NULL);
   HttpInstance   = Wrap->HttpInstance;
   Rx4Token       = NULL;
   Rx6Token       = NULL;
   
   if (HttpInstance->LocalAddressIsIPv6) {
-    if (Wrap != NULL) {
-      if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
-        gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
-      }
+    if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
+    }
 
-      Rx6Token = &Wrap->TcpWrap.Rx6Token;
-      if (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
-        FreePool (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
-        Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
-      }
-      FreePool (Wrap); 
+    Rx6Token = &Wrap->TcpWrap.Rx6Token;
+    if (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+      Rx6Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
     }
+    FreePool (Wrap);
 
     if (HttpInstance->Rx6Token.CompletionToken.Event != NULL) {
       gBS->CloseEvent (HttpInstance->Rx6Token.CompletionToken.Event);
@@ -1923,18 +1919,16 @@ HttpTcpTokenCleanup (
     }
     
   } else {
-    if (Wrap != NULL) {
-      if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
-        gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
-      }
-      Rx4Token = &Wrap->TcpWrap.Rx4Token;
-      if (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
-        FreePool (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
-        Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
-      }
-      FreePool (Wrap);
+    if (Wrap->TcpWrap.Rx4Token.CompletionToken.Event != NULL) {
+      gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
     }
-    
+    Rx4Token = &Wrap->TcpWrap.Rx4Token;
+    if (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer != NULL) {
+      FreePool (Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer);
+      Rx4Token->Packet.RxData->FragmentTable[0].FragmentBuffer = NULL;
+    }
+    FreePool (Wrap);
+
     if (HttpInstance->Rx4Token.CompletionToken.Event != NULL) {
       gBS->CloseEvent (HttpInstance->Rx4Token.CompletionToken.Event);
       HttpInstance->Rx4Token.CompletionToken.Event = NULL;

From 988a36669834068d2ba69df9a1598d740513662e Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Tue, 1 Dec 2015 01:56:57 +0000
Subject: [PATCH 183/525] MdeModulePkg/BDS: Do not pass unnecessary option to
 boot option

BDS puts a special GUID in boot option optional data for
auto-discovered boot option. But when launching that boot
option, the BDS core unconditionally pass the special GUID
to the executable.

A good written application/OS loader can ignore the unexpected
parameters, but BDS core should still avoid passing the
unnecessary GUID.

(Sync patch r19007 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19072 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiBootManagerLib/BmBoot.c       | 32 ++++++++++++++++---
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c b/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
index 4afd9c25ff2e..59366885c4b9 100644
--- a/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
+++ b/MdeModulePkg/Library/UefiBootManagerLib/BmBoot.c
@@ -52,6 +52,28 @@ EfiBootManagerRegisterLegacyBootSupport (
   mBmLegacyBoot              = LegacyBoot;
 }
 
+/**
+  Return TRUE when the boot option is auto-created instead of manually added.
+
+  @param BootOption Pointer to the boot option to check.
+
+  @retval TRUE  The boot option is auto-created.
+  @retval FALSE The boot option is manually added.
+**/
+BOOLEAN
+BmIsAutoCreateBootOption (
+  EFI_BOOT_MANAGER_LOAD_OPTION    *BootOption
+  )
+{
+  if ((BootOption->OptionalDataSize == sizeof (EFI_GUID)) &&
+      CompareGuid ((EFI_GUID *) BootOption->OptionalData, &mBmAutoCreateBootOptionGuid)
+      ) {
+    return TRUE;
+  } else {
+    return FALSE;
+  }
+}
+
 /**
   For a bootable Device path, return its boot type.
 
@@ -1738,8 +1760,10 @@ EfiBootManagerBoot (
   Status = gBS->HandleProtocol (ImageHandle, &gEfiLoadedImageProtocolGuid, (VOID **) &ImageInfo);
   ASSERT_EFI_ERROR (Status);
 
-  ImageInfo->LoadOptionsSize  = BootOption->OptionalDataSize;
-  ImageInfo->LoadOptions      = BootOption->OptionalData;
+  if (!BmIsAutoCreateBootOption (BootOption)) {
+    ImageInfo->LoadOptionsSize = BootOption->OptionalDataSize;
+    ImageInfo->LoadOptions     = BootOption->OptionalData;
+  }
 
   //
   // Clean to NULL because the image is loaded directly from the firmwares boot manager.
@@ -2155,9 +2179,7 @@ EfiBootManagerRefreshAllBootOption (
   for (Index = 0; Index < NvBootOptionCount; Index++) {
     if (((DevicePathType (NvBootOptions[Index].FilePath) != BBS_DEVICE_PATH) || 
          (DevicePathSubType (NvBootOptions[Index].FilePath) != BBS_BBS_DP)
-        ) &&
-        (NvBootOptions[Index].OptionalDataSize == sizeof (EFI_GUID)) &&
-        CompareGuid ((EFI_GUID *) NvBootOptions[Index].OptionalData, &mBmAutoCreateBootOptionGuid)
+        ) && BmIsAutoCreateBootOption (&NvBootOptions[Index])
        ) {
       //
       // Only check those added by BDS

From e55444859f00eca2676aef4f3290571d386dd6be Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 1 Dec 2015 02:30:17 +0000
Subject: [PATCH 184/525] BaseTools: Fix two warning reported in the make
 phase.

when we make BaseTools, it report warnings about VfrError.cpp and VolInfo,
so this patch fix this warning.

(Sync patch r18851 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19073 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/C/VfrCompile/VfrError.cpp |  2 +-
 BaseTools/Source/C/VolInfo/VolInfo.c       | 19 +++++++++++++++++--
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/C/VfrCompile/VfrError.cpp b/BaseTools/Source/C/VfrCompile/VfrError.cpp
index 3be2bd84db14..3c506ec20476 100644
--- a/BaseTools/Source/C/VfrCompile/VfrError.cpp
+++ b/BaseTools/Source/C/VfrCompile/VfrError.cpp
@@ -280,7 +280,7 @@ CVfrErrorHandle::HandleWarning (
   GetFileNameLineNum (LineNum, &FileName, &FileLine);
 
   if (mWarningAsError) {
-    Error (FileName, FileLine, 0x2220, "warning treated as error", NULL);
+    Error (FileName, FileLine, 0x2220, (CHAR8 *) "warning treated as error", NULL);
   }
 
   for (Index = 0; mVfrWarningHandleTable[Index].mWarningCode != VFR_WARNING_CODEUNDEFINED; Index++) {
diff --git a/BaseTools/Source/C/VolInfo/VolInfo.c b/BaseTools/Source/C/VolInfo/VolInfo.c
index 7e79d753676b..87e78d48a872 100644
--- a/BaseTools/Source/C/VolInfo/VolInfo.c
+++ b/BaseTools/Source/C/VolInfo/VolInfo.c
@@ -1,7 +1,7 @@
 /** @file
 The tool dumps the contents of a firmware volume
 
-Copyright (c) 1999 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -17,6 +17,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <string.h>
 #include <ctype.h>
 #include <assert.h>
+#ifdef __GNUC__
+#include <unistd.h>
+#endif
 
 #include <FvLib.h>
 #include <Common/UefiBaseTypes.h>
@@ -1422,9 +1425,21 @@ Routine Description:
           );
 
       if (ExtractionTool != NULL) {
-
+       #ifndef __GNUC__
         ToolInputFile = CloneString (tmpnam (NULL));
         ToolOutputFile = CloneString (tmpnam (NULL));
+       #else
+        char tmp1[] = "/tmp/fileXXXXXX";
+        char tmp2[] = "/tmp/fileXXXXXX";
+        int fd1;
+        int fd2;
+        fd1 = mkstemp(tmp1);
+        fd2 = mkstemp(tmp2);
+        ToolInputFile = CloneString(tmp1);
+        ToolOutputFile = CloneString(tmp2);
+        close(fd1);
+        close(fd2);
+       #endif
 
         //
         // Construction 'system' command string

From 61b90507206f4368cb102b3014cd46f7d31b2b89 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 1 Dec 2015 02:30:36 +0000
Subject: [PATCH 185/525] BaseTools/toolsetup.bat: fixed the error when the
 path contains space

when the path contains space, it will report error for PATH Environment
update.

(Sync patch r18852 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19074 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/toolsetup.bat | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/BaseTools/toolsetup.bat b/BaseTools/toolsetup.bat
index 59874c58392f..310ddd030c07 100755
--- a/BaseTools/toolsetup.bat
+++ b/BaseTools/toolsetup.bat
@@ -322,13 +322,24 @@ goto end
       echo !!! WARNING !!! Will not be able to compile Python programs to .exe
       echo Will setup environment to run Python scripts directly.
       echo.
-      set PATH=%BASETOOLS_PYTHON_SOURCE%\Trim;%PATH%
-      set PATH=%BASETOOLS_PYTHON_SOURCE%\GenFds;%PATH%
-      set PATH=%BASETOOLS_PYTHON_SOURCE%\build;%PATH%
-      set PATHEXT=%PATHEXT%;.py
+      goto UpdatePATH
     )
+    else (
+      goto UpdateEnv
+    )
+  )
+  else (
+    goto UpdateEnv
   )
-  
+ 
+:UpdatePATH
+  set PATH=%BASETOOLS_PYTHON_SOURCE%\Trim;%PATH%
+  set PATH=%BASETOOLS_PYTHON_SOURCE%\GenFds;%PATH%
+  set PATH=%BASETOOLS_PYTHON_SOURCE%\build;%PATH%
+  set PATHEXT=%PATHEXT%;.py
+  goto UpdateEnv
+ 
+:UpdateEnv
   echo BASE_TOOLS_PATH     = %BASE_TOOLS_PATH%
   echo     PYTHON_PATH     = %PYTHON_PATH%
   echo PYTHON_FREEZER_PATH = %PYTHON_FREEZER_PATH%

From 61b0bea7d9bbcf22c33cdc729842f9dfd513b56b Mon Sep 17 00:00:00 2001
From: Hess Chen <hesheng.chen@intel.com>
Date: Tue, 1 Dec 2015 02:31:16 +0000
Subject: [PATCH 186/525] BaseTool/UPT: Add supporting of decimal numbers for
 INF_VERSION and DEC_SPECIFICATION

(Sync patch r18868 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hess Chen <hesheng.chen@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19075 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Source/Python/UPT/Logger/StringTable.py     |  2 +-
 .../Python/UPT/Object/Parser/InfDefineObject.py | 17 +++++++++++------
 BaseTools/Source/Python/UPT/Parser/DecParser.py |  4 +++-
 3 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/BaseTools/Source/Python/UPT/Logger/StringTable.py b/BaseTools/Source/Python/UPT/Logger/StringTable.py
index f15ac7f0bc6b..a481c6785d61 100644
--- a/BaseTools/Source/Python/UPT/Logger/StringTable.py
+++ b/BaseTools/Source/Python/UPT/Logger/StringTable.py
@@ -656,7 +656,7 @@
 ERR_DECPARSE_DEFINE_UNKNOWKEY       = \
 _("Unknown key [%s] in define section.")
 ERR_DECPARSE_DEFINE_SPEC            = \
-_("Specification value must be HEX numbers.")
+_("Specification value must be HEX numbers or decimal numbers.")
 ERR_DECPARSE_DEFINE_PKGNAME         = \
 _("Package name must be AlphaNumeric characters.")
 ERR_DECPARSE_DEFINE_PKGGUID         = \
diff --git a/BaseTools/Source/Python/UPT/Object/Parser/InfDefineObject.py b/BaseTools/Source/Python/UPT/Object/Parser/InfDefineObject.py
index be9a0e196e39..1d074ee638fd 100644
--- a/BaseTools/Source/Python/UPT/Object/Parser/InfDefineObject.py
+++ b/BaseTools/Source/Python/UPT/Object/Parser/InfDefineObject.py
@@ -340,16 +340,21 @@ def SetInfVersion(self, InfVersion, Comments):
                 ErrorInInf(ST.ERR_INF_PARSER_NOT_SUPPORT_EDKI_INF,
                            ErrorCode=ToolError.EDK1_INF_ERROR,
                            LineInfo=self.CurrentLine)
-                
-            self.InfVersion = InfDefMember()
-            self.InfVersion.SetValue(InfVersion)
-            self.InfVersion.Comments = Comments          
-            return True
+        elif IsValidDecVersionVal(InfVersion):
+            if (InfVersion < 65541):
+                ErrorInInf(ST.ERR_INF_PARSER_NOT_SUPPORT_EDKI_INF,
+                           ErrorCode=ToolError.EDK1_INF_ERROR,
+                           LineInfo=self.CurrentLine)
         else:
             ErrorInInf(ST.ERR_INF_PARSER_DEFINE_FROMAT_INVALID%(InfVersion),
                        LineInfo=self.CurrentLine)
             return False
 
+        self.InfVersion = InfDefMember()
+        self.InfVersion.SetValue(InfVersion)
+        self.InfVersion.Comments = Comments
+        return True
+
     ## GetInfVersion
     #                     
     def GetInfVersion(self):
@@ -1000,4 +1005,4 @@ def SetDefines(self, DefineContent, Arch = None):
     
     def GetDefines(self):
         return self.Defines                      
-        
\ No newline at end of file
+        
diff --git a/BaseTools/Source/Python/UPT/Parser/DecParser.py b/BaseTools/Source/Python/UPT/Parser/DecParser.py
index 25407f9a2d50..23d1ed4dbb23 100644
--- a/BaseTools/Source/Python/UPT/Parser/DecParser.py
+++ b/BaseTools/Source/Python/UPT/Parser/DecParser.py
@@ -29,6 +29,7 @@
 from Library.ParserValidate import IsValidUserId
 from Library.ParserValidate import IsValidArch
 from Library.ParserValidate import IsValidWord
+from Library.ParserValidate import IsValidDecVersionVal
 from Parser.DecParserMisc import TOOL_NAME
 from Parser.DecParserMisc import CleanString
 from Parser.DecParserMisc import IsValidPcdDatum
@@ -452,7 +453,8 @@ def _SetDecSpecification(self, Token):
         if self.ItemObject.GetPackageSpecification():
             self._LoggerError(ST.ERR_DECPARSE_DEFINE_DEFINED % DT.TAB_DEC_DEFINES_DEC_SPECIFICATION)
         if not IsValidToken('0[xX][0-9a-fA-F]{8}', Token):
-            self._LoggerError(ST.ERR_DECPARSE_DEFINE_SPEC)
+            if not IsValidDecVersionVal(Token):
+                self._LoggerError(ST.ERR_DECPARSE_DEFINE_SPEC)
         self.ItemObject.SetPackageSpecification(Token)
     
     def _SetPackageName(self, Token):

From b6274a7a7890953c9906b12755fcee78330a02f2 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Tue, 1 Dec 2015 02:31:39 +0000
Subject: [PATCH 187/525] BaseTools/GenFw ARM: allow R_ARM_REL32 relocations

R_ARM_REL32 are relative relocations, so we don't need to do anything
special when performing the ELF to PE/COFF conversion, since our memory
layout is identical between the two binary formats. So just allow them.

(Sync patch r18931 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19076 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index a7b077873b40..469394540e6a 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -716,6 +716,7 @@ WriteSections32 (
             // break skipped
 
           case R_ARM_PC24:
+          case R_ARM_REL32:
           case R_ARM_XPC25:
           case R_ARM_THM_PC22:
           case R_ARM_THM_JUMP19:
@@ -844,6 +845,7 @@ WriteRelocations32 (
               // break skipped
 
             case R_ARM_PC24:
+            case R_ARM_REL32:
             case R_ARM_XPC25:
             case R_ARM_THM_PC22:
             case R_ARM_THM_JUMP19:

From e07c30da128c51eda38857f29689c5ec07ac6773 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 1 Dec 2015 02:32:08 +0000
Subject: [PATCH 188/525] BaseTools: Add a VPD report subsection of FLASH to
 the Report

Build Spec already added a VPD report subsection of FLASH to the Report
chapter, it provide a simple way for user to determine where the VPD
region and VPD PCDs are located in the fd file.

(Sync patch r19026 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19077 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/build/BuildReport.py | 35 ++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/BaseTools/Source/Python/build/BuildReport.py b/BaseTools/Source/Python/build/BuildReport.py
index 264607b00360..d64c55d08bc1 100644
--- a/BaseTools/Source/Python/build/BuildReport.py
+++ b/BaseTools/Source/Python/build/BuildReport.py
@@ -1385,6 +1385,32 @@ def __init__(self, Fd, Wa):
         self.BaseAddress = Fd.BaseAddress
         self.Size = Fd.Size
         self.FdRegionList = [FdRegionReport(FdRegion, Wa) for FdRegion in Fd.RegionList]
+        self.FvPath = os.path.join(Wa.BuildDir, "FV")
+        self.VpdFilePath = os.path.join(self.FvPath, "%s.map" % Wa.Platform.VpdToolGuid)
+        VpdPcdToken = 'gEfiMdeModulePkgTokenSpaceGuid'
+        VpdPcdName = 'PcdVpdBaseAddress'
+        self.VPDInfoList = []
+        for index, FdRegion in enumerate(Fd.RegionList):
+            if (VpdPcdName, VpdPcdToken) == FdRegion.PcdOffset:
+                self.VPDBaseAddress = self.FdRegionList[index].BaseAddress
+                self.VPDSize = self.FdRegionList[index].Size
+                break
+
+        if os.path.isfile(self.VpdFilePath):
+            fd = open(self.VpdFilePath, "r")
+            Lines = fd.readlines()
+            for Line in Lines:
+                Line = Line.strip()
+                if len(Line) == 0 or Line.startswith("#"):
+                    continue
+                try:
+                    PcdName, SkuId, Offset, Size, Value = Line.split("#")[0].split("|")
+                    PcdName, SkuId, Offset, Size, Value = PcdName.strip(), SkuId.strip(), Offset.strip(), Size.strip(), Value.strip()
+                    Offset = '0x%08X' % (int(Offset, 16) + self.VPDBaseAddress)
+                    self.VPDInfoList.append("%s | %s | %s | %s | %s" % (PcdName, SkuId, Offset, Size, Value))
+                except:
+                    EdkLogger.error("BuildReport", CODE_ERROR, "Fail to parse VPD information file %s" % self.VpdFilePath)
+            fd.close()
 
     ##
     # Generate report for the firmware device.
@@ -1405,6 +1431,15 @@ def GenerateReport(self, File):
             for FdRegionItem in self.FdRegionList:
                 FdRegionItem.GenerateReport(File)
 
+        if len(self.VPDInfoList) > 0:
+            FileWrite(File, gSubSectionStart)
+            FileWrite(File, "FD VPD Region")
+            FileWrite(File, "Base Address:       0x%X" % self.VPDBaseAddress)
+            FileWrite(File, "Size:               0x%X (%.0fK)" % (self.VPDSize, self.VPDSize / 1024.0))
+            FileWrite(File, gSubSectionSep)
+            for item in self.VPDInfoList:
+                FileWrite(File, item)
+            FileWrite(File, gSubSectionEnd)
         FileWrite(File, gSectionEnd)
 
 

From f80a15c236a8c433c6dd78f9796794d9f3b36e5c Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 1 Dec 2015 02:32:33 +0000
Subject: [PATCH 189/525] BaseTools: Add build error detection for Dynamic PCD
 name conflict

when multiple Dynamic PCD have different token space guid but same PCD
name, it is difficult for user to check why the generated autogen.c and
autogen.h are not consistent. so we add a check before generating
autogen.c and report error directly that user can know what happened
immediately.

(Sync patch r19027 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19078 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/AutoGen/GenC.py | 52 +++++++++++++++++--------
 1 file changed, 36 insertions(+), 16 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/GenC.py b/BaseTools/Source/Python/AutoGen/GenC.py
index 45fb9899f2c2..93be71885097 100644
--- a/BaseTools/Source/Python/AutoGen/GenC.py
+++ b/BaseTools/Source/Python/AutoGen/GenC.py
@@ -833,7 +833,7 @@ def CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd):
             AutoGenH.Append('// Disabled the macros, as PcdToken and PcdGet/Set are not allowed in the case that more than one DynamicEx Pcds are different Guids but same CName.\n')
             AutoGenH.Append('// #define %s  %s\n' % (PcdTokenName, PcdExTokenName))
             AutoGenH.Append('// #define %s  LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
-            AutoGenH.Append('#define %s LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))
+            AutoGenH.Append('// #define %s  LibPcdGetExSize(&%s, %s)\n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))
             if Pcd.DatumType == 'VOID*':
                 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer)  LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
                 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer)  LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
@@ -851,14 +851,24 @@ def CreateModulePcdCode(Info, AutoGenC, AutoGenH, Pcd):
                 AutoGenH.Append('#define %s(Value)  LibPcdSetEx%s(&%s, %s, (Value))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
                 AutoGenH.Append('#define %s(Value)  LibPcdSetEx%sS(&%s, %s, (Value))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
     elif Pcd.Type in gDynamicPcd:
-        AutoGenH.Append('#define %s  LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))
-        AutoGenH.Append('#define %s  LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))
-        if Pcd.DatumType == 'VOID*':
-            AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))
-            AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+        PcdList = []
+        PcdCNameList = []
+        PcdList.extend(Info.LibraryPcdList)
+        PcdList.extend(Info.ModulePcdList)
+        for PcdModule in PcdList:
+            if PcdModule.Type in gDynamicPcd:
+                PcdCNameList.append(PcdModule.TokenCName)
+        if PcdCNameList.count(Pcd.TokenCName) > 1:
+            EdkLogger.error("build", AUTOGEN_ERROR, "More than one Dynamic Pcds [%s] are different Guids but same CName. They need to be changed to DynamicEx type to avoid the confliction.\n" % (Pcd.TokenCName), ExtraData="[%s]" % str(Info.MetaFile.Path))
         else:
-            AutoGenH.Append('#define %s(Value)  LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))
-            AutoGenH.Append('#define %s(Value)  LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+            AutoGenH.Append('#define %s  LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))
+            AutoGenH.Append('#define %s  LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))
+            if Pcd.DatumType == 'VOID*':
+                AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))
+                AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+            else:
+                AutoGenH.Append('#define %s(Value)  LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))
+                AutoGenH.Append('#define %s(Value)  LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
     else:
         PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[Pcd.Type] + '_' + Pcd.TokenCName
         Const = 'const'
@@ -1111,7 +1121,7 @@ def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):
             AutoGenH.Append('// Disabled the macros, as PcdToken and PcdGet/Set are not allowed in the case that more than one DynamicEx Pcds are different Guids but same CName.\n')
             AutoGenH.Append('// #define %s  %s\n' % (PcdTokenName, PcdExTokenName))
             AutoGenH.Append('// #define %s  LibPcdGetEx%s(&%s, %s)\n' % (GetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
-            AutoGenH.Append('// #define %s LibPcdGetExSize(&%s, %s \n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))
+            AutoGenH.Append('// #define %s  LibPcdGetExSize(&%s, %s \n' % (GetModeSizeName,Pcd.TokenSpaceGuidCName, PcdTokenName))
             if Pcd.DatumType == 'VOID*':
                 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer)  LibPcdSetEx%s(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
                 AutoGenH.Append('// #define %s(SizeOfBuffer, Buffer)  LibPcdSetEx%sS(&%s, %s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, Pcd.TokenSpaceGuidCName, PcdTokenName))
@@ -1131,14 +1141,24 @@ def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):
     else:
         AutoGenH.Append('#define _PCD_TOKEN_%s  %dU\n' % (TokenCName, TokenNumber))
     if PcdItemType in gDynamicPcd:
-        AutoGenH.Append('#define %s  LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))
-        AutoGenH.Append('#define %s  LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))
-        if DatumType == 'VOID*':
-            AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))
-            AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+        PcdList = []
+        PcdCNameList = []
+        PcdList.extend(Info.LibraryPcdList)
+        PcdList.extend(Info.ModulePcdList)
+        for PcdModule in PcdList:
+            if PcdModule.Type in gDynamicPcd:
+                PcdCNameList.append(PcdModule.TokenCName)
+        if PcdCNameList.count(Pcd.TokenCName) > 1:
+            EdkLogger.error("build", AUTOGEN_ERROR, "More than one Dynamic Pcds [%s] are different Guids but same CName.They need to be changed to DynamicEx type to avoid the confliction.\n" % (Pcd.TokenCName), ExtraData="[%s]" % str(Info.MetaFile.Path))
         else:
-            AutoGenH.Append('#define %s(Value)  LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))
-            AutoGenH.Append('#define %s(Value)  LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+            AutoGenH.Append('#define %s  LibPcdGet%s(%s)\n' % (GetModeName, DatumSizeLib, PcdTokenName))
+            AutoGenH.Append('#define %s  LibPcdGetSize(%s)\n' % (GetModeSizeName, PcdTokenName))
+            if DatumType == 'VOID*':
+                AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%s(%s, (SizeOfBuffer), (Buffer))\n' %(SetModeName, DatumSizeLib, PcdTokenName))
+                AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPcdSet%sS(%s, (SizeOfBuffer), (Buffer))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
+            else:
+                AutoGenH.Append('#define %s(Value)  LibPcdSet%s(%s, (Value))\n' % (SetModeName, DatumSizeLib, PcdTokenName))
+                AutoGenH.Append('#define %s(Value)  LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
     if PcdItemType == TAB_PCDS_PATCHABLE_IN_MODULE:
         PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[TAB_PCDS_PATCHABLE_IN_MODULE] + '_' + TokenCName
         AutoGenH.Append('extern volatile %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType, TokenCName, Array) )

From 955b2d2e7b446488bb9333910e440c0b0f09f78e Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Tue, 1 Dec 2015 02:36:56 +0000
Subject: [PATCH 190/525] External link to BaseTools Win binary r107(main trunk
 r19027)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>





git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19079 6f19259b-4bc3-4df7-8a09-765794883524

From 76c092589ed74931ece00e3505979d80042f7b50 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Tue, 1 Dec 2015 06:13:41 +0000
Subject: [PATCH 191/525] Sync the files in root dirctory from main trunk
 r19027.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19081 6f19259b-4bc3-4df7-8a09-765794883524
---
 Edk2Setup.bat   | 64 ++++++++++++++++++++++++++++++++++++-------------
 Maintainers.txt |  3 ++-
 edksetup.bat    | 30 +++++++++++++++++++----
 edksetup.sh     | 19 ++++++++++++---
 4 files changed, 91 insertions(+), 25 deletions(-)

diff --git a/Edk2Setup.bat b/Edk2Setup.bat
index 0aa786d9ab94..2d132349bc32 100755
--- a/Edk2Setup.bat
+++ b/Edk2Setup.bat
@@ -62,14 +62,33 @@
 
 @if not defined ORIGINAL_PATH set "ORIGINAL_PATH=%PATH%"
 @REM Always set the WORKSPACE environment variable to the current directory
-@set "WORKSPACE=%CD%"
-@if exist "%WORKSPACE%\BaseTools" @set "BASE_TOOLS_PATH=%WORKSPACE%\BaseTools"
+@if not defined WORKSPACE (
+  @set "WORKSPACE=%CD%"
+)
+@if not exist "%BASE_TOOLS_PATH%" (
+  @if exist "%WORKSPACE%\BaseTools" (
+    set "BASE_TOOLS_PATH=%WORKSPACE%\BaseTools"
+  ) else (
+    @if defined PACKAGES_PATH (
+      @for %%i IN (%PACKAGES_PATH%) DO (
+        @if exist %%~fi\BaseTools (
+          @set BASE_TOOLS_PATH=%%~fi\BaseTools
+          @goto checkBaseTools
+        )
+      )
+    )
+  )
+)
+:checkBaseTools
+@if not defined BASE_TOOLS_PATH (
+  @echo.
+  @echo !!! ERROR !!! The BaseTools Package was not found !!!
+  @echo.
+  @goto ExitFailure
+)
 @if not exist "%WORKSPACE%\Conf" @mkdir "%WORKSPACE%\Conf"
 
-@@if not defined EDK_TOOLS_PATH @set "EDK_TOOLS_PATH=%WORKSPACE%\BaseTools"
-@rem   @set "PATH=%WORKSPACE%\BaseTools\Bin\Win32;%PATH%"
-@rem   @set WORKSPACE_TOOLS_PATH=%WORKSPACE%\BaseTools
-@rem )
+@@if not defined EDK_TOOLS_PATH @set "EDK_TOOLS_PATH=%BASE_TOOLS_PATH%"
 
 @REM Keep the existing EDK_TOOLS_PATH value, the --reset flag will set it
 @REM back to WORKSPACE\BaseTools while the --location DIRECTORY flag will
@@ -259,7 +278,7 @@
 @echo %SCRIPT_NAME% Version: %SCRIPT_VERSION%%SVN_REVISION:~11,-1%
 @echo Copyright(c) 2014, Intel Corporation. All rights reserved.
 @set HIDE_PATH=TRUE
-@call "%WORKSPACE%\BaseTools\Scripts\ShowEnvironment.bat"
+@call "%BASE_TOOLS_PATH%\Scripts\ShowEnvironment.bat"
 @set HIDE_PATH=
 @goto ExitSuccess
 
@@ -352,8 +371,8 @@
 @REM copied or replaced from the WORKSPACE\BaseTools\Conf directories' template files.
 :SetConf
 @if not exist "%EDK_TOOLS_PATH%\Conf" (
-    @if exist "%WORKSPACE%\BaseTools\Conf" (
-        @set "SRC_CONF=%WORKSPACE%\BaseTools\Conf"
+    @if exist "%BASE_TOOLS_PATH%\Conf" (
+        @set "SRC_CONF=%BASE_TOOLS_PATH%\Conf"
     )
 ) else (
     @set "SRC_CONF=%EDK_TOOLS_PATH%\Conf"
@@ -365,7 +384,7 @@
 
 @REM The script will test to see if the files exist, and also use the RESET_ENVIRONMENT flag
 @REM to overwrite the WORKSPACE\Conf *.txt files.
-@call "%WORKSPACE%\BaseTools\Scripts\ShowEnvironment.bat"
+@call "%BASE_TOOLS_PATH%\Scripts\ShowEnvironment.bat"
 @if errorlevel 1 (
     @echo Unable to copy the template files from "%SRC_CONF%" to "%WORKSPACE%\Conf"
     @goto ExitFailure
@@ -375,22 +394,34 @@
 @REM Set up Visual Studio if required to build the Nt32Pkg/Nt32Pkg.dsc emulator
 @if "%NT32PKG%"=="TRUE" (
     @if not defined VSINSTALLDIR @set "PATH=%ORIGINAL_PATH%"
-    @if not defined NT32_X64 @call "%WORKSPACE%\BaseTools\get_vsvars.bat"
-    @if defined NT32_X64 call "%WORKSPACE%\BaseTools\Scripts\SetVisualStudio.bat"
+    @if not defined NT32_X64 @call "%BASE_TOOLS_PATH%\get_vsvars.bat"
+    @if defined NT32_X64 call "%BASE_TOOLS_PATH%\Scripts\SetVisualStudio.bat"
 )
 @if "%NT32PKG%"=="TRUE" (
     @if not defined VS_PATH set "VS_PATH=%PATH%"
 )
 @if defined VS_PATH @set "PATH=%VS_PATH%"
 @if not defined VS_PATH @set "PATH=%ORIGINAL_PATH%"
-@set "PATH=%EDK_TOOLS_PATH%\Bin\Win32;%PATH%"
+@if not defined EDK_TOOLS_BIN (
+  @if exist %EDK_TOOLS_PATH%\Bin\Win32 (
+    @set EDK_TOOLS_BIN=%EDK_TOOLS_PATH%\Bin\Win32
+  ) else (
+    @echo.
+    @echo !!! ERROR !!! Cannot find BaseTools Bin Win32!!!
+    @echo Please check the directory %EDK_TOOLS_PATH%\Bin\Win32
+    @echo Or configure EDK_TOOLS_BIN env to point Win32 directory.
+    @echo. 
+    @goto ExitFailure
+  )
+)
+@set "PATH=%EDK_TOOLS_BIN%;%PATH%"
 
 @if "%REBUILD_TOOLS%"=="TRUE" @goto Rebuild
 @if "%SVN_PULL%"== "TRUE" (
     if defined PYTHONHOME (
         @REM Use the python script if possible to test is the svn command is available, if it fails, the user may be
         @REM able to rebuild the Win32 binaries
-        @call "%WORKSPACE%\BaseTools\Scripts\UpdateBuildVersions.py" --svn-test -v
+        @call "%BASE_TOOLS_PATH%\Scripts\UpdateBuildVersions.py" --svn-test -v
         @if errorlevel 1 (
             @echo ERROR : The command-line svn tool is not available and the Win32 binaries do not exist
             @echo         Please re-run this script again with the --rebuild option to attempt to build 
@@ -417,7 +448,6 @@
 
 @REM The following code is used to rebuild the Win32 BaseTools binaries - check that required tools are available
 :Rebuild
-@if not defined BASE_TOOLS_PATH @set "BASE_TOOLS_PATH=%WORKSPACE%\BaseTools"
 @if not exist "%BASE_TOOLS_PATH%\Source" @goto NoBaseTools
 @endlocal
 @if not defined VCINSTALLDIR @goto NoVisualStudio
@@ -430,11 +460,11 @@
     @if not exist "%PYTHONHOME%\Scripts\cxfreeze.bat" @goto NoCxFreeze
     @set "PYTHON_FREEZER_PATH=%PYTHONHOME%\Scripts"
 )
-@call "%WORKSPACE%\BaseTools\Scripts\SetVisualStudio.bat"
+@call "%BASE_TOOLS_PATH%\Scripts\SetVisualStudio.bat"
 @if errorlevel 1 @goto ExitFailure
 
 :ShowAndExit
-@call "%WORKSPACE%\BaseTools\Scripts\ShowEnvironment.bat"
+@call "%BASE_TOOLS_PATH%\Scripts\ShowEnvironment.bat"
 
 @REM #########################################################################################
 @REM EXIT ROUTINES
diff --git a/Maintainers.txt b/Maintainers.txt
index 1a073141033a..acb717e03a07 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -68,7 +68,8 @@ M: Ard Biesheuvel <ard.biesheuvel@linaro.org>
 
 BaseTools
 W: https://github.com/tianocore/tianocore.github.io/wiki/BaseTools
-M: Yingke D Liu <yingke.d.liu@intel.com>
+M: Yonghong Zhu <yonghong.zhu@intel.com>
+M: Liming Gao <liming.gao@intel.com>
 
 BeagleBoardPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/BeagleBoardPkg
diff --git a/edksetup.bat b/edksetup.bat
index 25a5a6e8d7e3..b63c29916b06 100755
--- a/edksetup.bat
+++ b/edksetup.bat
@@ -42,9 +42,11 @@ if %WORKSPACE% == %CD% (
 :SetWorkSpace
 @REM set new workspace
 @REM clear EFI_SOURCE and EDK_SOURCE for the new workspace
-set WORKSPACE=%CD%
-set EFI_SOURCE=
-set EDK_SOURCE=
+if not defined WORKSPACE (
+  set WORKSPACE=%CD%
+  set EFI_SOURCE=
+  set EDK_SOURCE=
+)
 
 :ParseArgs
 if /I "%1"=="-h" goto Usage
@@ -92,8 +94,28 @@ if not defined VCINSTALLDIR (
 shift
 
 :no_nt32
+
 if /I "%1"=="NewBuild" shift
-set EDK_TOOLS_PATH=%WORKSPACE%\BaseTools
+if exist %WORKSPACE%\BaseTools (
+  set EDK_TOOLS_PATH=%WORKSPACE%\BaseTools
+) else (
+  if defined PACKAGES_PATH (
+    for %%i IN (%PACKAGES_PATH%) DO (
+      if exist %%~fi\BaseTools (
+        set EDK_TOOLS_PATH=%%~fi\BaseTools
+        goto checkBaseTools
+      )
+    )
+  ) else (
+    echo.
+    echo !!! ERROR !!! Cannot find BaseTools !!!
+    echo. 
+    goto BadBaseTools
+  )
+)
+if exist %EDK_TOOLS_PATH%\Source set BASE_TOOLS_PATH=%EDK_TOOLS_PATH%
+
+:checkBaseTools
 IF NOT EXIST "%EDK_TOOLS_PATH%\toolsetup.bat" goto BadBaseTools
 call %EDK_TOOLS_PATH%\toolsetup.bat %*
 if /I "%1"=="Reconfig" shift
diff --git a/edksetup.sh b/edksetup.sh
index 64795c48d274..57368b56afac 100755
--- a/edksetup.sh
+++ b/edksetup.sh
@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -78,10 +78,23 @@ function SetupEnv()
   elif [ -f "$WORKSPACE/BaseTools/BuildEnv" ]
   then
     . $WORKSPACE/BaseTools/BuildEnv $*
+  elif [ -n "$PACKAGES_PATH" ]
+  then 
+    PATH_LIST=$PACKAGES_PATH
+    PATH_LIST=${PATH_LIST//:/ }
+    for DIR in $PATH_LIST
+    do
+      if [ -f "$DIR/BaseTools/BuildEnv" ]
+      then
+        export EDK_TOOLS_PATH=$DIR/BaseTools
+        . $DIR/BaseTools/BuildEnv $*
+        break
+      fi
+    done
   else
     echo BaseTools not found in your tree, and EDK_TOOLS_PATH is not set.
-    echo Please check that WORKSPACE is not set incorrectly in your
-    echo shell, or point EDK_TOOLS_PATH at the directory that contains
+    echo Please check that WORKSPACE or PACKAGES_PATH is not set incorrectly
+    echo in your shell, or point EDK_TOOLS_PATH at the directory that contains
     echo the EDK2 BuildEnv script.
     return 1
   fi

From cbf0366ac7df84a768b173b730526c6282d751c8 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:24:17 +0000
Subject: [PATCH 192/525] UefiCpuPkg/CpuMpPei: Exchange whole CPU data in
 SortApicId()

Current implementation only exchanges the APIC ID and BIST, this updating is to
exchange all CPU data.

(Sync patch r19085 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19091 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index c22252220316..ae071ac1f81a 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -61,7 +61,7 @@ SortApicId (
   UINTN             Index2;
   UINTN             Index3;
   UINT32            ApicId;
-  EFI_HEALTH_FLAGS  Health;
+  PEI_CPU_DATA      CpuData;
   UINT32            ApCount;
 
   ApCount = PeiCpuMpData->CpuCount - 1;
@@ -80,11 +80,13 @@ SortApicId (
         }
       }
       if (Index3 != Index1) {
-        PeiCpuMpData->CpuData[Index3].ApicId = PeiCpuMpData->CpuData[Index1].ApicId;
-        PeiCpuMpData->CpuData[Index1].ApicId = ApicId;
-        Health = PeiCpuMpData->CpuData[Index3].Health;
-        PeiCpuMpData->CpuData[Index3].Health = PeiCpuMpData->CpuData[Index1].Health;
-        PeiCpuMpData->CpuData[Index1].Health = Health;
+        CopyMem (&CpuData, &PeiCpuMpData->CpuData[Index3], sizeof (PEI_CPU_DATA));
+        CopyMem (
+          &PeiCpuMpData->CpuData[Index3],
+          &PeiCpuMpData->CpuData[Index1],
+          sizeof (PEI_CPU_DATA)
+          );
+        CopyMem (&PeiCpuMpData->CpuData[Index1], &CpuData, sizeof (PEI_CPU_DATA));
       }
     }
 

From 3e77391057f37d540254e7a388764d8057cbf9b6 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:24:52 +0000
Subject: [PATCH 193/525] UefiCpuPkg/CpuMpPei: Add CPU_VOLATILE_REGISTERS &
 worker functions

Add CPU_VOLATILE_REGISTERS definitions for CRx and DRx required to be restored
after APs received INIT IPI.

Add worker functions SaveVolatileRegisters()/RestoreVolatileRegisters() used to
save/restore CRx and DRx. It also check if Debugging Extensions supported or
not.

(Sync patch r19086 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19092 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 67 ++++++++++++++++++++++++++++++++++
 UefiCpuPkg/CpuMpPei/CpuMpPei.h | 13 +++++++
 2 files changed, 80 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index ae071ac1f81a..7bedf6421091 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -141,6 +141,73 @@ GetMpHobData (
   return CpuMpData;
 }
 
+/**
+  Save the volatile registers required to be restored following INIT IPI
+  
+  @param  VolatileRegisters    Returns buffer saved the volatile resisters
+**/
+VOID
+SaveVolatileRegisters (
+  OUT CPU_VOLATILE_REGISTERS    *VolatileRegisters
+  )
+{
+  UINT32                        RegEdx;
+
+  VolatileRegisters->Cr0 = AsmReadCr0 ();
+  VolatileRegisters->Cr3 = AsmReadCr3 ();
+  VolatileRegisters->Cr4 = AsmReadCr4 ();
+
+  AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &RegEdx);
+  if ((RegEdx & BIT2) != 0) {
+    //
+    // If processor supports Debugging Extensions feature
+    // by CPUID.[EAX=01H]:EDX.BIT2
+    //
+    VolatileRegisters->Dr0 = AsmReadDr0 ();
+    VolatileRegisters->Dr1 = AsmReadDr1 ();
+    VolatileRegisters->Dr2 = AsmReadDr2 ();
+    VolatileRegisters->Dr3 = AsmReadDr3 ();
+    VolatileRegisters->Dr6 = AsmReadDr6 ();
+    VolatileRegisters->Dr7 = AsmReadDr7 ();
+  }
+}
+
+/**
+  Restore the volatile registers following INIT IPI
+  
+  @param  VolatileRegisters   Pointer to volatile resisters
+  @param  IsRestoreDr         TRUE:  Restore DRx if supported
+                              FALSE: Do not restore DRx
+**/
+VOID
+RestoreVolatileRegisters (
+  IN CPU_VOLATILE_REGISTERS    *VolatileRegisters,
+  IN BOOLEAN                   IsRestoreDr
+  )
+{
+  UINT32                        RegEdx;
+
+  AsmWriteCr0 (VolatileRegisters->Cr0);
+  AsmWriteCr3 (VolatileRegisters->Cr3);
+  AsmWriteCr4 (VolatileRegisters->Cr4);
+
+  if (IsRestoreDr) {
+    AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &RegEdx);
+    if ((RegEdx & BIT2) != 0) {
+      //
+      // If processor supports Debugging Extensions feature
+      // by CPUID.[EAX=01H]:EDX.BIT2
+      //
+      AsmWriteDr0 (VolatileRegisters->Dr0);
+      AsmWriteDr1 (VolatileRegisters->Dr1);
+      AsmWriteDr2 (VolatileRegisters->Dr2);
+      AsmWriteDr3 (VolatileRegisters->Dr3);
+      AsmWriteDr6 (VolatileRegisters->Dr6);
+      AsmWriteDr7 (VolatileRegisters->Dr7);
+    }
+  }
+}
+
 /**
   This function will be called from AP reset code if BSP uses WakeUpAP.
 
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index de9011329c08..f2286b990ee9 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -113,11 +113,24 @@ typedef struct {
 
 #pragma pack()
 
+typedef struct {
+  UINTN                          Cr0;
+  UINTN                          Cr3;
+  UINTN                          Cr4;
+  UINTN                          Dr0;
+  UINTN                          Dr1;
+  UINTN                          Dr2;
+  UINTN                          Dr3;
+  UINTN                          Dr6;
+  UINTN                          Dr7;
+} CPU_VOLATILE_REGISTERS;
+
 typedef struct {
   UINT32                         ApicId;
   EFI_HEALTH_FLAGS               Health;
   CPU_STATE                      State;
   BOOLEAN                        CpuHealthy;
+  CPU_VOLATILE_REGISTERS         VolatileRegisters;
 } PEI_CPU_DATA;
 
 //

From cfe8be0f32d945a6b3cdc9096bfe11f50bb09447 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:25:21 +0000
Subject: [PATCH 194/525] UefiCpuPkg/CpuMpPei: Set AP state to CpuStateIdle
 after initialization

(Sync patch r19087 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19093 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 7bedf6421091..d058d143ced7 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -228,13 +228,14 @@ ApCFunction (
 
   PeiCpuMpData = ExchangeInfo->PeiCpuMpData;
   if (PeiCpuMpData->InitFlag) {
+    ProcessorNumber = NumApsExecuting;
     //
     // This is first time AP wakeup, get BIST information from AP stack
     //
-    BistData = *(UINTN *) (PeiCpuMpData->Buffer + NumApsExecuting * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
-    PeiCpuMpData->CpuData[NumApsExecuting].Health.Uint32 = (UINT32) BistData;
-    PeiCpuMpData->CpuData[NumApsExecuting].ApicId = GetInitialApicId ();
-    if (PeiCpuMpData->CpuData[NumApsExecuting].ApicId >= 0xFF) {
+    BistData = *(UINTN *) (PeiCpuMpData->Buffer + ProcessorNumber * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
+    PeiCpuMpData->CpuData[ProcessorNumber].Health.Uint32 = (UINT32) BistData;
+    PeiCpuMpData->CpuData[ProcessorNumber].ApicId = GetInitialApicId ();
+    if (PeiCpuMpData->CpuData[ProcessorNumber].ApicId >= 0xFF) {
       //
       // Set x2APIC mode if there are any logical processor reporting
       // an APIC ID of 255 or greater.
@@ -248,6 +249,7 @@ ApCFunction (
     //
     MtrrSetAllMtrrs (&PeiCpuMpData->MtrrTable);
     MicrocodeDetect ();
+    PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
   } else {
     //
     // Execute AP function if AP is not disabled

From 5bdb31378999f8a061427a8903b469cf1d02b72e Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:25:45 +0000
Subject: [PATCH 195/525] UefiCpuPkg/CpuMpPei: Sync BSP's CRx to APs when
 initialization

Save BSP's volatile register and sync CRx register to APs when AP 1st wake up.

(Sync patch r19088 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19094 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index d058d143ced7..53af9489b2db 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -230,6 +230,10 @@ ApCFunction (
   if (PeiCpuMpData->InitFlag) {
     ProcessorNumber = NumApsExecuting;
     //
+    // Sync BSP's Control registers to APs
+    //
+    RestoreVolatileRegisters (&PeiCpuMpData->CpuData[0].VolatileRegisters, FALSE);
+    //
     // This is first time AP wakeup, get BIST information from AP stack
     //
     BistData = *(UINTN *) (PeiCpuMpData->Buffer + ProcessorNumber * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
@@ -560,6 +564,7 @@ PrepareAPStartupVector (
   PeiCpuMpData->CpuData[0].Health.Uint32 = 0;
   PeiCpuMpData->EndOfPeiFlag             = FALSE;
   InitializeSpinLock(&PeiCpuMpData->MpLock);
+  SaveVolatileRegisters (&PeiCpuMpData->CpuData[0].VolatileRegisters);
   CopyMem (&PeiCpuMpData->AddressMap, &AddressMap, sizeof (MP_ASSEMBLY_ADDRESS_MAP));
 
   //

From 9d564cd5229bd2cd370cce13093e0d8b60cc7003 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:26:24 +0000
Subject: [PATCH 196/525] UefiCpuPkg/CpuMpPei: Save/Restore CRx/DRx register
 for APs waking up

PeiStartupAllAPs()/PeiStartupThisAP() will send INIT-SIPI-SIPI to wakeup APs to
execute AP function. However, some registers will be reset after APs received
INIT IPI. We need to restore some registers (For example, CRx/DRx) manually
after APs wakeup.

(Sync patch r19089 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19095 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 53af9489b2db..ca486135029a 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -259,6 +259,11 @@ ApCFunction (
     // Execute AP function if AP is not disabled
     //
     GetProcessorNumber (PeiCpuMpData, &ProcessorNumber);
+    //
+    // Restore AP's volatile registers saved
+    //
+    RestoreVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters, TRUE);
+
     if ((PeiCpuMpData->CpuData[ProcessorNumber].State != CpuStateDisabled) &&
         (PeiCpuMpData->ApFunction != 0)) {
       PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateBusy;
@@ -273,6 +278,11 @@ ApCFunction (
   //
   InterlockedIncrement ((UINT32 *)&PeiCpuMpData->FinishedCount);
 
+  //
+  // Save AP volatile registers
+  //
+  SaveVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters);
+
   AsmCliHltLoop ();
 }
 

From 37c2cf4fb85f7c79a15fc860dc5366f562d5f305 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Dec 2015 03:27:06 +0000
Subject: [PATCH 197/525] UefiCpuPkg/CpuMpPei: Fix typo and add some comments

(Sync patch r19090 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@Intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19096 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index ca486135029a..ab1260d0451b 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -212,7 +212,7 @@ RestoreVolatileRegisters (
   This function will be called from AP reset code if BSP uses WakeUpAP.
 
   @param ExchangeInfo     Pointer to the MP exchange info buffer
-  @param NumApsExecuting  Number of curret executing AP
+  @param NumApsExecuting  Number of current executing AP
 **/
 VOID
 EFIAPI
@@ -268,6 +268,9 @@ ApCFunction (
         (PeiCpuMpData->ApFunction != 0)) {
       PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateBusy;
       Procedure = (EFI_AP_PROCEDURE)(UINTN)PeiCpuMpData->ApFunction;
+      //
+      // Invoke AP function here
+      //
       Procedure ((VOID *)(UINTN)PeiCpuMpData->ApFunctionArgument);
       PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
     }
@@ -612,7 +615,7 @@ CpuMpEndOfPeiCallback (
   EFI_PEI_HOB_POINTERS      Hob;
   EFI_HOB_MEMORY_ALLOCATION *MemoryHob;
 
-  DEBUG ((EFI_D_INFO, "CpuMpPei: CpuMpEndOfPeiCallback () invokded\n"));
+  DEBUG ((EFI_D_INFO, "CpuMpPei: CpuMpEndOfPeiCallback () invoked\n"));
 
   Status = PeiServicesGetBootMode (&BootMode);
   ASSERT_EFI_ERROR (Status);

From 183f7faabc138a8d47c6dd387ed2ad175e9f96fe Mon Sep 17 00:00:00 2001
From: Mike Maslenkin <mike.maslenkin@gmail.com>
Date: Thu, 3 Dec 2015 03:27:13 +0000
Subject: [PATCH 198/525] BaseTools: sync BaseTools from main trunk r18579.

This patch fixes incomplete merge of multiple workspaces support.
Without this patch build fails with error similar to:

~/sources/edk2> build -p MdePkg/MdePkg.dsc -t GCC48 -a X64

Build environment: Linux-3.16.7-24-desktop-x86_64-with-SuSE-13.2-x86_64
Build start time: 17:15:43, Dec.02 2015

WORKSPACE        = /home/user/sources/edk2
ECP_SOURCE       = /home/user/sources/edk2/EdkCompatibilityPkg
EDK_SOURCE       = /home/user/sources/edk2/EdkCompatibilityPkg
EFI_SOURCE       = /home/user/sources/edk2/EdkCompatibilityPkg
EDK_TOOLS_PATH   = /home/user/sources/edk2/BaseTools

build.py...
 : error C0DE: Unknown fatal error when processing [/home/user/sources/edk2/MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf]

(Please send email to edk2-devel@lists.sourceforge.net for help, attaching following call stack trace!)

(Python 2.7.8 on linux2) Traceback (most recent call last):
  File "/home/user/sources/edk2/BaseTools/BinWrappers/PosixLike/../../Source/Python/build/build.py", line 2033, in Main
    MyBuild.Launch()
  File "/home/user/sources/edk2/BaseTools/BinWrappers/PosixLike/../../Source/Python/build/build.py", line 1788, in Launch
    self._MultiThreadBuildPlatform()
  File "/home/user/sources/edk2/BaseTools/BinWrappers/PosixLike/../../Source/Python/build/build.py", line 1583, in _MultiThreadBuildPlatform
    self.Progress
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 175, in __new__
    if not AutoGenObject._Init(Workspace, MetaFile, Target, Toolchain, Arch, *args, **kwargs):
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 355, in _Init
    Pkgs = list(PkgSet) + list(PGen.PackageList)
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 1484, in _GetPackageList
    for La in self.LibraryAutoGenList:
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 1594, in _GetLibraryAutoGenList
    self._GetAutoGenObjectList()
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 1575, in _GetAutoGenObjectList
    self.MetaFile
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 175, in __new__
    if not AutoGenObject._Init(Workspace, MetaFile, Target, Toolchain, Arch, *args, **kwargs):
  File "/home/user/sources/edk2/BaseTools/Source/Python/AutoGen/AutoGen.py", line 2199, in _Init
    self.SourceDir = mws.relpath(self.SourceDir, self.WorkspaceDir)
  File "/home/user/sources/edk2/BaseTools/Source/Python/Common/MultipleWorkspace.py", line 94, in relpath
    for Pkg in cls.PACKAGES_PATH:
TypeError: 'NoneType' object is not iterable

- Failed -
Build end time: 17:15:44, Dec.02 2015
Build total time: 00:00:01

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Mike Maslenkin <mike.maslenkin@gmail.com>
Cc: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19102 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/build/BuildReport.py | 16 ++++---
 BaseTools/Source/Python/build/build.py       | 46 +++++++++++++-------
 2 files changed, 39 insertions(+), 23 deletions(-)

diff --git a/BaseTools/Source/Python/build/BuildReport.py b/BaseTools/Source/Python/build/BuildReport.py
index d64c55d08bc1..38e55f3e07f6 100644
--- a/BaseTools/Source/Python/build/BuildReport.py
+++ b/BaseTools/Source/Python/build/BuildReport.py
@@ -41,6 +41,7 @@
 from Common.DataType import TAB_BRG_LIBRARY
 from Common.DataType import TAB_BACK_SLASH
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Pattern to extract contents in EDK DXS files
 gDxsDependencyPattern = re.compile(r"DEPENDENCY_START(.+)DEPENDENCY_END", re.DOTALL)
@@ -1235,12 +1236,13 @@ def __init__(self, FdRegion, Wa):
                     DecDefaultValue = Package.Pcds[TokenCName, TokenSpaceGuidCName, DecType].DefaultValue
                     PlatformPcds[(TokenCName, TokenSpaceGuidCName)] = DecDefaultValue
         #
-        # Collect PCDs defined in DSC common section
+        # Collect PCDs defined in DSC file
         #
-        Platform = Wa.BuildDatabase[Wa.MetaFile, 'COMMON']
-        for (TokenCName, TokenSpaceGuidCName) in Platform.Pcds:
-            DscDefaultValue = Platform.Pcds[(TokenCName, TokenSpaceGuidCName)].DefaultValue
-            PlatformPcds[(TokenCName, TokenSpaceGuidCName)] = DscDefaultValue
+        for arch in Wa.ArchList:
+            Platform = Wa.BuildDatabase[Wa.MetaFile, arch]
+            for (TokenCName, TokenSpaceGuidCName) in Platform.Pcds:
+                DscDefaultValue = Platform.Pcds[(TokenCName, TokenSpaceGuidCName)].DefaultValue
+                PlatformPcds[(TokenCName, TokenSpaceGuidCName)] = DscDefaultValue
 
         #
         # Add PEI and DXE a priori files GUIDs defined in PI specification.
@@ -1255,7 +1257,7 @@ def __init__(self, FdRegion, Wa):
         for Pa in Wa.AutoGenObjectList:
             for ModuleKey in Pa.Platform.Modules:
                 M = Pa.Platform.Modules[ModuleKey].M
-                InfPath = os.path.join(Wa.WorkspaceDir, M.MetaFile.File)
+                InfPath = mws.join(Wa.WorkspaceDir, M.MetaFile.File)
                 self._GuidsDb[M.Guid.upper()] = "%s (%s)" % (M.Module.BaseName, InfPath)
 
         #
@@ -1277,7 +1279,7 @@ def __init__(self, FdRegion, Wa):
                             Guid = GuidStructureByteArrayToGuidString(GuidValue).upper()
                     for Section in Ffs.SectionList:
                         try:
-                            ModuleSectFile = os.path.join(Wa.WorkspaceDir, Section.SectFileName)
+                            ModuleSectFile = mws.join(Wa.WorkspaceDir, Section.SectFileName)
                             self._GuidsDb[Guid] = ModuleSectFile
                         except AttributeError:
                             pass
diff --git a/BaseTools/Source/Python/build/build.py b/BaseTools/Source/Python/build/build.py
index 33b45ba26717..6d83ac9701ba 100644
--- a/BaseTools/Source/Python/build/build.py
+++ b/BaseTools/Source/Python/build/build.py
@@ -41,6 +41,7 @@
 from AutoGen.AutoGen import *
 from Common.BuildToolError import *
 from Workspace.WorkspaceDatabase import *
+from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 from BuildReport import BuildReport
 from GenPatchPcdTable.GenPatchPcdTable import *
@@ -104,12 +105,16 @@ def CheckEnvVariable():
         EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "No space is allowed in WORKSPACE path",
                         ExtraData=WorkspaceDir)
     os.environ["WORKSPACE"] = WorkspaceDir
+    
+    # set multiple workspace
+    PackagesPath = os.getenv("PACKAGES_PATH")
+    mws.setWs(WorkspaceDir, PackagesPath)
 
     #
     # Check EFI_SOURCE (Edk build convention). EDK_SOURCE will always point to ECP
     #
     if "ECP_SOURCE" not in os.environ:
-        os.environ["ECP_SOURCE"] = os.path.join(WorkspaceDir, GlobalData.gEdkCompatibilityPkg)
+        os.environ["ECP_SOURCE"] = mws.join(WorkspaceDir, GlobalData.gEdkCompatibilityPkg)
     if "EFI_SOURCE" not in os.environ:
         os.environ["EFI_SOURCE"] = os.environ["ECP_SOURCE"]
     if "EDK_SOURCE" not in os.environ:
@@ -151,16 +156,18 @@ def CheckEnvVariable():
         EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "No space is allowed in EFI_SOURCE path",
                         ExtraData=EfiSourceDir)
 
-    # change absolute path to relative path to WORKSPACE
-    if EfiSourceDir.upper().find(WorkspaceDir.upper()) != 0:
-        EdkLogger.error("build", PARAMETER_INVALID, "EFI_SOURCE is not under WORKSPACE",
-                        ExtraData="WORKSPACE = %s\n    EFI_SOURCE = %s" % (WorkspaceDir, EfiSourceDir))
-    if EdkSourceDir.upper().find(WorkspaceDir.upper()) != 0:
-        EdkLogger.error("build", PARAMETER_INVALID, "EDK_SOURCE is not under WORKSPACE",
-                        ExtraData="WORKSPACE = %s\n    EDK_SOURCE = %s" % (WorkspaceDir, EdkSourceDir))
-    if EcpSourceDir.upper().find(WorkspaceDir.upper()) != 0:
-        EdkLogger.error("build", PARAMETER_INVALID, "ECP_SOURCE is not under WORKSPACE",
-                        ExtraData="WORKSPACE = %s\n    ECP_SOURCE = %s" % (WorkspaceDir, EcpSourceDir))
+    # check those variables on single workspace case
+    if not PackagesPath:
+        # change absolute path to relative path to WORKSPACE
+        if EfiSourceDir.upper().find(WorkspaceDir.upper()) != 0:
+            EdkLogger.error("build", PARAMETER_INVALID, "EFI_SOURCE is not under WORKSPACE",
+                            ExtraData="WORKSPACE = %s\n    EFI_SOURCE = %s" % (WorkspaceDir, EfiSourceDir))
+        if EdkSourceDir.upper().find(WorkspaceDir.upper()) != 0:
+            EdkLogger.error("build", PARAMETER_INVALID, "EDK_SOURCE is not under WORKSPACE",
+                            ExtraData="WORKSPACE = %s\n    EDK_SOURCE = %s" % (WorkspaceDir, EdkSourceDir))
+        if EcpSourceDir.upper().find(WorkspaceDir.upper()) != 0:
+            EdkLogger.error("build", PARAMETER_INVALID, "ECP_SOURCE is not under WORKSPACE",
+                            ExtraData="WORKSPACE = %s\n    ECP_SOURCE = %s" % (WorkspaceDir, EcpSourceDir))
 
     # check EDK_TOOLS_PATH
     if "EDK_TOOLS_PATH" not in os.environ:
@@ -182,7 +189,7 @@ def CheckEnvVariable():
     GlobalData.gGlobalDefines["EDK_SOURCE"] = EdkSourceDir
     GlobalData.gGlobalDefines["ECP_SOURCE"] = EcpSourceDir
     GlobalData.gGlobalDefines["EDK_TOOLS_PATH"] = os.environ["EDK_TOOLS_PATH"]
-
+    
 ## Get normalized file path
 #
 # Convert the path to be local format, and remove the WORKSPACE path at the
@@ -198,7 +205,8 @@ def NormFile(FilePath, Workspace):
     if os.path.isabs(FilePath):
         FileFullPath = os.path.normpath(FilePath)
     else:
-        FileFullPath = os.path.normpath(os.path.join(Workspace, FilePath))
+        FileFullPath = os.path.normpath(mws.join(Workspace, FilePath))
+        Workspace = mws.getWs(Workspace, FilePath)
 
     # check if the file path exists or not
     if not os.path.isfile(FileFullPath):
@@ -748,10 +756,10 @@ def __init__(self, Target, WorkspaceDir, BuildOptions):
             if not os.path.isabs(ConfDirectoryPath):
                 # Since alternate directory name is not absolute, the alternate directory is located within the WORKSPACE
                 # This also handles someone specifying the Conf directory in the workspace. Using --conf=Conf
-                ConfDirectoryPath = os.path.join(self.WorkspaceDir, ConfDirectoryPath)
+                ConfDirectoryPath = mws.join(self.WorkspaceDir, ConfDirectoryPath)
         else:
             # Get standard WORKSPACE/Conf use the absolute path to the WORKSPACE/Conf
-            ConfDirectoryPath = os.path.join(self.WorkspaceDir, 'Conf')
+            ConfDirectoryPath = mws.join(self.WorkspaceDir, 'Conf')
         GlobalData.gConfDirectory = ConfDirectoryPath
         GlobalData.gDatabasePath = os.path.normpath(os.path.join(ConfDirectoryPath, GlobalData.gDatabasePath))
 
@@ -772,10 +780,16 @@ def __init__(self, Target, WorkspaceDir, BuildOptions):
 
         # print current build environment and configuration
         EdkLogger.quiet("%-16s = %s" % ("WORKSPACE", os.environ["WORKSPACE"]))
+        if "PACKAGES_PATH" in os.environ:
+            # WORKSPACE env has been converted before. Print the same path style with WORKSPACE env. 
+            EdkLogger.quiet("%-16s = %s" % ("PACKAGES_PATH", os.path.normcase(os.path.normpath(os.environ["PACKAGES_PATH"]))))
         EdkLogger.quiet("%-16s = %s" % ("ECP_SOURCE", os.environ["ECP_SOURCE"]))
         EdkLogger.quiet("%-16s = %s" % ("EDK_SOURCE", os.environ["EDK_SOURCE"]))
         EdkLogger.quiet("%-16s = %s" % ("EFI_SOURCE", os.environ["EFI_SOURCE"]))
         EdkLogger.quiet("%-16s = %s" % ("EDK_TOOLS_PATH", os.environ["EDK_TOOLS_PATH"]))
+        if "EDK_TOOLS_BIN" in os.environ:
+            # Print the same path style with WORKSPACE env. 
+            EdkLogger.quiet("%-16s = %s" % ("EDK_TOOLS_BIN", os.path.normcase(os.path.normpath(os.environ["EDK_TOOLS_BIN"]))))
 
         EdkLogger.info("")
 
@@ -796,7 +810,7 @@ def LoadConfiguration(self):
             ToolDefinitionFile = self.TargetTxt.TargetTxtDictionary[DataType.TAB_TAT_DEFINES_TOOL_CHAIN_CONF]
             if ToolDefinitionFile == '':
                 ToolDefinitionFile = gToolsDefinition
-                ToolDefinitionFile = os.path.normpath(os.path.join(self.WorkspaceDir, 'Conf', ToolDefinitionFile))
+                ToolDefinitionFile = os.path.normpath(mws.join(self.WorkspaceDir, 'Conf', ToolDefinitionFile))
             if os.path.isfile(ToolDefinitionFile) == True:
                 StatusCode = self.ToolDef.LoadToolDefFile(ToolDefinitionFile)
             else:

From 22ad647ffebbd26766a806007ad8eb2a35e3db09 Mon Sep 17 00:00:00 2001
From: Wang Yu <yu.wang@intel.com>
Date: Fri, 4 Dec 2015 03:43:12 +0000
Subject: [PATCH 199/525] BaseTools: Add VS2015 tool chain in
 tools_def.template

(Sync patch r19101 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Wang Yu <yu.wang@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19117 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Conf/tools_def.template | 519 +++++++++++++++++++++++++++++-
 edksetup.bat                      |  38 ++-
 2 files changed, 536 insertions(+), 21 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index db08e252d2b9..88d4b4f3b6c9 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -65,6 +65,14 @@ DEFINE VS2013x86_BIN    = C:\Program Files (x86)\Microsoft Visual Studio 12.0\Vc
 DEFINE VS2013x86_DLL    = C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE;DEF(VS2013x86_BIN)
 DEFINE VS2013x86_BINX64 = DEF(VS2013x86_BIN)\x86_amd64
 
+DEFINE VS2015_BIN      = C:\Program Files\Microsoft Visual Studio 14.0\Vc\bin
+DEFINE VS2015_DLL      = C:\Program Files\Microsoft Visual Studio 14.0\Common7\IDE;DEF(VS2015_BIN)
+DEFINE VS2015_BINX64   = DEF(VS2015_BIN)\x86_amd64
+
+DEFINE VS2015x86_BIN    = C:\Program Files (x86)\Microsoft Visual Studio 14.0\Vc\bin
+DEFINE VS2015x86_DLL    = C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE;DEF(VS2015x86_BIN)
+DEFINE VS2015x86_BINX64 = DEF(VS2015x86_BIN)\x86_amd64
+
 DEFINE WINSDK_VERSION   = v6.0A
 DEFINE WINSDK_BIN       = c:\Program Files\Microsoft SDKs\Windows\DEF(WINSDK_VERSION)\bin
 DEFINE WINSDKx86_BIN    = c:\Program Files (x86)\Microsoft SDKs\Windows\DEF(WINSDK_VERSION)\bin
@@ -81,6 +89,10 @@ DEFINE WINSDK71x86_BIN    = c:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\
 DEFINE WINSDK8_BIN       = c:\Program Files\Windows Kits\8.0\bin\x86\
 DEFINE WINSDK8x86_BIN    = c:\Program Files (x86)\Windows Kits\8.0\bin\x64
 
+# Microsoft Visual Studio 2015 Professional Edition
+DEFINE WINSDK81_BIN       = c:\Program Files\Windows Kits\8.1\bin\x86\
+DEFINE WINSDK81x86_BIN    = c:\Program Files (x86)\Windows Kits\8.1\bin\x64
+
 # These defines are needed for certain Microsoft Visual Studio tools that
 # are used by other toolchains.  An example is that ICC on Windows normally
 # uses Microsoft's nmake.exe.
@@ -293,6 +305,15 @@ DEFINE SOURCERY_CYGWIN_TOOLS = /cygdrive/c/Program Files/CodeSourcery/Sourcery G
 #                             Required to build platforms or ACPI tables:
 #                               Intel(r) ACPI Compiler (iasl.exe) from
 #                               https://acpica.org/downloads
+#   VS2015      -win32-  Requires:
+#                             Microsoft Visual Studio 2015 Professional Edition
+#                             Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830
+#                        Optional:
+#                             Required to build EBC drivers:
+#                               Intel(r) Compiler for Efi Byte Code (Intel(r) EBC Compiler)
+#                             Required to build platforms or ACPI tables:
+#                               Intel(r) ACPI Compiler (iasl.exe) from
+#                               https://acpica.org/downloads
 #   DDK3790     -win32-  Requires:
 #                             Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830
 #                        Optional:
@@ -452,6 +473,15 @@ DEFINE SOURCERY_CYGWIN_TOOLS = /cygdrive/c/Program Files/CodeSourcery/Sourcery G
 #                             Required to build platforms or ACPI tables:
 #                               Microsoft ASL ACPI Compiler (asl.exe) v4.0.0 from
 #                               http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/microsoft_asl_compiler-v4-0-0.msi
+#   VS2015xASL  -win32-  Requires:
+#                             Microsoft Visual Studio 2015 Professional Edition
+#                             Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830
+#                        Optional:
+#                             Required to build EBC drivers:
+#                               Intel(r) Compiler for Efi Byte Code (Intel(r) EBC Compiler)
+#                             Required to build platforms or ACPI tables:
+#                               Microsoft ASL ACPI Compiler (asl.exe) v4.0.0 from
+#                               http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/microsoft_asl_compiler-v4-0-0.msi
 #   DDK3790xASL -win32-  Requires:
 #                             Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830
 #                        Optional:
@@ -530,6 +560,13 @@ DEFINE SOURCERY_CYGWIN_TOOLS = /cygdrive/c/Program Files/CodeSourcery/Sourcery G
 #                             Required to build platforms or ACPI tables:
 #                               Intel(r) ACPI Compiler (iasl.exe) from
 #                               https://acpica.org/downloads
+#   VS2015x86   -win64-  Requires:
+#                             Microsoft Visual Studio 2015 (x86) Professional Edition
+#                             Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830
+#                        Optional:
+#                             Required to build platforms or ACPI tables:
+#                               Intel(r) ACPI Compiler (iasl.exe) from
+#                               https://acpica.org/downloads
 #   ICCx86      -win64-  Requires:
 #                             Intel C Compiler V9.1(x86)
 #                        Dependencies:
@@ -591,6 +628,13 @@ DEFINE SOURCERY_CYGWIN_TOOLS = /cygdrive/c/Program Files/CodeSourcery/Sourcery G
 #                             Required to build platforms or ACPI tables:
 #                               Microsoft ASL ACPI Compiler (asl.exe) v4.0.0 from
 #                               http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/microsoft_asl_compiler-v4-0-0.msi
+#  VS2015x86xASL -win64- Requires:
+#                             Microsoft Visual Studio 2015 (x86) Professional
+#                             Microsoft Windows Server 2003 Driver Development Kit(Microsoft WINDDK) version 3790.1830 
+#                        Optional:
+#                             Required to build platforms or ACPI tables:
+#                               Microsoft ASL ACPI Compiler (asl.exe) v4.0.0 from
+#                               http://download.microsoft.com/download/2/c/1/2c16c7e0-96c1-40f5-81fc-3e4bf7b65496/microsoft_asl_compiler-v4-0-0.msi
 #   ICCx86xASL  -win64-  Requires:
 #                             Intel C Compiler V9.1 (x86)
 #                        Dependencies:
@@ -2601,7 +2645,7 @@ NOOPT_VS2010x86xASL_IPF_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /LTCG /DLL /OPT:R
 #   VS2012  - Microsoft Visual Studio 2012 Professional Edition with Intel ASL
 #   ASL     - Intel ACPI Source Language Compiler
 ####################################################################################
-#   VS2012           - Microsoft Visual Studio 2012 Premium Edition
+#   VS2012           - Microsoft Visual Studio 2012 Professional Edition
 *_VS2012_*_*_FAMILY               = MSFT
 
 *_VS2012_*_MAKE_PATH              = DEF(VS2012_BIN)\nmake.exe
@@ -2719,7 +2763,7 @@ NOOPT_VS2012_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT
 #   VS2012  - Microsoft Visual Studio 2012 Professional Edition with Microsoft ASL
 #   ASL     - Microsoft ACPI Source Language Compiler (asl.exe)
 ####################################################################################
-#   VS2012xASL           - Microsoft Visual Studio 2012 Premium Edition
+#   VS2012xASL           - Microsoft Visual Studio 2012 Professional Edition
 *_VS2012xASL_*_*_FAMILY        = MSFT
 
 *_VS2012xASL_*_MAKE_PATH       = DEF(VS2012_BIN)\nmake.exe
@@ -3067,7 +3111,7 @@ NOOPT_VS2012x86xASL_X64_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT
 #   VS2013  - Microsoft Visual Studio 2013 Professional Edition with Intel ASL
 #   ASL     - Intel ACPI Source Language Compiler
 ####################################################################################
-#   VS2013           - Microsoft Visual Studio 2013 Premium Edition
+#   VS2013           - Microsoft Visual Studio 2013 Professional Edition
 *_VS2013_*_*_FAMILY               = MSFT
 
 *_VS2013_*_MAKE_PATH              = DEF(VS2013_BIN)\nmake.exe
@@ -3185,7 +3229,7 @@ NOOPT_VS2013_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT
 #   VS2013  - Microsoft Visual Studio 2013 Professional Edition with Microsoft ASL
 #   ASL     - Microsoft ACPI Source Language Compiler (asl.exe)
 ####################################################################################
-#   VS2013xASL           - Microsoft Visual Studio 2013 Premium Edition
+#   VS2013xASL           - Microsoft Visual Studio 2013 Professional Edition
 *_VS2013xASL_*_*_FAMILY        = MSFT
 
 *_VS2013xASL_*_MAKE_PATH       = DEF(VS2013_BIN)\nmake.exe
@@ -3527,6 +3571,473 @@ NOOPT_VS2013x86xASL_X64_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT
 *_VS2013x86xASL_EBC_DLINK_FLAGS         = "C:\Program Files (x86)\Intel\EBC\Lib\EbcLib.lib" /NOLOGO /NODEFAULTLIB /MACHINE:EBC /OPT:REF /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /MAP /ALIGN:32 /DRIVER
 
 
+####################################################################################
+#
+# Microsoft Visual Studio 2015
+#
+#   VS2015  - Microsoft Visual Studio 2015 Professional Edition with Intel ASL
+#   ASL     - Intel ACPI Source Language Compiler
+####################################################################################
+#   VS2015           - Microsoft Visual Studio 2015 Professional Edition
+*_VS2015_*_*_FAMILY               = MSFT
+
+*_VS2015_*_MAKE_PATH              = DEF(VS2015_BIN)\nmake.exe
+*_VS2015_*_MAKE_FLAGS             = /nologo
+*_VS2015_*_RC_PATH                = DEF(WINSDK81_BIN)\rc.exe
+
+*_VS2015_*_SLINK_FLAGS            = /NOLOGO /LTCG
+*_VS2015_*_APP_FLAGS              = /nologo /E /TC
+*_VS2015_*_PP_FLAGS               = /nologo /E /TC /FIAutoGen.h
+*_VS2015_*_VFRPP_FLAGS            = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+
+*_VS2015_*_ASM16_PATH             = DEF(VS2015_BIN)\ml.exe
+
+##################
+# ASL definitions
+##################
+*_VS2015_*_ASL_PATH               = DEF(DEFAULT_WIN_ASL_BIN)
+*_VS2015_*_ASL_FLAGS              = DEF(DEFAULT_WIN_ASL_FLAGS)
+*_VS2015_*_ASL_OUTFLAGS           = DEF(DEFAULT_WIN_ASL_OUTFLAGS)
+*_VS2015_*_ASLCC_FLAGS            = DEF(MSFT_ASLCC_FLAGS)
+*_VS2015_*_ASLPP_FLAGS            = DEF(MSFT_ASLPP_FLAGS)
+*_VS2015_*_ASLDLINK_FLAGS         = DEF(MSFT_ASLDLINK_FLAGS)
+
+##################
+# IA32 definitions
+##################
+*_VS2015_IA32_*_DLL               = DEF(VS2015_DLL)
+
+*_VS2015_IA32_MAKE_PATH           = DEF(VS2015_BIN)\nmake.exe
+*_VS2015_IA32_CC_PATH             = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_VFRPP_PATH          = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_SLINK_PATH          = DEF(VS2015_BIN)\lib.exe
+*_VS2015_IA32_DLINK_PATH          = DEF(VS2015_BIN)\link.exe
+*_VS2015_IA32_APP_PATH            = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_PP_PATH             = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_ASM_PATH            = DEF(VS2015_BIN)\ml.exe
+*_VS2015_IA32_ASLCC_PATH          = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_ASLPP_PATH          = DEF(VS2015_BIN)\cl.exe
+*_VS2015_IA32_ASLDLINK_PATH       = DEF(VS2015_BIN)\link.exe
+
+      *_VS2015_IA32_MAKE_FLAGS    = /nologo
+  DEBUG_VS2015_IA32_CC_FLAGS      = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm
+RELEASE_VS2015_IA32_CC_FLAGS      = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015_IA32_CC_FLAGS        = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm /Od
+
+  DEBUG_VS2015_IA32_ASM_FLAGS     = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+RELEASE_VS2015_IA32_ASM_FLAGS     = /nologo /c /WX /W3 /Cx /coff /Zd
+NOOPT_VS2015_IA32_ASM_FLAGS       = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+
+  DEBUG_VS2015_IA32_NASM_FLAGS    = -Ox -f win32 -g
+RELEASE_VS2015_IA32_NASM_FLAGS    = -Ox -f win32
+NOOPT_VS2015_IA32_NASM_FLAGS      = -O0 -f win32 -g
+
+  DEBUG_VS2015_IA32_DLINK_FLAGS   = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015_IA32_DLINK_FLAGS   = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015_IA32_DLINK_FLAGS     = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# X64 definitions
+##################
+*_VS2015_X64_*_DLL         = DEF(VS2015_DLL)
+
+*_VS2015_X64_CC_PATH       = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_PP_PATH       = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_APP_PATH      = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_VFRPP_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_ASM_PATH      = DEF(VS2015_BINX64)\ml64.exe
+*_VS2015_X64_SLINK_PATH    = DEF(VS2015_BINX64)\lib.exe
+*_VS2015_X64_DLINK_PATH    = DEF(VS2015_BINX64)\link.exe
+*_VS2015_X64_ASLCC_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_ASLPP_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015_X64_ASLDLINK_PATH = DEF(VS2015_BINX64)\link.exe
+
+  DEBUG_VS2015_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm
+RELEASE_VS2015_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015_X64_CC_FLAGS       = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm /Od
+
+  DEBUG_VS2015_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd /Zi
+RELEASE_VS2015_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd
+NOOPT_VS2015_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd /Zi
+
+  DEBUG_VS2015_X64_NASM_FLAGS   = -Ox -f win64 -g
+RELEASE_VS2015_X64_NASM_FLAGS   = -Ox -f win64
+NOOPT_VS2015_X64_NASM_FLAGS     = -O0 -f win64 -g
+
+  DEBUG_VS2015_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# EBC definitions
+##################
+*_VS2015_EBC_*_FAMILY            = INTEL
+*_VS2015_EBC_*_DLL               = DEF(VS2015_DLL)
+
+*_VS2015_EBC_MAKE_PATH           = DEF(VS2015_BIN)\nmake.exe
+*_VS2015_EBC_PP_PATH             = DEF(EBC_BIN)\iec.exe
+*_VS2015_EBC_VFRPP_PATH          = DEF(EBC_BIN)\iec.exe
+*_VS2015_EBC_CC_PATH             = DEF(EBC_BIN)\iec.exe
+*_VS2015_EBC_SLINK_PATH          = DEF(VS2015_BIN)\link.exe
+*_VS2015_EBC_DLINK_PATH          = DEF(VS2015_BIN)\link.exe
+
+*_VS2015_EBC_MAKE_FLAGS          = /nologo
+*_VS2015_EBC_PP_FLAGS            = /nologo /E /TC /FIAutoGen.h
+*_VS2015_EBC_CC_FLAGS            = /nologo /c /WX /W3 /FIAutoGen.h /D$(MODULE_ENTRY_POINT)=$(ARCH_ENTRY_POINT)
+*_VS2015_EBC_VFRPP_FLAGS         = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+*_VS2015_EBC_SLINK_FLAGS         = /lib /NOLOGO /MACHINE:EBC
+*_VS2015_EBC_DLINK_FLAGS         = "C:\Program Files\Intel\EBC\Lib\EbcLib.lib" /NOLOGO /NODEFAULTLIB /MACHINE:EBC /OPT:REF /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /MAP /ALIGN:32 /DRIVER
+
+
+####################################################################################
+#
+# Microsoft Visual Studio 2015
+#
+#   VS2015  - Microsoft Visual Studio 2015 Professional Edition with Microsoft ASL
+#   ASL     - Microsoft ACPI Source Language Compiler (asl.exe)
+####################################################################################
+#   VS2015xASL           - Microsoft Visual Studio 2015 Professional Edition
+*_VS2015xASL_*_*_FAMILY        = MSFT
+
+*_VS2015xASL_*_MAKE_PATH       = DEF(VS2015_BIN)\nmake.exe
+*_VS2015xASL_*_MAKE_FLAG       = /nologo
+*_VS2015xASL_*_RC_PATH         = DEF(WINSDK81_BIN)\rc.exe
+
+*_VS2015xASL_*_SLINK_FLAGS     = /NOLOGO /LTCG
+*_VS2015xASL_*_APP_FLAGS       = /nologo /E /TC
+*_VS2015xASL_*_PP_FLAGS        = /nologo /E /TC /FIAutoGen.h
+*_VS2015xASL_*_VFRPP_FLAGS     = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+
+*_VS2015xASL_*_ASM16_PATH      = DEF(VS2015_BIN)\ml.exe
+
+##################
+# ASL definitions
+##################
+*_VS2015xASL_*_ASL_PATH        = DEF(WIN_ASL_BIN)
+*_VS2015xASL_*_ASL_FLAGS       =
+*_VS2015xASL_*_ASL_OUTFLAGS    = DEF(MS_ASL_OUTFLAGS)
+*_VS2015xASL_*_ASLCC_FLAGS     = DEF(MSFT_ASLCC_FLAGS)
+*_VS2015xASL_*_ASLPP_FLAGS     = DEF(MSFT_ASLPP_FLAGS)
+*_VS2015xASL_*_ASLDLINK_FLAGS  = DEF(MSFT_ASLDLINK_FLAGS)
+
+##################
+# IA32 definitions
+##################
+*_VS2015xASL_IA32_*_DLL        = DEF(VS2015_DLL)
+
+*_VS2015xASL_IA32_MAKE_PATH    = DEF(VS2015_BIN)\nmake.exe
+*_VS2015xASL_IA32_CC_PATH      = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_VFRPP_PATH   = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_SLINK_PATH   = DEF(VS2015_BIN)\lib.exe
+*_VS2015xASL_IA32_DLINK_PATH   = DEF(VS2015_BIN)\link.exe
+*_VS2015xASL_IA32_APP_PATH     = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_PP_PATH      = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_ASM_PATH     = DEF(VS2015_BIN)\ml.exe
+*_VS2015xASL_IA32_ASLCC_PATH    = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_ASLPP_PATH    = DEF(VS2015_BIN)\cl.exe
+*_VS2015xASL_IA32_ASLDLINK_PATH = DEF(VS2015_BIN)\link.exe
+
+      *_VS2015xASL_IA32_MAKE_FLAGS  = /nologo
+  DEBUG_VS2015xASL_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm
+RELEASE_VS2015xASL_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015xASL_IA32_CC_FLAGS      = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm /Od
+
+  DEBUG_VS2015xASL_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+RELEASE_VS2015xASL_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd
+NOOPT_VS2015xASL_IA32_ASM_FLAGS     = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+
+  DEBUG_VS2015xASL_IA32_NASM_FLAGS  = -Ox -f win32 -g
+RELEASE_VS2015xASL_IA32_NASM_FLAGS  = -Ox -f win32
+NOOPT_VS2015xASL_IA32_NASM_FLAGS    = -O0 -f win32 -g
+
+  DEBUG_VS2015xASL_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015xASL_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015xASL_IA32_DLINK_FLAGS   = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# X64 definitions
+##################
+*_VS2015xASL_X64_*_DLL         = DEF(VS2015_DLL)
+
+*_VS2015xASL_X64_CC_PATH       = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_PP_PATH       = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_APP_PATH      = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_VFRPP_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_ASM_PATH      = DEF(VS2015_BINX64)\ml64.exe
+*_VS2015xASL_X64_SLINK_PATH    = DEF(VS2015_BINX64)\lib.exe
+*_VS2015xASL_X64_DLINK_PATH    = DEF(VS2015_BINX64)\link.exe
+*_VS2015xASL_X64_ASLCC_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_ASLPP_PATH    = DEF(VS2015_BINX64)\cl.exe
+*_VS2015xASL_X64_ASLDLINK_PATH = DEF(VS2015_BINX64)\link.exe
+
+  DEBUG_VS2015xASL_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm
+RELEASE_VS2015xASL_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015xASL_X64_CC_FLAGS       = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm /Od
+
+  DEBUG_VS2015xASL_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd /Zi
+RELEASE_VS2015xASL_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd
+NOOPT_VS2015xASL_X64_ASM_FLAGS      = /nologo /c /WX /W3 /Cx /Zd /Zi
+
+  DEBUG_VS2015xASL_X64_NASM_FLAGS   = -Ox -f win64 -g
+RELEASE_VS2015xASL_X64_NASM_FLAGS   = -Ox -f win64
+NOOPT_VS2015xASL_X64_NASM_FLAGS     = -O0 -f win64 -g
+
+  DEBUG_VS2015xASL_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015xASL_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015xASL_X64_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# EBC definitions
+##################
+*_VS2015xASL_EBC_*_FAMILY            = INTEL
+*_VS2015xASL_EBC_*_DLL               = DEF(VS2015_DLL)
+
+*_VS2015xASL_EBC_MAKE_PATH           = DEF(VS2015_BIN)\nmake.exe
+*_VS2015xASL_EBC_PP_PATH             = DEF(EBC_BIN)\iec.exe
+*_VS2015xASL_EBC_VFRPP_PATH          = DEF(EBC_BIN)\iec.exe
+*_VS2015xASL_EBC_CC_PATH             = DEF(EBC_BIN)\iec.exe
+*_VS2015xASL_EBC_SLINK_PATH          = DEF(VS2015_BIN)\link.exe
+*_VS2015xASL_EBC_DLINK_PATH          = DEF(VS2015_BIN)\link.exe
+
+*_VS2015xASL_EBC_MAKE_FLAGS          = /nologo
+*_VS2015xASL_EBC_PP_FLAGS            = /nologo /E /TC /FIAutoGen.h
+*_VS2015xASL_EBC_CC_FLAGS            = /nologo /c /WX /W3 /FIAutoGen.h /D$(MODULE_ENTRY_POINT)=$(ARCH_ENTRY_POINT)
+*_VS2015xASL_EBC_VFRPP_FLAGS         = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+*_VS2015xASL_EBC_SLINK_FLAGS         = /lib /NOLOGO /MACHINE:EBC
+*_VS2015xASL_EBC_DLINK_FLAGS         = "C:\Program Files\Intel\EBC\Lib\EbcLib.lib" /NOLOGO /NODEFAULTLIB /MACHINE:EBC /OPT:REF /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /MAP /ALIGN:32 /DRIVER
+
+
+####################################################################################
+#   VS2015x86       - Microsoft Visual Studio 2015 (x86) professional with Intel ASL
+#   ASL  - Intel ACPI Source Language Compiler (iasl.exe)
+####################################################################################
+#   VS2015x86           - Microsoft Visual Studio 2015 (x86) professional Edition with Intel ASL
+*_VS2015x86_*_*_FAMILY        = MSFT
+
+*_VS2015x86_*_MAKE_PATH       = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86_*_MAKE_FLAG       = /nologo
+*_VS2015x86_*_RC_PATH         = DEF(WINSDK81x86_BIN)\rc.exe
+
+*_VS2015x86_*_MAKE_FLAGS      = /nologo
+*_VS2015x86_*_SLINK_FLAGS     = /NOLOGO /LTCG
+*_VS2015x86_*_APP_FLAGS       = /nologo /E /TC
+*_VS2015x86_*_PP_FLAGS        = /nologo /E /TC /FIAutoGen.h
+*_VS2015x86_*_VFRPP_FLAGS     = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+
+*_VS2015x86_*_ASM16_PATH      = DEF(VS2015x86_BIN)\ml.exe
+
+##################
+# ASL definitions
+##################
+*_VS2015x86_*_ASL_PATH        = DEF(WIN_IASL_BIN)
+*_VS2015x86_*_ASL_FLAGS       = DEF(DEFAULT_WIN_ASL_FLAGS)
+*_VS2015x86_*_ASL_OUTFLAGS    = DEF(DEFAULT_WIN_ASL_OUTFLAGS)
+*_VS2015x86_*_ASLCC_FLAGS     = DEF(MSFT_ASLCC_FLAGS)
+*_VS2015x86_*_ASLPP_FLAGS     = DEF(MSFT_ASLPP_FLAGS)
+*_VS2015x86_*_ASLDLINK_FLAGS  = DEF(MSFT_ASLDLINK_FLAGS)
+
+##################
+# IA32 definitions
+##################
+*_VS2015x86_IA32_*_DLL        = DEF(VS2015x86_DLL)
+
+*_VS2015x86_IA32_MAKE_PATH    = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86_IA32_CC_PATH      = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_VFRPP_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_ASLCC_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_ASLPP_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_SLINK_PATH   = DEF(VS2015x86_BIN)\lib.exe
+*_VS2015x86_IA32_DLINK_PATH   = DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86_IA32_ASLDLINK_PATH= DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86_IA32_APP_PATH     = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_PP_PATH      = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86_IA32_ASM_PATH     = DEF(VS2015x86_BIN)\ml.exe
+
+      *_VS2015x86_IA32_MAKE_FLAGS  = /nologo
+  DEBUG_VS2015x86_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm
+RELEASE_VS2015x86_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015x86_IA32_CC_FLAGS      = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm /Od
+
+  DEBUG_VS2015x86_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+RELEASE_VS2015x86_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd
+NOOPT_VS2015x86_IA32_ASM_FLAGS     = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+
+  DEBUG_VS2015x86_IA32_NASM_FLAGS  = -Ox -f win32 -g
+RELEASE_VS2015x86_IA32_NASM_FLAGS  = -Ox -f win32
+NOOPT_VS2015x86_IA32_NASM_FLAGS    = -O0 -f win32 -g
+
+  DEBUG_VS2015x86_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015x86_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015x86_IA32_DLINK_FLAGS   = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# X64 definitions
+##################
+*_VS2015x86_X64_*_DLL         = DEF(VS2015x86_DLL)
+
+*_VS2015x86_X64_CC_PATH       = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_PP_PATH       = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_APP_PATH      = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_VFRPP_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_ASLCC_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_ASLPP_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86_X64_ASM_PATH      = DEF(VS2015x86_BINX64)\ml64.exe
+*_VS2015x86_X64_SLINK_PATH    = DEF(VS2015x86_BINX64)\lib.exe
+*_VS2015x86_X64_DLINK_PATH    = DEF(VS2015x86_BINX64)\link.exe
+*_VS2015x86_X64_ASLDLINK_PATH = DEF(VS2015x86_BINX64)\link.exe
+
+  DEBUG_VS2015x86_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm
+RELEASE_VS2015x86_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015x86_X64_CC_FLAGS       = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm /Od
+
+  DEBUG_VS2015x86_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd /Zi
+RELEASE_VS2015x86_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd
+NOOPT_VS2015x86_X64_ASM_FLAGS      = /nologo /c /WX /W3 /Cx /Zd /Zi
+
+  DEBUG_VS2015x86_X64_NASM_FLAGS   = -Ox -f win64 -g
+RELEASE_VS2015x86_X64_NASM_FLAGS   = -Ox -f win64
+NOOPT_VS2015x86_X64_NASM_FLAGS     = -O0 -f win64 -g
+
+  DEBUG_VS2015x86_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015x86_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015x86_X64_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# EBC definitions
+##################
+*_VS2015x86_EBC_*_FAMILY            = INTEL
+*_VS2015x86_EBC_*_DLL               = DEF(VS2015x86_DLL)
+
+*_VS2015x86_EBC_MAKE_PATH           = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86_EBC_PP_PATH             = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86_EBC_VFRPP_PATH          = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86_EBC_CC_PATH             = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86_EBC_SLINK_PATH          = DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86_EBC_DLINK_PATH          = DEF(VS2015x86_BIN)\link.exe
+
+*_VS2015x86_EBC_MAKE_FLAGS          = /nologo
+*_VS2015x86_EBC_PP_FLAGS            = /nologo /E /TC /FIAutoGen.h
+*_VS2015x86_EBC_CC_FLAGS            = /nologo /c /WX /W3 /FIAutoGen.h /D$(MODULE_ENTRY_POINT)=$(ARCH_ENTRY_POINT)
+*_VS2015x86_EBC_VFRPP_FLAGS         = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+*_VS2015x86_EBC_SLINK_FLAGS         = /lib /NOLOGO /MACHINE:EBC
+*_VS2015x86_EBC_DLINK_FLAGS         = "C:\Program Files (x86)\Intel\EBC\Lib\EbcLib.lib" /NOLOGO /NODEFAULTLIB /MACHINE:EBC /OPT:REF /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /MAP /ALIGN:32 /DRIVER
+
+
+####################################################################################
+#   VS2015x86xASL     - Microsoft Visual Studio 2015 (x86) professional with Microsoft ASL
+#   ASL  - Microsoft ACPI Source Language Compiler (asl.exe)
+####################################################################################
+*_VS2015x86xASL_*_*_FAMILY        = MSFT
+
+*_VS2015x86xASL_*_MAKE_PATH       = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86xASL_*_MAKE_FLAG       = /nologo
+*_VS2015x86xASL_*_RC_PATH         = DEF(WINSDK81x86_BIN)\rc.exe
+
+*_VS2015x86xASL_*_MAKE_FLAGS      = /nologo
+*_VS2015x86xASL_*_SLINK_FLAGS     = /NOLOGO /LTCG
+*_VS2015x86xASL_*_APP_FLAGS       = /nologo /E /TC
+*_VS2015x86xASL_*_PP_FLAGS        = /nologo /E /TC /FIAutoGen.h
+*_VS2015x86xASL_*_VFRPP_FLAGS     = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+
+*_VS2015x86xASL_*_ASM16_PATH      = DEF(VS2015x86_BIN)\ml.exe
+
+##################
+# ASL definitions
+##################
+*_VS2015x86xASL_*_ASL_PATH        = DEF(WIN_ASL_BIN)
+*_VS2015x86xASL_*_ASL_FLAGS       = DEF(MS_ASL_FLAGS)
+*_VS2015x86xASL_*_ASL_OUTFLAGS    = DEF(MS_ASL_OUTFLAGS)
+*_VS2015x86xASL_*_ASLCC_FLAGS     = DEF(MSFT_ASLCC_FLAGS)
+*_VS2015x86xASL_*_ASLPP_FLAGS     = DEF(MSFT_ASLPP_FLAGS)
+*_VS2015x86xASL_*_ASLDLINK_FLAGS  = DEF(MSFT_ASLDLINK_FLAGS)
+
+##################
+# IA32 definitions
+##################
+*_VS2015x86xASL_IA32_*_DLL        = DEF(VS2015x86_DLL)
+
+*_VS2015x86xASL_IA32_MAKE_PATH    = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86xASL_IA32_CC_PATH      = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_VFRPP_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_ASLCC_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_ASLPP_PATH   = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_SLINK_PATH   = DEF(VS2015x86_BIN)\lib.exe
+*_VS2015x86xASL_IA32_DLINK_PATH   = DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86xASL_IA32_ASLDLINK_PATH= DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86xASL_IA32_APP_PATH     = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_PP_PATH      = DEF(VS2015x86_BIN)\cl.exe
+*_VS2015x86xASL_IA32_ASM_PATH     = DEF(VS2015x86_BIN)\ml.exe
+
+      *_VS2015x86xASL_IA32_MAKE_FLAGS  = /nologo
+  DEBUG_VS2015x86xASL_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm
+RELEASE_VS2015x86xASL_IA32_CC_FLAGS    = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2 /GL /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015x86xASL_IA32_CC_FLAGS      = /nologo /arch:IA32 /c /WX /GS- /W4 /Gs32768 /D UNICODE /FIAutoGen.h /EHs-c- /GR- /GF /Gy /Zi /Gm /Od
+
+  DEBUG_VS2015x86xASL_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+RELEASE_VS2015x86xASL_IA32_ASM_FLAGS   = /nologo /c /WX /W3 /Cx /coff /Zd
+NOOPT_VS2015x86xASL_IA32_ASM_FLAGS     = /nologo /c /WX /W3 /Cx /coff /Zd /Zi
+
+  DEBUG_VS2015x86xASL_IA32_NASM_FLAGS  = -Ox -f win32 -g
+RELEASE_VS2015x86xASL_IA32_NASM_FLAGS  = -Ox -f win32
+NOOPT_VS2015x86xASL_IA32_NASM_FLAGS    = -O0 -f win32 -g
+
+  DEBUG_VS2015x86xASL_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015x86xASL_IA32_DLINK_FLAGS = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015x86xASL_IA32_DLINK_FLAGS   = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /MACHINE:X86 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# X64 definitions
+##################
+*_VS2015x86xASL_X64_*_DLL         = DEF(VS2015x86_DLL)
+
+*_VS2015x86xASL_X64_CC_PATH       = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_PP_PATH       = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_APP_PATH      = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_VFRPP_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_ASLCC_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_ASLPP_PATH    = DEF(VS2015x86_BINX64)\cl.exe
+*_VS2015x86xASL_X64_ASM_PATH      = DEF(VS2015x86_BINX64)\ml64.exe
+*_VS2015x86xASL_X64_SLINK_PATH    = DEF(VS2015x86_BINX64)\lib.exe
+*_VS2015x86xASL_X64_DLINK_PATH    = DEF(VS2015x86_BINX64)\link.exe
+*_VS2015x86xASL_X64_ASLDLINK_PATH = DEF(VS2015x86_BINX64)\link.exe
+
+  DEBUG_VS2015x86xASL_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm
+RELEASE_VS2015x86xASL_X64_CC_FLAGS     = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /O1ib2s /GL /Gy /FIAutoGen.h /EHs-c- /GR- /GF
+NOOPT_VS2015x86xASL_X64_CC_FLAGS       = /nologo /c /WX /GS- /W4 /Gs32768 /D UNICODE /Gy /FIAutoGen.h /EHs-c- /GR- /GF /Zi /Gm /Od
+
+  DEBUG_VS2015x86xASL_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd /Zi
+RELEASE_VS2015x86xASL_X64_ASM_FLAGS    = /nologo /c /WX /W3 /Cx /Zd
+NOOPT_VS2015x86xASL_X64_ASM_FLAGS      = /nologo /c /WX /W3 /Cx /Zd /Zi
+
+  DEBUG_VS2015x86xASL_X64_NASM_FLAGS   = -Ox -f win64 -g
+RELEASE_VS2015x86xASL_X64_NASM_FLAGS   = -Ox -f win64
+NOOPT_VS2015x86xASL_X64_NASM_FLAGS     = -O0 -f win64 -g
+
+  DEBUG_VS2015x86xASL_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+RELEASE_VS2015x86xASL_X64_DLINK_FLAGS  = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /IGNORE:4254 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /MERGE:.rdata=.data
+NOOPT_VS2015x86xASL_X64_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /IGNORE:4001 /OPT:REF /OPT:ICF=10 /MAP /ALIGN:32 /SECTION:.xdata,D /SECTION:.pdata,D /Machine:X64 /LTCG /DLL /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /SAFESEH:NO /BASE:0 /DRIVER /DEBUG
+
+##################
+# EBC definitions
+##################
+*_VS2015x86xASL_EBC_*_FAMILY            = INTEL
+*_VS2015x86xASL_EBC_*_DLL               = DEF(VS2015x86_DLL)
+
+*_VS2015x86xASL_EBC_MAKE_PATH           = DEF(VS2015x86_BIN)\nmake.exe
+*_VS2015x86xASL_EBC_PP_PATH             = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86xASL_EBC_VFRPP_PATH          = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86xASL_EBC_CC_PATH             = DEF(EBC_BINx86)\iec.exe
+*_VS2015x86xASL_EBC_SLINK_PATH          = DEF(VS2015x86_BIN)\link.exe
+*_VS2015x86xASL_EBC_DLINK_PATH          = DEF(VS2015x86_BIN)\link.exe
+
+*_VS2015x86xASL_EBC_MAKE_FLAGS          = /nologo
+*_VS2015x86xASL_EBC_PP_FLAGS            = /nologo /E /TC /FIAutoGen.h
+*_VS2015x86xASL_EBC_CC_FLAGS            = /nologo /c /WX /W3 /FIAutoGen.h /D$(MODULE_ENTRY_POINT)=$(ARCH_ENTRY_POINT)
+*_VS2015x86xASL_EBC_VFRPP_FLAGS         = /nologo /E /TC /DVFRCOMPILE /FI$(MODULE_NAME)StrDefs.h
+*_VS2015x86xASL_EBC_SLINK_FLAGS         = /lib /NOLOGO /MACHINE:EBC
+*_VS2015x86xASL_EBC_DLINK_FLAGS         = "C:\Program Files (x86)\Intel\EBC\Lib\EbcLib.lib" /NOLOGO /NODEFAULTLIB /MACHINE:EBC /OPT:REF /ENTRY:$(IMAGE_ENTRY_POINT) /SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER /MAP /ALIGN:32 /DRIVER
+
+
 ####################################################################################
 #
 # Microsoft Device Driver Kit 3790.1830 (IA-32, X64, Itanium, with Link Time Code Generation)
diff --git a/edksetup.bat b/edksetup.bat
index b63c29916b06..b69bd26857f5 100755
--- a/edksetup.bat
+++ b/edksetup.bat
@@ -1,7 +1,7 @@
 @REM @file
 @REM   Windows batch file to setup a WORKSPACE environment
 @REM
-@REM Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+@REM Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 @REM This program and the accompanying materials
 @REM are licensed and made available under the terms and conditions of the BSD License
 @REM which accompanies this distribution.  The full text of the license may be found at
@@ -63,27 +63,31 @@ if /I not "%1"=="--nt32" goto no_nt32
 @REM and headers to interface with Windows.
 
 if not defined VCINSTALLDIR (
-  if defined VS120COMNTOOLS (
-    call "%VS120COMNTOOLS%\vsvars32.bat"
+  if defined VS140COMNTOOLS (
+    call "%VS140COMNTOOLS%\vsvars32.bat"
   ) else (
-    if defined VS110COMNTOOLS (
-      call "%VS110COMNTOOLS%\vsvars32.bat"
-    ) else (
-      if defined VS100COMNTOOLS (
-        call "%VS100COMNTOOLS%\vsvars32.bat"
+    if defined VS120COMNTOOLS (
+      call "%VS120COMNTOOLS%\vsvars32.bat"
+    ) else (	
+      if defined VS110COMNTOOLS (
+        call "%VS110COMNTOOLS%\vsvars32.bat"
       ) else (
-        if defined VS90COMNTOOLS (
-          call "%VS90COMNTOOLS%\vsvars32.bat"
+        if defined VS100COMNTOOLS (
+          call "%VS100COMNTOOLS%\vsvars32.bat"
         ) else (
-          if defined VS80COMNTOOLS (
-            call "%VS80COMNTOOLS%\vsvars32.bat"
+          if defined VS90COMNTOOLS (
+            call "%VS90COMNTOOLS%\vsvars32.bat"
           ) else (
-            if defined VS71COMNTOOLS (
-              call "%VS71COMNTOOLS%\vsvars32.bat"
+            if defined VS80COMNTOOLS (
+              call "%VS80COMNTOOLS%\vsvars32.bat"
             ) else (
-              echo.
-              echo !!! WARNING !!! Cannot find Visual Studio !!!
-              echo.
+              if defined VS71COMNTOOLS (
+                call "%VS71COMNTOOLS%\vsvars32.bat"
+              ) else (
+                echo.
+                echo !!! WARNING !!! Cannot find Visual Studio !!!
+                echo.
+              )
             )
           )
         )

From ea6947cdfb224d2544cb962f301c4ef0b66b5eb0 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 4 Dec 2015 03:44:11 +0000
Subject: [PATCH 200/525] MdePkg: Disable VS2015 warning C4701 & C4703

C4701 & C4703 may cause false positive issues.
They have been disabled in VS2013.

(Sync patch r19111 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19118 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Ia32/ProcessorBind.h | 6 +++---
 MdePkg/Include/X64/ProcessorBind.h  | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/MdePkg/Include/Ia32/ProcessorBind.h b/MdePkg/Include/Ia32/ProcessorBind.h
index 22f07ca6375e..458f7dd21b93 100644
--- a/MdePkg/Include/Ia32/ProcessorBind.h
+++ b/MdePkg/Include/Ia32/ProcessorBind.h
@@ -93,7 +93,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //
 #pragma warning ( disable : 4206 )
 
-#if _MSC_VER == 1800
+#if _MSC_VER == 1800 || _MSC_VER == 1900
 
 //
 // Disable these warnings for VS2013.
@@ -101,13 +101,13 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 //
 // This warning is for potentially uninitialized local variable, and it may cause false 
-// positive issues in VS2013 build
+// 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 build
+// false positive issues in VS2013 and VS2015 build
 //
 #pragma warning ( disable : 4703 )
   
diff --git a/MdePkg/Include/X64/ProcessorBind.h b/MdePkg/Include/X64/ProcessorBind.h
index 81dbe188ca49..705104af062a 100644
--- a/MdePkg/Include/X64/ProcessorBind.h
+++ b/MdePkg/Include/X64/ProcessorBind.h
@@ -94,7 +94,7 @@
 //
 #pragma warning ( disable : 4206 )
 
-#if _MSC_VER == 1800
+#if _MSC_VER == 1800 || _MSC_VER == 1900
 
 //
 // Disable these warnings for VS2013.
@@ -102,13 +102,13 @@
 
 //
 // This warning is for potentially uninitialized local variable, and it may cause false 
-// positive issues in VS2013 build
+// 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 build
+// false positive issues in VS2013 and VS2015 build
 //
 #pragma warning ( disable : 4703 )
   

From 54d3c76fc0e8681c01c9aa546a3b63ccf78bbfa6 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 4 Dec 2015 03:44:39 +0000
Subject: [PATCH 201/525] MdeModulePkg: Fix VS2015 warning C4459 in
 DriverSampleDxe

warning C4459: declaration of 'PrivateData' hides global declaration.
Update DriverSampleDxe to rename global variable name to be different.

(Sync patch r19112 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19119 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Universal/DriverSampleDxe/DriverSample.c  | 72 +++++++++----------
 1 file changed, 36 insertions(+), 36 deletions(-)

diff --git a/MdeModulePkg/Universal/DriverSampleDxe/DriverSample.c b/MdeModulePkg/Universal/DriverSampleDxe/DriverSample.c
index 2f77d39e52db..8ec1d4e6e81c 100644
--- a/MdeModulePkg/Universal/DriverSampleDxe/DriverSample.c
+++ b/MdeModulePkg/Universal/DriverSampleDxe/DriverSample.c
@@ -21,7 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 CHAR16     VariableName[] = L"MyIfrNVData";
 CHAR16     MyEfiVar[] = L"MyEfiVar";
 EFI_HANDLE                      DriverHandle[2] = {NULL, NULL};
-DRIVER_SAMPLE_PRIVATE_DATA      *PrivateData = NULL;
+DRIVER_SAMPLE_PRIVATE_DATA      *mPrivateData = NULL;
 EFI_EVENT                       mEvent;
 
 HII_VENDOR_DEVICE_PATH  mHiiVendorDevicePath0 = {
@@ -1895,17 +1895,17 @@ DriverSampleInit (
   //
   // Initialize driver private data
   //
-  PrivateData = AllocateZeroPool (sizeof (DRIVER_SAMPLE_PRIVATE_DATA));
-  if (PrivateData == NULL) {
+  mPrivateData = AllocateZeroPool (sizeof (DRIVER_SAMPLE_PRIVATE_DATA));
+  if (mPrivateData == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
 
-  PrivateData->Signature = DRIVER_SAMPLE_PRIVATE_SIGNATURE;
+  mPrivateData->Signature = DRIVER_SAMPLE_PRIVATE_SIGNATURE;
 
-  PrivateData->ConfigAccess.ExtractConfig = ExtractConfig;
-  PrivateData->ConfigAccess.RouteConfig = RouteConfig;
-  PrivateData->ConfigAccess.Callback = DriverCallback;
-  PrivateData->PasswordState = BROWSER_STATE_VALIDATE_PASSWORD;
+  mPrivateData->ConfigAccess.ExtractConfig = ExtractConfig;
+  mPrivateData->ConfigAccess.RouteConfig = RouteConfig;
+  mPrivateData->ConfigAccess.Callback = DriverCallback;
+  mPrivateData->PasswordState = BROWSER_STATE_VALIDATE_PASSWORD;
 
   //
   // Locate Hii Database protocol
@@ -1914,7 +1914,7 @@ DriverSampleInit (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-  PrivateData->HiiDatabase = HiiDatabase;
+  mPrivateData->HiiDatabase = HiiDatabase;
 
   //
   // Locate HiiString protocol
@@ -1923,7 +1923,7 @@ DriverSampleInit (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-  PrivateData->HiiString = HiiString;
+  mPrivateData->HiiString = HiiString;
 
   //
   // Locate Formbrowser2 protocol
@@ -1932,7 +1932,7 @@ DriverSampleInit (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-  PrivateData->FormBrowser2 = FormBrowser2;
+  mPrivateData->FormBrowser2 = FormBrowser2;
 
   //
   // Locate ConfigRouting protocol
@@ -1941,7 +1941,7 @@ DriverSampleInit (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-  PrivateData->HiiConfigRouting = HiiConfigRouting;
+  mPrivateData->HiiConfigRouting = HiiConfigRouting;
 
   //
   // Locate keyword handler protocol
@@ -1950,19 +1950,19 @@ DriverSampleInit (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-  PrivateData->HiiKeywordHandler = HiiKeywordHandler;
+  mPrivateData->HiiKeywordHandler = HiiKeywordHandler;
 
   Status = gBS->InstallMultipleProtocolInterfaces (
                   &DriverHandle[0],
                   &gEfiDevicePathProtocolGuid,
                   &mHiiVendorDevicePath0,
                   &gEfiHiiConfigAccessProtocolGuid,
-                  &PrivateData->ConfigAccess,
+                  &mPrivateData->ConfigAccess,
                   NULL
                   );
   ASSERT_EFI_ERROR (Status);
 
-  PrivateData->DriverHandle[0] = DriverHandle[0];
+  mPrivateData->DriverHandle[0] = DriverHandle[0];
 
   //
   // Publish our HII data
@@ -1978,7 +1978,7 @@ DriverSampleInit (
     return EFI_OUT_OF_RESOURCES;
   }
 
-  PrivateData->HiiHandle[0] = HiiHandle[0];
+  mPrivateData->HiiHandle[0] = HiiHandle[0];
 
   //
   // Publish another Fromset
@@ -1988,12 +1988,12 @@ DriverSampleInit (
                   &gEfiDevicePathProtocolGuid,
                   &mHiiVendorDevicePath1,
                   &gEfiHiiConfigAccessProtocolGuid,
-                  &PrivateData->ConfigAccess,
+                  &mPrivateData->ConfigAccess,
                   NULL
                   );
   ASSERT_EFI_ERROR (Status);
 
-  PrivateData->DriverHandle[1] = DriverHandle[1];
+  mPrivateData->DriverHandle[1] = DriverHandle[1];
 
   HiiHandle[1] = HiiAddPackages (
                    &gDriverSampleInventoryGuid,
@@ -2007,7 +2007,7 @@ DriverSampleInit (
     return EFI_OUT_OF_RESOURCES;
   }
 
-  PrivateData->HiiHandle[1] = HiiHandle[1];
+  mPrivateData->HiiHandle[1] = HiiHandle[1];
 
   //
   // Update the device path string.
@@ -2037,14 +2037,14 @@ DriverSampleInit (
   //
   // Initialize Name/Value name String ID
   //
-  PrivateData->NameStringId[0] = STR_NAME_VALUE_VAR_NAME0;
-  PrivateData->NameStringId[1] = STR_NAME_VALUE_VAR_NAME1;
-  PrivateData->NameStringId[2] = STR_NAME_VALUE_VAR_NAME2;
+  mPrivateData->NameStringId[0] = STR_NAME_VALUE_VAR_NAME0;
+  mPrivateData->NameStringId[1] = STR_NAME_VALUE_VAR_NAME1;
+  mPrivateData->NameStringId[2] = STR_NAME_VALUE_VAR_NAME2;
 
   //
   // Initialize configuration data
   //
-  Configuration = &PrivateData->Configuration;
+  Configuration = &mPrivateData->Configuration;
   ZeroMem (Configuration, sizeof (DRIVER_SAMPLE_CONFIGURATION));
 
   //
@@ -2109,7 +2109,7 @@ DriverSampleInit (
   //
   // Initialize efi varstore configuration data
   //
-  VarStoreConfig = &PrivateData->VarStoreConfig;
+  VarStoreConfig = &mPrivateData->VarStoreConfig;
   ZeroMem (VarStoreConfig, sizeof (MY_EFI_VARSTORE_DATA));
 
   ConfigRequestHdr = HiiConstructConfigHdr (&gDriverSampleFormSetGuid, MyEfiVar, DriverHandle[0]);
@@ -2181,11 +2181,11 @@ DriverSampleInit (
     // Register the default HotKey F9 and F10 again.
     //
     HotKey.ScanCode   = SCAN_F10;
-    NewString         = HiiGetString (PrivateData->HiiHandle[0], STRING_TOKEN (FUNCTION_TEN_STRING), NULL);
+    NewString         = HiiGetString (mPrivateData->HiiHandle[0], STRING_TOKEN (FUNCTION_TEN_STRING), NULL);
     ASSERT (NewString != NULL);
     FormBrowserEx->RegisterHotKey (&HotKey, BROWSER_ACTION_SUBMIT, 0, NewString);
     HotKey.ScanCode   = SCAN_F9;
-    NewString         = HiiGetString (PrivateData->HiiHandle[0], STRING_TOKEN (FUNCTION_NINE_STRING), NULL);
+    NewString         = HiiGetString (mPrivateData->HiiHandle[0], STRING_TOKEN (FUNCTION_NINE_STRING), NULL);
     ASSERT (NewString != NULL);
     FormBrowserEx->RegisterHotKey (&HotKey, BROWSER_ACTION_DEFAULT, EFI_HII_DEFAULT_CLASS_STANDARD, NewString);
   }
@@ -2237,7 +2237,7 @@ DriverSampleUnload (
 {
   UINTN Index;
 
-  ASSERT (PrivateData != NULL);
+  ASSERT (mPrivateData != NULL);
 
   if (DriverHandle[0] != NULL) {
     gBS->UninstallMultipleProtocolInterfaces (
@@ -2245,7 +2245,7 @@ DriverSampleUnload (
             &gEfiDevicePathProtocolGuid,
             &mHiiVendorDevicePath0,
             &gEfiHiiConfigAccessProtocolGuid,
-            &PrivateData->ConfigAccess,
+            &mPrivateData->ConfigAccess,
             NULL
            );
     DriverHandle[0] = NULL;
@@ -2261,21 +2261,21 @@ DriverSampleUnload (
     DriverHandle[1] = NULL;
   }
 
-  if (PrivateData->HiiHandle[0] != NULL) {
-    HiiRemovePackages (PrivateData->HiiHandle[0]);
+  if (mPrivateData->HiiHandle[0] != NULL) {
+    HiiRemovePackages (mPrivateData->HiiHandle[0]);
   }
 
-  if (PrivateData->HiiHandle[1] != NULL) {
-    HiiRemovePackages (PrivateData->HiiHandle[1]);
+  if (mPrivateData->HiiHandle[1] != NULL) {
+    HiiRemovePackages (mPrivateData->HiiHandle[1]);
   }
 
   for (Index = 0; Index < NAME_VALUE_NAME_NUMBER; Index++) {
-    if (PrivateData->NameValueName[Index] != NULL) {
-      FreePool (PrivateData->NameValueName[Index]);
+    if (mPrivateData->NameValueName[Index] != NULL) {
+      FreePool (mPrivateData->NameValueName[Index]);
     }
   }
-  FreePool (PrivateData);
-  PrivateData = NULL;
+  FreePool (mPrivateData);
+  mPrivateData = NULL;
 
   gBS->CloseEvent (mEvent);
 

From 14a68bd79cb3a4d2237c56391a90fdf08ac68c2b Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 4 Dec 2015 03:45:20 +0000
Subject: [PATCH 202/525] CryptoPkg: Disable VS2015 warning C4311 in OpensslLib

Warning C4311: pointer truncation from 'type' to 'type'.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19120 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/OpensslLib/OpensslLib.inf | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 28d3aec00e2a..aaf0a2982e10 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -891,9 +891,10 @@
   # C4305: truncation from type1 to type2 of smaller size
   # C4306: conversion from type1 to type2 of greater size
   # C4702: Potentially uninitialized local variable name used
+  # C4311: pointer truncation from 'type' to 'type'
   #
   MSFT:*_*_IA32_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DTHIRTY_TWO_BIT /wd4244 /wd4701 /wd4702 /wd4706
-  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DSIXTY_FOUR_BIT /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
+  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DSIXTY_FOUR_BIT /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706 /wd4311
   MSFT:*_*_IPF_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DSIXTY_FOUR_BIT /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
 
   INTEL:*_*_IA32_CC_FLAGS   = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w -DTHIRTY_TWO_BIT

From 174448723f38513b798ea63241de9d4332528c62 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 4 Dec 2015 03:46:05 +0000
Subject: [PATCH 203/525] OvmfPkg: Fix VS2015 warning C4459 in XenBusDxe

warning C4459: declaration of 'xs' hides global declaration.
Update code to rename local variable xs to xsp to be different.

(Sync patch r19116 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
Acked-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19121 6f19259b-4bc3-4df7-8a09-765794883524
---
 OvmfPkg/XenBusDxe/XenStore.c | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/OvmfPkg/XenBusDxe/XenStore.c b/OvmfPkg/XenBusDxe/XenStore.c
index 9850f1e644fc..61976f91f11b 100644
--- a/OvmfPkg/XenBusDxe/XenStore.c
+++ b/OvmfPkg/XenBusDxe/XenStore.c
@@ -992,9 +992,9 @@ NotifyEventChannelCheckForEvent (
   IN VOID *Context
   )
 {
-  XENSTORE_PRIVATE *xs;
-  xs = (XENSTORE_PRIVATE *)Context;
-  if (TestAndClearBit (xs->EventChannel, xs->Dev->SharedInfo->evtchn_pending)) {
+  XENSTORE_PRIVATE *xsp;
+  xsp = (XENSTORE_PRIVATE *)Context;
+  if (TestAndClearBit (xsp->EventChannel, xsp->Dev->SharedInfo->evtchn_pending)) {
     gBS->SignalEvent (Event);
   }
 }
@@ -1007,12 +1007,12 @@ NotifyEventChannelCheckForEvent (
 STATIC
 EFI_STATUS
 XenStoreInitComms (
-  XENSTORE_PRIVATE *xs
+  XENSTORE_PRIVATE *xsp
   )
 {
   EFI_STATUS Status;
   EFI_EVENT TimerEvent;
-  struct xenstore_domain_interface *XenStore = xs->XenStore;
+  struct xenstore_domain_interface *XenStore = xsp->XenStore;
 
   Status = gBS->CreateEvent (EVT_TIMER, 0, NULL, NULL, &TimerEvent);
   Status = gBS->SetTimer (TimerEvent, TimerRelative,
@@ -1029,8 +1029,8 @@ XenStoreInitComms (
   gBS->CloseEvent (TimerEvent);
 
   Status = gBS->CreateEvent (EVT_NOTIFY_WAIT, TPL_NOTIFY,
-                             NotifyEventChannelCheckForEvent, xs,
-                             &xs->EventChannelEvent);
+                             NotifyEventChannelCheckForEvent, xsp,
+                             &xsp->EventChannelEvent);
   ASSERT_EFI_ERROR (Status);
 
   return Status;

From a1395ce447423d0d3aa74fce5e790081caebb6c4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 7 Dec 2015 02:21:29 +0000
Subject: [PATCH 204/525] Move CommunicationBuffer from stack to global
 variable.

We had put communication buffer to Runtime memory,
so that SMI handler can know it is not used by OS.

(Sync patch r18949 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19126 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/PiSmmCore/PiSmmIpl.c | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/MdeModulePkg/Core/PiSmmCore/PiSmmIpl.c b/MdeModulePkg/Core/PiSmmCore/PiSmmIpl.c
index c534ee37011a..50c3b34dfd34 100644
--- a/MdeModulePkg/Core/PiSmmCore/PiSmmIpl.c
+++ b/MdeModulePkg/Core/PiSmmCore/PiSmmIpl.c
@@ -246,6 +246,8 @@ BOOLEAN                    mSmmLocked = FALSE;
 EFI_PHYSICAL_ADDRESS       mSmramCacheBase;
 UINT64                     mSmramCacheSize;
 
+EFI_SMM_COMMUNICATE_HEADER mCommunicateHeader;
+
 //
 // Table of Protocol notification and GUIDed Event notifications that the SMM IPL requires
 //
@@ -538,21 +540,20 @@ SmmIplGuidedEventNotify (
   IN VOID       *Context
   )
 {
-  EFI_SMM_COMMUNICATE_HEADER  CommunicateHeader;
   UINTN                       Size;
 
   //
   // Use Guid to initialize EFI_SMM_COMMUNICATE_HEADER structure 
   //
-  CopyGuid (&CommunicateHeader.HeaderGuid, (EFI_GUID *)Context);
-  CommunicateHeader.MessageLength = 1;
-  CommunicateHeader.Data[0] = 0;
+  CopyGuid (&mCommunicateHeader.HeaderGuid, (EFI_GUID *)Context);
+  mCommunicateHeader.MessageLength = 1;
+  mCommunicateHeader.Data[0] = 0;
 
   //
   // Generate the Software SMI and return the result
   //
-  Size = sizeof (CommunicateHeader);
-  SmmCommunicationCommunicate (&mSmmCommunication, &CommunicateHeader, &Size);
+  Size = sizeof (mCommunicateHeader);
+  SmmCommunicationCommunicate (&mSmmCommunication, &mCommunicateHeader, &Size);
 }
 
 /**
@@ -569,7 +570,6 @@ SmmIplDxeDispatchEventNotify (
   IN VOID       *Context
   )
 {
-  EFI_SMM_COMMUNICATE_HEADER  CommunicateHeader;
   UINTN                       Size;
   EFI_STATUS                  Status;
 
@@ -582,20 +582,20 @@ SmmIplDxeDispatchEventNotify (
     // Clear the buffer passed into the Software SMI.  This buffer will return
     // the status of the SMM Core Dispatcher.
     //
-    CopyGuid (&CommunicateHeader.HeaderGuid, (EFI_GUID *)Context);
-    CommunicateHeader.MessageLength = 1;
-    CommunicateHeader.Data[0] = 0;
+    CopyGuid (&mCommunicateHeader.HeaderGuid, (EFI_GUID *)Context);
+    mCommunicateHeader.MessageLength = 1;
+    mCommunicateHeader.Data[0] = 0;
 
     //
     // Generate the Software SMI and return the result
     //
-    Size = sizeof (CommunicateHeader);
-    SmmCommunicationCommunicate (&mSmmCommunication, &CommunicateHeader, &Size);
+    Size = sizeof (mCommunicateHeader);
+    SmmCommunicationCommunicate (&mSmmCommunication, &mCommunicateHeader, &Size);
     
     //
     // Return if there is no request to restart the SMM Core Dispatcher
     //
-    if (CommunicateHeader.Data[0] != COMM_BUFFER_SMM_DISPATCH_RESTART) {
+    if (mCommunicateHeader.Data[0] != COMM_BUFFER_SMM_DISPATCH_RESTART) {
       return;
     }
       

From cc08065caea36f373f513f60cd800464e1955b5f Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Tue, 8 Dec 2015 08:39:21 +0000
Subject: [PATCH 205/525] UefiCpuPkg/CpuMpPei: Add missing point at function
 header

(Sync patch r19165 from main trunk.)

Cc: Qiu Shumin <shumin.qiu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19167 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index ab1260d0451b..2e6e7611a261 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -142,7 +142,7 @@ GetMpHobData (
 }
 
 /**
-  Save the volatile registers required to be restored following INIT IPI
+  Save the volatile registers required to be restored following INIT IPI.
   
   @param  VolatileRegisters    Returns buffer saved the volatile resisters
 **/
@@ -173,7 +173,7 @@ SaveVolatileRegisters (
 }
 
 /**
-  Restore the volatile registers following INIT IPI
+  Restore the volatile registers following INIT IPI.
   
   @param  VolatileRegisters   Pointer to volatile resisters
   @param  IsRestoreDr         TRUE:  Restore DRx if supported

From e5ece6913432c3dfdb842035021d4521ecd1836c Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Thu, 10 Dec 2015 07:15:21 +0000
Subject: [PATCH 206/525] CryptoPkg: Add one new API (Pkcs7GetCertificatesList)
 for certs retrieving.

Adding one new API (Pkcs7GetCertificatesList) to retrieve and sort all
embedded certificates from Pkcs7 signedData. This new API will provide
the support for UEFI 2.5 Secure-Boot AuditMode feature.

(Sync patch r18729 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Ting Ye <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19184 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Include/Library/BaseCryptLib.h      |  30 ++
 .../BaseCryptLib/Pk/CryptPkcs7Verify.c        | 288 ++++++++++++++++++
 .../BaseCryptLib/Pk/CryptPkcs7VerifyNull.c    |  34 +++
 .../Pk/CryptPkcs7VerifyNull.c                 |  34 +++
 4 files changed, 386 insertions(+)

diff --git a/CryptoPkg/Include/Library/BaseCryptLib.h b/CryptoPkg/Include/Library/BaseCryptLib.h
index 95b75c92b8f5..390e302f98c8 100644
--- a/CryptoPkg/Include/Library/BaseCryptLib.h
+++ b/CryptoPkg/Include/Library/BaseCryptLib.h
@@ -1984,6 +1984,36 @@ Pkcs7FreeSigners (
   IN  UINT8        *Certs
   );
 
+/**
+  Retrieves all embedded certificates from PKCS#7 signed data as described in "PKCS #7:
+  Cryptographic Message Syntax Standard", and outputs two certificate lists chained and
+  unchained to the signer's certificates.
+  The input signed data could be wrapped in a ContentInfo structure.
+
+  @param[in]  P7Data            Pointer to the PKCS#7 message.
+  @param[in]  P7Length          Length of the PKCS#7 message in bytes.
+  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+                                certificate. It's caller's responsiblity to free the buffer.
+  @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
+  @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
+                                responsiblity to free the buffer.
+  @param[out] UnchainLength     Length of the unchained certificates list buffer in bytes.
+
+  @retval  TRUE         The operation is finished successfully.
+  @retval  FALSE        Error occurs during the operation.
+
+**/
+BOOLEAN
+EFIAPI
+Pkcs7GetCertificatesList (
+  IN  CONST UINT8  *P7Data,
+  IN  UINTN        P7Length,
+  OUT UINT8        **SignerChainCerts,
+  OUT UINTN        *ChainLength,
+  OUT UINT8        **UnchainCerts,
+  OUT UINTN        *UnchainLength
+  );
+
 /**
   Creates a PKCS#7 signedData as described in "PKCS #7: Cryptographic Message
   Syntax Standard, version 1.5". This interface is only intended to be used for
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
index d0b0c838b83a..6c91dea58151 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
@@ -508,6 +508,294 @@ Pkcs7FreeSigners (
   free (Certs);
 }
 
+/**
+  Retrieves all embedded certificates from PKCS#7 signed data as described in "PKCS #7:
+  Cryptographic Message Syntax Standard", and outputs two certificate lists chained and
+  unchained to the signer's certificates.
+  The input signed data could be wrapped in a ContentInfo structure.
+
+  @param[in]  P7Data            Pointer to the PKCS#7 message.
+  @param[in]  P7Length          Length of the PKCS#7 message in bytes.
+  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+                                certificate. It's caller's responsiblity to free the buffer.
+  @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
+  @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
+                                responsiblity to free the buffer.
+  @param[out] UnchainLength     Length of the unchained certificates list buffer in bytes.
+
+  @retval  TRUE         The operation is finished successfully.
+  @retval  FALSE        Error occurs during the operation.
+
+**/
+BOOLEAN
+EFIAPI
+Pkcs7GetCertificatesList (
+  IN  CONST UINT8  *P7Data,
+  IN  UINTN        P7Length,
+  OUT UINT8        **SignerChainCerts,
+  OUT UINTN        *ChainLength,
+  OUT UINT8        **UnchainCerts,
+  OUT UINTN        *UnchainLength
+  )
+{
+  BOOLEAN          Status;
+  UINT8            *NewP7Data;
+  UINTN            NewP7Length;
+  BOOLEAN          Wrapped;
+  UINT8            Index;
+  PKCS7            *Pkcs7;
+  X509_STORE_CTX   CertCtx;
+  STACK_OF(X509)   *Signers;
+  X509             *Signer;
+  X509             *Cert;
+  X509             *TempCert;
+  X509             *Issuer;
+  UINT8            *CertBuf;
+  UINT8            *OldBuf;
+  UINTN            BufferSize;
+  UINTN            OldSize;
+  UINT8            *SingleCert;
+  UINTN            CertSize;
+
+  //
+  // Initializations
+  //
+  Status         = FALSE;
+  NewP7Data      = NULL;
+  Pkcs7          = NULL;
+  Cert           = NULL;
+  TempCert       = NULL;
+  SingleCert     = NULL;
+  CertBuf        = NULL;
+  OldBuf         = NULL;
+  Signers        = NULL;
+
+  //
+  // Parameter Checking
+  //
+  if ((P7Data == NULL) || (SignerChainCerts == NULL) || (ChainLength == NULL) ||
+      (UnchainCerts == NULL) || (UnchainLength == NULL) || (P7Length > INT_MAX)) {
+    return Status;
+  }
+
+  *SignerChainCerts = NULL;
+  *ChainLength      = 0;
+  *UnchainCerts     = NULL;
+  *UnchainLength    = 0;
+
+  //
+  // Construct a new PKCS#7 data wrapping with ContentInfo structure if needed.
+  //
+  Status = WrapPkcs7Data (P7Data, P7Length, &Wrapped, &NewP7Data, &NewP7Length);
+  if (!Status || (NewP7Length > INT_MAX)) {
+    goto _Error;
+  }
+
+  //
+  // Decodes PKCS#7 SignedData
+  //
+  Pkcs7 = d2i_PKCS7 (NULL, (const unsigned char **) &NewP7Data, (int) NewP7Length);
+  if ((Pkcs7 == NULL) || (!PKCS7_type_is_signed (Pkcs7))) {
+    goto _Error;
+  }
+
+  //
+  // Obtains Signer's Certificate from PKCS#7 data
+  // NOTE: Only one signer case will be handled in this function, which means SignerInfos
+  //       should include only one singer's certificate.
+  //
+  Signers = PKCS7_get0_signers (Pkcs7, NULL, PKCS7_BINARY);
+  if ((Signers == NULL) || (sk_X509_num (Signers) != 1)) {
+    goto _Error;
+  }
+  Signer = sk_X509_value (Signers, 0);
+
+  if (!X509_STORE_CTX_init (&CertCtx, NULL, Signer, Pkcs7->d.sign->cert)) {
+    goto _Error;
+  }
+  //
+  // Initialize Chained & Untrusted stack
+  //
+  if (CertCtx.chain == NULL) {
+    if (((CertCtx.chain = sk_X509_new_null ()) == NULL) ||
+        (!sk_X509_push (CertCtx.chain, CertCtx.cert))) {
+      goto _Error;
+    }
+  }
+  sk_X509_delete_ptr (CertCtx.untrusted, Signer);
+
+  //
+  // Build certificates stack chained from Signer's certificate.
+  //
+  Cert = Signer;
+  for (; ;) {
+    //
+    // Self-Issue checking
+    //
+    if (CertCtx.check_issued (&CertCtx, Cert, Cert)) {
+      break;
+    }
+
+    //
+    // Found the issuer of the current certificate
+    //
+    if (CertCtx.untrusted != NULL) {
+      Issuer = NULL;
+      for (Index = 0; Index < sk_X509_num (CertCtx.untrusted); Index++) {
+        TempCert = sk_X509_value (CertCtx.untrusted, Index);
+        if (CertCtx.check_issued (&CertCtx, Cert, TempCert)) {
+          Issuer = TempCert;
+          break;
+        }
+      }
+      if (Issuer != NULL) {
+        if (!sk_X509_push (CertCtx.chain, Issuer)) {
+          goto _Error;
+        }
+        sk_X509_delete_ptr (CertCtx.untrusted, Issuer);
+
+        Cert = Issuer;
+        continue;
+      }
+    }
+
+    break;
+  }
+
+  //
+  // Converts Chained and Untrusted Certificate to Certificate Buffer in following format:
+  //      UINT8  CertNumber;
+  //      UINT32 Cert1Length;
+  //      UINT8  Cert1[];
+  //      UINT32 Cert2Length;
+  //      UINT8  Cert2[];
+  //      ...
+  //      UINT32 CertnLength;
+  //      UINT8  Certn[];
+  //
+
+  if (CertCtx.chain != NULL) {
+    BufferSize = sizeof (UINT8);
+    OldSize    = BufferSize;
+    CertBuf    = NULL;
+
+    for (Index = 0; ; Index++) {
+      Status = X509PopCertificate (CertCtx.chain, &SingleCert, &CertSize);
+      if (!Status) {
+        break;
+      }
+
+      OldSize    = BufferSize;
+      OldBuf     = CertBuf;
+      BufferSize = OldSize + CertSize + sizeof (UINT32);
+      CertBuf    = malloc (BufferSize);
+
+      if (CertBuf == NULL) {
+        Status = FALSE;
+        goto _Error;
+      }
+      if (OldBuf != NULL) {
+        CopyMem (CertBuf, OldBuf, OldSize);
+        free (OldBuf);
+        OldBuf = NULL;
+      }
+
+      WriteUnaligned32 ((UINT32 *) (CertBuf + OldSize), (UINT32) CertSize);
+      CopyMem (CertBuf + OldSize + sizeof (UINT32), SingleCert, CertSize);
+
+      free (SingleCert);
+      SingleCert = NULL;
+    }
+
+    if (CertBuf != NULL) {
+      //
+      // Update CertNumber.
+      //
+      CertBuf[0] = Index;
+
+      *SignerChainCerts = CertBuf;
+      *ChainLength      = BufferSize;
+    }
+  }
+
+  if (CertCtx.untrusted != NULL) {
+    BufferSize = sizeof (UINT8);
+    OldSize    = BufferSize;
+    CertBuf    = NULL;
+
+    for (Index = 0; ; Index++) {
+      Status = X509PopCertificate (CertCtx.untrusted, &SingleCert, &CertSize);
+      if (!Status) {
+        break;
+      }
+
+      OldSize    = BufferSize;
+      OldBuf     = CertBuf;
+      BufferSize = OldSize + CertSize + sizeof (UINT32);
+      CertBuf    = malloc (BufferSize);
+
+      if (CertBuf == NULL) {
+        Status = FALSE;
+        goto _Error;
+      }
+      if (OldBuf != NULL) {
+        CopyMem (CertBuf, OldBuf, OldSize);
+        free (OldBuf);
+        OldBuf = NULL;
+      }
+
+      WriteUnaligned32 ((UINT32 *) (CertBuf + OldSize), (UINT32) CertSize);
+      CopyMem (CertBuf + OldSize + sizeof (UINT32), SingleCert, CertSize);
+
+      free (SingleCert);
+      SingleCert = NULL;
+    }
+
+    if (CertBuf != NULL) {
+      //
+      // Update CertNumber.
+      //
+      CertBuf[0] = Index;
+
+      *UnchainCerts  = CertBuf;
+      *UnchainLength = BufferSize;
+    }
+  }
+
+  Status = TRUE;
+
+_Error:
+  //
+  // Release Resources.
+  //
+  if (!Wrapped && (NewP7Data != NULL)) {
+    free (NewP7Data);
+  }
+
+  if (Pkcs7 != NULL) {
+    PKCS7_free (Pkcs7);
+  }
+  sk_X509_free (Signers);
+
+  X509_STORE_CTX_cleanup (&CertCtx);
+
+  if (SingleCert != NULL) {
+    free (SingleCert);
+  }
+
+  if (OldBuf != NULL) {
+    free (OldBuf);
+  }
+
+  if (!Status && (CertBuf != NULL)) {
+    free (CertBuf);
+    *SignerChainCerts = NULL;
+    *UnchainCerts     = NULL;
+  }
+
+  return Status;
+}
+
 /**
   Verifies the validility of a PKCS#7 signed data as described in "PKCS #7:
   Cryptographic Message Syntax Standard". The input signed data could be wrapped
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
index 09b92c7f159b..b9affe427503 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
@@ -66,6 +66,40 @@ Pkcs7FreeSigners (
   ASSERT (FALSE);
 }
 
+/**
+  Retrieves all embedded certificates from PKCS#7 signed data as described in "PKCS #7:
+  Cryptographic Message Syntax Standard", and outputs two certificate lists chained and
+  unchained to the signer's certificates.
+  The input signed data could be wrapped in a ContentInfo structure.
+
+  @param[in]  P7Data            Pointer to the PKCS#7 message.
+  @param[in]  P7Length          Length of the PKCS#7 message in bytes.
+  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+                                certificate. It's caller's responsiblity to free the buffer.
+  @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
+  @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
+                                responsiblity to free the buffer.
+  @param[out] UnchainLength     Length of the unchained certificates list buffer in bytes.
+
+  @retval  TRUE         The operation is finished successfully.
+  @retval  FALSE        Error occurs during the operation.
+
+**/
+BOOLEAN
+EFIAPI
+Pkcs7GetCertificatesList (
+  IN  CONST UINT8  *P7Data,
+  IN  UINTN        P7Length,
+  OUT UINT8        **SignerChainCerts,
+  OUT UINTN        *ChainLength,
+  OUT UINT8        **UnchainCerts,
+  OUT UINTN        *UnchainLength
+  )
+{
+  ASSERT (FALSE);
+  return FALSE;
+}
+
 /**
   Verifies the validility of a PKCS#7 signed data as described in "PKCS #7:
   Cryptographic Message Syntax Standard". The input signed data could be wrapped
diff --git a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
index 09b92c7f159b..b9affe427503 100644
--- a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
+++ b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
@@ -66,6 +66,40 @@ Pkcs7FreeSigners (
   ASSERT (FALSE);
 }
 
+/**
+  Retrieves all embedded certificates from PKCS#7 signed data as described in "PKCS #7:
+  Cryptographic Message Syntax Standard", and outputs two certificate lists chained and
+  unchained to the signer's certificates.
+  The input signed data could be wrapped in a ContentInfo structure.
+
+  @param[in]  P7Data            Pointer to the PKCS#7 message.
+  @param[in]  P7Length          Length of the PKCS#7 message in bytes.
+  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+                                certificate. It's caller's responsiblity to free the buffer.
+  @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
+  @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
+                                responsiblity to free the buffer.
+  @param[out] UnchainLength     Length of the unchained certificates list buffer in bytes.
+
+  @retval  TRUE         The operation is finished successfully.
+  @retval  FALSE        Error occurs during the operation.
+
+**/
+BOOLEAN
+EFIAPI
+Pkcs7GetCertificatesList (
+  IN  CONST UINT8  *P7Data,
+  IN  UINTN        P7Length,
+  OUT UINT8        **SignerChainCerts,
+  OUT UINTN        *ChainLength,
+  OUT UINT8        **UnchainCerts,
+  OUT UINTN        *UnchainLength
+  )
+{
+  ASSERT (FALSE);
+  return FALSE;
+}
+
 /**
   Verifies the validility of a PKCS#7 signed data as described in "PKCS #7:
   Cryptographic Message Syntax Standard". The input signed data could be wrapped

From 93b745fa60c3f188eeaa93f120ad33d1469a648b Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Thu, 10 Dec 2015 07:15:53 +0000
Subject: [PATCH 207/525] CryptoPkg: fix AARCH64 build under CLANG35

The OpenSSL function sk_X509_delete_ptr() resolves through preprocessor
substitution to '(X509 *)sk_delete_ptr()', in which the cast causes the
call to be interpreted as an expression (whose value is not used) rather
than a statement, resulting in the following error under Clang:

  ...: error: expression result unused [-Werror,-Wunused-value]

Add (VOID) casts to silence the error.

(Sync patch r18730 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19185 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
index 6c91dea58151..d49fbb7afded 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
@@ -622,7 +622,7 @@ Pkcs7GetCertificatesList (
       goto _Error;
     }
   }
-  sk_X509_delete_ptr (CertCtx.untrusted, Signer);
+  (VOID)sk_X509_delete_ptr (CertCtx.untrusted, Signer);
 
   //
   // Build certificates stack chained from Signer's certificate.
@@ -652,7 +652,7 @@ Pkcs7GetCertificatesList (
         if (!sk_X509_push (CertCtx.chain, Issuer)) {
           goto _Error;
         }
-        sk_X509_delete_ptr (CertCtx.untrusted, Issuer);
+        (VOID)sk_X509_delete_ptr (CertCtx.untrusted, Issuer);
 
         Cert = Issuer;
         continue;

From b2a59c532279fff7ed980e5ff2222adcd59c8a84 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:16:34 +0000
Subject: [PATCH 208/525] MdePkg: Add AuditMode/DeployedMode name definition

Add AuditMode/DeployedMode definition from Enable Secure Boot feature defined in UEFI2.5 Mantis 1263.
  https://mantis.uefi.org/mantis/view.php?id=1263

(Sync patch r19130 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Zeng Star <star.zeng@intel.com>
Reviewed-by: Long Qin <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19186 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Guid/GlobalVariable.h      | 14 ++++++++++++++
 MdePkg/Include/Guid/ImageAuthentication.h |  9 ++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/MdePkg/Include/Guid/GlobalVariable.h b/MdePkg/Include/Guid/GlobalVariable.h
index 1e4fbc822718..e58f7a1e8c01 100644
--- a/MdePkg/Include/Guid/GlobalVariable.h
+++ b/MdePkg/Include/Guid/GlobalVariable.h
@@ -126,6 +126,20 @@ extern EFI_GUID gEfiGlobalVariableGuid;
 ///
 #define EFI_SETUP_MODE_NAME                         L"SetupMode"
 ///
+/// Whether the system is operating in audit mode (1) or not (0).
+/// All other values are reserved. Should be treated as read-only except when DeployedMode is 0.
+/// Always becomes read-only after ExitBootServices() is called.
+/// Its attribute is BS+RT.
+///
+#define EFI_AUDIT_MODE_NAME                         L"AuditMode"
+///
+/// Whether the system is operating in deployed mode (1) or not (0).
+/// All other values are reserved. Should be treated as read-only when its value is 1.
+/// Always becomes read-only after ExitBootServices() is called.
+/// Its attribute is BS+RT.
+///
+#define EFI_DEPLOYED_MODE_NAME                      L"DeployedMode"
+///
 /// The Key Exchange Key Signature Database.
 /// Its attribute is NV+BS+RT+AT.
 ///
diff --git a/MdePkg/Include/Guid/ImageAuthentication.h b/MdePkg/Include/Guid/ImageAuthentication.h
index 4f4296086d75..2f51935c0c76 100644
--- a/MdePkg/Include/Guid/ImageAuthentication.h
+++ b/MdePkg/Include/Guid/ImageAuthentication.h
@@ -43,9 +43,12 @@
 
 #define SECURE_BOOT_MODE_ENABLE           1
 #define SECURE_BOOT_MODE_DISABLE          0
-#define SETUP_MODE                        1
-#define USER_MODE                         0
-
+#define SETUP_MODE_ENABLE                 1
+#define SETUP_MODE_DISABLE                0
+#define DEPLOYED_MODE_ENABLE              1
+#define DEPLOYED_MODE_DISABLE             0
+#define AUDIT_MODE_ENABLE                 1
+#define AUDIT_MODE_DISABLE                0
 
 //***********************************************************************
 // Signature Database

From 54707a6bc7a627660f742c1111763d9e093184a6 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:17:12 +0000
Subject: [PATCH 209/525] MdeModulePkg: VarCheckUefiLib: Add
 DeployedMode/AuditMode var check logic

DeployedMode & AuditMode are UINT8 Global variable according to Enable Secure Boot feature defined in UEFI2.5 Mantis 1263. Add them to var check list.
  https://mantis.uefi.org/mantis/view.php?id=1263

(Sync patch r19131 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Zeng Star <star.zeng@intel.com>
Reviewed-by: Long Qin <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19187 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../VarCheckUefiLibNullClass.c                | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/MdeModulePkg/Library/VarCheckUefiLib/VarCheckUefiLibNullClass.c b/MdeModulePkg/Library/VarCheckUefiLib/VarCheckUefiLibNullClass.c
index 15144bd4c0a9..a4268ae113a9 100644
--- a/MdeModulePkg/Library/VarCheckUefiLib/VarCheckUefiLibNullClass.c
+++ b/MdeModulePkg/Library/VarCheckUefiLib/VarCheckUefiLibNullClass.c
@@ -425,6 +425,28 @@ UEFI_DEFINED_VARIABLE_ENTRY mGlobalVariableList[] = {
     },
     NULL
   },
+  {
+    EFI_AUDIT_MODE_NAME,
+    {
+      VAR_CHECK_VARIABLE_PROPERTY_REVISION,
+      0,
+      VARIABLE_ATTRIBUTE_BS_RT,
+      sizeof (UINT8),
+      sizeof (UINT8)
+    },
+    NULL
+  },
+  {
+    EFI_DEPLOYED_MODE_NAME,
+    {
+      VAR_CHECK_VARIABLE_PROPERTY_REVISION,
+      0,
+      VARIABLE_ATTRIBUTE_BS_RT,
+      sizeof (UINT8),
+      sizeof (UINT8)
+    },
+    NULL
+  },
   {
     EFI_KEY_EXCHANGE_KEY_NAME,
     {

From 3d5dca0b88f2e1034553a9aa72930c6e7eb58bb3 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:17:41 +0000
Subject: [PATCH 210/525] SecurityPkg: Add gEdkiiSecureBootModeGuid definition

Add gEdkiiSecureBootModeGuid definition for Enable Secure Boot feature defined in
UEFI2.5 Mantis 1263. It is a private variable GUID.
  https://mantis.uefi.org/mantis/view.php?id=1263

(Sync patch r19132 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Zeng Star <star.zeng@intel.com>
Reviewed-by: Long Qin <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19188 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Include/Guid/AuthenticatedVariableFormat.h | 1 +
 SecurityPkg/SecurityPkg.dec                            | 6 +++++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/SecurityPkg/Include/Guid/AuthenticatedVariableFormat.h b/SecurityPkg/Include/Guid/AuthenticatedVariableFormat.h
index 1f007cfc73e2..7094d523b524 100644
--- a/SecurityPkg/Include/Guid/AuthenticatedVariableFormat.h
+++ b/SecurityPkg/Include/Guid/AuthenticatedVariableFormat.h
@@ -28,6 +28,7 @@ extern EFI_GUID gEfiSecureBootEnableDisableGuid;
 extern EFI_GUID gEfiCertDbGuid;
 extern EFI_GUID gEfiCustomModeEnableGuid;
 extern EFI_GUID gEfiVendorKeysNvGuid;
+extern EFI_GUID gEdkiiSecureBootModeGuid;
 
 ///
 /// "SecureBootEnable" variable for the Secure Boot feature enable/disable.
diff --git a/SecurityPkg/SecurityPkg.dec b/SecurityPkg/SecurityPkg.dec
index 959acf06b4c2..d568b4757a0b 100644
--- a/SecurityPkg/SecurityPkg.dec
+++ b/SecurityPkg/SecurityPkg.dec
@@ -109,7 +109,11 @@
   ## GUID used to "certdb" variable to store the signer's certificates for common variables with EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS attribute.
   #  Include/Guid/AuthenticatedVariableFormat.h
   gEfiCertDbGuid                     = { 0xd9bee56e, 0x75dc, 0x49d9, { 0xb4, 0xd7, 0xb5, 0x34, 0x21, 0xf, 0x63, 0x7a } }
-  
+
+  ## GUID used to "SecureBootMode" variable to save platform secure boot mode
+  #  Include/Guid/AuthenticatedVariableFormat.h
+  gEdkiiSecureBootModeGuid           = { 0xc573b77, 0xeb93, 0x4d3d, { 0xaf, 0xfc, 0x5f, 0xeb, 0xca, 0xfb, 0x65, 0xb0 } }
+
   ## Hob GUID used to pass a TCG_PCR_EVENT from a TPM PEIM to a TPM DXE Driver.
   #  Include/Guid/TcgEventHob.h
   gTcgEventEntryHobGuid              = { 0x2b9ffb52, 0x1b13, 0x416f, { 0xa8, 0x7b, 0xbc, 0x93, 0xd, 0xef, 0x92, 0xa8 }}

From 277a82548ac1a6d72be2c869cbd4a2b365f8d7c3 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:18:35 +0000
Subject: [PATCH 211/525] SecurityPkg: AuthVariableLib: Customized SecureBoot
 Mode transition.

  Implement Customized SecureBoot Mode transition logic according to Mantis 1263, including AuditMode/DeployedMode/PK update management.
  Also implement image verification logic in AuditMode. Image Certificate & Hash are recorded to EFI Image Execution Table.
  https://mantis.uefi.org/mantis/view.php?id=1263

(Sync patch r19133 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Zeng Star <star.zeng@intel.com>
Reviewed-by: Long Qin <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19189 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/AuthVariableLib/AuthService.c     | 1414 ++++++++++++++---
 .../AuthVariableLib/AuthServiceInternal.h     |   93 ++
 .../Library/AuthVariableLib/AuthVariableLib.c |  109 +-
 .../AuthVariableLib/AuthVariableLib.inf       |    4 +
 .../DxeImageVerificationLib.c                 |  670 +++++++-
 5 files changed, 1967 insertions(+), 323 deletions(-)

diff --git a/SecurityPkg/Library/AuthVariableLib/AuthService.c b/SecurityPkg/Library/AuthVariableLib/AuthService.c
index 1f9ba15384f2..5546c2e5c906 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthService.c
+++ b/SecurityPkg/Library/AuthVariableLib/AuthService.c
@@ -56,6 +56,54 @@ EFI_SIGNATURE_ITEM mSupportSigItem[] = {
   {EFI_CERT_X509_SHA512_GUID,     0,               80           }
 };
 
+//
+// Secure Boot Mode state machine
+//
+SECURE_BOOT_MODE mSecureBootState[SecureBootModeTypeMax] = {
+  // USER MODE
+  {
+      AUDIT_MODE_DISABLE,                        // AuditMode
+      FALSE,                                     // IsAuditModeRO, AuditMode is RW
+      DEPLOYED_MODE_DISABLE,                     // DeployedMode
+      FALSE,                                     // IsDeployedModeRO, DeployedMode is RW
+      SETUP_MODE_DISABLE,                        // SetupMode
+                                                 // SetupMode is always RO
+      SECURE_BOOT_MODE_ENABLE                    // SecureBoot
+  },
+  // SETUP MODE
+  {
+      AUDIT_MODE_DISABLE,                        // AuditMode
+      FALSE,                                     // IsAuditModeRO, AuditMode is RW
+      DEPLOYED_MODE_DISABLE,                     // DeployedMode
+      TRUE,                                      // IsDeployedModeRO, DeployedMode is RO
+      SETUP_MODE_ENABLE,                         // SetupMode
+                                                 // SetupMode is always RO
+      SECURE_BOOT_MODE_DISABLE                   // SecureBoot
+  },
+  // AUDIT MODE
+  {
+      AUDIT_MODE_ENABLE,                         // AuditMode
+      TRUE,                                      // AuditModeValAttr RO, AuditMode is RO
+      DEPLOYED_MODE_DISABLE,                     // DeployedMode
+      TRUE,                                      // DeployedModeValAttr RO, DeployedMode is RO
+      SETUP_MODE_ENABLE,                         // SetupMode
+                                                 // SetupMode is always RO
+      SECURE_BOOT_MODE_DISABLE                   // SecureBoot
+  },
+  // DEPLOYED MODE
+  {
+      AUDIT_MODE_DISABLE,                        // AuditMode, AuditMode is RO
+      TRUE,                                      // AuditModeValAttr RO
+      DEPLOYED_MODE_ENABLE,                      // DeployedMode
+      TRUE,                                      // DeployedModeValAttr RO, DeployedMode is RO
+      SETUP_MODE_DISABLE,                        // SetupMode
+                                                 // SetupMode is always RO
+      SECURE_BOOT_MODE_ENABLE                    // SecureBoot
+  }
+};
+
+SECURE_BOOT_MODE_TYPE  mSecureBootMode;
+
 /**
   Finds variable in storage blocks of volatile and non-volatile storage areas.
 
@@ -179,74 +227,982 @@ AuthServiceInternalUpdateVariableWithMonotonicCount (
 }
 
 /**
-  Update the variable region with Variable information.
+  Update the variable region with Variable information.
+
+  @param[in] VariableName           Name of variable.
+  @param[in] VendorGuid             Guid of variable.
+  @param[in] Data                   Data pointer.
+  @param[in] DataSize               Size of Data.
+  @param[in] Attributes             Attribute value of the variable.
+  @param[in] TimeStamp              Value of associated TimeStamp.
+
+  @retval EFI_SUCCESS               The update operation is success.
+  @retval EFI_INVALID_PARAMETER     Invalid parameter.
+  @retval EFI_WRITE_PROTECTED       Variable is write-protected.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+AuthServiceInternalUpdateVariableWithTimeStamp (
+  IN CHAR16             *VariableName,
+  IN EFI_GUID           *VendorGuid,
+  IN VOID               *Data,
+  IN UINTN              DataSize,
+  IN UINT32             Attributes,
+  IN EFI_TIME           *TimeStamp
+  )
+{
+  EFI_STATUS            FindStatus;
+  VOID                  *OrgData;
+  UINTN                 OrgDataSize;
+  AUTH_VARIABLE_INFO    AuthVariableInfo;
+
+  FindStatus = AuthServiceInternalFindVariable (
+                 VariableName,
+                 VendorGuid,
+                 &OrgData,
+                 &OrgDataSize
+                 );
+
+  //
+  // EFI_VARIABLE_APPEND_WRITE attribute only effects for existing variable
+  //
+  if (!EFI_ERROR (FindStatus) && ((Attributes & EFI_VARIABLE_APPEND_WRITE) != 0)) {
+    if ((CompareGuid (VendorGuid, &gEfiImageSecurityDatabaseGuid) &&
+        ((StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE) == 0) || (StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE1) == 0) ||
+        (StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE2) == 0))) ||
+        (CompareGuid (VendorGuid, &gEfiGlobalVariableGuid) && (StrCmp (VariableName, EFI_KEY_EXCHANGE_KEY_NAME) == 0))) {
+      //
+      // For variables with formatted as EFI_SIGNATURE_LIST, the driver shall not perform an append of
+      // EFI_SIGNATURE_DATA values that are already part of the existing variable value.
+      //
+      FilterSignatureList (
+        OrgData,
+        OrgDataSize,
+        Data,
+        &DataSize
+        );
+    }
+  }
+
+  ZeroMem (&AuthVariableInfo, sizeof (AuthVariableInfo));
+  AuthVariableInfo.VariableName = VariableName;
+  AuthVariableInfo.VendorGuid = VendorGuid;
+  AuthVariableInfo.Data = Data;
+  AuthVariableInfo.DataSize = DataSize;
+  AuthVariableInfo.Attributes = Attributes;
+  AuthVariableInfo.TimeStamp = TimeStamp;
+  return mAuthVarLibContextIn->UpdateVariable (
+           &AuthVariableInfo
+           );
+}
+
+/**
+  Initialize Secure Boot variables.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+InitSecureBootVariables (
+  VOID
+  )
+{
+  EFI_STATUS             Status;
+  UINT8                  *Data;
+  UINTN                  DataSize;
+  UINT32                 SecureBoot;
+  UINT8                  SecureBootEnable;
+  SECURE_BOOT_MODE_TYPE  SecureBootMode;
+  BOOLEAN                IsPkPresent;
+
+  //
+  // Find "PK" variable
+  //
+  Status = AuthServiceInternalFindVariable (EFI_PLATFORM_KEY_NAME, &gEfiGlobalVariableGuid, (VOID **) &Data, &DataSize);
+  if (EFI_ERROR (Status)) {
+    IsPkPresent = FALSE;
+    DEBUG ((EFI_D_INFO, "Variable %s does not exist.\n", EFI_PLATFORM_KEY_NAME));
+  } else {
+    IsPkPresent = TRUE;
+    DEBUG ((EFI_D_INFO, "Variable %s exists.\n", EFI_PLATFORM_KEY_NAME));
+  }
+
+  //
+  // Init "SecureBootMode" variable.
+  // Initial case
+  //   SecureBootMode doesn't exist. Init it with PK state
+  // 3 inconsistency cases need to sync
+  //   1.1 Add PK     -> system break -> update SecureBootMode Var
+  //   1.2 Delete PK  -> system break -> update SecureBootMode Var
+  //   1.3 Set AuditMode ->Delete PK  -> system break -> Update SecureBootMode Var
+  //
+  Status = AuthServiceInternalFindVariable (EDKII_SECURE_BOOT_MODE_NAME, &gEdkiiSecureBootModeGuid, (VOID **)&Data, &DataSize);
+  if (EFI_ERROR(Status)) {
+    //
+    // Variable driver Initial Case
+    //
+    if (IsPkPresent) {
+      SecureBootMode = SecureBootModeTypeUserMode;
+    } else {
+      SecureBootMode = SecureBootModeTypeSetupMode;
+    }
+  } else {
+    //
+    // 3 inconsistency cases need to sync
+    //
+    SecureBootMode = (SECURE_BOOT_MODE_TYPE)*Data;
+    ASSERT(SecureBootMode < SecureBootModeTypeMax);
+
+    if (IsPkPresent) {
+      //
+      // 3.1 Add PK     -> system break -> update SecureBootMode Var
+      //
+      if (SecureBootMode == SecureBootModeTypeSetupMode) {
+        SecureBootMode = SecureBootModeTypeUserMode;
+      } else if (SecureBootMode == SecureBootModeTypeAuditMode) {
+        SecureBootMode = SecureBootModeTypeDeployedMode;
+      }
+    } else {
+      //
+      // 3.2 Delete PK -> system break -> update SecureBootMode Var
+      // 3.3 Set AuditMode ->Delete PK  -> system break -> Update SecureBootMode Var. Reinit to be SetupMode
+      //
+      if ((SecureBootMode == SecureBootModeTypeUserMode) || (SecureBootMode == SecureBootModeTypeDeployedMode)) {
+        SecureBootMode = SecureBootModeTypeSetupMode;
+      }
+    }
+  }
+
+  if (EFI_ERROR(Status) || (SecureBootMode != (SECURE_BOOT_MODE_TYPE)*Data)) {
+    //
+    // Update SecureBootMode Var
+    //
+    Status = AuthServiceInternalUpdateVariable (
+               EDKII_SECURE_BOOT_MODE_NAME,
+               &gEdkiiSecureBootModeGuid,
+               &SecureBootMode,
+               sizeof (UINT8),
+               EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
+               );
+    if (EFI_ERROR(Status)) {
+      return Status;
+    }
+  }
+
+  //
+  // Init "AuditMode"
+  //
+  Status = AuthServiceInternalUpdateVariable (
+             EFI_AUDIT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &mSecureBootState[SecureBootMode].AuditMode,
+             sizeof(UINT8),
+             EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
+             );
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
+
+  //
+  // Init "DeployedMode"
+  //
+  Status = AuthServiceInternalUpdateVariable (
+             EFI_DEPLOYED_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &mSecureBootState[SecureBootMode].DeployedMode,
+             sizeof(UINT8),
+             EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
+             );
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
+
+  //
+  // Init "SetupMode"
+  //
+  Status = AuthServiceInternalUpdateVariable (
+             EFI_SETUP_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &mSecureBootState[SecureBootMode].SetupMode,
+             sizeof(UINT8),
+             EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
+             );
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
+
+  //
+  // If "SecureBootEnable" variable exists, then update "SecureBoot" variable.
+  // If "SecureBootEnable" variable is SECURE_BOOT_ENABLE and in User Mode or Deployed Mode, Set "SecureBoot" variable to SECURE_BOOT_MODE_ENABLE.
+  // If "SecureBootEnable" variable is SECURE_BOOT_DISABLE, Set "SecureBoot" variable to SECURE_BOOT_MODE_DISABLE.
+  //
+  SecureBootEnable = SECURE_BOOT_DISABLE;
+  Status = AuthServiceInternalFindVariable (EFI_SECURE_BOOT_ENABLE_NAME, &gEfiSecureBootEnableDisableGuid, (VOID **)&Data, &DataSize);
+  if (!EFI_ERROR(Status)) {
+    if (!IsPkPresent) {
+      //
+      // PK is cleared in runtime. "SecureBootMode" is not updated before reboot
+      // Delete "SecureBootMode"
+      //
+      Status = AuthServiceInternalUpdateVariable (
+                 EFI_SECURE_BOOT_ENABLE_NAME,
+                 &gEfiSecureBootEnableDisableGuid,
+                 &SecureBootEnable,
+                 0,
+                 EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+                 );
+    } else {
+      SecureBootEnable = *Data;
+    }
+  } else if ((SecureBootMode == SecureBootModeTypeUserMode) || (SecureBootMode == SecureBootModeTypeDeployedMode)) {
+    //
+    // "SecureBootEnable" not exist, initialize it in User Mode or Deployed Mode.
+    //
+    SecureBootEnable = SECURE_BOOT_ENABLE;
+    Status = AuthServiceInternalUpdateVariable (
+               EFI_SECURE_BOOT_ENABLE_NAME,
+               &gEfiSecureBootEnableDisableGuid,
+               &SecureBootEnable,
+               sizeof (UINT8),
+               EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+  }
+
+  //
+  // Create "SecureBoot" variable with BS+RT attribute set.
+  //
+  if ((SecureBootEnable == SECURE_BOOT_ENABLE) 
+  && ((SecureBootMode == SecureBootModeTypeUserMode) || (SecureBootMode == SecureBootModeTypeDeployedMode))) {
+    SecureBoot = SECURE_BOOT_MODE_ENABLE;
+  } else {
+    SecureBoot = SECURE_BOOT_MODE_DISABLE;
+  }
+  Status = AuthServiceInternalUpdateVariable (
+             EFI_SECURE_BOOT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SecureBoot,
+             sizeof (UINT8),
+             EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_BOOTSERVICE_ACCESS
+             );
+
+  DEBUG ((EFI_D_INFO, "SecureBootMode is %x\n", SecureBootMode));
+  DEBUG ((EFI_D_INFO, "Variable %s is %x\n", EFI_SECURE_BOOT_MODE_NAME, SecureBoot));
+  DEBUG ((EFI_D_INFO, "Variable %s is %x\n", EFI_SECURE_BOOT_ENABLE_NAME, SecureBootEnable));
+
+  //
+  // Save SecureBootMode in global space
+  //
+  mSecureBootMode = SecureBootMode;
+
+  return Status;
+}
+
+/**
+  Update SecureBootMode variable.
+
+  @param[in] NewMode                New Secure Boot Mode.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+UpdateSecureBootMode(
+  IN  SECURE_BOOT_MODE_TYPE  NewMode
+  )
+{
+  EFI_STATUS              Status;
+
+  //
+  // Update "SecureBootMode" variable to new Secure Boot Mode
+  //
+  Status = AuthServiceInternalUpdateVariable (
+             EDKII_SECURE_BOOT_MODE_NAME,
+             &gEdkiiSecureBootModeGuid,
+             &NewMode,
+             sizeof (UINT8),
+             EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
+             );
+
+  if (!EFI_ERROR(Status)) {
+    DEBUG((EFI_D_INFO, "SecureBootMode Update to %x\n", NewMode));
+    mSecureBootMode = NewMode;
+  } else {
+    DEBUG((EFI_D_ERROR, "SecureBootMode Update failure %x\n", Status));
+  }
+
+  return Status;
+}
+
+/**
+  Current secure boot mode is AuditMode. This function performs secure boot mode transition
+  to a new mode.
+
+  @param[in] NewMode                New Secure Boot Mode.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+TransitionFromAuditMode(
+  IN  SECURE_BOOT_MODE_TYPE               NewMode
+  )
+{
+  EFI_STATUS  Status;
+  UINT8       *AuditVarData;
+  UINT8       *DeployedVarData;
+  UINT8       *SetupVarData;
+  UINT8       *SecureBootVarData;
+  UINT8       SecureBootEnable;
+  UINTN       DataSize;
+
+  //
+  // AuditMode/DeployedMode/SetupMode/SecureBoot are all NON_NV variable maintained by Variable driver
+  // they can be RW. but can't be deleted. so they can always be found.
+  //
+  Status = AuthServiceInternalFindVariable (
+             EFI_AUDIT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &AuditVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_DEPLOYED_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &DeployedVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SETUP_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SetupVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SECURE_BOOT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SecureBootVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  //
+  // Make Secure Boot Mode transition ATOMIC
+  // Update Private NV SecureBootMode Variable first, because it may fail due to NV range overflow.
+  // other tranisition logic are all memory operations.
+  //
+  Status = UpdateSecureBootMode(NewMode);
+  if (EFI_ERROR(Status)) {
+    DEBUG((EFI_D_ERROR, "Update SecureBootMode Variable fail %x\n", Status));
+  }
+
+  if (NewMode == SecureBootModeTypeDeployedMode) {
+    //
+    // Since PK is enrolled, can't rollback, always update SecureBootMode in memory
+    //
+    mSecureBootMode = NewMode;
+    Status          = EFI_SUCCESS;
+
+    //
+    // AuditMode ----> DeployedMode
+    // Side Effects
+    //   AuditMode =: 0 / DeployedMode := 1 / SetupMode := 0
+    //
+    // Update the value of AuditMode variable by a simple mem copy, this could avoid possible
+    // variable storage reclaim at runtime.
+    //
+    CopyMem (AuditVarData, &mSecureBootState[NewMode].AuditMode, sizeof(UINT8));
+    //
+    // Update the value of DeployedMode variable by a simple mem copy, this could avoid possible
+    // variable storage reclaim at runtime.
+    //
+    CopyMem (DeployedVarData, &mSecureBootState[NewMode].DeployedMode, sizeof(UINT8));
+    //
+    // Update the value of SetupMode variable by a simple mem copy, this could avoid possible
+    // variable storage reclaim at runtime.
+    //
+    CopyMem (SetupVarData, &mSecureBootState[NewMode].SetupMode, sizeof(UINT8));
+
+    if (mAuthVarLibContextIn->AtRuntime ()) {
+      //
+      // SecureBoot Variable indicates whether the platform firmware is operating
+      // in Secure boot mode (1) or not (0), so we should not change SecureBoot
+      // Variable in runtime.
+      //
+      return Status;
+    }
+
+    //
+    // Update the value of SecureBoot variable by a simple mem copy, this could avoid possible
+    // variable storage reclaim at runtime.
+    //
+    CopyMem (SecureBootVarData, &mSecureBootState[NewMode].SecureBoot, sizeof(UINT8));
+
+    //
+    // Create "SecureBootEnable" variable  as secure boot is enabled.
+    //
+    SecureBootEnable = SECURE_BOOT_ENABLE;
+    AuthServiceInternalUpdateVariable (
+      EFI_SECURE_BOOT_ENABLE_NAME,
+      &gEfiSecureBootEnableDisableGuid,
+      &SecureBootEnable,
+      sizeof (SecureBootEnable),
+      EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+      );
+  } else {
+    DEBUG((EFI_D_ERROR, "Invalid state tranition from %x to %x\n", SecureBootModeTypeAuditMode, NewMode));
+    ASSERT(FALSE);
+  }
+
+  return Status;
+}
+
+/**
+  Current secure boot mode is DeployedMode. This function performs secure boot mode transition
+  to a new mode.
+
+  @param[in] NewMode                New Secure Boot Mode.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+TransitionFromDeployedMode(
+  IN  SECURE_BOOT_MODE_TYPE               NewMode
+  )
+{
+  EFI_STATUS  Status;
+  UINT8       *DeployedVarData;
+  UINT8       *SetupVarData;
+  UINT8       *SecureBootVarData;
+  UINT8       SecureBootEnable;
+  UINTN       DataSize;
+
+  //
+  // AuditMode/DeployedMode/SetupMode/SecureBoot are all NON_NV variable maintained by Variable driver
+  // they can be RW. but can't be deleted. so they can always be found.
+  //
+  Status = AuthServiceInternalFindVariable (
+             EFI_DEPLOYED_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &DeployedVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SETUP_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SetupVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SECURE_BOOT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SecureBootVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  //
+  // Make Secure Boot Mode transition ATOMIC
+  // Update Private NV SecureBootMode Variable first, because it may fail due to NV range overflow.
+  // other tranisition logic are all memory operations.
+  //
+  Status = UpdateSecureBootMode(NewMode);
+  if (EFI_ERROR(Status)) {
+    DEBUG((EFI_D_ERROR, "Update SecureBootMode Variable fail %x\n", Status));
+  }
+
+  switch(NewMode) {
+    case SecureBootModeTypeUserMode:
+      //
+      // DeployedMode ----> UserMode
+      // Side Effects
+      //   DeployedMode := 0
+      //
+      // Platform Specific DeployedMode clear. UpdateSecureBootMode fails and no other variables are updated before. rollback this transition
+      //
+      if (EFI_ERROR(Status)) {
+        return Status;
+      }
+      CopyMem (DeployedVarData, &mSecureBootState[NewMode].DeployedMode, sizeof(UINT8));
+
+      break;
+
+    case SecureBootModeTypeSetupMode:
+      //
+      // Since PK is processed before, can't rollback, still update SecureBootMode in memory
+      //
+      mSecureBootMode = NewMode;
+      Status          = EFI_SUCCESS;
+
+      //
+      // DeployedMode ----> SetupMode
+      //
+      // Platform Specific PKpub clear or Delete Pkpub
+      // Side Effects
+      //   DeployedMode := 0 / SetupMode := 1 / SecureBoot := 0
+      //
+      // Update the value of DeployedMode variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (DeployedVarData, &mSecureBootState[NewMode].DeployedMode, sizeof(UINT8));
+      //
+      // Update the value of SetupMode variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SetupVarData, &mSecureBootState[NewMode].SetupMode, sizeof(UINT8));
+
+      if (mAuthVarLibContextIn->AtRuntime ()) {
+        //
+        // SecureBoot Variable indicates whether the platform firmware is operating
+        // in Secure boot mode (1) or not (0), so we should not change SecureBoot
+        // Variable in runtime.
+        //
+        return Status;
+      }
+
+      //
+      // Update the value of SecureBoot variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SecureBootVarData, &mSecureBootState[NewMode].SecureBoot, sizeof(UINT8));
+
+      //
+      // Delete the "SecureBootEnable" variable as secure boot is Disabled.
+      //
+      SecureBootEnable = SECURE_BOOT_DISABLE;
+      AuthServiceInternalUpdateVariable (
+        EFI_SECURE_BOOT_ENABLE_NAME,
+        &gEfiSecureBootEnableDisableGuid,
+        &SecureBootEnable,
+        0,
+        EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+        );
+      break;
+
+    default:
+      DEBUG((EFI_D_ERROR, "Invalid state tranition from %x to %x\n", SecureBootModeTypeDeployedMode, NewMode));
+      ASSERT(FALSE);
+  }
+
+  return Status;
+}
+
+/**
+  Current secure boot mode is UserMode. This function performs secure boot mode transition
+  to a new mode.
+
+  @param[in] NewMode                New Secure Boot Mode.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+TransitionFromUserMode(
+  IN  SECURE_BOOT_MODE_TYPE               NewMode
+  )
+{
+  EFI_STATUS   Status;
+  UINT8        *AuditVarData;
+  UINT8        *DeployedVarData;
+  UINT8        *SetupVarData;
+  UINT8        *PkVarData;
+  UINT8        *SecureBootVarData;
+  UINT8        SecureBootEnable;
+  UINTN        DataSize;
+  VARIABLE_ENTRY_CONSISTENCY  VariableEntry;
+
+  //
+  // AuditMode/DeployedMode/SetupMode/SecureBoot are all NON_NV variable maintained by Variable driver
+  // they can be RW. but can't be deleted. so they can always be found.
+  //
+  Status = AuthServiceInternalFindVariable (
+             EFI_AUDIT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &AuditVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_DEPLOYED_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &DeployedVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SETUP_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SetupVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SECURE_BOOT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SecureBootVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  //
+  // Make Secure Boot Mode transition ATOMIC
+  // Update Private NV SecureBootMode Variable first, because it may fail due to NV range overflow. 
+  // Other tranisition logic are all memory operations and PK delete is assumed to be always successful.
+  //
+  if (NewMode != SecureBootModeTypeAuditMode) {
+    Status = UpdateSecureBootMode(NewMode);
+    if (EFI_ERROR(Status)) {
+      DEBUG((EFI_D_ERROR, "Update SecureBootMode Variable fail %x\n", Status));
+    }
+  } else {
+    //
+    // UserMode -----> AuditMode. Check RemainingSpace for SecureBootMode var first.
+    // Will update SecureBootMode after DeletePK logic
+    //
+    VariableEntry.VariableSize = sizeof(UINT8);
+    VariableEntry.Guid         = &gEdkiiSecureBootModeGuid;
+    VariableEntry.Name         = EDKII_SECURE_BOOT_MODE_NAME;
+    if (!mAuthVarLibContextIn->CheckRemainingSpaceForConsistency (VARIABLE_ATTRIBUTE_NV_BS_RT, &VariableEntry, NULL)) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+  }
+
+  switch(NewMode) {
+    case SecureBootModeTypeDeployedMode:
+      //
+      // UpdateSecureBootMode fails and no other variables are updated before. rollback this transition
+      //
+      if (EFI_ERROR(Status)) {
+        return Status;
+      }
+
+      //
+      // UserMode ----> DeployedMode
+      // Side Effects
+      //   DeployedMode := 1
+      //
+      CopyMem (DeployedVarData, &mSecureBootState[NewMode].DeployedMode, sizeof(UINT8));
+      break;
+
+    case SecureBootModeTypeAuditMode:
+      //
+      // UserMode ----> AuditMode
+      // Side Effects
+      //   Delete PKpub / SetupMode := 1 / SecureBoot := 0
+      //
+      // Delete PKpub without verification. Should always succeed.
+      //
+      PkVarData = NULL;
+      Status = AuthServiceInternalUpdateVariable (
+                 EFI_PLATFORM_KEY_NAME,
+                 &gEfiGlobalVariableGuid,
+                 PkVarData,
+                 0,
+                 EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS
+                 );
+      if (EFI_ERROR(Status)) {
+        DEBUG((EFI_D_ERROR, "UserMode -> AuditMode. Delete PK fail %x\n", Status));
+        ASSERT(FALSE);
+      }
+
+      //
+      // Update Private NV SecureBootMode Variable
+      //
+      Status = UpdateSecureBootMode(NewMode);
+      if (EFI_ERROR(Status)) {
+        //
+        // Since PK is deleted successfully, Doesn't break, continue to update other variable.
+        //
+        DEBUG((EFI_D_ERROR, "Update SecureBootMode Variable fail %x\n", Status));
+      }
+      CopyMem (AuditVarData, &mSecureBootState[NewMode].AuditMode, sizeof(UINT8));
+
+      //
+      // Fall into SetupMode logic
+      //
+    case SecureBootModeTypeSetupMode:
+      //
+      // Since PK is deleted before , can't rollback, still update SecureBootMode in memory
+      //
+      mSecureBootMode = NewMode;
+      Status          = EFI_SUCCESS;
+
+      //
+      // UserMode ----> SetupMode
+      //  Side Effects
+      //    DeployedMode :=0 / SetupMode :=1 / SecureBoot :=0
+      //
+      // Update the value of SetupMode variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SetupVarData, &mSecureBootState[NewMode].SetupMode, sizeof(UINT8));
+
+      if (mAuthVarLibContextIn->AtRuntime ()) {
+        //
+        // SecureBoot Variable indicates whether the platform firmware is operating
+        // in Secure boot mode (1) or not (0), so we should not change SecureBoot
+        // Variable in runtime.
+        //
+        return Status;
+      }
+
+      //
+      // Update the value of SecureBoot variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SecureBootVarData, &mSecureBootState[NewMode].SecureBoot, sizeof(UINT8));
+
+      //
+      // Delete the "SecureBootEnable" variable as secure boot is Disabled.
+      //
+      SecureBootEnable = SECURE_BOOT_DISABLE;
+      AuthServiceInternalUpdateVariable (
+        EFI_SECURE_BOOT_ENABLE_NAME,
+        &gEfiSecureBootEnableDisableGuid,
+        &SecureBootEnable,
+        0,
+        EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+        );
+
+      break;
+
+    default:
+      DEBUG((EFI_D_ERROR, "Invalid state tranition from %x to %x\n", SecureBootModeTypeUserMode, NewMode));
+      ASSERT(FALSE);
+  }
+
+  return Status;
+}
+
+/**
+  Current secure boot mode is SetupMode. This function performs secure boot mode transition
+  to a new mode.
+
+  @param[in] NewMode                New Secure Boot Mode.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS
+TransitionFromSetupMode(
+  IN  SECURE_BOOT_MODE_TYPE              NewMode
+  )
+{
+  EFI_STATUS   Status;
+  UINT8        *AuditVarData;
+  UINT8        *SetupVarData;
+  UINT8        *SecureBootVarData;
+  UINT8        SecureBootEnable;
+  UINTN        DataSize;
+
+  //
+  // AuditMode/DeployedMode/SetupMode/SecureBoot are all NON_NV variable maintained by Variable driver
+  // they can be RW. but can't be deleted. so they can always be found.
+  //
+  Status = AuthServiceInternalFindVariable (
+             EFI_AUDIT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &AuditVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SETUP_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SetupVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  Status = AuthServiceInternalFindVariable (
+             EFI_SECURE_BOOT_MODE_NAME,
+             &gEfiGlobalVariableGuid,
+             &SecureBootVarData,
+             &DataSize
+             );
+  if (EFI_ERROR (Status)) {
+    ASSERT(FALSE);
+  }
+
+  //
+  // Make Secure Boot Mode transition ATOMIC
+  // Update Private NV SecureBootMode Variable first, because it may fail due to NV range overflow.
+  // Other tranisition logic are all memory operations and PK delete is assumed to be always successful.
+  //
+  Status = UpdateSecureBootMode(NewMode);
+  if (EFI_ERROR(Status)) {
+    DEBUG((EFI_D_ERROR, "Update SecureBootMode Variable fail %x\n", Status));
+  }
+
+  switch(NewMode) {
+    case SecureBootModeTypeAuditMode:
+      //
+      // UpdateSecureBootMode fails and no other variables are updated before. rollback this transition
+      //
+      if (EFI_ERROR(Status)) {
+        return Status;
+      }
+
+      //
+      // SetupMode ----> AuditMode
+      // Side Effects
+      //   AuditMode := 1
+      //
+      // Update the value of AuditMode variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (AuditVarData, &mSecureBootState[NewMode].AuditMode, sizeof(UINT8));
+      break;
+
+    case SecureBootModeTypeUserMode:
+      //
+      // Since PK is enrolled before, can't rollback, still update SecureBootMode in memory
+      //
+      mSecureBootMode = NewMode;
+      Status          = EFI_SUCCESS;
+
+      //
+      // SetupMode ----> UserMode
+      // Side Effects
+      //   SetupMode := 0 / SecureBoot := 1
+      //
+      // Update the value of AuditMode variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SetupVarData, &mSecureBootState[NewMode].SetupMode, sizeof(UINT8));
+
+      if (mAuthVarLibContextIn->AtRuntime ()) {
+        //
+        // SecureBoot Variable indicates whether the platform firmware is operating
+        // in Secure boot mode (1) or not (0), so we should not change SecureBoot
+        // Variable in runtime.
+        //
+        return Status;
+      }
+
+      //
+      // Update the value of SecureBoot variable by a simple mem copy, this could avoid possible
+      // variable storage reclaim at runtime.
+      //
+      CopyMem (SecureBootVarData, &mSecureBootState[NewMode].SecureBoot, sizeof(UINT8));
+
+      //
+      // Create the "SecureBootEnable" variable as secure boot is enabled.
+      //
+      SecureBootEnable = SECURE_BOOT_ENABLE;
+      AuthServiceInternalUpdateVariable (
+        EFI_SECURE_BOOT_ENABLE_NAME,
+        &gEfiSecureBootEnableDisableGuid,
+        &SecureBootEnable,
+        sizeof (SecureBootEnable),
+        EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
+        );
+      break;
+
+    default:
+      DEBUG((EFI_D_ERROR, "Invalid state tranition from %x to %x\n", SecureBootModeTypeSetupMode, NewMode));
+      ASSERT(FALSE);
+  }
+
+  return Status;
+}
+
+/**
+  This function performs main secure boot mode transition logic.
 
-  @param[in] VariableName           Name of variable.
-  @param[in] VendorGuid             Guid of variable.
-  @param[in] Data                   Data pointer.
-  @param[in] DataSize               Size of Data.
-  @param[in] Attributes             Attribute value of the variable.
-  @param[in] TimeStamp              Value of associated TimeStamp.
+  @param[in] CurMode                Current Secure Boot Mode.
+  @param[in] NewMode                New Secure Boot Mode.
 
-  @retval EFI_SUCCESS               The update operation is success.
-  @retval EFI_INVALID_PARAMETER     Invalid parameter.
-  @retval EFI_WRITE_PROTECTED       Variable is write-protected.
+  @retval EFI_SUCCESS               The initialization operation is successful.
   @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+  @retval EFI_INVALID_PARAMETER     The Current Secure Boot Mode is wrong.
 
 **/
 EFI_STATUS
-AuthServiceInternalUpdateVariableWithTimeStamp (
-  IN CHAR16             *VariableName,
-  IN EFI_GUID           *VendorGuid,
-  IN VOID               *Data,
-  IN UINTN              DataSize,
-  IN UINT32             Attributes,
-  IN EFI_TIME           *TimeStamp
+SecureBootModeTransition(
+  IN  SECURE_BOOT_MODE_TYPE  CurMode,
+  IN  SECURE_BOOT_MODE_TYPE  NewMode
   )
 {
-  EFI_STATUS            FindStatus;
-  VOID                  *OrgData;
-  UINTN                 OrgDataSize;
-  AUTH_VARIABLE_INFO    AuthVariableInfo;
-
-  FindStatus = AuthServiceInternalFindVariable (
-                 VariableName,
-                 VendorGuid,
-                 &OrgData,
-                 &OrgDataSize
-                 );
+  EFI_STATUS Status;
 
   //
-  // EFI_VARIABLE_APPEND_WRITE attribute only effects for existing variable
+  // SecureBootMode transition
   //
-  if (!EFI_ERROR (FindStatus) && ((Attributes & EFI_VARIABLE_APPEND_WRITE) != 0)) {
-    if ((CompareGuid (VendorGuid, &gEfiImageSecurityDatabaseGuid) &&
-        ((StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE) == 0) || (StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE1) == 0) ||
-        (StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE2) == 0))) ||
-        (CompareGuid (VendorGuid, &gEfiGlobalVariableGuid) && (StrCmp (VariableName, EFI_KEY_EXCHANGE_KEY_NAME) == 0))) {
-      //
-      // For variables with formatted as EFI_SIGNATURE_LIST, the driver shall not perform an append of
-      // EFI_SIGNATURE_DATA values that are already part of the existing variable value.
-      //
-      FilterSignatureList (
-        OrgData,
-        OrgDataSize,
-        Data,
-        &DataSize
-        );
-    }
+  switch (CurMode) {
+    case SecureBootModeTypeUserMode:
+      Status = TransitionFromUserMode(NewMode);
+      break;
+
+    case SecureBootModeTypeSetupMode:
+      Status = TransitionFromSetupMode(NewMode);
+      break;
+
+    case SecureBootModeTypeAuditMode:
+      Status = TransitionFromAuditMode(NewMode);
+      break;
+
+    case SecureBootModeTypeDeployedMode:
+      Status = TransitionFromDeployedMode(NewMode);
+      break;
+
+    default:
+      Status = EFI_INVALID_PARAMETER;
+      ASSERT(FALSE);
   }
 
-  ZeroMem (&AuthVariableInfo, sizeof (AuthVariableInfo));
-  AuthVariableInfo.VariableName = VariableName;
-  AuthVariableInfo.VendorGuid = VendorGuid;
-  AuthVariableInfo.Data = Data;
-  AuthVariableInfo.DataSize = DataSize;
-  AuthVariableInfo.Attributes = Attributes;
-  AuthVariableInfo.TimeStamp = TimeStamp;
-  return mAuthVarLibContextIn->UpdateVariable (
-           &AuthVariableInfo
-           );
+  return Status;
+
 }
 
 /**
@@ -597,129 +1553,6 @@ VerifyCounterBasedPayload (
   }
 }
 
-/**
-  Update platform mode.
-
-  @param[in]      Mode                    SETUP_MODE or USER_MODE.
-
-  @return EFI_INVALID_PARAMETER           Invalid parameter.
-  @return EFI_SUCCESS                     Update platform mode successfully.
-
-**/
-EFI_STATUS
-UpdatePlatformMode (
-  IN  UINT32                    Mode
-  )
-{
-  EFI_STATUS              Status;
-  VOID                    *Data;
-  UINTN                   DataSize;
-  UINT8                   SecureBootMode;
-  UINT8                   SecureBootEnable;
-  UINTN                   VariableDataSize;
-
-  Status = AuthServiceInternalFindVariable (
-             EFI_SETUP_MODE_NAME,
-             &gEfiGlobalVariableGuid,
-             &Data,
-             &DataSize
-             );
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
-
-  //
-  // Update the value of SetupMode variable by a simple mem copy, this could avoid possible
-  // variable storage reclaim at runtime.
-  //
-  mPlatformMode = (UINT8) Mode;
-  CopyMem (Data, &mPlatformMode, sizeof(UINT8));
-
-  if (mAuthVarLibContextIn->AtRuntime ()) {
-    //
-    // SecureBoot Variable indicates whether the platform firmware is operating
-    // in Secure boot mode (1) or not (0), so we should not change SecureBoot
-    // Variable in runtime.
-    //
-    return Status;
-  }
-
-  //
-  // Check "SecureBoot" variable's existence.
-  // If it doesn't exist, firmware has no capability to perform driver signing verification,
-  // then set "SecureBoot" to 0.
-  //
-  Status = AuthServiceInternalFindVariable (
-             EFI_SECURE_BOOT_MODE_NAME,
-             &gEfiGlobalVariableGuid,
-             &Data,
-             &DataSize
-             );
-  //
-  // If "SecureBoot" variable exists, then check "SetupMode" variable update.
-  // If "SetupMode" variable is USER_MODE, "SecureBoot" variable is set to 1.
-  // If "SetupMode" variable is SETUP_MODE, "SecureBoot" variable is set to 0.
-  //
-  if (EFI_ERROR (Status)) {
-    SecureBootMode = SECURE_BOOT_MODE_DISABLE;
-  } else {
-    if (mPlatformMode == USER_MODE) {
-      SecureBootMode = SECURE_BOOT_MODE_ENABLE;
-    } else if (mPlatformMode == SETUP_MODE) {
-      SecureBootMode = SECURE_BOOT_MODE_DISABLE;
-    } else {
-      return EFI_NOT_FOUND;
-    }
-  }
-
-  Status  = AuthServiceInternalUpdateVariable (
-              EFI_SECURE_BOOT_MODE_NAME,
-              &gEfiGlobalVariableGuid,
-              &SecureBootMode,
-              sizeof(UINT8),
-              EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_BOOTSERVICE_ACCESS
-              );
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
-
-  //
-  // Check "SecureBootEnable" variable's existence. It can enable/disable secure boot feature.
-  //
-  Status = AuthServiceInternalFindVariable (
-             EFI_SECURE_BOOT_ENABLE_NAME,
-             &gEfiSecureBootEnableDisableGuid,
-             &Data,
-             &DataSize
-             );
-
-  if (SecureBootMode == SECURE_BOOT_MODE_ENABLE) {
-    //
-    // Create the "SecureBootEnable" variable as secure boot is enabled.
-    //
-    SecureBootEnable = SECURE_BOOT_ENABLE;
-    VariableDataSize = sizeof (SecureBootEnable);
-  } else {
-    //
-    // Delete the "SecureBootEnable" variable if this variable exist as "SecureBoot"
-    // variable is not in secure boot state.
-    //
-    if (EFI_ERROR (Status)) {
-      return EFI_SUCCESS;
-    }
-    SecureBootEnable = SECURE_BOOT_DISABLE;
-    VariableDataSize = 0;
-  }
-
-  Status = AuthServiceInternalUpdateVariable (
-             EFI_SECURE_BOOT_ENABLE_NAME,
-             &gEfiSecureBootEnableDisableGuid,
-             &SecureBootEnable,
-             VariableDataSize,
-             EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
-             );
-  return Status;
-}
 
 /**
   Check input data form to make sure it is a valid EFI_SIGNATURE_LIST for PK/KEK/db/dbx/dbt variable.
@@ -879,6 +1712,121 @@ VendorKeyIsModified (
            );
 }
 
+/**
+  Process Secure Boot Mode variable.
+
+  Caution: This function may receive untrusted input.
+  This function may be invoked in SMM mode, and datasize and data are external input.
+  This function will do basic validation, before parse the data.
+  This function will parse the authentication carefully to avoid security issues, like
+  buffer overflow, integer overflow.
+  This function will check attribute carefully to avoid authentication bypass.
+
+  @param[in]  VariableName                Name of Variable to be found.
+  @param[in]  VendorGuid                  Variable vendor GUID.
+  @param[in]  Data                        Data pointer.
+  @param[in]  DataSize                    Size of Data found. If size is less than the
+                                          data, this value contains the required size.
+  @param[in]  Attributes                  Attribute value of the variable
+
+  @return EFI_INVALID_PARAMETER           Invalid parameter
+  @return EFI_SECURITY_VIOLATION          The variable does NOT pass the validation
+                                          check carried out by the firmware.
+  @return EFI_WRITE_PROTECTED             Variable is Read-Only.
+  @return EFI_SUCCESS                     Variable passed validation successfully.
+
+**/
+EFI_STATUS
+ProcessSecureBootModeVar (
+  IN  CHAR16         *VariableName,
+  IN  EFI_GUID       *VendorGuid,
+  IN  VOID           *Data,
+  IN  UINTN          DataSize,
+  IN  UINT32         Attributes OPTIONAL
+  )
+{
+  EFI_STATUS    Status;
+  UINT8         *VarData;
+  UINTN         VarDataSize;
+
+  //
+  // Check "AuditMode", "DeployedMode" Variable ReadWrite Attributes
+  //  if in Runtime,  Always RO
+  //  if in Boottime, Depends on current Secure Boot Mode
+  //
+  if (mAuthVarLibContextIn->AtRuntime()) {
+    return EFI_WRITE_PROTECTED;
+  }
+
+  //
+  // Delete not OK
+  //
+  if ((DataSize != sizeof(UINT8)) || (Attributes == 0)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (StrCmp (VariableName, EFI_AUDIT_MODE_NAME) == 0) {
+    if(mSecureBootState[mSecureBootMode].IsAuditModeRO) {
+      return EFI_WRITE_PROTECTED;
+    }
+  } else {
+    //
+    // Platform specific deployedMode clear. Set DeployedMode = RW
+    //
+    if (!InCustomMode() || !UserPhysicalPresent() || mSecureBootMode != SecureBootModeTypeDeployedMode) {
+      if(mSecureBootState[mSecureBootMode].IsDeployedModeRO) {
+        return EFI_WRITE_PROTECTED;
+      }
+    }
+  }
+
+  if (*(UINT8 *)Data != 0 && *(UINT8 *)Data != 1) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // AuditMode/DeployedMode/SetupMode/SecureBoot are all NON_NV variable maintained by Variable driver
+  // they can be RW. but can't be deleted. so they can always be found.
+  //
+  Status = AuthServiceInternalFindVariable (
+             VariableName,
+             VendorGuid,
+             &VarData,
+             &VarDataSize
+             );
+  if (EFI_ERROR(Status)) {
+    ASSERT(FALSE);
+  }
+
+  //
+  // If AuditMode/DeployedMode is assigned same value. Simply return EFI_SUCCESS
+  //
+  if (*VarData == *(UINT8 *)Data) {
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Perform SecureBootMode transition
+  //
+  if (StrCmp (VariableName, EFI_AUDIT_MODE_NAME) == 0) {
+    DEBUG((EFI_D_INFO, "Current SecureBootMode %x Transfer to SecureBootMode %x\n", mSecureBootMode, SecureBootModeTypeAuditMode));
+    return SecureBootModeTransition(mSecureBootMode, SecureBootModeTypeAuditMode);
+  } else if (StrCmp (VariableName, EFI_DEPLOYED_MODE_NAME) == 0) {
+    if (mSecureBootMode == SecureBootModeTypeDeployedMode) {
+      //
+      // Platform specific DeployedMode clear. InCustomMode() && UserPhysicalPresent() is checked before
+      //
+      DEBUG((EFI_D_INFO, "Current SecureBootMode %x. Transfer to SecureBootMode %x\n", mSecureBootMode, SecureBootModeTypeUserMode));
+      return SecureBootModeTransition(mSecureBootMode, SecureBootModeTypeUserMode);
+    } else {
+      DEBUG((EFI_D_INFO, "Current SecureBootMode %x. Transfer to SecureBootMode %x\n", mSecureBootMode, SecureBootModeTypeDeployedMode));
+      return SecureBootModeTransition(mSecureBootMode, SecureBootModeTypeDeployedMode);
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
 /**
   Process variable with platform key for verification.
 
@@ -917,6 +1865,7 @@ ProcessVarWithPk (
   BOOLEAN                     Del;
   UINT8                       *Payload;
   UINTN                       PayloadSize;
+  VARIABLE_ENTRY_CONSISTENCY  VariableEntry[2];
 
   if ((Attributes & EFI_VARIABLE_NON_VOLATILE) == 0 ||
       (Attributes & EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS) == 0) {
@@ -927,19 +1876,55 @@ ProcessVarWithPk (
     return EFI_INVALID_PARAMETER;
   }
 
+  //
+  // Init state of Del. State may change due to secure check
+  //
   Del = FALSE;
-  if ((InCustomMode() && UserPhysicalPresent()) || (mPlatformMode == SETUP_MODE && !IsPk)) {
-    Payload = (UINT8 *) Data + AUTHINFO2_SIZE (Data);
-    PayloadSize = DataSize - AUTHINFO2_SIZE (Data);
-    if (PayloadSize == 0) {
-      Del = TRUE;
-    }
+  Payload = (UINT8 *) Data + AUTHINFO2_SIZE (Data);
+  PayloadSize = DataSize - AUTHINFO2_SIZE (Data);
+  if (PayloadSize == 0) {
+    Del = TRUE;
+  }
+
+  //
+  // Check the variable space for both PKpub and SecureBootMode variable.
+  //
+  VariableEntry[0].VariableSize = PayloadSize;
+  VariableEntry[0].Guid         = &gEfiGlobalVariableGuid;
+  VariableEntry[0].Name         = EFI_PLATFORM_KEY_NAME;
+
+  VariableEntry[1].VariableSize = sizeof(UINT8);
+  VariableEntry[1].Guid         = &gEdkiiSecureBootModeGuid;
+  VariableEntry[1].Name         = EDKII_SECURE_BOOT_MODE_NAME;
+
+  if ((InCustomMode() && UserPhysicalPresent()) || 
+      (((mSecureBootMode == SecureBootModeTypeSetupMode) || (mSecureBootMode == SecureBootModeTypeAuditMode)) && !IsPk)) {
 
     Status = CheckSignatureListFormat(VariableName, VendorGuid, Payload, PayloadSize);
     if (EFI_ERROR (Status)) {
       return Status;
     }
 
+    //
+    // If delete PKpub, only check for "SecureBootMode" only
+    // if update / add PKpub, check both NewPKpub & "SecureBootMode"
+    //
+    if (IsPk) {
+      //
+      // Delete PKpub
+      //
+      if (Del && ((mSecureBootMode == SecureBootModeTypeUserMode) || (mSecureBootMode == SecureBootModeTypeDeployedMode)) 
+          && !mAuthVarLibContextIn->CheckRemainingSpaceForConsistency (VARIABLE_ATTRIBUTE_NV_BS_RT, &VariableEntry[1], NULL)){
+        return EFI_OUT_OF_RESOURCES;
+      //
+      // Add PKpub
+      //
+      } else if (!Del && ((mSecureBootMode == SecureBootModeTypeSetupMode) || (mSecureBootMode == SecureBootModeTypeAuditMode))
+                 && !mAuthVarLibContextIn->CheckRemainingSpaceForConsistency (VARIABLE_ATTRIBUTE_NV_BS_RT, &VariableEntry[0], &VariableEntry[1], NULL)) {
+        return EFI_OUT_OF_RESOURCES;
+      }
+    }
+
     Status = AuthServiceInternalUpdateVariableWithTimeStamp (
                VariableName,
                VendorGuid,
@@ -952,10 +1937,17 @@ ProcessVarWithPk (
       return Status;
     }
 
-    if ((mPlatformMode != SETUP_MODE) || IsPk) {
+    if (((mSecureBootMode != SecureBootModeTypeSetupMode) && (mSecureBootMode != SecureBootModeTypeAuditMode)) || IsPk) {
       Status = VendorKeyIsModified ();
     }
-  } else if (mPlatformMode == USER_MODE) {
+  } else if (mSecureBootMode == SecureBootModeTypeUserMode || mSecureBootMode == SecureBootModeTypeDeployedMode) {
+    //
+    // If delete PKpub, check "SecureBootMode" only
+    //
+    if (IsPk && Del && !mAuthVarLibContextIn->CheckRemainingSpaceForConsistency (VARIABLE_ATTRIBUTE_NV_BS_RT, &VariableEntry[1], NULL)){
+      return EFI_OUT_OF_RESOURCES;
+    }
+
     //
     // Verify against X509 Cert in PK database.
     //
@@ -970,8 +1962,19 @@ ProcessVarWithPk (
                );
   } else {
     //
+    // SetupMode or  AuditMode to add PK
     // Verify against the certificate in data payload.
     //
+    //
+    // Check PKpub & SecureBootMode variable space consistency
+    //
+    if (!mAuthVarLibContextIn->CheckRemainingSpaceForConsistency (VARIABLE_ATTRIBUTE_NV_BS_RT, &VariableEntry[0], &VariableEntry[1], NULL)) {
+      //
+      // No enough variable space to set PK successfully.
+      //
+      return EFI_OUT_OF_RESOURCES;
+    }
+
     Status = VerifyTimeBasedPayloadAndUpdate (
                VariableName,
                VendorGuid,
@@ -984,16 +1987,30 @@ ProcessVarWithPk (
   }
 
   if (!EFI_ERROR(Status) && IsPk) {
-    if (mPlatformMode == SETUP_MODE && !Del) {
-      //
-      // If enroll PK in setup mode, need change to user mode.
-      //
-      Status = UpdatePlatformMode (USER_MODE);
-    } else if (mPlatformMode == USER_MODE && Del){
-      //
-      // If delete PK in user mode, need change to setup mode.
-      //
-      Status = UpdatePlatformMode (SETUP_MODE);
+    //
+    // Delete or Enroll PK causes SecureBootMode change
+    //
+    if (!Del) {
+      if (mSecureBootMode == SecureBootModeTypeSetupMode) {
+        //
+        // If enroll PK in setup mode,  change to user mode.
+        //
+        Status = SecureBootModeTransition (mSecureBootMode, SecureBootModeTypeUserMode);
+      } else if (mSecureBootMode == SecureBootModeTypeAuditMode) {
+        //
+        // If enroll PK in Audit mode,  change to Deployed mode.
+        //
+        Status = SecureBootModeTransition (mSecureBootMode, SecureBootModeTypeDeployedMode);
+      } else {
+        DEBUG((EFI_D_INFO, "PK is updated in %x mode. No SecureBootMode change.\n", mSecureBootMode));
+      }
+    } else {
+      if ((mSecureBootMode == SecureBootModeTypeUserMode) || (mSecureBootMode == SecureBootModeTypeDeployedMode)) {
+        //
+        // If delete PK in User Mode or DeployedMode,  change to Setup Mode.
+        //
+        Status = SecureBootModeTransition (mSecureBootMode, SecureBootModeTypeSetupMode);
+      }
     }
   }
 
@@ -1046,7 +2063,8 @@ ProcessVarWithKek (
   }
 
   Status = EFI_SUCCESS;
-  if (mPlatformMode == USER_MODE && !(InCustomMode() && UserPhysicalPresent())) {
+  if ((mSecureBootMode == SecureBootModeTypeUserMode || mSecureBootMode == SecureBootModeTypeDeployedMode)
+   && !(InCustomMode() && UserPhysicalPresent())) {
     //
     // Time-based, verify against X509 Cert KEK.
     //
@@ -1083,7 +2101,7 @@ ProcessVarWithKek (
       return Status;
     }
 
-    if (mPlatformMode != SETUP_MODE) {
+    if ((mSecureBootMode != SecureBootModeTypeSetupMode) && (mSecureBootMode != SecureBootModeTypeAuditMode)) {
       Status = VendorKeyIsModified ();
     }
   }
diff --git a/SecurityPkg/Library/AuthVariableLib/AuthServiceInternal.h b/SecurityPkg/Library/AuthVariableLib/AuthServiceInternal.h
index add05c21cce4..ec4b3d97f59f 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthServiceInternal.h
+++ b/SecurityPkg/Library/AuthVariableLib/AuthServiceInternal.h
@@ -117,6 +117,54 @@ typedef struct {
 } AUTH_CERT_DB_DATA;
 #pragma pack()
 
+///
+/// "SecureBootMode" variable stores current secure boot mode.
+/// The value type is SECURE_BOOT_MODE_TYPE.
+///
+#define EDKII_SECURE_BOOT_MODE_NAME    L"SecureBootMode"
+
+typedef enum { 
+  SecureBootModeTypeUserMode,
+  SecureBootModeTypeSetupMode,
+  SecureBootModeTypeAuditMode,
+  SecureBootModeTypeDeployedMode,
+  SecureBootModeTypeMax
+} SECURE_BOOT_MODE_TYPE;
+
+//
+// Record status info of Customized Secure Boot Mode.
+//
+typedef struct {
+  ///
+  /// AuditMode variable value
+  ///
+  UINT8   AuditMode;
+  ///
+  /// AuditMode variable RW
+  ///
+  BOOLEAN IsAuditModeRO;
+  ///
+  /// DeployedMode variable value
+  ///
+  UINT8   DeployedMode;
+  ///
+  /// AuditMode variable RW
+  ///
+  BOOLEAN IsDeployedModeRO;
+  ///
+  /// SetupMode variable value
+  ///
+  UINT8   SetupMode;
+  /// 
+  /// SetupMode is always RO. Skip IsSetupModeRO;              
+  ///
+
+  ///
+  /// SecureBoot variable value
+  ///
+  UINT8   SecureBoot;
+} SECURE_BOOT_MODE;
+
 extern UINT8    *mPubKeyStore;
 extern UINT32   mPubKeyNumber;
 extern UINT32   mMaxKeyNumber;
@@ -130,6 +178,18 @@ extern VOID     *mHashCtx;
 
 extern AUTH_VAR_LIB_CONTEXT_IN *mAuthVarLibContextIn;
 
+/**
+  Initialize Secure Boot variables.
+
+  @retval EFI_SUCCESS               The initialization operation is successful.
+  @retval EFI_OUT_OF_RESOURCES      There is not enough resource.
+
+**/
+EFI_STATUS 
+InitSecureBootVariables (
+  VOID
+  );
+
 /**
   Process variable with EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS set
 
@@ -219,6 +279,39 @@ FilterSignatureList (
   IN OUT UINTN      *NewDataSize
   );
 
+/**
+  Process Secure Boot Mode variable.
+
+  Caution: This function may receive untrusted input.
+  This function may be invoked in SMM mode, and datasize and data are external input.
+  This function will do basic validation, before parse the data.
+  This function will parse the authentication carefully to avoid security issues, like
+  buffer overflow, integer overflow.
+  This function will check attribute carefully to avoid authentication bypass.
+
+  @param[in]  VariableName                Name of Variable to be found.
+  @param[in]  VendorGuid                  Variable vendor GUID.
+  @param[in]  Data                        Data pointer.
+  @param[in]  DataSize                    Size of Data found. If size is less than the
+                                          data, this value contains the required size.
+  @param[in]  Attributes                  Attribute value of the variable
+
+  @return EFI_INVALID_PARAMETER           Invalid parameter
+  @return EFI_SECURITY_VIOLATION          The variable does NOT pass the validation
+                                          check carried out by the firmware.
+  @return EFI_WRITE_PROTECTED             Variable is Read-Only.
+  @return EFI_SUCCESS                     Variable passed validation successfully.
+
+**/
+EFI_STATUS
+ProcessSecureBootModeVar (
+  IN  CHAR16         *VariableName,
+  IN  EFI_GUID       *VendorGuid,
+  IN  VOID           *Data,
+  IN  UINTN          DataSize,
+  IN  UINT32         Attributes OPTIONAL
+  );
+
 /**
   Process variable with platform key for verification.
 
diff --git a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.c b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.c
index a54eaaa066bb..dee5e1dd9d85 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.c
+++ b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.c
@@ -33,7 +33,6 @@ UINT32   mMaxKeyNumber;
 UINT32   mMaxKeyDbSize;
 UINT8    *mCertDbStore;
 UINT32   mMaxCertDbSize;
-UINT32   mPlatformMode;
 UINT8    mVendorKeyState;
 
 EFI_GUID mSignatureSupport[] = {EFI_CERT_SHA1_GUID, EFI_CERT_SHA256_GUID, EFI_CERT_RSA2048_GUID, EFI_CERT_X509_GUID};
@@ -99,6 +98,17 @@ VARIABLE_ENTRY_PROPERTY mAuthVarEntry[] = {
       MAX_UINTN
     }
   },
+  {
+    &gEdkiiSecureBootModeGuid,
+    L"SecureBootMode",
+    {
+      VAR_CHECK_VARIABLE_PROPERTY_REVISION,
+      VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY,
+      VARIABLE_ATTRIBUTE_NV_BS_RT,
+      sizeof (UINT8),
+      sizeof (UINT8)
+    }
+  }
 };
 
 VOID **mAuthVarAddressPointer[10];
@@ -132,8 +142,6 @@ AuthVariableLibInitialize (
   UINT8                 *Data;
   UINTN                 DataSize;
   UINTN                 CtxSize;
-  UINT8                 SecureBootMode;
-  UINT8                 SecureBootEnable;
   UINT8                 CustomMode;
   UINT32                ListSize;
 
@@ -208,31 +216,11 @@ AuthVariableLibInitialize (
     mPubKeyNumber = (UINT32) (DataSize / sizeof (AUTHVAR_KEY_DB_DATA));
   }
 
-  Status = AuthServiceInternalFindVariable (EFI_PLATFORM_KEY_NAME, &gEfiGlobalVariableGuid, (VOID **) &Data, &DataSize);
-  if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_INFO, "Variable %s does not exist.\n", EFI_PLATFORM_KEY_NAME));
-  } else {
-    DEBUG ((EFI_D_INFO, "Variable %s exists.\n", EFI_PLATFORM_KEY_NAME));
-  }
-
   //
-  // Create "SetupMode" variable with BS+RT attribute set.
+  // Init Secure Boot variables
   //
-  if (EFI_ERROR (Status)) {
-    mPlatformMode = SETUP_MODE;
-  } else {
-    mPlatformMode = USER_MODE;
-  }
-  Status = AuthServiceInternalUpdateVariable (
-             EFI_SETUP_MODE_NAME,
-             &gEfiGlobalVariableGuid,
-             &mPlatformMode,
-             sizeof(UINT8),
-             EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS
-             );
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
+  Status = InitSecureBootVariables ();
+
 
   //
   // Create "SignatureSupport" variable with BS+RT attribute set.
@@ -248,69 +236,6 @@ AuthVariableLibInitialize (
     return Status;
   }
 
-  //
-  // If "SecureBootEnable" variable exists, then update "SecureBoot" variable.
-  // If "SecureBootEnable" variable is SECURE_BOOT_ENABLE and in USER_MODE, Set "SecureBoot" variable to SECURE_BOOT_MODE_ENABLE.
-  // If "SecureBootEnable" variable is SECURE_BOOT_DISABLE, Set "SecureBoot" variable to SECURE_BOOT_MODE_DISABLE.
-  //
-  SecureBootEnable = SECURE_BOOT_DISABLE;
-  Status = AuthServiceInternalFindVariable (EFI_SECURE_BOOT_ENABLE_NAME, &gEfiSecureBootEnableDisableGuid, (VOID **) &Data, &DataSize);
-  if (!EFI_ERROR (Status)) {
-    if (mPlatformMode == SETUP_MODE){
-      //
-      // PK is cleared in runtime. "SecureBootMode" is not updated before reboot
-      // Delete "SecureBootMode" in SetupMode
-      //
-      Status = AuthServiceInternalUpdateVariable (
-                 EFI_SECURE_BOOT_ENABLE_NAME,
-                 &gEfiSecureBootEnableDisableGuid,
-                 &SecureBootEnable,
-                 0,
-                 EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
-                 );
-    } else {
-      SecureBootEnable = *(UINT8 *) Data;
-    }
-  } else if (mPlatformMode == USER_MODE) {
-    //
-    // "SecureBootEnable" not exist, initialize it in USER_MODE.
-    //
-    SecureBootEnable = SECURE_BOOT_ENABLE;
-    Status = AuthServiceInternalUpdateVariable (
-               EFI_SECURE_BOOT_ENABLE_NAME,
-               &gEfiSecureBootEnableDisableGuid,
-               &SecureBootEnable,
-               sizeof (UINT8),
-               EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS
-               );
-    if (EFI_ERROR (Status)) {
-      return Status;
-    }
-  }
-
-  //
-  // Create "SecureBoot" variable with BS+RT attribute set.
-  //
-  if (SecureBootEnable == SECURE_BOOT_ENABLE && mPlatformMode == USER_MODE) {
-    SecureBootMode = SECURE_BOOT_MODE_ENABLE;
-  } else {
-    SecureBootMode = SECURE_BOOT_MODE_DISABLE;
-  }
-  Status = AuthServiceInternalUpdateVariable (
-             EFI_SECURE_BOOT_MODE_NAME,
-             &gEfiGlobalVariableGuid,
-             &SecureBootMode,
-             sizeof (UINT8),
-             EFI_VARIABLE_RUNTIME_ACCESS | EFI_VARIABLE_BOOTSERVICE_ACCESS
-             );
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
-
-  DEBUG ((EFI_D_INFO, "Variable %s is %x\n", EFI_SETUP_MODE_NAME, mPlatformMode));
-  DEBUG ((EFI_D_INFO, "Variable %s is %x\n", EFI_SECURE_BOOT_MODE_NAME, SecureBootMode));
-  DEBUG ((EFI_D_INFO, "Variable %s is %x\n", EFI_SECURE_BOOT_ENABLE_NAME, SecureBootEnable));
-
   //
   // Initialize "CustomMode" in STANDARD_SECURE_BOOT_MODE state.
   //
@@ -455,10 +380,16 @@ AuthVariableLibProcessVariable (
 {
   EFI_STATUS        Status;
 
+  //
+  // Process PK, KEK, Sigdb, AuditMode, DeployedMode separately.
+  //
   if (CompareGuid (VendorGuid, &gEfiGlobalVariableGuid) && (StrCmp (VariableName, EFI_PLATFORM_KEY_NAME) == 0)){
     Status = ProcessVarWithPk (VariableName, VendorGuid, Data, DataSize, Attributes, TRUE);
   } else if (CompareGuid (VendorGuid, &gEfiGlobalVariableGuid) && (StrCmp (VariableName, EFI_KEY_EXCHANGE_KEY_NAME) == 0)) {
     Status = ProcessVarWithPk (VariableName, VendorGuid, Data, DataSize, Attributes, FALSE);
+  } else if (CompareGuid (VendorGuid, &gEfiGlobalVariableGuid) 
+          && (StrCmp (VariableName, EFI_AUDIT_MODE_NAME) == 0 || StrCmp (VariableName, EFI_DEPLOYED_MODE_NAME) == 0)) {
+    Status = ProcessSecureBootModeVar(VariableName, VendorGuid, Data, DataSize, Attributes);
   } else if (CompareGuid (VendorGuid, &gEfiImageSecurityDatabaseGuid) &&
              ((StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE)  == 0) ||
               (StrCmp (VariableName, EFI_IMAGE_SECURITY_DATABASE1) == 0) ||
diff --git a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
index 3709f7baae0b..07a3ed541932 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
+++ b/SecurityPkg/Library/AuthVariableLib/AuthVariableLib.inf
@@ -85,6 +85,10 @@
   ## PRODUCES            ## Variable:L"AuthVarKeyDatabase"
   gEfiAuthenticatedVariableGuid
 
+  ## CONSUMES            ## Variable:L"SecureBootMode"
+  ## PRODUCES            ## Variable:L"SecureBootMode"
+  gEdkiiSecureBootModeGuid
+
   gEfiCertTypeRsa2048Sha256Guid  ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the certificate.
   gEfiCertPkcs7Guid              ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the certificate.
   gEfiCertX509Guid               ## SOMETIMES_CONSUMES   ## GUID  # Unique ID for the type of the signature.
diff --git a/SecurityPkg/Library/DxeImageVerificationLib/DxeImageVerificationLib.c b/SecurityPkg/Library/DxeImageVerificationLib/DxeImageVerificationLib.c
index 5cb9f8144e2a..4b4d3bf77de5 100644
--- a/SecurityPkg/Library/DxeImageVerificationLib/DxeImageVerificationLib.c
+++ b/SecurityPkg/Library/DxeImageVerificationLib/DxeImageVerificationLib.c
@@ -711,6 +711,58 @@ GetImageExeInfoTableSize (
   return TotalSize;
 }
 
+/**
+  Create signature list based on input signature data and certificate type GUID. Caller is reposible 
+  to free new created SignatureList.
+
+  @param[in]   SignatureData           Signature data in SignatureList.
+  @param[in]   SignatureDataSize       Signature data size.
+  @param[in]   CertType                Certificate Type.
+  @param[out]  SignatureList           Created SignatureList.
+  @param[out]  SignatureListSize       Created SignatureListSize.
+
+  @return EFI_OUT_OF_RESOURCES         The operation is failed due to lack of resources.
+  @retval EFI_SUCCESS          Successfully create signature list.
+
+**/
+EFI_STATUS
+CreateSignatureList(
+  IN UINT8                *SignatureData,
+  IN UINTN                SignatureDataSize,
+  IN EFI_GUID             *CertType,
+  OUT EFI_SIGNATURE_LIST  **SignatureList,
+  OUT UINTN               *SignatureListSize
+  )
+{
+  EFI_SIGNATURE_LIST   *SignList;
+  UINTN                SignListSize;
+  EFI_SIGNATURE_DATA   *Signature;
+
+  SignList       = NULL;
+  *SignatureList = NULL;
+
+  SignListSize = sizeof (EFI_SIGNATURE_LIST) + sizeof (EFI_SIGNATURE_DATA) - 1 + SignatureDataSize;
+  SignList     = (EFI_SIGNATURE_LIST *) AllocateZeroPool (SignListSize);
+  if (SignList == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  SignList->SignatureHeaderSize = 0;
+  SignList->SignatureListSize   = (UINT32) SignListSize;
+  SignList->SignatureSize       = (UINT32) SignatureDataSize + sizeof (EFI_SIGNATURE_DATA) - 1;
+  CopyMem (&SignList->SignatureType, CertType, sizeof (EFI_GUID));
+
+  DEBUG((EFI_D_INFO, "SignatureDataSize %x\n", SignatureDataSize));
+  Signature = (EFI_SIGNATURE_DATA *) ((UINT8 *) SignList + sizeof (EFI_SIGNATURE_LIST));
+  CopyMem (Signature->SignatureData, SignatureData, SignatureDataSize);
+
+  *SignatureList     = SignList;
+  *SignatureListSize = SignListSize;
+
+  return EFI_SUCCESS;
+
+}
+
 /**
   Create an Image Execution Information Table entry and add it to system configuration table.
 
@@ -737,11 +789,13 @@ AddImageExeInfo (
   UINTN                           NewImageExeInfoEntrySize;
   UINTN                           NameStringLen;
   UINTN                           DevicePathSize;
+  CHAR16                          *NameStr;
 
   ImageExeInfoTable     = NULL;
   NewImageExeInfoTable  = NULL;
   ImageExeInfoEntry     = NULL;
   NameStringLen         = 0;
+  NameStr               = NULL;
 
   if (DevicePath == NULL) {
     return ;
@@ -769,7 +823,12 @@ AddImageExeInfo (
   }
 
   DevicePathSize            = GetDevicePathSize (DevicePath);
-  NewImageExeInfoEntrySize  = sizeof (EFI_IMAGE_EXECUTION_INFO) + NameStringLen + DevicePathSize + SignatureSize;
+
+  //
+  // Signature size can be odd. Pad after signature to ensure next EXECUTION_INFO entry align
+  //
+  NewImageExeInfoEntrySize = sizeof (EFI_IMAGE_EXECUTION_INFO) + NameStringLen + DevicePathSize + SignatureSize;
+
   NewImageExeInfoTable      = (EFI_IMAGE_EXECUTION_INFO_TABLE *) AllocateRuntimePool (ImageExeInfoTableSize + NewImageExeInfoEntrySize);
   if (NewImageExeInfoTable == NULL) {
     return ;
@@ -788,19 +847,21 @@ AddImageExeInfo (
   WriteUnaligned32 ((UINT32 *) ImageExeInfoEntry, Action);
   WriteUnaligned32 ((UINT32 *) ((UINT8 *) ImageExeInfoEntry + sizeof (EFI_IMAGE_EXECUTION_ACTION)), (UINT32) NewImageExeInfoEntrySize);
 
+  NameStr = (CHAR16 *)(ImageExeInfoEntry + 1);
   if (Name != NULL) {
-    CopyMem ((UINT8 *) ImageExeInfoEntry + sizeof (EFI_IMAGE_EXECUTION_ACTION) + sizeof (UINT32), Name, NameStringLen);
+    CopyMem ((UINT8 *) NameStr, Name, NameStringLen);
   } else {
-    ZeroMem ((UINT8 *) ImageExeInfoEntry + sizeof (EFI_IMAGE_EXECUTION_ACTION) + sizeof (UINT32), sizeof (CHAR16));
+    ZeroMem ((UINT8 *) NameStr, sizeof (CHAR16));
   }
+
   CopyMem (
-    (UINT8 *) ImageExeInfoEntry + sizeof (EFI_IMAGE_EXECUTION_ACTION) + sizeof (UINT32) + NameStringLen,
+    (UINT8 *) NameStr + NameStringLen,
     DevicePath,
     DevicePathSize
     );
   if (Signature != NULL) {
     CopyMem (
-      (UINT8 *) ImageExeInfoEntry + sizeof (EFI_IMAGE_EXECUTION_ACTION) + sizeof (UINT32) + NameStringLen + DevicePathSize,
+      (UINT8 *) NameStr + NameStringLen + DevicePathSize,
       Signature,
       SignatureSize
       );
@@ -1087,6 +1148,53 @@ IsTimeZero (
   return FALSE;
 }
 
+/**
+  Record multiple certificate list & verification state of a verified image to 
+  IMAGE_EXECUTION_TABLE.
+
+  @param[in]  CertBuf              Certificate list buffer.
+  @param[in]  CertBufLength        Certificate list buffer.
+  @param[in]  Action               Certificate list action to be record.
+  @param[in]  ImageName            Image name.
+  @param[in]  ImageDevicePath      Image device path.
+
+**/
+VOID 
+RecordCertListToImageExeuctionTable(
+  IN UINT8                          *CertBuf,
+  IN UINTN                           CertBufLength,
+  IN EFI_IMAGE_EXECUTION_ACTION      Action,
+  IN CHAR16                         *ImageName OPTIONAL,
+  IN CONST EFI_DEVICE_PATH_PROTOCOL *ImageDevicePath OPTIONAL
+  )
+{
+  UINT8               CertNumber;
+  UINT8               *CertPtr;
+  UINTN               Index;
+  UINT8               *Cert;
+  UINTN               CertSize;
+  EFI_STATUS          Status;
+  EFI_SIGNATURE_LIST  *SignatureList;
+  UINTN               SignatureListSize;
+
+  CertNumber = (UINT8) (*CertBuf);
+  CertPtr    = CertBuf + 1;
+  for (Index = 0; Index < CertNumber; Index++) {
+    CertSize = (UINTN) ReadUnaligned32 ((UINT32 *)CertPtr);
+    Cert     = (UINT8 *)CertPtr + sizeof (UINT32);
+
+    //
+    // Record all cert in cert chain to be passed
+    //
+    Status = CreateSignatureList(Cert, CertSize, &gEfiCertX509Guid, &SignatureList, &SignatureListSize);
+    if (!EFI_ERROR(Status)) {
+      AddImageExeInfo (Action, ImageName, ImageDevicePath, SignatureList, SignatureListSize);
+      FreePool (SignatureList);
+    }
+  }
+}
+
+
 /**
   Check whether the timestamp signature is valid and the signing time is also earlier than 
   the revocation time.
@@ -1197,8 +1305,11 @@ PassTimestampCheck (
   Check whether the image signature is forbidden by the forbidden database (dbx).
   The image is forbidden to load if any certificates for signing are revoked before signing time.
 
-  @param[in]  AuthData      Pointer to the Authenticode signature retrieved from the signed image.
-  @param[in]  AuthDataSize  Size of the Authenticode signature in bytes.
+  @param[in]  AuthData             Pointer to the Authenticode signature retrieved from the signed image.
+  @param[in]  AuthDataSize         Size of the Authenticode signature in bytes.
+  @param[in]  IsAuditMode          Whether system Secure Boot Mode is in AuditMode.
+  @param[in]  ImageName            Name of the image to verify.
+  @param[in]  ImageDevicePath      DevicePath of the image to verify.
 
   @retval TRUE              Image is forbidden by dbx.
   @retval FALSE             Image is not forbidden by dbx.
@@ -1206,8 +1317,11 @@ PassTimestampCheck (
 **/
 BOOLEAN
 IsForbiddenByDbx (
-  IN UINT8                  *AuthData,
-  IN UINTN                  AuthDataSize
+  IN UINT8                          *AuthData,
+  IN UINTN                          AuthDataSize,
+  IN BOOLEAN                        IsAuditMode,
+  IN CHAR16                         *ImageName OPTIONAL,
+  IN CONST EFI_DEVICE_PATH_PROTOCOL *ImageDevicePath OPTIONAL
   )
 {
   EFI_STATUS                Status;
@@ -1230,7 +1344,10 @@ IsForbiddenByDbx (
   UINT8                     *Cert;
   UINTN                     CertSize;
   EFI_TIME                  RevocationTime;
-
+  UINT8                     *SignerCert;
+  UINTN                     SignerCertLength;
+  UINT8                     *UnchainCert;
+  UINTN                     UnchainCertLength;
   //
   // Variable Initialization
   //
@@ -1245,6 +1362,10 @@ IsForbiddenByDbx (
   BufferLength      = 0;
   TrustedCert       = NULL;
   TrustedCertLength = 0;
+  SignerCert        = NULL;
+  SignerCertLength  = 0;
+  UnchainCert       = NULL;
+  UnchainCertLength = 0;
 
   //
   // The image will not be forbidden if dbx can't be got.
@@ -1352,21 +1473,54 @@ IsForbiddenByDbx (
   }
 
 Done:
+  if (IsForbidden && IsAuditMode) {
+    Pkcs7GetCertificatesList(AuthData, AuthDataSize, &SignerCert, &SignerCertLength, &UnchainCert, &UnchainCertLength);
+
+    //
+    // Record all certs in image to be failed
+    //
+    if ((SignerCertLength != 0) && (SignerCert != NULL)) {
+      RecordCertListToImageExeuctionTable(
+        SignerCert,
+        SignerCertLength,
+        EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED,
+        ImageName,
+        ImageDevicePath
+        );
+    }
+
+    if ((UnchainCertLength != 0) && (UnchainCert != NULL)) {
+      RecordCertListToImageExeuctionTable(
+        UnchainCert,
+        UnchainCertLength,
+        EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED,
+        ImageName,
+        ImageDevicePath
+        );
+    }
+  }
+
   if (Data != NULL) {
     FreePool (Data);
   }
 
   Pkcs7FreeSigners (CertBuffer);
   Pkcs7FreeSigners (TrustedCert);
+  Pkcs7FreeSigners (SignerCert);
+  Pkcs7FreeSigners (UnchainCert);
 
   return IsForbidden;
 }
 
+
 /**
   Check whether the image signature can be verified by the trusted certificates in DB database.
 
-  @param[in]  AuthData      Pointer to the Authenticode signature retrieved from signed image.
-  @param[in]  AuthDataSize  Size of the Authenticode signature in bytes.
+  @param[in]  AuthData              Pointer to the Authenticode signature retrieved from signed image.
+  @param[in]  AuthDataSize          Size of the Authenticode signature in bytes.
+  @param[in]  IsAuditMode           Whether system Secure Boot Mode is in AuditMode.
+  @param[in]  ImageName             Name of the image to verify.
+  @param[in]  ImageDevicePath       DevicePath of the image to verify.
 
   @retval TRUE         Image passed verification using certificate in db.
   @retval FALSE        Image didn't pass verification using certificate in db.
@@ -1374,14 +1528,17 @@ IsForbiddenByDbx (
 **/
 BOOLEAN
 IsAllowedByDb (
-  IN UINT8              *AuthData,
-  IN UINTN              AuthDataSize
+  IN UINT8                          *AuthData,
+  IN UINTN                          AuthDataSize,
+  IN BOOLEAN                        IsAuditMode,
+  IN CHAR16                         *ImageName OPTIONAL,
+  IN CONST EFI_DEVICE_PATH_PROTOCOL *ImageDevicePath OPTIONAL
   )
 {
   EFI_STATUS                Status;
   BOOLEAN                   VerifyStatus;
   EFI_SIGNATURE_LIST        *CertList;
-  EFI_SIGNATURE_DATA        *Cert;
+  EFI_SIGNATURE_DATA        *CertData;
   UINTN                     DataSize;
   UINT8                     *Data;
   UINT8                     *RootCert;
@@ -1391,14 +1548,22 @@ IsAllowedByDb (
   UINTN                     DbxDataSize;
   UINT8                     *DbxData;
   EFI_TIME                  RevocationTime;
+  UINT8                     *SignerCert;
+  UINTN                     SignerCertLength;
+  UINT8                     *UnchainCert;
+  UINTN                     UnchainCertLength;
 
-  Data         = NULL;
-  CertList     = NULL;
-  Cert         = NULL;
-  RootCert     = NULL;
-  DbxData      = NULL;
-  RootCertSize = 0;
-  VerifyStatus = FALSE;
+  Data              = NULL;
+  CertList          = NULL;
+  CertData          = NULL;
+  RootCert          = NULL;
+  DbxData           = NULL;
+  RootCertSize      = 0;
+  VerifyStatus      = FALSE;
+  SignerCert        = NULL;
+  SignerCertLength  = 0;
+  UnchainCert       = NULL;
+  UnchainCertLength = 0;
 
   DataSize = 0;
   Status   = gRT->GetVariable (EFI_IMAGE_SECURITY_DATABASE, &gEfiImageSecurityDatabaseGuid, NULL, &DataSize, NULL);
@@ -1419,14 +1584,14 @@ IsAllowedByDb (
     CertList = (EFI_SIGNATURE_LIST *) Data;
     while ((DataSize > 0) && (DataSize >= CertList->SignatureListSize)) {
       if (CompareGuid (&CertList->SignatureType, &gEfiCertX509Guid)) {
-        Cert       = (EFI_SIGNATURE_DATA *) ((UINT8 *) CertList + sizeof (EFI_SIGNATURE_LIST) + CertList->SignatureHeaderSize);
-        CertCount  = (CertList->SignatureListSize - sizeof (EFI_SIGNATURE_LIST) - CertList->SignatureHeaderSize) / CertList->SignatureSize;
+        CertData  = (EFI_SIGNATURE_DATA *) ((UINT8 *) CertList + sizeof (EFI_SIGNATURE_LIST) + CertList->SignatureHeaderSize);
+        CertCount = (CertList->SignatureListSize - sizeof (EFI_SIGNATURE_LIST) - CertList->SignatureHeaderSize) / CertList->SignatureSize;
 
         for (Index = 0; Index < CertCount; Index++) {
           //
           // Iterate each Signature Data Node within this CertList for verify.
           //
-          RootCert     = Cert->SignatureData;
+          RootCert     = CertData->SignatureData;
           RootCertSize = CertList->SignatureSize - sizeof (EFI_GUID);
 
           //
@@ -1468,7 +1633,7 @@ IsAllowedByDb (
             goto Done;
           }
 
-          Cert = (EFI_SIGNATURE_DATA *) ((UINT8 *) Cert + CertList->SignatureSize);
+          CertData = (EFI_SIGNATURE_DATA *) ((UINT8 *) CertData + CertList->SignatureSize);
         }
       }
 
@@ -1478,10 +1643,67 @@ IsAllowedByDb (
   }
 
 Done:
+
   if (VerifyStatus) {
-    SecureBootHook (EFI_IMAGE_SECURITY_DATABASE, &gEfiImageSecurityDatabaseGuid, CertList->SignatureSize, Cert);
+    SecureBootHook (EFI_IMAGE_SECURITY_DATABASE, &gEfiImageSecurityDatabaseGuid, CertList->SignatureSize, CertData);
+  }
+
+  if (IsAuditMode) {
+
+    Pkcs7GetCertificatesList(AuthData, AuthDataSize, &SignerCert, &SignerCertLength, &UnchainCert, &UnchainCertLength);
+    if (VerifyStatus) {
+      if ((SignerCertLength != 0) && (SignerCert != NULL)) {
+        //
+        // Record all cert in signer's cert chain to be passed
+        //
+        RecordCertListToImageExeuctionTable(
+          SignerCert,
+          SignerCertLength,
+          EFI_IMAGE_EXECUTION_AUTH_SIG_PASSED | EFI_IMAGE_EXECUTION_INITIALIZED,
+          ImageName,
+          ImageDevicePath
+          );
+      }
+
+      if ((UnchainCertLength != 0) && (UnchainCert != NULL)) {
+        //
+        // Record all certs in unchained certificates lists to be failed
+        //
+        RecordCertListToImageExeuctionTable(
+          UnchainCert,
+          UnchainCertLength,
+          EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED,
+          ImageName,
+          ImageDevicePath
+          );
+      }
+    } else {
+      //
+      // Record all certs in image to be failed
+      //
+      if ((SignerCertLength != 0) && (SignerCert != NULL)) {
+        RecordCertListToImageExeuctionTable(
+          SignerCert,
+          SignerCertLength,
+          EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED,
+          ImageName,
+          ImageDevicePath
+          );
+      }
+
+      if ((UnchainCertLength != 0) && (UnchainCert != NULL)) {
+        RecordCertListToImageExeuctionTable(
+          UnchainCert,
+          UnchainCertLength,
+          EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED,
+          ImageName,
+          ImageDevicePath
+          );
+      }
+    }
   }
 
+
   if (Data != NULL) {
     FreePool (Data);
   }
@@ -1489,9 +1711,369 @@ IsAllowedByDb (
     FreePool (DbxData);
   }
 
+  Pkcs7FreeSigners (SignerCert);
+  Pkcs7FreeSigners (UnchainCert);
+
   return VerifyStatus;
 }
 
+/**
+  Provide verification service for signed images in AuditMode, which include both signature validation
+  and platform policy control. For signature types, both UEFI WIN_CERTIFICATE_UEFI_GUID and
+  MSFT Authenticode type signatures are supported. 
+
+  In this implementation, only verify external executables when in AuditMode.
+  Executables from FV is bypass, so pass in AuthenticationStatus is ignored. Other authentication status
+  are record into IMAGE_EXECUTION_TABLE.
+
+  The image verification policy is:
+    If the image is signed,
+      At least one valid signature or at least one hash value of the image must match a record
+      in the security database "db", and no valid signature nor any hash value of the image may
+      be reflected in the security database "dbx".
+    Otherwise, the image is not signed,
+      The SHA256 hash value of the image must match a record in the security database "db", and
+      not be reflected in the security data base "dbx".
+
+  Caution: This function may receive untrusted input.
+  PE/COFF image is external input, so this function will validate its data structure
+  within this image buffer before use.
+
+  @param[in]    AuthenticationStatus
+                           This is the authentication status returned from the security
+                           measurement services for the input file.
+  @param[in]    File       This is a pointer to the device path of the file that is
+                           being dispatched. This will optionally be used for logging.
+  @param[in]    FileBuffer File buffer matches the input file device path.
+  @param[in]    FileSize   Size of File buffer matches the input file device path.
+  @param[in]    BootPolicy A boot policy that was used to call LoadImage() UEFI service.
+
+  @retval EFI_SUCCESS            The authenticate info is sucessfully stored for the file 
+                                 specified by DevicePath and non-NULL FileBuffer 
+  @retval EFI_ACCESS_DENIED      The file specified by File and FileBuffer did not
+                                 authenticate, and the platform policy dictates that the DXE
+                                 Foundation many not use File.
+
+**/
+EFI_STATUS
+EFIAPI
+ImageVerificationInAuditMode (
+  IN  UINT32                           AuthenticationStatus,
+  IN  CONST EFI_DEVICE_PATH_PROTOCOL   *File,
+  IN  VOID                             *FileBuffer,
+  IN  UINTN                            FileSize,
+  IN  BOOLEAN                          BootPolicy
+  )
+{
+  EFI_STATUS                           Status;
+  UINT16                               Magic;
+  EFI_IMAGE_DOS_HEADER                 *DosHdr;
+  EFI_SIGNATURE_LIST                   *SignatureList;
+  EFI_IMAGE_EXECUTION_ACTION           Action;
+  WIN_CERTIFICATE                      *WinCertificate;
+  UINT32                               Policy;
+  PE_COFF_LOADER_IMAGE_CONTEXT         ImageContext;
+  UINT32                               NumberOfRvaAndSizes;
+  WIN_CERTIFICATE_EFI_PKCS             *PkcsCertData;
+  WIN_CERTIFICATE_UEFI_GUID            *WinCertUefiGuid;
+  UINT8                                *AuthData;
+  UINTN                                AuthDataSize;
+  EFI_IMAGE_DATA_DIRECTORY             *SecDataDir;
+  UINT32                               OffSet;
+  CHAR16                               *FilePathStr;
+  UINTN                                SignatureListSize;
+
+  SignatureList     = NULL;
+  WinCertificate    = NULL;
+  SecDataDir        = NULL;
+  PkcsCertData      = NULL;
+  FilePathStr       = NULL;
+  Action            = EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED;
+  Status            = EFI_ACCESS_DENIED;
+
+
+  //
+  // Check the image type and get policy setting.
+  //
+  switch (GetImageType (File)) {
+
+  case IMAGE_FROM_FV:
+    Policy = ALWAYS_EXECUTE;
+    break;
+
+  case IMAGE_FROM_OPTION_ROM:
+    Policy = PcdGet32 (PcdOptionRomImageVerificationPolicy);
+    break;
+
+  case IMAGE_FROM_REMOVABLE_MEDIA:
+    Policy = PcdGet32 (PcdRemovableMediaImageVerificationPolicy);
+    break;
+
+  case IMAGE_FROM_FIXED_MEDIA:
+    Policy = PcdGet32 (PcdFixedMediaImageVerificationPolicy);
+    break;
+
+  default:
+    Policy = DENY_EXECUTE_ON_SECURITY_VIOLATION;
+    break;
+  }
+
+  //
+  // If policy is always/never execute, return directly.
+  //
+  if (Policy == ALWAYS_EXECUTE) {
+    return EFI_SUCCESS;
+  }
+
+  //
+  // Get Image Device Path Str
+  //
+  FilePathStr = ConvertDevicePathToText (File, FALSE, TRUE);
+
+  //
+  // Authentication failed because of (unspecified) firmware security policy
+  //
+  if (Policy == NEVER_EXECUTE) {
+    //
+    // No signature, record FilePath/FilePathStr only
+    //
+    AddImageExeInfo (EFI_IMAGE_EXECUTION_POLICY_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED, FilePathStr, File, NULL, 0);
+    goto END;
+  }
+
+  //
+  // The policy QUERY_USER_ON_SECURITY_VIOLATION and ALLOW_EXECUTE_ON_SECURITY_VIOLATION
+  // violates the UEFI spec and has been removed.
+  //
+  ASSERT (Policy != QUERY_USER_ON_SECURITY_VIOLATION && Policy != ALLOW_EXECUTE_ON_SECURITY_VIOLATION);
+  if (Policy == QUERY_USER_ON_SECURITY_VIOLATION || Policy == ALLOW_EXECUTE_ON_SECURITY_VIOLATION) {
+    CpuDeadLoop ();
+  }
+
+  //
+  // Read the Dos header.
+  //
+  if (FileBuffer == NULL) {
+    Status = EFI_INVALID_PARAMETER;
+    goto END;
+  }
+
+  mImageBase  = (UINT8 *) FileBuffer;
+  mImageSize  = FileSize;
+
+  ZeroMem (&ImageContext, sizeof (ImageContext));
+  ImageContext.Handle    = (VOID *) FileBuffer;
+  ImageContext.ImageRead = (PE_COFF_LOADER_READ_FILE) DxeImageVerificationLibImageRead;
+
+  //
+  // Get information about the image being loaded
+  //
+  Status = PeCoffLoaderGetImageInfo (&ImageContext);
+  if (EFI_ERROR (Status)) {
+    //
+    // The information can't be got from the invalid PeImage
+    //
+    goto END;
+  }
+
+
+  DosHdr = (EFI_IMAGE_DOS_HEADER *) mImageBase;
+  if (DosHdr->e_magic == EFI_IMAGE_DOS_SIGNATURE) {
+    //
+    // DOS image header is present,
+    // so read the PE header after the DOS image header.
+    //
+    mPeCoffHeaderOffset = DosHdr->e_lfanew;
+  } else {
+    mPeCoffHeaderOffset = 0;
+  }
+
+  //
+  // Check PE/COFF image.
+  //
+  mNtHeader.Pe32 = (EFI_IMAGE_NT_HEADERS32 *) (mImageBase + mPeCoffHeaderOffset);
+  if (mNtHeader.Pe32->Signature != EFI_IMAGE_NT_SIGNATURE) {
+    //
+    // It is not a valid Pe/Coff file.
+    //
+    Status = EFI_ACCESS_DENIED;
+    goto END;
+  }
+
+  if (mNtHeader.Pe32->FileHeader.Machine == IMAGE_FILE_MACHINE_IA64 && mNtHeader.Pe32->OptionalHeader.Magic == EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC) {
+    //
+    // NOTE: Some versions of Linux ELILO for Itanium have an incorrect magic value
+    //       in the PE/COFF Header. If the MachineType is Itanium(IA64) and the
+    //       Magic value in the OptionalHeader is EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC
+    //       then override the magic value to EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC
+    //
+    Magic = EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC;
+  } else {
+    //
+    // Get the magic value from the PE/COFF Optional Header
+    //
+    Magic = mNtHeader.Pe32->OptionalHeader.Magic;
+  }
+
+  if (Magic == EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC) {
+    //
+    // Use PE32 offset.
+    //
+    NumberOfRvaAndSizes = mNtHeader.Pe32->OptionalHeader.NumberOfRvaAndSizes;
+    if (NumberOfRvaAndSizes > EFI_IMAGE_DIRECTORY_ENTRY_SECURITY) {
+      SecDataDir = (EFI_IMAGE_DATA_DIRECTORY *) &mNtHeader.Pe32->OptionalHeader.DataDirectory[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY];
+    }
+  } else {
+    //
+    // Use PE32+ offset.
+    //
+    NumberOfRvaAndSizes = mNtHeader.Pe32Plus->OptionalHeader.NumberOfRvaAndSizes;
+    if (NumberOfRvaAndSizes > EFI_IMAGE_DIRECTORY_ENTRY_SECURITY) {
+      SecDataDir = (EFI_IMAGE_DATA_DIRECTORY *) &mNtHeader.Pe32Plus->OptionalHeader.DataDirectory[EFI_IMAGE_DIRECTORY_ENTRY_SECURITY];
+    }
+  }
+
+  //
+  // Start Image Validation.
+  //
+  if (SecDataDir == NULL || SecDataDir->Size == 0) {
+    //
+    // This image is not signed. The SHA256 hash value of the image must match a record in the security database "db",
+    // and not be reflected in the security data base "dbx".
+    //
+    if (!HashPeImage (HASHALG_SHA256)) {
+      Status = EFI_ACCESS_DENIED;
+      goto END;
+    }
+
+    //
+    // Image Hash is in forbidden database (DBX).
+    //
+    if (!IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE1, mImageDigest, &mCertType, mImageDigestSize)) {
+      //
+      // Image Hash is in allowed database (DB).
+      //
+      if (IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE, mImageDigest, &mCertType, mImageDigestSize)) {
+        Action = EFI_IMAGE_EXECUTION_AUTH_SIG_PASSED | EFI_IMAGE_EXECUTION_INITIALIZED;
+      }
+    }
+
+    //
+    // Add HASH digest for image without signature
+    //
+    Status = CreateSignatureList(mImageDigest, mImageDigestSize, &mCertType, &SignatureList, &SignatureListSize);
+    if (!EFI_ERROR(Status)) {
+      AddImageExeInfo (Action, FilePathStr, File, SignatureList, SignatureListSize);
+      FreePool (SignatureList);
+    }
+    goto END;
+  }
+
+  //
+  // Verify the signature of the image, multiple signatures are allowed as per PE/COFF Section 4.7
+  // "Attribute Certificate Table".
+  // The first certificate starts at offset (SecDataDir->VirtualAddress) from the start of the file.
+  //
+  for (OffSet = SecDataDir->VirtualAddress;
+       OffSet < (SecDataDir->VirtualAddress + SecDataDir->Size);
+       OffSet += (WinCertificate->dwLength + ALIGN_SIZE (WinCertificate->dwLength))) {
+    WinCertificate = (WIN_CERTIFICATE *) (mImageBase + OffSet);
+    if ((SecDataDir->VirtualAddress + SecDataDir->Size - OffSet) <= sizeof (WIN_CERTIFICATE) ||
+        (SecDataDir->VirtualAddress + SecDataDir->Size - OffSet) < WinCertificate->dwLength) {
+      break;
+    }
+
+    //
+    // Verify the image's Authenticode signature, only DER-encoded PKCS#7 signed data is supported.
+    //
+    if (WinCertificate->wCertificateType == WIN_CERT_TYPE_PKCS_SIGNED_DATA) {
+      //
+      // The certificate is formatted as WIN_CERTIFICATE_EFI_PKCS which is described in the
+      // Authenticode specification.
+      //
+      PkcsCertData = (WIN_CERTIFICATE_EFI_PKCS *) WinCertificate;
+      if (PkcsCertData->Hdr.dwLength <= sizeof (PkcsCertData->Hdr)) {
+        break;
+      }
+      AuthData   = PkcsCertData->CertData;
+      AuthDataSize = PkcsCertData->Hdr.dwLength - sizeof(PkcsCertData->Hdr);
+    } else if (WinCertificate->wCertificateType == WIN_CERT_TYPE_EFI_GUID) {
+      //
+      // The certificate is formatted as WIN_CERTIFICATE_UEFI_GUID which is described in UEFI Spec.
+      //
+      WinCertUefiGuid = (WIN_CERTIFICATE_UEFI_GUID *) WinCertificate;
+      if (WinCertUefiGuid->Hdr.dwLength <= OFFSET_OF(WIN_CERTIFICATE_UEFI_GUID, CertData)) {
+        break;
+      }
+      if (!CompareGuid (&WinCertUefiGuid->CertType, &gEfiCertPkcs7Guid)) {
+        continue;
+      }
+      AuthData = WinCertUefiGuid->CertData;
+      AuthDataSize = WinCertUefiGuid->Hdr.dwLength - OFFSET_OF(WIN_CERTIFICATE_UEFI_GUID, CertData);
+    } else {
+      if (WinCertificate->dwLength < sizeof (WIN_CERTIFICATE)) {
+        break;
+      }
+      continue;
+    }
+
+    Status = HashPeImageByType (AuthData, AuthDataSize);
+    if (EFI_ERROR (Status)) {
+      continue;
+    }
+
+    Action = EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED | EFI_IMAGE_EXECUTION_INITIALIZED;
+
+    //
+    // Check the digital signature against the revoked certificate in forbidden database (dbx).
+    // Check the digital signature against the valid certificate in allowed database (db).
+    //
+    if (!IsForbiddenByDbx (AuthData, AuthDataSize, TRUE, FilePathStr, File)) {
+      IsAllowedByDb (AuthData, AuthDataSize, TRUE, FilePathStr, File);
+    }
+
+    //
+    // Check the image's hash value.
+    //
+    if (!IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE1, mImageDigest, &mCertType, mImageDigestSize)) {
+      if (IsSignatureFoundInDatabase (EFI_IMAGE_SECURITY_DATABASE, mImageDigest, &mCertType, mImageDigestSize)) {
+        Action = EFI_IMAGE_EXECUTION_AUTH_SIG_PASSED | EFI_IMAGE_EXECUTION_INITIALIZED; 
+      }
+    }
+
+    //
+    // Add HASH digest for image with signature
+    //
+    Status = CreateSignatureList(mImageDigest, mImageDigestSize, &mCertType, &SignatureList, &SignatureListSize);
+
+    if (!EFI_ERROR(Status)) {
+      AddImageExeInfo (Action, FilePathStr, File, SignatureList, SignatureListSize);
+      FreePool (SignatureList);
+    } else {
+      goto END;
+    }
+  }
+
+
+  if (OffSet != (SecDataDir->VirtualAddress + SecDataDir->Size)) {
+    //
+    // The Size in Certificate Table or the attribute certicate table is corrupted.
+    //
+    Status = EFI_ACCESS_DENIED;
+  } else {
+    Status = EFI_SUCCESS;
+  }
+
+END:
+
+  if (FilePathStr != NULL) {
+    FreePool(FilePathStr);
+    FilePathStr = NULL;
+  }
+
+  return Status;
+}
+
 /**
   Provide verification service for signed images, which include both signature validation
   and platform policy control. For signature types, both UEFI WIN_CERTIFICATE_UEFI_GUID and
@@ -1559,7 +2141,9 @@ DxeImageVerificationHandler (
   EFI_IMAGE_EXECUTION_ACTION           Action;
   WIN_CERTIFICATE                      *WinCertificate;
   UINT32                               Policy;
-  UINT8                                *SecureBoot;
+  UINT8                                *VarData;
+  UINT8                                SecureBoot;
+  UINT8                                AuditMode;
   PE_COFF_LOADER_IMAGE_CONTEXT         ImageContext;
   UINT32                               NumberOfRvaAndSizes;
   WIN_CERTIFICATE_EFI_PKCS             *PkcsCertData;
@@ -1579,6 +2163,20 @@ DxeImageVerificationHandler (
   Status            = EFI_ACCESS_DENIED;
   VerifyStatus      = EFI_ACCESS_DENIED;
 
+  GetEfiGlobalVariable2 (EFI_AUDIT_MODE_NAME, (VOID**)&VarData, NULL);
+  //
+  // Skip verification if AuditMode variable doesn't exist. AuditMode should always exist
+  //
+  if (VarData == NULL) {
+    return EFI_SUCCESS;
+  }
+  AuditMode = *VarData;
+  FreePool(VarData);
+
+  if (AuditMode == AUDIT_MODE_ENABLE) {
+    return ImageVerificationInAuditMode(AuthenticationStatus, File, FileBuffer, FileSize, BootPolicy);
+  }
+
   //
   // Check the image type and get policy setting.
   //
@@ -1622,22 +2220,22 @@ DxeImageVerificationHandler (
     CpuDeadLoop ();
   }
 
-  GetEfiGlobalVariable2 (EFI_SECURE_BOOT_MODE_NAME, (VOID**)&SecureBoot, NULL);
+  GetEfiGlobalVariable2 (EFI_SECURE_BOOT_MODE_NAME, (VOID**)&VarData, NULL);
   //
   // Skip verification if SecureBoot variable doesn't exist.
   //
-  if (SecureBoot == NULL) {
+  if (VarData == NULL) {
     return EFI_SUCCESS;
   }
+  SecureBoot = *VarData;
+  FreePool(VarData);
 
   //
-  // Skip verification if SecureBoot is disabled.
+  // Skip verification if SecureBoot is disabled but not AuditMode
   //
-  if (*SecureBoot == SECURE_BOOT_MODE_DISABLE) {
-    FreePool (SecureBoot);
+  if (SecureBoot == SECURE_BOOT_MODE_DISABLE) {
     return EFI_SUCCESS;
   }
-  FreePool (SecureBoot);
 
   //
   // Read the Dos header.
@@ -1808,7 +2406,7 @@ DxeImageVerificationHandler (
     //
     // Check the digital signature against the revoked certificate in forbidden database (dbx).
     //
-    if (IsForbiddenByDbx (AuthData, AuthDataSize)) {
+    if (IsForbiddenByDbx (AuthData, AuthDataSize, FALSE, NULL, NULL)) {
       Action = EFI_IMAGE_EXECUTION_AUTH_SIG_FAILED;
       VerifyStatus = EFI_ACCESS_DENIED;
       break;
@@ -1818,7 +2416,7 @@ DxeImageVerificationHandler (
     // Check the digital signature against the valid certificate in allowed database (db).
     //
     if (EFI_ERROR (VerifyStatus)) {
-      if (IsAllowedByDb (AuthData, AuthDataSize)) {
+      if (IsAllowedByDb (AuthData, AuthDataSize, FALSE, NULL, NULL)) {
         VerifyStatus = EFI_SUCCESS;
       }
     }

From f8d51f2e2705229aaceae1e53f4eb8fb993fc0d4 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:19:10 +0000
Subject: [PATCH 212/525] SecurityPkg: SecureBootConfigDxe: SecureBoot UI for
 Customized SecureBoot Mode

  Add SecureBoot UI support for Customized SecureBoot Mode transition according to Mantis 1263. User can do secure boot mode transition through UI.
  https://mantis.uefi.org/mantis/view.php?id=1263

(Sync patch r19134 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Zeng Star <star.zeng@intel.com>
Reviewed-by: Long Qin <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19190 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SecureBootConfigDxe/SecureBootConfig.vfr  |  77 +++-
 .../SecureBootConfigImpl.c                    | 432 ++++++++++++++++--
 .../SecureBootConfigNvData.h                  |  13 +-
 .../SecureBootConfigStrings.uni               | Bin 13086 -> 14876 bytes
 4 files changed, 465 insertions(+), 57 deletions(-)

diff --git a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
index 3c994317f74b..1eb3599279d8 100644
--- a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
+++ b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
@@ -1,7 +1,7 @@
 /** @file
   VFR file used by the SecureBoot configuration component.
 
-Copyright (c) 2011 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -33,6 +33,14 @@ formset
 
     subtitle text = STRING_TOKEN(STR_NULL);
 
+    //
+    // Display current secure boot mode(one of SetupMode/AuditMode/UserMode/DeployedMode)
+    //
+    text
+      help   = STRING_TOKEN(STR_CUR_SECURE_BOOT_MODE_HELP),
+      text   = STRING_TOKEN(STR_CUR_SECURE_BOOT_MODE_PROMPT),
+        text   = STRING_TOKEN(STR_CUR_SECURE_BOOT_MODE_CONTENT);
+
     text
       help   = STRING_TOKEN(STR_SECURE_BOOT_STATE_HELP),
       text   = STRING_TOKEN(STR_SECURE_BOOT_STATE_PROMPT),
@@ -84,18 +92,18 @@ formset
       endoneof;
 
     //
-    //
-    // Display of 'Current Secure Boot Mode'
+    // Display PK include page
     //
     suppressif questionref(SecureBootMode) == SECURE_BOOT_MODE_STANDARD;
-      grayoutif NOT ideqval SECUREBOOT_CONFIGURATION.PhysicalPresent == 1;
-      goto FORMID_SECURE_BOOT_OPTION_FORM,
-           prompt = STRING_TOKEN(STR_SECURE_BOOT_OPTION),
-           help   = STRING_TOKEN(STR_SECURE_BOOT_OPTION_HELP),
-           flags  = INTERACTIVE,
-           key    = KEY_SECURE_BOOT_OPTION;
-      endif;
+    grayoutif NOT ideqval SECUREBOOT_CONFIGURATION.PhysicalPresent == 1;
+    goto FORMID_SECURE_BOOT_OPTION_FORM,
+         prompt = STRING_TOKEN(STR_SECURE_BOOT_OPTION),
+         help   = STRING_TOKEN(STR_SECURE_BOOT_OPTION_HELP),
+         flags  = INTERACTIVE,
+         key    = KEY_SECURE_BOOT_OPTION;
+    endif;
     endif;
+
   endform;
 
   //
@@ -106,6 +114,55 @@ formset
 
     subtitle text = STRING_TOKEN(STR_NULL);
 
+    //
+    // Display of SetupMode/UserMode/AuditMode/DeployedMode transition
+    //
+    disableif TRUE;
+      oneof varid  = SECUREBOOT_CONFIGURATION.TransSecureBootMode,
+            prompt = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_PROMPT),
+            help   = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_HELP),
+            flags  = INTERACTIVE,
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE
+              OR (ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE AND
+                  ideqval SECUREBOOT_CONFIGURATION.PhysicalPresent == 0);
+            option text = STRING_TOKEN(STR_USER_MODE),     value = SECURE_BOOT_MODE_USER_MODE,   flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE;
+            option text = STRING_TOKEN(STR_SETUP_MODE),    value = SECURE_BOOT_MODE_SETUP_MODE,  flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE;
+            option text = STRING_TOKEN(STR_AUDIT_MODE),    value = SECURE_BOOT_MODE_AUDIT_MODE,  flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE;
+            option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = SECURE_BOOT_MODE_DEPLOYED_MODE,  flags = 0;
+      endif
+            option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = 4,  flags = 0;
+      endoneof;
+    endif;
+      oneof name   = TransSecureBootMode,
+            questionid = KEY_TRANS_SECURE_BOOT_MODE,
+            prompt = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_PROMPT),
+            help   = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_HELP),
+            flags  = INTERACTIVE | NUMERIC_SIZE_1,
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE 
+              OR (ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE AND
+                  ideqval SECUREBOOT_CONFIGURATION.PhysicalPresent == 0);
+            option text = STRING_TOKEN(STR_USER_MODE),     value = SECURE_BOOT_MODE_USER_MODE,   flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE;
+            option text = STRING_TOKEN(STR_SETUP_MODE),    value = SECURE_BOOT_MODE_SETUP_MODE,  flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE;
+            option text = STRING_TOKEN(STR_AUDIT_MODE),    value = SECURE_BOOT_MODE_AUDIT_MODE,  flags = 0;
+      endif
+      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE;
+            option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = SECURE_BOOT_MODE_DEPLOYED_MODE,  flags = 0;
+      endif
+
+      endoneof;
+
+    subtitle text = STRING_TOKEN(STR_NULL);
+
     goto FORMID_SECURE_BOOT_PK_OPTION_FORM,
          prompt = STRING_TOKEN(STR_SECURE_BOOT_PK_OPTION),
          help   = STRING_TOKEN(STR_SECURE_BOOT_PK_OPTION_HELP),
diff --git a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigImpl.c b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigImpl.c
index e43c6e0ee7e2..a685b409e238 100644
--- a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigImpl.c
+++ b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigImpl.c
@@ -49,6 +49,8 @@ HII_VENDOR_DEVICE_PATH          mSecureBootHiiVendorDevicePath = {
 
 
 BOOLEAN mIsEnterSecureBootForm = FALSE;
+BOOLEAN mIsSelectedSecureBootModeForm = FALSE;
+BOOLEAN mIsSecureBootModeChanged = FALSE;
 
 //
 // OID ASN.1 Value for Hash Algorithms
@@ -2808,6 +2810,256 @@ DeleteSignature (
            );
 }
 
+/**
+  Perform secure boot mode transition from User Mode by setting AuditMode 
+  or DeployedMode variable.
+
+  @param[in]  NewMode          New secure boot mode.
+
+  @retval   EFI_SUCCESS        Secure Boot mode transition is successful.
+**/
+EFI_STATUS
+TransitionFromUserMode(
+  IN  UINT8 NewMode
+  )
+{
+  UINT8      Data;
+  EFI_STATUS Status;
+
+  if (NewMode == SECURE_BOOT_MODE_AUDIT_MODE) {
+    Data = 1;
+    Status = gRT->SetVariable(
+                    EFI_AUDIT_MODE_NAME,
+                    &gEfiGlobalVariableGuid,
+                    EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+                    sizeof(UINT8),
+                    &Data
+                    );
+    return Status;
+  } else if (NewMode == SECURE_BOOT_MODE_DEPLOYED_MODE) {
+    Data = 1;
+    Status = gRT->SetVariable(
+                    EFI_DEPLOYED_MODE_NAME,
+                    &gEfiGlobalVariableGuid,
+                    EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+                    sizeof(UINT8),
+                    &Data
+                    );
+    return Status;
+  }
+
+  //
+  // Other case do nothing here. May Goto enroll PK page.
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+  Perform secure boot mode transition from Setup Mode by setting AuditMode 
+  variable.
+
+  @param[in]  NewMode          New secure boot mode.
+
+  @retval   EFI_SUCCESS        Secure Boot mode transition is successful.
+**/
+EFI_STATUS
+TransitionFromSetupMode(
+  IN UINT8 NewMode
+  )
+{
+  UINT8      Data;
+  EFI_STATUS Status;
+
+  Status = EFI_INVALID_PARAMETER;
+
+  if (NewMode == SECURE_BOOT_MODE_AUDIT_MODE) {
+    Data = 1;
+    Status = gRT->SetVariable(
+                    EFI_AUDIT_MODE_NAME,
+                    &gEfiGlobalVariableGuid,
+                    EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+                    sizeof(UINT8),
+                    &Data
+                    );
+    return Status;
+  }
+
+  //
+  // Other case do nothing here. May Goto enroll PK page.
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+  Perform secure boot mode transition from Audit Mode. Nothing is done here,
+  should goto enroll PK page.
+
+  @param[in]  NewMode          New secure boot mode.
+
+  @retval   EFI_SUCCESS        Secure Boot mode transition is successful.
+**/
+EFI_STATUS
+TransitionFromAuditMode(
+  IN UINT8 NewMode
+  )
+{
+  //
+  // Other case do nothing here. Should Goto enroll PK page.
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+   Perform secure boot mode transition from Deployed Mode by setting Deployed Mode
+   variable to 0.
+
+  @param[in]  NewMode          New secure boot mode.
+
+  @retval   EFI_SUCCESS        Secure Boot mode transition is successful.
+**/
+EFI_STATUS
+TransitionFromDeployedMode(
+  IN UINT8 NewMode
+  )
+{
+  UINT8      Data;
+  EFI_STATUS Status;
+
+  //
+  // Platform specific logic. when physical presence,  Allow to set DeployedMode =:0
+  // to switch back to UserMode
+  //
+  if (NewMode == SECURE_BOOT_MODE_USER_MODE) {
+    Data = 0;
+    Status = gRT->SetVariable(
+                    EFI_DEPLOYED_MODE_NAME,
+                    &gEfiGlobalVariableGuid,
+                    EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+                    sizeof(UINT8),
+                    &Data
+                    );
+    DEBUG((EFI_D_INFO, "DeployedMode Status %x\n", Status));
+    return Status;
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+   Perform main secure boot mode transition.
+
+  @param[in]  CurMode          New secure boot mode.
+  @param[in]  NewMode          New secure boot mode.
+
+  @retval   EFI_SUCCESS        Secure Boot mode transition is successful.
+**/
+EFI_STATUS
+SecureBootModeTransition(
+  IN  UINT8  CurMode,
+  IN  UINT8  NewMode
+  )
+{
+  EFI_STATUS                         Status;
+
+  //
+  // Set platform to be customized mode to ensure platform specific mode switch sucess
+  //
+  Status = SetSecureBootMode(CUSTOM_SECURE_BOOT_MODE);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // SecureBootMode transition
+  //
+  switch (CurMode) {
+    case SECURE_BOOT_MODE_USER_MODE:
+      Status = TransitionFromUserMode(NewMode);
+      break;
+
+    case SECURE_BOOT_MODE_SETUP_MODE:
+      Status = TransitionFromSetupMode(NewMode);
+      break;
+
+    case SECURE_BOOT_MODE_AUDIT_MODE:
+      Status = TransitionFromAuditMode(NewMode);
+      break;
+
+    case SECURE_BOOT_MODE_DEPLOYED_MODE:
+      Status = TransitionFromDeployedMode(NewMode);
+      break;
+
+    default:
+      Status = EFI_INVALID_PARAMETER;
+      ASSERT(FALSE);
+  }
+
+  return Status;
+}
+
+/**
+   Get current secure boot mode by retrieve data from SetupMode/AuditMode/DeployedMode.
+
+  @param[out]  SecureBootMode                Current secure boot mode.
+
+**/
+VOID
+ExtractSecureBootModeFromVariable(
+  OUT UINT8      *SecureBootMode
+  )
+{
+  UINT8     *SetupMode;
+  UINT8     *AuditMode;
+  UINT8     *DeployedMode;
+
+  SetupMode        = NULL;
+  AuditMode        = NULL;
+  DeployedMode     = NULL;
+
+  //
+  // Get AuditMode/DeployedMode from variable
+  //
+  GetVariable2 (EFI_SETUP_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&SetupMode, NULL);
+  GetVariable2 (EFI_AUDIT_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&AuditMode, NULL);
+  GetVariable2 (EFI_DEPLOYED_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&DeployedMode, NULL);
+  if (SetupMode != NULL && AuditMode != NULL && DeployedMode != NULL) {
+    if (*SetupMode == 0 && *AuditMode == 0 && *DeployedMode == 0) {
+      //
+      // User Mode
+      //
+      *SecureBootMode = SECURE_BOOT_MODE_USER_MODE;
+    } else if (*SetupMode == 1 && *AuditMode == 0 && *DeployedMode == 0) {
+      //
+      // Setup Mode
+      //
+      *SecureBootMode = SECURE_BOOT_MODE_SETUP_MODE;
+    } else if (*SetupMode == 1 && *AuditMode == 1 && *DeployedMode == 0) {
+      //
+      // Audit Mode
+      //
+      *SecureBootMode = SECURE_BOOT_MODE_AUDIT_MODE;
+    } else if (*SetupMode == 0 && *AuditMode == 0 && *DeployedMode == 1) {
+      //
+      // Deployed Mode
+      //
+      *SecureBootMode = SECURE_BOOT_MODE_DEPLOYED_MODE;
+    } else {
+      ASSERT(FALSE);
+    }
+  }else {
+    ASSERT(FALSE);
+  }
+
+  if (SetupMode != NULL) {
+    FreePool (SetupMode);
+  }
+  if (DeployedMode != NULL) {
+    FreePool (DeployedMode);
+  }
+  if (AuditMode != NULL) {
+    FreePool (AuditMode);
+  }
+}
+
 /**
   This function extracts configuration from variable.
 
@@ -2820,12 +3072,10 @@ SecureBootExtractConfigFromVariable (
   )
 {
   UINT8     *SecureBootEnable;
-  UINT8     *SetupMode;
   UINT8     *SecureBootMode;
   EFI_TIME  CurrTime;
 
   SecureBootEnable = NULL;
-  SetupMode        = NULL;
   SecureBootMode   = NULL;
 
   //
@@ -2865,16 +3115,6 @@ SecureBootExtractConfigFromVariable (
     ConfigData->PhysicalPresent = FALSE;
   }
 
-  //
-  // If there is no PK then the Delete Pk button will be gray.
-  //
-  GetVariable2 (EFI_SETUP_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&SetupMode, NULL);
-  if (SetupMode == NULL || (*SetupMode) == SETUP_MODE) {
-    ConfigData->HasPk = FALSE;
-  } else  {
-    ConfigData->HasPk = TRUE;
-  }
-
   //
   // Get the SecureBootMode from CustomMode variable.
   //
@@ -2885,12 +3125,24 @@ SecureBootExtractConfigFromVariable (
     ConfigData->SecureBootMode = *(SecureBootMode);
   }
 
+  //
+  // Extact current Secure Boot Mode
+  //
+  ExtractSecureBootModeFromVariable(&ConfigData->CurSecureBootMode);
+
+  //
+  // If there is no PK then the Delete Pk button will be gray.
+  //
+  if (ConfigData->CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE || ConfigData->CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE) {
+    ConfigData->HasPk = FALSE;
+  } else  {
+    ConfigData->HasPk = TRUE;
+  }
+
   if (SecureBootEnable != NULL) {
     FreePool (SecureBootEnable);
   }
-  if (SetupMode != NULL) {
-    FreePool (SetupMode);
-  }
+
   if (SecureBootMode != NULL) {
     FreePool (SecureBootMode);
   }
@@ -2965,16 +3217,28 @@ SecureBootExtractConfig (
   SecureBootExtractConfigFromVariable (&Configuration);
 
   //
-  // Update current secure boot state.
+  // Get current secure boot state.
   //
   GetVariable2 (EFI_SECURE_BOOT_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&SecureBoot, NULL);
+
   if (SecureBoot != NULL && *SecureBoot == SECURE_BOOT_MODE_ENABLE) {
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT), L"Enabled", NULL);
   } else {
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_SECURE_BOOT_STATE_CONTENT), L"Disabled", NULL);
   }
-  if (SecureBoot != NULL) {
-    FreePool (SecureBoot);
+
+  //
+  // Get current secure boot mode
+  //
+  DEBUG((EFI_D_INFO, "Configuration.CurSecureBootMode %d\n", Configuration.CurSecureBootMode));
+  if (Configuration.CurSecureBootMode == SECURE_BOOT_MODE_USER_MODE) {
+    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"UserMode", NULL);
+  } else if (Configuration.CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE) {
+    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"SetupMode", NULL);
+  } else if (Configuration.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE) {
+    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"AuditMode", NULL);
+  } else if (Configuration.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE) {
+    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"DeployedMode", NULL);
   }
 
   BufferSize = sizeof (SECUREBOOT_CONFIGURATION);
@@ -3021,6 +3285,10 @@ SecureBootExtractConfig (
     *Progress = Request + StrLen (Request);
   }
 
+  if (SecureBoot != NULL) {
+    FreePool (SecureBoot);
+  }
+
   return Status;
 }
 
@@ -3142,23 +3410,41 @@ SecureBootCallback (
   UINT16                          LabelId;
   UINT8                           *SecureBootEnable;
   UINT8                           *SecureBootMode;
-  UINT8                           *SetupMode;
   CHAR16                          PromptString[100];
+  UINT8                           CurSecureBootMode;
 
+  Status           = EFI_SUCCESS;
   SecureBootEnable = NULL;
   SecureBootMode   = NULL;
-  SetupMode        = NULL;
 
   if ((This == NULL) || (Value == NULL) || (ActionRequest == NULL)) {
     return EFI_INVALID_PARAMETER;
   }
+  Private = SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This);
+
+  //
+  // Retrieve uncommitted data from Browser
+  //
+  BufferSize = sizeof (SECUREBOOT_CONFIGURATION);
+  IfrNvData = AllocateZeroPool (BufferSize);
+  if (IfrNvData == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  HiiGetBrowserData (&gSecureBootConfigFormSetGuid, mSecureBootStorageName, BufferSize, (UINT8 *) IfrNvData);
 
   if (Action == EFI_BROWSER_ACTION_FORM_OPEN) {
     if (QuestionId == KEY_SECURE_BOOT_MODE) {
       mIsEnterSecureBootForm = TRUE;
+    } else if (QuestionId == KEY_TRANS_SECURE_BOOT_MODE){
+      //
+      // Secure Boot Policy variable changes after tranistion. Re-sync CurSecureBootMode
+      //
+      ExtractSecureBootModeFromVariable(&IfrNvData->CurSecureBootMode);
+      mIsSelectedSecureBootModeForm = TRUE;
+      mIsSecureBootModeChanged = FALSE;
     }
-
-    return EFI_SUCCESS;
+    goto EXIT;
   }
 
   if (Action == EFI_BROWSER_ACTION_RETRIEVE) {
@@ -3168,32 +3454,23 @@ SecureBootCallback (
         Value->u8 = SECURE_BOOT_MODE_STANDARD;
         Status = EFI_SUCCESS;
       }
+    } else if (QuestionId == KEY_TRANS_SECURE_BOOT_MODE) {
+      if (mIsSelectedSecureBootModeForm) {
+        Value->u8 = IfrNvData->CurSecureBootMode;
+        Status = EFI_SUCCESS;
+      }
     }
-    return Status;
+    goto EXIT;
   }
 
   if ((Action != EFI_BROWSER_ACTION_CHANGED) &&
       (Action != EFI_BROWSER_ACTION_CHANGING) &&
       (Action != EFI_BROWSER_ACTION_FORM_CLOSE) &&
       (Action != EFI_BROWSER_ACTION_DEFAULT_STANDARD)) {
-    return EFI_UNSUPPORTED;
-  }
-
-  Private = SECUREBOOT_CONFIG_PRIVATE_FROM_THIS (This);
-
-  //
-  // Retrieve uncommitted data from Browser
-  //
-  BufferSize = sizeof (SECUREBOOT_CONFIGURATION);
-  IfrNvData = AllocateZeroPool (BufferSize);
-  if (IfrNvData == NULL) {
-    return EFI_OUT_OF_RESOURCES;
+    Status = EFI_UNSUPPORTED;
+    goto EXIT;
   }
 
-  Status = EFI_SUCCESS;
-
-  HiiGetBrowserData (&gSecureBootConfigFormSetGuid, mSecureBootStorageName, BufferSize, (UINT8 *) IfrNvData);
-
   if (Action == EFI_BROWSER_ACTION_CHANGING) {
 
     switch (QuestionId) {
@@ -3419,6 +3696,66 @@ SecureBootCallback (
           );
       }
       break;
+    case KEY_TRANS_SECURE_BOOT_MODE:
+      //
+      // Pop up to alert user want to change secure boot mode 
+      //
+      if ((IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_USER_MODE && 
+           (Value->u8 == SECURE_BOOT_MODE_AUDIT_MODE || Value->u8 == SECURE_BOOT_MODE_DEPLOYED_MODE))
+        ||(IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE && 
+           Value->u8 == SECURE_BOOT_MODE_AUDIT_MODE)
+        ||(IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE && 
+          Value->u8 == SECURE_BOOT_MODE_USER_MODE && IfrNvData->PhysicalPresent == 1)){
+        CreatePopUp (
+          EFI_LIGHTGRAY | EFI_BACKGROUND_BLUE,
+          &Key,
+          L"Are you sure you want to switch secure boot mode?",
+          L"Press 'Y' to switch secure boot mode, 'N' to discard change and return",
+          NULL
+          );
+        if (Key.UnicodeChar != 'y' && Key.UnicodeChar != 'Y') {
+          //
+          // If not 'Y'/''y' restore to defualt secure boot mode
+          //
+          Value->u8 = IfrNvData->CurSecureBootMode;
+          goto EXIT;
+        }
+      } else if ((IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE && Value->u8 == SECURE_BOOT_MODE_USER_MODE)
+               ||(IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_USER_MODE && Value->u8 == SECURE_BOOT_MODE_SETUP_MODE)
+               ||(IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE && Value->u8 == SECURE_BOOT_MODE_DEPLOYED_MODE)
+               ||(IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE && Value->u8 == SECURE_BOOT_MODE_SETUP_MODE)) {
+        CreatePopUp (
+          EFI_LIGHTGRAY | EFI_BACKGROUND_BLUE,
+          &Key,
+          L"Secure boot mode tranistion requires PK change",
+          L"Please go to link below to update PK",
+          NULL
+          );
+      } else {
+        Status = EFI_INVALID_PARAMETER;
+        goto EXIT;
+      }
+
+      Status = SecureBootModeTransition(IfrNvData->CurSecureBootMode, Value->u8);
+      //
+      // Secure Boot Policy variable may change after tranistion. Re-sync CurSecureBootMode
+      //
+      ExtractSecureBootModeFromVariable(&CurSecureBootMode);
+      if (IfrNvData->CurSecureBootMode != CurSecureBootMode) {
+        IfrNvData->CurSecureBootMode = CurSecureBootMode;
+        mIsSecureBootModeChanged = TRUE;
+
+        if (IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_USER_MODE) {
+          HiiSetString (Private->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"UserMode", NULL);
+        } else if (IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE) {
+          HiiSetString (Private->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"SetupMode", NULL);
+        } else if (IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE) {
+          HiiSetString (Private->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"AuditMode", NULL);
+        } else if (IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE) {
+          HiiSetString (Private->HiiHandle, STRING_TOKEN (STR_CUR_SECURE_BOOT_MODE_CONTENT), L"DeployedMode", NULL);
+        }
+      }
+      break;
 
     default:
       if (QuestionId >= FILE_OPTION_GOTO_OFFSET) {
@@ -3509,7 +3846,13 @@ SecureBootCallback (
     case KEY_SECURE_BOOT_MODE:
       mIsEnterSecureBootForm = FALSE;
       break;
-
+    case KEY_TRANS_SECURE_BOOT_MODE:
+      mIsSelectedSecureBootModeForm = FALSE;
+      if (mIsSecureBootModeChanged) {
+        *ActionRequest = EFI_BROWSER_ACTION_REQUEST_RESET;
+      }
+      mIsSecureBootModeChanged = FALSE;
+      break;
     case KEY_SECURE_BOOT_KEK_GUID:
     case KEY_SECURE_BOOT_SIGNATURE_GUID_DB:
     case KEY_SECURE_BOOT_SIGNATURE_GUID_DBX:
@@ -3528,8 +3871,7 @@ SecureBootCallback (
       break;
 
     case KEY_SECURE_BOOT_DELETE_PK:
-      GetVariable2 (EFI_SETUP_MODE_NAME, &gEfiGlobalVariableGuid, (VOID**)&SetupMode, NULL);
-      if (SetupMode == NULL || (*SetupMode) == SETUP_MODE) {
+      if (IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_USER_MODE || IfrNvData->CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE) {
         IfrNvData->DeletePk = TRUE;
         IfrNvData->HasPk    = FALSE;
         *ActionRequest = EFI_BROWSER_ACTION_REQUEST_SUBMIT;
@@ -3538,9 +3880,6 @@ SecureBootCallback (
         IfrNvData->HasPk    = TRUE;
         *ActionRequest = EFI_BROWSER_ACTION_REQUEST_FORM_APPLY;
       }
-      if (SetupMode != NULL) {
-        FreePool (SetupMode);
-      }
       break;
     default:
       if (QuestionId >= FILE_OPTION_OFFSET && QuestionId < FILE_OPTION_GOTO_OFFSET) {
@@ -3575,10 +3914,13 @@ SecureBootCallback (
     }
   }
 
+EXIT:
+
   if (!EFI_ERROR (Status)) {
     BufferSize = sizeof (SECUREBOOT_CONFIGURATION);
     HiiSetBrowserData (&gSecureBootConfigFormSetGuid, mSecureBootStorageName, BufferSize, (UINT8*) IfrNvData, NULL);
   }
+
   FreePool (IfrNvData);
 
   return EFI_SUCCESS;
diff --git a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigNvData.h b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigNvData.h
index b628bcb1f532..7195e94a2fc7 100644
--- a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigNvData.h
+++ b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigNvData.h
@@ -1,7 +1,7 @@
 /** @file
   Header file for NV data structure definition.
 
-Copyright (c) 2011 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -84,6 +84,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define LABEL_DBT_DELETE                      0x1203
 #define LABEL_END                             0xffff
 
+#define KEY_TRANS_SECURE_BOOT_MODE            0x2000
+
 #define SECURE_BOOT_MAX_ATTEMPTS_NUM          255
 
 #define CONFIG_OPTION_OFFSET                  0x2000
@@ -116,6 +118,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define SECURE_BOOT_GUID_SIZE                 36
 #define SECURE_BOOT_GUID_STORAGE_SIZE         37
 
+#define SECURE_BOOT_MODE_USER_MODE            0
+#define SECURE_BOOT_MODE_SETUP_MODE           1
+#define SECURE_BOOT_MODE_AUDIT_MODE           2
+#define SECURE_BOOT_MODE_DEPLOYED_MODE        3
+
 //
 // Nv Data structure referenced by IFR
 //
@@ -125,6 +132,8 @@ typedef struct {
   CHAR16  SignatureGuid[SECURE_BOOT_GUID_STORAGE_SIZE];
   BOOLEAN PhysicalPresent;     // If a Physical Present User
   UINT8   SecureBootMode;      // Secure Boot Mode: Standard Or Custom
+  UINT8   CurSecureBootMode;   // Current SecureBoot Mode SetupMode/UserMode/AuditMode/DeployedMode
+  UINT8   TransSecureBootMode; // Trans Next SecureBoot Mode
   BOOLEAN DeletePk;
   BOOLEAN HasPk;               // If Pk is existed it is true
   BOOLEAN AlwaysRevocation;    // If the certificate is always revoked. Revocation time is hidden
@@ -133,4 +142,4 @@ typedef struct {
   EFI_HII_TIME RevocationTime; // The revocation time of the certificate
 } SECUREBOOT_CONFIGURATION;
 
-#endif
\ No newline at end of file
+#endif
diff --git a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigStrings.uni b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfigStrings.uni
index 063a10d44d125cda13a2b62d56dc4cbed528f01c..263811b05216b72148392d968fc12c65fd8591ff 100644
GIT binary patch
delta 801
zcmZ`%K~EDw7<~rY*%|^~h%CF{*wiMai3Jlc#7n~(H7QVGo9Mxq(iYjIwuKgrUep^W
zqWP}I_!A(#crx-&<R5tI**9a?HdQY>^Sw9k&71wc&wHPGAHH9@b9VkdDL>V8zoar#
zQ|qY6d2&%6yGyd{XJuK<8&bZy*+1NX+=-Kxtnv-_bOUYF(ZCuscDVL%gbre~fFkQU
zBH|;gf-X-Ujv)c-4x03O&0Rfaq~P3$Z%%Ar3xTv9SJvjza_ZdeA77cDm6AW5i0}pt
zDW<k$;64~bE|i=99ju2cS~RZm+BynYXRIzmwef=Cs3v+#E|mASOsq+)#wZ#uts>%g
zmuQ0;O~!a>A`M%$S?y8roSui)N#m7$@;<$ec#EdOtovkJT#b9xu12d_n{Ulz@(GWJ
z(yTi1Q8{yN%D07<+;)~E^qOiIT^=po?_c$2u1O}TQz5qb+c&Wz2g+kJvvR63^2OD2
z8X*&!^pSmiMDv!cI@c#OgOR2-(sb>ctmeP%{=2pR8i0v*%g2Shs&IVnVOySgtMV?F
zW^IQ=@?K8L&gDdi3d&>)@?#~VhJ$9<RFO=8hX^f8Es^2S8GbgPZy6<y&lBzfp30dU
N{D~CoKs=&p`~pRlwo(89

delta 181
zcmbPJGB0hy0Y;OJ2OHToyRhpqPwwNFn9QfixA_7O7yo1_R*A`Z<{Xp%Sjd4T9Ju8s
zACPC6Y+&v-c>_0#sWU?<Loq`MLq0<;g93vukWOJp1+wxPihyJ=P$rQf4=9!h<fp(?
zOjZ<7oxDM|VDcvmjmZk!ER&t&GT5QI!Ezuc%#-Jtyg*rGvVf_^<OZOc0}5u7KPVe)
Jo+qCn1^|lbGc*7I


From e8bff743847970c1b5a74bfc891f97223e5e0263 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Thu, 10 Dec 2015 07:19:44 +0000
Subject: [PATCH 213/525] SecurityPkg: AuthVariableLib: Fix GCC compile error

(Sync patch r19140 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19191 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/AuthVariableLib/AuthService.c     | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/SecurityPkg/Library/AuthVariableLib/AuthService.c b/SecurityPkg/Library/AuthVariableLib/AuthService.c
index 5546c2e5c906..9a09eaed609a 100644
--- a/SecurityPkg/Library/AuthVariableLib/AuthService.c
+++ b/SecurityPkg/Library/AuthVariableLib/AuthService.c
@@ -555,10 +555,10 @@ TransitionFromAuditMode(
   )
 {
   EFI_STATUS  Status;
-  UINT8       *AuditVarData;
-  UINT8       *DeployedVarData;
-  UINT8       *SetupVarData;
-  UINT8       *SecureBootVarData;
+  VOID        *AuditVarData;
+  VOID        *DeployedVarData;
+  VOID        *SetupVarData;
+  VOID        *SecureBootVarData;
   UINT8       SecureBootEnable;
   UINTN       DataSize;
 
@@ -693,9 +693,9 @@ TransitionFromDeployedMode(
   )
 {
   EFI_STATUS  Status;
-  UINT8       *DeployedVarData;
-  UINT8       *SetupVarData;
-  UINT8       *SecureBootVarData;
+  VOID        *DeployedVarData;
+  VOID        *SetupVarData;
+  VOID        *SecureBootVarData;
   UINT8       SecureBootEnable;
   UINTN       DataSize;
 
@@ -835,11 +835,11 @@ TransitionFromUserMode(
   )
 {
   EFI_STATUS   Status;
-  UINT8        *AuditVarData;
-  UINT8        *DeployedVarData;
-  UINT8        *SetupVarData;
-  UINT8        *PkVarData;
-  UINT8        *SecureBootVarData;
+  VOID         *AuditVarData;
+  VOID         *DeployedVarData;
+  VOID         *SetupVarData;
+  VOID         *PkVarData;
+  VOID         *SecureBootVarData;
   UINT8        SecureBootEnable;
   UINTN        DataSize;
   VARIABLE_ENTRY_CONSISTENCY  VariableEntry;
@@ -1034,9 +1034,9 @@ TransitionFromSetupMode(
   )
 {
   EFI_STATUS   Status;
-  UINT8        *AuditVarData;
-  UINT8        *SetupVarData;
-  UINT8        *SecureBootVarData;
+  VOID         *AuditVarData;
+  VOID         *SetupVarData;
+  VOID         *SecureBootVarData;
   UINT8        SecureBootEnable;
   UINTN        DataSize;
 
@@ -1746,7 +1746,7 @@ ProcessSecureBootModeVar (
   )
 {
   EFI_STATUS    Status;
-  UINT8         *VarData;
+  VOID          *VarData;
   UINTN         VarDataSize;
 
   //
@@ -1801,7 +1801,7 @@ ProcessSecureBootModeVar (
   //
   // If AuditMode/DeployedMode is assigned same value. Simply return EFI_SUCCESS
   //
-  if (*VarData == *(UINT8 *)Data) {
+  if (*(UINT8 *)VarData == *(UINT8 *)Data) {
     return EFI_SUCCESS;
   }
 

From 8012b6588f3070027ecfcf4c6a9fc840b13c026b Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Thu, 10 Dec 2015 07:20:16 +0000
Subject: [PATCH 214/525] MdePkg: Restore SetupMode macro definition

Restore SetupMode macro definition to keep backward compatibility. No current module is referencing them now.

(Sync patch r19175 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19192 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Guid/ImageAuthentication.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/MdePkg/Include/Guid/ImageAuthentication.h b/MdePkg/Include/Guid/ImageAuthentication.h
index 2f51935c0c76..c7336439981b 100644
--- a/MdePkg/Include/Guid/ImageAuthentication.h
+++ b/MdePkg/Include/Guid/ImageAuthentication.h
@@ -43,6 +43,14 @@
 
 #define SECURE_BOOT_MODE_ENABLE           1
 #define SECURE_BOOT_MODE_DISABLE          0
+///
+/// Depricated value definition for SetupMode variable 
+///
+#define SETUP_MODE                        1
+#define USER_MODE                         0
+///
+/// Value definition for SetupMode/DeployedMode/AuditMode variable
+///
 #define SETUP_MODE_ENABLE                 1
 #define SETUP_MODE_DISABLE                0
 #define DEPLOYED_MODE_ENABLE              1

From d839b9c0f0c80161b932f2c4d153c555b1322610 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Thu, 10 Dec 2015 07:20:43 +0000
Subject: [PATCH 215/525] ShellPkg: Fix wrong return status for Ifconfig.c

The Ifconfig command handler tries to return an EFI_STATUS when
the return type should be SHELL_STATUS.

(Sync patch r19110 from main trunk.)

Cc: Cohen Eugene <eugene@hp.com>
Cc: Carsey Jaben <jaben.carsey@intel.com>
Cc: Ye Ting <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19193 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellNetwork1CommandsLib/Ifconfig.c   | 102 ++++++++++++------
 1 file changed, 69 insertions(+), 33 deletions(-)

diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
index e16d46a8ec4d..fb6f57518422 100644
--- a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
+++ b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
@@ -423,7 +423,7 @@ IfConfigGetInterfaceInfo (
                   &HandleBuffer
                  );
   if (EFI_ERROR (Status) || (HandleNum == 0)) {
-    return EFI_ABORTED;
+    return Status;
   }
 
   //
@@ -587,11 +587,11 @@ IfConfigGetInterfaceInfo (
 
   @param[in]   IfList    The pointer of IfList(interface list).
 
-  @retval EFI_SUCCESS    The ifconfig command list processed successfully.
+  @retval SHELL_SUCCESS  The ifconfig command list processed successfully.
   @retval others         The ifconfig command list process failed.
 
 **/
-EFI_STATUS
+SHELL_STATUS
 IfConfigShowInterfaceInfo (
   IN LIST_ENTRY    *IfList
   )
@@ -783,7 +783,7 @@ IfConfigShowInterfaceInfo (
   
   ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INFO_BREAK), gShellNetwork1HiiHandle);
 
-  return EFI_SUCCESS;
+  return SHELL_SUCCESS;
 }
 
 /**
@@ -791,16 +791,17 @@ IfConfigShowInterfaceInfo (
 
   @param[in]   IfList    The pointer of IfList(interface list).
 
-  @retval EFI_SUCCESS    The ifconfig command clean processed successfully.
+  @retval SHELL_SUCCESS  The ifconfig command clean processed successfully.
   @retval others         The ifconfig command clean process failed.
 
 **/
-EFI_STATUS
+SHELL_STATUS
 IfConfigClearInterfaceInfo (
   IN LIST_ENTRY    *IfList
   )
 {
-  EFI_STATUS                Status;
+  EFI_STATUS                Status;  
+  SHELL_STATUS              ShellStatus;
   LIST_ENTRY                *Entry;
   LIST_ENTRY                *Next;
   IFCONFIG_INTERFACE_CB     *IfCb;
@@ -808,6 +809,7 @@ IfConfigClearInterfaceInfo (
 
   Policy = Ip4Config2PolicyDhcp;
   Status = EFI_SUCCESS;
+  ShellStatus = SHELL_SUCCESS;
 
   if (IsListEmpty (IfList)) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INVALID_INTERFACE), gShellNetwork1HiiHandle);
@@ -825,13 +827,13 @@ IfConfigClearInterfaceInfo (
                             sizeof (EFI_IP4_CONFIG2_POLICY),
                             &Policy
                             );
-
     if (EFI_ERROR (Status)) {
+      ShellStatus = SHELL_ACCESS_DENIED;
       break;
     }
   }
 
-  return Status;
+  return ShellStatus;
 }
 
 /**
@@ -840,18 +842,18 @@ IfConfigClearInterfaceInfo (
   @param[in]   IfList    The pointer of IfList(interface list).
   @param[in]   VarArg    The pointer of ARG_LIST(Args with "-s" option).
 
-  @retval EFI_SUCCESS    The ifconfig command set processed successfully.
+  @retval SHELL_SUCCESS  The ifconfig command set processed successfully.
   @retval others         The ifconfig command set process failed.
 
 **/
-EFI_STATUS
+SHELL_STATUS
 IfConfigSetInterfaceInfo (
   IN LIST_ENTRY    *IfList,
   IN ARG_LIST      *VarArg
   )
 {
-
   EFI_STATUS                       Status;
+  SHELL_STATUS                     ShellStatus;
   IFCONFIG_INTERFACE_CB            *IfCb;
   VAR_CHECK_CODE                   CheckCode;
   EFI_EVENT                        TimeOutEvt;
@@ -872,7 +874,7 @@ IfConfigSetInterfaceInfo (
 
   if (IsListEmpty (IfList)) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_INVALID_INTERFACE), gShellNetwork1HiiHandle);
-    return EFI_INVALID_PARAMETER;
+    return SHELL_INVALID_PARAMETER;
   }
   
   //
@@ -880,6 +882,7 @@ IfConfigSetInterfaceInfo (
   //
   IfCb   = NET_LIST_USER_STRUCT (IfList->ForwardLink, IFCONFIG_INTERFACE_CB, Link);
   Status = EFI_SUCCESS;
+  ShellStatus = SHELL_SUCCESS;
 
   //
   // Initialize check list mechanism.
@@ -901,6 +904,7 @@ IfConfigSetInterfaceInfo (
                   &TimeOutEvt
                   );
   if (EFI_ERROR (Status)) {
+    ShellStatus = SHELL_ACCESS_DENIED;
     goto ON_EXIT;
   }
 
@@ -912,6 +916,7 @@ IfConfigSetInterfaceInfo (
                   &MappedEvt
                   );
   if (EFI_ERROR (Status)) {
+    ShellStatus = SHELL_ACCESS_DENIED;
     goto ON_EXIT;
   }
 
@@ -969,6 +974,7 @@ IfConfigSetInterfaceInfo (
       if (IfCb->Policy == Ip4Config2PolicyDhcp) {
         Status = IfConfigStartIp4 (IfCb->NicHandle, gImageHandle);
         if (EFI_ERROR(Status)) {
+          ShellStatus = SHELL_ACCESS_DENIED;
           goto ON_EXIT;
         }
       } else {
@@ -983,6 +989,7 @@ IfConfigSetInterfaceInfo (
                                 &Policy
                                 );
         if (EFI_ERROR(Status)) {
+          ShellStatus = SHELL_ACCESS_DENIED;
           goto ON_EXIT;
         }
       }
@@ -1000,8 +1007,8 @@ IfConfigSetInterfaceInfo (
                               sizeof (EFI_IP4_CONFIG2_POLICY),
                               &Policy
                               );
-
       if (EFI_ERROR(Status)) {
+        ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
 
@@ -1014,6 +1021,7 @@ IfConfigSetInterfaceInfo (
       //
       Status = NetLibStrToIp4 (VarArg->Arg, &ManualAddress.Address);
       if (EFI_ERROR(Status)) {
+        ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
 
@@ -1023,6 +1031,7 @@ IfConfigSetInterfaceInfo (
       VarArg = VarArg->Next;
       Status = NetLibStrToIp4 (VarArg->Arg, &ManualAddress.SubnetMask);
       if (EFI_ERROR(Status)) {
+        ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
 
@@ -1032,6 +1041,7 @@ IfConfigSetInterfaceInfo (
       VarArg = VarArg->Next;
       Status = NetLibStrToIp4 (VarArg->Arg, &Gateway);
       if (EFI_ERROR(Status)) {
+        ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
       
@@ -1043,6 +1053,7 @@ IfConfigSetInterfaceInfo (
                               MappedEvt
                               );
       if (EFI_ERROR (Status)) {
+        ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
 
@@ -1071,9 +1082,10 @@ IfConfigSetInterfaceInfo (
                      Ip4Config2DataTypeManualAddress,
                      MappedEvt
                      );
-
+      
       if (EFI_ERROR (Status)) {
         ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_SET_ADDR_FAILED), gShellNetwork1HiiHandle, Status);
+        ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
 
@@ -1088,6 +1100,11 @@ IfConfigSetInterfaceInfo (
                               DataSize,
                               &Gateway
                               );
+      if (EFI_ERROR (Status)) {
+        ShellStatus = SHELL_ACCESS_DENIED;
+        goto ON_EXIT;
+      }
+      
       VarArg = VarArg->Next;
       
     } else if (StrCmp (VarArg->Arg, L"dns") == 0) {
@@ -1109,6 +1126,7 @@ IfConfigSetInterfaceInfo (
       while (Tmp != NULL) {
         Status = NetLibStrToIp4 (Tmp->Arg, Dns + Index);
         if (EFI_ERROR(Status)) {
+          ShellStatus = SHELL_INVALID_PARAMETER;
           goto ON_EXIT;
         }
         Index ++;
@@ -1128,6 +1146,10 @@ IfConfigSetInterfaceInfo (
                               DataSize,
                               Dns
                               );
+      if (EFI_ERROR (Status)) {
+        ShellStatus = SHELL_ACCESS_DENIED;
+        goto ON_EXIT;
+      }
     }
   }
 
@@ -1136,7 +1158,7 @@ IfConfigSetInterfaceInfo (
     FreePool (Dns);
   }
   
-  return Status;
+  return ShellStatus;
 
 }
 
@@ -1145,16 +1167,19 @@ IfConfigSetInterfaceInfo (
 
   @param[in]   Private    The pointer of IFCONFIG_PRIVATE_DATA.
 
-  @retval EFI_SUCCESS    ifconfig command processed successfully.
+  @retval SHELL_SUCCESS  ifconfig command processed successfully.
   @retval others         The ifconfig command process failed.
 
 **/
-EFI_STATUS
+SHELL_STATUS
 IfConfig (
   IN IFCONFIG_PRIVATE_DATA    *Private
   )
 {
   EFI_STATUS    Status;
+  SHELL_STATUS  ShellStatus;
+
+  ShellStatus = SHELL_SUCCESS;
 
   //
   // Get configure information of all interfaces.
@@ -1163,31 +1188,30 @@ IfConfig (
              Private->IfName,
              &Private->IfList
              );
-
   if (EFI_ERROR (Status)) {
+    ShellStatus = SHELL_NOT_FOUND; 
     goto ON_EXIT;
   }
 
   switch (Private->OpCode) {
   case IfConfigOpList:
-    Status = IfConfigShowInterfaceInfo (&Private->IfList);
+    ShellStatus = IfConfigShowInterfaceInfo (&Private->IfList);
     break;
 
   case IfConfigOpClear:
-    Status = IfConfigClearInterfaceInfo (&Private->IfList);
+    ShellStatus = IfConfigClearInterfaceInfo (&Private->IfList);
     break;
 
   case IfConfigOpSet:
-    Status = IfConfigSetInterfaceInfo (&Private->IfList, Private->VarArg);
+    ShellStatus = IfConfigSetInterfaceInfo (&Private->IfList, Private->VarArg);
     break;
 
   default:
-    Status = EFI_ABORTED;
+    ShellStatus = SHELL_UNSUPPORTED;
   }
 
 ON_EXIT:
-
-  return Status;
+  return ShellStatus;
 }
 
 /**
@@ -1267,16 +1291,26 @@ ShellCommandRunIfconfig (
   EFI_STATUS                Status;
   IFCONFIG_PRIVATE_DATA     *Private;
   LIST_ENTRY                *ParamPackage;
+  SHELL_STATUS              ShellStatus;
   CONST CHAR16              *ValueStr;
   ARG_LIST                  *ArgList;
   CHAR16                    *ProblemParam;
   CHAR16                    *Str;
-
+  
+  Status = EFI_INVALID_PARAMETER;
   Private = NULL;
+  ShellStatus = SHELL_SUCCESS;
 
   Status = ShellCommandLineParseEx (mIfConfigCheckList, &ParamPackage, &ProblemParam, TRUE, FALSE);
   if (EFI_ERROR (Status)) {
-    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellNetwork1HiiHandle, L"ifconfig", ProblemParam);
+    if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellNetwork1HiiHandle, L"ifconfig", ProblemParam);
+      FreePool(ProblemParam);
+      ShellStatus = SHELL_INVALID_PARAMETER;
+    } else {
+      ASSERT(FALSE);
+    }
+    
     goto ON_EXIT;
   }
 
@@ -1285,6 +1319,7 @@ ShellCommandRunIfconfig (
   //
   if (ShellCommandLineGetFlag (ParamPackage, L"-c")) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_UNSUPPORTED_OPTION), gShellNetwork1HiiHandle,L"-c");
+    ShellStatus = SHELL_INVALID_PARAMETER;
     goto ON_EXIT;
   }
 
@@ -1294,6 +1329,7 @@ ShellCommandRunIfconfig (
   if (!ShellCommandLineGetFlag (ParamPackage, L"-r") && !ShellCommandLineGetFlag (ParamPackage, L"-s") &&
       !ShellCommandLineGetFlag (ParamPackage, L"-l")) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_OPTION), gShellNetwork1HiiHandle);
+    ShellStatus = SHELL_INVALID_PARAMETER;
     goto ON_EXIT;
   }
 
@@ -1304,15 +1340,13 @@ ShellCommandRunIfconfig (
       ((ShellCommandLineGetFlag (ParamPackage, L"-r")) && (ShellCommandLineGetFlag (ParamPackage, L"-l"))) ||
       ((ShellCommandLineGetFlag (ParamPackage, L"-s")) && (ShellCommandLineGetFlag (ParamPackage, L"-l")))) {
     ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_CON), gShellNetwork1HiiHandle, L"ifconfig");
+    ShellStatus = SHELL_INVALID_PARAMETER;
     goto ON_EXIT;
   }
 
-  Status = EFI_INVALID_PARAMETER;
-
   Private = AllocateZeroPool (sizeof (IFCONFIG_PRIVATE_DATA));
-
   if (Private == NULL) {
-    Status = EFI_OUT_OF_RESOURCES;
+    ShellStatus = SHELL_OUT_OF_RESOURCES;
     goto ON_EXIT;
   }
 
@@ -1351,6 +1385,7 @@ ShellCommandRunIfconfig (
     ValueStr = ShellCommandLineGetValue (ParamPackage, L"-s");
     if (ValueStr == NULL) {
       ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_INTERFACE), gShellNetwork1HiiHandle);
+      ShellStatus = SHELL_INVALID_PARAMETER;
       goto ON_EXIT;
     }
     
@@ -1367,6 +1402,7 @@ ShellCommandRunIfconfig (
 
     if (Private->IfName == NULL || Private->VarArg == NULL) {
       ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_COMMAND), gShellNetwork1HiiHandle);
+      ShellStatus = SHELL_INVALID_PARAMETER;
       goto ON_EXIT;
     }
   }
@@ -1374,7 +1410,7 @@ ShellCommandRunIfconfig (
   //
   // Main process of ifconfig.
   //
-  Status = IfConfig (Private);
+  ShellStatus = IfConfig (Private);
 
 ON_EXIT:
 
@@ -1384,5 +1420,5 @@ ShellCommandRunIfconfig (
     IfConfigCleanup (Private);
   }
 
-  return Status;
+  return ShellStatus;
 }

From b0fdb34d967435c34f28a3da3b09398ff600f145 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Thu, 10 Dec 2015 07:21:12 +0000
Subject: [PATCH 216/525] ShellPkg: Refine the code to reduce time cost of 'map
 -r'

In some platform 'map -r' may cost more than 1 min. This patch filter the target handles by
BlockIO and SimpleFileSystem protocol to reduce the time cost.

(Sync patch r19149 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19194 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellCommandLib/ConsistMapping.c      | 40 ++++++++++++++-----
 1 file changed, 30 insertions(+), 10 deletions(-)

diff --git a/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c b/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
index 9bd7b2cedd25..86e8dc59a895 100644
--- a/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
+++ b/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
@@ -16,6 +16,10 @@
 #include <Library/SortLib.h>
 #include <Library/UefiLib.h>
 #include <Protocol/UsbIo.h>
+#include <Protocol/BlockIo.h>
+#include <Protocol/SimpleFileSystem.h>
+
+
 
 typedef enum {
   MTDTypeUnknown,
@@ -1349,20 +1353,22 @@ ShellCommandConsistMappingInitialize (
   OUT EFI_DEVICE_PATH_PROTOCOL           ***Table
   )
 {
-  EFI_HANDLE                *HandleBuffer;
-  UINTN                     HandleNum;
-  UINTN                     HandleLoop;
-  EFI_DEVICE_PATH_PROTOCOL  **TempTable;
-  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;
-  EFI_DEVICE_PATH_PROTOCOL  *HIDevicePath;
-  UINTN                     Index;
-  EFI_STATUS                Status;
+  EFI_HANDLE                      *HandleBuffer;
+  UINTN                           HandleNum;
+  UINTN                           HandleLoop;
+  EFI_DEVICE_PATH_PROTOCOL        **TempTable;
+  EFI_DEVICE_PATH_PROTOCOL        *DevicePath;
+  EFI_DEVICE_PATH_PROTOCOL        *HIDevicePath;
+  EFI_BLOCK_IO_PROTOCOL           *BlockIo;
+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *SimpleFileSystem;
+  UINTN                           Index;
+  EFI_STATUS                      Status;
 
   HandleBuffer              = NULL;
 
   Status = gBS->LocateHandleBuffer (
-              AllHandles,
-              NULL,
+              ByProtocol,
+              &gEfiDevicePathProtocolGuid,
               NULL,
               &HandleNum,
               &HandleBuffer
@@ -1385,6 +1391,20 @@ ShellCommandConsistMappingInitialize (
       continue;
     }
 
+    Status = gBS->HandleProtocol( HandleBuffer[HandleLoop], 
+                                  &gEfiBlockIoProtocolGuid, 
+                                  (VOID **)&BlockIo
+                                  );
+    if (EFI_ERROR(Status)) {
+      Status = gBS->HandleProtocol( HandleBuffer[HandleLoop], 
+                                    &gEfiSimpleFileSystemProtocolGuid, 
+                                    (VOID **)&SimpleFileSystem
+                                    );
+      if (EFI_ERROR(Status)) {
+        continue;
+      }
+    }
+
     for (Index = 0; TempTable[Index] != NULL; Index++) {
       if (DevicePathCompare (&TempTable[Index], &HIDevicePath) == 0) {
         FreePool (HIDevicePath);

From 53c6f25007d394164df6669506e643ed73c08577 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 10 Dec 2015 07:21:55 +0000
Subject: [PATCH 217/525] UefiCpuPkg/MtrrLib: Add PCD
 PcdCpuNumberOfReservedVariableMtrrs

Current MtrrLib reserves 2 variable MTRRs for some legacy OS boot (CSM boots)
may require some MTRRs to be reserved for OS use. But UEFI OS boot will not use
MTRRs.

Per Scott's suggestion in
link: http://article.gmane.org/gmane.comp.bios.edk2.devel/4099
Add one PCD PcdCpuNumberOfReservedVariableMtrrs to specify the number of
variable MTRRs reserved for OS use. Setting its default value to 2 is for
back-compatibility.

(Sync patch r19151 from main trunk.)

Cc: Scott Duplichan <scott@notabs.org>
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Suggested-by: Scott Duplichan <scott@notabs.org>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19195 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Library/MtrrLib.h   | 3 ++-
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c   | 6 ++++--
 UefiCpuPkg/Library/MtrrLib/MtrrLib.inf | 5 ++++-
 UefiCpuPkg/UefiCpuPkg.dec              | 5 +++++
 4 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/Include/Library/MtrrLib.h b/UefiCpuPkg/Include/Library/MtrrLib.h
index e06fff7f0178..f9002e7cbfc7 100644
--- a/UefiCpuPkg/Include/Library/MtrrLib.h
+++ b/UefiCpuPkg/Include/Library/MtrrLib.h
@@ -1,7 +1,7 @@
 /** @file
   MTRR setting library
 
-  Copyright (c) 2008 - 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2008 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -26,6 +26,7 @@
 #define  MTRR_NUMBER_OF_VARIABLE_MTRR  32
 //
 // Firmware need reserve 2 MTRR for OS
+// Note: It is replaced by PCD PcdCpuNumberOfReservedVariableMtrrs
 //
 #define  RESERVED_FIRMWARE_VARIABLE_MTRR_NUMBER  2
 
diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index a65560542c88..82223379e773 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -140,13 +140,15 @@ GetFirmwareVariableMtrrCount (
   )
 {
   UINT32  VariableMtrrCount;
+  UINT32  ReservedMtrrNumber;
 
   VariableMtrrCount = GetVariableMtrrCount ();
-  if (VariableMtrrCount < RESERVED_FIRMWARE_VARIABLE_MTRR_NUMBER) {
+  ReservedMtrrNumber = PcdGet32 (PcdCpuNumberOfReservedVariableMtrrs);
+  if (VariableMtrrCount < ReservedMtrrNumber) {
     return 0;
   }
 
-  return VariableMtrrCount - RESERVED_FIRMWARE_VARIABLE_MTRR_NUMBER;
+  return VariableMtrrCount - ReservedMtrrNumber;
 }
 
 /**
diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.inf b/UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
index 64ec9bd0b0fa..01a4d84da0ed 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.inf
@@ -1,7 +1,7 @@
 ## @file
 #  MTRR library provides APIs for MTRR operation.
 #
-#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution.  The full text of the license may be found at
@@ -41,3 +41,6 @@
   CpuLib
   DebugLib
 
+[Pcd]
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuNumberOfReservedVariableMtrrs   ## SOMETIMES_CONSUMES
+
diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index e783a7b53616..a6941466891e 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -167,6 +167,11 @@
   # @Prompt SMM CPU Synchronization Method.
   gUefiCpuPkgTokenSpaceGuid.PcdCpuSmmSyncMode|0x00|UINT8|0x60000014
 
+  ## Specifies the number of variable MTRRs reserved for OS use. The default number of
+  #  MTRRs reserved for OS use is 2.
+  # @Prompt Number of reserved variable MTRRs.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuNumberOfReservedVariableMtrrs|0x2|UINT32|0x00000015
+
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
   ## Specifies timeout value in microseconds for the BSP to detect all APs for the first time.
   # @Prompt Timeout for the BSP to detect all APs for the first time.

From e7409a1e259fb56c6a1927398aff5b251fbb444d Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:22:31 +0000
Subject: [PATCH 218/525] UefiCpuPkg/MtrrLib: Fix some typo and clean up code
 format

Fixed some typo. Removed some trailing spaces and TAB key. Clean up code format.

(Sync patch r19152 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19196 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Library/MtrrLib.h |  70 +++++++-----
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 162 ++++++++++++++-------------
 2 files changed, 121 insertions(+), 111 deletions(-)

diff --git a/UefiCpuPkg/Include/Library/MtrrLib.h b/UefiCpuPkg/Include/Library/MtrrLib.h
index f9002e7cbfc7..884c7bb6996c 100644
--- a/UefiCpuPkg/Include/Library/MtrrLib.h
+++ b/UefiCpuPkg/Include/Library/MtrrLib.h
@@ -84,8 +84,8 @@ typedef struct {
 // Structure to hold base and mask pair for variable MTRR register
 //
 typedef struct _MTRR_VARIABLE_SETTING_ {
-	UINT64    Base;
-	UINT64    Mask;
+  UINT64    Base;
+  UINT64    Mask;
 } MTRR_VARIABLE_SETTING;
 
 //
@@ -115,11 +115,11 @@ typedef struct _MTRR_SETTINGS_ {
 // Memory cache types
 //
 typedef enum {
-	CacheUncacheable    = 0,
-	CacheWriteCombining = 1,
-	CacheWriteThrough   = 4,
-	CacheWriteProtected = 5,
-	CacheWriteBack      = 6
+  CacheUncacheable    = 0,
+  CacheWriteCombining = 1,
+  CacheWriteThrough   = 4,
+  CacheWriteProtected = 5,
+  CacheWriteBack      = 6
 } MTRR_MEMORY_CACHE_TYPE;
 
 #define  MTRR_CACHE_UNCACHEABLE      0
@@ -156,20 +156,27 @@ GetFirmwareVariableMtrrCount (
 /**
   This function attempts to set the attributes for a memory range.
 
-  @param  BaseAddress            The physical address that is the start address of a memory region.
-  @param  Length                 The size in bytes of the memory region.
-  @param  Attributes             The bit mask of attributes to set for the memory region.
+  @param[in]       BaseAddress       The physical address that is the start
+                                     address of a memory region.
+  @param[in]       Length            The size in bytes of the memory region.
+  @param[in]       Attribute         The bit mask of attributes to set for the
+                                     memory region.
 
-  @retval RETURN_SUCCESS            The attributes were set for the memory region.
+  @retval RETURN_SUCCESS            The attributes were set for the memory
+                                    region.
   @retval RETURN_INVALID_PARAMETER  Length is zero.
-  @retval RETURN_UNSUPPORTED        The processor does not support one or more bytes of the
-                                 memory resource range specified by BaseAddress and Length.
-  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support for the memory resource
-                                 range specified by BaseAddress and Length.
-  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource range specified by
-                                 BaseAddress and Length cannot be modified.
-  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to modify the attributes of
-                                 the memory resource range.
+  @retval RETURN_UNSUPPORTED        The processor does not support one or
+                                    more bytes of the memory resource range
+                                    specified by BaseAddress and Length.
+  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support
+                                    for the memory resource range specified
+                                    by BaseAddress and Length.
+  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource
+                                    range specified by BaseAddress and Length
+                                    cannot be modified.
+  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to
+                                    modify the attributes of the memory
+                                    resource range.
 
 **/
 RETURN_STATUS
@@ -185,7 +192,7 @@ MtrrSetMemoryAttribute (
   This function will get the memory cache type of the specific address.
   This function is mainly for debugging purposes.
 
-  @param  Address            The specific address
+  @param[in]  Address            The specific address
 
   @return The memory cache type of the specific address
 
@@ -200,7 +207,7 @@ MtrrGetMemoryAttribute (
 /**
   This function will get the raw value in variable MTRRs
 
-  @param  VariableSettings   A buffer to hold variable MTRRs content.
+  @param[out]  VariableSettings   A buffer to hold variable MTRRs content.
 
   @return The buffer point to MTRR_VARIABLE_SETTINGS in which holds the content of the variable mtrr
 
@@ -215,7 +222,7 @@ MtrrGetVariableMtrr (
 /**
   This function sets fixed MTRRs
 
-  @param  VariableSettings   A buffer to hold variable MTRRs content.
+  @param[in]  VariableSettings   A buffer to hold variable MTRRs content.
 
   @return The pointer of VariableSettings
 
@@ -230,7 +237,7 @@ MtrrSetVariableMtrr (
 /**
   This function gets the content in fixed MTRRs
 
-  @param  FixedSettings      A buffer to hold fixed MTRRs content.
+  @param[out]  FixedSettings      A buffer to hold fixed MTRRs content.
 
   @return The pointer of FixedSettings
 
@@ -245,7 +252,7 @@ MtrrGetFixedMtrr (
 /**
   This function sets fixed MTRRs
 
-  @param   FixedSettings      A buffer holding fixed MTRRs content.
+  @param[in]   FixedSettings      A buffer holding fixed MTRRs content.
 
   @return  The pointer of FixedSettings
 
@@ -260,7 +267,7 @@ MtrrSetFixedMtrr (
 /**
   This function gets the content in all MTRRs (variable and fixed)
 
-  @param  MtrrSetting   A buffer to hold all MTRRs content.
+  @param[out]  MtrrSetting   A buffer to hold all MTRRs content.
 
   @return The pointer of MtrrSetting
 
@@ -275,7 +282,7 @@ MtrrGetAllMtrrs (
 /**
   This function sets all MTRRs (variable and fixed)
 
-  @param  MtrrSetting   A buffer to hold all MTRRs content.
+  @param[in]  MtrrSetting   A buffer to hold all MTRRs content.
 
   @return The pointer of MtrrSetting
 
@@ -293,11 +300,12 @@ MtrrSetAllMtrrs (
   This function shadows the content of variable MTRRs into
   an internal array: VariableMtrr
 
-  @param  MtrrValidBitsMask     The mask for the valid bit of the MTRR
-  @param  MtrrValidAddressMask  The valid address mask for MTRR since the base address in
-                                MTRR must align to 4K, so valid address mask equal to
-                                MtrrValidBitsMask & 0xfffffffffffff000ULL
-  @param  VariableMtrr          The array to shadow variable MTRRs content
+  @param[in]   MtrrValidBitsMask    The mask for the valid bit of the MTRR
+  @param[in]   MtrrValidAddressMask The valid address mask for MTRR since the base address in
+                                    MTRR must align to 4K, so valid address mask equal to
+                                    MtrrValidBitsMask & 0xfffffffffffff000ULL
+  @param[out]  VariableMtrr         The array to shadow variable MTRRs content
+
   @return                       The ruturn value of this paramter indicates the number of
                                 MTRRs which has been used.
 **/
diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 82223379e773..1584ae23d9ce 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -86,7 +86,7 @@ CONST FIXED_MTRR  mMtrrLibFixedMtrrTable[] = {
     MTRR_LIB_IA32_MTRR_FIX4K_F8000,
     0xF8000,
     SIZE_4KB
-  },
+  }
 };
 
 //
@@ -188,7 +188,7 @@ PreMtrrChange (
   // Disable interrupts and save current interrupt state
   //
   MtrrContext->InterruptState = SaveAndDisableInterrupts();
-  
+
   //
   // Enter no fill cache mode, CD=1(Bit30), NW=0 (Bit29)
   //
@@ -206,7 +206,7 @@ PreMtrrChange (
   CpuFlushTlb ();
 
   //
-  // Disable Mtrrs
+  // Disable MTRRs
   //
   AsmMsrBitFieldWrite64 (MTRR_LIB_IA32_MTRR_DEF_TYPE, 10, 11, 0);
 }
@@ -226,7 +226,7 @@ PostMtrrChangeEnableCache (
   )
 {
   //
-  // Flush all TLBs 
+  // Flush all TLBs
   //
   CpuFlushTlb ();
 
@@ -239,7 +239,7 @@ PostMtrrChangeEnableCache (
   // Restore original CR4 value
   //
   AsmWriteCr4 (MtrrContext->Cr4);
-  
+
   //
   // Restore original interrupt state
   //
@@ -272,9 +272,9 @@ PostMtrrChange (
 /**
   Programs fixed MTRRs registers.
 
-  @param  MemoryCacheType  The memory type to set.
-  @param  Base             The base address of memory range.
-  @param  Length           The length of memory range.
+  @param[in]      MemoryCacheType  The memory type to set.
+  @param[in, out] Base             The base address of memory range.
+  @param[in, out] Length           The length of memory range.
 
   @retval RETURN_SUCCESS      The cache type was updated successfully
   @retval RETURN_UNSUPPORTED  The requested range or cache type was invalid
@@ -356,14 +356,14 @@ ProgramFixedMtrr (
 
 
 /**
-  Get the attribute of variable MTRRs.
+  Gets the attribute of variable MTRRs.
 
   This function shadows the content of variable MTRRs into an
   internal array: VariableMtrr.
 
-  @param  MtrrValidBitsMask     The mask for the valid bit of the MTRR
-  @param  MtrrValidAddressMask  The valid address mask for MTRR
-  @param  VariableMtrr          The array to shadow variable MTRRs content
+  @param[in]   MtrrValidBitsMask     The mask for the valid bit of the MTRR
+  @param[in]   MtrrValidAddressMask  The valid address mask for MTRR
+  @param[out]  VariableMtrr          The array to shadow variable MTRRs content
 
   @return                       The return value of this paramter indicates the
                                 number of MTRRs which has been used.
@@ -423,9 +423,9 @@ MtrrGetMemoryAttributeInVariableMtrr (
 /**
   Checks overlap between given memory range and MTRRs.
 
-  @param  Start            The start address of memory range.
-  @param  End              The end address of memory range.
-  @param  VariableMtrr     The array to shadow variable MTRRs content
+  @param[in]  Start                      The start address of memory range.
+  @param[in]  End                        The end address of memory range.
+  @param[in]  VariableMtrr               The array to shadow variable MTRRs content
 
   @retval TRUE             Overlap exists.
   @retval FALSE            No overlap.
@@ -461,9 +461,9 @@ CheckMemoryAttributeOverlap (
 /**
   Marks a variable MTRR as non-valid.
 
-  @param  Index         The index of the array VariableMtrr to be invalidated
-  @param  VariableMtrr  The array to shadow variable MTRRs content
-  @param  UsedMtrr      The number of MTRRs which has already been used
+  @param[in]   Index         The index of the array VariableMtrr to be invalidated
+  @param[in]   VariableMtrr  The array to shadow variable MTRRs content
+  @param[out]  UsedMtrr      The number of MTRRs which has already been used
 
 **/
 VOID
@@ -479,16 +479,16 @@ InvalidateShadowMtrr (
 
 
 /**
-  Combine memory attributes.
+  Combines memory attributes.
 
   If overlap exists between given memory range and MTRRs, try to combine them.
 
-  @param  Attributes             The memory type to set.
-  @param  Base                   The base address of memory range.
-  @param  Length                 The length of memory range.
-  @param  VariableMtrr           The array to shadow variable MTRRs content
-  @param  UsedMtrr               The number of MTRRs which has already been used
-  @param  OverwriteExistingMtrr  Returns whether an existing MTRR was used
+  @param[in]       Attributes                 The memory type to set.
+  @param[in, out]  Base                       The base address of memory range.
+  @param[in, out]  Length                     The length of memory range.
+  @param[in]       VariableMtrr               The array to shadow variable MTRRs content
+  @param[in, out]  UsedMtrr                   The number of MTRRs which has already been used
+  @param[out]      OverwriteExistingMtrr      Returns whether an existing MTRR was used
 
   @retval EFI_SUCCESS            Memory region successfully combined.
   @retval EFI_ACCESS_DENIED      Memory region cannot be combined.
@@ -536,7 +536,7 @@ CombineMemoryAttribute (
     //
     if (Attributes == VariableMtrr[Index].Type) {
       //
-      // if the Mtrr range contain the request range, set a flag, then continue to 
+      // if the MTRR range contain the request range, set a flag, then continue to
       // invalidate any MTRR of the same request range with higher priority cache type.
       //
       if (VariableMtrr[Index].BaseAddress <= *Base && MtrrEnd >= EndAddress) {
@@ -597,9 +597,10 @@ CombineMemoryAttribute (
 
 
 /**
-  Calculate the maximum value which is a power of 2, but less the MemoryLength.
+  Calculates the maximum value which is a power of 2, but less the MemoryLength.
+
+  @param[in]  MemoryLength        The number to pass in.
 
-  @param  MemoryLength        The number to pass in.
   @return The maximum value which is align to power of 2 and less the MemoryLength
 
 **/
@@ -626,21 +627,22 @@ Power2MaxMemory (
 
 
 /**
-  Determine the MTRR numbers used to program a memory range.
+  Determines the MTRR numbers used to program a memory range.
 
-  This function first checks the alignment of the base address. If the alignment of the base address <= Length,
-  cover the memory range (BaseAddress, alignment) by a MTRR, then BaseAddress += alignment and Length -= alignment.
-  Repeat the step until alignment > Length.
+  This function first checks the alignment of the base address.
+  If the alignment of the base address <= Length, cover the memory range
+ (BaseAddress, alignment) by a MTRR, then BaseAddress += alignment and
+  Length -= alignment. Repeat the step until alignment > Length.
 
-  Then this function determines which direction of programming the variable MTRRs for the remaining length
-  will use fewer MTRRs.
+  Then this function determines which direction of programming the variable
+  MTRRs for the remaining length will use fewer MTRRs.
 
-  @param  BaseAddress Length of Memory to program MTRR
-  @param  Length      Length of Memory to program MTRR
-  @param  MtrrNumber  Pointer to the number of necessary MTRRs
+  @param[in]  BaseAddress Length of Memory to program MTRR
+  @param[in]  Length      Length of Memory to program MTRR
+  @param[in]  MtrrNumber  Pointer to the number of necessary MTRRs
 
   @retval TRUE        Positive direction is better.
-          FALSE       Negtive direction is better.
+          FALSE       Negative direction is better.
 
 **/
 BOOLEAN
@@ -709,13 +711,13 @@ GetMtrrNumberAndDirection (
   This function programs MTRRs according to the values specified
   in the shadow array.
 
-  @param  VariableMtrr   The array to shadow variable MTRRs content
+  @param[in, out]  VariableMtrr       Shadow of variable MTRR contents
 
 **/
 VOID
 InvalidateMtrr (
-   IN     VARIABLE_MTRR      *VariableMtrr
-   )
+  IN OUT VARIABLE_MTRR           *VariableMtrr
+  )
 {
   UINTN         Index;
   UINTN         VariableMtrrCount;
@@ -741,11 +743,11 @@ InvalidateMtrr (
 
   This function programs variable MTRRs
 
-  @param  MtrrNumber            Index of MTRR to program.
-  @param  BaseAddress           Base address of memory region.
-  @param  Length                Length of memory region.
-  @param  MemoryCacheType       Memory type to set.
-  @param  MtrrValidAddressMask  The valid address mask for MTRR
+  @param[in]       MtrrNumber            Index of MTRR to program.
+  @param[in]       BaseAddress           Base address of memory region.
+  @param[in]       Length                Length of memory region.
+  @param[in]       MemoryCacheType       Memory type to set.
+  @param[in]       MtrrValidAddressMask  The valid address mask for MTRR
 
 **/
 VOID
@@ -782,9 +784,9 @@ ProgramVariableMtrr (
 
 
 /**
-  Convert the Memory attibute value to MTRR_MEMORY_CACHE_TYPE.
+  Converts the Memory attribute value to MTRR_MEMORY_CACHE_TYPE.
 
-  @param  MtrrType  MTRR memory type
+  @param[in]  MtrrType           MTRR memory type
 
   @return The enum item in MTRR_MEMORY_CACHE_TYPE
 
@@ -808,7 +810,7 @@ GetMemoryCacheTypeFromMtrrType (
   default:
     //
     // MtrrType is MTRR_CACHE_INVALID_TYPE, that means
-    // no mtrr covers the range
+    // no MTRR covers the range
     //
     return MtrrGetDefaultMemoryType ();
   }
@@ -819,8 +821,8 @@ GetMemoryCacheTypeFromMtrrType (
 
   This function initializes the valid bits mask and valid address mask for MTRRs.
 
-  @param  MtrrValidBitsMask     The mask for the valid bit of the MTRR
-  @param  MtrrValidAddressMask  The valid address mask for the MTRR
+  @param[out]  MtrrValidBitsMask     The mask for the valid bit of the MTRR
+  @param[out]  MtrrValidAddressMask  The valid address mask for the MTRR
 
 **/
 VOID
@@ -849,21 +851,21 @@ MtrrLibInitializeMtrrMask (
 
 
 /**
-  Determing the real attribute of a memory range.
+  Determines the real attribute of a memory range.
 
   This function is to arbitrate the real attribute of the memory when
-  there are 2 MTRR covers the same memory range.  For further details,
+  there are 2 MTRRs covers the same memory range.  For further details,
   please refer the IA32 Software Developer's Manual, Volume 3,
   Section 10.11.4.1.
 
-  @param  MtrrType1    the first kind of Memory type
-  @param  MtrrType2    the second kind of memory type
+  @param[in]  MtrrType1    The first kind of Memory type
+  @param[in]  MtrrType2    The second kind of memory type
 
 **/
 UINT64
 MtrrPrecedence (
-  UINT64    MtrrType1,
-  UINT64    MtrrType2
+  IN UINT64    MtrrType1,
+  IN UINT64    MtrrType2
   )
 {
   UINT64 MtrrType;
@@ -923,11 +925,11 @@ MtrrPrecedence (
 /**
   This function attempts to set the attributes for a memory range.
 
-  @param  BaseAddress            The physical address that is the start
-                                 address of a memory region.
-  @param  Length                 The size in bytes of the memory region.
-  @param  Attributes             The bit mask of attributes to set for the
-                                 memory region.
+  @param[in]       BaseAddress       The physical address that is the start
+                                     address of a memory region.
+  @param[in]       Length            The size in bytes of the memory region.
+  @param[in]       Attribute         The bit mask of attributes to set for the
+                                     memory region.
 
   @retval RETURN_SUCCESS            The attributes were set for the memory
                                     region.
@@ -1198,9 +1200,9 @@ MtrrSetMemoryAttribute (
 
   This function is mainly for debug purpose.
 
-  @param  Address   The specific address
+  @param[in]  Address            The specific address
 
-  @return Memory cache type of the sepcific address
+  @return Memory cache type of the specific address
 
 **/
 MTRR_MEMORY_CACHE_TYPE
@@ -1290,7 +1292,7 @@ MtrrGetMemoryAttribute (
 /**
   This function will get the raw value in variable MTRRs
 
-  @param  VariableSettings   A buffer to hold variable MTRRs content.
+  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
 
   @return The VariableSettings input pointer
 
@@ -1325,7 +1327,7 @@ MtrrGetVariableMtrr (
 /**
   Worker function setting variable MTRRs
 
-  @param  VariableSettings   A buffer to hold variable MTRRs content.
+  @param[in]  VariableSettings   A buffer to hold variable MTRRs content.
 
 **/
 VOID
@@ -1355,7 +1357,7 @@ MtrrSetVariableMtrrWorker (
 /**
   This function sets variable MTRRs
 
-  @param  VariableSettings   A buffer to hold variable MTRRs content.
+  @param[in]  VariableSettings   A buffer to hold variable MTRRs content.
 
   @return The pointer of VariableSettings
 
@@ -1382,7 +1384,7 @@ MtrrSetVariableMtrr (
 /**
   This function gets the content in fixed MTRRs
 
-  @param  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[out]  FixedSettings  A buffer to hold fixed Mtrrs content.
 
   @retval The pointer of FixedSettings
 
@@ -1410,7 +1412,7 @@ MtrrGetFixedMtrr (
 /**
   Worker function setting fixed MTRRs
 
-  @param  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[in]  FixedSettings  A buffer to hold fixed Mtrrs content.
 
 **/
 VOID
@@ -1432,7 +1434,7 @@ MtrrSetFixedMtrrWorker (
 /**
   This function sets fixed MTRRs
 
-  @param  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[in]  FixedSettings  A buffer to hold fixed Mtrrs content.
 
   @retval The pointer of FixedSettings
 
@@ -1460,7 +1462,7 @@ MtrrSetFixedMtrr (
 /**
   This function gets the content in all MTRRs (variable and fixed)
 
-  @param  MtrrSetting  A buffer to hold all Mtrrs content.
+  @param[out]  MtrrSetting  A buffer to hold all Mtrrs content.
 
   @retval the pointer of MtrrSetting
 
@@ -1497,7 +1499,7 @@ MtrrGetAllMtrrs (
 /**
   This function sets all MTRRs (variable and fixed)
 
-  @param  MtrrSetting  A buffer holding all MTRRs content.
+  @param[in]  MtrrSetting  A buffer holding all MTRRs content.
 
   @retval The pointer of MtrrSetting
 
@@ -1569,7 +1571,7 @@ MtrrDebugPrintAllMtrrs (
 
     DEBUG((DEBUG_CACHE, "MTRR Settings\n"));
     DEBUG((DEBUG_CACHE, "=============\n"));
-    
+
     MtrrGetAllMtrrs (&MtrrSettings);
     DEBUG((DEBUG_CACHE, "MTRR Default Type: %016lx\n", MtrrSettings.MtrrDefType));
     for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
@@ -1596,7 +1598,7 @@ MtrrDebugPrintAllMtrrs (
       MemoryType = (UINTN)(RShiftU64 (MtrrSettings.Fixed.Mtrr[Index], Index1 * 8) & 0xff);
         if (MemoryType > CacheWriteBack) {
           MemoryType = MTRR_CACHE_INVALID_TYPE;
-        }            
+        }
         if (MemoryType != PreviousMemoryType) {
           if (PreviousMemoryType != MTRR_CACHE_INVALID_TYPE) {
             DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
@@ -1632,12 +1634,12 @@ MtrrDebugPrintAllMtrrs (
         PreviousMemoryType = MemoryType;
         DEBUG((DEBUG_CACHE, "%a:%016lx-", mMtrrMemoryCacheTypeShortName[MemoryType], Base));
       }
-      
-      RangeBase    = BASE_1MB;        
+
+      RangeBase    = BASE_1MB;
       NoRangeBase  = BASE_1MB;
       RangeLimit   = Limit;
       NoRangeLimit = Limit;
-      
+
       for (Index = 0, Found = FALSE; Index < VariableMtrrCount; Index++) {
         if ((MtrrSettings.Variables.Mtrr[Index].Mask & BIT11) == 0) {
           //
@@ -1651,7 +1653,7 @@ MtrrDebugPrintAllMtrrs (
         if (Base >= MtrrBase && Base < MtrrLimit) {
           Found = TRUE;
         }
-        
+
         if (Base >= MtrrBase && MtrrBase > RangeBase) {
           RangeBase = MtrrBase;
         }
@@ -1664,7 +1666,7 @@ MtrrDebugPrintAllMtrrs (
         if (Base < MtrrLimit && MtrrLimit <= RangeLimit) {
           RangeLimit = MtrrLimit;
         }
-        
+
         if (Base > MtrrLimit && NoRangeBase < MtrrLimit) {
           NoRangeBase = MtrrLimit + 1;
         }
@@ -1672,7 +1674,7 @@ MtrrDebugPrintAllMtrrs (
           NoRangeLimit = MtrrBase - 1;
         }
       }
-      
+
       if (Found) {
         Base = RangeLimit + 1;
       } else {

From 09e97e00725749440b9c6a968537dac09a11d34c Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:22:58 +0000
Subject: [PATCH 219/525] UefiCpuPkg/MtrrLib: Add worker functions not invoke
 IsMtrrSupported()

Abstract some worker functions not to invoke IsMtrrSupported(). They could be
used by other functions to reduce the number of invoking times on
IsMtrrSupported().

(Sync patch r19153 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19197 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 139 +++++++++++++++++++++------
 1 file changed, 108 insertions(+), 31 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 1584ae23d9ce..b1c12aa32e01 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -103,6 +103,24 @@ GLOBAL_REMOVE_IF_UNREFERENCED CONST CHAR8 *mMtrrMemoryCacheTypeShortName[] = {
   "R*"   // Invalid
 };
 
+/**
+  Worker function returns the variable MTRR count for the CPU.
+
+  @return Variable MTRR count
+
+**/
+UINT32
+GetVariableMtrrCountWorker (
+  VOID
+  )
+{
+  UINT32  VariableMtrrCount;
+
+  VariableMtrrCount = (UINT32)(AsmReadMsr64 (MTRR_LIB_IA32_MTRR_CAP) & MTRR_LIB_IA32_MTRR_CAP_VCNT_MASK);
+  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
+  return VariableMtrrCount;
+}
+
 /**
   Returns the variable MTRR count for the CPU.
 
@@ -115,34 +133,27 @@ GetVariableMtrrCount (
   VOID
   )
 {
-  UINT32  VariableMtrrCount;
-
   if (!IsMtrrSupported ()) {
     return 0;
   }
-
-  VariableMtrrCount = (UINT32)(AsmReadMsr64 (MTRR_LIB_IA32_MTRR_CAP) & MTRR_LIB_IA32_MTRR_CAP_VCNT_MASK);
-  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
-
-  return VariableMtrrCount;
+  return GetVariableMtrrCountWorker ();
 }
 
 /**
-  Returns the firmware usable variable MTRR count for the CPU.
+  Worker function returns the firmware usable variable MTRR count for the CPU.
 
   @return Firmware usable variable MTRR count
 
 **/
 UINT32
-EFIAPI
-GetFirmwareVariableMtrrCount (
+GetFirmwareVariableMtrrCountWorker (
   VOID
   )
 {
   UINT32  VariableMtrrCount;
   UINT32  ReservedMtrrNumber;
 
-  VariableMtrrCount = GetVariableMtrrCount ();
+  VariableMtrrCount = GetVariableMtrrCountWorker ();
   ReservedMtrrNumber = PcdGet32 (PcdCpuNumberOfReservedVariableMtrrs);
   if (VariableMtrrCount < ReservedMtrrNumber) {
     return 0;
@@ -151,6 +162,39 @@ GetFirmwareVariableMtrrCount (
   return VariableMtrrCount - ReservedMtrrNumber;
 }
 
+/**
+  Returns the firmware usable variable MTRR count for the CPU.
+
+  @return Firmware usable variable MTRR count
+
+**/
+UINT32
+EFIAPI
+GetFirmwareVariableMtrrCount (
+  VOID
+  )
+{
+  if (!IsMtrrSupported ()) {
+    return 0;
+  }
+  return GetFirmwareVariableMtrrCountWorker ();
+}
+
+/**
+  Worker function returns the default MTRR cache type for the system.
+
+  @return  The default MTRR cache type.
+
+**/
+MTRR_MEMORY_CACHE_TYPE
+MtrrGetDefaultMemoryTypeWorker (
+  VOID
+  )
+{
+  return (MTRR_MEMORY_CACHE_TYPE) (AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE) & 0x7);
+}
+
+
 /**
   Returns the default MTRR cache type for the system.
 
@@ -166,8 +210,7 @@ MtrrGetDefaultMemoryType (
   if (!IsMtrrSupported ()) {
     return CacheUncacheable;
   }
-
-  return (MTRR_MEMORY_CACHE_TYPE) (AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE) & 0x7);
+  return MtrrGetDefaultMemoryTypeWorker ();
 }
 
 /**
@@ -1290,26 +1333,21 @@ MtrrGetMemoryAttribute (
 
 
 /**
-  This function will get the raw value in variable MTRRs
+  Worker function will get the raw value in variable MTRRs
 
-  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
+  @param[out] VariableSettings   A buffer to hold variable MTRRs content.
 
   @return The VariableSettings input pointer
 
 **/
 MTRR_VARIABLE_SETTINGS*
-EFIAPI
-MtrrGetVariableMtrr (
-  OUT MTRR_VARIABLE_SETTINGS         *VariableSettings
+MtrrGetVariableMtrrWorker (
+  OUT MTRR_VARIABLE_SETTINGS  *VariableSettings
   )
 {
   UINT32  Index;
   UINT32  VariableMtrrCount;
 
-  if (!IsMtrrSupported ()) {
-    return VariableSettings;
-  }
-
   VariableMtrrCount = GetVariableMtrrCount ();
   ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
 
@@ -1323,6 +1361,29 @@ MtrrGetVariableMtrr (
   return  VariableSettings;
 }
 
+/**
+  This function will get the raw value in variable MTRRs
+
+  @param[out]  VariableSettings   A buffer to hold variable MTRRs content.
+
+  @return The VariableSettings input pointer
+
+**/
+MTRR_VARIABLE_SETTINGS*
+EFIAPI
+MtrrGetVariableMtrr (
+  OUT MTRR_VARIABLE_SETTINGS         *VariableSettings
+  )
+{
+  if (!IsMtrrSupported ()) {
+    return VariableSettings;
+  }
+
+  return MtrrGetVariableMtrrWorker (
+           VariableSettings
+           );
+}
+
 
 /**
   Worker function setting variable MTRRs
@@ -1380,11 +1441,34 @@ MtrrSetVariableMtrr (
   return  VariableSettings;
 }
 
+/**
+  Worker function gets the content in fixed MTRRs
+
+  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
+
+  @retval The pointer of FixedSettings
+
+**/
+MTRR_FIXED_SETTINGS*
+MtrrGetFixedMtrrWorker (
+  OUT MTRR_FIXED_SETTINGS         *FixedSettings
+  )
+{
+  UINT32  Index;
+
+  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+      FixedSettings->Mtrr[Index] =
+        AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
+  }
+
+  return FixedSettings;
+}
+
 
 /**
   This function gets the content in fixed MTRRs
 
-  @param[out]  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
 
   @retval The pointer of FixedSettings
 
@@ -1395,18 +1479,11 @@ MtrrGetFixedMtrr (
   OUT MTRR_FIXED_SETTINGS         *FixedSettings
   )
 {
-  UINT32  Index;
-
   if (!IsMtrrSupported ()) {
     return FixedSettings;
   }
 
-  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-      FixedSettings->Mtrr[Index] =
-        AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
-  };
-
-  return FixedSettings;
+  return MtrrGetFixedMtrrWorker (FixedSettings);
 }
 
 /**

From d9b7d84100be975a07b0cda0962c898ab970e614 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:23:27 +0000
Subject: [PATCH 220/525] UefiCpuPkg/MtrrLib: Adjust functions order

Only adjust functions order and there is no any real functionality impact.

(Sync patch r19154 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19198 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 956 +++++++++++++--------------
 1 file changed, 477 insertions(+), 479 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index b1c12aa32e01..ea2b211e0580 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -311,6 +311,103 @@ PostMtrrChange (
   PostMtrrChangeEnableCache (MtrrContext);
 }
 
+/**
+  Worker function gets the content in fixed MTRRs
+
+  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
+
+  @retval The pointer of FixedSettings
+
+**/
+MTRR_FIXED_SETTINGS*
+MtrrGetFixedMtrrWorker (
+  OUT MTRR_FIXED_SETTINGS         *FixedSettings
+  )
+{
+  UINT32  Index;
+
+  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+      FixedSettings->Mtrr[Index] =
+        AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
+  }
+
+  return FixedSettings;
+}
+
+
+/**
+  This function gets the content in fixed MTRRs
+
+  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
+
+  @retval The pointer of FixedSettings
+
+**/
+MTRR_FIXED_SETTINGS*
+EFIAPI
+MtrrGetFixedMtrr (
+  OUT MTRR_FIXED_SETTINGS         *FixedSettings
+  )
+{
+  if (!IsMtrrSupported ()) {
+    return FixedSettings;
+  }
+
+  return MtrrGetFixedMtrrWorker (FixedSettings);
+}
+
+
+/**
+  Worker function will get the raw value in variable MTRRs
+
+  @param[out] VariableSettings   A buffer to hold variable MTRRs content.
+
+  @return The VariableSettings input pointer
+
+**/
+MTRR_VARIABLE_SETTINGS*
+MtrrGetVariableMtrrWorker (
+  OUT MTRR_VARIABLE_SETTINGS  *VariableSettings
+  )
+{
+  UINT32  Index;
+  UINT32  VariableMtrrCount;
+
+  VariableMtrrCount = GetVariableMtrrCount ();
+  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
+
+  for (Index = 0; Index < VariableMtrrCount; Index++) {
+    VariableSettings->Mtrr[Index].Base =
+      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1));
+    VariableSettings->Mtrr[Index].Mask =
+      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1) + 1);
+  }
+
+  return  VariableSettings;
+}
+
+/**
+  This function will get the raw value in variable MTRRs
+
+  @param[out]  VariableSettings   A buffer to hold variable MTRRs content.
+
+  @return The VariableSettings input pointer
+
+**/
+MTRR_VARIABLE_SETTINGS*
+EFIAPI
+MtrrGetVariableMtrr (
+  OUT MTRR_VARIABLE_SETTINGS         *VariableSettings
+  )
+{
+  if (!IsMtrrSupported ()) {
+    return VariableSettings;
+  }
+
+  return MtrrGetVariableMtrrWorker (
+           VariableSettings
+           );
+}
 
 /**
   Programs fixed MTRRs registers.
@@ -965,126 +1062,368 @@ MtrrPrecedence (
 }
 
 
+
 /**
-  This function attempts to set the attributes for a memory range.
+  This function will get the memory cache type of the specific address.
 
-  @param[in]       BaseAddress       The physical address that is the start
-                                     address of a memory region.
-  @param[in]       Length            The size in bytes of the memory region.
-  @param[in]       Attribute         The bit mask of attributes to set for the
-                                     memory region.
+  This function is mainly for debug purpose.
 
-  @retval RETURN_SUCCESS            The attributes were set for the memory
-                                    region.
-  @retval RETURN_INVALID_PARAMETER  Length is zero.
-  @retval RETURN_UNSUPPORTED        The processor does not support one or
-                                    more bytes of the memory resource range
-                                    specified by BaseAddress and Length.
-  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support
-                                    for the memory resource range specified
-                                    by BaseAddress and Length.
-  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource
-                                    range specified by BaseAddress and Length
-                                    cannot be modified.
-  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to
-                                    modify the attributes of the memory
-                                    resource range.
+  @param[in]  Address            The specific address
+
+  @return Memory cache type of the specific address
 
 **/
-RETURN_STATUS
+MTRR_MEMORY_CACHE_TYPE
 EFIAPI
-MtrrSetMemoryAttribute (
-  IN PHYSICAL_ADDRESS        BaseAddress,
-  IN UINT64                  Length,
-  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+MtrrGetMemoryAttribute (
+  IN PHYSICAL_ADDRESS   Address
   )
 {
-  UINT64                    TempQword;
-  RETURN_STATUS             Status;
-  UINT64                    MemoryType;
-  UINT64                    Alignment;
-  BOOLEAN                   OverLap;
-  BOOLEAN                   Positive;
-  UINT32                    MsrNum;
-  UINTN                     MtrrNumber;
-  VARIABLE_MTRR             VariableMtrr[MTRR_NUMBER_OF_VARIABLE_MTRR];
-  UINT32                    UsedMtrr;
-  UINT64                    MtrrValidBitsMask;
-  UINT64                    MtrrValidAddressMask;
-  BOOLEAN                   OverwriteExistingMtrr;
-  UINT32                    FirmwareVariableMtrrCount;
-  UINT32                    VariableMtrrEnd;
-  MTRR_CONTEXT              MtrrContext;
-
-  DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
+  UINT64                  TempQword;
+  UINTN                   Index;
+  UINTN                   SubIndex;
+  UINT64                  MtrrType;
+  UINT64                  TempMtrrType;
+  MTRR_MEMORY_CACHE_TYPE  CacheType;
+  VARIABLE_MTRR           VariableMtrr[MTRR_NUMBER_OF_VARIABLE_MTRR];
+  UINT64                  MtrrValidBitsMask;
+  UINT64                  MtrrValidAddressMask;
+  UINTN                   VariableMtrrCount;
 
   if (!IsMtrrSupported ()) {
-    Status = RETURN_UNSUPPORTED;
-    goto Done;
+    return CacheUncacheable;
   }
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCount ();
-  VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
-
-  MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
-
-  TempQword = 0;
-  MemoryType = (UINT64)Attribute;
-  OverwriteExistingMtrr = FALSE;
-
   //
-  // Check for an invalid parameter
+  // Check if MTRR is enabled, if not, return UC as attribute
   //
-  if (Length == 0) {
-    Status = RETURN_INVALID_PARAMETER;
-    goto Done;
-  }
+  TempQword = AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE);
+  MtrrType = MTRR_CACHE_INVALID_TYPE;
 
-  if (
-       (BaseAddress & ~MtrrValidAddressMask) != 0 ||
-       (Length & ~MtrrValidAddressMask) != 0
-     ) {
-    Status = RETURN_UNSUPPORTED;
-    goto Done;
+  if ((TempQword & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+    return CacheUncacheable;
   }
 
   //
-  // Check if Fixed MTRR
+  // If address is less than 1M, then try to go through the fixed MTRR
   //
-  Status = RETURN_SUCCESS;
-  while ((BaseAddress < BASE_1MB) && (Length > 0) && Status == RETURN_SUCCESS) {
-    PreMtrrChange (&MtrrContext);
-    Status = ProgramFixedMtrr (MemoryType, &BaseAddress, &Length);
-    PostMtrrChange (&MtrrContext);
-    if (RETURN_ERROR (Status)) {
-      goto Done;
+  if (Address < BASE_1MB) {
+    if ((TempQword & MTRR_LIB_CACHE_FIXED_MTRR_ENABLED) != 0) {
+      //
+      // Go through the fixed MTRR
+      //
+      for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+         if (Address >= mMtrrLibFixedMtrrTable[Index].BaseAddress &&
+             Address  < (
+                          mMtrrLibFixedMtrrTable[Index].BaseAddress +
+                          (mMtrrLibFixedMtrrTable[Index].Length * 8)
+                        )
+            ) {
+           SubIndex =
+             ((UINTN)Address - mMtrrLibFixedMtrrTable[Index].BaseAddress) /
+               mMtrrLibFixedMtrrTable[Index].Length;
+           TempQword = AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
+           MtrrType =  RShiftU64 (TempQword, SubIndex * 8) & 0xFF;
+           return GetMemoryCacheTypeFromMtrrType (MtrrType);
+         }
+      }
     }
   }
-
-  if (Length == 0) {
-    //
-    // A Length of 0 can only make sense for fixed MTTR ranges.
-    // Since we just handled the fixed MTRRs, we can skip the
-    // variable MTRR section.
-    //
-    goto Done;
-  }
+  MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
+  MtrrGetMemoryAttributeInVariableMtrr(
+    MtrrValidBitsMask,
+    MtrrValidAddressMask,
+    VariableMtrr
+    );
 
   //
-  // Since memory ranges below 1MB will be overridden by the fixed MTRRs,
-  // we can set the base to 0 to save variable MTRRs.
+  // Go through the variable MTRR
   //
-  if (BaseAddress == BASE_1MB) {
-    BaseAddress = 0;
-    Length += SIZE_1MB;
+  VariableMtrrCount = GetVariableMtrrCount ();
+  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
+
+  for (Index = 0; Index < VariableMtrrCount; Index++) {
+    if (VariableMtrr[Index].Valid) {
+      if (Address >= VariableMtrr[Index].BaseAddress &&
+          Address < VariableMtrr[Index].BaseAddress+VariableMtrr[Index].Length) {
+        TempMtrrType = VariableMtrr[Index].Type;
+        MtrrType = MtrrPrecedence (MtrrType, TempMtrrType);
+      }
+    }
   }
+  CacheType = GetMemoryCacheTypeFromMtrrType (MtrrType);
 
-  //
-  // Check for overlap
-  //
-  UsedMtrr = MtrrGetMemoryAttributeInVariableMtrr (MtrrValidBitsMask, MtrrValidAddressMask, VariableMtrr);
-  OverLap = CheckMemoryAttributeOverlap (BaseAddress, BaseAddress + Length - 1, VariableMtrr);
-  if (OverLap) {
+  return CacheType;
+}
+
+
+
+/**
+  This function prints all MTRRs for debugging.
+**/
+VOID
+EFIAPI
+MtrrDebugPrintAllMtrrs (
+  VOID
+  )
+{
+  DEBUG_CODE (
+    MTRR_SETTINGS  MtrrSettings;
+    UINTN          Index;
+    UINTN          Index1;
+    UINTN          VariableMtrrCount;
+    UINT64         Base;
+    UINT64         Limit;
+    UINT64         MtrrBase;
+    UINT64         MtrrLimit;
+    UINT64         RangeBase;
+    UINT64         RangeLimit;
+    UINT64         NoRangeBase;
+    UINT64         NoRangeLimit;
+    UINT32         RegEax;
+    UINTN          MemoryType;
+    UINTN          PreviousMemoryType;
+    BOOLEAN        Found;
+
+    if (!IsMtrrSupported ()) {
+      return;
+    }
+
+    DEBUG((DEBUG_CACHE, "MTRR Settings\n"));
+    DEBUG((DEBUG_CACHE, "=============\n"));
+
+    MtrrGetAllMtrrs (&MtrrSettings);
+    DEBUG((DEBUG_CACHE, "MTRR Default Type: %016lx\n", MtrrSettings.MtrrDefType));
+    for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+      DEBUG((DEBUG_CACHE, "Fixed MTRR[%02d]   : %016lx\n", Index, MtrrSettings.Fixed.Mtrr[Index]));
+    }
+
+    VariableMtrrCount = GetVariableMtrrCount ();
+    for (Index = 0; Index < VariableMtrrCount; Index++) {
+      DEBUG((DEBUG_CACHE, "Variable MTRR[%02d]: Base=%016lx Mask=%016lx\n",
+        Index,
+        MtrrSettings.Variables.Mtrr[Index].Base,
+        MtrrSettings.Variables.Mtrr[Index].Mask
+        ));
+    }
+    DEBUG((DEBUG_CACHE, "\n"));
+    DEBUG((DEBUG_CACHE, "MTRR Ranges\n"));
+    DEBUG((DEBUG_CACHE, "====================================\n"));
+
+    Base = 0;
+    PreviousMemoryType = MTRR_CACHE_INVALID_TYPE;
+    for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+      Base = mMtrrLibFixedMtrrTable[Index].BaseAddress;
+      for (Index1 = 0; Index1 < 8; Index1++) {
+      MemoryType = (UINTN)(RShiftU64 (MtrrSettings.Fixed.Mtrr[Index], Index1 * 8) & 0xff);
+        if (MemoryType > CacheWriteBack) {
+          MemoryType = MTRR_CACHE_INVALID_TYPE;
+        }
+        if (MemoryType != PreviousMemoryType) {
+          if (PreviousMemoryType != MTRR_CACHE_INVALID_TYPE) {
+            DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
+          }
+          PreviousMemoryType = MemoryType;
+          DEBUG((DEBUG_CACHE, "%a:%016lx-", mMtrrMemoryCacheTypeShortName[MemoryType], Base));
+        }
+        Base += mMtrrLibFixedMtrrTable[Index].Length;
+      }
+    }
+    DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
+
+    VariableMtrrCount = GetVariableMtrrCount ();
+
+    Limit        = BIT36 - 1;
+    AsmCpuid (0x80000000, &RegEax, NULL, NULL, NULL);
+    if (RegEax >= 0x80000008) {
+      AsmCpuid (0x80000008, &RegEax, NULL, NULL, NULL);
+      Limit = LShiftU64 (1, RegEax & 0xff) - 1;
+    }
+    Base = BASE_1MB;
+    PreviousMemoryType = MTRR_CACHE_INVALID_TYPE;
+    do {
+      MemoryType = MtrrGetMemoryAttribute (Base);
+      if (MemoryType > CacheWriteBack) {
+        MemoryType = MTRR_CACHE_INVALID_TYPE;
+      }
+
+      if (MemoryType != PreviousMemoryType) {
+        if (PreviousMemoryType != MTRR_CACHE_INVALID_TYPE) {
+          DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
+        }
+        PreviousMemoryType = MemoryType;
+        DEBUG((DEBUG_CACHE, "%a:%016lx-", mMtrrMemoryCacheTypeShortName[MemoryType], Base));
+      }
+
+      RangeBase    = BASE_1MB;
+      NoRangeBase  = BASE_1MB;
+      RangeLimit   = Limit;
+      NoRangeLimit = Limit;
+
+      for (Index = 0, Found = FALSE; Index < VariableMtrrCount; Index++) {
+        if ((MtrrSettings.Variables.Mtrr[Index].Mask & BIT11) == 0) {
+          //
+          // If mask is not valid, then do not display range
+          //
+          continue;
+        }
+        MtrrBase  = (MtrrSettings.Variables.Mtrr[Index].Base & (~(SIZE_4KB - 1)));
+        MtrrLimit = MtrrBase + ((~(MtrrSettings.Variables.Mtrr[Index].Mask & (~(SIZE_4KB - 1)))) & Limit);
+
+        if (Base >= MtrrBase && Base < MtrrLimit) {
+          Found = TRUE;
+        }
+
+        if (Base >= MtrrBase && MtrrBase > RangeBase) {
+          RangeBase = MtrrBase;
+        }
+        if (Base > MtrrLimit && MtrrLimit > RangeBase) {
+          RangeBase = MtrrLimit + 1;
+        }
+        if (Base < MtrrBase && MtrrBase < RangeLimit) {
+          RangeLimit = MtrrBase - 1;
+        }
+        if (Base < MtrrLimit && MtrrLimit <= RangeLimit) {
+          RangeLimit = MtrrLimit;
+        }
+
+        if (Base > MtrrLimit && NoRangeBase < MtrrLimit) {
+          NoRangeBase = MtrrLimit + 1;
+        }
+        if (Base < MtrrBase && NoRangeLimit > MtrrBase) {
+          NoRangeLimit = MtrrBase - 1;
+        }
+      }
+
+      if (Found) {
+        Base = RangeLimit + 1;
+      } else {
+        Base = NoRangeLimit + 1;
+      }
+    } while (Base < Limit);
+    DEBUG((DEBUG_CACHE, "%016lx\n\n", Base - 1));
+  );
+}
+/**
+  This function attempts to set the attributes for a memory range.
+
+  @param[in]       BaseAddress       The physical address that is the start
+                                     address of a memory region.
+  @param[in]       Length            The size in bytes of the memory region.
+  @param[in]       Attribute         The bit mask of attributes to set for the
+                                     memory region.
+
+  @retval RETURN_SUCCESS            The attributes were set for the memory
+                                    region.
+  @retval RETURN_INVALID_PARAMETER  Length is zero.
+  @retval RETURN_UNSUPPORTED        The processor does not support one or
+                                    more bytes of the memory resource range
+                                    specified by BaseAddress and Length.
+  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support
+                                    for the memory resource range specified
+                                    by BaseAddress and Length.
+  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource
+                                    range specified by BaseAddress and Length
+                                    cannot be modified.
+  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to
+                                    modify the attributes of the memory
+                                    resource range.
+
+**/
+RETURN_STATUS
+EFIAPI
+MtrrSetMemoryAttribute (
+  IN PHYSICAL_ADDRESS        BaseAddress,
+  IN UINT64                  Length,
+  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+  )
+{
+  UINT64                    TempQword;
+  RETURN_STATUS             Status;
+  UINT64                    MemoryType;
+  UINT64                    Alignment;
+  BOOLEAN                   OverLap;
+  BOOLEAN                   Positive;
+  UINT32                    MsrNum;
+  UINTN                     MtrrNumber;
+  VARIABLE_MTRR             VariableMtrr[MTRR_NUMBER_OF_VARIABLE_MTRR];
+  UINT32                    UsedMtrr;
+  UINT64                    MtrrValidBitsMask;
+  UINT64                    MtrrValidAddressMask;
+  BOOLEAN                   OverwriteExistingMtrr;
+  UINT32                    FirmwareVariableMtrrCount;
+  UINT32                    VariableMtrrEnd;
+  MTRR_CONTEXT              MtrrContext;
+
+  DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
+
+  if (!IsMtrrSupported ()) {
+    Status = RETURN_UNSUPPORTED;
+    goto Done;
+  }
+
+  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCount ();
+  VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
+
+  MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
+
+  TempQword = 0;
+  MemoryType = (UINT64)Attribute;
+  OverwriteExistingMtrr = FALSE;
+
+  //
+  // Check for an invalid parameter
+  //
+  if (Length == 0) {
+    Status = RETURN_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if (
+       (BaseAddress & ~MtrrValidAddressMask) != 0 ||
+       (Length & ~MtrrValidAddressMask) != 0
+     ) {
+    Status = RETURN_UNSUPPORTED;
+    goto Done;
+  }
+
+  //
+  // Check if Fixed MTRR
+  //
+  Status = RETURN_SUCCESS;
+  while ((BaseAddress < BASE_1MB) && (Length > 0) && Status == RETURN_SUCCESS) {
+    PreMtrrChange (&MtrrContext);
+    Status = ProgramFixedMtrr (MemoryType, &BaseAddress, &Length);
+    PostMtrrChange (&MtrrContext);
+    if (RETURN_ERROR (Status)) {
+      goto Done;
+    }
+  }
+
+  if (Length == 0) {
+    //
+    // A Length of 0 can only make sense for fixed MTTR ranges.
+    // Since we just handled the fixed MTRRs, we can skip the
+    // variable MTRR section.
+    //
+    goto Done;
+  }
+
+  //
+  // Since memory ranges below 1MB will be overridden by the fixed MTRRs,
+  // we can set the base to 0 to save variable MTRRs.
+  //
+  if (BaseAddress == BASE_1MB) {
+    BaseAddress = 0;
+    Length += SIZE_1MB;
+  }
+
+  //
+  // Check for overlap
+  //
+  UsedMtrr = MtrrGetMemoryAttributeInVariableMtrr (MtrrValidBitsMask, MtrrValidAddressMask, VariableMtrr);
+  OverLap = CheckMemoryAttributeOverlap (BaseAddress, BaseAddress + Length - 1, VariableMtrr);
+  if (OverLap) {
     Status = CombineMemoryAttribute (MemoryType, &BaseAddress, &Length, VariableMtrr, &UsedMtrr, &OverwriteExistingMtrr);
     if (RETURN_ERROR (Status)) {
       goto Done;
@@ -1183,208 +1522,59 @@ MtrrSetMemoryAttribute (
     for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
       if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
         break;
-      }
-    }
-
-    ProgramVariableMtrr (
-      MsrNum,
-      BaseAddress,
-      Length,
-      MemoryType,
-      MtrrValidAddressMask
-      );
-    BaseAddress += Length;
-    TempQword   = Length - TempQword;
-    MemoryType  = MTRR_CACHE_UNCACHEABLE;
-  }
-
-  do {
-    //
-    // Find unused MTRR
-    //
-    for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
-      if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
-        break;
-      }
-    }
-
-    Length = Power2MaxMemory (TempQword);
-    if (!Positive) {
-      BaseAddress -= Length;
-    }
-
-    ProgramVariableMtrr (
-      MsrNum,
-      BaseAddress,
-      Length,
-      MemoryType,
-      MtrrValidAddressMask
-      );
-
-    if (Positive) {
-      BaseAddress += Length;
-    }
-    TempQword -= Length;
-
-  } while (TempQword > 0);
-
-Done:
-  DEBUG((DEBUG_CACHE, "  Status = %r\n", Status));
-  if (!RETURN_ERROR (Status)) {
-    MtrrDebugPrintAllMtrrs ();
-  }
-
-  return Status;
-}
-
-
-/**
-  This function will get the memory cache type of the specific address.
-
-  This function is mainly for debug purpose.
-
-  @param[in]  Address            The specific address
-
-  @return Memory cache type of the specific address
-
-**/
-MTRR_MEMORY_CACHE_TYPE
-EFIAPI
-MtrrGetMemoryAttribute (
-  IN PHYSICAL_ADDRESS   Address
-  )
-{
-  UINT64                  TempQword;
-  UINTN                   Index;
-  UINTN                   SubIndex;
-  UINT64                  MtrrType;
-  UINT64                  TempMtrrType;
-  MTRR_MEMORY_CACHE_TYPE  CacheType;
-  VARIABLE_MTRR           VariableMtrr[MTRR_NUMBER_OF_VARIABLE_MTRR];
-  UINT64                  MtrrValidBitsMask;
-  UINT64                  MtrrValidAddressMask;
-  UINTN                   VariableMtrrCount;
-
-  if (!IsMtrrSupported ()) {
-    return CacheUncacheable;
-  }
-
-  //
-  // Check if MTRR is enabled, if not, return UC as attribute
-  //
-  TempQword = AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE);
-  MtrrType = MTRR_CACHE_INVALID_TYPE;
-
-  if ((TempQword & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
-    return CacheUncacheable;
-  }
-
-  //
-  // If address is less than 1M, then try to go through the fixed MTRR
-  //
-  if (Address < BASE_1MB) {
-    if ((TempQword & MTRR_LIB_CACHE_FIXED_MTRR_ENABLED) != 0) {
-      //
-      // Go through the fixed MTRR
-      //
-      for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-         if (Address >= mMtrrLibFixedMtrrTable[Index].BaseAddress &&
-             Address  < (
-                          mMtrrLibFixedMtrrTable[Index].BaseAddress +
-                          (mMtrrLibFixedMtrrTable[Index].Length * 8)
-                        )
-            ) {
-           SubIndex =
-             ((UINTN)Address - mMtrrLibFixedMtrrTable[Index].BaseAddress) /
-               mMtrrLibFixedMtrrTable[Index].Length;
-           TempQword = AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
-           MtrrType =  RShiftU64 (TempQword, SubIndex * 8) & 0xFF;
-           return GetMemoryCacheTypeFromMtrrType (MtrrType);
-         }
-      }
-    }
-  }
-  MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
-  MtrrGetMemoryAttributeInVariableMtrr(
-    MtrrValidBitsMask,
-    MtrrValidAddressMask,
-    VariableMtrr
-    );
-
-  //
-  // Go through the variable MTRR
-  //
-  VariableMtrrCount = GetVariableMtrrCount ();
-  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
-
-  for (Index = 0; Index < VariableMtrrCount; Index++) {
-    if (VariableMtrr[Index].Valid) {
-      if (Address >= VariableMtrr[Index].BaseAddress &&
-          Address < VariableMtrr[Index].BaseAddress+VariableMtrr[Index].Length) {
-        TempMtrrType = VariableMtrr[Index].Type;
-        MtrrType = MtrrPrecedence (MtrrType, TempMtrrType);
-      }
-    }
-  }
-  CacheType = GetMemoryCacheTypeFromMtrrType (MtrrType);
-
-  return CacheType;
-}
-
-
-/**
-  Worker function will get the raw value in variable MTRRs
-
-  @param[out] VariableSettings   A buffer to hold variable MTRRs content.
-
-  @return The VariableSettings input pointer
-
-**/
-MTRR_VARIABLE_SETTINGS*
-MtrrGetVariableMtrrWorker (
-  OUT MTRR_VARIABLE_SETTINGS  *VariableSettings
-  )
-{
-  UINT32  Index;
-  UINT32  VariableMtrrCount;
-
-  VariableMtrrCount = GetVariableMtrrCount ();
-  ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
-
-  for (Index = 0; Index < VariableMtrrCount; Index++) {
-    VariableSettings->Mtrr[Index].Base =
-      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1));
-    VariableSettings->Mtrr[Index].Mask =
-      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1) + 1);
+      }
+    }
+
+    ProgramVariableMtrr (
+      MsrNum,
+      BaseAddress,
+      Length,
+      MemoryType,
+      MtrrValidAddressMask
+      );
+    BaseAddress += Length;
+    TempQword   = Length - TempQword;
+    MemoryType  = MTRR_CACHE_UNCACHEABLE;
   }
 
-  return  VariableSettings;
-}
+  do {
+    //
+    // Find unused MTRR
+    //
+    for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
+      if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+        break;
+      }
+    }
 
-/**
-  This function will get the raw value in variable MTRRs
+    Length = Power2MaxMemory (TempQword);
+    if (!Positive) {
+      BaseAddress -= Length;
+    }
 
-  @param[out]  VariableSettings   A buffer to hold variable MTRRs content.
+    ProgramVariableMtrr (
+      MsrNum,
+      BaseAddress,
+      Length,
+      MemoryType,
+      MtrrValidAddressMask
+      );
 
-  @return The VariableSettings input pointer
+    if (Positive) {
+      BaseAddress += Length;
+    }
+    TempQword -= Length;
 
-**/
-MTRR_VARIABLE_SETTINGS*
-EFIAPI
-MtrrGetVariableMtrr (
-  OUT MTRR_VARIABLE_SETTINGS         *VariableSettings
-  )
-{
-  if (!IsMtrrSupported ()) {
-    return VariableSettings;
+  } while (TempQword > 0);
+
+Done:
+  DEBUG((DEBUG_CACHE, "  Status = %r\n", Status));
+  if (!RETURN_ERROR (Status)) {
+    MtrrDebugPrintAllMtrrs ();
   }
 
-  return MtrrGetVariableMtrrWorker (
-           VariableSettings
-           );
+  return Status;
 }
-
-
 /**
   Worker function setting variable MTRRs
 
@@ -1441,51 +1631,6 @@ MtrrSetVariableMtrr (
   return  VariableSettings;
 }
 
-/**
-  Worker function gets the content in fixed MTRRs
-
-  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
-
-  @retval The pointer of FixedSettings
-
-**/
-MTRR_FIXED_SETTINGS*
-MtrrGetFixedMtrrWorker (
-  OUT MTRR_FIXED_SETTINGS         *FixedSettings
-  )
-{
-  UINT32  Index;
-
-  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-      FixedSettings->Mtrr[Index] =
-        AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
-  }
-
-  return FixedSettings;
-}
-
-
-/**
-  This function gets the content in fixed MTRRs
-
-  @param[out]  FixedSettings  A buffer to hold fixed MTRRs content.
-
-  @retval The pointer of FixedSettings
-
-**/
-MTRR_FIXED_SETTINGS*
-EFIAPI
-MtrrGetFixedMtrr (
-  OUT MTRR_FIXED_SETTINGS         *FixedSettings
-  )
-{
-  if (!IsMtrrSupported ()) {
-    return FixedSettings;
-  }
-
-  return MtrrGetFixedMtrrWorker (FixedSettings);
-}
-
 /**
   Worker function setting fixed MTRRs
 
@@ -1615,153 +1760,6 @@ MtrrSetAllMtrrs (
   return MtrrSetting;
 }
 
-/**
-  This function prints all MTRRs for debugging.
-**/
-VOID
-EFIAPI
-MtrrDebugPrintAllMtrrs (
-  VOID
-  )
-{
-  DEBUG_CODE (
-    MTRR_SETTINGS  MtrrSettings;
-    UINTN          Index;
-    UINTN          Index1;
-    UINTN          VariableMtrrCount;
-    UINT64         Base;
-    UINT64         Limit;
-    UINT64         MtrrBase;
-    UINT64         MtrrLimit;
-    UINT64         RangeBase;
-    UINT64         RangeLimit;
-    UINT64         NoRangeBase;
-    UINT64         NoRangeLimit;
-    UINT32         RegEax;
-    UINTN          MemoryType;
-    UINTN          PreviousMemoryType;
-    BOOLEAN        Found;
-
-    if (!IsMtrrSupported ()) {
-      return;
-    }
-
-    DEBUG((DEBUG_CACHE, "MTRR Settings\n"));
-    DEBUG((DEBUG_CACHE, "=============\n"));
-
-    MtrrGetAllMtrrs (&MtrrSettings);
-    DEBUG((DEBUG_CACHE, "MTRR Default Type: %016lx\n", MtrrSettings.MtrrDefType));
-    for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-      DEBUG((DEBUG_CACHE, "Fixed MTRR[%02d]   : %016lx\n", Index, MtrrSettings.Fixed.Mtrr[Index]));
-    }
-
-    VariableMtrrCount = GetVariableMtrrCount ();
-    for (Index = 0; Index < VariableMtrrCount; Index++) {
-      DEBUG((DEBUG_CACHE, "Variable MTRR[%02d]: Base=%016lx Mask=%016lx\n",
-        Index,
-        MtrrSettings.Variables.Mtrr[Index].Base,
-        MtrrSettings.Variables.Mtrr[Index].Mask
-        ));
-    }
-    DEBUG((DEBUG_CACHE, "\n"));
-    DEBUG((DEBUG_CACHE, "MTRR Ranges\n"));
-    DEBUG((DEBUG_CACHE, "====================================\n"));
-
-    Base = 0;
-    PreviousMemoryType = MTRR_CACHE_INVALID_TYPE;
-    for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-      Base = mMtrrLibFixedMtrrTable[Index].BaseAddress;
-      for (Index1 = 0; Index1 < 8; Index1++) {
-      MemoryType = (UINTN)(RShiftU64 (MtrrSettings.Fixed.Mtrr[Index], Index1 * 8) & 0xff);
-        if (MemoryType > CacheWriteBack) {
-          MemoryType = MTRR_CACHE_INVALID_TYPE;
-        }
-        if (MemoryType != PreviousMemoryType) {
-          if (PreviousMemoryType != MTRR_CACHE_INVALID_TYPE) {
-            DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
-          }
-          PreviousMemoryType = MemoryType;
-          DEBUG((DEBUG_CACHE, "%a:%016lx-", mMtrrMemoryCacheTypeShortName[MemoryType], Base));
-        }
-        Base += mMtrrLibFixedMtrrTable[Index].Length;
-      }
-    }
-    DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
-
-    VariableMtrrCount = GetVariableMtrrCount ();
-
-    Limit        = BIT36 - 1;
-    AsmCpuid (0x80000000, &RegEax, NULL, NULL, NULL);
-    if (RegEax >= 0x80000008) {
-      AsmCpuid (0x80000008, &RegEax, NULL, NULL, NULL);
-      Limit = LShiftU64 (1, RegEax & 0xff) - 1;
-    }
-    Base = BASE_1MB;
-    PreviousMemoryType = MTRR_CACHE_INVALID_TYPE;
-    do {
-      MemoryType = MtrrGetMemoryAttribute (Base);
-      if (MemoryType > CacheWriteBack) {
-        MemoryType = MTRR_CACHE_INVALID_TYPE;
-      }
-
-      if (MemoryType != PreviousMemoryType) {
-        if (PreviousMemoryType != MTRR_CACHE_INVALID_TYPE) {
-          DEBUG((DEBUG_CACHE, "%016lx\n", Base - 1));
-        }
-        PreviousMemoryType = MemoryType;
-        DEBUG((DEBUG_CACHE, "%a:%016lx-", mMtrrMemoryCacheTypeShortName[MemoryType], Base));
-      }
-
-      RangeBase    = BASE_1MB;
-      NoRangeBase  = BASE_1MB;
-      RangeLimit   = Limit;
-      NoRangeLimit = Limit;
-
-      for (Index = 0, Found = FALSE; Index < VariableMtrrCount; Index++) {
-        if ((MtrrSettings.Variables.Mtrr[Index].Mask & BIT11) == 0) {
-          //
-          // If mask is not valid, then do not display range
-          //
-          continue;
-        }
-        MtrrBase  = (MtrrSettings.Variables.Mtrr[Index].Base & (~(SIZE_4KB - 1)));
-        MtrrLimit = MtrrBase + ((~(MtrrSettings.Variables.Mtrr[Index].Mask & (~(SIZE_4KB - 1)))) & Limit);
-
-        if (Base >= MtrrBase && Base < MtrrLimit) {
-          Found = TRUE;
-        }
-
-        if (Base >= MtrrBase && MtrrBase > RangeBase) {
-          RangeBase = MtrrBase;
-        }
-        if (Base > MtrrLimit && MtrrLimit > RangeBase) {
-          RangeBase = MtrrLimit + 1;
-        }
-        if (Base < MtrrBase && MtrrBase < RangeLimit) {
-          RangeLimit = MtrrBase - 1;
-        }
-        if (Base < MtrrLimit && MtrrLimit <= RangeLimit) {
-          RangeLimit = MtrrLimit;
-        }
-
-        if (Base > MtrrLimit && NoRangeBase < MtrrLimit) {
-          NoRangeBase = MtrrLimit + 1;
-        }
-        if (Base < MtrrBase && NoRangeLimit > MtrrBase) {
-          NoRangeLimit = MtrrBase - 1;
-        }
-      }
-
-      if (Found) {
-        Base = RangeLimit + 1;
-      } else {
-        Base = NoRangeLimit + 1;
-      }
-    } while (Base < Limit);
-    DEBUG((DEBUG_CACHE, "%016lx\n\n", Base - 1));
-  );
-}
-
 /**
   Checks if MTRR is supported.
 

From de8926accb5d751ab88a73252c377be0b42ef3e7 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:23:53 +0000
Subject: [PATCH 221/525] UefiCpuPkg/MtrrLib: Make use of worker functions to
 get MTRRs count

Try to make use of worker functions to get MTRRs count. It could avoid invoking
IsMtrrSupported() for many times.

(Sync patch r19155 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19199 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 76 +++++++++++++++++++---------
 1 file changed, 51 insertions(+), 25 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index ea2b211e0580..0358fffb28a2 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -367,13 +367,12 @@ MtrrGetFixedMtrr (
 **/
 MTRR_VARIABLE_SETTINGS*
 MtrrGetVariableMtrrWorker (
+  IN  UINT32                  VariableMtrrCount,
   OUT MTRR_VARIABLE_SETTINGS  *VariableSettings
   )
 {
   UINT32  Index;
-  UINT32  VariableMtrrCount;
 
-  VariableMtrrCount = GetVariableMtrrCount ();
   ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
 
   for (Index = 0; Index < VariableMtrrCount; Index++) {
@@ -405,6 +404,7 @@ MtrrGetVariableMtrr (
   }
 
   return MtrrGetVariableMtrrWorker (
+           GetVariableMtrrCountWorker (),
            VariableSettings
            );
 }
@@ -527,7 +527,7 @@ MtrrGetMemoryAttributeInVariableMtrr (
     return 0;
   }
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCount ();
+  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
   VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
 
   ZeroMem (VariableMtrr, sizeof (VARIABLE_MTRR) * MTRR_NUMBER_OF_VARIABLE_MTRR);
@@ -563,6 +563,8 @@ MtrrGetMemoryAttributeInVariableMtrr (
 /**
   Checks overlap between given memory range and MTRRs.
 
+  @param[in]  FirmwareVariableMtrrCount  The number of variable MTRRs available
+                                         to firmware.
   @param[in]  Start                      The start address of memory range.
   @param[in]  End                        The end address of memory range.
   @param[in]  VariableMtrr               The array to shadow variable MTRRs content
@@ -573,14 +575,15 @@ MtrrGetMemoryAttributeInVariableMtrr (
 **/
 BOOLEAN
 CheckMemoryAttributeOverlap (
-  IN PHYSICAL_ADDRESS     Start,
-  IN PHYSICAL_ADDRESS     End,
-  IN VARIABLE_MTRR      *VariableMtrr
+  IN UINTN             FirmwareVariableMtrrCount,
+  IN PHYSICAL_ADDRESS  Start,
+  IN PHYSICAL_ADDRESS  End,
+  IN VARIABLE_MTRR     *VariableMtrr
   )
 {
   UINT32  Index;
 
-  for (Index = 0; Index < 6; Index++) {
+  for (Index = 0; Index < FirmwareVariableMtrrCount; Index++) {
     if (
          VariableMtrr[Index].Valid &&
          !(
@@ -623,6 +626,8 @@ InvalidateShadowMtrr (
 
   If overlap exists between given memory range and MTRRs, try to combine them.
 
+  @param[in]       FirmwareVariableMtrrCount  The number of variable MTRRs
+                                              available to firmware.
   @param[in]       Attributes                 The memory type to set.
   @param[in, out]  Base                       The base address of memory range.
   @param[in, out]  Length                     The length of memory range.
@@ -636,6 +641,7 @@ InvalidateShadowMtrr (
 **/
 RETURN_STATUS
 CombineMemoryAttribute (
+  IN     UINT32             FirmwareVariableMtrrCount,
   IN     UINT64             Attributes,
   IN OUT UINT64             *Base,
   IN OUT UINT64             *Length,
@@ -649,11 +655,8 @@ CombineMemoryAttribute (
   UINT64  CombineEnd;
   UINT64  MtrrEnd;
   UINT64  EndAddress;
-  UINT32  FirmwareVariableMtrrCount;
   BOOLEAN CoveredByExistingMtrr;
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCount ();
-
   *OverwriteExistingMtrr = FALSE;
   CoveredByExistingMtrr = FALSE;
   EndAddress = *Base +*Length - 1;
@@ -851,21 +854,21 @@ GetMtrrNumberAndDirection (
   This function programs MTRRs according to the values specified
   in the shadow array.
 
+  @param[in]       VariableMtrrCount  Number of variable MTRRs
   @param[in, out]  VariableMtrr       Shadow of variable MTRR contents
 
 **/
 VOID
 InvalidateMtrr (
+  IN     UINTN                   VariableMtrrCount,
   IN OUT VARIABLE_MTRR           *VariableMtrr
   )
 {
   UINTN         Index;
-  UINTN         VariableMtrrCount;
   MTRR_CONTEXT  MtrrContext;
 
   PreMtrrChange (&MtrrContext);
   Index = 0;
-  VariableMtrrCount = GetVariableMtrrCount ();
   while (Index < VariableMtrrCount) {
     if (!VariableMtrr[Index].Valid && VariableMtrr[Index].Used) {
        AsmWriteMsr64 (VariableMtrr[Index].Msr, 0);
@@ -1139,7 +1142,7 @@ MtrrGetMemoryAttribute (
   //
   // Go through the variable MTRR
   //
-  VariableMtrrCount = GetVariableMtrrCount ();
+  VariableMtrrCount = GetVariableMtrrCountWorker ();
   ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
 
   for (Index = 0; Index < VariableMtrrCount; Index++) {
@@ -1354,6 +1357,7 @@ MtrrSetMemoryAttribute (
   UINT32                    FirmwareVariableMtrrCount;
   UINT32                    VariableMtrrEnd;
   MTRR_CONTEXT              MtrrContext;
+  UINT32                    VariableMtrrCount;
 
   DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
 
@@ -1362,7 +1366,7 @@ MtrrSetMemoryAttribute (
     goto Done;
   }
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCount ();
+  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
   VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
 
   MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
@@ -1418,13 +1422,32 @@ MtrrSetMemoryAttribute (
     Length += SIZE_1MB;
   }
 
+  //
+  // Read all variable MTRRs
+  //
+  VariableMtrrCount = GetVariableMtrrCountWorker ();
+
   //
   // Check for overlap
   //
   UsedMtrr = MtrrGetMemoryAttributeInVariableMtrr (MtrrValidBitsMask, MtrrValidAddressMask, VariableMtrr);
-  OverLap = CheckMemoryAttributeOverlap (BaseAddress, BaseAddress + Length - 1, VariableMtrr);
+  OverLap = CheckMemoryAttributeOverlap (
+              FirmwareVariableMtrrCount,
+              BaseAddress,
+              BaseAddress + Length - 1,
+              VariableMtrr
+              );
+
   if (OverLap) {
-    Status = CombineMemoryAttribute (MemoryType, &BaseAddress, &Length, VariableMtrr, &UsedMtrr, &OverwriteExistingMtrr);
+    Status = CombineMemoryAttribute (
+               FirmwareVariableMtrrCount,
+               MemoryType,
+               &BaseAddress,
+               &Length,
+               VariableMtrr,
+               &UsedMtrr,
+               &OverwriteExistingMtrr
+               );
     if (RETURN_ERROR (Status)) {
       goto Done;
     }
@@ -1433,7 +1456,7 @@ MtrrSetMemoryAttribute (
       //
       // Combined successfully, invalidate the now-unused MTRRs
       //
-      InvalidateMtrr(VariableMtrr);
+      InvalidateMtrr(VariableMtrrCount, VariableMtrr);
       Status = RETURN_SUCCESS;
       goto Done;
     }
@@ -1447,7 +1470,7 @@ MtrrSetMemoryAttribute (
     //
     // Invalidate the now-unused MTRRs
     //
-    InvalidateMtrr(VariableMtrr);
+    InvalidateMtrr(VariableMtrrCount, VariableMtrr);
     goto Done;
   }
 
@@ -1461,7 +1484,7 @@ MtrrSetMemoryAttribute (
   //
   // Invalidate the now-unused MTRRs
   //
-  InvalidateMtrr(VariableMtrr);
+  InvalidateMtrr(VariableMtrrCount, VariableMtrr);
 
   //
   // Find first unused MTRR
@@ -1589,7 +1612,7 @@ MtrrSetVariableMtrrWorker (
   UINT32  Index;
   UINT32  VariableMtrrCount;
 
-  VariableMtrrCount = GetVariableMtrrCount ();
+  VariableMtrrCount = GetVariableMtrrCountWorker ();
   ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
 
   for (Index = 0; Index < VariableMtrrCount; Index++) {
@@ -1634,7 +1657,7 @@ MtrrSetVariableMtrr (
 /**
   Worker function setting fixed MTRRs
 
-  @param[in]  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[in]  FixedSettings  A buffer to hold fixed MTRRs content.
 
 **/
 VOID
@@ -1656,7 +1679,7 @@ MtrrSetFixedMtrrWorker (
 /**
   This function sets fixed MTRRs
 
-  @param[in]  FixedSettings  A buffer to hold fixed Mtrrs content.
+  @param[in]  FixedSettings  A buffer to hold fixed MTRRs content.
 
   @retval The pointer of FixedSettings
 
@@ -1684,7 +1707,7 @@ MtrrSetFixedMtrr (
 /**
   This function gets the content in all MTRRs (variable and fixed)
 
-  @param[out]  MtrrSetting  A buffer to hold all Mtrrs content.
+  @param[out]  MtrrSetting  A buffer to hold all MTRRs content.
 
   @retval the pointer of MtrrSetting
 
@@ -1702,12 +1725,15 @@ MtrrGetAllMtrrs (
   //
   // Get fixed MTRRs
   //
-  MtrrGetFixedMtrr (&MtrrSetting->Fixed);
+  MtrrGetFixedMtrrWorker (&MtrrSetting->Fixed);
 
   //
   // Get variable MTRRs
   //
-  MtrrGetVariableMtrr (&MtrrSetting->Variables);
+  MtrrGetVariableMtrrWorker (
+    GetVariableMtrrCountWorker (),
+    &MtrrSetting->Variables
+    );
 
   //
   // Get MTRR_DEF_TYPE value

From 58672619a3f1cf4c022d4c0c3c1cca071f70fc85 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:24:19 +0000
Subject: [PATCH 222/525] UefiCpuPkg/MtrrLib: Add
 MtrrGetMemoryAttributeInVariableMtrrWorker ()

Add function to shadow the content of variable MTRRs into an internal array:
VariableMtrr. And used MtrrGetMemoryAttributeInVariableMtrrWorker() in other
functions.

(Sync patch r19156 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19200 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 121 ++++++++++++++++++---------
 1 file changed, 82 insertions(+), 39 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 0358fffb28a2..697dc4352f61 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -495,6 +495,50 @@ ProgramFixedMtrr (
 }
 
 
+/**
+  Worker function gets the attribute of variable MTRRs.
+
+  This function shadows the content of variable MTRRs into an
+  internal array: VariableMtrr.
+
+  @param[in]   VariableSettings           The variable MTRR values to shadow
+  @param[in]   FirmwareVariableMtrrCount  The number of variable MTRRs available to firmware
+  @param[in]   MtrrValidBitsMask          The mask for the valid bit of the MTRR
+  @param[in]   MtrrValidAddressMask       The valid address mask for MTRR
+  @param[out]  VariableMtrr               The array to shadow variable MTRRs content
+
+  @return                       The return value of this parameter indicates the
+                                number of MTRRs which has been used.
+
+**/
+UINT32
+MtrrGetMemoryAttributeInVariableMtrrWorker (
+  IN  MTRR_VARIABLE_SETTINGS  *VariableSettings,
+  IN  UINTN                   FirmwareVariableMtrrCount,
+  IN  UINT64                  MtrrValidBitsMask,
+  IN  UINT64                  MtrrValidAddressMask,
+  OUT VARIABLE_MTRR           *VariableMtrr
+  )
+{
+  UINTN   Index;
+  UINT32  UsedMtrr;
+
+  ZeroMem (VariableMtrr, sizeof (VARIABLE_MTRR) * MTRR_NUMBER_OF_VARIABLE_MTRR);
+  for (Index = 0, UsedMtrr = 0; Index < FirmwareVariableMtrrCount; Index++) {
+    if ((VariableSettings->Mtrr[Index].Mask & MTRR_LIB_CACHE_MTRR_ENABLED) != 0) {
+      VariableMtrr[Index].Msr         = (UINT32)Index;
+      VariableMtrr[Index].BaseAddress = (VariableSettings->Mtrr[Index].Base & MtrrValidAddressMask);
+      VariableMtrr[Index].Length      = ((~(VariableSettings->Mtrr[Index].Mask & MtrrValidAddressMask)) & MtrrValidBitsMask) + 1;
+      VariableMtrr[Index].Type        = (VariableSettings->Mtrr[Index].Base & 0x0ff);
+      VariableMtrr[Index].Valid       = TRUE;
+      VariableMtrr[Index].Used        = TRUE;
+      UsedMtrr++;
+    }
+  }
+  return UsedMtrr;
+}
+
+
 /**
   Gets the attribute of variable MTRRs.
 
@@ -517,46 +561,24 @@ MtrrGetMemoryAttributeInVariableMtrr (
   OUT VARIABLE_MTRR             *VariableMtrr
   )
 {
-  UINTN   Index;
-  UINT32  MsrNum;
-  UINT32  UsedMtrr;
-  UINT32  FirmwareVariableMtrrCount;
-  UINT32  VariableMtrrEnd;
+  MTRR_VARIABLE_SETTINGS  VariableSettings;
 
   if (!IsMtrrSupported ()) {
     return 0;
   }
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
-  VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
-
-  ZeroMem (VariableMtrr, sizeof (VARIABLE_MTRR) * MTRR_NUMBER_OF_VARIABLE_MTRR);
-  UsedMtrr = 0;
+  MtrrGetVariableMtrrWorker (
+    GetVariableMtrrCountWorker (),
+    &VariableSettings
+    );
 
-  for (MsrNum = MTRR_LIB_IA32_VARIABLE_MTRR_BASE, Index = 0;
-       (
-         (MsrNum < VariableMtrrEnd) &&
-         (Index < FirmwareVariableMtrrCount)
-       );
-       MsrNum += 2
-      ) {
-    if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) != 0) {
-      VariableMtrr[Index].Msr          = MsrNum;
-      VariableMtrr[Index].BaseAddress  = (AsmReadMsr64 (MsrNum) &
-                                          MtrrValidAddressMask);
-      VariableMtrr[Index].Length       = ((~(AsmReadMsr64 (MsrNum + 1) &
-                                             MtrrValidAddressMask)
-                                          ) &
-                                          MtrrValidBitsMask
-                                         ) + 1;
-      VariableMtrr[Index].Type         = (AsmReadMsr64 (MsrNum) & 0x0ff);
-      VariableMtrr[Index].Valid        = TRUE;
-      VariableMtrr[Index].Used         = TRUE;
-      UsedMtrr = UsedMtrr  + 1;
-      Index++;
-    }
-  }
-  return UsedMtrr;
+  return MtrrGetMemoryAttributeInVariableMtrrWorker (
+           &VariableSettings,
+           GetFirmwareVariableMtrrCountWorker (),
+           MtrrValidBitsMask,
+           MtrrValidAddressMask,
+           VariableMtrr
+           );
 }
 
 
@@ -1092,6 +1114,7 @@ MtrrGetMemoryAttribute (
   UINT64                  MtrrValidBitsMask;
   UINT64                  MtrrValidAddressMask;
   UINTN                   VariableMtrrCount;
+  MTRR_VARIABLE_SETTINGS  VariableSettings;
 
   if (!IsMtrrSupported ()) {
     return CacheUncacheable;
@@ -1133,12 +1156,20 @@ MtrrGetMemoryAttribute (
     }
   }
   MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
-  MtrrGetMemoryAttributeInVariableMtrr(
-    MtrrValidBitsMask,
-    MtrrValidAddressMask,
-    VariableMtrr
+
+  MtrrGetVariableMtrrWorker (
+    GetVariableMtrrCountWorker (),
+    &VariableSettings
     );
 
+  MtrrGetMemoryAttributeInVariableMtrrWorker (
+           &VariableSettings,
+           GetFirmwareVariableMtrrCountWorker (),
+           MtrrValidBitsMask,
+           MtrrValidAddressMask,
+           VariableMtrr
+           );
+
   //
   // Go through the variable MTRR
   //
@@ -1358,6 +1389,9 @@ MtrrSetMemoryAttribute (
   UINT32                    VariableMtrrEnd;
   MTRR_CONTEXT              MtrrContext;
   UINT32                    VariableMtrrCount;
+  MTRR_VARIABLE_SETTINGS    OriginalVariableSettings;
+  MTRR_VARIABLE_SETTINGS    WorkingVariableSettings;
+  MTRR_VARIABLE_SETTINGS    *VariableSettings;
 
   DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
 
@@ -1426,11 +1460,20 @@ MtrrSetMemoryAttribute (
   // Read all variable MTRRs
   //
   VariableMtrrCount = GetVariableMtrrCountWorker ();
+  MtrrGetVariableMtrrWorker (VariableMtrrCount, &OriginalVariableSettings);
+  CopyMem (&WorkingVariableSettings, &OriginalVariableSettings, sizeof (WorkingVariableSettings));
+  VariableSettings = &WorkingVariableSettings;
 
   //
   // Check for overlap
   //
-  UsedMtrr = MtrrGetMemoryAttributeInVariableMtrr (MtrrValidBitsMask, MtrrValidAddressMask, VariableMtrr);
+  UsedMtrr = MtrrGetMemoryAttributeInVariableMtrrWorker (
+               VariableSettings,
+               FirmwareVariableMtrrCount,
+               MtrrValidBitsMask,
+               MtrrValidAddressMask,
+               VariableMtrr
+               );
   OverLap = CheckMemoryAttributeOverlap (
               FirmwareVariableMtrrCount,
               BaseAddress,

From d4ac50dfffbccd5fe608de084be489c7b45d93eb Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:24:56 +0000
Subject: [PATCH 223/525] UefiCpuPkg/MtrrLib: Reduce hardware init when program
 fixed MTRRs

When MtrrSetMemoryAttribute() programs fixed MTRRs, it may disable/enable cache
and disable/enable MTRRs several times. This updating tries to do operation in
local variable and does the hardware initialization one time only.

(Sync patch r19157 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19201 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 90 +++++++++++++++++++++-------
 1 file changed, 70 insertions(+), 20 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 697dc4352f61..322f47b0976c 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -415,6 +415,9 @@ MtrrGetVariableMtrr (
   @param[in]      MemoryCacheType  The memory type to set.
   @param[in, out] Base             The base address of memory range.
   @param[in, out] Length           The length of memory range.
+  @param[out]     ReturnMsrNum     The index of the fixed MTRR MSR to program.
+  @param[out]     ReturnClearMask  The bits to clear in the fixed MTRR MSR.
+  @param[out]     ReturnOrMask     The bits to set in the fixed MTRR MSR.
 
   @retval RETURN_SUCCESS      The cache type was updated successfully
   @retval RETURN_UNSUPPORTED  The requested range or cache type was invalid
@@ -423,9 +426,12 @@ MtrrGetVariableMtrr (
 **/
 RETURN_STATUS
 ProgramFixedMtrr (
-  IN     UINT64     MemoryCacheType,
-  IN OUT UINT64     *Base,
-  IN OUT UINT64     *Length
+  IN     UINT64               MemoryCacheType,
+  IN OUT UINT64               *Base,
+  IN OUT UINT64               *Length,
+  OUT    UINT32               *ReturnMsrNum,
+  OUT    UINT64               *ReturnClearMask,
+  OUT    UINT64               *ReturnOrMask
   )
 {
   UINT32  MsrNum;
@@ -488,9 +494,10 @@ ProgramFixedMtrr (
     return RETURN_UNSUPPORTED;
   }
 
-  TempQword =
-    (AsmReadMsr64 (mMtrrLibFixedMtrrTable[MsrNum].Msr) & ~ClearMask) | OrMask;
-  AsmWriteMsr64 (mMtrrLibFixedMtrrTable[MsrNum].Msr, TempQword);
+  *ReturnMsrNum    = MsrNum;
+  *ReturnClearMask = ClearMask;
+  *ReturnOrMask    = OrMask;
+
   return RETURN_SUCCESS;
 }
 
@@ -1388,12 +1395,25 @@ MtrrSetMemoryAttribute (
   UINT32                    FirmwareVariableMtrrCount;
   UINT32                    VariableMtrrEnd;
   MTRR_CONTEXT              MtrrContext;
+  BOOLEAN                   MtrrContextValid;
+  BOOLEAN                   FixedSettingsValid[MTRR_NUMBER_OF_FIXED_MTRR];
+  BOOLEAN                   FixedSettingsModified[MTRR_NUMBER_OF_FIXED_MTRR];
+  MTRR_FIXED_SETTINGS       WorkingFixedSettings;
   UINT32                    VariableMtrrCount;
   MTRR_VARIABLE_SETTINGS    OriginalVariableSettings;
   MTRR_VARIABLE_SETTINGS    WorkingVariableSettings;
+  UINT32                    Index;
+  UINT64                    ClearMask;
+  UINT64                    OrMask;
+  UINT64                    NewValue;
   MTRR_VARIABLE_SETTINGS    *VariableSettings;
 
   DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
+  MtrrContextValid = FALSE;
+  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+    FixedSettingsValid[Index]    = FALSE;
+    FixedSettingsModified[Index] = FALSE;
+  }
 
   if (!IsMtrrSupported ()) {
     Status = RETURN_UNSUPPORTED;
@@ -1429,22 +1449,31 @@ MtrrSetMemoryAttribute (
   // Check if Fixed MTRR
   //
   Status = RETURN_SUCCESS;
-  while ((BaseAddress < BASE_1MB) && (Length > 0) && Status == RETURN_SUCCESS) {
-    PreMtrrChange (&MtrrContext);
-    Status = ProgramFixedMtrr (MemoryType, &BaseAddress, &Length);
-    PostMtrrChange (&MtrrContext);
-    if (RETURN_ERROR (Status)) {
-      goto Done;
+  if (BaseAddress < BASE_1MB) {
+    while ((BaseAddress < BASE_1MB) && (Length > 0) && Status == RETURN_SUCCESS) {
+      Status = ProgramFixedMtrr (MemoryType, &BaseAddress, &Length, &MsrNum, &ClearMask, &OrMask);
+      if (RETURN_ERROR (Status)) {
+        goto Done;
+      }
+      if (!FixedSettingsValid[MsrNum]) {
+        WorkingFixedSettings.Mtrr[MsrNum] = AsmReadMsr64 (mMtrrLibFixedMtrrTable[MsrNum].Msr);
+        FixedSettingsValid[MsrNum] = TRUE;
+      }
+      NewValue = (WorkingFixedSettings.Mtrr[MsrNum] & ~ClearMask) | OrMask;
+      if (WorkingFixedSettings.Mtrr[MsrNum] != NewValue) {
+        WorkingFixedSettings.Mtrr[MsrNum] = NewValue;
+        FixedSettingsModified[MsrNum] = TRUE;
+      }
     }
-  }
 
-  if (Length == 0) {
-    //
-    // A Length of 0 can only make sense for fixed MTTR ranges.
-    // Since we just handled the fixed MTRRs, we can skip the
-    // variable MTRR section.
-    //
-    goto Done;
+    if (Length == 0) {
+      //
+      // A Length of 0 can only make sense for fixed MTTR ranges.
+      // Since we just handled the fixed MTRRs, we can skip the
+      // variable MTRR section.
+      //
+      goto Done;
+    }
   }
 
   //
@@ -1634,6 +1663,27 @@ MtrrSetMemoryAttribute (
   } while (TempQword > 0);
 
 Done:
+
+  //
+  // Write fixed MTRRs that have been modified
+  //
+  for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
+    if (FixedSettingsModified[Index]) {
+      if (!MtrrContextValid) {
+        PreMtrrChange (&MtrrContext);
+        MtrrContextValid = TRUE;
+      }
+      AsmWriteMsr64 (
+        mMtrrLibFixedMtrrTable[Index].Msr,
+        WorkingFixedSettings.Mtrr[Index]
+        );
+    }
+  }
+
+  if (MtrrContextValid) {
+    PostMtrrChange (&MtrrContext);
+  }
+
   DEBUG((DEBUG_CACHE, "  Status = %r\n", Status));
   if (!RETURN_ERROR (Status)) {
     MtrrDebugPrintAllMtrrs ();

From bf4f151df461b4b840600d7ea75736a065618be0 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:25:24 +0000
Subject: [PATCH 224/525] UefiCpuPkg/MtrrLib: Reduce hardware init when program
 variable MTRRs

When MtrrSetMemoryAttribute() programs variable MTRRs, it may disable/enable
cache and disable/enable MTRRs several times. This updating tries to do
operation in local variable and does the hardware initialization one time only.

(Sync patch r19158 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19202 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 98 ++++++++++++++++------------
 1 file changed, 55 insertions(+), 43 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 322f47b0976c..0e76e2f92ad5 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -883,30 +883,27 @@ GetMtrrNumberAndDirection (
   This function programs MTRRs according to the values specified
   in the shadow array.
 
+  @param[in, out]  VariableSettings   Variable MTRR settings
   @param[in]       VariableMtrrCount  Number of variable MTRRs
   @param[in, out]  VariableMtrr       Shadow of variable MTRR contents
 
 **/
 VOID
 InvalidateMtrr (
+  IN OUT MTRR_VARIABLE_SETTINGS  *VariableSettings,
   IN     UINTN                   VariableMtrrCount,
   IN OUT VARIABLE_MTRR           *VariableMtrr
   )
 {
   UINTN         Index;
-  MTRR_CONTEXT  MtrrContext;
 
-  PreMtrrChange (&MtrrContext);
-  Index = 0;
-  while (Index < VariableMtrrCount) {
+  for (Index = 0; Index < VariableMtrrCount; Index++) {
     if (!VariableMtrr[Index].Valid && VariableMtrr[Index].Used) {
-       AsmWriteMsr64 (VariableMtrr[Index].Msr, 0);
-       AsmWriteMsr64 (VariableMtrr[Index].Msr + 1, 0);
+       VariableSettings->Mtrr[Index].Base = 0;
+       VariableSettings->Mtrr[Index].Mask = 0;
        VariableMtrr[Index].Used = FALSE;
     }
-    Index ++;
   }
-  PostMtrrChange (&MtrrContext);
 }
 
 
@@ -915,6 +912,7 @@ InvalidateMtrr (
 
   This function programs variable MTRRs
 
+  @param[in, out]  VariableSettings      Variable MTRR settings.
   @param[in]       MtrrNumber            Index of MTRR to program.
   @param[in]       BaseAddress           Base address of memory region.
   @param[in]       Length                Length of memory region.
@@ -924,34 +922,27 @@ InvalidateMtrr (
 **/
 VOID
 ProgramVariableMtrr (
-  IN UINTN                    MtrrNumber,
-  IN PHYSICAL_ADDRESS         BaseAddress,
-  IN UINT64                   Length,
-  IN UINT64                   MemoryCacheType,
-  IN UINT64                   MtrrValidAddressMask
+  IN OUT MTRR_VARIABLE_SETTINGS  *VariableSettings,
+  IN     UINTN                   MtrrNumber,
+  IN     PHYSICAL_ADDRESS        BaseAddress,
+  IN     UINT64                  Length,
+  IN     UINT64                  MemoryCacheType,
+  IN     UINT64                  MtrrValidAddressMask
   )
 {
   UINT64        TempQword;
-  MTRR_CONTEXT  MtrrContext;
-
-  PreMtrrChange (&MtrrContext);
 
   //
   // MTRR Physical Base
   //
   TempQword = (BaseAddress & MtrrValidAddressMask) | MemoryCacheType;
-  AsmWriteMsr64 ((UINT32) MtrrNumber, TempQword);
+  VariableSettings->Mtrr[MtrrNumber].Base = TempQword;
 
   //
   // MTRR Physical Mask
   //
   TempQword = ~(Length - 1);
-  AsmWriteMsr64 (
-    (UINT32) (MtrrNumber + 1),
-    (TempQword & MtrrValidAddressMask) | MTRR_LIB_CACHE_MTRR_ENABLED
-    );
-
-  PostMtrrChange (&MtrrContext);
+  VariableSettings->Mtrr[MtrrNumber].Mask = (TempQword & MtrrValidAddressMask) | MTRR_LIB_CACHE_MTRR_ENABLED;
 }
 
 
@@ -1393,7 +1384,6 @@ MtrrSetMemoryAttribute (
   UINT64                    MtrrValidAddressMask;
   BOOLEAN                   OverwriteExistingMtrr;
   UINT32                    FirmwareVariableMtrrCount;
-  UINT32                    VariableMtrrEnd;
   MTRR_CONTEXT              MtrrContext;
   BOOLEAN                   MtrrContextValid;
   BOOLEAN                   FixedSettingsValid[MTRR_NUMBER_OF_FIXED_MTRR];
@@ -1401,6 +1391,7 @@ MtrrSetMemoryAttribute (
   MTRR_FIXED_SETTINGS       WorkingFixedSettings;
   UINT32                    VariableMtrrCount;
   MTRR_VARIABLE_SETTINGS    OriginalVariableSettings;
+  BOOLEAN                   ProgramVariableSettings;
   MTRR_VARIABLE_SETTINGS    WorkingVariableSettings;
   UINT32                    Index;
   UINT64                    ClearMask;
@@ -1414,16 +1405,14 @@ MtrrSetMemoryAttribute (
     FixedSettingsValid[Index]    = FALSE;
     FixedSettingsModified[Index] = FALSE;
   }
+  ProgramVariableSettings = FALSE;
 
   if (!IsMtrrSupported ()) {
     Status = RETURN_UNSUPPORTED;
     goto Done;
   }
 
-  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
-  VariableMtrrEnd = MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (2 * GetVariableMtrrCount ()) - 1;
-
-  MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
+  MtrrLibInitializeMtrrMask (&MtrrValidBitsMask, &MtrrValidAddressMask);
 
   TempQword = 0;
   MemoryType = (UINT64)Attribute;
@@ -1489,8 +1478,10 @@ MtrrSetMemoryAttribute (
   // Read all variable MTRRs
   //
   VariableMtrrCount = GetVariableMtrrCountWorker ();
+  FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
   MtrrGetVariableMtrrWorker (VariableMtrrCount, &OriginalVariableSettings);
   CopyMem (&WorkingVariableSettings, &OriginalVariableSettings, sizeof (WorkingVariableSettings));
+  ProgramVariableSettings = TRUE;
   VariableSettings = &WorkingVariableSettings;
 
   //
@@ -1509,7 +1500,6 @@ MtrrSetMemoryAttribute (
               BaseAddress + Length - 1,
               VariableMtrr
               );
-
   if (OverLap) {
     Status = CombineMemoryAttribute (
                FirmwareVariableMtrrCount,
@@ -1528,7 +1518,7 @@ MtrrSetMemoryAttribute (
       //
       // Combined successfully, invalidate the now-unused MTRRs
       //
-      InvalidateMtrr(VariableMtrrCount, VariableMtrr);
+      InvalidateMtrr (VariableSettings, VariableMtrrCount, VariableMtrr);
       Status = RETURN_SUCCESS;
       goto Done;
     }
@@ -1542,7 +1532,7 @@ MtrrSetMemoryAttribute (
     //
     // Invalidate the now-unused MTRRs
     //
-    InvalidateMtrr(VariableMtrrCount, VariableMtrr);
+    InvalidateMtrr (VariableSettings, VariableMtrrCount, VariableMtrr);
     goto Done;
   }
 
@@ -1556,16 +1546,13 @@ MtrrSetMemoryAttribute (
   //
   // Invalidate the now-unused MTRRs
   //
-  InvalidateMtrr(VariableMtrrCount, VariableMtrr);
+  InvalidateMtrr (VariableSettings, VariableMtrrCount, VariableMtrr);
 
   //
   // Find first unused MTRR
   //
-  for (MsrNum = MTRR_LIB_IA32_VARIABLE_MTRR_BASE;
-       MsrNum < VariableMtrrEnd;
-       MsrNum += 2
-      ) {
-    if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+  for (MsrNum = 0; MsrNum < VariableMtrrCount; MsrNum++) {
+    if ((VariableSettings->Mtrr[MsrNum].Mask & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
       break;
     }
   }
@@ -1584,13 +1571,14 @@ MtrrSetMemoryAttribute (
       //
       // Find unused MTRR
       //
-      for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
-        if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+      for (; MsrNum < VariableMtrrCount; MsrNum++) {
+        if ((VariableSettings->Mtrr[MsrNum].Mask & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
           break;
         }
       }
 
       ProgramVariableMtrr (
+        VariableSettings,
         MsrNum,
         BaseAddress,
         Alignment,
@@ -1614,13 +1602,14 @@ MtrrSetMemoryAttribute (
     //
     // Find unused MTRR
     //
-    for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
-      if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+    for (; MsrNum < VariableMtrrCount; MsrNum++) {
+      if ((VariableSettings->Mtrr[MsrNum].Mask & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
         break;
       }
     }
 
     ProgramVariableMtrr (
+      VariableSettings,
       MsrNum,
       BaseAddress,
       Length,
@@ -1636,8 +1625,8 @@ MtrrSetMemoryAttribute (
     //
     // Find unused MTRR
     //
-    for (; MsrNum < VariableMtrrEnd; MsrNum += 2) {
-      if ((AsmReadMsr64 (MsrNum + 1) & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
+    for (; MsrNum < VariableMtrrCount; MsrNum++) {
+      if ((VariableSettings->Mtrr[MsrNum].Mask & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
         break;
       }
     }
@@ -1648,6 +1637,7 @@ MtrrSetMemoryAttribute (
     }
 
     ProgramVariableMtrr (
+      VariableSettings,
       MsrNum,
       BaseAddress,
       Length,
@@ -1680,6 +1670,28 @@ MtrrSetMemoryAttribute (
     }
   }
 
+  //
+  // Write variable MTRRs
+  //
+  if (ProgramVariableSettings) {
+    for (Index = 0; Index < VariableMtrrCount; Index++) {
+      if (WorkingVariableSettings.Mtrr[Index].Base != OriginalVariableSettings.Mtrr[Index].Base ||
+          WorkingVariableSettings.Mtrr[Index].Mask != OriginalVariableSettings.Mtrr[Index].Mask    ) {
+        if (!MtrrContextValid) {
+          PreMtrrChange (&MtrrContext);
+          MtrrContextValid = TRUE;
+        }
+        AsmWriteMsr64 (
+          MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1),
+          WorkingVariableSettings.Mtrr[Index].Base
+          );
+        AsmWriteMsr64 (
+          MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1) + 1,
+          WorkingVariableSettings.Mtrr[Index].Mask
+          );
+      }
+    }
+  }
   if (MtrrContextValid) {
     PostMtrrChange (&MtrrContext);
   }

From 1a66807b216a6f17e4f206c121c998008c2460d6 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:25:55 +0000
Subject: [PATCH 225/525] UefiCpuPkg/MtrrLib: Print MTRR settings when set
 fixed/variable MTRRs

(Sync patch r19159 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19203 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 0e76e2f92ad5..d29aca2bdcfb 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -1756,6 +1756,8 @@ MtrrSetVariableMtrr (
   PreMtrrChange (&MtrrContext);
   MtrrSetVariableMtrrWorker (VariableSettings);
   PostMtrrChange (&MtrrContext);
+  MtrrDebugPrintAllMtrrs ();
+
   return  VariableSettings;
 }
 
@@ -1804,6 +1806,7 @@ MtrrSetFixedMtrr (
   PreMtrrChange (&MtrrContext);
   MtrrSetFixedMtrrWorker (FixedSettings);
   PostMtrrChange (&MtrrContext);
+  MtrrDebugPrintAllMtrrs ();
 
   return FixedSettings;
 }
@@ -1888,9 +1891,12 @@ MtrrSetAllMtrrs (
 
   PostMtrrChangeEnableCache (&MtrrContext);
 
+  MtrrDebugPrintAllMtrrs ();
+
   return MtrrSetting;
 }
 
+
 /**
   Checks if MTRR is supported.
 

From 9975f897f84f0e6baff716b1b778bb9cd893b526 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:26:28 +0000
Subject: [PATCH 226/525] UefiCpuPkg/MtrrLib: Add worker functions to access
 MTRRs or variable

Add worker functions that could access MTRRs or MTRR settings in input buffer.

(Sync patch r19160 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19204 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 106 +++++++++++++++++++++------
 1 file changed, 83 insertions(+), 23 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index d29aca2bdcfb..4c76abf9eb38 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -183,15 +183,25 @@ GetFirmwareVariableMtrrCount (
 /**
   Worker function returns the default MTRR cache type for the system.
 
+  If MtrrSetting is not NULL, returns the default MTRR cache type from input
+  MTRR settings buffer.
+  If MtrrSetting is NULL, returns the default MTRR cache type from MSR.
+
+  @param[in]  MtrrSetting    A buffer holding all MTRRs content.
+
   @return  The default MTRR cache type.
 
 **/
 MTRR_MEMORY_CACHE_TYPE
 MtrrGetDefaultMemoryTypeWorker (
-  VOID
+  IN MTRR_SETTINGS      *MtrrSetting
   )
 {
-  return (MTRR_MEMORY_CACHE_TYPE) (AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE) & 0x7);
+  if (MtrrSetting == NULL) {
+    return (MTRR_MEMORY_CACHE_TYPE) (AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE) & 0x7);
+  } else {
+    return (MTRR_MEMORY_CACHE_TYPE) (MtrrSetting->MtrrDefType & 0x7);
+  }
 }
 
 
@@ -210,7 +220,7 @@ MtrrGetDefaultMemoryType (
   if (!IsMtrrSupported ()) {
     return CacheUncacheable;
   }
-  return MtrrGetDefaultMemoryTypeWorker ();
+  return MtrrGetDefaultMemoryTypeWorker (NULL);
 }
 
 /**
@@ -360,6 +370,12 @@ MtrrGetFixedMtrr (
 /**
   Worker function will get the raw value in variable MTRRs
 
+  If MtrrSetting is not NULL, gets the variable MTRRs raw value from input
+  MTRR settings buffer.
+  If MtrrSetting is NULL, gets the variable MTRRs raw value from MTRRs.
+
+  @param[in]  MtrrSetting        A buffer holding all MTRRs content.
+  @param[in]  VariableMtrrCount  Number of variable MTRRs.
   @param[out] VariableSettings   A buffer to hold variable MTRRs content.
 
   @return The VariableSettings input pointer
@@ -367,6 +383,7 @@ MtrrGetFixedMtrr (
 **/
 MTRR_VARIABLE_SETTINGS*
 MtrrGetVariableMtrrWorker (
+  IN  MTRR_SETTINGS           *MtrrSetting,
   IN  UINT32                  VariableMtrrCount,
   OUT MTRR_VARIABLE_SETTINGS  *VariableSettings
   )
@@ -376,10 +393,15 @@ MtrrGetVariableMtrrWorker (
   ASSERT (VariableMtrrCount <= MTRR_NUMBER_OF_VARIABLE_MTRR);
 
   for (Index = 0; Index < VariableMtrrCount; Index++) {
-    VariableSettings->Mtrr[Index].Base =
-      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1));
-    VariableSettings->Mtrr[Index].Mask =
-      AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1) + 1);
+    if (MtrrSetting == NULL) {
+      VariableSettings->Mtrr[Index].Base =
+        AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1));
+      VariableSettings->Mtrr[Index].Mask =
+        AsmReadMsr64 (MTRR_LIB_IA32_VARIABLE_MTRR_BASE + (Index << 1) + 1);
+    } else {
+      VariableSettings->Mtrr[Index].Base = MtrrSetting->Variables.Mtrr[Index].Base;
+      VariableSettings->Mtrr[Index].Mask = MtrrSetting->Variables.Mtrr[Index].Mask;
+    }
   }
 
   return  VariableSettings;
@@ -404,6 +426,7 @@ MtrrGetVariableMtrr (
   }
 
   return MtrrGetVariableMtrrWorker (
+           NULL,
            GetVariableMtrrCountWorker (),
            VariableSettings
            );
@@ -575,6 +598,7 @@ MtrrGetMemoryAttributeInVariableMtrr (
   }
 
   MtrrGetVariableMtrrWorker (
+    NULL,
     GetVariableMtrrCountWorker (),
     &VariableSettings
     );
@@ -949,6 +973,11 @@ ProgramVariableMtrr (
 /**
   Converts the Memory attribute value to MTRR_MEMORY_CACHE_TYPE.
 
+  If MtrrSetting is not NULL, gets the default memory attribute from input
+  MTRR settings buffer.
+  If MtrrSetting is NULL, gets the default memory attribute from MSR.
+
+  @param[in]  MtrrSetting        A buffer holding all MTRRs content.
   @param[in]  MtrrType           MTRR memory type
 
   @return The enum item in MTRR_MEMORY_CACHE_TYPE
@@ -956,6 +985,7 @@ ProgramVariableMtrr (
 **/
 MTRR_MEMORY_CACHE_TYPE
 GetMemoryCacheTypeFromMtrrType (
+  IN MTRR_SETTINGS         *MtrrSetting,
   IN UINT64                MtrrType
   )
 {
@@ -975,7 +1005,7 @@ GetMemoryCacheTypeFromMtrrType (
     // MtrrType is MTRR_CACHE_INVALID_TYPE, that means
     // no MTRR covers the range
     //
-    return MtrrGetDefaultMemoryType ();
+    return MtrrGetDefaultMemoryTypeWorker (MtrrSetting);
   }
 }
 
@@ -1084,21 +1114,22 @@ MtrrPrecedence (
   return MtrrType;
 }
 
-
-
 /**
-  This function will get the memory cache type of the specific address.
+  Worker function will get the memory cache type of the specific address.
 
-  This function is mainly for debug purpose.
+  If MtrrSetting is not NULL, gets the memory cache type from input
+  MTRR settings buffer.
+  If MtrrSetting is NULL, gets the memory cache type from MTRRs.
 
+  @param[in]  MtrrSetting        A buffer holding all MTRRs content.
   @param[in]  Address            The specific address
 
   @return Memory cache type of the specific address
 
 **/
 MTRR_MEMORY_CACHE_TYPE
-EFIAPI
-MtrrGetMemoryAttribute (
+MtrrGetMemoryAttributeByAddressWorker (
+  IN MTRR_SETTINGS      *MtrrSetting,
   IN PHYSICAL_ADDRESS   Address
   )
 {
@@ -1114,14 +1145,14 @@ MtrrGetMemoryAttribute (
   UINTN                   VariableMtrrCount;
   MTRR_VARIABLE_SETTINGS  VariableSettings;
 
-  if (!IsMtrrSupported ()) {
-    return CacheUncacheable;
-  }
-
   //
   // Check if MTRR is enabled, if not, return UC as attribute
   //
-  TempQword = AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE);
+  if (MtrrSetting == NULL) {
+    TempQword = AsmReadMsr64 (MTRR_LIB_IA32_MTRR_DEF_TYPE);
+  } else {
+    TempQword = MtrrSetting->MtrrDefType;
+  }
   MtrrType = MTRR_CACHE_INVALID_TYPE;
 
   if ((TempQword & MTRR_LIB_CACHE_MTRR_ENABLED) == 0) {
@@ -1146,9 +1177,13 @@ MtrrGetMemoryAttribute (
            SubIndex =
              ((UINTN)Address - mMtrrLibFixedMtrrTable[Index].BaseAddress) /
                mMtrrLibFixedMtrrTable[Index].Length;
-           TempQword = AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
+           if (MtrrSetting == NULL) {
+             TempQword = AsmReadMsr64 (mMtrrLibFixedMtrrTable[Index].Msr);
+           } else {
+             TempQword = MtrrSetting->Fixed.Mtrr[Index];
+           }
            MtrrType =  RShiftU64 (TempQword, SubIndex * 8) & 0xFF;
-           return GetMemoryCacheTypeFromMtrrType (MtrrType);
+           return GetMemoryCacheTypeFromMtrrType (MtrrSetting, MtrrType);
          }
       }
     }
@@ -1156,6 +1191,7 @@ MtrrGetMemoryAttribute (
   MtrrLibInitializeMtrrMask(&MtrrValidBitsMask, &MtrrValidAddressMask);
 
   MtrrGetVariableMtrrWorker (
+    MtrrSetting,
     GetVariableMtrrCountWorker (),
     &VariableSettings
     );
@@ -1183,12 +1219,35 @@ MtrrGetMemoryAttribute (
       }
     }
   }
-  CacheType = GetMemoryCacheTypeFromMtrrType (MtrrType);
+  CacheType = GetMemoryCacheTypeFromMtrrType (MtrrSetting, MtrrType);
 
   return CacheType;
 }
 
 
+/**
+  This function will get the memory cache type of the specific address.
+
+  This function is mainly for debug purpose.
+
+  @param[in]  Address   The specific address
+
+  @return Memory cache type of the specific address
+
+**/
+MTRR_MEMORY_CACHE_TYPE
+EFIAPI
+MtrrGetMemoryAttribute (
+  IN PHYSICAL_ADDRESS   Address
+  )
+{
+  if (!IsMtrrSupported ()) {
+    return CacheUncacheable;
+  }
+
+  return MtrrGetMemoryAttributeByAddressWorker (NULL, Address);
+}
+
 
 /**
   This function prints all MTRRs for debugging.
@@ -1479,7 +1538,7 @@ MtrrSetMemoryAttribute (
   //
   VariableMtrrCount = GetVariableMtrrCountWorker ();
   FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
-  MtrrGetVariableMtrrWorker (VariableMtrrCount, &OriginalVariableSettings);
+  MtrrGetVariableMtrrWorker (NULL, VariableMtrrCount, &OriginalVariableSettings);
   CopyMem (&WorkingVariableSettings, &OriginalVariableSettings, sizeof (WorkingVariableSettings));
   ProgramVariableSettings = TRUE;
   VariableSettings = &WorkingVariableSettings;
@@ -1839,6 +1898,7 @@ MtrrGetAllMtrrs (
   // Get variable MTRRs
   //
   MtrrGetVariableMtrrWorker (
+    NULL,
     GetVariableMtrrCountWorker (),
     &MtrrSetting->Variables
     );

From cefdb9e78a5c24e34d66214b659f2b5f5b42f875 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:26:56 +0000
Subject: [PATCH 227/525] UefiCpuPkg/MtrrLib: Add
 MtrrDebugPrintAllMtrrsWorker()

MtrrDebugPrintAllMtrrsWorker() provides the capability to dump the MTRR setting
from MTRRs or the input MTRR settings buffer.

(Sync patch r19161 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19205 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 60 ++++++++++++++++++++--------
 1 file changed, 43 insertions(+), 17 deletions(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index 4c76abf9eb38..a5bfa8801615 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -1248,18 +1248,23 @@ MtrrGetMemoryAttribute (
   return MtrrGetMemoryAttributeByAddressWorker (NULL, Address);
 }
 
-
 /**
-  This function prints all MTRRs for debugging.
+  Worker function prints all MTRRs for debugging.
+
+  If MtrrSetting is not NULL, print MTRR settings from from input MTRR
+  settings buffer.
+  If MtrrSetting is NULL, print MTRR settings from MTRRs.
+
+  @param  MtrrSetting    A buffer holding all MTRRs content.
 **/
 VOID
-EFIAPI
-MtrrDebugPrintAllMtrrs (
-  VOID
+MtrrDebugPrintAllMtrrsWorker (
+  IN MTRR_SETTINGS    *MtrrSetting
   )
 {
   DEBUG_CODE (
-    MTRR_SETTINGS  MtrrSettings;
+    MTRR_SETTINGS  LocalMtrrs;
+    MTRR_SETTINGS  *Mtrrs;
     UINTN          Index;
     UINTN          Index1;
     UINTN          VariableMtrrCount;
@@ -1283,18 +1288,24 @@ MtrrDebugPrintAllMtrrs (
     DEBUG((DEBUG_CACHE, "MTRR Settings\n"));
     DEBUG((DEBUG_CACHE, "=============\n"));
 
-    MtrrGetAllMtrrs (&MtrrSettings);
-    DEBUG((DEBUG_CACHE, "MTRR Default Type: %016lx\n", MtrrSettings.MtrrDefType));
+    if (MtrrSetting != NULL) {
+      Mtrrs = MtrrSetting;
+    } else {
+      MtrrGetAllMtrrs (&LocalMtrrs);
+      Mtrrs = &LocalMtrrs;
+    }
+
+    DEBUG((DEBUG_CACHE, "MTRR Default Type: %016lx\n", Mtrrs->MtrrDefType));
     for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
-      DEBUG((DEBUG_CACHE, "Fixed MTRR[%02d]   : %016lx\n", Index, MtrrSettings.Fixed.Mtrr[Index]));
+      DEBUG((DEBUG_CACHE, "Fixed MTRR[%02d]   : %016lx\n", Index, Mtrrs->Fixed.Mtrr[Index]));
     }
 
     VariableMtrrCount = GetVariableMtrrCount ();
     for (Index = 0; Index < VariableMtrrCount; Index++) {
       DEBUG((DEBUG_CACHE, "Variable MTRR[%02d]: Base=%016lx Mask=%016lx\n",
         Index,
-        MtrrSettings.Variables.Mtrr[Index].Base,
-        MtrrSettings.Variables.Mtrr[Index].Mask
+        Mtrrs->Variables.Mtrr[Index].Base,
+        Mtrrs->Variables.Mtrr[Index].Mask
         ));
     }
     DEBUG((DEBUG_CACHE, "\n"));
@@ -1306,7 +1317,7 @@ MtrrDebugPrintAllMtrrs (
     for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
       Base = mMtrrLibFixedMtrrTable[Index].BaseAddress;
       for (Index1 = 0; Index1 < 8; Index1++) {
-      MemoryType = (UINTN)(RShiftU64 (MtrrSettings.Fixed.Mtrr[Index], Index1 * 8) & 0xff);
+      MemoryType = (UINTN)(RShiftU64 (Mtrrs->Fixed.Mtrr[Index], Index1 * 8) & 0xff);
         if (MemoryType > CacheWriteBack) {
           MemoryType = MTRR_CACHE_INVALID_TYPE;
         }
@@ -1333,7 +1344,7 @@ MtrrDebugPrintAllMtrrs (
     Base = BASE_1MB;
     PreviousMemoryType = MTRR_CACHE_INVALID_TYPE;
     do {
-      MemoryType = MtrrGetMemoryAttribute (Base);
+      MemoryType = MtrrGetMemoryAttributeByAddressWorker (Mtrrs, Base);
       if (MemoryType > CacheWriteBack) {
         MemoryType = MTRR_CACHE_INVALID_TYPE;
       }
@@ -1352,14 +1363,14 @@ MtrrDebugPrintAllMtrrs (
       NoRangeLimit = Limit;
 
       for (Index = 0, Found = FALSE; Index < VariableMtrrCount; Index++) {
-        if ((MtrrSettings.Variables.Mtrr[Index].Mask & BIT11) == 0) {
+        if ((Mtrrs->Variables.Mtrr[Index].Mask & BIT11) == 0) {
           //
           // If mask is not valid, then do not display range
           //
           continue;
         }
-        MtrrBase  = (MtrrSettings.Variables.Mtrr[Index].Base & (~(SIZE_4KB - 1)));
-        MtrrLimit = MtrrBase + ((~(MtrrSettings.Variables.Mtrr[Index].Mask & (~(SIZE_4KB - 1)))) & Limit);
+        MtrrBase  = (Mtrrs->Variables.Mtrr[Index].Base & (~(SIZE_4KB - 1)));
+        MtrrLimit = MtrrBase + ((~(Mtrrs->Variables.Mtrr[Index].Mask & (~(SIZE_4KB - 1)))) & Limit);
 
         if (Base >= MtrrBase && Base < MtrrLimit) {
           Found = TRUE;
@@ -1395,8 +1406,23 @@ MtrrDebugPrintAllMtrrs (
     DEBUG((DEBUG_CACHE, "%016lx\n\n", Base - 1));
   );
 }
+
+
+/**
+  This function prints all MTRRs for debugging.
+**/
+VOID
+EFIAPI
+MtrrDebugPrintAllMtrrs (
+  VOID
+  )
+{
+  MtrrDebugPrintAllMtrrsWorker (NULL);
+}
+
+
 /**
-  This function attempts to set the attributes for a memory range.
+  Worker function attempts to set the attributes for a memory range.
 
   @param[in]       BaseAddress       The physical address that is the start
                                      address of a memory region.

From 8e01b4c503c12a00c328cd96d5fbaca818e47980 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 10 Dec 2015 07:27:38 +0000
Subject: [PATCH 228/525] UefiCpuPkg/MtrrLib: Add
 MtrrSetMemoryAttributeInMtrrSettings()

Add new API MtrrSetMemoryAttributeInMtrrSettings() in MtrrLib. Platform could
use this API to set MTRR setting into local MTRR settings buffer instead of
MTRRs. At last, platform could use MtrrSetAllMtrrs() to set the MTRR settings
into MTRRs totally. It could improve MTRRs programming performance obviously,
specially when platform is going to program a set of MTRRs.

(Sync patch r19162 from main trunk.)

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19206 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Include/Library/MtrrLib.h |  31 ++++++
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 140 +++++++++++++++++++++++----
 2 files changed, 151 insertions(+), 20 deletions(-)

diff --git a/UefiCpuPkg/Include/Library/MtrrLib.h b/UefiCpuPkg/Include/Library/MtrrLib.h
index 884c7bb6996c..36cd2cd6d574 100644
--- a/UefiCpuPkg/Include/Library/MtrrLib.h
+++ b/UefiCpuPkg/Include/Library/MtrrLib.h
@@ -352,4 +352,35 @@ MtrrGetDefaultMemoryType (
   VOID
   );
 
+/**
+  This function attempts to set the attributes into MTRR setting buffer for a memory range.
+
+  @param[in, out]  MtrrSetting  MTRR setting buffer to be set.
+  @param[in]       BaseAddress  The physical address that is the start address
+                                of a memory region.
+  @param[in]       Length       The size in bytes of the memory region.
+  @param[in]       Attribute    The bit mask of attributes to set for the
+                                memory region.
+
+  @retval RETURN_SUCCESS            The attributes were set for the memory region.
+  @retval RETURN_INVALID_PARAMETER  Length is zero.
+  @retval RETURN_UNSUPPORTED        The processor does not support one or more bytes of the
+                                    memory resource range specified by BaseAddress and Length.
+  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support for the memory resource
+                                    range specified by BaseAddress and Length.
+  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource range specified by
+                                    BaseAddress and Length cannot be modified.
+  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to modify the attributes of
+                                    the memory resource range.
+
+**/
+RETURN_STATUS
+EFIAPI
+MtrrSetMemoryAttributeInMtrrSettings (
+  IN OUT MTRR_SETTINGS       *MtrrSetting,
+  IN PHYSICAL_ADDRESS        BaseAddress,
+  IN UINT64                  Length,
+  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+  );
+
 #endif // _MTRR_LIB_H_
diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index a5bfa8801615..f5b3460f1316 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -1424,6 +1424,11 @@ MtrrDebugPrintAllMtrrs (
 /**
   Worker function attempts to set the attributes for a memory range.
 
+  If MtrrSettings is not NULL, set the attributes into the input MTRR
+  settings buffer.
+  If MtrrSettings is NULL, set the attributes into MTRRs registers.
+
+  @param[in, out]  MtrrSetting       A buffer holding all MTRRs content.
   @param[in]       BaseAddress       The physical address that is the start
                                      address of a memory region.
   @param[in]       Length            The size in bytes of the memory region.
@@ -1448,11 +1453,11 @@ MtrrDebugPrintAllMtrrs (
 
 **/
 RETURN_STATUS
-EFIAPI
-MtrrSetMemoryAttribute (
-  IN PHYSICAL_ADDRESS        BaseAddress,
-  IN UINT64                  Length,
-  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+MtrrSetMemoryAttributeWorker (
+  IN OUT MTRR_SETTINGS           *MtrrSetting,
+  IN PHYSICAL_ADDRESS            BaseAddress,
+  IN UINT64                      Length,
+  IN MTRR_MEMORY_CACHE_TYPE      Attribute
   )
 {
   UINT64                    TempQword;
@@ -1484,7 +1489,6 @@ MtrrSetMemoryAttribute (
   UINT64                    NewValue;
   MTRR_VARIABLE_SETTINGS    *VariableSettings;
 
-  DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
   MtrrContextValid = FALSE;
   for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
     FixedSettingsValid[Index]    = FALSE;
@@ -1529,14 +1533,19 @@ MtrrSetMemoryAttribute (
       if (RETURN_ERROR (Status)) {
         goto Done;
       }
-      if (!FixedSettingsValid[MsrNum]) {
-        WorkingFixedSettings.Mtrr[MsrNum] = AsmReadMsr64 (mMtrrLibFixedMtrrTable[MsrNum].Msr);
-        FixedSettingsValid[MsrNum] = TRUE;
-      }
-      NewValue = (WorkingFixedSettings.Mtrr[MsrNum] & ~ClearMask) | OrMask;
-      if (WorkingFixedSettings.Mtrr[MsrNum] != NewValue) {
-        WorkingFixedSettings.Mtrr[MsrNum] = NewValue;
-        FixedSettingsModified[MsrNum] = TRUE;
+      if (MtrrSetting != NULL) {
+        MtrrSetting->Fixed.Mtrr[MsrNum] = (MtrrSetting->Fixed.Mtrr[MsrNum] & ~ClearMask) | OrMask;
+        MtrrSetting->MtrrDefType |= MTRR_LIB_CACHE_FIXED_MTRR_ENABLED;
+      } else {
+        if (!FixedSettingsValid[MsrNum]) {
+          WorkingFixedSettings.Mtrr[MsrNum] = AsmReadMsr64 (mMtrrLibFixedMtrrTable[MsrNum].Msr);
+          FixedSettingsValid[MsrNum] = TRUE;
+        }
+        NewValue = (WorkingFixedSettings.Mtrr[MsrNum] & ~ClearMask) | OrMask;
+        if (WorkingFixedSettings.Mtrr[MsrNum] != NewValue) {
+          WorkingFixedSettings.Mtrr[MsrNum] = NewValue;
+          FixedSettingsModified[MsrNum] = TRUE;
+        }
       }
     }
 
@@ -1564,10 +1573,14 @@ MtrrSetMemoryAttribute (
   //
   VariableMtrrCount = GetVariableMtrrCountWorker ();
   FirmwareVariableMtrrCount = GetFirmwareVariableMtrrCountWorker ();
-  MtrrGetVariableMtrrWorker (NULL, VariableMtrrCount, &OriginalVariableSettings);
-  CopyMem (&WorkingVariableSettings, &OriginalVariableSettings, sizeof (WorkingVariableSettings));
-  ProgramVariableSettings = TRUE;
-  VariableSettings = &WorkingVariableSettings;
+  if (MtrrSetting != NULL) {
+    VariableSettings = &MtrrSetting->Variables;
+  } else {
+    MtrrGetVariableMtrrWorker (NULL, VariableMtrrCount, &OriginalVariableSettings);
+    CopyMem (&WorkingVariableSettings, &OriginalVariableSettings, sizeof (WorkingVariableSettings));
+    ProgramVariableSettings = TRUE;
+    VariableSettings = &WorkingVariableSettings;
+  }
 
   //
   // Check for overlap
@@ -1613,7 +1626,7 @@ MtrrSetMemoryAttribute (
   // The memory type is the same with the type specified by
   // MTRR_LIB_IA32_MTRR_DEF_TYPE.
   //
-  if ((!OverwriteExistingMtrr) && (Attribute == MtrrGetDefaultMemoryType ())) {
+  if ((!OverwriteExistingMtrr) && (Attribute == MtrrGetDefaultMemoryTypeWorker (MtrrSetting))) {
     //
     // Invalidate the now-unused MTRRs
     //
@@ -1783,11 +1796,98 @@ MtrrSetMemoryAttribute (
 
   DEBUG((DEBUG_CACHE, "  Status = %r\n", Status));
   if (!RETURN_ERROR (Status)) {
-    MtrrDebugPrintAllMtrrs ();
+    if (MtrrSetting != NULL) {
+      MtrrSetting->MtrrDefType |= MTRR_LIB_CACHE_MTRR_ENABLED;
+    }
+    MtrrDebugPrintAllMtrrsWorker (MtrrSetting);
   }
 
   return Status;
 }
+
+/**
+  This function attempts to set the attributes for a memory range.
+
+  @param[in]  BaseAddress        The physical address that is the start
+                                 address of a memory region.
+  @param[in]  Length             The size in bytes of the memory region.
+  @param[in]  Attributes         The bit mask of attributes to set for the
+                                 memory region.
+
+  @retval RETURN_SUCCESS            The attributes were set for the memory
+                                    region.
+  @retval RETURN_INVALID_PARAMETER  Length is zero.
+  @retval RETURN_UNSUPPORTED        The processor does not support one or
+                                    more bytes of the memory resource range
+                                    specified by BaseAddress and Length.
+  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support
+                                    for the memory resource range specified
+                                    by BaseAddress and Length.
+  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource
+                                    range specified by BaseAddress and Length
+                                    cannot be modified.
+  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to
+                                    modify the attributes of the memory
+                                    resource range.
+
+**/
+RETURN_STATUS
+EFIAPI
+MtrrSetMemoryAttribute (
+  IN PHYSICAL_ADDRESS        BaseAddress,
+  IN UINT64                  Length,
+  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+  )
+{
+  DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttribute() %a:%016lx-%016lx\n", mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
+  return MtrrSetMemoryAttributeWorker (
+           NULL,
+           BaseAddress,
+           Length,
+           Attribute
+           );
+}
+
+/**
+  This function attempts to set the attributes into MTRR setting buffer for a memory range.
+
+  @param[in, out]  MtrrSetting  MTRR setting buffer to be set.
+  @param[in]       BaseAddress  The physical address that is the start address
+                                of a memory region.
+  @param[in]       Length       The size in bytes of the memory region.
+  @param[in]       Attribute    The bit mask of attributes to set for the
+                                memory region.
+
+  @retval RETURN_SUCCESS            The attributes were set for the memory region.
+  @retval RETURN_INVALID_PARAMETER  Length is zero.
+  @retval RETURN_UNSUPPORTED        The processor does not support one or more bytes of the
+                                    memory resource range specified by BaseAddress and Length.
+  @retval RETURN_UNSUPPORTED        The bit mask of attributes is not support for the memory resource
+                                    range specified by BaseAddress and Length.
+  @retval RETURN_ACCESS_DENIED      The attributes for the memory resource range specified by
+                                    BaseAddress and Length cannot be modified.
+  @retval RETURN_OUT_OF_RESOURCES   There are not enough system resources to modify the attributes of
+                                    the memory resource range.
+
+**/
+RETURN_STATUS
+EFIAPI
+MtrrSetMemoryAttributeInMtrrSettings (
+  IN OUT MTRR_SETTINGS       *MtrrSetting,
+  IN PHYSICAL_ADDRESS        BaseAddress,
+  IN UINT64                  Length,
+  IN MTRR_MEMORY_CACHE_TYPE  Attribute
+  )
+{
+  DEBUG((DEBUG_CACHE, "MtrrSetMemoryAttributeMtrrSettings(%p) %a:%016lx-%016lx\n", MtrrSetting, mMtrrMemoryCacheTypeShortName[Attribute], BaseAddress, Length));
+  return MtrrSetMemoryAttributeWorker (
+           MtrrSetting,
+           BaseAddress,
+           Length,
+           Attribute
+           );
+}
+
 /**
   Worker function setting variable MTRRs
 

From f7993e868c8b7947401ec94e50667d870b4ddfe0 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 10 Dec 2015 07:28:33 +0000
Subject: [PATCH 229/525] MdeModulePkg: Add PciSioSerialDxe driver

PciSioSerialDxe driver can manages UARTs on a SIO chip or a PCI/PCIE
card.
It manages the SIO instance whose last device path node is a ACPI
device path and the HID in the ACPI device path node equals to
EISA_PNP_ID (0x501).
It also manages the PCI IO instance whose class code is 7/0/2 (16550
UART). But when proper value is set to PcdPciSerialParameters, the
driver can also manage non-standard PCI serial cards by matching
the Vendor ID and Device ID specified in PcdPciSerialParameters.
The PCI BAR index, IO/MMIO offset, register stride, clock rate can
also be specified through the same PCD.

(Sync patch r19179 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19207 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Bus/Pci/PciSioSerialDxe/ComponentName.c   |  288 ++++
 .../Pci/PciSioSerialDxe/PciSioSerialDxe.inf   |   81 +
 .../Pci/PciSioSerialDxe/PciSioSerialDxe.uni   |  Bin 0 -> 1936 bytes
 .../PciSioSerialDxe/PciSioSerialDxeExtra.uni  |  Bin 0 -> 1372 bytes
 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c | 1242 ++++++++++++++++
 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.h |  789 ++++++++++
 .../Bus/Pci/PciSioSerialDxe/SerialIo.c        | 1320 +++++++++++++++++
 MdeModulePkg/MdeModulePkg.dec                 |   38 +
 MdeModulePkg/MdeModulePkg.dsc                 |    1 +
 9 files changed, 3759 insertions(+)
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/ComponentName.c
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.uni
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxeExtra.uni
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.h
 create mode 100644 MdeModulePkg/Bus/Pci/PciSioSerialDxe/SerialIo.c

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/ComponentName.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/ComponentName.c
new file mode 100644
index 000000000000..994dc847c9d1
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/ComponentName.c
@@ -0,0 +1,288 @@
+/** @file
+  UEFI Component Name and Name2 protocol for Isa serial driver.
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "Serial.h"
+
+//
+// EFI Component Name Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME_PROTOCOL  gPciSioSerialComponentName = {
+  SerialComponentNameGetDriverName,
+  SerialComponentNameGetControllerName,
+  "eng"
+};
+
+//
+// EFI Component Name 2 Protocol
+//
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_COMPONENT_NAME2_PROTOCOL gPciSioSerialComponentName2 = {
+  (EFI_COMPONENT_NAME2_GET_DRIVER_NAME) SerialComponentNameGetDriverName,
+  (EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME) SerialComponentNameGetControllerName,
+  "en"
+};
+
+
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_UNICODE_STRING_TABLE mSerialDriverNameTable[] = {
+  {
+    "eng;en",
+    L"PCI SIO Serial Driver"
+  },
+  {
+    NULL,
+    NULL
+  }
+};
+
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 mSioSerialPortName[] = L"SIO Serial Port #%d";
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 mPciSerialPortName[] = L"PCI Serial Port #%d";
+
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          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 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialComponentNameGetDriverName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL  *This,
+  IN  CHAR8                        *Language,
+  OUT CHAR16                       **DriverName
+  )
+{
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           mSerialDriverNameTable,
+           DriverName,
+           (BOOLEAN)(This == &gPciSioSerialComponentName)
+           );
+}
+
+/**
+  Retrieves a Unicode string that is the user readable name of the controller
+  that is being managed by a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  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[in]       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[in]          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 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL                     *This,
+  IN  EFI_HANDLE                                      ControllerHandle,
+  IN  EFI_HANDLE                                      ChildHandle        OPTIONAL,
+  IN  CHAR8                                           *Language,
+  OUT CHAR16                                          **ControllerName
+  )
+{
+  EFI_STATUS                Status;
+  EFI_SERIAL_IO_PROTOCOL    *SerialIo;
+  SERIAL_DEV                *SerialDevice;
+  EFI_UNICODE_STRING_TABLE  *ControllerNameTable;
+  EFI_GUID                  *IoProtocolGuid;
+
+  //
+  // Make sure this driver is currently managing ControllerHandle
+  //
+  IoProtocolGuid = &gEfiSioProtocolGuid;
+  Status = EfiTestManagedDevice (
+             ControllerHandle,
+             gSerialControllerDriver.DriverBindingHandle,
+             IoProtocolGuid
+             );
+  if (EFI_ERROR (Status)) {
+    IoProtocolGuid = &gEfiPciIoProtocolGuid;
+    Status = EfiTestManagedDevice (
+               ControllerHandle,
+               gSerialControllerDriver.DriverBindingHandle,
+               IoProtocolGuid
+               );
+  }
+
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  ControllerNameTable = NULL;
+  if (ChildHandle != NULL) {
+    Status = EfiTestChildHandle (
+               ControllerHandle,
+               ChildHandle,
+               IoProtocolGuid
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+
+    //
+    // Get the Serial I/O Protocol from the child handle
+    //
+    Status = gBS->OpenProtocol (
+                    ChildHandle,
+                    &gEfiSerialIoProtocolGuid,
+                    (VOID **) &SerialIo,
+                    gSerialControllerDriver.DriverBindingHandle,
+                    ChildHandle,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+
+    //
+    // Get the Serial Controller's Device structure
+    //
+    SerialDevice = SERIAL_DEV_FROM_THIS (SerialIo);
+    ControllerNameTable = SerialDevice->ControllerNameTable;
+  }
+
+  return LookupUnicodeString2 (
+           Language,
+           This->SupportedLanguages,
+           ControllerNameTable,
+           ControllerName,
+           (BOOLEAN)(This == &gPciSioSerialComponentName)
+           );
+}
+
+/**
+  Add the ISO639-2 and RFC4646 component name both for the Serial IO device
+
+  @param SerialDevice     A pointer to the SERIAL_DEV instance.
+  @param Instance         Instance ID for the serial device.
+**/
+VOID
+AddName (
+  IN  SERIAL_DEV                               *SerialDevice,
+  IN  UINT32                                   Instance
+  )
+{
+  CHAR16                                       SerialPortName[SERIAL_PORT_NAME_LEN];
+  UnicodeSPrint (
+    SerialPortName,
+    sizeof (SerialPortName),
+    (SerialDevice->PciDeviceInfo != NULL) ? PCI_SERIAL_PORT_NAME : SIO_SERIAL_PORT_NAME,
+    Instance
+    );
+  AddUnicodeString2 (
+    "eng",
+    gPciSioSerialComponentName.SupportedLanguages,
+    &SerialDevice->ControllerNameTable,
+    SerialPortName,
+    TRUE
+    );
+  AddUnicodeString2 (
+    "en",
+    gPciSioSerialComponentName2.SupportedLanguages,
+    &SerialDevice->ControllerNameTable,
+    SerialPortName,
+    FALSE
+    );
+
+}
diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf
new file mode 100644
index 000000000000..03fddfe75e8a
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf
@@ -0,0 +1,81 @@
+## @file
+# Serial driver for standard UARTS on a SIO chip or PCI/PCIE card.
+#
+# Produces the Serial I/O protocol for standard UARTS using Super I/O or PCI I/O.
+#
+# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+# This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution. The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PciSioSerialDxe
+  MODULE_UNI_FILE                = PciSioSerialDxe.uni
+  FILE_GUID                      = E2775B47-D453-4EE3-ADA7-391A1B05AC17
+  MODULE_TYPE                    = UEFI_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = InitializePciSioSerial
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+#  DRIVER_BINDING                =  gSerialControllerDriver
+#  COMPONENT_NAME                =  gPciSioSerialComponentName
+#  COMPONENT_NAME2               =  gPciSioSerialComponentName2
+#
+
+[Sources]
+  ComponentName.c
+  SerialIo.c
+  Serial.h
+  Serial.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  PcdLib
+  ReportStatusCodeLib
+  UefiBootServicesTableLib
+  MemoryAllocationLib
+  BaseMemoryLib
+  DevicePathLib
+  UefiLib
+  UefiDriverEntryPoint
+  DebugLib
+  IoLib
+
+[Guids]
+  gEfiUartDevicePathGuid                        ## SOMETIMES_CONSUMES   ## GUID
+
+[Protocols]
+  gEfiSioProtocolGuid                           ## TO_START
+  gEfiDevicePathProtocolGuid                    ## TO_START
+  gEfiPciIoProtocolGuid                         ## TO_START
+  gEfiSerialIoProtocolGuid                      ## BY_START
+  gEfiDevicePathProtocolGuid                    ## BY_START
+
+[FeaturePcd]
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseHalfHandshake|FALSE   ## CONSUMES
+
+[Pcd]
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultBaudRate|115200    ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultDataBits|8         ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultParity|1           ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdUartDefaultStopBits|1         ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialClockRate|1843200 ## CONSUMES
+  gEfiMdeModulePkgTokenSpaceGuid.PcdPciSerialParameters     ## CONSUMES
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  PciSioSerialDxeExtra.uni
diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.uni b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.uni
new file mode 100644
index 0000000000000000000000000000000000000000..617f583b35ad6654d838b1a174253a71862606db
GIT binary patch
literal 1936
zcmd6oTaOY!5QXd6#Q)G?U)1b^nivyfj9f;Ys0-ne)h9D7EKIV%W`NcG^XhkMU<L@r
zebbP>Rac)neX4r+^|NL*3$!Qvg1xmXOYPdm_Rt<+)n1QPhBd(+Y~=G>w*|Zxtb;9W
z#r~Y#g!Kr^!0OhuKBogdbNYnVv)I~<mo^3Q#`ko-V@-Byn=x{a9I09`DH(N$u^`GC
zoH4Nj(WlG~xe8IyZrp#xnM;~(aX;Q`uv55C9C;0nlnBmLxcS|4?py0IzD+!D?2fZ3
zSX0;rdjyxqjL+>Uzn9F;Hmhg$!cLjTL|ze5e1(vKp+3QyGMihKojUvSD6yqS=DLWj
zGBv{UwKd4cn<HxWJr_Ea>ooBgGuC-VOLY@COTihQ+Pf>%nK`SnPL@R+p@>a@Wy<L>
z=a$Z?#MkMO`y}v9@VllT((Bxs6WW#X+dNB`3?5>=WhrLzObdOqyCB!)xds*3V*P24
zOIcapT?<vGaQAPU5>trckoruqRQb|=2+!TTNL8`F!k%YHoPXeR$Z21fz^xLL4It*{
z7aIk{XtkrO>S#qKUimv!h2`4HKXaw4+&-h?Y6sdcu?%58qUQFaS3#N5N=3?9-#%Cb
zuMTz8w)gaP`^-A_H{SBGk2R*!2E6>pl^)nRV}w0m%Mr>f#8h^KN6(Sl%v90pD~!Dj
zdWEs!YsEU<VRu0^p|(9@unWAp&g>j}45~2N9=*#-++|bDKECo%)ZFVGzKZ^p@gqB8
zu9p~XqU5)T>`Q@DqQ_{_p{^9O#e3W8wjG0iVQX%eP3@$pp6xeA`h5eb4aNYph*h1t
z_h2f$n~dR)zZ0^l*D#?15_;8-YT^tmF|E*-Z}eY$%PYnG?{{}qPLErwsyaosjw$f>
MyZ_(+8o4sR0T-w!M*si-

literal 0
HcmV?d00001

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxeExtra.uni b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxeExtra.uni
new file mode 100644
index 0000000000000000000000000000000000000000..935bdba93e0322aa2412b9d02bd7cba7623bceb2
GIT binary patch
literal 1372
zcmZXUTW`}q5QXO%iT|()FM!&Fi+Di@ku(M@N*(1Q;3;x0O)ce8ISDlUc;GwZ*lvm<
z@9fUboH=`THh=%LtYv}kIlo{Z?AkJ0+T0%7BfQ${*%aS^Z^JmZoLNdt*X~#ayTm_r
zPiDXI%<v6t=W%OW*p_u_YxiFeyJm0hV_BoL!L)yC2hUyD4Uxf~g8mHq%3jz@d(G^;
zTD`F|=J648$y^9I7#dUZ#d>W`cG_@Og!mWOVwS^Y%a_|v=ian;*0H|5uN0`+4Plh|
zd2Wf{fT9{JP|EY|h>#{JoTo&rV4}SPdD0@_5vy9oZB<8EViRDQku8nHOnR31%AR>l
z3g48tCF6uqd3!Rnn=>z&6tz|-w;*PU%qo4P#D=@C^E%vNm-Xcdms*QouEmt`|I=o0
z5TZB~da2fywX~nW^Zva^Rk6RuU)+#5-x2eW)2S|nmItCH$NbGv0WsR$(^Y-6<0jsE
zN2|jMZ55xp(oIgEb3d&I+HdhpU_PVgPOCRTx#24nDQ&Q!eYOZzJ-R5dPmFE*$~s2T
zfTprTyfJ+?Vivj1BfG*z_-lmv4r2N`B4Xgk2{ZMx#s*fnLTz9>zSioj;uh>1`{I>&
zMXlRZ60<A(F{r{wyn3INxXY)SL!uO;szuaCVwL#=`-L4b*E@`kRf<zY_PxTX(POme
z(N(J1<z1G#l{WZ4QOo`EJ*oPpct3@9<D<GgQ2Nyg#$YF)j=+y>3@<6KyC{(KR)n(0
xF1%;d2j|3#pJE!|UcgQNU^;PNPf88lQ@>j2y!RgOa!OU`dT;ALBnL%U{{R8l(_R1o

literal 0
HcmV?d00001

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
new file mode 100644
index 000000000000..86e75a43f719
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
@@ -0,0 +1,1242 @@
+/** @file
+  Serial driver for PCI or SIO UARTS.
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "Serial.h"
+
+//
+// ISA Serial Driver Global Variables
+//
+
+EFI_DRIVER_BINDING_PROTOCOL gSerialControllerDriver = {
+  SerialControllerDriverSupported,
+  SerialControllerDriverStart,
+  SerialControllerDriverStop,
+  0xa,
+  NULL,
+  NULL
+};
+
+CONTROLLER_DEVICE_PATH mControllerDevicePathTemplate = {
+  {
+    HARDWARE_DEVICE_PATH,
+    HW_CONTROLLER_DP,
+    sizeof (CONTROLLER_DEVICE_PATH),
+    0
+  },
+  0
+};
+
+SERIAL_DEV  gSerialDevTemplate = {
+  SERIAL_DEV_SIGNATURE,
+  NULL,
+  {
+    SERIAL_IO_INTERFACE_REVISION,
+    SerialReset,
+    SerialSetAttributes,
+    SerialSetControl,
+    SerialGetControl,
+    SerialWrite,
+    SerialRead,
+    NULL
+  },                                       // SerialIo
+  {
+    SERIAL_PORT_SUPPORT_CONTROL_MASK,
+    SERIAL_PORT_DEFAULT_TIMEOUT,
+    0,
+    16,
+    0,
+    0,
+    0
+  },                                       // SerialMode
+  NULL,                                    // DevicePath
+  NULL,                                    // ParentDevicePath
+  {
+    {
+      MESSAGING_DEVICE_PATH,
+      MSG_UART_DP,
+      {
+        (UINT8) (sizeof (UART_DEVICE_PATH)),
+        (UINT8) ((sizeof (UART_DEVICE_PATH)) >> 8)
+      }
+    },
+    0, 0, 0, 0, 0
+  },                                       // UartDevicePath
+  0,                                       // BaseAddress
+  FALSE,                                   // MmioAccess
+  1,                                       // RegisterStride
+  0,                                       // ClockRate
+  16,                                      // ReceiveFifoDepth
+  { 0, 0 },                                // Receive;
+  16,                                      // TransmitFifoDepth
+  { 0, 0 },                                // Transmit;
+  FALSE,                                   // SoftwareLoopbackEnable;
+  FALSE,                                   // HardwareFlowControl;
+  NULL,                                    // *ControllerNameTable;
+  FALSE,                                   // ContainsControllerNode;
+  0,                                       // Instance;
+  NULL                                     // *PciDeviceInfo;
+};
+
+/**
+  Check the device path node whether it's the Flow Control node or not.
+
+  @param[in] FlowControl    The device path node to be checked.
+  
+  @retval TRUE              It's the Flow Control node.
+  @retval FALSE             It's not.
+
+**/
+BOOLEAN
+IsUartFlowControlDevicePathNode (
+  IN UART_FLOW_CONTROL_DEVICE_PATH *FlowControl
+  )
+{
+  return (BOOLEAN) (
+           (DevicePathType (FlowControl) == MESSAGING_DEVICE_PATH) &&
+           (DevicePathSubType (FlowControl) == MSG_VENDOR_DP) &&
+           (CompareGuid (&FlowControl->Guid, &gEfiUartDevicePathGuid))
+           );
+}
+
+/**
+  The user Entry Point for module PciSioSerial. The user code starts with this function.
+
+  @param[in] ImageHandle    The firmware allocated handle for the EFI image.  
+  @param[in] SystemTable    A pointer to the EFI System Table.
+  
+  @retval EFI_SUCCESS       The entry point is executed successfully.
+  @retval other             Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializePciSioSerial (
+  IN EFI_HANDLE           ImageHandle,
+  IN EFI_SYSTEM_TABLE     *SystemTable
+  )
+{
+  EFI_STATUS              Status;
+
+  //
+  // Install driver model protocol(s).
+  //
+  Status = EfiLibInstallDriverBindingComponentName2 (
+             ImageHandle,
+             SystemTable,
+             &gSerialControllerDriver,
+             ImageHandle,
+             &gPciSioSerialComponentName,
+             &gPciSioSerialComponentName2
+             );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Initialize UART default setting in gSerialDevTempate
+  //
+  gSerialDevTemplate.SerialMode.BaudRate = PcdGet64 (PcdUartDefaultBaudRate);
+  gSerialDevTemplate.SerialMode.DataBits = PcdGet8 (PcdUartDefaultDataBits);
+  gSerialDevTemplate.SerialMode.Parity   = PcdGet8 (PcdUartDefaultParity);
+  gSerialDevTemplate.SerialMode.StopBits = PcdGet8 (PcdUartDefaultStopBits);
+  gSerialDevTemplate.UartDevicePath.BaudRate = PcdGet64 (PcdUartDefaultBaudRate);
+  gSerialDevTemplate.UartDevicePath.DataBits = PcdGet8 (PcdUartDefaultDataBits);
+  gSerialDevTemplate.UartDevicePath.Parity   = PcdGet8 (PcdUartDefaultParity);
+  gSerialDevTemplate.UartDevicePath.StopBits = PcdGet8 (PcdUartDefaultStopBits);
+  gSerialDevTemplate.ClockRate = PcdGet32 (PcdSerialClockRate);
+
+  return Status;
+}
+
+/**
+  Return whether the controller is a SIO serial controller.
+
+  @param  Controller   The controller handle.
+
+  @retval EFI_SUCCESS  The controller is a SIO serial controller.
+  @retval others       The controller is not a SIO serial controller.
+**/
+EFI_STATUS
+IsSioSerialController (
+  EFI_HANDLE               Controller
+  )
+{
+  EFI_STATUS               Status;
+  EFI_SIO_PROTOCOL         *Sio;
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;
+  ACPI_HID_DEVICE_PATH     *Acpi;
+
+  //
+  // Open the IO Abstraction(s) needed to perform the supported test
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiSioProtocolGuid,
+                  (VOID **) &Sio,
+                  gSerialControllerDriver.DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (Status == EFI_ALREADY_STARTED) {
+    return EFI_SUCCESS;
+  }
+
+  if (!EFI_ERROR (Status)) {
+    //
+    // Close the I/O Abstraction(s) used to perform the supported test
+    //
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiSioProtocolGuid,
+           gSerialControllerDriver.DriverBindingHandle,
+           Controller
+           );
+
+    Status = gBS->OpenProtocol (
+      Controller,
+      &gEfiDevicePathProtocolGuid,
+      (VOID **) &DevicePath,
+      gSerialControllerDriver.DriverBindingHandle,
+      Controller,
+      EFI_OPEN_PROTOCOL_BY_DRIVER
+      );
+    ASSERT (Status != EFI_ALREADY_STARTED);
+
+    if (!EFI_ERROR (Status)) {
+      do {
+        Acpi = (ACPI_HID_DEVICE_PATH *) DevicePath;
+        DevicePath = NextDevicePathNode (DevicePath);
+      } while (!IsDevicePathEnd (DevicePath));
+
+      if (DevicePathType (Acpi) != ACPI_DEVICE_PATH ||
+          (DevicePathSubType (Acpi) != ACPI_DP && DevicePathSubType (Acpi) != ACPI_EXTENDED_DP) ||
+          Acpi->HID != EISA_PNP_ID (0x501)
+          ) {
+        Status = EFI_UNSUPPORTED;
+      }
+    }
+
+    //
+    // Close protocol, don't use device path protocol in the Support() function
+    //
+    gBS->CloseProtocol (
+      Controller,
+      &gEfiDevicePathProtocolGuid,
+      gSerialControllerDriver.DriverBindingHandle,
+      Controller
+      );
+  }
+  return Status;
+}
+
+/**
+  Return whether the controller is a PCI serial controller.
+
+  @param  Controller   The controller handle.
+
+  @retval EFI_SUCCESS  The controller is a PCI serial controller.
+  @retval others       The controller is not a PCI serial controller.
+**/
+EFI_STATUS
+IsPciSerialController (
+  EFI_HANDLE               Controller
+  )
+{
+  EFI_STATUS               Status;
+  EFI_PCI_IO_PROTOCOL      *PciIo;
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;
+  PCI_TYPE00               Pci;
+  PCI_SERIAL_PARAMETER     *PciSerialParameter;
+
+  //
+  // Open the IO Abstraction(s) needed to perform the supported test
+  //
+  Status = gBS->OpenProtocol (
+    Controller,
+    &gEfiPciIoProtocolGuid,
+    (VOID **) &PciIo,
+    gSerialControllerDriver.DriverBindingHandle,
+    Controller,
+    EFI_OPEN_PROTOCOL_BY_DRIVER
+    );
+  if (Status == EFI_ALREADY_STARTED) {
+    return EFI_SUCCESS;
+  }
+
+  if (!EFI_ERROR (Status)) {
+    Status = PciIo->Pci.Read (PciIo, EfiPciIoWidthUint8, 0, sizeof (Pci), &Pci);
+    if (!EFI_ERROR (Status)) {
+      if (!IS_PCI_16550_SERIAL (&Pci)) {
+        for (PciSerialParameter = (PCI_SERIAL_PARAMETER *) PcdGetPtr (PcdPciSerialParameters)
+             ; PciSerialParameter->VendorId != 0xFFFF
+             ; PciSerialParameter++
+             ) {
+          if ((Pci.Hdr.VendorId == PciSerialParameter->VendorId) &&
+              (Pci.Hdr.DeviceId == PciSerialParameter->DeviceId)
+              ) {
+            break;
+          }
+        }
+        if (PciSerialParameter->VendorId == 0xFFFF) {
+          Status = EFI_UNSUPPORTED;
+        } else {
+          Status = EFI_SUCCESS;
+        }
+      }
+    }
+
+    //
+    // Close the I/O Abstraction(s) used to perform the supported test
+    //
+    gBS->CloseProtocol (
+      Controller,
+      &gEfiPciIoProtocolGuid,
+      gSerialControllerDriver.DriverBindingHandle,
+      Controller
+      );
+  }
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Open the EFI Device Path protocol needed to perform the supported test
+  //
+  Status = gBS->OpenProtocol (
+    Controller,
+    &gEfiDevicePathProtocolGuid,
+    (VOID **) &DevicePath,
+    gSerialControllerDriver.DriverBindingHandle,
+    Controller,
+    EFI_OPEN_PROTOCOL_BY_DRIVER
+    );
+  ASSERT (Status != EFI_ALREADY_STARTED);
+
+  //
+  // Close protocol, don't use device path protocol in the Support() function
+  //
+  gBS->CloseProtocol (
+    Controller,
+    &gEfiDevicePathProtocolGuid,
+    gSerialControllerDriver.DriverBindingHandle,
+    Controller
+    );
+
+  return Status;
+}
+
+/**
+  Check to see if this driver supports the given controller
+
+  @param  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller           The handle of the controller to test.
+  @param  RemainingDevicePath  A pointer to the remaining portion of a device path.
+
+  @return EFI_SUCCESS          This driver can support the given controller
+
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  )
+
+{
+  EFI_STATUS                                Status;
+  UART_DEVICE_PATH                          *Uart;
+  UART_FLOW_CONTROL_DEVICE_PATH             *FlowControl;
+
+  //
+  // Test RemainingDevicePath
+  //
+  if ((RemainingDevicePath != NULL) && !IsDevicePathEnd (RemainingDevicePath)) {
+    Status = EFI_UNSUPPORTED;
+
+    Uart = SkipControllerDevicePathNode (RemainingDevicePath, NULL, NULL);
+    if (DevicePathType (Uart) != MESSAGING_DEVICE_PATH ||
+        DevicePathSubType (Uart) != MSG_UART_DP ||
+        DevicePathNodeLength (Uart) != sizeof (UART_DEVICE_PATH)
+        ) {
+      return EFI_UNSUPPORTED;
+    }
+
+    //
+    // Do a rough check because Clock Rate is unknown until DriverBindingStart()
+    //
+    if (!VerifyUartParameters (0, Uart->BaudRate, Uart->DataBits, Uart->Parity, Uart->StopBits, NULL, NULL)) {
+      return EFI_UNSUPPORTED;
+    }
+
+    FlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) NextDevicePathNode (Uart);
+    if (IsUartFlowControlDevicePathNode (FlowControl)) {
+      //
+      // If the second node is Flow Control Node,
+      //   return error when it request other than hardware flow control.
+      //
+      if ((ReadUnaligned32 (&FlowControl->FlowControlMap) & ~UART_FLOW_CONTROL_HARDWARE) != 0) {
+        return EFI_UNSUPPORTED;
+      }
+    }
+  }
+
+  Status = IsSioSerialController (Controller);
+  if (EFI_ERROR (Status)) {
+    Status = IsPciSerialController (Controller);
+  }
+  return Status;  
+}
+
+/**
+  Create the child serial device instance.
+
+  @param Controller           The parent controller handle.
+  @param Uart                 Pointer to the UART device path node in RemainingDevicePath,
+                              or NULL if RemainingDevicePath is NULL.
+  @param ParentDevicePath     Pointer to the parent device path.
+  @param CreateControllerNode TRUE to create the controller node.
+  @param Instance             Instance number of the serial device.
+                              The value will be set to the controller node
+                              if CreateControllerNode is TRUE.
+  @param ParentIo             A union type pointer to either Sio or PciIo.
+  @param PciSerialParameter   The PCI serial parameter to be used by current serial device.
+                              NULL for SIO serial device.
+  @param PciDeviceInfo        The PCI device info for the current serial device.
+                              NULL for SIO serial device.
+
+  @retval EFI_SUCCESS         The serial device was created successfully.
+  @retval others              The serial device wasn't created.
+**/
+EFI_STATUS
+CreateSerialDevice (
+  IN EFI_HANDLE                     Controller,
+  IN UART_DEVICE_PATH               *Uart,
+  IN EFI_DEVICE_PATH_PROTOCOL       *ParentDevicePath,
+  IN BOOLEAN                        CreateControllerNode,
+  IN UINT32                         Instance,
+  IN PARENT_IO_PROTOCOL_PTR         ParentIo,
+  IN PCI_SERIAL_PARAMETER           *PciSerialParameter, OPTIONAL
+  IN PCI_DEVICE_INFO                *PciDeviceInfo       OPTIONAL
+  )
+{
+  EFI_STATUS                                 Status;
+  SERIAL_DEV                                 *SerialDevice;
+  UINT8                                      BarIndex;
+  UINT64                                     Offset;
+  UART_FLOW_CONTROL_DEVICE_PATH              *FlowControl;
+  UINT32                                     FlowControlMap;
+  ACPI_RESOURCE_HEADER_PTR                   Resources;
+  EFI_ACPI_IO_PORT_DESCRIPTOR                *Io;
+  EFI_ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR *FixedIo;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR          *AddressSpace;
+  EFI_DEVICE_PATH_PROTOCOL                   *TempDevicePath;
+
+  BarIndex = 0;
+  Offset = 0;
+  FlowControl = NULL;
+  FlowControlMap = 0;
+
+  //
+  // Initialize the serial device instance
+  //
+  SerialDevice = AllocateCopyPool (sizeof (SERIAL_DEV), &gSerialDevTemplate);
+  ASSERT (SerialDevice != NULL);
+
+  SerialDevice->SerialIo.Mode    = &(SerialDevice->SerialMode);
+  SerialDevice->ParentDevicePath = ParentDevicePath;
+  SerialDevice->PciDeviceInfo    = PciDeviceInfo;
+  SerialDevice->Instance         = Instance;
+
+  if (Uart != NULL) {
+    CopyMem (&SerialDevice->UartDevicePath, Uart, sizeof (UART_DEVICE_PATH));
+    FlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) NextDevicePathNode (Uart);
+    if (IsUartFlowControlDevicePathNode (FlowControl)) {
+      FlowControlMap = ReadUnaligned32 (&FlowControl->FlowControlMap);
+    } else {
+      FlowControl = NULL;
+    }
+  }
+
+  //
+  // For PCI serial device, use the information from PCD
+  //
+  if (PciSerialParameter != NULL) {
+    BarIndex = (PciSerialParameter->BarIndex == PCI_BAR_ALL) ? 0 : PciSerialParameter->BarIndex;
+    Offset = PciSerialParameter->Offset;
+    if (PciSerialParameter->RegisterStride != 0) {
+      SerialDevice->RegisterStride = PciSerialParameter->RegisterStride;
+    }
+    if (PciSerialParameter->ClockRate != 0) {
+      SerialDevice->ClockRate = PciSerialParameter->ClockRate;
+    }
+    if (PciSerialParameter->ReceiveFifoDepth != 0) {
+      SerialDevice->ReceiveFifoDepth = PciSerialParameter->ReceiveFifoDepth;
+    }
+    if (PciSerialParameter->TransmitFifoDepth != 0) {
+      SerialDevice->TransmitFifoDepth = PciSerialParameter->TransmitFifoDepth;
+    }
+  }
+
+  //
+  // Pass NULL ActualBaudRate to VerifyUartParameters to disallow baudrate degrade.
+  // DriverBindingStart() shouldn't create a handle with different UART device path.
+  //
+  if (!VerifyUartParameters (SerialDevice->ClockRate, SerialDevice->UartDevicePath.BaudRate, SerialDevice->UartDevicePath.DataBits,
+                            SerialDevice->UartDevicePath.Parity, SerialDevice->UartDevicePath.StopBits, NULL, NULL
+                            )) {
+    Status = EFI_INVALID_PARAMETER;
+    goto CreateError;
+  }
+
+  if (PciSerialParameter == NULL) {
+    Status = ParentIo.Sio->GetResources (ParentIo.Sio, &Resources);
+  } else {
+    Status = ParentIo.PciIo->GetBarAttributes (ParentIo.PciIo, BarIndex, NULL, (VOID **) &Resources);
+  }
+
+  if (!EFI_ERROR (Status)) {
+    //
+    // Get the base address information from ACPI resource descriptor.
+    // ACPI_IO_PORT_DESCRIPTOR and ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR are returned from Sio;
+    // ACPI_ADDRESS_SPACE_DESCRIPTOR is returned from PciIo.
+    //
+    while ((Resources.SmallHeader->Byte != ACPI_END_TAG_DESCRIPTOR) && (SerialDevice->BaseAddress == 0)) {
+      switch (Resources.SmallHeader->Byte) {
+      case ACPI_IO_PORT_DESCRIPTOR:
+        Io = (EFI_ACPI_IO_PORT_DESCRIPTOR *) Resources.SmallHeader;
+        if (Io->Length != 0) {
+          SerialDevice->BaseAddress = Io->BaseAddressMin;
+        }
+        break;
+
+      case ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR:
+        FixedIo = (EFI_ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR *) Resources.SmallHeader;
+        if (FixedIo->Length != 0) {
+          SerialDevice->BaseAddress = FixedIo->BaseAddress;
+        }
+        break;
+
+      case ACPI_ADDRESS_SPACE_DESCRIPTOR:
+        AddressSpace = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Resources.SmallHeader;
+        if (AddressSpace->AddrLen != 0) {
+          if (AddressSpace->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
+            SerialDevice->MmioAccess = TRUE;
+          }
+          SerialDevice->BaseAddress = AddressSpace->AddrRangeMin + Offset;
+        }
+        break;
+      }
+
+      if (Resources.SmallHeader->Bits.Type == 0) {
+        Resources.SmallHeader = (ACPI_SMALL_RESOURCE_HEADER *) ((UINT8 *) Resources.SmallHeader
+                                                                + Resources.SmallHeader->Bits.Length
+                                                                + sizeof (*Resources.SmallHeader));
+      } else {
+        Resources.LargeHeader = (ACPI_LARGE_RESOURCE_HEADER *) ((UINT8 *) Resources.LargeHeader
+                                                                + Resources.LargeHeader->Length
+                                                                + sizeof (*Resources.LargeHeader));
+      }
+    }
+  }
+
+  if (SerialDevice->BaseAddress == 0) {
+    Status = EFI_INVALID_PARAMETER;
+    goto CreateError;
+  }
+
+  SerialDevice->HardwareFlowControl = (BOOLEAN) (FlowControlMap == UART_FLOW_CONTROL_HARDWARE);
+
+  //
+  // Report status code the serial present
+  //
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+    EFI_PROGRESS_CODE,
+    EFI_P_PC_PRESENCE_DETECT | EFI_PERIPHERAL_SERIAL_PORT,
+    SerialDevice->ParentDevicePath
+    );
+
+  if (!SerialPresent (SerialDevice)) {
+    Status = EFI_DEVICE_ERROR;
+    REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+      EFI_ERROR_CODE,
+      EFI_P_EC_NOT_DETECTED | EFI_PERIPHERAL_SERIAL_PORT,
+      SerialDevice->ParentDevicePath
+      );
+    goto CreateError;
+  }
+
+  //
+  // 1. Append Controller device path node.
+  //
+  if (CreateControllerNode) {
+    mControllerDevicePathTemplate.ControllerNumber = SerialDevice->Instance;
+    SerialDevice->DevicePath = AppendDevicePathNode (
+                                 SerialDevice->ParentDevicePath,
+                                 (EFI_DEVICE_PATH_PROTOCOL *) &mControllerDevicePathTemplate
+                                 );
+    SerialDevice->ContainsControllerNode = TRUE;
+  }
+
+  //
+  // 2. Append UART device path node.
+  //    The Uart setings are zero here.
+  //    SetAttribute() will update them to match the default setings.
+  //
+  TempDevicePath = SerialDevice->DevicePath;
+  if (TempDevicePath != NULL) {
+    SerialDevice->DevicePath = AppendDevicePathNode (
+                                 TempDevicePath,
+                                 (EFI_DEVICE_PATH_PROTOCOL *) &SerialDevice->UartDevicePath
+                                 );
+    FreePool (TempDevicePath);
+  } else {
+    SerialDevice->DevicePath = AppendDevicePathNode (
+                                 SerialDevice->ParentDevicePath,
+                                 (EFI_DEVICE_PATH_PROTOCOL *) &SerialDevice->UartDevicePath
+                                 );
+  }
+  //
+  // 3. Append the Flow Control device path node.
+  //    Only produce the Flow Control node when remaining device path has it
+  //
+  if (FlowControl != NULL) {
+    TempDevicePath = SerialDevice->DevicePath;
+    if (TempDevicePath != NULL) {
+      SerialDevice->DevicePath = AppendDevicePathNode (
+                                   TempDevicePath,
+                                   (EFI_DEVICE_PATH_PROTOCOL *) FlowControl
+                                   );
+      FreePool (TempDevicePath);
+    }
+  }
+  ASSERT (SerialDevice->DevicePath != NULL);
+
+  //
+  // Fill in Serial I/O Mode structure based on either the RemainingDevicePath or defaults.
+  //
+  SerialDevice->SerialMode.BaudRate = SerialDevice->UartDevicePath.BaudRate;
+  SerialDevice->SerialMode.DataBits = SerialDevice->UartDevicePath.DataBits;
+  SerialDevice->SerialMode.Parity   = SerialDevice->UartDevicePath.Parity;
+  SerialDevice->SerialMode.StopBits = SerialDevice->UartDevicePath.StopBits;
+
+  //
+  // Issue a reset to initialize the COM port
+  //
+  Status = SerialDevice->SerialIo.Reset (&SerialDevice->SerialIo);
+  if (EFI_ERROR (Status)) {
+    REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+      EFI_ERROR_CODE,
+      EFI_P_EC_CONTROLLER_ERROR | EFI_PERIPHERAL_SERIAL_PORT,
+      SerialDevice->DevicePath
+      );
+    goto CreateError;
+  }
+
+  AddName (SerialDevice, Instance);
+  //
+  // Install protocol interfaces for the serial device.
+  //
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &SerialDevice->Handle,
+                  &gEfiDevicePathProtocolGuid, SerialDevice->DevicePath,
+                  &gEfiSerialIoProtocolGuid, &SerialDevice->SerialIo,
+                  NULL
+                  );
+  if (EFI_ERROR (Status)) {
+    goto CreateError;
+  }
+  //
+  // Open For Child Device
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  PciSerialParameter != NULL ? &gEfiPciIoProtocolGuid : &gEfiSioProtocolGuid,
+                  (VOID **) &ParentIo,
+                  gSerialControllerDriver.DriverBindingHandle,
+                  SerialDevice->Handle,
+                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+                  );
+
+  if (EFI_ERROR (Status)) {
+    gBS->UninstallMultipleProtocolInterfaces (
+           &SerialDevice->Handle,
+           &gEfiDevicePathProtocolGuid, SerialDevice->DevicePath,
+           &gEfiSerialIoProtocolGuid, &SerialDevice->SerialIo,
+           NULL
+           );
+  }
+
+CreateError:
+  if (EFI_ERROR (Status)) {
+    if (SerialDevice->DevicePath != NULL) {
+      FreePool (SerialDevice->DevicePath);
+    }
+    if (SerialDevice->ControllerNameTable != NULL) {
+      FreeUnicodeStringTable (SerialDevice->ControllerNameTable);
+    }
+    FreePool (SerialDevice);
+  }
+  return Status;
+}
+
+/**
+  Returns an array of pointers containing all the child serial device pointers.
+
+  @param Controller      The parent controller handle.
+  @param IoProtocolGuid  The protocol GUID, either equals to gEfiSioProtocolGuid
+                         or equals to gEfiPciIoProtocolGuid.
+  @param Count           Count of the serial devices.
+
+  @return  An array of pointers containing all the child serial device pointers.
+**/
+SERIAL_DEV **
+GetChildSerialDevices (
+  IN EFI_HANDLE                       Controller,
+  IN EFI_GUID                         *IoProtocolGuid,
+  OUT UINTN                           *Count
+  )
+{
+  EFI_STATUS                                 Status;
+  UINTN                                      Index;
+  EFI_OPEN_PROTOCOL_INFORMATION_ENTRY        *OpenInfoBuffer;
+  UINTN                                      EntryCount;
+  SERIAL_DEV                                 **SerialDevices;
+  EFI_SERIAL_IO_PROTOCOL                     *SerialIo;
+  BOOLEAN                                    OpenByDriver;
+
+  *Count = 0;
+  //
+  // If the SerialIo instance specified by RemainingDevicePath is already created,
+  // update the attributes/control.
+  //
+  Status = gBS->OpenProtocolInformation (
+    Controller,
+    IoProtocolGuid,
+    &OpenInfoBuffer,
+    &EntryCount
+    );
+  if (EFI_ERROR (Status)) {
+    return NULL;
+  }
+
+  SerialDevices = AllocatePool (EntryCount * sizeof (SERIAL_DEV *));
+  ASSERT (SerialDevices != NULL);
+
+  *Count = 0;
+  OpenByDriver = FALSE;
+  for (Index = 0; Index < EntryCount; Index++) {
+    if ((OpenInfoBuffer[Index].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {
+      Status = gBS->OpenProtocol (
+        OpenInfoBuffer[Index].ControllerHandle,
+        &gEfiSerialIoProtocolGuid,
+        (VOID **) &SerialIo,
+        gSerialControllerDriver.DriverBindingHandle,
+        Controller,
+        EFI_OPEN_PROTOCOL_GET_PROTOCOL
+        );
+      if (!EFI_ERROR (Status)) {
+        SerialDevices[(*Count)++] = SERIAL_DEV_FROM_THIS (SerialIo);
+      }
+    }
+
+
+    if ((OpenInfoBuffer[Index].Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {
+      ASSERT (OpenInfoBuffer[Index].AgentHandle == gSerialControllerDriver.DriverBindingHandle);
+      OpenByDriver = TRUE;
+    }
+  }
+  if (OpenInfoBuffer != NULL) {
+    FreePool (OpenInfoBuffer);
+  }
+
+  ASSERT ((*Count == 0) || (OpenByDriver));
+
+  return SerialDevices;
+}
+
+/**
+  Start to management the controller passed in
+
+  @param  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller           The handle of the controller to test.
+  @param  RemainingDevicePath  A pointer to the remaining portion of a device path.
+
+  @return EFI_SUCCESS   Driver is started successfully
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  )
+{
+  EFI_STATUS                                 Status;
+  UINTN                                      Index;
+  EFI_DEVICE_PATH_PROTOCOL                   *ParentDevicePath;
+  EFI_DEVICE_PATH_PROTOCOL                   *Node;
+  EFI_SERIAL_IO_PROTOCOL                     *SerialIo;
+  UINT32                                     ControllerNumber;
+  UART_DEVICE_PATH                           *Uart;
+  UART_FLOW_CONTROL_DEVICE_PATH              *FlowControl;
+  UINT32                                     Control;
+  PARENT_IO_PROTOCOL_PTR                     ParentIo;
+  ACPI_HID_DEVICE_PATH                       *Acpi;
+  EFI_GUID                                   *IoProtocolGuid;
+  PCI_SERIAL_PARAMETER                       *PciSerialParameter;
+  PCI_SERIAL_PARAMETER                       DefaultPciSerialParameter;
+  PCI_TYPE00                                 Pci;
+  UINT32                                     PciSerialCount;
+  SERIAL_DEV                                 **SerialDevices;
+  UINTN                                      SerialDeviceCount;
+  PCI_DEVICE_INFO                            *PciDeviceInfo;
+  UINT64                                     Supports;
+  BOOLEAN                                    ContainsControllerNode;
+
+  //
+  // Get the Parent Device Path
+  //
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  &gEfiDevicePathProtocolGuid,
+                  (VOID **) &ParentDevicePath,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status) && Status != EFI_ALREADY_STARTED) {
+    return Status;
+  }
+  //
+  // Report status code enable the serial
+  //
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+    EFI_PROGRESS_CODE,
+    EFI_P_PC_ENABLE | EFI_PERIPHERAL_SERIAL_PORT,
+    ParentDevicePath
+    );
+
+  //
+  // Grab the IO abstraction we need to get any work done
+  //
+  IoProtocolGuid = &gEfiSioProtocolGuid;
+  Status = gBS->OpenProtocol (
+                  Controller,
+                  IoProtocolGuid,
+                  (VOID **) &ParentIo,
+                  This->DriverBindingHandle,
+                  Controller,
+                  EFI_OPEN_PROTOCOL_BY_DRIVER
+                  );
+  if (EFI_ERROR (Status) && Status != EFI_ALREADY_STARTED) {
+    IoProtocolGuid = &gEfiPciIoProtocolGuid;
+    Status = gBS->OpenProtocol (
+                    Controller,
+                    IoProtocolGuid,
+                    (VOID **) &ParentIo,
+                    This->DriverBindingHandle,
+                    Controller,
+                    EFI_OPEN_PROTOCOL_BY_DRIVER
+                    );
+  }
+  ASSERT (!EFI_ERROR (Status) || Status == EFI_ALREADY_STARTED);
+
+  //
+  // Do nothing for END device path node
+  //
+  if ((RemainingDevicePath != NULL) && IsDevicePathEnd (RemainingDevicePath)) {
+    return EFI_SUCCESS;
+  }
+
+
+  SerialDevices = GetChildSerialDevices (Controller, IoProtocolGuid, &SerialDeviceCount);
+  //
+  // If the SerialIo instance specified by RemainingDevicePath is already created,
+  // update the attributes/control.
+  //
+  if ((SerialDeviceCount != 0) && (RemainingDevicePath != NULL)) {
+    Uart = (UART_DEVICE_PATH *) SkipControllerDevicePathNode (RemainingDevicePath, &ContainsControllerNode, &ControllerNumber);
+    for (Index = 0; Index < SerialDeviceCount; Index++) {
+      if ((!SerialDevices[Index]->ContainsControllerNode && !ContainsControllerNode) ||
+          (SerialDevices[Index]->ContainsControllerNode && ContainsControllerNode && SerialDevices[Index]->Instance == ControllerNumber)
+          ) {
+        Status = EFI_INVALID_PARAMETER;
+        //
+        // Pass NULL ActualBaudRate to VerifyUartParameters to disallow baudrate degrade.
+        // DriverBindingStart() shouldn't create a handle with different UART device path.
+        //
+        if (VerifyUartParameters (SerialDevices[Index]->ClockRate, Uart->BaudRate, Uart->DataBits,
+                                  (EFI_PARITY_TYPE) Uart->Parity, (EFI_STOP_BITS_TYPE) Uart->StopBits, NULL, NULL)) {
+          SerialIo = &SerialDevices[Index]->SerialIo;
+          Status = SerialIo->SetAttributes (
+                               SerialIo,
+                               Uart->BaudRate,
+                               SerialIo->Mode->ReceiveFifoDepth,
+                               SerialIo->Mode->Timeout,
+                               (EFI_PARITY_TYPE) Uart->Parity,
+                               Uart->DataBits,
+                               (EFI_STOP_BITS_TYPE) Uart->StopBits
+                               );
+        }
+        FlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) NextDevicePathNode (Uart);
+        if (!EFI_ERROR (Status) && IsUartFlowControlDevicePathNode (FlowControl)) {
+          Status = SerialIo->GetControl (SerialIo, &Control);
+          if (!EFI_ERROR (Status)) {
+            if (ReadUnaligned32 (&FlowControl->FlowControlMap) == UART_FLOW_CONTROL_HARDWARE) {
+              Control |= EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+            } else {
+              Control &= ~EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+            }
+            //
+            // Clear the bits that are not allowed to pass to SetControl
+            //
+            Control &= (EFI_SERIAL_REQUEST_TO_SEND | EFI_SERIAL_DATA_TERMINAL_READY |
+                        EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE | EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE |
+                        EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE);
+            Status = SerialIo->SetControl (SerialIo, Control);
+          }
+        }
+        break;
+      }
+    }
+    if (Index != SerialDeviceCount) {
+      //
+      // Directly return if the SerialIo instance specified by RemainingDevicePath is found and updated.
+      // Otherwise continue to create the instance specified by RemainingDevicePath.
+      //
+      if (SerialDevices != NULL) {
+        FreePool (SerialDevices);
+      }
+      return Status;
+    }
+  }
+
+  if (RemainingDevicePath != NULL) {
+    Uart = (UART_DEVICE_PATH *) SkipControllerDevicePathNode (RemainingDevicePath, &ContainsControllerNode, &ControllerNumber);
+  } else {
+    Uart = NULL;
+  }
+
+  PciDeviceInfo = NULL;
+  if (IoProtocolGuid == &gEfiSioProtocolGuid) {
+    Status = EFI_NOT_FOUND;
+    if (RemainingDevicePath == NULL || !ContainsControllerNode) {
+      Node = ParentDevicePath;
+      do {
+        Acpi = (ACPI_HID_DEVICE_PATH *) Node;
+        Node = NextDevicePathNode (Node);
+      } while (!IsDevicePathEnd (Node));
+      Status = CreateSerialDevice (Controller, Uart, ParentDevicePath, FALSE, Acpi->UID, ParentIo, NULL, NULL);
+      DEBUG ((EFI_D_INFO, "PciSioSerial: Create SIO child serial device - %r\n", Status));
+    }
+  } else {
+    Status = ParentIo.PciIo->Pci.Read (ParentIo.PciIo, EfiPciIoWidthUint8, 0, sizeof (Pci), &Pci);
+    if (!EFI_ERROR (Status)) {
+      //
+      // PcdPciSerialParameters takes the higher priority.
+      //
+      PciSerialCount = 0;
+      for (PciSerialParameter = PcdGetPtr (PcdPciSerialParameters); PciSerialParameter->VendorId != 0xFFFF; PciSerialParameter++) {
+        if ((PciSerialParameter->VendorId == Pci.Hdr.VendorId) &&
+            (PciSerialParameter->DeviceId == Pci.Hdr.DeviceId)
+            ) {
+          PciSerialCount++;
+        }
+      }
+
+      if (SerialDeviceCount == 0) {
+        //
+        // Enable the IO & MEM decoding when creating the first child.
+        // Restore the PCI attributes when all children is destroyed (PciDeviceInfo->ChildCount == 0).
+        //
+        PciDeviceInfo = AllocatePool (sizeof (PCI_DEVICE_INFO));
+        PciDeviceInfo->ChildCount = 0;
+        PciDeviceInfo->PciIo = ParentIo.PciIo;
+        Status = ParentIo.PciIo->Attributes (
+          ParentIo.PciIo,
+          EfiPciIoAttributeOperationGet,
+          0,
+          &PciDeviceInfo->PciAttributes
+          );
+
+        if (!EFI_ERROR (Status)) {
+          Status = ParentIo.PciIo->Attributes (
+            ParentIo.PciIo,
+            EfiPciIoAttributeOperationSupported,
+            0,
+            &Supports
+            );
+          if (!EFI_ERROR (Status)) {
+            Supports &= EFI_PCI_IO_ATTRIBUTE_IO | EFI_PCI_IO_ATTRIBUTE_MEMORY;
+            Status = ParentIo.PciIo->Attributes (
+              ParentIo.PciIo,
+              EfiPciIoAttributeOperationEnable,
+              Supports,
+              NULL
+              );
+          }
+        }
+      } else {
+        //
+        // Re-use the PciDeviceInfo stored in existing children.
+        //
+        PciDeviceInfo = SerialDevices[0]->PciDeviceInfo;
+        ASSERT (PciDeviceInfo != NULL);
+      }
+
+      Status = EFI_NOT_FOUND;
+      if (PciSerialCount <= 1) {
+        //
+        // PCI serial device contains only one UART
+        //
+        if (RemainingDevicePath == NULL || !ContainsControllerNode) {
+          //
+          // This PCI serial device is matched by class code in Supported()
+          //
+          if (PciSerialCount == 0) {
+            DefaultPciSerialParameter.VendorId = Pci.Hdr.VendorId;
+            DefaultPciSerialParameter.DeviceId = Pci.Hdr.DeviceId;
+            DefaultPciSerialParameter.BarIndex = 0;
+            DefaultPciSerialParameter.Offset = 0;
+            DefaultPciSerialParameter.RegisterStride = 0;
+            DefaultPciSerialParameter.ClockRate = 0;
+            PciSerialParameter = &DefaultPciSerialParameter;
+          } else if (PciSerialCount == 1) {
+            PciSerialParameter = PcdGetPtr (PcdPciSerialParameters);
+          }
+
+          Status = CreateSerialDevice (Controller, Uart, ParentDevicePath, FALSE, 0, ParentIo, PciSerialParameter, PciDeviceInfo);
+          DEBUG ((EFI_D_INFO, "PciSioSerial: Create PCI child serial device (single) - %r\n", Status));
+          if (!EFI_ERROR (Status)) {
+            PciDeviceInfo->ChildCount++;
+          }
+        }
+      } else {
+        //
+        // PCI serial device contains multiple UARTs
+        //
+        if (RemainingDevicePath == NULL || ContainsControllerNode) {
+          PciSerialCount = 0;
+          for (PciSerialParameter = PcdGetPtr (PcdPciSerialParameters); PciSerialParameter->VendorId != 0xFFFF; PciSerialParameter++) {
+            if ((PciSerialParameter->VendorId == Pci.Hdr.VendorId) &&
+                (PciSerialParameter->DeviceId == Pci.Hdr.DeviceId) &&
+                ((RemainingDevicePath == NULL) || (ControllerNumber == PciSerialCount))
+                ) {
+              //
+              // Create controller node when PCI serial device contains multiple UARTs
+              //
+              Status = CreateSerialDevice (Controller, Uart, ParentDevicePath, TRUE, PciSerialCount, ParentIo, PciSerialParameter, PciDeviceInfo);
+              PciSerialCount++;
+              DEBUG ((EFI_D_INFO, "PciSioSerial: Create PCI child serial device (multiple) - %r\n", Status));
+              if (!EFI_ERROR (Status)) {
+                PciDeviceInfo->ChildCount++;
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+  if (SerialDevices != NULL) {
+    FreePool (SerialDevices);
+  }
+
+  //
+  // For multiple PCI serial devices, set Status to SUCCESS if one child is created successfully
+  //
+  if ((PciDeviceInfo != NULL) && (PciDeviceInfo->ChildCount != 0)) {
+    Status = EFI_SUCCESS;
+  }
+
+  if (EFI_ERROR (Status) && (SerialDeviceCount == 0)) {
+    if (PciDeviceInfo != NULL) {
+      Status = ParentIo.PciIo->Attributes (
+        ParentIo.PciIo,
+        EfiPciIoAttributeOperationSet,
+        PciDeviceInfo->PciAttributes,
+        NULL
+        );
+      ASSERT_EFI_ERROR (Status);
+      FreePool (PciDeviceInfo);
+    }
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiDevicePathProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+           );
+    gBS->CloseProtocol (
+           Controller,
+           IoProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+           );
+  }
+
+  return Status;
+}
+
+/**
+  Disconnect this driver with the controller, uninstall related protocol instance
+
+  @param  This                  A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller            The handle of the controller to test.
+  @param  NumberOfChildren      Number of child device.
+  @param  ChildHandleBuffer     A pointer to the remaining portion of a device path.
+
+  @retval EFI_SUCCESS           Operation successfully
+  @retval EFI_DEVICE_ERROR      Cannot stop the driver successfully
+
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN  EFI_HANDLE                     Controller,
+  IN  UINTN                          NumberOfChildren,
+  IN  EFI_HANDLE                     *ChildHandleBuffer
+  )
+
+{
+  EFI_STATUS                          Status;
+  UINTN                               Index;
+  BOOLEAN                             AllChildrenStopped;
+  EFI_SERIAL_IO_PROTOCOL              *SerialIo;
+  SERIAL_DEV                          *SerialDevice;
+  VOID                                *IoProtocol;
+  EFI_DEVICE_PATH_PROTOCOL            *DevicePath;
+  PCI_DEVICE_INFO                     *PciDeviceInfo;
+
+  PciDeviceInfo = NULL;
+
+  Status = gBS->HandleProtocol (
+                  Controller,
+                  &gEfiDevicePathProtocolGuid,
+                  (VOID **) &DevicePath
+                  );
+
+  //
+  // Report the status code disable the serial
+  //
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+    EFI_PROGRESS_CODE,
+    EFI_P_PC_DISABLE | EFI_PERIPHERAL_SERIAL_PORT,
+    DevicePath
+    );
+
+  if (NumberOfChildren == 0) {
+    //
+    // Close the bus driver
+    //
+    Status = gBS->OpenProtocol (
+                    Controller,
+                    &gEfiPciIoProtocolGuid,
+                    &IoProtocol,
+                    This->DriverBindingHandle,
+                    Controller,
+                    EFI_OPEN_PROTOCOL_TEST_PROTOCOL
+                    );
+    gBS->CloseProtocol (
+           Controller,
+           !EFI_ERROR (Status) ? &gEfiPciIoProtocolGuid : &gEfiSioProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+           );
+
+    gBS->CloseProtocol (
+           Controller,
+           &gEfiDevicePathProtocolGuid,
+           This->DriverBindingHandle,
+           Controller
+           );
+    return EFI_SUCCESS;
+  }
+
+  AllChildrenStopped = TRUE;
+
+  for (Index = 0; Index < NumberOfChildren; Index++) {
+
+    Status = gBS->OpenProtocol (
+                    ChildHandleBuffer[Index],
+                    &gEfiSerialIoProtocolGuid,
+                    (VOID **) &SerialIo,
+                    This->DriverBindingHandle,
+                    Controller,
+                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
+                    );
+    if (!EFI_ERROR (Status)) {
+
+      SerialDevice = SERIAL_DEV_FROM_THIS (SerialIo);
+      ASSERT ((PciDeviceInfo == NULL) || (PciDeviceInfo == SerialDevice->PciDeviceInfo));
+      PciDeviceInfo = SerialDevice->PciDeviceInfo;
+
+      Status = gBS->CloseProtocol (
+                      Controller,
+                      PciDeviceInfo != NULL ? &gEfiPciIoProtocolGuid : &gEfiSioProtocolGuid,
+                      This->DriverBindingHandle,
+                      ChildHandleBuffer[Index]
+                      );
+
+      Status = gBS->UninstallMultipleProtocolInterfaces (
+                      ChildHandleBuffer[Index],
+                      &gEfiDevicePathProtocolGuid, SerialDevice->DevicePath,
+                      &gEfiSerialIoProtocolGuid,   &SerialDevice->SerialIo,
+                      NULL
+                      );
+      if (EFI_ERROR (Status)) {
+        gBS->OpenProtocol (
+               Controller,
+               PciDeviceInfo != NULL ? &gEfiPciIoProtocolGuid : &gEfiSioProtocolGuid,
+               &IoProtocol,
+               This->DriverBindingHandle,
+               ChildHandleBuffer[Index],
+               EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER
+               );
+      } else {
+        FreePool (SerialDevice->DevicePath);
+        FreeUnicodeStringTable (SerialDevice->ControllerNameTable);
+        FreePool (SerialDevice);
+
+        if (PciDeviceInfo != NULL) {
+          ASSERT (PciDeviceInfo->ChildCount != 0);
+          PciDeviceInfo->ChildCount--;
+        }
+      }
+    }
+
+    if (EFI_ERROR (Status)) {
+      AllChildrenStopped = FALSE;
+    }
+  }
+
+  if (!AllChildrenStopped) {
+    return EFI_DEVICE_ERROR;
+  } else {
+    //
+    // If all children are destroyed, restore the PCI attributes.
+    //
+    if ((PciDeviceInfo != NULL) && (PciDeviceInfo->ChildCount == 0)) {
+      ASSERT (PciDeviceInfo->PciIo != NULL);
+      Status = PciDeviceInfo->PciIo->Attributes (
+        PciDeviceInfo->PciIo,
+        EfiPciIoAttributeOperationSet,
+        PciDeviceInfo->PciAttributes,
+        NULL
+        );
+      ASSERT_EFI_ERROR (Status);
+      FreePool (PciDeviceInfo);
+    }
+    return EFI_SUCCESS;
+  }
+}
diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.h b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.h
new file mode 100644
index 000000000000..f147e6904462
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.h
@@ -0,0 +1,789 @@
+/** @file
+  Header file for PciSioSerial Driver
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _SERIAL_H_
+#define _SERIAL_H_
+
+
+#include <Uefi.h>
+
+#include <IndustryStandard/Pci.h>
+
+#include <Protocol/SuperIo.h>
+#include <Protocol/PciIo.h>
+#include <Protocol/SerialIo.h>
+#include <Protocol/DevicePath.h>
+
+#include <Library/DebugLib.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/UefiLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/ReportStatusCodeLib.h>
+#include <Library/PcdLib.h>
+#include <Library/IoLib.h>
+#include <Library/PrintLib.h>
+
+//
+// Driver Binding Externs
+//
+extern EFI_DRIVER_BINDING_PROTOCOL  gSerialControllerDriver;
+extern EFI_COMPONENT_NAME_PROTOCOL  gPciSioSerialComponentName;
+extern EFI_COMPONENT_NAME2_PROTOCOL gPciSioSerialComponentName2;
+
+#define SIO_SERIAL_PORT_NAME L"SIO Serial Port #%d"
+#define PCI_SERIAL_PORT_NAME L"PCI Serial Port #%d"
+#define SERIAL_PORT_NAME_LEN (sizeof (SIO_SERIAL_PORT_NAME) / sizeof (CHAR16) + MAXIMUM_VALUE_CHARACTERS)
+
+//
+// Internal Data Structures
+//
+#define TIMEOUT_STALL_INTERVAL  10
+
+#pragma pack(1)
+///
+/// PcdPciSerialParameters contains zero or more instances of the below structure.
+/// If a PCI device contains multiple UARTs, PcdPciSerialParameters needs to contain
+/// two instances of the below structure, with the VendorId and DeviceId equals to the
+/// device ID and vendor ID of the device. If the PCI device uses the first two BARs
+/// to support multiple UARTs, BarIndex of first instance equals to 0 and BarIndex of
+/// second one equals to 1; if the PCI device uses the first BAR to support multiple
+/// UARTs, BarIndex of both instance equals to 0 and Offset of first instance equals
+/// to 0 while Offset of second one equals to some value bigger or equal to 8.
+/// For certain UART whose register needs to be accessed in DWORD aligned address,
+/// RegisterStride equals to 4.
+///
+typedef struct {
+  UINT16  VendorId;          ///< Vendor ID to match the PCI device.  The value 0xFFFF terminates the list of entries.
+  UINT16  DeviceId;          ///< Device ID to match the PCI device
+  UINT32  ClockRate;         ///< UART clock rate.  Set to 0 for default clock rate of 1843200 Hz
+  UINT64  Offset;            ///< The byte offset into to the BAR
+  UINT8   BarIndex;          ///< Which BAR to get the UART base address
+  UINT8   RegisterStride;    ///< UART register stride in bytes.  Set to 0 for default register stride of 1 byte.
+  UINT16  ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
+  UINT16  TransmitFifoDepth; ///< UART transmit FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
+  UINT8   Reserved[2];
+} PCI_SERIAL_PARAMETER;
+#pragma pack()
+
+#define SERIAL_MAX_FIFO_SIZE 17       ///< Actual FIFO size is 16. FIFO based on circular wastes one unit.
+typedef struct {
+  UINT16  Head;                       ///< Head pointer of the FIFO. Empty when (Head == Tail).
+  UINT16  Tail;                       ///< Tail pointer of the FIFO. Full when ((Tail + 1) % SERIAL_MAX_FIFO_SIZE == Head).
+  UINT8   Data[SERIAL_MAX_FIFO_SIZE]; ///< Store the FIFO data.
+} SERIAL_DEV_FIFO;
+
+typedef union {
+  EFI_PCI_IO_PROTOCOL       *PciIo;
+  EFI_SIO_PROTOCOL          *Sio;
+} PARENT_IO_PROTOCOL_PTR;
+
+typedef struct {
+  EFI_PCI_IO_PROTOCOL      *PciIo;        // Pointer to parent PciIo instance.
+  UINTN                    ChildCount;    // Count of child SerialIo instance.
+  UINT64                   PciAttributes; // Original PCI attributes.
+} PCI_DEVICE_INFO;
+
+typedef struct {
+  UINT32                   Signature;
+  EFI_HANDLE               Handle;
+  EFI_SERIAL_IO_PROTOCOL   SerialIo;
+  EFI_SERIAL_IO_MODE       SerialMode;
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;
+
+  EFI_DEVICE_PATH_PROTOCOL *ParentDevicePath;
+  UART_DEVICE_PATH         UartDevicePath;
+
+  EFI_PHYSICAL_ADDRESS     BaseAddress;       ///< UART base address
+  BOOLEAN                  MmioAccess;        ///< TRUE for MMIO, FALSE for IO
+  UINT8                    RegisterStride;    ///< UART Register Stride
+  UINT32                   ClockRate;         ///< UART clock rate
+
+  UINT16                   ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes.
+  SERIAL_DEV_FIFO          Receive;           ///< The FIFO used to store received data
+
+  UINT16                   TransmitFifoDepth; ///< UART transmit FIFO depth in bytes.
+  SERIAL_DEV_FIFO          Transmit;          ///< The FIFO used to store to-transmit data
+
+  BOOLEAN                  SoftwareLoopbackEnable;
+  BOOLEAN                  HardwareFlowControl;
+  EFI_UNICODE_STRING_TABLE *ControllerNameTable;
+  BOOLEAN                  ContainsControllerNode; ///< TRUE if the device produced contains Controller node
+  UINT32                   Instance;
+  PCI_DEVICE_INFO          *PciDeviceInfo;
+} SERIAL_DEV;
+
+#define SERIAL_DEV_SIGNATURE    SIGNATURE_32 ('s', 'e', 'r', 'd')
+#define SERIAL_DEV_FROM_THIS(a) CR (a, SERIAL_DEV, SerialIo, SERIAL_DEV_SIGNATURE)
+
+//
+// Serial Driver Defaults
+//
+#define SERIAL_PORT_DEFAULT_TIMEOUT             1000000
+#define SERIAL_PORT_SUPPORT_CONTROL_MASK        (EFI_SERIAL_CLEAR_TO_SEND                | \
+                                                 EFI_SERIAL_DATA_SET_READY               | \
+                                                 EFI_SERIAL_RING_INDICATE                | \
+                                                 EFI_SERIAL_CARRIER_DETECT               | \
+                                                 EFI_SERIAL_REQUEST_TO_SEND              | \
+                                                 EFI_SERIAL_DATA_TERMINAL_READY          | \
+                                                 EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE     | \
+                                                 EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE     | \
+                                                 EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE | \
+                                                 EFI_SERIAL_OUTPUT_BUFFER_EMPTY          | \
+                                                 EFI_SERIAL_INPUT_BUFFER_EMPTY)
+
+#define SERIAL_PORT_MIN_TIMEOUT             1         // 1 uS
+#define SERIAL_PORT_MAX_TIMEOUT             100000000 // 100 seconds
+//
+// UART Registers
+//
+#define SERIAL_REGISTER_THR 0  ///< WO   Transmit Holding Register
+#define SERIAL_REGISTER_RBR 0  ///< RO   Receive Buffer Register
+#define SERIAL_REGISTER_DLL 0  ///< R/W  Divisor Latch LSB
+#define SERIAL_REGISTER_DLM 1  ///< R/W  Divisor Latch MSB
+#define SERIAL_REGISTER_IER 1  ///< R/W  Interrupt Enable Register
+#define SERIAL_REGISTER_IIR 2  ///< RO   Interrupt Identification Register
+#define SERIAL_REGISTER_FCR 2  ///< WO   FIFO Cotrol Register
+#define SERIAL_REGISTER_LCR 3  ///< R/W  Line Control Register
+#define SERIAL_REGISTER_MCR 4  ///< R/W  Modem Control Register
+#define SERIAL_REGISTER_LSR 5  ///< R/W  Line Status Register
+#define SERIAL_REGISTER_MSR 6  ///< R/W  Modem Status Register
+#define SERIAL_REGISTER_SCR 7  ///< R/W  Scratch Pad Register
+#pragma pack(1)
+
+///
+/// Interrupt Enable Register
+///
+typedef union {
+  struct {
+    UINT8 Ravie : 1;   ///< Receiver Data Available Interrupt Enable
+    UINT8 Theie : 1;   ///< Transmistter Holding Register Empty Interrupt Enable
+    UINT8 Rie : 1;     ///< Receiver Interrupt Enable
+    UINT8 Mie : 1;     ///< Modem Interrupt Enable
+    UINT8 Reserved : 4;
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_IER;
+
+///
+/// FIFO Control Register
+///
+typedef union {
+  struct {
+    UINT8 TrFIFOE : 1;   ///< Transmit and Receive FIFO Enable
+    UINT8 ResetRF : 1;   ///< Reset Reciever FIFO
+    UINT8 ResetTF : 1;   ///< Reset Transmistter FIFO
+    UINT8 Dms : 1;       ///< DMA Mode Select
+    UINT8 Reserved : 1;
+    UINT8 TrFIFO64 : 1;  ///< Enable 64 byte FIFO
+    UINT8 Rtb : 2;       ///< Receive Trigger Bits
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_FCR;
+
+///
+/// Line Control Register
+///
+typedef union {
+  struct {
+    UINT8 SerialDB : 2;   ///< Number of Serial Data Bits
+    UINT8 StopB : 1;      ///< Number of Stop Bits
+    UINT8 ParEn : 1;      ///< Parity Enable
+    UINT8 EvenPar : 1;    ///< Even Parity Select
+    UINT8 SticPar : 1;    ///< Sticky Parity
+    UINT8 BrCon : 1;      ///< Break Control
+    UINT8 DLab : 1;       ///< Divisor Latch Access Bit
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_LCR;
+
+///
+/// Modem Control Register
+///
+typedef union {
+  struct {
+    UINT8 DtrC : 1;  ///< Data Terminal Ready Control
+    UINT8 Rts : 1;   ///< Request To Send Control
+    UINT8 Out1 : 1;  ///< Output1
+    UINT8 Out2 : 1;  ///< Output2, used to disable interrupt
+    UINT8 Lme : 1;   ///< Loopback Mode Enable
+    UINT8 Reserved : 3;
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_MCR;
+
+///
+/// Line Status Register
+///
+typedef union {
+  struct {
+    UINT8 Dr : 1;     ///< Receiver Data Ready Status
+    UINT8 Oe : 1;     ///< Overrun Error Status
+    UINT8 Pe : 1;     ///< Parity Error Status
+    UINT8 Fe : 1;     ///< Framing Error Status
+    UINT8 Bi : 1;     ///< Break Interrupt Status
+    UINT8 Thre : 1;   ///< Transmistter Holding Register Status
+    UINT8 Temt : 1;   ///< Transmitter Empty Status
+    UINT8 FIFOe : 1;  ///< FIFO Error Status
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_LSR;
+
+///
+/// Modem Status Register
+///
+typedef union {
+  struct {
+    UINT8 DeltaCTS : 1;         ///< Delta Clear To Send Status
+    UINT8 DeltaDSR : 1;         ///< Delta Data Set Ready Status
+    UINT8 TrailingEdgeRI : 1;   ///< Trailing Edge of Ring Indicator Status
+    UINT8 DeltaDCD : 1;         ///< Delta Data Carrier Detect Status
+    UINT8 Cts : 1;              ///< Clear To Send Status
+    UINT8 Dsr : 1;              ///< Data Set Ready Status
+    UINT8 Ri : 1;               ///< Ring Indicator Status
+    UINT8 Dcd : 1;              ///< Data Carrier Detect Status
+  } Bits;
+  UINT8 Data;
+} SERIAL_PORT_MSR;
+
+#pragma pack()
+//
+// Define serial register I/O macros
+//
+#define READ_RBR(S)     SerialReadRegister (S, SERIAL_REGISTER_RBR)
+#define READ_DLL(S)     SerialReadRegister (S, SERIAL_REGISTER_DLL)
+#define READ_DLM(S)     SerialReadRegister (S, SERIAL_REGISTER_DLM)
+#define READ_IER(S)     SerialReadRegister (S, SERIAL_REGISTER_IER)
+#define READ_IIR(S)     SerialReadRegister (S, SERIAL_REGISTER_IIR)
+#define READ_LCR(S)     SerialReadRegister (S, SERIAL_REGISTER_LCR)
+#define READ_MCR(S)     SerialReadRegister (S, SERIAL_REGISTER_MCR)
+#define READ_LSR(S)     SerialReadRegister (S, SERIAL_REGISTER_LSR)
+#define READ_MSR(S)     SerialReadRegister (S, SERIAL_REGISTER_MSR)
+#define READ_SCR(S)     SerialReadRegister (S, SERIAL_REGISTER_SCR)
+
+#define WRITE_THR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_THR, D)
+#define WRITE_DLL(S, D) SerialWriteRegister (S, SERIAL_REGISTER_DLL, D)
+#define WRITE_DLM(S, D) SerialWriteRegister (S, SERIAL_REGISTER_DLM, D)
+#define WRITE_IER(S, D) SerialWriteRegister (S, SERIAL_REGISTER_IER, D)
+#define WRITE_FCR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_FCR, D)
+#define WRITE_LCR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_LCR, D)
+#define WRITE_MCR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_MCR, D)
+#define WRITE_LSR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_LSR, D)
+#define WRITE_MSR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_MSR, D)
+#define WRITE_SCR(S, D) SerialWriteRegister (S, SERIAL_REGISTER_SCR, D)
+
+//
+// Prototypes
+// Driver model protocol interface
+//
+/**
+  Check to see if this driver supports the given controller
+
+  @param  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller           The handle of the controller to test.
+  @param  RemainingDevicePath  A pointer to the remaining portion of a device path.
+
+  @return EFI_SUCCESS          This driver can support the given controller
+
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverSupported (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  );
+
+/**
+  Start to management the controller passed in
+
+  @param  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller           The handle of the controller to test.
+  @param  RemainingDevicePath  A pointer to the remaining portion of a device path.
+
+  @return EFI_SUCCESS          Driver is started successfully
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverStart (
+  IN EFI_DRIVER_BINDING_PROTOCOL    *This,
+  IN EFI_HANDLE                     Controller,
+  IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath
+  );
+
+/**
+  Disconnect this driver with the controller, uninstall related protocol instance
+
+  @param  This                  A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.
+  @param  Controller            The handle of the controller to test.
+  @param  NumberOfChildren      Number of child device.
+  @param  ChildHandleBuffer     A pointer to the remaining portion of a device path.
+
+  @retval EFI_SUCCESS           Operation successfully
+  @retval EFI_DEVICE_ERROR      Cannot stop the driver successfully
+
+**/
+EFI_STATUS
+EFIAPI
+SerialControllerDriverStop (
+  IN  EFI_DRIVER_BINDING_PROTOCOL   *This,
+  IN  EFI_HANDLE                    Controller,
+  IN  UINTN                         NumberOfChildren,
+  IN  EFI_HANDLE                    *ChildHandleBuffer
+  );
+
+//
+// Serial I/O Protocol Interface
+//
+/**
+  Reset serial device.
+
+  @param This               Pointer to EFI_SERIAL_IO_PROTOCOL
+
+  @retval EFI_SUCCESS        Reset successfully
+  @retval EFI_DEVICE_ERROR   Failed to reset
+
+**/
+EFI_STATUS
+EFIAPI
+SerialReset (
+  IN EFI_SERIAL_IO_PROTOCOL         *This
+  );
+
+/**
+  Set new attributes to a serial device.
+
+  @param This                     Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param  BaudRate                 The baudrate of the serial device
+  @param  ReceiveFifoDepth         The depth of receive FIFO buffer
+  @param  Timeout                  The request timeout for a single char
+  @param  Parity                   The type of parity used in serial device
+  @param  DataBits                 Number of databits used in serial device
+  @param  StopBits                 Number of stopbits used in serial device
+
+  @retval  EFI_SUCCESS              The new attributes were set
+  @retval  EFI_INVALID_PARAMETERS   One or more attributes have an unsupported value
+  @retval  EFI_UNSUPPORTED          Data Bits can not set to 5 or 6
+  @retval  EFI_DEVICE_ERROR         The serial device is not functioning correctly (no return)
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetAttributes (
+  IN EFI_SERIAL_IO_PROTOCOL         *This,
+  IN UINT64                         BaudRate,
+  IN UINT32                         ReceiveFifoDepth,
+  IN UINT32                         Timeout,
+  IN EFI_PARITY_TYPE                Parity,
+  IN UINT8                          DataBits,
+  IN EFI_STOP_BITS_TYPE             StopBits
+  );
+
+/**
+  Set Control Bits.
+
+  @param This              Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param Control           Control bits that can be settable
+
+  @retval EFI_SUCCESS       New Control bits were set successfully
+  @retval EFI_UNSUPPORTED   The Control bits wanted to set are not supported
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetControl (
+  IN EFI_SERIAL_IO_PROTOCOL         *This,
+  IN UINT32                         Control
+  );
+
+/**
+  Get ControlBits.
+
+  @param This          Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param Control       Control signals of the serial device
+
+  @retval EFI_SUCCESS   Get Control signals successfully
+
+**/
+EFI_STATUS
+EFIAPI
+SerialGetControl (
+  IN EFI_SERIAL_IO_PROTOCOL         *This,
+  OUT UINT32                        *Control
+  );
+
+/**
+  Write the specified number of bytes to serial device.
+
+  @param This                Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param  BufferSize         On input the size of Buffer, on output the amount of
+                             data actually written
+  @param  Buffer             The buffer of data to write
+
+  @retval EFI_SUCCESS        The data were written successfully
+  @retval EFI_DEVICE_ERROR   The device reported an error
+  @retval EFI_TIMEOUT        The write operation was stopped due to timeout
+
+**/
+EFI_STATUS
+EFIAPI
+SerialWrite (
+  IN EFI_SERIAL_IO_PROTOCOL         *This,
+  IN OUT UINTN                      *BufferSize,
+  IN VOID                           *Buffer
+  );
+
+/**
+  Read the specified number of bytes from serial device.
+
+  @param This               Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param BufferSize         On input the size of Buffer, on output the amount of
+                            data returned in buffer
+  @param Buffer             The buffer to return the data into
+
+  @retval EFI_SUCCESS        The data were read successfully
+  @retval EFI_DEVICE_ERROR   The device reported an error
+  @retval EFI_TIMEOUT        The read operation was stopped due to timeout
+
+**/
+EFI_STATUS
+EFIAPI
+SerialRead (
+  IN EFI_SERIAL_IO_PROTOCOL         *This,
+  IN OUT UINTN                      *BufferSize,
+  OUT VOID                          *Buffer
+  );
+
+//
+// Internal Functions
+//
+/**
+  Use scratchpad register to test if this serial port is present.
+
+  @param SerialDevice   Pointer to serial device structure
+
+  @return if this serial port is present
+**/
+BOOLEAN
+SerialPresent (
+  IN SERIAL_DEV                     *SerialDevice
+  );
+
+/**
+  Detect whether specific FIFO is full or not.
+
+  @param Fifo    A pointer to the Data Structure SERIAL_DEV_FIFO
+
+  @return whether specific FIFO is full or not
+
+**/
+BOOLEAN
+SerialFifoFull (
+  IN SERIAL_DEV_FIFO                *Fifo
+  );
+
+/**
+  Detect whether specific FIFO is empty or not.
+ 
+  @param  Fifo    A pointer to the Data Structure SERIAL_DEV_FIFO
+
+  @return whether specific FIFO is empty or not
+
+**/
+BOOLEAN
+SerialFifoEmpty (
+  IN SERIAL_DEV_FIFO                *Fifo
+  );
+
+/**
+  Add data to specific FIFO.
+
+  @param Fifo                  A pointer to the Data Structure SERIAL_DEV_FIFO
+  @param Data                  the data added to FIFO
+
+  @retval EFI_SUCCESS           Add data to specific FIFO successfully
+  @retval EFI_OUT_OF_RESOURCE   Failed to add data because FIFO is already full
+
+**/
+EFI_STATUS
+SerialFifoAdd (
+  IN SERIAL_DEV_FIFO                *Fifo,
+  IN UINT8                          Data
+  );
+
+/**
+  Remove data from specific FIFO.
+
+  @param Fifo                  A pointer to the Data Structure SERIAL_DEV_FIFO
+  @param Data                  the data removed from FIFO
+
+  @retval EFI_SUCCESS           Remove data from specific FIFO successfully
+  @retval EFI_OUT_OF_RESOURCE   Failed to remove data because FIFO is empty
+
+**/
+EFI_STATUS
+SerialFifoRemove (
+  IN  SERIAL_DEV_FIFO               *Fifo,
+  OUT UINT8                         *Data
+  );
+
+/**
+  Reads and writes all avaliable data.
+
+  @param SerialDevice           The device to flush
+
+  @retval EFI_SUCCESS           Data was read/written successfully.
+  @retval EFI_OUT_OF_RESOURCE   Failed because software receive FIFO is full.  Note, when
+                                this happens, pending writes are not done.
+
+**/
+EFI_STATUS
+SerialReceiveTransmit (
+  IN SERIAL_DEV                     *SerialDevice
+  );
+
+/**
+  Read serial port.
+
+  @param SerialDev     Pointer to serial device
+  @param Offset        Offset in register group
+
+  @return Data read from serial port
+**/
+UINT8
+SerialReadRegister (
+  IN SERIAL_DEV                            *SerialDev,
+  IN UINT32                                Offset
+  );
+
+/**
+  Write serial port.
+
+  @param  SerialDev     Pointer to serial device
+  @param  Offset        Offset in register group
+  @param  Data          data which is to be written to some serial port register
+**/
+VOID
+SerialWriteRegister (
+  IN SERIAL_DEV                            *SerialDev,
+  IN UINT32                                Offset,
+  IN UINT8                                 Data
+  );
+
+
+//
+// EFI Component Name Functions
+//
+/**
+  Retrieves a Unicode string that is the user readable name of the driver.
+
+  This function retrieves the user readable name of a driver in the form of a
+  Unicode string. If the driver specified by This has a user readable name in
+  the language specified by Language, then a pointer to the driver name is
+  returned in DriverName, and EFI_SUCCESS is returned. If the driver specified
+  by This does not support the language specified by Language,
+  then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  Language[in]          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 or ISO 639-2 language code format.
+
+  @param  DriverName[out]       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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialComponentNameGetDriverName (
+  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 a driver.
+
+  This function retrieves the user readable name of the controller specified by
+  ControllerHandle and ChildHandle in the form of a Unicode string. If the
+  driver specified by This has a user readable name in the language specified by
+  Language, then a pointer to the controller name is returned in ControllerName,
+  and EFI_SUCCESS is returned.  If the driver specified by This is not currently
+  managing the controller specified by ControllerHandle and ChildHandle,
+  then EFI_UNSUPPORTED is returned.  If the driver specified by This does not
+  support the language specified by Language, then EFI_UNSUPPORTED is returned.
+
+  @param  This[in]              A pointer to the EFI_COMPONENT_NAME2_PROTOCOL or
+                                EFI_COMPONENT_NAME_PROTOCOL instance.
+
+  @param  ControllerHandle[in]  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[in]       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[in]          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 or ISO 639-2 language code format.
+
+  @param  ControllerName[out]   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.
+
+**/
+EFI_STATUS
+EFIAPI
+SerialComponentNameGetControllerName (
+  IN  EFI_COMPONENT_NAME_PROTOCOL                     *This,
+  IN  EFI_HANDLE                                      ControllerHandle,
+  IN  EFI_HANDLE                                      ChildHandle        OPTIONAL,
+  IN  CHAR8                                           *Language,
+  OUT CHAR16                                          **ControllerName
+  );
+
+/**
+  Add the component name for the serial io device
+
+  @param SerialDevice     A pointer to the SERIAL_DEV instance.
+  @param Uid              Unique ID for the serial device.
+**/
+VOID
+AddName (
+  IN  SERIAL_DEV                               *SerialDevice,
+  IN  UINT32                                   Uid
+  );
+
+/**
+  Checks whether the UART parameters are valid and computes the Divisor.
+
+  @param  ClockRate      The clock rate of the serial device used to verify
+                         the BaudRate. Do not verify the BaudRate if it's 0.
+  @param  BaudRate       The requested baudrate of the serial device.
+  @param  DataBits       Number of databits used in serial device.
+  @param  Parity         The type of parity used in serial device.
+  @param  StopBits       Number of stopbits used in serial device.
+  @param  Divisor        Return the divisor if ClockRate is not 0.
+  @param  ActualBaudRate Return the actual supported baudrate without
+                         exceeding BaudRate. NULL means baudrate degradation
+                         is not allowed.
+                         If the requested BaudRate is not supported, the routine
+                         returns TRUE and the Actual Baud Rate when ActualBaudRate
+                         is not NULL, returns FALSE when ActualBaudRate is NULL.
+
+  @retval TRUE   The UART parameters are valid.
+  @retval FALSE  The UART parameters are not valid.
+**/
+BOOLEAN
+VerifyUartParameters (
+  IN     UINT32                  ClockRate,
+  IN     UINT64                  BaudRate,
+  IN     UINT8                   DataBits,
+  IN     EFI_PARITY_TYPE         Parity,
+  IN     EFI_STOP_BITS_TYPE      StopBits,
+     OUT UINT64                  *Divisor,
+     OUT UINT64                  *ActualBaudRate
+  );
+
+/**
+  Skip the optional Controller device path node and return the
+  pointer to the next device path node.
+
+  @param DevicePath             Pointer to the device path.
+  @param ContainsControllerNode Returns TRUE if the Controller device path exists.
+  @param ControllerNumber       Returns the Controller Number if Controller device path exists.
+
+  @return     Pointer to the next device path node.
+**/
+UART_DEVICE_PATH *
+SkipControllerDevicePathNode (
+  EFI_DEVICE_PATH_PROTOCOL          *DevicePath,
+  BOOLEAN                           *ContainsControllerNode,
+  UINT32                            *ControllerNumber
+  );
+
+/**
+  Check the device path node whether it's the Flow Control node or not.
+
+  @param[in] FlowControl    The device path node to be checked.
+  
+  @retval TRUE              It's the Flow Control node.
+  @retval FALSE             It's not.
+
+**/
+BOOLEAN
+IsUartFlowControlDevicePathNode (
+  IN UART_FLOW_CONTROL_DEVICE_PATH *FlowControl
+  );
+#endif
diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/SerialIo.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/SerialIo.c
new file mode 100644
index 000000000000..f1870f3a1bed
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/SerialIo.c
@@ -0,0 +1,1320 @@
+/** @file
+  SerialIo implementation for PCI or SIO UARTs.
+
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "Serial.h"
+
+/**
+  Skip the optional Controller device path node and return the
+  pointer to the next device path node.
+
+  @param DevicePath             Pointer to the device path.
+  @param ContainsControllerNode Returns TRUE if the Controller device path exists.
+  @param ControllerNumber       Returns the Controller Number if Controller device path exists.
+
+  @return     Pointer to the next device path node.
+**/
+UART_DEVICE_PATH *
+SkipControllerDevicePathNode (
+  EFI_DEVICE_PATH_PROTOCOL          *DevicePath,
+  BOOLEAN                           *ContainsControllerNode,
+  UINT32                            *ControllerNumber
+  )
+{
+  if ((DevicePathType (DevicePath) == HARDWARE_DEVICE_PATH) &&
+      (DevicePathSubType (DevicePath) == HW_CONTROLLER_DP)
+      ) {
+    if (ContainsControllerNode != NULL) {
+      *ContainsControllerNode = TRUE;
+    }
+    if (ControllerNumber != NULL) {
+      *ControllerNumber = ((CONTROLLER_DEVICE_PATH *) DevicePath)->ControllerNumber;
+    }
+    DevicePath = NextDevicePathNode (DevicePath);
+  } else {
+    if (ContainsControllerNode != NULL) {
+      *ContainsControllerNode = FALSE;
+    }
+  }
+  return (UART_DEVICE_PATH *) DevicePath;
+}
+
+/**
+  Checks whether the UART parameters are valid and computes the Divisor.
+
+  @param  ClockRate      The clock rate of the serial device used to verify
+                         the BaudRate. Do not verify the BaudRate if it's 0.
+  @param  BaudRate       The requested baudrate of the serial device.
+  @param  DataBits       Number of databits used in serial device.
+  @param  Parity         The type of parity used in serial device.
+  @param  StopBits       Number of stopbits used in serial device.
+  @param  Divisor        Return the divisor if ClockRate is not 0.
+  @param  ActualBaudRate Return the actual supported baudrate without
+                         exceeding BaudRate. NULL means baudrate degradation
+                         is not allowed.
+                         If the requested BaudRate is not supported, the routine
+                         returns TRUE and the Actual Baud Rate when ActualBaudRate
+                         is not NULL, returns FALSE when ActualBaudRate is NULL.
+
+  @retval TRUE   The UART parameters are valid.
+  @retval FALSE  The UART parameters are not valid.
+**/
+BOOLEAN
+VerifyUartParameters (
+  IN     UINT32                  ClockRate,
+  IN     UINT64                  BaudRate,
+  IN     UINT8                   DataBits,
+  IN     EFI_PARITY_TYPE         Parity,
+  IN     EFI_STOP_BITS_TYPE      StopBits,
+     OUT UINT64                  *Divisor,
+     OUT UINT64                  *ActualBaudRate
+  )
+{
+  UINT64                     Remainder;
+  UINT32                     ComputedBaudRate;
+  UINT64                     ComputedDivisor;
+  UINT64                     Percent;
+
+  if ((DataBits < 5) || (DataBits > 8) ||
+      (Parity < NoParity) || (Parity > SpaceParity) ||
+      (StopBits < OneStopBit) || (StopBits > TwoStopBits) ||
+      ((DataBits == 5) && (StopBits == TwoStopBits)) ||
+      ((DataBits >= 6) && (DataBits <= 8) && (StopBits == OneFiveStopBits))
+      ) {
+    return FALSE;
+  } 
+
+  //
+  // Do not verify the baud rate if clock rate is unknown (0).
+  //
+  if (ClockRate == 0) {
+    return TRUE;
+  }
+
+  //
+  // Compute divisor use to program the baud rate using a round determination
+  // Divisor = ClockRate / 16 / BaudRate = ClockRate / (16 * BaudRate)
+  //         = ClockRate / (BaudRate << 4)
+  //
+  ComputedDivisor = DivU64x64Remainder (ClockRate, LShiftU64 (BaudRate, 4), &Remainder);
+  //
+  // Round Divisor up by 1 if the Remainder is more than half (16 * BaudRate)
+  // BaudRate * 16 / 2 = BaudRate * 8 = (BaudRate << 3)
+  //
+  if (Remainder >= LShiftU64 (BaudRate, 3)) {
+    ComputedDivisor++;
+  }
+  //
+  // If the computed divisor is larger than the maximum value that can be programmed
+  // into the UART, then the requested baud rate can not be supported.
+  //
+  if (ComputedDivisor > MAX_UINT16) {
+    return FALSE;
+  }
+
+  //
+  // If the computed divisor is 0, then use a computed divisor of 1, which will select
+  // the maximum supported baud rate.
+  //
+  if (ComputedDivisor == 0) {
+    ComputedDivisor = 1;
+  }
+
+  //
+  // Actual baud rate that the serial port will be programmed for
+  // should be with in 4% of requested one.
+  //
+  ComputedBaudRate = ClockRate / ((UINT16) ComputedDivisor << 4);
+  if (ComputedBaudRate == 0) {
+    return FALSE;
+  }
+
+  Percent = DivU64x32 (MultU64x32 (BaudRate, 100), ComputedBaudRate);
+  DEBUG ((EFI_D_INFO, "ClockRate = %d\n",  ClockRate));
+  DEBUG ((EFI_D_INFO, "Divisor   = %ld\n", ComputedDivisor));
+  DEBUG ((EFI_D_INFO, "BaudRate/Actual (%ld/%d) = %d%%\n", BaudRate, ComputedBaudRate, Percent));
+
+  //
+  // If the requested BaudRate is not supported:
+  //  Returns TRUE and the Actual Baud Rate when ActualBaudRate is not NULL;
+  //  Returns FALSE when ActualBaudRate is NULL.
+  //
+  if ((Percent >= 96) && (Percent <= 104)) {
+    if (ActualBaudRate != NULL) {
+      *ActualBaudRate = BaudRate;
+    }
+    if (Divisor != NULL) {
+      *Divisor = ComputedDivisor;
+    }
+    return TRUE;
+  }
+  if (ComputedBaudRate < BaudRate) {
+    if (ActualBaudRate != NULL) {
+      *ActualBaudRate = ComputedBaudRate;
+    }
+    if (Divisor != NULL) {
+      *Divisor = ComputedDivisor;
+    }
+    return TRUE;
+  }
+
+  //
+  // ActualBaudRate is higher than requested baud rate and more than 4% 
+  // higher than the requested value.  Increment Divisor if it is less 
+  // than MAX_UINT16 and computed baud rate with new divisor.
+  //
+  if (ComputedDivisor == MAX_UINT16) {
+    return FALSE;
+  }
+  ComputedDivisor++;
+  ComputedBaudRate = ClockRate / ((UINT16) ComputedDivisor << 4);
+  if (ComputedBaudRate == 0) {
+    return FALSE;
+  }
+
+  DEBUG ((EFI_D_INFO, "ClockRate = %d\n",  ClockRate));
+  DEBUG ((EFI_D_INFO, "Divisor   = %ld\n", ComputedDivisor));
+  DEBUG ((EFI_D_INFO, "BaudRate/Actual (%ld/%d) = %d%%\n", BaudRate, ComputedBaudRate, Percent));
+
+  if (ActualBaudRate != NULL) {
+    *ActualBaudRate = ComputedBaudRate;
+  }
+  if (Divisor != NULL) {
+    *Divisor = ComputedDivisor;
+  }
+  return TRUE;
+}
+
+/**
+  Detect whether specific FIFO is full or not.
+
+  @param Fifo    A pointer to the Data Structure SERIAL_DEV_FIFO
+
+  @return whether specific FIFO is full or not
+**/
+BOOLEAN
+SerialFifoFull (
+  IN SERIAL_DEV_FIFO *Fifo
+  )
+{
+  return (BOOLEAN) (((Fifo->Tail + 1) % SERIAL_MAX_FIFO_SIZE) == Fifo->Head);
+}
+
+/**
+  Detect whether specific FIFO is empty or not.
+ 
+  @param  Fifo    A pointer to the Data Structure SERIAL_DEV_FIFO
+
+  @return whether specific FIFO is empty or not
+**/
+BOOLEAN
+SerialFifoEmpty (
+  IN SERIAL_DEV_FIFO *Fifo
+  )
+
+{
+  return (BOOLEAN) (Fifo->Head == Fifo->Tail);
+}
+
+/**
+  Add data to specific FIFO.
+
+  @param Fifo                  A pointer to the Data Structure SERIAL_DEV_FIFO
+  @param Data                  the data added to FIFO
+
+  @retval EFI_SUCCESS           Add data to specific FIFO successfully
+  @retval EFI_OUT_OF_RESOURCE   Failed to add data because FIFO is already full
+**/
+EFI_STATUS
+SerialFifoAdd (
+  IN OUT SERIAL_DEV_FIFO *Fifo,
+  IN     UINT8           Data
+  )
+{
+  //
+  // if FIFO full can not add data
+  //
+  if (SerialFifoFull (Fifo)) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // FIFO is not full can add data
+  //
+  Fifo->Data[Fifo->Tail] = Data;
+  Fifo->Tail = (Fifo->Tail + 1) % SERIAL_MAX_FIFO_SIZE;
+  return EFI_SUCCESS;
+}
+
+/**
+  Remove data from specific FIFO.
+
+  @param Fifo                  A pointer to the Data Structure SERIAL_DEV_FIFO
+  @param Data                  the data removed from FIFO
+
+  @retval EFI_SUCCESS           Remove data from specific FIFO successfully
+  @retval EFI_OUT_OF_RESOURCE   Failed to remove data because FIFO is empty
+
+**/
+EFI_STATUS
+SerialFifoRemove (
+  IN OUT SERIAL_DEV_FIFO *Fifo,
+  OUT    UINT8           *Data
+  )
+{
+  //
+  // if FIFO is empty, no data can remove
+  //
+  if (SerialFifoEmpty (Fifo)) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  //
+  // FIFO is not empty, can remove data
+  //
+  *Data = Fifo->Data[Fifo->Head];
+  Fifo->Head = (Fifo->Head + 1) % SERIAL_MAX_FIFO_SIZE;
+  return EFI_SUCCESS;
+}
+
+/**
+  Reads and writes all avaliable data.
+
+  @param SerialDevice           The device to transmit.
+
+  @retval EFI_SUCCESS           Data was read/written successfully.
+  @retval EFI_OUT_OF_RESOURCE   Failed because software receive FIFO is full.  Note, when
+                                this happens, pending writes are not done.
+
+**/
+EFI_STATUS
+SerialReceiveTransmit (
+  IN SERIAL_DEV *SerialDevice
+  )
+
+{
+  SERIAL_PORT_LSR Lsr;
+  UINT8           Data;
+  BOOLEAN         ReceiveFifoFull;
+  SERIAL_PORT_MSR Msr;
+  SERIAL_PORT_MCR Mcr;
+  UINTN           TimeOut;
+
+  Data = 0;
+
+  //
+  // Begin the read or write
+  //
+  if (SerialDevice->SoftwareLoopbackEnable) {
+    do {
+      ReceiveFifoFull = SerialFifoFull (&SerialDevice->Receive);
+      if (!SerialFifoEmpty (&SerialDevice->Transmit)) {
+        SerialFifoRemove (&SerialDevice->Transmit, &Data);
+        if (ReceiveFifoFull) {
+          return EFI_OUT_OF_RESOURCES;
+        }
+
+        SerialFifoAdd (&SerialDevice->Receive, Data);
+      }
+    } while (!SerialFifoEmpty (&SerialDevice->Transmit));
+  } else {
+    ReceiveFifoFull = SerialFifoFull (&SerialDevice->Receive);
+    //
+    // For full handshake flow control, tell the peer to send data
+    // if receive buffer is available.
+    //
+    if (SerialDevice->HardwareFlowControl &&
+        !FeaturePcdGet(PcdSerialUseHalfHandshake)&&
+        !ReceiveFifoFull
+        ) {
+      Mcr.Data     = READ_MCR (SerialDevice);
+      Mcr.Bits.Rts = 1;
+      WRITE_MCR (SerialDevice, Mcr.Data);
+    }
+    do {
+      Lsr.Data = READ_LSR (SerialDevice);
+
+      //
+      // Flush incomming data to prevent a an overrun during a long write
+      //
+      if ((Lsr.Bits.Dr == 1) && !ReceiveFifoFull) {
+        ReceiveFifoFull = SerialFifoFull (&SerialDevice->Receive);
+        if (!ReceiveFifoFull) {
+          if (Lsr.Bits.FIFOe == 1 || Lsr.Bits.Oe == 1 || Lsr.Bits.Pe == 1 || Lsr.Bits.Fe == 1 || Lsr.Bits.Bi == 1) {
+            REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+              EFI_ERROR_CODE,
+              EFI_P_EC_INPUT_ERROR | EFI_PERIPHERAL_SERIAL_PORT,
+              SerialDevice->DevicePath
+              );
+            if (Lsr.Bits.FIFOe == 1 || Lsr.Bits.Pe == 1|| Lsr.Bits.Fe == 1 || Lsr.Bits.Bi == 1) {
+              Data = READ_RBR (SerialDevice);
+              continue;
+            }
+          }
+
+          Data = READ_RBR (SerialDevice);
+
+          SerialFifoAdd (&SerialDevice->Receive, Data);
+          
+          //
+          // For full handshake flow control, if receive buffer full
+          // tell the peer to stop sending data.
+          //
+          if (SerialDevice->HardwareFlowControl &&
+              !FeaturePcdGet(PcdSerialUseHalfHandshake)   &&
+              SerialFifoFull (&SerialDevice->Receive)
+              ) {
+            Mcr.Data     = READ_MCR (SerialDevice);
+            Mcr.Bits.Rts = 0;
+            WRITE_MCR (SerialDevice, Mcr.Data);
+          }
+
+
+          continue;
+        } else {
+          REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+            EFI_PROGRESS_CODE,
+            EFI_P_SERIAL_PORT_PC_CLEAR_BUFFER | EFI_PERIPHERAL_SERIAL_PORT,
+            SerialDevice->DevicePath
+            );
+        }
+      }
+      //
+      // Do the write
+      //
+      if (Lsr.Bits.Thre == 1 && !SerialFifoEmpty (&SerialDevice->Transmit)) {
+        //
+        // Make sure the transmit data will not be missed
+        //
+        if (SerialDevice->HardwareFlowControl) {
+          //
+          // For half handshake flow control assert RTS before sending.
+          //
+          if (FeaturePcdGet(PcdSerialUseHalfHandshake)) {
+            Mcr.Data     = READ_MCR (SerialDevice);
+            Mcr.Bits.Rts= 0;
+            WRITE_MCR (SerialDevice, Mcr.Data);
+          }
+          //
+          // Wait for CTS
+          //
+          TimeOut   = 0;
+          Msr.Data  = READ_MSR (SerialDevice);
+          while ((Msr.Bits.Dcd == 1) && ((Msr.Bits.Cts == 0) ^ FeaturePcdGet(PcdSerialUseHalfHandshake))) {
+            gBS->Stall (TIMEOUT_STALL_INTERVAL);
+            TimeOut++;
+            if (TimeOut > 5) {
+              break;
+            }
+
+            Msr.Data = READ_MSR (SerialDevice);
+          }
+
+          if ((Msr.Bits.Dcd == 0) || ((Msr.Bits.Cts == 1) ^ FeaturePcdGet(PcdSerialUseHalfHandshake))) {
+            SerialFifoRemove (&SerialDevice->Transmit, &Data);
+            WRITE_THR (SerialDevice, Data);
+          }
+
+          //
+          // For half handshake flow control, tell DCE we are done.
+          //
+          if (FeaturePcdGet(PcdSerialUseHalfHandshake)) {
+            Mcr.Data = READ_MCR (SerialDevice);
+            Mcr.Bits.Rts = 1;
+            WRITE_MCR (SerialDevice, Mcr.Data);
+          }
+        } else {
+          SerialFifoRemove (&SerialDevice->Transmit, &Data);
+          WRITE_THR (SerialDevice, Data);
+        }
+      }
+    } while (Lsr.Bits.Thre == 1 && !SerialFifoEmpty (&SerialDevice->Transmit));
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Flush the serial hardware transmit FIFO and shift register.
+
+  @param SerialDevice  The device to flush.
+**/
+VOID
+SerialFlushTransmitFifo (
+  SERIAL_DEV  *SerialDevice
+  )
+{
+  SERIAL_PORT_LSR  Lsr;
+
+  //
+  // Wait for the serial port to be ready, to make sure both the transmit FIFO
+  // and shift register empty.
+  //
+  do {
+    Lsr.Data = READ_LSR (SerialDevice);
+  } while (Lsr.Bits.Temt == 0);
+}
+
+//
+// Interface Functions
+//
+/**
+  Reset serial device.
+
+  @param This               Pointer to EFI_SERIAL_IO_PROTOCOL
+
+  @retval EFI_SUCCESS        Reset successfully
+  @retval EFI_DEVICE_ERROR   Failed to reset
+
+**/
+EFI_STATUS
+EFIAPI
+SerialReset (
+  IN EFI_SERIAL_IO_PROTOCOL  *This
+  )
+{
+  EFI_STATUS      Status;
+  SERIAL_DEV      *SerialDevice;
+  SERIAL_PORT_LCR Lcr;
+  SERIAL_PORT_IER Ier;
+  SERIAL_PORT_MCR Mcr;
+  SERIAL_PORT_FCR Fcr;
+  EFI_TPL         Tpl;
+  UINT32          Control;
+
+  SerialDevice = SERIAL_DEV_FROM_THIS (This);
+
+  //
+  // Report the status code reset the serial
+  //
+  REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+    EFI_PROGRESS_CODE,
+    EFI_P_PC_RESET | EFI_PERIPHERAL_SERIAL_PORT,
+    SerialDevice->DevicePath
+    );
+
+  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  SerialFlushTransmitFifo (SerialDevice);
+
+  //
+  // Make sure DLAB is 0.
+  //
+  Lcr.Data      = READ_LCR (SerialDevice);
+  Lcr.Bits.DLab = 0;
+  WRITE_LCR (SerialDevice, Lcr.Data);
+
+  //
+  // Turn off all interrupts
+  //
+  Ier.Data        = READ_IER (SerialDevice);
+  Ier.Bits.Ravie  = 0;
+  Ier.Bits.Theie  = 0;
+  Ier.Bits.Rie    = 0;
+  Ier.Bits.Mie    = 0;
+  WRITE_IER (SerialDevice, Ier.Data);
+
+  //
+  // Reset the FIFO
+  //
+  Fcr.Data = 0;
+  Fcr.Bits.TrFIFOE = 0;
+  WRITE_FCR (SerialDevice, Fcr.Data);
+
+  //
+  // Turn off loopback and disable device interrupt.
+  //
+  Mcr.Data      = READ_MCR (SerialDevice);
+  Mcr.Bits.Out1 = 0;
+  Mcr.Bits.Out2 = 0;
+  Mcr.Bits.Lme  = 0;
+  WRITE_MCR (SerialDevice, Mcr.Data);
+
+  //
+  // Clear the scratch pad register
+  //
+  WRITE_SCR (SerialDevice, 0);
+
+  //
+  // Enable FIFO
+  //
+  Fcr.Bits.TrFIFOE  = 1;
+  if (SerialDevice->ReceiveFifoDepth > 16) {
+    Fcr.Bits.TrFIFO64 = 1;
+  }
+  Fcr.Bits.ResetRF  = 1;
+  Fcr.Bits.ResetTF  = 1;
+  WRITE_FCR (SerialDevice, Fcr.Data);
+
+  //
+  // Go set the current attributes
+  //
+  Status = This->SetAttributes (
+                   This,
+                   This->Mode->BaudRate,
+                   This->Mode->ReceiveFifoDepth,
+                   This->Mode->Timeout,
+                   (EFI_PARITY_TYPE) This->Mode->Parity,
+                   (UINT8) This->Mode->DataBits,
+                   (EFI_STOP_BITS_TYPE) This->Mode->StopBits
+                   );
+
+  if (EFI_ERROR (Status)) {
+    gBS->RestoreTPL (Tpl);
+    return EFI_DEVICE_ERROR;
+  }
+  //
+  // Go set the current control bits
+  //
+  Control = 0;
+  if (SerialDevice->HardwareFlowControl) {
+    Control |= EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+  }
+  if (SerialDevice->SoftwareLoopbackEnable) {
+    Control |= EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE;
+  }
+  Status = This->SetControl (
+                   This,
+                   Control
+                   );
+
+  if (EFI_ERROR (Status)) {
+    gBS->RestoreTPL (Tpl);
+    return EFI_DEVICE_ERROR;
+  }
+
+  //
+  // Reset the software FIFO
+  //
+  SerialDevice->Receive.Head = SerialDevice->Receive.Tail = 0;
+  SerialDevice->Transmit.Head = SerialDevice->Transmit.Tail = 0;
+  gBS->RestoreTPL (Tpl);
+
+  //
+  // Device reset is complete
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+  Set new attributes to a serial device.
+
+  @param This                     Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param  BaudRate                 The baudrate of the serial device
+  @param  ReceiveFifoDepth         The depth of receive FIFO buffer
+  @param  Timeout                  The request timeout for a single char
+  @param  Parity                   The type of parity used in serial device
+  @param  DataBits                 Number of databits used in serial device
+  @param  StopBits                 Number of stopbits used in serial device
+
+  @retval  EFI_SUCCESS              The new attributes were set
+  @retval  EFI_INVALID_PARAMETERS   One or more attributes have an unsupported value
+  @retval  EFI_UNSUPPORTED          Data Bits can not set to 5 or 6
+  @retval  EFI_DEVICE_ERROR         The serial device is not functioning correctly (no return)
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetAttributes (
+  IN EFI_SERIAL_IO_PROTOCOL  *This,
+  IN UINT64                  BaudRate,
+  IN UINT32                  ReceiveFifoDepth,
+  IN UINT32                  Timeout,
+  IN EFI_PARITY_TYPE         Parity,
+  IN UINT8                   DataBits,
+  IN EFI_STOP_BITS_TYPE      StopBits
+  )
+{
+  EFI_STATUS                Status;
+  SERIAL_DEV                *SerialDevice;
+  UINT64                    Divisor;
+  SERIAL_PORT_LCR           Lcr;
+  UART_DEVICE_PATH          *Uart;
+  EFI_TPL                   Tpl;
+
+  SerialDevice = SERIAL_DEV_FROM_THIS (This);
+
+  //
+  // Check for default settings and fill in actual values.
+  //
+  if (BaudRate == 0) {
+    BaudRate = PcdGet64 (PcdUartDefaultBaudRate);
+  }
+
+  if (ReceiveFifoDepth == 0) {
+    ReceiveFifoDepth = SerialDevice->ReceiveFifoDepth;
+  }
+
+  if (Timeout == 0) {
+    Timeout = SERIAL_PORT_DEFAULT_TIMEOUT;
+  }
+
+  if (Parity == DefaultParity) {
+    Parity = (EFI_PARITY_TYPE) PcdGet8 (PcdUartDefaultParity);
+  }
+
+  if (DataBits == 0) {
+    DataBits = PcdGet8 (PcdUartDefaultDataBits);
+  }
+
+  if (StopBits == DefaultStopBits) {
+    StopBits = (EFI_STOP_BITS_TYPE) PcdGet8 (PcdUartDefaultStopBits);
+  }
+
+  if (!VerifyUartParameters (SerialDevice->ClockRate, BaudRate, DataBits, Parity, StopBits, &Divisor, &BaudRate)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((ReceiveFifoDepth == 0) || (ReceiveFifoDepth > SerialDevice->ReceiveFifoDepth)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((Timeout < SERIAL_PORT_MIN_TIMEOUT) || (Timeout > SERIAL_PORT_MAX_TIMEOUT)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  SerialFlushTransmitFifo (SerialDevice);
+
+  //
+  // Put serial port on Divisor Latch Mode
+  //
+  Lcr.Data      = READ_LCR (SerialDevice);
+  Lcr.Bits.DLab = 1;
+  WRITE_LCR (SerialDevice, Lcr.Data);
+
+  //
+  // Write the divisor to the serial port
+  //
+  WRITE_DLL (SerialDevice, (UINT8) Divisor);
+  WRITE_DLM (SerialDevice, (UINT8) ((UINT16) Divisor >> 8));
+
+  //
+  // Put serial port back in normal mode and set remaining attributes.
+  //
+  Lcr.Bits.DLab = 0;
+
+  switch (Parity) {
+  case NoParity:
+    Lcr.Bits.ParEn    = 0;
+    Lcr.Bits.EvenPar  = 0;
+    Lcr.Bits.SticPar  = 0;
+    break;
+
+  case EvenParity:
+    Lcr.Bits.ParEn    = 1;
+    Lcr.Bits.EvenPar  = 1;
+    Lcr.Bits.SticPar  = 0;
+    break;
+
+  case OddParity:
+    Lcr.Bits.ParEn    = 1;
+    Lcr.Bits.EvenPar  = 0;
+    Lcr.Bits.SticPar  = 0;
+    break;
+
+  case SpaceParity:
+    Lcr.Bits.ParEn    = 1;
+    Lcr.Bits.EvenPar  = 1;
+    Lcr.Bits.SticPar  = 1;
+    break;
+
+  case MarkParity:
+    Lcr.Bits.ParEn    = 1;
+    Lcr.Bits.EvenPar  = 0;
+    Lcr.Bits.SticPar  = 1;
+    break;
+
+  default:
+    break;
+  }
+
+  switch (StopBits) {
+  case OneStopBit:
+    Lcr.Bits.StopB = 0;
+    break;
+
+  case OneFiveStopBits:
+  case TwoStopBits:
+    Lcr.Bits.StopB = 1;
+    break;
+
+  default:
+    break;
+  }
+  //
+  // DataBits
+  //
+  Lcr.Bits.SerialDB = (UINT8) ((DataBits - 5) & 0x03);
+  WRITE_LCR (SerialDevice, Lcr.Data);
+
+  //
+  // Set the Serial I/O mode
+  //
+  This->Mode->BaudRate          = BaudRate;
+  This->Mode->ReceiveFifoDepth  = ReceiveFifoDepth;
+  This->Mode->Timeout           = Timeout;
+  This->Mode->Parity            = Parity;
+  This->Mode->DataBits          = DataBits;
+  This->Mode->StopBits          = StopBits;
+
+  //
+  // See if Device Path Node has actually changed
+  //
+  if (SerialDevice->UartDevicePath.BaudRate == BaudRate &&
+      SerialDevice->UartDevicePath.DataBits == DataBits &&
+      SerialDevice->UartDevicePath.Parity == Parity &&
+      SerialDevice->UartDevicePath.StopBits == StopBits
+      ) {
+    gBS->RestoreTPL (Tpl);
+    return EFI_SUCCESS;
+  }
+  //
+  // Update the device path
+  //
+  SerialDevice->UartDevicePath.BaudRate = BaudRate;
+  SerialDevice->UartDevicePath.DataBits = DataBits;
+  SerialDevice->UartDevicePath.Parity   = (UINT8) Parity;
+  SerialDevice->UartDevicePath.StopBits = (UINT8) StopBits;
+
+  Status = EFI_SUCCESS;
+  if (SerialDevice->Handle != NULL) {
+
+    //
+    // Skip the optional Controller device path node
+    //
+    Uart = SkipControllerDevicePathNode (
+             (EFI_DEVICE_PATH_PROTOCOL *) (
+               (UINT8 *) SerialDevice->DevicePath + GetDevicePathSize (SerialDevice->ParentDevicePath) - END_DEVICE_PATH_LENGTH
+               ),
+             NULL,
+             NULL
+             );
+    CopyMem (Uart, &SerialDevice->UartDevicePath, sizeof (UART_DEVICE_PATH));
+    Status = gBS->ReinstallProtocolInterface (
+                    SerialDevice->Handle,
+                    &gEfiDevicePathProtocolGuid,
+                    SerialDevice->DevicePath,
+                    SerialDevice->DevicePath
+                    );
+  }
+
+  gBS->RestoreTPL (Tpl);
+
+  return Status;
+}
+
+/**
+  Set Control Bits.
+
+  @param This              Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param Control           Control bits that can be settable
+
+  @retval EFI_SUCCESS       New Control bits were set successfully
+  @retval EFI_UNSUPPORTED   The Control bits wanted to set are not supported
+
+**/
+EFI_STATUS
+EFIAPI
+SerialSetControl (
+  IN EFI_SERIAL_IO_PROTOCOL  *This,
+  IN UINT32                  Control
+  )
+{
+  SERIAL_DEV                    *SerialDevice;
+  SERIAL_PORT_MCR               Mcr;
+  EFI_TPL                       Tpl;
+  UART_FLOW_CONTROL_DEVICE_PATH *FlowControl;
+  EFI_STATUS                    Status;
+
+  //
+  // The control bits that can be set are :
+  //     EFI_SERIAL_DATA_TERMINAL_READY: 0x0001  // WO
+  //     EFI_SERIAL_REQUEST_TO_SEND: 0x0002  // WO
+  //     EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE: 0x1000  // RW
+  //     EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE: 0x2000  // RW
+  //     EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE: 0x4000 // RW
+  //
+  SerialDevice = SERIAL_DEV_FROM_THIS (This);
+
+  //
+  // first determine the parameter is invalid
+  //
+  if ((Control & (~(EFI_SERIAL_REQUEST_TO_SEND | EFI_SERIAL_DATA_TERMINAL_READY |
+                    EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE | EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE |
+                    EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE))) != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Tpl = gBS->RaiseTPL (TPL_NOTIFY);
+
+  Mcr.Data = READ_MCR (SerialDevice);
+  Mcr.Bits.DtrC = 0;
+  Mcr.Bits.Rts = 0;
+  Mcr.Bits.Lme = 0;
+  SerialDevice->SoftwareLoopbackEnable = FALSE;
+  SerialDevice->HardwareFlowControl = FALSE;
+
+  if ((Control & EFI_SERIAL_DATA_TERMINAL_READY) == EFI_SERIAL_DATA_TERMINAL_READY) {
+    Mcr.Bits.DtrC = 1;
+  }
+
+  if ((Control & EFI_SERIAL_REQUEST_TO_SEND) == EFI_SERIAL_REQUEST_TO_SEND) {
+    Mcr.Bits.Rts = 1;
+  }
+
+  if ((Control & EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE) == EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE) {
+    Mcr.Bits.Lme = 1;
+  }
+
+  if ((Control & EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE) == EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE) {
+    SerialDevice->HardwareFlowControl = TRUE;
+  }
+
+  WRITE_MCR (SerialDevice, Mcr.Data);
+
+  if ((Control & EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE) == EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE) {
+    SerialDevice->SoftwareLoopbackEnable = TRUE;
+  }
+
+  Status = EFI_SUCCESS;
+  if (SerialDevice->Handle != NULL) {
+    FlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) (
+                    (UINTN) SerialDevice->DevicePath
+                    + GetDevicePathSize (SerialDevice->ParentDevicePath)
+                    - END_DEVICE_PATH_LENGTH
+                    + sizeof (UART_DEVICE_PATH)
+                    );
+    if (IsUartFlowControlDevicePathNode (FlowControl) &&
+        ((BOOLEAN) (ReadUnaligned32 (&FlowControl->FlowControlMap) == UART_FLOW_CONTROL_HARDWARE) != SerialDevice->HardwareFlowControl)) {
+      //
+      // Flow Control setting is changed, need to reinstall device path protocol
+      //
+      WriteUnaligned32 (&FlowControl->FlowControlMap, SerialDevice->HardwareFlowControl ? UART_FLOW_CONTROL_HARDWARE : 0);
+      Status = gBS->ReinstallProtocolInterface (
+                      SerialDevice->Handle,
+                      &gEfiDevicePathProtocolGuid,
+                      SerialDevice->DevicePath,
+                      SerialDevice->DevicePath
+                      );
+    }
+  }
+
+  gBS->RestoreTPL (Tpl);
+
+  return Status;
+}
+
+/**
+  Get ControlBits.
+
+  @param This          Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param Control       Control signals of the serial device
+
+  @retval EFI_SUCCESS   Get Control signals successfully
+
+**/
+EFI_STATUS
+EFIAPI
+SerialGetControl (
+  IN EFI_SERIAL_IO_PROTOCOL  *This,
+  OUT UINT32                 *Control
+  )
+{
+  SERIAL_DEV      *SerialDevice;
+  SERIAL_PORT_MSR Msr;
+  SERIAL_PORT_MCR Mcr;
+  EFI_TPL         Tpl;
+
+  Tpl           = gBS->RaiseTPL (TPL_NOTIFY);
+
+  SerialDevice  = SERIAL_DEV_FROM_THIS (This);
+
+  *Control      = 0;
+
+  //
+  // Read the Modem Status Register
+  //
+  Msr.Data = READ_MSR (SerialDevice);
+
+  if (Msr.Bits.Cts == 1) {
+    *Control |= EFI_SERIAL_CLEAR_TO_SEND;
+  }
+
+  if (Msr.Bits.Dsr == 1) {
+    *Control |= EFI_SERIAL_DATA_SET_READY;
+  }
+
+  if (Msr.Bits.Ri == 1) {
+    *Control |= EFI_SERIAL_RING_INDICATE;
+  }
+
+  if (Msr.Bits.Dcd == 1) {
+    *Control |= EFI_SERIAL_CARRIER_DETECT;
+  }
+  //
+  // Read the Modem Control Register
+  //
+  Mcr.Data = READ_MCR (SerialDevice);
+
+  if (Mcr.Bits.DtrC == 1) {
+    *Control |= EFI_SERIAL_DATA_TERMINAL_READY;
+  }
+
+  if (Mcr.Bits.Rts == 1) {
+    *Control |= EFI_SERIAL_REQUEST_TO_SEND;
+  }
+
+  if (Mcr.Bits.Lme == 1) {
+    *Control |= EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE;
+  }
+
+  if (SerialDevice->HardwareFlowControl) {
+    *Control |= EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+  }
+  //
+  // Update FIFO status
+  //
+  SerialReceiveTransmit (SerialDevice);
+
+  //
+  // See if the Transmit FIFO is empty
+  //
+  if (SerialFifoEmpty (&SerialDevice->Transmit)) {
+    *Control |= EFI_SERIAL_OUTPUT_BUFFER_EMPTY;
+  }
+
+  //
+  // See if the Receive FIFO is empty.
+  //
+  if (SerialFifoEmpty (&SerialDevice->Receive)) {
+    *Control |= EFI_SERIAL_INPUT_BUFFER_EMPTY;
+  }
+
+  if (SerialDevice->SoftwareLoopbackEnable) {
+    *Control |= EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE;
+  }
+
+  gBS->RestoreTPL (Tpl);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Write the specified number of bytes to serial device.
+
+  @param This               Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param  BufferSize         On input the size of Buffer, on output the amount of
+                       data actually written
+  @param  Buffer             The buffer of data to write
+
+  @retval EFI_SUCCESS        The data were written successfully
+  @retval EFI_DEVICE_ERROR   The device reported an error
+  @retval EFI_TIMEOUT        The write operation was stopped due to timeout
+
+**/
+EFI_STATUS
+EFIAPI
+SerialWrite (
+  IN EFI_SERIAL_IO_PROTOCOL  *This,
+  IN OUT UINTN               *BufferSize,
+  IN VOID                    *Buffer
+  )
+{
+  SERIAL_DEV  *SerialDevice;
+  UINT8       *CharBuffer;
+  UINT32      Index;
+  UINTN       Elapsed;
+  UINTN       ActualWrite;
+  EFI_TPL     Tpl;
+  UINTN       Timeout;
+  UINTN       BitsPerCharacter;
+
+  SerialDevice  = SERIAL_DEV_FROM_THIS (This);
+  Elapsed       = 0;
+  ActualWrite   = 0;
+
+  if (*BufferSize == 0) {
+    return EFI_SUCCESS;
+  }
+
+  if (Buffer == NULL) {
+    REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+      EFI_ERROR_CODE,
+      EFI_P_EC_OUTPUT_ERROR | EFI_PERIPHERAL_SERIAL_PORT,
+      SerialDevice->DevicePath
+      );
+
+    return EFI_DEVICE_ERROR;
+  }
+
+  Tpl         = gBS->RaiseTPL (TPL_NOTIFY);
+
+  CharBuffer  = (UINT8 *) Buffer;
+
+  //
+  // Compute the number of bits in a single character.  This is a start bit,
+  // followed by the number of data bits, followed by the number of stop bits.
+  // The number of stop bits is specified by an enumeration that includes
+  // support for 1.5 stop bits.  Treat 1.5 stop bits as 2 stop bits.
+  //
+  BitsPerCharacter =
+    1 +
+    This->Mode->DataBits +
+    ((This->Mode->StopBits == TwoStopBits) ? 2 : This->Mode->StopBits);
+
+  //
+  // Compute the timeout in microseconds to wait for a single byte to be
+  // transmitted.  The Mode structure contans a Timeout field that is the
+  // maximum time to transmit or receive a character.  However, many UARTs
+  // have a FIFO for transmits, so the time required to add one new character
+  // to the transmit FIFO may be the time required to flush a full FIFO.  If
+  // the Timeout in the Mode structure is smaller than the time required to
+  // flush a full FIFO at the current baud rate, then use a timeout value that
+  // is required to flush a full transmit FIFO.
+  //
+  Timeout = MAX (
+              This->Mode->Timeout,
+              (UINTN)DivU64x64Remainder (
+                BitsPerCharacter * (SerialDevice->TransmitFifoDepth + 1) * 1000000,
+                This->Mode->BaudRate,
+                NULL
+                )
+              );
+  
+  for (Index = 0; Index < *BufferSize; Index++) {
+    SerialFifoAdd (&SerialDevice->Transmit, CharBuffer[Index]);
+
+    while (SerialReceiveTransmit (SerialDevice) != EFI_SUCCESS || !SerialFifoEmpty (&SerialDevice->Transmit)) {
+      //
+      //  Unsuccessful write so check if timeout has expired, if not,
+      //  stall for a bit, increment time elapsed, and try again
+      //
+      if (Elapsed >= Timeout) {
+        *BufferSize = ActualWrite;
+        gBS->RestoreTPL (Tpl);
+        return EFI_TIMEOUT;
+      }
+
+      gBS->Stall (TIMEOUT_STALL_INTERVAL);
+
+      Elapsed += TIMEOUT_STALL_INTERVAL;
+    }
+
+    ActualWrite++;
+    //
+    //  Successful write so reset timeout
+    //
+    Elapsed = 0;
+  }
+
+  gBS->RestoreTPL (Tpl);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Read the specified number of bytes from serial device.
+
+  @param This               Pointer to EFI_SERIAL_IO_PROTOCOL
+  @param BufferSize         On input the size of Buffer, on output the amount of
+                            data returned in buffer
+  @param Buffer             The buffer to return the data into
+
+  @retval EFI_SUCCESS        The data were read successfully
+  @retval EFI_DEVICE_ERROR   The device reported an error
+  @retval EFI_TIMEOUT        The read operation was stopped due to timeout
+
+**/
+EFI_STATUS
+EFIAPI
+SerialRead (
+  IN EFI_SERIAL_IO_PROTOCOL  *This,
+  IN OUT UINTN               *BufferSize,
+  OUT VOID                   *Buffer
+  )
+{
+  SERIAL_DEV  *SerialDevice;
+  UINT32      Index;
+  UINT8       *CharBuffer;
+  UINTN       Elapsed;
+  EFI_STATUS  Status;
+  EFI_TPL     Tpl;
+
+  SerialDevice  = SERIAL_DEV_FROM_THIS (This);
+  Elapsed       = 0;
+
+  if (*BufferSize == 0) {
+    return EFI_SUCCESS;
+  }
+
+  if (Buffer == NULL) {
+    return EFI_DEVICE_ERROR;
+  }
+
+  Tpl     = gBS->RaiseTPL (TPL_NOTIFY);
+
+  Status  = SerialReceiveTransmit (SerialDevice);
+
+  if (EFI_ERROR (Status)) {
+    *BufferSize = 0;
+
+    REPORT_STATUS_CODE_WITH_DEVICE_PATH (
+      EFI_ERROR_CODE,
+      EFI_P_EC_INPUT_ERROR | EFI_PERIPHERAL_SERIAL_PORT,
+      SerialDevice->DevicePath
+      );
+
+    gBS->RestoreTPL (Tpl);
+
+    return EFI_DEVICE_ERROR;
+  }
+
+  CharBuffer = (UINT8 *) Buffer;
+  for (Index = 0; Index < *BufferSize; Index++) {
+    while (SerialFifoRemove (&SerialDevice->Receive, &(CharBuffer[Index])) != EFI_SUCCESS) {
+      //
+      //  Unsuccessful read so check if timeout has expired, if not,
+      //  stall for a bit, increment time elapsed, and try again
+      //  Need this time out to get conspliter to work.
+      //
+      if (Elapsed >= This->Mode->Timeout) {
+        *BufferSize = Index;
+        gBS->RestoreTPL (Tpl);
+        return EFI_TIMEOUT;
+      }
+
+      gBS->Stall (TIMEOUT_STALL_INTERVAL);
+      Elapsed += TIMEOUT_STALL_INTERVAL;
+
+      Status = SerialReceiveTransmit (SerialDevice);
+      if (Status == EFI_DEVICE_ERROR) {
+        *BufferSize = Index;
+        gBS->RestoreTPL (Tpl);
+        return EFI_DEVICE_ERROR;
+      }
+    }
+    //
+    //  Successful read so reset timeout
+    //
+    Elapsed = 0;
+  }
+
+  SerialReceiveTransmit (SerialDevice);
+
+  gBS->RestoreTPL (Tpl);
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Use scratchpad register to test if this serial port is present.
+
+  @param SerialDevice   Pointer to serial device structure
+
+  @return if this serial port is present
+**/
+BOOLEAN
+SerialPresent (
+  IN SERIAL_DEV *SerialDevice
+  )
+
+{
+  UINT8   Temp;
+  BOOLEAN Status;
+
+  Status = TRUE;
+
+  //
+  // Save SCR reg
+  //
+  Temp = READ_SCR (SerialDevice);
+  WRITE_SCR (SerialDevice, 0xAA);
+
+  if (READ_SCR (SerialDevice) != 0xAA) {
+    Status = FALSE;
+  }
+
+  WRITE_SCR (SerialDevice, 0x55);
+
+  if (READ_SCR (SerialDevice) != 0x55) {
+    Status = FALSE;
+  }
+  //
+  // Restore SCR
+  //
+  WRITE_SCR (SerialDevice, Temp);
+  return Status;
+}
+
+/**
+  Read serial port.
+
+  @param SerialDev     Pointer to serial device
+  @param Offset        Offset in register group
+
+  @return Data read from serial port
+
+**/
+UINT8
+SerialReadRegister (
+  IN SERIAL_DEV                            *SerialDev,
+  IN UINT32                                Offset
+  )
+{
+  UINT8                                    Data;
+  EFI_STATUS                               Status;
+
+  if (SerialDev->PciDeviceInfo == NULL) {
+    return IoRead8 ((UINTN) SerialDev->BaseAddress + Offset * SerialDev->RegisterStride);
+  } else {
+    if (SerialDev->MmioAccess) {
+      Status = SerialDev->PciDeviceInfo->PciIo->Mem.Read (SerialDev->PciDeviceInfo->PciIo, EfiPciIoWidthUint8, EFI_PCI_IO_PASS_THROUGH_BAR,
+                                                          SerialDev->BaseAddress + Offset * SerialDev->RegisterStride, 1, &Data);
+    } else {
+      Status = SerialDev->PciDeviceInfo->PciIo->Io.Read (SerialDev->PciDeviceInfo->PciIo, EfiPciIoWidthUint8, EFI_PCI_IO_PASS_THROUGH_BAR,
+                                                         SerialDev->BaseAddress + Offset * SerialDev->RegisterStride, 1, &Data);
+    }
+    ASSERT_EFI_ERROR (Status);
+    return Data;
+  }
+}
+
+/**
+  Write serial port.
+
+  @param  SerialDev     Pointer to serial device
+  @param  Offset        Offset in register group
+  @param  Data          data which is to be written to some serial port register
+**/
+VOID
+SerialWriteRegister (
+  IN SERIAL_DEV                            *SerialDev,
+  IN UINT32                                Offset,
+  IN UINT8                                 Data
+  )
+{
+  EFI_STATUS                               Status;
+
+  if (SerialDev->PciDeviceInfo == NULL) {
+    IoWrite8 ((UINTN) SerialDev->BaseAddress + Offset * SerialDev->RegisterStride, Data);
+  } else {
+    if (SerialDev->MmioAccess) {
+      Status = SerialDev->PciDeviceInfo->PciIo->Mem.Write (SerialDev->PciDeviceInfo->PciIo, EfiPciIoWidthUint8, EFI_PCI_IO_PASS_THROUGH_BAR,
+                                                           SerialDev->BaseAddress + Offset * SerialDev->RegisterStride, 1, &Data);
+    } else {
+      Status = SerialDev->PciDeviceInfo->PciIo->Io.Write (SerialDev->PciDeviceInfo->PciIo, EfiPciIoWidthUint8, EFI_PCI_IO_PASS_THROUGH_BAR,
+                                                          SerialDev->BaseAddress + Offset * SerialDev->RegisterStride, 1, &Data);
+    }
+    ASSERT_EFI_ERROR (Status);
+  }
+}
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 3dfcd6a77f64..38eac142ac79 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -665,6 +665,12 @@
   # @Prompt Enable S3 performance data support.
   gEfiMdeModulePkgTokenSpaceGuid.PcdFirmwarePerformanceDataTableS3Support|TRUE|BOOLEAN|0x00010064
 
+  ## Indicates if Serial device uses half hand shake.<BR><BR>
+  #   TRUE  - Serial device uses half hand shake.<BR>
+  #   FALSE - Serial device doesn't use half hand shake.<BR>
+  # @Prompt Enable Serial device Half Hand Shake
+  gEfiMdeModulePkgTokenSpaceGuid.PcdSerialUseHalfHandshake|FALSE|BOOLEAN|0x00010073
+
 [PcdsFeatureFlag.IA32, PcdsFeatureFlag.X64]
   ## Indicates if DxeIpl should switch to long mode to enter DXE phase.
   #  It is assumed that 64-bit DxeCore is built in firmware if it is true; otherwise 32-bit DxeCore
@@ -950,6 +956,38 @@
   # @Prompt Pci Serial Device Info
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialPciDeviceInfo|{0xFF}|VOID*|0x00010067
 
+  ## PCI Serial Parameters. It is an array of VendorID, DeviceID, ClockRate, Offset,
+  #  BarIndex, RegisterStride, ReceiveFifoDepth, TransmitFifoDepth information that 
+  #  describes the parameters of special PCI serial devices.
+  #  Each array entry is 24-byte in length. The array is terminated
+  #  by an array entry with a PCI Vendor ID of 0xFFFF. If a platform only contains a
+  #  standard 16550 PCI serial device whose class code is 7/0/2, the value is 0xFFFF.
+  #  The C style structure is defined as below:
+  #  typedef struct {
+  #    UINT16  VendorId;          ///< Vendor ID to match the PCI device.  The value 0xFFFF terminates the list of entries.
+  #    UINT16  DeviceId;          ///< Device ID to match the PCI device
+  #    UINT32  ClockRate;         ///< UART clock rate.  Set to 0 for default clock rate of 1843200 Hz
+  #    UINT64  Offset;            ///< The byte offset into to the BAR
+  #    UINT8   BarIndex;          ///< Which BAR to get the UART base address
+  #    UINT8   RegisterStride;    ///< UART register stride in bytes.  Set to 0 for default register stride of 1 byte.
+  #    UINT16  ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
+  #    UINT16  TransmitFifoDepth; ///< UART transmit FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
+  #    UINT8   Reserved[2];
+  #  } PCI_SERIAL_PARAMETER;
+  #  It contains zero or more instances of the above structure.
+  #  For example, if a PCI device contains two UARTs, PcdPciSerialParameters needs
+  #  to contain  two instances of the above structure, with the VendorId and DeviceId
+  #  equals to the Device ID and Vendor ID of the device; If the PCI device uses the
+  #  first two BARs to support two UARTs, BarIndex of first instance equals to 0 and
+  #  BarIndex of second one equals to 1; If the PCI device uses the first BAR to
+  #  support both UARTs, BarIndex of both instance equals to 0, Offset of first
+  #  instance equals to 0 and Offset of second one equals to a value bigger than or
+  #  equal to 8.
+  #  For certain UART whose register needs to be accessed in DWORD aligned address,
+  #  RegisterStride equals to 4.
+  # @Prompt Pci Serial Parameters
+  gEfiMdeModulePkgTokenSpaceGuid.PcdPciSerialParameters|{0xFF, 0xFF}|VOID*|0x00010071
+
   ## Serial Port Extended Transmit FIFO Size.  The default is 64 bytes. 
   # @Prompt Serial Port Extended Transmit FIFO Size in Bytes
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialExtendedTxFifoSize|64|UINT32|0x00010068
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index 602b4bba818f..d8d8885f167d 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -206,6 +206,7 @@
   MdeModulePkg/Application/HelloWorld/HelloWorld.inf
   MdeModulePkg/Application/MemoryProfileInfo/MemoryProfileInfo.inf
 
+  MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf
   MdeModulePkg/Bus/Pci/PciBusDxe/PciBusDxe.inf
   MdeModulePkg/Bus/Pci/IncompatiblePciDeviceSupportDxe/IncompatiblePciDeviceSupportDxe.inf
   MdeModulePkg/Bus/Pci/NvmExpressDxe/NvmExpressDxe.inf

From 09281aceec8e7eb24dab0421134f11fbf8bf9af9 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 10 Dec 2015 07:29:10 +0000
Subject: [PATCH 230/525] ShellPkg/mm: Fix the help message to align to
 implementation and spec

The implementation is already aligned to spec.

(Sync patch r19180 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19208 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib.uni            | Bin 140676 -> 139694 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index e16175a6174fbd08275d14d88eaa385e42ae4781..48ea1e07a369920006a5381c03e0235dff10e42a 100644
GIT binary patch
delta 70
zcmZoU&9Uw<$3&(_jHZoGw?1Y38qHh7punKZ;K|?*q-&<9$1)aAS4d?%vi(*pqZ9k|
ag!znV+wY|_3h_>VV9HpvU9FrkZXE!W5*c6s

delta 569
zcmb`EO-n*S6o$_cQ;9OM4?_}WB?K0zwKOCsFpz{GB2!Abno!s9BM90A{eZ&YK$}3?
zCT&7DMU)WKrv5?ZLRWDKYMGsTEfAtsF)(*#?#wgKd8c?|+PgRDnjibmIJR3mui;zR
z7lts*fdmPNfPhKJK}H+x@N5JEFw5Ux_t4`jPURJ0rp6L((o+caB@x95BZcg!r-cYs
zj4imJ<2nx0-31Pj;zbjkB+)XSh7`9fUlD^eBw>{`B%Z~2HLVE*A^0V+0y6(+seE(M
zMrToGZ257JmM^iB3UzdL#8i2zdeQb@^gdF27%x>Mw02X-jRuDsM%f|2hJt-k+_xeV
zsxeh>v6l{IuJNV8e&rrrm*cM*bL945Kg|?yfXSXVc8cliu+4mRBoS_KRmv$E=txE@
zT_sTOjdOC+kDR`fQ=iVo=d-Y;WvY3$amoj1rulcY8wF_Dw(QN<=pu`g?H{HwR`O?1
GE`9<%caSCk


From 5b2f873d3d5d0d2c65f3ffa6cd459822e9b06619 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 10 Dec 2015 07:30:02 +0000
Subject: [PATCH 231/525] ShellPkg/mm: Fix mm to support multiple root bridge
 platform

In multiple root bridge platforms, different root bridges may
share the same segment but occupy different range of buses,
or may occupy different segments.
The fix is to find the correct root bridge IO instance by
comparing not only the segment but also the bus ranges.
It tries to access the MMIO and IO in the following order:
PciRootBridgeIo, CpuIo and direct IO.

(Sync patch r19181 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19209 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiShellDebug1CommandsLib/Mm.c   | 917 +++++++++---------
 .../UefiShellDebug1CommandsLib.h              |   3 +-
 .../UefiShellDebug1CommandsLib.inf            |   4 +-
 .../UefiShellDebug1CommandsLib.uni            | Bin 139694 -> 139228 bytes
 ShellPkg/ShellPkg.dsc                         |   1 +
 5 files changed, 464 insertions(+), 461 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
index ca64f2c5b022..3f08cc84dc24 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
@@ -2,7 +2,7 @@
   Main file for Mm shell Debug1 function.
 
   (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2005 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -15,16 +15,25 @@
 
 #include "UefiShellDebug1CommandsLib.h"
 #include <Library/ShellLib.h>
+#include <Library/IoLib.h>
 #include <Protocol/PciRootBridgeIo.h>
 #include <Protocol/DeviceIo.h>
 
 typedef enum {
-  EfiMemory,
-  EFIMemoryMappedIo,
-  EfiIo,
-  EfiPciConfig,
-  EfiPciEConfig
-} EFI_ACCESS_TYPE;
+  ShellMmMemory,
+  ShellMmMemoryMappedIo,
+  ShellMmIo,
+  ShellMmPci,
+  ShellMmPciExpress
+} SHELL_MM_ACCESS_TYPE;
+
+CONST UINT16 mShellMmAccessTypeStr[] = {
+  STRING_TOKEN (STR_MM_MEM),
+  STRING_TOKEN (STR_MM_MMIO),
+  STRING_TOKEN (STR_MM_IO),
+  STRING_TOKEN (STR_MM_PCI),
+  STRING_TOKEN (STR_MM_PCIE)
+};
 
 STATIC CONST SHELL_PARAM_ITEM ParamList[] = {
   {L"-mmio", TypeFlag},
@@ -37,161 +46,341 @@ STATIC CONST SHELL_PARAM_ITEM ParamList[] = {
   {NULL, TypeMax}
   };
 
-STATIC CONST UINT64 MaxNum[9]      = { 0xff, 0xffff, 0xffffffff, 0xffffffffffffffffULL };
+CONST UINT64 mShellMmMaxNumber[] = {
+  0, MAX_UINT8, MAX_UINT16, 0, MAX_UINT32, 0, 0, 0, MAX_UINT64
+};
+CONST EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH mShellMmRootBridgeIoWidth[] = {
+  0, EfiPciWidthUint8, EfiPciWidthUint16, 0, EfiPciWidthUint32, 0, 0, 0, EfiPciWidthUint64
+};
+CONST EFI_CPU_IO_PROTOCOL_WIDTH mShellMmCpuIoWidth[] = {
+  0, EfiCpuIoWidthUint8, EfiCpuIoWidthUint16, 0, EfiCpuIoWidthUint32, 0, 0, 0, EfiCpuIoWidthUint64
+};
 
 /**
-  Read some data into a buffer from memory.
-
-  @param[in] Width    The width of each read.
-  @param[in] Addresss The memory location to start reading at.
-  @param[in] Size     The size of Buffer in Width sized units.
-  @param[out] Buffer  The buffer to read into.
+  Extract the PCI segment, bus, device, function, register from
+  from a SHELL_MM_PCI or SHELL_MM_PCIE format of address..
+
+  @param[in]  PciFormat      Whether the address is of PCI format of PCIE format.
+  @param[in]  Address        SHELL_MM_PCI or SHELL_MM_PCIE address.
+  @param[out] Segment        PCI segment number.
+  @param[out] Bus            PCI bus number.
+  @param[out] Device         PCI device number.
+  @param[out] Function       PCI function number.
+  @param[out] Register       PCI register offset.
 **/
 VOID
 EFIAPI
-ReadMem (
-  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
-  IN  UINT64        Address,
-  IN  UINTN         Size,
-  OUT VOID          *Buffer
+ShellMmDecodePciAddress (
+  IN BOOLEAN                PciFormat,
+  IN UINT64                 Address,
+  OUT UINT32                *Segment,
+  OUT UINT8                 *Bus,
+  OUT UINT8                 *Device,   OPTIONAL
+  OUT UINT8                 *Function, OPTIONAL
+  OUT UINT32                *Register  OPTIONAL
   )
 {
-  //
-  // This function is defective.  This ASSERT prevents the defect from affecting anything.
-  //
-  ASSERT(Size == 1);
-  do {
-    if (Width == EfiPciWidthUint8) {
-      *(UINT8 *) Buffer = *(UINT8 *) (UINTN) Address;
-      Address -= 1;
-    } else if (Width == EfiPciWidthUint16) {
-      *(UINT16 *) Buffer = *(UINT16 *) (UINTN) Address;
-      Address -= 2;
-    } else if (Width == EfiPciWidthUint32) {
-      *(UINT32 *) Buffer = *(UINT32 *) (UINTN) Address;
-      Address -= 4;
-    } else if (Width == EfiPciWidthUint64) {
-      *(UINT64 *) Buffer = *(UINT64 *) (UINTN) Address;
-      Address -= 8;
-    } else {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_READ_ERROR), gShellDebug1HiiHandle, L"mm");  
-      break;
+  if (PciFormat) {
+    //
+    // PCI Configuration Space.The address will have the format 0x000000ssbbddffrr,
+    // where ss = Segment, bb = Bus, dd = Device, ff = Function and rr = Register.
+    //
+    *Segment = (UINT32) (RShiftU64 (Address, 32) & 0xFF);
+    *Bus = (UINT8) (((UINT32) Address) >> 24);
+
+    if (Device != NULL) {
+      *Device = (UINT8) (((UINT32) Address) >> 16);
+    }
+    if (Function != NULL) {
+      *Function = (UINT8) (((UINT32) Address) >> 8);
     }
-    Size--;
-  } while (Size > 0);
+    if (Register != NULL) {
+      *Register = (UINT8) Address;
+    }
+  } else {
+    //
+    // PCI Express Configuration Space.The address will have the format 0x0000000ssbbddffrrr,
+    // where ss = Segment, bb = Bus, dd = Device, ff = Function and rrr = Register.
+    //
+    *Segment = (UINT32) (RShiftU64 (Address, 36) & 0xFF);
+    *Bus = (UINT8) RShiftU64 (Address, 28);
+    if (Device != NULL) {
+      *Device = (UINT8) (((UINT32) Address) >> 20);
+    }
+    if (Function != NULL) {
+      *Function = (UINT8) (((UINT32) Address) >> 12);
+    }
+    if (Register != NULL) {
+      *Register = (UINT32) (Address & 0xFFF);
+    }
+  }
 }
 
 /**
-  Write some data to memory.
-
-  @param[in] Width    The width of each write.
-  @param[in] Addresss The memory location to start writing at.
-  @param[in] Size     The size of Buffer in Width sized units.
-  @param[in] Buffer   The buffer to write from.
+  Read or write some data from or into the Address.
+
+  @param[in]      AccessType      Access type.
+  @param[in]      PciRootBridgeIo PciRootBridgeIo instance.
+  @param[in]      CpuIo           CpuIo instance.
+  @param[in]      Read            TRUE for read, FALSE for write.
+  @param[in]      Addresss        The memory location to access.
+  @param[in]      Size            The size of Buffer in Width sized units.
+  @param[in, out] Buffer          The buffer to read into or write from.
 **/
 VOID
-EFIAPI
-WriteMem (
-  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
-  IN  UINT64        Address,
-  IN  UINTN         Size,
-  IN  VOID          *Buffer
+ShellMmAccess (
+  IN     SHELL_MM_ACCESS_TYPE            AccessType,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo,
+  IN     EFI_CPU_IO2_PROTOCOL            *CpuIo,
+  IN     BOOLEAN                         Read,
+  IN     UINT64                          Address,
+  IN     UINTN                           Size,
+  IN OUT VOID                            *Buffer
   )
 {
-  //
-  // This function is defective.  This ASSERT prevents the defect from affecting anything.
-  //
-  ASSERT(Size == 1);
-  do {
-    if (Width == EfiPciWidthUint8) {
-      *(UINT8 *) (UINTN) Address = *(UINT8 *) Buffer;
-      Address += 1;
-    } else if (Width == EfiPciWidthUint16) {
-      *(UINT16 *) (UINTN) Address = *(UINT16 *) Buffer;
-      Address += 2;
-    } else if (Width == EfiPciWidthUint32) {
-      *(UINT32 *) (UINTN) Address = *(UINT32 *) Buffer;
-      Address += 4;
-    } else if (Width == EfiPciWidthUint64) {
-      *(UINT64 *) (UINTN) Address = *(UINT64 *) Buffer;
-      Address += 8;
+  EFI_STATUS                                Status;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_IO_MEM    RootBridgeIoMem;
+  EFI_CPU_IO_PROTOCOL_IO_MEM                CpuIoMem;
+  UINT32                                    Segment;
+  UINT8                                     Bus;
+  UINT8                                     Device;
+  UINT8                                     Function;
+  UINT32                                    Register;
+
+  if (AccessType == ShellMmMemory) {
+    if (Read) {
+      CopyMem (Buffer, (VOID *) (UINTN) Address, Size);
     } else {
+      CopyMem ((VOID *) (UINTN) Address, Buffer, Size);
+    }
+  } else {
+    RootBridgeIoMem = NULL;
+    CpuIoMem = NULL;
+    switch (AccessType) {
+    case ShellMmPci:
+    case ShellMmPciExpress:
+      ASSERT (PciRootBridgeIo != NULL);
+      ShellMmDecodePciAddress ((BOOLEAN) (AccessType == ShellMmPci), Address, &Segment, &Bus, &Device, &Function, &Register);
+      if (Read) {
+        Status = PciRootBridgeIo->Pci.Read (
+          PciRootBridgeIo, mShellMmRootBridgeIoWidth[Size],
+          EFI_PCI_ADDRESS (Bus, Device, Function, Register),
+          1, Buffer
+          );
+      } else {
+        Status = PciRootBridgeIo->Pci.Write (
+          PciRootBridgeIo, mShellMmRootBridgeIoWidth[Size],
+          EFI_PCI_ADDRESS (Bus, Device, Function, Register),
+          1, Buffer
+          );
+      }
+      ASSERT_EFI_ERROR (Status);
+      return;
+
+    case ShellMmMemoryMappedIo:
+      if (PciRootBridgeIo != NULL) {
+        RootBridgeIoMem = Read ? PciRootBridgeIo->Mem.Read : PciRootBridgeIo->Mem.Write;
+      }
+      if (CpuIo != NULL) {
+        CpuIoMem = Read ? CpuIo->Mem.Read : CpuIo->Mem.Write;
+      }
+      break;
+
+    case ShellMmIo:
+      if (PciRootBridgeIo != NULL) {
+        RootBridgeIoMem = Read ? PciRootBridgeIo->Io.Read : PciRootBridgeIo->Io.Write;
+      }
+      if (CpuIo != NULL) {
+        CpuIoMem = Read ? CpuIo->Io.Read : CpuIo->Io.Write;
+      }
+      break;
+    default:
       ASSERT (FALSE);
+      break;
     }
-    //
-    //
-    //
-    Size--;
-  } while (Size > 0);
+
+    Status = EFI_UNSUPPORTED;
+    if (RootBridgeIoMem != NULL) {
+      Status = RootBridgeIoMem (PciRootBridgeIo, mShellMmRootBridgeIoWidth[Size], Address, 1, Buffer);
+    }
+    if (EFI_ERROR (Status) && (CpuIoMem != NULL)) {
+      Status = CpuIoMem (CpuIo, mShellMmCpuIoWidth[Size], Address, 1, Buffer);
+    }
+
+    if (EFI_ERROR (Status)) {
+      if (AccessType == ShellMmIo) {
+        switch (Size) {
+        case 1:
+          if (Read) {
+            *(UINT8 *) Buffer = IoRead8 ((UINTN) Address);
+          } else {
+            IoWrite8 ((UINTN) Address, *(UINT8 *) Buffer);
+          }
+          break;
+        case 2:
+          if (Read) {
+            *(UINT16 *) Buffer = IoRead16 ((UINTN) Address);
+          } else {
+            IoWrite16 ((UINTN) Address, *(UINT16 *) Buffer);
+          }
+          break;
+        case 4:
+          if (Read) {
+            *(UINT32 *) Buffer = IoRead32 ((UINTN) Address);
+          } else {
+            IoWrite32 ((UINTN) Address, *(UINT32 *) Buffer);
+          }
+          break;
+        case 8:
+          if (Read) {
+            *(UINT64 *) Buffer = IoRead64 ((UINTN) Address);
+          } else {
+            IoWrite64 ((UINTN) Address, *(UINT64 *) Buffer);
+          }
+          break;
+        default:
+          ASSERT (FALSE);
+          break;
+        }
+      } else {
+        switch (Size) {
+        case 1:
+          if (Read) {
+            *(UINT8 *) Buffer = MmioRead8 ((UINTN) Address);
+          } else {
+            MmioWrite8 ((UINTN) Address, *(UINT8 *) Buffer);
+          }
+          break;
+        case 2:
+          if (Read) {
+            *(UINT16 *) Buffer = MmioRead16 ((UINTN) Address);
+          } else {
+            MmioWrite16 ((UINTN) Address, *(UINT16 *) Buffer);
+          }
+          break;
+        case 4:
+          if (Read) {
+            *(UINT32 *) Buffer = MmioRead32 ((UINTN) Address);
+          } else {
+            MmioWrite32 ((UINTN) Address, *(UINT32 *) Buffer);
+          }
+          break;
+        case 8:
+          if (Read) {
+            *(UINT64 *) Buffer = MmioRead64 ((UINTN) Address);
+          } else {
+            MmioWrite64 ((UINTN) Address, *(UINT64 *) Buffer);
+          }
+          break;
+        default:
+          ASSERT (FALSE);
+          break;
+        }
+      }
+    }
+  }
 }
 
 /**
-  Convert a string to it's hex data.
+  Find the CpuIo instance and PciRootBridgeIo instance in the platform.
+  If there are multiple PciRootBridgeIo instances, the instance which manages
+  the Address is returned.
 
-  @param[in] str    The pointer to the string of hex data.
-  @param[out] data  The pointer to the buffer to fill.  Valid upon a TRUE return.
+  @param[in]  AccessType      Access type.
+  @param[in]  Address         Address to access.
+  @param[out] CpuIo           Return the CpuIo instance.
+  @param[out] PciRootBridgeIo Return the proper PciRootBridgeIo instance.
 
-  @retval TRUE      The conversion was successful.
-  @retval FALSE     The conversion failed.
+  @retval TRUE  There are PciRootBridgeIo instances in the platform.
+  @retval FALSE There isn't PciRootBridgeIo instance in the platform.
 **/
 BOOLEAN
-EFIAPI
-GetHex (
-  IN  UINT16  *str,
-  OUT UINT64  *data
+ShellMmLocateIoProtocol (
+  IN SHELL_MM_ACCESS_TYPE             AccessType,
+  IN UINT64                           Address,
+  OUT EFI_CPU_IO2_PROTOCOL            **CpuIo,
+  OUT EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL **PciRootBridgeIo
   )
 {
-  UINTN   TempUint;
-  CHAR16  TempChar;
-  BOOLEAN Find;
+  EFI_STATUS                          Status;
+  UINTN                               Index;
+  UINTN                               HandleCount;
+  EFI_HANDLE                          *HandleBuffer;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL     *Io;
+  UINT32                              Segment;
+  UINT8                               Bus;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR   *Descriptors;
+
+  Status = gBS->LocateProtocol (&gEfiCpuIo2ProtocolGuid, NULL, (VOID **) CpuIo);
+  if (EFI_ERROR (Status)) {
+    *CpuIo = NULL;
+  }
+
+  *PciRootBridgeIo = NULL;
+  Status = gBS->LocateHandleBuffer (
+                  ByProtocol,
+                  &gEfiPciRootBridgeIoProtocolGuid,
+                  NULL,
+                  &HandleCount,
+                  &HandleBuffer
+                  );
+  if (EFI_ERROR (Status) || (HandleCount == 0)) {
+    return FALSE;
+  }
+
+  if ((AccessType == ShellMmPci) || (AccessType == ShellMmPciExpress)) {
+    ShellMmDecodePciAddress ((BOOLEAN) (AccessType == ShellMmPci), Address, &Segment, &Bus, NULL, NULL, NULL);
+  }
 
-  Find = FALSE;
   //
-  // convert hex digits
+  // Find the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL of the specified segment & bus number
   //
-  TempUint = 0;
-  TempChar = *(str++);
-  while (TempChar != CHAR_NULL) {
-    if (TempChar >= 'a' && TempChar <= 'f') {
-      TempChar -= 'a' - 'A';
-    }
-
-    if (TempChar == ' ') {
-      break;
+  for (Index = 0; (Index < HandleCount) && (*PciRootBridgeIo == NULL); Index++) {
+    Status = gBS->HandleProtocol (
+                    HandleBuffer[Index],
+                    &gEfiPciRootBridgeIoProtocolGuid,
+                    (VOID *) &Io
+                    );
+    if (EFI_ERROR (Status)) {
+      continue;
     }
 
-    if ((TempChar >= '0' && TempChar <= '9') || (TempChar >= 'A' && TempChar <= 'F')) {
-      TempUint     = (TempUint << 4) | (TempChar - (TempChar >= 'A' ? 'A' - 10 : '0'));
-
-      Find  = TRUE;
-    } else {
-      return FALSE;
+    if ((((AccessType == ShellMmPci) || (AccessType == ShellMmPciExpress)) && (Io->SegmentNumber == Segment)) ||
+        ((AccessType == ShellMmIo) || (AccessType == ShellMmMemoryMappedIo))
+        ) {
+      Status = Io->Configuration (Io, (VOID **) &Descriptors);
+      if (!EFI_ERROR (Status)) {
+        while (Descriptors->Desc != ACPI_END_TAG_DESCRIPTOR) {
+          //
+          // Compare the segment and bus range for PCI/PCIE access
+          //
+          if ((Descriptors->ResType == ACPI_ADDRESS_SPACE_TYPE_BUS) &&
+              ((AccessType == ShellMmPci) || (AccessType == ShellMmPciExpress)) &&
+              ((Bus >= Descriptors->AddrRangeMin) && (Bus <= Descriptors->AddrRangeMax))
+              ) {
+            *PciRootBridgeIo = Io;
+            break;
+
+          //
+          // Compare the address range for MMIO/IO access
+          //
+          } else if ((((Descriptors->ResType == ACPI_ADDRESS_SPACE_TYPE_IO) && (AccessType == ShellMmIo)) ||
+                      ((Descriptors->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) && (AccessType == ShellMmMemoryMappedIo))
+                      ) && ((Address >= Descriptors->AddrRangeMin) && (Address <= Descriptors->AddrRangeMax))
+                     ) {
+            *PciRootBridgeIo = Io;
+            break;
+          }
+          Descriptors++;
+        }
+      }
     }
-
-    TempChar = *(str++);
+  }
+  if (HandleBuffer != NULL) {
+    FreePool (HandleBuffer);
   }
 
-  *data = TempUint;
-  return Find;
-}
-
-/**
-  Get the PCI-E Address from a PCI address format 0x0000ssbbddffrrr
-  where ss is SEGMENT, bb is BUS, dd is DEVICE, ff is FUNCTION
-  and rrr is REGISTER (extension format for PCI-E).
-
-  @param[in] InputAddress       PCI address format on input.
-  @param[out]PciEAddress        PCI-E address extention format.
-**/
-VOID
-EFIAPI
-GetPciEAddressFromInputAddress (
-  IN UINT64                 InputAddress,
-  OUT UINT64                *PciEAddress
-  )
-{
-  *PciEAddress = RShiftU64(InputAddress & ~(UINT64) 0xFFF, 4);
-  *PciEAddress += LShiftU64((UINT16) InputAddress & 0x0FFF, 32);
+  return TRUE;
 }
 
 /**
@@ -207,438 +396,248 @@ ShellCommandRunMm (
   IN EFI_SYSTEM_TABLE  *SystemTable
   )
 {
-  EFI_STATUS                      Status;
-  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *IoDev;
-  UINT64                          Address;
-  UINT64                          PciEAddress;
-  UINT64                          Value;
-  UINT32                          SegmentNumber;
-  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH                    Width;
-  EFI_ACCESS_TYPE                 AccessType;
-  UINT64                          Buffer;
-  UINTN                           Index;
-  UINTN                           Size;
-//  CHAR16                          *ValueStr;
-  BOOLEAN                         Complete;
-  CHAR16                          *InputStr;
-  BOOLEAN                         Interactive;
-  EFI_HANDLE                      *HandleBuffer;
-  UINTN                           BufferSize;
-  UINTN                           ItemValue;
-  LIST_ENTRY                      *Package;
-  CHAR16                          *ProblemParam;
-  SHELL_STATUS                    ShellStatus;
-  CONST CHAR16                    *Temp;
-
-  Value         = 0;
-  Address       = 0;
-  PciEAddress   = 0;
-  IoDev         = NULL;
-  HandleBuffer  = NULL;
-  BufferSize    = 0;
-  SegmentNumber = 0;
-  ShellStatus   = SHELL_SUCCESS;
-  InputStr      = NULL;
+  EFI_STATUS                            Status;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL       *PciRootBridgeIo;
+  EFI_CPU_IO2_PROTOCOL                  *CpuIo;
+  UINT64                                Address;
+  UINT64                                Value;
+  SHELL_MM_ACCESS_TYPE                  AccessType;
+  UINT64                                Buffer;
+  UINTN                                 Index;
+  UINTN                                 Size;
+  BOOLEAN                               Complete;
+  CHAR16                                *InputStr;
+  BOOLEAN                               Interactive;
+  LIST_ENTRY                            *Package;
+  CHAR16                                *ProblemParam;
+  SHELL_STATUS                          ShellStatus;
+  CONST CHAR16                          *Temp;
+  BOOLEAN                               HasPciRootBridgeIo;
+
+  Value = 0;
+  Address = 0;
+  ShellStatus = SHELL_SUCCESS;
+  InputStr = NULL;
+  Size = 1;
+  AccessType = ShellMmMemory;
 
   //
   // Parse arguments
   //
-  Width       = EfiPciWidthUint8;
-  Size        = 1;
-  AccessType  = EfiMemory;
-//  ValueStr    = NULL;
-  Interactive = TRUE;
-  Package     = NULL;
-
   Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);
-  if (EFI_ERROR(Status)) {
+  if (EFI_ERROR (Status)) {
     if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, L"mm", ProblemParam);  
-      FreePool(ProblemParam);
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDebug1HiiHandle, L"mm", ProblemParam);
+      FreePool (ProblemParam);
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
     } else {
-      ASSERT(FALSE);
+      ASSERT (FALSE);
     }
   } else {
-    if (ShellCommandLineGetCount(Package) < 2) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle, L"mm");  
+    if (ShellCommandLineGetCount (Package) < 2) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellDebug1HiiHandle, L"mm");
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
-    } else if (ShellCommandLineGetCount(Package) > 3) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");  
+    } else if (ShellCommandLineGetCount (Package) > 3) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
-    } else if (ShellCommandLineGetFlag(Package, L"-w") && ShellCommandLineGetValue(Package, L"-w") == NULL) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellDebug1HiiHandle, L"mm", L"-w"); 
+    } else if (ShellCommandLineGetFlag (Package, L"-w") && ShellCommandLineGetValue (Package, L"-w") == NULL) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellDebug1HiiHandle, L"mm", L"-w");
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
     } else {
-      if (ShellCommandLineGetFlag(Package, L"-mmio")) {
-        AccessType = EFIMemoryMappedIo;
-        if (ShellCommandLineGetFlag(Package, L"-mem")
-          ||ShellCommandLineGetFlag(Package, L"-io")
-          ||ShellCommandLineGetFlag(Package, L"-pci")
-          ||ShellCommandLineGetFlag(Package, L"-pcie")
-        ){
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");  
+      if (ShellCommandLineGetFlag (Package, L"-mmio")) {
+        AccessType = ShellMmMemoryMappedIo;
+        if (ShellCommandLineGetFlag (Package, L"-mem")
+            || ShellCommandLineGetFlag (Package, L"-io")
+            || ShellCommandLineGetFlag (Package, L"-pci")
+            || ShellCommandLineGetFlag (Package, L"-pcie")
+            ) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");
           ShellStatus = SHELL_INVALID_PARAMETER;
           goto Done;
         }
-      } else if (ShellCommandLineGetFlag(Package, L"-mem")) {
-        AccessType = EfiMemory;
-        if (ShellCommandLineGetFlag(Package, L"-io")
-          ||ShellCommandLineGetFlag(Package, L"-pci")
-          ||ShellCommandLineGetFlag(Package, L"-pcie")
-        ){
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");  
+      } else if (ShellCommandLineGetFlag (Package, L"-mem")) {
+        AccessType = ShellMmMemory;
+        if (ShellCommandLineGetFlag (Package, L"-io")
+            || ShellCommandLineGetFlag (Package, L"-pci")
+            || ShellCommandLineGetFlag (Package, L"-pcie")
+            ) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");
           ShellStatus = SHELL_INVALID_PARAMETER;
           goto Done;
         }
-      } else if (ShellCommandLineGetFlag(Package, L"-io")) {
-        AccessType = EfiIo;
-        if (ShellCommandLineGetFlag(Package, L"-pci")
-          ||ShellCommandLineGetFlag(Package, L"-pcie")
-        ){
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");  
+      } else if (ShellCommandLineGetFlag (Package, L"-io")) {
+        AccessType = ShellMmIo;
+        if (ShellCommandLineGetFlag (Package, L"-pci")
+            || ShellCommandLineGetFlag (Package, L"-pcie")
+            ) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");
           ShellStatus = SHELL_INVALID_PARAMETER;
           goto Done;
         }
-      } else if (ShellCommandLineGetFlag(Package, L"-pci")) {
-        AccessType = EfiPciConfig;
-        if (ShellCommandLineGetFlag(Package, L"-pcie")
-        ){
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");  
+      } else if (ShellCommandLineGetFlag (Package, L"-pci")) {
+        AccessType = ShellMmPci;
+        if (ShellCommandLineGetFlag (Package, L"-pcie")
+            ) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDebug1HiiHandle, L"mm");
           ShellStatus = SHELL_INVALID_PARAMETER;
           goto Done;
         }
-      } else if (ShellCommandLineGetFlag(Package, L"-pcie")) {
-        AccessType = EfiPciEConfig;
+      } else if (ShellCommandLineGetFlag (Package, L"-pcie")) {
+        AccessType = ShellMmPciExpress;
       }
     }
 
     //
     // Non interactive for a script file or for the specific parameter
     //
-    if (gEfiShellProtocol->BatchIsActive() || ShellCommandLineGetFlag (Package, L"-n")) {
+    Interactive = TRUE;
+    if (gEfiShellProtocol->BatchIsActive () || ShellCommandLineGetFlag (Package, L"-n")) {
       Interactive = FALSE;
     }
 
-    Temp = ShellCommandLineGetValue(Package, L"-w");
+    Temp = ShellCommandLineGetValue (Package, L"-w");
     if (Temp != NULL) {
-      ItemValue = ShellStrToUintn (Temp);
-
-      switch (ItemValue) {
-      case 1:
-        Width = EfiPciWidthUint8;
-        Size  = 1;
-        break;
-
-      case 2:
-        Width = EfiPciWidthUint16;
-        Size  = 2;
-        break;
-
-      case 4:
-        Width = EfiPciWidthUint32;
-        Size  = 4;
-        break;
-
-      case 8:
-        Width = EfiPciWidthUint64;
-        Size  = 8;
-        break;
-
-      default:
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM_VAL), gShellDebug1HiiHandle, L"mm", Temp, L"-w");  
-        ShellStatus = SHELL_INVALID_PARAMETER;
-        goto Done;
-      }
+      Size = ShellStrToUintn (Temp);
     }
-
-    Temp = ShellCommandLineGetRawValue(Package, 1);
-    if (!ShellIsHexOrDecimalNumber(Temp, TRUE, FALSE) || EFI_ERROR(ShellConvertStringToUint64(Temp, (UINT64*)&Address, TRUE, FALSE))) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);  
+    if ((Size != 1) && (Size != 2) && (Size != 4) && (Size != 8)) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM_VAL), gShellDebug1HiiHandle, L"mm", Temp, L"-w");
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
     }
 
-    Temp = ShellCommandLineGetRawValue(Package, 2);
-    if (Temp != NULL) {
-      //
-      // Per spec if value is specified, then -n is assumed.
-      //
-      Interactive = FALSE;
-
-      if (!ShellIsHexOrDecimalNumber(Temp, TRUE, FALSE) || EFI_ERROR(ShellConvertStringToUint64(Temp, &Value, TRUE, FALSE))) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);  
-        ShellStatus = SHELL_INVALID_PARAMETER;
-        goto Done;
-      }
-      switch (Size) {
-      case 1:
-        if (Value > 0xFF) {
-          ShellStatus = SHELL_INVALID_PARAMETER;
-        }
-        break;
-
-      case 2:
-        if (Value > 0xFFFF) {
-          ShellStatus = SHELL_INVALID_PARAMETER;
-        }
-        break;
-
-      case 4:
-        if (Value > 0xFFFFFFFF) {
-          ShellStatus = SHELL_INVALID_PARAMETER;
-        }
-        break;
-
-      default:
-        break;
-      }
-
-      if (ShellStatus != SHELL_SUCCESS) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);  
-        ShellStatus = SHELL_INVALID_PARAMETER;
-        goto Done;
-      }
+    Temp = ShellCommandLineGetRawValue (Package, 1);
+    Status = ShellConvertStringToUint64 (Temp, &Address, TRUE, FALSE);
+    if (EFI_ERROR (Status)) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);
+      ShellStatus = SHELL_INVALID_PARAMETER;
+      goto Done;
     }
 
     if ((Address & (Size - 1)) != 0) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_NOT_ALIGNED), gShellDebug1HiiHandle, L"mm", Address);  
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_NOT_ALIGNED), gShellDebug1HiiHandle, L"mm", Address);
+      ShellStatus = SHELL_INVALID_PARAMETER;
+      goto Done;
+    }
+
+    if ((AccessType == ShellMmIo) && (Address + Size > MAX_UINT16 + 1)) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_IO_ADDRESS_RANGE), gShellDebug1HiiHandle, L"mm");
       ShellStatus = SHELL_INVALID_PARAMETER;
       goto Done;
     }
+
     //
-    // locate DeviceIO protocol interface
+    // locate IO protocol interface
     //
-    if (AccessType != EfiMemory) {
-      Status = gBS->LocateHandleBuffer (
-                 ByProtocol,
-                 &gEfiPciRootBridgeIoProtocolGuid,
-                 NULL,
-                 &BufferSize,
-                 &HandleBuffer
-                );
-      if (EFI_ERROR (Status)) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PCIRBIO_NF), gShellDebug1HiiHandle, L"mm");  
+    HasPciRootBridgeIo = ShellMmLocateIoProtocol (AccessType, Address, &CpuIo, &PciRootBridgeIo);
+    if ((AccessType == ShellMmPci) || (AccessType == ShellMmPciExpress)) {
+      if (!HasPciRootBridgeIo) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PCIRBIO_NF), gShellDebug1HiiHandle, L"mm");
         ShellStatus = SHELL_NOT_FOUND;
         goto Done;
       }
-      //
-      // In the case of PCI or PCIE
-      // Get segment number and mask the segment bits in Address
-      //
-      if (AccessType == EfiPciEConfig) {
-        SegmentNumber = (UINT32) RShiftU64 (Address, 36) & 0xff;
-        Address      &= 0xfffffffffULL;
-      } else {
-        if (AccessType == EfiPciConfig) {
-          SegmentNumber = (UINT32) RShiftU64 (Address, 32) & 0xff;
-          Address      &= 0xffffffff;
-        }
-      }
-      //
-      // Find the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL of the specified segment number
-      //
-      for (Index = 0; Index < BufferSize; Index++) {
-        Status = gBS->HandleProtocol (
-                       HandleBuffer[Index],
-                       &gEfiPciRootBridgeIoProtocolGuid,
-                       (VOID *) &IoDev
-                      );
-        if (EFI_ERROR (Status)) {
-          continue;
-        }
-        if (IoDev->SegmentNumber != SegmentNumber) {
-          IoDev = NULL;
-        }
-      }
-      if (IoDev == NULL) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_SEGMENT_NOT_FOUND), gShellDebug1HiiHandle, L"mm", SegmentNumber);  
+      if (PciRootBridgeIo == NULL) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_PCIE_ADDRESS_RANGE), gShellDebug1HiiHandle, L"mm", Address);
         ShellStatus = SHELL_INVALID_PARAMETER;
         goto Done;
       }
     }
 
-    if (AccessType == EfiIo && Address + Size > 0x10000) {
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS_RANGE), gShellDebug1HiiHandle, L"mm");  
-      ShellStatus = SHELL_INVALID_PARAMETER;
-      goto Done;
-    }
-
-    if (AccessType == EfiPciEConfig) {
-      GetPciEAddressFromInputAddress (Address, &PciEAddress);
-    }
-
     //
-    // Set value
+    // Mode 1: Directly set a value
     //
-    if (ShellCommandLineGetRawValue(Package, 2) != NULL) {
-      if (AccessType == EFIMemoryMappedIo) {
-        IoDev->Mem.Write (IoDev, Width, Address, 1, &Value);
-      } else if (AccessType == EfiIo) {
-        IoDev->Io.Write (IoDev, Width, Address, 1, &Value);
-      } else if (AccessType == EfiPciConfig) {
-        IoDev->Pci.Write (IoDev, Width, Address, 1, &Value);
-      } else if (AccessType == EfiPciEConfig) {
-        IoDev->Pci.Write (IoDev, Width, PciEAddress, 1, &Value);
-      } else {
-        WriteMem (Width, Address, 1, &Value);
+    Temp = ShellCommandLineGetRawValue (Package, 2);
+    if (Temp != NULL) {
+      Status = ShellConvertStringToUint64 (Temp, &Value, TRUE, FALSE);
+      if (EFI_ERROR (Status)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);
+        ShellStatus = SHELL_INVALID_PARAMETER;
+        goto Done;
+      }
+
+      if (Value > mShellMmMaxNumber[Size]) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellDebug1HiiHandle, L"mm", Temp);
+        ShellStatus = SHELL_INVALID_PARAMETER;
+        goto Done;
       }
 
-      ASSERT(ShellStatus == SHELL_SUCCESS);
+      ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, FALSE, Address, Size, &Value);
       goto Done;
     }
 
-
     //
-    // non-interactive mode
+    // Mode 2: Directly show a value
     //
     if (!Interactive) {
-      Buffer = 0;
-      if (AccessType == EFIMemoryMappedIo) {
-        if (!gEfiShellProtocol->BatchIsActive()) {
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_MMIO), gShellDebug1HiiHandle);
-        }
-        IoDev->Mem.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiIo) {
-        if (!gEfiShellProtocol->BatchIsActive()) {
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_IO), gShellDebug1HiiHandle);
-        }
-        IoDev->Io.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiPciConfig) {
-        if (!gEfiShellProtocol->BatchIsActive()) {
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_PCI), gShellDebug1HiiHandle);
-        }
-        IoDev->Pci.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiPciEConfig) {
-        if (!gEfiShellProtocol->BatchIsActive()) {
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_PCIE), gShellDebug1HiiHandle);
-        }
-        IoDev->Pci.Read (IoDev, Width, PciEAddress, 1, &Buffer);
-      } else {
-        if (!gEfiShellProtocol->BatchIsActive()) {
-          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_MEM), gShellDebug1HiiHandle);
-        }
-        ReadMem (Width, Address, 1, &Buffer);
-      }
-      if (!gEfiShellProtocol->BatchIsActive()) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS), gShellDebug1HiiHandle, Address);
-      }
-      if (Size == 1) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF2), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 2) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF4), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 4) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF8), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 8) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF16), gShellDebug1HiiHandle, Buffer);
+      if (!gEfiShellProtocol->BatchIsActive ()) {
+        ShellPrintHiiEx (-1, -1, NULL, mShellMmAccessTypeStr[AccessType], gShellDebug1HiiHandle);
       }
+      ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, TRUE, Address, Size, &Buffer);
 
-      ShellPrintEx(-1, -1, L"\r\n");
-
-      ASSERT(ShellStatus == SHELL_SUCCESS);
+      if (!gEfiShellProtocol->BatchIsActive ()) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS), gShellDebug1HiiHandle, Address);
+      }
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_BUF), gShellDebug1HiiHandle, Size * 2, Buffer & mShellMmMaxNumber[Size]);
+      ShellPrintEx (-1, -1, L"\r\n");
       goto Done;
     }
+
     //
-    // interactive mode
+    // Mode 3: Show or set values in interactive mode
     //
     Complete = FALSE;
     do {
-      if (AccessType == EfiIo && Address + Size > 0x10000) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS_RANGE2), gShellDebug1HiiHandle, L"mm");  
+      if ((AccessType == ShellMmIo) && (Address + Size > MAX_UINT16 + 1)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS_RANGE2), gShellDebug1HiiHandle, L"mm");
         break;
       }
 
-      Buffer = 0;
-      if (AccessType == EFIMemoryMappedIo) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_MMIO), gShellDebug1HiiHandle);
-        IoDev->Mem.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiIo) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_IO), gShellDebug1HiiHandle);
-        IoDev->Io.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiPciConfig) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_PCI), gShellDebug1HiiHandle);
-        IoDev->Pci.Read (IoDev, Width, Address, 1, &Buffer);
-      } else if (AccessType == EfiPciEConfig) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_PCIE), gShellDebug1HiiHandle);
-        IoDev->Pci.Read (IoDev, Width, PciEAddress, 1, &Buffer);
-      } else {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_MEM), gShellDebug1HiiHandle);
-        ReadMem (Width, Address, 1, &Buffer);
-      }
-
-      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS), gShellDebug1HiiHandle, Address);
-
-      if (Size == 1) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF2), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 2) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF4), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 4) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF8), gShellDebug1HiiHandle, (UINTN)Buffer);
-      } else if (Size == 8) {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_BUF16), gShellDebug1HiiHandle, Buffer);
-      }
-      ShellPrintEx(-1, -1, L" > ");
+      ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, TRUE, Address, Size, &Buffer);
+      ShellPrintHiiEx (-1, -1, NULL, mShellMmAccessTypeStr[AccessType], gShellDebug1HiiHandle);
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ADDRESS), gShellDebug1HiiHandle, Address);
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_BUF), gShellDebug1HiiHandle, Size * 2, Buffer & mShellMmMaxNumber[Size]);
+      ShellPrintEx (-1, -1, L" > ");
       //
       // wait user input to modify
       //
       if (InputStr != NULL) {
-        FreePool(InputStr);
+        FreePool (InputStr);
         InputStr = NULL;
       }
-      ShellPromptForResponse(ShellPromptResponseTypeFreeform, NULL, (VOID**)&InputStr);
+      ShellPromptForResponse (ShellPromptResponseTypeFreeform, NULL, (VOID**) &InputStr);
 
-      //
-      // skip space characters
-      //
-      for (Index = 0; InputStr != NULL && InputStr[Index] == ' '; Index++);
-
-      //
-      // parse input string
-      //
-      if (InputStr != NULL && (InputStr[Index] == '.' || InputStr[Index] == 'q' || InputStr[Index] == 'Q')) {
-        Complete = TRUE;
-      } else if (InputStr == NULL || InputStr[Index] == CHAR_NULL) {
+      if (InputStr != NULL) {
         //
-        // Continue to next address
+        // skip space characters
         //
-      } else if (GetHex (InputStr + Index, &Buffer) && Buffer <= MaxNum[Width]) {
-        if (AccessType == EFIMemoryMappedIo) {
-          IoDev->Mem.Write (IoDev, Width, Address, 1, &Buffer);
-        } else if (AccessType == EfiIo) {
-          IoDev->Io.Write (IoDev, Width, Address, 1, &Buffer);
-        } else if (AccessType == EfiPciConfig) {
-          IoDev->Pci.Write (IoDev, Width, Address, 1, &Buffer);
-        } else if (AccessType == EfiPciEConfig) {
-          IoDev->Pci.Write (IoDev, Width, PciEAddress, 1, &Buffer);
+        for (Index = 0; InputStr[Index] == ' '; Index++);
+      }
+
+      if ((InputStr != NULL) && (InputStr[Index] != CHAR_NULL)) {
+        if ((InputStr[Index] == '.') || (InputStr[Index] == 'q') || (InputStr[Index] == 'Q')) {
+          Complete = TRUE;
+        } else if (!EFI_ERROR (ShellConvertStringToUint64 (InputStr + Index, &Buffer, TRUE, TRUE)) &&
+                   (Buffer <= mShellMmMaxNumber[Size])
+                   ) {
+          ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, FALSE, Address, Size, &Buffer);
         } else {
-          WriteMem (Width, Address, 1, &Buffer);
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ERROR), gShellDebug1HiiHandle, L"mm");
+          continue;
         }
-      } else {
-        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_MM_ERROR), gShellDebug1HiiHandle, L"mm");  
-        continue;
-  //      PrintToken (STRING_TOKEN (STR_IOMOD_ERROR), HiiHandle);
       }
 
       Address += Size;
-      if (AccessType == EfiPciEConfig) {
-        GetPciEAddressFromInputAddress (Address, &PciEAddress);
-      }
-      ShellPrintEx(-1, -1, L"\r\n");
-  //    Print (L"\n");
+      ShellPrintEx (-1, -1, L"\r\n");
     } while (!Complete);
   }
-  ASSERT(ShellStatus == SHELL_SUCCESS);
-Done:
+  ASSERT (ShellStatus == SHELL_SUCCESS);
 
+Done:
   if (InputStr != NULL) {
-    FreePool(InputStr);
-  }
-  if (HandleBuffer != NULL) {
-    FreePool (HandleBuffer);
+    FreePool (InputStr);
   }
   if (Package != NULL) {
     ShellCommandLineFreeVarList (Package);
diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.h b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.h
index d8755bfefce3..ec15155a0793 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.h
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.h
@@ -1,7 +1,7 @@
 /** @file
   Main file for NULL named library for Profile1 shell command functions.
 
-  Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -38,6 +38,7 @@
 #include <Protocol/DriverFamilyOverride.h>
 #include <Protocol/DriverHealth.h>
 #include <Protocol/SimplePointer.h>
+#include <Protocol/CpuIo2.h>
 #include <Protocol/PciRootBridgeIo.h>
 
 #include <Library/BaseLib.h>
diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf
index 55371eb37194..cfbf001bcb25 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf
@@ -17,7 +17,7 @@
   BASE_NAME                      = UefiShellDebug1CommandsLib
   FILE_GUID                      = 90330D51-A99B-4cc8-A2EB-AE22542A3F45
   MODULE_TYPE                    = UEFI_APPLICATION
-  VERSION_STRING                 = 1.0
+  VERSION_STRING                 = 1.1
   LIBRARY_CLASS                  = NULL|UEFI_APPLICATION UEFI_DRIVER
   CONSTRUCTOR                    = UefiShellDebug1CommandsLibConstructor
   DESTRUCTOR                     = UefiShellDebug1CommandsLibDestructor
@@ -106,6 +106,7 @@
   MemoryAllocationLib
   BaseLib
   BaseMemoryLib
+  IoLib
   DebugLib
   ShellCommandLib
   ShellLib
@@ -125,6 +126,7 @@
   gEfiPciRootBridgeIoProtocolGuid             ## CONSUMES
   gEfiBlockIoProtocolGuid                     ## CONSUMES
   gEfiSimplePointerProtocolGuid               ## CONSUMES
+  gEfiCpuIo2ProtocolGuid                      ## CONSUMES
 
 [Guids]
   gEfiGlobalVariableGuid          ## SOMETIMES_CONSUMES ## GUID
diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index 48ea1e07a369920006a5381c03e0235dff10e42a..2d9bed75c60e9689aab39654f005c2b95690fbb0 100644
GIT binary patch
delta 111
zcmV-#0FeK#!wB5J2(V;Slg?HK0Y#G!RUeaN3^J4GQ$h_O0CoUj0Bith0Av6lmjhe@
zA(y0G0T7Zk8k1mD1OrI`Pm>Q-Ba;e6B9ri1KC_rrG6R$1ARv>#2qKdVSqK3tvwvE3
R0h3@b9D~4Ix4>Kh?!@`vC7A#K

delta 235
zcmcb!pJUx&jtwaxyul2v4DJlRK+=yPWcqw1M#;%+97e*y45<w147orukD-J?fkBla
zWwJeo=;VZWjmZs>3X_AP940@A)Y<$X)QEYq&=iHq2RM|t4Hznb3Jn;H7%C=z3{z!y
zVhCk$V=$S#aE~K1P;N5sLiNc4;cQTG3y?Tmj|D^zCq$1SgV|)m$@XwrAb)dgWGUk$
zQ>n=bAuOyxK=(RM?q4lGd4jvz<PFA3>_tGQCNiW<-|x#PKRLlbrukje_IFW??~VWf
DV&+0w

diff --git a/ShellPkg/ShellPkg.dsc b/ShellPkg/ShellPkg.dsc
index c2ce4f9ab365..c9ed0f8fbafc 100644
--- a/ShellPkg/ShellPkg.dsc
+++ b/ShellPkg/ShellPkg.dsc
@@ -49,6 +49,7 @@
   
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
   BcfgCommandLib|ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.inf
+  IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
 
 [LibraryClasses.ARM]
   #

From e01bbd9f84666a8d0f1d364e7301b99e72ce8f44 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 10 Dec 2015 07:31:17 +0000
Subject: [PATCH 232/525] UefiCpuPkg/UefiCpuPkg.uni: Add
 PcdCpuNumberOfReservedVariableMtrrs

(Sync patch r19182 from main trunk.)

Cc: Shumin Qiu <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19210 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.uni | Bin 21898 -> 22498 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index f7ab84c5a246356d85cba9e5c88b15bd7c5e80fe..542b1cd961caa039fb3bee7125f299a86f67ea72 100644
GIT binary patch
delta 316
zcmeBL&G=|N<A$!#$yHo2=6(#N47m(R45<u74E_vh3_(CvF_>2dBvTl|7!rXpnLsj$
zAqObp%TNO37fs$6Y;KRNSAiiPs9OOjhpJzJp$yFg1)v!rKzo8F3-X1#>M;Z`Bm?bn
zW+(u<1ldGVT=P-PKP3;zCotFGv>WJ0Y;H{h`l1LZ<IfNbBul{|p~s-az{|h|#sI9(
BKw<y@

delta 9
QcmaE~p0R5+<A$zK02hh`SO5S3


From 8cdd99bb2f9628037ca339b273c273a7c7c4cdb5 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 10 Dec 2015 07:31:51 +0000
Subject: [PATCH 233/525] UefiCpuPkg/MtrrLib:Initialize local variables before
 use them

(Sync patch r19183 from main trunk.)

Cc: Shumin Qiu <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19211 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/Library/MtrrLib/MtrrLib.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
index f5b3460f1316..199e165d466a 100644
--- a/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
+++ b/UefiCpuPkg/Library/MtrrLib/MtrrLib.c
@@ -1489,7 +1489,9 @@ MtrrSetMemoryAttributeWorker (
   UINT64                    NewValue;
   MTRR_VARIABLE_SETTINGS    *VariableSettings;
 
-  MtrrContextValid = FALSE;
+  MtrrContextValid  = FALSE;
+  VariableMtrrCount = 0;
+  ZeroMem (&WorkingFixedSettings, sizeof (WorkingFixedSettings));
   for (Index = 0; Index < MTRR_NUMBER_OF_FIXED_MTRR; Index++) {
     FixedSettingsValid[Index]    = FALSE;
     FixedSettingsModified[Index] = FALSE;

From 754840385799645d6be1b589d8e3933471f7cb8a Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Fri, 11 Dec 2015 07:32:28 +0000
Subject: [PATCH 234/525] NetworkPkg: Fix the potential NULL pointer
 dereferenced issue

This patch is used to fix the potential NULL pointer dereferenced
in function 'ParseDnsResponse'.

(Sync patch r19178 from main trunk.)

Cc: Fu Siyuan <siyuan.fu@intel.com>
Cc: Zhang Lubo <lubo.zhang@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19220 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/DnsDxe/DnsImpl.c | 59 ++++++++++++++++++++++++++-----------
 1 file changed, 41 insertions(+), 18 deletions(-)

diff --git a/NetworkPkg/DnsDxe/DnsImpl.c b/NetworkPkg/DnsDxe/DnsImpl.c
index 42d51f0ed7a2..4f7320e403bf 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.c
+++ b/NetworkPkg/DnsDxe/DnsImpl.c
@@ -1199,19 +1199,28 @@ ParseDnsResponse (
   //
   // Check the Query type, do some buffer allocations.
   //
-  if (QuerySection->Type == DNS_TYPE_A) {
-    Dns4TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS_HOST_TO_ADDR_DATA));
-    ASSERT (Dns4TokenEntry->Token->RspData.H2AData != NULL);
-    Dns4TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv4_ADDRESS));
-    ASSERT (Dns4TokenEntry->Token->RspData.H2AData->IpList != NULL);
-  } else if (QuerySection->Type == DNS_TYPE_AAAA) {
-    Dns6TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS6_HOST_TO_ADDR_DATA));
-    ASSERT (Dns6TokenEntry->Token->RspData.H2AData != NULL);
-    Dns6TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv6_ADDRESS));
-    ASSERT (Dns6TokenEntry->Token->RspData.H2AData->IpList != NULL);
+  if (Instance->Service->IpVersion == IP_VERSION_4) {
+    ASSERT (Dns4TokenEntry != NULL);
+    if (QuerySection->Type == DNS_TYPE_A) {
+      Dns4TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS_HOST_TO_ADDR_DATA));
+      ASSERT (Dns4TokenEntry->Token->RspData.H2AData != NULL);
+      Dns4TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv4_ADDRESS));
+      ASSERT (Dns4TokenEntry->Token->RspData.H2AData->IpList != NULL);
+    } else {
+      Status = EFI_UNSUPPORTED;
+      goto ON_EXIT;
+    }
   } else {
-    Status = EFI_UNSUPPORTED;
-    goto ON_EXIT;
+    ASSERT (Dns6TokenEntry != NULL);
+    if (QuerySection->Type == DNS_TYPE_AAAA) {
+      Dns6TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS6_HOST_TO_ADDR_DATA));
+      ASSERT (Dns6TokenEntry->Token->RspData.H2AData != NULL);
+      Dns6TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv6_ADDRESS));
+      ASSERT (Dns6TokenEntry->Token->RspData.H2AData->IpList != NULL);
+    } else {
+      Status = EFI_UNSUPPORTED;
+      goto ON_EXIT;
+    }
   }
 
   //
@@ -1240,7 +1249,7 @@ ParseDnsResponse (
         //
         // This is address entry, get Data.
         //
-        ASSERT (AnswerSection->DataLength == 4);
+        ASSERT (Dns4TokenEntry != NULL && AnswerSection->DataLength == 4);
         
         HostAddr4 = Dns4TokenEntry->Token->RspData.H2AData->IpList;
         AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
@@ -1282,7 +1291,7 @@ ParseDnsResponse (
         //
         // This is address entry, get Data.
         //
-        ASSERT (AnswerSection->DataLength == 16);
+        ASSERT (Dns6TokenEntry != NULL && AnswerSection->DataLength == 16);
         
         HostAddr6 = Dns6TokenEntry->Token->RspData.H2AData->IpList;
         AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
@@ -1333,16 +1342,29 @@ ParseDnsResponse (
     AnswerSectionNum ++;
   }
 
-  if (QuerySection->Type == DNS_TYPE_A) {
-    Dns4TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
-  } else if (QuerySection->Type == DNS_TYPE_AAAA) {
-    Dns6TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+  if (Instance->Service->IpVersion == IP_VERSION_4) {
+    ASSERT (Dns4TokenEntry != NULL);
+    if (QuerySection->Type == DNS_TYPE_A) {
+      Dns4TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+    } else {
+      Status = EFI_UNSUPPORTED;
+      goto ON_EXIT;
+    }
+  } else {
+    ASSERT (Dns6TokenEntry != NULL);
+    if (QuerySection->Type == DNS_TYPE_AAAA) {
+      Dns6TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+    } else {
+      Status = EFI_UNSUPPORTED;
+      goto ON_EXIT;
+    }
   }
 
   //
   // Parsing is complete, SignalEvent here.
   //
   if (Instance->Service->IpVersion == IP_VERSION_4) {
+    ASSERT (Dns4TokenEntry != NULL);
     Dns4RemoveTokenEntry (&Instance->Dns4TxTokens, Dns4TokenEntry);
     Dns4TokenEntry->Token->Status = EFI_SUCCESS;
     if (Dns4TokenEntry->Token->Event != NULL) {
@@ -1350,6 +1372,7 @@ ParseDnsResponse (
       DispatchDpc ();
     }
   } else {
+    ASSERT (Dns6TokenEntry != NULL);
     Dns6RemoveTokenEntry (&Instance->Dns6TxTokens, Dns6TokenEntry);
     Dns6TokenEntry->Token->Status = EFI_SUCCESS;
     if (Dns6TokenEntry->Token->Event != NULL) {

From 540afa672ba3f0236835f8ef7e2030d61e56039e Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 11 Dec 2015 07:33:24 +0000
Subject: [PATCH 235/525] MdePkg UefiScsiLib: Add non-blocking support for SCSI
 Read/Write command

Four new functions are added to UefiScsiLib:
ScsiRead10CommandEx
ScsiWrite10CommandEx
ScsiRead16CommandEx
ScsiWrite16CommandEx

They support both blocking and non-blocking SCSI Read/Write operation
depending on the optional parameter 'Event' passed to those APIs.

When 'Event' is NULL, these four functions will call the non-EX version
couterparts to execute blocking SCSI I/O. When 'Event' is not NULL,
non-blocking I/O operation is executed.

(Sync patch r19214 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19221 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/Library/UefiScsiLib.h       | 360 ++++++++++
 MdePkg/Library/UefiScsiLib/UefiScsiLib.c   | 776 +++++++++++++++++++++
 MdePkg/Library/UefiScsiLib/UefiScsiLib.inf |   4 +-
 3 files changed, 1139 insertions(+), 1 deletion(-)

diff --git a/MdePkg/Include/Library/UefiScsiLib.h b/MdePkg/Include/Library/UefiScsiLib.h
index 26e4aa4e0f02..067acfdb4347 100644
--- a/MdePkg/Include/Library/UefiScsiLib.h
+++ b/MdePkg/Include/Library/UefiScsiLib.h
@@ -818,4 +818,364 @@ ScsiWrite16Command (
   IN     UINT32                SectorSize
   );
 
+
+/**
+  Execute blocking/non-blocking Read(10) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Read(10) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               A pointer to SCSI IO protocol.
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           Read 16 command data.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Read(10) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiRead10CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  );
+
+
+/**
+  Execute blocking/non-blocking Write(10) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Write(10) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               SCSI IO Protocol to use
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           A pointer to a data buffer.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Write(10) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiWrite10CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  );
+
+
+/**
+  Execute blocking/non-blocking Read(16) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Read(16) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               A pointer to SCSI IO protocol.
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           Read 16 command data.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Read(16) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiRead16CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  );
+
+
+/**
+  Execute blocking/non-blocking Write(16) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Write(16) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               SCSI IO Protocol to use
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           A pointer to a data buffer.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Write(16) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiWrite16CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  );
+
 #endif
diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
index 89f261777bb6..d8babcee406a 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
@@ -18,6 +18,8 @@
 #include <Library/DebugLib.h>
 #include <Library/UefiScsiLib.h>
 #include <Library/BaseMemoryLib.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/UefiBootServicesTableLib.h>
   
 #include <IndustryStandard/Scsi.h>
   
@@ -29,6 +31,39 @@
 #define EFI_SCSI_OP_LENGTH_TEN      0xa
 #define EFI_SCSI_OP_LENGTH_SIXTEEN  0x10
 
+//
+// The context structure used when non-blocking SCSI read/write operation
+// completes.
+//
+typedef struct {
+  ///
+  /// The SCSI request packet to send to the SCSI controller specified by
+  /// the device handle.
+  ///
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET      CommandPacket;
+  ///
+  /// The length of the output sense data.
+  ///
+  UINT8                                *SenseDataLength;
+  ///
+  /// The status of the SCSI host adapter.
+  ///
+  UINT8                                *HostAdapterStatus;
+  ///
+  /// The status of the target SCSI device.
+  ///
+  UINT8                                *TargetStatus;
+  ///
+  /// The length of the data buffer for the SCSI read/write command.
+  ///
+  UINT32                               *DataLength;
+  ///
+  /// The caller event to be signaled when the SCSI read/write command
+  /// completes.
+  ///
+  EFI_EVENT                            CallerEvent;
+} EFI_SCSI_LIB_ASYNC_CONTEXT;
+
 
 
 /**
@@ -1249,3 +1284,744 @@ ScsiWrite16Command (
 
   return Status;
 }
+
+
+/**
+  Internal helper notify function in which update the result of the
+  non-blocking SCSI Read/Write commands and signal caller event.
+
+  @param  Event    The instance of EFI_EVENT.
+  @param  Context  The parameter passed in.
+
+**/
+VOID
+EFIAPI
+ScsiLibNotify (
+  IN  EFI_EVENT  Event,
+  IN  VOID       *Context
+  )
+{
+  EFI_SCSI_LIB_ASYNC_CONTEXT      *LibContext;
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET *CommandPacket;
+  EFI_EVENT                       CallerEvent;
+
+  LibContext    = (EFI_SCSI_LIB_ASYNC_CONTEXT *) Context;
+  CommandPacket = &LibContext->CommandPacket;
+  CallerEvent  = LibContext->CallerEvent;
+
+  //
+  // Update SCSI Read/Write operation results
+  //
+  *LibContext->SenseDataLength    = CommandPacket->SenseDataLength;
+  *LibContext->HostAdapterStatus  = CommandPacket->HostAdapterStatus;
+  *LibContext->TargetStatus       = CommandPacket->TargetStatus;
+  if (CommandPacket->InDataBuffer != NULL) {
+    *LibContext->DataLength       = CommandPacket->InTransferLength;
+  } else {
+    *LibContext->DataLength       = CommandPacket->OutTransferLength;
+  }
+
+  if (CommandPacket->Cdb != NULL) {
+    FreePool (CommandPacket->Cdb);
+  }
+  FreePool (Context);
+
+  gBS->CloseEvent (Event);
+  gBS->SignalEvent (CallerEvent);
+}
+
+
+/**
+  Execute blocking/non-blocking Read(10) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Read(10) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               A pointer to SCSI IO protocol.
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           Read 16 command data.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Read(10) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiRead10CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  )
+{
+  EFI_SCSI_LIB_ASYNC_CONTEXT      *Context;
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET *CommandPacket;
+  EFI_STATUS                      Status;
+  UINT8                           *Cdb;
+  EFI_EVENT                       SelfEvent;
+
+  if (Event == NULL) {
+    return ScsiRead10Command (
+             ScsiIo,
+             Timeout,
+             SenseData,
+             SenseDataLength,
+             HostAdapterStatus,
+             TargetStatus,
+             DataBuffer,
+             DataLength,
+             StartLba,
+             SectorSize
+             );
+  }
+
+  ASSERT (SenseDataLength != NULL);
+  ASSERT (HostAdapterStatus != NULL);
+  ASSERT (TargetStatus != NULL);
+  ASSERT (DataLength != NULL);
+  ASSERT (ScsiIo != NULL);
+
+  Context = AllocateZeroPool (sizeof (EFI_SCSI_LIB_ASYNC_CONTEXT));
+  if (Context == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Cdb = AllocateZeroPool (EFI_SCSI_OP_LENGTH_TEN);
+  if (Cdb == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Context->SenseDataLength        = SenseDataLength;
+  Context->HostAdapterStatus      = HostAdapterStatus;
+  Context->TargetStatus           = TargetStatus;
+  Context->CallerEvent            = Event;
+
+  CommandPacket                   = &Context->CommandPacket;
+  CommandPacket->Timeout          = Timeout;
+  CommandPacket->InDataBuffer     = DataBuffer;
+  CommandPacket->SenseData        = SenseData;
+  CommandPacket->InTransferLength = *DataLength;
+  CommandPacket->Cdb              = Cdb;
+  //
+  // Fill Cdb for Read (10) Command
+  //
+  Cdb[0]                          = EFI_SCSI_OP_READ10;
+  WriteUnaligned32 ((UINT32 *)&Cdb[2], SwapBytes32 (StartLba));
+  WriteUnaligned16 ((UINT16 *)&Cdb[7], SwapBytes16 ((UINT16) SectorSize));
+
+  CommandPacket->CdbLength        = EFI_SCSI_OP_LENGTH_TEN;
+  CommandPacket->DataDirection    = EFI_SCSI_DATA_IN;
+  CommandPacket->SenseDataLength  = *SenseDataLength;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiLibNotify,
+                  Context,
+                  &SelfEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+
+ErrorExit:
+  if (Context != NULL) {
+    FreePool (Context);
+  }
+
+  return Status;
+}
+
+
+/**
+  Execute blocking/non-blocking Write(10) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Write(10) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               SCSI IO Protocol to use
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           A pointer to a data buffer.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Write(10) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiWrite10CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  )
+{
+  EFI_SCSI_LIB_ASYNC_CONTEXT      *Context;
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET *CommandPacket;
+  EFI_STATUS                      Status;
+  UINT8                           *Cdb;
+  EFI_EVENT                       SelfEvent;
+
+  if (Event == NULL) {
+    return ScsiWrite10Command (
+             ScsiIo,
+             Timeout,
+             SenseData,
+             SenseDataLength,
+             HostAdapterStatus,
+             TargetStatus,
+             DataBuffer,
+             DataLength,
+             StartLba,
+             SectorSize
+             );
+  }
+
+  ASSERT (SenseDataLength != NULL);
+  ASSERT (HostAdapterStatus != NULL);
+  ASSERT (TargetStatus != NULL);
+  ASSERT (DataLength != NULL);
+  ASSERT (ScsiIo != NULL);
+
+  Context = AllocateZeroPool (sizeof (EFI_SCSI_LIB_ASYNC_CONTEXT));
+  if (Context == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Cdb = AllocateZeroPool (EFI_SCSI_OP_LENGTH_TEN);
+  if (Cdb == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Context->SenseDataLength         = SenseDataLength;
+  Context->HostAdapterStatus       = HostAdapterStatus;
+  Context->TargetStatus            = TargetStatus;
+  Context->CallerEvent             = Event;
+
+  CommandPacket                    = &Context->CommandPacket;
+  CommandPacket->Timeout           = Timeout;
+  CommandPacket->OutDataBuffer     = DataBuffer;
+  CommandPacket->SenseData         = SenseData;
+  CommandPacket->OutTransferLength = *DataLength;
+  CommandPacket->Cdb               = Cdb;
+  //
+  // Fill Cdb for Write (10) Command
+  //
+  Cdb[0]                           = EFI_SCSI_OP_WRITE10;
+  WriteUnaligned32 ((UINT32 *)&Cdb[2], SwapBytes32 (StartLba));
+  WriteUnaligned16 ((UINT16 *)&Cdb[7], SwapBytes16 ((UINT16) SectorSize));
+
+  CommandPacket->CdbLength         = EFI_SCSI_OP_LENGTH_TEN;
+  CommandPacket->DataDirection     = EFI_SCSI_DATA_OUT;
+  CommandPacket->SenseDataLength   = *SenseDataLength;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiLibNotify,
+                  Context,
+                  &SelfEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+
+ErrorExit:
+  if (Context != NULL) {
+    FreePool (Context);
+  }
+
+  return Status;
+}
+
+
+/**
+  Execute blocking/non-blocking Read(16) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Read(16) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               A pointer to SCSI IO protocol.
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           Read 16 command data.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Read(16) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiRead16CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  )
+{
+  EFI_SCSI_LIB_ASYNC_CONTEXT      *Context;
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET *CommandPacket;
+  EFI_STATUS                      Status;
+  UINT8                           *Cdb;
+  EFI_EVENT                       SelfEvent;
+
+  if (Event == NULL) {
+    return ScsiRead16Command (
+             ScsiIo,
+             Timeout,
+             SenseData,
+             SenseDataLength,
+             HostAdapterStatus,
+             TargetStatus,
+             DataBuffer,
+             DataLength,
+             StartLba,
+             SectorSize
+             );
+  }
+
+  ASSERT (SenseDataLength != NULL);
+  ASSERT (HostAdapterStatus != NULL);
+  ASSERT (TargetStatus != NULL);
+  ASSERT (DataLength != NULL);
+  ASSERT (ScsiIo != NULL);
+
+  Context = AllocateZeroPool (sizeof (EFI_SCSI_LIB_ASYNC_CONTEXT));
+  if (Context == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Cdb = AllocateZeroPool (EFI_SCSI_OP_LENGTH_SIXTEEN);
+  if (Cdb == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Context->SenseDataLength        = SenseDataLength;
+  Context->HostAdapterStatus      = HostAdapterStatus;
+  Context->TargetStatus           = TargetStatus;
+  Context->CallerEvent            = Event;
+
+  CommandPacket                   = &Context->CommandPacket;
+  CommandPacket->Timeout          = Timeout;
+  CommandPacket->InDataBuffer     = DataBuffer;
+  CommandPacket->SenseData        = SenseData;
+  CommandPacket->InTransferLength = *DataLength;
+  CommandPacket->Cdb              = Cdb;
+  //
+  // Fill Cdb for Read (16) Command
+  //
+  Cdb[0]                          = EFI_SCSI_OP_READ16;
+  WriteUnaligned64 ((UINT64 *)&Cdb[2], SwapBytes64 (StartLba));
+  WriteUnaligned32 ((UINT32 *)&Cdb[10], SwapBytes32 (SectorSize));
+
+  CommandPacket->CdbLength        = EFI_SCSI_OP_LENGTH_SIXTEEN;
+  CommandPacket->DataDirection    = EFI_SCSI_DATA_IN;
+  CommandPacket->SenseDataLength  = *SenseDataLength;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiLibNotify,
+                  Context,
+                  &SelfEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+
+ErrorExit:
+  if (Context != NULL) {
+    FreePool (Context);
+  }
+
+  return Status;
+}
+
+
+/**
+  Execute blocking/non-blocking Write(16) SCSI command on a specific SCSI
+  target.
+
+  Executes the SCSI Write(16) command on the SCSI target specified by ScsiIo.
+  When Event is NULL, blocking command will be executed. Otherwise non-blocking
+  command will be executed.
+  For blocking I/O, if Timeout is zero, this function will wait indefinitely
+  for the command to complete. If Timeout is greater than zero, then the
+  command is executed and will timeout after Timeout 100 ns units.
+  For non-blocking I/O, if Timeout is zero, Event will be signaled only after
+  the command to completes. If Timeout is greater than zero, Event will also be
+  signaled after Timeout 100 ns units.
+  The StartLba and SectorSize parameters are used to construct the CDB for this
+  SCSI command.
+
+  If ScsiIo is NULL, then ASSERT().
+  If SenseDataLength is NULL, then ASSERT().
+  If HostAdapterStatus is NULL, then ASSERT().
+  If TargetStatus is NULL, then ASSERT().
+  If DataLength is NULL, then ASSERT().
+
+  If SenseDataLength is non-zero and SenseData is not NULL, SenseData must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  If DataLength is non-zero and DataBuffer is not NULL, DataBuffer must meet
+  buffer alignment requirement defined in EFI_SCSI_IO_PROTOCOL. Otherwise
+  EFI_INVALID_PARAMETER gets returned.
+
+  @param[in]      ScsiIo               SCSI IO Protocol to use
+  @param[in]      Timeout              The length of timeout period.
+  @param[in, out] SenseData            A pointer to output sense data.
+  @param[in, out] SenseDataLength      The length of output sense data.
+  @param[out]     HostAdapterStatus    The status of Host Adapter.
+  @param[out]     TargetStatus         The status of the target.
+  @param[in, out] DataBuffer           A pointer to a data buffer.
+  @param[in, out] DataLength           The length of data buffer.
+  @param[in]      StartLba             The start address of LBA.
+  @param[in]      SectorSize           The number of contiguous logical blocks
+                                       of data that shall be transferred.
+  @param[in]      Event                If the SCSI target does not support
+                                       non-blocking I/O, then Event is ignored,
+                                       and blocking I/O is performed. 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 SCSI Write(16) command
+                                       completes.
+
+  @retval  EFI_SUCCESS                 Command is executed successfully.
+  @retval  EFI_BAD_BUFFER_SIZE         The SCSI Request Packet was executed,
+                                       but the entire DataBuffer could not be
+                                       transferred. The actual number of bytes
+                                       transferred is returned in DataLength.
+  @retval  EFI_NOT_READY               The SCSI Request Packet could not be
+                                       sent because there are too many SCSI
+                                       Command Packets already queued.
+  @retval  EFI_DEVICE_ERROR            A device error occurred while attempting
+                                       to send SCSI Request Packet.
+  @retval  EFI_UNSUPPORTED             The command described by the SCSI
+                                       Request Packet is not supported by the
+                                       SCSI initiator(i.e., SCSI  Host
+                                       Controller)
+  @retval  EFI_TIMEOUT                 A timeout occurred while waiting for the
+                                       SCSI Request Packet to execute.
+  @retval  EFI_INVALID_PARAMETER       The contents of the SCSI Request Packet
+                                       are invalid.
+  @retval  EFI_OUT_OF_RESOURCES        The request could not be completed due
+                                       to a lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiWrite16CommandEx (
+  IN     EFI_SCSI_IO_PROTOCOL  *ScsiIo,
+  IN     UINT64                Timeout,
+  IN OUT VOID                  *SenseData,   OPTIONAL
+  IN OUT UINT8                 *SenseDataLength,
+     OUT UINT8                 *HostAdapterStatus,
+     OUT UINT8                 *TargetStatus,
+  IN OUT VOID                  *DataBuffer,  OPTIONAL
+  IN OUT UINT32                *DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorSize,
+  IN     EFI_EVENT             Event         OPTIONAL
+  )
+{
+  EFI_SCSI_LIB_ASYNC_CONTEXT      *Context;
+  EFI_SCSI_IO_SCSI_REQUEST_PACKET *CommandPacket;
+  EFI_STATUS                      Status;
+  UINT8                           *Cdb;
+  EFI_EVENT                       SelfEvent;
+
+  if (Event == NULL) {
+    return ScsiWrite16Command (
+             ScsiIo,
+             Timeout,
+             SenseData,
+             SenseDataLength,
+             HostAdapterStatus,
+             TargetStatus,
+             DataBuffer,
+             DataLength,
+             StartLba,
+             SectorSize
+             );
+  }
+
+  ASSERT (SenseDataLength != NULL);
+  ASSERT (HostAdapterStatus != NULL);
+  ASSERT (TargetStatus != NULL);
+  ASSERT (DataLength != NULL);
+  ASSERT (ScsiIo != NULL);
+
+  Context = AllocateZeroPool (sizeof (EFI_SCSI_LIB_ASYNC_CONTEXT));
+  if (Context == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  Cdb = AllocateZeroPool (EFI_SCSI_OP_LENGTH_SIXTEEN);
+  if (Cdb == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Context->SenseDataLength         = SenseDataLength;
+  Context->HostAdapterStatus       = HostAdapterStatus;
+  Context->TargetStatus            = TargetStatus;
+  Context->CallerEvent             = Event;
+
+  CommandPacket                    = &Context->CommandPacket;
+  CommandPacket->Timeout           = Timeout;
+  CommandPacket->OutDataBuffer     = DataBuffer;
+  CommandPacket->SenseData         = SenseData;
+  CommandPacket->OutTransferLength = *DataLength;
+  CommandPacket->Cdb               = Cdb;
+  //
+  // Fill Cdb for Write (16) Command
+  //
+  Cdb[0]                           = EFI_SCSI_OP_WRITE16;
+  WriteUnaligned64 ((UINT64 *)&Cdb[2], SwapBytes64 (StartLba));
+  WriteUnaligned32 ((UINT32 *)&Cdb[10], SwapBytes32 (SectorSize));
+
+  CommandPacket->CdbLength         = EFI_SCSI_OP_LENGTH_SIXTEEN;
+  CommandPacket->DataDirection     = EFI_SCSI_DATA_OUT;
+  CommandPacket->SenseDataLength   = *SenseDataLength;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiLibNotify,
+                  Context,
+                  &SelfEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+
+ErrorExit:
+  if (Context != NULL) {
+    FreePool (Context);
+  }
+
+  return Status;
+}
diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.inf b/MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
index 1eb90765af42..cd0c5c1ec803 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.inf
@@ -4,7 +4,7 @@
 # This libarary provides the functions to submit Scsi commands defined
 # in SCSI-2 specification for scsi device.
 #
-# Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -42,4 +42,6 @@
   BaseMemoryLib
   DebugLib
   BaseLib
+  MemoryAllocationLib
+  UefiBootServicesTableLib
 

From 6a14da57ac9737d268ee6abe156008b862146ef9 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 11 Dec 2015 07:34:34 +0000
Subject: [PATCH 236/525] MdeModulePkg ScsiDiskDxe: Add BlockIO2 Support

Together with EFI_BLOCK_IO_PROTOCOL, EFI_BLOCK_IO2_PROTOCOL is installed
as well in ScsiDiskDxe.

Block I/O 2 functions are implemented:
Reset
ReadBlocksEx
WriteBlocksEx
FlushBlocksEx

(Sync patch r19215 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19222 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Bus/Scsi/ScsiDiskDxe/ComponentName.c      |    4 +-
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c  | 1436 ++++++++++++++++-
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h  |  335 +++-
 .../Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf      |    6 +-
 4 files changed, 1767 insertions(+), 14 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ComponentName.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ComponentName.c
index 17908258029c..08b71d08f36b 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ComponentName.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ComponentName.c
@@ -1,7 +1,7 @@
 /** @file
   UEFI Component Name(2) protocol implementation for SCSI disk driver.
 
-Copyright (c) 2004 - 2011, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -211,7 +211,7 @@ ScsiDiskComponentNameGetControllerName (
     return Status;
   }
 
-  ScsiDiskDevice = SCSI_DISK_DEV_FROM_THIS (BlockIo);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO (BlockIo);
 
   return LookupUnicodeString2 (
            Language,
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index e7abe544df58..d83fa24a4fe0 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -239,7 +239,13 @@ ScsiDiskDriverBindingStart (
   ScsiDiskDevice->BlkIo.ReadBlocks     = ScsiDiskReadBlocks;
   ScsiDiskDevice->BlkIo.WriteBlocks    = ScsiDiskWriteBlocks;
   ScsiDiskDevice->BlkIo.FlushBlocks    = ScsiDiskFlushBlocks;
+  ScsiDiskDevice->BlkIo2.Media         = &ScsiDiskDevice->BlkIoMedia;
+  ScsiDiskDevice->BlkIo2.Reset         = ScsiDiskResetEx;
+  ScsiDiskDevice->BlkIo2.ReadBlocksEx  = ScsiDiskReadBlocksEx;
+  ScsiDiskDevice->BlkIo2.WriteBlocksEx = ScsiDiskWriteBlocksEx;
+  ScsiDiskDevice->BlkIo2.FlushBlocksEx = ScsiDiskFlushBlocksEx;
   ScsiDiskDevice->Handle               = Controller;
+  InitializeListHead (&ScsiDiskDevice->BlkIo2Queue);
 
   ScsiIo->GetDeviceType (ScsiIo, &(ScsiDiskDevice->DeviceType));
   switch (ScsiDiskDevice->DeviceType) {
@@ -300,7 +306,8 @@ ScsiDiskDriverBindingStart (
   Status = ScsiDiskDetectMedia (ScsiDiskDevice, MustReadCapacity, &Temp);
   if (!EFI_ERROR (Status)) {
     //
-    // Determine if Block IO should be produced on this controller handle
+    // Determine if Block IO & Block IO2 should be produced on this controller
+    // handle
     //
     if (DetermineInstallBlockIo(Controller)) {
       InitializeInstallDiskInfo(ScsiDiskDevice, Controller);
@@ -308,6 +315,8 @@ ScsiDiskDriverBindingStart (
                       &Controller,
                       &gEfiBlockIoProtocolGuid,
                       &ScsiDiskDevice->BlkIo,
+                      &gEfiBlockIo2ProtocolGuid,
+                      &ScsiDiskDevice->BlkIo2,
                       &gEfiDiskInfoProtocolGuid,
                       &ScsiDiskDevice->DiskInfo,
                       NULL
@@ -390,11 +399,19 @@ ScsiDiskDriverBindingStop (
     return Status;
   }
 
-  ScsiDiskDevice = SCSI_DISK_DEV_FROM_THIS (BlkIo);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO (BlkIo);
+
+  //
+  // Wait for the BlockIo2 requests queue to become empty
+  //
+  while (!IsListEmpty (&ScsiDiskDevice->BlkIo2Queue));
+
   Status = gBS->UninstallMultipleProtocolInterfaces (
                   Controller,
                   &gEfiBlockIoProtocolGuid,
                   &ScsiDiskDevice->BlkIo,
+                  &gEfiBlockIo2ProtocolGuid,
+                  &ScsiDiskDevice->BlkIo2,
                   &gEfiDiskInfoProtocolGuid,
                   &ScsiDiskDevice->DiskInfo,
                   NULL
@@ -443,7 +460,7 @@ ScsiDiskReset (
 
   OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
 
-  ScsiDiskDevice  = SCSI_DISK_DEV_FROM_THIS (This);
+  ScsiDiskDevice  = SCSI_DISK_DEV_FROM_BLKIO (This);
 
   Status          = ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);
 
@@ -505,7 +522,7 @@ ScsiDiskReadBlocks (
 
   MediaChange    = FALSE;
   OldTpl         = gBS->RaiseTPL (TPL_CALLBACK);
-  ScsiDiskDevice = SCSI_DISK_DEV_FROM_THIS (This);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO (This);
 
   if (!IS_DEVICE_FIXED(ScsiDiskDevice)) {
 
@@ -522,6 +539,12 @@ ScsiDiskReadBlocks (
             &ScsiDiskDevice->BlkIo,
             &ScsiDiskDevice->BlkIo
             );
+      gBS->ReinstallProtocolInterface (
+             ScsiDiskDevice->Handle,
+             &gEfiBlockIo2ProtocolGuid,
+             &ScsiDiskDevice->BlkIo2,
+             &ScsiDiskDevice->BlkIo2
+             );
       Status = EFI_MEDIA_CHANGED;
       goto Done;
     }
@@ -623,7 +646,7 @@ ScsiDiskWriteBlocks (
 
   MediaChange    = FALSE;
   OldTpl         = gBS->RaiseTPL (TPL_CALLBACK);
-  ScsiDiskDevice = SCSI_DISK_DEV_FROM_THIS (This);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO (This);
 
   if (!IS_DEVICE_FIXED(ScsiDiskDevice)) {
 
@@ -640,6 +663,12 @@ ScsiDiskWriteBlocks (
             &ScsiDiskDevice->BlkIo,
             &ScsiDiskDevice->BlkIo
             );
+      gBS->ReinstallProtocolInterface (
+             ScsiDiskDevice->Handle,
+             &gEfiBlockIo2ProtocolGuid,
+             &ScsiDiskDevice->BlkIo2,
+             &ScsiDiskDevice->BlkIo2
+             );
       Status = EFI_MEDIA_CHANGED;
       goto Done;
     }
@@ -725,6 +754,392 @@ ScsiDiskFlushBlocks (
 }
 
 
+/**
+  Reset SCSI Disk.
+
+  @param  This                 The pointer of EFI_BLOCK_IO2_PROTOCOL.
+  @param  ExtendedVerification The flag about if extend verificate.
+
+  @retval EFI_SUCCESS          The device was reset.
+  @retval EFI_DEVICE_ERROR     The device is not functioning properly and could
+                               not be reset.
+  @return EFI_STATUS is returned from EFI_SCSI_IO_PROTOCOL.ResetDevice().
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskResetEx (
+  IN  EFI_BLOCK_IO2_PROTOCOL  *This,
+  IN  BOOLEAN                 ExtendedVerification
+  )
+{
+  EFI_TPL       OldTpl;
+  SCSI_DISK_DEV *ScsiDiskDevice;
+  EFI_STATUS    Status;
+
+  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+
+  ScsiDiskDevice  = SCSI_DISK_DEV_FROM_BLKIO2 (This);
+
+  Status          = ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);
+
+  if (EFI_ERROR (Status)) {
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
+  }
+
+  if (!ExtendedVerification) {
+    goto Done;
+  }
+
+  Status = ScsiDiskDevice->ScsiIo->ResetBus (ScsiDiskDevice->ScsiIo);
+
+  if (EFI_ERROR (Status)) {
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
+  }
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+}
+
+/**
+  The function is to Read Block from SCSI Disk.
+
+  @param  This       The pointer of EFI_BLOCK_IO_PROTOCOL.
+  @param  MediaId    The Id of Media detected.
+  @param  Lba        The logic block address.
+  @param  Token      A pointer to the token associated with the transaction.
+  @param  BufferSize The size of Buffer.
+  @param  Buffer     The buffer to fill the read out data.
+
+  @retval EFI_SUCCESS           The read request was queued if Token-> Event is
+                                not NULL. The data was read correctly from the
+                                device if theToken-> Event is NULL.
+  @retval EFI_DEVICE_ERROR      The device reported an error while attempting
+                                to perform the read operation.
+  @retval EFI_NO_MEDIA          There is no media in the device.
+  @retval EFI_MEDIA_CHANGED     The MediaId is not for the current media.
+  @retval EFI_BAD_BUFFER_SIZE   The BufferSize parameter is not a multiple of
+                                the intrinsic block size of the device.
+  @retval EFI_INVALID_PARAMETER The read request contains LBAs that are not
+                                valid, or the buffer is not on proper
+                                alignment.
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskReadBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL   *This,
+  IN     UINT32                   MediaId,
+  IN     EFI_LBA                  Lba,
+  IN OUT EFI_BLOCK_IO2_TOKEN      *Token,
+  IN     UINTN                    BufferSize,
+  OUT    VOID                     *Buffer
+  )
+{
+  SCSI_DISK_DEV       *ScsiDiskDevice;
+  EFI_BLOCK_IO_MEDIA  *Media;
+  EFI_STATUS          Status;
+  UINTN               BlockSize;
+  UINTN               NumberOfBlocks;
+  BOOLEAN             MediaChange;
+  EFI_TPL             OldTpl;
+
+  MediaChange    = FALSE;
+  OldTpl         = gBS->RaiseTPL (TPL_CALLBACK);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO2 (This);
+
+  if (!IS_DEVICE_FIXED(ScsiDiskDevice)) {
+
+    Status = ScsiDiskDetectMedia (ScsiDiskDevice, FALSE, &MediaChange);
+    if (EFI_ERROR (Status)) {
+      Status = EFI_DEVICE_ERROR;
+      goto Done;
+    }
+
+    if (MediaChange) {
+      gBS->ReinstallProtocolInterface (
+            ScsiDiskDevice->Handle,
+            &gEfiBlockIoProtocolGuid,
+            &ScsiDiskDevice->BlkIo,
+            &ScsiDiskDevice->BlkIo
+            );
+      gBS->ReinstallProtocolInterface (
+             ScsiDiskDevice->Handle,
+             &gEfiBlockIo2ProtocolGuid,
+             &ScsiDiskDevice->BlkIo2,
+             &ScsiDiskDevice->BlkIo2
+             );
+      Status = EFI_MEDIA_CHANGED;
+      goto Done;
+    }
+  }
+  //
+  // Get the intrinsic block size
+  //
+  Media           = ScsiDiskDevice->BlkIo2.Media;
+  BlockSize       = Media->BlockSize;
+
+  NumberOfBlocks  = BufferSize / BlockSize;
+
+  if (!(Media->MediaPresent)) {
+    Status = EFI_NO_MEDIA;
+    goto Done;
+  }
+
+  if (MediaId != Media->MediaId) {
+    Status = EFI_MEDIA_CHANGED;
+    goto Done;
+  }
+
+  if (Buffer == NULL) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if (BufferSize == 0) {
+    if ((Token != NULL) && (Token->Event != NULL)) {
+      Token->TransactionStatus = EFI_SUCCESS;
+      gBS->SignalEvent (Token->Event);
+    }
+
+    Status = EFI_SUCCESS;
+    goto Done;
+  }
+
+  if (BufferSize % BlockSize != 0) {
+    Status = EFI_BAD_BUFFER_SIZE;
+    goto Done;
+  }
+
+  if (Lba > Media->LastBlock) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if ((Lba + NumberOfBlocks - 1) > Media->LastBlock) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if ((Media->IoAlign > 1) && (((UINTN) Buffer & (Media->IoAlign - 1)) != 0)) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  //
+  // If all the parameters are valid, then perform read sectors command
+  // to transfer data from device to host.
+  //
+  if ((Token != NULL) && (Token->Event != NULL)) {
+    Token->TransactionStatus = EFI_SUCCESS;
+    Status = ScsiDiskAsyncReadSectors (
+               ScsiDiskDevice,
+               Buffer,
+               Lba,
+               NumberOfBlocks,
+               Token
+               );
+  } else {
+    Status = ScsiDiskReadSectors (
+               ScsiDiskDevice,
+               Buffer,
+               Lba,
+               NumberOfBlocks
+               );
+  }
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+}
+
+/**
+  The function is to Write Block to SCSI Disk.
+
+  @param  This       The pointer of EFI_BLOCK_IO_PROTOCOL.
+  @param  MediaId    The Id of Media detected.
+  @param  Lba        The logic block address.
+  @param  Token      A pointer to the token associated with the transaction.
+  @param  BufferSize The size of Buffer.
+  @param  Buffer     The buffer to fill the read out data.
+
+  @retval EFI_SUCCESS           The data were written correctly to the device.
+  @retval EFI_WRITE_PROTECTED   The device cannot be written to.
+  @retval EFI_NO_MEDIA          There is no media in the device.
+  @retval EFI_MEDIA_CHANGED     The MediaId is not for the current media.
+  @retval EFI_DEVICE_ERROR      The device reported an error while attempting
+                                to perform the write operation.
+  @retval EFI_BAD_BUFFER_SIZE   The BufferSize parameter is not a multiple of
+                                the intrinsic block size of the device.
+  @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not
+                                valid, or the buffer is not on proper
+                                alignment.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskWriteBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL *This,
+  IN     UINT32                 MediaId,
+  IN     EFI_LBA                Lba,
+  IN OUT EFI_BLOCK_IO2_TOKEN    *Token,
+  IN     UINTN                  BufferSize,
+  IN     VOID                   *Buffer
+  )
+{
+  SCSI_DISK_DEV       *ScsiDiskDevice;
+  EFI_BLOCK_IO_MEDIA  *Media;
+  EFI_STATUS          Status;
+  UINTN               BlockSize;
+  UINTN               NumberOfBlocks;
+  BOOLEAN             MediaChange;
+  EFI_TPL             OldTpl;
+
+  MediaChange    = FALSE;
+  OldTpl         = gBS->RaiseTPL (TPL_CALLBACK);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO2 (This);
+
+  if (!IS_DEVICE_FIXED(ScsiDiskDevice)) {
+
+    Status = ScsiDiskDetectMedia (ScsiDiskDevice, FALSE, &MediaChange);
+    if (EFI_ERROR (Status)) {
+      Status = EFI_DEVICE_ERROR;
+      goto Done;
+    }
+
+    if (MediaChange) {
+      gBS->ReinstallProtocolInterface (
+            ScsiDiskDevice->Handle,
+            &gEfiBlockIoProtocolGuid,
+            &ScsiDiskDevice->BlkIo,
+            &ScsiDiskDevice->BlkIo
+            );
+      gBS->ReinstallProtocolInterface (
+             ScsiDiskDevice->Handle,
+             &gEfiBlockIo2ProtocolGuid,
+             &ScsiDiskDevice->BlkIo2,
+             &ScsiDiskDevice->BlkIo2
+             );
+      Status = EFI_MEDIA_CHANGED;
+      goto Done;
+    }
+  }
+  //
+  // Get the intrinsic block size
+  //
+  Media           = ScsiDiskDevice->BlkIo2.Media;
+  BlockSize       = Media->BlockSize;
+
+  NumberOfBlocks  = BufferSize / BlockSize;
+
+  if (!(Media->MediaPresent)) {
+    Status = EFI_NO_MEDIA;
+    goto Done;
+  }
+
+  if (MediaId != Media->MediaId) {
+    Status = EFI_MEDIA_CHANGED;
+    goto Done;
+  }
+
+  if (BufferSize == 0) {
+    if ((Token != NULL) && (Token->Event != NULL)) {
+      Token->TransactionStatus = EFI_SUCCESS;
+      gBS->SignalEvent (Token->Event);
+    }
+
+    Status = EFI_SUCCESS;
+    goto Done;
+  }
+
+  if (Buffer == NULL) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if (BufferSize % BlockSize != 0) {
+    Status = EFI_BAD_BUFFER_SIZE;
+    goto Done;
+  }
+
+  if (Lba > Media->LastBlock) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if ((Lba + NumberOfBlocks - 1) > Media->LastBlock) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  if ((Media->IoAlign > 1) && (((UINTN) Buffer & (Media->IoAlign - 1)) != 0)) {
+    Status = EFI_INVALID_PARAMETER;
+    goto Done;
+  }
+
+  //
+  // if all the parameters are valid, then perform write sectors command
+  // to transfer data from device to host.
+  //
+  if ((Token != NULL) && (Token->Event != NULL)) {
+    Token->TransactionStatus = EFI_SUCCESS;
+    Status = ScsiDiskAsyncWriteSectors (
+               ScsiDiskDevice,
+               Buffer,
+               Lba,
+               NumberOfBlocks,
+               Token
+               );
+  } else {
+    Status = ScsiDiskWriteSectors (
+               ScsiDiskDevice,
+               Buffer,
+               Lba,
+               NumberOfBlocks
+               );
+  }
+
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
+}
+
+/**
+  Flush the Block Device.
+
+  @param  This       Indicates a pointer to the calling context.
+  @param  Token      A pointer to the token associated with the transaction.
+
+  @retval EFI_SUCCESS       All outstanding data was written to the device.
+  @retval EFI_DEVICE_ERROR  The device reported an error while writing back the
+                            data.
+  @retval EFI_NO_MEDIA      There is no media in the device.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskFlushBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL  *This,
+  IN OUT EFI_BLOCK_IO2_TOKEN     *Token
+  )
+{
+  //
+  // Signal event and return directly.
+  //
+  if ((Token != NULL) && (Token->Event != NULL)) {
+    Token->TransactionStatus = EFI_SUCCESS;
+    gBS->SignalEvent (Token->Event);
+  }
+
+  return EFI_SUCCESS;
+}
+
+
 /**
   Detect Device and read out capacity ,if error occurs, parse the sense key.
 
@@ -2050,6 +2465,328 @@ ScsiDiskWriteSectors (
   return EFI_SUCCESS;
 }
 
+/**
+  Asynchronously read sector from SCSI Disk.
+
+  @param  ScsiDiskDevice  The pointer of SCSI_DISK_DEV.
+  @param  Buffer          The buffer to fill in the read out data.
+  @param  Lba             Logic block address.
+  @param  NumberOfBlocks  The number of blocks to read.
+  @param  Token           A pointer to the token associated with the
+                          non-blocking read request.
+
+  @retval EFI_INVALID_PARAMETER  Token is NULL or Token->Event is NULL.
+  @retval EFI_DEVICE_ERROR       Indicates a device error.
+  @retval EFI_SUCCESS            Operation is successful.
+
+**/
+EFI_STATUS
+ScsiDiskAsyncReadSectors (
+  IN   SCSI_DISK_DEV         *ScsiDiskDevice,
+  OUT  VOID                  *Buffer,
+  IN   EFI_LBA               Lba,
+  IN   UINTN                 NumberOfBlocks,
+  IN   EFI_BLOCK_IO2_TOKEN   *Token
+  )
+{
+  UINTN                 BlocksRemaining;
+  UINT8                 *PtrBuffer;
+  UINT32                BlockSize;
+  UINT32                ByteCount;
+  UINT32                MaxBlock;
+  UINT32                SectorCount;
+  UINT64                Timeout;
+  SCSI_BLKIO2_REQUEST   *BlkIo2Req;
+  EFI_STATUS            Status;
+
+  if ((Token == NULL) || (Token->Event == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  BlkIo2Req = AllocateZeroPool (sizeof (SCSI_BLKIO2_REQUEST));
+  if (BlkIo2Req == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  BlkIo2Req->Token  = Token;
+  InsertTailList (&ScsiDiskDevice->BlkIo2Queue, &BlkIo2Req->Link);
+  InitializeListHead (&BlkIo2Req->ScsiRWQueue);
+
+  Status            = EFI_SUCCESS;
+
+  BlocksRemaining   = NumberOfBlocks;
+  BlockSize         = ScsiDiskDevice->BlkIo.Media->BlockSize;
+
+  //
+  // Limit the data bytes that can be transferred by one Read(10) or Read(16)
+  // Command
+  //
+  if (!ScsiDiskDevice->Cdb16Byte) {
+    MaxBlock         = 0xFFFF;
+  } else {
+    MaxBlock         = 0xFFFFFFFF;
+  }
+
+  PtrBuffer = Buffer;
+
+  while (BlocksRemaining > 0) {
+
+    if (BlocksRemaining <= MaxBlock) {
+      if (!ScsiDiskDevice->Cdb16Byte) {
+        SectorCount = (UINT16) BlocksRemaining;
+      } else {
+        SectorCount = (UINT32) BlocksRemaining;
+      }
+    } else {
+      SectorCount = MaxBlock;
+    }
+
+    ByteCount = SectorCount * BlockSize;
+    //
+    // |------------------------|-----------------|------------------|-----------------|
+    // |   ATA Transfer Mode    |  Transfer Rate  |  SCSI Interface  |  Transfer Rate  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 0       |  3.3Mbytes/sec  |     SCSI-1       |    5Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 1       |  5.2Mbytes/sec  |    Fast SCSI     |   10Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 2       |  8.3Mbytes/sec  |  Fast-Wide SCSI  |   20Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 3       | 11.1Mbytes/sec  |    Ultra SCSI    |   20Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 4       | 16.6Mbytes/sec  |  Ultra Wide SCSI |   40Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 0 |  2.1Mbytes/sec  |    Ultra2 SCSI   |   40Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 1 |  4.2Mbytes/sec  | Ultra2 Wide SCSI |   80Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 2 |  8.4Mbytes/sec  |    Ultra3 SCSI   |  160Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Multi-word DMA Mode 0  |  4.2Mbytes/sec  |  Ultra-320 SCSI  |  320Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Multi-word DMA Mode 1  | 13.3Mbytes/sec  |  Ultra-640 SCSI  |  640Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    //
+    // As ScsiDisk and ScsiBus driver are used to manage SCSI or ATAPI devices,
+    // we have to use the lowest transfer rate to calculate the possible
+    // maximum timeout value for each operation.
+    // From the above table, we could know 2.1Mbytes per second is lowest one.
+    // The timout value is rounded up to nearest integar and here an additional
+    // 30s is added to follow ATA spec in which it mentioned that the device
+    // may take up to 30s to respond commands in the Standby/Idle mode.
+    //
+    Timeout   = EFI_TIMER_PERIOD_SECONDS (ByteCount / 2100000 + 31);
+
+    if (!ScsiDiskDevice->Cdb16Byte) {
+      Status = ScsiDiskAsyncRead10 (
+                 ScsiDiskDevice,
+                 Timeout,
+                 PtrBuffer,
+                 ByteCount,
+                 (UINT32) Lba,
+                 SectorCount,
+                 BlkIo2Req,
+                 Token
+                 );
+    } else {
+      Status = ScsiDiskAsyncRead16 (
+                 ScsiDiskDevice,
+                 Timeout,
+                 PtrBuffer,
+                 ByteCount,
+                 Lba,
+                 SectorCount,
+                 BlkIo2Req,
+                 Token
+                 );
+    }
+    if (EFI_ERROR (Status)) {
+      //
+      // Free the SCSI_BLKIO2_REQUEST structure only when the first SCSI
+      // command fails. Otherwise, it will be freed in the callback function
+      // ScsiDiskNotify().
+      //
+      if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+        RemoveEntryList (&BlkIo2Req->Link);
+        FreePool (BlkIo2Req);
+      }
+      return EFI_DEVICE_ERROR;
+    }
+
+    //
+    // Sectors submitted for transfer
+    //
+    SectorCount = ByteCount / BlockSize;
+
+    Lba += SectorCount;
+    PtrBuffer = PtrBuffer + SectorCount * BlockSize;
+    BlocksRemaining -= SectorCount;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Asynchronously write sector to SCSI Disk.
+
+  @param  ScsiDiskDevice  The pointer of SCSI_DISK_DEV.
+  @param  Buffer          The buffer of data to be written into SCSI Disk.
+  @param  Lba             Logic block address.
+  @param  NumberOfBlocks  The number of blocks to read.
+  @param  Token           A pointer to the token associated with the
+                          non-blocking read request.
+
+  @retval EFI_INVALID_PARAMETER  Token is NULL or Token->Event is NULL
+  @retval EFI_DEVICE_ERROR  Indicates a device error.
+  @retval EFI_SUCCESS       Operation is successful.
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWriteSectors (
+  IN  SCSI_DISK_DEV          *ScsiDiskDevice,
+  IN  VOID                   *Buffer,
+  IN  EFI_LBA                Lba,
+  IN  UINTN                  NumberOfBlocks,
+  IN  EFI_BLOCK_IO2_TOKEN    *Token
+  )
+{
+  UINTN                 BlocksRemaining;
+  UINT8                 *PtrBuffer;
+  UINT32                BlockSize;
+  UINT32                ByteCount;
+  UINT32                MaxBlock;
+  UINT32                SectorCount;
+  UINT64                Timeout;
+  SCSI_BLKIO2_REQUEST   *BlkIo2Req;
+  EFI_STATUS            Status;
+
+  if ((Token == NULL) || (Token->Event == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  BlkIo2Req = AllocateZeroPool (sizeof (SCSI_BLKIO2_REQUEST));
+  if (BlkIo2Req == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  BlkIo2Req->Token  = Token;
+  InsertTailList (&ScsiDiskDevice->BlkIo2Queue, &BlkIo2Req->Link);
+  InitializeListHead (&BlkIo2Req->ScsiRWQueue);
+
+  Status            = EFI_SUCCESS;
+
+  BlocksRemaining   = NumberOfBlocks;
+  BlockSize         = ScsiDiskDevice->BlkIo.Media->BlockSize;
+
+  //
+  // Limit the data bytes that can be transferred by one Read(10) or Read(16)
+  // Command
+  //
+  if (!ScsiDiskDevice->Cdb16Byte) {
+    MaxBlock         = 0xFFFF;
+  } else {
+    MaxBlock         = 0xFFFFFFFF;
+  }
+
+  PtrBuffer = Buffer;
+
+  while (BlocksRemaining > 0) {
+
+    if (BlocksRemaining <= MaxBlock) {
+      if (!ScsiDiskDevice->Cdb16Byte) {
+        SectorCount = (UINT16) BlocksRemaining;
+      } else {
+        SectorCount = (UINT32) BlocksRemaining;
+      }
+    } else {
+      SectorCount = MaxBlock;
+    }
+
+    ByteCount = SectorCount * BlockSize;
+    //
+    // |------------------------|-----------------|------------------|-----------------|
+    // |   ATA Transfer Mode    |  Transfer Rate  |  SCSI Interface  |  Transfer Rate  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 0       |  3.3Mbytes/sec  |     SCSI-1       |    5Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 1       |  5.2Mbytes/sec  |    Fast SCSI     |   10Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 2       |  8.3Mbytes/sec  |  Fast-Wide SCSI  |   20Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 3       | 11.1Mbytes/sec  |    Ultra SCSI    |   20Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // |       PIO Mode 4       | 16.6Mbytes/sec  |  Ultra Wide SCSI |   40Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 0 |  2.1Mbytes/sec  |    Ultra2 SCSI   |   40Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 1 |  4.2Mbytes/sec  | Ultra2 Wide SCSI |   80Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Single-word DMA Mode 2 |  8.4Mbytes/sec  |    Ultra3 SCSI   |  160Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Multi-word DMA Mode 0  |  4.2Mbytes/sec  |  Ultra-320 SCSI  |  320Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    // | Multi-word DMA Mode 1  | 13.3Mbytes/sec  |  Ultra-640 SCSI  |  640Mbytes/sec  |
+    // |------------------------|-----------------|------------------|-----------------|
+    //
+    // As ScsiDisk and ScsiBus driver are used to manage SCSI or ATAPI devices,
+    // we have to use the lowest transfer rate to calculate the possible
+    // maximum timeout value for each operation.
+    // From the above table, we could know 2.1Mbytes per second is lowest one.
+    // The timout value is rounded up to nearest integar and here an additional
+    // 30s is added to follow ATA spec in which it mentioned that the device
+    // may take up to 30s to respond commands in the Standby/Idle mode.
+    //
+    Timeout   = EFI_TIMER_PERIOD_SECONDS (ByteCount / 2100000 + 31);
+
+    if (!ScsiDiskDevice->Cdb16Byte) {
+      Status = ScsiDiskAsyncWrite10 (
+                 ScsiDiskDevice,
+                 Timeout,
+                 PtrBuffer,
+                 ByteCount,
+                 (UINT32) Lba,
+                 SectorCount,
+                 BlkIo2Req,
+                 Token
+                 );
+    } else {
+      Status = ScsiDiskAsyncWrite16 (
+                 ScsiDiskDevice,
+                 Timeout,
+                 PtrBuffer,
+                 ByteCount,
+                 Lba,
+                 SectorCount,
+                 BlkIo2Req,
+                 Token
+                 );
+    }
+    if (EFI_ERROR (Status)) {
+      //
+      // Free the SCSI_BLKIO2_REQUEST structure only when the first SCSI
+      // command fails. Otherwise, it will be freed in the callback function
+      // ScsiDiskNotify().
+      //
+      if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+        RemoveEntryList (&BlkIo2Req->Link);
+        FreePool (BlkIo2Req);
+      }
+      return EFI_DEVICE_ERROR;
+    }
+
+    //
+    // Sectors submitted for transfer
+    //
+    SectorCount = ByteCount / BlockSize;
+
+    Lba += SectorCount;
+    PtrBuffer = PtrBuffer + SectorCount * BlockSize;
+    BlocksRemaining -= SectorCount;
+  }
+
+  return EFI_SUCCESS;
+}
+
 
 /**
   Submit Read(10) command.
@@ -2546,6 +3283,689 @@ ScsiDiskWrite16 (
 }
 
 
+/**
+  Internal helper notify function in which determine whether retry of a SCSI
+  Read/Write command is needed and signal the event passed from Block I/O(2) if
+  the SCSI I/O operation completes.
+
+  @param  Event    The instance of EFI_EVENT.
+  @param  Context  The parameter passed in.
+
+**/
+VOID
+EFIAPI
+ScsiDiskNotify (
+  IN  EFI_EVENT  Event,
+  IN  VOID       *Context
+  )
+{
+  EFI_STATUS                       Status;
+  SCSI_ASYNC_RW_REQUEST            *Request;
+  SCSI_DISK_DEV                    *ScsiDiskDevice;
+  EFI_BLOCK_IO2_TOKEN              *Token;
+  UINTN                            Action;
+  UINT32                           OldDataLength;
+  UINT32                           OldSectorCount;
+  UINT8                            MaxRetry;
+
+  gBS->CloseEvent (Event);
+
+  Request         = (SCSI_ASYNC_RW_REQUEST *) Context;
+  ScsiDiskDevice  = Request->ScsiDiskDevice;
+  Token           = Request->BlkIo2Req->Token;
+  OldDataLength   = Request->DataLength;
+  OldSectorCount  = Request->SectorCount;
+  MaxRetry        = 2;
+
+  //
+  // If previous sub-tasks already fails, no need to process this sub-task.
+  //
+  if (Token->TransactionStatus != EFI_SUCCESS) {
+    goto Exit;
+  }
+
+  //
+  // Check HostAdapterStatus and TargetStatus
+  // (EFI_TIMEOUT, EFI_DEVICE_ERROR, EFI_WARN_BUFFER_TOO_SMALL)
+  //
+  Status = CheckHostAdapterStatus (Request->HostAdapterStatus);
+  if ((Status == EFI_TIMEOUT) || (Status == EFI_NOT_READY)) {
+    if (++Request->TimesRetry > MaxRetry) {
+      Token->TransactionStatus = EFI_DEVICE_ERROR;
+      goto Exit;
+    } else {
+      goto Retry;
+    }
+  } else if (Status == EFI_DEVICE_ERROR) {
+    //
+    // reset the scsi channel
+    //
+    ScsiDiskDevice->ScsiIo->ResetBus (ScsiDiskDevice->ScsiIo);
+    Token->TransactionStatus = EFI_DEVICE_ERROR;
+    goto Exit;
+  }
+
+  Status = CheckTargetStatus (Request->TargetStatus);
+  if (Status == EFI_NOT_READY) {
+    //
+    // reset the scsi device
+    //
+    ScsiDiskDevice->ScsiIo->ResetDevice (ScsiDiskDevice->ScsiIo);
+    if (++Request->TimesRetry > MaxRetry) {
+      Token->TransactionStatus = EFI_DEVICE_ERROR;
+      goto Exit;
+    } else {
+      goto Retry;
+    }
+  } else if (Status == EFI_DEVICE_ERROR) {
+    Token->TransactionStatus = EFI_DEVICE_ERROR;
+    goto Exit;
+  }
+
+  if (Request->TargetStatus == EFI_EXT_SCSI_STATUS_TARGET_CHECK_CONDITION) {
+    DEBUG ((EFI_D_ERROR, "ScsiDiskNotify: Check Condition happened!\n"));
+
+    Status = DetectMediaParsingSenseKeys (
+               ScsiDiskDevice,
+               Request->SenseData,
+               Request->SenseDataLength / sizeof (EFI_SCSI_SENSE_DATA),
+               &Action
+               );
+    if (Action == ACTION_RETRY_COMMAND_LATER) {
+      if (++Request->TimesRetry > MaxRetry) {
+        Token->TransactionStatus = EFI_DEVICE_ERROR;
+        goto Exit;
+      } else {
+        goto Retry;
+      }
+    } else if (Action == ACTION_RETRY_WITH_BACKOFF_ALGO) {
+      if (Request->SectorCount <= 1) {
+        //
+        // Jump out if the operation still fails with one sector transfer
+        // length.
+        //
+        Token->TransactionStatus = EFI_DEVICE_ERROR;
+        goto Exit;
+      }
+      //
+      // Try again with two half length request if the sense data shows we need
+      // to retry.
+      //
+      Request->SectorCount >>= 1;
+      Request->DataLength = Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize;
+      Request->TimesRetry  = 0;
+
+      goto Retry;
+    } else {
+      Token->TransactionStatus = EFI_DEVICE_ERROR;
+      goto Exit;
+    }
+  }
+
+  //
+  // This sub-task succeeds, no need to retry.
+  //
+  goto Exit;
+
+Retry:
+  if (Request->InBuffer != NULL) {
+    //
+    // SCSI read command
+    //
+    if (!ScsiDiskDevice->Cdb16Byte) {
+      Status = ScsiDiskAsyncRead10 (
+                 ScsiDiskDevice,
+                 Request->Timeout,
+                 Request->InBuffer,
+                 Request->DataLength,
+                 (UINT32) Request->StartLba,
+                 Request->SectorCount,
+                 Request->BlkIo2Req,
+                 Token
+                 );
+    } else {
+      Status = ScsiDiskAsyncRead16 (
+                 ScsiDiskDevice,
+                 Request->Timeout,
+                 Request->InBuffer,
+                 Request->DataLength,
+                 Request->StartLba,
+                 Request->SectorCount,
+                 Request->BlkIo2Req,
+                 Token
+                 );
+    }
+
+    if (EFI_ERROR (Status)) {
+      Token->TransactionStatus = EFI_DEVICE_ERROR;
+      goto Exit;
+    } else if (OldSectorCount != Request->SectorCount) {
+      //
+      // Original sub-task will be split into two new sub-tasks with smaller
+      // DataLength
+      //
+      if (!ScsiDiskDevice->Cdb16Byte) {
+        Status = ScsiDiskAsyncRead10 (
+                   ScsiDiskDevice,
+                   Request->Timeout,
+                   Request->InBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
+                   OldDataLength - Request->DataLength,
+                   (UINT32) Request->StartLba + Request->SectorCount,
+                   OldSectorCount - Request->SectorCount,
+                   Request->BlkIo2Req,
+                   Token
+                   );
+      } else {
+        Status = ScsiDiskAsyncRead16 (
+                   ScsiDiskDevice,
+                   Request->Timeout,
+                   Request->InBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
+                   OldDataLength - Request->DataLength,
+                   Request->StartLba + Request->SectorCount,
+                   OldSectorCount - Request->SectorCount,
+                   Request->BlkIo2Req,
+                   Token
+                   );
+      }
+      if (EFI_ERROR (Status)) {
+        Token->TransactionStatus = EFI_DEVICE_ERROR;
+        goto Exit;
+      }
+    }
+  } else {
+    //
+    // SCSI write command
+    //
+    if (!ScsiDiskDevice->Cdb16Byte) {
+      Status = ScsiDiskAsyncWrite10 (
+                 ScsiDiskDevice,
+                 Request->Timeout,
+                 Request->OutBuffer,
+                 Request->DataLength,
+                 (UINT32) Request->StartLba,
+                 Request->SectorCount,
+                 Request->BlkIo2Req,
+                 Token
+                 );
+    } else {
+      Status = ScsiDiskAsyncWrite16 (
+                 ScsiDiskDevice,
+                 Request->Timeout,
+                 Request->OutBuffer,
+                 Request->DataLength,
+                 Request->StartLba,
+                 Request->SectorCount,
+                 Request->BlkIo2Req,
+                 Token
+                 );
+    }
+
+    if (EFI_ERROR (Status)) {
+      Token->TransactionStatus = EFI_DEVICE_ERROR;
+      goto Exit;
+    } else if (OldSectorCount != Request->SectorCount) {
+      //
+      // Original sub-task will be split into two new sub-tasks with smaller
+      // DataLength
+      //
+      if (!ScsiDiskDevice->Cdb16Byte) {
+        Status = ScsiDiskAsyncWrite10 (
+                   ScsiDiskDevice,
+                   Request->Timeout,
+                   Request->OutBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
+                   OldDataLength - Request->DataLength,
+                   (UINT32) Request->StartLba + Request->SectorCount,
+                   OldSectorCount - Request->SectorCount,
+                   Request->BlkIo2Req,
+                   Token
+                   );
+      } else {
+        Status = ScsiDiskAsyncWrite16 (
+                   ScsiDiskDevice,
+                   Request->Timeout,
+                   Request->OutBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
+                   OldDataLength - Request->DataLength,
+                   Request->StartLba + Request->SectorCount,
+                   OldSectorCount - Request->SectorCount,
+                   Request->BlkIo2Req,
+                   Token
+                   );
+      }
+      if (EFI_ERROR (Status)) {
+        Token->TransactionStatus = EFI_DEVICE_ERROR;
+        goto Exit;
+      }
+    }
+  }
+
+Exit:
+  RemoveEntryList (&Request->Link);
+  if (IsListEmpty (&Request->BlkIo2Req->ScsiRWQueue)) {
+    //
+    // The last SCSI R/W command of a BlockIo2 request completes
+    //
+    RemoveEntryList (&Request->BlkIo2Req->Link);
+    FreePool (Request->BlkIo2Req);  // Should be freed only once
+    gBS->SignalEvent (Token->Event);
+  }
+
+  FreePool (Request->SenseData);
+  FreePool (Request);
+}
+
+
+/**
+  Submit Async Read(10) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer to fill with the read out data.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to read.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiRead10CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncRead10 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+     OUT UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  )
+{
+  EFI_STATUS                   Status;
+  SCSI_ASYNC_RW_REQUEST        *Request;
+  EFI_EVENT                    AsyncIoEvent;
+
+  Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
+  if (Request == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+
+  Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
+  Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
+  if (Request->SenseData == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Request->ScsiDiskDevice  = ScsiDiskDevice;
+  Request->Timeout         = Timeout;
+  Request->InBuffer        = DataBuffer;
+  Request->DataLength      = DataLength;
+  Request->StartLba        = StartLba;
+  Request->SectorCount     = SectorCount;
+  Request->BlkIo2Req       = BlkIo2Req;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiDiskNotify,
+                  Request,
+                  &AsyncIoEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  Status = ScsiRead10CommandEx (
+             ScsiDiskDevice->ScsiIo,
+             Request->Timeout,
+             Request->SenseData,
+             &Request->SenseDataLength,
+             &Request->HostAdapterStatus,
+             &Request->TargetStatus,
+             Request->InBuffer,
+             &Request->DataLength,
+             (UINT32) Request->StartLba,
+             Request->SectorCount,
+             AsyncIoEvent
+             );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return EFI_SUCCESS;
+
+ErrorExit:
+  if (Request != NULL) {
+    if (Request->SenseData != NULL) {
+      FreePool (Request->SenseData);
+    }
+
+    RemoveEntryList (&Request->Link);
+    FreePool (Request);
+  }
+
+  return Status;
+}
+
+
+/**
+  Submit Async Write(10) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer contains the data to write.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to write.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiWrite10CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWrite10 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+  IN     UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  )
+{
+  EFI_STATUS                   Status;
+  SCSI_ASYNC_RW_REQUEST        *Request;
+  EFI_EVENT                    AsyncIoEvent;
+
+  Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
+  if (Request == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+
+  Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
+  Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
+  if (Request->SenseData == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Request->ScsiDiskDevice  = ScsiDiskDevice;
+  Request->Timeout         = Timeout;
+  Request->OutBuffer       = DataBuffer;
+  Request->DataLength      = DataLength;
+  Request->StartLba        = StartLba;
+  Request->SectorCount     = SectorCount;
+  Request->BlkIo2Req       = BlkIo2Req;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiDiskNotify,
+                  Request,
+                  &AsyncIoEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  Status = ScsiWrite10CommandEx (
+             ScsiDiskDevice->ScsiIo,
+             Request->Timeout,
+             Request->SenseData,
+             &Request->SenseDataLength,
+             &Request->HostAdapterStatus,
+             &Request->TargetStatus,
+             Request->OutBuffer,
+             &Request->DataLength,
+             (UINT32) Request->StartLba,
+             Request->SectorCount,
+             AsyncIoEvent
+             );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return EFI_SUCCESS;
+
+ErrorExit:
+  if (Request != NULL) {
+    if (Request->SenseData != NULL) {
+      FreePool (Request->SenseData);
+    }
+
+    RemoveEntryList (&Request->Link);
+    FreePool (Request);
+  }
+
+  return Status;
+}
+
+
+/**
+  Submit Async Read(16) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer to fill with the read out data.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to read.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiRead16CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncRead16 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+     OUT UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  )
+{
+  EFI_STATUS                   Status;
+  SCSI_ASYNC_RW_REQUEST        *Request;
+  EFI_EVENT                    AsyncIoEvent;
+
+  Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
+  if (Request == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+
+  Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
+  Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
+  if (Request->SenseData == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Request->ScsiDiskDevice  = ScsiDiskDevice;
+  Request->Timeout         = Timeout;
+  Request->InBuffer        = DataBuffer;
+  Request->DataLength      = DataLength;
+  Request->StartLba        = StartLba;
+  Request->SectorCount     = SectorCount;
+  Request->BlkIo2Req       = BlkIo2Req;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiDiskNotify,
+                  Request,
+                  &AsyncIoEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  Status = ScsiRead16CommandEx (
+             ScsiDiskDevice->ScsiIo,
+             Request->Timeout,
+             Request->SenseData,
+             &Request->SenseDataLength,
+             &Request->HostAdapterStatus,
+             &Request->TargetStatus,
+             Request->InBuffer,
+             &Request->DataLength,
+             Request->StartLba,
+             Request->SectorCount,
+             AsyncIoEvent
+             );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return EFI_SUCCESS;
+
+ErrorExit:
+  if (Request != NULL) {
+    if (Request->SenseData != NULL) {
+      FreePool (Request->SenseData);
+    }
+
+    RemoveEntryList (&Request->Link);
+    FreePool (Request);
+  }
+
+  return Status;
+}
+
+
+/**
+  Submit Async Write(16) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer contains the data to write.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to write.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiWrite16CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWrite16 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+  IN     UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  )
+{
+  EFI_STATUS                   Status;
+  SCSI_ASYNC_RW_REQUEST        *Request;
+  EFI_EVENT                    AsyncIoEvent;
+
+  Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
+  if (Request == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+
+  Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
+  Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
+  if (Request->SenseData == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ErrorExit;
+  }
+
+  Request->ScsiDiskDevice  = ScsiDiskDevice;
+  Request->Timeout         = Timeout;
+  Request->OutBuffer       = DataBuffer;
+  Request->DataLength      = DataLength;
+  Request->StartLba        = StartLba;
+  Request->SectorCount     = SectorCount;
+  Request->BlkIo2Req       = BlkIo2Req;
+
+  //
+  // Create Event
+  //
+  Status = gBS->CreateEvent (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ScsiDiskNotify,
+                  Request,
+                  &AsyncIoEvent
+                  );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  Status = ScsiWrite16CommandEx (
+             ScsiDiskDevice->ScsiIo,
+             Request->Timeout,
+             Request->SenseData,
+             &Request->SenseDataLength,
+             &Request->HostAdapterStatus,
+             &Request->TargetStatus,
+             Request->OutBuffer,
+             &Request->DataLength,
+             Request->StartLba,
+             Request->SectorCount,
+             AsyncIoEvent
+             );
+  if (EFI_ERROR(Status)) {
+    goto ErrorExit;
+  }
+
+  return EFI_SUCCESS;
+
+ErrorExit:
+  if (Request != NULL) {
+    if (Request->SenseData != NULL) {
+      FreePool (Request->SenseData);
+    }
+
+    RemoveEntryList (&Request->Link);
+    FreePool (Request);
+  }
+
+  return Status;
+}
+
+
 /**
   Check sense key to find if media presents.
 
@@ -2932,13 +4352,13 @@ ReleaseScsiDiskDeviceResources (
 }
 
 /**
-  Determine if Block Io should be produced.
+  Determine if Block Io & Block Io2 should be produced.
   
 
   @param  ChildHandle  Child Handle to retrieve Parent information.
   
-  @retval  TRUE    Should produce Block Io.
-  @retval  FALSE   Should not produce Block Io.
+  @retval  TRUE    Should produce Block Io & Block Io2.
+  @retval  FALSE   Should not produce Block Io & Block Io2.
 
 **/  
 BOOLEAN
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
index 407763665f7c..836e7caeeda1 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
@@ -1,7 +1,7 @@
 /** @file
   Header file for SCSI Disk Driver.
 
-Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -22,6 +22,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Protocol/ScsiIo.h>
 #include <Protocol/ComponentName.h>
 #include <Protocol/BlockIo.h>
+#include <Protocol/BlockIo2.h>
 #include <Protocol/DriverBinding.h>
 #include <Protocol/ScsiPassThruExt.h>
 #include <Protocol/ScsiPassThru.h>
@@ -50,6 +51,7 @@ typedef struct {
   EFI_HANDLE                Handle;
 
   EFI_BLOCK_IO_PROTOCOL     BlkIo;
+  EFI_BLOCK_IO2_PROTOCOL    BlkIo2;
   EFI_BLOCK_IO_MEDIA        BlkIoMedia;
   EFI_SCSI_IO_PROTOCOL      *ScsiIo;
   UINT8                     DeviceType;
@@ -75,12 +77,59 @@ typedef struct {
   // The flag indicates if 16-byte command can be used
   //
   BOOLEAN                   Cdb16Byte;
+
+  //
+  // The queue for BlockIo2 requests
+  //
+  LIST_ENTRY                BlkIo2Queue;
 } SCSI_DISK_DEV;
 
-#define SCSI_DISK_DEV_FROM_THIS(a)  CR (a, SCSI_DISK_DEV, BlkIo, SCSI_DISK_DEV_SIGNATURE)
+#define SCSI_DISK_DEV_FROM_BLKIO(a)  CR (a, SCSI_DISK_DEV, BlkIo, SCSI_DISK_DEV_SIGNATURE)
+#define SCSI_DISK_DEV_FROM_BLKIO2(a)  CR (a, SCSI_DISK_DEV, BlkIo2, SCSI_DISK_DEV_SIGNATURE)
 
 #define SCSI_DISK_DEV_FROM_DISKINFO(a) CR (a, SCSI_DISK_DEV, DiskInfo, SCSI_DISK_DEV_SIGNATURE)
 
+//
+// Asynchronous I/O request
+//
+//
+// Private data structure for a BlockIo2 request
+//
+typedef struct {
+  EFI_BLOCK_IO2_TOKEN                  *Token;
+  //
+  // The queue for Scsi Read/Write requests of a BlockIo2
+  //
+  LIST_ENTRY                           ScsiRWQueue;
+
+  LIST_ENTRY                           Link;
+} SCSI_BLKIO2_REQUEST;
+
+//
+// Private data structure for a SCSI Read/Write request
+//
+typedef struct {
+  SCSI_DISK_DEV                        *ScsiDiskDevice;
+  UINT64                               Timeout;
+  EFI_SCSI_SENSE_DATA                  *SenseData;
+  UINT8                                SenseDataLength;
+  UINT8                                HostAdapterStatus;
+  UINT8                                TargetStatus;
+  UINT8                                *InBuffer;
+  UINT8                                *OutBuffer;
+  UINT32                               DataLength;
+  UINT64                               StartLba;
+  UINT32                               SectorCount;
+  UINT8                                TimesRetry;
+
+  //
+  // The BlockIo2 request this SCSI command belongs to
+  //
+  SCSI_BLKIO2_REQUEST                  *BlkIo2Req;
+
+  LIST_ENTRY                           Link;
+} SCSI_ASYNC_RW_REQUEST;
+
 //
 // Global Variables
 //
@@ -410,6 +459,116 @@ ScsiDiskFlushBlocks (
   );
 
 
+/**
+  Reset SCSI Disk.
+
+  @param  This                 The pointer of EFI_BLOCK_IO2_PROTOCOL.
+  @param  ExtendedVerification The flag about if extend verificate.
+
+  @retval EFI_SUCCESS          The device was reset.
+  @retval EFI_DEVICE_ERROR     The device is not functioning properly and could
+                               not be reset.
+  @return EFI_STATUS is returned from EFI_SCSI_IO_PROTOCOL.ResetDevice().
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskResetEx (
+  IN  EFI_BLOCK_IO2_PROTOCOL  *This,
+  IN  BOOLEAN                 ExtendedVerification
+  );
+
+/**
+  The function is to Read Block from SCSI Disk.
+
+  @param  This       The pointer of EFI_BLOCK_IO_PROTOCOL.
+  @param  MediaId    The Id of Media detected.
+  @param  Lba        The logic block address.
+  @param  Token      A pointer to the token associated with the transaction.
+  @param  BufferSize The size of Buffer.
+  @param  Buffer     The buffer to fill the read out data.
+
+  @retval EFI_SUCCESS           The read request was queued if Token-> Event is
+                                not NULL. The data was read correctly from the
+                                device if theToken-> Event is NULL.
+  @retval EFI_DEVICE_ERROR      The device reported an error while attempting
+                                to perform the read operation.
+  @retval EFI_NO_MEDIA          There is no media in the device.
+  @retval EFI_MEDIA_CHANGED     The MediaId is not for the current media.
+  @retval EFI_BAD_BUFFER_SIZE   The BufferSize parameter is not a multiple of
+                                the intrinsic block size of the device.
+  @retval EFI_INVALID_PARAMETER The read request contains LBAs that are not
+                                valid, or the buffer is not on proper
+                                alignment.
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskReadBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL   *This,
+  IN     UINT32                   MediaId,
+  IN     EFI_LBA                  Lba,
+  IN OUT EFI_BLOCK_IO2_TOKEN      *Token,
+  IN     UINTN                    BufferSize,
+  OUT    VOID                     *Buffer
+  );
+
+/**
+  The function is to Write Block to SCSI Disk.
+
+  @param  This       The pointer of EFI_BLOCK_IO_PROTOCOL.
+  @param  MediaId    The Id of Media detected.
+  @param  Lba        The logic block address.
+  @param  Token      A pointer to the token associated with the transaction.
+  @param  BufferSize The size of Buffer.
+  @param  Buffer     The buffer to fill the read out data.
+
+  @retval EFI_SUCCESS           The data were written correctly to the device.
+  @retval EFI_WRITE_PROTECTED   The device cannot be written to.
+  @retval EFI_NO_MEDIA          There is no media in the device.
+  @retval EFI_MEDIA_CHANGED     The MediaId is not for the current media.
+  @retval EFI_DEVICE_ERROR      The device reported an error while attempting
+                                to perform the write operation.
+  @retval EFI_BAD_BUFFER_SIZE   The BufferSize parameter is not a multiple of
+                                the intrinsic block size of the device.
+  @retval EFI_INVALID_PARAMETER The write request contains LBAs that are not
+                                valid, or the buffer is not on proper
+                                alignment.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskWriteBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL *This,
+  IN     UINT32                 MediaId,
+  IN     EFI_LBA                Lba,
+  IN OUT EFI_BLOCK_IO2_TOKEN    *Token,
+  IN     UINTN                  BufferSize,
+  IN     VOID                   *Buffer
+  );
+
+/**
+  Flush the Block Device.
+
+  @param  This       Indicates a pointer to the calling context.
+  @param  Token      A pointer to the token associated with the transaction.
+
+  @retval EFI_SUCCESS       All outstanding data was written to the device.
+  @retval EFI_DEVICE_ERROR  The device reported an error while writing back the
+                            data.
+  @retval EFI_NO_MEDIA      There is no media in the device.
+
+**/
+EFI_STATUS
+EFIAPI
+ScsiDiskFlushBlocksEx (
+  IN     EFI_BLOCK_IO2_PROTOCOL  *This,
+  IN OUT EFI_BLOCK_IO2_TOKEN     *Token
+  );
+
+
 /**
   Provides inquiry information for the controller type.
   
@@ -717,6 +876,54 @@ ScsiDiskWriteSectors (
   IN  UINTN             NumberOfBlocks
   );
 
+/**
+  Asynchronously read sector from SCSI Disk.
+
+  @param  ScsiDiskDevice  The pointer of SCSI_DISK_DEV.
+  @param  Buffer          The buffer to fill in the read out data.
+  @param  Lba             Logic block address.
+  @param  NumberOfBlocks  The number of blocks to read.
+  @param  Token           A pointer to the token associated with the
+                          non-blocking read request.
+
+  @retval EFI_INVALID_PARAMETER  Token is NULL or Token->Event is NULL.
+  @retval EFI_DEVICE_ERROR       Indicates a device error.
+  @retval EFI_SUCCESS            Operation is successful.
+
+**/
+EFI_STATUS
+ScsiDiskAsyncReadSectors (
+  IN   SCSI_DISK_DEV         *ScsiDiskDevice,
+  OUT  VOID                  *Buffer,
+  IN   EFI_LBA               Lba,
+  IN   UINTN                 NumberOfBlocks,
+  IN   EFI_BLOCK_IO2_TOKEN   *Token
+  );
+
+/**
+  Asynchronously write sector to SCSI Disk.
+
+  @param  ScsiDiskDevice  The pointer of SCSI_DISK_DEV.
+  @param  Buffer          The buffer of data to be written into SCSI Disk.
+  @param  Lba             Logic block address.
+  @param  NumberOfBlocks  The number of blocks to read.
+  @param  Token           A pointer to the token associated with the
+                          non-blocking read request.
+
+  @retval EFI_INVALID_PARAMETER  Token is NULL or Token->Event is NULL
+  @retval EFI_DEVICE_ERROR  Indicates a device error.
+  @retval EFI_SUCCESS       Operation is successful.
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWriteSectors (
+  IN  SCSI_DISK_DEV          *ScsiDiskDevice,
+  IN  VOID                   *Buffer,
+  IN  EFI_LBA                Lba,
+  IN  UINTN                  NumberOfBlocks,
+  IN  EFI_BLOCK_IO2_TOKEN    *Token
+  );
+
 /**
   Submit Read(10) command.
 
@@ -815,6 +1022,130 @@ ScsiDiskWrite16 (
   IN     UINT32                SectorCount
   );  
 
+/**
+  Submit Async Read(10) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer to fill with the read out data.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to read.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiRead10CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncRead10 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+     OUT UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  );
+
+/**
+  Submit Async Write(10) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer contains the data to write.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to write.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiWrite10CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWrite10 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+  IN     UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT32                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  );
+
+/**
+  Submit Async Read(16) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer to fill with the read out data.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to read.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiRead16CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncRead16 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+     OUT UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  );
+
+/**
+  Submit Async Write(16) command.
+
+  @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
+  @param  Timeout            The time to complete the command.
+  @param  DataBuffer         The buffer contains the data to write.
+  @param  DataLength         The length of buffer.
+  @param  StartLba           The start logic block address.
+  @param  SectorCount        The number of blocks to write.
+  @param  BlkIo2Req          The upstream BlockIo2 request.
+  @param  Token              The pointer to the token associated with the
+                             non-blocking read request.
+
+  @retval EFI_OUT_OF_RESOURCES  The request could not be completed due to a
+                                lack of resources.
+  @return others                Status returned by calling
+                                ScsiWrite16CommandEx().
+
+**/
+EFI_STATUS
+ScsiDiskAsyncWrite16 (
+  IN     SCSI_DISK_DEV         *ScsiDiskDevice,
+  IN     UINT64                Timeout,
+  IN     UINT8                 *DataBuffer,
+  IN     UINT32                DataLength,
+  IN     UINT64                StartLba,
+  IN     UINT32                SectorCount,
+  IN OUT SCSI_BLKIO2_REQUEST   *BlkIo2Req,
+  IN     EFI_BLOCK_IO2_TOKEN   *Token
+  );
+
 /**
   Get information from media read capacity command.
 
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf
index ec96aa6f928c..47539e55c8e7 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDiskDxe.inf
@@ -1,8 +1,9 @@
 ## @file
 #  The Scsi Disk driver is used to retrieve the media info in the attached SCSI disk.
-#  It detects the SCSI disk media and installs Block I/O Protocol on the device handle.
+#  It detects the SCSI disk media and installs Block I/O and Block I/O2 Protocol on
+#  the device handle.
 #  
-#  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution.  The full text of the license may be found at
@@ -55,6 +56,7 @@
 [Protocols]
   gEfiDiskInfoProtocolGuid                      ## BY_START
   gEfiBlockIoProtocolGuid                       ## BY_START
+  gEfiBlockIo2ProtocolGuid                      ## BY_START
   gEfiScsiIoProtocolGuid                        ## TO_START
   gEfiScsiPassThruProtocolGuid                  ## TO_START
   gEfiExtScsiPassThruProtocolGuid               ## TO_START

From c3a1d5980474c31dcdb0742a190f35fe7251aca3 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 11 Dec 2015 07:35:31 +0000
Subject: [PATCH 237/525] MdeModulePkg UfsPassThruDxe: Add Non-blocking I/O
 Support

Previously, UfsPassThruPassThru function does not handle the 'Event'
parameter and blocking read/write operations are always executed.

This commit enables non-blocking read/write feature for UFS devices.

(Sync patch r19216 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19223 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Bus/Ufs/UfsPassThruDxe/UfsPassThru.c      |  70 ++++-
 .../Bus/Ufs/UfsPassThruDxe/UfsPassThru.h      |  75 ++++-
 .../Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c   | 288 ++++++++++++++++--
 3 files changed, 393 insertions(+), 40 deletions(-)

diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
index 306fd37a2979..aa40e2747097 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
@@ -1,6 +1,6 @@
 /** @file
 
-  Copyright (c) 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -21,10 +21,7 @@ UFS_PASS_THRU_PRIVATE_DATA gUfsPassThruTemplate = {
   NULL,                           // Handle  
   {                               // ExtScsiPassThruMode
     0xFFFFFFFF,
-    //
-    // Note that the driver doesn't support ExtScsiPassThru non blocking I/O.
-    //
-    EFI_EXT_SCSI_PASS_THRU_ATTRIBUTES_PHYSICAL | EFI_EXT_SCSI_PASS_THRU_ATTRIBUTES_LOGICAL,
+    EFI_EXT_SCSI_PASS_THRU_ATTRIBUTES_PHYSICAL | EFI_EXT_SCSI_PASS_THRU_ATTRIBUTES_LOGICAL | EFI_EXT_SCSI_PASS_THRU_ATTRIBUTES_NONBLOCKIO,
     sizeof (UINTN)
   },
   {                               // ExtScsiPassThru
@@ -64,6 +61,11 @@ UFS_PASS_THRU_PRIVATE_DATA gUfsPassThruTemplate = {
     },
     0x0000,                           // By default don't expose any Luns.
     0x0
+  },
+  NULL,                           // TimerEvent
+  {                               // Queue
+    NULL,
+    NULL
   }
 };
 
@@ -212,7 +214,7 @@ UfsPassThruPassThru (
     return EFI_INVALID_PARAMETER;
   }
 
-  Status = UfsExecScsiCmds (Private, UfsLun, Packet);
+  Status = UfsExecScsiCmds (Private, UfsLun, Packet, Event);
 
   return Status;
 }
@@ -816,6 +818,7 @@ UfsPassThruDriverBindingStart (
   //
   Private = AllocateCopyPool (sizeof (UFS_PASS_THRU_PRIVATE_DATA), &gUfsPassThruTemplate);
   if (Private == NULL) {
+    DEBUG ((EFI_D_ERROR, "Unable to allocate Ufs Pass Thru private data\n"));
     Status = EFI_OUT_OF_RESOURCES;
     goto Error;
   }
@@ -823,6 +826,7 @@ UfsPassThruDriverBindingStart (
   Private->ExtScsiPassThru.Mode = &Private->ExtScsiPassThruMode;
   Private->UfsHostController    = UfsHc;
   Private->UfsHcBase            = UfsHcBase;
+  InitializeListHead (&Private->Queue);
 
   //
   // Initialize UFS Host Controller H/W.
@@ -873,6 +877,31 @@ UfsPassThruDriverBindingStart (
     }
   }
 
+  //
+  // Start the asynchronous interrupt monitor
+  //
+  Status = gBS->CreateEvent (
+                  EVT_TIMER | EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  ProcessAsyncTaskList,
+                  Private,
+                  &Private->TimerEvent
+                  );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "Ufs Create Async Tasks Event Error, Status = %r\n", Status));
+    goto Error;
+  }
+
+  Status = gBS->SetTimer (
+                  Private->TimerEvent,
+                  TimerPeriodic,
+                  UFS_HC_ASYNC_TIMER
+                  );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "Ufs Set Periodic Timer Error, Status = %r\n", Status));
+    goto Error;
+  }
+
   Status = gBS->InstallProtocolInterface (
                   &Controller,
                   &gEfiExtScsiPassThruProtocolGuid,
@@ -899,6 +928,10 @@ UfsPassThruDriverBindingStart (
       UfsHc->FreeBuffer (UfsHc, EFI_SIZE_TO_PAGES (Private->Nutrs * sizeof (UTP_TMRD)), Private->UtpTrlBase);
     }
 
+    if (Private->TimerEvent != NULL) {
+      gBS->CloseEvent (Private->TimerEvent);
+    }
+
     FreePool (Private);
   }
 
@@ -953,6 +986,9 @@ UfsPassThruDriverBindingStop (
   UFS_PASS_THRU_PRIVATE_DATA            *Private;
   EFI_EXT_SCSI_PASS_THRU_PROTOCOL       *ExtScsiPassThru;
   EDKII_UFS_HOST_CONTROLLER_PROTOCOL    *UfsHc;
+  UFS_PASS_THRU_TRANS_REQ               *TransReq;
+  LIST_ENTRY                            *Entry;
+  LIST_ENTRY                            *NextEntry;
 
   DEBUG ((EFI_D_INFO, "==UfsPassThru Stop== Controller Controller = %x\n", Controller));
 
@@ -972,6 +1008,24 @@ UfsPassThruDriverBindingStop (
   Private = UFS_PASS_THRU_PRIVATE_DATA_FROM_THIS (ExtScsiPassThru);
   UfsHc   = Private->UfsHostController;
 
+  //
+  // Cleanup the resources of I/O requests in the async I/O queue
+  //
+  if (!IsListEmpty(&Private->Queue)) {
+    EFI_LIST_FOR_EACH_SAFE (Entry, NextEntry, &Private->Queue) {
+      TransReq  = UFS_PASS_THRU_TRANS_REQ_FROM_THIS (Entry);
+
+      //
+      // TODO: Should find/add a proper host adapter return status for this
+      // case.
+      //
+      TransReq->Packet->HostAdapterStatus =
+        EFI_EXT_SCSI_STATUS_HOST_ADAPTER_PHASE_ERROR;
+
+      SignalCallerEvent (Private, TransReq);
+    }
+  }
+
   Status = gBS->UninstallProtocolInterface (
                   Controller,
                   &gEfiExtScsiPassThruProtocolGuid,
@@ -1002,6 +1056,10 @@ UfsPassThruDriverBindingStop (
     UfsHc->FreeBuffer (UfsHc, EFI_SIZE_TO_PAGES (Private->Nutrs * sizeof (UTP_TMRD)), Private->UtpTrlBase);
   }
 
+  if (Private->TimerEvent != NULL) {
+    gBS->CloseEvent (Private->TimerEvent);
+  }
+
   FreePool (Private);
 
   //
diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.h b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.h
index ce8066f71e84..4f7087f44f42 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.h
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.h
@@ -50,6 +50,14 @@ typedef struct {
   UINT16   Rsvd:4;
 } UFS_EXPOSED_LUNS;
 
+//
+// Iterate through the doule linked list. This is delete-safe.
+// Do not touch NextEntry
+//
+#define EFI_LIST_FOR_EACH_SAFE(Entry, NextEntry, ListHead)            \
+  for(Entry = (ListHead)->ForwardLink, NextEntry = Entry->ForwardLink;\
+      Entry != (ListHead); Entry = NextEntry, NextEntry = Entry->ForwardLink)
+
 typedef struct _UFS_PASS_THRU_PRIVATE_DATA {  
   UINT32                              Signature;
   EFI_HANDLE                          Handle;
@@ -69,9 +77,37 @@ typedef struct _UFS_PASS_THRU_PRIVATE_DATA {
   VOID                                *TmrlMapping;
 
   UFS_EXPOSED_LUNS                    Luns;
+
+  //
+  // For Non-blocking operation.
+  //
+  EFI_EVENT                           TimerEvent;
+  LIST_ENTRY                          Queue;
 } UFS_PASS_THRU_PRIVATE_DATA;
 
+#define UFS_PASS_THRU_TRANS_REQ_SIG   SIGNATURE_32 ('U', 'F', 'S', 'T')
+
+typedef struct {
+  UINT32                                        Signature;
+  LIST_ENTRY                                    TransferList;
+
+  UINT8                                         Slot;
+  UTP_TRD                                       *Trd;
+  UINT32                                        CmdDescSize;
+  VOID                                          *CmdDescHost;
+  VOID                                          *CmdDescMapping;
+  VOID                                          *DataBufMapping;
+
+  EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET    *Packet;
+  UINT64                                        TimeoutRemain;
+  EFI_EVENT                                     CallerEvent;
+} UFS_PASS_THRU_TRANS_REQ;
+
+#define UFS_PASS_THRU_TRANS_REQ_FROM_THIS(a) \
+    CR(a, UFS_PASS_THRU_TRANS_REQ, TransferList, UFS_PASS_THRU_TRANS_REQ_SIG)
+
 #define UFS_TIMEOUT                   EFI_TIMER_PERIOD_SECONDS(3)
+#define UFS_HC_ASYNC_TIMER            EFI_TIMER_PERIOD_MILLISECONDS(1)
 
 #define ROUNDUP8(x) (((x) % 8 == 0) ? (x) : ((x) / 8 + 1) * 8)
 
@@ -587,6 +623,11 @@ UfsPassThruGetNextTarget (
   @param[in]      Lun           The LUN of the UFS device to send the SCSI Request Packet.
   @param[in, out] Packet        A pointer to the SCSI Request Packet to send to a specified Lun of the
                                 UFS device.
+  @param[in]      Event         If nonblocking I/O is not supported then Event is ignored, and blocking
+                                I/O is performed. If Event is NULL, then blocking I/O is performed. If
+                                Event is not NULL and non blocking I/O is supported, then
+                                nonblocking I/O is performed, and Event will be signaled when the
+                                SCSI Request Packet completes.
 
   @retval EFI_SUCCESS           The SCSI Request Packet was sent by the host. For bi-directional
                                 commands, InTransferLength bytes were transferred from
@@ -603,7 +644,8 @@ EFI_STATUS
 UfsExecScsiCmds (
   IN     UFS_PASS_THRU_PRIVATE_DATA                  *Private,
   IN     UINT8                                       Lun,
-  IN OUT EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET  *Packet
+  IN OUT EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET  *Packet,
+  IN     EFI_EVENT                                   Event    OPTIONAL
   );
 
 /**
@@ -719,6 +761,37 @@ UfsExecNopCmds (
   IN  UFS_PASS_THRU_PRIVATE_DATA       *Private
   );
 
+/**
+  Call back function when the timer event is signaled.
+
+  @param[in]  Event     The Event this notify function registered to.
+  @param[in]  Context   Pointer to the context data registered to the Event.
+
+**/
+VOID
+EFIAPI
+ProcessAsyncTaskList (
+  IN EFI_EVENT          Event,
+  IN VOID               *Context
+  );
+
+/**
+  Internal helper function which will signal the caller event and clean up
+  resources.
+
+  @param[in] Private   The pointer to the UFS_PASS_THRU_PRIVATE_DATA data
+                       structure.
+  @param[in] TransReq  The pointer to the UFS_PASS_THRU_TRANS_REQ data
+                       structure.
+
+**/
+VOID
+EFIAPI
+SignalCallerEvent (
+  IN UFS_PASS_THRU_PRIVATE_DATA      *Private,
+  IN UFS_PASS_THRU_TRANS_REQ         *TransReq
+  );
+
 extern EFI_COMPONENT_NAME_PROTOCOL  gUfsPassThruComponentName;
 extern EFI_COMPONENT_NAME2_PROTOCOL gUfsPassThruComponentName2;
 extern EFI_DRIVER_BINDING_PROTOCOL  gUfsPassThruDriverBinding;
diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
index 9f9abab40fde..4fbe199390f4 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
@@ -729,6 +729,7 @@ UfsCreateNopCommandDesc (
   @param[out] Slot          The available slot.
 
   @retval EFI_SUCCESS       The available slot was found successfully.
+  @retval EFI_NOT_READY     No slot is available at this moment.
 
 **/
 EFI_STATUS
@@ -737,15 +738,28 @@ UfsFindAvailableSlotInTrl (
      OUT UINT8                        *Slot
   )
 {
+  UINT8            Nutrs;
+  UINT8            Index;
+  UINT32           Data;
+  EFI_STATUS       Status;
+
   ASSERT ((Private != NULL) && (Slot != NULL));
 
-  //
-  // The simplest algo to always use slot 0.
-  // TODO: enhance it to support async transfer with multiple slot.
-  //
-  *Slot = 0;
+  Status  = UfsMmioRead32 (Private, UFS_HC_UTRLDBR_OFFSET, &Data);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
 
-  return EFI_SUCCESS;
+  Nutrs   = (UINT8)((Private->Capabilities & UFS_HC_CAP_NUTRS) + 1);
+
+  for (Index = 0; Index < Nutrs; Index++) {
+    if ((Data & (BIT0 << Index)) == 0) {
+      *Slot = Index;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_NOT_READY;
 }
 
 /**
@@ -1382,6 +1396,11 @@ UfsExecNopCmds (
   @param[in]      Lun           The LUN of the UFS device to send the SCSI Request Packet.
   @param[in, out] Packet        A pointer to the SCSI Request Packet to send to a specified Lun of the
                                 UFS device.
+  @param[in]      Event         If nonblocking I/O is not supported then Event is ignored, and blocking
+                                I/O is performed. If Event is NULL, then blocking I/O is performed. If
+                                Event is not NULL and non blocking I/O is supported, then
+                                nonblocking I/O is performed, and Event will be signaled when the
+                                SCSI Request Packet completes.
 
   @retval EFI_SUCCESS           The SCSI Request Packet was sent by the host. For bi-directional
                                 commands, InTransferLength bytes were transferred from
@@ -1398,19 +1417,14 @@ EFI_STATUS
 UfsExecScsiCmds (
   IN     UFS_PASS_THRU_PRIVATE_DATA                  *Private,
   IN     UINT8                                       Lun,
-  IN OUT EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET  *Packet
+  IN OUT EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET  *Packet,
+  IN     EFI_EVENT                                   Event    OPTIONAL
   )
 {
   EFI_STATUS                           Status;
-  UINT8                                Slot;
-  UTP_TRD                              *Trd;
-  UINT32                               CmdDescSize;
   UTP_RESPONSE_UPIU                    *Response;
   UINT16                               SenseDataLen;
   UINT32                               ResTranCount;
-  VOID                                 *CmdDescHost;
-  VOID                                 *CmdDescMapping;
-  VOID                                 *DataBufMapping;
   VOID                                 *DataBuf;
   EFI_PHYSICAL_ADDRESS                 DataBufPhyAddr;
   UINT32                               DataLen;
@@ -1419,32 +1433,44 @@ UfsExecScsiCmds (
   EDKII_UFS_HOST_CONTROLLER_OPERATION  Flag;
   UFS_DATA_DIRECTION                   DataDirection;
   UTP_TR_PRD                           *PrdtBase;
+  EFI_TPL                              OldTpl;
+  UFS_PASS_THRU_TRANS_REQ              *TransReq;
 
-  Trd            = NULL;
-  CmdDescHost    = NULL;
-  CmdDescMapping = NULL;
-  DataBufMapping = NULL;
+  TransReq       = AllocateZeroPool (sizeof (UFS_PASS_THRU_TRANS_REQ));
+  if (TransReq == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+
+  TransReq->Signature     = UFS_PASS_THRU_TRANS_REQ_SIG;
+  TransReq->TimeoutRemain = Packet->Timeout;
   DataBufPhyAddr = 0;
   UfsHc          = Private->UfsHostController;
   //
   // Find out which slot of transfer request list is available.
   //
-  Status = UfsFindAvailableSlotInTrl (Private, &Slot);
+  Status = UfsFindAvailableSlotInTrl (Private, &TransReq->Slot);
   if (EFI_ERROR (Status)) {
     return Status;
   }
 
-  Trd = ((UTP_TRD*)Private->UtpTrlBase) + Slot;
+  TransReq->Trd = ((UTP_TRD*)Private->UtpTrlBase) + TransReq->Slot;
 
   //
   // Fill transfer request descriptor to this slot.
   //
-  Status = UfsCreateScsiCommandDesc (Private, Lun, Packet, Trd, &CmdDescHost, &CmdDescMapping);
+  Status = UfsCreateScsiCommandDesc (
+             Private,
+             Lun,
+             Packet,
+             TransReq->Trd,
+             &TransReq->CmdDescHost,
+             &TransReq->CmdDescMapping
+             );
   if (EFI_ERROR (Status)) {
     return Status;
   }
 
-  CmdDescSize = Trd->PrdtO * sizeof (UINT32) + Trd->PrdtL * sizeof (UTP_TR_PRD);
+  TransReq->CmdDescSize = TransReq->Trd->PrdtO * sizeof (UINT32) + TransReq->Trd->PrdtL * sizeof (UTP_TR_PRD);
 
   if (Packet->DataDirection == EFI_EXT_SCSI_DATA_DIRECTION_READ) {
     DataBuf       = Packet->InDataBuffer;
@@ -1468,7 +1494,7 @@ UfsExecScsiCmds (
                          DataBuf,
                          &MapLength,
                          &DataBufPhyAddr,
-                         &DataBufMapping
+                         &TransReq->DataBufMapping
                          );
 
     if (EFI_ERROR (Status) || (DataLen != MapLength)) {
@@ -1478,14 +1504,32 @@ UfsExecScsiCmds (
   //
   // Fill PRDT table of Command UPIU for executed SCSI cmd.
   //
-  PrdtBase = (UTP_TR_PRD*)((UINT8*)CmdDescHost + ROUNDUP8 (sizeof (UTP_COMMAND_UPIU)) + ROUNDUP8 (sizeof (UTP_RESPONSE_UPIU)));
+  PrdtBase = (UTP_TR_PRD*)((UINT8*)TransReq->CmdDescHost + ROUNDUP8 (sizeof (UTP_COMMAND_UPIU)) + ROUNDUP8 (sizeof (UTP_RESPONSE_UPIU)));
   ASSERT (PrdtBase != NULL);
   UfsInitUtpPrdt (PrdtBase, (VOID*)(UINTN)DataBufPhyAddr, DataLen);
 
+  //
+  // Insert the async SCSI cmd to the Async I/O list
+  //
+  if (Event != NULL) {
+    OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+    TransReq->Packet      = Packet;
+    TransReq->CallerEvent = Event;
+    InsertTailList (&Private->Queue, &TransReq->TransferList);
+    gBS->RestoreTPL (OldTpl);
+  }
+
   //
   // Start to execute the transfer request.
   //
-  UfsStartExecCmd (Private, Slot);
+  UfsStartExecCmd (Private, TransReq->Slot);
+
+  //
+  // Immediately return for async I/O.
+  //
+  if (Event != NULL) {
+    return EFI_SUCCESS;
+  }
 
   //
   // Wait for the completion of the transfer request.
@@ -1498,7 +1542,7 @@ UfsExecScsiCmds (
   //
   // Get sense data if exists
   //
-  Response     = (UTP_RESPONSE_UPIU*)((UINT8*)CmdDescHost + Trd->RuO * sizeof (UINT32));
+  Response     = (UTP_RESPONSE_UPIU*)((UINT8*)TransReq->CmdDescHost + TransReq->Trd->RuO * sizeof (UINT32));
   ASSERT (Response != NULL);
   SenseDataLen = Response->SenseDataLen;
   SwapLittleEndianToBigEndian ((UINT8*)&SenseDataLen, sizeof (UINT16));
@@ -1518,7 +1562,7 @@ UfsExecScsiCmds (
     goto Exit;
   }
 
-  if (Trd->Ocs == 0) {
+  if (TransReq->Trd->Ocs == 0) {
     if (Packet->DataDirection == EFI_EXT_SCSI_DATA_DIRECTION_READ) {
       if ((Response->Flags & BIT5) == BIT5) {
         ResTranCount = Response->ResTranCount;
@@ -1539,18 +1583,21 @@ UfsExecScsiCmds (
 Exit:
   UfsHc->Flush (UfsHc);
 
-  UfsStopExecCmd (Private, Slot);
+  UfsStopExecCmd (Private, TransReq->Slot);
 
-  if (DataBufMapping != NULL) {
-    UfsHc->Unmap (UfsHc, DataBufMapping);
+  if (TransReq->DataBufMapping != NULL) {
+    UfsHc->Unmap (UfsHc, TransReq->DataBufMapping);
   }
 
 Exit1:
-  if (CmdDescMapping != NULL) {
-    UfsHc->Unmap (UfsHc, CmdDescMapping);
+  if (TransReq->CmdDescMapping != NULL) {
+    UfsHc->Unmap (UfsHc, TransReq->CmdDescMapping);
   }
-  if (CmdDescHost != NULL) {
-    UfsHc->FreeBuffer (UfsHc, EFI_SIZE_TO_PAGES (CmdDescSize), CmdDescHost);
+  if (TransReq->CmdDescHost != NULL) {
+    UfsHc->FreeBuffer (UfsHc, EFI_SIZE_TO_PAGES (TransReq->CmdDescSize), TransReq->CmdDescHost);
+  }
+  if (TransReq != NULL) {
+    FreePool (TransReq);
   }
   return Status;
 }
@@ -2123,3 +2170,178 @@ UfsControllerStop (
   return EFI_SUCCESS;
 }
 
+
+/**
+  Internal helper function which will signal the caller event and clean up
+  resources.
+
+  @param[in] Private   The pointer to the UFS_PASS_THRU_PRIVATE_DATA data
+                       structure.
+  @param[in] TransReq  The pointer to the UFS_PASS_THRU_TRANS_REQ data
+                       structure.
+
+**/
+VOID
+EFIAPI
+SignalCallerEvent (
+  IN UFS_PASS_THRU_PRIVATE_DATA      *Private,
+  IN UFS_PASS_THRU_TRANS_REQ         *TransReq
+  )
+{
+  EDKII_UFS_HOST_CONTROLLER_PROTOCOL *UfsHc;
+  EFI_EVENT                          CallerEvent;
+
+  UfsHc        = Private->UfsHostController;
+  CallerEvent  = TransReq->CallerEvent;
+
+  RemoveEntryList (&TransReq->TransferList);
+
+  UfsHc->Flush (UfsHc);
+
+  UfsStopExecCmd (Private, TransReq->Slot);
+
+  if (TransReq->DataBufMapping != NULL) {
+    UfsHc->Unmap (UfsHc, TransReq->DataBufMapping);
+  }
+
+  if (TransReq->CmdDescMapping != NULL) {
+    UfsHc->Unmap (UfsHc, TransReq->CmdDescMapping);
+  }
+  if (TransReq->CmdDescHost != NULL) {
+    UfsHc->FreeBuffer (
+             UfsHc,
+             EFI_SIZE_TO_PAGES (TransReq->CmdDescSize),
+             TransReq->CmdDescHost
+             );
+  }
+  if (TransReq != NULL) {
+    FreePool (TransReq);
+  }
+
+  gBS->SignalEvent (CallerEvent);
+  return;
+}
+
+/**
+  Call back function when the timer event is signaled.
+
+  @param[in]  Event     The Event this notify function registered to.
+  @param[in]  Context   Pointer to the context data registered to the Event.
+
+**/
+VOID
+EFIAPI
+ProcessAsyncTaskList (
+  IN EFI_EVENT          Event,
+  IN VOID               *Context
+  )
+{
+  UFS_PASS_THRU_PRIVATE_DATA                    *Private;
+  LIST_ENTRY                                    *Entry;
+  LIST_ENTRY                                    *NextEntry;
+  UFS_PASS_THRU_TRANS_REQ                       *TransReq;
+  EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET    *Packet;
+  UTP_RESPONSE_UPIU                             *Response;
+  UINT16                                        SenseDataLen;
+  UINT32                                        ResTranCount;
+  UINT32                                        SlotsMap;
+  UINT32                                        Value;
+  EFI_STATUS                                    Status;
+
+  Private   = (UFS_PASS_THRU_PRIVATE_DATA*) Context;
+  SlotsMap  = 0;
+
+  //
+  // Check the entries in the async I/O queue are done or not.
+  //
+  if (!IsListEmpty(&Private->Queue)) {
+    EFI_LIST_FOR_EACH_SAFE (Entry, NextEntry, &Private->Queue) {
+      TransReq  = UFS_PASS_THRU_TRANS_REQ_FROM_THIS (Entry);
+      Packet    = TransReq->Packet;
+
+      if ((SlotsMap & (BIT0 << TransReq->Slot)) != 0) {
+        return;
+      }
+      SlotsMap |= BIT0 << TransReq->Slot;
+
+      Status = UfsMmioRead32 (Private, UFS_HC_UTRLDBR_OFFSET, &Value);
+      if (EFI_ERROR (Status)) {
+        //
+        // TODO: Should find/add a proper host adapter return status for this
+        // case.
+        //
+        Packet->HostAdapterStatus = EFI_EXT_SCSI_STATUS_HOST_ADAPTER_PHASE_ERROR;
+        DEBUG ((EFI_D_VERBOSE, "ProcessAsyncTaskList(): Signal Event %p UfsMmioRead32() Error.\n", TransReq->CallerEvent));
+        SignalCallerEvent (Private, TransReq);
+        continue;
+      }
+
+      if ((Value & (BIT0 << TransReq->Slot)) != 0) {
+        //
+        // Scsi cmd not finished yet.
+        //
+        if (TransReq->TimeoutRemain > UFS_HC_ASYNC_TIMER) {
+          TransReq->TimeoutRemain -= UFS_HC_ASYNC_TIMER;
+          continue;
+        } else {
+          //
+          // Timeout occurs.
+          //
+          Packet->HostAdapterStatus = EFI_EXT_SCSI_STATUS_HOST_ADAPTER_TIMEOUT_COMMAND;
+          DEBUG ((EFI_D_VERBOSE, "ProcessAsyncTaskList(): Signal Event %p EFI_TIMEOUT.\n", TransReq->CallerEvent));
+          SignalCallerEvent (Private, TransReq);
+          continue;
+        }
+      } else {
+        //
+        // Scsi cmd finished.
+        //
+        // Get sense data if exists
+        //
+        Response = (UTP_RESPONSE_UPIU*)((UINT8*)TransReq->CmdDescHost + TransReq->Trd->RuO * sizeof (UINT32));
+        ASSERT (Response != NULL);
+        SenseDataLen = Response->SenseDataLen;
+        SwapLittleEndianToBigEndian ((UINT8*)&SenseDataLen, sizeof (UINT16));
+
+        if ((Packet->SenseDataLength != 0) && (Packet->SenseData != NULL)) {
+          CopyMem (Packet->SenseData, Response->SenseData, SenseDataLen);
+          Packet->SenseDataLength = (UINT8)SenseDataLen;
+        }
+
+        //
+        // Check the transfer request result.
+        //
+        Packet->TargetStatus = Response->Status;
+        if (Response->Response != 0) {
+          DEBUG ((EFI_D_VERBOSE, "ProcessAsyncTaskList(): Signal Event %p Target Failure.\n", TransReq->CallerEvent));
+          SignalCallerEvent (Private, TransReq);
+          continue;
+        }
+
+        if (TransReq->Trd->Ocs == 0) {
+          if (Packet->DataDirection == EFI_EXT_SCSI_DATA_DIRECTION_READ) {
+            if ((Response->Flags & BIT5) == BIT5) {
+              ResTranCount = Response->ResTranCount;
+              SwapLittleEndianToBigEndian ((UINT8*)&ResTranCount, sizeof (UINT32));
+              Packet->InTransferLength -= ResTranCount;
+            }
+          } else {
+            if ((Response->Flags & BIT5) == BIT5) {
+              ResTranCount = Response->ResTranCount;
+              SwapLittleEndianToBigEndian ((UINT8*)&ResTranCount, sizeof (UINT32));
+              Packet->OutTransferLength -= ResTranCount;
+            }
+          }
+        } else {
+          DEBUG ((EFI_D_VERBOSE, "ProcessAsyncTaskList(): Signal Event %p Target Device Error.\n", TransReq->CallerEvent));
+          SignalCallerEvent (Private, TransReq);
+          continue;
+        }
+
+        DEBUG ((EFI_D_VERBOSE, "ProcessAsyncTaskList(): Signal Event %p Success.\n", TransReq->CallerEvent));
+        SignalCallerEvent (Private, TransReq);
+      }
+    }
+  }
+}
+

From 12c0612023fc1f6f1d62f21810ab146f8e3c6016 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 11 Dec 2015 07:36:06 +0000
Subject: [PATCH 238/525] MdeModulePkg ScsiBusDxe: Fix caller event may nerver
 be signaled

For function ScsiExecuteSCSICommand(), when the 'Event' parameter is not
NULL but the target SCSI device does not support non-blocking I/O, it will
execute a blocking I/O operation instead.

However, after the SCSI operation is done, the 'Event' is not signaled to
inform the caller.

(Sync patch r19217 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19224 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c | 46 +++++++++++++++++-----
 1 file changed, 37 insertions(+), 9 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
index 3e49ffba6888..8eb73e7673fa 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
@@ -2,7 +2,7 @@
   SCSI Bus driver that layers on every SCSI Pass Thru and
   Extended SCSI Pass Thru protocol in the system.
 
-Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -986,13 +986,34 @@ ScsiExecuteSCSICommand (
 
   if (ScsiIoDevice->ExtScsiSupport) {
     ExtRequestPacket = (EFI_EXT_SCSI_PASS_THRU_SCSI_REQUEST_PACKET *) Packet;
-    Status = ScsiIoDevice->ExtScsiPassThru->PassThru (
-                                          ScsiIoDevice->ExtScsiPassThru,
-                                          Target,
-                                          ScsiIoDevice->Lun,
-                                          ExtRequestPacket,
-                                          Event
-                                          );
+
+    if (((ScsiIoDevice->ExtScsiPassThru->Mode->Attributes & EFI_SCSI_PASS_THRU_ATTRIBUTES_NONBLOCKIO) != 0) && (Event !=  NULL)) {
+      Status = ScsiIoDevice->ExtScsiPassThru->PassThru (
+                                                ScsiIoDevice->ExtScsiPassThru,
+                                                Target,
+                                                ScsiIoDevice->Lun,
+                                                ExtRequestPacket,
+                                                Event
+                                                );
+    } else {
+      //
+      // If there's no event or the SCSI Device doesn't support NON-BLOCKING,
+      // let the 'Event' parameter for PassThru() be NULL.
+      //
+      Status = ScsiIoDevice->ExtScsiPassThru->PassThru (
+                                                ScsiIoDevice->ExtScsiPassThru,
+                                                Target,
+                                                ScsiIoDevice->Lun,
+                                                ExtRequestPacket,
+                                                NULL
+                                                );
+      if (Event != NULL) {
+        //
+        // Signal Event to tell caller to pick up the SCSI IO Packet.
+        //
+        gBS->SignalEvent (Event);
+      }
+    }
   } else {
 
     mWorkingBuffer = AllocatePool (sizeof(EFI_SCSI_PASS_THRU_SCSI_REQUEST_PACKET));
@@ -1052,7 +1073,7 @@ ScsiExecuteSCSICommand (
                                           ScsiIoDevice->Pun.ScsiId.Scsi,
                                           ScsiIoDevice->Lun,
                                           mWorkingBuffer,
-                                          Event
+                                          NULL
                                           );
       if (EFI_ERROR(Status)) {
         FreePool(mWorkingBuffer);
@@ -1065,6 +1086,13 @@ ScsiExecuteSCSICommand (
       // free mWorkingBuffer.
       //
       FreePool(mWorkingBuffer);
+
+      //
+      // Signal Event to tell caller to pick up the SCSI IO Packet.
+      //
+      if (Event != NULL) {
+        gBS->SignalEvent (Event);
+      }
     }
   }
   return Status;

From 6ba6beac50740f3d6d9d68889a646f169650006f Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Fri, 11 Dec 2015 07:41:49 +0000
Subject: [PATCH 239/525] CryptoPkg/OpensslLib: upgrade OpenSSL version to
 1.0.2e

OpenSSL has released version 1.0.2e with security fixes.
Upgrade the supported OpenSSL version in CryptoPkg/OpensslLib
from 1.0.2d to 1.0.2e.
(Note: This is based on Ard's previous patch with extra fix
       https://rt.openssl.org/Ticket/Display.html?id=4175)

(Sync patch r19218 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Singed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19225 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 380 ----------
 .../OpensslLib/EDKII_openssl-1.0.2e.patch     | 707 ++++++++++++++++++
 CryptoPkg/Library/OpensslLib/Install.cmd      |   2 +-
 CryptoPkg/Library/OpensslLib/Install.sh       | 158 ++--
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |   2 +-
 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt  |  26 +-
 6 files changed, 801 insertions(+), 474 deletions(-)
 delete mode 100644 CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
 create mode 100644 CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
deleted file mode 100644
index 72e5f3da54c4..000000000000
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ /dev/null
@@ -1,380 +0,0 @@
-diff U3 crypto/bio/bio.h crypto/bio/bio.h
---- crypto/bio/bio.h	Thu Jun 11 21:50:12 2015
-+++ crypto/bio/bio.h	Fri Jun 12 11:00:52 2015
-@@ -646,10 +646,10 @@
- int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix,
-                         asn1_ps_func **psuffix_free);
- 
--# ifndef OPENSSL_NO_FP_API
- BIO_METHOD *BIO_s_file(void);
- BIO *BIO_new_file(const char *filename, const char *mode);
- BIO *BIO_new_fp(FILE *stream, int close_flag);
-+# ifndef OPENSSL_NO_FP_API
- #  define BIO_s_file_internal    BIO_s_file
- # endif
- BIO *BIO_new(BIO_METHOD *type);
-diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
---- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
-+++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
-@@ -460,6 +460,23 @@
-     return (ret);
- }
- 
-+# else
-+
-+BIO_METHOD *BIO_s_file(void)
-+{
-+    return NULL;
-+}
-+
-+BIO *BIO_new_file(const char *filename, const char *mode)
-+{
-+    return NULL;
-+}
-+
-+BIO *BIO_new_fp(FILE *stream, int close_flag)
-+{
-+    return NULL;
-+}
-+
- # endif                         /* OPENSSL_NO_STDIO */
- 
- #endif                          /* HEADER_BSS_FILE_C */
-diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
---- crypto/dh/dh_pmeth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/dh/dh_pmeth.c	Fri Jun 12 11:08:48 2015
-@@ -449,6 +449,9 @@
-         *keylen = ret;
-         return 1;
-     } else if (dctx->kdf_type == EVP_PKEY_DH_KDF_X9_42) {
-+#ifdef OPENSSL_NO_CMS
-+        return 0;
-+#else
-         unsigned char *Z = NULL;
-         size_t Zlen = 0;
-         if (!dctx->kdf_outlen || !dctx->kdf_oid)
-@@ -478,6 +481,7 @@
-             OPENSSL_free(Z);
-         }
-         return ret;
-+#endif
-     }
-     return 1;
- }
-diff U3 crypto/pem/pem.h crypto/pem/pem.h
---- crypto/pem/pem.h	Thu Jun 11 21:50:12 2015
-+++ crypto/pem/pem.h	Fri Jun 12 10:58:18 2015
-@@ -324,6 +324,7 @@
- 
- #  define DECLARE_PEM_read_fp(name, type) /**/
- #  define DECLARE_PEM_write_fp(name, type) /**/
-+#  define DECLARE_PEM_write_fp_const(name, type) /**/
- #  define DECLARE_PEM_write_cb_fp(name, type) /**/
- # else
- 
-diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
---- crypto/pkcs7/pk7_smime.c	Thu Jun 11 21:01:06 2015
-+++ crypto/pkcs7/pk7_smime.c	Fri Jun 12 11:23:38 2015
-@@ -254,7 +254,8 @@
-     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
-     PKCS7_SIGNER_INFO *si;
-     X509_STORE_CTX cert_ctx;
--    char buf[4096];
-+    char *buf = NULL;
-+    int bufsiz;
-     int i, j = 0, k, ret = 0;
-     BIO *p7bio;
-     BIO *tmpin, *tmpout;
-@@ -365,9 +366,14 @@
-     } else
-         tmpout = out;
- 
-+    bufsiz = 4096;
-+    buf = OPENSSL_malloc(bufsiz);
-+    if (buf == NULL) {
-+        goto err;
-+    }
-     /* We now have to 'read' from p7bio to calculate digests etc. */
-     for (;;) {
--        i = BIO_read(p7bio, buf, sizeof(buf));
-+        i = BIO_read(p7bio, buf, bufsiz);
-         if (i <= 0)
-             break;
-         if (tmpout)
-@@ -406,6 +412,10 @@
-     BIO_free_all(p7bio);
- 
-     sk_X509_free(signers);
-+
-+    if (buf != NULL) {
-+      OPENSSL_free(buf);
-+    }
- 
-     return ret;
- }
-diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
---- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
-+++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
-@@ -116,7 +116,7 @@
- #include <openssl/rand.h>
- #include "rand_lcl.h"
- 
--#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE))
-+#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE) || defined(OPENSSL_SYS_UEFI))
- 
- # include <sys/types.h>
- # include <sys/time.h>
-@@ -439,7 +439,7 @@
-                                  * defined(OPENSSL_SYS_VXWORKS) ||
-                                  * defined(OPENSSL_SYS_NETWARE)) */
- 
--#if defined(OPENSSL_SYS_VXWORKS)
-+#if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI)
- int RAND_poll(void)
- {
-     return 0;
-diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
---- crypto/rsa/rsa_ameth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/rsa/rsa_ameth.c	Fri Jun 12 10:45:38 2015
-@@ -68,10 +68,12 @@
- #endif
- #include "asn1_locl.h"
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_sign(CMS_SignerInfo *si);
- static int rsa_cms_verify(CMS_SignerInfo *si);
- static int rsa_cms_decrypt(CMS_RecipientInfo *ri);
- static int rsa_cms_encrypt(CMS_RecipientInfo *ri);
-+#endif
- 
- static int rsa_pub_encode(X509_PUBKEY *pk, const EVP_PKEY *pkey)
- {
-@@ -665,6 +667,7 @@
-     return rv;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_verify(CMS_SignerInfo *si)
- {
-     int nid, nid2;
-@@ -683,6 +686,7 @@
-     }
-     return 0;
- }
-+#endif
- 
- /*
-  * Customised RSA item verification routine. This is called when a signature
-@@ -705,6 +709,7 @@
-     return -1;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_sign(CMS_SignerInfo *si)
- {
-     int pad_mode = RSA_PKCS1_PADDING;
-@@ -729,6 +734,7 @@
-     X509_ALGOR_set0(alg, OBJ_nid2obj(NID_rsassaPss), V_ASN1_SEQUENCE, os);
-     return 1;
- }
-+#endif
- 
- static int rsa_item_sign(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
-                          X509_ALGOR *alg1, X509_ALGOR *alg2,
-@@ -785,6 +791,7 @@
-     return pss;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_decrypt(CMS_RecipientInfo *ri)
- {
-     EVP_PKEY_CTX *pkctx;
-@@ -857,7 +864,9 @@
-         X509_ALGOR_free(maskHash);
-     return rv;
- }
-+#endif
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_encrypt(CMS_RecipientInfo *ri)
- {
-     const EVP_MD *md, *mgf1md;
-@@ -920,6 +929,7 @@
-         ASN1_STRING_free(os);
-     return rv;
- }
-+#endif
- 
- const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[] = {
-     {
-diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
---- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
-+++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
-@@ -1653,6 +1653,10 @@
- 
- static int check_cert_time(X509_STORE_CTX *ctx, X509 *x)
- {
-+#ifdef OPENSSL_SYS_UEFI
-+    /* Bypass Certificate Time Checking for UEFI version. */
-+    return 1;
-+#else
-     time_t *ptime;
-     int i;
- 
-@@ -1692,6 +1696,7 @@
-     }
- 
-     return 1;
-+#endif
- }
- 
- static int internal_verify(X509_STORE_CTX *ctx)
-diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
---- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
-+++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015
-@@ -127,8 +127,10 @@
-     &v3_idp,
-     &v3_alt[2],
-     &v3_freshest_crl,
-+#ifndef OPENSSL_SYS_UEFI
-     &v3_ct_scts[0],
-     &v3_ct_scts[1],
-+#endif
- };
- 
- /* Number of standard extensions */
-diff U3 crypto/crypto.h crypto/crypto.h
---- crypto/crypto.h	Thu Jun 11 21:01:06 2015
-+++ crypto/crypto.h	Fri Jun 12 11:33:27 2015
-@@ -235,15 +235,15 @@
- # ifndef OPENSSL_NO_LOCKING
- #  ifndef CRYPTO_w_lock
- #   define CRYPTO_w_lock(type)     \
--        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,NULL,0)
- #   define CRYPTO_w_unlock(type)   \
--        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,NULL,0)
- #   define CRYPTO_r_lock(type)     \
--        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,NULL,0)
- #   define CRYPTO_r_unlock(type)   \
--        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,NULL,0)
- #   define CRYPTO_add(addr,amount,type)    \
--        CRYPTO_add_lock(addr,amount,type,__FILE__,__LINE__)
-+        CRYPTO_add_lock(addr,amount,type,NULL,0)
- #  endif
- # else
- #  define CRYPTO_w_lock(a)
-@@ -378,19 +378,19 @@
- # define MemCheck_off()  CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE)
- # define is_MemCheck_on() CRYPTO_is_mem_check_on()
- 
--# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,__FILE__,__LINE__)
--# define OPENSSL_strdup(str)     CRYPTO_strdup((str),__FILE__,__LINE__)
-+# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,NULL,0)
-+# define OPENSSL_strdup(str)     CRYPTO_strdup((str),NULL,0)
- # define OPENSSL_realloc(addr,num) \
--        CRYPTO_realloc((char *)addr,(int)num,__FILE__,__LINE__)
-+        CRYPTO_realloc((char *)addr,(int)num,NULL,0)
- # define OPENSSL_realloc_clean(addr,old_num,num) \
--        CRYPTO_realloc_clean(addr,old_num,num,__FILE__,__LINE__)
-+        CRYPTO_realloc_clean(addr,old_num,num,NULL,0)
- # define OPENSSL_remalloc(addr,num) \
--        CRYPTO_remalloc((char **)addr,(int)num,__FILE__,__LINE__)
-+        CRYPTO_remalloc((char **)addr,(int)num,NULL,0)
- # define OPENSSL_freeFunc        CRYPTO_free
- # define OPENSSL_free(addr)      CRYPTO_free(addr)
- 
- # define OPENSSL_malloc_locked(num) \
--        CRYPTO_malloc_locked((int)num,__FILE__,__LINE__)
-+        CRYPTO_malloc_locked((int)num,NULL,0)
- # define OPENSSL_free_locked(addr) CRYPTO_free_locked(addr)
- 
- const char *SSLeay_version(int type);
-@@ -545,7 +545,7 @@
- long CRYPTO_get_mem_debug_options(void);
- 
- # define CRYPTO_push_info(info) \
--        CRYPTO_push_info_(info, __FILE__, __LINE__);
-+        CRYPTO_push_info_(info, NULL, 0);
- int CRYPTO_push_info_(const char *info, const char *file, int line);
- int CRYPTO_pop_info(void);
- int CRYPTO_remove_all_info(void);
-@@ -588,7 +588,7 @@
- 
- /* die if we have to */
- void OpenSSLDie(const char *file, int line, const char *assertion);
--# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(__FILE__, __LINE__, #e),1))
-+# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(NULL, 0, #e),1))
- 
- unsigned long *OPENSSL_ia32cap_loc(void);
- # define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc()))
-@@ -605,14 +605,14 @@
- #  define fips_md_init_ctx(alg, cx) \
-         int alg##_Init(cx##_CTX *c) \
-         { \
--        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
-+        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
-                 "Low level API call to digest " #alg " forbidden in FIPS mode!"); \
-         return private_##alg##_Init(c); \
-         } \
-         int private_##alg##_Init(cx##_CTX *c)
- 
- #  define fips_cipher_abort(alg) \
--        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
-+        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
-                 "Low level API call to cipher " #alg " forbidden in FIPS mode!")
- 
- # else
-diff U3 crypto/opensslconf.h crypto/opensslconf.h
---- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
-+++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
-@@ -159,9 +159,12 @@
- /* Should we define BN_DIV2W here? */
- 
- /* Only one for the following should be defined */
-+/* Bypass the following definitions for UEFI version. */
-+#if !defined(OPENSSL_SYS_UEFI)
- #undef SIXTY_FOUR_BIT_LONG
- #undef SIXTY_FOUR_BIT
- #define THIRTY_TWO_BIT
-+#endif
- #endif
- 
- #if defined(HEADER_RC4_LOCL_H) && !defined(CONFIG_HEADER_RC4_LOCL_H)
-diff U3 crypto/err/err.c crypto/err/err.c
---- crypto/err/err.c
-+++ crypto/err/err.c
-@@ -1072,7 +1072,12 @@ void ERR_set_error_data(char *data, int flags)
-     es->err_data_flags[i] = flags;
- }
- 
-+/* Add EFIAPI for UEFI version. */
-+#if defined(OPENSSL_SYS_UEFI)
-+void EFIAPI ERR_add_error_data(int num, ...)
-+#else
- void ERR_add_error_data(int num, ...)
-+#endif
- {
-     va_list args;
-     va_start(args, num);
-diff U3 crypto/err/err.h crypto/err/err.h
---- crypto/err/err.h
-+++ crypto/err/err.h
-@@ -344,7 +344,14 @@ void ERR_print_errors_fp(FILE *fp);
- # ifndef OPENSSL_NO_BIO
- void ERR_print_errors(BIO *bp);
- # endif
-+
-+/* Add EFIAPI for UEFI version. */
-+#if defined(OPENSSL_SYS_UEFI)
-+void EFIAPI ERR_add_error_data(int num, ...);
-+#else
- void ERR_add_error_data(int num, ...);
-+#endif
-+
- void ERR_add_error_vdata(int num, va_list args);
- void ERR_load_strings(int lib, ERR_STRING_DATA str[]);
- void ERR_unload_strings(int lib, ERR_STRING_DATA str[]);
diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
new file mode 100644
index 000000000000..e4eaff6eadd2
--- /dev/null
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
@@ -0,0 +1,707 @@
+diff U3 crypto/bio/bio.h crypto/bio/bio.h
+--- crypto/bio/bio.h	Thu Jun 11 21:50:12 2015
++++ crypto/bio/bio.h	Fri Jun 12 11:00:52 2015
+@@ -646,10 +646,10 @@
+ int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix,
+                         asn1_ps_func **psuffix_free);
+ 
+-# ifndef OPENSSL_NO_FP_API
+ BIO_METHOD *BIO_s_file(void);
+ BIO *BIO_new_file(const char *filename, const char *mode);
+ BIO *BIO_new_fp(FILE *stream, int close_flag);
++# ifndef OPENSSL_NO_FP_API
+ #  define BIO_s_file_internal    BIO_s_file
+ # endif
+ BIO *BIO_new(BIO_METHOD *type);
+diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
+--- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
++++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
+@@ -467,6 +467,23 @@
+     return (ret);
+ }
+ 
++# else
++
++BIO_METHOD *BIO_s_file(void)
++{
++    return NULL;
++}
++
++BIO *BIO_new_file(const char *filename, const char *mode)
++{
++    return NULL;
++}
++
++BIO *BIO_new_fp(FILE *stream, int close_flag)
++{
++    return NULL;
++}
++
+ # endif                         /* OPENSSL_NO_STDIO */
+ 
+ #endif                          /* HEADER_BSS_FILE_C */
+diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
+--- crypto/dh/dh_pmeth.c	Thu Jun 11 21:50:12 2015
++++ crypto/dh/dh_pmeth.c	Fri Jun 12 11:08:48 2015
+@@ -449,6 +449,9 @@
+         *keylen = ret;
+         return 1;
+     } else if (dctx->kdf_type == EVP_PKEY_DH_KDF_X9_42) {
++#ifdef OPENSSL_NO_CMS
++        return 0;
++#else
+         unsigned char *Z = NULL;
+         size_t Zlen = 0;
+         if (!dctx->kdf_outlen || !dctx->kdf_oid)
+@@ -478,6 +481,7 @@
+             OPENSSL_free(Z);
+         }
+         return ret;
++#endif
+     }
+     return 1;
+ }
+diff U3 crypto/pem/pem.h crypto/pem/pem.h
+--- crypto/pem/pem.h	Thu Jun 11 21:50:12 2015
++++ crypto/pem/pem.h	Fri Jun 12 10:58:18 2015
+@@ -324,6 +324,7 @@
+ 
+ #  define DECLARE_PEM_read_fp(name, type) /**/
+ #  define DECLARE_PEM_write_fp(name, type) /**/
++#  define DECLARE_PEM_write_fp_const(name, type) /**/
+ #  define DECLARE_PEM_write_cb_fp(name, type) /**/
+ # else
+ 
+diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
+--- crypto/pkcs7/pk7_smime.c	Thu Jun 11 21:01:06 2015
++++ crypto/pkcs7/pk7_smime.c	Fri Jun 12 11:23:38 2015
+@@ -254,7 +254,8 @@
+     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
+     PKCS7_SIGNER_INFO *si;
+     X509_STORE_CTX cert_ctx;
+-    char buf[4096];
++    char *buf = NULL;
++    int bufsiz;
+     int i, j = 0, k, ret = 0;
+     BIO *p7bio = NULL;
+     BIO *tmpin = NULL, *tmpout = NULL;
+@@ -275,12 +276,6 @@
+         return 0;
+     }
+ 
+-    /* Check for data and content: two sets of data */
+-    if (!PKCS7_get_detached(p7) && indata) {
+-        PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_CONTENT_AND_DATA_PRESENT);
+-        return 0;
+-    }
+-
+     sinfos = PKCS7_get_signer_info(p7);
+ 
+     if (!sinfos || !sk_PKCS7_SIGNER_INFO_num(sinfos)) {
+@@ -355,9 +350,14 @@
+     } else
+         tmpout = out;
+ 
++    bufsiz = 4096;
++    buf = OPENSSL_malloc(bufsiz);
++    if (buf == NULL) {
++        goto err;
++    }
+     /* We now have to 'read' from p7bio to calculate digests etc. */
+     for (;;) {
+-        i = BIO_read(p7bio, buf, sizeof(buf));
++        i = BIO_read(p7bio, buf, bufsiz);
+         if (i <= 0)
+             break;
+         if (tmpout)
+@@ -394,6 +394,10 @@
+     }
+     BIO_free_all(p7bio);
+     sk_X509_free(signers);
++
++    if (buf != NULL) {
++      OPENSSL_free(buf);
++    }
+     return ret;
+ }
+ 
+diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
+--- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
++++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
+@@ -116,7 +116,7 @@
+ #include <openssl/rand.h>
+ #include "rand_lcl.h"
+ 
+-#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE))
++#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE) || defined(OPENSSL_SYS_UEFI))
+ 
+ # include <sys/types.h>
+ # include <sys/time.h>
+@@ -439,7 +439,7 @@
+                                  * defined(OPENSSL_SYS_VXWORKS) ||
+                                  * defined(OPENSSL_SYS_NETWARE)) */
+ 
+-#if defined(OPENSSL_SYS_VXWORKS)
++#if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI)
+ int RAND_poll(void)
+ {
+     return 0;
+diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
+--- crypto/rsa/rsa_ameth.c	Thu Jun 11 21:50:12 2015
++++ crypto/rsa/rsa_ameth.c	Fri Jun 12 10:45:38 2015
+@@ -68,10 +68,12 @@
+ #endif
+ #include "asn1_locl.h"
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_sign(CMS_SignerInfo *si);
+ static int rsa_cms_verify(CMS_SignerInfo *si);
+ static int rsa_cms_decrypt(CMS_RecipientInfo *ri);
+ static int rsa_cms_encrypt(CMS_RecipientInfo *ri);
++#endif
+ 
+ static int rsa_pub_encode(X509_PUBKEY *pk, const EVP_PKEY *pkey)
+ {
+@@ -665,6 +667,7 @@
+     return rv;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_verify(CMS_SignerInfo *si)
+ {
+     int nid, nid2;
+@@ -683,6 +686,7 @@
+     }
+     return 0;
+ }
++#endif
+ 
+ /*
+  * Customised RSA item verification routine. This is called when a signature
+@@ -705,6 +709,7 @@
+     return -1;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_sign(CMS_SignerInfo *si)
+ {
+     int pad_mode = RSA_PKCS1_PADDING;
+@@ -729,6 +734,7 @@
+     X509_ALGOR_set0(alg, OBJ_nid2obj(NID_rsassaPss), V_ASN1_SEQUENCE, os);
+     return 1;
+ }
++#endif
+ 
+ static int rsa_item_sign(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
+                          X509_ALGOR *alg1, X509_ALGOR *alg2,
+@@ -785,6 +791,7 @@
+     return pss;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_decrypt(CMS_RecipientInfo *ri)
+ {
+     EVP_PKEY_CTX *pkctx;
+@@ -857,7 +864,9 @@
+         X509_ALGOR_free(maskHash);
+     return rv;
+ }
++#endif
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_encrypt(CMS_RecipientInfo *ri)
+ {
+     const EVP_MD *md, *mgf1md;
+@@ -920,6 +929,7 @@
+         ASN1_STRING_free(os);
+     return rv;
+ }
++#endif
+ 
+ const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[] = {
+     {
+diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
+--- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
++++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
+@@ -940,6 +940,8 @@
+         ctx->current_crl = crl;
+     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
+         ptime = &ctx->param->check_time;
++    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
++        return 1;
+     else
+         ptime = NULL;
+ 
+@@ -1663,6 +1665,8 @@
+ 
+     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
+         ptime = &ctx->param->check_time;
++    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
++        return 1;
+     else
+         ptime = NULL;
+ 
+diff U3 crypto/x509/x509_vfy.h crypto/x509/x509_vfy.h
+--- crypto/x509/x509_vfy.h	Thu Jul 09 19:57:16 2015
++++ crypto/x509/x509_vfy.h	Thu Oct 29 14:05:57 2015
+@@ -438,6 +438,8 @@
+  * will force the behaviour to match that of previous versions.
+  */
+ # define X509_V_FLAG_NO_ALT_CHAINS               0x100000
++/* Do not check certificate/CRL validity against current time */
++# define X509_V_FLAG_NO_CHECK_TIME               0x200000
+ 
+ # define X509_VP_FLAG_DEFAULT                    0x1
+ # define X509_VP_FLAG_OVERWRITE                  0x2
+diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
+--- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
++++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015
+@@ -127,8 +127,10 @@
+     &v3_idp,
+     &v3_alt[2],
+     &v3_freshest_crl,
++#ifndef OPENSSL_SYS_UEFI
+     &v3_ct_scts[0],
+     &v3_ct_scts[1],
++#endif
+ };
+ 
+ /* Number of standard extensions */
+diff U3 crypto/crypto.h crypto/crypto.h
+--- crypto/crypto.h	Thu Jun 11 21:01:06 2015
++++ crypto/crypto.h	Fri Jun 12 11:33:27 2015
+@@ -235,15 +235,15 @@
+ # ifndef OPENSSL_NO_LOCKING
+ #  ifndef CRYPTO_w_lock
+ #   define CRYPTO_w_lock(type)     \
+-        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,NULL,0)
+ #   define CRYPTO_w_unlock(type)   \
+-        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,NULL,0)
+ #   define CRYPTO_r_lock(type)     \
+-        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,NULL,0)
+ #   define CRYPTO_r_unlock(type)   \
+-        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,NULL,0)
+ #   define CRYPTO_add(addr,amount,type)    \
+-        CRYPTO_add_lock(addr,amount,type,__FILE__,__LINE__)
++        CRYPTO_add_lock(addr,amount,type,NULL,0)
+ #  endif
+ # else
+ #  define CRYPTO_w_lock(a)
+@@ -378,19 +378,19 @@
+ # define MemCheck_off()  CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE)
+ # define is_MemCheck_on() CRYPTO_is_mem_check_on()
+ 
+-# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,__FILE__,__LINE__)
+-# define OPENSSL_strdup(str)     CRYPTO_strdup((str),__FILE__,__LINE__)
++# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,NULL,0)
++# define OPENSSL_strdup(str)     CRYPTO_strdup((str),NULL,0)
+ # define OPENSSL_realloc(addr,num) \
+-        CRYPTO_realloc((char *)addr,(int)num,__FILE__,__LINE__)
++        CRYPTO_realloc((char *)addr,(int)num,NULL,0)
+ # define OPENSSL_realloc_clean(addr,old_num,num) \
+-        CRYPTO_realloc_clean(addr,old_num,num,__FILE__,__LINE__)
++        CRYPTO_realloc_clean(addr,old_num,num,NULL,0)
+ # define OPENSSL_remalloc(addr,num) \
+-        CRYPTO_remalloc((char **)addr,(int)num,__FILE__,__LINE__)
++        CRYPTO_remalloc((char **)addr,(int)num,NULL,0)
+ # define OPENSSL_freeFunc        CRYPTO_free
+ # define OPENSSL_free(addr)      CRYPTO_free(addr)
+ 
+ # define OPENSSL_malloc_locked(num) \
+-        CRYPTO_malloc_locked((int)num,__FILE__,__LINE__)
++        CRYPTO_malloc_locked((int)num,NULL,0)
+ # define OPENSSL_free_locked(addr) CRYPTO_free_locked(addr)
+ 
+ const char *SSLeay_version(int type);
+@@ -545,7 +545,7 @@
+ long CRYPTO_get_mem_debug_options(void);
+ 
+ # define CRYPTO_push_info(info) \
+-        CRYPTO_push_info_(info, __FILE__, __LINE__);
++        CRYPTO_push_info_(info, NULL, 0);
+ int CRYPTO_push_info_(const char *info, const char *file, int line);
+ int CRYPTO_pop_info(void);
+ int CRYPTO_remove_all_info(void);
+@@ -588,7 +588,7 @@
+ 
+ /* die if we have to */
+ void OpenSSLDie(const char *file, int line, const char *assertion);
+-# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(__FILE__, __LINE__, #e),1))
++# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(NULL, 0, #e),1))
+ 
+ unsigned long *OPENSSL_ia32cap_loc(void);
+ # define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc()))
+@@ -605,14 +605,14 @@
+ #  define fips_md_init_ctx(alg, cx) \
+         int alg##_Init(cx##_CTX *c) \
+         { \
+-        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
++        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
+                 "Low level API call to digest " #alg " forbidden in FIPS mode!"); \
+         return private_##alg##_Init(c); \
+         } \
+         int private_##alg##_Init(cx##_CTX *c)
+ 
+ #  define fips_cipher_abort(alg) \
+-        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
++        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
+                 "Low level API call to cipher " #alg " forbidden in FIPS mode!")
+ 
+ # else
+diff U3 crypto/opensslconf.h crypto/opensslconf.h
+--- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
++++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
+@@ -5,15 +5,72 @@
+ extern "C" {
+ #endif
+ /* OpenSSL was configured with the following options: */
++#ifndef OPENSSL_SYSNAME_UEFI
++# define OPENSSL_SYSNAME_UEFI
++#endif
+ #ifndef OPENSSL_DOING_MAKEDEPEND
+ 
+ 
++#ifndef OPENSSL_NO_BF
++# define OPENSSL_NO_BF
++#endif
++#ifndef OPENSSL_NO_CAMELLIA
++# define OPENSSL_NO_CAMELLIA
++#endif
++#ifndef OPENSSL_NO_CAPIENG
++# define OPENSSL_NO_CAPIENG
++#endif
++#ifndef OPENSSL_NO_CAST
++# define OPENSSL_NO_CAST
++#endif
++#ifndef OPENSSL_NO_CMS
++# define OPENSSL_NO_CMS
++#endif
++#ifndef OPENSSL_NO_DEPRECATED
++# define OPENSSL_NO_DEPRECATED
++#endif
++#ifndef OPENSSL_NO_DGRAM
++# define OPENSSL_NO_DGRAM
++#endif
++#ifndef OPENSSL_NO_DSA
++# define OPENSSL_NO_DSA
++#endif
++#ifndef OPENSSL_NO_DYNAMIC_ENGINE
++# define OPENSSL_NO_DYNAMIC_ENGINE
++#endif
++#ifndef OPENSSL_NO_EC
++# define OPENSSL_NO_EC
++#endif
+ #ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
+ # define OPENSSL_NO_EC_NISTP_64_GCC_128
+ #endif
++#ifndef OPENSSL_NO_ECDH
++# define OPENSSL_NO_ECDH
++#endif
++#ifndef OPENSSL_NO_ECDSA
++# define OPENSSL_NO_ECDSA
++#endif
++#ifndef OPENSSL_NO_ENGINE
++# define OPENSSL_NO_ENGINE
++#endif
++#ifndef OPENSSL_NO_ENGINES
++# define OPENSSL_NO_ENGINES
++#endif
++#ifndef OPENSSL_NO_FILENAMES
++# define OPENSSL_NO_FILENAMES
++#endif
++#ifndef OPENSSL_NO_FP_API
++# define OPENSSL_NO_FP_API
++#endif
+ #ifndef OPENSSL_NO_GMP
+ # define OPENSSL_NO_GMP
+ #endif
++#ifndef OPENSSL_NO_GOST
++# define OPENSSL_NO_GOST
++#endif
++#ifndef OPENSSL_NO_IDEA
++# define OPENSSL_NO_IDEA
++#endif
+ #ifndef OPENSSL_NO_JPAKE
+ # define OPENSSL_NO_JPAKE
+ #endif
+@@ -23,30 +80,90 @@
+ #ifndef OPENSSL_NO_LIBUNBOUND
+ # define OPENSSL_NO_LIBUNBOUND
+ #endif
++#ifndef OPENSSL_NO_LOCKING
++# define OPENSSL_NO_LOCKING
++#endif
+ #ifndef OPENSSL_NO_MD2
+ # define OPENSSL_NO_MD2
+ #endif
++#ifndef OPENSSL_NO_MDC2
++# define OPENSSL_NO_MDC2
++#endif
++#ifndef OPENSSL_NO_POSIX_IO
++# define OPENSSL_NO_POSIX_IO
++#endif
++#ifndef OPENSSL_NO_RC2
++# define OPENSSL_NO_RC2
++#endif
+ #ifndef OPENSSL_NO_RC5
+ # define OPENSSL_NO_RC5
+ #endif
++#ifndef OPENSSL_NO_RCS
++# define OPENSSL_NO_RCS
++#endif
+ #ifndef OPENSSL_NO_RFC3779
+ # define OPENSSL_NO_RFC3779
+ #endif
++#ifndef OPENSSL_NO_RIPEMD
++# define OPENSSL_NO_RIPEMD
++#endif
++#ifndef OPENSSL_NO_SCRYPT
++# define OPENSSL_NO_SCRYPT
++#endif
++#ifndef OPENSSL_NO_SCT
++# define OPENSSL_NO_SCT
++#endif
+ #ifndef OPENSSL_NO_SCTP
+ # define OPENSSL_NO_SCTP
+ #endif
++#ifndef OPENSSL_NO_SEED
++# define OPENSSL_NO_SEED
++#endif
++#ifndef OPENSSL_NO_SHA0
++# define OPENSSL_NO_SHA0
++#endif
++#ifndef OPENSSL_NO_SOCK
++# define OPENSSL_NO_SOCK
++#endif
++#ifndef OPENSSL_NO_SRP
++# define OPENSSL_NO_SRP
++#endif
+ #ifndef OPENSSL_NO_SSL_TRACE
+ # define OPENSSL_NO_SSL_TRACE
+ #endif
++#ifndef OPENSSL_NO_SSL2
++# define OPENSSL_NO_SSL2
++#endif
++#ifndef OPENSSL_NO_SSL3
++# define OPENSSL_NO_SSL3
++#endif
++#ifndef OPENSSL_NO_STDIO
++# define OPENSSL_NO_STDIO
++#endif
+ #ifndef OPENSSL_NO_STORE
+ # define OPENSSL_NO_STORE
+ #endif
++#ifndef OPENSSL_NO_UI
++# define OPENSSL_NO_UI
++#endif
+ #ifndef OPENSSL_NO_UNIT_TEST
+ # define OPENSSL_NO_UNIT_TEST
+ #endif
++#ifndef OPENSSL_NO_WHIRLPOOL
++# define OPENSSL_NO_WHIRLPOOL
++#endif
+ 
+ #endif /* OPENSSL_DOING_MAKEDEPEND */
+ 
++#ifndef OPENSSL_NO_ASM
++# define OPENSSL_NO_ASM
++#endif
++#ifndef OPENSSL_NO_ERR
++# define OPENSSL_NO_ERR
++#endif
++#ifndef OPENSSL_NO_HW
++# define OPENSSL_NO_HW
++#endif
+ #ifndef OPENSSL_NO_DYNAMIC_ENGINE
+ # define OPENSSL_NO_DYNAMIC_ENGINE
+ #endif
+@@ -56,12 +173,66 @@
+    who haven't had the time to do the appropriate changes in their
+    applications.  */
+ #ifdef OPENSSL_ALGORITHM_DEFINES
++# if defined(OPENSSL_NO_BF) && !defined(NO_BF)
++#  define NO_BF
++# endif
++# if defined(OPENSSL_NO_CAMELLIA) && !defined(NO_CAMELLIA)
++#  define NO_CAMELLIA
++# endif
++# if defined(OPENSSL_NO_CAPIENG) && !defined(NO_CAPIENG)
++#  define NO_CAPIENG
++# endif
++# if defined(OPENSSL_NO_CAST) && !defined(NO_CAST)
++#  define NO_CAST
++# endif
++# if defined(OPENSSL_NO_CMS) && !defined(NO_CMS)
++#  define NO_CMS
++# endif
++# if defined(OPENSSL_NO_DEPRECATED) && !defined(NO_DEPRECATED)
++#  define NO_DEPRECATED
++# endif
++# if defined(OPENSSL_NO_DGRAM) && !defined(NO_DGRAM)
++#  define NO_DGRAM
++# endif
++# if defined(OPENSSL_NO_DSA) && !defined(NO_DSA)
++#  define NO_DSA
++# endif
++# if defined(OPENSSL_NO_DYNAMIC_ENGINE) && !defined(NO_DYNAMIC_ENGINE)
++#  define NO_DYNAMIC_ENGINE
++# endif
++# if defined(OPENSSL_NO_EC) && !defined(NO_EC)
++#  define NO_EC
++# endif
+ # if defined(OPENSSL_NO_EC_NISTP_64_GCC_128) && !defined(NO_EC_NISTP_64_GCC_128)
+ #  define NO_EC_NISTP_64_GCC_128
+ # endif
++# if defined(OPENSSL_NO_ECDH) && !defined(NO_ECDH)
++#  define NO_ECDH
++# endif
++# if defined(OPENSSL_NO_ECDSA) && !defined(NO_ECDSA)
++#  define NO_ECDSA
++# endif
++# if defined(OPENSSL_NO_ENGINE) && !defined(NO_ENGINE)
++#  define NO_ENGINE
++# endif
++# if defined(OPENSSL_NO_ENGINES) && !defined(NO_ENGINES)
++#  define NO_ENGINES
++# endif
++# if defined(OPENSSL_NO_FILENAMES) && !defined(NO_FILENAMES)
++#  define NO_FILENAMES
++# endif
++# if defined(OPENSSL_NO_FP_API) && !defined(NO_FP_API)
++#  define NO_FP_API
++# endif
+ # if defined(OPENSSL_NO_GMP) && !defined(NO_GMP)
+ #  define NO_GMP
+ # endif
++# if defined(OPENSSL_NO_GOST) && !defined(NO_GOST)
++#  define NO_GOST
++# endif
++# if defined(OPENSSL_NO_IDEA) && !defined(NO_IDEA)
++#  define NO_IDEA
++# endif
+ # if defined(OPENSSL_NO_JPAKE) && !defined(NO_JPAKE)
+ #  define NO_JPAKE
+ # endif
+@@ -71,27 +242,78 @@
+ # if defined(OPENSSL_NO_LIBUNBOUND) && !defined(NO_LIBUNBOUND)
+ #  define NO_LIBUNBOUND
+ # endif
++# if defined(OPENSSL_NO_LOCKING) && !defined(NO_LOCKING)
++#  define NO_LOCKING
++# endif
+ # if defined(OPENSSL_NO_MD2) && !defined(NO_MD2)
+ #  define NO_MD2
+ # endif
++# if defined(OPENSSL_NO_MDC2) && !defined(NO_MDC2)
++#  define NO_MDC2
++# endif
++# if defined(OPENSSL_NO_POSIX_IO) && !defined(NO_POSIX_IO)
++#  define NO_POSIX_IO
++# endif
++# if defined(OPENSSL_NO_RC2) && !defined(NO_RC2)
++#  define NO_RC2
++# endif
+ # if defined(OPENSSL_NO_RC5) && !defined(NO_RC5)
+ #  define NO_RC5
+ # endif
++# if defined(OPENSSL_NO_RCS) && !defined(NO_RCS)
++#  define NO_RCS
++# endif
+ # if defined(OPENSSL_NO_RFC3779) && !defined(NO_RFC3779)
+ #  define NO_RFC3779
+ # endif
++# if defined(OPENSSL_NO_RIPEMD) && !defined(NO_RIPEMD)
++#  define NO_RIPEMD
++# endif
++# if defined(OPENSSL_NO_SCRYPT) && !defined(NO_SCRYPT)
++#  define NO_SCRYPT
++# endif
++# if defined(OPENSSL_NO_SCT) && !defined(NO_SCT)
++#  define NO_SCT
++# endif
+ # if defined(OPENSSL_NO_SCTP) && !defined(NO_SCTP)
+ #  define NO_SCTP
+ # endif
++# if defined(OPENSSL_NO_SEED) && !defined(NO_SEED)
++#  define NO_SEED
++# endif
++# if defined(OPENSSL_NO_SHA0) && !defined(NO_SHA0)
++#  define NO_SHA0
++# endif
++# if defined(OPENSSL_NO_SOCK) && !defined(NO_SOCK)
++#  define NO_SOCK
++# endif
++# if defined(OPENSSL_NO_SRP) && !defined(NO_SRP)
++#  define NO_SRP
++# endif
+ # if defined(OPENSSL_NO_SSL_TRACE) && !defined(NO_SSL_TRACE)
+ #  define NO_SSL_TRACE
+ # endif
++# if defined(OPENSSL_NO_SSL2) && !defined(NO_SSL2)
++#  define NO_SSL2
++# endif
++# if defined(OPENSSL_NO_SSL3) && !defined(NO_SSL3)
++#  define NO_SSL3
++# endif
++# if defined(OPENSSL_NO_STDIO) && !defined(NO_STDIO)
++#  define NO_STDIO
++# endif
+ # if defined(OPENSSL_NO_STORE) && !defined(NO_STORE)
+ #  define NO_STORE
+ # endif
++# if defined(OPENSSL_NO_UI) && !defined(NO_UI)
++#  define NO_UI
++# endif
+ # if defined(OPENSSL_NO_UNIT_TEST) && !defined(NO_UNIT_TEST)
+ #  define NO_UNIT_TEST
+ # endif
++# if defined(OPENSSL_NO_WHIRLPOOL) && !defined(NO_WHIRLPOOL)
++#  define NO_WHIRLPOOL
++# endif
+ #endif
+ 
+ /* crypto/opensslconf.h.in */
+@@ -152,7 +374,7 @@
+ #endif
+ #endif
+ 
+-#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H)
++#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H) && !defined(OPENSSL_SYSNAME_UEFI)
+ #define CONFIG_HEADER_BN_H
+ #undef BN_LLONG
+ 
+diff U3 e_os.h e_os.h
+--- e_os.h	Thu Jul 09 19:57:16 2015
++++ e_os.h	Thu Oct 29 16:54:10 2015
+@@ -136,7 +136,7 @@
+ #  define MSDOS
+ # endif
+ 
+-# if defined(MSDOS) && !defined(GETPID_IS_MEANINGLESS)
++# if (defined(MSDOS) || defined(OPENSSL_SYS_UEFI)) && !defined(GETPID_IS_MEANINGLESS)
+ #  define GETPID_IS_MEANINGLESS
+ # endif
+ 
+diff U3 e_os2.h e_os2.h
+--- e_os2.h	Thu Jul 09 19:57:16 2015
++++ e_os2.h	Thu Oct 29 15:08:19 2015
+@@ -97,7 +97,14 @@
+  * For 32 bit environment, there seems to be the CygWin environment and then
+  * all the others that try to do the same thing Microsoft does...
+  */
+-# if defined(OPENSSL_SYSNAME_UWIN)
++/*
++ * UEFI lives here because it might be built with a Microsoft toolchain and
++ * we need to avoid the false positive match on Windows.
++ */
++# if defined(OPENSSL_SYSNAME_UEFI)
++#  undef OPENSSL_SYS_UNIX
++#  define OPENSSL_SYS_UEFI
++# elif defined(OPENSSL_SYSNAME_UWIN)
+ #  undef OPENSSL_SYS_UNIX
+ #  define OPENSSL_SYS_WIN32_UWIN
+ # else
diff --git a/CryptoPkg/Library/OpensslLib/Install.cmd b/CryptoPkg/Library/OpensslLib/Install.cmd
index ef0a4bdcebc9..b9b6fc6f7094 100755
--- a/CryptoPkg/Library/OpensslLib/Install.cmd
+++ b/CryptoPkg/Library/OpensslLib/Install.cmd
@@ -1,4 +1,4 @@
-cd openssl-1.0.2d
+cd openssl-1.0.2e
 copy e_os2.h                    ..\..\..\Include\openssl
 copy crypto\crypto.h            ..\..\..\Include\openssl
 copy crypto\opensslv.h          ..\..\..\Include\openssl
diff --git a/CryptoPkg/Library/OpensslLib/Install.sh b/CryptoPkg/Library/OpensslLib/Install.sh
index 877e775b81af..82a7f409f105 100755
--- a/CryptoPkg/Library/OpensslLib/Install.sh
+++ b/CryptoPkg/Library/OpensslLib/Install.sh
@@ -1,79 +1,79 @@
-#!/bin/sh
-
-cd openssl-1.0.2d
-cp e_os2.h                    ../../../Include/openssl
-cp crypto/crypto.h            ../../../Include/openssl
-cp crypto/opensslv.h          ../../../Include/openssl
-cp crypto/opensslconf.h       ../../../Include/openssl
-cp crypto/ebcdic.h            ../../../Include/openssl
-cp crypto/symhacks.h          ../../../Include/openssl
-cp crypto/ossl_typ.h          ../../../Include/openssl
-cp crypto/objects/objects.h   ../../../Include/openssl
-cp crypto/objects/obj_mac.h   ../../../Include/openssl
-cp crypto/md4/md4.h           ../../../Include/openssl
-cp crypto/md5/md5.h           ../../../Include/openssl
-cp crypto/sha/sha.h           ../../../Include/openssl
-cp crypto/mdc2/mdc2.h         ../../../Include/openssl
-cp crypto/hmac/hmac.h         ../../../Include/openssl
-cp crypto/ripemd/ripemd.h     ../../../Include/openssl
-cp crypto/whrlpool/whrlpool.h ../../../Include/openssl
-cp crypto/des/des.h           ../../../Include/openssl
-cp crypto/des/des_old.h       ../../../Include/openssl
-cp crypto/aes/aes.h           ../../../Include/openssl
-cp crypto/rc2/rc2.h           ../../../Include/openssl
-cp crypto/rc4/rc4.h           ../../../Include/openssl
-cp crypto/idea/idea.h         ../../../Include/openssl
-cp crypto/bf/blowfish.h       ../../../Include/openssl
-cp crypto/cast/cast.h         ../../../Include/openssl
-cp crypto/camellia/camellia.h ../../../Include/openssl
-cp crypto/seed/seed.h         ../../../Include/openssl
-cp crypto/modes/modes.h       ../../../Include/openssl
-cp crypto/bn/bn.h             ../../../Include/openssl
-cp crypto/ec/ec.h             ../../../Include/openssl
-cp crypto/rsa/rsa.h           ../../../Include/openssl
-cp crypto/dsa/dsa.h           ../../../Include/openssl
-cp crypto/ecdsa/ecdsa.h       ../../../Include/openssl
-cp crypto/dh/dh.h             ../../../Include/openssl
-cp crypto/ecdh/ecdh.h         ../../../Include/openssl
-cp crypto/dso/dso.h           ../../../Include/openssl
-cp crypto/engine/engine.h     ../../../Include/openssl
-cp crypto/buffer/buffer.h     ../../../Include/openssl
-cp crypto/bio/bio.h           ../../../Include/openssl
-cp crypto/stack/stack.h       ../../../Include/openssl
-cp crypto/stack/safestack.h   ../../../Include/openssl
-cp crypto/lhash/lhash.h       ../../../Include/openssl
-cp crypto/rand/rand.h         ../../../Include/openssl
-cp crypto/err/err.h           ../../../Include/openssl
-cp crypto/evp/evp.h           ../../../Include/openssl
-cp crypto/asn1/asn1.h         ../../../Include/openssl
-cp crypto/asn1/asn1_mac.h     ../../../Include/openssl
-cp crypto/asn1/asn1t.h        ../../../Include/openssl
-cp crypto/pem/pem.h           ../../../Include/openssl
-cp crypto/pem/pem2.h          ../../../Include/openssl
-cp crypto/x509/x509.h         ../../../Include/openssl
-cp crypto/x509/x509_vfy.h     ../../../Include/openssl
-cp crypto/x509v3/x509v3.h     ../../../Include/openssl
-cp crypto/conf/conf.h         ../../../Include/openssl
-cp crypto/conf/conf_api.h     ../../../Include/openssl
-cp crypto/txt_db/txt_db.h     ../../../Include/openssl
-cp crypto/pkcs7/pkcs7.h       ../../../Include/openssl
-cp crypto/pkcs12/pkcs12.h     ../../../Include/openssl
-cp crypto/comp/comp.h         ../../../Include/openssl
-cp crypto/ocsp/ocsp.h         ../../../Include/openssl
-cp crypto/ui/ui.h             ../../../Include/openssl
-cp crypto/ui/ui_compat.h      ../../../Include/openssl
-cp crypto/krb5/krb5_asn.h     ../../../Include/openssl
-cp crypto/cms/cms.h           ../../../Include/openssl
-cp crypto/pqueue/pqueue.h     ../../../Include/openssl
-cp crypto/ts/ts.h             ../../../Include/openssl
-cp crypto/srp/srp.h           ../../../Include/openssl
-cp crypto/cmac/cmac.h         ../../../Include/openssl
-cp ssl/ssl.h                  ../../../Include/openssl
-cp ssl/ssl2.h                 ../../../Include/openssl
-cp ssl/ssl3.h                 ../../../Include/openssl
-cp ssl/ssl23.h                ../../../Include/openssl
-cp ssl/tls1.h                 ../../../Include/openssl
-cp ssl/dtls1.h                ../../../Include/openssl
-cp ssl/kssl.h                 ../../../Include/openssl
-cp ssl/srtp.h                 ../../../Include/openssl
-cd ..
+#!/bin/sh
+
+cd openssl-1.0.2e
+cp e_os2.h                    ../../../Include/openssl
+cp crypto/crypto.h            ../../../Include/openssl
+cp crypto/opensslv.h          ../../../Include/openssl
+cp crypto/opensslconf.h       ../../../Include/openssl
+cp crypto/ebcdic.h            ../../../Include/openssl
+cp crypto/symhacks.h          ../../../Include/openssl
+cp crypto/ossl_typ.h          ../../../Include/openssl
+cp crypto/objects/objects.h   ../../../Include/openssl
+cp crypto/objects/obj_mac.h   ../../../Include/openssl
+cp crypto/md4/md4.h           ../../../Include/openssl
+cp crypto/md5/md5.h           ../../../Include/openssl
+cp crypto/sha/sha.h           ../../../Include/openssl
+cp crypto/mdc2/mdc2.h         ../../../Include/openssl
+cp crypto/hmac/hmac.h         ../../../Include/openssl
+cp crypto/ripemd/ripemd.h     ../../../Include/openssl
+cp crypto/whrlpool/whrlpool.h ../../../Include/openssl
+cp crypto/des/des.h           ../../../Include/openssl
+cp crypto/des/des_old.h       ../../../Include/openssl
+cp crypto/aes/aes.h           ../../../Include/openssl
+cp crypto/rc2/rc2.h           ../../../Include/openssl
+cp crypto/rc4/rc4.h           ../../../Include/openssl
+cp crypto/idea/idea.h         ../../../Include/openssl
+cp crypto/bf/blowfish.h       ../../../Include/openssl
+cp crypto/cast/cast.h         ../../../Include/openssl
+cp crypto/camellia/camellia.h ../../../Include/openssl
+cp crypto/seed/seed.h         ../../../Include/openssl
+cp crypto/modes/modes.h       ../../../Include/openssl
+cp crypto/bn/bn.h             ../../../Include/openssl
+cp crypto/ec/ec.h             ../../../Include/openssl
+cp crypto/rsa/rsa.h           ../../../Include/openssl
+cp crypto/dsa/dsa.h           ../../../Include/openssl
+cp crypto/ecdsa/ecdsa.h       ../../../Include/openssl
+cp crypto/dh/dh.h             ../../../Include/openssl
+cp crypto/ecdh/ecdh.h         ../../../Include/openssl
+cp crypto/dso/dso.h           ../../../Include/openssl
+cp crypto/engine/engine.h     ../../../Include/openssl
+cp crypto/buffer/buffer.h     ../../../Include/openssl
+cp crypto/bio/bio.h           ../../../Include/openssl
+cp crypto/stack/stack.h       ../../../Include/openssl
+cp crypto/stack/safestack.h   ../../../Include/openssl
+cp crypto/lhash/lhash.h       ../../../Include/openssl
+cp crypto/rand/rand.h         ../../../Include/openssl
+cp crypto/err/err.h           ../../../Include/openssl
+cp crypto/evp/evp.h           ../../../Include/openssl
+cp crypto/asn1/asn1.h         ../../../Include/openssl
+cp crypto/asn1/asn1_mac.h     ../../../Include/openssl
+cp crypto/asn1/asn1t.h        ../../../Include/openssl
+cp crypto/pem/pem.h           ../../../Include/openssl
+cp crypto/pem/pem2.h          ../../../Include/openssl
+cp crypto/x509/x509.h         ../../../Include/openssl
+cp crypto/x509/x509_vfy.h     ../../../Include/openssl
+cp crypto/x509v3/x509v3.h     ../../../Include/openssl
+cp crypto/conf/conf.h         ../../../Include/openssl
+cp crypto/conf/conf_api.h     ../../../Include/openssl
+cp crypto/txt_db/txt_db.h     ../../../Include/openssl
+cp crypto/pkcs7/pkcs7.h       ../../../Include/openssl
+cp crypto/pkcs12/pkcs12.h     ../../../Include/openssl
+cp crypto/comp/comp.h         ../../../Include/openssl
+cp crypto/ocsp/ocsp.h         ../../../Include/openssl
+cp crypto/ui/ui.h             ../../../Include/openssl
+cp crypto/ui/ui_compat.h      ../../../Include/openssl
+cp crypto/krb5/krb5_asn.h     ../../../Include/openssl
+cp crypto/cms/cms.h           ../../../Include/openssl
+cp crypto/pqueue/pqueue.h     ../../../Include/openssl
+cp crypto/ts/ts.h             ../../../Include/openssl
+cp crypto/srp/srp.h           ../../../Include/openssl
+cp crypto/cmac/cmac.h         ../../../Include/openssl
+cp ssl/ssl.h                  ../../../Include/openssl
+cp ssl/ssl2.h                 ../../../Include/openssl
+cp ssl/ssl3.h                 ../../../Include/openssl
+cp ssl/ssl23.h                ../../../Include/openssl
+cp ssl/tls1.h                 ../../../Include/openssl
+cp ssl/dtls1.h                ../../../Include/openssl
+cp ssl/kssl.h                 ../../../Include/openssl
+cp ssl/srtp.h                 ../../../Include/openssl
+cd ..
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index aaf0a2982e10..1b7eb07fab90 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -20,7 +20,7 @@
   MODULE_TYPE                    = BASE
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
-  DEFINE OPENSSL_PATH            = openssl-1.0.2d
+  DEFINE OPENSSL_PATH            = openssl-1.0.2e
   DEFINE OPENSSL_FLAGS           = -DOPENSSL_SYSNAME_UWIN -DOPENSSL_SYS_UEFI -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DGETPID_IS_MEANINGLESS -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
   DEFINE OPENSSL_EXFLAGS         = -DOPENSSL_SMALL_FOOTPRINT -DOPENSSL_NO_SHA0 -DOPENSSL_NO_LHASH -DOPENSSL_NO_HW -DOPENSSL_NO_OCSP -DOPENSSL_NO_LOCKING -DOPENSSL_NO_DEPRECATED -DOPENSSL_NO_RIPEMD -DOPENSSL_NO_RC2 -DOPENSSL_NO_IDEA -DOPENSSL_NO_BF -DOPENSSL_NO_CAST -DOPENSSL_NO_WHIRLPOOL -DOPENSSL_NO_DSA -DOPENSSL_NO_EC -DOPENSSL_NO_ECDH -DOPENSSL_NO_ECDSA -DOPENSSL_NO_SRP -DOPENSSL_NO_ENGINE
 
diff --git a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
index 59e74ee9b0d9..f575d7147bdf 100644
--- a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
+++ b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
@@ -17,36 +17,36 @@ cryptography. This patch will enable openssl building under UEFI environment.
 ================================================================================
                                 OpenSSL-Version
 ================================================================================
-  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2d.
-    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
+  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2e.
+    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
 
 
 ================================================================================
                       HOW to Install Openssl for UEFI Building
 ================================================================================
-1.  Download OpenSSL 1.0.2d from official website:
-    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
+1.  Download OpenSSL 1.0.2e from official website:
+    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
 
-    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2d.tar.tar.
-          When you do the download, rename the "openssl-1.0.2d.tar.tar" to
-          "openssl-1.0.2d.tar.gz" or rename the local downloaded file with ".tar.tar"
+    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2e.tar.tar.
+          When you do the download, rename the "openssl-1.0.2e.tar.tar" to
+          "openssl-1.0.2e.tar.gz" or rename the local downloaded file with ".tar.tar"
           extension to ".tar.gz".
 
-2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2d
+2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2e
 
     NOTE: If you use WinZip to unpack the openssl source in Windows, please
           uncheck the WinZip smart CR/LF conversion option (WINZIP: Options -->
           Configuration --> Miscellaneous --> "TAR file smart CR/LF conversion").
 
-3.  Apply this patch: EDKII_openssl-1.0.2d.patch, and make installation
+3.  Apply this patch: EDKII_openssl-1.0.2e.patch, and make installation
 
     For Windows Environment:
     ------------------------
     1) Make sure the patch utility has been installed in your machine.
        Install Cygwin or get the patch utility binary from
           http://gnuwin32.sourceforge.net/packages/patch.htm
-    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2d
-    3) patch -p0 -i ..\EDKII_openssl-1.0.2d.patch
+    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2e
+    3) patch -p0 -i ..\EDKII_openssl-1.0.2e.patch
     4) cd ..
     5) Install.cmd
 
@@ -54,8 +54,8 @@ cryptography. This patch will enable openssl building under UEFI environment.
     -----------------------
     1) Make sure the patch utility has been installed in your machine.
        Patch utility is available from http://directory.fsf.org/project/patch/
-    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2d
-    3) patch -p0 -i ../EDKII_openssl-1.0.2d.patch
+    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2e
+    3) patch -p0 -i ../EDKII_openssl-1.0.2e.patch
     4) cd ..
     5) ./Install.sh
 

From 3163594ee114acff704c40fff4cfb007a55b9dac Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 11 Dec 2015 08:34:51 +0000
Subject: [PATCH 240/525] UefiCpuPkg/UefiCpuPkg.uni: Fix one typo

'.' should be '_'.

(Sync patch r19226 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19227 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.uni | Bin 22498 -> 22498 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index 542b1cd961caa039fb3bee7125f299a86f67ea72..4011cfd1816b133ea82e64335f35332c2fc7e656 100644
GIT binary patch
delta 17
ZcmaE~p7GIo#tpB+CLa*xoBSi}6#!Iy3043A

delta 15
XcmaE~p7GIo#tpB+81*K<4*L!OK#2$s


From 7f58594c3263afcce15bcd1d784590a4f0083646 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Tue, 15 Dec 2015 05:59:34 +0000
Subject: [PATCH 241/525] MdeModulePkg/PciSioSerialDxe: Fix compiler warnings

Add missing braces in module global mControllerDevicePathTemplate.
Initialize ControllerNumber and ContainsControllerNode in
SerialControllerDriverStart() to address warning for potential use
before initialization warning.
Move initialization of local SerialIo earlier in
SerialControllerDriverStart() to address warning for potential use
before initialization warning.

(Sync patch r19232 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19269 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
index 86e75a43f719..7fc053578d7d 100644
--- a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
@@ -31,8 +31,10 @@ CONTROLLER_DEVICE_PATH mControllerDevicePathTemplate = {
   {
     HARDWARE_DEVICE_PATH,
     HW_CONTROLLER_DP,
-    sizeof (CONTROLLER_DEVICE_PATH),
-    0
+    {
+      (UINT8) (sizeof (CONTROLLER_DEVICE_PATH)),
+      (UINT8) ((sizeof (CONTROLLER_DEVICE_PATH)) >> 8)
+    }
   },
   0
 };
@@ -858,7 +860,8 @@ SerialControllerDriverStart (
     return EFI_SUCCESS;
   }
 
-
+  ControllerNumber = 0;
+  ContainsControllerNode = FALSE;
   SerialDevices = GetChildSerialDevices (Controller, IoProtocolGuid, &SerialDeviceCount);
   //
   // If the SerialIo instance specified by RemainingDevicePath is already created,
@@ -870,6 +873,7 @@ SerialControllerDriverStart (
       if ((!SerialDevices[Index]->ContainsControllerNode && !ContainsControllerNode) ||
           (SerialDevices[Index]->ContainsControllerNode && ContainsControllerNode && SerialDevices[Index]->Instance == ControllerNumber)
           ) {
+        SerialIo = &SerialDevices[Index]->SerialIo;
         Status = EFI_INVALID_PARAMETER;
         //
         // Pass NULL ActualBaudRate to VerifyUartParameters to disallow baudrate degrade.
@@ -877,7 +881,6 @@ SerialControllerDriverStart (
         //
         if (VerifyUartParameters (SerialDevices[Index]->ClockRate, Uart->BaudRate, Uart->DataBits,
                                   (EFI_PARITY_TYPE) Uart->Parity, (EFI_STOP_BITS_TYPE) Uart->StopBits, NULL, NULL)) {
-          SerialIo = &SerialDevices[Index]->SerialIo;
           Status = SerialIo->SetAttributes (
                                SerialIo,
                                Uart->BaudRate,

From 623f8330bcc1aa12947c799cd8129075f52b39e0 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Tue, 15 Dec 2015 06:00:10 +0000
Subject: [PATCH 242/525] MdeModulePkg UfsPassThru: ASSERT if params are NULL
 in SignalCallerEvent

In function SignalCallerEvent(), 'Private' and 'TransReq' are dereferenced
before NULL checking.

Since the function assumes that both 'Private' and 'TransReq' passed in
are not NULL pointer, this commit will add an ASSERT to make sure the
above assumption is satisfied.

(Sync patch r19266 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19270 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
index 4fbe199390f4..81653af5a8ad 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
@@ -2191,6 +2191,8 @@ SignalCallerEvent (
   EDKII_UFS_HOST_CONTROLLER_PROTOCOL *UfsHc;
   EFI_EVENT                          CallerEvent;
 
+  ASSERT ((Private != NULL) && (TransReq != NULL));
+
   UfsHc        = Private->UfsHostController;
   CallerEvent  = TransReq->CallerEvent;
 
@@ -2214,9 +2216,8 @@ SignalCallerEvent (
              TransReq->CmdDescHost
              );
   }
-  if (TransReq != NULL) {
-    FreePool (TransReq);
-  }
+
+  FreePool (TransReq);
 
   gBS->SignalEvent (CallerEvent);
   return;

From dcf73c32bf8ea9307c148f672fcef0dbcb05aff6 Mon Sep 17 00:00:00 2001
From: Masamitsu MURASE <masamitsu.murase@gmail.com>
Date: Tue, 15 Dec 2015 13:19:06 +0000
Subject: [PATCH 243/525] MdePkg: Add UefiDebugLibDebugPortProtocol to output
 logs via DebugPort.

UefiDebugLibDebugPortProtocol is an implementation of DebugLib.
It calls EFI_DEBUGPORT_PROTOCOL.Write in DebugPrint and DebugAssert.

(Sync patch r18414 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Masamitsu MURASE <masamitsu.murase@gmail.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19276 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiDebugLibDebugPortProtocol/DebugLib.c  | 329 ++++++++++++++++++
 .../UefiDebugLibDebugPortProtocol.inf         |  57 +++
 .../UefiDebugLibDebugPortProtocol.uni         | Bin 0 -> 1812 bytes
 MdePkg/MdePkg.dsc                             |   1 +
 4 files changed, 387 insertions(+)
 create mode 100644 MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
 create mode 100644 MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
 create mode 100644 MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.uni

diff --git a/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c b/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
new file mode 100644
index 000000000000..fdad2f5556f0
--- /dev/null
+++ b/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
@@ -0,0 +1,329 @@
+/** @file
+  UEFI Debug Library that sends messages to EFI_DEBUGPORT_PROTOCOL.Write.
+
+  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials                          
+  are licensed and made available under the terms and conditions of the BSD License         
+  which accompanies this distribution.  The full text of the license may be found at        
+  http://opensource.org/licenses/bsd-license.php.                                            
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             
+
+**/
+
+#include <Uefi.h>
+
+#include <Library/DebugLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/PrintLib.h>
+#include <Library/PcdLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DebugPrintErrorLevelLib.h>
+
+#include <Protocol/DebugPort.h>
+
+//
+// Define the maximum debug and assert message length that this library supports 
+//
+#define MAX_DEBUG_MESSAGE_LENGTH  0x100
+
+//
+// Define the timeout for EFI_DEBUGPORT_PROTOCOL.Write 
+//
+#define WRITE_TIMEOUT 1000
+
+
+EFI_DEBUGPORT_PROTOCOL *mDebugPort = NULL;
+
+/**
+  Send message to DebugPort Protocol.
+
+  If mDebugPort is NULL, i.e. EFI_DEBUGPORT_PROTOCOL is not located,
+  EFI_DEBUGPORT_PROTOCOL is located first.
+  Then, Buffer is sent via EFI_DEBUGPORT_PROTOCOL.Write.
+
+  @param  Buffer         The message to be sent.
+  @param  BufferLength   The byte length of Buffer.
+**/
+VOID
+UefiDebugLibDebugPortProtocolWrite (
+  IN  CONST CHAR8  *Buffer,
+  IN        UINTN  BufferLength
+  )
+{
+  UINTN      Length;
+  EFI_STATUS Status;
+
+  //
+  // If mDebugPort is NULL, initialize first.
+  //
+  if (mDebugPort == NULL) {
+      Status = gBS->LocateProtocol (&gEfiDebugPortProtocolGuid, NULL, (VOID **)&mDebugPort);
+      if (EFI_ERROR (Status)) {
+          return;
+      }
+
+      mDebugPort->Reset (mDebugPort);
+  }
+
+  //
+  // EFI_DEBUGPORT_PROTOCOL.Write is called until all message is sent.
+  //
+  while (BufferLength > 0) {
+    Length = BufferLength;
+
+    Status = mDebugPort->Write (mDebugPort, WRITE_TIMEOUT, &Length, (VOID *) Buffer);
+    if (EFI_ERROR (Status) || BufferLength < Length) {
+      break;
+    }
+
+    Buffer += Length;
+    BufferLength -= Length;
+  }
+}
+
+/**
+  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  ...         A 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,
+  ...
+  )
+{
+  CHAR8      Buffer[MAX_DEBUG_MESSAGE_LENGTH];
+  VA_LIST    Marker;
+
+  //
+  // 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 an ASCII String
+  //
+  VA_START (Marker, Format);
+  AsciiVSPrint (Buffer, sizeof (Buffer), Format, Marker);
+  VA_END (Marker);
+
+  //
+  // Send the print string to EFI_DEBUGPORT_PROTOCOL.Write.
+  //
+  UefiDebugLibDebugPortProtocolWrite (Buffer, AsciiStrLen (Buffer));
+}
+
+
+/**
+  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
+  )
+{
+  CHAR8  Buffer[MAX_DEBUG_MESSAGE_LENGTH];
+
+  //
+  // Generate the ASSERT() message in ASCII format
+  //
+  AsciiSPrint (
+    Buffer, 
+    sizeof (Buffer), 
+    "ASSERT %a(%d): %a\n", 
+    FileName, 
+    LineNumber, 
+    Description
+    );
+
+  //
+  // Send the print string to EFI_DEBUGPORT_PROTOCOL.Write.
+  //
+  UefiDebugLibDebugPortProtocolWrite (Buffer, AsciiStrLen (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/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf b/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
new file mode 100644
index 000000000000..11c7e815b8b5
--- /dev/null
+++ b/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
@@ -0,0 +1,57 @@
+## @file
+#  Instance of Debug Library using EFI_DEBUGPORT_PROTOCOL.
+#
+#  Debug Lib that sends messages to EFI_DEBUGPORT_PROTOCOL.Write.
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = UefiDebugLibDebugPortProtocol
+  MODULE_UNI_FILE                = UefiDebugLibDebugPortProtocol.uni
+  FILE_GUID                      = 102287b4-6b12-4D41-91e1-ebee1f3aa614
+  MODULE_TYPE                    = UEFI_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = DebugLib|DXE_CORE DXE_DRIVER DXE_RUNTIME_DRIVER DXE_SAL_DRIVER DXE_SMM_DRIVER UEFI_APPLICATION UEFI_DRIVER 
+
+
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+
+[Sources]
+  DebugLib.c
+
+
+
+[Packages]
+  MdePkg/MdePkg.dec
+
+
+[LibraryClasses]
+  BaseMemoryLib
+  BaseLib
+  PcdLib
+  PrintLib
+  UefiBootServicesTableLib
+  DebugPrintErrorLevelLib
+
+[Protocols]
+  gEfiDebugPortProtocolGuid                     ## UNDEFINED
+
+[Pcd]
+  gEfiMdePkgTokenSpaceGuid.PcdDebugClearMemoryValue        ## SOMETIMES_CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask            ## CONSUMES
+  gEfiMdePkgTokenSpaceGuid.PcdFixedDebugPrintErrorLevel    ## CONSUMES
+
diff --git a/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.uni b/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.uni
new file mode 100644
index 0000000000000000000000000000000000000000..83051cace477ca2941bd5523c2ea7ed35ab472ef
GIT binary patch
literal 1812
zcmc(fPj3@35XI+=#CNdL3!pXuBrXUcl6G5GwB0D#C~&Gaf10k;B-JJ@^vf51&rWtj
z8U$QGE3e1)_|2Q~v%fzytYMD!g3s9pyR_V{ZER2N3A0*@ZDtEwT1G!)#n~J$XGhor
zyR`}SDZ2(%;8WN=<6Cy*_-ie)V=yl8kE~@qJF&JU*0GeiHhqGX*dguI>Sf$2{^K|f
zHdn-2g1&&o%trLirq~O<jJUGoH~(t}eR9azIo`?U5X2jDl+Oef;_!^RJg0wcFYT4R
zv3+b+O&HhM+EcJgf3eQ7W}rK3vM!GbO{@#geoTLdHNx{9mFw919o0$Uko#P3@Snp;
zF{YsCyhik@l};^#<q(f4Otf~-zHmZQ#^Nd#8GIIH9PJVt$87FTUs@2S3SYZNs|a`4
z(ocpOq#`LnEQDP#39+W0^_r!a$y1dN^-(2)($*QYtc!|*+N8w5rBcdQUyC9C$Jyri
z2Su#wrC8FnvX+k5adj@Ls@PvLA5KV|zu~jZ>F2sggPFepgVp}|ssduP+^DORv*aY+
z`dcPVg?!{+_)6EwzTi9?TeV*>Gl2QX4z^b6pj^?aTck`ra_`*grk$Xorkyd4sip3)
z`jpw&-^~<XRk&y8{=Rmw*9cYhV-y|X(e=m)mXxf2jb6Ayt<ksqSfl-o-21ExH6c!l
zS0AsAXLimw22~h(BOERA+%>0|DZcVi)ZlfDm!f~6|HO)z>jp-vD3QmB>~o1zp~uvs
z&AX$RM;mpkG^Ka3;kj#0ZLd^KxILkM7a%2I^gxSv*_z}YR+>~xS^nzV;}mrZCY*eD
rxt!O+0a#*MgWbP-foo;1f0n0S^)4AoLGAKncIEo}JpboQU*-J+Kfe{x

literal 0
HcmV?d00001

diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index e8a3ea76332e..4ea367ccc070 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -114,6 +114,7 @@
   MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
   MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf
   MdePkg/Library/UefiDebugLibConOut/UefiDebugLibConOut.inf
+  MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
   MdePkg/Library/UefiDebugLibStdErr/UefiDebugLibStdErr.inf
   MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
   MdePkg/Library/UefiDevicePathLib/UefiDevicePathLibOptionalDevicePathProtocol.inf

From 2def2a6c41624a8c02cbb2c438744313a4d6d3cf Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Tue, 15 Dec 2015 13:19:32 +0000
Subject: [PATCH 244/525] MdePkg: Correct Protocol usages in
 UefiDebugLibDebugPortProtocol

(Sync patch r18415 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19277 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c         | 1 +
 .../UefiDebugLibDebugPortProtocol.inf                           | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c b/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
index fdad2f5556f0..10d3e347ccc6 100644
--- a/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
+++ b/MdePkg/Library/UefiDebugLibDebugPortProtocol/DebugLib.c
@@ -327,3 +327,4 @@ DebugPrintLevelEnabled (
 {
   return (BOOLEAN) ((ErrorLevel & PcdGet32(PcdFixedDebugPrintErrorLevel)) != 0);
 }
+
diff --git a/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf b/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
index 11c7e815b8b5..0f18c27a1130 100644
--- a/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
+++ b/MdePkg/Library/UefiDebugLibDebugPortProtocol/UefiDebugLibDebugPortProtocol.inf
@@ -48,7 +48,7 @@
   DebugPrintErrorLevelLib
 
 [Protocols]
-  gEfiDebugPortProtocolGuid                     ## UNDEFINED
+  gEfiDebugPortProtocolGuid                     ## CONSUMES
 
 [Pcd]
   gEfiMdePkgTokenSpaceGuid.PcdDebugClearMemoryValue        ## SOMETIMES_CONSUMES

From f770b72f916d2fc96c40c183879a2af65fcc584c Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 15 Dec 2015 13:28:00 +0000
Subject: [PATCH 245/525] MdePkg: Add 3 macro defined in latest TPM2
 specification.

Add 3 macro to TPM_RH Constants, which is in latest TPM2 spec.

(Sync patch r19230 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19278 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/IndustryStandard/Tpm20.h | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/MdePkg/Include/IndustryStandard/Tpm20.h b/MdePkg/Include/IndustryStandard/Tpm20.h
index 05059270107a..cd68ce7c76e4 100644
--- a/MdePkg/Include/IndustryStandard/Tpm20.h
+++ b/MdePkg/Include/IndustryStandard/Tpm20.h
@@ -675,7 +675,10 @@ typedef UINT32 TPM_RH;
 #define TPM_RH_LOCKOUT     (TPM_RH)(0x4000000A)
 #define TPM_RH_ENDORSEMENT (TPM_RH)(0x4000000B)
 #define TPM_RH_PLATFORM    (TPM_RH)(0x4000000C)
-#define TPM_RH_LAST        (TPM_RH)(0x4000000C)
+#define TPM_RH_PLATFORM_NV (TPM_RH)(0x4000000D)
+#define TPM_RH_AUTH_00     (TPM_RH)(0x40000010)
+#define TPM_RH_AUTH_FF     (TPM_RH)(0x4000010F)
+#define TPM_RH_LAST        (TPM_RH)(0x4000010F)
 
 // Table 28 - TPM_HC Constants
 typedef TPM_HANDLE TPM_HC;

From 69b6a5c34ac3775ffecb7d1a6acab04e55edb086 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 15 Dec 2015 13:33:46 +0000
Subject: [PATCH 246/525] Fix >4G issue on IDT not restored correctly.

Idtr might be changed inside of FSP. 32bit FSP only knows the <4G address.
If IDTR.Base is >4G, FSP can not handle. So we need save/restore IDTR here.
Interrupt is already disabled here, so it is safety to update IDTR.

(Sync patch r19246 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Ma, Maurice" <maurice.ma@intel.com>
Reviewed-by: "Mudusuru, Giri P" <giri.p.mudusuru@intel.com>
Reviewed-by: "Yarlagadda, Satya P" <satya.p.yarlagadda@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19279 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/BaseFspApiLib/X64/DispatchExecute.c    | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/IntelFspWrapperPkg/Library/BaseFspApiLib/X64/DispatchExecute.c b/IntelFspWrapperPkg/Library/BaseFspApiLib/X64/DispatchExecute.c
index e2f44225347c..360327ed08f5 100644
--- a/IntelFspWrapperPkg/Library/BaseFspApiLib/X64/DispatchExecute.c
+++ b/IntelFspWrapperPkg/Library/BaseFspApiLib/X64/DispatchExecute.c
@@ -89,6 +89,18 @@ Execute32BitCode (
   IN UINT64      Param1
   )
 {
-  return AsmExecute32BitCode (Function, Param1, 0, &mGdt);
+  EFI_STATUS       Status;
+  IA32_DESCRIPTOR  Idtr;
+
+  //
+  // Idtr might be changed inside of FSP. 32bit FSP only knows the <4G address.
+  // If IDTR.Base is >4G, FSP can not handle. So we need save/restore IDTR here for X64 only.
+  // Interrupt is already disabled here, so it is safety to update IDTR.
+  //
+  AsmReadIdtr (&Idtr);
+  Status = AsmExecute32BitCode (Function, Param1, 0, &mGdt);
+  AsmWriteIdtr (&Idtr);
+
+  return Status;
 }
 

From 4b71020adbcba630b37b86b920d98e40f0eb25df Mon Sep 17 00:00:00 2001
From: Feng Tian <feng.tian@intel.com>
Date: Thu, 17 Dec 2015 15:02:17 +0000
Subject: [PATCH 247/525] MdeModulePkg/PciSioSerialDxe:add non-null pointer
 dereference assertion

Add assertion to make sure there doesn't exist null pointer dereference.

(Sync patch r19308 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19322 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
index 7fc053578d7d..e8cefecd8d2d 100644
--- a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
@@ -870,6 +870,7 @@ SerialControllerDriverStart (
   if ((SerialDeviceCount != 0) && (RemainingDevicePath != NULL)) {
     Uart = (UART_DEVICE_PATH *) SkipControllerDevicePathNode (RemainingDevicePath, &ContainsControllerNode, &ControllerNumber);
     for (Index = 0; Index < SerialDeviceCount; Index++) {
+      ASSERT ((SerialDevices != NULL) && (SerialDevices[Index] != NULL));
       if ((!SerialDevices[Index]->ContainsControllerNode && !ContainsControllerNode) ||
           (SerialDevices[Index]->ContainsControllerNode && ContainsControllerNode && SerialDevices[Index]->Instance == ControllerNumber)
           ) {
@@ -963,6 +964,7 @@ SerialControllerDriverStart (
         // Restore the PCI attributes when all children is destroyed (PciDeviceInfo->ChildCount == 0).
         //
         PciDeviceInfo = AllocatePool (sizeof (PCI_DEVICE_INFO));
+        ASSERT (PciDeviceInfo != NULL);
         PciDeviceInfo->ChildCount = 0;
         PciDeviceInfo->PciIo = ParentIo.PciIo;
         Status = ParentIo.PciIo->Attributes (
@@ -993,6 +995,7 @@ SerialControllerDriverStart (
         //
         // Re-use the PciDeviceInfo stored in existing children.
         //
+        ASSERT ((SerialDevices != NULL) && (SerialDevices[0] != NULL));
         PciDeviceInfo = SerialDevices[0]->PciDeviceInfo;
         ASSERT (PciDeviceInfo != NULL);
       }

From 4b2bb7094053f8e7624a435b57f3ab547c5de043 Mon Sep 17 00:00:00 2001
From: Feng Tian <feng.tian@intel.com>
Date: Thu, 17 Dec 2015 15:14:25 +0000
Subject: [PATCH 248/525] MdeModulePkg/PciSioSerialDxe:bitwise operation have
 same width operands

Operands in a bitwise operation have different size. Update code to fix it.

(Sync patch r19309 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19323 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
index e8cefecd8d2d..aeafee247c9b 100644
--- a/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
+++ b/MdeModulePkg/Bus/Pci/PciSioSerialDxe/Serial.c
@@ -982,7 +982,7 @@ SerialControllerDriverStart (
             &Supports
             );
           if (!EFI_ERROR (Status)) {
-            Supports &= EFI_PCI_IO_ATTRIBUTE_IO | EFI_PCI_IO_ATTRIBUTE_MEMORY;
+            Supports &= (UINT64)(EFI_PCI_IO_ATTRIBUTE_IO | EFI_PCI_IO_ATTRIBUTE_MEMORY);
             Status = ParentIo.PciIo->Attributes (
               ParentIo.PciIo,
               EfiPciIoAttributeOperationEnable,

From 99224547e3b98042aea13c48e67ebb0daf8e9e20 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Thu, 17 Dec 2015 15:15:13 +0000
Subject: [PATCH 249/525] MdeModulePkg:Fix a bug HttpLib can't parse last
 chunked data well

When HttpLib parsing the last chunked data down, the Http NextMsg pointer
in the HttpBodyParserCallback function should point to the character
after '/n' flag.

(Sync patch r19310 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19324 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c | 39 ++++++++++++--------
 1 file changed, 24 insertions(+), 15 deletions(-)

diff --git a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
index 500b3c72b38f..6b830fdd9be8 100644
--- a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
+++ b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
@@ -1161,21 +1161,7 @@ HttpParseMessageBody (
     switch (Parser->State) {
     case BodyParserStateMax:
       return EFI_ABORTED;
-
-    case BodyParserComplete:
-      if (Parser->Callback != NULL) {
-        Status = Parser->Callback (
-                   BodyParseEventOnComplete,
-                   Char,
-                   0,
-                   Parser->Context
-                   );
-        if (EFI_ERROR (Status)) {
-          return Status;
-        }
-      }
-      return EFI_SUCCESS;
-    
+ 
     case BodyParserBodyIdentity:
       //
       // Identity transfer-coding, just notify user to save the body data.
@@ -1195,6 +1181,17 @@ HttpParseMessageBody (
       Parser->ParsedBodyLength += MIN (BodyLength, Parser->ContentLength - Parser->ParsedBodyLength);
       if (Parser->ParsedBodyLength == Parser->ContentLength) {
         Parser->State = BodyParserComplete;
+        if (Parser->Callback != NULL) {
+          Status = Parser->Callback (
+                     BodyParseEventOnComplete,
+                     Char,
+                     0,
+                     Parser->Context
+                     );
+          if (EFI_ERROR (Status)) {
+            return Status;
+          }
+        }
       }
       break;
 
@@ -1272,6 +1269,18 @@ HttpParseMessageBody (
     case BodyParserLastCRLFEnd:
       if (*Char == '\n') {
         Parser->State = BodyParserComplete;
+        Char++;
+        if (Parser->Callback != NULL) {
+          Status = Parser->Callback (
+                     BodyParseEventOnComplete,
+                     Char,
+                     0,
+                     Parser->Context
+                     );
+          if (EFI_ERROR (Status)) {
+            return Status;
+          }
+        }
         break;
       } else {
         Parser->State = BodyParserStateMax;

From b85d3c6d351d59f96894134194ba4f85118ddb08 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Thu, 17 Dec 2015 15:15:42 +0000
Subject: [PATCH 250/525] MdeModulePkg: Update print error level for
 RuntimeDriver alignment check

In DxeCore, use warning message for Runtime driver that doesn't satisfy
section alignment requirement. This check is required when PropertiesTable
is installed. So, add error message if PropertiesTable can't be installed
successfully.

(Sync patch r19312 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19325 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Core/Dxe/Misc/PropertiesTable.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Core/Dxe/Misc/PropertiesTable.c b/MdeModulePkg/Core/Dxe/Misc/PropertiesTable.c
index 34867375b157..adfc91c41f95 100644
--- a/MdeModulePkg/Core/Dxe/Misc/PropertiesTable.c
+++ b/MdeModulePkg/Core/Dxe/Misc/PropertiesTable.c
@@ -1120,11 +1120,11 @@ InsertImageRecord (
 
   SetPropertiesTableSectionAlignment (SectionAlignment);
   if ((SectionAlignment & (EFI_ACPI_RUNTIME_PAGE_ALLOCATION_ALIGNMENT - 1)) != 0) {
-    DEBUG ((EFI_D_ERROR, "!!!!!!!!  InsertImageRecord - Section Alignment(0x%x) is not %dK  !!!!!!!!\n",
+    DEBUG ((EFI_D_WARN, "!!!!!!!!  InsertImageRecord - Section Alignment(0x%x) is not %dK  !!!!!!!!\n",
       SectionAlignment, EFI_ACPI_RUNTIME_PAGE_ALLOCATION_ALIGNMENT >> 10));
     PdbPointer = PeCoffLoaderGetPdbPointer ((VOID*) (UINTN) ImageAddress);
     if (PdbPointer != NULL) {
-      DEBUG ((EFI_D_ERROR, "!!!!!!!!  Image - %a  !!!!!!!!\n", PdbPointer));
+      DEBUG ((EFI_D_WARN, "!!!!!!!!  Image - %a  !!!!!!!!\n", PdbPointer));
     }
     goto Finish;
   }
@@ -1320,6 +1320,8 @@ InstallPropertiesTable (
 
     DEBUG ((EFI_D_INFO, "MemoryProtectionAttribute - 0x%016lx\n", mPropertiesTable.MemoryProtectionAttribute));
     if ((mPropertiesTable.MemoryProtectionAttribute & EFI_PROPERTIES_RUNTIME_MEMORY_PROTECTION_NON_EXECUTABLE_PE_DATA) == 0) {
+      DEBUG ((EFI_D_ERROR, "MemoryProtectionAttribute NON_EXECUTABLE_PE_DATA is not set, "));
+      DEBUG ((EFI_D_ERROR, "because Runtime Driver Section Alignment is not %dK.\n", EFI_ACPI_RUNTIME_PAGE_ALLOCATION_ALIGNMENT >> 10));
       return ;
     }
 

From 323d56b992549db17e96251e03b9b40923c9ebe4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Thu, 17 Dec 2015 15:16:03 +0000
Subject: [PATCH 251/525] Add clarification for PcdAcpiDefault value PCD.

Add clarification for PcdAcpiDefaultOemTableId, PcdAcpiDefaultOemRevision,
PcdAcpiDefaultCreatorId, PcdAcpiDefaultCreatorRevision.
According to ACPI spec, they are used as special meaning for SSDT,
so we ignore them in updating generic SSDT provided by EDKII.

(Sync patch r19321 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19326 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dec |  14 ++++++++++++++
 MdeModulePkg/MdeModulePkg.uni | Bin 184014 -> 188464 bytes
 2 files changed, 14 insertions(+)

diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 38eac142ac79..3ded8f1de1a5 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -1387,18 +1387,32 @@
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemId|"INTEL "|VOID*|0x30001034
 
   ## Default OEM Table ID for ACPI table creation, it is "EDK2    ".
+  #  Accroding to ACPI specification, this field is particularly useful when
+  #  defining a definition block to distinguish definition block functions.
+  #  The OEM assigns each dissimilar table a new OEM Table ID.
+  #  This PCD is ignored for definition block.
   # @Prompt Default OEM Table ID for ACPI table creation.
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemTableId|0x20202020324B4445|UINT64|0x30001035
 
   ## Default OEM Revision for ACPI table creation.
+  #  Accroding to ACPI specification, for LoadTable() opcode, the OS can also
+  #  check the OEM Table ID and Revision ID against a database for a newer
+  #  revision Definition Block of the same OEM Table ID and load it instead.
+  #  This PCD is ignored for definition block.
   # @Prompt Default OEM Revision for ACPI table creation.
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemRevision|0x00000002|UINT32|0x30001036
 
   ## Default Creator ID for ACPI table creation.
+  #  Accroding to ACPI specification, for tables containing Definition Blocks,
+  #  this is the ID for the ASL Compiler.
+  #  This PCD is ignored for definition block.
   # @Prompt Default Creator ID for ACPI table creation.
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorId|0x20202020|UINT32|0x30001037
 
   ## Default Creator Revision for ACPI table creation.
+  #  Accroding to ACPI specification, for tables containing Definition Blocks,
+  #  this is the revision for the ASL Compiler.
+  #  This PCD is ignored for definition block.
   # @Prompt Default Creator Revision for ACPI table creation.
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision|0x01000013|UINT32|0x30001038
 
diff --git a/MdeModulePkg/MdeModulePkg.uni b/MdeModulePkg/MdeModulePkg.uni
index b1fd210d2b93664435762262a67efa34006061b1..cf4f580dbe00f37290742a5e8eb968197b45653c 100644
GIT binary patch
delta 1227
zcmcIjO=}ZT6umRHH5w__SO%-bG%7aGg^Rkjja8zg45f-o9g|5Swlgsw7I#`f7m7sg
zVx%I}oh#dzmPlP_v1p|tBDj_Q0&(R|@!Xe8TQ><VBxK&a`|-{_=e+s!Bsl*jSkb?~
z;Ka`W-#`6sUxbD!iC>;vO3@W^C_`Z?lFJY0kD3GOJ&Sk&Z)vPHO`tB^h~&sZXA!$3
zm5`C$1l>Tsgbo`W5)IQ7WwCQS&D54dDU}c?AI{>+b|V_5%P4kn)K#=#1UzM=f&!4i
zN@|yt>fXPr1;|0CjN+2R+M~BT6bx`KyK~f}Q#6XRESyw8K7&f3V<VEpU_OfECh@P+
zkO?d`k*#{e=(1^w?^X75#9Z}`t?51dae8-q8i08jX~)J$p5^ETo_&6R%L{w>M=i$d
z3vnKro5p^oA^mD|>BmHRbu`ulAS`HcZeyZ;iX!e(4h+ONn|!NeT9d}{OrqMsYJpJ!
zhISdtp@?E^<5|}jwt!J@yHuw5#LI5u42`Is4En?$Q6FdU*kH)moXA2<=>g=toUBDW
zEvki%j36NQM9giNfzsF(V_iz~tynidsPr6Cu*i$;LQw9N!1=(i$h-DTdk-%=S}R^H
zFRo|}c~_dtJHA!kO{3*nh@g%#zs{omMYQ5opaHLIPJ7L>PuuwS*<Htr>dJ?yuBY#$
zA038634omh*d$z(TL&dQ?YjPfZ(eNkW*+OE-lYqANAo*YUOZg=R{QL;{$e!wn*Rr9
t?mNHcQ{D!0-miYm;Pq<YU<;<)XMX(`qMfe>Z^xJJ#+S5Od`Z8v_Ya$BFlGP%

delta 76
zcmdmRfcxBBZl?eLHoV(3UCWj+ZSuTzGMmeG>|liP#5SMVzYd94bMzjRS8&FpdDZFm
ORi_!ZuR6`tCISF|_9N5)


From 9fe90f039a7784943362eab0ebc0949ebd1f6486 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:40:43 +0000
Subject: [PATCH 252/525] SecurityPkg: Correct Pcd Usage PcdTpm2HashMask in
 Tcg2Pei

Tcg2Pei sets PcdTpm2HashMask. Its usage should be both SOMETIMES_CONSUMES
and SOMETIMES_PRODUCES.

(Sync patch r19314 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19348 6f19259b-4bc3-4df7-8a09-765794883524
---
 SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.inf | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.inf b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.inf
index 29ca3aa918fb..007ce918eda9 100644
--- a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.inf
+++ b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.inf
@@ -78,7 +78,9 @@
   gEfiSecurityPkgTokenSpaceGuid.PcdTpm2ScrtmPolicy                     ## CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdPeiCoreMaxFvSupported              ## CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdStatusCodeSubClassTpmDevice         ## SOMETIMES_CONSUMES
-  gEfiSecurityPkgTokenSpaceGuid.PcdTpm2HashMask                        ## CONSUMES
+  ## SOMETIMES_CONSUMES
+  ## SOMETIMES_PRODUCES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTpm2HashMask
 
 [Depex]
   gEfiPeiMasterBootModePpiGuid AND

From 72b61d20fc59d35232ad0960dcf89735b064a96b Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:41:21 +0000
Subject: [PATCH 253/525] MdeModulePkg: Correct usage
 gEfiIp4Config2ProtocolGuid in Ip4Dxe

Ip4Dxe driver installs gEfiIp4Config2ProtocolGuid.
Its usage should be BY_START.

(Sync patch r19315 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19349 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf
index b93f2b733023..f561af0c75a4 100644
--- a/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf
+++ b/MdeModulePkg/Universal/Network/Ip4Dxe/Ip4Dxe.inf
@@ -95,7 +95,7 @@
   gEfiManagedNetworkServiceBindingProtocolGuid  ## TO_START
   gEfiManagedNetworkProtocolGuid                ## TO_START
   gEfiArpServiceBindingProtocolGuid             ## TO_START
-  gEfiIp4Config2ProtocolGuid                    ## TO_START
+  gEfiIp4Config2ProtocolGuid                    ## BY_START
   gEfiArpProtocolGuid                           ## TO_START
   gEfiDhcp4ServiceBindingProtocolGuid           ## TO_START
   gEfiDhcp4ProtocolGuid                         ## TO_START

From 82e945021ef3e9a88cddf68e7d93b10bc7fe1c27 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:41:59 +0000
Subject: [PATCH 254/525] SourceLevelDebugPkg: Correct gEfiDebugAgentGuid usage
 in DxeDebugAgentLib

DxeDebugAgentLib instance produces gEfiDebugAgentGuid system table.
Its usage should be PRODUCES instead of SOMETIMES_PRODUCES.

(Sync patch r19316 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19350 6f19259b-4bc3-4df7-8a09-765794883524
---
 SourceLevelDebugPkg/Library/DebugAgent/DxeDebugAgentLib.inf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SourceLevelDebugPkg/Library/DebugAgent/DxeDebugAgentLib.inf b/SourceLevelDebugPkg/Library/DebugAgent/DxeDebugAgentLib.inf
index 7ed5f5514c00..8894a047c34c 100644
--- a/SourceLevelDebugPkg/Library/DebugAgent/DxeDebugAgentLib.inf
+++ b/SourceLevelDebugPkg/Library/DebugAgent/DxeDebugAgentLib.inf
@@ -81,7 +81,7 @@
   MemoryAllocationLib
 
 [Guids]
-  ## SOMETIMES_PRODUCES ## SystemTable
+  ## PRODUCES ## SystemTable
   ## CONSUMES ## HOB
   gEfiDebugAgentGuid
   ## SOMETIMES_CONSUMES ## SystemTable

From 210774babaca41d457777aa030b571286b4dfc7a Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:42:32 +0000
Subject: [PATCH 255/525] NetworkPkg: Correct gEfiUdp4ProtocolGuid usage in
 DnsDxe

DnsDxe driver locates gEfiUdp4ProtocolGuid. Its usage should be TO_START.

(Sync patch r19317 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19351 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/DnsDxe/DnsDxe.inf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NetworkPkg/DnsDxe/DnsDxe.inf b/NetworkPkg/DnsDxe/DnsDxe.inf
index d63bbbebc47e..0d1efd8e0179 100644
--- a/NetworkPkg/DnsDxe/DnsDxe.inf
+++ b/NetworkPkg/DnsDxe/DnsDxe.inf
@@ -57,7 +57,7 @@
   gEfiDns4ServiceBindingProtocolGuid              ## BY_START
   gEfiDns4ProtocolGuid                            ## BY_START
   gEfiUdp4ServiceBindingProtocolGuid              ## TO_START
-  gEfiUdp4ProtocolGuid                            ## BY_START
+  gEfiUdp4ProtocolGuid                            ## TO_START
   gEfiDhcp4ServiceBindingProtocolGuid             ## SOMETIMES_CONSUMES
   gEfiDhcp4ProtocolGuid                           ## SOMETIMES_CONSUMES
   gEfiIp4Config2ProtocolGuid                      ## SOMETIMES_CONSUMES

From a8d5a3a25be665915784a0cbdec0ff7afab67a8e Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Fri, 18 Dec 2015 05:43:19 +0000
Subject: [PATCH 256/525] NetworkPkg:Fix the issue Http boot hang when network
 failed.

For both IPv4 and IPv6, when network transfer failed, such as disconnected
cable or disable http server, HTTP boot should exit back to the menu UI
rather than hang.

(Sync patch r19335 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19352 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpProto.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index d4ab74f0094d..b7cd0fdfcc53 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -150,6 +150,9 @@ HttpTcpReceiveNotifyDpc (
     gBS->CloseEvent (Wrap->TcpWrap.Rx6Token.CompletionToken.Event);
     
     if (EFI_ERROR (Wrap->TcpWrap.Rx6Token.CompletionToken.Status)) {
+      Wrap->HttpToken->Status = Wrap->TcpWrap.Rx6Token.CompletionToken.Status;
+      gBS->SignalEvent (Wrap->HttpToken->Event);
+      FreePool (Wrap);
       return ;
     }
 
@@ -157,6 +160,9 @@ HttpTcpReceiveNotifyDpc (
     gBS->CloseEvent (Wrap->TcpWrap.Rx4Token.CompletionToken.Event);
     
     if (EFI_ERROR (Wrap->TcpWrap.Rx4Token.CompletionToken.Status)) {
+      Wrap->HttpToken->Status = Wrap->TcpWrap.Rx4Token.CompletionToken.Status;
+      gBS->SignalEvent (Wrap->HttpToken->Event);
+      FreePool (Wrap);
       return ;
     }
   }

From 9a46a893ddd9bbed649746e501facf5ec217272d Mon Sep 17 00:00:00 2001
From: Dandan Bi <dandan.bi@intel.com>
Date: Fri, 18 Dec 2015 05:43:54 +0000
Subject: [PATCH 257/525] MdeModulePkg:Fix bug that get the password width info
 incorrectly

(Sync patch r19336 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <dandan.bi@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19353 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index 52aa4d8bcf0b..0deaf205573b 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -1583,6 +1583,8 @@ GetWidth (
     return (UINT16) sizeof (BOOLEAN);
     
   case EFI_IFR_PASSWORD_OP:
+    return (UINT16)((UINTN) ((EFI_IFR_PASSWORD *) OpCodeData)->MaxSize * sizeof (CHAR16));
+
   case EFI_IFR_STRING_OP:
     return (UINT16)((UINTN) ((EFI_IFR_STRING *) OpCodeData)->MaxSize * sizeof (CHAR16));
 

From f64559d605c9c2fb60770bd202dc3fea5dbb90e8 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:44:39 +0000
Subject: [PATCH 258/525] EdkCompatibilityPkg: Fix GCC error to avoid the
 duplicated global variables

SmmBaseHelper uses the same name global variables to the one in
SmmMemoryAllocateLib. Update SmmBaseHelper to use SmmMemLib
SmmIsBufferOutsideSmmValid().

(Sync patch r19337 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19354 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmmBaseHelper/SmmBaseHelper.c             | 84 +------------------
 .../SmmBaseHelper/SmmBaseHelper.inf           |  2 +-
 EdkCompatibilityPkg/EdkCompatibilityPkg.dsc   |  2 +
 3 files changed, 5 insertions(+), 83 deletions(-)

diff --git a/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.c b/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.c
index 1d1644923da1..16566d2b2948 100644
--- a/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.c
+++ b/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.c
@@ -34,6 +34,7 @@
 #include <Library/MemoryAllocationLib.h>
 #include <Library/SynchronizationLib.h>
 #include <Library/CpuLib.h>
+#include <Library/SmmMemLib.h>
 #include <Guid/SmmBaseThunkCommunication.h>
 #include <Protocol/SmmBaseHelperReady.h>
 #include <Protocol/SmmCpu.h>
@@ -42,7 +43,6 @@
 #include <Protocol/MpService.h>
 #include <Protocol/LoadPe32Image.h>
 #include <Protocol/SmmReadyToLock.h>
-#include <Protocol/SmmAccess2.h>
 
 /**
   Register SMM image to SMRAM profile.
@@ -122,8 +122,6 @@ SPIN_LOCK                          mPFLock;
 UINT64                             mPhyMask;
 VOID                               *mOriginalHandler;
 EFI_SMM_CPU_SAVE_STATE             *mShadowSaveState;
-EFI_SMRAM_DESCRIPTOR               *mSmramRanges;
-UINTN                              mSmramRangeCount;
 
 LIST_ENTRY mCallbackInfoListHead = INITIALIZE_LIST_HEAD_VARIABLE (mCallbackInfoListHead);
 
@@ -743,60 +741,6 @@ LoadImage (
   return Status;
 }
 
-/**
-  This function check if the address is in SMRAM.
-
-  @param Buffer  the buffer address to be checked.
-  @param Length  the buffer length to be checked.
-
-  @retval TRUE  this address is in SMRAM.
-  @retval FALSE this address is NOT in SMRAM.
-**/
-BOOLEAN
-IsAddressInSmram (
-  IN EFI_PHYSICAL_ADDRESS  Buffer,
-  IN UINT64                Length
-  )
-{
-  UINTN  Index;
-
-  for (Index = 0; Index < mSmramRangeCount; Index ++) {
-    if (((Buffer >= mSmramRanges[Index].CpuStart) && (Buffer < mSmramRanges[Index].CpuStart + mSmramRanges[Index].PhysicalSize)) ||
-        ((mSmramRanges[Index].CpuStart >= Buffer) && (mSmramRanges[Index].CpuStart < Buffer + Length))) {
-      return TRUE;
-    }
-  }
-
-  return FALSE;
-}
-
-/**
-  This function check if the address refered by Buffer and Length is valid.
-
-  @param Buffer  the buffer address to be checked.
-  @param Length  the buffer length to be checked.
-
-  @retval TRUE  this address is valid.
-  @retval FALSE this address is NOT valid.
-**/
-BOOLEAN
-IsAddressValid (
-  IN UINTN                 Buffer,
-  IN UINTN                 Length
-  )
-{
-  if (Buffer > (MAX_ADDRESS - Length)) {
-    //
-    // Overflow happen
-    //
-    return FALSE;
-  }
-  if (IsAddressInSmram ((EFI_PHYSICAL_ADDRESS)Buffer, (UINT64)Length)) {
-    return FALSE;
-  }
-  return TRUE;
-}
-
 /** 
   Thunk service of EFI_SMM_BASE_PROTOCOL.Register().
 
@@ -1133,7 +1077,7 @@ SmmHandlerEntry (
   ASSERT (CommBufferSize != NULL);
 
   if (*CommBufferSize == sizeof (SMMBASE_FUNCTION_DATA) &&
-      IsAddressValid ((UINTN)CommBuffer, *CommBufferSize)) {
+      SmmIsBufferOutsideSmmValid ((EFI_PHYSICAL_ADDRESS)(UINTN)CommBuffer, (UINT64)*CommBufferSize)) {
     FunctionData = (SMMBASE_FUNCTION_DATA *)CommBuffer;
 
     switch (FunctionData->Function) {
@@ -1207,8 +1151,6 @@ SmmBaseHelperMain (
   EFI_HANDLE                 Handle;
   UINTN                      NumberOfEnabledProcessors;
   VOID                       *Registration;
-  EFI_SMM_ACCESS2_PROTOCOL   *SmmAccess;
-  UINTN                      Size;
   
   Handle = NULL;
   ///
@@ -1253,28 +1195,6 @@ SmmBaseHelperMain (
   mSmmBaseHelperReady->FrameworkSmst = mFrameworkSmst;
   mSmmBaseHelperReady->ServiceEntry = SmmHandlerEntry;
 
-  //
-  // Get SMRAM information
-  //
-  Status = gBS->LocateProtocol (&gEfiSmmAccess2ProtocolGuid, NULL, (VOID **)&SmmAccess);
-  ASSERT_EFI_ERROR (Status);
-
-  Size = 0;
-  Status = SmmAccess->GetCapabilities (SmmAccess, &Size, NULL);
-  ASSERT (Status == EFI_BUFFER_TOO_SMALL);
-
-  Status = gSmst->SmmAllocatePool (
-                    EfiRuntimeServicesData,
-                    Size,
-                    (VOID **)&mSmramRanges
-                    );
-  ASSERT_EFI_ERROR (Status);
-
-  Status = SmmAccess->GetCapabilities (SmmAccess, &Size, mSmramRanges);
-  ASSERT_EFI_ERROR (Status);
-
-  mSmramRangeCount = Size / sizeof (EFI_SMRAM_DESCRIPTOR);
-
   //
   // Register SMM Ready To Lock Protocol notification
   //
diff --git a/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.inf b/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.inf
index 8e967dc2cb38..118640b1e4a0 100644
--- a/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.inf
+++ b/EdkCompatibilityPkg/Compatibility/SmmBaseHelper/SmmBaseHelper.inf
@@ -60,6 +60,7 @@
   SynchronizationLib
   CpuLib
   PcdLib
+  SmmMemLib
 
 [Guids]
   gEfiSmmBaseThunkCommunicationGuid
@@ -75,7 +76,6 @@
   gEfiSmmCpuIo2ProtocolGuid              # PROTOCOL ALWAYS_CONSUMED
   gEfiLoadPeImageProtocolGuid            # PROTOCOL ALWAYS_CONSUMED
   gEfiSmmReadyToLockProtocolGuid         # PROTOCOL ALWAYS_CONSUMED
-  gEfiSmmAccess2ProtocolGuid             # PROTOCOL ALWAYS_CONSUMED
   gEfiSmmCommunicationProtocolGuid
 
 [Pcd]
diff --git a/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc b/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
index 016e9adeedf3..eca611de07e4 100644
--- a/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
+++ b/EdkCompatibilityPkg/EdkCompatibilityPkg.dsc
@@ -72,6 +72,7 @@ DEFINE GCC_MACRO                 = -DEFI_SPECIFICATION_VERSION=0x00020000 -DPI_S
   LocalApicLib|UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.inf
   DxeServicesLib|MdePkg/Library/DxeServicesLib/DxeServicesLib.inf
   LockBoxLib|MdeModulePkg/Library/LockBoxNullLib/LockBoxNullLib.inf
+  SmmMemLib|MdePkg/Library/SmmMemLib/SmmMemLib.inf
 
 [LibraryClasses.common.PEIM]
   MemoryAllocationLib|MdePkg/Library/PeiMemoryAllocationLib/PeiMemoryAllocationLib.inf
@@ -84,6 +85,7 @@ DEFINE GCC_MACRO                 = -DEFI_SPECIFICATION_VERSION=0x00020000 -DPI_S
   SmmServicesTableLib|MdePkg/Library/SmmServicesTableLib/SmmServicesTableLib.inf
   ReportStatusCodeLib|MdeModulePkg/Library/SmmReportStatusCodeLib/SmmReportStatusCodeLib.inf
   MemoryAllocationLib|MdePkg/Library/SmmMemoryAllocationLib/SmmMemoryAllocationLib.inf
+  HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
 
 [BuildOptions.Common.EDK]
   GCC:*_*_IA32_CC_FLAGS     = -DEFI32 $(GCC_MACRO)

From bb44a4d107b7355d2daca93b679285cb5fd496c9 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:45:12 +0000
Subject: [PATCH 259/525] DuetPkg: Fix GCC error to avoid the duplicated global
 variables in EfiLdr

Move the global variable definitions into source code instead of head filer.

(Sync patch r19338 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19355 6f19259b-4bc3-4df7-8a09-765794883524
---
 DuetPkg/EfiLdr/EfiLdr.h    | 3 ---
 DuetPkg/EfiLdr/EfiLoader.c | 3 +++
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/DuetPkg/EfiLdr/EfiLdr.h b/DuetPkg/EfiLdr/EfiLdr.h
index 665f40585507..4f21cf3f790f 100644
--- a/DuetPkg/EfiLdr/EfiLdr.h
+++ b/DuetPkg/EfiLdr/EfiLdr.h
@@ -80,9 +80,6 @@ typedef struct {
   BIOS_MEMORY_MAP_ENTRY MemoryMapEntry[1];
 } BIOS_MEMORY_MAP;
 
-EFILDR_LOADED_IMAGE    DxeCoreImage;
-EFILDR_LOADED_IMAGE    DxeIplImage;
-
 typedef
 VOID
 (EFIAPI * EFI_MAIN_ENTRYPOINT) (
diff --git a/DuetPkg/EfiLdr/EfiLoader.c b/DuetPkg/EfiLdr/EfiLoader.c
index 691302765074..b23966e5ee1a 100644
--- a/DuetPkg/EfiLdr/EfiLoader.c
+++ b/DuetPkg/EfiLdr/EfiLoader.c
@@ -24,6 +24,9 @@ Revision History:
 #include "PeLoader.h"
 #include "LzmaDecompress.h"
 
+EFILDR_LOADED_IMAGE    DxeCoreImage;
+EFILDR_LOADED_IMAGE    DxeIplImage;
+
 VOID
 SystemHang (
   CHAR8        *Message

From b95380aa266cf3e2869e7cd69ded5621f332d281 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Fri, 18 Dec 2015 05:45:52 +0000
Subject: [PATCH 260/525] DuetPkg: Fix GCC error to avoid the duplicated global
 variable in SmbiosGenDxe

Update SmbiosGenDxe to use UefiHiiServicesLib.

(Sync patch r19339 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19356 6f19259b-4bc3-4df7-8a09-765794883524
---
 DuetPkg/SmbiosGenDxe/SmbiosGen.c   | 11 -----------
 DuetPkg/SmbiosGenDxe/SmbiosGen.h   |  1 +
 DuetPkg/SmbiosGenDxe/SmbiosGen.inf |  1 +
 3 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/DuetPkg/SmbiosGenDxe/SmbiosGen.c b/DuetPkg/SmbiosGenDxe/SmbiosGen.c
index 03e093639b64..393bb4d374e5 100644
--- a/DuetPkg/SmbiosGenDxe/SmbiosGen.c
+++ b/DuetPkg/SmbiosGenDxe/SmbiosGen.c
@@ -18,7 +18,6 @@ Module Name:
 **/
 
 #include "SmbiosGen.h"
-EFI_HII_DATABASE_PROTOCOL   *gHiiDatabase;
 extern UINT8                SmbiosGenDxeStrings[];
 EFI_SMBIOS_PROTOCOL         *gSmbios;
 EFI_HII_HANDLE              gStringHandle;
@@ -211,16 +210,6 @@ SmbiosGenEntrypoint (
   if (EFI_ERROR (Status)) {
     return Status;
   }
-
-  Status = gBS->LocateProtocol (
-                  &gEfiHiiDatabaseProtocolGuid,
-                  NULL,
-                  (VOID**)&gHiiDatabase
-                  );
-
-  if (EFI_ERROR (Status)) {
-    return Status;
-  }
   
   gStringHandle = HiiAddPackages (
                     &gEfiCallerIdGuid,
diff --git a/DuetPkg/SmbiosGenDxe/SmbiosGen.h b/DuetPkg/SmbiosGenDxe/SmbiosGen.h
index 0474366b04c8..3a42e22887c6 100644
--- a/DuetPkg/SmbiosGenDxe/SmbiosGen.h
+++ b/DuetPkg/SmbiosGenDxe/SmbiosGen.h
@@ -39,6 +39,7 @@ Module Name:
 #include <Library/DebugLib.h>
 #include <Library/BaseMemoryLib.h>
 #include <Library/MemoryAllocationLib.h>
+#include <Library/UefiHiiServicesLib.h>
 
 #define   PRODUCT_NAME                  L"DUET"
 #define   PRODUCT_VERSION               L"Beta"
diff --git a/DuetPkg/SmbiosGenDxe/SmbiosGen.inf b/DuetPkg/SmbiosGenDxe/SmbiosGen.inf
index e413beb7f38d..c8568dabe474 100644
--- a/DuetPkg/SmbiosGenDxe/SmbiosGen.inf
+++ b/DuetPkg/SmbiosGenDxe/SmbiosGen.inf
@@ -41,6 +41,7 @@
   UefiDriverEntryPoint
   BaseLib
   HiiLib
+  UefiHiiServicesLib
   
 [Sources]
   SmbiosGen.c

From 2f10bcddc5be6f4809f3fd2874999627c2fa6b1b Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:46:37 +0000
Subject: [PATCH 261/525] UefiCpuPkg/CpuMpPei: Fix pack(1) issue on x64 arch

Packing alignment for MP_CPU_EXCHANGE_INFO should be 1. This should be typo when
check-in CpuMpPei driver. IA32 arch MP_CPU_EXCHANGE_INFO is luckly pack(1). It
leads CpuMpPei x64 version hung.

(Sync patch r19340 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Reported-by: Michael Kinney <michael.d.kinney@intel.com>
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19357 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index f2286b990ee9..2b960c6eb1fe 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -72,7 +72,7 @@ typedef struct {
 
 typedef struct _PEI_CPU_MP_DATA  PEI_CPU_MP_DATA;
 
-#pragma pack()
+#pragma pack(1)
 
 typedef union {
   struct {
@@ -95,6 +95,8 @@ typedef union {
 
 //
 // MP CPU exchange information for AP reset code
+// This structure is required to be packed because fixed field offsets
+// into this structure are used in assembly code in this module
 //
 typedef struct {
   UINTN                 Lock;

From 75cffb4d2e62d7be3d78d50ec97978fdfad570b4 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:47:12 +0000
Subject: [PATCH 262/525] UefiCpuPkg: Add PCD PcdCpuApLoopMode

This new PCD is used to specify the AP loop mode during POST phase.

The value 1 means we will place AP in the Hlt-Loop state by HLT instruction.
BSP need to send INIT-SIPI-SIPI to wake up APs.

The value 2 means we will place AP in the deepest C-state by MWAIT instruction.
BSP need to modify the monitor buffer by MONITOR instruction to wake up APs.

The value 3 means we will place AP in the Run-loop state. APs are running.
BSP need to write one semaphore to wake up APs.

(Sync patch r19341 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19358 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.dec |   8 ++++++++
 UefiCpuPkg/UefiCpuPkg.uni | Bin 22498 -> 22980 bytes
 2 files changed, 8 insertions(+)

diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index a6941466891e..0d42918427ea 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -182,6 +182,14 @@
   ## Specifies the size of the microcode Region.
   # @Prompt Microcode Region size.
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchRegionSize|0x0|UINT64|0x00000006
+  ## Specifies the AP wait loop state during POST phase.
+  #  The value is defined as below.<BR><BR>
+  #  1: Place AP in the Hlt-Loop state.<BR>
+  #  2: Place AP in the Mwait-Loop state.<BR>
+  #  3: Place AP in the Run-Loop state.<BR>
+  # @Prompt The AP wait loop state.
+  # @ValidRange  0x80000001 | 1 - 3
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode|1|UINT8|0x60008006
 
 [PcdsDynamic, PcdsDynamicEx]
   ## Contains the pointer to a CPU S3 data buffer of structure ACPI_CPU_DATA.
diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index 4011cfd1816b133ea82e64335f35332c2fc7e656..b4c5376ca8c14132dcd12c30f0c1499599195d48 100644
GIT binary patch
delta 178
zcmaE~p7F?L#to0cCm)cA;C5svVDMqc2f~8MhQ79w*93AXJ2C_?C@_>WBr;?&lmJ;d
z5P2Z07|2fq;?&8G{OSBqeGI-p`4pg-VYqJy5qg2<q%f2+6ah`oV@L<`0vP-mf*C@9
XtOAA%p!vlNsSJ7yN({UVTwn|Ux)~-4

delta 9
QcmX@Ineowj#to0c0U2@x^Z)<=


From d9786fd59f731cd621c16c38cfa82d40f955bbc6 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:47:48 +0000
Subject: [PATCH 263/525] UefiCpuPkg: Add PCD PcdCpuApTargetCstate

This new PCD is used to specify the AP C-state value by MWAIT instruction.

More deeper C-state means more longer latency time when APs exiting from MWAIT
state. Platforms need to balance the performance and power saving to find the
proper C-state for APs.

Also, some processor may not ready for the deepest C-state at the beginning.
Platform also could choose the proper chance to place AP into the deeper C-state
by set this PCD before hand-off to OS.

(Sync patch r19342 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19359 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/UefiCpuPkg.dec |   5 +++++
 UefiCpuPkg/UefiCpuPkg.uni | Bin 22980 -> 23534 bytes
 2 files changed, 5 insertions(+)

diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index 0d42918427ea..472b38acbc1e 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -190,6 +190,11 @@
   # @Prompt The AP wait loop state.
   # @ValidRange  0x80000001 | 1 - 3
   gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode|1|UINT8|0x60008006
+  ## Specifies the AP target C-state for Mwait during POST phase.
+  #  The default value 0 means C1 state.
+  #  The value is defined as below.<BR><BR>
+  # @Prompt The specified AP target C-state for Mwait.
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApTargetCstate|0|UINT8|0x00000007
 
 [PcdsDynamic, PcdsDynamicEx]
   ## Contains the pointer to a CPU S3 data buffer of structure ACPI_CPU_DATA.
diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index b4c5376ca8c14132dcd12c30f0c1499599195d48..9fbc7310fd30d3349fc2c9a6b26029cc6f739b2f 100644
GIT binary patch
delta 203
zcmX@Inep9r#tlazCm)cAm@E*<A{xSw$WX+P&XCGb!r;tM3?vg7N+ugRnonL6$l+Pc
zPym!kX2@hn1L9PM6b1zbM}`0(2~r2srvTKc3)2f!r2tf&50q74@MS0ms>=kL=*XXr
Q!!E_hP<>KOn;dBf0QUqgOaK4?

delta 9
QcmaF2o$<(K#tlaz0U9y{>;M1&


From 6be91122b1b3303f6c97a9545a300021acc3e9c1 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:48:45 +0000
Subject: [PATCH 264/525] UefiCpuPkg/CpuMpPei: Add GetApLoopMode() to get AP
 loop mode

Add GetApLoopMode() that will get PCD PcdCpuApLoopMode firstly. If it is
ApInMwaitLoop, we will check if MONITOR/MWAIT feature supported by CPUID. If
MONITOR/MWAIT feature is not supported, force AP loop mode to ApInHltLoop.

GetApLoopMode() also return the largest line size required.

(Sync patch r19343 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19360 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c      | 48 +++++++++++++++++++++++++++++
 UefiCpuPkg/CpuMpPei/CpuMpPei.h      |  6 ++++
 UefiCpuPkg/CpuMpPei/CpuMpPei.inf    |  1 +
 UefiCpuPkg/Include/Register/Cpuid.h |  2 ++
 4 files changed, 57 insertions(+)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index 2e6e7611a261..ac609a01f8cc 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -117,6 +117,54 @@ ApFuncEnableX2Apic (
   SetApicMode (LOCAL_APIC_MODE_X2APIC);
 }
 
+/**
+  Get AP loop mode.
+
+  @param MonitorFilterSize  Returns the largest monitor-line size in bytes.
+
+  @return The AP loop mode.
+**/
+UINT8
+GetApLoopMode (
+  OUT UINT16     *MonitorFilterSize
+  )
+{
+  UINT8          ApLoopMode;
+  UINT32         RegEbx;
+  UINT32         RegEcx;
+  UINT32         RegEdx;
+
+  ASSERT (MonitorFilterSize != NULL);
+
+  ApLoopMode = PcdGet8 (PcdCpuApLoopMode);
+  ASSERT (ApLoopMode >= ApInHltLoop && ApLoopMode <= ApInRunLoop);
+  if (ApLoopMode == ApInMwaitLoop) {
+    AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, &RegEcx, NULL);
+    if ((RegEcx & BIT3) == 0) {
+      //
+      // If processor does not support MONITOR/MWAIT feature
+      // by CPUID.[EAX=01H]:ECX.BIT3, force AP in Hlt-loop mode
+      //
+      ApLoopMode = ApInHltLoop;
+    }
+  }
+
+  if (ApLoopMode == ApInHltLoop) {
+    *MonitorFilterSize = 0;
+  } else if (ApLoopMode == ApInRunLoop) {
+    *MonitorFilterSize = sizeof (UINT32);
+  } else if (ApLoopMode == ApInMwaitLoop) {
+    //
+    // CPUID.[EAX=05H]:EBX.BIT0-15: Largest monitor-line size in bytes
+    // CPUID.[EAX=05H].EDX: C-states supported using MWAIT
+    //
+    AsmCpuid (CPUID_MONITOR_MWAIT, NULL, &RegEbx, NULL, &RegEdx);
+    *MonitorFilterSize = RegEbx & 0xFFFF;
+  }
+
+  return ApLoopMode;
+}
+
 /**
   Get CPU MP Data pointer from the Guided HOB.
 
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index 2b960c6eb1fe..be4e31237747 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -50,6 +50,12 @@ typedef enum {
   CpuStateDisabled
 } CPU_STATE;
 
+typedef enum {
+  ApInHltLoop   = 1,
+  ApInMwaitLoop = 2,
+  ApInRunLoop   = 3
+} AP_LOOP_MODE;
+
 //
 // AP reset code information
 //
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
index 423f7f10ed52..4a5cfe75ff95 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
@@ -81,6 +81,7 @@
   gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize                      ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchAddress            ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchRegionSize         ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode                       ## CONSUMES
 
 [Depex]
   gEfiPeiMemoryDiscoveredPpiGuid
diff --git a/UefiCpuPkg/Include/Register/Cpuid.h b/UefiCpuPkg/Include/Register/Cpuid.h
index 6730551ff8cd..f8ff247d098f 100644
--- a/UefiCpuPkg/Include/Register/Cpuid.h
+++ b/UefiCpuPkg/Include/Register/Cpuid.h
@@ -31,6 +31,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #define CPUID_CACHE_PARAMS                      0x4
 
+#define CPUID_MONITOR_MWAIT                     0x5
+
 #define CPUID_EXTENDED_TOPOLOGY                 0xB
 #define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID  0x0
 #define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT      0x1

From 18be815babcb4537128753b40b60aa257a6ece88 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:49:28 +0000
Subject: [PATCH 265/525] UefiCpuPkg/CpuMpPei: Prepare for monitor buffer

Get AP loop mode to prepare for the monitor buffer required for ApInMwaitLoop
and ApInRunLoop.

(Sync patch r19344 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19361 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c | 25 +++++++++++++++++++++++--
 UefiCpuPkg/CpuMpPei/CpuMpPei.h |  3 +++
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index ac609a01f8cc..b8fa5118b45a 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -589,6 +589,10 @@ PrepareAPStartupVector (
   UINTN                         WakeupBuffer;
   UINTN                         WakeupBufferSize;
   MP_ASSEMBLY_ADDRESS_MAP       AddressMap;
+  UINT8                         ApLoopMode;
+  UINT16                        MonitorFilterSize;
+  UINT8                         *MonitorBuffer;
+  UINTN                         Index;
 
   AsmGetAddressMap (&AddressMap);
   WakeupBufferSize = AddressMap.RendezvousFunnelSize + sizeof (MP_CPU_EXCHANGE_INFO);
@@ -597,11 +601,14 @@ PrepareAPStartupVector (
   DEBUG ((EFI_D_INFO, "CpuMpPei: WakeupBuffer = 0x%x\n", WakeupBuffer));
 
   //
-  // Allocate Pages for APs stack, CPU MP Data and backup buffer for wakeup buffer
+  // Allocate Pages for APs stack, CPU MP Data, backup buffer for wakeup buffer,
+  // and monitor buffer if required.
   //
   MaxCpuCount = PcdGet32(PcdCpuMaxLogicalProcessorNumber);
   BufferSize  = PcdGet32 (PcdCpuApStackSize) * MaxCpuCount + sizeof (PEI_CPU_MP_DATA)
                   + WakeupBufferSize + sizeof (PEI_CPU_DATA) * MaxCpuCount;
+  ApLoopMode = GetApLoopMode (&MonitorFilterSize);
+  BufferSize += MonitorFilterSize * MaxCpuCount;
   Status = PeiServicesAllocatePages (
              EfiBootServicesData,
              EFI_SIZE_TO_PAGES (BufferSize),
@@ -627,7 +634,21 @@ PrepareAPStartupVector (
   InitializeSpinLock(&PeiCpuMpData->MpLock);
   SaveVolatileRegisters (&PeiCpuMpData->CpuData[0].VolatileRegisters);
   CopyMem (&PeiCpuMpData->AddressMap, &AddressMap, sizeof (MP_ASSEMBLY_ADDRESS_MAP));
-
+  //
+  // Initialize AP loop mode
+  //
+  PeiCpuMpData->ApLoopMode = ApLoopMode;
+  DEBUG ((EFI_D_INFO, "AP Loop Mode is %d\n", PeiCpuMpData->ApLoopMode));
+  MonitorBuffer = (UINT8 *)(PeiCpuMpData->CpuData + MaxCpuCount);
+  if (PeiCpuMpData->ApLoopMode != ApInHltLoop) {
+    //
+    // Set up APs wakeup signal buffer
+    //
+    for (Index = 0; Index < MaxCpuCount; Index++) {
+      PeiCpuMpData->CpuData[Index].StartupApSignal = 
+        (UINT32 *)(MonitorBuffer + MonitorFilterSize * Index);
+    }
+  }
   //
   // Backup original data and copy AP reset code in it
   //
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index be4e31237747..a22bae700542 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -134,6 +134,7 @@ typedef struct {
 } CPU_VOLATILE_REGISTERS;
 
 typedef struct {
+  volatile UINT32                *StartupApSignal;
   UINT32                         ApicId;
   EFI_HEALTH_FLAGS               Health;
   CPU_STATE                      State;
@@ -163,6 +164,8 @@ struct _PEI_CPU_MP_DATA {
   CPU_EXCHANGE_ROLE_INFO         BSPInfo;
   CPU_EXCHANGE_ROLE_INFO         APInfo;
   MTRR_SETTINGS                  MtrrTable;
+  UINT8                          ApLoopMode;
+  UINT8                          ApTargetCState;
   PEI_CPU_DATA                   *CpuData;
   volatile MP_CPU_EXCHANGE_INFO  *MpCpuExchangeInfo;
 };

From e6c1d069fd25ef5db7a53a0cb1686b39d014da03 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:50:19 +0000
Subject: [PATCH 266/525] UefiCpuPkg/CpuMpPei: Place APs in proper loop mode
 after AP execution

After AP function is executed, we will place AP in proper loop mode. Because AP
maybe waken up by SMI or other reasons. We need to read signature in monitor
buffer to check if APs is waken up by BSP. If it is not waken up by BSP, we will
continue to place them into proper loop mode.

(Sync patch r19345 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19362 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c   | 148 +++++++++++++++++++++----------
 UefiCpuPkg/CpuMpPei/CpuMpPei.h   |   3 +
 UefiCpuPkg/CpuMpPei/CpuMpPei.inf |   1 +
 3 files changed, 106 insertions(+), 46 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index b8fa5118b45a..ba82ba42184d 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -273,68 +273,124 @@ ApCFunction (
   UINTN                      ProcessorNumber;
   EFI_AP_PROCEDURE           Procedure;
   UINTN                      BistData;
+  volatile UINT32            *ApStartupSignalBuffer;
 
   PeiCpuMpData = ExchangeInfo->PeiCpuMpData;
-  if (PeiCpuMpData->InitFlag) {
-    ProcessorNumber = NumApsExecuting;
-    //
-    // Sync BSP's Control registers to APs
-    //
-    RestoreVolatileRegisters (&PeiCpuMpData->CpuData[0].VolatileRegisters, FALSE);
-    //
-    // This is first time AP wakeup, get BIST information from AP stack
-    //
-    BistData = *(UINTN *) (PeiCpuMpData->Buffer + ProcessorNumber * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
-    PeiCpuMpData->CpuData[ProcessorNumber].Health.Uint32 = (UINT32) BistData;
-    PeiCpuMpData->CpuData[ProcessorNumber].ApicId = GetInitialApicId ();
-    if (PeiCpuMpData->CpuData[ProcessorNumber].ApicId >= 0xFF) {
+  while (TRUE) {
+    if (PeiCpuMpData->InitFlag) {
+      ProcessorNumber = NumApsExecuting;
+      //
+      // Sync BSP's Control registers to APs
+      //
+      RestoreVolatileRegisters (&PeiCpuMpData->CpuData[0].VolatileRegisters, FALSE);
+      //
+      // This is first time AP wakeup, get BIST information from AP stack
+      //
+      BistData = *(UINTN *) (PeiCpuMpData->Buffer + ProcessorNumber * PeiCpuMpData->CpuApStackSize - sizeof (UINTN));
+      PeiCpuMpData->CpuData[ProcessorNumber].Health.Uint32 = (UINT32) BistData;
+      PeiCpuMpData->CpuData[ProcessorNumber].ApicId = GetInitialApicId ();
+      if (PeiCpuMpData->CpuData[ProcessorNumber].ApicId >= 0xFF) {
+        //
+        // Set x2APIC mode if there are any logical processor reporting
+        // an APIC ID of 255 or greater.
+        //
+        AcquireSpinLock(&PeiCpuMpData->MpLock);
+        PeiCpuMpData->X2ApicEnable = TRUE;
+        ReleaseSpinLock(&PeiCpuMpData->MpLock);
+      }
+      //
+      // Sync BSP's Mtrr table to all wakeup APs and load microcode on APs.
+      //
+      MtrrSetAllMtrrs (&PeiCpuMpData->MtrrTable);
+      MicrocodeDetect ();
+      PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
+    } else {
       //
-      // Set x2APIC mode if there are any logical processor reporting
-      // an APIC ID of 255 or greater.
+      // Execute AP function if AP is not disabled
       //
-      AcquireSpinLock(&PeiCpuMpData->MpLock);
-      PeiCpuMpData->X2ApicEnable = TRUE;
-      ReleaseSpinLock(&PeiCpuMpData->MpLock);
+      GetProcessorNumber (PeiCpuMpData, &ProcessorNumber);
+      if (PeiCpuMpData->ApLoopMode == ApInHltLoop) {
+        //
+        // Restore AP's volatile registers saved
+        //
+        RestoreVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters, TRUE);
+      }
+
+      if ((PeiCpuMpData->CpuData[ProcessorNumber].State != CpuStateDisabled) &&
+          (PeiCpuMpData->ApFunction != 0)) {
+        PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateBusy;
+        Procedure = (EFI_AP_PROCEDURE)(UINTN)PeiCpuMpData->ApFunction;
+        //
+        // Invoke AP function here
+        //
+        Procedure ((VOID *)(UINTN)PeiCpuMpData->ApFunctionArgument);
+        //
+        // Re-get the processor number due to BSP/AP maybe exchange in AP function
+        //
+        GetProcessorNumber (PeiCpuMpData, &ProcessorNumber);
+        PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
+      }
     }
+
     //
-    // Sync BSP's Mtrr table to all wakeup APs and load microcode on APs.
+    // AP finished executing C code
     //
-    MtrrSetAllMtrrs (&PeiCpuMpData->MtrrTable);
-    MicrocodeDetect ();
-    PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
-  } else {
+    InterlockedIncrement ((UINT32 *)&PeiCpuMpData->FinishedCount);
+
     //
-    // Execute AP function if AP is not disabled
+    // Place AP is specified loop mode
     //
-    GetProcessorNumber (PeiCpuMpData, &ProcessorNumber);
+    if (PeiCpuMpData->ApLoopMode == ApInHltLoop) {
+      //
+      // Save AP volatile registers
+      //
+      SaveVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters);
+      //
+      // Place AP in Hlt-loop
+      //
+      while (TRUE) {
+        DisableInterrupts ();
+        CpuSleep ();
+        CpuPause ();
+      }
+    }
+    ApStartupSignalBuffer = PeiCpuMpData->CpuData[ProcessorNumber].StartupApSignal;
     //
-    // Restore AP's volatile registers saved
+    // Clear AP start-up signal
     //
-    RestoreVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters, TRUE);
+    *ApStartupSignalBuffer = 0;
+    while (TRUE) {
+      DisableInterrupts ();
+      if (PeiCpuMpData->ApLoopMode == ApInMwaitLoop) {
+        //
+        // Place AP in Mwait-loop
+        //
+        AsmMonitor ((UINTN)ApStartupSignalBuffer, 0, 0);
+        if (*ApStartupSignalBuffer != WAKEUP_AP_SIGNAL) {
+          //
+          // If AP start-up signal is not set, place AP into
+          // the maximum C-state
+          //
+          AsmMwait (PeiCpuMpData->ApTargetCState << 4, 0);
+        }
+      } else if (PeiCpuMpData->ApLoopMode == ApInRunLoop) {
+        //
+        // Place AP in Run-loop
+        //
+        CpuPause ();
+      } else {
+        ASSERT (FALSE);
+      }
 
-    if ((PeiCpuMpData->CpuData[ProcessorNumber].State != CpuStateDisabled) &&
-        (PeiCpuMpData->ApFunction != 0)) {
-      PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateBusy;
-      Procedure = (EFI_AP_PROCEDURE)(UINTN)PeiCpuMpData->ApFunction;
       //
-      // Invoke AP function here
+      // If AP start-up signal is written, AP is waken up
+      // otherwise place AP in loop again
       //
-      Procedure ((VOID *)(UINTN)PeiCpuMpData->ApFunctionArgument);
-      PeiCpuMpData->CpuData[ProcessorNumber].State = CpuStateIdle;
+      if (*ApStartupSignalBuffer == WAKEUP_AP_SIGNAL) {
+        break;
+      }
     }
   }
-
-  //
-  // AP finished executing C code
-  //
-  InterlockedIncrement ((UINT32 *)&PeiCpuMpData->FinishedCount);
-
-  //
-  // Save AP volatile registers
-  //
-  SaveVolatileRegisters (&PeiCpuMpData->CpuData[ProcessorNumber].VolatileRegisters);
-
-  AsmCliHltLoop ();
 }
 
 /**
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index a22bae700542..47038c282533 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -38,6 +38,7 @@
 #include <Library/SynchronizationLib.h>
 #include <Library/TimerLib.h>
 #include <Library/UefiCpuLib.h>
+#include <Library/CpuLib.h>
 
 #include "Microcode.h"
 
@@ -50,6 +51,8 @@ typedef enum {
   CpuStateDisabled
 } CPU_STATE;
 
+#define WAKEUP_AP_SIGNAL SIGNATURE_32 ('S', 'T', 'A', 'P')
+
 typedef enum {
   ApInHltLoop   = 1,
   ApInMwaitLoop = 2,
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
index 4a5cfe75ff95..ec353aed7d50 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
@@ -66,6 +66,7 @@
   SynchronizationLib
   TimerLib
   UefiCpuLib
+  CpuLib
 
 [Ppis]
   gEfiPeiMpServicesPpiGuid                      ## PRODUCES

From 9a10f17a9cf897fd32be38e36a4b8dcd411bee64 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:51:24 +0000
Subject: [PATCH 267/525] UefiCpuPkg/CpuMpPei: Wake up APs by proper method

If ApLoopMode is ApInHltLoop, BSP will send INIT-SIPI-SIPI to wake up APs.
If ApLoopMode is ApInMwaitLoop or ApInRunLoop, BSP will write one semaphore to
wake up APs.

(Sync patch r19346 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19363 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.c      | 43 ++++++++++++++++++++++++-----
 UefiCpuPkg/CpuMpPei/CpuMpPei.h      |  4 +--
 UefiCpuPkg/CpuMpPei/CpuMpPei.inf    |  1 +
 UefiCpuPkg/CpuMpPei/PeiMpServices.c |  6 ++--
 4 files changed, 42 insertions(+), 12 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.c b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
index ba82ba42184d..950d61cc4853 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.c
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.c
@@ -399,7 +399,7 @@ ApCFunction (
   @param PeiCpuMpData       Pointer to PEI CPU MP Data
   @param Broadcast          TRUE:  Send broadcast IPI to all APs
                             FALSE: Send IPI to AP by ApicId
-  @param ApicId             Apic ID for the processor to be waked
+  @param ProcessorNumber    The handle number of specified processor
   @param Procedure          The function to be invoked by AP
   @param ProcedureArgument  The argument to be passed into AP function
 **/
@@ -407,12 +407,13 @@ VOID
 WakeUpAP (
   IN PEI_CPU_MP_DATA           *PeiCpuMpData,
   IN BOOLEAN                   Broadcast,
-  IN UINT32                    ApicId,
+  IN UINTN                     ProcessorNumber,
   IN EFI_AP_PROCEDURE          Procedure,              OPTIONAL
   IN VOID                      *ProcedureArgument      OPTIONAL
   )
 {
   volatile MP_CPU_EXCHANGE_INFO    *ExchangeInfo;
+  UINTN                            Index;
 
   PeiCpuMpData->ApFunction         = (UINTN) Procedure;
   PeiCpuMpData->ApFunctionArgument = (UINTN) ProcedureArgument;
@@ -436,12 +437,40 @@ WakeUpAP (
   CopyMem ((VOID *)&ExchangeInfo->GdtrProfile, &mGdt, sizeof(mGdt));
   AsmReadIdtr ((IA32_DESCRIPTOR *) &ExchangeInfo->IdtrProfile);
 
-  if (Broadcast) {
-    SendInitSipiSipiAllExcludingSelf ((UINT32) ExchangeInfo->BufferStart);
-  } else {
-    SendInitSipiSipi (ApicId, (UINT32) ExchangeInfo->BufferStart);
+  if (PeiCpuMpData->ApLoopMode == ApInMwaitLoop) {
+    //
+    // Get AP target C-state each time when waking up AP,
+    // for it maybe updated by platform again
+    //
+    PeiCpuMpData->ApTargetCState = PcdGet8 (PcdCpuApTargetCstate);
   }
 
+  //
+  // Wakeup APs per AP loop state
+  //
+  if (PeiCpuMpData->ApLoopMode == ApInHltLoop || PeiCpuMpData->InitFlag) {
+    if (Broadcast) {
+      SendInitSipiSipiAllExcludingSelf ((UINT32) ExchangeInfo->BufferStart);
+    } else {
+      SendInitSipiSipi (
+        PeiCpuMpData->CpuData[ProcessorNumber].ApicId,
+        (UINT32) ExchangeInfo->BufferStart
+        );
+    }
+  } else if ((PeiCpuMpData->ApLoopMode == ApInMwaitLoop) ||
+             (PeiCpuMpData->ApLoopMode == ApInRunLoop)) {
+    if (Broadcast) {
+      for (Index = 0; Index < PeiCpuMpData->CpuCount; Index++) {
+        if (Index != PeiCpuMpData->BspNumber) {
+          *(PeiCpuMpData->CpuData[Index].StartupApSignal) = WAKEUP_AP_SIGNAL;
+        }
+      }
+    } else {
+      *(PeiCpuMpData->CpuData[ProcessorNumber].StartupApSignal) = WAKEUP_AP_SIGNAL;
+    }
+  } else {
+    ASSERT (FALSE);
+  }
   return ;
 }
 
@@ -600,7 +629,7 @@ CountProcessorNumber (
     if (PeiCpuMpData->X2ApicEnable) {
       DEBUG ((EFI_D_INFO, "Force x2APIC mode!\n"));
       //
-      // Send 2nd broadcast IPI to all APs to enable x2APIC mode
+      // Wakeup all APs to enable x2APIC mode
       //
       WakeUpAP (PeiCpuMpData, TRUE, 0, ApFuncEnableX2Apic, NULL);
       //
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index 47038c282533..6f508b420be3 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -255,7 +255,7 @@ CpuMpEndOfPeiCallback (
   @param PeiCpuMpData       Pointer to PEI CPU MP Data
   @param Broadcast          TRUE:  Send broadcast IPI to all APs
                             FALSE: Send IPI to AP by ApicId
-  @param ApicId             Apic ID for the processor to be waked
+  @param ProcessorNumber    The handle number of specified processor
   @param Procedure          The function to be invoked by AP
   @param ProcedureArgument  The argument to be passed into AP function
 **/
@@ -263,7 +263,7 @@ VOID
 WakeUpAP (
   IN PEI_CPU_MP_DATA           *PeiCpuMpData,
   IN BOOLEAN                   Broadcast,
-  IN UINT32                    ApicId,
+  IN UINTN                     ProcessorNumber,
   IN EFI_AP_PROCEDURE          Procedure,              OPTIONAL
   IN VOID                      *ProcedureArgument      OPTIONAL
   );
diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
index ec353aed7d50..70b272e33bc4 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.inf
@@ -83,6 +83,7 @@
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchAddress            ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuMicrocodePatchRegionSize         ## CONSUMES
   gUefiCpuPkgTokenSpaceGuid.PcdCpuApLoopMode                       ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApTargetCstate                   ## SOMETIMES_CONSUMES
 
 [Depex]
   gEfiPeiMemoryDiscoveredPpiGuid
diff --git a/UefiCpuPkg/CpuMpPei/PeiMpServices.c b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
index 5dd2c153f46a..e784377d674a 100644
--- a/UefiCpuPkg/CpuMpPei/PeiMpServices.c
+++ b/UefiCpuPkg/CpuMpPei/PeiMpServices.c
@@ -520,7 +520,7 @@ PeiStartupAllAPs (
       if (Index == CallerNumber) {
         continue;
       }
-      WakeUpAP (PeiCpuMpData, FALSE, PeiCpuMpData->CpuData[Index].ApicId, Procedure, ProcedureArgument);
+      WakeUpAP (PeiCpuMpData, FALSE, Index, Procedure, ProcedureArgument);
       //
       // Wait to finish
       //
@@ -655,7 +655,7 @@ PeiStartupThisAP (
   WaitCountIndex = 0;
   FinishedCount = &PeiCpuMpData->FinishedCount;
 
-  WakeUpAP (PeiCpuMpData, FALSE, PeiCpuMpData->CpuData[ProcessorNumber].ApicId, Procedure, ProcedureArgument);
+  WakeUpAP (PeiCpuMpData, FALSE, ProcessorNumber, Procedure, ProcedureArgument);
 
   //
   // Wait to finish
@@ -791,7 +791,7 @@ PeiSwitchBSP (
   //
   // Need to wakeUp AP (future BSP).
   //
-  WakeUpAP (PeiCpuMpData, FALSE, PeiCpuMpData->CpuData[ProcessorNumber].ApicId, FutureBSPProc, PeiCpuMpData);
+  WakeUpAP (PeiCpuMpData, FALSE, ProcessorNumber, FutureBSPProc, PeiCpuMpData);
 
   AsmExchangeRole (&PeiCpuMpData->BSPInfo, &PeiCpuMpData->APInfo);
 

From e5cdee8d1de3af6e939b40ab372f946d6161dbb3 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 05:53:03 +0000
Subject: [PATCH 268/525] UefiCpuPkg/CpuMpPei: Remove un-used AsmCliHltLoop()

(Sync patch r19347 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Tested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19364 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/CpuMpPei/CpuMpPei.h        | 10 ----------
 UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.asm  |  6 ------
 UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.nasm |  6 ------
 UefiCpuPkg/CpuMpPei/X64/MpFuncs.asm   |  6 ------
 UefiCpuPkg/CpuMpPei/X64/MpFuncs.nasm  |  6 ------
 5 files changed, 34 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.h b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
index 6f508b420be3..7c8a218e0ee3 100644
--- a/UefiCpuPkg/CpuMpPei/CpuMpPei.h
+++ b/UefiCpuPkg/CpuMpPei/CpuMpPei.h
@@ -198,16 +198,6 @@ AsmInitializeGdt (
   IN IA32_DESCRIPTOR  *Gdtr
   );
 
-/**
-  Assembly code to do CLI-HALT loop.
-
-**/
-VOID
-EFIAPI
-AsmCliHltLoop (
-  VOID
-  );
-
 /**
   Get available system memory below 1MB by specified size.
 
diff --git a/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.asm b/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.asm
index eb23a1691762..ab78bcc07b59 100644
--- a/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.asm
+++ b/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.asm
@@ -144,12 +144,6 @@ CProcedureInvoke:
 RendezvousFunnelProc   ENDP
 RendezvousFunnelProcEnd::
 
-AsmCliHltLoop PROC near C PUBLIC
-    cli
-    hlt
-    jmp        $-2
-AsmCliHltLoop ENDP
-
 ;-------------------------------------------------------------------------------------
 ;  AsmGetAddressMap (&AddressMap);
 ;-------------------------------------------------------------------------------------
diff --git a/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.nasm b/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.nasm
index 5d2da82d148c..2ff16dc297bc 100644
--- a/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.nasm
+++ b/UefiCpuPkg/CpuMpPei/Ia32/MpFuncs.nasm
@@ -132,12 +132,6 @@ CProcedureInvoke:
     jmp        $                 ; never reach here
 RendezvousFunnelProcEnd:
 
-global ASM_PFX(AsmCliHltLoop)
-ASM_PFX(AsmCliHltLoop):
-    cli
-    hlt
-    jmp        $-2
-
 ;-------------------------------------------------------------------------------------
 ;  AsmGetAddressMap (&AddressMap);
 ;-------------------------------------------------------------------------------------
diff --git a/UefiCpuPkg/CpuMpPei/X64/MpFuncs.asm b/UefiCpuPkg/CpuMpPei/X64/MpFuncs.asm
index fad5e8d443ce..1bb3b6d6b668 100644
--- a/UefiCpuPkg/CpuMpPei/X64/MpFuncs.asm
+++ b/UefiCpuPkg/CpuMpPei/X64/MpFuncs.asm
@@ -181,12 +181,6 @@ CProcedureInvoke:
 RendezvousFunnelProc   ENDP
 RendezvousFunnelProcEnd::
 
-AsmCliHltLoop PROC
-    cli
-    hlt
-    jmp $-2
-AsmCliHltLoop ENDP
-
 ;-------------------------------------------------------------------------------------
 ;  AsmGetAddressMap (&AddressMap);
 ;-------------------------------------------------------------------------------------
diff --git a/UefiCpuPkg/CpuMpPei/X64/MpFuncs.nasm b/UefiCpuPkg/CpuMpPei/X64/MpFuncs.nasm
index 0b2e879905a4..00e5f5875860 100644
--- a/UefiCpuPkg/CpuMpPei/X64/MpFuncs.nasm
+++ b/UefiCpuPkg/CpuMpPei/X64/MpFuncs.nasm
@@ -175,12 +175,6 @@ CProcedureInvoke:
 
 RendezvousFunnelProcEnd:
 
-global ASM_PFX(AsmCliHltLoop)
-ASM_PFX(AsmCliHltLoop):
-    cli
-    hlt
-    jmp $-2
-
 ;-------------------------------------------------------------------------------------
 ;  AsmGetAddressMap (&AddressMap);
 ;-------------------------------------------------------------------------------------

From 36f30d41c5ade03206d9f1d5fdb652a382322dac Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Fri, 18 Dec 2015 06:07:50 +0000
Subject: [PATCH 269/525] DxeTpmMeasureBootLib: Change global variable name to
 avoid name conflict.

(Sync patch r19334 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19366 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../DxeTpmMeasureBootLib/DxeTpmMeasureBootLib.c        | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/SecurityPkg/Library/DxeTpmMeasureBootLib/DxeTpmMeasureBootLib.c b/SecurityPkg/Library/DxeTpmMeasureBootLib/DxeTpmMeasureBootLib.c
index cd48a1a9773a..25788b854937 100644
--- a/SecurityPkg/Library/DxeTpmMeasureBootLib/DxeTpmMeasureBootLib.c
+++ b/SecurityPkg/Library/DxeTpmMeasureBootLib/DxeTpmMeasureBootLib.c
@@ -53,7 +53,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 BOOLEAN                           mMeasureGptTableFlag = FALSE;
 UINTN                             mMeasureGptCount = 0;
 VOID                              *mFileBuffer;
-UINTN                             mImageSize;
+UINTN                             mTpmImageSize;
 //
 // Measured FV handle cache
 //
@@ -95,11 +95,11 @@ DxeTpmMeasureBootLibImageRead (
   }
 
   EndPosition = FileOffset + *ReadSize;
-  if (EndPosition > mImageSize) {
-    *ReadSize = (UINT32)(mImageSize - FileOffset);
+  if (EndPosition > mTpmImageSize) {
+    *ReadSize = (UINT32)(mTpmImageSize - FileOffset);
   }
 
-  if (FileOffset >= mImageSize) {
+  if (FileOffset >= mTpmImageSize) {
     *ReadSize = 0;
   }
 
@@ -908,7 +908,7 @@ DxeTpmMeasureBootHandler (
     goto Finish;
   }
 
-  mImageSize  = FileSize;
+  mTpmImageSize  = FileSize;
   mFileBuffer = FileBuffer;
 
   //

From 818e60d95106bd68679bf4be1cef67f0d0af4b6c Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:41:38 +0000
Subject: [PATCH 270/525] BaseTools/toolsetup.bat: fixed the error when the
 path contains space

We have a new simple and effective method to resolve the original issue
that the PATH env's update error when the path contains space, so this
patch remove the last check in and use the new method to fix the original
issue.

(Sync patch r19028 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19368 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/toolsetup.bat | 21 +++++----------------
 1 file changed, 5 insertions(+), 16 deletions(-)

diff --git a/BaseTools/toolsetup.bat b/BaseTools/toolsetup.bat
index 310ddd030c07..76fd8bb6ef9e 100755
--- a/BaseTools/toolsetup.bat
+++ b/BaseTools/toolsetup.bat
@@ -322,24 +322,13 @@ goto end
       echo !!! WARNING !!! Will not be able to compile Python programs to .exe
       echo Will setup environment to run Python scripts directly.
       echo.
-      goto UpdatePATH
+      set "PATH=%BASETOOLS_PYTHON_SOURCE%\Trim;%PATH%"
+      set "PATH=%BASETOOLS_PYTHON_SOURCE%\GenFds;%PATH%"
+      set "PATH=%BASETOOLS_PYTHON_SOURCE%\build;%PATH%"
+      set PATHEXT=%PATHEXT%;.py
     )
-    else (
-      goto UpdateEnv
-    )
-  )
-  else (
-    goto UpdateEnv
   )
- 
-:UpdatePATH
-  set PATH=%BASETOOLS_PYTHON_SOURCE%\Trim;%PATH%
-  set PATH=%BASETOOLS_PYTHON_SOURCE%\GenFds;%PATH%
-  set PATH=%BASETOOLS_PYTHON_SOURCE%\build;%PATH%
-  set PATHEXT=%PATHEXT%;.py
-  goto UpdateEnv
- 
-:UpdateEnv
+  
   echo BASE_TOOLS_PATH     = %BASE_TOOLS_PATH%
   echo     PYTHON_PATH     = %PYTHON_PATH%
   echo PYTHON_FREEZER_PATH = %PYTHON_FREEZER_PATH%

From 253a4b8ccbb4a984189eb29c48c25f6ef266ca80 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:43:57 +0000
Subject: [PATCH 271/525] BaseTools: Clean some coding style issues

This patch clean some coding style issues, majorly for space character.

(Sync patch r19080 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19369 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/AutoGen/AutoGen.py    | 206 ++++++------
 .../Source/Python/AutoGen/BuildEngine.py      |  20 +-
 BaseTools/Source/Python/AutoGen/GenDepex.py   |   4 +-
 BaseTools/Source/Python/AutoGen/GenMake.py    |  12 +-
 BaseTools/Source/Python/AutoGen/GenPcdDb.py   |   8 +-
 BaseTools/Source/Python/AutoGen/StrGather.py  |  20 +-
 .../Source/Python/AutoGen/UniClassObject.py   |   8 +-
 BaseTools/Source/Python/BPDG/GenVpd.py        | 298 +++++++++---------
 BaseTools/Source/Python/Common/Dictionary.py  |   8 +-
 .../Source/Python/Common/EdkIIWorkspace.py    |  24 +-
 .../Source/Python/Common/FdfParserLite.py     |   8 +-
 .../Python/Common/MigrationUtilities.py       |   4 +-
 BaseTools/Source/Python/Common/Misc.py        |  62 ++--
 .../Python/Common/ToolDefClassObject.py       |   6 +-
 BaseTools/Source/Python/GenFds/GenFds.py      |  14 +-
 .../Python/GenFds/GenFdsGlobalVariable.py     |  38 +--
 BaseTools/Source/Python/GenFds/GuidSection.py |  64 ++--
 BaseTools/Source/Python/GenFds/Region.py      |  44 +--
 BaseTools/Source/Python/GenFds/UiSection.py   |   2 +-
 BaseTools/Source/Python/GenFds/VerSection.py  |   2 +-
 BaseTools/Source/Python/GenFds/Vtf.py         |  98 +++---
 .../GenPatchPcdTable/GenPatchPcdTable.py      |  20 +-
 .../Python/PatchPcdValue/PatchPcdValue.py     |  18 +-
 BaseTools/Source/Python/Table/TableReport.py  |  10 +-
 .../Source/Python/Workspace/MetaFileParser.py |   2 +-
 .../Python/Workspace/WorkspaceDatabase.py     |  34 +-
 BaseTools/Source/Python/build/BuildReport.py  |  30 +-
 BaseTools/Source/Python/build/build.py        |  50 +--
 28 files changed, 557 insertions(+), 557 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index fe565743576b..4c627dfb555a 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -232,7 +232,7 @@ class WorkspaceAutoGen(AutoGen):
     #   @param  SkuId                   SKU id from command line
     #
     def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaFileDb,
-              BuildConfig, ToolDefinition, FlashDefinitionFile='', Fds=None, Fvs=None, Caps=None, SkuId='', UniFlag=None, 
+              BuildConfig, ToolDefinition, FlashDefinitionFile='', Fds=None, Fvs=None, Caps=None, SkuId='', UniFlag=None,
               Progress=None, BuildModule=None):
         if Fds is None:
             Fds = []
@@ -280,7 +280,7 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
 
         # Validate build target
         if self.BuildTarget not in self.Platform.BuildTargets:
-            EdkLogger.error("build", PARAMETER_INVALID, 
+            EdkLogger.error("build", PARAMETER_INVALID,
                             ExtraData="Build target [%s] is not supported by the platform. [Valid target: %s]"
                                       % (self.BuildTarget, " ".join(self.Platform.BuildTargets)))
 
@@ -288,30 +288,30 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
         # parse FDF file to get PCDs in it, if any
         if not self.FdfFile:
             self.FdfFile = self.Platform.FlashDefinition
-        
+
         EdkLogger.info("")
         if self.ArchList:
             EdkLogger.info('%-16s = %s' % ("Architecture(s)", ' '.join(self.ArchList)))
         EdkLogger.info('%-16s = %s' % ("Build target", self.BuildTarget))
-        EdkLogger.info('%-16s = %s' % ("Toolchain",self.ToolChain))        
-        
+        EdkLogger.info('%-16s = %s' % ("Toolchain", self.ToolChain))
+
         EdkLogger.info('\n%-24s = %s' % ("Active Platform", self.Platform))
         if BuildModule:
             EdkLogger.info('%-24s = %s' % ("Active Module", BuildModule))
-        
+
         if self.FdfFile:
             EdkLogger.info('%-24s = %s' % ("Flash Image Definition", self.FdfFile))
 
         EdkLogger.verbose("\nFLASH_DEFINITION = %s" % self.FdfFile)
-        
+
         if Progress:
             Progress.Start("\nProcessing meta-data")
-        
+
         if self.FdfFile:
             #
             # Mark now build in AutoGen Phase
             #
-            GlobalData.gAutoGenPhase = True    
+            GlobalData.gAutoGenPhase = True
             Fdf = FdfParser(self.FdfFile.Path)
             Fdf.ParseFile()
             GlobalData.gFdfParser = Fdf
@@ -336,7 +336,7 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
             if self.CapTargetList:
                 EdkLogger.info("No flash definition file found. Capsule [%s] will be ignored." % " ".join(self.CapTargetList))
                 self.CapTargetList = []
-        
+
         # apply SKU and inject PCDs from Flash Definition file
         for Arch in self.ArchList:
             Platform = self.BuildDatabase[self.MetaFile, Arch, Target, Toolchain]
@@ -391,12 +391,12 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
             Pa.CollectPlatformDynamicPcds()
             Pa.CollectFixedAtBuildPcds()
             self.AutoGenObjectList.append(Pa)
-        
+
         #
         # Check PCDs token value conflict in each DEC file.
         #
         self._CheckAllPcdsTokenValueConflict()
-        
+
         #
         # Check PCD type and definition between DSC and DEC
         #
@@ -425,7 +425,7 @@ def _CheckDuplicateInFV(self, Fdf):
                     #
                     # Get INF file GUID
                     #
-                    InfFoundFlag = False                   
+                    InfFoundFlag = False
                     for Pa in self.AutoGenObjectList:
                         if InfFoundFlag:
                             break
@@ -436,9 +436,9 @@ def _CheckDuplicateInFV(self, Fdf):
                                     _GuidDict[Module.Guid.upper()] = FfsFile
                                     break
                                 else:
-                                    EdkLogger.error("build", 
+                                    EdkLogger.error("build",
                                                     FORMAT_INVALID,
-                                                    "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s"%(FfsFile.CurrentLineNum,
+                                                    "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s" % (FfsFile.CurrentLineNum,
                                                                                                                                    FfsFile.CurrentLineContent,
                                                                                                                                    _GuidDict[Module.Guid.upper()].CurrentLineNum,
                                                                                                                                    _GuidDict[Module.Guid.upper()].CurrentLineContent,
@@ -452,7 +452,7 @@ def _CheckDuplicateInFV(self, Fdf):
                             InfPath = NormPath(FfsFile.InfFileName)
                             if not os.path.exists(InfPath):
                                 EdkLogger.error('build', GENFDS_ERROR, "Non-existant Module %s !" % (FfsFile.InfFileName))
-                                
+
                             PathClassObj = PathClass(FfsFile.InfFileName, self.WorkspaceDir)
                             #
                             # Here we just need to get FILE_GUID from INF file, use 'COMMON' as ARCH attribute. and use 
@@ -462,19 +462,19 @@ def _CheckDuplicateInFV(self, Fdf):
                             if not InfObj.Guid.upper() in _GuidDict.keys():
                                 _GuidDict[InfObj.Guid.upper()] = FfsFile
                             else:
-                                EdkLogger.error("build", 
+                                EdkLogger.error("build",
                                                 FORMAT_INVALID,
-                                                "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s"%(FfsFile.CurrentLineNum,
+                                                "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s" % (FfsFile.CurrentLineNum,
                                                                                                                                FfsFile.CurrentLineContent,
                                                                                                                                _GuidDict[InfObj.Guid.upper()].CurrentLineNum,
                                                                                                                                _GuidDict[InfObj.Guid.upper()].CurrentLineContent,
                                                                                                                                InfObj.Guid.upper()),
                                                 ExtraData=self.FdfFile)
                         InfFoundFlag = False
-                                                                   
+
                 if FfsFile.NameGuid != None:
                     _CheckPCDAsGuidPattern = re.compile("^PCD\(.+\..+\)$")
-                    
+
                     #
                     # If the NameGuid reference a PCD name. 
                     # The style must match: PCD(xxxx.yyy)
@@ -493,51 +493,51 @@ def _CheckDuplicateInFV(self, Fdf):
                                         # First convert from CFormatGuid to GUID string
                                         #
                                         _PcdGuidString = GuidStructureStringToGuidString(PcdItem.DefaultValue)
-                                        
+
                                         if not _PcdGuidString:
                                             #
                                             # Then try Byte array.
                                             #
                                             _PcdGuidString = GuidStructureByteArrayToGuidString(PcdItem.DefaultValue)
-                                            
+
                                         if not _PcdGuidString:
                                             #
                                             # Not Byte array or CFormat GUID, raise error.
                                             #
                                             EdkLogger.error("build",
                                                             FORMAT_INVALID,
-                                                            "The format of PCD value is incorrect. PCD: %s , Value: %s\n"%(_PcdName, PcdItem.DefaultValue),
+                                                            "The format of PCD value is incorrect. PCD: %s , Value: %s\n" % (_PcdName, PcdItem.DefaultValue),
                                                             ExtraData=self.FdfFile)
-                                        
-                                        if not _PcdGuidString.upper() in _GuidDict.keys():    
+
+                                        if not _PcdGuidString.upper() in _GuidDict.keys():
                                             _GuidDict[_PcdGuidString.upper()] = FfsFile
                                             PcdFoundFlag = True
                                             break
                                         else:
-                                            EdkLogger.error("build", 
+                                            EdkLogger.error("build",
                                                             FORMAT_INVALID,
-                                                            "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s"%(FfsFile.CurrentLineNum,
+                                                            "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s" % (FfsFile.CurrentLineNum,
                                                                                                                                            FfsFile.CurrentLineContent,
                                                                                                                                            _GuidDict[_PcdGuidString.upper()].CurrentLineNum,
                                                                                                                                            _GuidDict[_PcdGuidString.upper()].CurrentLineContent,
                                                                                                                                            FfsFile.NameGuid.upper()),
-                                                            ExtraData=self.FdfFile)                                                                       
-                
+                                                            ExtraData=self.FdfFile)
+
                     if not FfsFile.NameGuid.upper() in _GuidDict.keys():
                         _GuidDict[FfsFile.NameGuid.upper()] = FfsFile
                     else:
                         #
                         # Two raw file GUID conflict.
                         #
-                        EdkLogger.error("build", 
+                        EdkLogger.error("build",
                                         FORMAT_INVALID,
-                                        "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s"%(FfsFile.CurrentLineNum,
+                                        "Duplicate GUID found for these lines: Line %d: %s and Line %d: %s. GUID: %s" % (FfsFile.CurrentLineNum,
                                                                                                                        FfsFile.CurrentLineContent,
                                                                                                                        _GuidDict[FfsFile.NameGuid.upper()].CurrentLineNum,
                                                                                                                        _GuidDict[FfsFile.NameGuid.upper()].CurrentLineContent,
                                                                                                                        FfsFile.NameGuid.upper()),
                                         ExtraData=self.FdfFile)
-                
+
 
     def _CheckPcdDefineAndType(self):
         PcdTypeList = [
@@ -552,17 +552,17 @@ def _CheckPcdDefineAndType(self):
             # Key of DSC's Pcds dictionary is PcdCName, TokenSpaceGuid
             for Pcd in Pa.Platform.Pcds:
                 PcdType = Pa.Platform.Pcds[Pcd].Type
-                
+
                 # If no PCD type, this PCD comes from FDF 
                 if not PcdType:
                     continue
-                
+
                 # Try to remove Hii and Vpd suffix
                 if PcdType.startswith("DynamicEx"):
                     PcdType = "DynamicEx"
                 elif PcdType.startswith("Dynamic"):
                     PcdType = "Dynamic"
-    
+
                 for Package in Pa.PackageList:
                     # Key of DEC's Pcds dictionary is PcdCName, TokenSpaceGuid, PcdType
                     if (Pcd[0], Pcd[1], PcdType) in Package.Pcds:
@@ -640,7 +640,7 @@ def _GetBuildCommand(self):
             # BuildCommand should be all the same. So just get one from platform AutoGen
             self._BuildCommand = self.AutoGenObjectList[0].BuildCommand
         return self._BuildCommand
-    
+
     ## Check the PCDs token value conflict in each DEC file.
     #
     # Will cause build break and raise error message while two PCDs conflict.
@@ -672,12 +672,12 @@ def _CheckAllPcdsTokenValueConflict(self):
                         #
                         # Sort same token value PCD list with TokenGuid and TokenCName
                         #
-                        SameTokenValuePcdList.sort(lambda x, y: cmp("%s.%s"%(x.TokenSpaceGuidCName, x.TokenCName), "%s.%s"%(y.TokenSpaceGuidCName, y.TokenCName))) 
-                        SameTokenValuePcdListCount = 0     
+                        SameTokenValuePcdList.sort(lambda x, y: cmp("%s.%s" % (x.TokenSpaceGuidCName, x.TokenCName), "%s.%s" % (y.TokenSpaceGuidCName, y.TokenCName)))
+                        SameTokenValuePcdListCount = 0
                         while (SameTokenValuePcdListCount < len(SameTokenValuePcdList) - 1):
-                            TemListItem     = SameTokenValuePcdList[SameTokenValuePcdListCount]
-                            TemListItemNext = SameTokenValuePcdList[SameTokenValuePcdListCount + 1] 
-                                                                                                      
+                            TemListItem = SameTokenValuePcdList[SameTokenValuePcdListCount]
+                            TemListItemNext = SameTokenValuePcdList[SameTokenValuePcdListCount + 1]
+
                             if (TemListItem.TokenSpaceGuidCName == TemListItemNext.TokenSpaceGuidCName) and (TemListItem.TokenCName != TemListItemNext.TokenCName):
                                 EdkLogger.error(
                                             'build',
@@ -689,13 +689,13 @@ def _CheckAllPcdsTokenValueConflict(self):
                             SameTokenValuePcdListCount += 1
                         Count += SameTokenValuePcdListCount
                     Count += 1
-                
+
                 PcdList = Package.Pcds.values()
-                PcdList.sort(lambda x, y: cmp("%s.%s"%(x.TokenSpaceGuidCName, x.TokenCName), "%s.%s"%(y.TokenSpaceGuidCName, y.TokenCName)))
+                PcdList.sort(lambda x, y: cmp("%s.%s" % (x.TokenSpaceGuidCName, x.TokenCName), "%s.%s" % (y.TokenSpaceGuidCName, y.TokenCName)))
                 Count = 0
                 while (Count < len(PcdList) - 1) :
                     Item = PcdList[Count]
-                    ItemNext = PcdList[Count + 1]                
+                    ItemNext = PcdList[Count + 1]
                     #
                     # Check PCDs with same TokenSpaceGuidCName.TokenCName have same token value as well.
                     #
@@ -786,7 +786,7 @@ class PlatformAutoGen(AutoGen):
                 "0x01001"  : 3,      #  ******_TOOLCHAIN_****_***********_ATTRIBUTE
                 "0x10001"  : 2,      #  TARGET_*********_****_***********_ATTRIBUTE
                 "0x00001"  : 1}      #  ******_*********_****_***********_ATTRIBUTE (Lowest)
-    
+
     ## The real constructor of PlatformAutoGen
     #
     #  This method is not supposed to be called by users of PlatformAutoGen. It's
@@ -960,8 +960,8 @@ def CollectPlatformDynamicPcds(self):
             #GuidValue.update(M.Guids)
             
             self.Platform.Modules[F].M = M
-            
-            for PcdFromModule in M.ModulePcdList+M.LibraryPcdList:
+
+            for PcdFromModule in M.ModulePcdList + M.LibraryPcdList:
                 # make sure that the "VOID*" kind of datum has MaxDatumSize set
                 if PcdFromModule.DatumType == "VOID*" and PcdFromModule.MaxDatumSize in [None, '']:
                     NoDatumTypePcdList.add("%s.%s [%s]" % (PcdFromModule.TokenSpaceGuidCName, PcdFromModule.TokenCName, F))
@@ -1111,9 +1111,9 @@ def CollectPlatformDynamicPcds(self):
         if (self.Workspace.ArchList[-1] == self.Arch): 
             for Pcd in self._DynamicPcdList:
                 # just pick the a value to determine whether is unicode string type
-                Sku      = Pcd.SkuInfoList[Pcd.SkuInfoList.keys()[0]]
+                Sku = Pcd.SkuInfoList[Pcd.SkuInfoList.keys()[0]]
                 Sku.VpdOffset = Sku.VpdOffset.strip()
-                
+
                 PcdValue = Sku.DefaultValue
                 if Pcd.DatumType == 'VOID*' and PcdValue.startswith("L"):
                     # if found PCD which datum value is unicode string the insert to left size of UnicodeIndex
@@ -1124,10 +1124,10 @@ def CollectPlatformDynamicPcds(self):
                 else:
                     OtherPcdArray.append(Pcd)
                 if Pcd.Type in [TAB_PCDS_DYNAMIC_VPD, TAB_PCDS_DYNAMIC_EX_VPD]:
-                    VpdPcdDict[(Pcd.TokenCName, Pcd.TokenSpaceGuidCName)] = Pcd                   
-            
+                    VpdPcdDict[(Pcd.TokenCName, Pcd.TokenSpaceGuidCName)] = Pcd
+
             PlatformPcds = self.Platform.Pcds.keys()
-            PlatformPcds.sort()            
+            PlatformPcds.sort()
             #
             # Add VPD type PCD into VpdFile and determine whether the VPD PCD need to be fixed up.
             #
@@ -1145,8 +1145,8 @@ def CollectPlatformDynamicPcds(self):
                             if self.Platform.VpdToolGuid == None or self.Platform.VpdToolGuid == '':
                                 EdkLogger.error("Build", FILE_NOT_FOUND, \
                                                 "Fail to find third-party BPDG tool to process VPD PCDs. BPDG Guid tool need to be defined in tools_def.txt and VPD_TOOL_GUID need to be provided in DSC file.")
-                            
-                                   
+
+
             #
             # Fix the PCDs define in VPD PCD section that never referenced by module.
             # An example is PCD for signature usage.
@@ -1161,7 +1161,7 @@ def CollectPlatformDynamicPcds(self):
                             if (VpdPcd.TokenSpaceGuidCName == DscPcdEntry.TokenSpaceGuidCName) and \
                                (VpdPcd.TokenCName == DscPcdEntry.TokenCName):
                                     FoundFlag = True
-                        
+
                         # Not found, it should be signature
                         if not FoundFlag :
                             # just pick the a value to determine whether is unicode string type
@@ -1211,7 +1211,7 @@ def CollectPlatformDynamicPcds(self):
                VpdFile.GetCount() != 0:
                 EdkLogger.error("build", ATTRIBUTE_NOT_AVAILABLE, 
                                 "Fail to get FLASH_DEFINITION definition in DSC file %s which is required when DSC contains VPD PCD." % str(self.Platform.MetaFile))
-            
+
             if VpdFile.GetCount() != 0:
                 DscTimeStamp = self.Platform.MetaFile.TimeStamp
                 FvPath = os.path.join(self.BuildDir, "FV")
@@ -1220,14 +1220,14 @@ def CollectPlatformDynamicPcds(self):
                         os.makedirs(FvPath)
                     except:
                         EdkLogger.error("build", FILE_WRITE_FAILURE, "Fail to create FV folder under %s" % self.BuildDir)
-                        
-        
+
+
                 VpdFilePath = os.path.join(FvPath, "%s.txt" % self.Platform.VpdToolGuid)
 
-                
+
                 if not os.path.exists(VpdFilePath) or os.path.getmtime(VpdFilePath) < DscTimeStamp:
                     VpdFile.Write(VpdFilePath)
-        
+
                     # retrieve BPDG tool's path from tool_def.txt according to VPD_TOOL_GUID defined in DSC file.
                     BPDGToolName = None
                     for ToolDef in self.ToolDefinition.values():
@@ -1241,13 +1241,13 @@ def CollectPlatformDynamicPcds(self):
                         VpdInfoFile.CallExtenalBPDGTool(BPDGToolName, VpdFilePath)
                     else:
                         EdkLogger.error("Build", FILE_NOT_FOUND, "Fail to find third-party BPDG tool to process VPD PCDs. BPDG Guid tool need to be defined in tools_def.txt and VPD_TOOL_GUID need to be provided in DSC file.")
-                        
+
                 # Process VPD map file generated by third party BPDG tool
                 if NeedProcessVpdMapFile:
                     VpdMapFilePath = os.path.join(self.BuildDir, "FV", "%s.map" % self.Platform.VpdToolGuid)
                     if os.path.exists(VpdMapFilePath):
                         VpdFile.Read(VpdMapFilePath)
-                
+
                         # Fixup "*" offset
                         for Pcd in self._DynamicPcdList:
                             # just pick the a value to determine whether is unicode string type
@@ -1258,9 +1258,9 @@ def CollectPlatformDynamicPcds(self):
                                 i += 1
                     else:
                         EdkLogger.error("build", FILE_READ_FAILURE, "Can not find VPD map file %s to fix up VPD offset." % VpdMapFilePath)
-            
+
             # Delete the DynamicPcdList At the last time enter into this function 
-            del self._DynamicPcdList[:]	                
+            del self._DynamicPcdList[:]
         self._DynamicPcdList.extend(UnicodePcdArray)
         self._DynamicPcdList.extend(HiiPcdArray)
         self._DynamicPcdList.extend(OtherPcdArray)
@@ -1471,10 +1471,10 @@ def _GetBuildRule(self):
             else:
                 if self._BuildRule._FileVersion < AutoGenReqBuildRuleVerNum :
                     # If Build Rule's version is less than the version number required by the tools, halting the build.
-                    EdkLogger.error("build", AUTOGEN_ERROR, 
+                    EdkLogger.error("build", AUTOGEN_ERROR,
                                     ExtraData="The version number [%s] of build_rule.txt is less than the version number required by the AutoGen.(the minimum required version number is [%s])"\
                                      % (self._BuildRule._FileVersion, AutoGenReqBuildRuleVerNum))
-              
+
         return self._BuildRule
 
     ## Summarize the packages used by modules in this platform
@@ -1534,28 +1534,28 @@ def _GetPcdTokenNumbers(self):
                         EdkLogger.debug(EdkLogger.DEBUG_5, "%s %s (%s) -> %d" % (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Pcd.Phase, TokenNumber))
                         self._PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName] = TokenNumber
                         TokenNumber += 1
-                        
+
             for Pcd in self.DynamicPcdList:
                 if Pcd.Phase == "PEI":
                     if Pcd.Type in ["DynamicEx", "DynamicExDefault", "DynamicExVpd", "DynamicExHii"]:
                         EdkLogger.debug(EdkLogger.DEBUG_5, "%s %s (%s) -> %d" % (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Pcd.Phase, TokenNumber))
                         self._PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName] = TokenNumber
                         TokenNumber += 1
-                        
+
             for Pcd in self.DynamicPcdList:
                 if Pcd.Phase == "DXE":
                     if Pcd.Type in ["Dynamic", "DynamicDefault", "DynamicVpd", "DynamicHii"]:
                         EdkLogger.debug(EdkLogger.DEBUG_5, "%s %s (%s) -> %d" % (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Pcd.Phase, TokenNumber))
                         self._PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName] = TokenNumber
                         TokenNumber += 1
-                        
+
             for Pcd in self.DynamicPcdList:
                 if Pcd.Phase == "DXE":
                     if Pcd.Type in ["DynamicEx", "DynamicExDefault", "DynamicExVpd", "DynamicExHii"]:
                         EdkLogger.debug(EdkLogger.DEBUG_5, "%s %s (%s) -> %d" % (Pcd.TokenCName, Pcd.TokenSpaceGuidCName, Pcd.Phase, TokenNumber))
                         self._PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName] = TokenNumber
                         TokenNumber += 1
-                        
+
             for Pcd in self.NonDynamicPcdList:
                 self._PcdTokenNumber[Pcd.TokenCName, Pcd.TokenSpaceGuidCName] = TokenNumber
                 TokenNumber += 1
@@ -1787,7 +1787,7 @@ def _OverridePcd(self, ToPcd, FromPcd, Module=""):
             elif (ToPcd.Type not in [None, '']) and (FromPcd.Type not in [None, ''])\
                 and (ToPcd.Type != FromPcd.Type) and (ToPcd.Type in FromPcd.Type):
                 if ToPcd.Type.strip() == "DynamicEx":
-                    ToPcd.Type = FromPcd.Type             
+                    ToPcd.Type = FromPcd.Type
             elif ToPcd.Type not in [None, ''] and FromPcd.Type not in [None, ''] \
                 and ToPcd.Type != FromPcd.Type:
                 EdkLogger.error("build", OPTION_CONFLICT, "Mismatched PCD type",
@@ -1850,11 +1850,11 @@ def _OverridePcd(self, ToPcd, FromPcd, Module=""):
     #
     def ApplyPcdSetting(self, Module, Pcds):
         # for each PCD in module
-        for Name,Guid in Pcds:
-            PcdInModule = Pcds[Name,Guid]
+        for Name, Guid in Pcds:
+            PcdInModule = Pcds[Name, Guid]
             # find out the PCD setting in platform
-            if (Name,Guid) in self.Platform.Pcds:
-                PcdInPlatform = self.Platform.Pcds[Name,Guid]
+            if (Name, Guid) in self.Platform.Pcds:
+                PcdInPlatform = self.Platform.Pcds[Name, Guid]
             else:
                 PcdInPlatform = None
             # then override the settings if any
@@ -1927,8 +1927,8 @@ def ResolveLibraryReference(self, Module):
     # @retval   Value  Priority value based on the priority list.
     #
     def CalculatePriorityValue(self, Key):
-        Target, ToolChain, Arch, CommandType, Attr = Key.split('_')       
-        PriorityValue = 0x11111          
+        Target, ToolChain, Arch, CommandType, Attr = Key.split('_')
+        PriorityValue = 0x11111
         if Target == "*":
             PriorityValue &= 0x01111
         if ToolChain == "*":
@@ -1939,9 +1939,9 @@ def CalculatePriorityValue(self, Key):
             PriorityValue &= 0x11101
         if Attr == "*":
             PriorityValue &= 0x11110
-        
-        return self.PrioList["0x%0.5x"%PriorityValue]
-                                    
+
+        return self.PrioList["0x%0.5x" % PriorityValue]
+
 
     ## Expand * in build option key
     #
@@ -1953,7 +1953,7 @@ def _ExpandBuildOption(self, Options, ModuleStyle=None):
         BuildOptions = {}
         FamilyMatch  = False
         FamilyIsNull = True
-                
+
         OverrideList = {}
         #
         # Construct a list contain the build options which need override.
@@ -1970,7 +1970,7 @@ def _ExpandBuildOption(self, Options, ModuleStyle=None):
                     if ToolChain == self.ToolChain or ToolChain == "*":
                         if Arch == self.Arch or Arch == "*":
                             if Options[Key].startswith("="):
-                                if OverrideList.get(Key[1]) != None:                                                
+                                if OverrideList.get(Key[1]) != None:
                                     OverrideList.pop(Key[1])
                                 OverrideList[Key[1]] = Options[Key]
         
@@ -1978,9 +1978,9 @@ def _ExpandBuildOption(self, Options, ModuleStyle=None):
         # Use the highest priority value. 
         #
         if (len(OverrideList) >= 2):
-            KeyList   = OverrideList.keys()
+            KeyList = OverrideList.keys()
             for Index in range(len(KeyList)):
-                NowKey      = KeyList[Index]
+                NowKey = KeyList[Index]
                 Target1, ToolChain1, Arch1, CommandType1, Attr1 = NowKey.split("_")
                 for Index1 in range(len(KeyList) - Index - 1):
                     NextKey = KeyList[Index1 + Index + 1]
@@ -1994,10 +1994,10 @@ def _ExpandBuildOption(self, Options, ModuleStyle=None):
                                 if CommandType1 == CommandType2 or CommandType1 == "*" or CommandType2 == "*":
                                     if Attr1 == Attr2 or Attr1 == "*" or Attr2 == "*":
                                         if self.CalculatePriorityValue(NowKey) > self.CalculatePriorityValue(NextKey):
-                                            if Options.get((self.BuildRuleFamily, NextKey)) != None:  
+                                            if Options.get((self.BuildRuleFamily, NextKey)) != None:
                                                 Options.pop((self.BuildRuleFamily, NextKey))
                                         else:
-                                            if Options.get((self.BuildRuleFamily, NowKey)) != None: 
+                                            if Options.get((self.BuildRuleFamily, NowKey)) != None:
                                                 Options.pop((self.BuildRuleFamily, NowKey))
                                                            
         for Key in Options:
@@ -2045,7 +2045,7 @@ def _ExpandBuildOption(self, Options, ModuleStyle=None):
             Family = Key[0]
             Target, Tag, Arch, Tool, Attr = Key[1].split("_")
             # if tool chain family doesn't match, skip it
-            if Tool not in self.ToolDefinition or Family =="":
+            if Tool not in self.ToolDefinition or Family == "":
                 continue
             # option has been added before
             if Family != self.ToolDefinition[Tool][TAB_TOD_DEFINES_FAMILY]:
@@ -2637,9 +2637,9 @@ def _GetBuildOptionIncPathList(self):
             # is the former use /I , the Latter used -I to specify include directories
             #
             if self.PlatformInfo.ToolChainFamily in ('MSFT'):
-                gBuildOptIncludePattern = re.compile(r"(?:.*?)/I[ \t]*([^ ]*)", re.MULTILINE|re.DOTALL)
+                gBuildOptIncludePattern = re.compile(r"(?:.*?)/I[ \t]*([^ ]*)", re.MULTILINE | re.DOTALL)
             elif self.PlatformInfo.ToolChainFamily in ('INTEL', 'GCC', 'RVCT'):
-                gBuildOptIncludePattern = re.compile(r"(?:.*?)-I[ \t]*([^ ]*)", re.MULTILINE|re.DOTALL)
+                gBuildOptIncludePattern = re.compile(r"(?:.*?)-I[ \t]*([^ ]*)", re.MULTILINE | re.DOTALL)
             else:
                 #
                 # New ToolChainFamily, don't known whether there is option to specify include directories
@@ -2673,11 +2673,11 @@ def _GetBuildOptionIncPathList(self):
                 if self.AutoGenVersion >= 0x00010005 and len(IncPathList) > 0:
                     for Path in IncPathList:
                         if (Path not in self.IncludePathList) and (CommonPath([Path, self.MetaFile.Dir]) != self.MetaFile.Dir):
-                            ErrMsg = "The include directory for the EDK II module in this line is invalid %s specified in %s FLAGS '%s'" % (Path, Tool, FlagOption) 
-                            EdkLogger.error("build", 
+                            ErrMsg = "The include directory for the EDK II module in this line is invalid %s specified in %s FLAGS '%s'" % (Path, Tool, FlagOption)
+                            EdkLogger.error("build",
                                             PARAMETER_INVALID,
-                                            ExtraData = ErrMsg, 
-                                            File = str(self.MetaFile))
+                                            ExtraData=ErrMsg,
+                                            File=str(self.MetaFile))
 
                 
                 BuildOptionIncPathList += IncPathList
@@ -2797,7 +2797,7 @@ def _ApplyBuildRule(self, File, FileType):
             if File.IsBinary and File == Source and self._BinaryFileList != None and File in self._BinaryFileList:
                 # Skip all files that are not binary libraries
                 if not self.IsLibrary:
-                    continue            
+                    continue
                 RuleObject = self.BuildRules[TAB_DEFAULT_BINARY_FILE]
             elif FileType in self.BuildRules:
                 RuleObject = self.BuildRules[FileType]
@@ -3215,7 +3215,7 @@ def CreateAsBuiltInf(self):
         # Also find all packages that the DynamicEx PCDs depend on
         Pcds = []
         PatchablePcds = {}
-        Packages = []        
+        Packages = []
         PcdCheckList = []
         PcdTokenSpaceList = []
         for Pcd in self.ModulePcdList + self.LibraryPcdList:
@@ -3292,7 +3292,7 @@ def CreateAsBuiltInf(self):
           'module_uefi_hii_resource_section'  : [MDefs['UEFI_HII_RESOURCE_SECTION']] if 'UEFI_HII_RESOURCE_SECTION' in MDefs else [],
           'module_uni_file'                   : [MDefs['MODULE_UNI_FILE']] if 'MODULE_UNI_FILE' in MDefs else [],
           'module_arch'                       : self.Arch,
-          'package_item'                      : ['%s' % (Package.MetaFile.File.replace('\\','/')) for Package in Packages],
+          'package_item'                      : ['%s' % (Package.MetaFile.File.replace('\\', '/')) for Package in Packages],
           'binary_item'                       : [],
           'patchablepcd_item'                 : [],
           'pcd_item'                          : [],
@@ -3316,27 +3316,27 @@ def CreateAsBuiltInf(self):
         if 'PI_SPECIFICATION_VERSION' in self.Specification:
           AsBuiltInfDict['module_pi_specification_version'] += [self.Specification['PI_SPECIFICATION_VERSION']]
 
-        OutputDir = self.OutputDir.replace('\\','/').strip('/')
+        OutputDir = self.OutputDir.replace('\\', '/').strip('/')
         if self.ModuleType in ['BASE', 'USER_DEFINED']:
           for Item in self.CodaTargetList:
-            File = Item.Target.Path.replace('\\','/').strip('/').replace(OutputDir,'').strip('/')
-            if Item.Target.Ext.lower() == '.aml': 
+            File = Item.Target.Path.replace('\\', '/').strip('/').replace(OutputDir, '').strip('/')
+            if Item.Target.Ext.lower() == '.aml':
               AsBuiltInfDict['binary_item'] += ['ASL|' + File]
-            elif Item.Target.Ext.lower() == '.acpi': 
+            elif Item.Target.Ext.lower() == '.acpi':
               AsBuiltInfDict['binary_item'] += ['ACPI|' + File]
             else:
               AsBuiltInfDict['binary_item'] += ['BIN|' + File]
         else:
           for Item in self.CodaTargetList:
-            File = Item.Target.Path.replace('\\','/').strip('/').replace(OutputDir,'').strip('/')
-            if Item.Target.Ext.lower() == '.efi': 
+            File = Item.Target.Path.replace('\\', '/').strip('/').replace(OutputDir, '').strip('/')
+            if Item.Target.Ext.lower() == '.efi':
               AsBuiltInfDict['binary_item'] += ['PE32|' + self.Name + '.efi']
             else:
               AsBuiltInfDict['binary_item'] += ['BIN|' + File]
           if self.DepexGenerated:
             if self.ModuleType in ['PEIM']:
               AsBuiltInfDict['binary_item'] += ['PEI_DEPEX|' + self.Name + '.depex']
-            if self.ModuleType in ['DXE_DRIVER','DXE_RUNTIME_DRIVER','DXE_SAL_DRIVER','UEFI_DRIVER']:
+            if self.ModuleType in ['DXE_DRIVER', 'DXE_RUNTIME_DRIVER', 'DXE_SAL_DRIVER', 'UEFI_DRIVER']:
               AsBuiltInfDict['binary_item'] += ['DXE_DEPEX|' + self.Name + '.depex']
             if self.ModuleType in ['DXE_SMM_DRIVER']:
               AsBuiltInfDict['binary_item'] += ['SMM_DEPEX|' + self.Name + '.depex']
diff --git a/BaseTools/Source/Python/AutoGen/BuildEngine.py b/BaseTools/Source/Python/AutoGen/BuildEngine.py
index ee1d3c89f292..63ed47d94bcb 100644
--- a/BaseTools/Source/Python/AutoGen/BuildEngine.py
+++ b/BaseTools/Source/Python/AutoGen/BuildEngine.py
@@ -388,7 +388,7 @@ def Parse(self):
             
             # find the build_rule_version
             if Line and Line[0] == "#" and Line.find(TAB_BUILD_RULE_VERSION) <> -1:
-                if Line.find("=") <> -1 and Line.find("=") < (len(Line)-1) and (Line[(Line.find("=") + 1):]).split():
+                if Line.find("=") <> -1 and Line.find("=") < (len(Line) - 1) and (Line[(Line.find("=") + 1):]).split():
                     self._FileVersion = (Line[(Line.find("=") + 1):]).split()[0]
             # skip empty or comment line
             if Line == "" or Line[0] == "#":
@@ -470,16 +470,16 @@ def ParseSectionHeader(self, LineIndex):
             if TokenList[0] == "BUILD":
                 if len(TokenList) == 1:
                     EdkLogger.error("build", FORMAT_INVALID, "Invalid rule section",
-                                    File=self.RuleFile, Line=LineIndex+1,
+                                    File=self.RuleFile, Line=LineIndex + 1,
                                     ExtraData=self.RuleContent[LineIndex])
 
                 FileType = TokenList[1]
                 if FileType == '':
                     EdkLogger.error("build", FORMAT_INVALID, "No file type given",
-                                    File=self.RuleFile, Line=LineIndex+1,
+                                    File=self.RuleFile, Line=LineIndex + 1,
                                     ExtraData=self.RuleContent[LineIndex])
                 if self._FileTypePattern.match(FileType) == None:
-                    EdkLogger.error("build", FORMAT_INVALID, File=self.RuleFile, Line=LineIndex+1,
+                    EdkLogger.error("build", FORMAT_INVALID, File=self.RuleFile, Line=LineIndex + 1,
                                     ExtraData="Only character, number (non-first character), '_' and '-' are allowed in file type")
             # new format: File-Type.Build-Type.Arch
             else:
@@ -488,7 +488,7 @@ def ParseSectionHeader(self, LineIndex):
                 elif FileType != TokenList[0]:
                     EdkLogger.error("build", FORMAT_INVALID,
                                     "Different file types are not allowed in the same rule section",
-                                    File=self.RuleFile, Line=LineIndex+1,
+                                    File=self.RuleFile, Line=LineIndex + 1,
                                     ExtraData=self.RuleContent[LineIndex])
                 if len(TokenList) > 1:
                     BuildType = TokenList[1]
@@ -502,12 +502,12 @@ def ParseSectionHeader(self, LineIndex):
         if 'COMMON' in self._BuildTypeList and len(self._BuildTypeList) > 1:
             EdkLogger.error("build", FORMAT_INVALID,
                             "Specific build types must not be mixed with common one",
-                            File=self.RuleFile, Line=LineIndex+1,
+                            File=self.RuleFile, Line=LineIndex + 1,
                             ExtraData=self.RuleContent[LineIndex])
         if 'COMMON' in self._ArchList and len(self._ArchList) > 1:
             EdkLogger.error("build", FORMAT_INVALID,
                             "Specific ARCH must not be mixed with common one",
-                            File=self.RuleFile, Line=LineIndex+1,
+                            File=self.RuleFile, Line=LineIndex + 1,
                             ExtraData=self.RuleContent[LineIndex])
 
         self._FileType = FileType
@@ -531,7 +531,7 @@ def ParseSubSectionHeader(self, LineIndex):
             elif SectionType != Type:
                 EdkLogger.error("build", FORMAT_INVALID,
                                 "Two different section types are not allowed in the same sub-section",
-                                File=self.RuleFile, Line=LineIndex+1,
+                                File=self.RuleFile, Line=LineIndex + 1,
                                 ExtraData=self.RuleContent[LineIndex])
 
             if len(TokenList) > 1:
@@ -548,10 +548,10 @@ def ParseSubSectionHeader(self, LineIndex):
         if 'COMMON' in FamilyList and len(FamilyList) > 1:
             EdkLogger.error("build", FORMAT_INVALID,
                             "Specific tool chain family should not be mixed with general one",
-                            File=self.RuleFile, Line=LineIndex+1,
+                            File=self.RuleFile, Line=LineIndex + 1,
                             ExtraData=self.RuleContent[LineIndex])
         if self._State not in self._StateHandler:
-            EdkLogger.error("build", FORMAT_INVALID, File=self.RuleFile, Line=LineIndex+1,
+            EdkLogger.error("build", FORMAT_INVALID, File=self.RuleFile, Line=LineIndex + 1,
                             ExtraData="Unknown subsection: %s" % self.RuleContent[LineIndex])
     ## Parse <InputFile> sub-section
     #
diff --git a/BaseTools/Source/Python/AutoGen/GenDepex.py b/BaseTools/Source/Python/AutoGen/GenDepex.py
index a390d560fc1a..5923a75ab7fb 100644
--- a/BaseTools/Source/Python/AutoGen/GenDepex.py
+++ b/BaseTools/Source/Python/AutoGen/GenDepex.py
@@ -286,7 +286,7 @@ def Optimize(self):
         # don't generate depex if only TRUE operand left
         if self.ModuleType == 'PEIM' and len(NewOperand) == 1 and NewOperand[0] == 'TRUE':
             self.PostfixNotation = []
-            return            
+            return
 
         # don't generate depex if all operands are architecture protocols
         if self.ModuleType in ['UEFI_DRIVER', 'DXE_DRIVER', 'DXE_RUNTIME_DRIVER', 'DXE_SAL_DRIVER', 'DXE_SMM_DRIVER'] and \
@@ -424,7 +424,7 @@ def Main():
         Dpx = DependencyExpression(DxsString, Option.ModuleType, Option.Optimize)
         if Option.OutputFile != None:
             FileChangeFlag = Dpx.Generate(Option.OutputFile)
-            if not FileChangeFlag and DxsFile: 
+            if not FileChangeFlag and DxsFile:
                 #
                 # Touch the output file if its time stamp is older than the original
                 # DXS file to avoid re-invoke this tool for the dependency check in build rule.
diff --git a/BaseTools/Source/Python/AutoGen/GenMake.py b/BaseTools/Source/Python/AutoGen/GenMake.py
index d9b219e1c75f..89285c125433 100644
--- a/BaseTools/Source/Python/AutoGen/GenMake.py
+++ b/BaseTools/Source/Python/AutoGen/GenMake.py
@@ -27,7 +27,7 @@
 import Common.GlobalData as GlobalData
 
 ## Regular expression for finding header file inclusions
-gIncludePattern = re.compile(r"^[ \t]*#?[ \t]*include(?:[ \t]*(?:\\(?:\r\n|\r|\n))*[ \t]*)*(?:\(?[\"<]?[ \t]*)([-\w.\\/() \t]+)(?:[ \t]*[\">]?\)?)", re.MULTILINE|re.UNICODE|re.IGNORECASE)
+gIncludePattern = re.compile(r"^[ \t]*#?[ \t]*include(?:[ \t]*(?:\\(?:\r\n|\r|\n))*[ \t]*)*(?:\(?[\"<]?[ \t]*)([-\w.\\/() \t]+)(?:[ \t]*[\">]?\)?)", re.MULTILINE | re.UNICODE | re.IGNORECASE)
 
 ## Regular expression for matching macro used in header file inclusion
 gMacroPattern = re.compile("([_A-Z][_A-Z0-9]*)[ \t]*\((.+)\)", re.UNICODE)
@@ -499,7 +499,7 @@ def _CreateTemplateDict(self):
 
         # convert source files and binary files to build targets
         self.ResultFileList = [str(T.Target) for T in self._AutoGenObject.CodaTargetList]
-        if len(self.ResultFileList) == 0 and len(self._AutoGenObject.SourceFileList) <> 0:        
+        if len(self.ResultFileList) == 0 and len(self._AutoGenObject.SourceFileList) <> 0:
             EdkLogger.error("build", AUTOGEN_ERROR, "Nothing to build",
                             ExtraData="[%s]" % str(self._AutoGenObject))
 
@@ -520,9 +520,9 @@ def _CreateTemplateDict(self):
         FileMacro = ""
         IncludePathList = []
         for P in  self._AutoGenObject.IncludePathList:
-            IncludePathList.append(IncPrefix+self.PlaceMacro(P, self.Macros))
+            IncludePathList.append(IncPrefix + self.PlaceMacro(P, self.Macros))
             if FileBuildRule.INC_LIST_MACRO in self.ListFileMacros:
-                self.ListFileMacros[FileBuildRule.INC_LIST_MACRO].append(IncPrefix+P)
+                self.ListFileMacros[FileBuildRule.INC_LIST_MACRO].append(IncPrefix + P)
         FileMacro += self._FILE_MACRO_TEMPLATE.Replace(
                                                 {
                                                     "macro_name"   : "INC",
@@ -533,7 +533,7 @@ def _CreateTemplateDict(self):
 
         # Generate macros used to represent files containing list of input files
         for ListFileMacro in self.ListFileMacros:
-            ListFileName = os.path.join(self._AutoGenObject.OutputDir, "%s.lst" % ListFileMacro.lower()[:len(ListFileMacro)-5])
+            ListFileName = os.path.join(self._AutoGenObject.OutputDir, "%s.lst" % ListFileMacro.lower()[:len(ListFileMacro) - 5])
             FileMacroList.append("%s = %s" % (ListFileMacro, ListFileName))
             SaveFileOnChange(
                 ListFileName,
@@ -767,7 +767,7 @@ def GetDependencyList(self, File, ForceList, SearchPathList):
                 try:
                     Fd = open(F.Path, 'r')
                 except BaseException, X:
-                    EdkLogger.error("build", FILE_OPEN_FAILURE, ExtraData=F.Path+"\n\t"+str(X))
+                    EdkLogger.error("build", FILE_OPEN_FAILURE, ExtraData=F.Path + "\n\t" + str(X))
 
                 FileContent = Fd.read()
                 Fd.close()
diff --git a/BaseTools/Source/Python/AutoGen/GenPcdDb.py b/BaseTools/Source/Python/AutoGen/GenPcdDb.py
index d07ac60ef363..23865254d791 100644
--- a/BaseTools/Source/Python/AutoGen/GenPcdDb.py
+++ b/BaseTools/Source/Python/AutoGen/GenPcdDb.py
@@ -784,11 +784,11 @@ def BuildExDataBase(Dict):
  
     DbTotal = [InitValueUint64, VardefValueUint64, InitValueUint32, VardefValueUint32, VpdHeadValue, ExMapTable, 
                LocalTokenNumberTable, GuidTable, StringHeadValue,  PcdNameOffsetTable,VariableTable,SkuTable, StringTableLen, PcdTokenTable,PcdCNameTable, 
-               SizeTableValue, InitValueUint16, VardefValueUint16,InitValueUint8, VardefValueUint8, InitValueBoolean,
+               SizeTableValue, InitValueUint16, VardefValueUint16, InitValueUint8, VardefValueUint8, InitValueBoolean,
                VardefValueBoolean, SkuidValue, SkuIndexValue, UnInitValueUint64, UnInitValueUint32, UnInitValueUint16, UnInitValueUint8, UnInitValueBoolean]
     DbItemTotal = [DbInitValueUint64, DbVardefValueUint64, DbInitValueUint32, DbVardefValueUint32, DbVpdHeadValue, DbExMapTable, 
                DbLocalTokenNumberTable, DbGuidTable, DbStringHeadValue,  DbPcdNameOffsetTable,DbVariableTable,DbSkuTable, DbStringTableLen, DbPcdTokenTable, DbPcdCNameTable, 
-               DbSizeTableValue, DbInitValueUint16, DbVardefValueUint16,DbInitValueUint8, DbVardefValueUint8, DbInitValueBoolean,
+               DbSizeTableValue, DbInitValueUint16, DbVardefValueUint16, DbInitValueUint8, DbVardefValueUint8, DbInitValueBoolean,
                DbVardefValueBoolean, DbSkuidValue, DbSkuIndexValue, DbUnInitValueUint64, DbUnInitValueUint32, DbUnInitValueUint16, DbUnInitValueUint8, DbUnInitValueBoolean]
     
     # SkuidValue is the last table in the init table items
@@ -1343,7 +1343,7 @@ def CreatePcdDatabasePhaseSpecificAutoGen (Platform, Phase):
                         Dict['STRING_TABLE_VALUE'].append(DefaultValueBinStructure)
                     elif Sku.DefaultValue[0] == '"':
                         DefaultValueBinStructure = StringToArray(Sku.DefaultValue)
-                        Size = len(Sku.DefaultValue) -2 + 1
+                        Size = len(Sku.DefaultValue) - 2 + 1
                         Dict['STRING_TABLE_VALUE'].append(DefaultValueBinStructure)
                     elif Sku.DefaultValue[0] == '{':
                         DefaultValueBinStructure = StringToArray(Sku.DefaultValue)
@@ -1375,7 +1375,7 @@ def CreatePcdDatabasePhaseSpecificAutoGen (Platform, Phase):
                         Pcd.InitString = 'INIT'
                     else:
                         if int(Sku.DefaultValue, 0) != 0:
-                            Pcd.InitString = 'INIT'              
+                            Pcd.InitString = 'INIT'
                 #
                 # For UNIT64 type PCD's value, ULL should be append to avoid
                 # warning under linux building environment.
diff --git a/BaseTools/Source/Python/AutoGen/StrGather.py b/BaseTools/Source/Python/AutoGen/StrGather.py
index 48c396a9aa96..60840041ba22 100644
--- a/BaseTools/Source/Python/AutoGen/StrGather.py
+++ b/BaseTools/Source/Python/AutoGen/StrGather.py
@@ -113,7 +113,7 @@ def DecToHexStr(Dec, Digit = 8):
 # @retval:       A list for formatted hex string
 #
 def DecToHexList(Dec, Digit = 8):
-    Hex = eval("'%0" + str(Digit) + "X' % int(Dec)" )
+    Hex = eval("'%0" + str(Digit) + "X' % int(Dec)")
     List = []
     for Bit in range(Digit - 2, -1, -2):
         List.append(HexHeader + Hex[Bit:Bit + 2])
@@ -192,7 +192,7 @@ def CreateHFileContent(BaseName, UniObjectClass, IsCompatibleMode, UniGenCFlag):
                     Line = COMMENT_DEFINE_STR + ' ' + Name + ' ' * (ValueStartPtr - len(DEFINE_STR + Name)) + DecToHexStr(Token, 4) + COMMENT_NOT_REFERENCED
                 UnusedStr = WriteLine(UnusedStr, Line)
 
-    Str = ''.join([Str,UnusedStr])
+    Str = ''.join([Str, UnusedStr])
 
     Str = WriteLine(Str, '')
     if IsCompatibleMode or UniGenCFlag:
@@ -235,7 +235,7 @@ def CreateCFileHeader():
 #
 def CreateBinBuffer(BinBuffer, Array):
     for Item in Array:
-        BinBuffer.write(pack("B", int(Item,16)))
+        BinBuffer.write(pack("B", int(Item, 16)))
 
 ## Create a formatted string all items in an array
 #
@@ -258,7 +258,7 @@ def CreateArrayItem(Array, Width = 16):
             Index = Index + 1
         else:
             ArrayItem = WriteLine(ArrayItem, Line)
-            Line = '  ' + Item +  ',  '
+            Line = '  ' + Item + ',  '
             Index = 1
     ArrayItem = Write(ArrayItem, Line.rstrip())
 
@@ -320,7 +320,7 @@ def GetFilteredLanguage(UniLanguageList, LanguageFilterList):
 
                 if PrimaryTag == UniLanguagePrimaryTag:
                     if UniLanguage not in UniLanguageListFiltered:
-                        UniLanguageListFiltered += [UniLanguage]    
+                        UniLanguageListFiltered += [UniLanguage]
                     break
             else:
                 # Here is rule 3 for "get best language"
@@ -368,7 +368,7 @@ def CreateCFileContent(BaseName, UniObjectClass, IsCompatibleMode, UniBinBuffer,
     
     UniLanguageList = []
     for IndexI in range(len(UniObjectClass.LanguageDef)):
-        UniLanguageList += [UniObjectClass.LanguageDef[IndexI][0]]           
+        UniLanguageList += [UniObjectClass.LanguageDef[IndexI][0]]
 
     UniLanguageListFiltered = GetFilteredLanguage(UniLanguageList, LanguageFilterList)
  
@@ -450,14 +450,14 @@ def CreateCFileContent(BaseName, UniObjectClass, IsCompatibleMode, UniBinBuffer,
         if UniBinBuffer:
             CreateBinBuffer (UniBinBuffer, List)
             UniBinBuffer.write (StringBuffer.getvalue())
-            UniBinBuffer.write (pack("B", int(EFI_HII_SIBT_END,16)))
+            UniBinBuffer.write (pack("B", int(EFI_HII_SIBT_END, 16)))
         StringBuffer.close()
 
     #
     # Create line for string variable name
     # "unsigned char $(BaseName)Strings[] = {"
     #
-    AllStr = WriteLine('', CHAR_ARRAY_DEFIN + ' ' + BaseName + COMMON_FILE_NAME + '[] = {\n' )
+    AllStr = WriteLine('', CHAR_ARRAY_DEFIN + ' ' + BaseName + COMMON_FILE_NAME + '[] = {\n')
 
     if IsCompatibleMode:
         #
@@ -618,13 +618,13 @@ def GetStringFiles(UniFilList, SourceFileList, IncludeList, IncludePathList, Ski
 # Write an item
 #
 def Write(Target, Item):
-    return ''.join([Target,Item])
+    return ''.join([Target, Item])
 
 #
 # Write an item with a break line
 #
 def WriteLine(Target, Item):
-    return ''.join([Target,Item,'\n'])
+    return ''.join([Target, Item, '\n'])
 
 # This acts like the main() function for the script, unless it is 'import'ed into another
 # script.
diff --git a/BaseTools/Source/Python/AutoGen/UniClassObject.py b/BaseTools/Source/Python/AutoGen/UniClassObject.py
index 02a15cc0f0d4..a01381be5e64 100644
--- a/BaseTools/Source/Python/AutoGen/UniClassObject.py
+++ b/BaseTools/Source/Python/AutoGen/UniClassObject.py
@@ -248,7 +248,7 @@ def GetLangDef(self, File, Line):
                 EdkLogger.error("build", FILE_OPEN_FAILURE, ExtraData=File);
             LineNo = GetLineNo(FileIn, Line, False)
             EdkLogger.error("Unicode File Parser", PARSER_ERROR, "Wrong language definition",
-                            ExtraData="""%s\n\t*Correct format is like '#langdef en-US "English"'""" % Line, File = File, Line = LineNo)
+                            ExtraData="""%s\n\t*Correct format is like '#langdef en-US "English"'""" % Line, File=File, Line=LineNo)
         else:
             LangName = GetLanguageCode(Lang[1], self.IsCompatibleMode, self.File)
             LangPrintName = Lang[2]
@@ -352,7 +352,7 @@ def GetStringObject(self, Item):
         if Name != '':
             MatchString = re.match('[A-Z0-9_]+', Name, re.UNICODE)
             if MatchString == None or MatchString.end(0) != len(Name):
-                EdkLogger.error('Unicode File Parser', FORMAT_INVALID, 'The string token name %s defined in UNI file %s contains the invalid lower case character.' %(Name, self.File))
+                EdkLogger.error('Unicode File Parser', FORMAT_INVALID, 'The string token name %s defined in UNI file %s contains the invalid lower case character.' % (Name, self.File))
         LanguageList = Item.split(u'#language ')
         for IndexI in range(len(LanguageList)):
             if IndexI == 0:
@@ -512,7 +512,7 @@ def LoadUniFile(self, File = None):
                 if not self.IsCompatibleMode and Name != '':
                     MatchString = re.match('[A-Z0-9_]+', Name, re.UNICODE)
                     if MatchString == None or MatchString.end(0) != len(Name):
-                        EdkLogger.error('Unicode File Parser', FORMAT_INVALID, 'The string token name %s defined in UNI file %s contains the invalid lower case character.' %(Name, self.File))
+                        EdkLogger.error('Unicode File Parser', FORMAT_INVALID, 'The string token name %s defined in UNI file %s contains the invalid lower case character.' % (Name, self.File))
                 self.AddStringToList(Name, Language, Value)
                 continue
 
@@ -571,7 +571,7 @@ def AddStringToList(self, Name, Language, Value, Token = None, Referenced = Fals
                 ItemIndexInList = self.OrderedStringDict[Language][Name]
                 Item = self.OrderedStringList[Language][ItemIndexInList]
                 Item.UpdateValue(Value)
-                Item.UseOtherLangDef = ''   
+                Item.UseOtherLangDef = ''
 
         if IsAdded:
             Token = len(self.OrderedStringList[Language])
diff --git a/BaseTools/Source/Python/BPDG/GenVpd.py b/BaseTools/Source/Python/BPDG/GenVpd.py
index 76d30fa6ff49..d1da99fe5faa 100644
--- a/BaseTools/Source/Python/BPDG/GenVpd.py
+++ b/BaseTools/Source/Python/BPDG/GenVpd.py
@@ -48,19 +48,19 @@ def __init__(self, PcdCName, SkuId,PcdOffset, PcdSize, PcdValue, Lineno=None, Fi
         self.PcdBinSize     = PcdBinSize
         
         if self.PcdValue == '' :
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid PCD format(Name: %s File: %s line: %s) , no Value specified!" %(self.PcdCName, self.FileName, self.Lineno))
-                         
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid PCD format(Name: %s File: %s line: %s) , no Value specified!" % (self.PcdCName, self.FileName, self.Lineno))
+
         if self.PcdOffset == '' :
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid PCD format(Name: %s File: %s Line: %s) , no Offset specified!" %(self.PcdCName, self.FileName, self.Lineno))
-            
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid PCD format(Name: %s File: %s Line: %s) , no Offset specified!" % (self.PcdCName, self.FileName, self.Lineno))
+
         if self.PcdSize == '' :
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid PCD format(Name: %s File: %s Line: %s), no PcdSize specified!" %(self.PcdCName, self.FileName, self.Lineno))  
-                   
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid PCD format(Name: %s File: %s Line: %s), no PcdSize specified!" % (self.PcdCName, self.FileName, self.Lineno))
+
         self._GenOffsetValue ()
-    
+
     ## Analyze the string value to judge the PCD's datum type euqal to Boolean or not.
     # 
     #  @param   ValueString      PCD's value
@@ -74,10 +74,10 @@ def _IsBoolean(self, ValueString, Size):
             if ValueString.upper() in ["TRUE", "FALSE"]:
                 return True
             elif ValueString in ["0", "1", "0x0", "0x1", "0x00", "0x01"]:
-                return True 
-        
+                return True
+
         return False
-    
+
     ## Convert the PCD's value from string to integer.
     #              
     #  This function will try to convert the Offset value form string to integer
@@ -91,9 +91,9 @@ def _GenOffsetValue(self):
                 try:
                     self.PcdBinOffset = int(self.PcdOffset, 16)
                 except:
-                    EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                    "Invalid offset value %s for PCD %s (File: %s Line: %s)" % (self.PcdOffset, self.PcdCName, self.FileName, self.Lineno))                                  
-    
+                    EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                    "Invalid offset value %s for PCD %s (File: %s Line: %s)" % (self.PcdOffset, self.PcdCName, self.FileName, self.Lineno))
+
     ## Pack Boolean type VPD PCD's value form string to binary type.
     # 
     #  @param ValueString     The boolean type string for pack.
@@ -101,18 +101,18 @@ def _GenOffsetValue(self):
     # 
     def _PackBooleanValue(self, ValueString):
         if ValueString.upper() == "TRUE" or ValueString in ["1", "0x1", "0x01"]:
-            try:    
-                self.PcdValue =  pack(_FORMAT_CHAR[1], 1)
+            try:
+                self.PcdValue = pack(_FORMAT_CHAR[1], 1)
             except:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))                 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))
         else:
             try:
-                self.PcdValue =  pack(_FORMAT_CHAR[1], 0)
+                self.PcdValue = pack(_FORMAT_CHAR[1], 0)
             except:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno)) 
-                     
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))
+
     ## Pack Integer type VPD PCD's value form string to binary type.
     # 
     #  @param ValueString     The Integer type string for pack.
@@ -120,46 +120,46 @@ def _PackBooleanValue(self, ValueString):
     #                                
     def _PackIntValue(self, IntValue, Size):
         if Size not in _FORMAT_CHAR.keys():
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid size %d for PCD %s in integer datum size(File: %s Line: %s)." % (Size, self.PcdCName, self.FileName, self.Lineno))        
-        
-        if Size == 1:            
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid size %d for PCD %s in integer datum size(File: %s Line: %s)." % (Size, self.PcdCName, self.FileName, self.Lineno))
+
+        if Size == 1:
             if IntValue < 0:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "PCD can't be set to negative value %d for PCD %s in UINT8 datum type(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
             elif IntValue >= 0x100:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                "Too large PCD value %d for datum type UINT8 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))                             
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                "Too large PCD value %d for datum type UINT8 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
         elif Size == 2:
             if IntValue < 0:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "PCD can't be set to negative value %d for PCD %s in UINT16 datum type(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
             elif IntValue >= 0x10000:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                "Too large PCD value %d for datum type UINT16 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno)) 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                "Too large PCD value %d for datum type UINT16 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
         elif Size == 4:
             if IntValue < 0:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "PCD can't be set to negative value %d for PCD %s in UINT32 datum type(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
             elif IntValue >= 0x100000000:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "Too large PCD value %d for datum type UINT32 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
         elif Size == 8:
             if IntValue < 0:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "PCD can't be set to negative value %d for PCD %s in UINT32 datum type(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
             elif IntValue >= 0x10000000000000000:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "Too large PCD value %d for datum type UINT32 for PCD %s(File: %s Line: %s)." % (IntValue, self.PcdCName, self.FileName, self.Lineno))
         else:
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid size %d for PCD %s in integer datum size(File: %s Line: %s)." % (Size, self.PcdCName, self.FileName, self.Lineno))              
-        
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid size %d for PCD %s in integer datum size(File: %s Line: %s)." % (Size, self.PcdCName, self.FileName, self.Lineno))
+
         try:
-            self.PcdValue =  pack(_FORMAT_CHAR[Size], IntValue)
+            self.PcdValue = pack(_FORMAT_CHAR[Size], IntValue)
         except:
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))                
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))
 
     ## Pack VOID* type VPD PCD's value form string to binary type.
     #
@@ -178,53 +178,53 @@ def _PackPtrValue(self, ValueString, Size):
         elif ValueString.startswith('"') and ValueString.endswith('"'):
             self._PackString(ValueString, Size)
         else:
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid VOID* type PCD %s value %s (File: %s Line: %s)" % (self.PcdCName, ValueString, self.FileName, self.Lineno)) 
-            
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid VOID* type PCD %s value %s (File: %s Line: %s)" % (self.PcdCName, ValueString, self.FileName, self.Lineno))
+
     ## Pack an Ascii PCD value.
     #  
     #  An Ascii string for a PCD should be in format as  "".
     #                   
     def _PackString(self, ValueString, Size):
         if (Size < 0):
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                             "Invalid parameter Size %s of PCD %s!(File: %s Line: %s)" % (self.PcdBinSize, self.PcdCName, self.FileName, self.Lineno))
         if (ValueString == ""):
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter ValueString %s of PCD %s!(File: %s Line: %s)" % (self.PcdUnpackValue, self.PcdCName, self.FileName, self.Lineno))        
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter ValueString %s of PCD %s!(File: %s Line: %s)" % (self.PcdUnpackValue, self.PcdCName, self.FileName, self.Lineno))
         if (len(ValueString) < 2):
             EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "For PCD: %s ,ASCII string %s at least contains two!(File: %s Line: %s)" % (self.PcdCName, self.PcdUnpackValue, self.FileName, self.Lineno))
-        
+
         ValueString = ValueString[1:-1]
         if len(ValueString) + 1 > Size:
-            EdkLogger.error("BPDG", BuildToolError.RESOURCE_OVERFLOW, 
+            EdkLogger.error("BPDG", BuildToolError.RESOURCE_OVERFLOW,
                             "PCD value string %s is exceed to size %d(File: %s Line: %s)" % (ValueString, Size, self.FileName, self.Lineno))
         try:
-            self.PcdValue=  pack('%ds' % Size, ValueString)
+            self.PcdValue = pack('%ds' % Size, ValueString)
         except:
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                            "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))   
-                           
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                            "Invalid size or value for PCD %s to pack(File: %s Line: %s)." % (self.PcdCName, self.FileName, self.Lineno))
+
     ## Pack a byte-array PCD value.
     #  
     #  A byte-array for a PCD should be in format as  {0x01, 0x02, ...}.
     #         
     def _PackByteArray(self, ValueString, Size):
-        if (Size < 0):        
+        if (Size < 0):
             EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter Size %s of PCD %s!(File: %s Line: %s)" % (self.PcdBinSize, self.PcdCName, self.FileName, self.Lineno))
         if (ValueString == ""):
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter ValueString %s of PCD %s!(File: %s Line: %s)" % (self.PcdUnpackValue, self.PcdCName, self.FileName, self.Lineno)) 
-        
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter ValueString %s of PCD %s!(File: %s Line: %s)" % (self.PcdUnpackValue, self.PcdCName, self.FileName, self.Lineno))
+
         ValueString = ValueString.strip()
         ValueString = ValueString.lstrip('{').strip('}')
         ValueList = ValueString.split(',')
         ValueList = [item.strip() for item in ValueList]
-        
+
         if len(ValueList) > Size:
-            EdkLogger.error("BPDG", BuildToolError.RESOURCE_OVERFLOW, 
+            EdkLogger.error("BPDG", BuildToolError.RESOURCE_OVERFLOW,
                             "The byte array %s is too large for size %d(File: %s Line: %s)" % (ValueString, Size, self.FileName, self.Lineno))
-        
+
         ReturnArray = array.array('B')
-        
+
         for Index in xrange(len(ValueList)):
             Value = None
             if ValueList[Index].lower().startswith('0x'):
@@ -232,7 +232,7 @@ def _PackByteArray(self, ValueString, Size):
                 try:
                     Value = int(ValueList[Index], 16)
                 except:
-                    EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                    EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                     "The value item %s in byte array %s is an invalid HEX value.(File: %s Line: %s)" % \
                                     (ValueList[Index], ValueString, self.FileName, self.Lineno))
             else:
@@ -243,52 +243,52 @@ def _PackByteArray(self, ValueString, Size):
                     EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                     "The value item %s in byte array %s is an invalid DECIMAL value.(File: %s Line: %s)" % \
                                     (ValueList[Index], ValueString, self.FileName, self.Lineno))
-            
+
             if Value > 255:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
-                                "The value item %s in byte array %s do not in range 0 ~ 0xFF(File: %s Line: %s)" %\
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
+                                "The value item %s in byte array %s do not in range 0 ~ 0xFF(File: %s Line: %s)" % \
                                 (ValueList[Index], ValueString, self.FileName, self.Lineno))
-             
+
             ReturnArray.append(Value)
-            
+
         for Index in xrange(len(ValueList), Size):
             ReturnArray.append(0)
-        
-        self.PcdValue =  ReturnArray.tolist()
+
+        self.PcdValue = ReturnArray.tolist()
 
     ## Pack a unicode PCD value into byte array.
     #  
     #  A unicode string for a PCD should be in format as  L"".
     #
     def _PackUnicode(self, UnicodeString, Size):
-        if (Size < 0):        
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter Size %s of PCD %s!(File: %s Line: %s)" %\
+        if (Size < 0):
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid parameter Size %s of PCD %s!(File: %s Line: %s)" % \
                              (self.PcdBinSize, self.PcdCName, self.FileName, self.Lineno))
         if (len(UnicodeString) < 3):
-            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "For PCD: %s ,ASCII string %s at least contains two!(File: %s Line: %s)" %\
+            EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "For PCD: %s ,ASCII string %s at least contains two!(File: %s Line: %s)" % \
                             (self.PcdCName, self.PcdUnpackValue, self.FileName, self.Lineno))
-        
+
         UnicodeString = UnicodeString[2:-1]
-        
+
         if (len(UnicodeString) + 1) * 2 > Size:
             EdkLogger.error("BPDG", BuildToolError.RESOURCE_OVERFLOW,
                             "The size of unicode string %s is too larger for size %s(File: %s Line: %s)" % \
                             (UnicodeString, Size, self.FileName, self.Lineno))
-            
+
         ReturnArray = array.array('B')
         for Value in UnicodeString:
             try:
                 ReturnArray.append(ord(Value))
                 ReturnArray.append(0)
             except:
-                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, 
+                EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID,
                                 "Invalid unicode character %s in unicode string %s(File: %s Line: %s)" % \
                                 (Value, UnicodeString, self.FileName, self.Lineno))
-                
+
         for Index in xrange(len(UnicodeString) * 2, Size):
             ReturnArray.append(0)
-            
-        self.PcdValue =  ReturnArray.tolist()    
+
+        self.PcdValue = ReturnArray.tolist()
 
 
 
@@ -300,7 +300,7 @@ def _PackUnicode(self, UnicodeString, Size):
 #       3. Fixed offset if needed;
 #       4. Generate output file, including guided.map and guided.bin file;
 #        
-class GenVPD :    
+class GenVPD :
     ## Constructor of DscBuildData
     #
     #  Initialize object of GenVPD
@@ -322,47 +322,47 @@ def __init__(self, InputFileName, MapFileName, VpdFileName):
             try:
                 self.FileLinesList = fInputfile.readlines()
             except:
-                EdkLogger.error("BPDG", BuildToolError.FILE_READ_FAILURE, "File read failed for %s" %InputFileName,None)
+                EdkLogger.error("BPDG", BuildToolError.FILE_READ_FAILURE, "File read failed for %s" % InputFileName, None)
             finally:
                 fInputfile.close()
         except:
-            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" %InputFileName,None)
-    
+            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" % InputFileName, None)
+
     ##
     # Parser the input file which is generated by the build tool. Convert the value of each pcd's 
     # from string to it's real format. Also remove the useless line in the input file.
     # 
     def ParserInputFile (self):
-        count = 0        
+        count = 0
         for line in self.FileLinesList:
             # Strip "\r\n" generated by readlines ().
             line = line.strip()
             line = line.rstrip(os.linesep)
-                       
+
             # Skip the comment line
             if (not line.startswith("#")) and len(line) > 1 :
                 #
                 # Enhanced for support "|" character in the string.
                 #
                 ValueList = ['', '', '', '','']    
-                
-                ValueRe  = re.compile(r'\s*L?\".*\|.*\"\s*$')
+
+                ValueRe = re.compile(r'\s*L?\".*\|.*\"\s*$')
                 PtrValue = ValueRe.findall(line)
-                
+
                 ValueUpdateFlag = False
-                
+
                 if len(PtrValue) >= 1:
                     line = re.sub(ValueRe, '', line)
-                    ValueUpdateFlag = True   
-            
+                    ValueUpdateFlag = True
+
                 TokenList = line.split('|')
                 ValueList[0:len(TokenList)] = TokenList
-                
+
                 if ValueUpdateFlag:
                     ValueList[4] = PtrValue[0]                              
                 self.FileLinesList[count] = ValueList
                 # Store the line number
-                self.FileLinesList[count].append(str(count+1))
+                self.FileLinesList[count].append(str(count + 1))
             elif len(line) <= 1 :
                 # Set the blank line to "None"
                 self.FileLinesList[count] = None
@@ -370,9 +370,9 @@ def ParserInputFile (self):
                 # Set the comment line to "None"
                 self.FileLinesList[count] = None
             count += 1
-            
+
         # The line count contain usage information
-        count = 0     
+        count = 0
         # Delete useless lines
         while (True) :
             try :
@@ -381,18 +381,18 @@ def ParserInputFile (self):
                 else :
                     count += 1
             except :
-                break     
+                break
         #
         # After remove the useless line, if there are no data remain in the file line list,
         # Report warning messages to user's.
         # 
         if len(self.FileLinesList) == 0 :
-            EdkLogger.warn('BPDG', BuildToolError.RESOURCE_NOT_AVAILABLE, 
+            EdkLogger.warn('BPDG', BuildToolError.RESOURCE_NOT_AVAILABLE,
                            "There are no VPD type pcds defined in DSC file, Please check it.")
-                      
+
         # Process the pcds one by one base on the pcd's value and size
         count = 0
-        for line in self.FileLinesList:        
+        for line in self.FileLinesList:
             if line != None :
                 PCD = PcdEntry(line[0], line[1], line[2], line[3], line[4],line[5], self.InputFileName)   
                 # Strip the space char
@@ -421,7 +421,7 @@ def ParserInputFile (self):
                         PCD.PcdBinSize = PackSize
                     except:
                         EdkLogger.error("BPDG", BuildToolError.FORMAT_INVALID, "Invalid PCD size value %s at file: %s line: %s" % (PCD.PcdSize, self.InputFileName, PCD.Lineno))
-                    
+
                 if PCD._IsBoolean(PCD.PcdValue, PCD.PcdSize):
                     PCD._PackBooleanValue(PCD.PcdValue)
                     self.FileLinesList[count] = PCD
@@ -431,7 +431,7 @@ def ParserInputFile (self):
                 # Try to translate value to an integer firstly.
                 #
                 IsInteger = True
-                PackValue  = None
+                PackValue = None
                 try:
                     PackValue = int(PCD.PcdValue)
                 except:
@@ -439,23 +439,23 @@ def ParserInputFile (self):
                         PackValue = int(PCD.PcdValue, 16)
                     except:
                         IsInteger = False
-                
+
                 if IsInteger:
                     PCD._PackIntValue(PackValue, PackSize)
                 else:
                     PCD._PackPtrValue(PCD.PcdValue, PackSize)
-                    
+
                 self.FileLinesList[count] = PCD
                 count += 1
             else :
                 continue
-            
+
     ##
     # This function used to create a clean list only contain useful information and reorganized to make it 
     # easy to be sorted
     #
     def FormatFileLine (self) :
-             
+
         for eachPcd in self.FileLinesList :
             if eachPcd.PcdOffset != '*' :
                 # Use pcd's Offset value as key, and pcd's Value as value 
@@ -463,43 +463,43 @@ def FormatFileLine (self) :
             else :
                 # Use pcd's CName as key, and pcd's Size as value
                 self.PcdUnknownOffsetList.append(eachPcd)
-                                        
-                            
+
+
     ##
     # This function is use to fix the offset value which the not specified in the map file.
     # Usually it use the star (meaning any offset) character in the offset field
     #    
-    def FixVpdOffset (self):        
+    def FixVpdOffset (self):
         # At first, the offset should start at 0
         # Sort fixed offset list in order to find out where has free spaces for the pcd's offset
         # value is "*" to insert into.      
-        
-        self.PcdFixedOffsetSizeList.sort(lambda x,y: cmp(x.PcdBinOffset, y.PcdBinOffset))                            
-                
+
+        self.PcdFixedOffsetSizeList.sort(lambda x, y: cmp(x.PcdBinOffset, y.PcdBinOffset))
+
         #
         # Sort the un-fixed pcd's offset by it's size.
         #
-        self.PcdUnknownOffsetList.sort(lambda x,y: cmp(x.PcdBinSize, y.PcdBinSize))
-        
+        self.PcdUnknownOffsetList.sort(lambda x, y: cmp(x.PcdBinSize, y.PcdBinSize))
+
         #
         # Process all Offset value are "*"
         #
         if (len(self.PcdFixedOffsetSizeList) == 0) and (len(self.PcdUnknownOffsetList) != 0) :
             # The offset start from 0
             NowOffset = 0
-            for Pcd in self.PcdUnknownOffsetList :                
+            for Pcd in self.PcdUnknownOffsetList :
                 Pcd.PcdBinOffset = NowOffset
                 Pcd.PcdOffset    = str(hex(Pcd.PcdBinOffset))
                 NowOffset       += Pcd.PcdBinSize
                 
             self.PcdFixedOffsetSizeList = self.PcdUnknownOffsetList
             return
-                         
+
         # Check the offset of VPD type pcd's offset start from 0.    
-        if self.PcdFixedOffsetSizeList[0].PcdBinOffset  != 0 :
+        if self.PcdFixedOffsetSizeList[0].PcdBinOffset != 0 :
             EdkLogger.warn("BPDG", "The offset of VPD type pcd should start with 0, please check it.",
-                            None)  
-            
+                            None)
+
         # Judge whether the offset in fixed pcd offset list is overlapped or not.
         lenOfList = len(self.PcdFixedOffsetSizeList)
         count     = 0                       
@@ -508,22 +508,22 @@ def FixVpdOffset (self):
             PcdNext = self.PcdFixedOffsetSizeList[count+1]
             # Two pcd's offset is same            
             if PcdNow.PcdBinOffset == PcdNext.PcdBinOffset :
-                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE, 
-                                "The offset of %s at line: %s is same with %s at line: %s in file %s" %\
+                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE,
+                                "The offset of %s at line: %s is same with %s at line: %s in file %s" % \
                                 (PcdNow.PcdCName, PcdNow.Lineno, PcdNext.PcdCName, PcdNext.Lineno, PcdNext.FileName),
                                 None)
-            
+
             # Overlapped   
             if PcdNow.PcdBinOffset + PcdNow.PcdBinSize > PcdNext.PcdBinOffset :
-                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE, 
-                                "The offset of %s at line: %s is overlapped with %s at line: %s in file %s" %\
+                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE,
+                                "The offset of %s at line: %s is overlapped with %s at line: %s in file %s" % \
                                 (PcdNow.PcdCName, PcdNow.Lineno, PcdNext.PcdCName, PcdNext.Lineno, PcdNext.FileName),
                                 None)
-                
+
             # Has free space, raise a warning message   
             if PcdNow.PcdBinOffset + PcdNow.PcdBinSize < PcdNext.PcdBinOffset :
-                EdkLogger.warn("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE, 
-                               "The offsets have free space of between %s at line: %s and %s at line: %s in file %s" %\
+                EdkLogger.warn("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE,
+                               "The offsets have free space of between %s at line: %s and %s at line: %s in file %s" % \
                                (PcdNow.PcdCName, PcdNow.Lineno, PcdNext.PcdCName, PcdNext.Lineno, PcdNext.FileName),
                                 None)
             count += 1
@@ -545,7 +545,7 @@ def FixVpdOffset (self):
             if LastOffset < NowOffset :
                 if lenOfUnfixedList != 0 :
                     countOfUnfixedList = 0
-                    while(countOfUnfixedList < lenOfUnfixedList) :                   
+                    while(countOfUnfixedList < lenOfUnfixedList) :
                         eachUnfixedPcd      = self.PcdUnknownOffsetList[countOfUnfixedList]
                         needFixPcdSize      = eachUnfixedPcd.PcdBinSize
                         # Not been fixed
@@ -586,8 +586,8 @@ def FixVpdOffset (self):
                 FixOffsetSizeListCount += 1
             # Usually it will not enter into this thunk, if so, means it overlapped. 
             else :
-                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_NOT_AVAILABLE, 
-                                "The offset value definition has overlapped at pcd: %s, it's offset is: %s, in file: %s line: %s" %\
+                EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_NOT_AVAILABLE,
+                                "The offset value definition has overlapped at pcd: %s, it's offset is: %s, in file: %s line: %s" % \
                                 (eachFixedPcd.PcdCName, eachFixedPcd.PcdOffset, eachFixedPcd.InputFileName, eachFixedPcd.Lineno),
                                 None)
                 FixOffsetSizeListCount += 1
@@ -618,46 +618,46 @@ def GenerateVpdFile (self, MapFileName, BinFileName):
         #Open an VPD file to process
 
         try:
-            fVpdFile  = open (BinFileName, "wb", 0)               
+            fVpdFile = open(BinFileName, "wb", 0)
         except:
             # Open failed
-            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" %self.VpdFileName,None)
-        
+            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" % self.VpdFileName, None)
+
         try :
-            fMapFile  = open (MapFileName, "w", 0)
+            fMapFile = open(MapFileName, "w", 0)
         except:
             # Open failed
-            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" %self.MapFileName,None)
-        
+            EdkLogger.error("BPDG", BuildToolError.FILE_OPEN_FAILURE, "File open failed for %s" % self.MapFileName, None)
+
         # Use a instance of StringIO to cache data
-        fStringIO = StringIO.StringIO('') 
-        
+        fStringIO = StringIO.StringIO('')
+
         # Write the header of map file.
         try :
             fMapFile.write (st.MAP_FILE_COMMENT_TEMPLATE + "\n")
         except:
-            EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." %self.MapFileName,None)  
-                  
+            EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." % self.MapFileName, None)
+
         for eachPcd in self.PcdFixedOffsetSizeList  :
             # write map file
             try :
                 fMapFile.write("%s | %s | %s | %s | %s  \n" % (eachPcd.PcdCName, eachPcd.SkuId,eachPcd.PcdOffset, eachPcd.PcdSize,eachPcd.PcdUnpackValue))
             except:
-                EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." %self.MapFileName,None)                                                                      
-                         
+                EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." % self.MapFileName, None)
+
             # Write Vpd binary file
-            fStringIO.seek (eachPcd.PcdBinOffset)          
+            fStringIO.seek (eachPcd.PcdBinOffset)
             if isinstance(eachPcd.PcdValue, list):
                 ValueList = [chr(Item) for Item in eachPcd.PcdValue]
-                fStringIO.write(''.join(ValueList))      
-            else:                 
+                fStringIO.write(''.join(ValueList))
+            else:
                 fStringIO.write (eachPcd.PcdValue)
-                                           
-        try :  
+
+        try :
             fVpdFile.write (fStringIO.getvalue())
         except:
-            EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." %self.VpdFileName,None)
-        
+            EdkLogger.error("BPDG", BuildToolError.FILE_WRITE_FAILURE, "Write data to file %s failed, please check whether the file been locked or using by other applications." % self.VpdFileName, None)
+
         fStringIO.close ()
         fVpdFile.close ()
         fMapFile.close ()
diff --git a/BaseTools/Source/Python/Common/Dictionary.py b/BaseTools/Source/Python/Common/Dictionary.py
index 5300a5456c1e..1c33fefabf98 100644
--- a/BaseTools/Source/Python/Common/Dictionary.py
+++ b/BaseTools/Source/Python/Common/Dictionary.py
@@ -27,19 +27,19 @@
 #
 def ConvertTextFileToDictionary(FileName, Dictionary, CommentCharacter, KeySplitCharacter, ValueSplitFlag, ValueSplitCharacter):
     try:
-        F = open(FileName,'r')
+        F = open(FileName, 'r')
         Keys = []
         for Line in F:
             if Line.startswith(CommentCharacter):
                 continue
-            LineList = Line.split(KeySplitCharacter,1)
+            LineList = Line.split(KeySplitCharacter, 1)
             if len(LineList) >= 2:
                 Key = LineList[0].split()
             if len(Key) == 1 and Key[0][0] != CommentCharacter and Key[0] not in Keys:
                 if ValueSplitFlag:
-                    Dictionary[Key[0]] = LineList[1].replace('\\','/').split(ValueSplitCharacter)
+                    Dictionary[Key[0]] = LineList[1].replace('\\', '/').split(ValueSplitCharacter)
                 else:
-                    Dictionary[Key[0]] = LineList[1].strip().replace('\\','/')
+                    Dictionary[Key[0]] = LineList[1].strip().replace('\\', '/')
                 Keys += [Key[0]]
         F.close()
         return 0
diff --git a/BaseTools/Source/Python/Common/EdkIIWorkspace.py b/BaseTools/Source/Python/Common/EdkIIWorkspace.py
index 401efeef3c94..f22a545b77ce 100644
--- a/BaseTools/Source/Python/Common/EdkIIWorkspace.py
+++ b/BaseTools/Source/Python/Common/EdkIIWorkspace.py
@@ -59,7 +59,7 @@ def __init__(self):
             #
             # Load TianoCoreOrgLogo, used for GUI tool
             #
-            self.Icon = wx.Icon(self.WorkspaceFile('tools/Python/TianoCoreOrgLogo.gif'),wx.BITMAP_TYPE_GIF)
+            self.Icon = wx.Icon(self.WorkspaceFile('tools/Python/TianoCoreOrgLogo.gif'), wx.BITMAP_TYPE_GIF)
         except:
             self.Icon = None
             
@@ -151,7 +151,7 @@ def XmlParseFile (self, FileName):
     def XmlParseFileSection (self, FileName, SectionTag):
         if self.Verbose:
             print FileName
-        return XmlParseFileSection (self.WorkspaceFile(FileName), SectionTag)        
+        return XmlParseFileSection (self.WorkspaceFile(FileName), SectionTag)
 
     ## Save a XML file
     #
@@ -219,19 +219,19 @@ def ConvertDictionaryToTextFile(self, FileName, Dictionary, CommentCharacter, Ke
 #
 def ConvertTextFileToDictionary(FileName, Dictionary, CommentCharacter, KeySplitCharacter, ValueSplitFlag, ValueSplitCharacter):
     try:
-        F = open(FileName,'r')
+        F = open(FileName, 'r')
     except:
         return False
     Keys = []
     for Line in F:
-        LineList = Line.split(KeySplitCharacter,1)
+        LineList = Line.split(KeySplitCharacter, 1)
         if len(LineList) >= 2:
             Key = LineList[0].split()
-            if len(Key) == 1 and Key[0][0] != CommentCharacter and Key[0] not in Keys: 
+            if len(Key) == 1 and Key[0][0] != CommentCharacter and Key[0] not in Keys:
                 if ValueSplitFlag:
-                    Dictionary[Key[0]] = LineList[1].replace('\\','/').split(ValueSplitCharacter)
+                    Dictionary[Key[0]] = LineList[1].replace('\\', '/').split(ValueSplitCharacter)
                 else:
-                    Dictionary[Key[0]] = LineList[1].strip().replace('\\','/')
+                    Dictionary[Key[0]] = LineList[1].strip().replace('\\', '/')
                 Keys += [Key[0]]
     F.close()
     return True
@@ -252,7 +252,7 @@ def ConvertTextFileToDictionary(FileName, Dictionary, CommentCharacter, KeySplit
 #
 def ConvertDictionaryToTextFile(FileName, Dictionary, CommentCharacter, KeySplitCharacter, ValueSplitFlag, ValueSplitCharacter):
     try:
-        F = open(FileName,'r')
+        F = open(FileName, 'r')
         Lines = []
         Lines = F.readlines()
         F.close()
@@ -265,7 +265,7 @@ def ConvertDictionaryToTextFile(FileName, Dictionary, CommentCharacter, KeySplit
             MaxLength = len(Key)
     Index = 0
     for Line in Lines:
-        LineList = Line.split(KeySplitCharacter,1)
+        LineList = Line.split(KeySplitCharacter, 1)
         if len(LineList) >= 2:
             Key = LineList[0].split()
             if len(Key) == 1 and Key[0][0] != CommentCharacter and Key[0] in Dictionary:
@@ -275,17 +275,17 @@ def ConvertDictionaryToTextFile(FileName, Dictionary, CommentCharacter, KeySplit
                     Line = '%-*s %c %s\n' % (MaxLength, Key[0], KeySplitCharacter, Dictionary[Key[0]])
                 Lines.pop(Index)
                 if Key[0] in Keys:
-                    Lines.insert(Index,Line)
+                    Lines.insert(Index, Line)
                     Keys.remove(Key[0])
         Index += 1
     for RemainingKey in Keys:
         if ValueSplitFlag:
-            Line = '%-*s %c %s\n' % (MaxLength, RemainingKey, KeySplitCharacter,' '.join(Dictionary[RemainingKey])) 
+            Line = '%-*s %c %s\n' % (MaxLength, RemainingKey, KeySplitCharacter, ' '.join(Dictionary[RemainingKey]))
         else:
             Line = '%-*s %c %s\n' % (MaxLength, RemainingKey, KeySplitCharacter, Dictionary[RemainingKey])
         Lines.append(Line)
     try:
-        F = open(FileName,'w')
+        F = open(FileName, 'w')
     except:
         return False
     F.writelines(Lines)
diff --git a/BaseTools/Source/Python/Common/FdfParserLite.py b/BaseTools/Source/Python/Common/FdfParserLite.py
index a0ee249748e1..a8cce261202e 100644
--- a/BaseTools/Source/Python/Common/FdfParserLite.py
+++ b/BaseTools/Source/Python/Common/FdfParserLite.py
@@ -69,8 +69,8 @@ class Warning (Exception):
     #   @param  File        The FDF name
     #   @param  Line        The Line number that error occurs
     #
-    def __init__(self, Str, File = None, Line = None):
-        
+    def __init__(self, Str, File=None, Line=None):
+
         FileLineTuple = GetRealFileLine(File, Line)
         self.FileName = FileLineTuple[0]
         self.LineNumber = FileLineTuple[1]
@@ -359,8 +359,8 @@ def __ReplaceMacros(self, Str, File, Line):
             else:
                 raise Warning("Macro not complete At Line ", self.FileName, self.CurrentLineNumber)
         return Str
-    
-    def __ReplaceFragment(self, StartPos, EndPos, Value = ' '):
+
+    def __ReplaceFragment(self, StartPos, EndPos, Value=' '):
         if StartPos[0] == EndPos[0]:
             Offset = StartPos[1]
             while Offset <= EndPos[1]:
diff --git a/BaseTools/Source/Python/Common/MigrationUtilities.py b/BaseTools/Source/Python/Common/MigrationUtilities.py
index 6d6669d7ae57..e9f1cabcb794 100644
--- a/BaseTools/Source/Python/Common/MigrationUtilities.py
+++ b/BaseTools/Source/Python/Common/MigrationUtilities.py
@@ -423,7 +423,7 @@ def StoreHeader(TextFile, CommonHeader):
     Description = CommonHeader.Description
     License = CommonHeader.License
 
-    Header =  "#/** @file\n#\n"
+    Header = "#/** @file\n#\n"
     Header += "# " + Abstract + "\n#\n"
     Header += "# " + Description.strip().replace("\n", "\n# ") + "\n"
     Header += "# " + CopyRight + "\n#\n"
@@ -519,7 +519,7 @@ def GetXmlFileInfo(FileName, TagTuple):
 # @retval Options            A optparse object containing the parsed options.
 # @retval InputFile          Path of an source file to be migrated.
 #
-def MigrationOptionParser(Source, Destinate, ToolName, VersionNumber = 1.0):
+def MigrationOptionParser(Source, Destinate, ToolName, VersionNumber=1.0):
     # use clearer usage to override default usage message
     UsageString = "%s [-a] [-v|-q] [-o <output_file>] <input_file>" % ToolName
     Version = "%s Version %.2f" % (ToolName, VersionNumber)
diff --git a/BaseTools/Source/Python/Common/Misc.py b/BaseTools/Source/Python/Common/Misc.py
index 0eedddc86125..777450d81860 100644
--- a/BaseTools/Source/Python/Common/Misc.py
+++ b/BaseTools/Source/Python/Common/Misc.py
@@ -38,7 +38,7 @@
 from Common.MultipleWorkspace import MultipleWorkspace as mws
 
 ## Regular expression used to find out place holders in string template
-gPlaceholderPattern = re.compile("\$\{([^$()\s]+)\}", re.MULTILINE|re.UNICODE)
+gPlaceholderPattern = re.compile("\$\{([^$()\s]+)\}", re.MULTILINE | re.UNICODE)
 
 ## Dictionary used to store file time stamp for quick re-access
 gFileTimeStampCache = {}    # {file path : file time stamp}
@@ -293,11 +293,11 @@ def ProcessVariableArgument(Option, OptionString, Value, Parser):
 def GuidStringToGuidStructureString(Guid):
     GuidList = Guid.split('-')
     Result = '{'
-    for Index in range(0,3,1):
+    for Index in range(0, 3, 1):
         Result = Result + '0x' + GuidList[Index] + ', '
     Result = Result + '{0x' + GuidList[3][0:2] + ', 0x' + GuidList[3][2:4]
-    for Index in range(0,12,2):
-        Result = Result + ', 0x' + GuidList[4][Index:Index+2]
+    for Index in range(0, 12, 2):
+        Result = Result + ', 0x' + GuidList[4][Index:Index + 2]
     Result += '}}'
     return Result
 
@@ -494,7 +494,7 @@ def SaveFileOnChange(File, Content, IsBinaryFile=True):
             Fd.write(Content)
             Fd.close()
     except IOError, X:
-        EdkLogger.error(None, FILE_CREATE_FAILURE, ExtraData='IOError %s'%X)
+        EdkLogger.error(None, FILE_CREATE_FAILURE, ExtraData='IOError %s' % X)
 
     return True
 
@@ -613,7 +613,7 @@ def __getitem__(self, Path):
 #
 # @retval  A list of all files
 #
-def GetFiles(Root, SkipList=None, FullPath = True):
+def GetFiles(Root, SkipList=None, FullPath=True):
     OriPath = Root
     FileList = []
     for Root, Dirs, Files in os.walk(Root):
@@ -663,7 +663,7 @@ def RealPath2(File, Dir='', OverrideDir=''):
             if OverrideDir[-1] == os.path.sep:
                 return NewFile[len(OverrideDir):], NewFile[0:len(OverrideDir)]
             else:
-                return NewFile[len(OverrideDir)+1:], NewFile[0:len(OverrideDir)]
+                return NewFile[len(OverrideDir) + 1:], NewFile[0:len(OverrideDir)]
     if GlobalData.gAllFiles:
         NewFile = GlobalData.gAllFiles[os.path.normpath(os.path.join(Dir, File))]
     if not NewFile:
@@ -675,7 +675,7 @@ def RealPath2(File, Dir='', OverrideDir=''):
             if Dir[-1] == os.path.sep:
                 return NewFile[len(Dir):], NewFile[0:len(Dir)]
             else:
-                return NewFile[len(Dir)+1:], NewFile[0:len(Dir)]
+                return NewFile[len(Dir) + 1:], NewFile[0:len(Dir)]
         else:
             return NewFile, ''
 
@@ -701,7 +701,7 @@ def ValidFile2(AllFiles, File, Ext=None, Workspace='', EfiSource='', EdkSource='
     # Replace the default dir to current dir
     if Dir == '.':
         Dir = os.getcwd()
-        Dir = Dir[len(Workspace)+1:]
+        Dir = Dir[len(Workspace) + 1:]
 
     # First check if File has Edk definition itself
     if File.find('$(EFI_SOURCE)') > -1 or File.find('$(EDK_SOURCE)') > -1:
@@ -740,7 +740,7 @@ def ValidFile3(AllFiles, File, Workspace='', EfiSource='', EdkSource='', Dir='.'
     # Dir is current module dir related to workspace
     if Dir == '.':
         Dir = os.getcwd()
-        Dir = Dir[len(Workspace)+1:]
+        Dir = Dir[len(Workspace) + 1:]
 
     NewFile = File
     RelaPath = AllFiles[os.path.normpath(Dir)]
@@ -865,7 +865,7 @@ def __init__(self, TemplateSection, PlaceHolderList):
                 #
                 #   PlaceHolderName, PlaceHolderStartPoint, PlaceHolderEndPoint
                 #
-                for PlaceHolder,Start,End in PlaceHolderList:
+                for PlaceHolder, Start, End in PlaceHolderList:
                     self._SubSectionList.append(TemplateSection[SubSectionStart:Start])
                     self._SubSectionList.append(TemplateSection[Start:End])
                     self._PlaceHolderList.append(PlaceHolder)
@@ -1251,11 +1251,11 @@ def __getitem__(self, key):
             if len(key) > 1:
                 RestKeys = key[1:]
             elif self._Level_ > 1:
-                RestKeys = [self._Wildcard for i in range(0, self._Level_-1)]
+                RestKeys = [self._Wildcard for i in range(0, self._Level_ - 1)]
         else:
             FirstKey = key
             if self._Level_ > 1:
-                RestKeys = [self._Wildcard for i in range(0, self._Level_-1)]
+                RestKeys = [self._Wildcard for i in range(0, self._Level_ - 1)]
 
         if FirstKey == None or str(FirstKey).upper() in self._ValidWildcardList:
             FirstKey = self._Wildcard
@@ -1328,11 +1328,11 @@ def __setitem__(self, key, value):
             if len(key) > 1:
                 RestKeys = key[1:]
             else:
-                RestKeys = [self._Wildcard for i in range(0, self._Level_-1)]
+                RestKeys = [self._Wildcard for i in range(0, self._Level_ - 1)]
         else:
             FirstKey = key
             if self._Level_ > 1:
-                RestKeys = [self._Wildcard for i in range(0, self._Level_-1)]
+                RestKeys = [self._Wildcard for i in range(0, self._Level_ - 1)]
 
         if FirstKey in self._ValidWildcardList:
             FirstKey = self._Wildcard
@@ -1437,7 +1437,7 @@ def AnalyzeDscPcd(Setting, PcdType, DataType=''):
             Pair += 1
         elif ch == ')' and not InStr:
             Pair -= 1
-        
+
         if (Pair > 0 or InStr) and ch == TAB_VALUE_SPLIT:
             NewStr += '-'
         else:
@@ -1491,7 +1491,7 @@ def AnalyzeDscPcd(Setting, PcdType, DataType=''):
             IsValid = (len(FieldList) <= 3)
         else:
             IsValid = (len(FieldList) <= 1)
-        return [Value, Type, Size], IsValid, 0 
+        return [Value, Type, Size], IsValid, 0
     elif PcdType in (MODEL_PCD_DYNAMIC_VPD, MODEL_PCD_DYNAMIC_EX_VPD):
         VpdOffset = FieldList[0]
         Value = Size = ''
@@ -1532,17 +1532,17 @@ def AnalyzeDscPcd(Setting, PcdType, DataType=''):
 #  
 #  @retval   ValueList: A List contain value, datum type and toke number. 
 #
-def AnalyzePcdData(Setting):   
-    ValueList = ['', '', '']    
-    
-    ValueRe  = re.compile(r'^\s*L?\".*\|.*\"')
+def AnalyzePcdData(Setting):
+    ValueList = ['', '', '']
+
+    ValueRe = re.compile(r'^\s*L?\".*\|.*\"')
     PtrValue = ValueRe.findall(Setting)
     
     ValueUpdateFlag = False
     
     if len(PtrValue) >= 1:
         Setting = re.sub(ValueRe, '', Setting)
-        ValueUpdateFlag = True   
+        ValueUpdateFlag = True
 
     TokenList = Setting.split(TAB_VALUE_SPLIT)
     ValueList[0:len(TokenList)] = TokenList
@@ -1578,17 +1578,17 @@ def AnalyzeHiiPcdData(Setting):
 #  
 #  @retval   ValueList: A List contain VpdOffset, MaxDatumSize and InitialValue. 
 #
-def AnalyzeVpdPcdData(Setting):   
-    ValueList = ['', '', '']    
-    
-    ValueRe  = re.compile(r'\s*L?\".*\|.*\"\s*$')
+def AnalyzeVpdPcdData(Setting):
+    ValueList = ['', '', '']
+
+    ValueRe = re.compile(r'\s*L?\".*\|.*\"\s*$')
     PtrValue = ValueRe.findall(Setting)
     
     ValueUpdateFlag = False
     
     if len(PtrValue) >= 1:
         Setting = re.sub(ValueRe, '', Setting)
-        ValueUpdateFlag = True   
+        ValueUpdateFlag = True
 
     TokenList = Setting.split(TAB_VALUE_SPLIT)
     ValueList[0:len(TokenList)] = TokenList
@@ -1604,12 +1604,12 @@ def AnalyzeVpdPcdData(Setting):
 #
 def CheckPcdDatum(Type, Value):
     if Type == "VOID*":
-        ValueRe  = re.compile(r'\s*L?\".*\"\s*$')
+        ValueRe = re.compile(r'\s*L?\".*\"\s*$')
         if not (((Value.startswith('L"') or Value.startswith('"')) and Value.endswith('"'))
                 or (Value.startswith('{') and Value.endswith('}'))
                ):
             return False, "Invalid value [%s] of type [%s]; must be in the form of {...} for array"\
-                          ", or \"...\" for string, or L\"...\" for unicode string" % (Value, Type)        
+                          ", or \"...\" for string, or L\"...\" for unicode string" % (Value, Type)
         elif ValueRe.match(Value):
             # Check the chars in UnicodeString or CString is printable
             if Value.startswith("L"):
@@ -1662,7 +1662,7 @@ def SplitOption(OptionString):
 
         if CurrentChar in ["/", "-"] and LastChar in [" ", "\t", "\r", "\n"]:
             if Index > OptionStart:
-                OptionList.append(OptionString[OptionStart:Index-1])
+                OptionList.append(OptionString[OptionStart:Index - 1])
             OptionStart = Index
         LastChar = CurrentChar
     OptionList.append(OptionString[OptionStart:])
@@ -1739,7 +1739,7 @@ def __init__(self, File='', Root='', AlterRoot='', Type='', IsBinary=False,
             if self.Root[-1] == os.path.sep:
                 self.File = self.Path[len(self.Root):]
             else:
-                self.File = self.Path[len(self.Root)+1:]
+                self.File = self.Path[len(self.Root) + 1:]
         else:
             self.Path = os.path.normpath(self.File)
 
diff --git a/BaseTools/Source/Python/Common/ToolDefClassObject.py b/BaseTools/Source/Python/Common/ToolDefClassObject.py
index 4fefbd91e0a0..4d54027820ff 100644
--- a/BaseTools/Source/Python/Common/ToolDefClassObject.py
+++ b/BaseTools/Source/Python/Common/ToolDefClassObject.py
@@ -42,7 +42,7 @@
 # @var MacroDictionary:        To store keys and values defined in DEFINE statement
 #
 class ToolDefClassObject(object):
-    def __init__(self, FileName = None):
+    def __init__(self, FileName=None):
         self.ToolsDefTxtDictionary = {}
         self.MacroDictionary = {}
         for Env in os.environ:
@@ -61,7 +61,7 @@ def LoadToolDefFile(self, FileName):
         FileContent = []
         if os.path.isfile(FileName):
             try:
-                F = open(FileName,'r')
+                F = open(FileName, 'r')
                 FileContent = F.readlines()
             except:
                 EdkLogger.error("tools_def.txt parser", FILE_OPEN_FAILURE, ExtraData=FileName)
@@ -155,7 +155,7 @@ def LoadToolDefFile(self, FileName):
         self.ToolsDefTxtDatabase[TAB_TOD_DEFINES_COMMAND_TYPE].sort()
 
         KeyList = [TAB_TOD_DEFINES_TARGET, TAB_TOD_DEFINES_TOOL_CHAIN_TAG, TAB_TOD_DEFINES_TARGET_ARCH, TAB_TOD_DEFINES_COMMAND_TYPE]
-        for Index in range(3,-1,-1):
+        for Index in range(3, -1, -1):
             for Key in dict(self.ToolsDefTxtDictionary):
                 List = Key.split('_')
                 if List[Index] == '*':
diff --git a/BaseTools/Source/Python/GenFds/GenFds.py b/BaseTools/Source/Python/GenFds/GenFds.py
index a0beff039132..4fa4eda04a5f 100644
--- a/BaseTools/Source/Python/GenFds/GenFds.py
+++ b/BaseTools/Source/Python/GenFds/GenFds.py
@@ -34,7 +34,7 @@
 import Common.GlobalData as GlobalData
 from Common import EdkLogger
 from Common.String import *
-from Common.Misc import DirCache,PathClass
+from Common.Misc import DirCache, PathClass
 from Common.Misc import SaveFileOnChange
 from Common.Misc import ClearDuplicatedInf
 from Common.Misc import GuidStructureStringToGuidString
@@ -93,7 +93,7 @@ def main():
             if 'EDK_SOURCE' in os.environ.keys():
                 GenFdsGlobalVariable.EdkSourceDir = os.path.normcase(os.environ['EDK_SOURCE'])
             if (Options.debug):
-                GenFdsGlobalVariable.VerboseLogger( "Using Workspace:" + Workspace)
+                GenFdsGlobalVariable.VerboseLogger("Using Workspace:" + Workspace)
         os.chdir(GenFdsGlobalVariable.WorkSpaceDir)
         
         # set multiple workspace
@@ -106,7 +106,7 @@ def main():
 
             if FdfFilename[0:2] == '..':
                 FdfFilename = os.path.realpath(FdfFilename)
-            if not os.path.isabs (FdfFilename):
+            if not os.path.isabs(FdfFilename):
                 FdfFilename = mws.join(GenFdsGlobalVariable.WorkSpaceDir, FdfFilename)
             if not os.path.exists(FdfFilename):
                 EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=FdfFilename)
@@ -287,7 +287,7 @@ def main():
         GenFds.DisplayFvSpaceInfo(FdfParserObj)
 
     except FdfParser.Warning, X:
-        EdkLogger.error(X.ToolName, FORMAT_INVALID, File=X.FileName, Line=X.LineNumber, ExtraData=X.Message, RaiseError = False)
+        EdkLogger.error(X.ToolName, FORMAT_INVALID, File=X.FileName, Line=X.LineNumber, ExtraData=X.Message, RaiseError=False)
         ReturnCode = FORMAT_INVALID
     except FatalError, X:
         if Options.debug != None:
@@ -326,7 +326,7 @@ def SingleCheckCallback(option, opt_str, value, parser):
 #
 def myOptionParser():
     usage = "%prog [options] -f input_file -a arch_list -b build_target -p active_platform -t tool_chain_tag -D \"MacroName [= MacroValue]\""
-    Parser = OptionParser(usage=usage,description=__copyright__,version="%prog " + str(versionNumber))
+    Parser = OptionParser(usage=usage, description=__copyright__, version="%prog " + str(versionNumber))
     Parser.add_option("-f", "--file", dest="filename", type="string", help="Name of FDF file to convert", action="callback", callback=SingleCheckCallback)
     Parser.add_option("-a", "--arch", dest="archList", help="comma separated list containing one or more of: IA32, X64, IPF, ARM, AARCH64 or EBC which should be built, overrides target.txt?s TARGET_ARCH")
     Parser.add_option("-q", "--quiet", action="store_true", type=None, help="Disable all messages except FATAL ERRORS.")
@@ -503,8 +503,8 @@ def DisplayFvSpaceInfo(FdfParser):
             if UsedSizeValue == TotalSizeValue:
                 Percentage = '100'
             else:
-                Percentage = str((UsedSizeValue+0.0)/TotalSizeValue)[0:4].lstrip('0.') 
-            
+                Percentage = str((UsedSizeValue + 0.0) / TotalSizeValue)[0:4].lstrip('0.')
+
             GenFdsGlobalVariable.InfLogger(Name + ' ' + '[' + Percentage + '%Full] ' + str(TotalSizeValue) + ' total, ' + str(UsedSizeValue) + ' used, ' + str(FreeSizeValue) + ' free')
 
     ## PreprocessImage()
diff --git a/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py b/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
index 5bdc1b8288a8..8a974236f221 100644
--- a/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
+++ b/BaseTools/Source/Python/GenFds/GenFdsGlobalVariable.py
@@ -274,7 +274,7 @@ def GetModuleCodaTargetList(Inf, Arch):
     #   @param  ArchList            The Arch list of platform
     #
     def SetDir (OutputDir, FdfParser, WorkSpace, ArchList):
-        GenFdsGlobalVariable.VerboseLogger( "GenFdsGlobalVariable.OutputDir :%s" %OutputDir)
+        GenFdsGlobalVariable.VerboseLogger("GenFdsGlobalVariable.OutputDir :%s" % OutputDir)
 #        GenFdsGlobalVariable.OutputDirDict = OutputDir
         GenFdsGlobalVariable.FdfParser = FdfParser
         GenFdsGlobalVariable.WorkSpace = WorkSpace
@@ -292,7 +292,7 @@ def SetDir (OutputDir, FdfParser, WorkSpace, ArchList):
         # Create FV Address inf file
         #
         GenFdsGlobalVariable.FvAddressFileName = os.path.join(GenFdsGlobalVariable.FfsDir, 'FvAddress.inf')
-        FvAddressFile = open (GenFdsGlobalVariable.FvAddressFileName, 'w')
+        FvAddressFile = open(GenFdsGlobalVariable.FvAddressFileName, 'w')
         #
         # Add [Options]
         #
@@ -304,7 +304,7 @@ def SetDir (OutputDir, FdfParser, WorkSpace, ArchList):
                 break
 
         FvAddressFile.writelines("EFI_BOOT_DRIVER_BASE_ADDRESS = " + \
-                                       BsAddress          + \
+                                       BsAddress + \
                                        T_CHAR_LF)
 
         RtAddress = '0'
@@ -313,7 +313,7 @@ def SetDir (OutputDir, FdfParser, WorkSpace, ArchList):
                 RtAddress = GenFdsGlobalVariable.WorkSpace.BuildObject[GenFdsGlobalVariable.ActivePlatform, Arch, GenFdsGlobalVariable.TargetName, GenFdsGlobalVariable.ToolChainTag].RtBaseAddress
 
         FvAddressFile.writelines("EFI_RUNTIME_DRIVER_BASE_ADDRESS = " + \
-                                       RtAddress          + \
+                                       RtAddress + \
                                        T_CHAR_LF)
 
         FvAddressFile.close()
@@ -386,13 +386,13 @@ def GenerateSection(Output, Input, Type=None, CompressionType=None, Guid=None,
         CommandFile = Output + '.txt'
         if Ui not in [None, '']:
             #Cmd += ["-n", '"' + Ui + '"']
-            SectionData = array.array('B', [0,0,0,0])
+            SectionData = array.array('B', [0, 0, 0, 0])
             SectionData.fromstring(Ui.encode("utf_16_le"))
             SectionData.append(0)
             SectionData.append(0)
             Len = len(SectionData)
             GenFdsGlobalVariable.SectionHeader.pack_into(SectionData, 0, Len & 0xff, (Len >> 8) & 0xff, (Len >> 16) & 0xff, 0x15)
-            SaveFileOnChange(Output,  SectionData.tostring())
+            SaveFileOnChange(Output, SectionData.tostring())
         elif Ver not in [None, '']:
             Cmd += ["-n", Ver]
             if BuildNumber:
@@ -461,12 +461,12 @@ def GenerateFirmwareVolume(Output, Input, BaseAddress=None, ForceRebase=None, Ca
         Cmd = ["GenFv"]
         if BaseAddress not in [None, '']:
             Cmd += ["-r", BaseAddress]
-        
+
         if ForceRebase == False:
-            Cmd +=["-F", "FALSE"]
+            Cmd += ["-F", "FALSE"]
         elif ForceRebase == True:
-            Cmd +=["-F", "TRUE"]
-            
+            Cmd += ["-F", "TRUE"]
+
         if Capsule:
             Cmd += ["-c"]
         if Dump:
@@ -570,7 +570,7 @@ def GenerateOptionRom(Output, EfiInput, BinaryInput, Compress=False, ClassCode=N
         if VendorId != None:
             Cmd += ["-f", VendorId]
 
-        Cmd += ["-o", Output]    
+        Cmd += ["-o", Output]
         GenFdsGlobalVariable.CallExternalTool(Cmd, "Failed to generate option rom")
 
     @staticmethod
@@ -606,7 +606,7 @@ def CallExternalTool (cmd, errorMess, returnValue=[]):
                 sys.stdout.write('\n')
 
         try:
-            PopenObject = subprocess.Popen(' '.join(cmd), stdout=subprocess.PIPE, stderr= subprocess.PIPE, shell=True)
+            PopenObject = subprocess.Popen(' '.join(cmd), stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True)
         except Exception, X:
             EdkLogger.error("GenFds", COMMAND_FAILURE, ExtraData="%s: %s" % (str(X), cmd[0]))
         (out, error) = PopenObject.communicate()
@@ -618,7 +618,7 @@ def CallExternalTool (cmd, errorMess, returnValue=[]):
             returnValue[0] = PopenObject.returncode
             return
         if PopenObject.returncode != 0 or GenFdsGlobalVariable.VerboseMode or GenFdsGlobalVariable.DebugLevel != -1:
-            GenFdsGlobalVariable.InfLogger ("Return Value = %d" %PopenObject.returncode)
+            GenFdsGlobalVariable.InfLogger ("Return Value = %d" % PopenObject.returncode)
             GenFdsGlobalVariable.InfLogger (out)
             GenFdsGlobalVariable.InfLogger (error)
             if PopenObject.returncode != 0:
@@ -631,7 +631,7 @@ def VerboseLogger (msg):
     def InfLogger (msg):
         EdkLogger.info(msg)
 
-    def ErrorLogger (msg, File = None, Line = None, ExtraData = None):
+    def ErrorLogger (msg, File=None, Line=None, ExtraData=None):
         EdkLogger.error('GenFds', GENFDS_ERROR, msg, File, Line, ExtraData)
 
     def DebugLogger (Level, msg):
@@ -642,7 +642,7 @@ def DebugLogger (Level, msg):
     #   @param  Str           String that may contain macro
     #   @param  MacroDict     Dictionary that contains macro value pair
     #
-    def MacroExtend (Str, MacroDict = {}, Arch = 'COMMON'):
+    def MacroExtend (Str, MacroDict={}, Arch='COMMON'):
         if Str == None :
             return None
 
@@ -699,10 +699,10 @@ def GetPcdValue (PcdPattern):
                         
                     PcdValue = PcdObj.DefaultValue
                     return PcdValue
-                
-            for Package in GenFdsGlobalVariable.WorkSpace.GetPackageList(GenFdsGlobalVariable.ActivePlatform, 
-                                                                         Arch, 
-                                                                         GenFdsGlobalVariable.TargetName, 
+
+            for Package in GenFdsGlobalVariable.WorkSpace.GetPackageList(GenFdsGlobalVariable.ActivePlatform,
+                                                                         Arch,
+                                                                         GenFdsGlobalVariable.TargetName,
                                                                          GenFdsGlobalVariable.ToolChainTag):
                 PcdDict = Package.Pcds
                 for Key in PcdDict:
diff --git a/BaseTools/Source/Python/GenFds/GuidSection.py b/BaseTools/Source/Python/GenFds/GuidSection.py
index 006cf0f2169b..cc0c05a28c1e 100644
--- a/BaseTools/Source/Python/GenFds/GuidSection.py
+++ b/BaseTools/Source/Python/GenFds/GuidSection.py
@@ -53,7 +53,7 @@ def __init__(self):
     #   @param  Dict        dictionary contains macro and its value
     #   @retval tuple       (Generated file name, section alignment)
     #
-    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = None, Dict = {}):
+    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf=None, Dict={}):
         #
         # Generate all section
         #
@@ -65,7 +65,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
             self.SectionType = FfsInf.__ExtendMacro__(self.SectionType)
             self.CurrentArchList = [FfsInf.CurrentArch]
 
-        SectFile  = tuple()
+        SectFile = tuple()
         SectAlign = []
         Index = 0
         MaxAlign = None
@@ -84,7 +84,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
 
         for Sect in self.SectionList:
             Index = Index + 1
-            SecIndex = '%s.%d' %(SecNum,Index)
+            SecIndex = '%s.%d' % (SecNum, Index)
             # set base address for inside FvImage
             if isinstance(Sect, FvImageSection):
                 if self.FvAddr != []:
@@ -93,7 +93,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
             elif isinstance(Sect, GuidSection):
                 Sect.FvAddr = self.FvAddr
                 Sect.FvParentAddr = self.FvParentAddr
-            ReturnSectList, align = Sect.GenSection(OutputPath, ModuleName, SecIndex, KeyStringList,FfsInf, Dict)
+            ReturnSectList, align = Sect.GenSection(OutputPath, ModuleName, SecIndex, KeyStringList, FfsInf, Dict)
             if isinstance(Sect, GuidSection):
                 if Sect.IncludeFvSection:
                     self.IncludeFvSection = Sect.IncludeFvSection
@@ -118,10 +118,10 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
                     self.Alignment = MaxAlign
 
         OutputFile = OutputPath + \
-                     os.sep     + \
+                     os.sep + \
                      ModuleName + \
-                     'SEC'      + \
-                     SecNum     + \
+                     'SEC' + \
+                     SecNum + \
                      Ffs.SectionSuffix['GUIDED']
         OutputFile = os.path.normpath(OutputFile)
 
@@ -135,7 +135,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
         # GENCRC32 section
         #
         if self.NameGuid == None :
-            GenFdsGlobalVariable.VerboseLogger( "Use GenSection function Generate CRC32 Section")
+            GenFdsGlobalVariable.VerboseLogger("Use GenSection function Generate CRC32 Section")
             GenFdsGlobalVariable.GenerateSection(OutputFile, SectFile, Section.Section.SectionType[self.SectionType], InputAlign=SectAlign)
             OutputFileList = []
             OutputFileList.append(OutputFile)
@@ -144,7 +144,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
         elif ExternalTool == None:
             EdkLogger.error("GenFds", GENFDS_ERROR, "No tool found with GUID %s" % self.NameGuid)
         else:
-            DummyFile = OutputFile+".dummy"
+            DummyFile = OutputFile + ".dummy"
             #
             # Call GenSection with DUMMY section type.
             #
@@ -153,10 +153,10 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
             # Use external tool process the Output
             #
             TempFile = OutputPath + \
-                       os.sep     + \
+                       os.sep + \
                        ModuleName + \
-                       'SEC'      + \
-                       SecNum     + \
+                       'SEC' + \
+                       SecNum + \
                        '.tmp'
             TempFile = os.path.normpath(TempFile)
             #
@@ -197,12 +197,12 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
             if not os.path.exists(TempFile):
                 EdkLogger.error("GenFds", COMMAND_FAILURE, 'Fail to call %s, no output file was generated' % ExternalTool)
 
-            FileHandleIn = open(DummyFile,'rb')
-            FileHandleIn.seek(0,2)
+            FileHandleIn = open(DummyFile, 'rb')
+            FileHandleIn.seek(0, 2)
             InputFileSize = FileHandleIn.tell()
-            
-            FileHandleOut = open(TempFile,'rb')
-            FileHandleOut.seek(0,2)
+
+            FileHandleOut = open(TempFile, 'rb')
+            FileHandleOut.seek(0, 2)
             TempFileSize = FileHandleOut.tell()
 
             Attribute = []
@@ -213,7 +213,7 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
             if self.ProcessRequired == "NONE" and HeaderLength == None:
                 if TempFileSize > InputFileSize:
                     FileHandleIn.seek(0)
-                    BufferIn  = FileHandleIn.read()
+                    BufferIn = FileHandleIn.read()
                     FileHandleOut.seek(0)
                     BufferOut = FileHandleOut.read()
                     if BufferIn == BufferOut[TempFileSize - InputFileSize:]:
@@ -224,18 +224,18 @@ def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = Non
 
             FileHandleIn.close()
             FileHandleOut.close()
-            
+
             if FirstCall and 'PROCESSING_REQUIRED' in Attribute:
                 # Guided data by -z option on first call is the process required data. Call the guided tool with the real option.
                 GenFdsGlobalVariable.GuidTool(TempFile, [DummyFile], ExternalTool, CmdOption)
-            
+
             #
             # Call Gensection Add Section Header
             #
             if self.ProcessRequired in ("TRUE", "1"):
                 if 'PROCESSING_REQUIRED' not in Attribute:
                     Attribute.append('PROCESSING_REQUIRED')
-  
+
             if self.AuthStatusValid in ("TRUE", "1"):
                 Attribute.append('AUTH_STATUS_VALID')
             GenFdsGlobalVariable.GenerateSection(OutputFile, [TempFile], Section.Section.SectionType['GUIDED'],
@@ -263,7 +263,7 @@ def __FindExtendTool__(self):
             ToolDb = ToolDefClassObject.ToolDefDict(GenFdsGlobalVariable.ConfDir).ToolsDefTxtDatabase
             if ToolChain not in ToolDb['TOOL_CHAIN_TAG']:
                 EdkLogger.error("GenFds", GENFDS_ERROR, "Can not find external tool because tool tag %s is not defined in tools_def.txt!" % ToolChain)
-            self.KeyStringList = [Target+'_'+ToolChain+'_'+self.CurrentArchList[0]]
+            self.KeyStringList = [Target + '_' + ToolChain + '_' + self.CurrentArchList[0]]
             for Arch in self.CurrentArchList:
                 if Target + '_' + ToolChain + '_' + Arch not in self.KeyStringList:
                     self.KeyStringList.append(Target + '_' + ToolChain + '_' + Arch)
@@ -275,30 +275,30 @@ def __FindExtendTool__(self):
             if self.NameGuid == ToolDef[1]:
                 KeyList = ToolDef[0].split('_')
                 Key = KeyList[0] + \
-                      '_'        + \
+                      '_' + \
                       KeyList[1] + \
-                      '_'        + \
+                      '_' + \
                       KeyList[2]
                 if Key in self.KeyStringList and KeyList[4] == 'GUID':
 
-                    ToolPath = ToolDefinition.get( Key        + \
-                                                   '_'        + \
+                    ToolPath = ToolDefinition.get(Key + \
+                                                   '_' + \
                                                    KeyList[3] + \
-                                                   '_'        + \
+                                                   '_' + \
                                                    'PATH')
 
-                    ToolOption = ToolDefinition.get( Key        + \
-                                                    '_'        + \
+                    ToolOption = ToolDefinition.get(Key + \
+                                                    '_' + \
                                                     KeyList[3] + \
-                                                    '_'        + \
+                                                    '_' + \
                                                     'FLAGS')
                     if ToolPathTmp == None:
                         ToolPathTmp = ToolPath
                     else:
                         if ToolPathTmp != ToolPath:
                             EdkLogger.error("GenFds", GENFDS_ERROR, "Don't know which tool to use, %s or %s ?" % (ToolPathTmp, ToolPath))
-                            
-                    
+
+
         return ToolPathTmp, ToolOption
 
 
diff --git a/BaseTools/Source/Python/GenFds/Region.py b/BaseTools/Source/Python/GenFds/Region.py
index feb56cb60f27..01e998e54c6f 100644
--- a/BaseTools/Source/Python/GenFds/Region.py
+++ b/BaseTools/Source/Python/GenFds/Region.py
@@ -54,10 +54,10 @@ def __init__(self):
     #   @retval string      Generated FV file path
     #
 
-    def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBinDict, vtfDict = None, MacroDict = {}):
+    def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBinDict, vtfDict=None, MacroDict={}):
         Size = self.Size
         GenFdsGlobalVariable.InfLogger('\nGenerate Region at Offset 0x%X' % self.Offset)
-        GenFdsGlobalVariable.InfLogger("   Region Size = 0x%X" %Size)
+        GenFdsGlobalVariable.InfLogger("   Region Size = 0x%X" % Size)
         GenFdsGlobalVariable.SharpCounter = 0
 
         if self.RegionType == 'FV':
@@ -65,13 +65,13 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
             # Get Fv from FvDict
             #
             self.FvAddress = int(BaseAddress, 16) + self.Offset
-            FvBaseAddress  = '0x%X' %self.FvAddress
-            FvOffset       = 0
+            FvBaseAddress = '0x%X' % self.FvAddress
+            FvOffset = 0
             for RegionData in self.RegionDataList:
                 FileName = None
                 if RegionData.endswith(".fv"):
                     RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
-                    GenFdsGlobalVariable.InfLogger('   Region FV File Name = .fv : %s'%RegionData)
+                    GenFdsGlobalVariable.InfLogger('   Region FV File Name = .fv : %s' % RegionData)
                     if RegionData[1] != ':' :
                         RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                     if not os.path.exists(RegionData):
@@ -101,7 +101,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                             EdkLogger.error("GenFds", GENFDS_ERROR,
                                             "FV (%s) is NOT %s Aligned!" % (FvObj.UiFvName, FvObj.FvAlignment))
                         FvBuffer = StringIO.StringIO('')
-                        FvBaseAddress = '0x%X' %self.FvAddress
+                        FvBaseAddress = '0x%X' % self.FvAddress
                         BlockSize = None
                         BlockNum = None
                         FvObj.AddToBuffer(FvBuffer, FvBaseAddress, BlockSize, BlockNum, ErasePolarity, vtfDict)
@@ -128,7 +128,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                         EdkLogger.error("GenFds", GENFDS_ERROR,
                                         "Size of FV File (%s) is larger than Region Size 0x%X specified." \
                                         % (RegionData, Size))
-                    BinFile = open (FileName, 'r+b')
+                    BinFile = open(FileName, 'r+b')
                     Buffer.write(BinFile.read())
                     BinFile.close()
                     Size = Size - FileLength
@@ -150,7 +150,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
             for RegionData in self.RegionDataList:
                 if RegionData.endswith(".cap"):
                     RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
-                    GenFdsGlobalVariable.InfLogger('   Region CAPSULE Image Name = .cap : %s'%RegionData)
+                    GenFdsGlobalVariable.InfLogger('   Region CAPSULE Image Name = .cap : %s' % RegionData)
                     if RegionData[1] != ':' :
                         RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                     if not os.path.exists(RegionData):
@@ -187,7 +187,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                     EdkLogger.error("GenFds", GENFDS_ERROR,
                                     "Size 0x%X of Capsule File (%s) is larger than Region Size 0x%X specified." \
                                     % (FileLength, RegionData, Size))
-                BinFile = open (FileName, 'r+b')
+                BinFile = open(FileName, 'r+b')
                 Buffer.write(BinFile.read())
                 BinFile.close()
                 Size = Size - FileLength
@@ -217,8 +217,8 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                     EdkLogger.error("GenFds", GENFDS_ERROR,
                                     "Size of File (%s) is larger than Region Size 0x%X specified." \
                                     % (RegionData, Size))
-                GenFdsGlobalVariable.InfLogger('   Region File Name = %s'%RegionData)
-                BinFile = open (RegionData, 'rb')
+                GenFdsGlobalVariable.InfLogger('   Region File Name = %s' % RegionData)
+                BinFile = open(RegionData, 'rb')
                 Buffer.write(BinFile.read())
                 BinFile.close()
                 Size = Size - FileLength
@@ -273,17 +273,17 @@ def GetFvAlignValue(self, Str):
             Granu = 1024
             Str = Str[:-1]
         elif Str.endswith('M'):
-            Granu = 1024*1024
+            Granu = 1024 * 1024
             Str = Str[:-1]
         elif Str.endswith('G'):
-            Granu = 1024*1024*1024
+            Granu = 1024 * 1024 * 1024
             Str = Str[:-1]
         else:
             pass
 
-        AlignValue = int(Str)*Granu
+        AlignValue = int(Str) * Granu
         return AlignValue
- 
+
     ## BlockSizeOfRegion()
     #
     #   @param  BlockSizeList        List of block information
@@ -304,7 +304,7 @@ def BlockInfoOfRegion(self, BlockSizeList, FvObj):
             else:
                 # region ended within current blocks
                 if self.Offset + self.Size <= End:
-                    ExpectedList.append((BlockSize, (RemindingSize + BlockSize - 1)/BlockSize))
+                    ExpectedList.append((BlockSize, (RemindingSize + BlockSize - 1) / BlockSize))
                     break
                 # region not ended yet
                 else:
@@ -313,11 +313,11 @@ def BlockInfoOfRegion(self, BlockSizeList, FvObj):
                         UsedBlockNum = BlockNum
                     # region started in middle of current blocks
                     else:
-                        UsedBlockNum = (End - self.Offset)/BlockSize
+                        UsedBlockNum = (End - self.Offset) / BlockSize
                     Start = End
                     ExpectedList.append((BlockSize, UsedBlockNum))
                     RemindingSize -= BlockSize * UsedBlockNum
-                   
+
         if FvObj.BlockSizeList == []:
             FvObj.BlockSizeList = ExpectedList
         else:
@@ -333,22 +333,22 @@ def BlockInfoOfRegion(self, BlockSizeList, FvObj):
                 Sum += Item[0] * Item[1]
             if self.Size < Sum:
                 EdkLogger.error("GenFds", GENFDS_ERROR, "Total Size of FV %s 0x%x is larger than Region Size 0x%x "
-                                %(FvObj.UiFvName, Sum, self.Size))
+                                % (FvObj.UiFvName, Sum, self.Size))
             # check whether the BlockStatements in FV section is appropriate
             ExpectedListData = ''
             for Item in ExpectedList:
-                ExpectedListData += "BlockSize = 0x%x\n\tNumBlocks = 0x%x\n\t"%Item 
+                ExpectedListData += "BlockSize = 0x%x\n\tNumBlocks = 0x%x\n\t" % Item
             Index = 0
             for Item in FvObj.BlockSizeList:
                 if Item[0] != ExpectedList[Index][0]:
                     EdkLogger.error("GenFds", GENFDS_ERROR, "BlockStatements of FV %s are not align with FD's, suggested FV BlockStatement"
-                                    %FvObj.UiFvName, ExtraData = ExpectedListData)
+                                    % FvObj.UiFvName, ExtraData=ExpectedListData)
                 elif Item[1] != ExpectedList[Index][1]:
                     if (Item[1] < ExpectedList[Index][1]) and (Index == len(FvObj.BlockSizeList) - 1):
                         break;
                     else:
                         EdkLogger.error("GenFds", GENFDS_ERROR, "BlockStatements of FV %s are not align with FD's, suggested FV BlockStatement"
-                                        %FvObj.UiFvName, ExtraData = ExpectedListData)
+                                        % FvObj.UiFvName, ExtraData=ExpectedListData)
                 else:
                     Index += 1
 
diff --git a/BaseTools/Source/Python/GenFds/UiSection.py b/BaseTools/Source/Python/GenFds/UiSection.py
index e4f3647f1323..d54e3b2a6d04 100644
--- a/BaseTools/Source/Python/GenFds/UiSection.py
+++ b/BaseTools/Source/Python/GenFds/UiSection.py
@@ -48,7 +48,7 @@ def __init__(self):
     #   @param  Dict        dictionary contains macro and its value
     #   @retval tuple       (Generated file name, section alignment)
     #
-    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = None, Dict = {}):
+    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf=None, Dict={}):
         #
         # Prepare the parameter of GenSection
         #
diff --git a/BaseTools/Source/Python/GenFds/VerSection.py b/BaseTools/Source/Python/GenFds/VerSection.py
index 7399e7a5d4c7..ad995d314bd6 100644
--- a/BaseTools/Source/Python/GenFds/VerSection.py
+++ b/BaseTools/Source/Python/GenFds/VerSection.py
@@ -48,7 +48,7 @@ def __init__(self):
     #   @param  Dict        dictionary contains macro and its value
     #   @retval tuple       (Generated file name, section alignment)
     #
-    def GenSection(self,OutputPath, ModuleName, SecNum, KeyStringList, FfsInf = None, Dict = {}):
+    def GenSection(self, OutputPath, ModuleName, SecNum, KeyStringList, FfsInf=None, Dict={}):
         #
         # Prepare the parameter of GenSection
         #
diff --git a/BaseTools/Source/Python/GenFds/Vtf.py b/BaseTools/Source/Python/GenFds/Vtf.py
index 64b5d771382d..06e3d275c381 100644
--- a/BaseTools/Source/Python/GenFds/Vtf.py
+++ b/BaseTools/Source/Python/GenFds/Vtf.py
@@ -67,80 +67,80 @@ def GenVtf(self, FdAddressDict) :
     def GenBsfInf (self):
         FvList = self.GetFvList()
         self.BsfInfName = os.path.join(GenFdsGlobalVariable.FvDir, self.UiName + '.inf')
-        BsfInf = open (self.BsfInfName, 'w+')
+        BsfInf = open(self.BsfInfName, 'w+')
         if self.ResetBin != None:
             BsfInf.writelines ("[OPTIONS]" + T_CHAR_LF)
-            BsfInf.writelines ("IA32_RST_BIN"     + \
-                               " = "              + \
+            BsfInf.writelines ("IA32_RST_BIN" + \
+                               " = " + \
                                GenFdsGlobalVariable.MacroExtend(GenFdsGlobalVariable.ReplaceWorkspaceMacro(self.ResetBin)) + \
-                               T_CHAR_LF )
-            BsfInf.writelines (T_CHAR_LF )
-        
+                               T_CHAR_LF)
+            BsfInf.writelines (T_CHAR_LF)
+
         BsfInf.writelines ("[COMPONENTS]" + T_CHAR_LF)
 
         for ComponentObj in self.ComponentStatementList :
-            BsfInf.writelines ("COMP_NAME"        + \
-                               " = "              + \
+            BsfInf.writelines ("COMP_NAME" + \
+                               " = " + \
                                ComponentObj.CompName + \
-                               T_CHAR_LF )
+                               T_CHAR_LF)
             if ComponentObj.CompLoc.upper() == 'NONE':
-                BsfInf.writelines ("COMP_LOC"        + \
-                                   " = "             + \
-                                   'N'               + \
-                                   T_CHAR_LF )
-            
+                BsfInf.writelines ("COMP_LOC" + \
+                                   " = " + \
+                                   'N' + \
+                                   T_CHAR_LF)
+
             elif ComponentObj.FilePos != None:
-                BsfInf.writelines ("COMP_LOC"        + \
-                                   " = "             + \
+                BsfInf.writelines ("COMP_LOC" + \
+                                   " = " + \
                                    ComponentObj.FilePos + \
-                                   T_CHAR_LF )
+                                   T_CHAR_LF)
             else:
                 Index = FvList.index(ComponentObj.CompLoc.upper())
                 if Index == 0:
-                    BsfInf.writelines ("COMP_LOC"        + \
-                                       " = "             + \
-                                       'F'               + \
-                                       T_CHAR_LF )
+                    BsfInf.writelines ("COMP_LOC" + \
+                                       " = " + \
+                                       'F' + \
+                                       T_CHAR_LF)
                 elif Index == 1:
-                    BsfInf.writelines ("COMP_LOC"        + \
-                                       " = "             + \
-                                       'S'                 + \
-                                       T_CHAR_LF )
-                
-            BsfInf.writelines ("COMP_TYPE"        + \
-                               " = "              + \
+                    BsfInf.writelines ("COMP_LOC" + \
+                                       " = " + \
+                                       'S' + \
+                                       T_CHAR_LF)
+
+            BsfInf.writelines ("COMP_TYPE" + \
+                               " = " + \
                                ComponentObj.CompType + \
-                               T_CHAR_LF )
-            BsfInf.writelines ("COMP_VER"        + \
-                               " = "             + \
+                               T_CHAR_LF)
+            BsfInf.writelines ("COMP_VER" + \
+                               " = " + \
                                ComponentObj.CompVer + \
-                               T_CHAR_LF )
-            BsfInf.writelines ("COMP_CS"        + \
-                               " = "            + \
+                               T_CHAR_LF)
+            BsfInf.writelines ("COMP_CS" + \
+                               " = " + \
                                ComponentObj.CompCs + \
-                               T_CHAR_LF )
-            
+                               T_CHAR_LF)
+
             BinPath = ComponentObj.CompBin
             if BinPath != '-':
                 BinPath = GenFdsGlobalVariable.MacroExtend(GenFdsGlobalVariable.ReplaceWorkspaceMacro(BinPath))
-            BsfInf.writelines ("COMP_BIN"        + \
-                               " = "             + \
+            BsfInf.writelines ("COMP_BIN" + \
+                               " = " + \
                                BinPath + \
-                               T_CHAR_LF )
-            
+                               T_CHAR_LF)
+
             SymPath = ComponentObj.CompSym
             if SymPath != '-':
                 SymPath = GenFdsGlobalVariable.MacroExtend(GenFdsGlobalVariable.ReplaceWorkspaceMacro(SymPath))
-            BsfInf.writelines ("COMP_SYM"        + \
-                               " = "             + \
+            BsfInf.writelines ("COMP_SYM" + \
+                               " = " + \
                                SymPath + \
-                               T_CHAR_LF )
-            BsfInf.writelines ("COMP_SIZE"        + \
-                               " = "              + \
+                               T_CHAR_LF)
+            BsfInf.writelines ("COMP_SIZE" + \
+                               " = " + \
                                ComponentObj.CompSize + \
-                               T_CHAR_LF )
-            BsfInf.writelines (T_CHAR_LF )
-            
+                               T_CHAR_LF)
+            BsfInf.writelines (T_CHAR_LF)
+
         BsfInf.close()
 
     ## GenFvList() method
@@ -170,7 +170,7 @@ def GetBaseAddressArg(self, FdAddressDict):
             (BaseAddress, Size) = FdAddressDict.get(i)
             CmdStr += (
                 '-r', '0x%x' % BaseAddress,
-                '-s', '0x%x' %Size,
+                '-s', '0x%x' % Size,
                 )
         return CmdStr
     
diff --git a/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py b/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
index 50d99f7267a3..36e539f67458 100644
--- a/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
+++ b/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
@@ -112,11 +112,11 @@ def _parseGeneral(lines, efifilepath):
     @param lines    line array for map file
     
     @return a list which element hold (PcdName, Offset, SectionName)
-    """    
+    """
     status = 0    #0 - beginning of file; 1 - PE section definition; 2 - symbol table
-    secs  = []    # key = section name
+    secs = []    # key = section name
     bPcds = []
-    
+
 
     for line in lines:
         line = line.strip()
@@ -128,9 +128,9 @@ def _parseGeneral(lines, efifilepath):
             continue
         if re.match("^entry point at", line):
             status = 3
-            continue        
+            continue
         if status == 1 and len(line) != 0:
-            m =  secRe.match(line)
+            m = secRe.match(line)
             assert m != None, "Fail to parse the section in map file , line is %s" % line
             sec_no, sec_start, sec_length, sec_name, sec_class = m.groups(0)
             secs.append([int(sec_no, 16), int(sec_start, 16), int(sec_length, 16), sec_name, sec_class])
@@ -138,9 +138,9 @@ def _parseGeneral(lines, efifilepath):
             m = symRe.match(line)
             assert m != None, "Fail to parse the symbol in map file, line is %s" % line
             sec_no, sym_offset, sym_name, vir_addr = m.groups(0)
-            sec_no     = int(sec_no,     16)
+            sec_no = int(sec_no, 16)
             sym_offset = int(sym_offset, 16)
-            vir_addr   = int(vir_addr,   16)
+            vir_addr = int(vir_addr, 16)
             m2 = re.match('^[_]+gPcd_BinaryPatch_([\w]+)', sym_name)
             if m2 != None:
                 # fond a binary pcd entry in map file
@@ -179,7 +179,7 @@ def generatePcdTable(list, pcdpath):
     f.close()
 
     #print 'Success to generate Binary Patch PCD table at %s!' % pcdpath 
-    
+
 if __name__ == '__main__':
     UsageString = "%prog -m <MapFile> -e <EfiFile> -o <OutFile>"
     AdditionalNotes = "\nPCD table is generated in file name with .BinaryPcdTable.txt postfix"
@@ -196,12 +196,12 @@ def generatePcdTable(list, pcdpath):
     if options.mapfile == None or options.efifile == None:
         print parser.get_usage()
     elif os.path.exists(options.mapfile) and os.path.exists(options.efifile):
-        list = parsePcdInfoFromMapFile(options.mapfile, options.efifile) 
+        list = parsePcdInfoFromMapFile(options.mapfile, options.efifile)
         if list != None:
             if options.outfile != None:
                 generatePcdTable(list, options.outfile)
             else:
-                generatePcdTable(list, options.mapfile.replace('.map', '.BinaryPcdTable.txt')) 
+                generatePcdTable(list, options.mapfile.replace('.map', '.BinaryPcdTable.txt'))
         else:
             print 'Fail to generate Patch PCD Table based on map file and efi file'
     else:
diff --git a/BaseTools/Source/Python/PatchPcdValue/PatchPcdValue.py b/BaseTools/Source/Python/PatchPcdValue/PatchPcdValue.py
index 1b3a0ec93d62..882da81930da 100644
--- a/BaseTools/Source/Python/PatchPcdValue/PatchPcdValue.py
+++ b/BaseTools/Source/Python/PatchPcdValue/PatchPcdValue.py
@@ -48,7 +48,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
     #
     # Length of Binary File
     #
-    FileHandle = open (FileName, 'rb')
+    FileHandle = open(FileName, 'rb')
     FileHandle.seek (0, 2)
     FileLength = FileHandle.tell()
     FileHandle.close()
@@ -75,7 +75,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
             return OPTION_MISSING, "PcdMaxSize is not specified for VOID* type PCD."
         ValueLength = int(MaxSize)
     else:
-        return PARAMETER_INVALID,  "PCD type %s is not valid." %(CommandOptions.PcdTypeName)
+        return PARAMETER_INVALID, "PCD type %s is not valid." % (CommandOptions.PcdTypeName)
     #
     # Check PcdValue is in the input binary file.
     #
@@ -84,7 +84,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
     #
     # Read binary file into array
     #
-    FileHandle = open (FileName, 'rb')
+    FileHandle = open(FileName, 'rb')
     ByteArray = array.array('B')
     ByteArray.fromfile(FileHandle, FileLength)
     FileHandle.close()
@@ -117,7 +117,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
             if ValueNumber != 0:
                 ValueNumber = 1
         except:
-            return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string." %(ValueString)
+            return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string." % (ValueString)
         #
         # Set PCD value into binary data
         #
@@ -132,7 +132,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
             else:
                 ValueNumber = int (ValueString)
         except:
-            return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string." %(ValueString)
+            return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string." % (ValueString)
         #
         # Set PCD value into binary data
         #
@@ -174,7 +174,7 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
                     if Index >= ValueLength:
                         break
             except:
-                return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string array." %(ValueString)
+                return PARAMETER_INVALID, "PCD Value %s is not valid dec or hex string array." % (ValueString)
         else:
             #
             # Patch ascii string 
@@ -197,10 +197,10 @@ def PatchBinaryFile(FileName, ValueOffset, TypeName, ValueString, MaxSize=0):
     if ByteList != OrigByteList:
         ByteArray = array.array('B')
         ByteArray.fromlist(ByteList)
-        FileHandle = open (FileName, 'wb')
+        FileHandle = open(FileName, 'wb')
         ByteArray.tofile(FileHandle)
         FileHandle.close()
-    return 0, "Patch Value into File %s successfully." %(FileName)
+    return 0, "Patch Value into File %s successfully." % (FileName)
 
 ## Parse command line options
 #
@@ -270,7 +270,7 @@ def Main():
             EdkLogger.error("PatchPcdValue", OPTION_MISSING, ExtraData="PcdOffset or PcdValue of PcdTypeName is not specified.")
             return 1
         if CommandOptions.PcdTypeName.upper() not in ["BOOLEAN", "UINT8", "UINT16", "UINT32", "UINT64", "VOID*"]:
-            EdkLogger.error("PatchPcdValue", PARAMETER_INVALID, ExtraData="PCD type %s is not valid." %(CommandOptions.PcdTypeName))
+            EdkLogger.error("PatchPcdValue", PARAMETER_INVALID, ExtraData="PCD type %s is not valid." % (CommandOptions.PcdTypeName))
             return 1
         if CommandOptions.PcdTypeName.upper() == "VOID*" and CommandOptions.PcdMaxSize == None:
             EdkLogger.error("PatchPcdValue", OPTION_MISSING, ExtraData="PcdMaxSize is not specified for VOID* type PCD.")
diff --git a/BaseTools/Source/Python/Table/TableReport.py b/BaseTools/Source/Python/Table/TableReport.py
index c7829c0097bf..4af0e98d86b4 100644
--- a/BaseTools/Source/Python/Table/TableReport.py
+++ b/BaseTools/Source/Python/Table/TableReport.py
@@ -68,14 +68,14 @@ def Create(self):
     # @param Enabled:        If this error enabled
     # @param Corrected:      if this error corrected
     #
-    def Insert(self, ErrorID, OtherMsg = '', BelongsToTable = '', BelongsToItem = -1, Enabled = 0, Corrected = -1):
+    def Insert(self, ErrorID, OtherMsg='', BelongsToTable='', BelongsToItem= -1, Enabled=0, Corrected= -1):
         self.ID = self.ID + 1
         SqlCommand = """insert into %s values(%s, %s, '%s', '%s', %s, %s, %s)""" \
                      % (self.Table, self.ID, ErrorID, ConvertToSqlString2(OtherMsg), BelongsToTable, BelongsToItem, Enabled, Corrected)
         Table.Insert(self, SqlCommand)
-        
+
         return self.ID
-    
+
     ## Query table
     #
     # @retval:       A recordSet of all found records 
@@ -98,7 +98,7 @@ def UpdateBelongsToItemByFile(self, ItemID=-1, File=""):
     #
     # @param Filename:  To filename to save the report content
     #
-    def ToCSV(self, Filename = 'Report.csv'):
+    def ToCSV(self, Filename='Report.csv'):
         try:
             File = open(Filename, 'w+')
             File.write("""No, Error Code, Error Message, File, LineNo, Other Error Message\n""")
@@ -123,7 +123,7 @@ def ToCSV(self, Filename = 'Report.csv'):
                 if NewRecord != []:
                     File.write("""%s,%s,"%s",%s,%s,"%s"\n""" % (Index, ErrorID, EccToolError.gEccErrorMessage[ErrorID], NewRecord[0][1], NewRecord[0][0], OtherMsg))
                     EdkLogger.quiet("%s(%s): [%s]%s %s" % (NewRecord[0][1], NewRecord[0][0], ErrorID, EccToolError.gEccErrorMessage[ErrorID], OtherMsg))
-                    
+
             File.close()
         except IOError:
             NewFilename = 'Report_' + time.strftime("%Y%m%d_%H%M%S.csv", time.localtime())
diff --git a/BaseTools/Source/Python/Workspace/MetaFileParser.py b/BaseTools/Source/Python/Workspace/MetaFileParser.py
index e7d6df659590..451d8547d22b 100644
--- a/BaseTools/Source/Python/Workspace/MetaFileParser.py
+++ b/BaseTools/Source/Python/Workspace/MetaFileParser.py
@@ -1525,7 +1525,7 @@ def __ProcessPcd(self):
 
         ValList, Valid, Index = AnalyzeDscPcd(self._ValueList[2], self._ItemType)
         if not Valid:
-            EdkLogger.error('build', FORMAT_INVALID, "Pcd format incorrect.", File=self._FileWithError, Line=self._LineIndex+1,
+            EdkLogger.error('build', FORMAT_INVALID, "Pcd format incorrect.", File=self._FileWithError, Line=self._LineIndex + 1,
                             ExtraData="%s.%s|%s" % (self._ValueList[0], self._ValueList[1], self._ValueList[2]))
         PcdValue = ValList[Index]
         if PcdValue:
diff --git a/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py b/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
index 46eb5d3a8c2f..1f236e83ff51 100644
--- a/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
+++ b/BaseTools/Source/Python/Workspace/WorkspaceDatabase.py
@@ -1863,11 +1863,11 @@ def _GetHeaderInfo(self):
                         LineNo = Record[6]
                         break
                 EdkLogger.error("build", FORMAT_NOT_SUPPORTED,
-                                "MODULE_TYPE %s is not supported for EDK II, valid values are:\n %s" % (self._ModuleType,' '.join(l for l in SUP_MODULE_LIST)), 
+                                "MODULE_TYPE %s is not supported for EDK II, valid values are:\n %s" % (self._ModuleType, ' '.join(l for l in SUP_MODULE_LIST)),
                                 File=self.MetaFile, Line=LineNo)
             if (self._Specification == None) or (not 'PI_SPECIFICATION_VERSION' in self._Specification) or (int(self._Specification['PI_SPECIFICATION_VERSION'], 16) < 0x0001000A):
                 if self._ModuleType == SUP_MODULE_SMM_CORE:
-                    EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "SMM_CORE module type can't be used in the module with PI_SPECIFICATION_VERSION less than 0x0001000A", File=self.MetaFile)                
+                    EdkLogger.error("build", FORMAT_NOT_SUPPORTED, "SMM_CORE module type can't be used in the module with PI_SPECIFICATION_VERSION less than 0x0001000A", File=self.MetaFile)
             if self._Defs and 'PCI_DEVICE_ID' in self._Defs and 'PCI_VENDOR_ID' in self._Defs \
                and 'PCI_CLASS_CODE' in self._Defs:
                 self._BuildType = 'UEFI_OPTIONROM'
@@ -1876,7 +1876,7 @@ def _GetHeaderInfo(self):
                 self._BuildType = 'UEFI_HII'
             else:
                 self._BuildType = self._ModuleType.upper()
-            
+
             if self._DxsFile:
                 File = PathClass(NormPath(self._DxsFile), self._ModuleDir, Arch=self._Arch)
                 # check the file validation
@@ -1891,7 +1891,7 @@ def _GetHeaderInfo(self):
             if not self._ComponentType:
                 EdkLogger.error("build", ATTRIBUTE_NOT_AVAILABLE,
                                 "COMPONENT_TYPE is not given", File=self.MetaFile)
-            self._BuildType = self._ComponentType.upper()                
+            self._BuildType = self._ComponentType.upper()
             if self._ComponentType in self._MODULE_TYPE_:
                 self._ModuleType = self._MODULE_TYPE_[self._ComponentType]
             if self._ComponentType == 'LIBRARY':
@@ -1901,7 +1901,7 @@ def _GetHeaderInfo(self):
             Macros["EDK_SOURCE"] = GlobalData.gEcpSource
             Macros['PROCESSOR'] = self._Arch
             RecordList = self._RawData[MODEL_META_DATA_NMAKE, self._Arch, self._Platform]
-            for Name,Value,Dummy,Arch,Platform,ID,LineNo in RecordList:
+            for Name, Value, Dummy, Arch, Platform, ID, LineNo in RecordList:
                 Value = ReplaceMacro(Value, Macros, True)
                 if Name == "IMAGE_ENTRY_POINT":
                     if self._ModuleEntryPointList == None:
@@ -2584,7 +2584,7 @@ def _GetPcd(self, Type):
                                 'build',
                                 FORMAT_INVALID,
                                 "No TokenValue for PCD [%s.%s] in [%s]!" % (TokenSpaceGuid, PcdCName, str(Package)),
-                                File =self.MetaFile, Line=LineNo,
+                                File=self.MetaFile, Line=LineNo,
                                 ExtraData=None
                                 )                        
                     #
@@ -2597,7 +2597,7 @@ def _GetPcd(self, Type):
                                     'build',
                                     FORMAT_INVALID,
                                     "The format of TokenValue [%s] of PCD [%s.%s] in [%s] is invalid:" % (Pcd.TokenValue, TokenSpaceGuid, PcdCName, str(Package)),
-                                    File =self.MetaFile, Line=LineNo,
+                                    File=self.MetaFile, Line=LineNo,
                                     ExtraData=None
                                     )
                             
@@ -2611,19 +2611,19 @@ def _GetPcd(self, Type):
                                 EdkLogger.error(
                                             'build',
                                             FORMAT_INVALID,
-                                            "The format of TokenValue [%s] of PCD [%s.%s] in [%s] is invalid, as a decimal it should between: 0 - 4294967295!"% (Pcd.TokenValue, TokenSpaceGuid, PcdCName, str(Package)),
-                                            File =self.MetaFile, Line=LineNo,
+                                            "The format of TokenValue [%s] of PCD [%s.%s] in [%s] is invalid, as a decimal it should between: 0 - 4294967295!" % (Pcd.TokenValue, TokenSpaceGuid, PcdCName, str(Package)),
+                                            File=self.MetaFile, Line=LineNo,
                                             ExtraData=None
-                                            )                                
+                                            )
                         except:
                             EdkLogger.error(
                                         'build',
                                         FORMAT_INVALID,
-                                        "The format of TokenValue [%s] of PCD [%s.%s] in [%s] is invalid, it should be hexadecimal or decimal!"% (Pcd.TokenValue, TokenSpaceGuid, PcdCName, str(Package)),
-                                        File =self.MetaFile, Line=LineNo,
+                                        "The format of TokenValue [%s] of PCD [%s.%s] in [%s] is invalid, it should be hexadecimal or decimal!" % (Pcd.TokenValue, TokenSpaceGuid, PcdCName, str(Package)),
+                                        File=self.MetaFile, Line=LineNo,
                                         ExtraData=None
                                         )
-                    
+
                     Pcd.DatumType = PcdInPackage.DatumType
                     Pcd.MaxDatumSize = PcdInPackage.MaxDatumSize
                     Pcd.InfDefaultValue = Pcd.DefaultValue
@@ -2635,7 +2635,7 @@ def _GetPcd(self, Type):
                             'build',
                             FORMAT_INVALID,
                             "PCD [%s.%s] in [%s] is not found in dependent packages:" % (TokenSpaceGuid, PcdCName, self.MetaFile),
-                            File =self.MetaFile, Line=LineNo,
+                            File=self.MetaFile, Line=LineNo,
                             ExtraData="\t%s" % '\n\t'.join([str(P) for P in self.Packages])
                             )
             Pcds[PcdCName, TokenSpaceGuid] = Pcd
@@ -2946,7 +2946,7 @@ def Close(self):
     ## Summarize all packages in the database
     def GetPackageList(self, Platform, Arch, TargetName, ToolChainTag):
         self.Platform = Platform
-        PackageList =[]
+        PackageList = []
         Pa = self.BuildObject[self.Platform, 'COMMON']
         #
         # Get Package related to Modules
@@ -2963,8 +2963,8 @@ def GetPackageList(self, Platform, Arch, TargetName, ToolChainTag):
             LibObj = self.BuildObject[Lib, Arch, TargetName, ToolChainTag]
             for Package in LibObj.Packages:
                 if Package not in PackageList:
-                    PackageList.append(Package)            
-        
+                    PackageList.append(Package)
+
         return PackageList
 
     ## Summarize all platforms in the database
diff --git a/BaseTools/Source/Python/build/BuildReport.py b/BaseTools/Source/Python/build/BuildReport.py
index 38e55f3e07f6..722d8b7f458c 100644
--- a/BaseTools/Source/Python/build/BuildReport.py
+++ b/BaseTools/Source/Python/build/BuildReport.py
@@ -78,13 +78,13 @@
 gEndOfLine = "\r\n"
 
 ## Tags for section start, end and separator
-gSectionStart = ">" + "=" * (gLineMaxLength-2) + "<"
-gSectionEnd = "<" + "=" * (gLineMaxLength-2) + ">" + "\n"
+gSectionStart = ">" + "=" * (gLineMaxLength - 2) + "<"
+gSectionEnd = "<" + "=" * (gLineMaxLength - 2) + ">" + "\n"
 gSectionSep = "=" * gLineMaxLength
 
 ## Tags for subsection start, end and separator
-gSubSectionStart = ">" + "-" * (gLineMaxLength-2) + "<"
-gSubSectionEnd = "<" + "-" * (gLineMaxLength-2) + ">"
+gSubSectionStart = ">" + "-" * (gLineMaxLength - 2) + "<"
+gSubSectionEnd = "<" + "-" * (gLineMaxLength - 2) + ">"
 gSubSectionSep = "-" * gLineMaxLength
 
 
@@ -233,7 +233,7 @@ class DepexParser(object):
     def __init__(self, Wa):
         self._GuidDb = {}
         for Pa in Wa.AutoGenObjectList:
-            for Package in Pa.PackageList:        
+            for Package in Pa.PackageList:
                 for Protocol in Package.Protocols:
                     GuidValue = GuidStructureStringToGuidString(Package.Protocols[Protocol])
                     self._GuidDb[GuidValue.upper()] = Protocol
@@ -265,8 +265,8 @@ def ParseDepexFile(self, DepexFileName):
                 GuidString = self._GuidDb.get(GuidValue, GuidValue)
                 Statement = "%s %s" % (Statement, GuidString)
             DepexStatement.append(Statement)
-            OpCode = DepexFile.read(1)     
-        
+            OpCode = DepexFile.read(1)
+
         return DepexStatement
     
 ##
@@ -361,7 +361,7 @@ class DepexReport(object):
     #
     def __init__(self, M):
         self.Depex = ""
-        self._DepexFileName = os.path.join(M.BuildDir, "OUTPUT", M.Module.BaseName + ".depex") 
+        self._DepexFileName = os.path.join(M.BuildDir, "OUTPUT", M.Module.BaseName + ".depex")
         ModuleType = M.ModuleType
         if not ModuleType:
             ModuleType = gComponentType2ModuleType.get(M.ComponentType, "")
@@ -536,7 +536,7 @@ def __init__(self, M, ReportType):
             # If a module complies to PI 1.1, promote Module type to "SMM_DRIVER"
             #
             if ModuleType == "DXE_SMM_DRIVER":
-                PiSpec =  M.Module.Specification.get("PI_SPECIFICATION_VERSION", "0x00010000")
+                PiSpec = M.Module.Specification.get("PI_SPECIFICATION_VERSION", "0x00010000")
                 if int(PiSpec, 0) >= 0x0001000A:
                     ModuleType = "SMM_DRIVER"
             self.DriverType = gDriverTypeMap.get(ModuleType, "0x2 (FREE_FORM)")
@@ -813,20 +813,20 @@ def GenerateReport(self, File, ModulePcdSet):
                     # Report PCD item according to their override relationship
                     #
                     if DecMatch and InfMatch:
-                        FileWrite(File, '    %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '('+Pcd.DatumType+')', PcdValue.strip()))
+                        FileWrite(File, '    %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '(' + Pcd.DatumType + ')', PcdValue.strip()))
                     else:
                         if DscMatch:
                             if (Pcd.TokenCName, Key) in self.FdfPcdSet:
-                                FileWrite(File, ' *F %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '('+Pcd.DatumType+')', PcdValue.strip()))
+                                FileWrite(File, ' *F %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '(' + Pcd.DatumType + ')', PcdValue.strip()))
                             else:
-                                FileWrite(File, ' *P %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '('+Pcd.DatumType+')', PcdValue.strip()))
+                                FileWrite(File, ' *P %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '(' + Pcd.DatumType + ')', PcdValue.strip()))
                         else:
-                            FileWrite(File, ' *M %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '('+Pcd.DatumType+')', PcdValue.strip()))
-                    
+                            FileWrite(File, ' *M %-*s: %6s %10s = %-22s' % (self.MaxLen, Pcd.TokenCName, TypeName, '(' + Pcd.DatumType + ')', PcdValue.strip()))
+
                     if TypeName in ('DYNHII', 'DEXHII', 'DYNVPD', 'DEXVPD'):
                         for SkuInfo in Pcd.SkuInfoList.values():
                             if TypeName in ('DYNHII', 'DEXHII'):
-                                FileWrite(File, '%*s: %s: %s' % (self.MaxLen + 4, SkuInfo.VariableGuid, SkuInfo.VariableName, SkuInfo.VariableOffset))        
+                                FileWrite(File, '%*s: %s: %s' % (self.MaxLen + 4, SkuInfo.VariableGuid, SkuInfo.VariableName, SkuInfo.VariableOffset))
                             else:
                                 FileWrite(File, '%*s' % (self.MaxLen + 4, SkuInfo.VpdOffset))
                                
diff --git a/BaseTools/Source/Python/build/build.py b/BaseTools/Source/Python/build/build.py
index 6d83ac9701ba..3cd385d69d99 100644
--- a/BaseTools/Source/Python/build/build.py
+++ b/BaseTools/Source/Python/build/build.py
@@ -210,7 +210,7 @@ def NormFile(FilePath, Workspace):
 
     # check if the file path exists or not
     if not os.path.isfile(FileFullPath):
-        EdkLogger.error("build", FILE_NOT_FOUND, ExtraData="\t%s (Please give file in absolute path or relative to WORKSPACE)"  % FileFullPath)
+        EdkLogger.error("build", FILE_NOT_FOUND, ExtraData="\t%s (Please give file in absolute path or relative to WORKSPACE)" % FileFullPath)
 
     # remove workspace directory from the beginning part of the file path
     if Workspace[-1] in ["\\", "/"]:
@@ -1122,13 +1122,13 @@ def _RebaseModule (self, MapBuffer, BaseAddress, ModuleList, AddrIsOffset = True
                 # Update Image to new BaseAddress by GenFw tool
                 #
                 LaunchCommand(["GenFw", "--rebase", str(BaseAddress), "-r", ModuleOutputImage], ModuleInfo.OutputDir)
-                LaunchCommand(["GenFw", "--rebase", str(BaseAddress), "-r", ModuleDebugImage],  ModuleInfo.DebugDir)
+                LaunchCommand(["GenFw", "--rebase", str(BaseAddress), "-r", ModuleDebugImage], ModuleInfo.DebugDir)
             else:
                 #
                 # Set new address to the section header only for SMM driver.
                 #
                 LaunchCommand(["GenFw", "--address", str(BaseAddress), "-r", ModuleOutputImage], ModuleInfo.OutputDir)
-                LaunchCommand(["GenFw", "--address", str(BaseAddress), "-r", ModuleDebugImage],  ModuleInfo.DebugDir)
+                LaunchCommand(["GenFw", "--address", str(BaseAddress), "-r", ModuleDebugImage], ModuleInfo.DebugDir)
             #
             # Collect funtion address from Map file
             #
@@ -1136,7 +1136,7 @@ def _RebaseModule (self, MapBuffer, BaseAddress, ModuleList, AddrIsOffset = True
             FunctionList = []
             if os.path.exists(ImageMapTable):
                 OrigImageBaseAddress = 0
-                ImageMap = open (ImageMapTable, 'r')
+                ImageMap = open(ImageMapTable, 'r')
                 for LinStr in ImageMap:
                     if len (LinStr.strip()) == 0:
                         continue
@@ -1149,7 +1149,7 @@ def _RebaseModule (self, MapBuffer, BaseAddress, ModuleList, AddrIsOffset = True
 
                     StrList = LinStr.split()
                     if len (StrList) > 4:
-                        if StrList[3] == 'f' or StrList[3] =='F':
+                        if StrList[3] == 'f' or StrList[3] == 'F':
                             Name = StrList[1]
                             RelativeAddress = int (StrList[2], 16) - OrigImageBaseAddress
                             FunctionList.append ((Name, RelativeAddress))
@@ -1273,7 +1273,7 @@ def _CollectModuleMapBuffer (self, MapBuffer, ModuleList):
                     if not ImageClass.IsValid:
                         EdkLogger.error("build", FILE_PARSE_FAILURE, ExtraData=ImageClass.ErrorInfo)
                     ImageInfo = PeImageInfo(Module.Name, Module.Guid, Module.Arch, Module.OutputDir, Module.DebugDir, ImageClass)
-                    if Module.ModuleType in ['PEI_CORE', 'PEIM', 'COMBINED_PEIM_DRIVER','PIC_PEIM', 'RELOCATABLE_PEIM', 'DXE_CORE']:
+                    if Module.ModuleType in ['PEI_CORE', 'PEIM', 'COMBINED_PEIM_DRIVER', 'PIC_PEIM', 'RELOCATABLE_PEIM', 'DXE_CORE']:
                         PeiModuleList[Module.MetaFile] = ImageInfo
                         PeiSize += ImageInfo.Image.Size
                     elif Module.ModuleType in ['BS_DRIVER', 'DXE_DRIVER', 'UEFI_DRIVER']:
@@ -1354,21 +1354,21 @@ def _CollectModuleMapBuffer (self, MapBuffer, ModuleList):
             for PcdInfo in PcdTable:
                 ReturnValue = 0
                 if PcdInfo[0] == TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_PEI_PAGE_SIZE:
-                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_PEI_PAGE_SIZE_DATA_TYPE, str (PeiSize/0x1000))
+                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_PEI_PAGE_SIZE_DATA_TYPE, str (PeiSize / 0x1000))
                 elif PcdInfo[0] == TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_DXE_PAGE_SIZE:
-                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_DXE_PAGE_SIZE_DATA_TYPE, str (BtSize/0x1000))
+                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_DXE_PAGE_SIZE_DATA_TYPE, str (BtSize / 0x1000))
                 elif PcdInfo[0] == TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_RUNTIME_PAGE_SIZE:
-                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_RUNTIME_PAGE_SIZE_DATA_TYPE, str (RtSize/0x1000))
+                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_RUNTIME_PAGE_SIZE_DATA_TYPE, str (RtSize / 0x1000))
                 elif PcdInfo[0] == TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_SMM_PAGE_SIZE and len (SmmModuleList) > 0:
-                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_SMM_PAGE_SIZE_DATA_TYPE, str (SmmSize/0x1000))
+                    ReturnValue, ErrorInfo = PatchBinaryFile (EfiImage, PcdInfo[1], TAB_PCDS_PATCHABLE_LOAD_FIX_ADDRESS_SMM_PAGE_SIZE_DATA_TYPE, str (SmmSize / 0x1000))
                 if ReturnValue != 0:
                     EdkLogger.error("build", PARAMETER_INVALID, "Patch PCD value failed", ExtraData=ErrorInfo)
 
-        MapBuffer.write('PEI_CODE_PAGE_NUMBER      = 0x%x\n' % (PeiSize/0x1000))
-        MapBuffer.write('BOOT_CODE_PAGE_NUMBER     = 0x%x\n' % (BtSize/0x1000))
-        MapBuffer.write('RUNTIME_CODE_PAGE_NUMBER  = 0x%x\n' % (RtSize/0x1000))
+        MapBuffer.write('PEI_CODE_PAGE_NUMBER      = 0x%x\n' % (PeiSize / 0x1000))
+        MapBuffer.write('BOOT_CODE_PAGE_NUMBER     = 0x%x\n' % (BtSize / 0x1000))
+        MapBuffer.write('RUNTIME_CODE_PAGE_NUMBER  = 0x%x\n' % (RtSize / 0x1000))
         if len (SmmModuleList) > 0:
-            MapBuffer.write('SMM_CODE_PAGE_NUMBER      = 0x%x\n' % (SmmSize/0x1000))
+            MapBuffer.write('SMM_CODE_PAGE_NUMBER      = 0x%x\n' % (SmmSize / 0x1000))
 
         PeiBaseAddr = TopMemoryAddress - RtSize - BtSize
         BtBaseAddr  = TopMemoryAddress - RtSize
@@ -1377,7 +1377,7 @@ def _CollectModuleMapBuffer (self, MapBuffer, ModuleList):
         self._RebaseModule (MapBuffer, PeiBaseAddr, PeiModuleList, TopMemoryAddress == 0)
         self._RebaseModule (MapBuffer, BtBaseAddr, BtModuleList, TopMemoryAddress == 0)
         self._RebaseModule (MapBuffer, RtBaseAddr, RtModuleList, TopMemoryAddress == 0)
-        self._RebaseModule (MapBuffer, 0x1000, SmmModuleList, AddrIsOffset = False, ModeIsSmm = True)
+        self._RebaseModule (MapBuffer, 0x1000, SmmModuleList, AddrIsOffset=False, ModeIsSmm=True)
         MapBuffer.write('\n\n')
         sys.stdout.write ("\n")
         sys.stdout.flush()
@@ -1395,7 +1395,7 @@ def _SaveMapFile (self, MapBuffer, Wa):
         SaveFileOnChange(MapFilePath, MapBuffer.getvalue(), False)
         MapBuffer.close()
         if self.LoadFixAddress != 0:
-            sys.stdout.write ("\nLoad Module At Fix Address Map file can be found at %s\n" %(MapFilePath))
+            sys.stdout.write ("\nLoad Module At Fix Address Map file can be found at %s\n" % (MapFilePath))
         sys.stdout.flush()
 
     ## Build active platform for different build targets and different tool chains
@@ -1529,7 +1529,7 @@ def _BuildModule(self):
                                 BUILD_ERROR,
                                 "Module for [%s] is not a component of active platform."\
                                 " Please make sure that the ARCH and inf file path are"\
-                                " given in the same as in [%s]" %\
+                                " given in the same as in [%s]" % \
                                     (', '.join(Wa.ArchList), self.PlatformFile),
                                 ExtraData=self.ModuleFile
                                 )
@@ -1874,8 +1874,8 @@ def SingleCheckCallback(option, opt_str, value, parser):
 #   @retval Args  Target of build command
 #
 def MyOptionParser():
-    Parser = OptionParser(description=__copyright__,version=__version__,prog="build.exe",usage="%prog [options] [all|fds|genc|genmake|clean|cleanall|cleanlib|modules|libraries|run]")
-    Parser.add_option("-a", "--arch", action="append", type="choice", choices=['IA32','X64','IPF','EBC','ARM', 'AARCH64'], dest="TargetArch",
+    Parser = OptionParser(description=__copyright__, version=__version__, prog="build.exe", usage="%prog [options] [all|fds|genc|genmake|clean|cleanall|cleanlib|modules|libraries|run]")
+    Parser.add_option("-a", "--arch", action="append", type="choice", choices=['IA32', 'X64', 'IPF', 'EBC', 'ARM', 'AARCH64'], dest="TargetArch",
         help="ARCHS is one of list: IA32, X64, IPF, ARM, AARCH64 or EBC, which overrides target.txt's TARGET_ARCH definition. To specify more archs, please repeat this option.")
     Parser.add_option("-p", "--platform", action="callback", type="string", dest="PlatformFile", callback=SingleCheckCallback,
         help="Build the platform specified by the DSC file name argument, overriding target.txt's ACTIVE_PLATFORM definition.")
@@ -1917,7 +1917,7 @@ def MyOptionParser():
     Parser.add_option("-D", "--define", action="append", type="string", dest="Macros", help="Macro: \"Name [= Value]\".")
 
     Parser.add_option("-y", "--report-file", action="store", dest="ReportFile", help="Create/overwrite the report to the specified filename.")
-    Parser.add_option("-Y", "--report-type", action="append", type="choice", choices=['PCD','LIBRARY','FLASH','DEPEX','BUILD_FLAGS','FIXED_ADDRESS', 'EXECUTION_ORDER'], dest="ReportType", default=[],
+    Parser.add_option("-Y", "--report-type", action="append", type="choice", choices=['PCD', 'LIBRARY', 'FLASH', 'DEPEX', 'BUILD_FLAGS', 'FIXED_ADDRESS', 'EXECUTION_ORDER'], dest="ReportType", default=[],
         help="Flags that control the type of build report to generate.  Must be one of: [PCD, LIBRARY, FLASH, DEPEX, BUILD_FLAGS, FIXED_ADDRESS, EXECUTION_ORDER].  "\
              "To specify more than one flag, repeat this option on the command line and the default flag set is [PCD, LIBRARY, FLASH, DEPEX, BUILD_FLAGS, FIXED_ADDRESS]")
     Parser.add_option("-F", "--flag", action="store", type="string", dest="Flag",
@@ -1929,7 +1929,7 @@ def MyOptionParser():
     Parser.add_option("--check-usage", action="store_true", dest="CheckUsage", default=False, help="Check usage content of entries listed in INF file.")
     Parser.add_option("--ignore-sources", action="store_true", dest="IgnoreSources", default=False, help="Focus to a binary build and ignore all source files")
 
-    (Opt, Args)=Parser.parse_args()
+    (Opt, Args) = Parser.parse_args()
     return (Opt, Args)
 
 ## Tool entrance method
@@ -1985,13 +1985,13 @@ def Main():
             Target = "all"
         elif len(Target) >= 2:
             EdkLogger.error("build", OPTION_NOT_SUPPORTED, "More than one targets are not supported.",
-                            ExtraData="Please select one of: %s" %(' '.join(gSupportedTarget)))
+                            ExtraData="Please select one of: %s" % (' '.join(gSupportedTarget)))
         else:
             Target = Target[0].lower()
 
         if Target not in gSupportedTarget:
             EdkLogger.error("build", OPTION_NOT_SUPPORTED, "Not supported target [%s]." % Target,
-                            ExtraData="Please select one of: %s" %(' '.join(gSupportedTarget)))
+                            ExtraData="Please select one of: %s" % (' '.join(gSupportedTarget)))
 
         #
         # Check environment variable: EDK_TOOLS_PATH, WORKSPACE, PATH
@@ -2069,7 +2069,7 @@ def Main():
         if Option != None and Option.debug != None:
             EdkLogger.quiet("(Python %s on %s) " % (platform.python_version(), sys.platform) + traceback.format_exc())
         else:
-            EdkLogger.error(X.ToolName, FORMAT_INVALID, File=X.FileName, Line=X.LineNumber, ExtraData=X.Message, RaiseError = False)
+            EdkLogger.error(X.ToolName, FORMAT_INVALID, File=X.FileName, Line=X.LineNumber, ExtraData=X.Message, RaiseError=False)
         ReturnCode = FORMAT_INVALID
     except KeyboardInterrupt:
         ReturnCode = ABORT_ERROR
@@ -2110,7 +2110,7 @@ def Main():
     BuildDuration = time.gmtime(int(round(FinishTime - StartTime)))
     BuildDurationStr = ""
     if BuildDuration.tm_yday > 1:
-        BuildDurationStr = time.strftime("%H:%M:%S", BuildDuration) + ", %d day(s)"%(BuildDuration.tm_yday - 1)
+        BuildDurationStr = time.strftime("%H:%M:%S", BuildDuration) + ", %d day(s)" % (BuildDuration.tm_yday - 1)
     else:
         BuildDurationStr = time.strftime("%H:%M:%S", BuildDuration)
     if MyBuild != None:

From 7da20f7b917cf7c501c452db8f90b700e5d49cd1 Mon Sep 17 00:00:00 2001
From: Eugene Cohen <eugene@hp.com>
Date: Fri, 18 Dec 2015 06:44:26 +0000
Subject: [PATCH 272/525] BaseTools RVCT: add preprocessor preinclude for
 AutoGen.h

Ensure that AutoGen.h is force-included when the RVCT preprocessor
is invoked.

(Sync patch r19097 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eugene Cohen <eugene@hp.com>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19370 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Conf/tools_def.template | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index 88d4b4f3b6c9..d6b0af43d772 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -7152,7 +7152,7 @@ RELEASE_RVCT_ARM_DLINK_FLAGS     = $(ARCHDLINK_FLAGS) DEF(RVCT_ALL_DLINK_FLAGS)
 
 
 *_RVCT_ARM_ASM_FLAGS       = $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) DEF(RVCT_ALL_ASM_FLAGS)
-*_RVCT_ARM_PP_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -E
+*_RVCT_ARM_PP_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -E --preinclude AutoGen.h
 *_RVCT_ARM_VFRPP_FLAGS     = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -E  -DVFRCOMPILE --preinclude $(DEST_DIR_DEBUG)/$(MODULE_NAME)StrDefs.h
 *_RVCT_ARM_MAKE_PATH       = nmake /NOLOGO
 *_RVCT_ARM_SLINK_FLAGS     = --partial -o

From a166931e9404a5b42aa9955282d21d09a0a5df6d Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Fri, 18 Dec 2015 06:44:53 +0000
Subject: [PATCH 273/525] BaseTools PatchCheck.py: Support binary diff

This allows a patch with binary data that is generated with --binary
to be parsed by the PatchCheck.py script.

(Sync patch r19104 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19371 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Scripts/PatchCheck.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/BaseTools/Scripts/PatchCheck.py b/BaseTools/Scripts/PatchCheck.py
index 340a9972b838..455c1309b6d3 100644
--- a/BaseTools/Scripts/PatchCheck.py
+++ b/BaseTools/Scripts/PatchCheck.py
@@ -285,6 +285,10 @@ def run(self):
                 self.set_filename(line[6:].rstrip())
             if line.startswith('@@ '):
                 self.state = PATCH
+                self.binary = False
+            elif line.startswith('GIT binary patch'):
+                self.state = PATCH
+                self.binary = True
             else:
                 ok = False
                 for pfx in self.pre_patch_prefixes:
@@ -294,6 +298,8 @@ def run(self):
                     self.format_error("didn't find diff hunk marker (@@)")
             self.line_num += 1
         elif self.state == PATCH:
+            if self.binary:
+                pass
             if line.startswith('-'):
                 pass
             elif line.startswith('+'):

From 5fbc2feda298235bd54b38a1e2838db01501aca3 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:45:34 +0000
Subject: [PATCH 274/525] BaseTools: Add support for INF statement in FD region

FD region today can be file or data, but not a patched image.Add support
for an INF statement in an FD region, so the binary from the INF can be
patched prior to being added to the FD region.

(Sync patch r19136 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19372 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/GenFds/FdfParser.py   | 57 ++++++++++++-------
 .../Source/Python/GenFds/FfsInfStatement.py   | 44 +++++++++++++-
 BaseTools/Source/Python/GenFds/Region.py      | 21 ++++---
 3 files changed, 91 insertions(+), 31 deletions(-)

diff --git a/BaseTools/Source/Python/GenFds/FdfParser.py b/BaseTools/Source/Python/GenFds/FdfParser.py
index 664bf8e87d26..788190567eef 100644
--- a/BaseTools/Source/Python/GenFds/FdfParser.py
+++ b/BaseTools/Source/Python/GenFds/FdfParser.py
@@ -1,7 +1,7 @@
 ## @file
 # parse FDF file
 #
-#  Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 #  Copyright (c) 2015, Hewlett Packard Enterprise Development, L.P.<BR>
 #
 #  This program and the accompanying materials
@@ -1846,7 +1846,7 @@ def __GetRegionLayout(self, Fd):
         if not self.__GetNextWord():
             return True
 
-        if not self.__Token in ("SET", "FV", "FILE", "DATA", "CAPSULE"):
+        if not self.__Token in ("SET", "FV", "FILE", "DATA", "CAPSULE", "INF"):
             #
             # If next token is a word which is not a valid FV type, it might be part of [PcdOffset[|PcdSize]]
             # Or it might be next region's offset described by an expression which starts with a PCD.
@@ -1887,17 +1887,27 @@ def __GetRegionLayout(self, Fd):
 
         elif self.__Token == "FILE":
             self.__UndoToken()
-            self.__GetRegionFileType( RegionObj)
+            self.__GetRegionFileType(RegionObj)
+
+        elif self.__Token == "INF":
+            self.__UndoToken()
+            RegionObj.RegionType = "INF"
+            while self.__IsKeyword("INF"):
+                self.__UndoToken()
+                ffsInf = self.__ParseInfStatement()
+                if not ffsInf:
+                    break
+                RegionObj.RegionDataList.append(ffsInf)
 
         elif self.__Token == "DATA":
             self.__UndoToken()
-            self.__GetRegionDataType( RegionObj)
+            self.__GetRegionDataType(RegionObj)
         else:
             self.__UndoToken()
             if self.__GetRegionLayout(Fd):
                 return True
             raise Warning("A valid region type was not found. "
-                          "Valid types are [SET, FV, CAPSULE, FILE, DATA]. This error occurred",
+                          "Valid types are [SET, FV, CAPSULE, FILE, DATA, INF]. This error occurred",
                           self.FileName, self.CurrentLineNumber)
 
         return True
@@ -2426,23 +2436,12 @@ def __GetAprioriSection(self, FvObj, MacroDict = {}):
         FvObj.AprioriSectionList.append(AprSectionObj)
         return True
 
-    ## __GetInfStatement() method
-    #
-    #   Get INF statements
-    #
-    #   @param  self        The object pointer
-    #   @param  Obj         for whom inf statement is got
-    #   @param  MacroDict   dictionary used to replace macro
-    #   @retval True        Successfully find inf statement
-    #   @retval False       Not able to find inf statement
-    #
-    def __GetInfStatement(self, Obj, ForCapsule = False, MacroDict = {}):
-
-        if not self.__IsKeyword( "INF"):
-            return False
+    def __ParseInfStatement(self):
+        if not self.__IsKeyword("INF"):
+            return None
 
         ffsInf = FfsInfStatement.FfsInfStatement()
-        self.__GetInfOptions( ffsInf)
+        self.__GetInfOptions(ffsInf)
 
         if not self.__GetNextToken():
             raise Warning("expected INF file path", self.FileName, self.CurrentLineNumber)
@@ -2472,7 +2471,23 @@ def __GetInfStatement(self, Obj, ForCapsule = False, MacroDict = {}):
                 ffsInf.KeepReloc = True
             else:
                 raise Warning("Unknown reloc strip flag '%s'" % self.__Token, self.FileName, self.CurrentLineNumber)
-        
+        return ffsInf
+
+    ## __GetInfStatement() method
+    #
+    #   Get INF statements
+    #
+    #   @param  self        The object pointer
+    #   @param  Obj         for whom inf statement is got
+    #   @param  MacroDict   dictionary used to replace macro
+    #   @retval True        Successfully find inf statement
+    #   @retval False       Not able to find inf statement
+    #
+    def __GetInfStatement(self, Obj, ForCapsule=False, MacroDict={}):
+        ffsInf = self.__ParseInfStatement()
+        if not ffsInf:
+            return False
+
         if ForCapsule:
             capsuleFfs = CapsuleData.CapsuleFfs()
             capsuleFfs.Ffs = ffsInf
diff --git a/BaseTools/Source/Python/GenFds/FfsInfStatement.py b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
index ed767d3fa698..7b221399b401 100644
--- a/BaseTools/Source/Python/GenFds/FfsInfStatement.py
+++ b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
@@ -331,25 +331,63 @@ def __InfParse__(self, Dict = {}):
     #           If passed in file does not end with efi, return as is
     #
     def PatchEfiFile(self, EfiFile, FileType):
+        #
+        # If the module does not have any patches, then return path to input file
+        #  
         if not self.PatchPcds:
             return EfiFile
+
+        #
+        # Only patch file if FileType is PE32 or ModuleType is USER_DEFINED
+        #  
         if FileType != 'PE32' and self.ModuleType != "USER_DEFINED":
             return EfiFile
+
+        #
+        # Generate path to patched output file
+        #
+        Basename = os.path.basename(EfiFile)
+        Output = os.path.normpath (os.path.join(self.OutputPath, Basename))
+
+        #
+        # If this file has already been patched, then return the path to the patched file
+        #
+        if self.PatchedBinFile == Output:
+          return Output
+
+        #
+        # If a different file from the same module has already been patched, then generate an error
+        #  
         if self.PatchedBinFile:
             EdkLogger.error("GenFds", GENFDS_ERROR,
                             'Only one binary file can be patched:\n'
                             '  a binary file has been patched: %s\n'
                             '  current file: %s' % (self.PatchedBinFile, EfiFile),
                             File=self.InfFileName)
-        Basename = os.path.basename(EfiFile)
-        Output = os.path.join(self.OutputPath, Basename)
+
+        #
+        # Copy unpatched file contents to output file location to perform patching
+        #  
         CopyLongFilePath(EfiFile, Output)
+
+        #
+        # Apply patches to patched output file
+        #  
         for Pcd, Value in self.PatchPcds:
             RetVal, RetStr = PatchBinaryFile(Output, int(Pcd.Offset, 0), Pcd.DatumType, Value, Pcd.MaxDatumSize)
             if RetVal:
                 EdkLogger.error("GenFds", GENFDS_ERROR, RetStr, File=self.InfFileName)
-        self.PatchedBinFile = os.path.normpath(EfiFile)
+
+        #
+        # Save the path of the patched output file
+        #  
+        self.PatchedBinFile = Output
+
+        #
+        # Return path to patched output file
+        #  
         return Output
+
     ## GenFfs() method
     #
     #   Generate FFS
diff --git a/BaseTools/Source/Python/GenFds/Region.py b/BaseTools/Source/Python/GenFds/Region.py
index 01e998e54c6f..8734635fda29 100644
--- a/BaseTools/Source/Python/GenFds/Region.py
+++ b/BaseTools/Source/Python/GenFds/Region.py
@@ -1,7 +1,7 @@
 ## @file
 # process FD Region generation
 #
-#  Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -202,13 +202,20 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                 for i in range(0, Size):
                     Buffer.write(pack('B', PadData))
 
-        if self.RegionType == 'FILE':
+        if self.RegionType in ('FILE', 'INF'):
             for RegionData in self.RegionDataList:
-                RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
-                if RegionData[1] != ':' :
-                    RegionData = mws.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
-                if not os.path.exists(RegionData):
-                    EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
+                if self.RegionType == 'INF':
+                    RegionData.__InfParse__(None)
+                    if len(RegionData.BinFileList) != 1:
+                        EdkLogger.error('GenFds', GENFDS_ERROR, 'INF in FD region can only contain one binary: %s' % RegionData)
+                    File = RegionData.BinFileList[0]
+                    RegionData = RegionData.PatchEfiFile(File.Path, File.Type)
+                else:
+                    RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
+                    if RegionData[1] != ':' :
+                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
+                    if not os.path.exists(RegionData):
+                        EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
                 #
                 # Add the file image into FD buffer
                 #

From 9ada9cb84cb0693d545a0286f940afaa79765e04 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:46:23 +0000
Subject: [PATCH 275/525] BaseTools: Enhance GenFv Tool to report error message

When two vtf files in one FV image, no FV file can be generated, but it
report the stack trace info. so we enhance the tool to report error
message directly but not the stack trace info.

(Sync patch r19137 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19373 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Source/C/Include/Common/BuildVersion.h    |  2 +-
 BaseTools/Source/Python/GenFds/Fv.py          | 43 ++++++++++---------
 2 files changed, 24 insertions(+), 21 deletions(-)

diff --git a/BaseTools/Source/C/Include/Common/BuildVersion.h b/BaseTools/Source/C/Include/Common/BuildVersion.h
index d5bc56cb873c..8bfa74114022 100644
--- a/BaseTools/Source/C/Include/Common/BuildVersion.h
+++ b/BaseTools/Source/C/Include/Common/BuildVersion.h
@@ -12,4 +12,4 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 **/
 
-#define __BUILD_VERSION ""
+#define __BUILD_VERSION "Build 99862"
diff --git a/BaseTools/Source/Python/GenFds/Fv.py b/BaseTools/Source/Python/GenFds/Fv.py
index 163ccd37f158..df97ccbab648 100644
--- a/BaseTools/Source/Python/GenFds/Fv.py
+++ b/BaseTools/Source/Python/GenFds/Fv.py
@@ -181,30 +181,33 @@ def AddToBuffer (self, Buffer, BaseAddress=None, BlockSize= None, BlockNum=None,
         #
         # Write the Fv contents to Buffer
         #
-        FvFileObj = open ( FvOutputFile,'r+b')
+        if os.path.isfile(FvOutputFile):
+            FvFileObj = open ( FvOutputFile,'r+b')
 
-        GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
-        GenFdsGlobalVariable.SharpCounter = 0
+            GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
+            GenFdsGlobalVariable.SharpCounter = 0
 
-        Buffer.write(FvFileObj.read())
-        FvFileObj.seek(0)
-        # PI FvHeader is 0x48 byte
-        FvHeaderBuffer = FvFileObj.read(0x48)
-        # FV alignment position.
-        FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
-        # FvAlignmentValue is larger than or equal to 1K
-        if FvAlignmentValue >= 0x400:
-            if FvAlignmentValue >= 0x10000:
-                #The max alignment supported by FFS is 64K.
-                self.FvAlignment = "64K"
+            Buffer.write(FvFileObj.read())
+            FvFileObj.seek(0)
+            # PI FvHeader is 0x48 byte
+            FvHeaderBuffer = FvFileObj.read(0x48)
+            # FV alignment position.
+            FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
+            # FvAlignmentValue is larger than or equal to 1K
+            if FvAlignmentValue >= 0x400:
+                if FvAlignmentValue >= 0x10000:
+                    #The max alignment supported by FFS is 64K.
+                    self.FvAlignment = "64K"
+                else:
+                    self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
             else:
-                self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
+                # FvAlignmentValue is less than 1K
+                self.FvAlignment = str (FvAlignmentValue)
+            FvFileObj.close()
+            GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
+            GenFdsGlobalVariable.LargeFileInFvFlags.pop()
         else:
-            # FvAlignmentValue is less than 1K
-            self.FvAlignment = str (FvAlignmentValue)
-        FvFileObj.close()
-        GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
-        GenFdsGlobalVariable.LargeFileInFvFlags.pop()
+            GenFdsGlobalVariable.ErrorLogger("Failed to generate %s FV file." %self.UiFvName)
         return FvOutputFile
 
     ## _GetBlockSize()

From e6ad964ec7a1f6f98a2b14d374541c02f48fdf2e Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:47:07 +0000
Subject: [PATCH 276/525] Revert the change in r19137.

(Sync patch r19138 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19374 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Source/C/Include/Common/BuildVersion.h    |  2 +-
 BaseTools/Source/Python/GenFds/Fv.py          | 43 +++++++++----------
 2 files changed, 21 insertions(+), 24 deletions(-)

diff --git a/BaseTools/Source/C/Include/Common/BuildVersion.h b/BaseTools/Source/C/Include/Common/BuildVersion.h
index 8bfa74114022..d5bc56cb873c 100644
--- a/BaseTools/Source/C/Include/Common/BuildVersion.h
+++ b/BaseTools/Source/C/Include/Common/BuildVersion.h
@@ -12,4 +12,4 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 **/
 
-#define __BUILD_VERSION "Build 99862"
+#define __BUILD_VERSION ""
diff --git a/BaseTools/Source/Python/GenFds/Fv.py b/BaseTools/Source/Python/GenFds/Fv.py
index df97ccbab648..163ccd37f158 100644
--- a/BaseTools/Source/Python/GenFds/Fv.py
+++ b/BaseTools/Source/Python/GenFds/Fv.py
@@ -181,33 +181,30 @@ def AddToBuffer (self, Buffer, BaseAddress=None, BlockSize= None, BlockNum=None,
         #
         # Write the Fv contents to Buffer
         #
-        if os.path.isfile(FvOutputFile):
-            FvFileObj = open ( FvOutputFile,'r+b')
+        FvFileObj = open ( FvOutputFile,'r+b')
 
-            GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
-            GenFdsGlobalVariable.SharpCounter = 0
+        GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
+        GenFdsGlobalVariable.SharpCounter = 0
 
-            Buffer.write(FvFileObj.read())
-            FvFileObj.seek(0)
-            # PI FvHeader is 0x48 byte
-            FvHeaderBuffer = FvFileObj.read(0x48)
-            # FV alignment position.
-            FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
-            # FvAlignmentValue is larger than or equal to 1K
-            if FvAlignmentValue >= 0x400:
-                if FvAlignmentValue >= 0x10000:
-                    #The max alignment supported by FFS is 64K.
-                    self.FvAlignment = "64K"
-                else:
-                    self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
+        Buffer.write(FvFileObj.read())
+        FvFileObj.seek(0)
+        # PI FvHeader is 0x48 byte
+        FvHeaderBuffer = FvFileObj.read(0x48)
+        # FV alignment position.
+        FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
+        # FvAlignmentValue is larger than or equal to 1K
+        if FvAlignmentValue >= 0x400:
+            if FvAlignmentValue >= 0x10000:
+                #The max alignment supported by FFS is 64K.
+                self.FvAlignment = "64K"
             else:
-                # FvAlignmentValue is less than 1K
-                self.FvAlignment = str (FvAlignmentValue)
-            FvFileObj.close()
-            GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
-            GenFdsGlobalVariable.LargeFileInFvFlags.pop()
+                self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
         else:
-            GenFdsGlobalVariable.ErrorLogger("Failed to generate %s FV file." %self.UiFvName)
+            # FvAlignmentValue is less than 1K
+            self.FvAlignment = str (FvAlignmentValue)
+        FvFileObj.close()
+        GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
+        GenFdsGlobalVariable.LargeFileInFvFlags.pop()
         return FvOutputFile
 
     ## _GetBlockSize()

From b30dd623c9151866cd1ef1cf31de62d415586875 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:47:44 +0000
Subject: [PATCH 277/525] BaseTools: Fix a bug in the VPD report generation

Changed the if condition to check whether current Region is FD VPD region
to fix a bug in the VPD report generation.

(Sync patch r19139 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19375 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/build/BuildReport.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/Python/build/BuildReport.py b/BaseTools/Source/Python/build/BuildReport.py
index 722d8b7f458c..d459a0113acb 100644
--- a/BaseTools/Source/Python/build/BuildReport.py
+++ b/BaseTools/Source/Python/build/BuildReport.py
@@ -1389,11 +1389,11 @@ def __init__(self, Fd, Wa):
         self.FdRegionList = [FdRegionReport(FdRegion, Wa) for FdRegion in Fd.RegionList]
         self.FvPath = os.path.join(Wa.BuildDir, "FV")
         self.VpdFilePath = os.path.join(self.FvPath, "%s.map" % Wa.Platform.VpdToolGuid)
-        VpdPcdToken = 'gEfiMdeModulePkgTokenSpaceGuid'
-        VpdPcdName = 'PcdVpdBaseAddress'
+        self.VPDBaseAddress = 0
+        self.VPDSize = 0
         self.VPDInfoList = []
         for index, FdRegion in enumerate(Fd.RegionList):
-            if (VpdPcdName, VpdPcdToken) == FdRegion.PcdOffset:
+            if str(FdRegion.RegionType) is 'FILE' and Wa.Platform.VpdToolGuid in str(FdRegion.RegionDataList):
                 self.VPDBaseAddress = self.FdRegionList[index].BaseAddress
                 self.VPDSize = self.FdRegionList[index].Size
                 break

From 8e3314b048ed8efac7d743d23a32f89634055bac Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:48:32 +0000
Subject: [PATCH 278/525] BaseTools: Enhance GenFv Tool to report error message

When two vtf files in one FV image, no FV file can be generated, but it
report the stack trace info. so we enhance the tool to report error
message directly but not the stack trace info.

(Sync patch r19141 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19376 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/C/GenFv/GenFvInternalLib.c | 23 +++++------
 BaseTools/Source/Python/GenFds/Fv.py        | 43 +++++++++++----------
 2 files changed, 35 insertions(+), 31 deletions(-)

diff --git a/BaseTools/Source/C/GenFv/GenFvInternalLib.c b/BaseTools/Source/C/GenFv/GenFvInternalLib.c
index 6d2d5d1f8c67..10bb88b0a88c 100644
--- a/BaseTools/Source/C/GenFv/GenFvInternalLib.c
+++ b/BaseTools/Source/C/GenFv/GenFvInternalLib.c
@@ -2854,17 +2854,18 @@ Routine Description:
     fclose (fpin);
     
     if (FvInfoPtr->IsPiFvImage) {
-	    //
-	    // Check whether this ffs file is vtf file
-	    //
-	    if (IsVtfFile (&FfsHeader)) {
-	      if (VtfFileFlag) {
-	        //
-	        // One Fv image can't have two vtf files.
-	        //
-	        return EFI_ABORTED;
-	      }
-	      VtfFileFlag = TRUE;
+        //
+        // Check whether this ffs file is vtf file
+        //
+        if (IsVtfFile (&FfsHeader)) {
+          if (VtfFileFlag) {
+            //
+            // One Fv image can't have two vtf files.
+            //
+            Error (NULL, 0, 3000,"Invalid", "One Fv image can't have two vtf files.");
+            return EFI_ABORTED;
+          }
+          VtfFileFlag = TRUE;
         VtfFileSize = FfsFileSize;
         continue;
       }
diff --git a/BaseTools/Source/Python/GenFds/Fv.py b/BaseTools/Source/Python/GenFds/Fv.py
index 163ccd37f158..df97ccbab648 100644
--- a/BaseTools/Source/Python/GenFds/Fv.py
+++ b/BaseTools/Source/Python/GenFds/Fv.py
@@ -181,30 +181,33 @@ def AddToBuffer (self, Buffer, BaseAddress=None, BlockSize= None, BlockNum=None,
         #
         # Write the Fv contents to Buffer
         #
-        FvFileObj = open ( FvOutputFile,'r+b')
+        if os.path.isfile(FvOutputFile):
+            FvFileObj = open ( FvOutputFile,'r+b')
 
-        GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
-        GenFdsGlobalVariable.SharpCounter = 0
+            GenFdsGlobalVariable.VerboseLogger( "\nGenerate %s FV Successfully" %self.UiFvName)
+            GenFdsGlobalVariable.SharpCounter = 0
 
-        Buffer.write(FvFileObj.read())
-        FvFileObj.seek(0)
-        # PI FvHeader is 0x48 byte
-        FvHeaderBuffer = FvFileObj.read(0x48)
-        # FV alignment position.
-        FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
-        # FvAlignmentValue is larger than or equal to 1K
-        if FvAlignmentValue >= 0x400:
-            if FvAlignmentValue >= 0x10000:
-                #The max alignment supported by FFS is 64K.
-                self.FvAlignment = "64K"
+            Buffer.write(FvFileObj.read())
+            FvFileObj.seek(0)
+            # PI FvHeader is 0x48 byte
+            FvHeaderBuffer = FvFileObj.read(0x48)
+            # FV alignment position.
+            FvAlignmentValue = 1 << (ord (FvHeaderBuffer[0x2E]) & 0x1F)
+            # FvAlignmentValue is larger than or equal to 1K
+            if FvAlignmentValue >= 0x400:
+                if FvAlignmentValue >= 0x10000:
+                    #The max alignment supported by FFS is 64K.
+                    self.FvAlignment = "64K"
+                else:
+                    self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
             else:
-                self.FvAlignment = str (FvAlignmentValue / 0x400) + "K"
+                # FvAlignmentValue is less than 1K
+                self.FvAlignment = str (FvAlignmentValue)
+            FvFileObj.close()
+            GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
+            GenFdsGlobalVariable.LargeFileInFvFlags.pop()
         else:
-            # FvAlignmentValue is less than 1K
-            self.FvAlignment = str (FvAlignmentValue)
-        FvFileObj.close()
-        GenFds.ImageBinDict[self.UiFvName.upper() + 'fv'] = FvOutputFile
-        GenFdsGlobalVariable.LargeFileInFvFlags.pop()
+            GenFdsGlobalVariable.ErrorLogger("Failed to generate %s FV file." %self.UiFvName)
         return FvOutputFile
 
     ## _GetBlockSize()

From 7182a9146f26fa424deccf3c8d0b691cc5bd3c23 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:49:12 +0000
Subject: [PATCH 279/525] BaseTools: Fix a bug when apply patches to SEC use
 the FILE_GUID override

Fix a bug when applying patches to SEC modules that use the FILE_GUID
override. Since a temp dir is used when FILE_GUID override is used, the
INF file path comparisons fail. The fix is to capture the real INF file
path comparisons instead of using the temp dir path to the INF.

(Sync patch r19142 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19377 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/GenFds/FfsInfStatement.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/BaseTools/Source/Python/GenFds/FfsInfStatement.py b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
index 7b221399b401..864e5be7d9e0 100644
--- a/BaseTools/Source/Python/GenFds/FfsInfStatement.py
+++ b/BaseTools/Source/Python/GenFds/FfsInfStatement.py
@@ -174,6 +174,10 @@ def __InfParse__(self, Dict = {}):
         if ErrorCode != 0:
             EdkLogger.error("GenFds", ErrorCode, ExtraData=ErrorInfo)
 
+        #
+        # Cache lower case version of INF path before processing FILE_GUID override
+        #
+        InfLowerPath = str(PathClassObj).lower()
         if self.OverrideGuid:
             PathClassObj = ProcessDuplicatedInf(PathClassObj, self.OverrideGuid, GenFdsGlobalVariable.WorkSpaceDir)
         if self.CurrentArch != None:
@@ -241,7 +245,6 @@ def __InfParse__(self, Dict = {}):
                 continue
             # Override Patchable PCD value by the value from DSC
             PatchPcd = None
-            InfLowerPath = str(PathClassObj).lower()
             if InfLowerPath in DscModules and PcdKey in DscModules[InfLowerPath].Pcds:
                 PatchPcd = DscModules[InfLowerPath].Pcds[PcdKey]
             elif PcdKey in Platform.Pcds:

From f91c838c59db44a2ed89dc55e4d5ce075772eb5f Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:49:46 +0000
Subject: [PATCH 280/525] BaseTools: process the files by the priority in
 BUILDRULEORDER

By the BUILDRULEORDER feature to process files listed in INF [Sources]
sections in priority order, if a filename is listed with multiple
extensions, the tools will use only the file that matches the first
extension in the space separated list.

(Sync patch r19143 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19378 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 27 ++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index 4c627dfb555a..cf0b4466f992 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -2713,9 +2713,36 @@ def _GetSourceFileList(self):
                 if F.Dir not in self.IncludePathList and self.AutoGenVersion >= 0x00010005:
                     self.IncludePathList.insert(0, F.Dir)
                 self._SourceFileList.append(F)
+
+            self._MatchBuildRuleOrder(self._SourceFileList)
+
+            for F in self._SourceFileList:
                 self._ApplyBuildRule(F, TAB_UNKNOWN_FILE)
         return self._SourceFileList
 
+    def _MatchBuildRuleOrder(self, FileList):
+        Order_Dict = {}
+        self._GetModuleBuildOption()
+        for SingleFile in FileList:
+            if self.BuildRuleOrder and SingleFile.Ext in self.BuildRuleOrder:
+                key = SingleFile.Path.split(SingleFile.Ext)[0]
+                if key in Order_Dict:
+                    Order_Dict[key].append(SingleFile.Ext)
+                else:
+                    Order_Dict[key] = [SingleFile.Ext]
+
+        RemoveList = []
+        for F in Order_Dict:
+            if len(Order_Dict[F]) > 1:
+                Order_Dict[F].sort(key=lambda i: self.BuildRuleOrder.index(i))
+                for Ext in Order_Dict[F][1:]:
+                    RemoveList.append(F + Ext)
+                   
+        for item in RemoveList:
+            FileList.remove(item)
+
+        return FileList
+
     ## Return the list of unicode files
     def _GetUnicodeFileList(self):
         if self._UnicodeFileList == None:

From 57b4b9977d0a45a90a7c784bc3bd9036d674e6ef Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:50:15 +0000
Subject: [PATCH 281/525] BaseTools: update man page to add some descriptions

add the description for --ignore-sources and --check-usage into man page.

(Sync patch r19144 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19379 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UserManuals/Build_Utility_Man_Page.rtf    | 723 +++++++++---------
 1 file changed, 378 insertions(+), 345 deletions(-)

diff --git a/BaseTools/UserManuals/Build_Utility_Man_Page.rtf b/BaseTools/UserManuals/Build_Utility_Man_Page.rtf
index 6a0e7d996850..af3a071ad6a6 100644
--- a/BaseTools/UserManuals/Build_Utility_Man_Page.rtf
+++ b/BaseTools/UserManuals/Build_Utility_Man_Page.rtf
@@ -1,29 +1,31 @@
-{\rtf1\adeflang1025\ansi\ansicpg936\uc2\adeff0\deff0\stshfdbch13\stshfloch37\stshfhich37\stshfbi0\deflang1033\deflangfe2052\themelang1033\themelangfe2052\themelangcs0{\fonttbl{\f0\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}
+{\rtf1\adeflang1025\ansi\ansicpg1252\uc2\adeff0\deff0\stshfdbch13\stshfloch37\stshfhich37\stshfbi0\deflang1033\deflangfe2052\themelang1033\themelangfe2052\themelangcs0{\fonttbl{\f0\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}
 {\f2\fbidi \fmodern\fcharset0\fprq1{\*\panose 02070309020205020404}Courier New{\*\falt Courier New};}{\f13\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}\'cb\'ce\'cc\'e5{\*\falt SimSun};}
-{\f34\fbidi \froman\fcharset1\fprq2{\*\panose 02040503050406030204}Cambria Math;}{\f36\fbidi \froman\fcharset0\fprq2{\*\panose 02040503050406030204}Cambria;}
-{\f37\fbidi \fswiss\fcharset0\fprq2{\*\panose 020f0502020204030204}Calibri{\*\falt Century Gothic};}{\f38\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604030504040204}Tahoma{\*\falt Times New Roman};}
-{\f40\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}@\'cb\'ce\'cc\'e5;}{\f41\fbidi \fswiss\fcharset0\fprq2{\*\panose 00000000000000000000}Verdana{\*\falt Verdana};}
-{\f42\fbidi \fmodern\fcharset0\fprq1{\*\panose 00000000000000000000}Consolas;}{\flomajor\f31500\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}
-{\fdbmajor\f31501\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}\'cb\'ce\'cc\'e5{\*\falt SimSun};}{\fhimajor\f31502\fbidi \froman\fcharset0\fprq2{\*\panose 02040503050406030204}Cambria;}
+{\f34\fbidi \froman\fcharset0\fprq2{\*\panose 02040503050406030204}Cambria Math;}{\f37\fbidi \fswiss\fcharset0\fprq2{\*\panose 020f0502020204030204}Calibri{\*\falt Century Gothic};}
+{\f39\fbidi \froman\fcharset0\fprq2{\*\panose 00000000000000000000}Cambria;}{\f40\fbidi \fswiss\fcharset0\fprq2{\*\panose 00000000000000000000}Tahoma{\*\falt Times New Roman};}
+{\f41\fbidi \fnil\fcharset134\fprq2{\*\panose 00000000000000000000}@\'cb\'ce\'cc\'e5;}{\f42\fbidi \fswiss\fcharset0\fprq2{\*\panose 020b0604030504040204}Verdana{\*\falt Verdana};}
+{\f43\fbidi \fmodern\fcharset0\fprq1{\*\panose 020b0609020204030204}Consolas;}{\flomajor\f31500\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}
+{\fdbmajor\f31501\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}\'cb\'ce\'cc\'e5{\*\falt SimSun};}{\fhimajor\f31502\fbidi \froman\fcharset0\fprq2{\*\panose 00000000000000000000}Cambria;}
 {\fbimajor\f31503\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}{\flominor\f31504\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}
 {\fdbminor\f31505\fbidi \fnil\fcharset134\fprq2{\*\panose 02010600030101010101}\'cb\'ce\'cc\'e5{\*\falt SimSun};}{\fhiminor\f31506\fbidi \fswiss\fcharset0\fprq2{\*\panose 020f0502020204030204}Calibri{\*\falt Century Gothic};}
-{\fbiminor\f31507\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}{\f44\fbidi \froman\fcharset238\fprq2 Times New Roman CE{\*\falt Times};}
-{\f45\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr{\*\falt Times};}{\f47\fbidi \froman\fcharset161\fprq2 Times New Roman Greek{\*\falt Times};}{\f48\fbidi \froman\fcharset162\fprq2 Times New Roman Tur{\*\falt Times};}
-{\f49\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew){\*\falt Times};}{\f50\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic){\*\falt Times};}{\f51\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic{\*\falt Times};}
-{\f52\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese){\*\falt Times};}{\f64\fbidi \fmodern\fcharset238\fprq1 Courier New CE{\*\falt Courier New};}{\f65\fbidi \fmodern\fcharset204\fprq1 Courier New Cyr{\*\falt Courier New};}
-{\f67\fbidi \fmodern\fcharset161\fprq1 Courier New Greek{\*\falt Courier New};}{\f68\fbidi \fmodern\fcharset162\fprq1 Courier New Tur{\*\falt Courier New};}{\f69\fbidi \fmodern\fcharset177\fprq1 Courier New (Hebrew){\*\falt Courier New};}
-{\f70\fbidi \fmodern\fcharset178\fprq1 Courier New (Arabic){\*\falt Courier New};}{\f71\fbidi \fmodern\fcharset186\fprq1 Courier New Baltic{\*\falt Courier New};}{\f72\fbidi \fmodern\fcharset163\fprq1 Courier New (Vietnamese){\*\falt Courier New};}
-{\f176\fbidi \fnil\fcharset0\fprq2 SimSun Western{\*\falt SimSun};}{\f404\fbidi \froman\fcharset238\fprq2 Cambria CE;}{\f405\fbidi \froman\fcharset204\fprq2 Cambria Cyr;}{\f407\fbidi \froman\fcharset161\fprq2 Cambria Greek;}
-{\f408\fbidi \froman\fcharset162\fprq2 Cambria Tur;}{\f411\fbidi \froman\fcharset186\fprq2 Cambria Baltic;}{\f412\fbidi \froman\fcharset163\fprq2 Cambria (Vietnamese);}{\f414\fbidi \fswiss\fcharset238\fprq2 Calibri CE{\*\falt Century Gothic};}
-{\f415\fbidi \fswiss\fcharset204\fprq2 Calibri Cyr{\*\falt Century Gothic};}{\f417\fbidi \fswiss\fcharset161\fprq2 Calibri Greek{\*\falt Century Gothic};}{\f418\fbidi \fswiss\fcharset162\fprq2 Calibri Tur{\*\falt Century Gothic};}
-{\f421\fbidi \fswiss\fcharset186\fprq2 Calibri Baltic{\*\falt Century Gothic};}{\f422\fbidi \fswiss\fcharset163\fprq2 Calibri (Vietnamese){\*\falt Century Gothic};}{\f424\fbidi \fswiss\fcharset238\fprq2 Tahoma CE{\*\falt Times New Roman};}
-{\f425\fbidi \fswiss\fcharset204\fprq2 Tahoma Cyr{\*\falt Times New Roman};}{\f427\fbidi \fswiss\fcharset161\fprq2 Tahoma Greek{\*\falt Times New Roman};}{\f428\fbidi \fswiss\fcharset162\fprq2 Tahoma Tur{\*\falt Times New Roman};}
-{\f429\fbidi \fswiss\fcharset177\fprq2 Tahoma (Hebrew){\*\falt Times New Roman};}{\f430\fbidi \fswiss\fcharset178\fprq2 Tahoma (Arabic){\*\falt Times New Roman};}{\f431\fbidi \fswiss\fcharset186\fprq2 Tahoma Baltic{\*\falt Times New Roman};}
-{\f432\fbidi \fswiss\fcharset163\fprq2 Tahoma (Vietnamese){\*\falt Times New Roman};}{\f433\fbidi \fswiss\fcharset222\fprq2 Tahoma (Thai){\*\falt Times New Roman};}{\f446\fbidi \fnil\fcharset0\fprq2 @\'cb\'ce\'cc\'e5 Western;}
-{\f454\fbidi \fswiss\fcharset238\fprq2 Verdana CE{\*\falt Verdana};}{\f455\fbidi \fswiss\fcharset204\fprq2 Verdana Cyr{\*\falt Verdana};}{\f457\fbidi \fswiss\fcharset161\fprq2 Verdana Greek{\*\falt Verdana};}
-{\f458\fbidi \fswiss\fcharset162\fprq2 Verdana Tur{\*\falt Verdana};}{\f461\fbidi \fswiss\fcharset186\fprq2 Verdana Baltic{\*\falt Verdana};}{\f462\fbidi \fswiss\fcharset163\fprq2 Verdana (Vietnamese){\*\falt Verdana};}
-{\f464\fbidi \fmodern\fcharset238\fprq1 Consolas CE;}{\f465\fbidi \fmodern\fcharset204\fprq1 Consolas Cyr;}{\f467\fbidi \fmodern\fcharset161\fprq1 Consolas Greek;}{\f468\fbidi \fmodern\fcharset162\fprq1 Consolas Tur;}
-{\f471\fbidi \fmodern\fcharset186\fprq1 Consolas Baltic;}{\f472\fbidi \fmodern\fcharset163\fprq1 Consolas (Vietnamese);}{\flomajor\f31508\fbidi \froman\fcharset238\fprq2 Times New Roman CE{\*\falt Times};}
+{\fbiminor\f31507\fbidi \froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times New Roman{\*\falt Times};}{\f45\fbidi \froman\fcharset238\fprq2 Times New Roman CE{\*\falt Times};}
+{\f46\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr{\*\falt Times};}{\f48\fbidi \froman\fcharset161\fprq2 Times New Roman Greek{\*\falt Times};}{\f49\fbidi \froman\fcharset162\fprq2 Times New Roman Tur{\*\falt Times};}
+{\f50\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew){\*\falt Times};}{\f51\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic){\*\falt Times};}{\f52\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic{\*\falt Times};}
+{\f53\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese){\*\falt Times};}{\f65\fbidi \fmodern\fcharset238\fprq1 Courier New CE{\*\falt Courier New};}{\f66\fbidi \fmodern\fcharset204\fprq1 Courier New Cyr{\*\falt Courier New};}
+{\f68\fbidi \fmodern\fcharset161\fprq1 Courier New Greek{\*\falt Courier New};}{\f69\fbidi \fmodern\fcharset162\fprq1 Courier New Tur{\*\falt Courier New};}{\f70\fbidi \fmodern\fcharset177\fprq1 Courier New (Hebrew){\*\falt Courier New};}
+{\f71\fbidi \fmodern\fcharset178\fprq1 Courier New (Arabic){\*\falt Courier New};}{\f72\fbidi \fmodern\fcharset186\fprq1 Courier New Baltic{\*\falt Courier New};}{\f73\fbidi \fmodern\fcharset163\fprq1 Courier New (Vietnamese){\*\falt Courier New};}
+{\f177\fbidi \fnil\fcharset0\fprq2 SimSun Western{\*\falt SimSun};}{\f385\fbidi \froman\fcharset238\fprq2 Cambria Math CE;}{\f386\fbidi \froman\fcharset204\fprq2 Cambria Math Cyr;}{\f388\fbidi \froman\fcharset161\fprq2 Cambria Math Greek;}
+{\f389\fbidi \froman\fcharset162\fprq2 Cambria Math Tur;}{\f392\fbidi \froman\fcharset186\fprq2 Cambria Math Baltic;}{\f393\fbidi \froman\fcharset163\fprq2 Cambria Math (Vietnamese);}
+{\f415\fbidi \fswiss\fcharset238\fprq2 Calibri CE{\*\falt Century Gothic};}{\f416\fbidi \fswiss\fcharset204\fprq2 Calibri Cyr{\*\falt Century Gothic};}{\f418\fbidi \fswiss\fcharset161\fprq2 Calibri Greek{\*\falt Century Gothic};}
+{\f419\fbidi \fswiss\fcharset162\fprq2 Calibri Tur{\*\falt Century Gothic};}{\f422\fbidi \fswiss\fcharset186\fprq2 Calibri Baltic{\*\falt Century Gothic};}{\f423\fbidi \fswiss\fcharset163\fprq2 Calibri (Vietnamese){\*\falt Century Gothic};}
+{\f435\fbidi \froman\fcharset238\fprq2 Cambria CE;}{\f436\fbidi \froman\fcharset204\fprq2 Cambria Cyr;}{\f438\fbidi \froman\fcharset161\fprq2 Cambria Greek;}{\f439\fbidi \froman\fcharset162\fprq2 Cambria Tur;}
+{\f442\fbidi \froman\fcharset186\fprq2 Cambria Baltic;}{\f443\fbidi \froman\fcharset163\fprq2 Cambria (Vietnamese);}{\f445\fbidi \fswiss\fcharset238\fprq2 Tahoma CE{\*\falt Times New Roman};}
+{\f446\fbidi \fswiss\fcharset204\fprq2 Tahoma Cyr{\*\falt Times New Roman};}{\f448\fbidi \fswiss\fcharset161\fprq2 Tahoma Greek{\*\falt Times New Roman};}{\f449\fbidi \fswiss\fcharset162\fprq2 Tahoma Tur{\*\falt Times New Roman};}
+{\f450\fbidi \fswiss\fcharset177\fprq2 Tahoma (Hebrew){\*\falt Times New Roman};}{\f451\fbidi \fswiss\fcharset178\fprq2 Tahoma (Arabic){\*\falt Times New Roman};}{\f452\fbidi \fswiss\fcharset186\fprq2 Tahoma Baltic{\*\falt Times New Roman};}
+{\f453\fbidi \fswiss\fcharset163\fprq2 Tahoma (Vietnamese){\*\falt Times New Roman};}{\f454\fbidi \fswiss\fcharset222\fprq2 Tahoma (Thai){\*\falt Times New Roman};}{\f457\fbidi \fnil\fcharset0\fprq2 @\'cb\'ce\'cc\'e5 Western;}
+{\f465\fbidi \fswiss\fcharset238\fprq2 Verdana CE{\*\falt Verdana};}{\f466\fbidi \fswiss\fcharset204\fprq2 Verdana Cyr{\*\falt Verdana};}{\f468\fbidi \fswiss\fcharset161\fprq2 Verdana Greek{\*\falt Verdana};}
+{\f469\fbidi \fswiss\fcharset162\fprq2 Verdana Tur{\*\falt Verdana};}{\f472\fbidi \fswiss\fcharset186\fprq2 Verdana Baltic{\*\falt Verdana};}{\f473\fbidi \fswiss\fcharset163\fprq2 Verdana (Vietnamese){\*\falt Verdana};}
+{\f475\fbidi \fmodern\fcharset238\fprq1 Consolas CE;}{\f476\fbidi \fmodern\fcharset204\fprq1 Consolas Cyr;}{\f478\fbidi \fmodern\fcharset161\fprq1 Consolas Greek;}{\f479\fbidi \fmodern\fcharset162\fprq1 Consolas Tur;}
+{\f482\fbidi \fmodern\fcharset186\fprq1 Consolas Baltic;}{\f483\fbidi \fmodern\fcharset163\fprq1 Consolas (Vietnamese);}{\flomajor\f31508\fbidi \froman\fcharset238\fprq2 Times New Roman CE{\*\falt Times};}
 {\flomajor\f31509\fbidi \froman\fcharset204\fprq2 Times New Roman Cyr{\*\falt Times};}{\flomajor\f31511\fbidi \froman\fcharset161\fprq2 Times New Roman Greek{\*\falt Times};}
 {\flomajor\f31512\fbidi \froman\fcharset162\fprq2 Times New Roman Tur{\*\falt Times};}{\flomajor\f31513\fbidi \froman\fcharset177\fprq2 Times New Roman (Hebrew){\*\falt Times};}
 {\flomajor\f31514\fbidi \froman\fcharset178\fprq2 Times New Roman (Arabic){\*\falt Times};}{\flomajor\f31515\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic{\*\falt Times};}
@@ -47,387 +49,418 @@
 {\fbiminor\f31585\fbidi \froman\fcharset186\fprq2 Times New Roman Baltic{\*\falt Times};}{\fbiminor\f31586\fbidi \froman\fcharset163\fprq2 Times New Roman (Vietnamese){\*\falt Times};}}{\colortbl;\red0\green0\blue0;\red0\green0\blue255;
 \red0\green255\blue255;\red0\green255\blue0;\red255\green0\blue255;\red255\green0\blue0;\red255\green255\blue0;\red255\green255\blue255;\red0\green0\blue128;\red0\green128\blue128;\red0\green128\blue0;\red128\green0\blue128;\red128\green0\blue0;
 \red128\green128\blue0;\red128\green128\blue128;\red192\green192\blue192;\red8\green96\blue168;}{\*\defchp \fs21\kerning2\loch\af37\hich\af37\dbch\af13 }{\*\defpap \ql \li0\ri0\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 }
-\noqfpromote {\stylesheet{\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 \snext0 \sqformat \spriority0 Normal;}{
-\s1\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\outlinelevel0\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink15 \sqformat 
-heading 1;}{\s2\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\outlinelevel1\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 
+\noqfpromote {\stylesheet{\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 \snext0 \sqformat \spriority0 Normal;}{
+\s1\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\outlinelevel0\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext0 \slink15 \sqformat 
+heading 1;}{\s2\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\outlinelevel1\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 
 \sbasedon0 \snext0 \slink16 \sqformat heading 2;}{\*\cs10 \additive \ssemihidden Default Paragraph Font;}{\*
-\ts11\tsrowd\trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tscellwidthfts0\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 
-\ql \li0\ri0\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs22\alang1025 \ltrch\fcs0 \fs21\lang1033\langfe2052\kerning2\loch\f37\hich\af37\dbch\af13\cgrid\langnp1033\langfenp2052 
-\snext11 \ssemihidden \sunhideused \sqformat Normal Table;}{\*\cs15 \additive \rtlch\fcs1 \ab\af0\afs32 \ltrch\fcs0 \b\fs32\kerning32\loch\f36\hich\af36\dbch\af13 \sbasedon10 \slink1 \slocked Heading 1 Char;}{\*\cs16 \additive \rtlch\fcs1 
-\ab\ai\af0\afs28 \ltrch\fcs0 \b\i\fs28\loch\f36\hich\af36\dbch\af13 \sbasedon10 \slink2 \slocked Heading 2 Char;}{\*\cs17 \additive \rtlch\fcs1 \af0\afs16 \ltrch\fcs0 \fs16 \sbasedon10 \ssemihidden \styrsid16534634 annotation reference;}{
-\s18\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext18 \slink19 \ssemihidden \styrsid16534634 
-annotation text;}{\*\cs19 \additive \rtlch\fcs1 \af0 \ltrch\fcs0 \f41 \sbasedon10 \slink18 \slocked \ssemihidden \styrsid16534634 Comment Text Char;}{\s20\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \ab\af0\afs20\alang1025 
-\ltrch\fcs0 \b\fs20\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon18 \snext18 \slink21 \ssemihidden \styrsid16534634 annotation subject;}{\*\cs21 \additive \rtlch\fcs1 \ab\af0 \ltrch\fcs0 \b\f41 
-\sbasedon19 \slink20 \slocked \ssemihidden \styrsid16534634 Comment Subject Char;}{\s22\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af38\afs16\alang1025 \ltrch\fcs0 
-\fs16\lang1033\langfe1033\loch\f38\hich\af38\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext22 \slink23 \ssemihidden \styrsid16534634 Balloon Text;}{\*\cs23 \additive \rtlch\fcs1 \af38\afs16 \ltrch\fcs0 \f38\fs16 
+\ts11\tsrowd\trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 
+\ql \li0\ri0\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs21\alang1025 \ltrch\fcs0 \fs21\lang1033\langfe2052\kerning2\loch\f37\hich\af37\dbch\af13\cgrid\langnp1033\langfenp2052 
+\snext11 \ssemihidden \sunhideused Normal Table;}{\*\cs15 \additive \rtlch\fcs1 \ab\af0\afs32 \ltrch\fcs0 \b\fs32\kerning32\loch\f39\hich\af39\dbch\af13 \sbasedon10 \slink1 \slocked Heading 1 Char;}{\*\cs16 \additive \rtlch\fcs1 \ab\ai\af0\afs28 
+\ltrch\fcs0 \b\i\fs28\loch\f39\hich\af39\dbch\af13 \sbasedon10 \slink2 \slocked Heading 2 Char;}{\*\cs17 \additive \rtlch\fcs1 \af0\afs16 \ltrch\fcs0 \fs16 \sbasedon10 \ssemihidden \styrsid16534634 annotation reference;}{
+\s18\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs20\alang1025 \ltrch\fcs0 \fs20\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext18 \slink19 \ssemihidden \styrsid16534634 
+annotation text;}{\*\cs19 \additive \rtlch\fcs1 \af0 \ltrch\fcs0 \f42 \sbasedon10 \slink18 \slocked \ssemihidden \styrsid16534634 Comment Text Char;}{\s20\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \ab\af0\afs20\alang1025 
+\ltrch\fcs0 \b\fs20\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon18 \snext18 \slink21 \ssemihidden \styrsid16534634 annotation subject;}{\*\cs21 \additive \rtlch\fcs1 \ab\af0 \ltrch\fcs0 \b\f42 
+\sbasedon19 \slink20 \slocked \ssemihidden \styrsid16534634 Comment Subject Char;}{\s22\ql \li0\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0 \rtlch\fcs1 \af40\afs16\alang1025 \ltrch\fcs0 
+\fs16\lang1033\langfe1033\loch\f40\hich\af40\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext22 \slink23 \ssemihidden \styrsid16534634 Balloon Text;}{\*\cs23 \additive \rtlch\fcs1 \af40\afs16 \ltrch\fcs0 \f40\fs16 
 \sbasedon10 \slink22 \slocked \ssemihidden \styrsid16534634 Balloon Text Char;}{\s24\ql \li0\ri20\sb60\sa60\sl-200\slmult0\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin20\lin0\itap0 \rtlch\fcs1 \af0\afs16\alang1025 \ltrch\fcs0 
-\fs16\cf1\lang1033\langfe1033\loch\f41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext24 \styrsid14971029 CellBodyLeft;}{\*\cs25 \additive \b\f2\cf13 \styrsid14971029 CodeCharacter;}{\*\ts26\tsrowd\trbrdrt\brdrs\brdrw10 \trbrdrl
+\fs16\cf1\lang1033\langfe1033\loch\f42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 \sbasedon0 \snext24 \styrsid14971029 CellBodyLeft;}{\*\cs25 \additive \b\f2\cf13 \styrsid14971029 CodeCharacter;}{\*\ts26\tsrowd\trbrdrt\brdrs\brdrw10 \trbrdrl
 \brdrs\brdrw10 \trbrdrb\brdrs\brdrw10 \trbrdrr\brdrs\brdrw10 \trbrdrh\brdrs\brdrw10 \trbrdrv\brdrs\brdrw10 
-\trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tscellwidthfts0\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 
+\trftsWidthB3\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblind0\tblindtype3\tsvertalt\tsbrdrt\tsbrdrl\tsbrdrb\tsbrdrr\tsbrdrdgl\tsbrdrdgr\tsbrdrh\tsbrdrv 
 \ql \li0\ri0\widctlpar\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0\itap0 \rtlch\fcs1 \af0\afs22\alang1025 \ltrch\fcs0 \fs22\lang1033\langfe2052\loch\f37\hich\af37\dbch\af13\cgrid\langnp1033\langfenp2052 \sbasedon11 \snext26 \styrsid14971029 
-Table Grid;}}{\*\revtbl {Unknown;}{yzeng15;}}{\*\rsidtbl \rsid1063253\rsid1211840\rsid1381256\rsid1839752\rsid2442797\rsid2694053\rsid2974720\rsid4338091\rsid4590013\rsid4999604\rsid5116989\rsid5911148\rsid6164334\rsid6375506\rsid6492146\rsid6561745\rsid6579891\rsid6637302
-\rsid6827362\rsid7278947\rsid7820891\rsid8023663\rsid8600807\rsid8996461\rsid9010967\rsid10121491\rsid10897639\rsid11224689\rsid11427337\rsid12210198\rsid13245303\rsid13716787\rsid14971029\rsid15538292\rsid15612145\rsid16533044\rsid16534634}{\mmathPr
-\mmathFont34\mbrkBin0\mbrkBinSub0\msmallFrac0\mdispDef1\mlMargin0\mrMargin0\mdefJc1\mwrapIndent1440\mintLim0\mnaryLim1}{\info{\operator yzeng15}{\creatim\yr2010\mo10\dy6\hr13\min22}{\revtim\yr2011\mo8\dy31\hr14\min13}{\version29}{\edmins158}{\nofpages5}
-{\nofwords1165}{\nofchars6672}{\nofcharsws7822}{\vern32771}}{\*\xmlnstbl {\xmlns1 http://schemas.microsoft.com/office/word/2003/wordml}}\paperw12240\paperh15840\margl1440\margr1440\margt1440\margb1440\gutter0\ltrsect 
-\ftnbj\aenddoc\revisions\trackmoves1\trackformatting1\donotembedsysfont0\relyonvml0\donotembedlingdata1\grfdocevents0\validatexml0\showplaceholdtext0\ignoremixedcontent0\saveinvalidxml0\showxmlerrors0\horzdoc\dghspace120\dgvspace120\dghorigin1701
-\dgvorigin1984\dghshow0\dgvshow3\jcompress\viewkind1\viewscale135\rsidroot1211840 \fet0{\*\wgrffmtfilter 2450}\ilfomacatclnup0\ltrpar \sectd \ltrsect\linex0\sectdefaultcl\sftnbj {\*\pnseclvl1\pnucrm\pnstart1\pnindent720\pnhang {\pntxta \dbch .}}
-{\*\pnseclvl2\pnucltr\pnstart1\pnindent720\pnhang {\pntxta \dbch .}}{\*\pnseclvl3\pndec\pnstart1\pnindent720\pnhang {\pntxta \dbch .}}{\*\pnseclvl4\pnlcltr\pnstart1\pnindent720\pnhang {\pntxta \dbch )}}{\*\pnseclvl5\pndec\pnstart1\pnindent720\pnhang 
-{\pntxtb \dbch (}{\pntxta \dbch )}}{\*\pnseclvl6\pnlcltr\pnstart1\pnindent720\pnhang {\pntxtb \dbch (}{\pntxta \dbch )}}{\*\pnseclvl7\pnlcrm\pnstart1\pnindent720\pnhang {\pntxtb \dbch (}{\pntxta \dbch )}}{\*\pnseclvl8\pnlcltr\pnstart1\pnindent720\pnhang 
-{\pntxtb \dbch (}{\pntxta \dbch )}}{\*\pnseclvl9\pnlcrm\pnstart1\pnindent720\pnhang {\pntxtb \dbch (}{\pntxta \dbch )}}\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar
-\tx360\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 
-\b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Name
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build.exe \hich\f41 \endash \loch\f41  }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 is }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 the master command that provides }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 developers}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  with a single command for selecting various options of a build
+Table Grid;}}{\*\revtbl {Unknown;}{Zhu, Yonghong;}{yzeng15;}}{\*\rsidtbl \rsid1063253\rsid1211840\rsid1381256\rsid1839752\rsid2442797\rsid2694053\rsid2974720\rsid4338091\rsid4590013\rsid4999604\rsid5116989\rsid5911148\rsid6164334\rsid6375506\rsid6492146\rsid6561745\rsid6579891\rsid6637302
+\rsid6827362\rsid7278947\rsid7479872\rsid7820891\rsid8023663\rsid8081890\rsid8600807\rsid8996461\rsid9010967\rsid10121491\rsid10756011\rsid10897639\rsid11224689\rsid11413092\rsid11427337\rsid12210198\rsid13245303\rsid13716787\rsid14971029\rsid15538292
+\rsid15612145\rsid16533044\rsid16534634}{\mmathPr\mmathFont34\mbrkBin0\mbrkBinSub0\msmallFrac0\mdispDef1\mlMargin0\mrMargin0\mdefJc1\mwrapIndent1440\mintLim0\mnaryLim1}{\info{\operator Zhu, Yonghong}{\creatim\yr2010\mo10\dy6\hr13\min22}
+{\revtim\yr2015\mo12\dy2\hr15\min37}{\version33}{\edmins160}{\nofpages5}{\nofwords1253}{\nofchars7144}{\nofcharsws8381}{\vern57435}}{\*\xmlnstbl {\xmlns1 http://schemas.microsoft.com/office/word/2003/wordml}}
+\paperw12240\paperh15840\margl1440\margr1440\margt1440\margb1440\gutter0\ltrsect 
+\widowctrl\ftnbj\aenddoc\revisions\trackmoves0\trackformatting1\donotembedsysfont0\relyonvml0\donotembedlingdata1\grfdocevents0\validatexml0\showplaceholdtext0\ignoremixedcontent0\saveinvalidxml0\showxmlerrors0\horzdoc\dghspace120\dgvspace120
+\dghorigin1701\dgvorigin1984\dghshow0\dgvshow3\jcompress\viewkind1\viewscale200\rsidroot1211840 \fet0{\*\wgrffmtfilter 2450}\ilfomacatclnup0\ltrpar \sectd \ltrsect\linex0\sectdefaultcl\sftnbj {\*\pnseclvl1\pnucrm\pnstart1\pnindent720\pnhang 
+{\pntxta \hich .}}{\*\pnseclvl2\pnucltr\pnstart1\pnindent720\pnhang {\pntxta \hich .}}{\*\pnseclvl3\pndec\pnstart1\pnindent720\pnhang {\pntxta \hich .}}{\*\pnseclvl4\pnlcltr\pnstart1\pnindent720\pnhang {\pntxta \hich )}}{\*\pnseclvl5
+\pndec\pnstart1\pnindent720\pnhang {\pntxtb \hich (}{\pntxta \hich )}}{\*\pnseclvl6\pnlcltr\pnstart1\pnindent720\pnhang {\pntxtb \hich (}{\pntxta \hich )}}{\*\pnseclvl7\pnlcrm\pnstart1\pnindent720\pnhang {\pntxtb \hich (}{\pntxta \hich )}}{\*\pnseclvl8
+\pnlcltr\pnstart1\pnindent720\pnhang {\pntxtb \hich (}{\pntxta \hich )}}{\*\pnseclvl9\pnlcrm\pnstart1\pnindent720\pnhang {\pntxtb \hich (}{\pntxta \hich )}}\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar
+\tx360\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 
+\b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Name
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build.exe \hich\f42 \endash \loch\f42  }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 is }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 the master command that provides }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 developers}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  with a single command for selecting various options of a build
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Synopsis
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs18 
-\ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build.exe }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af41\dbch\af13\loch\f41 
-[-v | -q | -d] [-a <Arch>] [-p <DscFile>] [-m <InfFile>] [-b <Target>] [-t <TagName>] [-f FdfFile] [-r <RomImageName>] [-i <FvImageName>] }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid15612145 
-\hich\af41\dbch\af13\loch\f41 [-C <Cap}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid8023663 \hich\af41\dbch\af13\loch\f41 sule}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 
-\b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid15612145 \hich\af41\dbch\af13\loch\f41 ImageName>] }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af41\dbch\af13\loch\f41 
-[-n ThreadNum] [-x <SkuId>] [-u] [-e] [-w] [-j <LogFile>] [-s] [-D <MACROS>] [-y <ReportFile>]\hich\af41\dbch\af13\loch\f41  [-Y <ReportType>] [-F <Flags>] }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
-[}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af41\dbch\af13\loch\f41 All | GenC | GenMake | Fds | Libraries | Modules | Clean | CleanAll | CleanLib | run}{\rtlch\fcs1 \ab\af41\afs18 
-\ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 ]}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid13716787 \hich\af41\dbch\af13\loch\f41 Build.exe}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787 \hich\af41\dbch\af13\loch\f41  \hich\f41 
-\endash \loch\f41 h
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid13716787 \hich\af41\dbch\af13\loch\f41 Build.exe}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787 \hich\af41\dbch\af13\loch\f41  --version}{
-\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787\charrsid13716787 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Synopsis
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs18 
+\ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build.exe }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af42\dbch\af13\loch\f42 
+[-v | -q | -d] [-a <Arch>] [-p <DscFile>] [-m <InfFile>] [-b <Target>] [-t <TagName>] [-f FdfFile] [-r <RomImageName>] [-i <FvImageName>] }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid15612145 
+\hich\af42\dbch\af13\loch\f42 [-C <Cap}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid8023663 \hich\af42\dbch\af13\loch\f42 sule}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid15612145 \hich\af42\dbch\af13\loch\f42 ImageName>] }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af42\dbch\af13\loch\f42 
+[-n ThreadNum] [-x <SkuId>] [-u] [-e] [-w] [-j <LogFile>] [-s] [-D <MACROS>] [-y <ReportFile>]\hich\af42\dbch\af13\loch\f42  [-Y <ReportType>] [-F <Flags>]}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990500\langfenp2052\insrsid11413092 \hich\af42\dbch\af13\loch\f42  }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011 \hich\af42\dbch\af13\loch\f42 [}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011\charrsid11689747 \hich\af42\dbch\af13\loch\f42 --ignore-sources}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011 \hich\af42\dbch\af13\loch\f42 ] \hich\af42\dbch\af13\loch\f42 [}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011\charrsid10894100 \hich\af42\dbch\af13\loch\f42 --check-usage}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011 \hich\af42\dbch\af13\loch\f42 ]}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\deleted\fs18\cf1\lang1033\langfe2052\revauthdel1\revdttmdel1731990499\langfenp2052\insrsid2442797\delrsid10756011 \hich\af42\dbch\af13\loch\f42  }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 [}{
+\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid2442797 \hich\af42\dbch\af13\loch\f42 All | GenC | GenMake | Fds | Libraries | Modules | Clean | CleanAll | CleanLib | run}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 ]}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid13716787 \hich\af42\dbch\af13\loch\f42 Build.exe}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787 \hich\af42\dbch\af13\loch\f42  \hich\f42 
+\endash \loch\f42 h
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid13716787 \hich\af42\dbch\af13\loch\f42 Build.exe}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787 \hich\af42\dbch\af13\loch\f42  --version}{
+\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid13716787\charrsid13716787 
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Description
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build.exe is the master command line (CLI) tool that provides a single command for selecting various }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 
-\hich\af41\dbch\af13\loch\f41 build options}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 . In general, it checks the environment variables, gets the user\hich\f41 \rquote \loch\f41 
-s configuration from either the CLI or target.txt, parses the dsc, dec, inf, \hich\af41\dbch\af13\loch\f41 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Description
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build.exe is the master command line (CLI) tool that provides a single command for selecting various }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 
+\hich\af42\dbch\af13\loch\f42 build options}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 . In general, it checks the environment variables, gets the user\hich\f42 \rquote \loch\f42 
+s configuration from either the CLI or target.txt, parses the dsc, dec, inf, \hich\af42\dbch\af13\loch\f42 
 target.txt, tools_def.txt, generates .C, .H files and the Makefiles for one or more modules and/or the active platform, calls a make (NMake or make) program to process these Makefiles, then optionally calls GenFds to generate an fd file.
-\par \hich\af41\dbch\af13\loch\f41 The build tool sup\hich\af41\dbch\af13\loch\f41 ports two kinds of path specifications on command line - an absolutely path or a relative (to the WORKSPACE environment variable) path \hich\f41 \endash \loch\f41 
+\par \hich\af42\dbch\af13\loch\f42 The build tool sup\hich\af42\dbch\af13\loch\f42 ports two kinds of path specifications on command line - an absolutely path or a relative (to the WORKSPACE environment variable) path \hich\f42 \endash \loch\f42 
  in command line.
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Options
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 There are no required options. }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11427337 \hich\af41\dbch\af13\loch\f41 
-If no options are specified, it uses options specified in targe\hich\af41\dbch\af13\loch\f41 t.txt.}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -a, --arch <ARCH>
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 ARCH is one of }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 
-\hich\af41\dbch\af13\loch\f41 a }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 list: IA32, X64, IPF or EBC, which overrides }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 
-\hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 target.txt's TARGET_ARCH  definition. To specify }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 
-\hich\af41\dbch\af13\loch\f41 another }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 ARCH, repeat this option.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -p, --platform PlatformName.dsc
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
-\hich\af41\dbch\af13\loch\f41 s}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  the platform specified by the DSC file}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 
-\hich\af41\dbch\af13\loch\f41 . }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 The}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 name argument, overrides }{
-\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 target.txt's  ACTIVE_PLATFORM definition.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -m, --module ModuleName.inf
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
-\hich\af41\dbch\af13\loch\f41 s}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  the module specified by the INF file name argument.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -b, --buildtarget <TARGET>
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 TARGET is one of}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41  a}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  list: DEBUG, RELEASE,}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1727593357\langfenp2052\insrsid15538292 \hich\af41\dbch\af13\loch\f41  NOOPT}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1727593357\langfenp2052\insrsid15538292 \loch\af41\hich\af41\dbch\f13 \'a3\'ac}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  which overrides }{
-\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 target.txt\hich\af41\dbch\af13\loch\f41 
-'s TARGET definition. To specify }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41 another }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
-TARGET, please repeat this option.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -t, --tagname Tagname
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Us}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 
-\hich\af41\dbch\af13\loch\f41 e}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 \hich\af41\dbch\af13\loch\f41 s}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
- the Tool Chain Tagname to build the platform}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 .}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 \hich\af41\dbch\af13\loch\f41  }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid1063253 \hich\af41\dbch\af13\loch\f41  It }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 overrides target.txt's TOOL_CHAIN_TAG definition.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -f --fdf Filename.fdf
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 The name of the FDF file }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid6164334 \hich\af41\dbch\af13\loch\f41 to use to}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  override the setting in the DSC file.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -r --rom-image ROM_IMAGE_NAME
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Options
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 There are no required options. }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11427337 \hich\af42\dbch\af13\loch\f42 
+If no options are specified, it uses options specified in targe\hich\af42\dbch\af13\loch\f42 t.txt.}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -a, --arch <ARCH>
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 ARCH is one of }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 
+\hich\af42\dbch\af13\loch\f42 a }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 list: IA32, X64, IPF or EBC, which overrides }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 
+\hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 target.txt's TARGET_ARCH  definition. To specify }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 
+\hich\af42\dbch\af13\loch\f42 another }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 ARCH, repeat this option.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -p, --platform PlatformName.dsc
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
+\hich\af42\dbch\af13\loch\f42 s}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  the platform specified by the DSC file}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 
+\hich\af42\dbch\af13\loch\f42 . }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 The}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 name argument, overrides }{
+\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 target.txt's  ACTIVE_PLATFORM definition.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -m, --module ModuleName.inf
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
+\hich\af42\dbch\af13\loch\f42 s}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  the module specified by the INF file name argument.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -b, --buildtarget <TARGET>
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 TARGET is one of}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42  a}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  list: DEBUG, RELEASE,}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\revised\lang1033\langfe2052\revauth2\revdttm1727593357\langfenp2052\insrsid15538292 \hich\af42\dbch\af13\loch\f42  NOOPT}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\revised\lang1033\langfe2052\revauth2\revdttm1727593357\langfenp2052\insrsid15538292 \loch\af42\hich\af42\dbch\f13 \u-244\'a3\'ac}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  which overrides }{
+\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 target.txt's TARGET definition. To specify }{\rtlch\fcs1 
+\af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42 another }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 TARGET, please repeat this option.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -t, --tagname Tagname
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Us}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 
+\hich\af42\dbch\af13\loch\f42 e}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 \hich\af42\dbch\af13\loch\f42 s}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
+ the Tool Chain Tagname to build the platform}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid1063253 .}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 \hich\af42\dbch\af13\loch\f42  }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid1063253 \hich\af42\dbch\af13\loch\f42  It }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 overrides target.txt's TOOL_CHAIN_TAG definition.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -f --fdf Filename.fdf
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 The name of the FDF file }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid6164334 \hich\af42\dbch\af13\loch\f42 to use to}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  override the setting in the DSC file.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -r --rom-image ROM_IMAGE_NAME
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
 The name of FD to be generated. The name must be from [FD] section in FDF file.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -i --fv-image FV_IMAGE_NAME
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 The name of FV to be generated. The name must be from [FV] section in 
-\hich\af41\dbch\af13\loch\f41 FDF file.}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0\pararsid10121491 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid10121491 -}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 
-\b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid10121491 \hich\af41\dbch\af13\loch\f41 C}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid10121491 \hich\af41\dbch\af13\loch\f41  --}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 
-\b\fs18\cf1\insrsid6637302\charrsid6637302 \hich\af41\dbch\af13\loch\f41 capsule-image}{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid10121491 \hich\af41\dbch\af13\loch\f41  CAPSULE}{\rtlch\fcs1 \ab\af41\afs18 
-\ltrch\fcs0 \b\fs18\cf1\insrsid10121491 \hich\af41\dbch\af13\loch\f41 _IMAGE_NAME
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0\pararsid6375506 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid10121491\charrsid6375506 \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -i --fv-image FV_IMAGE_NAME
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 The name of FV to be generated. The name must\hich\af42\dbch\af13\loch\f42 
+ be from [FV] section in FDF file.}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0\pararsid10121491 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid10121491 -}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid10121491 \hich\af42\dbch\af13\loch\f42 C}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid10121491 \hich\af42\dbch\af13\loch\f42  --}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 
+\b\fs18\cf1\insrsid6637302\charrsid6637302 \hich\af42\dbch\af13\loch\f42 capsule-image}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid10121491 \hich\af42\dbch\af13\loch\f42  CAPSULE}{\rtlch\fcs1 \ab\af42\afs18 
+\ltrch\fcs0 \b\fs18\cf1\insrsid10121491 \hich\af42\dbch\af13\loch\f42 _IMAGE_NAME
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0\pararsid6375506 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid10121491\charrsid6375506 \hich\af42\dbch\af13\loch\f42 
 The name of Capsule to be generated. The name must be from [Capsule] section in FDF file.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\pnrdate1190691435\pnrnot1\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -n NUM
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
-\hich\af41\dbch\af13\loch\f41 s}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  the platform using multi-threaded compiler. The value overrides }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 
-\hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 target.txt's MULTIPLE_THREAD and MAX_CONCURRENT_THREAD_NUMBER. }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 
-\hich\af41\dbch\af13\loch\f41 Using l}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 ess than 2 will disable multi-thread builds.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -x --sku-id SKU_ID}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\pnrdate1190691435\pnrnot1\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -n NUM
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 
+\hich\af42\dbch\af13\loch\f42 s}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  the platform using multi-threaded compiler. The value overrides }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 
+\hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 target.txt's MULTIPLE_THREAD and MAX_CONCURRENT_THREAD_NUMBER. }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 
+\hich\af42\dbch\af13\loch\f42 Using l}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 ess than 2 will disable multi-thread builds.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -x --sku-id SKU_ID}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 Use}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41  SKU ID to build the platform}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41  and override the}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41  SKUID_IDENTIFIER in DSC file.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -u --skip-autogen}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 Use}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42  SKU ID to build the platform}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42  and override the}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42  SKUID_IDENTIFIER in DSC file.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -u --skip-autogen}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 Use to s}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41 kip }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 AutoGen 
-\hich\af41\dbch\af13\loch\f41 step. Note the build may fail if there\hich\f41 \rquote \loch\f41 s no AutoGen-ed files before.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -e --re-parse}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 Use to s}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42 kip }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 AutoGen 
+\hich\af42\dbch\af13\loch\f42 step. Note the build may fail if there\hich\f42 \rquote \loch\f42 s no AutoGen-ed files before.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -e --re-parse}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 Use to r}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41 e-parse all meta-data files. Use this option if you encounter }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 an }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41 inconsistency issue.}{\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -w --warning-as-error}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 Use to r}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42 e-parse all meta-data files. Use this option if you encounter }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 an }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42 inconsistency issue.}{\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -w --warning-as-error}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 Use to t}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41 reat warning in }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 the }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 tool as }{
-\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 an }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 error.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -j --log LOGFILE}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 Use to t}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42 reat warning in }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 the }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 tool as }{
+\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 an }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 error.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -j --log LOGFILE}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af41\dbch\af13\loch\f41 Use to p}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41 ut screen output in specified file.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -s \hich\f41 \endash \loch\f41 silent
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af41\dbch\af13\loch\f41 Enable  }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\loch\af41\dbch\af13\hich\f41 \'93\loch\f41 \hich\f41 make\'94\loch\f41 \hich\f41  tool to run \'93\loch\f41 \hich\f41 silently\'94\loch\f41 . Internally, a \hich\f41 \lquote \loch\f41 -s\hich\f41 \rquote \loch\f41 \hich\f41  switch will be passed to \'93
-\loch\f41 \hich\f41 make\'94\loch\f41  tool. Don\hich\f41 \rquote \loch\f41 \hich\f41 t use this option if your \'93\loch\f41 \hich\f41 make\'94\loch\f41  tool doesn\hich\f41 \rquote \loch\f41 t support \hich\f41 \lquote \loch\f41 -s\hich\f41 \rquote 
-\loch\f41 \hich\f41 . Instead, if your \'93\loch\f41 \hich\f41 make\'94\loch\f41  \hich\af41\dbch\af13\loch\f41 tool uses other option}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af41\dbch\af13\loch\f41 s}{\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  you could add it to the XX_XX_XX_MAKE_FLAGS in tools_def.txt.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -d, --debug [#]
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Enable debug messages at specified level. It is used by Tool itself.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -q, --quiet
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Disable all messages except FATAL ERRORS.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -v, --verbose
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af41\dbch\af13\loch\f41 Enable}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41  verbose ou\hich\af41\dbch\af13\loch\f41 tput with informational messages printed.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -D, --define MACROS
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Macro: "Name [= Value]".
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -y, --report-file REPORTFILE}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid7820891 \hich\af42\dbch\af13\loch\f42 Use to p}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42 ut screen output in specified file.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -s \hich\f42 \endash \loch\f42 silent
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af42\dbch\af13\loch\f42 Enable  }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\loch\af42\dbch\af13\hich\f42 \'93\loch\f42 \hich\f42 make\'94\loch\f42 \hich\f42  tool to run \'93\loch\f42 \hich\f42 silently\'94\loch\f42 . Internally, a \hich\f42 \lquote \loch\f42 -s\hich\f42 \rquote \loch\f42 \hich\f42  switch will be passed to \'93
+\loch\f42 \hich\f42 make\'94\loch\f42  tool. Don\hich\f42 \rquote \loch\f42 \hich\f42 t use this option if your \'93\loch\f42 \hich\f42 make\'94\loch\f42  tool doesn\hich\f42 \rquote \loch\f42 t support \hich\f42 \lquote \loch\f42 -s\hich\f42 \rquote 
+\loch\f42 \hich\f42 . Instead, if your \'93\loch\f42 \hich\f42 make\'94\loch\f42  \hich\af42\dbch\af13\loch\f42 tool uses other option}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af42\dbch\af13\loch\f42 s}{\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  you could add it to the XX_XX_XX_MAKE_FLAGS in tools_def.txt.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -d, --debug [#]
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Enable debug messages at specified level. It is used by Tool itself.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -q, --quiet
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Disable all messages except FATAL ERRORS.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -v, --verbose
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid2974720 \hich\af42\dbch\af13\loch\f42 Enable}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42  verbose ou\hich\af42\dbch\af13\loch\f42 tput with informational messages printed.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -D, --define MACROS
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Macro: "Name [= Value]".
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -y, --report-file REPORTFILE}{\rtlch\fcs1 \ab\af0\afs18 \ltrch\fcs0 
 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Create/overwrite the report to the specified filename.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -Y, --report-type REPORTTYPE
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Flags that control the type of build report to generate.
-\hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Create/overwrite the report to the specified filename.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -Y, --report-type REPORTTYPE
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Flags that control the type of build report to generate.
+\hich\af42\dbch\af13\loch\f42 
   Must be one of: [PCD, LIBRARY, FLASH, DEPEX, BUILD_FLAGS, FIXED_ADDRESS, EXECUTION_ORDER].  To specify more than one flag, repeat this option on the command line and the default flag set is [PCD, LIBRARY, FLASH, DEPEX, BUILD_FLAGS, FIXED_ADDRESS]}{
 \rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -F FLAG\hich\af41\dbch\af13\loch\f41 , --flag=FLAG}{\rtlch\fcs1 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -F FLAG\hich\af42\dbch\af13\loch\f42 , --flag=FLAG}{\rtlch\fcs1 
 \ab\af0\afs18 \ltrch\fcs0 \b\f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
 Specify the specific option to parse EDK UNI file. Must be one of: [-c, -s]. -c is for EDK framework UNI file, and -s is for EDK UEFI UNI file. This option can also be specified by setting *_*_*_BUILD_FLAGS in [BuildOptions] section of platfo
-\hich\af41\dbch\af13\loch\f41 rm DSC. If they are both specified, this value will override the setting in [BuildOptions] section of platform DSC.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 --version
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Show program copyright and version number then exit.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 -h, --help
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Print the copyright, version and usage of this program then exit.
+\hich\af42\dbch\af13\loch\f42 rm DSC. If they are both specified, this value will override the setting in [BuildOptions] section of platform DSC.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0\pararsid10756011 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011\charrsid10894100 
+\hich\af42\dbch\af13\loch\f42 --check-usage}{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011 
+\par \hich\af42\dbch\af13\loch\f42     }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011\charrsid10894100 \hich\af42\dbch\af13\loch\f42 Check usage content of entries listed in INF file.}{\rtlch\fcs1 
+\af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\lang1033\langfe2052\revauth1\revdttm1731990499\langfenp2052\insrsid10756011\charrsid12155946 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011\charrsid2178333 \hich\af42\dbch\af13\loch\f42 --ignore-sources
+\par }\pard \ltrpar\ql \li0\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin0\itap0\pararsid10756011 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011 \tab }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011\charrsid11689747 \hich\af42\dbch\af13\loch\f42 Focus to a binary build and ignore all source files}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011 .
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0\pararsid10756011 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011\charrsid11689747 \hich\af42\dbch\af13\loch\f42 
+If an INF file listed in the DSC or FDF file contains a [Sources] section and it also contains a [Binaries] section, do not generate a Makefile, ignoring the sources, and just use the binaries listed in the [Binaries] section
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\prauth1\prdate1731990500\rin0\lin720\itap0\pararsid10756011 {\*\oldpprops \pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0\pararsid10756011 }{\rtlch\fcs1 
+\af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011\charrsid11689747 \hich\af42\dbch\af13\loch\f42 If an INF file listed in the D\hich\af42\dbch\af13\loch\f42 
+SC or FDF file contains a [Sources] section and it does not contain a [Binaries] section, break the build with an error message}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\insrsid10756011 .}{\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\revised\revauth1\revdttm1731990499\crauth1\crdate1731990500\insrsid10756011\charrsid10756011 {\*\oldcprops \b\crauth1\crdate1731990500\insrsid10756011\charrsid10756011 }
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 --version
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Show program copyright and version number then exit.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 -h, --help
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Print the copyright, version and usage of this program then exit.
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 {\*\bkmkstart _Ref299349210}\hich\af41\dbch\af13\loch\f41 Target{\*\bkmkend _Ref299349210}
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 If no target is given, then default target is ALL.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 ALL}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 {\*\bkmkstart _Ref299349210}\hich\af42\dbch\af13\loch\f42 Target{\*\bkmkend _Ref299349210}
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 If no target is given, then default target is ALL.
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 ALL}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
            Build everything for either the platform or module.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 GenC}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 GenC}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
          Auto-generate all C files for either the platform or module.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 GenMake}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41      Generate the Makefiles \hich\f41 \endash 
-\loch\f41  if auto-generated files are missing,
-\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 GenMake}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42      Generate the Makefiles \hich\f42 \endash 
+\loch\f42  if auto-generated files are missing,
+\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
                     then auto-generate all C files first for either the platform or module.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Fds}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41             Create the FD Image files.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Libraries}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41       Build all EDK Libraries and EDK II Libra
-\hich\af41\dbch\af13\loch\f41 ry Instances which are specified.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Modules}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Fds}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42             Create the FD Image files.
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Libraries}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42       Build all EDK Libraries and EDK II Libra
+\hich\af42\dbch\af13\loch\f42 ry Instances which are specified.
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Modules}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
        Build all EDK components and EDK II modules which are specified.
-\par }{\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Clean}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }{\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Clean}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
          Remove intermediate files generated by the NMAKE command (leaving
-\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41                     the auto-generated C format, FD image files
-\hich\af41\dbch\af13\loch\f41 , PE32 output files, PCH 
-\par \hich\af41\dbch\af13\loch\f41                     files and LIB files).
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 CleanAll}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41       Remove all }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 \hich\af41\dbch\af13\loch\f41 intermediate}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
-, auto-generated, FV and FD image files \hich\f41 \endash \loch\f41  
-\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42                     the auto-generated C format, FD image files
+\hich\af42\dbch\af13\loch\f42 , PE32 output files, PCH 
+\par \hich\af42\dbch\af13\loch\f42                     files and LIB files).
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 CleanAll}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42       Remove all }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid6164334 \hich\af42\dbch\af13\loch\f42 intermediate}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
+, auto-generated, FV and FD image files \hich\f42 \endash \loch\f42  
+\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
                    state of the tree should be exactly as if a fresh checkout or install has 
-\par \hich\af41\dbch\af13\loch\f41               \hich\af41\dbch\af13\loch\f41      occurred.
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 CleanLib}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41      Remove intermediate files generated by the NMAKE command AND LIB 
-\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par \hich\af42\dbch\af13\loch\f42               \hich\af42\dbch\af13\loch\f42      occurred.
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 CleanLib}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42      Remove intermediate files generated by the NMAKE command AND LIB 
+\par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
                    files (leaving the auto-generated, FV and FD image files, PE32 output 
-\par \hich\af41\dbch\af13\loch\f41                    files and PCH files)
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 run}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\hich\af41\dbch\af13\loch\f41            Run platform (for \hich\af41\dbch\af13\loch\f41 emulator platform only)
+\par \hich\af42\dbch\af13\loch\f42                    files and PCH files)
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 run}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\hich\af42\dbch\af13\loch\f42            Run platform (for \hich\af42\dbch\af13\loch\f42 emulator platform only)
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0\pararsid14971029 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\lang1033\langfe2052\langfenp2052\insrsid14971029 {\*\bkmkstart OLE_LINK3}{\*\bkmkstart OLE_LINK4}
-{\*\bkmkstart OLE_LINK5}{\*\bkmkstart OLE_LINK6}\hich\af41\dbch\af13\loch\f41 Status codes returned}{\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\lang1033\langfe2052\langfenp2052\insrsid14971029\charrsid4999604 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\lang1033\langfe2052\langfenp2052\insrsid14971029 {\*\bkmkstart OLE_LINK3}{\*\bkmkstart OLE_LINK4}
+{\*\bkmkstart OLE_LINK5}{\*\bkmkstart OLE_LINK6}\hich\af42\dbch\af13\loch\f42 Status codes returned}{\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\lang1033\langfe2052\langfenp2052\insrsid14971029\charrsid4999604 
 \par \ltrrow}\trowd \irow0\irowband0\ltrrow\ts26\trleft-108\trbrdrt\brdrs\brdrw10 \trbrdrl\brdrs\brdrw10 \trbrdrb\brdrs\brdrw10 \trbrdrr\brdrs\brdrw10 \trbrdrh\brdrs\brdrw10 \trbrdrv\brdrs\brdrw10 
 \trftsWidth3\trwWidth8820\trftsWidthB3\trftsWidthA3\trautofit1\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblrsid5911148\tbllkhdrrows\tbllkhdrcols\tblind0\tblindtype3 \clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb
 \brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth2970\clshdrawnil \cellx2862\clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb\brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth5850\clshdrawnil \cellx8712
 \pard\plain \ltrpar\s24\ql \li0\ri20\sb60\sa60\sl-200\slmult0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin20\lin0\pararsid5911148\yts26 \rtlch\fcs1 \af0\afs16\alang1025 \ltrch\fcs0 
-\fs16\cf1\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 \cs25\b\f2\fs18\cf13\lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 0}{\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 
-\cs25\b\f2\fs18\lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 \cell }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid14971029 \hich\af41\dbch\af13\loch\f41 The action was completed as requested.}{\rtlch\fcs1 \af0 \ltrch\fcs0 \kerning2\insrsid14971029 
-\cell }\pard\plain \ltrpar\ql \li0\ri0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {
+\fs16\cf1\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 \cs25\b\f2\fs18\cf13\lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 0}{\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 
+\cs25\b\f2\fs18\lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 \cell }{\rtlch\fcs1 \af0 \ltrch\fcs0 \insrsid14971029 \hich\af42\dbch\af13\loch\f42 The action was completed as requested.}{\rtlch\fcs1 \af0 \ltrch\fcs0 \kerning2\insrsid14971029 
+\cell }\pard\plain \ltrpar\ql \li0\ri0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {
 \rtlch\fcs1 \af37\afs20 \ltrch\fcs0 \fs20\insrsid14971029 \trowd \irow0\irowband0\ltrrow\ts26\trleft-108\trbrdrt\brdrs\brdrw10 \trbrdrl\brdrs\brdrw10 \trbrdrb\brdrs\brdrw10 \trbrdrr\brdrs\brdrw10 \trbrdrh\brdrs\brdrw10 \trbrdrv\brdrs\brdrw10 
 \trftsWidth3\trwWidth8820\trftsWidthB3\trftsWidthA3\trautofit1\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblrsid5911148\tbllkhdrrows\tbllkhdrcols\tblind0\tblindtype3 \clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb
 \brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth2970\clshdrawnil \cellx2862\clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb\brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth5850\clshdrawnil \cellx8712
 \row \ltrrow}\pard\plain \ltrpar\s24\ql \li0\ri20\sb60\sa60\sl-200\slmult0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin20\lin0\pararsid5911148\yts26 \rtlch\fcs1 \af0\afs16\alang1025 \ltrch\fcs0 
-\fs16\cf1\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 \cs25\b\f2\fs18\cf13\lang1033\langfe2052\kerning2\langfenp2052\insrsid4338091 \hich\af2\dbch\af13\loch\f2 Nonzero}{
-\rtlch\fcs1 \af42\afs19 \ltrch\fcs0 \cs25\f42\fs19\cf0\lang1033\langfe2052\langfenp2052\insrsid14971029\charrsid8600807 \cell }\pard \ltrpar\s24\ql \li0\ri20\sb60\sa60\sl-200\slmult0
-\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin20\lin0\pararsid13245303\yts26 {\rtlch\fcs1 \af0 \ltrch\fcs0 \lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 \hich\af41\dbch\af13\loch\f41 The action failed.\cell 
-}\pard\plain \ltrpar\ql \li0\ri0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 
+\fs16\cf1\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af2\afs18 \ltrch\fcs0 \cs25\b\f2\fs18\cf13\lang1033\langfe2052\kerning2\langfenp2052\insrsid4338091 \hich\af2\dbch\af13\loch\f2 Nonzero}{
+\rtlch\fcs1 \af43\afs19 \ltrch\fcs0 \cs25\f43\fs19\cf0\lang1033\langfe2052\langfenp2052\insrsid14971029\charrsid8600807 \cell }\pard \ltrpar\s24\ql \li0\ri20\sb60\sa60\sl-200\slmult0
+\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin20\lin0\pararsid13245303\yts26 {\rtlch\fcs1 \af0 \ltrch\fcs0 \lang1033\langfe2052\kerning2\langfenp2052\insrsid14971029 \hich\af42\dbch\af13\loch\f42 The action failed.\cell 
+}\pard\plain \ltrpar\ql \li0\ri0\widctlpar\intbl\wrapdefault\aspalpha\aspnum\faauto\adjustright\rin0\lin0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 
 \af37\afs20 \ltrch\fcs0 \fs20\insrsid14971029 \trowd \irow1\irowband1\lastrow \ltrrow\ts26\trleft-108\trbrdrt\brdrs\brdrw10 \trbrdrl\brdrs\brdrw10 \trbrdrb\brdrs\brdrw10 \trbrdrr\brdrs\brdrw10 \trbrdrh\brdrs\brdrw10 \trbrdrv\brdrs\brdrw10 
 \trftsWidth3\trwWidth8820\trftsWidthB3\trftsWidthA3\trautofit1\trpaddl108\trpaddr108\trpaddfl3\trpaddft3\trpaddfb3\trpaddfr3\tblrsid5911148\tbllkhdrrows\tbllkhdrcols\tblind0\tblindtype3 \clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb
 \brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth2970\clshdrawnil \cellx2862\clvertalt\clbrdrt\brdrs\brdrw10 \clbrdrl\brdrs\brdrw10 \clbrdrb\brdrs\brdrw10 \clbrdrr\brdrs\brdrw10 \cltxlrtb\clftsWidth3\clwWidth5850\clshdrawnil \cellx8712
-\row }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid16534634 {\*\bkmkend OLE_LINK3}{\*\bkmkend OLE_LINK4}{\*\bkmkend OLE_LINK5}
+\row }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid16534634 {\*\bkmkend OLE_LINK3}{\*\bkmkend OLE_LINK4}{\*\bkmkend OLE_LINK5}
 {\*\bkmkend OLE_LINK6}
 \par }\pard \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
 \par }{\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid11224689 
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Examples
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Assume that $(WORKSPACE) is C:\\MyWorkspace
-\par }\pard \ltrpar\ql \li180\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin180\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build platform: Nt32Pkg.dsc
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Specify the platform description file on the command line.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\MyWorkspace>build -p Nt32Pkg\\Nt32Pkg.dsc \hich\f41 \endash 
-\loch\f41 a IA32
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Examples
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Assume that $(WORKSPACE) is C:\\MyWorkspace
+\par }\pard \ltrpar\ql \li180\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin180\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build platform: Nt32Pkg.dsc
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Specify the platform description file on the command line.
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\MyWorkspace>build -p Nt32Pkg\\Nt32Pkg.dsc \hich\f42 \endash 
+\loch\f42 a IA32
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
 Build the platform in the current working directory if it contains a platform description file.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\MyWorkspace\\Nt32Pk\hich\af41\dbch\af13\loch\f41 g>build \hich\f41 
-\endash \loch\f41 a IA32
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build the active platform specified in the target.txt file.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\ MyWorkspace>build \hich\f41 \endash \loch\f41 a Ia32
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\MyWorkspace\\Nt32Pk\hich\af42\dbch\af13\loch\f42 g>build \hich\f42 
+\endash \loch\f42 a IA32
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build the active platform specified in the target.txt file.
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\ MyWorkspace>build \hich\f42 \endash \loch\f42 a Ia32
 \par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
-\par }\pard \ltrpar\ql \li180\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin180\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build Module: HelloWorld.inf
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Specify the platform and Module on the command line.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\MyWorkspace>build -p Nt32Pkg\\Nt32Pkg.dsc \hich\f41 \endash 
-\loch\f41 a IA32 \\
-\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41  \hich\f41 \endash \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li180\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin180\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build Module: HelloWorld.inf
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Specify the platform and Module on the command line.
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\MyWorkspace>build -p Nt32Pkg\\Nt32Pkg.dsc \hich\f42 \endash 
+\loch\f42 a IA32 \\
+\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42  \hich\f42 \endash \hich\af42\dbch\af13\loch\f42 
 m MdeModulePkg/Application/HelloWorld/HelloWorld.inf
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 
 Specify the Module on the command line and use the active platform specified in the target.txt file.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\MyWorkspace>build \hich\f41 \endash \loch\f41 a IA32 \\
-\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \loch\af41\dbch\af13\hich\f41 \endash \loch\f41 m MdeModulePkg/Application/HelloWorld/HelloWorld.inf
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build the module \hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\MyWorkspace>build \hich\f42 \endash \loch\f42 a IA32 \\
+\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \loch\af42\dbch\af13\hich\f42 \endash \loch\f42 m MdeModulePkg/Application/HelloWorld/HelloWorld.inf
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build the module \hich\af42\dbch\af13\loch\f42 
 in the current working directory if it contains a module description file and specify the platform on the command line.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\ MyWorkspace\\MdeModulePkg\\Application\\HelloWorld>build \hich\f41 
-\endash \loch\f41 a Ia32 \\
-\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \loch\af41\dbch\af13\hich\f41 \endash \loch\f41 p Nt32Pkg\\Nt32Pkg.dsc
-\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Build the module in the current working direc\hich\af41\dbch\af13\loch\f41 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\ MyWorkspace\\MdeModulePkg\\Application\\HelloWorld>build \hich\f42 
+\endash \loch\f42 a Ia32 \\
+\par }\pard \ltrpar\ql \li720\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \loch\af42\dbch\af13\hich\f42 \endash \loch\f42 p Nt32Pkg\\Nt32Pkg.dsc
+\par }\pard \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Build the module in the current working direc\hich\af42\dbch\af13\loch\f42 
 tory and use the active platform specified in the target.txt file.
-\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af41\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 C:\\ MyWorkspace\\MdeModulePkg\\Application\\HelloWorld>build \hich\f41 
-\endash \loch\f41 a Ia32 
+\par }\pard \ltrpar\ql \li720\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin720\itap0 {\rtlch\fcs1 \ab\af42\afs18 \ltrch\fcs0 \b\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 C:\\ MyWorkspace\\MdeModulePkg\\Application\\HelloWorld>build \hich\f42 
+\endash \loch\f42 a Ia32 
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Bugs 
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 No known }{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 \hich\af41\dbch\af13\loch\f41 issues.}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
-\par \hich\af41\dbch\af13\loch\f41 Report bugs to edk2-buildtools-devel@lists.sourceforge.net}{\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Bugs 
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 No known }{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid9010967 \hich\af42\dbch\af13\loch\f42 issues.}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\insrsid11224689 
+\par \hich\af42\dbch\af13\loch\f42 Report bugs to edk2-buildtools-devel@lists.sourceforge.net}{\rtlch\fcs1 \af0\afs18 \ltrch\fcs0 \f0\fs18\cf1\insrsid11224689 
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Files 
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 target.txt, tools_def.txt, platform.dsc, flashmap.fdf, package.dec and module.inf.
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Files 
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 target.txt, tools_def.txt, platfo\hich\af42\dbch\af13\loch\f42 rm.dsc, flashmap.fdf, package.dec and module.inf.
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 See also
-\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 
-\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 GenFds.exe
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 See also
+\par }\pard\plain \ltrpar\ql \li360\ri0\sb200\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 
+\ltrch\fcs0 \fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 GenFds.exe
 \par }\pard\plain \ltrpar\s2\ql \li-1440\ri0\sb400\sa60\sl-340\slmult0\keep\keepn\nowidctlpar\tx360\tx1440\wrapdefault\faauto\outlinelevel1\rin0\lin-1440\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 
-\fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af41\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af41\dbch\af13\loch\f41 License
-\par }\pard\plain \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af41\hich\af41\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 Copyright (c) 1999 - 201}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid1381256 \hich\af41\dbch\af13\loch\f41 1}{\rtlch\fcs1 \af41\afs18 \ltrch\fcs0 
-\fs18\cf1\insrsid11224689 \hich\af41\dbch\af13\loch\f41 , Intel Corporation. All rights reserved.
+\fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \ab\af42\afs28 \ltrch\fcs0 \b\fs28\cf17\insrsid11224689 \hich\af42\dbch\af13\loch\f42 License
+\par }\pard\plain \ltrpar\ql \li360\ri0\nowidctlpar\wrapdefault\faauto\rin0\lin360\itap0 \rtlch\fcs1 \af0\afs24\alang1025 \ltrch\fcs0 \fs24\lang1033\langfe1033\loch\af42\hich\af42\dbch\af13\cgrid\langnp1033\langfenp1033 {\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 Copyright (c) 1999 - 201}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 \fs18\cf1\lang1033\langfe2052\langfenp2052\insrsid1381256 \hich\af42\dbch\af13\loch\f42 1}{\rtlch\fcs1 \af42\afs18 \ltrch\fcs0 
+\fs18\cf1\insrsid11224689 \hich\af42\dbch\af13\loch\f42 , Intel Corporation. All rights reserved.
 \par 
-\par \hich\af41\dbch\af13\loch\f41 This program and the accompanying materials are licensed and made available under the terms and
-\par \hich\af41\dbch\af13\loch\f41 conditions of the BSD License which accompanies this distribution.  The full text of the license may be
-\par \hich\af41\dbch\af13\loch\f41 found at:
-\par \hich\af41\dbch\af13\loch\f41 http://opensource.org/licenses/bsd-license.php
+\par \hich\af42\dbch\af13\loch\f42 This program and the accompanying materials are licensed and made available under the terms and
+\par \hich\af42\dbch\af13\loch\f42 conditions of the BSD License which accompanies this distribution.  The full text of the license may be
+\par \hich\af42\dbch\af13\loch\f42 found at:
+\par \hich\af42\dbch\af13\loch\f42 http://opensource.org/licenses/bsd-license.php
 \par 
-\par \hich\af41\dbch\af13\loch\f41 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES
-\par \hich\af41\dbch\af13\loch\f41 OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-\par }{\*\themedata 504b030414000600080000002100828abc13fa0000001c020000130000005b436f6e74656e745f54797065735d2e786d6cac91cb6ac3301045f785fe83d0b6d8
-72ba28a5d8cea249777d2cd20f18e4b12d6a8f843409c9df77ecb850ba082d74231062ce997b55ae8fe3a00e1893f354e9555e6885647de3a8abf4fbee29bbd7
-2a3150038327acf409935ed7d757e5ee14302999a654e99e393c18936c8f23a4dc072479697d1c81e51a3b13c07e4087e6b628ee8cf5c4489cf1c4d075f92a0b
-44d7a07a83c82f308ac7b0a0f0fbf90c2480980b58abc733615aa2d210c2e02cb04430076a7ee833dfb6ce62e3ed7e14693e8317d8cd0433bf5c60f53fea2fe7
-065bd80facb647e9e25c7fc421fd2ddb526b2e9373fed4bb902e182e97b7b461e6bfad3f010000ffff0300504b030414000600080000002100a5d6a7e7c00000
-00360100000b0000005f72656c732f2e72656c73848fcf6ac3300c87ef85bd83d17d51d2c31825762fa590432fa37d00e1287f68221bdb1bebdb4fc7060abb08
-84a4eff7a93dfeae8bf9e194e720169aaa06c3e2433fcb68e1763dbf7f82c985a4a725085b787086a37bdbb55fbc50d1a33ccd311ba548b63095120f88d94fbc
-52ae4264d1c910d24a45db3462247fa791715fd71f989e19e0364cd3f51652d73760ae8fa8c9ffb3c330cc9e4fc17faf2ce545046e37944c69e462a1a82fe353
-bd90a865aad41ed0b5b8f9d6fd010000ffff0300504b0304140006000800000021006b799616830000008a0000001c0000007468656d652f7468656d652f7468
-656d654d616e616765722e786d6c0ccc4d0ac3201040e17da17790d93763bb284562b2cbaebbf600439c1a41c7a0d29fdbd7e5e38337cedf14d59b4b0d592c9c
-070d8a65cd2e88b7f07c2ca71ba8da481cc52c6ce1c715e6e97818c9b48d13df49c873517d23d59085adb5dd20d6b52bd521ef2cdd5eb9246a3d8b4757e8d3f7
-29e245eb2b260a0238fd010000ffff0300504b03041400060008000000210096b5ade296060000501b0000160000007468656d652f7468656d652f7468656d65
-312e786d6cec594f6fdb3614bf0fd87720746f6327761a07758ad8b19b2d4d1bc46e871e698996d850a240d2497d1bdae38001c3ba618715d86d87615b8116d8
-a5fb34d93a6c1dd0afb0475292c5585e9236d88aad3e2412f9e3fbff1e1fa9abd7eec70c1d1221294fda5efd72cd4324f1794093b0eddd1ef62fad79482a9c04
-98f184b4bd2991deb58df7dfbb8ad755446282607d22d771db8b944ad79796a40fc3585ee62949606ecc458c15bc8a702910f808e8c66c69b9565b5d8a314d3c
-94e018c8de1a8fa94fd05093f43672e23d06af89927ac06762a049136785c10607758d9053d965021d62d6f6804fc08f86e4bef210c352c144dbab999fb7b471
-7509af678b985ab0b6b4ae6f7ed9ba6c4170b06c788a705430adf71bad2b5b057d03606a1ed7ebf5babd7a41cf00b0ef83a6569632cd467faddec9699640f671
-9e76b7d6ac355c7c89feca9cccad4ea7d36c65b258a206641f1b73f8b5da6a6373d9c11b90c537e7f08dce66b7bbeae00dc8e257e7f0fd2badd5868b37a088d1
-e4600ead1ddaef67d40bc898b3ed4af81ac0d76a197c86826828a24bb318f3442d8ab518dfe3a20f000d6458d104a9694ac6d88728eee2782428d60cf03ac1a5
-193be4cbb921cd0b495fd054b5bd0f530c1931a3f7eaf9f7af9e3f45c70f9e1d3ff8e9f8e1c3e3073f5a42ceaa6d9c84e5552fbffdeccfc71fa33f9e7ef3f2d1
-17d57859c6fffac327bffcfc793510d26726ce8b2f9ffcf6ecc98baf3efdfdbb4715f04d814765f890c644a29be408edf3181433567125272371be15c308d3f2
-8acd249438c19a4b05fd9e8a1cf4cd296699771c393ac4b5e01d01e5a30a787d72cf1178108989a2159c77a2d801ee72ce3a5c545a6147f32a99793849c26ae6
-6252c6ed637c58c5bb8b13c7bfbd490a75330f4b47f16e441c31f7184e140e494214d273fc80900aedee52ead87597fa824b3e56e82e451d4c2b4d32a423279a
-668bb6690c7e9956e90cfe766cb37b077538abd27a8b1cba48c80acc2a841f12e698f13a9e281c57911ce298950d7e03aba84ac8c154f8655c4f2af074481847
-bd804859b5e696007d4b4edfc150b12addbecba6b18b148a1e54d1bc81392f23b7f84137c2715a851dd0242a633f900710a218ed715505dfe56e86e877f0034e
-16bafb0e258ebb4faf06b769e888340b103d3311da9750aa9d0a1cd3e4efca31a3508f6d0c5c5c398602f8e2ebc71591f5b616e24dd893aa3261fb44f95d843b
-5974bb5c04f4edafb95b7892ec1108f3f98de75dc97d5772bdff7cc95d94cf672db4b3da0a6557f70db629362d72bcb0431e53c6066acac80d699a6409fb44d0
-8741bdce9c0e4971624a2378cceaba830b05366b90e0ea23aaa241845368b0eb9e2612ca8c742851ca251ceccc70256d8d87265dd96361531f186c3d9058edf2
-c00eafe8e1fc5c509031bb4d680e9f39a3154de0accc56ae644441edd76156d7429d995bdd88664a9dc3ad50197c38af1a0c16d684060441db02565e85f3b966
-0d0713cc48a0ed6ef7dedc2dc60b17e92219e180643ed27acffba86e9c94c78ab90980d8a9f0913ee49d62b512b79626fb06dccee2a432bbc60276b9f7dec44b
-7904cfbca4f3f6443ab2a49c9c2c41476dafd55c6e7ac8c769db1bc399161ee314bc2e75cf8759081743be1236ec4f4d6693e5336fb672c5dc24a8c33585b5fb
-9cc24e1d4885545b58463634cc5416022cd19cacfccb4d30eb45296023fd35a458598360f8d7a4003bbaae25e331f155d9d9a5116d3bfb9a95523e51440ca2e0
-088dd844ec6370bf0e55d027a012ae264c45d02f708fa6ad6da6dce29c255df9f6cae0ec38666984b372ab5334cf640b37795cc860de4ae2816e95b21be5ceaf
-8a49f90b52a51cc6ff3355f47e0237052b81f6800fd7b802239daf6d8f0b1571a8426944fdbe80c6c1d40e8816b88b8569082ab84c36ff0539d4ff6dce591a26
-ade1c0a7f669880485fd484582903d284b26fa4e2156cff62e4b9265844c4495c495a9157b440e091bea1ab8aaf7760f4510eaa69a6465c0e04ec69ffb9e65d0
-28d44d4e39df9c1a52ecbd3607fee9cec7263328e5d661d3d0e4f62f44acd855ed7ab33cdf7bcb8ae889599bd5c8b3029895b6825696f6af29c239b75a5bb1e6
-345e6ee6c28117e73586c1a2214ae1be07e93fb0ff51e133fb65426fa843be0fb515c187064d0cc206a2fa926d3c902e907670048d931db4c1a44959d366ad93
-b65abe595f70a75bf03d616c2dd959fc7d4e6317cd99cbcec9c58b34766661c7d6766ca1a9c1b327531486c6f941c638c67cd22a7f75e2a37be0e82db8df9f30
-254d30c1372581a1f51c983c80e4b71ccdd28dbf000000ffff0300504b0304140006000800000021000dd1909fb60000001b010000270000007468656d652f74
-68656d652f5f72656c732f7468656d654d616e616765722e786d6c2e72656c73848f4d0ac2301484f78277086f6fd3ba109126dd88d0add40384e4350d363f24
-51eced0dae2c082e8761be9969bb979dc9136332de3168aa1a083ae995719ac16db8ec8e4052164e89d93b64b060828e6f37ed1567914b284d262452282e3198
-720e274a939cd08a54f980ae38a38f56e422a3a641c8bbd048f7757da0f19b017cc524bd62107bd5001996509affb3fd381a89672f1f165dfe514173d9850528
-a2c6cce0239baa4c04ca5bbabac4df000000ffff0300504b01022d0014000600080000002100828abc13fa0000001c0200001300000000000000000000000000
-000000005b436f6e74656e745f54797065735d2e786d6c504b01022d0014000600080000002100a5d6a7e7c0000000360100000b000000000000000000000000
-002b0100005f72656c732f2e72656c73504b01022d00140006000800000021006b799616830000008a0000001c00000000000000000000000000140200007468
-656d652f7468656d652f7468656d654d616e616765722e786d6c504b01022d001400060008000000210096b5ade296060000501b000016000000000000000000
-00000000d10200007468656d652f7468656d652f7468656d65312e786d6c504b01022d00140006000800000021000dd1909fb60000001b010000270000000000
-00000000000000009b0900007468656d652f7468656d652f5f72656c732f7468656d654d616e616765722e786d6c2e72656c73504b050600000000050005005d010000960a00000000}
+\par \hich\af42\dbch\af13\loch\f42 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES
+\par \hich\af42\dbch\af13\loch\f42 OR RE\hich\af42\dbch\af13\loch\f42 PRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+\par }{\*\themedata 504b030414000600080000002100e9de0fbfff0000001c020000130000005b436f6e74656e745f54797065735d2e786d6cac91cb4ec3301045f748fc83e52d4a
+9cb2400825e982c78ec7a27cc0c8992416c9d8b2a755fbf74cd25442a820166c2cd933f79e3be372bd1f07b5c3989ca74aaff2422b24eb1b475da5df374fd9ad
+5689811a183c61a50f98f4babebc2837878049899a52a57be670674cb23d8e90721f90a4d2fa3802cb35762680fd800ecd7551dc18eb899138e3c943d7e503b6
+b01d583deee5f99824e290b4ba3f364eac4a430883b3c092d4eca8f946c916422ecab927f52ea42b89a1cd59c254f919b0e85e6535d135a8de20f20b8c12c3b0
+0c895fcf6720192de6bf3b9e89ecdbd6596cbcdd8eb28e7c365ecc4ec1ff1460f53fe813d3cc7f5b7f020000ffff0300504b030414000600080000002100a5d6
+a7e7c0000000360100000b0000005f72656c732f2e72656c73848fcf6ac3300c87ef85bd83d17d51d2c31825762fa590432fa37d00e1287f68221bdb1bebdb4f
+c7060abb0884a4eff7a93dfeae8bf9e194e720169aaa06c3e2433fcb68e1763dbf7f82c985a4a725085b787086a37bdbb55fbc50d1a33ccd311ba548b6309512
+0f88d94fbc52ae4264d1c910d24a45db3462247fa791715fd71f989e19e0364cd3f51652d73760ae8fa8c9ffb3c330cc9e4fc17faf2ce545046e37944c69e462
+a1a82fe353bd90a865aad41ed0b5b8f9d6fd010000ffff0300504b0304140006000800000021006b799616830000008a0000001c0000007468656d652f746865
+6d652f7468656d654d616e616765722e786d6c0ccc4d0ac3201040e17da17790d93763bb284562b2cbaebbf600439c1a41c7a0d29fdbd7e5e38337cedf14d59b
+4b0d592c9c070d8a65cd2e88b7f07c2ca71ba8da481cc52c6ce1c715e6e97818c9b48d13df49c873517d23d59085adb5dd20d6b52bd521ef2cdd5eb9246a3d8b
+4757e8d3f729e245eb2b260a0238fd010000ffff0300504b03041400060008000000210096b5ade296060000501b0000160000007468656d652f7468656d652f
+7468656d65312e786d6cec594f6fdb3614bf0fd87720746f6327761a07758ad8b19b2d4d1bc46e871e698996d850a240d2497d1bdae38001c3ba618715d86d87
+615b8116d8a5fb34d93a6c1dd0afb0475292c5585e9236d88aad3e2412f9e3fbff1e1fa9abd7eec70c1d1221294fda5efd72cd4324f1794093b0eddd1ef62fad
+79482a9c0498f184b4bd2991deb58df7dfbb8ad755446282607d22d771db8b944ad79796a40fc3585ee62949606ecc458c15bc8a702910f808e8c66c69b9565b
+5d8a314d3c94e018c8de1a8fa94fd05093f43672e23d06af89927ac06762a049136785c10607758d9053d965021d62d6f6804fc08f86e4bef210c352c144dbab
+999fb7b4717509af678b985ab0b6b4ae6f7ed9ba6c4170b06c788a705430adf71bad2b5b057d03606a1ed7ebf5babd7a41cf00b0ef83a6569632cd467faddec9
+699640f6719e76b7d6ac355c7c89feca9cccad4ea7d36c65b258a206641f1b73f8b5da6a6373d9c11b90c537e7f08dce66b7bbeae00dc8e257e7f0fd2badd586
+8b37a088d1e4600ead1ddaef67d40bc898b3ed4af81ac0d76a197c86826828a24bb318f3442d8ab518dfe3a20f000d6458d104a9694ac6d88728eee2782428d6
+0cf03ac1a5193be4cbb921cd0b495fd054b5bd0f530c1931a3f7eaf9f7af9e3f45c70f9e1d3ff8e9f8e1c3e3073f5a42ceaa6d9c84e5552fbffdeccfc71fa33f
+9e7ef3f2d117d57859c6fffac327bffcfc793510d26726ce8b2f9ffcf6ecc98baf3efdfdbb4715f04d814765f890c644a29be408edf3181433567125272371be
+15c308d3f28acd249438c19a4b05fd9e8a1cf4cd296699771c393ac4b5e01d01e5a30a787d72cf1178108989a2159c77a2d801ee72ce3a5c545a6147f32a9979
+3849c26ae66252c6ed637c58c5bb8b13c7bfbd490a75330f4b47f16e441c31f7184e140e494214d273fc80900aedee52ead87597fa824b3e56e82e451d4c2b4d
+32a423279a668bb6690c7e9956e90cfe766cb37b077538abd27a8b1cba48c80acc2a841f12e698f13a9e281c57911ce298950d7e03aba84ac8c154f8655c4f2a
+f074481847bd804859b5e696007d4b4edfc150b12addbecba6b18b148a1e54d1bc81392f23b7f84137c2715a851dd0242a633f900710a218ed715505dfe56e86
+e877f0034e16bafb0e258ebb4faf06b769e888340b103d3311da9750aa9d0a1cd3e4efca31a3508f6d0c5c5c398602f8e2ebc71591f5b616e24dd893aa3261fb
+44f95d843b5974bb5c04f4edafb95b7892ec1108f3f98de75dc97d5772bdff7cc95d94cf672db4b3da0a6557f70db629362d72bcb0431e53c6066acac80d699a
+6409fb44d08741bdce9c0e4971624a2378cceaba830b05366b90e0ea23aaa241845368b0eb9e2612ca8c742851ca251ceccc70256d8d87265dd96361531f186c
+3d9058edf2c00eafe8e1fc5c509031bb4d680e9f39a3154de0accc56ae644441edd76156d7429d995bdd88664a9dc3ad50197c38af1a0c16d684060441db0256
+5e85f3b9660d0713cc48a0ed6ef7dedc2dc60b17e92219e180643ed27acffba86e9c94c78ab90980d8a9f0913ee49d62b512b79626fb06dccee2a432bbc60276
+b9f7dec44b7904cfbca4f3f6443ab2a49c9c2c41476dafd55c6e7ac8c769db1bc399161ee314bc2e75cf8759081743be1236ec4f4d6693e5336fb672c5dc24a8
+c33585b5fb9cc24e1d4885545b58463634cc5416022cd19cacfccb4d30eb45296023fd35a458598360f8d7a4003bbaae25e331f155d9d9a5116d3bfb9a95523e
+51440ca2e0088dd844ec6370bf0e55d027a012ae264c45d02f708fa6ad6da6dce29c255df9f6cae0ec38666984b372ab5334cf640b37795cc860de4ae2816e95
+b21be5ceaf8a49f90b52a51cc6ff3355f47e0237052b81f6800fd7b802239daf6d8f0b1571a8426944fdbe80c6c1d40e8816b88b8569082ab84c36ff0539d4ff
+6dce591a26ade1c0a7f669880485fd484582903d284b26fa4e2156cff62e4b9265844c4495c495a9157b440e091bea1ab8aaf7760f4510eaa69a6465c0e04ec6
+9ffb9e65d028d44d4e39df9c1a52ecbd3607fee9cec7263328e5d661d3d0e4f62f44acd855ed7ab33cdf7bcb8ae889599bd5c8b3029895b6825696f6af29c239
+b75a5bb1e6345e6ee6c28117e73586c1a2214ae1be07e93fb0ff51e133fb65426fa843be0fb515c187064d0cc206a2fa926d3c902e907670048d931db4c1a449
+59d366ad93b65abe595f70a75bf03d616c2dd959fc7d4e6317cd99cbcec9c58b34766661c7d6766ca1a9c1b327531486c6f941c638c67cd22a7f75e2a37be0e8
+2db8df9f30254d30c1372581a1f51c983c80e4b71ccdd28dbf000000ffff0300504b0304140006000800000021000dd1909fb60000001b010000270000007468
+656d652f7468656d652f5f72656c732f7468656d654d616e616765722e786d6c2e72656c73848f4d0ac2301484f78277086f6fd3ba109126dd88d0add40384e4
+350d363f2451eced0dae2c082e8761be9969bb979dc9136332de3168aa1a083ae995719ac16db8ec8e4052164e89d93b64b060828e6f37ed1567914b284d2624
+52282e3198720e274a939cd08a54f980ae38a38f56e422a3a641c8bbd048f7757da0f19b017cc524bd62107bd5001996509affb3fd381a89672f1f165dfe5141
+73d9850528a2c6cce0239baa4c04ca5bbabac4df000000ffff0300504b01022d0014000600080000002100e9de0fbfff0000001c020000130000000000000000
+0000000000000000005b436f6e74656e745f54797065735d2e786d6c504b01022d0014000600080000002100a5d6a7e7c0000000360100000b00000000000000
+000000000000300100005f72656c732f2e72656c73504b01022d00140006000800000021006b799616830000008a0000001c0000000000000000000000000019
+0200007468656d652f7468656d652f7468656d654d616e616765722e786d6c504b01022d001400060008000000210096b5ade296060000501b00001600000000
+000000000000000000d60200007468656d652f7468656d652f7468656d65312e786d6c504b01022d00140006000800000021000dd1909fb60000001b01000027
+00000000000000000000000000a00900007468656d652f7468656d652f5f72656c732f7468656d654d616e616765722e786d6c2e72656c73504b050600000000050005005d0100009b0a00000000}
 {\*\colorschememapping 3c3f786d6c2076657273696f6e3d22312e302220656e636f64696e673d225554462d3822207374616e64616c6f6e653d22796573223f3e0d0a3c613a636c724d
 617020786d6c6e733a613d22687474703a2f2f736368656d61732e6f70656e786d6c666f726d6174732e6f72672f64726177696e676d6c2f323030362f6d6169
 6e22206267313d226c743122207478313d22646b3122206267323d226c743222207478323d22646b322220616363656e74313d22616363656e74312220616363
 656e74323d22616363656e74322220616363656e74333d22616363656e74332220616363656e74343d22616363656e74342220616363656e74353d22616363656e74352220616363656e74363d22616363656e74362220686c696e6b3d22686c696e6b2220666f6c486c696e6b3d22666f6c486c696e6b222f3e}
-{\*\latentstyles\lsdstimax267\lsdlockeddef0\lsdsemihiddendef1\lsdunhideuseddef1\lsdqformatdef0\lsdprioritydef99{\lsdlockedexcept \lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 Normal;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 heading 1;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 heading 2;\lsdqformat1 \lsdpriority0 heading 3;\lsdqformat1 \lsdpriority0 heading 4;\lsdqformat1 \lsdpriority0 heading 5;
-\lsdqformat1 \lsdpriority0 heading 6;\lsdqformat1 \lsdpriority0 heading 7;\lsdqformat1 \lsdpriority0 heading 8;\lsdqformat1 \lsdpriority0 heading 9;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 7;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 8;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 toc 9;\lsdqformat1 \lsdpriority0 caption;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 Title;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 Default Paragraph Font;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 Subtitle;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 Strong;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority0 Emphasis;\lsdsemihidden0 \lsdunhideused0 \lsdpriority0 Table Grid;\lsdunhideused0 \lsdlocked0 Placeholder Text;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority1 \lsdlocked0 No Spacing;\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading;\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid;\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading;\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List;\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 1;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 1;
-\lsdunhideused0 \lsdlocked0 Revision;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority34 \lsdlocked0 List Paragraph;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority29 \lsdlocked0 Quote;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority30 \lsdlocked0 Intense Quote;\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 1;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 1;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 1;\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 1;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 2;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 2;\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 3;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 3;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 3;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 3;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 3;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 3;\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 4;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 4;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 4;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 4;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 4;\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 4;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 5;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 5;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 5;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 5;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 5;\lsdsemihidden0 \lsdunhideused0 \lsdpriority60 \lsdlocked0 Light Shading Accent 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority61 \lsdlocked0 Light List Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority62 \lsdlocked0 Light Grid Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority65 \lsdlocked0 Medium List 1 Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority66 \lsdlocked0 Medium List 2 Accent 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority70 \lsdlocked0 Dark List Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority71 \lsdlocked0 Colorful Shading Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdpriority72 \lsdlocked0 Colorful List Accent 6;
-\lsdsemihidden0 \lsdunhideused0 \lsdpriority73 \lsdlocked0 Colorful Grid Accent 6;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority19 \lsdlocked0 Subtle Emphasis;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority21 \lsdlocked0 Intense Emphasis;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority31 \lsdlocked0 Subtle Reference;
-\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority32 \lsdlocked0 Intense Reference;\lsdsemihidden0 \lsdunhideused0 \lsdqformat1 \lsdpriority33 \lsdlocked0 Book Title;\lsdpriority37 \lsdlocked0 Bibliography;
-\lsdqformat1 \lsdpriority39 \lsdlocked0 TOC Heading;}}{\*\datastore 0105000002000000180000004d73786d6c322e534158584d4c5265616465722e352e3000000000000000000000060000
+{\*\latentstyles\lsdstimax371\lsdlockeddef0\lsdsemihiddendef0\lsdunhideuseddef0\lsdqformatdef0\lsdprioritydef99{\lsdlockedexcept \lsdqformat1 \lsdpriority0 Normal;\lsdqformat1 \lsdpriority0 heading 1;\lsdqformat1 \lsdpriority0 heading 2;
+\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 3;\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 4;\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 5;
+\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 6;\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 7;\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 8;
+\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 heading 9;\lsdpriority0 toc 1;\lsdpriority0 toc 2;\lsdpriority0 toc 3;\lsdpriority0 toc 4;\lsdpriority0 toc 5;\lsdpriority0 toc 6;\lsdpriority0 toc 7;\lsdpriority0 toc 8;\lsdpriority0 toc 9;
+\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority0 caption;\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 List Number;\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 List 4;\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 List 5;
+\lsdqformat1 \lsdpriority0 Title;\lsdpriority0 Default Paragraph Font;\lsdqformat1 \lsdpriority0 Subtitle;\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 Salutation;\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 Date;
+\lsdsemihidden1 \lsdunhideused1 \lsdlocked0 Body Text First Indent;\lsdqformat1 \lsdpriority0 Strong;\lsdqformat1 \lsdpriority0 Emphasis;\lsdpriority0 Table Grid;\lsdsemihidden1 \lsdlocked0 Placeholder Text;
+\lsdqformat1 \lsdpriority1 \lsdlocked0 No Spacing;\lsdpriority60 \lsdlocked0 Light Shading;\lsdpriority61 \lsdlocked0 Light List;\lsdpriority62 \lsdlocked0 Light Grid;\lsdpriority63 \lsdlocked0 Medium Shading 1;\lsdpriority64 \lsdlocked0 Medium Shading 2;
+\lsdpriority65 \lsdlocked0 Medium List 1;\lsdpriority66 \lsdlocked0 Medium List 2;\lsdpriority67 \lsdlocked0 Medium Grid 1;\lsdpriority68 \lsdlocked0 Medium Grid 2;\lsdpriority69 \lsdlocked0 Medium Grid 3;\lsdpriority70 \lsdlocked0 Dark List;
+\lsdpriority71 \lsdlocked0 Colorful Shading;\lsdpriority72 \lsdlocked0 Colorful List;\lsdpriority73 \lsdlocked0 Colorful Grid;\lsdpriority60 \lsdlocked0 Light Shading Accent 1;\lsdpriority61 \lsdlocked0 Light List Accent 1;
+\lsdpriority62 \lsdlocked0 Light Grid Accent 1;\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 1;\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 1;\lsdpriority65 \lsdlocked0 Medium List 1 Accent 1;\lsdsemihidden1 \lsdlocked0 Revision;
+\lsdqformat1 \lsdpriority34 \lsdlocked0 List Paragraph;\lsdqformat1 \lsdpriority29 \lsdlocked0 Quote;\lsdqformat1 \lsdpriority30 \lsdlocked0 Intense Quote;\lsdpriority66 \lsdlocked0 Medium List 2 Accent 1;\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 1;
+\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 1;\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 1;\lsdpriority70 \lsdlocked0 Dark List Accent 1;\lsdpriority71 \lsdlocked0 Colorful Shading Accent 1;\lsdpriority72 \lsdlocked0 Colorful List Accent 1;
+\lsdpriority73 \lsdlocked0 Colorful Grid Accent 1;\lsdpriority60 \lsdlocked0 Light Shading Accent 2;\lsdpriority61 \lsdlocked0 Light List Accent 2;\lsdpriority62 \lsdlocked0 Light Grid Accent 2;\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 2;
+\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 2;\lsdpriority65 \lsdlocked0 Medium List 1 Accent 2;\lsdpriority66 \lsdlocked0 Medium List 2 Accent 2;\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 2;\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 2;
+\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 2;\lsdpriority70 \lsdlocked0 Dark List Accent 2;\lsdpriority71 \lsdlocked0 Colorful Shading Accent 2;\lsdpriority72 \lsdlocked0 Colorful List Accent 2;\lsdpriority73 \lsdlocked0 Colorful Grid Accent 2;
+\lsdpriority60 \lsdlocked0 Light Shading Accent 3;\lsdpriority61 \lsdlocked0 Light List Accent 3;\lsdpriority62 \lsdlocked0 Light Grid Accent 3;\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 3;\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 3;
+\lsdpriority65 \lsdlocked0 Medium List 1 Accent 3;\lsdpriority66 \lsdlocked0 Medium List 2 Accent 3;\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 3;\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 3;\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 3;
+\lsdpriority70 \lsdlocked0 Dark List Accent 3;\lsdpriority71 \lsdlocked0 Colorful Shading Accent 3;\lsdpriority72 \lsdlocked0 Colorful List Accent 3;\lsdpriority73 \lsdlocked0 Colorful Grid Accent 3;\lsdpriority60 \lsdlocked0 Light Shading Accent 4;
+\lsdpriority61 \lsdlocked0 Light List Accent 4;\lsdpriority62 \lsdlocked0 Light Grid Accent 4;\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 4;\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 4;\lsdpriority65 \lsdlocked0 Medium List 1 Accent 4;
+\lsdpriority66 \lsdlocked0 Medium List 2 Accent 4;\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 4;\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 4;\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 4;\lsdpriority70 \lsdlocked0 Dark List Accent 4;
+\lsdpriority71 \lsdlocked0 Colorful Shading Accent 4;\lsdpriority72 \lsdlocked0 Colorful List Accent 4;\lsdpriority73 \lsdlocked0 Colorful Grid Accent 4;\lsdpriority60 \lsdlocked0 Light Shading Accent 5;\lsdpriority61 \lsdlocked0 Light List Accent 5;
+\lsdpriority62 \lsdlocked0 Light Grid Accent 5;\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 5;\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 5;\lsdpriority65 \lsdlocked0 Medium List 1 Accent 5;\lsdpriority66 \lsdlocked0 Medium List 2 Accent 5;
+\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 5;\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 5;\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 5;\lsdpriority70 \lsdlocked0 Dark List Accent 5;\lsdpriority71 \lsdlocked0 Colorful Shading Accent 5;
+\lsdpriority72 \lsdlocked0 Colorful List Accent 5;\lsdpriority73 \lsdlocked0 Colorful Grid Accent 5;\lsdpriority60 \lsdlocked0 Light Shading Accent 6;\lsdpriority61 \lsdlocked0 Light List Accent 6;\lsdpriority62 \lsdlocked0 Light Grid Accent 6;
+\lsdpriority63 \lsdlocked0 Medium Shading 1 Accent 6;\lsdpriority64 \lsdlocked0 Medium Shading 2 Accent 6;\lsdpriority65 \lsdlocked0 Medium List 1 Accent 6;\lsdpriority66 \lsdlocked0 Medium List 2 Accent 6;
+\lsdpriority67 \lsdlocked0 Medium Grid 1 Accent 6;\lsdpriority68 \lsdlocked0 Medium Grid 2 Accent 6;\lsdpriority69 \lsdlocked0 Medium Grid 3 Accent 6;\lsdpriority70 \lsdlocked0 Dark List Accent 6;\lsdpriority71 \lsdlocked0 Colorful Shading Accent 6;
+\lsdpriority72 \lsdlocked0 Colorful List Accent 6;\lsdpriority73 \lsdlocked0 Colorful Grid Accent 6;\lsdqformat1 \lsdpriority19 \lsdlocked0 Subtle Emphasis;\lsdqformat1 \lsdpriority21 \lsdlocked0 Intense Emphasis;
+\lsdqformat1 \lsdpriority31 \lsdlocked0 Subtle Reference;\lsdqformat1 \lsdpriority32 \lsdlocked0 Intense Reference;\lsdqformat1 \lsdpriority33 \lsdlocked0 Book Title;\lsdsemihidden1 \lsdunhideused1 \lsdpriority37 \lsdlocked0 Bibliography;
+\lsdsemihidden1 \lsdunhideused1 \lsdqformat1 \lsdpriority39 \lsdlocked0 TOC Heading;\lsdpriority41 \lsdlocked0 Plain Table 1;\lsdpriority42 \lsdlocked0 Plain Table 2;\lsdpriority43 \lsdlocked0 Plain Table 3;\lsdpriority44 \lsdlocked0 Plain Table 4;
+\lsdpriority45 \lsdlocked0 Plain Table 5;\lsdpriority40 \lsdlocked0 Grid Table Light;\lsdpriority46 \lsdlocked0 Grid Table 1 Light;\lsdpriority47 \lsdlocked0 Grid Table 2;\lsdpriority48 \lsdlocked0 Grid Table 3;\lsdpriority49 \lsdlocked0 Grid Table 4;
+\lsdpriority50 \lsdlocked0 Grid Table 5 Dark;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful;\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful;\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 1;\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 1;
+\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 1;\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 1;\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 1;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 1;
+\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 1;\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 2;\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 2;\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 2;
+\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 2;\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 2;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 2;\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 2;
+\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 3;\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 3;\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 3;\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 3;
+\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 3;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 3;\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 3;\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 4;
+\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 4;\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 4;\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 4;\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 4;
+\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 4;\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 4;\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 5;\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 5;
+\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 5;\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 5;\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 5;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 5;
+\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 5;\lsdpriority46 \lsdlocked0 Grid Table 1 Light Accent 6;\lsdpriority47 \lsdlocked0 Grid Table 2 Accent 6;\lsdpriority48 \lsdlocked0 Grid Table 3 Accent 6;
+\lsdpriority49 \lsdlocked0 Grid Table 4 Accent 6;\lsdpriority50 \lsdlocked0 Grid Table 5 Dark Accent 6;\lsdpriority51 \lsdlocked0 Grid Table 6 Colorful Accent 6;\lsdpriority52 \lsdlocked0 Grid Table 7 Colorful Accent 6;
+\lsdpriority46 \lsdlocked0 List Table 1 Light;\lsdpriority47 \lsdlocked0 List Table 2;\lsdpriority48 \lsdlocked0 List Table 3;\lsdpriority49 \lsdlocked0 List Table 4;\lsdpriority50 \lsdlocked0 List Table 5 Dark;
+\lsdpriority51 \lsdlocked0 List Table 6 Colorful;\lsdpriority52 \lsdlocked0 List Table 7 Colorful;\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 1;\lsdpriority47 \lsdlocked0 List Table 2 Accent 1;\lsdpriority48 \lsdlocked0 List Table 3 Accent 1;
+\lsdpriority49 \lsdlocked0 List Table 4 Accent 1;\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 1;\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 1;\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 1;
+\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 2;\lsdpriority47 \lsdlocked0 List Table 2 Accent 2;\lsdpriority48 \lsdlocked0 List Table 3 Accent 2;\lsdpriority49 \lsdlocked0 List Table 4 Accent 2;
+\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 2;\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 2;\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 2;\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 3;
+\lsdpriority47 \lsdlocked0 List Table 2 Accent 3;\lsdpriority48 \lsdlocked0 List Table 3 Accent 3;\lsdpriority49 \lsdlocked0 List Table 4 Accent 3;\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 3;
+\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 3;\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 3;\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 4;\lsdpriority47 \lsdlocked0 List Table 2 Accent 4;
+\lsdpriority48 \lsdlocked0 List Table 3 Accent 4;\lsdpriority49 \lsdlocked0 List Table 4 Accent 4;\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 4;\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 4;
+\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 4;\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 5;\lsdpriority47 \lsdlocked0 List Table 2 Accent 5;\lsdpriority48 \lsdlocked0 List Table 3 Accent 5;
+\lsdpriority49 \lsdlocked0 List Table 4 Accent 5;\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 5;\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 5;\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 5;
+\lsdpriority46 \lsdlocked0 List Table 1 Light Accent 6;\lsdpriority47 \lsdlocked0 List Table 2 Accent 6;\lsdpriority48 \lsdlocked0 List Table 3 Accent 6;\lsdpriority49 \lsdlocked0 List Table 4 Accent 6;
+\lsdpriority50 \lsdlocked0 List Table 5 Dark Accent 6;\lsdpriority51 \lsdlocked0 List Table 6 Colorful Accent 6;\lsdpriority52 \lsdlocked0 List Table 7 Colorful Accent 6;}}{\*\datastore 010500000200000018000000
+4d73786d6c322e534158584d4c5265616465722e362e3000000000000000000000060000
 d0cf11e0a1b11ae1000000000000000000000000000000003e000300feff090006000000000000000000000001000000010000000000000000100000feffffff00000000feffffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
 ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
 ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
@@ -436,8 +469,8 @@ fffffffffffffffffdfffffffeffffffffffffffffffffffffffffffffffffffffffffffffffffff
 ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
 ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
 ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffff52006f006f007400200045006e00740072007900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000016000500ffffffffffffffffffffffffec69d9888b8b3d4c859eaf6cd158be0f000000000000000000000000e0ee
-b81fa567cc01feffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000
+ffffffffffffffffffffffffffffffff52006f006f007400200045006e00740072007900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000016000500ffffffffffffffffffffffff0c6ad98892f1d411a65f0040963251e5000000000000000000000000705c
+ab3bd42cd101feffffff00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff00000000000000000000000000000000000000000000000000000000
 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000
 000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffff000000000000000000000000000000000000000000000000
 0000000000000000000000000000000000000000000000000105000000000000}}
\ No newline at end of file

From f8ae6c9e4c81bcc2b77e11a79b6bfd45390e0c9f Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:51:00 +0000
Subject: [PATCH 282/525] Revert the change in r19143 for BUILDRULEORDER.

(Sync patch r19150 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19380 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 27 ----------------------
 1 file changed, 27 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index cf0b4466f992..4c627dfb555a 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -2713,36 +2713,9 @@ def _GetSourceFileList(self):
                 if F.Dir not in self.IncludePathList and self.AutoGenVersion >= 0x00010005:
                     self.IncludePathList.insert(0, F.Dir)
                 self._SourceFileList.append(F)
-
-            self._MatchBuildRuleOrder(self._SourceFileList)
-
-            for F in self._SourceFileList:
                 self._ApplyBuildRule(F, TAB_UNKNOWN_FILE)
         return self._SourceFileList
 
-    def _MatchBuildRuleOrder(self, FileList):
-        Order_Dict = {}
-        self._GetModuleBuildOption()
-        for SingleFile in FileList:
-            if self.BuildRuleOrder and SingleFile.Ext in self.BuildRuleOrder:
-                key = SingleFile.Path.split(SingleFile.Ext)[0]
-                if key in Order_Dict:
-                    Order_Dict[key].append(SingleFile.Ext)
-                else:
-                    Order_Dict[key] = [SingleFile.Ext]
-
-        RemoveList = []
-        for F in Order_Dict:
-            if len(Order_Dict[F]) > 1:
-                Order_Dict[F].sort(key=lambda i: self.BuildRuleOrder.index(i))
-                for Ext in Order_Dict[F][1:]:
-                    RemoveList.append(F + Ext)
-                   
-        for item in RemoveList:
-            FileList.remove(item)
-
-        return FileList
-
     ## Return the list of unicode files
     def _GetUnicodeFileList(self):
         if self._UnicodeFileList == None:

From 033469d9a9ed257afe3073e9d97ef4a85cbcf366 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 18 Dec 2015 06:51:36 +0000
Subject: [PATCH 283/525] BaseTools GCC: avoid the use of COMMON symbols

The default behavior of the GCC compiler is to emit uninitialized globals
with external linkage into a COMMON section, where duplicate definitions
are merged. This may result in unexpected behavior, since global variables
defined under the same name in different C files may not refer to the same
logical data item.

For instance, the definitions of EFI_EVENT mVirtualAddressChangeEvent that
[used to] appear in the following files:

  CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
  MdeModulePkg/Universal/Variable/RuntimeDxe/VariableDxe.c

will be folded into a single instance of the variable when the latter
module includes the former library, which can lead to unexpected results.

Even if some may argue that there are legal uses for COMMON allocation, the
high modularity of EDK2 combined with the low level of awareness of the
intracicies surrounding common allocation and the generally poor EDK2
developer discipline regarding the use of the STATIC keyword* make a strong
case for disabling it by default, and re-enabling it explicitly for packages
that depend on it.

So prevent GCC from emitting variables into the COMMON section, by passing
-fno-common to the compiler, and discarding the section in the GNU ld linker
script.

* Any function or variable that is only referenced from the translation unit
  that defines it could be made STATIC. This does not only prevent issues
  like the above, it also allows the compiler to generate better code, e.g.,
  drop out of line function definitions after inlining all invocations or
  perform constant propagation on variables.

(Sync patch r19164 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19381 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Conf/tools_def.template | 4 ++--
 BaseTools/Scripts/GccBase.lds     | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index d6b0af43d772..1a44fbd1d3eb 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -4318,7 +4318,7 @@ NOOPT_DDK3790xASL_IPF_DLINK_FLAGS    = /NOLOGO /NODEFAULTLIB /LTCG /DLL /OPT:REF
 DEBUG_*_*_OBJCOPY_ADDDEBUGFLAG     = --add-gnu-debuglink=$(DEBUG_DIR)/$(MODULE_NAME).debug
 RELEASE_*_*_OBJCOPY_ADDDEBUGFLAG   =
 
-DEFINE GCC_ALL_CC_FLAGS            = -g -Os -fshort-wchar -fno-strict-aliasing -Wall -Werror -Wno-array-bounds -c -include AutoGen.h
+DEFINE GCC_ALL_CC_FLAGS            = -g -Os -fshort-wchar -fno-strict-aliasing -Wall -Werror -Wno-array-bounds -c -include AutoGen.h -fno-common
 DEFINE GCC_IA32_CC_FLAGS           = DEF(GCC_ALL_CC_FLAGS) -m32 -malign-double -freorder-blocks -freorder-blocks-and-partition -O2 -mno-stack-arg-probe
 DEFINE GCC_X64_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mno-red-zone -Wno-address -mno-stack-arg-probe
 DEFINE GCC_IPF_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -minline-int-divide-min-latency
@@ -4349,7 +4349,7 @@ DEFINE GCC_IPF_RC_FLAGS            = -I binary -O elf64-ia64-little   -B ia64
 DEFINE GCC_ARM_RC_FLAGS            = -I binary -O elf32-littlearm     -B arm     --rename-section .data=.hii
 DEFINE GCC_AARCH64_RC_FLAGS        = -I binary -O elf64-littleaarch64 -B aarch64 --rename-section .data=.hii
 
-DEFINE GCC44_ALL_CC_FLAGS            = -g -fshort-wchar -fno-strict-aliasing -Wall -Werror -Wno-array-bounds -ffunction-sections -fdata-sections -c -include AutoGen.h -DSTRING_ARRAY_NAME=$(BASE_NAME)Strings
+DEFINE GCC44_ALL_CC_FLAGS            = -g -fshort-wchar -fno-strict-aliasing -Wall -Werror -Wno-array-bounds -ffunction-sections -fdata-sections -c -include AutoGen.h -fno-common -DSTRING_ARRAY_NAME=$(BASE_NAME)Strings
 DEFINE GCC44_IA32_CC_FLAGS           = DEF(GCC44_ALL_CC_FLAGS) -m32 -malign-double -fno-stack-protector -D EFI32 -fno-asynchronous-unwind-tables
 DEFINE GCC44_X64_CC_FLAGS            = DEF(GCC44_ALL_CC_FLAGS) -m64 -fno-stack-protector "-DEFIAPI=__attribute__((ms_abi))" -DNO_BUILTIN_VA_FUNCS -mno-red-zone -Wno-address -mcmodel=large -fno-asynchronous-unwind-tables
 DEFINE GCC44_IA32_X64_DLINK_COMMON   = -nostdlib -n -q --gc-sections -z common-page-size=0x20
diff --git a/BaseTools/Scripts/GccBase.lds b/BaseTools/Scripts/GccBase.lds
index 4ee6d998532c..32310bc75dcc 100644
--- a/BaseTools/Scripts/GccBase.lds
+++ b/BaseTools/Scripts/GccBase.lds
@@ -46,7 +46,7 @@ SECTIONS {
    */
   .data ALIGN(ALIGNOF(.text)) : ALIGN(CONSTANT(COMMONPAGESIZE)) {
     *(.data .data.* .gnu.linkonce.d.*)
-    *(.bss .bss.* *COM*)
+    *(.bss .bss.*)
   }
 
   .eh_frame ALIGN(CONSTANT(COMMONPAGESIZE)) : {
@@ -66,5 +66,6 @@ SECTIONS {
     *(.dynamic)
     *(.hash)
     *(.comment)
+    *(COMMON)
   }
 }

From 8bc5c95c550103317b739d3d620b189d03121062 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 18 Dec 2015 06:52:09 +0000
Subject: [PATCH 284/525] BaseTools RVCT: use scatter file to enforce minimum
 section alignment

Up until SVN r18540, GenFw created invalid PE/COFF binaries for the ARM
architecture, by allowing PE/COFF .data sections to appear at offsets
that were not aligned to the global PE/COFF section alignment. The
reason for this was that the relocation metadata emitted by RVCT's
armlink only contains dynamic absolute relocations, so it is impossible
to recalculate relative relocations between .text and .data, and so the
relative offset between the two needs to be preserved.

Since r18540, we do align .data to the PE/COFF section alignment,
resulting in potentially corrupt PE/COFF binaries unless .data happens
to appear at a 32-byte aligned offset. So let's introduce a RVCT scatter
file that sets this alignment for the ELF .data section (and subsequent
.bss section).

At the same time, set the start offset to 0x220 bytes (which is the size
of our 32-bit PE/COFF header) so that the memory layouts are identical
between ELF and PE/COFF. Also add a 4 KB aligned version that can be
used to build DXE_RUNTIME_DRIVER modules with runtime memory protection
enabled.

(Sync patch r19235 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Eugene Cohen <eugene@hp.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19382 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Conf/tools_def.template  |  2 +-
 BaseTools/Scripts/Rvct-Align32.sct | 25 +++++++++++++++++++++++++
 BaseTools/Scripts/Rvct-Align4K.sct | 25 +++++++++++++++++++++++++
 3 files changed, 51 insertions(+), 1 deletion(-)
 create mode 100644 BaseTools/Scripts/Rvct-Align32.sct
 create mode 100644 BaseTools/Scripts/Rvct-Align4K.sct

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index 1a44fbd1d3eb..fc79bd660142 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -7128,7 +7128,7 @@ RELEASE_XCODE5_X64_CC_FLAGS   = -target x86_64-pc-win32-macho -c    -Os       -W
 
 DEFINE RVCT_ALL_ASM_FLAGS   = --diag_suppress=1786 --diag_error=warning --apcs /interwork
 DEFINE RVCT_ALL_CC_FLAGS    = --c90 -c --no_autoinline --asm --gnu --apcs /interwork --signed_chars --no_unaligned_access --split_sections --enum_is_int --preinclude AutoGen.h --diag_suppress=186 --diag_warning 167 --diag_error=warning --diag_style=ide --protect_stack
-DEFINE RVCT_ALL_DLINK_FLAGS = --ro-base 0 --no_scanlib --reloc --no_exceptions --datacompressor off --strict --symbols --diag_style=ide --no_legacyalign
+DEFINE RVCT_ALL_DLINK_FLAGS = --no_scanlib --no_exceptions --datacompressor off --strict --symbols --diag_style=ide --no_legacyalign --scatter $(EDK_TOOLS_PATH)/Scripts/Rvct-Align32.sct
 
 ####################################################################################
 #
diff --git a/BaseTools/Scripts/Rvct-Align32.sct b/BaseTools/Scripts/Rvct-Align32.sct
new file mode 100644
index 000000000000..4f29ad416b82
--- /dev/null
+++ b/BaseTools/Scripts/Rvct-Align32.sct
@@ -0,0 +1,25 @@
+/** @file
+
+  Copyright (c) 2015, Linaro Ltd. All rights reserved.<BR>
+
+  This program and the accompanying materials are licensed and made available under
+  the terms and conditions of the BSD License that accompanies this distribution.
+  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+REGION 0x220 RELOC {
+  ER_RO +0 ALIGN 32 {
+    * (+RO)
+  }
+  ER_RW +0 ALIGN 32 {
+    * (+RW)
+  }
+  ER_ZI +0 {
+    * (+ZI)
+  }
+}
diff --git a/BaseTools/Scripts/Rvct-Align4K.sct b/BaseTools/Scripts/Rvct-Align4K.sct
new file mode 100644
index 000000000000..83f5a0d5e4cd
--- /dev/null
+++ b/BaseTools/Scripts/Rvct-Align4K.sct
@@ -0,0 +1,25 @@
+/** @file
+
+  Copyright (c) 2015, Linaro Ltd. All rights reserved.<BR>
+
+  This program and the accompanying materials are licensed and made available under
+  the terms and conditions of the BSD License that accompanies this distribution.
+  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+REGION 0x1000 RELOC {
+  ER_RO +0 ALIGN 4096 {
+    * (+RO)
+  }
+  ER_RW +0 ALIGN 4096 {
+    * (+RW)
+  }
+  ER_ZI +0 {
+    * (+ZI)
+  }
+}

From 7f33c1d949d8ce1f1bff57a230d42d1c2ac1b1f8 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 18 Dec 2015 06:52:50 +0000
Subject: [PATCH 285/525] BaseTools/GenFw RVCT: fix relocation processing of
 PT_DYNAMIC sections

Unlike GNU ld, which can be instructed to emit symbol based static
relocations into fully linked binaries using the --emit-relocs command
line switch, the RVCT armlink tool can only emit dynamic relocations
into the PT_DYNAMIC segment.

This has two consequences
. we can only identify absolute relocations, so there is no way to fix
  up relative relocations between sections, or check their validity in
  the PE/COFF layout
. the r_offset fields of the PT_DYNAMIC DT_REL entries are relative
  either to the base of the image or to any of its segments but *not* to
  the base of the input section that contains the location they refer
  to, and converting them to PE/COFF image offsets is non-trivial unless
  the sections are laid out in the same way in the ELF and PE/COFF
  versions of the binary.

There is really only one way to deal with this, and that is to require
that the ELF and PE/COFF versions of the binary are identical in memory.
So enforce that in the code.

Also, fix the utterly broken relocation fixup code that dereferences
ELF32_R_SYM(r_info) both as a 1-based program header index and a 0-based
section header index. If this code ever produced working binaries, it
was purely by chance.

(Sync patch r19236 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19383 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 36 ++++++++++++++++++-------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index 469394540e6a..eede64576940 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -804,9 +804,7 @@ WriteRelocations32 (
   UINTN                            RelSize;
   UINTN                            RelOffset;
   UINTN                            K;
-  UINT8                            *Targ;
   Elf32_Phdr                       *DynamicSegment;
-  Elf32_Phdr                       *TargetSegment;
 
   for (Index = 0, FoundRelocations = FALSE; Index < mEhdr->e_shnum; Index++) {
     Elf_Shdr *RelShdr = GetShdrByIndex(Index);
@@ -957,6 +955,31 @@ WriteRelocations32 (
           Error (NULL, 0, 3000, "Invalid", "%s bad ARM dynamic relocations.", mInImageName);
         }
 
+        for (Index = 0; Index < mEhdr->e_shnum; Index++) {
+          Elf_Shdr *shdr = GetShdrByIndex(Index);
+
+          //
+          // The PT_DYNAMIC section contains DT_REL relocations whose r_offset
+          // field is relative to the base of a segment (or the entire image),
+          // and not to the base of an ELF input section as is the case for
+          // SHT_REL sections. This means that we cannot fix up such relocations
+          // unless we cross-reference ELF sections and segments, considering
+          // that the output placement recorded in mCoffSectionsOffset[] is
+          // section based, not segment based.
+          //
+          // Fortunately, there is a simple way around this: we require that the
+          // in-memory layout of the ELF and PE/COFF versions of the binary is
+          // identical. That way, r_offset will retain its validity as a PE/COFF
+          // image offset, and we can record it in the COFF fixup table
+          // unmodified.
+          //
+          if (shdr->sh_addr != mCoffSectionsOffset[Index]) {
+            Error (NULL, 0, 3000,
+              "Invalid", "%s: PT_DYNAMIC relocations require identical ELF and PE/COFF section offsets.",
+              mInImageName);
+          }
+        }
+
         for (K = 0; K < RelSize; K += RelElementSize) {
 
           if (DynamicSegment->p_paddr == 0) {
@@ -973,14 +996,7 @@ WriteRelocations32 (
             break;
 
           case  R_ARM_RABS32:
-            TargetSegment = GetPhdrByIndex (ELF32_R_SYM (Rel->r_info) - 1);
-
-            // Note: r_offset in a memory address.  Convert it to a pointer in the coff file.
-            Targ = mCoffFile + mCoffSectionsOffset[ ELF32_R_SYM( Rel->r_info ) ] + Rel->r_offset - TargetSegment->p_vaddr;
-
-            *(UINT32 *)Targ = *(UINT32 *)Targ + mCoffSectionsOffset [ELF32_R_SYM( Rel->r_info )];
-
-            CoffAddFixup (mCoffSectionsOffset[ELF32_R_SYM (Rel->r_info)] + (Rel->r_offset - TargetSegment->p_vaddr), EFI_IMAGE_REL_BASED_HIGHLOW);
+            CoffAddFixup (Rel->r_offset, EFI_IMAGE_REL_BASED_HIGHLOW);
             break;
           
           default:

From 336e74a8acb29568004d64eeca1067bdcfdfad70 Mon Sep 17 00:00:00 2001
From: Hess Chen <hesheng.chen@intel.com>
Date: Fri, 18 Dec 2015 06:53:30 +0000
Subject: [PATCH 286/525] BaseTools/Ecc: Fix a bug to report fake issue

Fix a bug to ignore the lib ins defined in [components] section but also listed in SkipDir

(Sync patch r19238 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hess Chen <hesheng.chen@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19384 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/Ecc/Check.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/BaseTools/Source/Python/Ecc/Check.py b/BaseTools/Source/Python/Ecc/Check.py
index 5e5c8e72e400..a69ae344a3c3 100644
--- a/BaseTools/Source/Python/Ecc/Check.py
+++ b/BaseTools/Source/Python/Ecc/Check.py
@@ -653,6 +653,10 @@ def MetaDataFileCheckLibraryInstanceDependent(self):
                     continue
                 else:
                     LibraryIns = os.path.normpath(mws.join(EccGlobalData.gWorkspace, LibraryClass[2]))
+                    SkipDirString = '|'.join(EccGlobalData.gConfig.SkipDirList)
+                    p = re.compile(r'.*[\\/](?:%s^\S)[\\/]?.*' % SkipDirString)
+                    if p.match(os.path.split(LibraryIns)[0].upper()):
+                        continue
                     SqlCommand = """select Value3 from Inf where BelongsToFile =
                                     (select ID from File where lower(FullPath) = lower('%s'))
                                     and Value2 = '%s'""" % (LibraryIns, 'LIBRARY_CLASS')

From 4bf20e4d6fbc1308527cbfab0d868ef13953870f Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Fri, 18 Dec 2015 06:54:03 +0000
Subject: [PATCH 287/525] BaseTools/Scripts: Add ConvertUni.py script

This script uses python codecs to convert .uni string files between
the utf-16 and utf-8 formats.

The advantages of utf-8 data:
 * Generally smaller files
 * More commonly supported by editors
 * Not treated as binary data in patch files

The script was tested on MdePkg with both python 2.7 and python 3.4.
It was able to convert all MdePkg .uni files between utf-8 and utf-16
multiple times always producing the same files for each format.

v2:
 * Rename ConvertUtf16ToUtf8.py to ConvertUni.py
 * Also support utf-8 to utf-16 conversion (with --utf-16)

(Sync patch r19247 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19385 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Scripts/ConvertUni.py | 137 ++++++++++++++++++++++++++++++++
 1 file changed, 137 insertions(+)
 create mode 100755 BaseTools/Scripts/ConvertUni.py

diff --git a/BaseTools/Scripts/ConvertUni.py b/BaseTools/Scripts/ConvertUni.py
new file mode 100755
index 000000000000..2af55dfc6702
--- /dev/null
+++ b/BaseTools/Scripts/ConvertUni.py
@@ -0,0 +1,137 @@
+## @file
+#  Check a patch for various format issues
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials are licensed and made
+#  available under the terms and conditions of the BSD License which
+#  accompanies this distribution. The full text of the license may be
+#  found at http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS"
+#  BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER
+#  EXPRESS OR IMPLIED.
+#
+
+from __future__ import print_function
+
+VersionNumber = '0.1'
+__copyright__ = "Copyright (c) 2015, Intel Corporation  All rights reserved."
+
+import argparse
+import codecs
+import os
+import sys
+
+try:
+    from io import StringIO
+except ImportError:
+    from StringIO import StringIO
+
+class ConvertOneArg:
+    """Converts utf-16 to utf-8 for one command line argument.
+
+       This could be a single file, or a directory.
+    """
+
+    def __init__(self, utf8, source):
+        self.utf8 = utf8
+        self.source = source
+
+        self.ok = True
+
+        if not os.path.exists(source):
+            self.ok = False
+        elif os.path.isdir(source):
+            for (root, dirs, files) in os.walk(source):
+                files = filter(lambda a: a.endswith('.uni'), files)
+                for filename in files:
+                    path = os.path.join(root, filename)
+                    self.ok &= self.convert_one_file(path)
+                    if not self.ok:
+                        break
+
+                if not self.ok:
+                    break
+        else:
+            self.ok &= self.convert_one_file(source)
+
+    def convert_one_file(self, source):
+        if self.utf8:
+            new_enc, old_enc = 'utf-8', 'utf-16'
+        else:
+            new_enc, old_enc = 'utf-16', 'utf-8'
+        #
+        # Read file
+        #
+        f = open(source, mode='rb')
+        file_content = f.read()
+        f.close()
+
+        #
+        # Detect UTF-16 Byte Order Mark at beginning of file.
+        #
+        bom = (file_content.startswith(codecs.BOM_UTF16_BE) or
+               file_content.startswith(codecs.BOM_UTF16_LE))
+        if bom != self.utf8:
+            print("%s: already %s" % (source, new_enc))
+            return True
+
+        #
+        # Decode old string data
+        #
+        str_content = file_content.decode(old_enc, 'ignore')
+
+        #
+        # Encode new string data
+        #
+        new_content = str_content.encode(new_enc, 'ignore')
+
+        #
+        # Write converted data back to file
+        #
+        f = open(source, mode='wb')
+        f.write(new_content)
+        f.close()
+
+        print(source + ": converted, size", len(file_content), '=>', len(new_content))
+        return True
+
+
+class ConvertUniApp:
+    """Converts .uni files between utf-16 and utf-8."""
+
+    def __init__(self):
+        self.parse_options()
+        sources = self.args.source
+
+        self.ok = True
+        for patch in sources:
+            self.process_one_arg(patch)
+
+        if self.ok:
+            self.retval = 0
+        else:
+            self.retval = -1
+
+    def process_one_arg(self, arg):
+        self.ok &= ConvertOneArg(self.utf8, arg).ok
+
+    def parse_options(self):
+        parser = argparse.ArgumentParser(description=__copyright__)
+        parser.add_argument('--version', action='version',
+                            version='%(prog)s ' + VersionNumber)
+        parser.add_argument('source', nargs='+',
+                            help='[uni file | directory]')
+        group = parser.add_mutually_exclusive_group()
+        group.add_argument("--utf-8",
+                           action="store_true",
+                           help="Convert from utf-16 to utf-8 [default]")
+        group.add_argument("--utf-16",
+                           action="store_true",
+                           help="Convert from utf-8 to utf-16")
+        self.args = parser.parse_args()
+        self.utf8 = not self.args.utf_16
+
+if __name__ == "__main__":
+    sys.exit(ConvertUniApp().retval)

From 075c88d540f90f98800f537c9e5a95eac1e75a37 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 18 Dec 2015 06:54:36 +0000
Subject: [PATCH 288/525] BaseTools ARM: add CLANG35 support

This extends the existing CLANG35 toolchain definition with support for
building for the ARM architecture. In order to be able to reuse the existing
ARM GCC definitions as much as possible, the following changes have been
made to the existing ARM GCC support:
- the -mapcs option has been removed; it is a no-op under Thumb (our default)
  and we use AAPCS (-mabi=aapcs) anyway
- the -mword-relocations option has been moved from GCC_ARM_CC_FLAGS to
  the GCC4x specific option: CLANG does not support it, and uses '-mllvm
  -marm-use-movt=0' instead.

(Sync patch r19284 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19386 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Conf/tools_def.template | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index fc79bd660142..6e26bbca934b 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -366,7 +366,7 @@ DEFINE SOURCERY_CYGWIN_TOOLS = /cygdrive/c/Program Files/CodeSourcery/Sourcery G
 #                               Intel(r) ACPI Compiler from
 #                               https://acpica.org/downloads
 #   CLANG35     -Linux,Windows-  Requires:
-#                             Clang v3.5 or later, and GNU binutils targeting aarch64-linux-gnu
+#                             Clang v3.5 or later, and GNU binutils targeting aarch64-linux-gnu or arm-linux-gnueabi
 #                        Optional:
 #                             Required to build platforms or ACPI tables:
 #                               Intel(r) ACPI Compiler from
@@ -4322,7 +4322,7 @@ DEFINE GCC_ALL_CC_FLAGS            = -g -Os -fshort-wchar -fno-strict-aliasing -
 DEFINE GCC_IA32_CC_FLAGS           = DEF(GCC_ALL_CC_FLAGS) -m32 -malign-double -freorder-blocks -freorder-blocks-and-partition -O2 -mno-stack-arg-probe
 DEFINE GCC_X64_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mno-red-zone -Wno-address -mno-stack-arg-probe
 DEFINE GCC_IPF_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -minline-int-divide-min-latency
-DEFINE GCC_ARM_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mword-relocations -mlittle-endian -mabi=aapcs -mapcs -fno-short-enums -save-temps -fsigned-char -ffunction-sections -fdata-sections -fomit-frame-pointer -Wno-address -mthumb -mfloat-abi=soft
+DEFINE GCC_ARM_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mlittle-endian -mabi=aapcs -fno-short-enums -save-temps -fsigned-char -ffunction-sections -fdata-sections -fomit-frame-pointer -Wno-address -mthumb -mfloat-abi=soft
 DEFINE GCC_AARCH64_CC_FLAGS        = DEF(GCC_ALL_CC_FLAGS) -mlittle-endian -fno-short-enums -save-temps -fverbose-asm -fsigned-char  -ffunction-sections -fdata-sections -fomit-frame-pointer -fno-builtin -Wno-address -fno-asynchronous-unwind-tables
 DEFINE GCC_DLINK_FLAGS_COMMON      = -nostdlib --pie
 DEFINE GCC_DLINK2_FLAGS_COMMON     = --script=$(EDK_TOOLS_PATH)/Scripts/GccBase.lds
@@ -4380,7 +4380,7 @@ DEFINE GCC46_X64_DLINK_FLAGS         = DEF(GCC45_X64_DLINK_FLAGS)
 DEFINE GCC46_X64_DLINK2_FLAGS        = DEF(GCC45_X64_DLINK2_FLAGS)
 DEFINE GCC46_ASM_FLAGS               = DEF(GCC45_ASM_FLAGS)
 DEFINE GCC46_ARM_ASM_FLAGS           = $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_ASM_FLAGS) -mlittle-endian
-DEFINE GCC46_ARM_CC_FLAGS            = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) DEF(GCC_ARM_CC_FLAGS) -fstack-protector
+DEFINE GCC46_ARM_CC_FLAGS            = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) DEF(GCC_ARM_CC_FLAGS) -fstack-protector -mword-relocations
 DEFINE GCC46_ARM_DLINK_FLAGS         = DEF(GCC_ARM_DLINK_FLAGS) --oformat=elf32-littlearm
 DEFINE GCC46_ARM_DLINK2_FLAGS        = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
 DEFINE GCC46_ARM_ASLDLINK_FLAGS      = DEF(GCC_ARM_ASLDLINK_FLAGS) --oformat=elf32-littlearm
@@ -5184,8 +5184,30 @@ RELEASE_GCC49_AARCH64_CC_FLAGS   = DEF(GCC49_AARCH64_CC_FLAGS) -Wno-unused-but-s
 *_CLANG35_*_ASLPP_PATH           = ENV(CLANG35_BIN)clang
 
 DEFINE CLANG35_WARNING_OVERRIDES = -Wno-parentheses-equality -Wno-tautological-compare -Wno-tautological-constant-out-of-range-compare -Wno-empty-body
+DEFINE CLANG35_ARM_CC_FLAGS      = DEF(GCC_ARM_CC_FLAGS) -target armv7-a -mstrict-align -mllvm -arm-use-movt=0 DEF(CLANG35_WARNING_OVERRIDES)
 DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) -target aarch64 -mcmodel=small -mstrict-align DEF(CLANG35_WARNING_OVERRIDES)
 
+##################
+# CLANG35 ARM definitions
+##################
+*_CLANG35_ARM_SLINK_PATH         = ENV(CLANG35_ARM_PREFIX)ar
+*_CLANG35_ARM_DLINK_PATH         = ENV(CLANG35_ARM_PREFIX)ld
+*_CLANG35_ARM_ASLDLINK_PATH      = ENV(CLANG35_ARM_PREFIX)ld
+*_CLANG35_ARM_RC_PATH            = ENV(CLANG35_ARM_PREFIX)objcopy
+
+*_CLANG35_ARM_ASLCC_FLAGS        = DEF(GCC_ASLCC_FLAGS)
+*_CLANG35_ARM_ASLDLINK_FLAGS     = DEF(GCC_ARM_ASLDLINK_FLAGS)
+*_CLANG35_ARM_ASM_FLAGS          = DEF(GCC_ASM_FLAGS) $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) -target armv7-a -Qunused-arguments
+*_CLANG35_ARM_DLINK_FLAGS        = DEF(GCC_ARM_DLINK_FLAGS)
+*_CLANG35_ARM_DLINK2_FLAGS       = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
+*_CLANG35_ARM_PLATFORM_FLAGS     =
+*_CLANG35_ARM_PP_FLAGS           = DEF(GCC_PP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_ARM_RC_FLAGS           = DEF(GCC_ARM_RC_FLAGS)
+*_CLANG35_ARM_VFRPP_FLAGS        = DEF(GCC_VFRPP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+
+  DEBUG_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -O0
+RELEASE_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -Oz
+
 ##################
 # CLANG35 AARCH64 definitions
 ##################

From d33e7a2627cc25284e8412d94157fae7c9eac1e3 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 18 Dec 2015 06:55:09 +0000
Subject: [PATCH 289/525] BaseTools: Fix one bug in FD region for multiple
 workspace support

Update the os.path.join to mws.join for FILE/INF/CAPSULE/FV region type.

(Sync patch r19319 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19387 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Source/Python/GenFds/Region.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/Python/GenFds/Region.py b/BaseTools/Source/Python/GenFds/Region.py
index 8734635fda29..6015e24e25a5 100644
--- a/BaseTools/Source/Python/GenFds/Region.py
+++ b/BaseTools/Source/Python/GenFds/Region.py
@@ -73,7 +73,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                     RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
                     GenFdsGlobalVariable.InfLogger('   Region FV File Name = .fv : %s' % RegionData)
                     if RegionData[1] != ':' :
-                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
+                        RegionData = mws.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                     if not os.path.exists(RegionData):
                         EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
 
@@ -152,7 +152,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                     RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
                     GenFdsGlobalVariable.InfLogger('   Region CAPSULE Image Name = .cap : %s' % RegionData)
                     if RegionData[1] != ':' :
-                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
+                        RegionData = mws.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                     if not os.path.exists(RegionData):
                         EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
 
@@ -213,7 +213,7 @@ def AddToBuffer(self, Buffer, BaseAddress, BlockSizeList, ErasePolarity, ImageBi
                 else:
                     RegionData = GenFdsGlobalVariable.MacroExtend(RegionData, MacroDict)
                     if RegionData[1] != ':' :
-                        RegionData = os.path.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
+                        RegionData = mws.join (GenFdsGlobalVariable.WorkSpaceDir, RegionData)
                     if not os.path.exists(RegionData):
                         EdkLogger.error("GenFds", FILE_NOT_FOUND, ExtraData=RegionData)
                 #

From 0d2f9e91bf2bb40a09840fe4c80eadb001d696dc Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 07:01:30 +0000
Subject: [PATCH 290/525] External link to BaseTools Win binary r112(main trunk
 r19319)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19388 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Bin/externals.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Bin/externals.txt b/BaseTools/Bin/externals.txt
index c2c4ab729732..146687fa930d 100644
--- a/BaseTools/Bin/externals.txt
+++ b/BaseTools/Bin/externals.txt
@@ -1 +1 @@
-Win32  https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
+Win32  -r 112 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32

From b73e1f6915b2cc49e9a8bc5c379e63cefc5013be Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Fri, 18 Dec 2015 07:25:22 +0000
Subject: [PATCH 291/525] ShellPkg: UefiShellTftpCommandLib: fix incompatible
 pointer assignment

Add the missing EFIAPI calling convention to the CheckPacket() function.
Without it, the gcc build breaks due to the incompatible pointer
assignment in "Mtftp4Token.CheckPacket = CheckPacket".

(Sync patch r18553 from main trunk.)

Cc: Jaben Carsey <jaben.carsey@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19389 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
index 2dc9287020d7..4bb21aae6fb6 100644
--- a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
+++ b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
@@ -197,6 +197,7 @@ DownloadFile (
 **/
 STATIC 
 EFI_STATUS 
+EFIAPI
 CheckPacket (
   IN EFI_MTFTP4_PROTOCOL  *This,
   IN EFI_MTFTP4_TOKEN     *Token,
@@ -940,6 +941,7 @@ Error :
 **/
 STATIC
 EFI_STATUS
+EFIAPI
 CheckPacket (
   IN EFI_MTFTP4_PROTOCOL  *This,
   IN EFI_MTFTP4_TOKEN     *Token,

From e2ef42aad648f01d8d41093d02c62a93b9904dc3 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:26:39 +0000
Subject: [PATCH 292/525] ShellPkg: Build all libraries unconditionally.

Build all the optional libraries unconditionally so we can catch changes and how they affect the package regardless of the NO_SHELL_PROFILES,
INCLUDE_DP, and INCLUDE_TFTP_COMMAND settings.

(Sync patch r18557 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Signed-off-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19390 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/ShellPkg.dsc | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/ShellPkg.dsc b/ShellPkg/ShellPkg.dsc
index c9ed0f8fbafc..7e07cfb43778 100644
--- a/ShellPkg/ShellPkg.dsc
+++ b/ShellPkg/ShellPkg.dsc
@@ -1,7 +1,7 @@
 ##  @file
 # Shell Package
 #
-# Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
 #    are licensed and made available under the terms and conditions of the BSD License
@@ -74,10 +74,21 @@
 !endif #$(NO_SHELL_PROFILES)
 
 [Components]
+  #
+  # Build all the libraries when building this package.
+  # This helps developers test changes and how they affect the package.
+  #
   ShellPkg/Library/UefiShellLib/UefiShellLib.inf
   ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.inf
-  ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.inf
   ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
+  ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.inf
+  ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.inf
+  ShellPkg/Library/UefiShellLevel3CommandsLib/UefiShellLevel3CommandsLib.inf
+  ShellPkg/Library/UefiShellDriver1CommandsLib/UefiShellDriver1CommandsLib.inf
+  ShellPkg/Library/UefiShellInstall1CommandsLib/UefiShellInstall1CommandsLib.inf
+  ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.inf
+  ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.inf
+  ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.inf
 
   ShellPkg/Library/UefiDpLib/UefiDpLib.inf {
     <LibraryClasses>

From 8368182d00a164b7b4d12ffc2c3c65cd51e749a7 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Fri, 18 Dec 2015 07:27:10 +0000
Subject: [PATCH 293/525] ShellPkg: Add a simple case to test shell parameter
 parsing logic

TestArgv.nsh is a very simple shell script to test how the interpreter parses
the parameters. It uses ShellCTestApp.efi to dump the parameters passed from the
interpreter.

TestArgv.log is the desired output created using "TestArgv.nsh > TestArgv.log".

(Sync patch r18558 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19391 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/ShellCTestApp/README.txt |   5 ++
 .../Application/ShellCTestApp/ShellCTestApp.c |  11 +--
 .../Application/ShellCTestApp/TestArgv.log    | Bin 0 -> 3320 bytes
 .../Application/ShellCTestApp/TestArgv.nsh    |  64 ++++++++++++++++++
 4 files changed, 75 insertions(+), 5 deletions(-)
 create mode 100644 ShellPkg/Application/ShellCTestApp/README.txt
 create mode 100644 ShellPkg/Application/ShellCTestApp/TestArgv.log
 create mode 100644 ShellPkg/Application/ShellCTestApp/TestArgv.nsh

diff --git a/ShellPkg/Application/ShellCTestApp/README.txt b/ShellPkg/Application/ShellCTestApp/README.txt
new file mode 100644
index 000000000000..7814bb838605
--- /dev/null
+++ b/ShellPkg/Application/ShellCTestApp/README.txt
@@ -0,0 +1,5 @@
+TestArgv.nsh is a very simple shell script to test how the interpreter parses
+the parameters. It uses ShellCTestApp.efi to dump the parameters passed from the
+intepreter.
+
+TestArgv.log is the desired output created using "TestArgv.nsh > TestArgv.log".
\ No newline at end of file
diff --git a/ShellPkg/Application/ShellCTestApp/ShellCTestApp.c b/ShellPkg/Application/ShellCTestApp/ShellCTestApp.c
index 8d3fa4c6621a..08c830cfb79a 100644
--- a/ShellPkg/Application/ShellCTestApp/ShellCTestApp.c
+++ b/ShellPkg/Application/ShellCTestApp/ShellCTestApp.c
@@ -2,7 +2,7 @@
   This is a test application that demonstrates how to use the C-style entry point
   for a shell application.
 
-  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -40,10 +40,11 @@ ShellAppMain (
   )
 {
   UINTN  Index;
-
-  Print(L"ShellCTestApp.c:ShellAppMain called with %d parameters\n", Argc);
-  for (Index = 0; Index < Argc; Index++) {
-    Print(L"Argv[%d]: %s\n", Index, Argv[Index]);
+  if (Argc == 1) {
+    Print (L"Argv[1] = NULL\n");
+  }
+  for (Index = 1; Index < Argc; Index++) {
+    Print(L"Argv[%d]: \"%s\"\n", Index, Argv[Index]);
   }
 
   return 0;
diff --git a/ShellPkg/Application/ShellCTestApp/TestArgv.log b/ShellPkg/Application/ShellCTestApp/TestArgv.log
new file mode 100644
index 0000000000000000000000000000000000000000..e76781ea0e4387cf97ad42d5ccbb8a72f99c8d61
GIT binary patch
literal 3320
zcmcha-EPxB5QWcmCEmeumCH&=6Q>ChNOt0IgFvXzn?fx_-5;r<5dp;01K+G=wZUFT
z4t8bPp6txdIXgS!+5Gvv(y4}eu8(@DK)Jr?M)ycZJiqFh4zz8t!R9;qGkw-KWlGU6
zxW|e#<(=u6YsOfniB5PQBgI;RVq;?^SS}e^XwK6tSG<Eqm-)Wa50KvKO0SS^b=kn>
z6wbzGjsFynkz<g8KXuqcuxCgU$8Cf(gF(t@#ybK%ak>~r3x3bglzc99*ns>FZui6^
z$5YB|TUqKjByMDk?-*&K5xNLzj@B?UxXl@z5|O#n4|!TFACSWa<TC!Y_MB+lG4nmr
z1~xH~C}NS~-y)KrwOE{h7&~bKTI_fvj?ozH63Z2AhFFbwM$EGH1msBnDAioEEVyN7
zH&4W%h`fKTRfc}sKo?v#BPKJi^;74>^b?g9C`41Yx6R&)JgoC}xQDkv=M_BguC@=X
z_VFub)Wt8{BYpw9>Dyh?wdWUj{k8Yy=e7?s%VdA_OxK=ax7AVIi9j!?v^V;o*Iex?
zci_HvU3V0JeYCINP<_-?Kz|&lkDlgVdws7rCUrUWuxkIe(mHWBeXox7|KwFjS1x)?
zS%r09qknC-&tLv^TVGjo`)hx_$9HL)bB_OC+-1c#^Us}awf4$0<PoR3?oX1t@GOE|
n*Y+;VK5A+g=2M;!t6UzR-HLtoXKr^DTjjC+kLHU16K3-lP8Y@4

literal 0
HcmV?d00001

diff --git a/ShellPkg/Application/ShellCTestApp/TestArgv.nsh b/ShellPkg/Application/ShellCTestApp/TestArgv.nsh
new file mode 100644
index 000000000000..013ac123ec6b
--- /dev/null
+++ b/ShellPkg/Application/ShellCTestApp/TestArgv.nsh
@@ -0,0 +1,64 @@
+#/** @file
+#  This is a very simple shell script to test how the interpreter parses the parameters.
+#
+#  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#**/
+echo -on
+set Var_EFCF356F_228C_47C2_AD0C_3B5DAC9A8CFA      ValueOfGuid
+set Sharp_E8528E46_A008_4221_8DE0_D5AB42A9C580    ^#
+set Quote_E95DEE8B_E3AA_4155_9ED5_6916394104FC    ^"
+set Var_ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE
+alias ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE   ShellCTestApp
+
+#
+# '^' should escape all special characters (including space)
+#     but has no impact to non-special characters
+#
+ShellCTestApp ^^
+ShellCTestApp ^#
+ShellCTestApp ^%Var_EFCF356F_228C_47C2_AD0C_3B5DAC9A8CFA%
+ShellCTestApp ^"
+ShellCTestApp ^ 1
+ShellCTestApp ^ 
+ShellCTestApp ^1
+ShellCTestApp ^^^"
+ShellCTestApp ^^^
+
+#
+# '#' should be processed before %% replacement, and inside '"'
+#
+ShellCTestApp #%Var_EFCF356F_228C_47C2_AD0C_3B5DAC9A8CFA%
+#ShellCTestApp "#"
+ShellCTestApp %Sharp_E8528E46_A008_4221_8DE0_D5AB42A9C580%
+
+#
+# '%' should be processed before grouping parameters
+#
+ShellCTestApp "%Var_EFCF356F_228C_47C2_AD0C_3B5DAC9A8CFA% 2%Quote_E95DEE8B_E3AA_4155_9ED5_6916394104FC%
+
+#
+# alias should be processed after %% replacement
+#
+%Var_ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE%
+
+#
+# '"' should be stripped, space inside '"' should be kept, 
+#
+ShellCTestApp "p   1"
+ShellCTestApp "p"1
+ShellCTestApp "p   1"e"x"""
+
+set -d Var_EFCF356F_228C_47C2_AD0C_3B5DAC9A8CFA
+set -d Sharp_E8528E46_A008_4221_8DE0_D5AB42A9C580
+set -d Quote_E95DEE8B_E3AA_4155_9ED5_6916394104FC
+set -d Var_ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE
+alias -d ShellCTestApp_EE6E8BC6_71A6_44A5_BED3_D8F901105CDE
+echo -off
\ No newline at end of file

From 1bd38073f35107cf8d6af0b294b9f2641287683d Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:27:50 +0000
Subject: [PATCH 294/525] ShellPkg: Print error message when Shell set
 environment variable fail.

If you try to 'set' a read only environment variable and it fails without printing any information.
This patch add error message printing when 'set' environment variable fails.

(Sync patch r18598 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19392 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiShellLevel2CommandsLib/Set.c  |   7 ++++++-
 .../UefiShellLevel2CommandsLib.uni            | Bin 109570 -> 109742 bytes
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Set.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Set.c
index 45948e127531..d5e6a089782a 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Set.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Set.c
@@ -2,7 +2,7 @@
   Main file for attrib shell level 2 function.
 
   (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -141,6 +141,11 @@ ShellCommandRunSet (
         // assigning one
         //
         Status = ShellSetEnvironmentVariable(KeyName, Value, ShellCommandLineGetFlag(Package, L"-v"));
+        if (EFI_ERROR(Status)) {
+          ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_SET_ERROR_SET), gShellLevel2HiiHandle, L"set", KeyName);
+          ShellStatus = (SHELL_STATUS) (Status & (~MAX_BIT));
+        }
+        
       } else {
         if (KeyName != NULL) {
           //
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.uni b/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.uni
index 29563d2e21737be3c84a7e3413596a4fc8e0850b..cc2c33cda4a6bf1c4f5dbc8527dfaaab5185ca53 100644
GIT binary patch
delta 93
zcmZp=!M5%u+k_{KrW>CgSD0+TAu%~mo`c_&AqWWlfjFKan89_jqps-W2b@Ne6F6B!
t6B&{iau`w>6c|bv@_}SAkX<tQVW{ln4Vp5O9hBIb&na#{r^sm11pq_q8_WOz

delta 27
jcmZ2?ldb6n+k_{KCL5m~SD3s(Q>M8@X?uwhqg59Gwb%>C


From bd8504381c8acf81d4abfe252751a2d93ae97d0d Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:28:26 +0000
Subject: [PATCH 295/525] ShellPkg: Use safe string functions to refine
 'Tftp.c' code.

Safe string functions can help avoid potential buffer overflow. This patch replaces the StrCpy with StCpyS.

(Sync patch r18608 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19393 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
index 4bb21aae6fb6..02099febef08 100644
--- a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
+++ b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
@@ -955,6 +955,7 @@ CheckPacket (
   UINTN             Index;
   UINTN             LastStep;
   UINTN             Step;
+  EFI_STATUS        Status;
 
   if ((NTOHS (Packet->OpCode)) != EFI_MTFTP4_OPCODE_DATA) {
     return EFI_SUCCESS;
@@ -984,7 +985,10 @@ CheckPacket (
 
   ShellPrintEx (-1, -1, L"%s", mTftpProgressDelete);
 
-  StrCpy (Progress, mTftpProgressFrame);
+  Status = StrCpyS (Progress, TFTP_PROGRESS_MESSAGE_SIZE, mTftpProgressFrame);
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
   for (Index = 1; Index < Step; Index++) {
     Progress[Index] = L'=';
   }

From 90fb9ed5a0d24117a4847b5d25bca84d8d90c5c2 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:29:05 +0000
Subject: [PATCH 296/525] ShellPkg: Fix ASCII input redirection does not work
 correctly.

When executing 'ls -b <a arg.txt' Shell cannot get the ASCII char in 'arg.txt' correctly.
This patch updates the file read buffer size when read from ASCII file to fix the bug.

(Sync patch r18609 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Signed-off-by: Felix Poludov <Felixp@ami.com>
Signed-off-by: Oleksiy Yakovlev <Oleksiyy@ami.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19394 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ConsoleWrappers.c  | 14 +++++++--
 .../Application/Shell/FileHandleWrappers.c    | 29 +++++++++++++++----
 .../Shell/ShellParametersProtocol.c           |  4 +++
 3 files changed, 39 insertions(+), 8 deletions(-)

diff --git a/ShellPkg/Application/Shell/ConsoleWrappers.c b/ShellPkg/Application/Shell/ConsoleWrappers.c
index feea6ef3a22e..04a7513a3346 100644
--- a/ShellPkg/Application/Shell/ConsoleWrappers.c
+++ b/ShellPkg/Application/Shell/ConsoleWrappers.c
@@ -2,7 +2,7 @@
   Function definitions for shell simple text in and out on top of file handles.
 
   (C) Copyright 2013 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -15,6 +15,8 @@
 
 #include "Shell.h"
 
+extern BOOLEAN AsciiRedirection;
+
 typedef struct {
   EFI_SIMPLE_TEXT_INPUT_PROTOCOL  SimpleTextIn;
   SHELL_FILE_HANDLE               FileHandle;
@@ -81,6 +83,7 @@ FileBasedSimpleTextInReadKeyStroke(
   )
 {
   UINTN Size;
+  UINTN CharSize;
 
   //
   // Verify the parameters
@@ -98,11 +101,16 @@ FileBasedSimpleTextInReadKeyStroke(
 
   Size = sizeof(CHAR16);
 
+  if(!AsciiRedirection) {
+    CharSize = sizeof(CHAR16);
+  } else {
+    CharSize = sizeof(CHAR8);
+  } 
   //
   // Decrement the amount of free space by Size or set to zero (for odd length files)
   //
-  if (((SHELL_EFI_SIMPLE_TEXT_INPUT_PROTOCOL *)This)->RemainingBytesOfInputFile > Size) {
-    ((SHELL_EFI_SIMPLE_TEXT_INPUT_PROTOCOL *)This)->RemainingBytesOfInputFile -= Size;
+  if (((SHELL_EFI_SIMPLE_TEXT_INPUT_PROTOCOL *)This)->RemainingBytesOfInputFile > CharSize) {
+    ((SHELL_EFI_SIMPLE_TEXT_INPUT_PROTOCOL *)This)->RemainingBytesOfInputFile -= CharSize;
   } else {
     ((SHELL_EFI_SIMPLE_TEXT_INPUT_PROTOCOL *)This)->RemainingBytesOfInputFile = 0;
   }
diff --git a/ShellPkg/Application/Shell/FileHandleWrappers.c b/ShellPkg/Application/Shell/FileHandleWrappers.c
index 18b6c3e76829..91c35f7cb70a 100644
--- a/ShellPkg/Application/Shell/FileHandleWrappers.c
+++ b/ShellPkg/Application/Shell/FileHandleWrappers.c
@@ -1670,8 +1670,10 @@ FileInterfaceFileRead(
   OUT VOID                    *Buffer
   )
 {
-  CHAR8       *AsciiBuffer;
+  CHAR8       *AsciiStrBuffer;
+  CHAR16      *UscStrBuffer;
   UINTN       Size;
+  UINTN       CharNum;
   EFI_STATUS  Status;
   if (((EFI_FILE_PROTOCOL_FILE*)This)->Unicode) {
     //
@@ -1682,10 +1684,27 @@ FileInterfaceFileRead(
     //
     // Ascii
     //
-    AsciiBuffer = AllocateZeroPool((Size = *BufferSize));
-    Status = (((EFI_FILE_PROTOCOL_FILE*)This)->Orig->Read(((EFI_FILE_PROTOCOL_FILE*)This)->Orig, &Size, AsciiBuffer));
-    UnicodeSPrint(Buffer, *BufferSize, L"%a", AsciiBuffer);
-    FreePool(AsciiBuffer);
+    Size  = (*BufferSize) / sizeof(CHAR16);
+    AsciiStrBuffer = AllocateZeroPool(Size + sizeof(CHAR8));
+    if (AsciiStrBuffer == NULL) {
+      return EFI_OUT_OF_RESOURCES;
+    }
+    UscStrBuffer = AllocateZeroPool(*BufferSize + sizeof(CHAR16));
+    if (UscStrBuffer== NULL) {
+      SHELL_FREE_NON_NULL(AsciiStrBuffer);
+      return EFI_OUT_OF_RESOURCES;
+    }
+    Status = (((EFI_FILE_PROTOCOL_FILE*)This)->Orig->Read(((EFI_FILE_PROTOCOL_FILE*)This)->Orig, &Size, AsciiStrBuffer));
+    if (!EFI_ERROR(Status)) {
+      CharNum = UnicodeSPrint(UscStrBuffer, *BufferSize + sizeof(CHAR16), L"%a", AsciiStrBuffer);
+      if (CharNum == Size) {
+        CopyMem (Buffer, UscStrBuffer, *BufferSize);
+      } else {
+        Status = EFI_UNSUPPORTED;
+      }
+    }
+    SHELL_FREE_NON_NULL(AsciiStrBuffer);
+    SHELL_FREE_NON_NULL(UscStrBuffer);
     return (Status);
   }
 }
diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.c b/ShellPkg/Application/Shell/ShellParametersProtocol.c
index bbe026b644b2..9c502f8f212e 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.c
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.c
@@ -17,6 +17,8 @@
 
 #include "Shell.h"
 
+BOOLEAN AsciiRedirection = FALSE;
+
 /**
   Return the next parameter's end from a command line string.
 
@@ -726,6 +728,7 @@ UpdateStdInStdOutStdErr(
 
   OutUnicode      = TRUE;
   InUnicode       = TRUE;
+  AsciiRedirection = FALSE;
   ErrUnicode      = TRUE;
   StdInVarName    = NULL;
   StdOutVarName   = NULL;
@@ -1004,6 +1007,7 @@ UpdateStdInStdOutStdErr(
     } else {
       StdInFileName   = CommandLineWalker += 4;
       InUnicode       = FALSE;
+      AsciiRedirection = TRUE;
     }
     if (StrStr(CommandLineWalker, L" <a ") != NULL) {
       Status = EFI_NOT_FOUND;

From 631a25f3618b25a8a0bdd70d7338ce80a1f9c57d Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:30:21 +0000
Subject: [PATCH 297/525] ShellPkg: Follow spec to remove the last '\' char in
 return name of GetCurDir().

In Shell spec 2.1 the return name of EFI_SHELL_PROTOCOL.GetCurDir() is defined as 'fs0:\current-dir' while in current implementation it's 'fs0:\current-dir\'.
To follow spec the patch removed the redundant '\' char.

Since it has been broken for a long time, some codes may depend on the broken behavior.
After this change 'EFI_SHELL_PROTOCOL.GetCurDir()' and 'UefiShellLib.ShellGetCurrentDir()'
will return a current directory string without tailing '\' (fs0:\current-dir), the value of Shell environment variable 'cwd' will become 'fs0:\current-dir' as well.

This patch has updated all the code in EDKII to make them depend on the new behavior.
Developers should check whether 'GetCurDir()' and 'ShellGetCurrentDir' are used in their source code.

(Sync patch r18653 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19395 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Application/Shell/FileHandleWrappers.c    |   1 +
 ShellPkg/Application/Shell/Shell.uni          | Bin 4838 -> 4840 bytes
 ShellPkg/Application/Shell/ShellProtocol.c    |  18 +++++++---
 ShellPkg/Include/Library/ShellLib.h           |   4 ++-
 ShellPkg/Include/Protocol/EfiShell.h          |   4 ++-
 .../Library/UefiShellLevel2CommandsLib/Cd.c   |  23 ++++++++++---
 .../Library/UefiShellLevel2CommandsLib/Cp.c   |  12 +++++--
 .../Library/UefiShellLevel2CommandsLib/Ls.c   |   6 +++-
 .../Library/UefiShellLevel2CommandsLib/Mv.c   |  32 +++++++++++++++---
 .../Library/UefiShellLevel2CommandsLib/Rm.c   |   4 ++-
 .../UefiShellLevel2CommandsLib.c              |   3 +-
 ShellPkg/Library/UefiShellLib/UefiShellLib.c  |   5 ++-
 12 files changed, 91 insertions(+), 21 deletions(-)

diff --git a/ShellPkg/Application/Shell/FileHandleWrappers.c b/ShellPkg/Application/Shell/FileHandleWrappers.c
index 91c35f7cb70a..64f382718b85 100644
--- a/ShellPkg/Application/Shell/FileHandleWrappers.c
+++ b/ShellPkg/Application/Shell/FileHandleWrappers.c
@@ -510,6 +510,7 @@ FileInterfaceStdInRead(
           Cwd = ShellInfoObject.NewEfiShellProtocol->GetCurDir(NULL);
           if (Cwd != NULL) {
             StrnCpyS(TabStr, (*BufferSize)/sizeof(CHAR16), Cwd, (*BufferSize)/sizeof(CHAR16) - 1);
+            StrCatS(TabStr, (*BufferSize)/sizeof(CHAR16), L"\\");
             if (TabStr[StrLen(TabStr)-1] == L'\\' && *(CurrentString + TabPos) == L'\\' ) {
               TabStr[StrLen(TabStr)-1] = CHAR_NULL;
             }
diff --git a/ShellPkg/Application/Shell/Shell.uni b/ShellPkg/Application/Shell/Shell.uni
index 04f001d3870ac3d9f59ebea4617ab5f13e2c4ce9..25cf69966b733e7b2488413361cfab98c2249bfd 100644
GIT binary patch
delta 19
bcmaE+`a*TW6GqdGPp`8w#%$irrp*HYUOEUp

delta 17
ZcmaE%`b>4g6Gp?0Pp`9X-p8iJ0{~Bl2i^bx

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index 28521ecc154b..3a963849f29a 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -532,12 +532,13 @@ EfiShellGetDevicePathFromFilePath(
     if (Cwd == NULL) {
       return (NULL);
     }
-    Size = StrSize(Cwd) + StrSize(Path) - sizeof(CHAR16);
+    Size = StrSize(Cwd) + StrSize(Path);
     NewPath = AllocateZeroPool(Size);
     if (NewPath == NULL) {
       return (NULL);
     }
     StrCpyS(NewPath, Size/sizeof(CHAR16), Cwd);
+    StrCatS(NewPath, Size/sizeof(CHAR16), L"\\");
     if (*Path == L'\\') {
       Path++;
       while (PathRemoveLastItem(NewPath)) ;
@@ -2495,6 +2496,7 @@ EfiShellOpenFileList(
     CurDir = EfiShellGetCurDir(NULL);
     ASSERT((Path2 == NULL && Path2Size == 0) || (Path2 != NULL));
     StrnCatGrow(&Path2, &Path2Size, CurDir, 0);
+    StrnCatGrow(&Path2, &Path2Size, L"\\", 0);
     if (*Path == L'\\') {
       Path++;
       while (PathRemoveLastItem(Path2)) ;
@@ -2796,6 +2798,8 @@ EfiShellSetEnv(
   FileSystemMapping is not NULL, it returns the current directory associated with the
   FileSystemMapping. In both cases, the returned name includes the file system
   mapping (i.e. fs0:\current-dir).
+  
+  Note that the current directory string should exclude the tailing backslash character.
 
   @param FileSystemMapping      A pointer to the file system mapping. If NULL,
                                 then the current working directory is returned.
@@ -2852,6 +2856,8 @@ EfiShellGetCurDir(
   If the current working directory or the current working file system is changed then the
   %cwd% environment variable will be updated
 
+  Note that the current directory string should exclude the tailing backslash character.
+
   @param FileSystem             A pointer to the file system's mapped name. If NULL, then the current working
                                 directory is changed.
   @param Dir                    Points to the NULL-terminated directory on the device specified by FileSystem.
@@ -2939,9 +2945,11 @@ EfiShellSetCurDir(
       ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
       MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, DirectoryName, 0);
     }
-    if ((MapListItem->CurrentDirectoryPath != NULL && MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] != L'\\') || (MapListItem->CurrentDirectoryPath == NULL)) {
+    if ((MapListItem->CurrentDirectoryPath != NULL && MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] == L'\\') || (MapListItem->CurrentDirectoryPath == NULL)) {
       ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
-      MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, L"\\", 0);
+      if (MapListItem->CurrentDirectoryPath != NULL) {
+        MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] = CHAR_NULL;
+      }
     }
   } else {
     //
@@ -2973,9 +2981,9 @@ EfiShellSetCurDir(
       MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, L"\\", 0);
       ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
       MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, DirectoryName, 0);
-      if (MapListItem->CurrentDirectoryPath != NULL && MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] != L'\\') {
+      if (MapListItem->CurrentDirectoryPath != NULL && MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] == L'\\') {
         ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
-        MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, L"\\", 0);
+        MapListItem->CurrentDirectoryPath[StrLen(MapListItem->CurrentDirectoryPath)-1] = CHAR_NULL;
       }
     }
   }
diff --git a/ShellPkg/Include/Library/ShellLib.h b/ShellPkg/Include/Library/ShellLib.h
index 23da4eeaf610..d02d6e9de1f1 100644
--- a/ShellPkg/Include/Library/ShellLib.h
+++ b/ShellPkg/Include/Library/ShellLib.h
@@ -1,7 +1,7 @@
 /** @file
   Provides interface to shell functionality for shell commands and applications.
 
-  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -550,6 +550,8 @@ ShellExecute (
   name. If the DeviceName is not NULL, it returns the current directory name
   on specified drive.
 
+  Note that the current directory string should exclude the tailing backslash character.
+
   @param[in] DeviceName         The name of the file system to get directory on.
 
   @retval NULL                  The directory does not exist.
diff --git a/ShellPkg/Include/Protocol/EfiShell.h b/ShellPkg/Include/Protocol/EfiShell.h
index 6c1d66a6696d..5c7f4f635726 100644
--- a/ShellPkg/Include/Protocol/EfiShell.h
+++ b/ShellPkg/Include/Protocol/EfiShell.h
@@ -2,7 +2,7 @@
   EFI Shell protocol as defined in the UEFI Shell 2.0 specification including errata.
 
   (C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -294,6 +294,8 @@ EFI_STATUS
   FileSystemMapping. In both cases, the returned name includes the file system
   mapping (i.e. fs0:\current-dir).
 
+  Note that the current directory string should exclude the tailing backslash character.
+
   @param[in] FileSystemMapping  A pointer to the file system mapping. If NULL,
                                 then the current working directory is returned.
 
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Cd.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Cd.c
index 10bc185dbaf6..19e8e2ff9a79 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Cd.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Cd.c
@@ -2,7 +2,7 @@
   Main file for attrib shell level 2 function.
 
   (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -31,8 +31,10 @@ ShellCommandRunCd (
   EFI_STATUS        Status;
   LIST_ENTRY        *Package;
   CONST CHAR16      *Directory;
+  CHAR16            *Cwd;
   CHAR16            *Path;
   CHAR16            *Drive;
+  UINTN             CwdSize;
   UINTN             DriveSize;
   CHAR16            *ProblemParam;
   SHELL_STATUS      ShellStatus;
@@ -121,8 +123,14 @@ ShellCommandRunCd (
             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle, L"cd");  
             ShellStatus = SHELL_NOT_FOUND;
           } else {
-            Drive = GetFullyQualifiedPath(Directory);
+            CwdSize = StrSize(Directory) + sizeof(CHAR16);
+            Cwd = AllocateZeroPool(CwdSize);
+            ASSERT(Cwd!=NULL);
+            StrCpyS(Cwd, StrSize(Directory)/sizeof(CHAR16)+1, Directory);
+            StrCatS(Cwd, StrSize(Directory)/sizeof(CHAR16)+1, L"\\");
+            Drive = GetFullyQualifiedPath(Cwd);
             PathRemoveLastItem(Drive);
+            FreePool(Cwd);
           }
           if (ShellStatus == SHELL_SUCCESS && Drive != NULL) {
             //
@@ -143,8 +151,14 @@ ShellCommandRunCd (
             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_CWD), gShellLevel2HiiHandle, L"cd");  
             ShellStatus = SHELL_NOT_FOUND;
           } else {
-            Drive = GetFullyQualifiedPath(Directory);
-            while (PathRemoveLastItem(Drive)) ;
+            CwdSize = StrSize(Directory) + sizeof(CHAR16);
+            Cwd = AllocateZeroPool(CwdSize);
+            ASSERT(Cwd!=NULL);
+            StrCpyS(Cwd, StrSize(Directory)/sizeof(CHAR16)+1, Directory);
+            StrCatS(Cwd, StrSize(Directory)/sizeof(CHAR16)+1, L"\\");
+            Drive = GetFullyQualifiedPath(Cwd);
+            while (PathRemoveLastItem(Drive));
+            FreePool(Cwd);
           }
           if (ShellStatus == SHELL_SUCCESS && Drive != NULL) {
             //
@@ -166,6 +180,7 @@ ShellCommandRunCd (
           } else {
             ASSERT((Drive == NULL && DriveSize == 0) || (Drive != NULL));
             Drive = StrnCatGrow(&Drive, &DriveSize, ShellGetCurrentDir(NULL), 0);
+            Drive = StrnCatGrow(&Drive, &DriveSize, L"\\", 0);
             if (*Param1Copy == L'\\') {
               while (PathRemoveLastItem(Drive)) ;
               Drive = StrnCatGrow(&Drive, &DriveSize, Param1Copy+1, 0);
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Cp.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Cp.c
index deff42e0494e..5cfbc9064f83 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Cp.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Cp.c
@@ -360,7 +360,7 @@ ValidateAndCopyFiles(
 
     NewSize =  StrSize(CleanFilePathStr);
     NewSize += StrSize(Node->FullName);
-    NewSize += (Cwd == NULL)? 0 : StrSize(Cwd);
+    NewSize += (Cwd == NULL)? 0 : (StrSize(Cwd) + sizeof(CHAR16));
     if (NewSize > PathSize) {
       PathSize = NewSize;
     }
@@ -428,6 +428,7 @@ ValidateAndCopyFiles(
         //
         if (Cwd != NULL) {
           StrCpyS(DestPath, PathSize / sizeof(CHAR16), Cwd);
+          StrCatS(DestPath, PathSize / sizeof(CHAR16), L"\\");
         } else {
           ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_DIR_NF), gShellLevel2HiiHandle, L"cp", CleanFilePathStr);  
           FreePool (CleanFilePathStr);
@@ -456,6 +457,7 @@ ValidateAndCopyFiles(
          //
         if (Cwd != NULL) {
           StrCpyS(DestPath, PathSize/sizeof(CHAR16), Cwd);
+          StrCatS(DestPath, PathSize/sizeof(CHAR16), L"\\");
         } else {
           ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_DIR_NF), gShellLevel2HiiHandle, L"cp",  CleanFilePathStr); 
           FreePool(CleanFilePathStr);
@@ -467,6 +469,7 @@ ValidateAndCopyFiles(
       } else if (StrStr(CleanFilePathStr, L":") == NULL) {
         if (Cwd != NULL) {
           StrCpyS(DestPath, PathSize/sizeof(CHAR16), Cwd);
+          StrCatS(DestPath, PathSize/sizeof(CHAR16), L"\\");
         } else {
           ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_DIR_NF), gShellLevel2HiiHandle, L"cp", CleanFilePathStr);  
           FreePool(CleanFilePathStr);
@@ -644,6 +647,7 @@ ShellCommandRunCp (
   BOOLEAN             SilentMode;
   BOOLEAN             RecursiveMode;
   CONST CHAR16        *Cwd;
+  CHAR16              *FullCwd;
 
   ProblemParam        = NULL;
   ShellStatus         = SHELL_SUCCESS;
@@ -712,7 +716,11 @@ ShellCommandRunCp (
             ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_NF), gShellLevel2HiiHandle, L"cp", ShellCommandLineGetRawValue(Package, 1));  
             ShellStatus = SHELL_NOT_FOUND;
           } else  {
-            ShellStatus = ProcessValidateAndCopyFiles(FileList, Cwd, SilentMode, RecursiveMode);
+            FullCwd = AllocateZeroPool(StrSize(Cwd) + sizeof(CHAR16));
+            ASSERT (FullCwd != NULL);
+            StrCpyS(FullCwd, StrSize(Cwd)/sizeof(CHAR16)+1, Cwd);
+            ShellStatus = ProcessValidateAndCopyFiles(FileList, FullCwd, SilentMode, RecursiveMode);
+            FreePool(FullCwd);
           }
         }
 
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Ls.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Ls.c
index c1e2887aa1fb..25bf8ca9e13a 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Ls.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Ls.c
@@ -2,7 +2,7 @@
   Main file for ls shell level 2 function.
 
   (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -669,6 +669,8 @@ ShellCommandRunLs (
           ASSERT(FullPath == NULL);
           StrnCatGrow(&SearchString, NULL, L"*", 0);
           StrnCatGrow(&FullPath, NULL, CurDir, 0);
+          Size = FullPath != NULL? StrSize(FullPath) : 0;
+          StrnCatGrow(&FullPath, &Size, L"\\", 0);
         } else {
           if (StrStr(PathName, L":") == NULL && gEfiShellProtocol->GetCurDir(NULL) == NULL) {
             //
@@ -687,6 +689,8 @@ ShellCommandRunLs (
                 ShellCommandLineFreeVarList (Package);
                 return SHELL_OUT_OF_RESOURCES;
               }
+              Size = FullPath != NULL? StrSize(FullPath) : 0;
+              StrnCatGrow(&FullPath, &Size, L"\\", 0);
             }
             StrnCatGrow(&FullPath, &Size, PathName, 0);
             if (FullPath == NULL) {
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Mv.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Mv.c
index fa6753374394..eb7287e48a38 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Mv.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Mv.c
@@ -467,6 +467,7 @@ ValidateAndMoveFiles(
   CHAR16                    *DestPath;
   CHAR16                    *FullDestPath;
   CONST CHAR16              *Cwd;
+  CHAR16                    *FullCwd;
   SHELL_STATUS              ShellStatus;
   EFI_SHELL_FILE_INFO       *Node;
   VOID                      *Response;
@@ -483,8 +484,17 @@ ValidateAndMoveFiles(
   Attr              = 0;
   CleanFilePathStr  = NULL;
 
+  FullCwd = AllocateZeroPool(StrSize(Cwd) + sizeof(CHAR16));
+  if (FullCwd == NULL) {
+    return SHELL_OUT_OF_RESOURCES;
+  } else {
+    StrCpyS(FullCwd, StrSize(Cwd)/sizeof(CHAR16)+1, Cwd);
+    StrCatS(FullCwd, StrSize(Cwd)/sizeof(CHAR16)+1, L"\\");
+  }
+
   Status = ShellLevel2StripQuotes (DestParameter, &CleanFilePathStr);
   if (EFI_ERROR (Status)) {
+    FreePool (FullCwd);
     if (Status == EFI_OUT_OF_RESOURCES) {
       return SHELL_OUT_OF_RESOURCES;
     } else {
@@ -497,14 +507,16 @@ ValidateAndMoveFiles(
   //
   // Get and validate the destination location
   //
-  ShellStatus = GetDestinationLocation(CleanFilePathStr, &DestPath, Cwd, (BOOLEAN)(FileList->Link.ForwardLink == FileList->Link.BackLink), &Attr);
+  ShellStatus = GetDestinationLocation(CleanFilePathStr, &DestPath, FullCwd, (BOOLEAN)(FileList->Link.ForwardLink == FileList->Link.BackLink), &Attr);
   FreePool (CleanFilePathStr);
 
   if (ShellStatus != SHELL_SUCCESS) {
+    FreePool (FullCwd);
     return (ShellStatus);
   }
   DestPath = PathCleanUpDirectories(DestPath);
   if (DestPath == NULL) {
+    FreePool (FullCwd);
     return (SHELL_OUT_OF_RESOURCES);
   }
 
@@ -514,6 +526,7 @@ ValidateAndMoveFiles(
     SHELL_FREE_NON_NULL(DestPath);
     SHELL_FREE_NON_NULL(HiiOutput);
     SHELL_FREE_NON_NULL(HiiResultOk);
+    FreePool (FullCwd);
     return (SHELL_OUT_OF_RESOURCES);
   }
 
@@ -551,7 +564,7 @@ ValidateAndMoveFiles(
     //
     // Validate that the move is valid
     //
-    if (!IsValidMove(Node->FullName, Cwd, FullDestPath!=NULL? FullDestPath:DestPath, Node->Info->Attribute, Attr, Node->Status)) {
+    if (!IsValidMove(Node->FullName, FullCwd, FullDestPath!=NULL? FullDestPath:DestPath, Node->Info->Attribute, Attr, Node->Status)) {
       ShellStatus = SHELL_INVALID_PARAMETER;
       continue;
     }
@@ -575,6 +588,7 @@ ValidateAndMoveFiles(
           //
           // indicate to stop everything
           //
+          FreePool(FullCwd);
           return (SHELL_ABORTED);
         case ShellPromptResponseAll:
           *Resp = Response;
@@ -585,12 +599,13 @@ ValidateAndMoveFiles(
           break;
         default:
           FreePool(Response);
+          FreePool(FullCwd);
           return SHELL_ABORTED;
       }
       Status = ShellDeleteFileByName(FullDestPath!=NULL? FullDestPath:DestPath);
     }
 
-    if (IsBetweenFileSystem(Node->FullName, Cwd, DestPath)) {
+    if (IsBetweenFileSystem(Node->FullName, FullCwd, DestPath)) {
       while (FullDestPath == NULL && DestPath != NULL && DestPath[0] != CHAR_NULL && DestPath[StrLen(DestPath) - 1] == L'\\') {
         DestPath[StrLen(DestPath) - 1] = CHAR_NULL;
       }
@@ -631,6 +646,7 @@ ValidateAndMoveFiles(
   SHELL_FREE_NON_NULL(DestPath);
   SHELL_FREE_NON_NULL(HiiOutput);
   SHELL_FREE_NON_NULL(HiiResultOk);
+  FreePool (FullCwd);
   return (ShellStatus);
 }
 
@@ -650,6 +666,8 @@ ShellCommandRunMv (
   EFI_STATUS          Status;
   LIST_ENTRY          *Package;
   CHAR16              *ProblemParam;
+  CHAR16              *Cwd;
+  UINTN               CwdSize;
   SHELL_STATUS        ShellStatus;
   UINTN               ParamCount;
   UINTN               LoopCounter;
@@ -713,7 +731,13 @@ ShellCommandRunMv (
             //
             // ValidateAndMoveFiles will report errors to the screen itself
             //
-            ShellStatus = ValidateAndMoveFiles(FileList, &Response, ShellGetCurrentDir(NULL));
+            CwdSize = StrSize(ShellGetCurrentDir(NULL)) + 1;
+            Cwd = AllocateZeroPool(CwdSize);
+            ASSERT (Cwd != NULL);
+            StrCpyS(Cwd, CwdSize/sizeof(CHAR16), ShellGetCurrentDir(NULL));
+            StrCatS(Cwd, CwdSize/sizeof(CHAR16), L"\\");
+            ShellStatus = ValidateAndMoveFiles(FileList, &Response, Cwd);
+            FreePool(Cwd);
           }
         }
 
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/Rm.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/Rm.c
index ed9940d82704..0b23fba15081 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/Rm.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/Rm.c
@@ -231,7 +231,9 @@ IsValidDeleteTarget(
   Pattern       = NULL;
   SearchString  = NULL;
   Size          = 0;
-  Pattern       = StrnCatGrow(&Pattern     , NULL, TempLocation  , 0);
+  Pattern       = StrnCatGrow(&Pattern, &Size, TempLocation  , 0);
+  Pattern       = StrnCatGrow(&Pattern, &Size, L"\\"  , 0);
+  Size = 0;
   SearchString  = StrnCatGrow(&SearchString, &Size, Node->FullName, 0);
   if (!EFI_ERROR(ShellIsDirectory(SearchString))) {
     SearchString  = StrnCatGrow(&SearchString, &Size, L"\\", 0);
diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.c b/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.c
index 4ac7e67007f8..0dafb19969c5 100644
--- a/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.c
+++ b/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.c
@@ -22,7 +22,7 @@
   * functions are non-interactive only
 
   Copyright (c) 2014 Hewlett-Packard Development Company, L.P.
-  Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -188,6 +188,7 @@ GetFullyQualifiedPath(
   if (StrStr(Path, L":") == NULL) {
     CurDir = gEfiShellProtocol->GetCurDir(NULL);
     StrnCatGrow(&PathToReturn, &Size, CurDir, 0);
+    StrnCatGrow(&PathToReturn, &Size, L"\\", 0);
     if (*Path == L'\\') {
       Path++;
     }
diff --git a/ShellPkg/Library/UefiShellLib/UefiShellLib.c b/ShellPkg/Library/UefiShellLib/UefiShellLib.c
index 6e0f61130ff4..44ac382980c0 100644
--- a/ShellPkg/Library/UefiShellLib/UefiShellLib.c
+++ b/ShellPkg/Library/UefiShellLib/UefiShellLib.c
@@ -1276,6 +1276,8 @@ ShellExecute (
   name. If the DeviceName is not NULL, it returns the current directory name
   on specified drive.
 
+  Note that the current directory string should exclude the tailing backslash character.
+
   @param DeviceName             the name of the drive to get directory on
 
   @retval NULL                  the directory does not exist
@@ -1708,13 +1710,14 @@ ShellFindFilePath (
 
   Path = ShellGetEnvironmentVariable(L"cwd");
   if (Path != NULL) {
-    Size = StrSize(Path);
+    Size = StrSize(Path) + sizeof(CHAR16);
     Size += StrSize(FileName);
     TestPath = AllocateZeroPool(Size);
     if (TestPath == NULL) {
       return (NULL);
     }
     StrCpyS(TestPath, Size/sizeof(CHAR16), Path);
+    StrCatS(TestPath, Size/sizeof(CHAR16), L"\\");
     StrCatS(TestPath, Size/sizeof(CHAR16), FileName);
     Status = ShellOpenFileByName(TestPath, &Handle, EFI_FILE_MODE_READ, 0);
     if (!EFI_ERROR(Status)){

From 44114063177170f05e2e4a040e5a06a0214a4b7d Mon Sep 17 00:00:00 2001
From: Tapan Shah <tapandshah@hpe.com>
Date: Fri, 18 Dec 2015 07:30:58 +0000
Subject: [PATCH 298/525] ShellPkg: Update 'tftp' command help output and error
 messages

Changing 'tftp' command's help output .uni file to match other EDK2 Shell commands as well as adjusting error messages text.

(Sync patch r18659 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Tapan Shah <tapandshah@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19396 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellTftpCommandLib.uni               | Bin 8856 -> 9952 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni b/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni
index 43b8cc5e7cd8726138c600b96b4ebbb1c960824c..d12a87cb56a06ec796d3054e0aa9fd158937f004 100644
GIT binary patch
delta 956
zcmZ`&O=}ZD7=D|^G)ZHP`;kp{Yg`MSB%Z{B1TolHE3MX~5y6VYq@jT{X*O$WPZ7_e
z;#;tI>cy*AbCVtvJbCgD6x5R^F(r8RnORd>stmI``+m&xF|!-lud{D=Bb<zA960(}
zzR!<Fx&L?FH>3Q0Y+J;;?~a}GaWG)BPpOSgQiE2hPBm(9Q#r}&%C$o=zgizoQI$Jk
zy>pjrx<e_{+mxmibUWnIMH<AN|HMl&?$9Et9a_Uz3B3=1yuaI(RW4O&8I>aMWf#!1
zfZ7S(QAhYvJj_qk4SpQf_@{33Z7nyn!aI6``}zdGvLgITYjatDxEFnrNMnb8V)M(`
zYrbH($J4+%fXmNfXZVNlh%50rZ)*M{OJLOEZ@SJOLP7qmM-xKFJYB(@!zvF1huY%F
zQ|1X?H#B~e7$32bvnj>JQ<hNyMhz7<yek562`d-g_e_<2V+y}8V!UaZ8LtOj$j<<`
zglge=8NDsZv@ZLr$kh=)v~Txgyf@taH2!|5`#c%+^R^P!bCd<u0_EsB-J%ROE>M;;
z>gfX+dywOvZ6)$_6<sqJ_aLx9moc(f<#{V)P0d4q5K{y}VV_5472hpH#St$<s1WR8
zmSv^Lh{I^&cs((TycJdXiyr9gN1NVbIZcy5p9A9@=B!ka#o9CJ1`H4!8Zbea=`j-a
zwlD-LF0V96#2id<xdb0avK+8QjUp*KlAaJ$qcv`t7AK7)&OCav0uTr7;^YQ`M8pPw
gD>rK+SChhQ{8ye0-aQ@=ypKJ^y)UEwEcZg{A3;Xe%>V!Z

delta 257
zcmaFhJHvIuC!Wbl+#-|NcuxUomC0Ygw8-QTDW%C@_*Q}BHgDoLVVa!5D>0c#sDL?$
zA$9UcA$i8c$?{T?lQ#*OpoypnM@T9#_%j4BgfMslX+MTw20buTV2GWpEHZm?k$}kL
zD<TE#0Sx&JMGPgAC$bAqP7qx*nMJG&O-y0(HnA-J5TL3`24|q^QieRB`eX_1$uZ(h
zlOKo|iH9&`GUPI(g5^pW!Wa@6a)7E*Cud76o-81lGkKj7$7Uw!Ys{0+sR&Fi5M$YV
POKt}vh_iWu0v8Ja{0d6k


From 5566c69a147344a5003855d367e77819fce747b1 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:31:38 +0000
Subject: [PATCH 299/525] ShellPkg: Fix 'EfiShellExecute' doesn't get command
 status correctly.

1. Add a new  function 'RunShellCommand' to return command status, thus 'EfiShellExecute' can get the command return status of 'CommandLine'.
2. Refine the code logic of 'EfiShellExecute' to make the new image of shell be loaded only if  'Environment' isn't NULL.

(Sync patch r18664 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Signed-off-by: Jin Eric <eric.jin@intel.com>
Signed-off-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19397 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c         | 69 +++++++++++++++++----
 ShellPkg/Application/Shell/Shell.h         | 19 ++++++
 ShellPkg/Application/Shell/ShellEnvVar.c   |  5 +-
 ShellPkg/Application/Shell/ShellProtocol.c | 72 ++++++++++++++--------
 4 files changed, 125 insertions(+), 40 deletions(-)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 03f5e4f05fe8..cb9d96944150 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1053,6 +1053,7 @@ DoStartupScript(
   )
 {
   EFI_STATUS                    Status;
+  EFI_STATUS                    CalleeStatus;
   UINTN                         Delay;
   EFI_INPUT_KEY                 Key;
   SHELL_FILE_HANDLE             FileHandle;
@@ -1084,7 +1085,10 @@ DoStartupScript(
       StrnCatS(FileStringPath, NewSize/sizeof(CHAR16), L" ", NewSize/sizeof(CHAR16) - StrLen(FileStringPath) -1);
       StrnCatS(FileStringPath, NewSize/sizeof(CHAR16), ShellInfoObject.ShellInitSettings.FileOptions, NewSize/sizeof(CHAR16) - StrLen(FileStringPath) -1);
     }
-    Status = RunCommand(FileStringPath);
+    Status = RunShellCommand(FileStringPath, &CalleeStatus);
+    if (ShellInfoObject.ShellInitSettings.BitUnion.Bits.Exit == TRUE) {
+      ShellCommandRegisterExit(gEfiShellProtocol->BatchIsActive(), (CONST UINT64)CalleeStatus);
+    }
     FreePool(FileStringPath);
     return (Status);
 
@@ -2133,6 +2137,7 @@ ProcessCommandLineToFinal(
   @param[in] CmdLine          the command line to run.
   @param[in] FirstParameter   the first parameter on the command line
   @param[in] ParamProtocol    the shell parameters protocol pointer
+  @param[out] CommandStatus   the status from the command line.
 
   @retval EFI_SUCCESS     The command was completed.
   @retval EFI_ABORTED     The command's operation was aborted.
@@ -2142,7 +2147,8 @@ EFIAPI
 RunInternalCommand(
   IN CONST CHAR16                   *CmdLine,
   IN       CHAR16                   *FirstParameter,
-  IN EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol
+  IN EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol,
+  OUT EFI_STATUS                    *CommandStatus
 )
 {
   EFI_STATUS                Status;
@@ -2175,6 +2181,14 @@ RunInternalCommand(
     Status = ShellCommandRunCommandHandler(FirstParameter, &CommandReturnedStatus, &LastError);
 
     if (!EFI_ERROR(Status)) {
+      if (CommandStatus != NULL) {
+        if (CommandReturnedStatus != SHELL_SUCCESS) {
+          *CommandStatus = (EFI_STATUS)(CommandReturnedStatus | MAX_BIT);
+        } else {
+          *CommandStatus = EFI_SUCCESS;
+        }
+      }
+
       //
       // Update last error status.
       // some commands do not update last error.
@@ -2236,6 +2250,7 @@ RunInternalCommand(
   @param[in] CmdLine          the command line to run.
   @param[in] FirstParameter   the first parameter on the command line
   @param[in] ParamProtocol    the shell parameters protocol pointer
+  @param[out] CommandStatus   the status from the command line.
 
   @retval EFI_SUCCESS     The command was completed.
   @retval EFI_ABORTED     The command's operation was aborted.
@@ -2246,7 +2261,8 @@ RunCommandOrFile(
   IN       SHELL_OPERATION_TYPES    Type,
   IN CONST CHAR16                   *CmdLine,
   IN       CHAR16                   *FirstParameter,
-  IN EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol
+  IN EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol,
+  OUT EFI_STATUS                    *CommandStatus
 )
 {
   EFI_STATUS                Status;
@@ -2262,7 +2278,7 @@ RunCommandOrFile(
 
   switch (Type) {
     case   Internal_Command:
-      Status = RunInternalCommand(CmdLine, FirstParameter, ParamProtocol);
+      Status = RunInternalCommand(CmdLine, FirstParameter, ParamProtocol, CommandStatus);
       break;
     case   Script_File_Name:
     case   Efi_Application:
@@ -2328,6 +2344,10 @@ RunCommandOrFile(
             CalleeExitStatus = (SHELL_STATUS) StartStatus;
           }
 
+          if (CommandStatus != NULL) {
+            *CommandStatus = CalleeExitStatus;
+          }
+
           //
           // Update last error status.
           //
@@ -2360,6 +2380,7 @@ RunCommandOrFile(
   @param[in] CmdLine          the command line to run.
   @param[in] FirstParameter   the first parameter on the command line.
   @param[in] ParamProtocol    the shell parameters protocol pointer
+  @param[out] CommandStatus   the status from the command line.
 
   @retval EFI_SUCCESS     The command was completed.
   @retval EFI_ABORTED     The command's operation was aborted.
@@ -2367,10 +2388,11 @@ RunCommandOrFile(
 EFI_STATUS
 EFIAPI
 SetupAndRunCommandOrFile(
-  IN SHELL_OPERATION_TYPES          Type,
-  IN CHAR16                         *CmdLine,
-  IN CHAR16                         *FirstParameter,
-  IN EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol
+  IN   SHELL_OPERATION_TYPES          Type,
+  IN   CHAR16                         *CmdLine,
+  IN   CHAR16                         *FirstParameter,
+  IN   EFI_SHELL_PARAMETERS_PROTOCOL  *ParamProtocol,
+  OUT EFI_STATUS                    *CommandStatus
 )
 {
   EFI_STATUS                Status;
@@ -2390,7 +2412,7 @@ SetupAndRunCommandOrFile(
   //
   if (!EFI_ERROR(Status)) {
     TrimSpaces(&CmdLine);
-    Status = RunCommandOrFile(Type, CmdLine, FirstParameter, ParamProtocol);
+    Status = RunCommandOrFile(Type, CmdLine, FirstParameter, ParamProtocol, CommandStatus);
   }
 
   //
@@ -2415,14 +2437,16 @@ SetupAndRunCommandOrFile(
   command or dispatch an external application.
 
   @param[in] CmdLine      The command line to parse.
+  @param[out] CommandStatus   The status from the command line.
 
   @retval EFI_SUCCESS     The command was completed.
   @retval EFI_ABORTED     The command's operation was aborted.
 **/
 EFI_STATUS
 EFIAPI
-RunCommand(
-  IN CONST CHAR16   *CmdLine
+RunShellCommand(
+  IN CONST CHAR16   *CmdLine,
+  OUT EFI_STATUS    *CommandStatus
   )
 {
   EFI_STATUS                Status;
@@ -2507,7 +2531,7 @@ RunCommand(
       case   Internal_Command:
       case   Script_File_Name:
       case   Efi_Application:
-        Status = SetupAndRunCommandOrFile(Type, CleanOriginal, FirstParameter, ShellInfoObject.NewShellParametersProtocol);
+        Status = SetupAndRunCommandOrFile(Type, CleanOriginal, FirstParameter, ShellInfoObject.NewShellParametersProtocol, CommandStatus);
         break;
       default:
         //
@@ -2528,6 +2552,27 @@ RunCommand(
   return (Status);
 }
 
+/**
+  Function will process and run a command line.
+
+  This will determine if the command line represents an internal shell 
+  command or dispatch an external application.
+
+  @param[in] CmdLine      The command line to parse.
+
+  @retval EFI_SUCCESS     The command was completed.
+  @retval EFI_ABORTED     The command's operation was aborted.
+**/
+EFI_STATUS
+EFIAPI
+RunCommand(
+  IN CONST CHAR16   *CmdLine
+  )
+{
+  return (RunShellCommand(CmdLine, NULL));
+}
+
+
 STATIC CONST UINT16 InvalidChars[] = {L'*', L'?', L'<', L'>', L'\\', L'/', L'\"', 0x0001, 0x0002};
 /**
   Function determines if the CommandName COULD be a valid command.  It does not determine whether
diff --git a/ShellPkg/Application/Shell/Shell.h b/ShellPkg/Application/Shell/Shell.h
index b6686256aac3..7c876510dd29 100644
--- a/ShellPkg/Application/Shell/Shell.h
+++ b/ShellPkg/Application/Shell/Shell.h
@@ -293,6 +293,25 @@ RunCommand(
   IN CONST CHAR16   *CmdLine
   );
 
+/**
+  Function will process and run a command line.
+
+  This will determine if the command line represents an internal shell 
+  command or dispatch an external application.
+
+  @param[in] CmdLine      The command line to parse.
+  @param[out] CommandStatus   The status from the command line.
+
+  @retval EFI_SUCCESS     The command was completed.
+  @retval EFI_ABORTED     The command's operation was aborted.
+**/
+EFI_STATUS
+EFIAPI
+RunShellCommand(
+  IN CONST CHAR16   *CmdLine,
+  OUT EFI_STATUS    *CommandStatus
+  );
+
 /**
   Function determines if the CommandName COULD be a valid command.  It does not determine whether
   this is a valid command.  It only checks for invalid characters.
diff --git a/ShellPkg/Application/Shell/ShellEnvVar.c b/ShellPkg/Application/Shell/ShellEnvVar.c
index 8ed14b34a2f4..a8f177e6adae 100644
--- a/ShellPkg/Application/Shell/ShellEnvVar.c
+++ b/ShellPkg/Application/Shell/ShellEnvVar.c
@@ -339,9 +339,10 @@ SetEnvironmentVariables(
     //
     // Copy the string into the Key, leaving the last character allocated as NULL to terminate
     //
-    StrCpyS( Node->Key, 
+    StrnCpyS( Node->Key, 
               StrStr(CurrentString, L"=") - CurrentString + 1, 
-              CurrentString
+              CurrentString,
+              StrStr(CurrentString, L"=") - CurrentString
               );
 
     //
diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index 3a963849f29a..af00fe401d9c 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -1631,40 +1631,60 @@ EfiShellExecute(
   CHAR16                    *Temp;
   EFI_DEVICE_PATH_PROTOCOL  *DevPath;
   UINTN                     Size;
-
+  EFI_STATUS                CalleeStatusCode;
+  
   if ((PcdGet8(PcdShellSupportLevel) < 1)) {
     return (EFI_UNSUPPORTED);
   }
 
-  DevPath = AppendDevicePath (ShellInfoObject.ImageDevPath, ShellInfoObject.FileDevPath);
+  if (Environment != NULL) {
+    // If Environment isn't null, load a new image of the shell with its own
+    // environment
+    DevPath = AppendDevicePath (ShellInfoObject.ImageDevPath, ShellInfoObject.FileDevPath);
+ 
+    DEBUG_CODE_BEGIN();
+    Temp = ConvertDevicePathToText(ShellInfoObject.FileDevPath, TRUE, TRUE);
+    FreePool(Temp);
+    Temp = ConvertDevicePathToText(ShellInfoObject.ImageDevPath, TRUE, TRUE);
+    FreePool(Temp);
+    Temp = ConvertDevicePathToText(DevPath, TRUE, TRUE);
+    FreePool(Temp);
+    DEBUG_CODE_END();
+
+    Temp = NULL;
+    Size = 0;
+    ASSERT((Temp == NULL && Size == 0) || (Temp != NULL));
+    StrnCatGrow(&Temp, &Size, L"Shell.efi -_exit ", 0);
+    StrnCatGrow(&Temp, &Size, CommandLine, 0);
 
-  DEBUG_CODE_BEGIN();
-  Temp = ConvertDevicePathToText(ShellInfoObject.FileDevPath, TRUE, TRUE);
-  FreePool(Temp);
-  Temp = ConvertDevicePathToText(ShellInfoObject.ImageDevPath, TRUE, TRUE);
-  FreePool(Temp);
-  Temp = ConvertDevicePathToText(DevPath, TRUE, TRUE);
-  FreePool(Temp);
-  DEBUG_CODE_END();
+    Status = InternalShellExecuteDevicePath(
+      ParentImageHandle,
+      DevPath,
+      Temp,
+      (CONST CHAR16**)Environment,
+      StatusCode);
 
-  Temp = NULL;
-  Size = 0;
-  ASSERT((Temp == NULL && Size == 0) || (Temp != NULL));
-  StrnCatGrow(&Temp, &Size, L"Shell.efi -_exit ", 0);
-  StrnCatGrow(&Temp, &Size, CommandLine, 0);
+    //
+    // de-allocate and return
+    //
+    FreePool(DevPath);
+    FreePool(Temp);
+  } else {
+    // If Environment is NULL, we are free to use and mutate the current shell
+    // environment. This is much faster as uses much less memory.
 
-  Status = InternalShellExecuteDevicePath(
-    ParentImageHandle,
-    DevPath,
-    Temp,
-    (CONST CHAR16**)Environment,
-    StatusCode);
+    if (CommandLine == NULL) {
+      CommandLine = L"";
+    }
+
+    Status = RunShellCommand (CommandLine, &CalleeStatusCode);
+
+    // Pass up the command's exit code if the caller wants it
+    if (StatusCode != NULL) {
+      *StatusCode = (EFI_STATUS) CalleeStatusCode;
+    }
+  }
 
-  //
-  // de-allocate and return
-  //
-  FreePool(DevPath);
-  FreePool(Temp);
   return(Status);
 }
 

From 45ac3433b58fb87cf63960cf3f1492b22df0d255 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:32:17 +0000
Subject: [PATCH 300/525] ShellPkg: Refine code by initializing local variable
 and adding ASSERT statement.

Add ASSERT statement and initialize local variable to make code more readable.

(Sync patch r18689 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19398 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c      | 2 ++
 ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c | 1 +
 2 files changed, 3 insertions(+)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index af00fe401d9c..fc13595dbb03 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -1632,6 +1632,8 @@ EfiShellExecute(
   EFI_DEVICE_PATH_PROTOCOL  *DevPath;
   UINTN                     Size;
   EFI_STATUS                CalleeStatusCode;
+
+  CalleeStatusCode = EFI_SUCCESS;
   
   if ((PcdGet8(PcdShellSupportLevel) < 1)) {
     return (EFI_UNSUPPORTED);
diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
index 02099febef08..831b9c3d0250 100644
--- a/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
+++ b/ShellPkg/Library/UefiShellTftpCommandLib/Tftp.c
@@ -341,6 +341,7 @@ ShellCommandRunTftp (
   }
 
   RemoteFilePath = ShellCommandLineGetRawValue (CheckPackage, 2);
+  ASSERT(RemoteFilePath != NULL);
   AsciiRemoteFilePath = AllocatePool (
                           (StrLen (RemoteFilePath) + 1) * sizeof (CHAR8)
                           );

From 66fb2e8febaf403cf1dfaa1bea718faf4529cacd Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Fri, 18 Dec 2015 07:32:50 +0000
Subject: [PATCH 301/525] ShellPkg UefiDpLib: Use correct string length for the
 input UnicodeBuffer

Same as the beginning of function to use DP_GAUGE_STRING_LENGTH, but not
DXE_PERFORMANCE_STRING_LENGTH.

(Sync patch r18725 from main trunk.)

Cc: Jaben Carsey <jaben.carsey@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19399 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiDpLib/DpUtilities.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/Library/UefiDpLib/DpUtilities.c b/ShellPkg/Library/UefiDpLib/DpUtilities.c
index 5237459e5b00..e9d8fb3adf31 100644
--- a/ShellPkg/Library/UefiDpLib/DpUtilities.c
+++ b/ShellPkg/Library/UefiDpLib/DpUtilities.c
@@ -164,8 +164,8 @@ DpGetShortPdbFileName (
     for (IndexA = StartIndex; IndexA < EndIndex; IndexA++) {
       UnicodeBuffer[IndexU] = (CHAR16) PdbFileName[IndexA];
       IndexU++;
-      if (IndexU >= DXE_PERFORMANCE_STRING_LENGTH) {
-        UnicodeBuffer[DXE_PERFORMANCE_STRING_LENGTH] = 0;
+      if (IndexU >= DP_GAUGE_STRING_LENGTH) {
+        UnicodeBuffer[DP_GAUGE_STRING_LENGTH] = 0;
         break;
       }
     }

From e52ab636c6e22788d5a968da3198498f20487aaa Mon Sep 17 00:00:00 2001
From: Cinnamon Shia <cinnamon.shia@hpe.com>
Date: Fri, 18 Dec 2015 07:33:22 +0000
Subject: [PATCH 302/525] ShellPkg/UefiDpLib: Fix a DP cumulative data issue

The value of PERF_CUM_DATA.Count and PERF_CUM_DATA.Duration field
keep cumulating on every execution of dp.
Initialize the CumData at dp's entry point.

(Sync patch r18727 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Cinnamon Shia <cinnamon.shia@hpe.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19400 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiDpLib/Dp.c | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiDpLib/Dp.c b/ShellPkg/Library/UefiDpLib/Dp.c
index 82701723c894..62a4e7b57782 100644
--- a/ShellPkg/Library/UefiDpLib/Dp.c
+++ b/ShellPkg/Library/UefiDpLib/Dp.c
@@ -14,6 +14,7 @@
   timer information to calculate elapsed time for each measurement.
  
   Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -110,7 +111,26 @@ DumpStatistics( void )
   SHELL_FREE_NON_NULL (StringPtrUnknown);
 }
 
-/** 
+/**
+  Initialize the cumulative data.
+
+**/
+VOID
+InitCumulativeData (
+  VOID
+  )
+{
+  UINTN                             Index;
+
+  for (Index = 0; Index < NumCum; ++Index) {
+    CumData[Index].Count = 0;
+    CumData[Index].MinDur = PERF_MAXDUR;
+    CumData[Index].MaxDur = 0;
+    CumData[Index].Duration = 0;
+  }
+}
+
+/**
   Dump performance data.
   
   @param[in]  ImageHandle     The image handle.
@@ -218,6 +238,11 @@ ShellCommandRunDp (
 #endif  // PROFILING_IMPLEMENTED
   }
 
+  //
+  // Initialize the pre-defined cumulative data.
+  //
+  InitCumulativeData ();
+
   //
   // Timer specific processing
   //

From b8e0c9e02451ea95052a0c18f86ff61141df0547 Mon Sep 17 00:00:00 2001
From: Cinnamon Shia <cinnamon.shia@hpe.com>
Date: Fri, 18 Dec 2015 07:34:01 +0000
Subject: [PATCH 303/525] ShellPkg/UefiDpLib: Support dumping cumulative data

Add a new option -c to dump cumulative data.
For example:
shell> dp -c
==[ Cumulative ]========
(Times in microsec.)     Cumulative   Average     Shortest    Longest
   Name          Count    Duration    Duration    Duration    Duration
LoadImage:         200     1000000        7000           0      100000
StartImage:        200    20000000       90000           0     7000000
  DB:Start:        200    20000000      100000           0     9000000
DB:Support:     200000      100000           0           0        7000

shell> dp -c DXE
==[ Cumulative ]========
(Times in microsec.)     Cumulative   Average     Shortest    Longest
   Name          Count    Duration    Duration    Duration    Duration
LoadImage:         200     1000000        7000           0      100000
StartImage:        200    20000000       90000           0     7000000
  DB:Start:        200    20000000      100000           0     9000000
DB:Support:     200000      100000           0           0        7000
        DXE          1    30000000    30000000           0    30000000

(Sync patch r18728 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Cinnamon Shia <cinnamon.shia@hpe.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: El-Haj-Mahmoud Samer <samer.el-haj-mahmoud@hpe.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19401 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiDpLib/Dp.c          |  33 ++++++++++++--
 ShellPkg/Library/UefiDpLib/DpInternal.h  |   9 +++-
 ShellPkg/Library/UefiDpLib/DpTrace.c     |  55 ++++++++++++++++++++---
 ShellPkg/Library/UefiDpLib/UefiDpLib.uni | Bin 17466 -> 18146 bytes
 4 files changed, 87 insertions(+), 10 deletions(-)

diff --git a/ShellPkg/Library/UefiDpLib/Dp.c b/ShellPkg/Library/UefiDpLib/Dp.c
index 62a4e7b57782..4d109d037c1b 100644
--- a/ShellPkg/Library/UefiDpLib/Dp.c
+++ b/ShellPkg/Library/UefiDpLib/Dp.c
@@ -79,6 +79,7 @@ STATIC CONST SHELL_PARAM_ITEM ParamList[] = {
 #endif // PROFILING_IMPLEMENTED
   {L"-x", TypeFlag},   // -x   eXclude Cumulative Items
   {L"-i", TypeFlag},   // -i   Display Identifier
+  {L"-c", TypeValue},  // -c   Display cumulative data.
   {L"-n", TypeValue},  // -n # Number of records to display for A and R
   {L"-t", TypeValue},  // -t # Threshold of interest
   {NULL, TypeMax}
@@ -164,6 +165,9 @@ ShellCommandRunDp (
   BOOLEAN                   TraceMode;
   BOOLEAN                   ProfileMode;
   BOOLEAN                   ExcludeMode;
+  BOOLEAN                   CumulativeMode;
+  CONST CHAR16              *CustomCumulativeToken;
+  PERF_CUM_DATA             *CustomCumulativeData;
 
   StringPtr   = NULL;
   SummaryMode = FALSE;
@@ -173,6 +177,8 @@ ShellCommandRunDp (
   TraceMode   = FALSE;
   ProfileMode = FALSE;
   ExcludeMode = FALSE;
+  CumulativeMode = FALSE;
+  CustomCumulativeData = NULL;
 
   // Get DP's entry time as soon as possible.
   // This is used as the Shell-Phase end time.
@@ -210,6 +216,7 @@ ShellCommandRunDp (
 #endif  // PROFILING_IMPLEMENTED
   ExcludeMode = ShellCommandLineGetFlag (ParamPackage, L"-x");
   mShowId     = ShellCommandLineGetFlag (ParamPackage, L"-i");
+  CumulativeMode = ShellCommandLineGetFlag (ParamPackage, L"-c");
 
   // Options with Values
   CmdLineArg  = ShellCommandLineGetValue (ParamPackage, L"-n");
@@ -243,6 +250,20 @@ ShellCommandRunDp (
   //
   InitCumulativeData ();
 
+  //
+  // Init the custom cumulative data.
+  //
+  CustomCumulativeToken = ShellCommandLineGetValue (ParamPackage, L"-c");
+  if (CustomCumulativeToken != NULL) {
+    CustomCumulativeData = AllocateZeroPool (sizeof (PERF_CUM_DATA));
+    CustomCumulativeData->MinDur = 0;
+    CustomCumulativeData->MaxDur = 0;
+    CustomCumulativeData->Count  = 0;
+    CustomCumulativeData->Duration = 0;
+    CustomCumulativeData->Name   = AllocateZeroPool (StrLen (CustomCumulativeToken) + 1);
+    UnicodeStrToAsciiStr (CustomCumulativeToken, CustomCumulativeData->Name);
+  }
+
   //
   // Timer specific processing
   //
@@ -302,8 +323,10 @@ ShellCommandRunDp (
 ****    !T &&  P  := (2) Only Profile records are displayed
 ****     T &&  P  := (3) Same as Default, both are displayed
 ****************************************************************************/
-  GatherStatistics();
-  if (AllMode) {
+  GatherStatistics (CustomCumulativeData);
+  if (CumulativeMode) {                       
+    ProcessCumulative (CustomCumulativeData);
+  } else if (AllMode) {
     if (TraceMode) {
       DumpAllTrace( Number2Display, ExcludeMode);
     }
@@ -326,7 +349,7 @@ ShellCommandRunDp (
         if ( ! EFI_ERROR( Status)) {
           ProcessPeims ();
           ProcessGlobal ();
-          ProcessCumulative ();
+          ProcessCumulative (NULL);
         }
       }
     }
@@ -339,6 +362,10 @@ ShellCommandRunDp (
   }
 
   SHELL_FREE_NON_NULL (StringPtr);
+  if (CustomCumulativeData != NULL) {
+    SHELL_FREE_NON_NULL (CustomCumulativeData->Name);
+  }
+  SHELL_FREE_NON_NULL (CustomCumulativeData);
 
   return SHELL_SUCCESS;
 }
diff --git a/ShellPkg/Library/UefiDpLib/DpInternal.h b/ShellPkg/Library/UefiDpLib/DpInternal.h
index 9b8163aaa0f7..aa07fea8c21d 100644
--- a/ShellPkg/Library/UefiDpLib/DpInternal.h
+++ b/ShellPkg/Library/UefiDpLib/DpInternal.h
@@ -172,10 +172,13 @@ GetCumulativeItem(
   
   @post The SummaryData and CumData structures contain statistics for the
         current performance logs.
+
+  @param[in, out] CustomCumulativeData  The pointer to the custom cumulative data.
+
 **/
 VOID
 GatherStatistics(
-  VOID
+  IN OUT PERF_CUM_DATA              *CustomCumulativeData OPTIONAL
   );
 
 /** 
@@ -283,11 +286,13 @@ ProcessGlobal(
   For each record with a Token listed in the CumData array:<BR>
      - Update the instance count and the total, minimum, and maximum durations.
   Finally, print the gathered cumulative statistics.
+
+  @param[in]    CustomCumulativeData  The pointer to the custom cumulative data.
   
 **/
 VOID
 ProcessCumulative(
-  VOID
+  IN PERF_CUM_DATA                  *CustomCumulativeData OPTIONAL
   );
 
 /** 
diff --git a/ShellPkg/Library/UefiDpLib/DpTrace.c b/ShellPkg/Library/UefiDpLib/DpTrace.c
index cf8200c6f1a2..d17d514bf12e 100644
--- a/ShellPkg/Library/UefiDpLib/DpTrace.c
+++ b/ShellPkg/Library/UefiDpLib/DpTrace.c
@@ -43,11 +43,14 @@
   
   @post The SummaryData and CumData structures contain statistics for the
         current performance logs.
+
+  @param[in, out] CustomCumulativeData  A pointer to the cumtom cumulative data.
+
 **/
 VOID
 GatherStatistics(
-  VOID
-)
+  IN OUT PERF_CUM_DATA              *CustomCumulativeData OPTIONAL
+  )
 {
   MEASUREMENT_RECORD        Measurement;
   UINT64                    Duration;
@@ -99,6 +102,20 @@ GatherStatistics(
         CumData[TIndex].MaxDur = Duration;
       }
     }
+
+    //
+    // Collect the data for custom cumulative data.
+    //
+    if ((CustomCumulativeData != NULL) && (AsciiStrCmp (Measurement.Token, CustomCumulativeData->Name) == 0)) {
+      CustomCumulativeData->Duration += Duration;
+      CustomCumulativeData->Count++;
+      if (Duration < CustomCumulativeData->MinDur) {
+        CustomCumulativeData->MinDur = Duration;
+      }
+      if (Duration > CustomCumulativeData->MaxDur) {
+        CustomCumulativeData->MaxDur = Duration;
+      }
+    }
   }
 }
 
@@ -782,12 +799,14 @@ ProcessGlobal(
   For each record with a Token listed in the CumData array:<BR>
      - Update the instance count and the total, minimum, and maximum durations.
   Finally, print the gathered cumulative statistics.
-  
+
+  @param[in]    CustomCumulativeData  A pointer to the cumtom cumulative data.
+
 **/
 VOID
 ProcessCumulative(
-  VOID
-)
+  IN PERF_CUM_DATA                  *CustomCumulativeData OPTIONAL
+  )
 {
   UINT64                    AvgDur;         // the computed average duration
   UINT64                    Dur;
@@ -826,4 +845,30 @@ ProcessCumulative(
                  );
     }
   }
+
+  //
+  // Print the custom cumulative data.
+  //
+  if (CustomCumulativeData != NULL) {
+    if (CustomCumulativeData->Count != 0) {
+      AvgDur = DivU64x32 (CustomCumulativeData->Duration, CustomCumulativeData->Count);
+      AvgDur = DurationInMicroSeconds (AvgDur);
+      Dur    = DurationInMicroSeconds (CustomCumulativeData->Duration);
+      MaxDur = DurationInMicroSeconds (CustomCumulativeData->MaxDur);
+      MinDur = DurationInMicroSeconds (CustomCumulativeData->MinDur);
+    } else {
+      AvgDur = 0;
+      Dur    = 0;
+      MaxDur = 0;
+      MinDur = 0;
+    }
+    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_DP_CUMULATIVE_STATS), gDpHiiHandle,
+                CustomCumulativeData->Name,
+                CustomCumulativeData->Count,
+                Dur,
+                AvgDur,
+                MinDur,
+                MaxDur
+                );
+  }
 }
diff --git a/ShellPkg/Library/UefiDpLib/UefiDpLib.uni b/ShellPkg/Library/UefiDpLib/UefiDpLib.uni
index 1e5c26ac944e3f626c97c79ac9bb1c4196c70ed3..5bcb4964523aa7839694bc430f57ad27e8f63047 100644
GIT binary patch
delta 437
zcmZvY%}&BV6ot>kz=Fh81IBbSc8>}EM5qg+kpz)o6WIZaNgW8GMN$D@!HtWiPv9G9
zy5nu+NjTFG(MTq}(|hlC&$*f9n^?Vz&!&i_b8!xd1~gs~FwS@+JSg}WGe&q~UdM!W
z&1}kVgcs;IwD(%@;twlrilA!w#JYr@Ii`vC(NDi>!(7(r-~snkX%i|#CP!7P8xbp0
zU1LDS32)=1_-Ae(bGjJ0aFd0s1nkd9FGx#rCR6Bfryl1V*7i|=lc>CX?XkMc!6^UN
z+AeN(Fq3ZbeOXKf`O;wp$5d`{7e&uIPAd$56ZT0)JZ9TOj60Zv(~P;r4P0!=9~b-V
RPk+vrp3>2%xv99S<<^p%SkM3f

delta 24
gcmaFV%ebq9af27*<|~Xj7Mmlil2|t%a8zOi0D&(FVgLXD


From 916f81f23277fa9a7451783d207e3485c779d5d6 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:34:43 +0000
Subject: [PATCH 304/525] ShellPkg: Don't strip positional parameters of
 quotation marks.

Per Shell SPEC 2.1 'Double-quotation marks that surround arguments are not stripped in positional parameters'. This patch makes Shell implementation to follow SPEC.

(Sync patch r18742 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19402 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c            | 30 +++++------
 ShellPkg/Application/Shell/Shell.h            |  8 ---
 .../Shell/ShellParametersProtocol.c           | 52 ++++++++++++++-----
 .../Shell/ShellParametersProtocol.h           | 36 +++++++++----
 ShellPkg/Application/Shell/ShellProtocol.c    |  2 +-
 5 files changed, 80 insertions(+), 48 deletions(-)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index cb9d96944150..8af66479a3b4 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1863,7 +1863,7 @@ IsValidSplit(
       return (EFI_OUT_OF_RESOURCES);
     }
     TempWalker = (CHAR16*)Temp;
-    if (!EFI_ERROR(GetNextParameter(&TempWalker, &FirstParameter, StrSize(CmdLine)))) {
+    if (!EFI_ERROR(GetNextParameter(&TempWalker, &FirstParameter, StrSize(CmdLine), TRUE))) {
       if (GetOperationType(FirstParameter) == Unknown_Invalid) {
         ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_SHELL_NOT_FOUND), ShellInfoObject.HiiHandle, FirstParameter);
         SetLastError(SHELL_NOT_FOUND);
@@ -2029,7 +2029,7 @@ DoHelpUpdate(
 
   Walker = *CmdLine;
   while(Walker != NULL && *Walker != CHAR_NULL) {
-    if (!EFI_ERROR(GetNextParameter(&Walker, &CurrentParameter, StrSize(*CmdLine)))) {
+    if (!EFI_ERROR(GetNextParameter(&Walker, &CurrentParameter, StrSize(*CmdLine), TRUE))) {
       if (StrStr(CurrentParameter, L"-?") == CurrentParameter) {
         CurrentParameter[0] = L' ';
         CurrentParameter[1] = L' ';
@@ -2173,7 +2173,7 @@ RunInternalCommand(
   //
   // get the argc and argv updated for internal commands
   //
-  Status = UpdateArgcArgv(ParamProtocol, NewCmdLine, &Argv, &Argc);
+  Status = UpdateArgcArgv(ParamProtocol, NewCmdLine, Internal_Command, &Argv, &Argc);
   if (!EFI_ERROR(Status)) {
     //
     // Run the internal command.
@@ -2520,7 +2520,7 @@ RunShellCommand(
     return (EFI_OUT_OF_RESOURCES);
   }
   TempWalker = CleanOriginal;
-  if (!EFI_ERROR(GetNextParameter(&TempWalker, &FirstParameter, StrSize(CleanOriginal)))) {
+  if (!EFI_ERROR(GetNextParameter(&TempWalker, &FirstParameter, StrSize(CleanOriginal), TRUE))) {
     //
     // Depending on the first parameter we change the behavior
     //
@@ -2767,34 +2767,34 @@ RunScriptFileHandle (
       if (NewScriptFile->Argv != NULL) {
         switch (NewScriptFile->Argc) {
           default:
-            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%9", NewScriptFile->Argv[9], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%9", NewScriptFile->Argv[9], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 9:
-            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%8", NewScriptFile->Argv[8], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%8", NewScriptFile->Argv[8], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 8:
-            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%7", NewScriptFile->Argv[7], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%7", NewScriptFile->Argv[7], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 7:
-            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%6", NewScriptFile->Argv[6], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%6", NewScriptFile->Argv[6], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 6:
-            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%5", NewScriptFile->Argv[5], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%5", NewScriptFile->Argv[5], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 5:
-            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%4", NewScriptFile->Argv[4], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%4", NewScriptFile->Argv[4], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 4:
-            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%3", NewScriptFile->Argv[3], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%3", NewScriptFile->Argv[3], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 3:
-            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%2", NewScriptFile->Argv[2], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%2", NewScriptFile->Argv[2], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 2:
-            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%1", NewScriptFile->Argv[1], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine2,  CommandLine, PrintBuffSize, L"%1", NewScriptFile->Argv[1], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
           case 1:
-            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%0", NewScriptFile->Argv[0], FALSE, TRUE);
+            Status = ShellCopySearchAndReplace(CommandLine,  CommandLine2, PrintBuffSize, L"%0", NewScriptFile->Argv[0], FALSE, FALSE);
             ASSERT_EFI_ERROR(Status);
             break;
           case 0:
@@ -2944,7 +2944,7 @@ RunScriptFile (
   //
   // get the argc and argv updated for scripts
   //
-  Status = UpdateArgcArgv(ParamProtocol, CmdLine, &Argv, &Argc);
+  Status = UpdateArgcArgv(ParamProtocol, CmdLine, Script_File_Name, &Argv, &Argc);
   if (!EFI_ERROR(Status)) {
 
     if (Handle == NULL) {
diff --git a/ShellPkg/Application/Shell/Shell.h b/ShellPkg/Application/Shell/Shell.h
index 7c876510dd29..57263204e388 100644
--- a/ShellPkg/Application/Shell/Shell.h
+++ b/ShellPkg/Application/Shell/Shell.h
@@ -124,14 +124,6 @@ typedef struct {
 
 extern SHELL_INFO ShellInfoObject;
 
-typedef enum {
-  Internal_Command,
-  Script_File_Name,
-  Efi_Application,
-  File_Sys_Change,
-  Unknown_Invalid
-} SHELL_OPERATION_TYPES;
-
 /**
   Converts the command line to it's post-processed form.  this replaces variables and alias' per UEFI Shell spec.
 
diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.c b/ShellPkg/Application/Shell/ShellParametersProtocol.c
index 9c502f8f212e..56dd79214b3a 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.c
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.c
@@ -74,10 +74,12 @@ FindEndOfParameter(
 
   This will also remove all remaining ^ characters after processing.
 
-  @param[in, out] Walker        pointer to string of command line.  Adjusted to
-                                reminaing command line on return
-  @param[in, out] TempParameter pointer to string of command line item extracted.
-  @param[in]      Length        buffer size of TempParameter.
+  @param[in, out] Walker          pointer to string of command line.  Adjusted to
+                                  reminaing command line on return
+  @param[in, out] TempParameter   pointer to string of command line item extracted.
+  @param[in]      Length          buffer size of TempParameter.
+  @param[in]      StripQuotation  if TRUE then strip the quotation marks surrounding
+                                  the parameters.
 
   @return   EFI_INALID_PARAMETER  A required parameter was NULL or pointed to a NULL or empty string.
   @return   EFI_NOT_FOUND         A closing " could not be found on the specified string
@@ -87,7 +89,8 @@ EFIAPI
 GetNextParameter(
   IN OUT CHAR16   **Walker,
   IN OUT CHAR16   **TempParameter,
-  IN CONST UINTN  Length
+  IN CONST UINTN  Length,
+  IN BOOLEAN      StripQuotation
   )
 {
   CONST CHAR16 *NextDelim;
@@ -161,7 +164,11 @@ DEBUG_CODE_END();
       //
       // eliminate the unescaped quote
       //
-      CopyMem ((CHAR16*)NextDelim, NextDelim + 1, StrSize (NextDelim + 1));
+      if (StripQuotation) {
+        CopyMem ((CHAR16*)NextDelim, NextDelim + 1, StrSize (NextDelim + 1));
+	  } else{
+        NextDelim++;
+	  }
     }
   }
 
@@ -178,9 +185,11 @@ DEBUG_CODE_END();
   All special character processing (alias, environment variable, redirection, 
   etc... must be complete before calling this API.
 
-  @param[in] CommandLine         String of command line to parse
-  @param[in, out] Argv           pointer to array of strings; one for each parameter
-  @param[in, out] Argc           pointer to number of strings in Argv array
+  @param[in] CommandLine          String of command line to parse
+  @param[in] StripQuotation       if TRUE then strip the quotation marks surrounding
+                                  the parameters.
+  @param[in, out] Argv            pointer to array of strings; one for each parameter
+  @param[in, out] Argc            pointer to number of strings in Argv array
 
   @return EFI_SUCCESS           the operation was sucessful
   @return EFI_OUT_OF_RESOURCES  a memory allocation failed.
@@ -189,8 +198,9 @@ EFI_STATUS
 EFIAPI
 ParseCommandLineToArgs(
   IN CONST CHAR16 *CommandLine,
-  IN OUT CHAR16 ***Argv,
-  IN OUT UINTN *Argc
+  IN BOOLEAN      StripQuotation,
+  IN OUT CHAR16   ***Argv,
+  IN OUT UINTN    *Argc
   )
 {
   UINTN       Count;
@@ -228,7 +238,7 @@ ParseCommandLineToArgs(
       ; Walker != NULL && *Walker != CHAR_NULL
       ; Count++
       ) {
-    if (EFI_ERROR(GetNextParameter(&Walker, &TempParameter, Size))) {
+    if (EFI_ERROR(GetNextParameter(&Walker, &TempParameter, Size, TRUE))) {
       break;
     }
   }
@@ -246,7 +256,7 @@ ParseCommandLineToArgs(
   Walker = (CHAR16*)NewCommandLine;
   while(Walker != NULL && *Walker != CHAR_NULL) {
     SetMem16(TempParameter, Size, CHAR_NULL);
-    if (EFI_ERROR(GetNextParameter(&Walker, &TempParameter, Size))) {
+    if (EFI_ERROR(GetNextParameter(&Walker, &TempParameter, Size, StripQuotation))) {
       Status = EFI_INVALID_PARAMETER;
       goto Done;
     }
@@ -375,6 +385,7 @@ CreatePopulateInstallShellParametersProtocol (
     // Populate Argc and Argv
     //
     Status = ParseCommandLineToArgs(FullCommandLine,
+                                    TRUE,
                                     &(*NewShellParameters)->Argv,
                                     &(*NewShellParameters)->Argc);
 
@@ -1369,6 +1380,7 @@ RestoreStdInStdOutStdErr (
 
   @param[in, out] ShellParameters        Pointer to parameter structure to modify.
   @param[in] NewCommandLine              The new command line to parse and use.
+  @param[in] Type                        The type of operation.
   @param[out] OldArgv                    Pointer to old list of parameters.
   @param[out] OldArgc                    Pointer to old number of items in Argv list.
 
@@ -1380,11 +1392,15 @@ EFIAPI
 UpdateArgcArgv(
   IN OUT EFI_SHELL_PARAMETERS_PROTOCOL  *ShellParameters,
   IN CONST CHAR16                       *NewCommandLine,
+  IN SHELL_OPERATION_TYPES              Type,
   OUT CHAR16                            ***OldArgv OPTIONAL,
   OUT UINTN                             *OldArgc OPTIONAL
   )
 {
+  BOOLEAN                 StripParamQuotation;
+  
   ASSERT(ShellParameters != NULL);
+  StripParamQuotation = TRUE;
 
   if (OldArgc != NULL) {
     *OldArgc = ShellParameters->Argc;
@@ -1393,7 +1409,15 @@ UpdateArgcArgv(
     *OldArgv = ShellParameters->Argv;
   }
 
-  return (ParseCommandLineToArgs(NewCommandLine, &(ShellParameters->Argv), &(ShellParameters->Argc)));
+  if (Type == Script_File_Name) {
+    StripParamQuotation = FALSE;
+  }
+  
+  return ParseCommandLineToArgs( NewCommandLine, 
+                                 StripParamQuotation, 
+                                 &(ShellParameters->Argv), 
+                                 &(ShellParameters->Argc)
+                                );
 }
 
 /**
diff --git a/ShellPkg/Application/Shell/ShellParametersProtocol.h b/ShellPkg/Application/Shell/ShellParametersProtocol.h
index 2fd8f8c88b33..926f36242cde 100644
--- a/ShellPkg/Application/Shell/ShellParametersProtocol.h
+++ b/ShellPkg/Application/Shell/ShellParametersProtocol.h
@@ -18,6 +18,14 @@
 
 #include "Shell.h"
 
+typedef enum {
+  Internal_Command,
+  Script_File_Name,
+  Efi_Application,
+  File_Sys_Change,
+  Unknown_Invalid
+} SHELL_OPERATION_TYPES;
+
 /**
   creates a new EFI_SHELL_PARAMETERS_PROTOCOL instance and populates it and then
   installs it on our handle and if there is an existing version of the protocol
@@ -66,6 +74,7 @@ CleanUpShellParametersProtocol (
 
   @param[in, out] ShellParameters       pointer to parameter structure to modify
   @param[in] NewCommandLine             the new command line to parse and use
+  @param[in] Type                       the type of operation.
   @param[out] OldArgv                   pointer to old list of parameters
   @param[out] OldArgc                   pointer to old number of items in Argv list
 
@@ -77,6 +86,7 @@ EFIAPI
 UpdateArgcArgv(
   IN OUT EFI_SHELL_PARAMETERS_PROTOCOL  *ShellParameters,
   IN CONST CHAR16                       *NewCommandLine,
+  IN SHELL_OPERATION_TYPES              Type,
   OUT CHAR16                            ***OldArgv,
   OUT UINTN                             *OldArgc
   );
@@ -162,9 +172,11 @@ RestoreStdInStdOutStdErr (
   parameters for inclusion in EFI_SHELL_PARAMETERS_PROTOCOL.  this supports space
   delimited and quote surrounded parameter definition.
 
-  @param[in] CommandLine         String of command line to parse
-  @param[in, out] Argv           pointer to array of strings; one for each parameter
-  @param[in, out] Argc           pointer to number of strings in Argv array
+  @param[in] CommandLine          String of command line to parse
+  @param[in] StripQuotation       if TRUE then strip the quotation marks surrounding
+                                  the parameters.
+  @param[in, out] Argv            pointer to array of strings; one for each parameter
+  @param[in, out] Argc            pointer to number of strings in Argv array
 
   @return EFI_SUCCESS           the operation was sucessful
   @return EFI_OUT_OF_RESOURCES  a memory allocation failed.
@@ -173,8 +185,9 @@ EFI_STATUS
 EFIAPI
 ParseCommandLineToArgs(
   IN CONST CHAR16 *CommandLine,
-  IN OUT CHAR16 ***Argv,
-  IN OUT UINTN *Argc
+  IN BOOLEAN      StripQuotation,
+  IN OUT CHAR16   ***Argv,
+  IN OUT UINTN    *Argc
   );
 
 /**
@@ -187,10 +200,12 @@ ParseCommandLineToArgs(
   Temp Parameter must be large enough to hold the parameter before calling this
   function.
 
-  @param[in, out] Walker        pointer to string of command line.  Adjusted to
-                                reminaing command line on return
-  @param[in, out] TempParameter pointer to string of command line item extracted.
-  @param[in]      Length        Length of (*TempParameter) in bytes
+  @param[in, out] Walker          pointer to string of command line.  Adjusted to
+                                  reminaing command line on return
+  @param[in, out] TempParameter   pointer to string of command line item extracted.
+  @param[in]      Length          Length of (*TempParameter) in bytes
+  @param[in]      StripQuotation  if TRUE then strip the quotation marks surrounding
+                                  the parameters.
 
   @return   EFI_INALID_PARAMETER  A required parameter was NULL or pointed to a NULL or empty string.
   @return   EFI_NOT_FOUND         A closing " could not be found on the specified string
@@ -200,7 +215,8 @@ EFIAPI
 GetNextParameter(
   IN OUT CHAR16   **Walker,
   IN OUT CHAR16   **TempParameter,
-  IN CONST UINTN  Length
+  IN CONST UINTN  Length,
+  IN BOOLEAN      StripQuotation
   );
 
 #endif //_SHELL_PARAMETERS_PROTOCOL_PROVIDER_HEADER_
diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index fc13595dbb03..9c370ccef5af 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -1501,7 +1501,7 @@ InternalShellExecuteDevicePath(
     ShellParamsProtocol.StdIn   = ShellInfoObject.NewShellParametersProtocol->StdIn;
     ShellParamsProtocol.StdOut  = ShellInfoObject.NewShellParametersProtocol->StdOut;
     ShellParamsProtocol.StdErr  = ShellInfoObject.NewShellParametersProtocol->StdErr;
-    Status = UpdateArgcArgv(&ShellParamsProtocol, NewCmdLine, NULL, NULL);
+    Status = UpdateArgcArgv(&ShellParamsProtocol, NewCmdLine, Efi_Application, NULL, NULL);
     ASSERT_EFI_ERROR(Status);
     //
     // Replace Argv[0] with the full path of the binary we're executing:

From b5e0f73c8f0e5344d17071e6791749700fb63fd4 Mon Sep 17 00:00:00 2001
From: Cecil Sheng <cecil.sheng@hpe.com>
Date: Fri, 18 Dec 2015 07:35:18 +0000
Subject: [PATCH 305/525] ShellPkg: Corrected CatSPrint usage to prevent memory
 leaks.

CatSPrint allocates return buffer for the caller. The caller doesn't have to allocate one, and has to free the used buffers.

(Sync patch r18902 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Cecil Sheng <cecil.sheng@hpe.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19403 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiHandleParsingLib.c                    | 230 +++++++++---------
 1 file changed, 121 insertions(+), 109 deletions(-)

diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
index b6ce509af3f2..b211de7d1d76 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
@@ -1,6 +1,7 @@
 /** @file
   Provides interface to advanced shell functionality for parsing both handle and protocol database.
 
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
   Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
@@ -108,9 +109,9 @@ HandleParsingLibConstructor (
   return (EFI_SUCCESS);
 }
 
-/** 
+/**
   Initialization function for HII packages.
- 
+
 **/
 VOID
 HandleParsingHiiInit (VOID)
@@ -180,10 +181,7 @@ LoadedImageProtocolDumpInformation(
   HandleParsingHiiInit();
 
   Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_LI_DUMP_MAIN), NULL);
-  RetVal = AllocateZeroPool (PcdGet16 (PcdShellPrintBufferSize));
-  if (Temp == NULL || RetVal == NULL) {
-    SHELL_FREE_NON_NULL(Temp);
-    SHELL_FREE_NON_NULL(RetVal);
+  if (Temp == NULL) {
     return NULL;
   }
 
@@ -198,29 +196,30 @@ LoadedImageProtocolDumpInformation(
 
   if (EFI_ERROR (Status)) {
     SHELL_FREE_NON_NULL (Temp);
-    SHELL_FREE_NON_NULL (RetVal);
     return NULL;
   }
 
   DataType = ConvertMemoryType(LoadedImage->ImageDataType);
   CodeType = ConvertMemoryType(LoadedImage->ImageCodeType);
 
-  RetVal = CatSPrint(RetVal,
-                      Temp,
-                      LoadedImage->Revision,
-                      LoadedImage->ParentHandle,
-                      LoadedImage->SystemTable,
-                      LoadedImage->DeviceHandle,
-                      LoadedImage->FilePath,
-                      LoadedImage->LoadOptionsSize,
-                      LoadedImage->LoadOptions,
-                      LoadedImage->ImageBase,
-                      LoadedImage->ImageSize,
-                      CodeType,
-                      DataType,
-                      LoadedImage->Unload);
-
-  
+  RetVal = CatSPrint(
+             NULL,
+             Temp,
+             LoadedImage->Revision,
+             LoadedImage->ParentHandle,
+             LoadedImage->SystemTable,
+             LoadedImage->DeviceHandle,
+             LoadedImage->FilePath,
+             LoadedImage->LoadOptionsSize,
+             LoadedImage->LoadOptions,
+             LoadedImage->ImageBase,
+             LoadedImage->ImageSize,
+             CodeType,
+             DataType,
+             LoadedImage->Unload
+             );
+
+
   SHELL_FREE_NON_NULL(Temp);
   SHELL_FREE_NON_NULL(CodeType);
   SHELL_FREE_NON_NULL(DataType);
@@ -258,10 +257,7 @@ GraphicsOutputProtocolDumpInformation(
   HandleParsingHiiInit();
 
   Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_GOP_DUMP_MAIN), NULL);
-  RetVal = AllocateZeroPool (PcdGet16 (PcdShellPrintBufferSize));
-  if (Temp == NULL || RetVal == NULL) {
-    SHELL_FREE_NON_NULL(Temp);
-    SHELL_FREE_NON_NULL(RetVal);
+  if (Temp == NULL) {
     return NULL;
   }
 
@@ -276,29 +272,29 @@ GraphicsOutputProtocolDumpInformation(
 
   if (EFI_ERROR (Status)) {
     SHELL_FREE_NON_NULL (Temp);
-    SHELL_FREE_NON_NULL (RetVal);
     return NULL;
   }
 
   Fmt = ConvertPixelFormat(GraphicsOutput->Mode->Info->PixelFormat);
 
-  RetVal = CatSPrint(RetVal,
-                      Temp,
-                      GraphicsOutput->Mode->MaxMode,
-                      GraphicsOutput->Mode->Mode,
-                      GraphicsOutput->Mode->FrameBufferBase,
-                      (UINT64)GraphicsOutput->Mode->FrameBufferSize,
-                      (UINT64)GraphicsOutput->Mode->SizeOfInfo,
-                      GraphicsOutput->Mode->Info->Version,
-                      GraphicsOutput->Mode->Info->HorizontalResolution,
-                      GraphicsOutput->Mode->Info->VerticalResolution,
-                      Fmt,
-                      GraphicsOutput->Mode->Info->PixelsPerScanLine,
-                      GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.RedMask,
-                      GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.GreenMask,
-                      GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.BlueMask
-                      );
-  
+  RetVal = CatSPrint(
+             NULL,
+             Temp,
+             GraphicsOutput->Mode->MaxMode,
+             GraphicsOutput->Mode->Mode,
+             GraphicsOutput->Mode->FrameBufferBase,
+             (UINT64)GraphicsOutput->Mode->FrameBufferSize,
+             (UINT64)GraphicsOutput->Mode->SizeOfInfo,
+             GraphicsOutput->Mode->Info->Version,
+             GraphicsOutput->Mode->Info->HorizontalResolution,
+             GraphicsOutput->Mode->Info->VerticalResolution,
+             Fmt,
+             GraphicsOutput->Mode->Info->PixelsPerScanLine,
+             GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.RedMask,
+             GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.GreenMask,
+             GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.BlueMask
+             );
+
   SHELL_FREE_NON_NULL(Temp);
   SHELL_FREE_NON_NULL(Fmt);
 
@@ -356,7 +352,7 @@ PciRootBridgeIoDumpInformation(
   FreePool(Temp);
   RetVal = Temp2;
   Temp2 = NULL;
- 
+
   Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_SEG), NULL);
   if (Temp == NULL) {
     SHELL_FREE_NON_NULL(RetVal);
@@ -376,13 +372,13 @@ PciRootBridgeIoDumpInformation(
     if (Temp == NULL) {
       SHELL_FREE_NON_NULL(RetVal);
       return NULL;
-    }    
+    }
     Temp2 = CatSPrint(RetVal, Temp, Attributes);
     FreePool(Temp);
     FreePool(RetVal);
     RetVal = Temp2;
     Temp2 = NULL;
-    
+
     Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_SUPPORTS), NULL);
     if (Temp == NULL) {
       SHELL_FREE_NON_NULL(RetVal);
@@ -429,7 +425,7 @@ PciRootBridgeIoDumpInformation(
         Temp2 = NULL;
       }
 
-      Temp2 = CatSPrint(RetVal, 
+      Temp2 = CatSPrint(RetVal,
         L"%H%02x    %016lx  %016lx  %02x%N\r\n",
         Configuration->SpecificFlag,
         Configuration->AddrRangeMin,
@@ -618,23 +614,17 @@ AdapterInformationDumpInformation (
   CHAR16                            *GuidStr;
   CHAR16                            *TempStr;
   CHAR16                            *RetVal;
+  CHAR16                            *TempRetVal;
   VOID                              *InformationBlock;
   UINTN                             InformationBlockSize;
-   
+
   if (!Verbose) {
     return (CatSPrint(NULL, L"AdapterInfo"));
   }
 
   InfoTypesBuffer   = NULL;
   InformationBlock  = NULL;
-  
-  //
-  // Allocate print buffer to store data
-  //
-  RetVal = AllocateZeroPool (PcdGet16(PcdShellPrintBufferSize));
-  if (RetVal == NULL) {
-    return NULL;
-  }
+
 
   Status = gBS->OpenProtocol (
                   (EFI_HANDLE) (TheHandle),
@@ -646,7 +636,6 @@ AdapterInformationDumpInformation (
                   );
 
   if (EFI_ERROR (Status)) {
-    SHELL_FREE_NON_NULL (RetVal);
     return NULL;
   }
 
@@ -655,22 +644,23 @@ AdapterInformationDumpInformation (
   //
   Status = EfiAdptrInfoProtocol->GetSupportedTypes (
                                    EfiAdptrInfoProtocol,
-                                   &InfoTypesBuffer, 
+                                   &InfoTypesBuffer,
                                    &InfoTypesBufferCount
                                    );
+  RetVal = NULL;
   if (EFI_ERROR (Status)) {
     TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GET_SUPP_TYPES_FAILED), NULL);
     if (TempStr != NULL) {
-      RetVal = CatSPrint (RetVal, TempStr, Status);
+      RetVal = CatSPrint (NULL, TempStr, Status);
     } else {
       goto ERROR_EXIT;
-    }  
+    }
   } else {
     TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_SUPP_TYPE_HEADER), NULL);
     if (TempStr == NULL) {
       goto ERROR_EXIT;
     }
-    RetVal = CatSPrint (RetVal, TempStr);
+    RetVal = CatSPrint (NULL, TempStr);
     SHELL_FREE_NON_NULL (TempStr);
 
     for (GuidIndex = 0; GuidIndex < InfoTypesBufferCount; GuidIndex++) {
@@ -678,7 +668,9 @@ AdapterInformationDumpInformation (
       if (TempStr == NULL) {
         goto ERROR_EXIT;
       }
-      RetVal = CatSPrint (RetVal, TempStr, (GuidIndex + 1), InfoTypesBuffer[GuidIndex]);
+      TempRetVal = CatSPrint (RetVal, TempStr, (GuidIndex + 1), InfoTypesBuffer[GuidIndex]);
+      SHELL_FREE_NON_NULL (RetVal);
+      RetVal = TempRetVal;
       SHELL_FREE_NON_NULL (TempStr);
 
       TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GUID_STRING), NULL);
@@ -687,32 +679,42 @@ AdapterInformationDumpInformation (
       }
 
       if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoMediaStateGuid)) {
-        RetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoMediaStateGuid");
+        TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoMediaStateGuid");
+        SHELL_FREE_NON_NULL (RetVal);
+        RetVal = TempRetVal;
       } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoNetworkBootGuid)) {
-        RetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoNetworkBootGuid");
+        TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoNetworkBootGuid");
+        SHELL_FREE_NON_NULL (RetVal);
+        RetVal = TempRetVal;
       } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoSanMacAddressGuid)) {
-        RetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoSanMacAddressGuid");
+        TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoSanMacAddressGuid");
+        SHELL_FREE_NON_NULL (RetVal);
+        RetVal = TempRetVal;
       } else {
 
         GuidStr = GetStringNameFromGuid (&InfoTypesBuffer[GuidIndex], NULL);
-       
+
         if (GuidStr != NULL) {
           if (StrCmp(GuidStr, L"UnknownDevice") == 0) {
-            RetVal = CatSPrint (RetVal, TempStr, L"UnknownInfoType");
-            
+            TempRetVal = CatSPrint (RetVal, TempStr, L"UnknownInfoType");
+            SHELL_FREE_NON_NULL (RetVal);
+            RetVal = TempRetVal;
+
             SHELL_FREE_NON_NULL (TempStr);
             SHELL_FREE_NON_NULL(GuidStr);
             //
             // So that we never have to pass this UnknownInfoType to the parsing function "GetInformation" service of AIP
             //
-            continue; 
+            continue;
           } else {
-            RetVal = CatSPrint (RetVal, TempStr, GuidStr);
+            TempRetVal = CatSPrint (RetVal, TempStr, GuidStr);
+            SHELL_FREE_NON_NULL (RetVal);
+            RetVal = TempRetVal;
             SHELL_FREE_NON_NULL(GuidStr);
           }
         }
       }
-      
+
       SHELL_FREE_NON_NULL (TempStr);
 
       Status = EfiAdptrInfoProtocol->GetInformation (
@@ -727,57 +729,67 @@ AdapterInformationDumpInformation (
         if (TempStr == NULL) {
           goto ERROR_EXIT;
         }
-        RetVal = CatSPrint (RetVal, TempStr, Status);
+        TempRetVal = CatSPrint (RetVal, TempStr, Status);
+        SHELL_FREE_NON_NULL (RetVal);
+        RetVal = TempRetVal;
       } else {
         if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoMediaStateGuid)) {
           TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_MEDIA_STATE), NULL);
           if (TempStr == NULL) {
             goto ERROR_EXIT;
           }
-          RetVal = CatSPrint (
-                     RetVal,
-                     TempStr,
-                     ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState,
-                     ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState
-                     );
+          TempRetVal = CatSPrint (
+                         RetVal,
+                         TempStr,
+                         ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState,
+                         ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState
+                         );
+          SHELL_FREE_NON_NULL (RetVal);
+          RetVal = TempRetVal;
         } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoNetworkBootGuid)) {
           TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_NETWORK_BOOT_INFO), NULL);
           if (TempStr == NULL) {
             goto ERROR_EXIT;
           }
-          RetVal = CatSPrint (
-                     RetVal,
-                     TempStr,
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4BootCapablity,
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6BootCapablity, 
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBootCapablity, 
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->OffloadCapability, 
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiMpioCapability, 
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4Boot, 
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6Boot,
-                     ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBoot
-                     );
-        } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoSanMacAddressGuid) == TRUE) { 
+          TempRetVal = CatSPrint (
+                         RetVal,
+                         TempStr,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4BootCapablity,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6BootCapablity,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBootCapablity,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->OffloadCapability,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiMpioCapability,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4Boot,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6Boot,
+                         ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBoot
+                         );
+          SHELL_FREE_NON_NULL (RetVal);
+          RetVal = TempRetVal;
+        } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoSanMacAddressGuid) == TRUE) {
           TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_SAN_MAC_ADDRESS_INFO), NULL);
           if (TempStr == NULL) {
             goto ERROR_EXIT;
           }
-          RetVal = CatSPrint (
-                     RetVal,
-                     TempStr,
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[0], 
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[1], 
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[2],
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[3], 
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[4], 
-                     ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[5]
-                     );   
+          TempRetVal = CatSPrint (
+                         RetVal,
+                         TempStr,
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[0],
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[1],
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[2],
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[3],
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[4],
+                         ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[5]
+                         );
+          SHELL_FREE_NON_NULL (RetVal);
+          RetVal = TempRetVal;
         } else {
           TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_UNKNOWN_INFO_TYPE), NULL);
           if (TempStr == NULL) {
             goto ERROR_EXIT;
           }
-          RetVal = CatSPrint (RetVal, TempStr, &InfoTypesBuffer[GuidIndex]);
+          TempRetVal = CatSPrint (RetVal, TempStr, &InfoTypesBuffer[GuidIndex]);
+          SHELL_FREE_NON_NULL (RetVal);
+          RetVal = TempRetVal;
         }
       }
       SHELL_FREE_NON_NULL (TempStr);
@@ -821,7 +833,7 @@ STATIC CONST EFI_GUID WinNtSerialPortGuid    = LOCAL_EFI_WIN_NT_SERIAL_PORT_GUID
 #define LOCAL_EFI_ISA_IO_PROTOCOL_GUID \
   { \
   0x7ee2bd44, 0x3da0, 0x11d4, { 0x9a, 0x38, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \
-  } 
+  }
 #define LOCAL_EFI_ISA_ACPI_PROTOCOL_GUID \
   { \
   0x64a892dc, 0x5561, 0x4536, { 0x92, 0xc7, 0x79, 0x9b, 0xfc, 0x18, 0x33, 0x55 } \
@@ -1290,9 +1302,9 @@ GetGuidFromStringName(
 
 /**
   Get best support language for this driver.
-  
-  First base on the user input language  to search, second base on the current 
-  platform used language to search, third get the first language from the 
+
+  First base on the user input language  to search, second base on the current
+  platform used language to search, third get the first language from the
   support language list. The caller need to free the buffer of the best language.
 
   @param[in] SupportedLanguages      The support languages for this driver.
@@ -1690,7 +1702,7 @@ ParseHandleDatabaseByRelationshipWithType (
 
       if (ControllerHandle == NULL) {
         //
-        // ControllerHandle == NULL and DriverBindingHandle != NULL.  
+        // ControllerHandle == NULL and DriverBindingHandle != NULL.
         // Return information on all the controller handles that the driver specified by DriverBindingHandle is managing
         //
         for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {

From b2a2d3c39cc2c589326b0b693ac3297205d518bd Mon Sep 17 00:00:00 2001
From: Cohen Eugene <eugene@hp.com>
Date: Fri, 18 Dec 2015 07:35:47 +0000
Subject: [PATCH 306/525] ShellPkg: fix RVCT warning due to CONST in typecast.

Building the latest shell on RVCT exposed this warning:

ShellPkg\Application\Shell\Shell.c(1090,69): error #191-D: type qualifier is meaningless on cast type

The CONST in the cast was deemed meaningless.  Removing the CONST fixed the warning.

(Sync patch r18954 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Cohen Eugene <eugene@hp.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19404 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 8af66479a3b4..36063227a2d8 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1087,7 +1087,7 @@ DoStartupScript(
     }
     Status = RunShellCommand(FileStringPath, &CalleeStatus);
     if (ShellInfoObject.ShellInitSettings.BitUnion.Bits.Exit == TRUE) {
-      ShellCommandRegisterExit(gEfiShellProtocol->BatchIsActive(), (CONST UINT64)CalleeStatus);
+      ShellCommandRegisterExit(gEfiShellProtocol->BatchIsActive(), (UINT64)CalleeStatus);
     }
     FreePool(FileStringPath);
     return (Status);

From 322afa48f37a70db8c26a5c9561801861ad5d22f Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:36:16 +0000
Subject: [PATCH 307/525] ShellPkg: Add NULL check to pointer returned from
 'AllocateZeroPool'.

When CustomCumulativeToken is not NULL, the CustomCumulativeData is expected non-NULL.
Add 'ASSERT' statement to ensure this.

(Sync patch r18956 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19405 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiDpLib/Dp.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiDpLib/Dp.c b/ShellPkg/Library/UefiDpLib/Dp.c
index 4d109d037c1b..6b06d20749f2 100644
--- a/ShellPkg/Library/UefiDpLib/Dp.c
+++ b/ShellPkg/Library/UefiDpLib/Dp.c
@@ -13,7 +13,7 @@
   Dp uses this information to group records in different ways.  It also uses
   timer information to calculate elapsed time for each measurement.
  
-  Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.
   (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -256,6 +256,7 @@ ShellCommandRunDp (
   CustomCumulativeToken = ShellCommandLineGetValue (ParamPackage, L"-c");
   if (CustomCumulativeToken != NULL) {
     CustomCumulativeData = AllocateZeroPool (sizeof (PERF_CUM_DATA));
+    ASSERT (CustomCumulativeData != NULL);
     CustomCumulativeData->MinDur = 0;
     CustomCumulativeData->MaxDur = 0;
     CustomCumulativeData->Count  = 0;

From adec21510c8b70a78435c82d248594ee8a4d0e06 Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Fri, 18 Dec 2015 07:37:57 +0000
Subject: [PATCH 308/525] ShellPkg: Convert all .uni files to utf-8

To convert these files I ran:

$ python3 BaseTools/Scripts/ConvertUni.py ShellPkg

(Sync patch r19176 from main trunk.)

Cc: Jaben Carsey <jaben.carsey@intel.com>
Cc: Shumin Qiu <shumin.qiu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19406 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.uni          | Bin 4840 -> 2419 bytes
 ShellPkg/Library/UefiDpLib/UefiDpLib.uni      | Bin 18146 -> 9072 bytes
 .../UefiHandleParsingLib.uni                  | Bin 32404 -> 16201 bytes
 .../UefiShellBcfgCommandLib.uni               | Bin 18414 -> 9206 bytes
 .../Edit/TextEditStrings.uni                  | Bin 11484 -> 5741 bytes
 .../HexEdit/HexeditStrings.uni                | Bin 13156 -> 6577 bytes
 .../SmbiosView/SmbiosViewStrings.uni          | Bin 109944 -> 54971 bytes
 .../UefiShellDebug1CommandsLib.uni            | Bin 139228 -> 140676 bytes
 .../UefiShellDriver1CommandsLib.uni           | Bin 70806 -> 35402 bytes
 .../UefiShellLevel1CommandsLib.uni            | Bin 43930 -> 21964 bytes
 .../UefiShellLevel2CommandsLib.uni            | Bin 109742 -> 54870 bytes
 .../UefiShellLevel3CommandsLib.uni            | Bin 44956 -> 22477 bytes
 .../UefiShellNetwork1CommandsLib.uni          | Bin 21094 -> 10546 bytes
 .../UefiShellTftpCommandLib.uni               | Bin 9952 -> 4975 bytes
 14 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Application/Shell/Shell.uni b/ShellPkg/Application/Shell/Shell.uni
index 25cf69966b733e7b2488413361cfab98c2249bfd..301d8797ff460a944de3123c34d6edbdd423112b 100644
GIT binary patch
literal 2419
zcmai0{cj>S5dFPU|A!ILD#;xzG}TFM)Sk3}6ILaL?8n_zItiIw16CIA%J!0^>L1^+
z`3MPnDN+bwXWl%&nR!mP3m-my{Q0MD*Z#o8;1UL9^{m8lW#Fp!%dZ`L`vfEYSa4%H
zQ<gn2mBWy4cu`hsE)B-7D<+@YF!rbZAN}aFLwZ5E$Sx77_d9ef;HNf(((nS)R8=Zw
zL@9j;iUM3s4T@{7Haz#?fR(I-hDw!7#n!-N4raxHW!bi{kV{xI!<Ar#cD0$}P>766
z&2tyOW;rHom?+r1;84q)D+hvEYwbd^Qs%;v(NHejvwl2;@fO9QKCVQzI+PV$V-)hr
zg*Hme>+L}jWVWdBG=@K!J<^T~vV4X)J};2~Fyl~H##GncZdoDQvQ`=QOSSCoGIV#Y
z^Um%Mzgkr`#ib=90@G-68wGa|#xM-yBnta!LWYpiA&I~SxD$i}LSq6G3IT;y5My`?
z`avAVZHM$VOh%J5fv-Un1vCjs43h{VGL1+~Xc8phgyL5>nEp5X71CiF2&P~O^3BG$
z@bGRr4$06z@VhJX8kMGO&94t%#w%VFF{&k(+OMTJJP78fA<N8BsEdM}FNEB+Wl?T>
zwq`;?N^U}McyQ(SfK?T$<c8@08u5+L*iaZ@hf4MQ0^aF-Kov3Y&ole$tYC79l>mUt
zP8vgt$Ymk)s^y;A_Tq@4z_WNn#^c!_jfP=_(MK<bQL`oALwLl~-#>##5#;O$;+D`E
zHm*M=cSq^=;|YYFC8n0O+p=@7?`e;o1CE@KS*aAyjQ?GImv0JeIlA}%E8r2Q;Ev^M
zo;#Q%h>~<VyH81M2ceOtN2j>78oUvS2OdRw;N_sXT`63W67++pz$4l)W$Mb8dWBKg
zO>_+?ahDZ5@Mjx{8AiyO`#(?~=aEFSWHK8}XtF!qiEMj1F8CPr+9Qox-KSx4jQH*$
zPf+ba&hO7*t~h(xmS|FvPLkQp1b6eODGk)m?cD6zEK7rKn3YQ@{;@`8jS9s@&yuXL
zWzk}`pV0}|=!<PY8&S^Uc5aE^DA1V_m4SsQ_<mrT7!IQG%@H~G@r2=S;F|JD6rpjv
ze!b0ymPhfvuw;QKh2&zxOs%iMQ|~~B^h+=fhqJq2It}S<Gc{E0Xh*Dg3^uF~Ir?r@
z;R^2$f4q*{G2i3I=wd&dt59yyYR#>&SEAx@;r0LZ=;a={NtQi!L|#nett_onx~}00
zD4q+u+OOJm${5jbmV(*4s1eWcreSzT?@_HC>WXJ#A@GK6RQwBW7~TidG(ovTy7jzf
z#hnRzdgsF%FZaE?!I4f7)2Y2Ja8^!qK+imNw72=L>^qDck=|8~-O+96J$b#~o-P~D
zy6rxl%<!D#+wth0Fry{JVqFzH!L18rRU7gIkGPZWHuqtWMB~n!+5b2e97h@*5zU)}
Mox@t&?(XIO4^T7HdjJ3c

literal 4840
zcmcJTdruoz5XI;3O8pKi5F(_(kW`Uc)K&sws8wR9A89L9Lgr;Gz_z>wLe<aS_IK{=
zWp^DL8>Gr&ckg58o_prZ+*$tpXTvruvDfwuzpw2pS{sk|#9rC1tuel90~^|djjU%~
zyR<QV?`+fF+PAizJ-w&zXFIohyXHFPw{Az)u~WO^I<hmyKQMB~-*vEe!&5)llKmT2
z=+J(!H_SY+3U62J2iviR{Zzm-4a+N55l&&+wC{OZ&suNoeXv&xD`{ol&4|?opz5%G
zkEcFsCAQ7DX5{-!L+jj9u#N)uvoP~ZTrGI%F)zXL2#eid{f4%7rQMI2aUR;I;4SXB
z$BZr`Hvx}U>hW}qwdfOB8HKm689NQk36tzb`+EB<Tj7r99u_)w!d0u@1{AWLBN;O?
zVpXAzR)kD=dymX$bYK^S_jas_FXg2omK^JS;Nq04?3Q=iV@+8U8_t*3N@;7?C*Ul4
zM63$^1^w<DVgAgVNlay4oXZDhon-G1G6sZbT;Nq|9^<pEpnd6Fs!ZAOEr`T)h366e
z*#JRtzbQQ@%sfMF<&g?jF8Pa$#Cu{bVx$VHBUF88`&_r}BkdZDDn4{?(OX0JZJw%u
z=eE_kSLx3!<UXhopH*fwgXKe>q-0%}xXZ4rE^*%pZMEJ!VoU5d#)a!Jtf=-jD+yVh
z{u)+g<1nn=pe5|;)0!=2X^vL)S$oXYn}2Zsg%KfFL|3y_d>2*w{n1Wty#^OYs7h;o
zfcMB-yeEtg;9FXdD(d)BS!8R<%w|xIG}FYt(w1T@#i}BqH|34(;7!eyX2&zE=C+a$
zZ5P3EIa)4)V)8gsWNQ5chO4&6{t{40*{<n#pxUIbgJy=Amh#LLcOUNw{40+tYCLx-
z^Lh+PsSi_;ucOk}S$20zKiYC&L9Jz0RR-v0drCl)uu7k|+QG9+AlJB*o`QX;@NSG=
z&tk6NW8RY15BMFU&^D;0Z)te;FUN5Uo-PO`QLJEd1q6R`DkMDBGbGFO6@3#?>@&X(
z0*|;I&{RXj&Bl-v*qDVP<|Sq2E{e*}vQ;qc1cbu23P$mzYadm~Kg#3MSA{){`0LNv
zL6OJ&`6>L1>_9x`8Z2|^ikQx4jzAt({5QC^;rG~n4f<BEXM~7x5wF&<AZF6Q)=JP$
z6WxeKXHVYNd8czPo>F3V46EwBg5x1i+L^G+H)DJ=glT2;%gmO1;OCvrhXHdGiR!!J
zu0FTuYv?rUV@2n{^E5BrDT6m)rbUKS6ev%&SfTiPK0CSPSy;CM3yybIWE4Fq&*>DH
zg)!p&Kd{ONVt*C=C|*uzo#VYL@|b-2Jl5-QtbOcp_j5C1FW(p2iK5x_O*xwTK{u)t
zU5i~b(zCy4c||5&DxbP?z0T^>qw3Ok>s5?&7yG5R8-8Ai>CE(MMCVbg;>xw9&k=Vi
z5ur0~h;~&isrHj%%Nb_TxZXvx2QXM>?90}C4qvvuVn+2*V-A9O>#G8i-*!vPsuoce
zc0V*>OlR#a9B#4R3L`H=ty<?3`B3%C2Nd{`=OcdV-!JTB9%{!t>l}&7>tIn;zRqK5
zPP$R`;C0TV=NHKVllYrp*Iu5VuWD$zh)vw;B=@ffVN{i^?@OJPe+M6}y;!Z2xK*7_
zt2E~G-VU)CW6e(iMYz6DJkp<vu0=R@Y@V04(a6iOHUcjHs#C@gvPrD5I!puKr|d$R
zLHn81$5WZ%6MX6n^Y4Qrva0f{)Gg+VbzYt!7U4Qp!m8%V_3#~v5Jp|gu{ew4`50B9
z#BU4FEAugWow-PjHgEmB?td9aIU}3=mqYQc*h#~e)h6G=D||nE$9-*ruc!Q4JpXlS
z9%ug4w^@#|{4}4lI#Dif_Q**3mN`c)e%2`~49T-&^z@lI_hc-2USCVD;|i@^=IiuX
j=giZ%)T%kE2$ZFzaX(%4lwea8oc_O&GQ(qcQr-UnIPBGU

diff --git a/ShellPkg/Library/UefiDpLib/UefiDpLib.uni b/ShellPkg/Library/UefiDpLib/UefiDpLib.uni
index 5bcb4964523aa7839694bc430f57ad27e8f63047..b09227451078e8f596cd457fe99fd047037f077d 100644
GIT binary patch
literal 9072
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
E2MdYQRR910

literal 18146
zcmd^{drzFl6~^c9O8pKiA|xjb_?A?y)ilB^wox#wSZud-td#-V*#?Zuf*n`=>}{Xl
zoIT9Ew`E>%s;JScW#8MLdFI^b%nbke_swuK48j-TcRGF>exs|K7vF<$Bdmwd^?W^?
zgm>X%I1SVACj1c2bni~M6>f*G!pi*YYu$SkUWE_gNPo|Ctb|c`84kja`g<A<^?ax&
z@AWx~^p17*HqwIrv08Yk>yP0}y}1=u_3PE}r*J>)hCgSR+OXVEE8qmvt?);kt<0}(
zhr5y9W^9R;tv9D??L??vs{N_X-m0xZSkrUfNd26}t5;zrtfvwCVJoW3Io0IPpuwMw
zIZDuhfmXY@wx!=U`Liea@XJA@aUyxq%VS-`U8HcPH=v7b4l10V>Ww#gavb?WkEc32
z5;fNiesvmueWYgxI(r*YLf7f@>%(~q?{z*Eg_mJpe`)nRqJVZna;7JzY8BK@1!Ulz
zUPy?iC*gJWyZd1*okCl3ED7s}$cqF0ZT5DmHlYYNj9;`h(>1-`7tUNW1_8c;|Fxc&
zmVo*vy;Vn5<&1Ijqu$z||Ndmo12COsoW-urB(;0d3b8ojF7Ka4UazYEr;^Z3A;^0?
z)17@`Ka}2ApR9_?5BemYq_aKQ>xOWRWMMnuq5iIg$GYAWSJ67Y_jGqtHuywm8<E#f
z!nVFQbRV7=g(Qbf`HBs_F^-gXbcR*&cS+ySh3b;N@5gJdzRb`)({rfq#1;qPncmus
z$hLKVQ&gd`6I<Wa71+5)n|pefcWBk#dZ2e{{jd7|PESCNciEV?V!hZ1f4QKOsBelF
zBWV_G4rTMsxBB-$@12PAXa)MQEve$!?lpcf&{O#OPUuX_u(p|KV-wSs_t&CSc^6wf
z>!g{}8${cCEqc&&9iFM>*HL?t)s3S@n=T&;)nM)ouwN{%+0$M1>%FMX^uapu_+~Tc
z<;PZhE7Hj?=268ceiJ^6w7L3BT%)x&bJWHo^nOJefHaoGf1ab)Ga+8ee(Tn1Udyy~
zA`XwjM86*C*X2h-axO$~qAYV9Ac3Z}|Cz8P84iRLOYydc(!poagwoba+IE^{?PF`$
zCLFx{C}|%#{&J7+r6VPr!BebXc!^2m(V8^IJVBFFC7hw{Z*)8tr<bJ{gYY6=bI*@b
zeE6uR@>%$uq4Wvw_i%v(OYo8V5QniKi_^rA^XR3>zitTg=b;qgqv%nGLWp)vBIk%7
z#Dlh@1mTvv$$=0OQHhG?lYY<{eh9w`SIH4h=RS=5Zdq5QsFAOsoQT83IU-;8QG)u3
z(EX^-iE>_i;i2$MV~$8}^H%7I10`BXeBBgBkvQ?}sjkNQSp00FEI|in@PtI#bKyFQ
zvVR)6=>Gd&jRVViXH|SXEavNXvY@}!s5J4WJ0-}+iX?c~SK=Sp339jCWs!-jliXt(
z`3tWf=#5w5AL=I_`yfUlYjaug{tvO|H<ST93jge(>EsgV34Yyjq*1&|c}VIPXFpHh
z$b-ob&Y}&Ne|fF`GGZENwDXhXwWYtr^^?k-QrmbMdv#yhhIgEZvyY+{5<zyNR`&1b
zV@cwr5R<tgN91BXFl)x1$-J>}Ecr{dgKs*PR1aeB82k7bfVX|zfxVG)TekjAdi_%J
zex>WxVy&%5fsuMj#O#WfC6awC9Df%!^l=n>Mh|91_HTI5GRINnc>Ssb55F<GIUe#)
zWRk|cRUd#ZxxJhVeR*6+*eCKhL$$pp?WrSA*QI?(zu?R$C+o*H$cyc*96h5+Y69fJ
z2hx&rX$V?kcM_#KKT548@9$9lo6(bxKB}1Qs-(Zm;cH2zOkT~tmLf+kjFq-z>z@kw
zUbIRgceU?z?siM66n))xhvNLEA|`%%Tx%UHC43*sB0O^AYxd<)7~7=$qa=#wnbBl!
zd)L(nayRt$r@4;jn5vv^Ugf<?<I?7P`5h{Bv*>}R8WH;F(ckcxdqdXL$2U|tLw?&X
zD{rSnX4uN%oGZ^2LGFr2FXr;+>i0tE^p;hryj{6AFITE_Rs2;AymQftw^pWeRmqmi
zwXamWC0duJ<7eb?HO{zX+jwHs`$@Jc*IcT(M3W~pohZd#l_SxYy3pfRF9P}!>`tRB
z?)%#%-l7yiRj-I8Cou+EjddVTiI*l*c6qmbLxmh14`})J!#GBv+S+{(1%4D|aymQe
zI#w#1#2MEqr`Y~oBAeV}Sl*0Rpzg)7tTC~jdE4HS>sNp5RSoO1iW2Nqsa{2<{UutJ
zW?hoboj%^eIXj6p4q`wTPmFpAXOdLwGBt^Mn^1H~az^whm1tFt6IEoWH<NLYML8$Z
zcM0x?(M}lKVvi;H#Y45V6YJ(=ZdFXF?Q~XxBI#B7-Q{Oq<G%dO`WxNRh&SsxRw|z=
zXD;^`C7f}+T9%G}o#hVb&fRNe6IHZTIkwqD3EKaa9J}RLmz_(#kAJ9g#^u<?6Qf?j
znWh|b`F$#nu&(I%Sf8!=D3I}pbAay>r0a^x$NEswIGc}0O8i1w+sQvnq^miSGAuVP
zY>_N_8Y6nWHnSSX*G{_)y**o-*F=3*#ec#46ZH}@6LJl|Pc@hs9lKlV11{r2U5iR2
zVu-rE-MWxkZO*Yb>nr}GJ`(PG|GIpz+0o_*xr7gvZBv=xSe{piES}z04U(!#=~Zbz
zs(ulD_W51Tm}jo`rKBI@n9*We=o^*BvOL|}X1-%PS~|0RYjLjI<(Pk$V6pWCwwB_9
zbluLVy;BA4s-BXOTZYX%wylOps~qn2$Y@+2yhqGDtt-E<S?>+;IQL*BJxaB9uhrr=
zsNu4<hq^D8-ls}i$CzqvRoNTwuZEF11+UvuXQAqx)_$;xhAOqya<79uuOT$i_rne%
z)=@Fbgs)tQTDcW-QJ$q)Gql8X%4LH7^5%8=;yHD*A4sBKUmTayWIaT=kEm-%o<TIx
zT@4wL=&e4MsdroFb#UAK(gXQ5=2dfFa&?Zfh71qE+#i<6_!cjNMY0~RAE&GH=8N%`
z>A+Z6e9jJUY}MmYh8hjutspMRhw71oF<RRw&AD8n742B}gq4*!SHo$z(i()_hTI*Y
zeV5?Ga@xlN<rPL+tFCFP;#hQ5tr_s<o+L{=>svE+?)WHRQL8*F;Z7P0+?DoQz2KIz
z8EQbOx=6OebIWL$4J-9Wj(Mouz}Mf@^Uk~<C76G?Yi{bu`f`c&Nvyru{RCB@U%uYE
z-204&U7y?r7U|N@Z39@tb!ukh%g^Kuy7J}{TQC~<6!*JVi3didJA(B=QjJz6XsmT+
zUXzb--DvwRK~uNHU&nQ+zj2Pc6}53WzgNO>k0e;dZOt`qX$^7rIZvn=+6dau`{Gaj
zGDq7yFTvmKFRSz3b?P>Pre<UNDC*S@-rtDhkM8Gnns(jH9NOP&znkYPefgSO;vx@Q
z!q;Di<t^%EU+%kAF5)~gFX8^Du*$x1&b>>r&c!_`>Bs-Gb++4Y{cfKuX>sMMPPt5z
z*r&pZf7_!#wU8A;ZTk$mYi7-sxl<y4`{m-+$qm^n!%l~7t!>>_?e6kD2PLgn*EJi8
zMSNg36dYIpd(vzdM6>sowY@aw_mV0=tU+asCnK|4Q4&M(e-`VAtoNiY*S;>8v8GAO
zs=MDya>*w_n~@pop==d+{du(=MuBB5`Fd6&qt~?18)_~2x<l|C$Gab6rK=s?SbLU`
z=tyW;3*JOIQajI8`P+}Ho;Z7dab_!_xCj1!>9eBV`q}QqdwUmWql+`}+in5Yh_Ipx
zI;`lRZe;P^?;gab^wDb4FZ4cdPcMGQ&O2-WTivVo!ev1}eWhHpuY<<#&@Fmi)iL%2
zG^J<zlx$v&Dw9>Bk*du{%{r*RFQU#)M^++3nU<`Eg{Md>*8N$%_tpzmZs!NRU{ql{
zWqs8&ZRFZ-m4Djd345{*B^ztKd-lM0fKlPD&ona2XKU`eID#(aM?1e+^L?xX8^BK6
zdBNPpTh%2$c5okU&5!oB=<ku<>+UhFV~>Ma1H~TOrLbFR&GrvBb*Z#HMyDS{G1r0i
zcK3?f#h-bdvAeH}If}o?k9LmcHDjupS8WY1LT0z6=tMo6)~KP{9)P+wvl9S~XMf*`
zB*h#UUZqN-KL1RAsbaTt7P%9fiH>j?1Y6QZsC1#A#r!u`HwTx`fv?Rq&gNLCPMf6h
z=!dZf?P#W=kRR>b$BJ#I#5C6JiE!=o4n&Q0+~0}2+d6O3!^6STl}OX}gIXMN?05l-
zP{*Rs?h_8xKjs`0ib2eYmMXo;d*<G&*=~CaDSCL^WEQg;6|3~~tJ{j9$n``R4;3l#
zJIvSgp>ZeD7{`7xvb`FWyOGLJ>$C1j)8QGk`r!DgLg8HUv;R@hMP(&?Ta!Xl3(#EK
z1;+06BT?+~$aS83Y-VrdSXRL*`xK??Z#QE!*$Z>X;|?B}<eEOVYrhwsDCKpZHrry)
z-JU$fu52lJt&&V6|7Gs2x_WK10?bFTqTz}7%6|E=j$EtrbN{~swgcSvU4M{%A=~=w
zI-b*>VEZ<^hK*zS%uhD$Do128n`l3s`ORS~Do508fvBGE8gP`pXN!1923dloz7uw&
zXu?>V9eL=LMeH3>BTiNSF9f;WOh=w~bB`!$dW2_%e~yqm!RAHj6?^T;O{x*xxJX;4
zdg4(e<;sbg?MiY~`xm{o8P~-!AYP#vBOUCj_5Zt&>jb_({SOb%FS{k5kimU2wB%dL
zG{gQM!$gQ4NOSFfE^u#muD^!PP{F~}BAlhg*D<0Uh;J6*;4N?RE}5<8H=d)O&3jnY
QGS3U_e`z$ezpmr|1r4*+QUCw|

diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
index d8e45d049638a4956ee09e51574bcdae0376f411..1d142e9c9801b3fbe9ded9e773572cbfdde96de3 100644
GIT binary patch
literal 16201
zcmcIrZI9bF68?U`{Rbk&USF=+%}ZMpL0dqUWLt<W3zoc_;(8FYw$>{|mJCTwcJJ5U
zGo&O-B>i$1$3SAQ&3WeGa5x-tsGA#h^TQ8+|J%(C{bS#m-!n7cJ{QUQv0`sty?*-=
z|NYFy@#i$Is+V50{1_E0X2qZ4G~aIGtU~+EHp-rVWRq*}`nSRS5011)`EL0=A-!TR
z>FwtqnUhs<3bA6F7g3eu*)=oLlyRLUE8;RPKE<nR)?x*ZNy)ZFzAmB-i?S7~9%B|Q
zmqKxpt=T53;v$LClIxC&n5D@w&dPYj+i#*31U^Mc8r`Qc+hwb`;2@CNl)T9@&sGVM
zDOvu&e;fD~n+Oz+`uQ<gKDKI;xI`=PS|w#wB=<YfkpRpdcIZtNKUED<%>^u<**$*G
zL4ZXSM}4fS?Yo<sd<(Yuu2{y`d9l8!CCZ!oa`m$Q<9hqJB@r$bjBV!4XQR0>Wsc7*
z#}DStU=i3BTey}zXVifAz%gytx7o~PhRa?UKAOK^1H*UxA34&U6O3nzfZZAMx#0$m
z?X%gO&24XP`?ebxfirXQ)ez!;viFW_{m5*HK!yE*+VJMi)SEcAb=~rt=Bphn?M9pU
zUHj!Cen`d`zcluuqQtmOlKbmjmb49wd)P8sR;@_;%MU-G-}vkIZ|LotG|JYi_<=DN
zXD=5%dl6^rG$|in@J7N!UXfS%GEZ3s5+&P_Gi;)d<SyhtqlII!-(LQ~IkNlY<ti!S
zC5>W~!h1?SJOYm0M`f}snX`%3K>7!{KOBR3QS}HiH2wg^2!xZFVcAybOpTEZa`lVT
z-9fftJIUdYD-H+7T>#6z#ejvL5sVvYyej~L0O^<Hxn@~hmFKDtf^<lPi@=!(CPzpt
zswBnaiA#x17by4;95TnANRS7ZH%Cy0EzA)*!y@0D!12t+yhm_6)5yx?2%FpB^{ZDL
z=m-jLbPB{Hlv5!8Jc_aihQFRfp+-QVdBv<E`4krjnLP)bJGb^c9AKh5?uhqI%Z$qo
z5(Ld`Ez$BOMlhVsr{N4pbH@@hLFt^AM%6=JY-S))B&%3L87%xh0Oz8h40ffzjhD$o
zvK0L}0B4DQS&q?m>TtiTBwA;ASz*#ktU54n8sq2&j+>_g^G1(jx_b~E9a>xS467^!
z(nAm(A{r_^2$=>ARcOs`Lvz?Mi(=$vsH$Ap*vzwsWW5usx1JV;-p9((bWed4K)3Ke
zL|i~{j|6U+r*YpSG2=t01v&`mC!1{=)3kR8uj|tSA+$d<!u(yK)J3qLG#Io@_FqRZ
zW;;2K`OY--W{w+R?cBc(KzMnAG^vnS7z6(t2&|)dx~pP6h;PpwV-h;EJqdhLdGL(N
znMo9oa(H9M#N=EAUTY9VdQ?PPBupjDuvIK!TaFbXXE7;4AY~CR1%sMdNx94sA>x(9
zgJT$GfN<66hZe)Yvi?b)K3u*Rp$JARe;}loGxr?Ftesl%N)kWAqiS)DI|WvV_}b~b
zwgY~(vJ3JfKEtN*DvA2DgL0N|=uEn1)EI(tmSK|0W^AR8N1;Yq4nUX_-o)nWL;p{|
z?u;@DVrr6l|GBK<jpPf&9z!ua;n5`TWDmJc8p`_!3WvRR4Mt#iV9?jEF=7yHV`WBR
zBD_CC7Bk`FA=#esHF|}tZ2ZAQqgR~*gEU{Nnip*b)%8HdYKtsc=BwDuQ!Mu))OSPk
z!j!0Uu#+fqPYlcO5LWvmsP@EIMOy^bdi?l=@Jy#a9q`3`pbUq?h??bjH9+RFR)-Y7
zDiE4sK{Gz0oQZGx5*7L;^iHoiXy!#_89Wv{$+bDcX}6?iifh%{v21o3D2A|~su=s}
z6*cd$;9W}S%f5LL^nIu6G5P`Ll1_$AMO5WQo&9jkg+J&c;)`=^jb=(0Np!6EvC>5}
z8zUP;B(4giClpM3KFm>MKR$s17;<9XB`dz)t^1gkJy?uFf8lwv`QH2rCYSVgTb!iG
z*@i&qiNn--1W$;|6wKLF?C?9|r2(LG7@XQrs@z8~OwS1eW6)n(6a-_rO#(WYQ2^|L
zi7AbV4I2BbNdZ7JI#VjZLZnRGs%~6;&Wn$IO1{f?TAdEjM+H%=H#LGZ+^(bguLhzP
z=ENSNW$dhw#$%hJxDW8cx348eDy74CZ(mCcy$^OcIPKPGHi$}uW@Yb10OsH%B{Vam
zG`+{6pu}K+Gb#0@m>JC^!Kv$o{%OtAD8q5es<w%b14Eq0=y#()RGFye?IVI!-*1fh
zS-jBfC>i{I4jD9)>|%{g@AfCzG>So~*{7e5QV>Woivvg!i$F(0wI!OJAi;rT4hMiF
z4vxkSn(619qChwb1C;{d=os`i%!H#@kR-8WV559MzQ1A|k(aZbg{8BB0)S>GhJgbq
zM$iLEotOs0KxLtb@@6Mk)KC(SLr~zs!@D0ZcSTY?_vh)@@W=8j(TvSFDj$!|62g%P
z>Bg9FB*PesU@YaKI!R-PLuf1rOP&>XGt#jmrA+uD9M0T*8o-Gu_Cd2DG8Bmp2~%xg
zf0jqmI$@t5V{62v)9eG{y3=e@ZW+h`3{)W6mrl7ARS{0v<=rI#V4pm6M&W$FSJnZD
znKsW+hfxkBJ1B<Pu8W6JjO9|KGu<qYK=`TVU_QIU5sH|-I*=g_H3vohx$LBP{$re`
zeOL9z_GE&idX#V|xv3XS1&~XkUV;NaBscPTBnN3N+kDW2NJA_1TYtL7)M<^PdIr~T
zJ)?+{EOC~&LH!0m{jS(UCmc;?1Dq<|8aP}M8K1%e%|>Z{AEmbuigiuGhm&YGc>9LM
zo1NGq_Ob6A*A2p8yl~$)-NU<reV1fz5IpWOITaD|^|@`k71GO#LrG<uARy{vvo@pF
zLm;Z44yjG3(F1pO=Z2yx(sV|FS!5rx{BtIXBHYxl&?-i9i&%jg77C%ft|cAZi{a$i
z^3X7w>87Cb;cSyqtxMSMZ9|T~>oM%?Q&Qv^m4FYS^cJ|2DDo;-`==L9jZV^}huK$<
zrqNbQ$Cx;%eePd+93xF4d5YCVtk!h|h9WO0D87SCXRoyVq)4NgM0+tZa58V)wKDvJ
zB8X;I5q;JOON1e=6IKY@{#k@Em&H*WLQ};H=MsgH7liI$-lwlpn8fR7`8*xWCGmQ~
zis0XZC_Om49wC5Qk30uRc1XuJ&N*m6GsUPRO1t5<Bm9Fx0?nwEWD0rZ5g>{%nsrtl
z6{D|PPXHLIpjh@yV=@^SrU=41<(;iyKY~;F1&eoREv8;LwoxG`uTUTuGgd1)M|j7s
zuEtj%uC8!pp`yDL?CRB<r@xB7bakB;c;dJs=xKnjmW*w%&1F}scer?x;+@U&&v>g*
z`-E%X8ydY5rh+ScZ-|94eLhek@XV&T(Y3yU<SpguMqqa8ajmQ(7%b(@1v!g{VZsH3
zaDrPQLRJwRCkemHvyLaY>VPrtTfp&tQL|`u$eisjN3&?awA}X}6f%I3ypHrsQy=m=
zLG2EU?<kZWDB{!Vp*qn6fwbo?J{>@kIzc;ag@oD(>v4I41P78i8~~CyV27ttP(>H3
z6BGzXVW7v67+_^Phe2@42!wM61HzFQ+)fNv^(JKuZ*i$e>rHky|7a;F^0tzBKroz+
zrl&S;5EQ3Rnp_H-Y~|EPGZBW>_V}p};k4A-4@w^hN3x!SgD=~Z?WagOTWrX+=Cd>#
zX-yYIG#$rLs$6Qa>>;jHjri@Vmb>bFR{VgQB=x;2DmY3#Ss;TC&3(ODKq)<0VBcl}
zhIZ#ss>7JNqkdka#Smj!NC4OkBR=~+b~N)v+ZhGGsG?3WrMnLu-f4VFHO4S0HlJ}3
z@}OslacvpY9~2^dT%|q;(KeSlDk>*Y@2A}?yiu>HeZP^@a8ay0sZ<mzb6KtL@3**(
zQjHV(C^q3>xj9?f?{~W+upl3jiKrvc_ah=Ct+5sk*>S9c!y;!NA{0xYZh&b;g(sAZ
zs3Il}hNvE&tbOweu&90aX^46!&&|C3OjT%bqaoMFtPoc?udk7(jjx`rTuo-y0rl-R
zlhK3v@tWTw{^puq=YbkQYcV~jNE~qmraT|CuC|eX>Ot#58;3lXDXy_K{-y_I)Z!hJ
zMzv$WsXaY`KrN0TbasLVI8cjY2!RtcMZ5zD!Sgm|Y?wxC#;B^)P!{i#WRq0AuW&yo
zs~xBJ{aJs!5Uqa4i?RLx^r?A?@0-8qU3}9f{PJ|1;HZ)|C{v?**-YQtIqv_`y*2VJ
z?g&@oS5H^3etp88<qJEdOff#kz8F^Q)p?b*VT`H!#jxVgqZ1G=!<Mev(B)=sUJ419
zft_vn1%E&JPkc!uP^wWwx3J}x+m;`w(^TSCxR?<*Y;A(tcdsTFa0MzOQxNEm*#)dX
zg@LaCyU0?En&8@4p<{&p5;>ZAn%JNZ4b$j};o*nc3>{-!DnOV!<hXe3rmKWI$E6eu
zsnoy*y9Z>`Jd~poje^Om*S~bkbXKtLH4>4#r=mL@(T5AEAoJi!qlcWezJBRm5PE?p
zkFXGYVbEu+z6jkoWXI$eSydRD<H412UVL2z=*8Dl;3ZFZY>bXLqe^HIG4TRHhA|Fa
zvK!_vqYRIIWpU&37qY)#PcHMtzCwe!nnvZv*47v1%Gjug<E*3N;tB@o4qMZG7qklG
z6m4V&{7PIH{OQ?#I5cqWcYnUB#N$QApZ2SAwvH=Sid%9hpjB9<N<587Sw*p5r@LD`
z+6r(j`}68f7*jMcR&Nb}-iZo~7A_oT*CXClKu@2A?qWLVJqyt2&?vx|?2^^Li1P}Z
z|BZD0N<RDLplY$dMpZ${1cR&2{OK{Y1G-TyTlpXu|DkX4WFH`pn|q4O_y(>i7(r9F
zY%D?VDsg<tFS7d;Dxw|NAuR_+)U|`V+5CMtn9XR%ed?+>wqsoi|J!H2$R&QcOq}hf
zp9Z)lY(`u7B5teDu+>BOf5(A_Os!^FlA2$>u9~5l$9)Z)#ie^Qdw8I{jGK!dDSQ@v
zy|kLdhta0nB=0NwDry=RXhw}T+F#KHzMh)K1@;>FC#5&tAmZcXeQKDYVOjL3ur%?s
z6Wfol@GN_!Kve%;QVCG^A7Y^{zBYF)cnG8AqQ_dRm>%8!wiCT6cz;{Rtu?7ZX7FuA
S4{+lqMxL!RY$Nye!~X)pPorD_

literal 32404
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

diff --git a/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.uni b/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.uni
index d34f314f50c4b1074a87662b679fb1750682859a..b680a48f508d4938f9697e7c9df2abb189e4ef7b 100644
GIT binary patch
literal 9206
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
F`wva#vRVKD

literal 18414
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
SZE3j2Eqd(wr8Y-cng1WBXS7!U

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/Edit/TextEditStrings.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/Edit/TextEditStrings.uni
index a61cae33d3f32312741b0505e85395fd51903b98..f79914813553d612b17ee35fbdeccdace41597d7 100644
GIT binary patch
literal 5741
zcmbtYZExE)5dNG2`wxc{0k*7;<FrZIVjCdaR3gNdJ-sw7P{3eh+7>2Df?kqlzkWx`
zl%h(ZoW?-H7u`M2-SH$I+3!RD`1sdf`hETfqbPn%{PiY--@M=9?DX^;de{sGZ@~yN
z7N9^9M+wdRC_Diz2tY`ukg${`_iTCc=g|6FKsg&fg*b`U3Ect>mym53P|u6DF%2L6
za1C3UvBalAD&%RxAn-jFrfezXw{(dL_tX#QUBDm@mn;z=sI^Unh!=%RpWBi`v=YyT
z_82Awia>qX_}-?Z^;wEiXxGwDv&6s43qKsRY?Y%k8T+0|q@68j<s;nT^9T(9nhDfR
zmc^g?{U}Cjqdf80NtCSnJB_q|mo9s|!AZP{xr$J8t_jSo*_EYD!LVU$*p6ikU5AXp
zHOIsPE+9NGM#QuU%uLWsIMi$uKZK!X8}?g)bZa=*GuMGz&9XGpF^CN_3oJ6Xh)qmK
zbBvjZQ#z`Dg&V^hzXgISNI|}E86j>==M#gBPfGi=JB$kTvQO2_vWPDYfCmg0ZOK-C
zxQqEJO28$$0rrMr^v+IBVa)FG^?<MY%Ev_`s1CT~TTB26DjYaI#*kp|uQ$AT6VPyt
z$N<2?o@>J)3)g|4ZVtuM9W_R4LB@u&m>5Ie&a8!FI1@6|EL7ybg9Cw-(>0SoM`TL<
zklTUAa?4?b8HFhph2Z#Ez=pJ#|CW3Uk4z+d^E};DGt4P5-GWX0--GahrVvIMq`Bv@
zG{sEg<lL+&3v*%AKIAqot7})zBK=R3+ZoOB^d+tv=G=8^<Uh}DgmIp|gj_dpm0exO
z{FT3-c3sESALgqSeoS~e>=SvJWsA{-Xr?=Fi+q_&UchLW$Ix7LPSufLm|Ga*Cp^s{
z^PJ(adks&SN)=Nho>hvxhDoN4BsyqG+A<wpLsX?mN!4)a$<n`uihl)m-yg#?9G;O4
zs^({>o)5c^K$$h2saOV*v&(^a8JgVbGg-zzT|B*Jb7C%dzzz;@JzA`v;l>6$S{*>P
z_L(SwY<kc30U}?DI0}c_y&~WJtizm<%l8KJS+_=chQ&eH<<(rX9Z~@`;yb5l#`Xca
znk}4}0_Z9NC)x+dCYm+6#?@+HE}PNB<9lV>)+HCcz*u07FwsV&?L91D`WA}=>U9N)
zr_aLqI>%rai`EDe&mV9e<4&XjckEe|L5E-ZnNt0%OZ}Zv{au&(d!_pOF7<Pz`gxc7
zg;M>ZOZ`%*e%Yn|L8<<sOZ}r#{bQH<;1ugUMc$lt0u0muotZZ{Qv-D6-pH{g3!=gp
zWl8V{>2O5A+;+m;w!vJJ$-Jndt50v)YrN9eEQrgeFYL6}K7xNZ(af6`xCVcV%-&N9
z{s|t$+JeyFA4Or7L;>8eN95J>(BlWl-EdSKbDlFu!9O-Ww`w)`d({sWszI;!!%#e`
zV=DNoeX6d~;OFVsyOKisK=wpi?Pj%UIZ*JIWrUR7we9@2l+w>+PqbyNQJXCX3jSvG
zQE0XE|05ywcd{p1UZB(_>H`ITu{GDl`KX;=mxB6x*%NKCeb=U*4m$Z|X;3M(^Ot8Z
z{k#&zUcG#%J>mlezpUGS)M@80zZCjKO+i+7waIFr;I9h4N}TuF`ODM4epwT*%EH>T
z94Pq9dR)rx+IIe#l+r)Qo@mRWy*6786#Qi^R|*%Mc7Ac-;R5={ntWOB)n?0qf}g*C
z3%(PS!bPXS@1_jIH|Q3!2pE6i#C0BCKXvX)?fm>SwJ^-j+Qb-(lgz@@ro1}lzXt!&
zHN%UfBl8p9hThY_Uy8F0m~_jYJKXOG&_P|pl6kBsS)QWf4IASBCoWoFaFrm~ikp%r
v#g)>Nqf}|SYu=c%TT@)T;e{KqEM9UcBIAbthS5VPuKw`KjU-8w>=^zBxH~X~

literal 11484
zcmc&)X-^|Z5UsC7%6}Mvka8@CxmhKVu<@`KU=wUZR$9s8UTeXuY_l8k<CDDC?RL+_
zT<u*nvZtrJr|P}x>YBd(`*%fF#KZ3wTtCVWNUcoop48+~KFhNVr7w5#QO2nIlU&Kq
zxUb17u1%ztCQlWq$Qz^^GC<86xks83hLFMk3*`2Z8ptwA_E63mR`y6e-N*><4&@8}
zuTk?ismiJR5kS=el0IsAkUNCDJ0<%8&liw=jr$liZq)M?&_2ooYO?GZ?+sAjLk`hU
zPamm!NHgpyWvJf1N7)rp1BHlkjeNd+J<;$5={_V}$R+-%^+}<iY>PzedQhm16e1(u
z{?sny^eDH1_o~vCeLNq9uvn~Ll`XFDPjq3neW0O4T0`55x<+^=>r3Dawg;_B^tZ^@
zEkn$IqfQi4*e=?Z&!}}ddH-=@0U{a)>`MO`qb1%dFQaE^+p_*pS$Y}lhiIP_APCxi
zgq%wtzlN`cOO_$!BYwsr=I%*H-bo#(PT)N)Il%v(9OJnGi+Zpr?;Yee;9p&&>dMYt
zY2sc-zLj9xpaFlbqefdvZXrcK=KnnIluN1exL4IPpWaNdd2)_&;%X_4eBOg5B5NYQ
z0jZSHQrb`PMC{C?&JJp^4z=o9KI-z#_qZRTgvi<d>Ju%RMP2@y%CXWLu*C_yiaPhv
z%Z%O3oswyB`U?GOj8-#c=FU3TA^&Ah@}?f9dm8)6En0JcpYgX5YTc@~_F##+_`u<T
z6+KY<-Wo8iB5xl#^wc}V7SrD;P4~3=M7sxs?B(p2>`?|`^zNxRrz4y$`&|}PZ9XkP
zD&N0@1Y-8oMIT)PO4@E7`7Eaoj(~PP@UH1snzi<=p0Y06yr*nkoj$XTd#XJ<D5)!d
zq0a@cIhhM!dIGjP==T%`i)ayVAES&GHuhjI@>C9OPFw33#fZw@Jivbk<zr>XDoTU(
zKj7&D>MX*eG{c2Ro91J84F8~49s^es77TK;X=`;ChF`&fUNrzaG9JNa7!4T#N8rzx
zW|$jm9V<&dA>VlCteDe2?5*?~MuKR|YWClsc^kH2On!n*zE!KU#ZSPzlfvAakzW^S
z^#*+7GnkLR8FNN4-Iu$FXg<6?solSStNZY8#>*<$-{R6ElUe&bzfHkd*2A}w*5DVa
z3y;X_^YOTJrO-1nKcNLZ$<yklC%eTj9k+B3PUe%xlTDm4J?^#m#G_IYr)>XBiXyMY
zDH?5}jOLWzWpj#0hu3116h-2!vKb}!`qyG*#sVB|GEV664_l8<W;Bq^D$i&qEk1-t
z0`XYm9u?yrX}CvA4C_2GWD#HNVzJDOx=i$HAqF#^_0(vak(uL5-9LyV+x9I)Uygr0
zNYGytH$-iG8_s~EJfb#6Gh8Q_6(Y`+g8pb*$fmOGRL88DV{13-)YKSC&l{R0TC1kU
zI(p?`02{fXIYC?T`@z=YtTBuz+a@P!e9jexSs^+=4B-rl|78#zV5Y!X5dV+V48YY!
zoTqcFU&9Pv_pKtms}0+59>%pCx3&u6=m8Jc5srY2YZrOHhe0$eka2^)&)G3&RBq_Z
z_l<4$Ud5zf6v`KgO#ET{J*%kXim5VfG23Q&u~eKbvgV+D%~|`pgZ6c2?Hdl-H=MO^
zI%wZ?*1qMSeal(<wuAO<XYD%<+IO6_?>cDTb=F={Yn#z;ME-cQIs*h;Pc4tYJ?2%g
zgXDt1HSX2$?Ks7Ek!!SNanvx%8{)h8D`dERfh?Ny8K61OjfQ(9NB9Z{*P`uMH!YPt
z=6i>+!o6CtNs}}CGOk_cZ4Jx6s>Vo7?4;yFl+8b%oY~hZ$Dd<pj_~t(LN<Ty{c<Om
zd$e4AKZHMUpOBZ2*~tK-NwXsqF6EncH>aqD%JJvA#MuO09*x=jm#}XXzqIUlzRpQ6
zwQr>%EXO}-K9!~=o4<*UOW1vlO7hiyUNqM{C(X@FS@yjg|M+S|x~3xhxpx@8eD(DU
z=h>(Dx`r*wPL<=IXYC`Xy9ob3BkbA#*JF8Bx>-T7IYm<C_y=drd9)Sb&z<`4<;zAS
zCs-bweFyXNrQP{QR}GT%7U3V?2lLg*p(MG?3-XVyKD_jf%`eA4y545xC8vt;kB=#Q
z*-B~u=-OQ}f|qj3@lRUedr1THi|~){{rj?=!ar%XFbzw%tQ`ON`gmAs^r;B{R*b7J
zJFz^gA->XX%d%7D_{Z1f(lr&~Z+Cc%OkZ|W_{Z1x%zJt6<@lTLUr(JI<D4j6S2q7H
z_H4M`ZO1{J+l|$VGf&p(vpM#3o<9A=9d5U)2!FFT)l+NwXILfXJYXNQ0P7D;<Z?Hu
z=*s9KEXfl`<jJ!{Z^4WEtUNKv6I48lWLvt4+y~Szx^o|9z}*{S=gA}PaqX8}<9G=>
zx#$z4efbB7?ffNe*U_9nD$k8)6wR3uvuYD=5Bf~DPbTr=-eP%VJTZBQUkj%hxw{zN
p;pG{aQ`H9L@pa)dpYVIc$q(*6hEKWGF~8&tlV{fSxivla{~x9-GJ*gA

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/HexEdit/HexeditStrings.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/HexEdit/HexeditStrings.uni
index f52193106f022e90c8752fba3738d5d6ec10330b..d9591ca13da0f6d663db305bd5b153a65c459573 100644
GIT binary patch
literal 6577
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

literal 13156
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
SI&wb4-HY6<`oWfVZS)_J>Eg@)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni
index f36882573a5fc8ecad9e9cb4ecb02e586982a7b3..24fca87adfa2104d9877a261727a4cb96c435b96 100644
GIT binary patch
literal 54971
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
GZ~q^FQ5%#1

literal 109944
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

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index 2d9bed75c60e9689aab39654f005c2b95690fbb0..448897024f199b23370ee36914188c9084f6a72b 100644
GIT binary patch
delta 808
zcmb`FPiPZS5XNWHbhE}*LjP-`Spu!1ZOJB9d(k!lEfHc%lT?yeO=T0?5=|N#h!R9l
zJf`AP=4dP46p2*G!9WU%2wv*NlR{7Gsp!p<I-6~)B6^Z#=e;-Y&HKLj@!r+s8?R;4
z_itq_+#G^qFakl2Cm~GtT)0z6vZpl!NjMJ|I9`N#P@o$$F(kK(#Myn~T2v9^v0<?m
z?Ok4rcp5~@9Yw6juI+9p@Ig0tpdh|XbX)uof#YycELD9CyeFEM_6pl6X(K<V=eKGG
zjhbynjS7c^Du%XpdA&Rt&ExHXT_O=SH;%JkpICV46t_ltMA_@I<k;#IXjBWLQzYDu
z>+3OEk73u5IK;u|W|I5xLmn=HJ}dIy2LTx6@vmpdcOL^HD_N-{j@inI)9ANQb`P5A
zW*lEM*6*b^B|Jc1pP_>m`%$LwDB1>ckl{}!cMfte0~*sz@+!sITwOWH&<*t|W~}Ks
z@g&kopJ(}w2S>4sN>#Md+Y<KB(<-+8*UQ_eJccQHIg2)$nBl;x)`~;JPfavtH%Wae
z^s}P?`&HOohND4F+3^3{`=DAHo#gn4^4+4TY4^W+&(oY2+o`aK9d?x;%1@OH>!jf_
zEAfo*J=#fm#GqfLv4w_1X!fR<XYvnvn>=-vy<9yH({<8yzobrMC%HA0=)(f;AgRb)
cSNEg2brbq8jnLs0RB81&Ua4H2!!wV60RNrHEdT%j

delta 164
zcmZoU&2eWx$3~`<kjWRq*ce?W3x>*1F5xtq{3_T<RDq$4A(0`6A(J76L4hHF!I{C6
zL4W$eJVwdsIjM{SlMOf}CMSfjF?%xj1NA9S=HM{eoD-VBJeg^#(`3F#4o0objZvkH
zlQ+aGG#`tZek_JjgtrE0k}l93e;{2mJw2AOc)CI=<B{#RVi}#-rzgy3Oxu1hol%H)
P`U6wOs_km!jB)D#<)<>4

diff --git a/ShellPkg/Library/UefiShellDriver1CommandsLib/UefiShellDriver1CommandsLib.uni b/ShellPkg/Library/UefiShellDriver1CommandsLib/UefiShellDriver1CommandsLib.uni
index a28985300e18d78785e752ac57fd71a966704442..a14469afdb53e659d941e54906690cdde4be6fcb 100644
GIT binary patch
literal 35402
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

literal 70806
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
Kg?!~KfBz40)L5?o

diff --git a/ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.uni b/ShellPkg/Library/UefiShellLevel1CommandsLib/UefiShellLevel1CommandsLib.uni
index 40fa57eb027d870872ae0f89cdd58efe51c1aeec..73e8655ff509d6ee5221b837c4bda93d0e3ba6e6 100644
GIT binary patch
literal 21964
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

literal 43930
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
LF;=67tmpp#1>jX@

diff --git a/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.uni b/ShellPkg/Library/UefiShellLevel2CommandsLib/UefiShellLevel2CommandsLib.uni
index cc2c33cda4a6bf1c4f5dbc8527dfaaab5185ca53..60f48f4633d7d12b4b4426812732990b279e759d 100644
GIT binary patch
literal 54870
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
RhpTCjL@u?lqKX6dzW`6;0H^=}

literal 109742
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
ZH0qbgT-hthsblhC_O<oCqGcKE{{tqw0;K=|

diff --git a/ShellPkg/Library/UefiShellLevel3CommandsLib/UefiShellLevel3CommandsLib.uni b/ShellPkg/Library/UefiShellLevel3CommandsLib/UefiShellLevel3CommandsLib.uni
index f4473ada5ff58a6e06dd04bb84e55cbe71ea1622..fc9c5d447ccc3a13fd69862f9e2eed847c9cfa0d 100644
GIT binary patch
literal 22477
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

literal 44956
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
F{{gac1vmfz

diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni b/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
index 43259591820582cc38937ad680739fcff21b96c5..4c68e416406a8a9a985feec992f6bdd45bce8ce2 100644
GIT binary patch
literal 10546
zcmb_i|8Lq@694&D+W%pc6-rt)gk;;Qi@K2rm|ztQXPeFT+6p<?fK{+L+cf2LfBb#s
z+3(o|8`9=b8w`H_%)I$N^SHR6i<d8d{pI3<|I=Cf1+~NVHuC3-gsvKwzn|mJ8|rxv
zOD{>zN6z%C6S>s!zIn@Vz4C$t>sM<h*uJ8EeN=ycV_plS9OZ2Kf{_|@&TnsCksc)8
z5|2geFme(<4C>TcE=kagDe_`3`sTTHQdsuFk7*r+^T=6|6S$NtJaVSfl&~MnY2_qd
z<U7k)&~_q^mj2WWV$T)pSB{GZzB&HVxnFv;30yA{Ab4sOizU-AaD8Sbrf??i-B=y!
zrzisTVc|~~imdO&SOvaZKTab5ev@v*24}Mkc9VGD6N!}Z0xq|7kNY7QASV&1izHb$
zFD}A0xD7Ya)T@Wl{33fIzPOLw^Xx-?y;$=j;xW6Y(a0R$nymrp7Ik#XHuamat#xQ@
zbTpHAf!KlG)(lIdp+PN!PFfb0pU_Rq(ydnl=}xzM!?8_wEz@inwys$;G|ALPre<k|
z-Lmzefv>uF{3CtPjm|65@CZm~fAbo#Tpx`3y4I;H{sy7Dfus#*<u%opV{hhL3vanJ
zyyPK_zFxv~R?uhM_wVbQz*h@f_mHVGP4Y)A$QXKdfe>VBnuQUKwXRMAlCJ6v3Q}CU
zB-n;PmXQ2TFJD4<xcc)qe*10d1aklqkr$kgEjsan`O=RUC*m$^6%--Y$*pEg?BQ@S
zU=gU7cz)x|J^6U8SBq;#lk6~rs)H>#(R{-$64yURp98@DRs!19?i3`^LC~4^a2#{g
zf=x_x<1d9;iKz$QoTU#_%=m<do~D~PtzZ}?chlDf3i<%U<KSx$J_IydI`bz3Plltb
z4E$%fu9NnC?M)N7{b}unwQ)+Y5_w&vhHO`pzgqoc#BUszAheBF*b*E%dg3;XArl#E
zxd1D-Iq>6{4NxiP=~Oh+oU}SQjRRV0O{ZRrAm#-=LT-iD8E^dINqAP`B%8QNwWtCs
zHP1G}k$hE3VB{d)dkE1n+&P#b3?@|^cJ;mn+ku~UTe?tUC2HFVf)Jq@0heYzV$@Ni
z7vMYctOU=*DR8|gf?XU%Z=3zD6h->Jhh8B{7!$K*<xlTDDMOOM5h<B2*r1rXm>xVN
zNs)=FWZKcqiLt|4C49$^;B{fNB^GU(-;Qovh;@fRC4QIn^aIekH39dzTn;#Z40wc8
z?jV_G8>tXEB85F{5Bs@bDtYEg05wYzPQ#@Nt4t;G{=EU2v@*#zbyl0dkgC|t6eHcZ
zoxo$d`fYJbC7Wu)P5gPe^9ht&%^nOph42Hwy&c?o3DURMaT4b+RHtRPb~q}7Is$_l
zqcbtJe~vZFmRNf*+H?^Lxp{FyG34h3Q;%vc^yLb>;8G9;sz>og1T-$ewo;nKtSh8o
z46WhVY-`Aponc0Fk0$g758+ZW2q`ViV)6s3#iuc?Hp|4HI^f0)SB@W4lhW+Fq4{Bg
z5Q?fQeeID_UYeCJvrRDNa*}4KSYap+ezG{AiPSVY6GLw+yR4=WieT!`H*A7FO7Ups
zAO{=?2$|eWREpZ9J4B6HwV70Iuycql3OCS65{i1-h4TDB6#Ob9(<};C;%+M8{KkV5
zSBEFTjb*n?WinOVj5y-eVqq(6&-dHJD=o(aq^%D$u7!)QJxNv?W8$woY`D@EP*e9m
z!sfct=0Ii-9Y!s9OeF)(o8(Vd>j|v>PuxqArFa9W+O+1b;*vlmrL((_GGd<tK(5i#
zc?r6i$O+<=pP+hr#qvTV^n5g8{GnFMmeDed<5$F6#n;v3O?!{}{$4)^W|Ex2NVuho
z{I!66K`TGN9?_SrobTy{^KC9Jvd!*>N4=Xmz+`M#<I!knq6tDRz<o=m$Hzj(*C!mF
z!?p0TVhY#<@n(&_luJmIul2pMT~X_|+8=hw9H7=k5ggMJl0Js08@6V4TkT?uF5|xs
ztlWJmK&5mHx;-4AgOQG#a{B~muDy^{QehpSftI7y*E=xqM>{B^AzKd>fR62;Ge(Em
zZXx<S+C~|AXR}7Nh?#)u1M9?<d)5_F8gMxo$6x*Rnk(PO?U~Xu8y6_skLm82Gg}oW
zV6IaorTFLRj*Sn-@XpvHTS`|pTe9u_d9s#fqj%_-qL9WkLA}c4tfSaVQxsx+>?L$S
zjv{qf6HEVB(X;`-2mB8@L15|;nVddiIzuo*7ad{b@}gO-sEhz+7A8m8j`nxP`yK%(
zis6Ygpl(0a+%MIrR&RJW(MLii8D9EUih6m)y^m3I>+)YUGADwGq22X$V^<<&$VXs0
zhLvjVX4sJ<iZYnmyC-vYV`{CPo)6nDgZvzvKlgQHbEvmfD3>ZI<D~g$!lGPQNLues
zjMm^OlCJeQno3GYz&uDe!s9^e=&cD#5<90*#$&BF@Lb;^?vp{{N!X(y;?KuPr`H}S
zrpmF`A%f2~Tht_XF<l?!JVQrjP~fF{uJs<F$Jl~DJ&HeQwNumVX{v`V=YHi($#LCC
z@WF0$P@f9-n8`P;z8?h2oO@E>uT%gWll=9!*MdhLnjB@(8s8WQr-PRDL7|szosr|s
zJ*Jl^dE&3aEDmq}7It>m`lwJ@WL3x*aXM&MXby{eaJEOeR<WcYkSc7fMcl`@o|VSP
zN8Cipx}dXCzGd`87!`=S6(71-?7TmkaHT7(rELEv(E3T;?$MfifCim#FTg{4bR-z6
zLD-8B4V-AMoPhKZREvQP-ro{z8>QMwR&SovtsZgkke`1TNj}Ix)<<JF!uVZ&NAg1K
z=F|DaU%&lAc#p{vCj$DKKL)5NHbKIdON#yfcwfjC+tAk%fYH;!cORSx2<hvbEDTBg
zS$c$l{&usvhXQfz;T8LA7yS~SxIknfA6vx8!LqkG0o<|zj(L+OAB;iwo7oKb=$%>i
zr8J7Tynlv%%x10_+Qd9|Utvf=XPwNvQOpSy3e~Ae3Ns2piq~VntmSlEXN@kH&~Wb9
z0EZ&Dd4V;ljxyGA+sU4jBFLy9xMBK+8a+J;0AEsjKZKT9?qf98d`Gj|rY`y(MMPd0
zLtC?&@)OZzoy4J<EQmKT>MYid-X2Il;H$T!wR=M~pOGfP7U3b)_zBL=a#Tn;TaHFI
zZD1YYWNO#Ur}lRXr$ySniOL%VK40Q6CH3D@w|)CMYnGX@!ed0UxY7K4ojwXn#lp)!
zuIiU>-_;xSOU1FeplU+*Tef_cW5`vb+<N0`(g8no)d1-$5N`Yoap9|5rq42{Fxt%M
zsu_V3?67gQ`%y_kT^td~E?1?#d4L&q@vBCo(Y(j2*?cFdvVEAEJvO<Q#7IznuVQ3+
zlhV5d0v7T?e`1Z>Z9b7KzHA5$M~OU6<C&726k`0Ej$$#D;{H#$Wr`%5S#eyUp`iuj
zFi>%A?Zh}+K1WDf=Z6#w?+4Q`;u-RCn?n}a*}cY@4(9SaY(VDmF@#CamKX`W4~LL@
zo{p#>RFMZ|rMnA`Pi1*qrbU02b@oV&nD^%SKo$)8NR>KZgpE%ew~8Q{o#1jEdni#p
z6IY6m&7v}Gs?C2okLVMhIDbi#WOgk<3hQEe&+D#5g-rjY_h~Il@Ac6&y&s?kyC!;n
zn-)yh*Sx~T4+Hr2^%sf9OdZI!X&Eata!#ff;OsV)_a^<(11mS5e(<jvxPj)9ozg<P
zV3R7>0`43?N{D$}2Yu`S7T0GPkEtW;iRs>f<tz)qXu4b#2dIi<auglW86QD<-yNQ{
zzalSLG>Ul^=AvGYQ?0NWnHb?UI3nVLAo1o%yu#*pW2gcW7w0(E6-1lGDBh5YAhJa9
z%zE1`8yuVm<Yo19=w7{fQ<wh>gfkNnl#6@DNz!iB&DGEUW7BfaY<$m2_^6!@Iy`H-
z;PI~|U7-*8GmErJ&Tn1SX&ifWdLEr}g%CZ@=zo`JOM!-8W+Z|o?m5_9Lhy&GEv?c(
zYzcQ2PJ~ki)cL#vXSvL|1MAA)5MI;$#hI}ejzS84^jfl@0>)0D$juH>qhJcxr)gKQ
zLpys?ALR|?j{8c6nX|)Oz1ic6qsFNK;32{5RQNb0%OqByxx>;feRm5d$J7)jXNngk
zu;X04-RCL`nWs1|11IUPuJFT{jkA0l;@F&J`KMTv7xG3S-HUQfS;X!>r0H^e$~9hi
zSXGBA10ufiYDrL48<ZA7sE(;Zu!V8JE*Fob31e08u*4r>E>2gok`;uy$T?(pRYq3H
z*Uv~NV;}?13+Xo`Ln6O7iosd&r!G=PrH~-dd~_gv_!+!$dd?YpSGfKo<3L2NXZ_)y
Jh5h=={{Vh46Egq+

literal 21094
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

diff --git a/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni b/ShellPkg/Library/UefiShellTftpCommandLib/UefiShellTftpCommandLib.uni
index d12a87cb56a06ec796d3054e0aa9fd158937f004..33a8944504c3484ebaf53e9caed7c624b192a136 100644
GIT binary patch
literal 4975
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

literal 9952
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


From 91cf863a549d441f73ed55b19af95c5ff65d7913 Mon Sep 17 00:00:00 2001
From: Jaben Carsey <jaben.carsey@intel.com>
Date: Fri, 18 Dec 2015 07:38:33 +0000
Subject: [PATCH 309/525] ShellPkg: Make 'dh' support showing all spec defined
 protocols.

When using 'dh' to dump all protocols installed on a handle, some of
them are shown as 'UnknownDevice'.

Device patch make 'dh' support all spec defined protocols.

(Sync patch r19177 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19407 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiHandleParsingLib.c                    | 123 ++++++++++++++++++
 .../UefiHandleParsingLib.inf                  | 115 ++++++++++++++++
 .../UefiHandleParsingLib.uni                  | 116 +++++++++++++++++
 3 files changed, 354 insertions(+)

diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
index b211de7d1d76..6f093ffe0e82 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
@@ -1025,6 +1025,124 @@ STATIC CONST GUID_INFO_BLOCK mGuidStringList[] = {
   {STRING_TOKEN(STR_IDE_CONT_INIT),         &gEfiIdeControllerInitProtocolGuid,               NULL},
   {STRING_TOKEN(STR_DISK_INFO),             &gEfiDiskInfoProtocolGuid,                        NULL},
 
+//
+// PI Spec 1.0
+//
+  {STRING_TOKEN(STR_BDS_ARCH),              &gEfiBdsArchProtocolGuid,                         NULL},
+  {STRING_TOKEN(STR_CPU_ARCH),              &gEfiCpuArchProtocolGuid,                         NULL},
+  {STRING_TOKEN(STR_MET_ARCH),              &gEfiMetronomeArchProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_MON_ARCH),              &gEfiMonotonicCounterArchProtocolGuid,            NULL},
+  {STRING_TOKEN(STR_RTC_ARCH),              &gEfiRealTimeClockArchProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_RESET_ARCH),            &gEfiResetArchProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_RT_ARCH),               &gEfiRuntimeArchProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_SEC_ARCH),              &gEfiSecurityArchProtocolGuid,                    NULL},
+  {STRING_TOKEN(STR_TIMER_ARCH),            &gEfiTimerArchProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_VAR_ARCH),              &gEfiVariableWriteArchProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_V_ARCH),                &gEfiVariableArchProtocolGuid,                    NULL},
+  {STRING_TOKEN(STR_SECP),                  &gEfiSecurityPolicyProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_WDT_ARCH),              &gEfiWatchdogTimerArchProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_SCR),                   &gEfiStatusCodeRuntimeProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_SMB_HC),                &gEfiSmbusHcProtocolGuid,                         NULL},
+  {STRING_TOKEN(STR_FV_2),                  &gEfiFirmwareVolume2ProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_FV_BLOCK),              &gEfiFirmwareVolumeBlockProtocolGuid,             NULL},
+  {STRING_TOKEN(STR_CAP_ARCH),              &gEfiCapsuleArchProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_MP_SERVICE),            &gEfiMpServiceProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_HBRAP),                 &gEfiPciHostBridgeResourceAllocationProtocolGuid, NULL},
+  {STRING_TOKEN(STR_PCIP),                  &gEfiPciPlatformProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_PCIO),                  &gEfiPciOverrideProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_PCIE),                  &gEfiPciEnumerationCompleteProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_IPCID),                 &gEfiIncompatiblePciDeviceSupportProtocolGuid,    NULL},
+  {STRING_TOKEN(STR_PCIHPI),                &gEfiPciHotPlugInitProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_PCIHPR),                &gEfiPciHotPlugRequestProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_SMBIOS),                &gEfiSmbiosProtocolGuid,                          NULL},
+  {STRING_TOKEN(STR_S3_SAVE),               &gEfiS3SaveStateProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_S3_S_SMM),              &gEfiS3SmmSaveStateProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_RSC),                   &gEfiRscHandlerProtocolGuid,                      NULL},
+  {STRING_TOKEN(STR_S_RSC),                 &gEfiSmmRscHandlerProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_ACPI_SDT),              &gEfiAcpiSdtProtocolGuid,                         NULL},
+  {STRING_TOKEN(STR_SIO),                   &gEfiSioProtocolGuid,                             NULL},
+  {STRING_TOKEN(STR_S_CPU2),                &gEfiSmmCpuIo2ProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_S_BASE2),               &gEfiSmmBase2ProtocolGuid,                        NULL},
+  {STRING_TOKEN(STR_S_ACC_2),               &gEfiSmmAccess2ProtocolGuid,                      NULL},
+  {STRING_TOKEN(STR_S_CON_2),               &gEfiSmmControl2ProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_S_CONFIG),              &gEfiSmmConfigurationProtocolGuid,                NULL},
+  {STRING_TOKEN(STR_S_RTL),                 &gEfiSmmReadyToLockProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_DS_RTL),                &gEfiDxeSmmReadyToLockProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_S_COMM),                &gEfiSmmCommunicationProtocolGuid,                NULL},
+  {STRING_TOKEN(STR_S_STAT),                &gEfiSmmStatusCodeProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_S_CPU),                 &gEfiSmmCpuProtocolGuid,                          NULL},
+  {STRING_TOKEN(STR_S_PCIRBIO),             &gEfiPciRootBridgeIoProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_S_SWD),                 &gEfiSmmSwDispatch2ProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_S_SXD),                 &gEfiSmmSxDispatch2ProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_S_PTD2),                &gEfiSmmPeriodicTimerDispatch2ProtocolGuid,       NULL},
+  {STRING_TOKEN(STR_S_UD2),                 &gEfiSmmUsbDispatch2ProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_S_GD2),                 &gEfiSmmGpiDispatch2ProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_S_SBD2),                &gEfiSmmStandbyButtonDispatch2ProtocolGuid,       NULL},
+  {STRING_TOKEN(STR_S_PBD2),                &gEfiSmmPowerButtonDispatch2ProtocolGuid,         NULL},
+  {STRING_TOKEN(STR_S_ITD2),                &gEfiSmmIoTrapDispatch2ProtocolGuid,              NULL},
+  {STRING_TOKEN(STR_PCD),                   &gEfiPcdProtocolGuid,                             NULL},
+  {STRING_TOKEN(STR_FVB2),                  &gEfiFirmwareVolumeBlock2ProtocolGuid,            NULL},
+  {STRING_TOKEN(STR_CPUIO2),                &gEfiCpuIo2ProtocolGuid,                          NULL},
+  {STRING_TOKEN(STR_LEGACY_R2),             &gEfiLegacyRegion2ProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_SAL_MIP),               &gEfiSalMcaInitPmiProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_ES_BS),                 &gEfiExtendedSalBootServiceProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_BIO),                &gEfiExtendedSalBaseIoServicesProtocolGuid,       NULL},
+  {STRING_TOKEN(STR_ES_STALL),              &gEfiExtendedSalStallServicesProtocolGuid,        NULL},
+  {STRING_TOKEN(STR_ES_RTC),                &gEfiExtendedSalRtcServicesProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_VS),                 &gEfiExtendedSalVariableServicesProtocolGuid,     NULL},
+  {STRING_TOKEN(STR_ES_MTC),                &gEfiExtendedSalMtcServicesProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_RESET),              &gEfiExtendedSalResetServicesProtocolGuid,        NULL},
+  {STRING_TOKEN(STR_ES_SC),                 &gEfiExtendedSalStatusCodeServicesProtocolGuid,   NULL},
+  {STRING_TOKEN(STR_ES_FBS),                &gEfiExtendedSalFvBlockServicesProtocolGuid,      NULL},
+  {STRING_TOKEN(STR_ES_MP),                 &gEfiExtendedSalMpServicesProtocolGuid,           NULL},
+  {STRING_TOKEN(STR_ES_PAL),                &gEfiExtendedSalPalServicesProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_BASE),               &gEfiExtendedSalBaseServicesProtocolGuid,         NULL},
+  {STRING_TOKEN(STR_ES_MCA),                &gEfiExtendedSalMcaServicesProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_PCI),                &gEfiExtendedSalPciServicesProtocolGuid,          NULL},
+  {STRING_TOKEN(STR_ES_CACHE),              &gEfiExtendedSalCacheServicesProtocolGuid,        NULL},
+  {STRING_TOKEN(STR_ES_MCA_LOG),            &gEfiExtendedSalMcaLogServicesProtocolGuid,       NULL},
+  {STRING_TOKEN(STR_S2ARCH),                &gEfiSecurity2ArchProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_EODXE),                 &gEfiSmmEndOfDxeProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_ISAHC),                 &gEfiIsaHcProtocolGuid,                           NULL},
+  {STRING_TOKEN(STR_ISAHC_B),               &gEfiIsaHcServiceBindingProtocolGuid,             NULL},
+  {STRING_TOKEN(STR_SIO_C),                 &gEfiSioControlProtocolGuid,                      NULL},
+  {STRING_TOKEN(STR_GET_PCD),               &gEfiGetPcdInfoProtocolGuid,                      NULL},
+  {STRING_TOKEN(STR_I2C_M),                 &gEfiI2cMasterProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_I2CIO),                 &gEfiI2cIoProtocolGuid,                           NULL},
+  {STRING_TOKEN(STR_I2CEN),                 &gEfiI2cEnumerateProtocolGuid,                    NULL},
+  {STRING_TOKEN(STR_I2C_H),                 &gEfiI2cHostProtocolGuid,                         NULL},
+  {STRING_TOKEN(STR_I2C_BCM),               &gEfiI2cBusConfigurationManagementProtocolGuid,   NULL},
+  {STRING_TOKEN(STR_TREE),                  &gEfiTrEEProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_TCG2),                  &gEfiTcg2ProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_TIMESTAMP),             &gEfiTimestampProtocolGuid,                       NULL},
+  {STRING_TOKEN(STR_RNG),                   &gEfiRngProtocolGuid,                             NULL},
+  {STRING_TOKEN(STR_NVMEPT),                &gEfiNvmExpressPassThruProtocolGuid,              NULL},
+  {STRING_TOKEN(STR_H2_SB),                 &gEfiHash2ServiceBindingProtocolGuid,             NULL},
+  {STRING_TOKEN(STR_HASH2),                 &gEfiHash2ProtocolGuid,                           NULL},
+  {STRING_TOKEN(STR_BIO_C),                 &gEfiBlockIoCryptoProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_SCR),                   &gEfiSmartCardReaderProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_SCE),                   &gEfiSmartCardEdgeProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_USB_FIO),               &gEfiUsbFunctionIoProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_BC_HC),                 &gEfiBluetoothHcProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_BC_IO_SB),              &gEfiBluetoothIoServiceBindingProtocolGuid,       NULL},
+  {STRING_TOKEN(STR_BC_IO),                 &gEfiBluetoothIoProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_BC_C),                  &gEfiBluetoothConfigProtocolGuid,                 NULL},
+  {STRING_TOKEN(STR_REG_EXP),               &gEfiRegularExpressionProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_B_MGR_P),               &gEfiBootManagerPolicyProtocolGuid,               NULL},
+  {STRING_TOKEN(STR_CKH),                   &gEfiConfigKeywordHandlerProtocolGuid,            NULL},
+  {STRING_TOKEN(STR_WIFI),                  &gEfiWiFiProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_EAP_M),                 &gEfiEapManagement2ProtocolGuid,                  NULL},
+  {STRING_TOKEN(STR_EAP_C),                 &gEfiEapConfigurationProtocolGuid,                NULL},
+  {STRING_TOKEN(STR_PKCS7),                 &gEfiPkcs7VerifyProtocolGuid,                     NULL},
+  {STRING_TOKEN(STR_NET_DNS4_SB),           &gEfiDns4ServiceBindingProtocolGuid,              NULL},
+  {STRING_TOKEN(STR_NET_DNS4),              &gEfiDns4ProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_NET_DNS6_SB),           &gEfiDns6ServiceBindingProtocolGuid,              NULL},
+  {STRING_TOKEN(STR_NET_DNS6),              &gEfiDns6ProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_NET_HTTP_SB),           &gEfiHttpServiceBindingProtocolGuid,              NULL},
+  {STRING_TOKEN(STR_NET_HTTP),              &gEfiHttpProtocolGuid,                            NULL},
+  {STRING_TOKEN(STR_NET_HTTP_U),            &gEfiHttpUtilitiesProtocolGuid,                   NULL},
+  {STRING_TOKEN(STR_REST),                  &gEfiRestProtocolGuid,                            NULL},
+
 //
 // UEFI Shell Spec 2.0
 //
@@ -1036,6 +1154,11 @@ STATIC CONST GUID_INFO_BLOCK mGuidStringList[] = {
 //
   {STRING_TOKEN(STR_SHELL_DYNAMIC),         &gEfiShellDynamicCommandProtocolGuid,             NULL},
 
+//
+// Misc
+//
+  {STRING_TOKEN(STR_PCDINFOPROT),           &gGetPcdInfoProtocolGuid,                         NULL},
+
 //
 // terminator
 //
diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
index 4cd81f59ed66..4a19e3945057 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
@@ -175,6 +175,121 @@
   gEfiAdapterInformationProtocolGuid                      ## UNDEFINED
   gEfiShellDynamicCommandProtocolGuid                     ## UNDEFINED
   gEfiDiskInfoProtocolGuid                                ## UNDEFINED
+  gGetPcdInfoProtocolGuid                                 ## UNDEFINED
+  gEfiBdsArchProtocolGuid                                 ## UNDEFINED
+  gEfiCpuArchProtocolGuid                                 ## UNDEFINED
+  gEfiMetronomeArchProtocolGuid                           ## UNDEFINED
+  gEfiMonotonicCounterArchProtocolGuid                    ## UNDEFINED
+  gEfiRealTimeClockArchProtocolGuid                       ## UNDEFINED
+  gEfiResetArchProtocolGuid                               ## UNDEFINED
+  gEfiRuntimeArchProtocolGuid                             ## UNDEFINED
+  gEfiSecurityArchProtocolGuid                            ## UNDEFINED
+  gEfiTimerArchProtocolGuid                               ## UNDEFINED
+  gEfiVariableWriteArchProtocolGuid                       ## UNDEFINED
+  gEfiVariableArchProtocolGuid                            ## UNDEFINED
+  gEfiSecurityPolicyProtocolGuid                          ## UNDEFINED
+  gEfiWatchdogTimerArchProtocolGuid                       ## UNDEFINED
+  gEfiStatusCodeRuntimeProtocolGuid                       ## UNDEFINED
+  gEfiSmbusHcProtocolGuid                                 ## UNDEFINED
+  gEfiFirmwareVolume2ProtocolGuid                         ## UNDEFINED
+  gEfiFirmwareVolumeBlockProtocolGuid                     ## UNDEFINED
+  gEfiCapsuleArchProtocolGuid                             ## UNDEFINED
+  gEfiMpServiceProtocolGuid                               ## UNDEFINED
+  gEfiPciHostBridgeResourceAllocationProtocolGuid         ## UNDEFINED
+  gEfiPciPlatformProtocolGuid                             ## UNDEFINED
+  gEfiPciOverrideProtocolGuid                             ## UNDEFINED
+  gEfiPciEnumerationCompleteProtocolGuid                  ## UNDEFINED
+  gEfiIncompatiblePciDeviceSupportProtocolGuid            ## UNDEFINED
+  gEfiPciHotPlugInitProtocolGuid                          ## UNDEFINED
+  gEfiPciHotPlugRequestProtocolGuid                       ## UNDEFINED
+  gEfiSmbiosProtocolGuid                                  ## UNDEFINED
+  gEfiS3SaveStateProtocolGuid                             ## UNDEFINED
+  gEfiS3SmmSaveStateProtocolGuid                          ## UNDEFINED
+  gEfiRscHandlerProtocolGuid                              ## UNDEFINED
+  gEfiSmmRscHandlerProtocolGuid                           ## UNDEFINED
+  gEfiAcpiSdtProtocolGuid                                 ## UNDEFINED
+  gEfiSioProtocolGuid                                     ## UNDEFINED
+  gEfiSmmCpuIo2ProtocolGuid                               ## UNDEFINED
+  gEfiSmmBase2ProtocolGuid                                ## UNDEFINED
+  gEfiSmmAccess2ProtocolGuid                              ## UNDEFINED
+  gEfiSmmControl2ProtocolGuid                             ## UNDEFINED
+  gEfiSmmConfigurationProtocolGuid                        ## UNDEFINED
+  gEfiSmmReadyToLockProtocolGuid                          ## UNDEFINED
+  gEfiDxeSmmReadyToLockProtocolGuid                       ## UNDEFINED
+  gEfiSmmCommunicationProtocolGuid                        ## UNDEFINED
+  gEfiSmmStatusCodeProtocolGuid                           ## UNDEFINED
+  gEfiSmmCpuProtocolGuid                                  ## UNDEFINED
+  gEfiSmmPciRootBridgeIoProtocolGuid                      ## UNDEFINED
+  gEfiSmmSwDispatch2ProtocolGuid                          ## UNDEFINED
+  gEfiSmmSxDispatch2ProtocolGuid                          ## UNDEFINED
+  gEfiSmmPeriodicTimerDispatch2ProtocolGuid               ## UNDEFINED
+  gEfiSmmUsbDispatch2ProtocolGuid                         ## UNDEFINED
+  gEfiSmmGpiDispatch2ProtocolGuid                         ## UNDEFINED
+  gEfiSmmStandbyButtonDispatch2ProtocolGuid               ## UNDEFINED
+  gEfiSmmPowerButtonDispatch2ProtocolGuid                 ## UNDEFINED
+  gEfiSmmIoTrapDispatch2ProtocolGuid                      ## UNDEFINED
+  gEfiPcdProtocolGuid                                     ## UNDEFINED
+  gEfiFirmwareVolumeBlock2ProtocolGuid                    ## UNDEFINED
+  gEfiCpuIo2ProtocolGuid                                  ## UNDEFINED
+  gEfiLegacyRegion2ProtocolGuid                           ## UNDEFINED
+  gEfiSalMcaInitPmiProtocolGuid                           ## UNDEFINED
+  gEfiExtendedSalBootServiceProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalBaseIoServicesProtocolGuid               ## UNDEFINED
+  gEfiExtendedSalStallServicesProtocolGuid                ## UNDEFINED
+  gEfiExtendedSalRtcServicesProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalVariableServicesProtocolGuid             ## UNDEFINED
+  gEfiExtendedSalMtcServicesProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalResetServicesProtocolGuid                ## UNDEFINED
+  gEfiExtendedSalStatusCodeServicesProtocolGuid           ## UNDEFINED
+  gEfiExtendedSalFvBlockServicesProtocolGuid              ## UNDEFINED
+  gEfiExtendedSalMpServicesProtocolGuid                   ## UNDEFINED
+  gEfiExtendedSalPalServicesProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalBaseServicesProtocolGuid                 ## UNDEFINED
+  gEfiExtendedSalMcaServicesProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalPciServicesProtocolGuid                  ## UNDEFINED
+  gEfiExtendedSalCacheServicesProtocolGuid                ## UNDEFINED
+  gEfiExtendedSalMcaLogServicesProtocolGuid               ## UNDEFINED
+  gEfiSecurity2ArchProtocolGuid                           ## UNDEFINED
+  gEfiSmmEndOfDxeProtocolGuid                             ## UNDEFINED
+  gEfiIsaHcProtocolGuid                                   ## UNDEFINED
+  gEfiIsaHcServiceBindingProtocolGuid                     ## UNDEFINED
+  gEfiSioControlProtocolGuid                              ## UNDEFINED
+  gEfiGetPcdInfoProtocolGuid                              ## UNDEFINED
+  gEfiI2cMasterProtocolGuid                               ## UNDEFINED
+  gEfiI2cIoProtocolGuid                                   ## UNDEFINED
+  gEfiI2cEnumerateProtocolGuid                            ## UNDEFINED
+  gEfiI2cHostProtocolGuid                                 ## UNDEFINED
+  gEfiI2cBusConfigurationManagementProtocolGuid           ## UNDEFINED
+  gEfiTrEEProtocolGuid                                    ## UNDEFINED
+  gEfiTcg2ProtocolGuid                                    ## UNDEFINED
+  gEfiTimestampProtocolGuid                               ## UNDEFINED
+  gEfiRngProtocolGuid                                     ## UNDEFINED
+  gEfiNvmExpressPassThruProtocolGuid                      ## UNDEFINED
+  gEfiHash2ServiceBindingProtocolGuid                     ## UNDEFINED
+  gEfiHash2ProtocolGuid                                   ## UNDEFINED
+  gEfiBlockIoCryptoProtocolGuid                           ## UNDEFINED
+  gEfiSmartCardReaderProtocolGuid                         ## UNDEFINED
+  gEfiSmartCardEdgeProtocolGuid                           ## UNDEFINED
+  gEfiUsbFunctionIoProtocolGuid                           ## UNDEFINED
+  gEfiBluetoothHcProtocolGuid                             ## UNDEFINED
+  gEfiBluetoothIoServiceBindingProtocolGuid               ## UNDEFINED
+  gEfiBluetoothIoProtocolGuid                             ## UNDEFINED
+  gEfiBluetoothConfigProtocolGuid                         ## UNDEFINED
+  gEfiRegularExpressionProtocolGuid                       ## UNDEFINED
+  gEfiBootManagerPolicyProtocolGuid                       ## UNDEFINED
+  gEfiConfigKeywordHandlerProtocolGuid                    ## UNDEFINED
+  gEfiWiFiProtocolGuid                                    ## UNDEFINED
+  gEfiEapManagement2ProtocolGuid                          ## UNDEFINED
+  gEfiEapConfigurationProtocolGuid                        ## UNDEFINED
+  gEfiPkcs7VerifyProtocolGuid                             ## UNDEFINED
+  gEfiDns4ServiceBindingProtocolGuid                      ## UNDEFINED
+  gEfiDns4ProtocolGuid                                    ## UNDEFINED
+  gEfiDns6ServiceBindingProtocolGuid                      ## UNDEFINED
+  gEfiDns6ProtocolGuid                                    ## UNDEFINED
+  gEfiHttpServiceBindingProtocolGuid                      ## UNDEFINED
+  gEfiHttpProtocolGuid                                    ## UNDEFINED
+  gEfiHttpUtilitiesProtocolGuid                           ## UNDEFINED
+  gEfiRestProtocolGuid                                    ## UNDEFINED
 
 [Guids]
   gEfiFileInfoGuid                                        ## CONSUMES ## GUID
diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
index 1d142e9c9801..f7d54855fb66 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
@@ -218,6 +218,122 @@
 #string STR_SSC                   #language en-US "StorageSecurityCommand"
 #string STR_UCRED2                #language en-US "UserCredential2"
 
+#string STR_PCDINFOPROT           #language en-US "GetPcdInfoProtocol"
+#string STR_BDS_ARCH              #language en-US "BdsArch"
+#string STR_CPU_ARCH              #language en-US "CpuArch"
+#string STR_MET_ARCH              #language en-US "MetronomeArch"
+#string STR_MON_ARCH              #language en-US "MonotonicCounterArch"
+#string STR_RTC_ARCH              #language en-US "RealTimeClockArch"
+#string STR_RESET_ARCH            #language en-US "ResetArch"
+#string STR_RT_ARCH               #language en-US "RuntimeArch"
+#string STR_SEC_ARCH              #language en-US "SecurityArch"
+#string STR_TIMER_ARCH            #language en-US "TimerArch"
+#string STR_VAR_ARCH              #language en-US "VariableWriteArch"
+#string STR_V_ARCH                #language en-US "VariableArch"
+#string STR_SECP                  #language en-US "SecurityPolicy"
+#string STR_WDT_ARCH              #language en-US "WatchdogTimerArch"
+#string STR_SCR                   #language en-US "StatusCodeRuntime"
+#string STR_SMB_HC                #language en-US "SmbusHc"
+#string STR_FV_2                  #language en-US "FirmwareVolume2"
+#string STR_FV_BLOCK              #language en-US "FirmwareVolumeBlock"
+#string STR_CAP_ARCH              #language en-US "CapsuleArch"
+#string STR_MP_SERVICE            #language en-US "MpService"
+#string STR_HBRAP                 #language en-US "PciHostBridgeResourceAllocation"
+#string STR_PCIP                  #language en-US "PciPlatform"
+#string STR_PCIO                  #language en-US "PciOverride"
+#string STR_PCIE                  #language en-US "PciEnumerationComplete"
+#string STR_IPCID                 #language en-US "IncompatiblePciDeviceSupport"
+#string STR_PCIHPI                #language en-US "PciHotPlugInit"
+#string STR_PCIHPR                #language en-US "PciHotPlugRequest"
+#string STR_SMBIOS                #language en-US "Smbios"
+#string STR_S3_SAVE               #language en-US "S3SaveState"
+#string STR_S3_S_SMM              #language en-US "S3SmmSaveState"
+#string STR_RSC                   #language en-US "RscHandler"
+#string STR_S_RSC                 #language en-US "SmmRscHandler"
+#string STR_ACPI_SDT              #language en-US "AcpiSdt"
+#string STR_SIO                   #language en-US "Sio"
+#string STR_S_CPU2                #language en-US "SmmCpuIo2"
+#string STR_S_BASE2               #language en-US "SmmBase2"
+#string STR_S_ACC_2               #language en-US "SmmAccess2"
+#string STR_S_CON_2               #language en-US "SmmControl2"
+#string STR_S_CONFIG              #language en-US "SmmConfig"
+#string STR_S_RTL                 #language en-US "SmmReadyToLock"
+#string STR_DS_RTL                #language en-US "DxeSmmReadyToLock"
+#string STR_S_COMM                #language en-US "SmmCommunication"
+#string STR_S_STAT                #language en-US "SmmStatusCode"
+#string STR_S_CPU                 #language en-US "SmmCpu"
+#string STR_S_PCIRBIO             #language en-US "SmmPCIRootBridgeIO"
+#string STR_S_SWD                 #language en-US "SmmSwDispatch2"
+#string STR_S_SXD                 #language en-US "SmmSxDispatch2"
+#string STR_S_PTD2                #language en-US "SmmPeriodicTimerDispatch2"
+#string STR_S_UD2                 #language en-US "SmmUsbDispatch2"
+#string STR_S_GD2                 #language en-US "SmmGpiDispatch2"
+#string STR_S_SBD2                #language en-US "SmmStandbyButtonDispatch2"
+#string STR_S_PBD2                #language en-US "SmmPowerButtonDispatch2"
+#string STR_S_ITD2                #language en-US "SmmIoTrapDispatch2"
+#string STR_PCD                   #language en-US "Pcd"
+#string STR_FVB2                  #language en-US "FirmwareVolumeBlock2"
+#string STR_CPUIO2                #language en-US "CpuIo2"
+#string STR_LEGACY_R2             #language en-US "LegacyRegion2"
+#string STR_SAL_MIP               #language en-US "SalMcaInitPmi"
+#string STR_ES_BS                 #language en-US "ExtendedSalBootService"
+#string STR_ES_BIO                #language en-US "ExtendedSalBaseIoServices"
+#string STR_ES_STALL              #language en-US "ExtendedSalStallServices"
+#string STR_ES_RTC                #language en-US "ExtendedSalRtcServices"
+#string STR_ES_VS                 #language en-US "ExtendedSalVariableServices"
+#string STR_ES_MTC                #language en-US "ExtendedSalMtcServices"
+#string STR_ES_RESET              #language en-US "ExtendedSalResetServices"
+#string STR_ES_SC                 #language en-US "ExtendedSalStatusCodeServices"
+#string STR_ES_FBS                #language en-US "ExtendedSalFvBlockServices"
+#string STR_ES_MP                 #language en-US "ExtendedSalMpServices"
+#string STR_ES_PAL                #language en-US "ExtendedSalPalServices"
+#string STR_ES_BASE               #language en-US "ExtendedSalBaseServices"
+#string STR_ES_MCA                #language en-US "ExtendedSalMcaServices"
+#string STR_ES_PCI                #language en-US "ExtendedSalPciServices"
+#string STR_ES_CACHE              #language en-US "ExtendedSalCacheServices"
+#string STR_ES_MCA_LOG            #language en-US "ExtendedSalMcaLogServices"
+#string STR_S2ARCH                #language en-US "Security2Arch"
+#string STR_EODXE                 #language en-US "SmmEndOfDxe"
+#string STR_ISAHC                 #language en-US "IsaHc"
+#string STR_ISAHC_B               #language en-US "IsaHcServiceBinding"
+#string STR_SIO_C                 #language en-US "SioControl"
+#string STR_GET_PCD               #language en-US "GetPcdInfo"
+#string STR_I2C_M                 #language en-US "I2cMaster"
+#string STR_I2CIO                 #language en-US "I2cIo"
+#string STR_I2CEN                 #language en-US "I2cEnumerate"
+#string STR_I2C_H                 #language en-US "I2cHost"
+#string STR_I2C_BCM               #language en-US "I2cBusConfigurationManagement"
+#string STR_TREE                  #language en-US "TrEE"
+#string STR_TCG2                  #language en-US "Tcg2"
+#string STR_TIMESTAMP             #language en-US "Timestamp"
+#string STR_RNG                   #language en-US "Rng"
+#string STR_NVMEPT                #language en-US "NvmExpressPassThru"
+#string STR_H2_SB                 #language en-US "Hash2ServiceBinding"
+#string STR_HASH2                 #language en-US "Hash2"
+#string STR_BIO_C                 #language en-US "BlockIoCrypto"
+#string STR_SCR                   #language en-US "SmartCardReader"
+#string STR_SCE                   #language en-US "SmartCardEdge"
+#string STR_USB_FIO               #language en-US "UsbFunctionIo"
+#string STR_BC_HC                 #language en-US "BluetoothHc"
+#string STR_BC_IO_SB              #language en-US "BluetoothIoServiceBinding"
+#string STR_BC_IO                 #language en-US "BluetoothIo"
+#string STR_BC_C                  #language en-US "BluetoothConfig"
+#string STR_REG_EXP               #language en-US "RegularExpression"
+#string STR_B_MGR_P               #language en-US "BootManagerPolicy"
+#string STR_CKH                   #language en-US "ConfigKeywordHandler"
+#string STR_WIFI                  #language en-US "WiFi"
+#string STR_EAP_M                 #language en-US "EapManagement2"
+#string STR_EAP_C                 #language en-US "EapConfiguration"
+#string STR_PKCS7                 #language en-US "Pkcs7Verify"
+#string STR_NET_DNS4_SB           #language en-US "Dns4ServiceBinding"
+#string STR_NET_DNS4              #language en-US "Dns4"
+#string STR_NET_DNS6_SB           #language en-US "Dns6ServiceBinding"
+#string STR_NET_DNS6              #language en-US "Dns6"
+#string STR_NET_HTTP_SB           #language en-US "HttpServiceBinding"
+#string STR_NET_HTTP              #language en-US "Http"
+#string STR_NET_HTTP_U            #language en-US "HttpUtilities"
+#string STR_REST                  #language en-US "Rest"
+
 #string STR_IDE_CONT_INIT         #language en-US "IdeControllerInit"
 #string STR_DISK_INFO             #language en-US "DiskInfo"
 

From 89ed8b7770eee793c2375abb479d1db7eaa8a823 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Fri, 18 Dec 2015 07:39:06 +0000
Subject: [PATCH 310/525] ShellPkg: Fix ifconfig hang issue with incomplete
 parameters

This patch is used to fix ifconfig hang issue with incomplete
parameters. In addition, some error related output information
is added to increase the interactivity.

(Sync patch r19212 from main trunk.)

Cc: Leekha Shaveta <shaveta@freescale.com>
Cc: Carsey Jaben <jaben.carsey@intel.com>
Cc: Ye Ting <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Tested-by: Leekha Shaveta <shaveta@freescale.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19408 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellNetwork1CommandsLib/Ifconfig.c   | 61 ++++++++++++++-----
 .../UefiShellNetwork1CommandsLib.uni          |  7 ++-
 2 files changed, 51 insertions(+), 17 deletions(-)

diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
index fb6f57518422..f8dbc88cf842 100644
--- a/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
+++ b/ShellPkg/Library/UefiShellNetwork1CommandsLib/Ifconfig.c
@@ -828,6 +828,7 @@ IfConfigClearInterfaceInfo (
                             &Policy
                             );
     if (EFI_ERROR (Status)) {
+      ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
       ShellStatus = SHELL_ACCESS_DENIED;
       break;
     }
@@ -904,6 +905,7 @@ IfConfigSetInterfaceInfo (
                   &TimeOutEvt
                   );
   if (EFI_ERROR (Status)) {
+    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
     ShellStatus = SHELL_ACCESS_DENIED;
     goto ON_EXIT;
   }
@@ -916,6 +918,7 @@ IfConfigSetInterfaceInfo (
                   &MappedEvt
                   );
   if (EFI_ERROR (Status)) {
+    ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
     ShellStatus = SHELL_ACCESS_DENIED;
     goto ON_EXIT;
   }
@@ -974,6 +977,7 @@ IfConfigSetInterfaceInfo (
       if (IfCb->Policy == Ip4Config2PolicyDhcp) {
         Status = IfConfigStartIp4 (IfCb->NicHandle, gImageHandle);
         if (EFI_ERROR(Status)) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
           ShellStatus = SHELL_ACCESS_DENIED;
           goto ON_EXIT;
         }
@@ -989,6 +993,7 @@ IfConfigSetInterfaceInfo (
                                 &Policy
                                 );
         if (EFI_ERROR(Status)) {
+          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
           ShellStatus = SHELL_ACCESS_DENIED;
           goto ON_EXIT;
         }
@@ -997,23 +1002,13 @@ IfConfigSetInterfaceInfo (
       VarArg= VarArg->Next;    
 
     } else if (StrCmp (VarArg->Arg, L"static") == 0) {
-      //
-      // Set manual config policy.
-      //
-      Policy = Ip4Config2PolicyStatic;
-      Status = IfCb->IfCfg->SetData (
-                              IfCb->IfCfg,
-                              Ip4Config2DataTypePolicy,
-                              sizeof (EFI_IP4_CONFIG2_POLICY),
-                              &Policy
-                              );
-      if (EFI_ERROR(Status)) {
-        ShellStatus = SHELL_ACCESS_DENIED;
+      VarArg= VarArg->Next;
+      if (VarArg == NULL) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_COMMAND), gShellNetwork1HiiHandle);
+        ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
 
-      VarArg= VarArg->Next;   
-
       ZeroMem (&ManualAddress, sizeof (ManualAddress));
     
       //
@@ -1021,6 +1016,7 @@ IfConfigSetInterfaceInfo (
       //
       Status = NetLibStrToIp4 (VarArg->Arg, &ManualAddress.Address);
       if (EFI_ERROR(Status)) {
+        ShellPrintHiiEx(-1, -1, NULL,STRING_TOKEN (STR_IFCONFIG_INVALID_IPADDRESS), gShellNetwork1HiiHandle, VarArg->Arg);
         ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
@@ -1029,8 +1025,15 @@ IfConfigSetInterfaceInfo (
       // Get subnetmask.
       //    
       VarArg = VarArg->Next;
+      if (VarArg == NULL) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_COMMAND), gShellNetwork1HiiHandle);
+        ShellStatus = SHELL_INVALID_PARAMETER;
+        goto ON_EXIT;
+      }
+      
       Status = NetLibStrToIp4 (VarArg->Arg, &ManualAddress.SubnetMask);
       if (EFI_ERROR(Status)) {
+        ShellPrintHiiEx(-1, -1, NULL,STRING_TOKEN (STR_IFCONFIG_INVALID_IPADDRESS), gShellNetwork1HiiHandle, VarArg->Arg);
         ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
@@ -1039,12 +1042,38 @@ IfConfigSetInterfaceInfo (
       // Get gateway.
       //
       VarArg = VarArg->Next;
+      if (VarArg == NULL) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_LACK_COMMAND), gShellNetwork1HiiHandle);
+        ShellStatus = SHELL_INVALID_PARAMETER;
+        goto ON_EXIT;
+      }
+      
       Status = NetLibStrToIp4 (VarArg->Arg, &Gateway);
       if (EFI_ERROR(Status)) {
+        ShellPrintHiiEx(-1, -1, NULL,STRING_TOKEN (STR_IFCONFIG_INVALID_IPADDRESS), gShellNetwork1HiiHandle, VarArg->Arg);
         ShellStatus = SHELL_INVALID_PARAMETER;
         goto ON_EXIT;
       }
+
+      //
+      // Set manual config policy.
+      //
+      Policy = Ip4Config2PolicyStatic;
+      Status = IfCb->IfCfg->SetData (
+                              IfCb->IfCfg,
+                              Ip4Config2DataTypePolicy,
+                              sizeof (EFI_IP4_CONFIG2_POLICY),
+                              &Policy
+                              );
+      if (EFI_ERROR(Status)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
+        ShellStatus = SHELL_ACCESS_DENIED;
+        goto ON_EXIT;
+      }
       
+      //
+      // Set Manual Address.
+      //
       IsAddressOk = FALSE;
 
       Status = IfCb->IfCfg->RegisterDataNotify (
@@ -1053,6 +1082,7 @@ IfConfigSetInterfaceInfo (
                               MappedEvt
                               );
       if (EFI_ERROR (Status)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_SET_ADDR_FAILED), gShellNetwork1HiiHandle, Status);
         ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
@@ -1101,6 +1131,7 @@ IfConfigSetInterfaceInfo (
                               &Gateway
                               );
       if (EFI_ERROR (Status)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_IFCONFIG_SET_ADDR_FAILED), gShellNetwork1HiiHandle, Status);
         ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
@@ -1126,6 +1157,7 @@ IfConfigSetInterfaceInfo (
       while (Tmp != NULL) {
         Status = NetLibStrToIp4 (Tmp->Arg, Dns + Index);
         if (EFI_ERROR(Status)) {
+          ShellPrintHiiEx(-1, -1, NULL,STRING_TOKEN (STR_IFCONFIG_INVALID_IPADDRESS), gShellNetwork1HiiHandle, Tmp->Arg);
           ShellStatus = SHELL_INVALID_PARAMETER;
           goto ON_EXIT;
         }
@@ -1147,6 +1179,7 @@ IfConfigSetInterfaceInfo (
                               Dns
                               );
       if (EFI_ERROR (Status)) {
+        ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellNetwork1HiiHandle, L"ifconfig");
         ShellStatus = SHELL_ACCESS_DENIED;
         goto ON_EXIT;
       }
diff --git a/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni b/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
index 4c68e416406a..bc6acac0c12a 100644
--- a/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
+++ b/ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
@@ -63,10 +63,11 @@
 #string STR_IFCONFIG_LACK_INTERFACE           #language en-US    "Lack interface name.\n"
 #string STR_IFCONFIG_LACK_COMMAND             #language en-US    "Lack interface config option.\n"
 #string STR_IFCONFIG_INVALID_INTERFACE        #language en-US    "Invalid interface name.\n"
+#string STR_IFCONFIG_INVALID_IPADDRESS        #language en-US    "Invalid ipv4 address: '%H%s%N'\n"
 #string STR_IFCONFIG_DUPLICATE_COMMAND        #language en-US    "Duplicate commands. Bad command %H%s%N is skipped.\n"
 #string STR_IFCONFIG_CONFLICT_COMMAND         #language en-US    "Conflict commands. Bad command %H%s%N is skipped.\n"
 #string STR_IFCONFIG_UNKNOWN_COMMAND          #language en-US    "Unknown commands. Bad command %H%s%N is skipped.\n"
-#string STR_IFCONFIG_SET_ADDR_FAILED          #language en-US    "It failed to set .\n"
+#string STR_IFCONFIG_SET_ADDR_FAILED          #language en-US    "Failed to set address.\n"
 #string STR_IFCONFIG_ROUTES_SIZE              #language en-US  	 "\n%H  Routes (%d entries):\n"
 #string STR_IFCONFIG_ROUTES_ENTRY_INDEX       #language en-US    "%H    Entry[%d]\n"
 #string STR_IFCONFIG_SHOW_IP_ADDR             #language en-US    "%12s: %N%d.%d.%d.%d\n"
@@ -156,9 +157,9 @@
 "  3. Use '-l' to list the DNS and other address related settings for all\r\n"
 "     interfaces or the specified interface.\r\n"
 "  4. Use '-s <Name> static <IP> <SubnetMask> <GatewayMask>' with \r\n"
-"     static IP4 address configuration for all or specified interface.\r\n"
+"     static IP4 address configuration for specified interface.\r\n"
 "  5. Use '-s <Name> dhcp' for DHCP4 to request the IP4 address\r\n"
-"     configuration dynamically for all interface or specified interface.\r\n"
+"     configuration dynamically for specified interface.\r\n"
 "  6. Use '-s <Name> dns <IP>' must under manual policy.\r\n"
 ".SH EXAMPLES\r\n"
 " \r\n"

From 1d8a8d09eef4028fee03ab9660aab9398ebe6675 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Fri, 18 Dec 2015 07:39:35 +0000
Subject: [PATCH 311/525] ShellPkg/Shell - Fix ASSERT() when
 FvSimpleFileSystemDxe is used

When the FvSimpleFileSystemDxe module is included in a platform,
Simple File System Protocols are produced for firmware volumes(FV)
that do not have the same style device paths as file systems with
file names.  The ShellPkg has an assumption that the device path
contains device path nodes of type MEDIA_FILEPATH_DP and generates
an ASSERT() if any other device path nodes are encountered.  This
change removes the ASSERT() condition and instead returns NULL that
means EfiShellGetFilePathFromDevicePath() can not convert the
device path nodes that represent the file path to a Unicode string.

(Sync patch r19228 from main trunk.)

Cc: Jaben Carsey <jaben.carsey@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19409 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c | 51 +++++++++++-----------
 1 file changed, 25 insertions(+), 26 deletions(-)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index 9c370ccef5af..def3bd35c208 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -449,38 +449,37 @@ EfiShellGetFilePathFromDevicePath(
           ; FilePath = (FILEPATH_DEVICE_PATH*)NextDevicePathNode (&FilePath->Header)
          ){
         //
-        // all the rest should be file path nodes
+        // If any node is not a file path node, then the conversion can not be completed
         //
         if ((DevicePathType(&FilePath->Header) != MEDIA_DEVICE_PATH) ||
             (DevicePathSubType(&FilePath->Header) != MEDIA_FILEPATH_DP)) {
           FreePool(PathForReturn);
-          PathForReturn = NULL;
-          ASSERT(FALSE);
-        } else {
-          //
-          // append the path part onto the filepath.
-          //
-          ASSERT((PathForReturn == NULL && PathSize == 0) || (PathForReturn != NULL));
-
-          AlignedNode = AllocateCopyPool (DevicePathNodeLength(FilePath), FilePath);
-          ASSERT (AlignedNode != NULL);
-
-          // File Path Device Path Nodes 'can optionally add a "\" separator to
-          //  the beginning and/or the end of the Path Name string.'
-          // (UEFI Spec 2.4 section 9.3.6.4).
-          // If necessary, add a "\", but otherwise don't
-          // (This is specified in the above section, and also implied by the
-          //  UEFI Shell spec section 3.7)
-          if ((PathSize != 0)                        &&
-              (PathForReturn != NULL)                &&
-              (PathForReturn[PathSize - 1] != L'\\') &&
-              (AlignedNode->PathName[0]    != L'\\')) {
-            PathForReturn = StrnCatGrow (&PathForReturn, &PathSize, L"\\", 1);
-          }
+          return NULL;
+        }
 
-          PathForReturn = StrnCatGrow(&PathForReturn, &PathSize, AlignedNode->PathName, 0);
-          FreePool(AlignedNode);
+        //
+        // append the path part onto the filepath.
+        //
+        ASSERT((PathForReturn == NULL && PathSize == 0) || (PathForReturn != NULL));
+
+        AlignedNode = AllocateCopyPool (DevicePathNodeLength(FilePath), FilePath);
+        ASSERT (AlignedNode != NULL);
+
+        // File Path Device Path Nodes 'can optionally add a "\" separator to
+        //  the beginning and/or the end of the Path Name string.'
+        // (UEFI Spec 2.4 section 9.3.6.4).
+        // If necessary, add a "\", but otherwise don't
+        // (This is specified in the above section, and also implied by the
+        //  UEFI Shell spec section 3.7)
+        if ((PathSize != 0)                        &&
+            (PathForReturn != NULL)                &&
+            (PathForReturn[PathSize - 1] != L'\\') &&
+            (AlignedNode->PathName[0]    != L'\\')) {
+          PathForReturn = StrnCatGrow (&PathForReturn, &PathSize, L"\\", 1);
         }
+
+        PathForReturn = StrnCatGrow(&PathForReturn, &PathSize, AlignedNode->PathName, 0);
+        FreePool(AlignedNode);
       } // for loop of remaining nodes
     }
     if (PathForReturn != NULL) {

From bd3445a74754f3eeda9d2f2cc89803c27f046531 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:40:05 +0000
Subject: [PATCH 312/525] ShellPkg: Initialize the local pointer to avoid
 potential suspicious dereference.

1. Initialize the local pointer 'HandleBuffer'.
2. When 'LocateHandleBuffer' return error 'HandleBuffer' is expected unchanged, add code make sure this.

(Sync patch r19229 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19410 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
index 3f08cc84dc24..7b26e4d27f6e 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
@@ -317,6 +317,7 @@ ShellMmLocateIoProtocol (
   }
 
   *PciRootBridgeIo = NULL;
+  HandleBuffer     = NULL;
   Status = gBS->LocateHandleBuffer (
                   ByProtocol,
                   &gEfiPciRootBridgeIoProtocolGuid,
@@ -324,7 +325,7 @@ ShellMmLocateIoProtocol (
                   &HandleCount,
                   &HandleBuffer
                   );
-  if (EFI_ERROR (Status) || (HandleCount == 0)) {
+  if (EFI_ERROR (Status) || (HandleCount == 0) || (HandleBuffer == NULL)) {
     return FALSE;
   }
 

From a672cba6b879a6c7a30b05a0ee48d5bdc771554f Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Fri, 18 Dec 2015 07:40:34 +0000
Subject: [PATCH 313/525] ShellPkg/Mm: Fix build warnings

Fix build warnings for potentially uninitialized local variables
in the functions ShellMmLocateIoProtocol() and ShellCommandRunMm()
in the Shell implementation of the 'mm' command.

(Sync patch r19233 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19411 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiShellDebug1CommandsLib/Mm.c   | 24 ++++++++++---------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
index 7b26e4d27f6e..26a758b6cdd7 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/Mm.c
@@ -329,6 +329,8 @@ ShellMmLocateIoProtocol (
     return FALSE;
   }
 
+  Segment = 0;
+  Bus     = 0;
   if ((AccessType == ShellMmPci) || (AccessType == ShellMmPciExpress)) {
     ShellMmDecodePciAddress ((BOOLEAN) (AccessType == ShellMmPci), Address, &Segment, &Bus, NULL, NULL, NULL);
   }
@@ -615,18 +617,18 @@ ShellCommandRunMm (
         // skip space characters
         //
         for (Index = 0; InputStr[Index] == ' '; Index++);
-      }
 
-      if ((InputStr != NULL) && (InputStr[Index] != CHAR_NULL)) {
-        if ((InputStr[Index] == '.') || (InputStr[Index] == 'q') || (InputStr[Index] == 'Q')) {
-          Complete = TRUE;
-        } else if (!EFI_ERROR (ShellConvertStringToUint64 (InputStr + Index, &Buffer, TRUE, TRUE)) &&
-                   (Buffer <= mShellMmMaxNumber[Size])
-                   ) {
-          ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, FALSE, Address, Size, &Buffer);
-        } else {
-          ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ERROR), gShellDebug1HiiHandle, L"mm");
-          continue;
+        if (InputStr[Index] != CHAR_NULL) {
+          if ((InputStr[Index] == '.') || (InputStr[Index] == 'q') || (InputStr[Index] == 'Q')) {
+            Complete = TRUE;
+          } else if (!EFI_ERROR (ShellConvertStringToUint64 (InputStr + Index, &Buffer, TRUE, TRUE)) &&
+                     (Buffer <= mShellMmMaxNumber[Size])
+                     ) {
+            ShellMmAccess (AccessType, PciRootBridgeIo, CpuIo, FALSE, Address, Size, &Buffer);
+          } else {
+            ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_MM_ERROR), gShellDebug1HiiHandle, L"mm");
+            continue;
+          }
         }
       }
 

From 5fe2882981b8e4b9b179c7f3e0a58e96b5115a20 Mon Sep 17 00:00:00 2001
From: Jim Dailey <jim_dailey@dell.com>
Date: Fri, 18 Dec 2015 07:41:07 +0000
Subject: [PATCH 314/525] ShellPkg: Ease the shell's MAN file Title Header
 syntax requirements.

Prior to this change, the shell would not use a MAN file if the Title Header line was not strictly formatted.
For example, if the case of the command name in the file was not exactly the same as the case of the command name as typed by the user,
the MAN file would not be used.  Also, extra whitespace on the line would also cause the shell to ignore the MAN file.
This change allows "extra" white space and ignores case when looking for the command name.
It also ignores any path information for cases where the user enters a relative or absolute path to the EFI file.

(Sync patch r19290 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jim Dailey <jim_dailey@dell.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19412 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellManParser.c | 198 +++++++++++++++-----
 1 file changed, 150 insertions(+), 48 deletions(-)

diff --git a/ShellPkg/Application/Shell/ShellManParser.c b/ShellPkg/Application/Shell/ShellManParser.c
index 78b8decd8324..ce471cffdaf4 100644
--- a/ShellPkg/Application/Shell/ShellManParser.c
+++ b/ShellPkg/Application/Shell/ShellManParser.c
@@ -2,6 +2,7 @@
   Provides interface to shell MAN file parser.
 
   Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+  Copyright 2015 Dell Inc.
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -14,6 +15,8 @@
 
 #include "Shell.h"
 
+CHAR16 EFIAPI InternalShellCharToUpper (IN CHAR16  Char);
+
 /**
   Verifies that the filename has .MAN on the end.
 
@@ -444,23 +447,150 @@ ManBufferFindTitleSection(
   return (Status);
 }
 
+/**
+  Parses a line from a MAN file to see if it is the Title Header. If it is, then
+  if the "Brief Description" is desired, allocate a buffer for it and return a
+  copy. Upon a sucessful return the caller is responsible to free the memory in
+  *BriefDesc
+
+  Uses a simple state machine that allows "unlimited" whitespace before and after the
+  ".TH", compares Command and the MAN file commnd name without respect to case, and
+  allows "unlimited" whitespace and '0' and '1' characters before the Short Description.
+  The PCRE regex describing this functionality is: ^\s*\.TH\s+(\S)\s[\s01]*(.*)$
+  where group 1 is the Command Name and group 2 is the Short Description.
+
+  @param[in] Command             name of command whose MAN file we think Line came from
+  @param[in] Line                Pointer to a line from the MAN file
+  @param[out] BriefDesc          pointer to pointer to string where description goes.
+  @param[out] BriefSize          pointer to size of allocated BriefDesc
+  @param[out] Found              TRUE if the Title Header was found and it belongs to Command
+
+  @retval TRUE   Line contained the Title Header
+  @retval FALSE  Line did not contain the Title Header
+**/
+BOOLEAN
+IsTitleHeader(
+  IN CONST CHAR16       *Command,
+  IN CHAR16             *Line,
+  OUT CHAR16            **BriefDesc OPTIONAL,
+  OUT UINTN             *BriefSize OPTIONAL,
+  OUT BOOLEAN           *Found
+  )
+{
+  // The states of a simple state machine used to recognize a title header line
+  // and to extract the Short Description, if desired.
+  typedef enum {
+    LookForThMacro, LookForCommandName, CompareCommands, GetBriefDescription, Final
+  } STATEVALUES;
+
+  STATEVALUES  State;
+  UINTN        CommandIndex; // Indexes Command as we compare its chars to the MAN file.
+  BOOLEAN      ReturnValue;  // TRUE if this the Title Header line of *some* MAN file.
+  BOOLEAN      ReturnFound;  // TRUE if this the Title Header line of *the desired* MAN file.
+
+  ReturnValue = FALSE;
+  ReturnFound = FALSE;
+  CommandIndex = 0;
+  State = LookForThMacro;
+
+  do {
+
+    if (*Line == L'\0') {
+      break;
+    }
+
+    switch (State) {
+
+      // Handle "^\s*.TH\s"
+      // Go to state LookForCommandName if the title header macro is present; otherwise,
+      // eat white space. If we see something other than white space, this is not a
+      // title header line.
+      case LookForThMacro:
+        if (StrnCmp (L".TH ", Line, 4) == 0 || StrnCmp (L".TH\t", Line, 4) == 0) {
+          Line += 4;
+          State = LookForCommandName;
+        }
+        else if (*Line == L' ' || *Line == L'\t') {
+          Line++;
+        }
+        else {
+          State = Final;
+        }
+      break;
+
+      // Handle "\s*"
+      // Eat any "extra" whitespace after the title header macro (we have already seen
+      // at least one white space character). Go to state CompareCommands when a
+      // non-white space is seen.
+      case LookForCommandName:
+        if (*Line == L' ' || *Line == L'\t') {
+          Line++;
+        }
+        else {
+          ReturnValue = TRUE;  // This is *some* command's title header line.
+          State = CompareCommands;
+          // Do not increment Line; it points to the first character of the command
+          // name on the title header line.
+        }
+      break;
+
+      // Handle "(\S)\s"
+      // Compare Command to the title header command name, ignoring case. When we
+      // reach the end of the command (i.e. we see white space), the next state
+      // depends on whether the caller wants a copy of the Brief Description.
+      case CompareCommands:
+        if (*Line == L' ' || *Line == L'\t') {
+          ReturnFound = TRUE;  // This is the desired command's title header line.
+          State = (BriefDesc == NULL) ? Final : GetBriefDescription;
+        }
+        else if (InternalShellCharToUpper (*Line) != InternalShellCharToUpper (*(Command + CommandIndex++))) {
+          State = Final;
+        }
+        Line++;
+      break;
+
+      // Handle "[\s01]*(.*)$"
+      // Skip whitespace, '0', and '1' characters, if any, prior to the brief description.
+      // Return the description to the caller.
+      case GetBriefDescription:
+        if (*Line != L' ' && *Line != L'\t' && *Line != L'0' && *Line != L'1') {
+          *BriefSize = StrSize(Line);
+          *BriefDesc = AllocateZeroPool(*BriefSize);
+          if (*BriefDesc != NULL) {
+            StrCpyS(*BriefDesc, (*BriefSize)/sizeof(CHAR16), Line);
+          }
+          State = Final;
+        }
+        Line++;
+      break;
+
+    }
+
+  } while (State < Final);
+
+  *Found = ReturnFound;
+  return ReturnValue;
+}
+
 /**
   parses through the MAN file specified by SHELL_FILE_HANDLE and returns the
-  "Brief Description" for the .TH section as specified by Command.  if the
+  "Brief Description" for the .TH section as specified by Command.  If the
   command section is not found return EFI_NOT_FOUND.
 
   Upon a sucessful return the caller is responsible to free the memory in *BriefDesc
 
   @param[in] Handle              FileHandle to read from
-  @param[in] Command             name of command's section to find
+  @param[in] Command             name of command's section to find as entered on the
+                                 command line (may be a relative or absolute path or
+                                 be in any case: upper, lower, or mixed in numerous ways!).
   @param[out] BriefDesc          pointer to pointer to string where description goes.
   @param[out] BriefSize          pointer to size of allocated BriefDesc
   @param[in, out] Ascii          TRUE if the file is ASCII, FALSE otherwise, will be
                                  set if the file handle is at the 0 position.
 
   @retval EFI_OUT_OF_RESOURCES  a memory allocation failed.
-  @retval EFI_SUCCESS           the section was found and its description sotred in
-                                an alloceted buffer.
+  @retval EFI_SUCCESS           the section was found and its description stored in
+                                an allocated buffer if requested.
 **/
 EFI_STATUS
 EFIAPI
@@ -473,13 +603,10 @@ ManFileFindTitleSection(
   )
 {
   EFI_STATUS  Status;
-  CHAR16      *TitleString;
   CHAR16      *ReadLine;
   UINTN       Size;
-  CHAR16      *TitleEnd;
-  UINTN       TitleLen;
   BOOLEAN     Found;
-  UINTN       TitleSize;
+  UINTN       Start;
 
   if ( Handle     == NULL
     || Command    == NULL
@@ -497,59 +624,34 @@ ManFileFindTitleSection(
     return (EFI_OUT_OF_RESOURCES);
   }
 
-  TitleSize = (4*sizeof(CHAR16)) + StrSize(Command);
-  TitleString = AllocateZeroPool(TitleSize);
-  if (TitleString == NULL) {
-    FreePool(ReadLine);
-    return (EFI_OUT_OF_RESOURCES);
+  //
+  // Do not pass any leading path information that may be present to IsTitleHeader().
+  //
+  Start = StrLen(Command);
+  while (Start
+         && (*(Command + Start - 1) != L'\\')
+         && (*(Command + Start - 1) != L'/')
+         && (*(Command + Start - 1) != L':')) {
+    --Start;
   }
-  StrCpyS(TitleString, TitleSize/sizeof(CHAR16), L".TH ");
-  StrCatS(TitleString, TitleSize/sizeof(CHAR16), Command);
 
-  TitleLen = StrLen(TitleString);
   for (;!ShellFileHandleEof(Handle);Size = 1024) {
    Status = ShellFileHandleReadLine(Handle, ReadLine, &Size, TRUE, Ascii);
-    if (ReadLine[0] == L'#') {
-      //
-      // Skip comment lines
-      //
-      continue;
-    }
     //
     // ignore too small of buffer...
     //
-    if (Status == EFI_BUFFER_TOO_SMALL) {
-      Status = EFI_SUCCESS;
-    }
-    if (EFI_ERROR(Status)) {
+    if (EFI_ERROR(Status) && Status != EFI_BUFFER_TOO_SMALL) {
       break;
     }
-    if (StrnCmp(ReadLine, TitleString, TitleLen) == 0) {
-      Found = TRUE;
-      //
-      // we found it so copy out the rest of the line into BriefDesc
-      // After skipping any spaces or zeroes
-      //
-      for ( TitleEnd = ReadLine+TitleLen
-          ; *TitleEnd == L' ' || *TitleEnd == L'0' || *TitleEnd == L'1'
-          ; TitleEnd++);
-      if (BriefDesc != NULL) {
-        *BriefSize = StrSize(TitleEnd);
-        *BriefDesc = AllocateZeroPool(*BriefSize);
-        if (*BriefDesc == NULL) {
-          Status = EFI_OUT_OF_RESOURCES;
-          break;
-        }
-        StrCpyS(*BriefDesc, (*BriefSize)/sizeof(CHAR16), TitleEnd);
-      }
+
+    Status = EFI_NOT_FOUND;
+    if (IsTitleHeader (Command+Start, ReadLine, BriefDesc, BriefSize, &Found)) {
+      Status = Found ? EFI_SUCCESS : EFI_NOT_FOUND;
       break;
     }
   }
+
   FreePool(ReadLine);
-  FreePool(TitleString);
-  if (!Found && !EFI_ERROR(Status)) {
-    return (EFI_NOT_FOUND);
-  }
   return (Status);
 }
 

From ff8da347261ec80529f6c2398d9905a289b81ba3 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Date: Fri, 18 Dec 2015 07:41:39 +0000
Subject: [PATCH 315/525] ShellPkg: Fix a bug in smbiosview PowerSupply
 Characteristics.

Fix bit shifting when isolating the Characteristics of Power Supply information.

(Sync patch r19291 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19413 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c       | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
index e348c6f25c3a..3f99dc4825dc 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/PrintInfo.c
@@ -3100,7 +3100,7 @@ DisplaySPSCharacteristics (
   // Bits 13:10 - DMTF Power Supply Type
   //
   ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_TYPE), gShellDebug1HiiHandle);
-  Temp = (Characteristics & 0x1C00) << 10;
+  Temp = (Characteristics & 0x1C00) >> 10;
   switch (Temp) {
   case 1:
     ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_OTHER_SPACE), gShellDebug1HiiHandle);
@@ -3141,7 +3141,7 @@ DisplaySPSCharacteristics (
   // Bits 9:7 - Status
   //
   ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_STATUS_DASH), gShellDebug1HiiHandle);
-  Temp = (Characteristics & 0x380) << 7;
+  Temp = (Characteristics & 0x380) >> 7;
   switch (Temp) {
   case 1:
     ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_OTHER_SPACE), gShellDebug1HiiHandle);
@@ -3170,7 +3170,7 @@ DisplaySPSCharacteristics (
   // Bits 6:3 - DMTF Input Voltage Range Switching
   //
   ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_INPUT_VOLTAGE_RANGE), gShellDebug1HiiHandle);
-  Temp = (Characteristics & 0x78) << 3;
+  Temp = (Characteristics & 0x78) >> 3;
   switch (Temp) {
   case 1:
     ShellPrintHiiEx(-1,-1,NULL,STRING_TOKEN (STR_SMBIOSVIEW_PRINTINFO_OTHER_SPACE), gShellDebug1HiiHandle);

From 147f4c29a2b1903b160cdda1693d35e3a6a8ee32 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Date: Fri, 18 Dec 2015 07:42:12 +0000
Subject: [PATCH 316/525] ShellPkg: Use %p for smbiosview SMBIOS table
 addresses.

(Sync patch r19293 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19414 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmbiosView/SmbiosViewStrings.uni                         | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni
index 24fca87adfa2..9811542013c2 100644
--- a/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni
+++ b/ShellPkg/Library/UefiShellDebug1CommandsLib/SmbiosView/SmbiosViewStrings.uni
@@ -2,6 +2,7 @@
 //
 // Copyright (c) 2005 - 2015, Intel Corporation. All rights reserved.<BR>
 // (C) Copyright 2014-2015 Hewlett-Packard Development Company, L.P.<BR>
+// (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 // This program and the accompanying materials
 // are licensed and made available under the terms and conditions of the BSD License
 // which accompanies this distribution. The full text of the license may be found at
@@ -78,7 +79,7 @@
 #string STR_SMBIOSVIEW_PRINTINFO_DOCREV                         #language en-US "SMBIOS Docrev:        0x%x\r\n"
 #string STR_SMBIOSVIEW_PRINTINFO_NUMBER_STRUCT                  #language en-US "Number of Structures: %d\r\n"
 #string STR_SMBIOSVIEW_PRINTINFO_MAX_STRUCT_SIZE                #language en-US "Max Struct size:      %d\r\n"
-#string STR_SMBIOSVIEW_PRINTINFO_TABLE_ADDR                     #language en-US "Table Address:        0x%x\r\n"
+#string STR_SMBIOSVIEW_PRINTINFO_TABLE_ADDR                     #language en-US "Table Address:        0x%p\r\n"
 #string STR_SMBIOSVIEW_PRINTINFO_TABLE_LENGTH                   #language en-US "Table Length:         %d\r\n"
 #string STR_SMBIOSVIEW_PRINTINFO_TABLE_MAX_SIZE                 #language en-US "Table Max Size:       %d\r\n"
 #string STR_SMBIOSVIEW_PRINTINFO_ANCHOR_STR                     #language en-US "Anchor String:        %a\r\n"
@@ -452,7 +453,7 @@
 #string STR_SMBIOSVIEW_SMBIOSVIEW_SHOWTYPE                      #language en-US "ShowType    = "
 #string STR_SMBIOSVIEW_SMBIOSVIEW_TYPE_HANDLE_DUMP_STRUCT       #language en-US "Type=%d, Handle=0x%x\r\nDump Structure as:\r\n"
 #string STR_SMBIOSVIEW_SMBIOSVIEW_INDEX_LENGTH                  #language en-US "Index=%d,Length=0x%x,"
-#string STR_SMBIOSVIEW_SMBIOSVIEW_ADDR                          #language en-US "Addr=0x%x\r\n"
+#string STR_SMBIOSVIEW_SMBIOSVIEW_ADDR                          #language en-US "Addr=0x%p\r\n"
 #string STR_SMBIOSVIEW_SMBIOSVIEW_ENTRYLEN                      #language en-US "Entry Length: 0x%x\r\n"
 #string STR_SMBIOSVIEW_SMBIOSVIEW_REFERENCEDHANDLE              #language en-US "Referenced Handle: 0x%x\r\n"
 #string STR_SMBIOSVIEW_SMBIOSVIEW_REFERENCEDOFFSET              #language en-US "Referenced Offset: 0x%x\r\n"

From c3cf4d47580c9c90359e60cc3e47af86d17db3f4 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 07:42:43 +0000
Subject: [PATCH 317/525] ShellPkg: Fix the 'bcfg' command ASSERT when use some
 invalid parameters.

'bcfg boot mv xx yy' command will ASSET when xx is larger than the count of boot options.
This patch correct the order of ShellPrintHiiEx parameters to fix the bugs.

(Sync patch r19295 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19415 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.c b/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.c
index eeee055cdb1b..142504a72dbe 100644
--- a/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.c
+++ b/ShellPkg/Library/UefiShellBcfgCommandLib/UefiShellBcfgCommandLib.c
@@ -2,7 +2,7 @@
   Main file for BCFG command.
 
   (C) Copyright 2014-2015 Hewlett-Packard Development Company, L.P.<BR>
-  Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -1379,7 +1379,7 @@ ShellCommandRunBcfg (
             Status = ShellConvertStringToUint64(CurrentParam, &Intermediate, TRUE, FALSE);
             CurrentOperation.Number1     = (UINT16)Intermediate;
             if (CurrentOperation.Number1 >= Count){
-              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_NUMB_RANGE), L"bcfg", gShellBcfgHiiHandle, Count);  
+              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_BCFG_NUMB_RANGE), gShellBcfgHiiHandle, L"bcfg", Count);  
               ShellStatus = SHELL_INVALID_PARAMETER;
             } else {
               CurrentParam = ShellCommandLineGetRawValue(Package, ++ParamNumber);

From 553e1a5738c5f8eb0423de66218330e99de4aebc Mon Sep 17 00:00:00 2001
From: Paulo Alcantara <paulo.alc.cavalcanti@hp.com>
Date: Fri, 18 Dec 2015 07:43:13 +0000
Subject: [PATCH 318/525] ShellPkg: Fix unhandled value in switch statement

This patch fixes the following compile error under GCC 5.3.1:

/home/pcacjr/work/edk2.git/ShellPkg/Application/Shell/ShellManParser.c:
In function 'IsTitleHeader':
/home/pcacjr/work/edk2.git/ShellPkg/Application/Shell/ShellManParser.c:502:5:
error: enumeration value 'Final' not handled in switch [-Werror=switch]
     switch (State) {
     ^
(Sync patch r19304 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Paulo Alcantara <paulo.alc.cavalcanti@hp.com>
Acked-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19416 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellManParser.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ShellPkg/Application/Shell/ShellManParser.c b/ShellPkg/Application/Shell/ShellManParser.c
index ce471cffdaf4..f12775f86585 100644
--- a/ShellPkg/Application/Shell/ShellManParser.c
+++ b/ShellPkg/Application/Shell/ShellManParser.c
@@ -564,6 +564,8 @@ IsTitleHeader(
         Line++;
       break;
 
+      default:
+       break;
     }
 
   } while (State < Final);

From cfbedffeef8f5cc480429571ef84fa7dbba8b9b2 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 18 Dec 2015 08:31:33 +0000
Subject: [PATCH 319/525] ShellBinPkg: Ia32/X64 Shell binary update.

The binaries of ShellBinPkg are generated with ShellPkg project 19307. The binaries are built with no debug information by building with "RELEASE" target.

(Sync patch r19320 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19417 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellBinPkg/MinUefiShell/AArch64/Shell.efi | Bin 387808 -> 382304 bytes
 ShellBinPkg/MinUefiShell/Arm/Shell.efi     | Bin 330208 -> 330336 bytes
 ShellBinPkg/MinUefiShell/Ia32/Shell.efi    | Bin 338944 -> 347552 bytes
 ShellBinPkg/MinUefiShell/X64/Shell.efi     | Bin 382528 -> 392832 bytes
 ShellBinPkg/ReadMe.txt                     |   2 +-
 ShellBinPkg/UefiShell/AArch64/Shell.efi    | Bin 887136 -> 873664 bytes
 ShellBinPkg/UefiShell/Arm/Shell.efi        | Bin 769536 -> 769088 bytes
 ShellBinPkg/UefiShell/Ia32/Shell.efi       | Bin 801824 -> 810496 bytes
 ShellBinPkg/UefiShell/X64/Shell.efi        | Bin 896800 -> 907264 bytes
 9 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/ShellBinPkg/MinUefiShell/AArch64/Shell.efi b/ShellBinPkg/MinUefiShell/AArch64/Shell.efi
index d5756e1013426f55223d34615a762ce87dfaeed7..9faeaff581bccfcf17665ecc7e58545b427e2150 100755
GIT binary patch
literal 382304
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

literal 387808
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
K)c~;k`~LyIR~7jH

diff --git a/ShellBinPkg/MinUefiShell/Arm/Shell.efi b/ShellBinPkg/MinUefiShell/Arm/Shell.efi
index 8a7d7e5b79461cd49e52995e99316ecdfd233f48..695f72a3f1bf0ec12d0c63c91a9839a1e09b20d1 100755
GIT binary patch
delta 140725
zcmZ_134B!5**|{nGHbR8Ye)i2W(W>Uz=5C!a0vl!W|ANvRZ)-*;&Q{HAZ``y1aOI4
z4Gii)z(&zZz$H`4uZ&1TcWZ0k3ECEj*0E~i)_S67?qs(A_qj8P^zHlS^SQZq&OOg_
z&vVXmp7U(y5DSiq?Hbj#x5EEVnY9?0{;xu0%#N$&6IuUl$6x!7;*kY@t3iK3rPdwA
zV|SdbDq#PXnZKN|mH(32BTvtGLTns4{q`I0z8zHvC*i?8_^2@cLc&ithwg-C=wB^k
zC#K(a<N90IpgzzIp=JLL{#{T4Mx{V0Q%8m$QTNmpzCA_pD2x|t+55!7DT=I@tc=^0
zjmHJ=#^d+qi)<Xew(*Dz$UHtbVN|Sqef&U}O&@v2%6}YR5?;(%t(6~)yTUV-y}s<P
zHSzX_+OK+x_js+`9iO7u0sHfmF#zDphk>^a13#t%Kb`|#7=Nr`@!2moJqq9g9k_ts
zH%K4$48yJ&hP_3H{b3IFy!d_i@CU{B0`^M~W>*UM9Xjj?zy`9dUN{WAL<hb#2W*Mo
zf)9VSX#;?Ja=;(!z-P4~iq9K{ovFk6bFiOl-^YjhidO;lunt?udvw^p4#Qdk!@#3-
z;H5d>x3ner@Hd+l1NccD*v2nN6U9e|fj`%Vy82s<y1Fh0`>Hk%AO2TyEnx4`VMp-O
z8o}-vh6R3om;zRQN(Zja0q@Xe;=|ge834XU2Oh-*{loVT1HU@_;n#H7NjccfniC)X
zy4V5OxjJkaza~Q;UNsE6V;FWX!3LDkIp8a`QTT9T(?|f1*X+s^Wdbit$^fp_j)qy)
zXfW62Vc;JE*r6D6uor0td^lb#dyjvzvDU&<-5Za0=85c0Tz|)vW!4G&aFQBRGTfL(
zEilxDSLu`tb$=1MzxJ!@ip5?F|67Kbri}j&D6#Ot%+R<`8*WUE4x8<M3-8ZR_g`31
z3)qMbJBlaJgBJeoFf8zAXGwsU>cH9VxA3<!GXXriVg`WQb>I>F0<_w~e~|;G4`hKY
zJei?!&vw6sAIUh;gGHMhfW1$LE#@OJ?iSuL4Ey#l?B8|RK(_lW{OQaneE718kpTXF
zhPuCyx5s4wZ_8x6pFS}3;S&HJ>V6CVL58}&u41VBFZ*BJFY;d<r6I8Jm4KTRaWs6d
zf*R@0SOR=m=I*dlT^E_yaAn1K6jo$RF&9SZZ^_Q`Z4+Dox+Ptyx?An;ucH=sf0RwO
zt5&`%sf8<5s`o^a^|M-`<^s*;vAZoj+0y%SrInh^|IfZ`**)jfw75TuGW*8k0oJ|j
zdXfF4P-LfYWf^6RvOY{>Zsns>wP7XPQD;2u(Zq{axy7FQ%XuFGGFGEYKnwpmO*D;b
zc)nsBn*Xb`g@1;U%E*|87b-@fB!ZF;(w^{3b@JOI8h%nygtAxD;;fhIMn#<g<xpM0
z$<o&6`aObWiuJUE+l6_v$4wDVe}Af>N38y`Pq5b<-(MH+VYsvIFVRS9Y<`i*&cije
z(cR!V!X}le4|Um8(IM;<53*fvYoR5R8z=kN+A{S(eMep8BI_CV`o%mm!=acJ798O$
z;!6hY%FI|`Vx!b4h91{O)yl!m&X=|P+LyILkD>oDNp2q3&{03Gk-6lcu~!Tk`rD+@
z4N|Av+)+P5FI~(>N_uU)l{#&W1r7ABK!0b@%kmq|dYP%qgT{Nlkl8F;Rk&&&6=}%|
zFf$gD8ygwJir6yhQ<;_E+IVCH?~5BS_N^IN5ftKrk25951jh$zhic%D>eHzvot=sn
zzAin)n0KP<XDVi0E?D^aX%iUp%?cyBd>~b!<GCyI7kvP;@*$AzPSX+bkkBR^n6H_~
zkHZ4-O}uNch1Xi7uIn^8!I%wWJ;Ik6_&j3{3wGOao6oLf20qF#*FaC9{`_}5_xI%M
z&!_PGd5=|pK8fd#d(8UtpEAr-(oOJtu!`=&<q6y&vgh#d60W1TrhS^J-=;hadfx==
zz1Gi)3_UK;Fm{FuG(44p96)(QFQ0_juIRJ<k(8rJtaMz?&Jzzhd`?w(l06L`I8m*Z
zD6#skerBH1>r|zKVu;?9`iMVHsMX+&0KFX9D~0lS?V#BHrp8!Fa~_{F_y;_RA*VW1
zEkgCZOXeykP@R5T>31!2+LVs^T1D<U{t17Gb<YDc5@TM2JB>4q@y5qR*7k_V9&Th6
z(>~>kAL^10KIAP^-_~C8gzA~=#8+Zq>-|k^^8JgQTaGFcZ;@{O`u8K9o7Zf)^=l@r
z*=%q+SI<?iRiCPB;s0nUQx|{spj8Up<6EXpULvVel~8?2#JOcY7o<5cDKu5N-6yF-
zWuoNK%Ql`<CQFm`vh~Adf%)7lmFtD-aN&GzlSb%eH=I*um&|&ZUoW%kAFh?0n}d4k
zO1(6O(mTrMgAnKDxoVlZXTcc_jO}84Ym3w>cg}G`8<Nc3qNh|T;^k=;aNXW3w@+7`
zt2gRs8gt0k=v1xQd}B;-Oi}8wCbkZW%94mvpT)wHG>aw7;!WB-uRq47FO8Bctb@X4
z<x<Ae=wHoTHPO;7!iCm;*}7Y)<Dyu)nK{IrBVwmC<`Fv${Uxka4KU{wn$=E~3VA`|
zv{uq}49qn;DqKj_R;bU^O*(1e4<<VzWs8{eyoM}bAs-lgCs+4xJ!*4F*vkK${;f8u
zYod2tY=1Lz_w|VF%>7Zc9L(E4qa4gTC;48VaA8TGV+(XwZWBeGkwyf<hQ^ZBELNhJ
zh>@Pi3JK4Hx^Q4C!9>5ptau04XSj?7BD3R~gUgF+6|VKT?!iTBb>VoCS#ZBC$BZPR
z+rs&FEBB>InmCi5@U(~#O^VMmph^9Sz)ODUxOlucWmjsBi?%Em?}aj5bHtz!XjPh4
zE+aszB831gSXzks?<A<hAB8e%<xS}hzlDF3s0r^^-4PNwMN0|&uM!oC0V+uiRFeGT
z{~nXY?Z7t<==fPhUZBySFm;963%-?=jbRtoHg}qqo>lP*{GFI)E|*{OmUNT+uQ^Uy
zK2fM0F)BYfEI2$$Da6vjq~MU15}yY`>G`BVsll7kKGBmI*q1aZ?C=d(e9R{WN0G0i
zJTnkX9;h36^8WG>v5vZc?c{8T#mvBuldqRA3Dbui_^^nwS)lspAd6Kgla)U}WNOE6
zxf8>JuBN&CKo=<%_a;2y>5&IPad7E_ptvF70R{o0dj$WXwpA%P%=$~rwW!$%RZdXo
z$(TA3`9P(58{(#bqK1!^8Qju)7ilsUSSi|p9{4~rEcie@TK=!T3LRvBGKL0V>X;>d
zb4ph3kIX;=t$aty+%KDr`t!9Z6Y5&|Re1lCV>K~nD|3GyC4yelY8OhU>FJ2pqEx`3
zA-ln(M8g+p0rBEW_sAZ4xmmjiDnz9_zvtWr8Gu6K(^6LcG#XW*94(LaQSFtQ;E_MC
zl_Pzouo@whOH*URHMlPVC$XwP)XKdnX5SJ+!#`VYUi{gWc@npzwkagk-O<-DyXGIB
z6KI$RMZ?19r>;=4PrK3=<jS5%FTtmIk~ya;Vo-2C{)vUnR-9;mA@?QcDA(Z0!Y8Me
z;G?6_9P8(`)@UEC4P`yV316m%Acf#;#oh?hE;zBVkh_Or&8Yyj_?skA^i|TMRK_g*
zC6>ipuzG>IC((jN(bM!KbN!`9Y@4dQrO6$$l~bD8L+DOv`JO^94I_*tv-ST3$PfAq
zxhZ{FZdMWR{16vSOQvQ9-b))Sid`k)@v~&G#a13@9Hd!xG5G1Z)pNm5;|48!-e3(B
zM0cbHrTbT3h|<DAHd%i80-s%7sF^pAfgmZih(i?=Q_O=>E5Ar{s56x9r7LVMbk-gX
z3u8!lx|lD7waQ$c9^&|mFtsl0m0zw_7HaYa;efbjN&uDb*G!7g=8A}+18CQEN%868
zSecHr049y7R4c-PLdabMYK2hChFT3t@yRS53o%+wzs)-`Hdk?|v-P?wG@&i~_Co!w
z7%~IKlN8#S-RU=Uai~Ub>RkkFWDOpM#MnsmQ!)Qykhv}ehoUz!Syguy_;ilDsHYrS
z1*A--^%xq6r{ft5H)RCZu5QUL+s}*Hl`+0T-Ucn69fswSmR+MU4Irt~gh%X@Yrw&h
zig7GxoTtf`<OlejDSL#N;U5XXZUO=;e=i~0MKCdo$#${JcAOe#z5%j#q{uGDwHb}H
z@Qv{<2oDQ?Lq{#tWSeM=7GuzUy~&0_yC80e73s}f3zg`ro`OXc3bU_M%hrYJjT0=o
zej3Qk5Oy&KEpB<vLY@Xkie1pPySL;xh(1mtZ~(HIsTTg*G$wq4wJ}$H)U66ZVK1w?
zBs!^;Rn3XI@cu|zaEeMZhC$%p$9Vs{cf5~<EPP6awTJ5ZdhAZAh3y&VUDjgZKTgX5
zg@D@A@&clKDww4!e1qBGEN-X(ZJEURY7OpJr{^e=E=Mf<u9Qoq(QHgi_p?bXW@=&~
zJAThk2r=2q(1VgbzW0OeAHhYkn;m(yOH%S0CReD6nVZ4lBjWb3;AmC?Ca=sVrRmXt
zCkTIgURDF`{_9+kJp}|ExJVn#3@nFFCNpp&sH*6trzQGtAAXPPg}l|Wv&IS~QC@Au
z0Ne?qIx}!d9J(lo>`dD*V3~mxu=O$nGvf?e=^p~QZhjCS*?8o^E>>xLNmPu=0xkbK
zH%vnEoeZR<wxi)mKIrCY7B;j%*j36;W(JOA<O$PzNg^d7EFT|~+GWh5k>L{b<nh6A
zUU$r+7=jl5uM`c5+-bm&Je^{$QN3~~Gw>Lgv#2K^x08`l)HD@liV!SpEL+clW^h6x
zQE1N$+>nt%BrKj9WKJn4>(i(WW{gqik)P$dw-8-SJc3mUOX`DNMam8(gl2_d09g5L
z@W3$F^-)==RAy=7+|A)tZflRT)#*0%xB{s5462dcY33JXpvCqS^ygdULvLxUgE?kE
z7>ZyXc|uihL4TfT=&Zp6y>(EYFsb(_>EuzvzJl;V&KAC*u_gPoJkQ9m0o0i@#r$l-
z&~6TwD@C#Skz)RNa(Q?}qhZhJspjr-#Sp8(AiNb1z=ntxG+lx2p%0A**x!=1SXD9u
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
Vo#C|NBIJjC5Uy}~4{}dk{r}ufjcot`

delta 140594
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

diff --git a/ShellBinPkg/MinUefiShell/Ia32/Shell.efi b/ShellBinPkg/MinUefiShell/Ia32/Shell.efi
index 154171811e70c20ebee9af11b471120829c32054..293547e09159a47d78b44715f15a3e43c24f818b 100644
GIT binary patch
delta 120067
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
J#aaJ3{s*10cn$yn

delta 111791
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
T1@;CWp>Uqwp>*5Xm23SMcJ>?&

diff --git a/ShellBinPkg/MinUefiShell/X64/Shell.efi b/ShellBinPkg/MinUefiShell/X64/Shell.efi
index e7370161693f522520fc3b3499258aa7b596f22d..e79060ca5eaccff4b96eaf51828009ab8f7eed0d 100644
GIT binary patch
delta 125926
zcmZ@>3tUvi_g@ySBDyY$i->}&pyC5X@c|;b2&)%e6d&aKnUc>mT@+GV3NY8}8akDa
z%6Da%X-^ejC@LTdKJr~Zt;`1ZXK4>3EBF6Bb1z8s`|~O9oik_7oH=vm%$YMYcMCsg
zn*CSP{4eTcAJyw7_gQnjvp)MV^YfZm=hp9%F4t#G!f;mT<=b-!vbX4UIzppo?LV_l
zH>2~kDfTG<o(u5SnUCvrx5Se@_6qL#WfQ<JOS)UyvvyI7PS?M4rdsxPL!Iu{T}h`i
z(vuC*2RF?1!7KRKBA#rK-r;!VoTQUo@s?G1<dtSLb`6WRxuklOR4Vvkw@xQJLlyuj
z;ZQ7UlJjn4GzP+aAS5VX5Y7g|Q4%N1PH8w1%PY)i28?uIxKjHO#$tgXbw@5TT<57q
z!|D@yUGxQqC*R_Q@~+5U(?IbEs>qg=Dw`{QDAJ&nWwt4WvT`XwDd#)y5~krKD5ogJ
z$;uZzlqkpchy%%tAkc2?612Aiqo6lv@xM^S=4#Vg5c6b(+LU4tO9ruV$VpKg#RbD4
z{$%A0zev=T#L;NSs}*WH0zq=dc4|i#)cXS7_-=tE%>o88a|qF8xP6k^Qr(o0&wxm*
zqc&olYWty*YAY@nO)^x<c)Cg^%&5{yQt6yM%3kzo*6u?Md7_5gRz?1{T-4b>#f>Z^
zT*tE-?lcYe4$`tBZC7zW#RL3>K+9_QQ>5i;<|}IExx!kRF2e&N@9eRSy3*NWyZYFn
zKJwH@L-pYSrUN+l@#GyJqF$H5hu&MN?=rmysPA8(E?!rCPbK&tzXCtD$5OygN$=oa
zFUyJ^oAAVA10JATr9OVgBV!=ibndKZe=>nxhFPbGZFW^^;TXwP;XbYP<Qb&-&D~!A
z?1WAlUb=?2gYX89)c+IDN5h+`;VnfP{Cti2c~Jhp&>LU+UafzQhM&UOlvT~xraIw{
z=TQdZ$}aIa;owIxOsN5kQvq@fU=RTO#T+l)Vf1A-DNuXaW!gI#tyT(^v%EK|fzA~J
zfcD?QqhJqe<nIFx$}J(6Xb)8;N8ga+;+rDfY+*-PNviJ)Vs?|Pl<=@W1nw_q+1R?l
zBXyL@X+we~3S-VxGrKE{m@Vh^qg5ex03!h^BQiL7^N!%8y~;^{;^Z^pqyac#*}Fs7
zcXgXP)Xdd*@RPuoW240oJ*>hPQK2+6l<%ZWrG9!&tl3@%|JKV$<@Z&X>>8%GxqNiI
z>KmQTeO*@K$edh6W_r%jfsf7h07@4L<TwGUmk~msy?0>sh^W(^@EA|N<qliz+gCq_
zvvS{I;gir#<yz9pV!p)V@t|#A0+O&_8*j35pO1=RiS>HO025Xl!h#4BWtXf603{X?
zjkuzPe%zNbmHX~i{PANVHdv4BakU8E=hs+aJzLA{QmR&Z5f7VUm?cul5jL0ApQL+?
zb@Xf5y?>cr=NjDD8eN!V+*g`Y>XDsE;b!GLKReV*7hPESp%~^?f1As&2dGeooeF!w
zFRI=PYHFUs_W4EBPg7HU74*lN*F);{P}6}5^RM5_VJ#s>QZ2G_+A};V`W~8QT(QWP
z`ZV(EQs}ocviE86h{GdUIcr%FxfSqJk{)R<xmc=;r#E%pqaV?EE<+J=`48%QKjiUm
z=v|S%EtYiF=u$K%`a*Q6CtpXl-k})IP%SRgcT~)O6;<5hz<6Tns^H~op^wrgl>XSu
zrdTY=N=br;7&g5G7+U>p5fL!7fb9Z(emewu>XhaZS<F91`CtIJ!(VpgYedUs`nE(A
zD8s|S?_esET|J%|hh9HQSePPSLIPzqqkTC6T6E)U8rLTZ-UHWU#7962<=Ds-ppnr8
zOuP)13*Of<ds3#$un?JiQy$)*&`JiaS2S9Cy>t#itgcEdshZdlBKDC+>@KkRYn|1>
zr%of6iOL|2%03P6IN^mX`xjno4X;4M+emno=wXuZIO^^f;R5jNl_=>ljR6l}eGsw!
zV%>kSe)*OvhI1ORAt0tmZx-uy2mK+uofc!>c|6hG_fN7-h9G_061LwE+VS!TNEGTD
zft>e&EmWB&*{Dt_YwVLuS26Qy7+9|v<tT<{Pcn1EwvGWP;T#zrl|&Sji%J=kNTqOY
zuovn-0{g$yoY57GH%He+U*IRg|Hb;@n=0#nYOMD_Q{e3cpCVnW;79Jktn`(Y5kayt
z*gs*f7eDc$M#CZIZXxt6jR^Ew^xOlaW#u9f_#6ae<s4oiSZ@14r^_w0?}eIvbdt2`
zg1sBq%R^I%_JKtj?I)x|HPU_>>DQ4yNK?5osf;)NNvBJ44c-h*8%5GmN~qE*zUU0-
zxC}#8va)i8PyRRMlmAg$-dLj?FPJtw4^IX3;>NPA#$anxl~TkLN?!k_l&(<<)F}N2
zX>=1S5(DweF>Cz;9f!&UOTUg0EhU!T$sjBm&ebD|^w(FT6|B+97PKmO3p5q3rE$eG
z=qN=x4Bv34e?~(dv0PA5q+Ng{?87{EBXdYXZZWdv{!V81sv_l|&^xGbW=~|;yF%H%
zKMrZR4F05ZN@kSoN`(q`<L5RKF+(ZkIuoK4X%vXM>&VJqvhphtXn~F^0}M!q@Zbm4
z0i#HrkunzC@-@D+8GU1kiHt|%jd^QH>xpaDq){Ws*YHJi3p0FSFL`?xsj~Du%E5Nt
zAY%oy)Ett(IU2)UbveuVqOXV}X#~(tWtV`O7gAQFWarLvL|iefqq2(RPfRP$7>LJ{
zn#m0f1RL)Q=v8~Roab@a!{xk(_LeB~<uO7|j^bsa#nKr{J0S??d<epDR<KiQZv?sr
zkmX684~xG~RAkt%Wj5e1+y?{B$ahuv&Kh{S3RfA6zmLTUYPT=MfHAzP;--oErHOcu
zzwI)u>JE<`j)~Eezk-_OjGP5bcO6fDJ|$zj*xOPU#Ln|w1TV!XD-9lS9aZBwCC4rH
zUEl_g|0t%E3jRGkospSTu_9%O`U~wAtR#pw#$On~?m{%#WomL5NG`)$qpGJN**PcN
z>`5IBF<4NNAEfc_jO>ng>Nhhy?dm?9p^%|6R1%u63MZpK2DA#Cn*Q#;f#Qn61RMu>
zUJdwQl{+6mkRj1Sz@t_8FUJHtz6O4?DQa;>b|Qew@GG+Un{eU5L<6M1qx3DZ(u$$0
zS|-B`Cf<4qOl;Pe=q{M(VrZlh4dSneVPnt%zz@PGp#rKHio1;DVzh=VD`XV`VesC^
zhX<v}%75jY|C-?v!7yilwCqd?l3nzFn!oI{`t#8yuz+bJcQ^HyOBzi`lu1ZHkew5P
zcyu+A=wp|Z_`i@Esz~-{K&8X~By+EcsLMV87|s3{i8C5P8zA`pFN9r9SXq-^L(+&x
z!z#=|1x?|s@FUm2d!9#lp{LZ$d6XGMnOiASF$_6^La+>Y*j!2BsnDV5eK46y>AE$s
zUM4o(6ws^%Wuk8dYBH9cN#Ub`7ymI^V+tR>P)rFn6m`P1B%Arv8i336=p%Hqvo31b
zf0!ylX+?SquW({K`DTo6@Zb_z((CkanHGP}>IOy+8H*HLMKfCT@+VIgY|#(VEtyL}
z(0NqSz1ZgH5hw+@p~cc6yu$a<DgTjU=ld>-2hMchfaD7!*^0mxog6?QgA+qgPmvrq
z+IK<GLum%U{s7O!6RL6we$~Vy>|9_o$4GTND<vL(GH3O23=zQ5yWf=+V$9U>-w1Vq
z;NxDdA$0f$LW3N`9gI-l%BjMK7DU?q8|OH1{44u9o*=dUH_|2`nJa^z;57U<&hx;r
zR6Zp6s2uD6fs<w|h)e?#^-x36zrM0!yM}qE)R@b@Z`#aZhaXNOVa1y&l_-*&Q!=4Y
zrSl2lx1m@f)}YDC0K)tbHFX*xxeTuYAz?o{96f%8`&}i~#Q5?j6~L5|8!u>8@I#m3
z9g`7lVnxsD%v?tce5bS<#6*d6f`pU;{m3yaKg2c%1v_#?<^`;UV0$Po(i*j)(xRbI
z_Xnizzg`k6xQzmy7J<B>C_}FFCy8iaY!3^P_CXNC%|ldFpmYMvrVv(&;&YWd2~#lz
zs+HNX@RB|zWKWXNC1XzdUnJ<1h|1?guNb~NNIa93Y%Utn;|l`puZI@kFS~Mzz?X>N
z0q=FUn(Kr08!c>ov-V@324b|wru>wk6grn#WaqN`Ik&uwc|q!k8L1LB=K3Pd`=V_a
zMgs}xY9Yi%wHkOE%5b$vlyi!FC<v24%hiP90LOHQ1Ow4ifD-31*_6P&<H=+ZV&i`T
z5Vi>J|J5%Ds|?}{9gg1ZNLYX;drJ8*;m4Ho&jgBe1Z4=bHcDqgaiz&bX;Y9+_nWj7
zSlWW<s=YfnjyQ<Pcuh8BVTp;)IRF>q)nh9R&*SCcwcyg$sLv{+>z@N)g<(4WC0dGD
z{TEek1F?jMg?hU$=@Ed)m6q=(&-iaEsF23g$|Gno{bfVh?2Zh04q5YoKMME>_#cHa
zGepRWYymU@C9KAMsDGGDOSw{II4nNarM#>!selxLA_pw}jXF<$70N!8-Z=nO&uE4$
z30Y{i1w2Hlt2kdQmSs;_hJqG<54`>LLQzI|_qK2|mb_T`mSDv@U!{F=AIodrQExuL
zK5pKAveSYJoe%?7<4a+3hNY4eO1KwwEnwd1&X^R}03TFYg~<u*mhv<zgFZzuE`1~P
zKCqMEss^PSP+-#6?PqZ<%#KUn5wV9^<59u+j*ws}-$sE(B_)bnT1DzkjY8+6LdlaF
z<d*m*5rZhB(7`&CMz!GJzSWfg16$5d458BHv_{Ahv~Og_%1YXOS|LQC-al!IaY=JA
zJTVd-6HzCBD~!sR?jj2n--qMxSxYXWdlXRm5XQU+Y8ScK8D=?l*?oIFXmnF)L=VPD
z-#}};=~$b&!%)e3wUT;3h`vBFixV|~=PG{tHdR(E=bW%4Ok`t18tcFMjLi*+j<$cR
z(_xNLYcbXutJg_K;Fl76F2gVzxsm8u!{X1_#gMRopJ0~coGPzH?SW(k(gD2~(Dh5>
zymao?0Jhl2I)^qJ{Wj7l_WbA6Olb){Tq7}gD#`vfrO1;H!-$M3G%^$Fgc+H5FO$#n
zbZ7TOz7R2R%Ee&b0#4N?L`|AFu83_84e2o&y{#4&lm1&NLcT8~LpHyYZ1z?lAK_6^
z`4!nY$)A7yC3_GWpR`d$ZBD2R<AJ9Ts&Y0(`JQhQrMe5l!oRbV=5QJgnWPU3Y_9oG
z^m6{`mux}H4py6rJV4Glg}BgAJuNnQBKkz*>j?CS(AR%SpmTU7E$NJf0X*3^DQd#s
zewuyVvPHDJoS5|y)h5TCSmaNwz6_wv6|NdN<*Yk3J;(95O@@{73d&iOxuc`~(?q$1
z=ZW&&YjJXsFQaY}(#_aHMWzTGVIlR#yr*EcZOTbmxy;|ZMTq4#=*mpICcEZ@!-Sr-
zLEpz99eu;5+)Byw7;`BinUeR=n7aut5Qy>V+}H3X8nR_-b#2C6M5e%aWGVDCJ+`I&
zd0F`?MLCH$yfDBQdCUbew#7m^XZT7CZ)9t!rAUz)RPZ67n4+9v$67U+G_V_K(q;Ml
z-4x{%EjI56DOd0p&Ju&NtIt3=r&yoyqD`3-o|%$&&;DGpYc59gS-u|HjHg)1U*+lW
zr{RAOla<Hv`5&<*08JbmM0Gg6=<0>~PGQQX3Koe9FbACFj=xbb2@3YlqHiQCKf;KV
z4$#)cXZhGWH2s@C8B`5{@^C8wMK{<3DZ~hbwJHMdAhIyXA=_`-L1@A|z|;gO-?PWr
z;(lD%KG~H*MW(5>@T%|FlGc#{jgXXGhL5dK;dg+~Z<n!yt<!o|inaO(XkrCotEv{?
zD~6GP(VVS^pz`h+^Uet`MS2bTk5FSlvcw8onFbAsf{4%m04ZxCz6b3l?LCXhjrLF|
z>X57yyTeI5`;mYu*s&rm=etDWHYLvRP5)uL!@^iaSgQe<NwhR9wA0e635~WEbyQMs
zoJLz+k>`*v!Yh~f1BzC_*b%B1p@wRx^G~y$;pVoVi)hBk@cFU}6N$}b(UbM}$C_DI
zE@>f}wP)DU@D_=;dl3-!7oOJV!sWu8Nx?FKS;9xERT=XTTGQELmxj+b<}MJghr(%f
zW6Yh#ZiKgV)FCF7D;PQ=Ol>@c$aGR{NBg(<H_n*b21OE9{^<6$eC9>VOK&mA$(V^o
z1j%T`K&=szN-^!PJZp0<4&udcfvj_&@Up43bqR5hhS(E`=-0%(h)Iy|*c=`rjfQgW
zWXs!_9Tp71=nDy2ur=>qra_oYo@yXoIg0)O3_cgd<hWuX_|FD{{#1?rA<Qx~wsho^
zDnr3Usl9P>T)Eu<1O4rXdQ9>(4<Rc^xK)6jtpy!d!CQ)Emhq<IS<a2(dD3kmCiPn8
zBU-iYhiRa{Y&U`z+7`vvlmV{<vq>5MLSR*Uh-~Oe6Ju?gJKBO_G-OW#_}&J-`PWcj
zIj5hx3usnz*HG?u$}OT?#1(R;N1>Q$GKK_iN?nJJ@U<y*p(pN8S!s#9B;--WRgf|!
zAh~0ae7?#C@4=N4g&5<o9;7(72~nUGArQZqj==nd+(KjC0W<`{cw;wBWo7USgoYK`
zdl9|wgn=mMuYnaCEQsdM^J~{wR=Y^Yh3=s1v_=p|=9<>85QU5+=7W3*C34#7+<U1h
zF4IDc4BkN~LmFaSDG>-OlES}Cq)4}+WbRMVI?AJrXSEEJ2Elr~gGLb5`Kr=xcAZ5=
zv~d(n^P<_OF7_MLHkI*pr>JdZ*keh2+&d!<)n7_P^{Yr%VC3^wQQKXnOig-rp+hBn
zGKw9<AfT<1#j{<BdiQL8za{ZUgTOw9=A}MFI;YBKQE$?^&Zl&JL1|=ojGR;Wr|fDl
z5Uc!`TB1{&wr~rLYzxh`F?<MIXKJJ58tvtl;Om15%J;g)jO`O0ZE54mX^kO_+HT7O
zmCxDzsFzFlE2J1;#3wz;83Q@RBr7-hH=rde88Ir8#uZyohD_K~CjoagP%UQ06(pQi
zi&}wFP9j~$mtf4e^OF@zx$Mk{;cY~TG_ai#Q*CP#KJwyOK~%#8Dx8U>MH#oi+(HBy
zu`U_Ys+6*eHSExAz~wGpx&sYSJHHPZ%17xHf7ul0!{{jIzY`PHL*>7epc!*~_+&V8
zQ3;b0CQh0-p@_}z(A+qzFFE!TQJSi&U>iHMLNw!0he$`j3Bamb)s2h-`UVnC{io<2
zi^6p%Z#43Zx$sfQ+Qk@iFN&;&yts&Hk^6>z8eO}^&6*P7rGjc^6KKkx{iz2kxMK^+
z2zCfdZV-0AgJE5XyyCiMoms~h5k;k8^*WBHQ`%E#b9GOoF3BOcUv*9!$cL-VgnMA}
z`5$05w}MUrmPyoom#Mp3&}dN_ax<vdlsbUgA~3Wek?mygQ4f02mk**fx3jP845i2>
zBn`E?%o=nGa-2b&Y;=-R3gZ2#0W{GRv_%E{={+ETrklb4K&lr3|G{IPz(#1WUVvdE
zBj?0ugbl`r`;O8gZ@j||@&U?tokw^=FVZPt62SUA<0s0j-(RRCjosI%;W=UGeUCjF
zn6fjDS6&xL5bhtae7q-hEOcAg(MqwjF5@TJ?M}TSQd5)%DatKb`3W&UUU5t{b=4**
z0E<{_^gZ}`%(%|vP_Bw8tz&vl+{BEQ={ZaEVHq%OW&CB7lU?LUsI%WIhl!^meMW_h
zkQfvmV-?G~WOA0yklL8}tu8=0YJ$M<m#y}kam5JI?!1S>NAISPSPchP!gl9jAacja
zLaHWy>^rK$41tU4PO!z!_80hJD*h_MUrqS06S^W@e47F=iExss=S9HEJ|F%gb!H++
zJlVCmh7_#bZW>T+CJLjX#yPQON_$swfQ<CiyHvU9w;l8-!Ai%na!xqh{I8TM@^B&{
z=C<;BnXD!KWy|%CB|Gc55zICfp^Rna><9$-Mws1aQk<PFx%cdK!Nzmwlcbo)vEbA$
z$xq*O4?t%&CpLb*?eTymBZ<nPQB-cayYktXY^YB|ay+J5ax^C0bT^R?*4T#{2~%tm
zc5P(1h1{;cIzv7Y8i@d^ND&of)Rp6ICL66^k=OPo9B)}Evbn~GrzR`oqS#jfP1jxA
ztZ&RByM#J=qpMsAuvK2hmq${!xlF@hTClR`Lr5LKTRRz^&et7P>l{o&Bnq>SO*x6_
zb7Lof)$tlZXdfehqopZKRRL1y{K+xsOfQUPzV-+)Q^tpP5acrJ(DqL6x7oQap)HTJ
zueOd?|G+|}!oJv3Va(eIaRDc92dfv=+>u3^h{@4Vu}#ESRo`9J#jE`Yvx1iFTj9tn
z;8Rv|!?TG17BDhQdZE3J{PcO*>CY#j3U|j8r2-UGcj|x<dKhR^R*4cg+as$deH#5q
zqY%?CJeWGfyY)O<9Tn<zhJ6r~&}T_A8f!E;XLh7nf%m>l=+;yU7m0-hHlDSy0`*W)
zvmjFG*mh>_8rsfEi+*xju{lh#s@x7=&KE8{RxFK>zDDWMr`hzb;re&BGo@?0LCdyd
zajyDo&V?AcgUzzCtVE8h5IaDVYUM6LPRQdeq~y!a0Wpe@g81z$l2pidTiBmnTh#k)
ziAWW0VXeBgXmLSJy&(!&F>@?I;5$(U!}(j-m~OosXU<^k!_cKYH7en$gi-2V12lr7
zd9>qzLub_WTY8JGZ{Gu5zmd9r+(D|QjPIc*W^wXH5Jy0pQ(#q~Pell9Ar{E}pa-Nw
zHIwm^fa1$~T_aI|2Y*3gE~4p*wTKRNkawZaxI)DEcNZzIj7MrU!Otz@Ghh|exFw-1
zuhKfTFsm`5F&1!b%xws6Dt(A0n#xh8P*hR|Uoh7RE#kI^REj*EOl)@;^0uODcEB^r
zE$o%i9Doc0{Gz!aeu$94T2VBKVr+2e!NiZ%1cVCQ+rsXH_vf&zsG0S5o~8PWE9XER
z_=p0MkLIB)peaogN}y1gk3~$mjN4JB@@+MNog0}q7v+SXBG;a^=NX7N;;oqOR~({&
z0R!Ra_Or)BfDZu3snQ!)=ZP2Z>cLmR&%h9h<2b!DXs$Q(B8{rx$5a7}i1Y!BafrY#
z8vR{V7rggD8E8!wcD1mofwfGXta`ConE+o0_&|NsV~u9@dYB?7;;fW=C@geWWT<fh
zrNrj6V~(Mrijr<J6^x4cipW!ZQxs9Xsjk#7)oxP~iK%9q7j6L7_y6#r&ah2A+BnMI
zqSbI@<8Cn6v@Bagc4~+pxff@7%zmA2rSvXP4p_kFirjEGs5<_hSRq~|4X*8negze`
z#l{FSvxv+%jm(36B6^4>X=a8x+v!c^+xn4Cyf_{${~T@eL4*YXT3^{Y*q{8C=jCHx
zd-L9>*^Hj80y`4Txf;!vKobS_y~Q^7Y^v|whVAd!W%xbvq+Ele_-(u-E5FHTgDIUH
z|BUBl*Q?<aN+;M?wC2Y?tm?5}BR6U|(Svcsk*j`T_8teK&|W^Xl*RUH=lB!U+-s<}
zhoj~0m+4K$TjeQD`4)r!!`XddaL@99QmTWjp)vOz<O8G=AR03n5@sm(ahkaPAYPq`
zm@*I`JHt!h+0cUP4)g|dd_=;5el3X*j5E90tFHc~LyY(8?3nmDH4M&2xmcV(^RZ4R
z)|+H|yzgfmBG!5XhvJmRm#)^qT3rwl>QtWK8s^1~P<q%wb^qtIHznXw<WxzE#~X8-
z($FW?KcWmzi7_{=`lSk4Mge+*kSMP&+Y!?({ArRZCF@kbya(X{Vo#No1PngIe|s=b
zOrWDlFb(p;ENsn~ZbgzWQ-}eg%jVB~iblJnUjQq(sCDoSz`&U=itm5{wNa$ZViAFf
z@}w0@5y%(bS7Ea!G*{K88KBbKLNqT6nvS#l<tIc(*AT^`2>w(>EuwR35sj%$^ynvo
zQ5zAxrZF1*gl2;pnwWMGL8;AXP&3C9PH!VtU(@>8D$y#y3cl2c-ULi*ePQ?N)<akR
z!RQI{H8hFl*QVK2rMZJ>-qdJ1lqW>(HAKz-;&gs3qJ3%;ErPb8n^KABHyY7iPiRKe
z(8PrN4@O&nCQcKmea}1AYW+Nw=%0WUe5Vop7BH>#U&5HGeUFLcA0jQGa|RmCS8LO3
zuF~8|G`U9em5<?dYDDvEi2DAEQ+q9<mfA#%KN77UNkrWm(YPm!CRNi!CI8^Fl}fUw
zQ2cuxYBk=j()1#lKWH?$fc5wb78$yKryD!kCorNs5FvS&;V1!VB-GTP&JTOk?DZ;g
zzM6XO|3Q9E%^sv84_8xR{||Dsn*C>2!A27`b*bzBX5&{JgaDTx3S|9d6WbFX=+MKm
z!l;^U%4{g`j~PZ`uw-wZp0iA6wm+mtZ)2|N<eud>_oAC%h$rl~z&51ET6M-em`a>k
zjsNO3nqO1&(HBlh=kTuM$A7`BhXab>2d*kb?z=;JRGfSfJAoa_C2rP$b(2=aZ$Lp<
z%cPk2e7qU+QfNjS<wcW(F>fmp6zN~F9xp(dEl_Z12INOX*y8RQ^JoqsgZ%+khIrDN
z3s#)dF@MaXE89!zOhD8s!M1FLF+XLA@Tx?NkVpm-$=o%RrAS|59|4Spp#QM|Q$1sQ
zADWM@)7qOhn>qt6@^x0HUzp<q*iSe4%^nmxfXyCVLQXktEtcXY0UWFZj5=WybAX6}
zIzNiKsRCfSY0wuynt#vo`EYhnSLF>ceT|5q<`iO9sMVY_w63x_?UlG9H$<pyatI+*
z&W7IzC#BD;q@R+jGxZ5p#Rb#A5C8BDuuW?-v}!G~C}i-u^$Bc~273uG2;)bF!^kV*
z@8V&6Rr(qan=}3!JZK@OKTa~L;E#?Wyim%!gkf>UA7No_{M@vkN_@Ub_#^0UW77HP
z!WE`%jLDXkY-C|TBG!48$?%}bA^)BKtj;`Gebz*0E1lE@HH-R${peRzM>`*?5I3{E
zmY`X*&Lbu+|4F&z^I(yquB)za=~r^g#3Jje$J7rJaW_=QCcjIXsa$=sSS7)qZ$U(g
zR98%y6Fx&$><I1WoJgHibcUVNhZwOXeaogi!XhHt!_#-O$qCK$gLktf388H}?ndFb
z`wPB-$K)yIEs(^rDz0R~r{qEzDA(naxNc1|uckPr@5}y^&@A-5w$&jr-Wi>lo)e?9
zo3-7T&mx(rzj@t9R<EW5WW@_(!n*Q7GJ@%%dJ<}GV^aLQ3&z}fc(KJ|l#>4kD&`D>
zjKv1M*&oVIYzWum-9KRY{hK;^p&r%$$!IL^uU@{}oN<-VFsP$9BE5(`+d9^l&)-Wv
z|2xJlzk%_IWlUdMywye5%ar*$;+K77iVHiV-Q&`8swQTH%dSZjn&F@CB0*B%quRCS
z2j3;oA4A=pf!aDF!kSA52eCWJR}!*o6be4UUJYz)4q@*MP`D!tFsESz@zWxvRAt<!
zONY0nL>I0ro9-1_$1DPm?8>~B4k*OKWaV0lQkAswE_4fL0L5a@4-}yE&1rH(tWC%B
z-X~k49?eQqGar+kze1TakO>dnnEN`382a^z06^w>8ekg$<h4~tu<k&7kSmV2S)<T7
zfAhS@QW*sEd1w&{znrI2VQmYQM)ylpSStvRyPUf)zTJmqEc|gA-+DhCZaai4V(#}5
z%}r5G@YN&=sCxq}<?koMTSlc<k{#$B^2xh`VlqyB0f?x}vMBjrJ+upd*_90cf-=H)
zA_L^3OVeY0?UO{{Ox&;9{thv$R%cy_9q1F>EF=#?s1iG;6?{9q$l3z<UaYhnh4x{|
z&<Q0#cKVzr)?|-2hA8-W(-s%Kkk;LLh#6hMFw+*$;UoUnPO)2By&_sGL|M*Pif57A
z{DgU2$Pi(7YKXhs=8TRmOmX(20jrJG#t8UkR)?Y!CM1kUFnYbU-7pE2(Yl}3P+3%Q
zA5=`DpNzUG5J(v-C?j6W7)Tk4;g?lp?WDi(07mF5G$EMU=_KYqpiQ(wi&%A~RC}dm
zAqQMBY*34C6GfpFE|Viqk8(|!V}PMgzL~6lA#VXy2j%yWq)iaPRK6H2QW_CxwKUvp
zLqGt<GggS{sJuNZ84%X|5}b3JVrneNi~L?{etvsaXJ8wzDXi1L7LI9{@d_4ebibv3
zRnnrALD)<>rk9<FGmH|8VDvSuwmkN6NlJgb4~N%X!P{-8D!f1TN^xP)2fzif(5;}E
zJPvKgT$~jP#^zzO1W_t=weaw5(V!f_3RaS3A~DZ;hm{Wub@ZgGOfFNu$3Bpo442Ux
zim;W0>XhM?Qi>6ZQ#M2Bw^ovf>H~NRZ%|K9el~jEJq~&QT?I5~nF1=#L7*gEuYurv
z=pay&N@^fPZS6_~R*_={NyJw_5SfO#pbU;a{L2Rcs}*8skTTI`#>9m2w3$&8P152>
zAeB!Y<4QBDvyvyjkjlX#uXsfe5LXouvoX_w9QAw>3XNMOH3rKmX1W$fh8i$=6?-K2
zY3fJx=x`2lYw~_oSW2?R`(~)b@{<GodbcK=GXBFmY;SUJzZbOR`|q${l4JFQSF$dH
z!UL9JLV>u_+d%f%an<p2+gbXc!EmhFbXp<l*hhnU^=QyoC;{Ak%p9IZ)QgDiJrpkp
zG2O$9O-We{!)eUDg#<LY{ACt0c!)ovlq=<X%()1xuJUI~1~+RoOQ4h_D}UOY)4%6;
zwz0Pdr#83YxH6v&U(u$_J&N^x7jP9ruzh=&zb(S=d^kmL&+@b#tiLUy#~+(OIj0Ec
zk4>*42kk_VsN$4$rx*9%fh@>2557EVH|1(2tG2Vvw$@#DJSmxioKx0!G22n;ef$8l
zmkiG&l$xTIdV4$j$<}(zFs&4}MO>x`wMHsxQ+`I#n=7pE@ri0_W9|mjn|!!>rc74;
zs$7Y6JIb94Q`^v;Foo}7k6_QGHfeSHEdX+g{DAWoa4O?y&UKl#YWTlyW7|?%x815@
z`NA`@zKiVXg!&u#d@fU#hPrzjyPFa*XarCx=r2LaZtN)+`PE_;=<R?`x-o8>XffjI
zf6?r<VlA9-=+sf5Gyw{a+s4KZ3DvvbWJ`yHcCXM>=;y6}F9j=DUFr}}_(jTB+h?Qp
z>2uy>w}*svSfG_({*Us9;reQ|PNMSZTUpnkq58l#*|4FlI|OQ_g8xx!*ppJ;RO-<d
z_7+OL{{}mZQU$Hl7Jj(p@4SBJT~pV)K;f&muzIPXmcHcYsy(n+EooE!K+patR4Vl!
zL|%SEWDF6B+QQ0HL-n^dvX@gsI+(PoD>whWYV(s)dMZ`AS(M7!$bLYnBe3VxC3JlQ
zN?6k+IDJ?xoLxZSQ#T9YG~US4hPCc6RVx+vk5Va5N)4q_4>z%`!$S4%Y+%QRwd_z&
zE47=nx>jAcy=v-u2y4t;RH~)d2G(JCOUGV7h{2?P6k776&|6d}obuJ)mkXfyaB>lu
zD@k(o50;Jn@AEI#)9zx8b~c3A>p-Ekkp#^frB!r;^u30=CdL)QeO0xy57l(=E%xQ`
z(8SpwNJLPyfm#$DSIl$&R@}G(?nbpB?}eiDG|E@`Ol5mhnhb41bd<DWjB%WK6ho&m
z==!d(?m8vSa^U(e(M2trQJf?Z@V6Q=hiE#SPt<>VlWiCg+WXygf;V53nyi)rjVrwH
zO@Otgp+S5HR?8?2!=s)B=4>N-FrsPeXG!r;(*nwOHAs}>9@tw8#Ew79=O6R28(D{u
z-St(!u*oA^cwJ}9Mz-?W&o+;2?&Zr4jtupxWY_WUY4-cbaQ*I!tYw;6uUupaX>Ih=
zF0vVEZS{RFvi!96`bHPoK|JnUV0Y5i>AmJN$5Ty%`8*NA%&n_-Fqktro1<yBHn6=<
zSsOJncwveqPc5?v?Q=U>ol)V9zHCqf^{1`6kt}YMxzVn_LCbj<n=`6aqpT;;c*1?a
zHjSF7e|9N*JSxm#{f=S;%if2Z5nUK#-I)<+&Gq2uS)PYH*pxl|&;#;~s{qZ27RD=3
zH3)n7thtbu)4B(&Wwd~+^q*$vFPEWTQ%rI%0g1o&8i|z<VDoNbSYmn~_B?fJ$|zjB
zGAFxI9de3dNu`y$G?I`F-H=bsbta^Ot#>J^klP!Qq58?2*tmqQ=ahT$?~|Un()Iv3
zc|T~=Up5KIewzrPHFB(V58c7~vvL}l1ea+d7$l76p)JXAr|k2vgV1tJvxcYcizd2<
zf_~d2Y`~aK^;ZGp#<EKK@p-mvOxu}Zb3mb1Th|4NwpN+Y*4@<BsjpJ4T3gq{ETFA^
zSv749LR(|dR0}or$Z*0nxHGGpYOyI9`*67Bd?Sf97#r+3gB<Yts~v}}T?u+>Z|Z2`
zylC3r+4uvphRDYg8^?%^Q&>e18>oFTh}e{6qfleAb6^bvyrWwC=qI(K=KhVa2=^g$
zu)^LR+jMGAm4`|H;vw=MJWN-4IMoC^oF^Wlp78MXVo2OM&`dnIQbk|$4Z}q1Pc3Gl
z<C=P%Wj)7*>*vg3<HvOkP6IkAot$$#BH20ApC=6!xbchGyW@K5onNz?<C^OGWU;Do
zZS_sEn0b8YkQFnlMdHcCm^Hn+h-grg5uHCC!E=WQ63YmTt9~@h$G{Vom5^BgMHea~
z8aS<^oOC=un!Jdu8Xv6hvxw~+-yz69Q?JvmUMuI}<*M<GO@Fex<J+>e3xn7BZ}RdP
zo2>kvfPD)Ei`tqU%qa8+x@Bf#hy?nKsXCu(#7&?As4`3vt{_lMRfGV%aSO=!`SG})
zY_7q+3C5&Tbk<BcyYk$+HLJaXrOHpf^LW<nZmADuZ%puWe2<Q*UNF5uBHt>!f(qUr
zRbaG;1=BXl*rsK)r@FO_t(37{%kZa+oH(7m4OX+UOT>k{`nYiSJKwk+Ii6xUZi%>X
zSD!lpNX99d92Pz?#<4d8=BXE1Wo$CwT{|r6g&7Gh<pi`0yHGd}FJpO38`0SU=OXWe
zB5oWqFXJDI$%|x;^$VoYkpDt1lGst1?28w5AIpz_Mc|yL{Q)ZD=O~fqVK*iw>ifRJ
z%##BB0tIOVyWV7$NzI<=2ZQep!CqDnOhW|kQ%VI2=_VuvJ@{yv4{Gk{{(uyYR-C6T
zv@*V5%u{9D7nNXt8UF%R3SNlj(fK}HxWfKR8ct9cj?7?%lbQ!sE)ZE!l!ZkkRtYY{
zy>#|qlC0m?oyAR#??3quqEW`bbW!w&j?3BUb10V@pdf;Mprsy&;JpMQ68!gJh|O!E
zG5+5ztYC6n+$iu6?ZMG|=TbWHhKK{t7Za5sp17m-a6T5E6$MXAh;O=%hkBns#iFJ(
zaf~LFaTz|sqX0+jb$r(<;J|GS1v5kaRAyumjf64f(;p!h@lY5gE5tZ5{7Kdz%0lc7
z;U#e}%mT9SlNb<;YOAvJhDZvQ_5%WzqH-sapN%zaE1X+$*XLbHyRbTkB^1uQQXjog
z$*1lh;uSoU{XC_c<BC7XI<cAVT!tGSr5UZjYkg|L4zz$)t_2FvV<)7F(*Sn>L~qTS
z50mFYY{Qk73f2Pfbq`NIHe*Q%GOq%1{yAuF5LOO&KZ$n;kJilJ07AlhQ_voQm8&CV
zboD6v9Gnz<uGMO#S`|sJR#b(GMuXI@=`|HmWF^*GWz54~DJiSi*4<?U2^#vuxE>@@
zlmQSeZUCt#82G6wBD*XV?I&N!X?0jCuL}*V;9a)rbbWk`dB14s!CLyZNM}GgH*mcM
z-ASR6{!~+iR?~)+M74q^qlDPWJjZ)N%W;|u@(_mN4?@47q0b_8(7`l+!(m4}aOuLw
z<LzzJ6LK6r<At(R0==5;gaat1;|+;(94$z34WyekH7$Dh8?{zzjfH<AMpp%|4^~Kd
z(D!z{Lg=~8gm&D>XafPDxFHI%MZD}X{{Yi;<tPzsFXIbApfXS-ifZCWhy#q9P-Gc_
z10^^+7ZH6AfkkwiF}E9d!vy-+my~Eu_+(y1{YI-*L|P~+ZfQ+?a02B@gbapCob*Ik
z6V4$vy>xs(0n|%kh<D-yGR9c-9`$*W{&}~Jc9lwCUbq{B934>7khBWcrkuyFp<&-|
zJp2|BFfHes;rhZt{vtX<;Fy3Ta7FmH9G%Zsl96&KMQ%G<(3e^Op3sQVyazP`0}?7{
z!@<su#Y6{3l3lVFcRnOSSJ5Cl4$qeGzYsIgj_7tE-oIAQ64KSY68@#IgZF8a&mdJm
zxCU-EfSBZRPDCKO;uwcHNNP2g#*?`FIue*JL&?+{MaKrB2#J0Lp|}f)fI?Nq&KaoB
zs0YrE8Q@XCg+$i@j(F@qF#&Ry&;ZN=ReYO}XF1;}p2hB5Yzv)`ouhqiPSz?tOW)Yc
z-b@ckHO?VN#!xkzMA6`J0`8HLsIB`^i!uRoG)yA4wa14eMuYuQ>gTK;;Qk5<pj@F=
zPAl==SFGMMZS~1Ptm`xF^+PtY@pyz`N%>5eUf+^^@J!E`)1h>cXD+8{aoIWJ@-L{b
zm5dU&M;M_}@hm}iFCNK??XPN9<ng%l+tiH8(E(Dvij?&aq$yvrVKX}D{|aQwX0+Gq
zH?W;EI_fX2XP0IqCgejqVA1y4O|ZOsVTz+Kkh{M7C+ZjXw1kHz^>$cZX~j%Y|8w*Z
z#?JI1qyW>xy7&dMc{2_AppEQ>naN=fX5jFw<raxc&Y64_*cJ-E-36F-D_o}a6WQIF
zElo!OfS`8L1HFxoHr*c2LTB|dE)mC;#7@mQzPu}&HmgTK7Y!|jR1p)O;qnCb!K|+O
zD-rDGtgJ@!pQ&bx4iOoeO<*%;w@Cj@v#@IaXeVhKzD{y2=fTJnC*IESx?;(IaZtr~
zLL6lGaQaGMozT)psP~nOTbPz_iHvq+&!N?919Q*L4EydGZG|AFLVU{sTYu&J6%sCu
z)cd?@JzGAfWp{5;m9U?g%}CJS;EXlA&s&%jcw2hMvCTjMQ2jOOxo6n5IWdXr>QKjD
zr46#w98irb&cN51hWhYsW5n=o@MO2l{j|t<i(Fo(H+pdd+2cnK*~qyAd>UfOux?me
zuK@PZ+-6N4KL!p?A|=tJ(T~QBxgq<{+@|L54`Engkb-PIG#!80?xx0lm}1NLo`zn!
zb<dggP1jXC?Ip3U&$ci;EfIJ3iMuzm+1O`WI*KtnsqxtQG^bIhzY~zqIdgqr{@vuW
zKLdjYujdA+qxaiWHW*FFCY}m28e1No^2&G{>x5l1C<^TDz6h+v-YQme4GW`Qs*im4
ze~|eDNE3<2jx?1<0MRh!317e^O`8ckEO|^!!yEb{&>+dyLSS7-2}$~)3@)E_5OF#P
zcoUWb?iY!yj-|}&;?rrZCc$-{HC}bthI!3ezdnr`YYUI@<a25a%o!rZr=&c<bw#J7
zWz*OfxGniR`)gh^$0ToHxKc{^RxwkS*_?Buc#juIzlv&hkh0(=t6R)}+dK-Rvj6Xa
z==;lv@{<G6RawM~I1sJiUYAwukJf|zjlh8HG?i_d9~OxZ0)V1PHx;|uYj1)1N*q}O
zMEYTh7@t?@;j$J&YA43BALa+eKJt=uM}e5FT7HCXL;-7IQtXT<;SUt*(Zi*};V<VE
zOKDC<SYR3J_gquQ{21)B(JeCwVC7S&2~HB0%N6{yu~e<$G>kp1uIW%pf<G-pZS=_u
z*=gkfAeawVM@cZFJb5fte1MzWyuz%uV6f+}J`h?Vb=A=&ke^Gk0a9>F<0KlKv?OP!
zi&%P#X$v|JLQv3lu3^4>)@t^{b8VWxg2+AAv#5Y9*Vf4-0bsdI<ri7!1;LJuztq$d
zrq;6;kb=Lode#AkawAa=)T2E4Bv$uKfD$wi)^!y3KL<E4Qc=Gh3o^v2rIs27L{1gT
z7ilK~x*+BkYGddxKB3i(eD`_L$nNNnf&dCbL(I*Wu<sUxPv5YblGa<Id9<jiT5yx+
z0;u*JN#75S2K<8VqAN)EtHt=%&o#|!tJd&|4mEVtYS;)Eb!gAk?Ae9k*a>gKvS0CW
zSYYk%BjZ}K*p{~8gg^N?*F_tpv7%k3`cr7282+4$2QAh-ss6aU{5D1upg#bLGYGJj
z2`kU>S4Ah3@GWq0kXfo`QqJ>Q&T`}k{Bl4Ye3}NHPX%(Oh2yFf{*56u_|AhZroSzI
z9Nz<}HUwS`p9P=|w?Lw7%2}K>LL<cl&j*Q(E-^m@2yST6R1a_N2t*TM(hR@(U^mHV
zJuOJ`eTPM8M?2z4C*Wz}f%EJ#&Jm2JwajF3QD!M-J#pi?=!|7V^%qd^-5k;fiN8k+
zCORxFQg5iKAT{MuQ>b1n>ZOoL0Z;D5m4T>vT;;4)%qOE)$hDV=Oa-4QoW1(ow4Bmd
za#!*9m$T6sR{x?rv}A^?Typotggj*e+nv#3q_;p5zM(}>DCgo%CiX;VXd3y4C`B9o
zv=Y3}lYou|)lLDq#Mjiy<h-4lxqRI`v);reFK@^!i<*!5l^k8+JQ{Ngg_aBr;-4<2
zE*Kb8V+emEEN3DH;!rbxUCqVlSHDKVuc^6aSs8^+J1#4Y`6(y+bdjY;CK=b9r-M+1
zDndU#T?Ls5BxLNzhpQl{3g$KIN_O_WW~~3>_WJKuu(^xFM;s+5(wPY4!VLJGW&AYi
zb7RL72On^%3l?kv(h@Wu6tIZF0L8r{m@haM*c3bWttgHjETk|Z&bqF2vfGOz+r1((
z)O$>{1Q~4RvXF-0%a}`j#d|tgOlF&a@Bbj(HB5d43zJ_Lv*y?gHb1jTNDHC?!VN|7
z>)^Dqzv$u;{%bDVnwi?~+XDi_xZ(}?r!->6hKVzH+AbE3r8?)1#{c(u0%eF`Lds|u
zP+E{L_=ZJgnI^R(3Dmd%l?mkOx=bNIfhRQo>>^QvxW0xtWdhc}6p<hzMMNaz8{~`g
zwGbcNjL#rL_bz$^*O2DRY)4jWz2E1oBr7gCMQB_VwTZlim(XCedsh|O{gB%I_Cg|7
z!N+9N6AKv}^ua4_HUQs>Lqy_Br!RfZY|js<dtFc~VmB@{TeqpBz7E^}e6tqY_2g_(
z6`2TyVZNp{)b;s9ub4TOG+i4hv3g4a$IN{|pfbJzJF~=3-ThBPLEYXsY64TVZj{)6
zhBw6b?<GV`AcYiXDB)+I4=70K27KW*m;op54Y-^0KWISgZ@BKGr@fjn&+`&{eMw$;
zk6ZvT9mh}|A!ze`G!|`M^AK%5;fppa&#`_>P5Kjy*;7lSdlr2}gJV@VT8&y(g~Pif
z>sA7EY85D%`75;KB90IQAQA1!Wk;8G3!aoiMM`9+RmWc@H$h3k{};LU3#|UKj-9#*
z66O3S!9Tg)u-&gEh0o{ya7?t=kQnG+zQCp~>)&_9kN7I)%Y;qqTUa9?4GH2ig)CLh
zYW6!u60p{1Pv*bGzF8Kj&#<#bF9g;<j4>_B_Q_%0Ug#Bf1+4HvRD`Avny!#*hSD9U
zjIPxg?`T!ZuBRf@op(Nr?Ra72)REK_1X?hO6?CZw86JI>Nc<r}^SX>CE;)vGC%;dV
z#&|JXQ@{x#;g>0eZHU2In=kWJcn!4$aC<2m>u9HUzsPbNW4jN%2d0KpGerkjXwpd)
z|4v4^GTsK&*Y@mYX0t}w!A)igU(NLBztndnWQ~8G$NFVA?K|iO)ki@BINvn~b=(W6
zGdF!poqJ!)gWE-a+3u%k+QH;f!rx}EX1CQ3AI=VCn_J{(gA(+>mx|_y#63!!<%_ae
zRd#zEPqK&mr{P+R_5rSBeE3+sk~fALoija#{vp$b!%yOp9Bw!pbCc0ZT*m91fp4ZR
z(T~r-(JXw=#$`GLr=D88p9Bu}?XUoFw9y+B!AyaH7M7(RTmoqA=?4z#C^d_W#ZT7+
z+3`4U5Jl08B5XmF^7ZHtieAvstx#KRN{qO@@rVqN%kb@ebTVCK;9t#F>v7}2Db*!x
za1q}Gny^bz#MW}r(J<R(oQd;G4#WfQbJ;=MKFpGE49dL>^OvRDL*9-&XKix3%6~-)
zJPeX^miX)NQ6txg2sx*>jv^R?gK*S^uYwb5`5aq_6kNuXc#((xjlidZfc>Zi=iGc?
z4+6zuJNEKRO${QjiTN6LWpO&`otL^hR?~oRrQGKqB@t(ZS#<LV*V$B{Efa>wqH;oJ
zQdT9g0pqbC-Vc&svxxP<{`?NTfDYM8?K=yy7rv#|9~4yhIT#9l1xd`@yP^IN`Y|7D
zlBM|b%cKCJFd4Uu<~&278S})al!&|RM9er(iy7xW-v^%EW91wN<U?G2@<8;D4{?=B
zTs@x2_U42PeM5}Javoj78?Hd9p9JAdYq#(ys(6IT7Zakmi9GZG7JI1qhyK*UGQMpC
zYmpml>OTa2b}Iy8-~hl+_lG7<8pH<YHfwPXJ+47w2a)3mj~+G>ZuX-TmYo}-|70oK
zoZD?subChSlTAm7-bev83}G{xZ#t4J79+F`qg05m_LXrzLZ-M6@;4#hrrmc!*-0s^
zd0v>YH%LJLsFcezA(^G*4RwqpvdVdgX6?5$O4J*n#@uxnz$n=R*~t44@}lmlzA#GP
zRSQ<L*f)RAnu08kO_W;yk1U)Jm2Rt9pJ`d9YKk3^SE}Y6#|*zb)sYGMd{PEh;x{1S
zxftshd^m@Nl5k<_;5H#TmV$xfX&+!bZoY4#yOm-VwRgv*G5BiY3^Art8pfX@a0L$z
z;;97{vmD=mEb0XG-Kp0>R}Tp>&+@U3J1}Lab3GX24!h7t9HDCn+2Aj`65r88c8cm)
z;o2Sl<05rzWDpFFwn(NhbR}$Y!87&A*TFrWbk*lMftH~g(!TQ%F3_+UNWz@u;WC!!
za~m=pF<NeS%7uzyOec4wdzM<9a~0L6wpfHRWx5V3(ztU&L%=DW9fZgu+`{-1co7D(
z4`sL(n{Bae?JdatIz1f*E+J>>0Bp&?|8B^=U>0o7wkZx6>9({6eh(P5>cFtvgjYH4
zsy&S0Ymi8B`3!J-gEQDn3j|Gzy<aZ?i9YiuE{=!tnN&z=h!AW7g6Q?IIxyxn5)CcQ
zXlaX`Zm}a~ubzAS4<??1jjFI5{L(a0kP75}4ViPZN~y9O2@DNm-Y^jbui!()ZO1Bt
ziEqS-z48wU%Qf0e>k6z$e0h5eUYj!vozna+Sptn?954|ai|b^;f+6ZS#|UEPpw@GP
zh!?d4wHC_aPlYh;iNlq4D@}AS0tw9=@OXSi4_NOftyA|R^+fQ9M(}qyZ{Uolh(^}O
zQRQj)D0f_ZNHRX`J|DX3fC`Jthp9AeIHz0q=JVh`c6w^Y6DFh3kb=`1$#+3gRq~p0
zd^XD9hzWdPLzA06;xv7>aK^B}M~4QHc|(Amlpbrr+UHW)q?KJ9n`riQ8Cr5wQ-x}H
zGh$milRPsLO64;A)CueG5{w4^=Tv06BG<@dR?hM~cp&cnPiBQND*kc8KTr5)2w#!v
z0bjk9PRkedR(dC4aT=fHS>(phat@2%tK9e;YpH}fu24aI8p60--La_PCjo)z2R@#u
zdYGS8r<09&q&wtoY}H_YrmHw>s?!6Ed51NeWg6_!bQNcAb=qpo+o0i$Nz;H;osD^U
z8qf+D-7<x6J$xF>h2}2N#4|;xo8kB!NU?4MH2lyMl_P&DB({dQG?g`46%=#x8QKzq
zg5lddxJF=y^L%wMA&KUj$Znv!FvruKYg+FKl+Om^+xo5iUK*&^6`ffrEg8sGtqRq@
zzL0&es=a=Xm0eji(A-z>gb=e>v8ZEZuV5a+m1HaH>k4s{cE^lF)7h&Ng~1z#Wl=_m
zwwjUtfEvgyLw6Xaf<@Gh&Xd89*kKeOm7{RQ&u5{8F6qQqVuV5OM2<|KnY&6^N(Lz&
zrLn9pNTRudb}4Z>7>!}qU8YuZ!63dk;ttY66*x4gLZ}Z@@ydox3t(ZZTXwrJi3mQ4
zPX?0fPs<E-u{KU+*LEB177)7wCNcZ!E^S_nrfC=JAu%kI!e{V3j0)PqXH+5%k2mQ^
zA}d+l_344nQ3a;lL}C*gP1+8SDL|v3t#1-M!(~*O)d(X)b!<C;6S!32D{03_DSLP>
z+-pT0-bC<M;r8Xdg|An_pIyzyzY^bV38YP7|LO?BQK9tIN5XOO`CiEVSIm9|Rn(9l
zC$O?tx)09lUo)p`bALcLYT8+9ny+vTuDTP&^DO5R=;+Wx%q%~2)#I`ZK4zfaiAHn#
z^k;+egY{MOS$ck&_gS46JCbkK_ng3P<u4yRAQ6XR>yd-uk{%@q-=o@N`NJX>o#He0
zsi|asSI~|tD1MC`)nkFjk>Hw-Uo43Ht}FX!jY<D3WV<F*KlWM1*R;|vw6OYXTj`_b
zvCeBlqkfr7rNugf2F{D<Iw;)mTWENh0S&i}6V&U0I@IT<er)O5sIKSwQA&LNe_4Op
z@wfzUF{t{iG^s<T5mc@vkZdmTRx{XFYn#`bMqZyQzDIxN#R9v&hD`niW?Hx#RP!Zr
zh+Kx{u$cvJsyTbCs5u^W0p7MBlUd5MO$AAO178$0=E`d0&-En(XgEL*m+5*Jx{Qsl
z_T{U(^|8oRVt`8@na<fxZ-l=_WJqhp1HXZQ?*`(Pbj|`YVLfS6jRn8z?>KIumf(vU
z5%hT&3nJzF{{{K*UyvRDf^7U3B>!KK<^O^#^|G+{Uv1H+FZm^kv?rdVKh$4*`pRY6
z-&t$z3el(vK5q`8;iqNb``}57%KPa||5|tbslF`cwGe%~csA;_kox=kK`WDvt&sNg
zV~*EMEpPQ9AxdB40ZE(|shS^#SlFF@7^3~QzW>h;LqrydO&k~;qT$__{qb5W{kgs@
z^z~l)&3)OZ*SqK!^<^twZ>xW*FWdWizvl5!G1mx$$_(T1#tX0saNsIR^O%{;Z(Un`
zQrsuq)(!J&bB!A9jK+VJFCm-G{==`06&?L{4|EG|0>rYN>%;Z=Gg$fhW-T&=ln_YY
zy9M~}9H1{Cbj7eRmU(Z8b=()0($MHXsCNEHP|sO1T3xRU00{Jc1401|k&X|eY-R9#
za%YVEdrTDwCeEjSG67ep0?IP+Ga_p{0g$_Wr+DHU=P^`qBFq>axJp2vDRFdDsMd0_
z`pyIkc>6@47~YIw7dCVZ=%VtLN*rti5&r%N=D+dvfaPBb&fdkNpgy#hdyV+yz{aj#
z0aMS4jHhoPV-RH=9`?y!Zy@9K>ms8i9tG<tBP*39ytObO^O}Hfz@wm$;6D###c$;X
zY*6v_1n-~+eEd*0aZ|g1Ju1B9D&U<6-g+oozbRF3zs~M%iVrvpI1NwAK2PMbhp^t8
z+ebc7;die9evRNsLr9dW$dsJ*Xd9g%a5Z_6ZyLn%H;)g<S4&Kx68EUY!4&4%+)UqO
z5DVTC-09FDbmnYX$q{NEOMwiX2m*{!%ju|`ju;%9!X|I|*zo|CS?yL?#prq&7>fu)
zu~F@k1(QlaUE%~&O_XcUpQoflREQ5eM!W)cO4<bg_99@@usH-X6|U0y?h<G{Pq_U+
ztJWfg*rJ)qFPWdlWJ$imb2+g-8G-zuNJ_uZgpsr59Po7RkvXy68NK)xHR~F()DQ5Z
zoS`EjD$<T9c71E}fKkOl&ZDW`SE=5Q2Q%Moz4b#5u%vC7`deMuk!?NoJG-)n+q&o%
zcV+FiC+dHiz~*eXIU0N+ioS+Tq=Et7DEebEsz#`0Ow~iFXB57SO_wZ@L4Vnm_}(p!
z0)%{s3?bj$s1iN=6cryt#rL8(_?wP<q2Mna53-n(@vYPdsP^MFv;{%^i&JAXKh@iZ
zcS}r<AEKCLN0a0T4Ig_R$8mhP96z*l5>?T6HXyc6pwRZX*mycX-0<Bpb&u2=FfdVc
z0Zh>64R}a0duvCpexp&8&MmHxhTzRzXQea%PdZOER>UNvcQF@OV)mAR7y@bgskiZ$
z?QRZ^e(uZy-tHeT4@5z`3I|9Fa*6hEnay}RCBUe{*Asj@!G9XaN&w#j0Ptf7ev;s8
z2eQ5IG+}+-nG(=W&D(npc|TL0ALVt|w~J(V-U$yV031aVDckIW?6(H6kay4MTX$ma
zciRPgTp_aK@F<u{*{@kyo1K#b`l;}ea==#;ytS3B-zj%rIvPFkzYWq9k@Zi5Bu#D4
zn!Gnzf95H+=)IOrchSzPGiM7V0^y6ziTV8FQS5{FTI#1*uniLIcr60G?3p~{Omtxp
zeRd3=@WY3kPt)=FX=M5)*_4C`Z1ItB>yT(kxFc6eRw`GFpf+?>_wcIR`~v!0Z;Ly=
zsGhCkaho$C0!MzG!y?kHPCDxRVS7^c<e(Jn^ordx^^?19_SF0R9B-tN!jW5n?{k10
zA;_57Jf?f?QHvV&M5>rln4j_e3aKu2e@8fj_@YsPKNX@6cetcKuz)=vZdzd(iBLPO
zXX$f9P8etx;&xhOXj(hE-c1fxW)~bJlG2cdYSwAZ%)8p@rKec(uK4D6=w=nZ5DcdR
z6XsQs5;5w$R&498K>cfJ?7*(UA-ev={!n=4bY{i7kQ``K69uwo+p$(3$ok?DZ1xAu
z>W?NLRj@ULz4AeuUJ)WK*bY%&qrh@w^%b#Hsjm8J!D|C*FB-uIj$rN&I_O)rVoi5j
zyiIK+Hg>mJe_;e$x;wtrC*d@=9|O~)(VDqt8mg+3M5pDreFVF{+Z^T97B(S8DM5Im
z#w^g0tl=n~jOdkOu_WV^vu84*$WnZ`#5#O9!BL3Cs;v0osx7$L0wZ8m9^0H5O%w3>
zTBr3U{;!MV75ra;|BoiE$XJK}9eCf2|M%ek@A>p$M1$5U#iWn5?@vw<<Qww-gyOXR
zNcmzfE@e23*=1Q$r14=AtG{PNm!JB;-mJVSE7G5>$u?PAisOR#s1b?$K44^e#D{&P
z>#Zf`+SA<Y5_@k?c<-a(@JSz4dOWAB>u|gJg8P}In6!0v1ldA%Ad8k}^y4WJsx3~&
zqu?8;7T+Gv>hA68)rZCIZKGcu#wPC#O~KMZms9C$%td@#=P9)>$@$&KnESCWt(up;
zXEwg{B8Ch0=8gF3iY=}xqiIr%>HRQxWO*}?ksRmA=vX-sZve9}R<<|9(LEMlbJ=Ho
z564m~<YMa;*l7fkoJq^*ymVzSaC2|iU$Did?GX<3XC=azT*jl|dzw$PAs0l!H&Zjn
z<Mt^P2!vO_31N~zz!7*vuEQ|hA{LDIb83%lZp}Xh45l@AuT-6Pk^d<s0|aHPn=9XB
z&X1-#S{+1;&HF2g*aY_lB1UcAW*UHsbf*=*35!oEjYixGfz}zQV4gUs0TYmd<Air@
zu0bAtCV`Nx^8`%6Z;VNPxL<%={z9UtxR`$yr@p8mu8ctJL*S?*-vqFOibY>YcaEf=
zTq7#}beY0hobH6WrXY<}2|l4l!w@xgEa!hFL4|^=t0cJMU(Jl=Z_EVY*d>oeEwCyg
zUNWKB*0BT}W<eM51%5QT3I7n}DCnEE2U39mr3YsA?Z>f={4kY)13*Zm9E<PBPof=k
zHI|flByHegP`-|~@_N)hNT{C%%p>40y;UI2R0_;F1iYyM@r^$L97n*@Dlh{dlf~!U
z+&Ig;nKwp9AtEX(qkZ|NLXQWZRwQQnQ)e$3_&3h{!6@}JZ6xE|VN;w(Tuit$p_kgB
z2O2t7ZYExLAZzt$K*(cqgD{RE#R{BPL|kdYQIxp}*_5?p!#?fNdm7Xi_rw<Z!xsAU
zrzl0iJS$K~`D0_SC%A*``N$qZe9GhW{!X8cK&W7apLX&Z$L@U^(Xb-f`)rCgggZ>n
zzwXY$KKsUD3Z<#zA|Gb0rg#$;$P)r++<jvn4N%clCA<q^z!s_DOl3k{+129;;Zdx;
zoF@qa^h!wlZ6rwwTdN6_W7>tH9JY1*jZQ~;2D^Ov%D=JP&!fF6*#6Jk;on=I2R3dH
z4Wxz`wuvB(Ph|87VZQs~O>g%kKE(8J_Y<fyR%M%F*w}sT^e=W}Is3vpjO#}2PIvmm
z;p5i|j32^O9{Pam6&^ulAv%Kb<~`Z@edd5hK!<?8#|Oo`$}s89lnUmvKdOC05Qos~
zlEZ{qCIUZ?icg88cq6uj-3mT?i%<jpN)I++f7|Bmy3=>QE|6J)$vFV)q)Rpq^vF4&
zwrPJxaxYw4N>NVGCrT9=R=+gCGc0E11V?3aoX&(N(D66awV=>PrwRi%iImg*T}{k<
z0fsz%crxubFu9Na#>O8Aax6k^IM@osw!3i3gAJf2(7Z0}QPoGn9v#4)rUHWmd*p^B
zDTv<>#ZqwCxjI;rL*;0bO)GdsEtpLOaY`J%F$%)X>J_YN#`hNRqL22(f|X+4Th-nl
zc~|vi9$4>3$F5?R?GX-dESiJT1xG>dDe~c_MYB!?X4dymFq>A;sKK{%=}4)>SgqHD
zy@<uqOe@=6(5m4|z-c9ciQe>K0Q<5ayalIDs@`?Wsj6dKPK!D+jpf}~i-XN(e^MI(
zzb1g28jlS0ixp*j{XepB)Hv}G>FE+bK?1vV2EGtT3H!;%!sUi^kpRbFqbAaHED+qf
zOm`czEeD(VErtfm5a~QCD>~S^@j}W}x4Gz7mrSfN`|V(Oqj-Sf<k^HXgu82vS*Jts
z#ve`8?w^toEpnL}H)ffKB2DvPkrA)^09n;dKi7yA97>+_S0}2e0v~R}6F*eh2#&g7
zv=(n&1x4J<UW)V6^lMl!9as6!!pax9yVL~tz7`NkPqko^!)1zS#HJn|YJ3-0ig21(
z<><6OD?A)#>I!cQ96gIH;>ZH*wf?N?a74RX9Vv%E6vDN68{PPP4?a~gC)_M!gN<mp
zOo{$%;E^Q9gf7Ij`r`_+Ysh4tDdqvvRr?LO7$U~jk4p-sFC)4Jk5=7B>1CV{qo^Y3
zrc3(uzsRJ3F-{J-r0*%^OeDAMOZ643N$1s98L!9h3Iu46RKfg?2GskugDSzJtnJa^
z?WziVboEd3_zlFEVQmx4r1$W_nb$B=xM#tz_{*M?d~j#B`DpXB)yNh1a<P#?GwP;o
zV%#YM{Bus@^FY!j(8A%i`lp4v%P(TJ2AUBlMW?#F|KL+-{&5)s1q8Fzeg1PCGZwzA
z55*7R6q-$Pdt$Aw?3FmV@&gEi5ALV_h7G$_=x5q?K#->mn!&+@Sk8}jVV=Uk3Gb3v
zl@T-WO9rEDuKx9H-i2I2QDJivNAs5{Kc}!h2*Wuj=ZghC<V$P~o{U4}Ui{q%mE<^)
zSB}px6C1n`p~>CBZ2sK_Z2hse`u-8D@K{Hqm5Ap&JsLHX@tA(>(XkNyU-7Kj@er@q
zS+C>f$QSpKofJJJJ|v^|&?xwTfKm_H)K}`Ec$Ry-t@RE{6nq0SL)v|b`Y30~4E0Nl
zKU3DXT2_IYHCfH7qO99m*5(fE$K#_M^eIw0@0Xo58usnJ_=-;@*5XRSWD#sMSMGsq
z;Z)1#E7k9gdyer9!buZGv$lVnCou6HfMa^TNTA#&^C(>8m*Sx#nAfb6X$fKx4h~|O
z4zn8g&BUF7rqGITut<Il)@daB-GQh(4$;mGe{s@{4nlI@wjkvvANEFd_{%1-hJ!p6
zXd#{_X<JLCBaW$b0FgfajYH5jW!U6o<#e)Vs;~MTR$Q84Uls*=U+$w@=Ng04Pz_Hs
z(ZAD&g`Y@lZ6)nf=vS{l`3${-FAtI5QpLv*M-ckij?8(Yl|Hl&``|<u{rTSPs}s%j
zTf*6+6P*)xs!Jj>y6Z2owiC;zsZW+qgP$y))b*C=<uNLhdU-6HeX_UT;0D4R*nRbE
z&&ifU{v+I#DiSI2b?{RJFH>=5)=-K!9@CB(lm4o&SwV`2fRw3)FO4Y7;ljQ_D8jyd
z*qgOD71FL^Gl{$C0Ev-51-XLmw}64@cn~ds9mAd4wrujL?z0F0xQQyur7oCAPCRk4
zU<ZX!pFw67CVu`5GO15?!HI%Lh$)iJkp3#T9~`8nz89%7ep5Uvcp1%>Dr=Lwv&X0U
z=oiGWKE;vVFZ)SsPI3QM!9b+Wf7pu<Nw18#^b487k(I)MRZ-k>Vz)YIEbU~?4O1N_
zGf)m-uws2A3X=5H3)R@n#y4|Qxk7N<4;C5tfFly>!Hm!Akt9=6ZLWdnNz)Zc&uk^p
z#^e~F<UA7uZYsFB7h7Et*07&I6=>6dcC;k0|E_Q{^iMW-ekAuv{T&NCZUW&`oR|Q+
zLW=PD)nAXO$B%*)oAa3<(yvc?v8JV+8s^mkW%XjiN=^Eyz1WP>WJeb<r_u4>VbGiE
zpNqeWW@L2$yD@K4&*Ix|<@{J{(XT@QK^GP8MZZ2GiFAdG=#*#_KMGpz>Eshr@0g)R
zU)P1|Ri8ca@u@z0qV6uC-?LcMX&=WIZwU3Fewm<Fau*O(@-$WA4Po-LfQw4dW}aWo
zv*@)d9u5J(g?L%z;-PxBng1VKR~{JS@%}TLta~kCi6evraVM@y6C@;TNQk=YuCu5!
zakOd?SFBZRYp7}+Jyb6}5n5NBA#t?mrFu^qT0Pt<zt3mpjimkl@<;Za=XvItXP&v9
zdFE<GY35NassOQXbPI#?vlr%IMfL>u<hrH?+A2IKt2U+W{(UDxJ2uk-?WaH=*3-G}
zYy{f#4g|tAg8`}m1>%<3T=lE&y)m@t^@;gW{+c<1Jv?8T;*Hju30C17NzF%Ovb;xy
zS@vE!V92P0e3Qs`R=uK{c3szHQ$=}n9~?Sb9J0Xy+c~hA<H6m;M@gO46`DuI3=|$s
z@3iQ>x`<o>CJ4hMx#=bMnY(HR;TUhh3%w;5g~>5ZsLtpGC~8+oqX%SPT#}82-Sz>%
zy80o4fTnjjba^kNVn>G>OG!LgIGG6pW8%@S@XP?P_-aN7Ud>STbgsBa$K%AuR8n)M
zfc@8})IoeEXC5t+>V3$%+ZL7pDpEOB23E5>b8IEb0=5Kc?PQMSZs=U4z_cJ-3#yS9
zTXSGF5pu0g;gs_79`Oe|e+$Ym%~}4!lcD}vr@}mq!w|*i`W}{d!Y=qZ5Z}C(p}Oci
z=ds9YDjUd*x8EqFD@|M6jXYVYx@1rx2_|iTDs8~bCT7Fvn20nT(|%1?btvh`iElt1
zb615=U_%2<q+S9A`on>5`EyTIw^eEE|K(I>ixY2Bus{liPB9E(fH^M7gLWbI2O6uz
z2G$nlUzZy`_Vqdz(Mv)T<+Bn4y^)c9uE~glAWb4KA-LTy7~la0tY#60F4E`9-)`cK
zDM9tQ1?wH=ua{T9;YP0^F6tIpv<@Z@BXztkU!}^1`5(^<w}nOfSLRjkv@aA`l7AS0
z57_H(m_**!>TyLH{uFLAA(n8Jtz>=vFtGY!xxeh`+PyrC>T^WmC;KaKQ)g>)D#$(S
z=BWh5BfQY)ux&wvTfjvC=7+;E0QZ5<)fqS{=YAc3`sqEkkuChuXJTwE*7_%%X&dQ(
zoyc7EI~Z%B_1wqjiiJ2ug_4U47X8Q1v~WF93q;-(`dK413T(4dV?+HF&bANUd)y2s
z`dNFh8`#3%|7^RM5OVi94nTtJfha095vFF5{IFF{s#eRi{5M~*<k!H^W&Xow6U*I2
zv_GAd>;>EWRnA36h0#n!cRUcYX;VcjT97c#NCX3c7l9nkdReELKmA-}w@4IK3Z|v(
z&~V@#6`tchY*ihefN(M<E8cVJ4V|}J&;h*UpHzgh@i(8lOmkFb4gU}4B1^aRWAGkP
z%OCt%imhie|A@~b{5!7K_P|M#ietszFOz&@a6`r)3Cpi1EWeuI{l~ep{8;YNs)?L?
zFK}b-9`GzYVJ>AYJdxfH-;4hOY;5N3=vh^qI}hMl2vmC!5QrlxTMta1!qi8HFyE$c
zPtJ0x`Ar}+Hitvh^d8Ax4_rTRh8?5t?Rk`9L3?luOK*w)Wz!ocICoa_b$)4V=B*mD
zg2rb48s<xQ5XcWp#!GW!V^5@)Dd4kH3Eq3$%3Cl-Gf348x?!*EKK66@E$O`WIi|cC
zL}vq47El9%Eym4(SP*iIFNWt+U<l`e$1g0s6#kdR9roaye}&c_uJYLjjRYjb-gB<_
zk`Oedsrt}O{BrEx!I7KzWsS}G8ycs0n}!zx;wsM+@7Kv$gUcjmO$<rSnh`c2p>IOJ
zgjRehAoEH*${^KyS#OHY*H@(R+U#8c=s8+{#p^!099xF1Tq+5(BK?r(4-kPP!5wX|
zvf$IBlYKq!L)B247@Mh}!duN*Ec@Nrq72BxkT2)fgVW2pGxKfk!aRD=a248N*8L1m
z@m*uAVo|v6(RBYQv@F%pRfw$pD046+um_9>KicN87c;u@y42apz6$g3J{{uVtq?Qk
zn+wAQoU0=hF4IIYGwPR5wN3CsffL(kW^>i%EBDQF$>DJ3;+1ec=Q{-JUr*zig8$v{
z2zv@%L<*D9gGDue;`vxH#y|gjEnDTg{*CAB+pb^tA2=W0>>6%XH9It&iz1;qc65<0
z{O)1#lao;qQd#e>bfLQE__HiJxM-DX7fJez_<}%qGV$2loH1}lwLY%y>oL&L?JoCV
zV(w)3-C=igo}8=$Wk0|LfgVBc>hm7sE0|>1U^RJbv*SxWVxLlHX}>QnoP$e7@UYbc
zxBt}(^>9q{*oCI`Hs2)mt%5+D9Y7+b?l3uA0dx#fvxxiot6uC|cIp=08Li&ppLVfo
z**zwdzQw=t;*zqTZq~S;Hv2=rc&Xu=Ce#5x*<T{}>Skq_S%-x7JdHERu+9GOzsRgG
zn1%+P^~LoWulT2Z`Bd4I7d5A$Tm9F+>=$~z63|7yCCf5;c&nx;*y11eRo$ACs}wzZ
z6?jN{*cu!3dt2V$^i{dQh6gtV1?1mF!MlB-+4xRwdJAg{v-1@|$$>CxLN@{GUvMeh
z|JSAH-X}3R$)8Jd^c=r)B=S8Kl<+ZT907@V#Rq#7IU)INy%wQ5$5!n9nOK2~77u~6
zR1w8VLvj5Lf5x}NZOvZtpZ|89?Zk`zsh4AI8(;Llb$O8O%Z>gr-#t-n4>Rl?ayk+o
z{LI_-Ss|F7z4oHt`&}K|o{jIn@!eTr`+dXvo*&Kzmi=Y5PWIMX|D(Sobz7h_WnL9T
zh0vKlB{jv`wb1-|m;@>SL@+gZ@+wb-mqva9k7&xj4CSP?{-1yGH@dkFGpv5N($diZ
zf~z=0bvOMzCHDGEE}~2`nW?|tze)K#<yYx6=918h(skn<Su87JB@);E9?%hPfgN}a
z0!el(RHsIPF8;<*Qv;S8cCp095zEo2sCryCQR@(ixi%irVG?*LxG)FLkPgqd>3=gn
zvff;jy0)55tIhnx%|2?p{^$kk?X+6qzn<SBqPeERwECK={{VSWRny<8AiSl@`Mdp^
z+~~AP^frE!X}d?=H!q@Z(YbljV82@D-}!4=*#x7wv+Mko3i?+#2%N7E9%*x&Ugw`)
z(86~4NB@?B#)I6Dny$qtcUE6so`CLyV{d#4e6F)Gsqxu2Ag0;NG4d*#pM4>>rJ-Tt
zEK__uKX3sk_my)?790u-J|)jX{>!C92C-10=4c(yAsg+Unt=hPNQ;3+#Y2dEi(2f@
z(Z_oqr#KfB^7Y{9WMMZ{?MOvq3pY#ouA~P4j4(2E0U6D{NAMZ{l`FM^zcAqK1ph<u
z%l;ZyCyt0S;N}FkL%*jQ=^-gkJ;mSuwB445IDo_tk@yaM5)1BAq?u6=sVgu@`&(9E
z&TZ5e{vWSS?ewMr4<(ql`>6qphbsLBfB%z+G{jLP{)xm*{QlpjKRjxtX8q=K0G~p$
zP_M%5Z(SJQJ{ALT39a-n(HD^p+d=}=Jb$O(dkzdY;0S{8cyxfO!&w7*$F5Xup=p10
z3{l~;Algf!+njS6<};fke`6pN@^^^@`$%xn|I_b%g2TWS;CCtV0_t{#zx%cRX=w=G
zI3V;%^F&732^@RmK(N*AiF?W?FxD;$laH;!xHFrs6Yfc$N!-U4?v(%9wVKT)6Z8o{
z1?P)2UlEkE2>z7decb3t(93K6?f$4+(ND~2i^rq>QGc|pIF+E!El_p;tADIb`vCG4
z$+~R~&}E={`Y^`bE+K0!b73yW%~PqsB(?srNY*cj!-WevR<wV`pEcvp666G^;QTJu
z5qGSbNy#)Rr`rXeq{Lp+pl4Vx)d<3=%d1-czn}I0{AWZ(t!y0o)O=s@hx`>+nZjl_
zvp|D!bG$$Lud4nze|cM9f#^lqxQw1Idz7X+sb0b$$>v3kmxd+#;L_qH{)hgq?<r)K
zr&zT8IiNnUAo8mN%uG`9o1~ixz`wO0K#nsBexUv41kEMrO=gIt`8`1k0HW#t2k#Eq
zg$l|)|HZ#+SKLeVQVYGuZ@b>A@@GtLg$3emBmT<QtNI6BU)b7(!K5goWuF1n5lwYU
z9mDPMMH!6(QT9;_@s7XZjk*<^5@fD4I;9r+V{g<P9!}6XP!*ilPm`y_{-KLRlX7Dm
zOX;=-T_)+51iiswi5f{F=rTd;it>4fAU0ikvC8^CxY4{~9zj<uP_F;?8*vrCVewqI
zK#Tk_H`hLPn`0Apu?72j$AR^BjFE1zIFFYF+%a|al}y#hh$9OTA8W+$G8z*>Oh*f|
zl^94E3^x90=;Zr%VuTg`=v(0x?=j^kEXu+D$8I$ZzRQ%ci=7xuAJIMdU%C|?e9?ga
zpn~5e_$&YSw>kzdGvLhxe@U>{-|BY9;Q0pJn_$dhaB;1F;qCBXuL0L4n1^{(DgVyf
z^@9f(u)=PsY&XGY{ROuh)EaNV?-Kkt!5etPWK1pRv-{<@uZS9T)Hq`oa|pN$o)CK)
ziPw-Axw(@N+`#atL+~#Im+^miXHxJ@L%qodFt#}asOA3FcaMj+;R27()tp!~_!{~J
zMYw_KqRRLXnDA%(b?<d6dx95O_*`GD^iR3xvYlM%UvjTY*f;}RhNKudg~FPcAA@$<
zN`L;n#Na@fWDv6%<?&Hp=#&4c6MXI|4ZcTt_7mLGKjohWAuky4VS>LRxcYBknpO9?
zG`vCJxl_iU^N%z52(Vyzfkg1r=~3>V*0zyn{q^oA+6oK&<L=jMyX{F$)R^hUFvH<`
ztS)ICjG^E@M=6p#Op*Zq$M<WBLH>*P6NTF!T3Ao~>F-q7tgY(|F1Se3Tl)15z%kl^
zx*JJj2OyMy(s&p!@Cv6)t!ci6`ZpEUv^6~I-&^>&ZO@tK8i^6Mgq6=_iPj?hxsOE+
zTe&mOT@>z$Bl2id(A@AjY9Es=glJQH$!S=p%P+<+$Aan~EQxw*1Ba?C`=rxyo)Fy~
zQ7d$E$@o!9elEmd$Fgx6^qm)=`Lcse)D9kQK)V3S&ZMFqkrQpAPMeknzKrk}2(Qmo
zB;LV76FF-p4I^%SerFkYl>*MWGf+;miICtQ#_B}k81n<hJTHH-iH5;%7<drjX9<5%
z)(sR<!H*mG!R3HoC47h+87R6uQq{npAiM!<X=w!sd|mFjJKQY{2++pcCLke1GHDu;
z=7(P>B_1cIl-)BR<$webOkD~okIEZ?qEX8YrWpRtLY#QUS;;u?M1hIr0`yupPbeHy
z=Di?tM3AUr>$hBH1c_nQhVt;TFZCWBr-8@x)(f1zmH9!UMa9Q+Oi{H5!{_$N26iz`
zJTIkPw6aw{DRb;%j2JJYONoS*uR;&Lw6+j#FTPYP?y1DyYM8Bk;H%b4@D;S5u<03h
zV0rbd++0e8wK)n>eLKR*lZnocI`gpdX9Usxz#H8&ue5i2J7cx0dl}q#PxR+rdA*bv
z<XJl!WY~|3iq!T+<TM{U<oJypDgk&$)48Y`!fxMW#+iJGQ^Zs1$?x^+nH2!aWGVwS
ziEG~hgC1Oro=Y^F5J=}AH0ZcuG~ToT9(x&xPuOYjp~d)_jE-qA(P#G>^!@MFmJy+k
z++7kBPymhCZ79Nm()f56AE4`uIGo0D%`^WU6Zeyc2|J~>e@DTci)f@ccXn-(f?X>q
z`qDsGYp<MAMugisdgZfaMC0~3;Ey@k*ZgrN9YAqp;S<(Z7>xO~_(Y0RG>xkgQcQ6s
zVK(kaT_Ud|w&yo$aypccn@*2Hs9#x!4yZCofk&``#=w3CjDmgwi!#yMmGAf!SfDom
z%7^QN`Eh<?^6kB>m0k&;&p=i%35Ar2LZUJH3tz$U^<){H1}?Q1Y9Q(=Tmp~LT+O^%
zH68O**Kvz|DuH<1K0E=uF~xO$l-QBUzh&W@1D_m-6NLXv{{i4F%jK1_qN#1pa#^FC
zh_sDcF1wTyBgb8#7(-B>%7Ex020B@RatySx0v#A=U<IZ!5Ml)~87OZB+98l%85V9L
zDk&I##IQhEzLO+EWO#WoEMz!f+L@UR_Y>Y5IuOrQH5Dn>mlv^BDgaBEMry>D@|W_W
zzU}ucS-ygZ9DWt*DyU#wnLgJ|gw#P8qlw;bXkIx<=qz!ss)oZ=tX=~OSM6cP3p<JR
z2xWS(HssC8sF1=fJFfE&*u^7sI!mspfC}_}mfTrEjI=Gwk~JNoPR(Uj86D#bm%hP4
z^nm>Y`naX?5eKx|Crf%9qFR#~uv${^Ji7jI^urIckm^i4Hvh>Wf!bD+W{uC)G)wLS
z-?~k~H@_j6atXRSnzk;6wuDxqX*)HeTHRkk|FBN~3-v3k)7FLFn=I`XRB-PlGP<Iu
zR=u7k$WgmNKx9i+v4|yd7?43BsN(YDnkax(6-6D}!DVtsMNz%x?!~6=#?a)&Yb=@f
z%it*>T(P}OepgXc>9oSaSJ3#Q?#x2qQSXy*FP3W-h6Yyr-(i?KccxZ_2X}1dWoJgn
zqT~AI>T%0tYo`eJw3^Qh+q>|`nRM{RfiOhA>Y<t(_w|qc0)DjD5AE;7jRTO}@c}Wq
z#kxi=G6_A7gq9~^hMg1Pj1xR$?<xlw3g%NHR{YC@P4i4B+^?G_n!D>tCH5x}vl%UJ
zpX>ES@+YU5YRg<I2UHR*y6pive;%yn;x6|XK@&9yWunXD6hQ+4f@Zth@lSWY7YOaF
z3H2~?xsvD}yb?gjUmC@n{T$7J1v0KO2K%RwU}X_wo4-`9sVus6?}ZHJ*D@VjQ+{)%
z1OZF)o2#SvE|`b!o2CQV$L|93y@B7~n(sy)86GTfmSTw<A1orBAxOXAv$#O5pB_u)
zOTnVSL+KO>N{EADTrdQj{{n{sTqox`!H*jFc%2`tGxPaT8Xv>w$-BX#k*(Ac8Bs+v
zuiX+%bbEZ8He%+d?GK$qqi1iGv{XI;3R{b%@`WlQ)OK{f+*3u=EFGwm&6WFW3YYw&
zia23I&-!sy5odd8iM(4?H1ZtLH7qX?j+QX>g}(1BZ_!uI#YP#Su}}uR?fZZkn>nvi
zDOj00W5ZzE72p8*yh@dEvyji#6=Ahr-%F0#fCW?7t^EO70?_<<c*4YIZw(T(zpAFU
z59N<nZgwGqVT<Jnmx#ArS|lq}6RoOl*A*^L9n{at;?7f7+&qal?V8$pES8>XqEYPm
zr@?zD(2yYVfl&8mTS7$|p?*YIJp`(P$`mRRj1Kgb-&GSes<uGBab_0{0cpWw?Q@-6
zBr8@I&1^mA%ed;Iwyn+6^3m!d)^=!-l-0$|#0?-+H(<f)&g?CQ6hh09S8om+<<!DE
zgq|f06|fs2RMq`zKkZ(h>)l1NcZi5=_&(qT4FK4}kJ|X~@q<z3@`GhRaglr}L?k8j
z1ps$<V+BE}5U_FXoL36xxj%=22wh&%KW&GD2tz8bf#p6-XVPJH1+xked^}S&s3Gbn
ztOsF1$gTi*gaO@v(AdSdGC15j5f_nIIbT2==o1P0?C~Z6!Q^pXa;{ufLqypwXUgmv
zqJ!-~ro3H4L{}`8%T%}{0~I+_wy!CYo5)N?aqO6d_BXc_+Fz41%zghLY}L5OWLBQi
z+E|(?->4}D_E-#h6#x^ypf#*dOsgD$uq(kZg^XC=3tV0e{~=w&D*&#WK@RrAVV@ZK
zY#z;U_05z$Yl((6bv(3=d@uLQS>~GNCs)=IHM)*O{QMz|>(h;A5W^|OVU3UbPq-Pw
z#pA=6OnJ4I2roN+E3Jw=^`op&TQqXDC#wynUl@YD3Pf#_%W8|zY8`<}K5#j#U^GN|
z+`?rTT$dtTG;m`rTxYqbwy0+tk|{6MM$Mm<Da(h7$2_AztJcC)FGxh`{WKlr+7ut3
z@uNOI_V9xjd2itdExXnHU{TM;2lmfXS9WqqqrvaZ;bk+dyoXWbDvq4lTDqZ{x$a};
zs2XdsAv}(f9wD!Uit@I_Gv)12(X{Nnh2+@b>O$GPj_77fUnpnR5n;9o3+1{xB0TN@
z3ljEX5@rAe)zK7!;Olk0V?kSTUVzmL=x7y9{@9DtzXtjRgXaD6HDsl_BB`-6hjQks
z3!sA8xtQLx6kmf1NE{oXea)BBR~i!<v{25gD@NOzERa9e6+3G-XV>O)yof5Cjiago
zs*>ho|NI^KVVLL^T-D$^5T8c;JF;Ru*kzBrBiq*#!-Ci7y6@NuRT-b9OK!uWk9bCI
zsV~~}d=hY9|L#a(9hG_E7=*C4T;&nfrw33^6SbG9%)JqtAh$VhSf{@hZ8)&mDFCYV
zG9p~ej(ql0=9HJOV^uPWXZIIs$g?^wf$a%=LVg-95~7=G9IsmeBF*i5=UaE+CB66I
zoN|_kr$IUD-XYm8LaZOLKpQ}gEgT?sF!8UCur0KG8sBs)(X(;N(99!^_Pp!@jo$pN
z+I>M8FLF*y$|`+zR{D}sPe)hEmJP(@M{2$S=UPTjxaPmuuKTKT06-%%&|-L}C8vhq
zq0jSO=m?6UcY}u=rZn~fz(D>itd{KGC}pnvy@BXx^KO?d8;Z`JZs3Y#Z+)ls{)~P|
z=bzVgIxUFsIpmiAP3LZh66sL0NXKc?*@c15xQG7KnzR2xZg^YFiv>_jLRtMYKMfo1
zE)2u=#J&;oT0_w!xQ;fh9Qzn~6NOwYo59N<BBig9Xwq~JPEn-#JZ0R01<Brr=n(rn
z(bts&_EtTvo>Buq0nv|blixQI1Nzh@*yq@UJ~*2z$ZGl_jUTX$nZ*W8u4WWz?cul*
zxjAr9=cXrMU@)8vI6G6(az&(Q)};~{z*&qvq`1{&1Pbq}@iTzV*AGj;j+gMIE`bSa
z0QY*%1E&OE|8Br>NKgmm-AK`|;v{}c6cI8pVxAn<Sk$sLdQCpnSZt4KjX@dYDflr(
zw&VZ?lq9Q4EjHK|#QsiQjhFqJpwFCJL&xd|xVj8m4g<ibr{(G<VyNxCSLC%OqK$3t
zE3#ozvBtH@xTa#*E8W_sHS_t)@>EmN)#iIyx|)eTwlu$-&<x#WxL?X<BGLBEnw{S?
z6DvgU1+(H40wW~*HZ{{(KGj033T|uQGx3v+lb``=lMHPsj&}MRwgWP=5kJ{q6Ml3L
z6LhLtdnu#Y1d<ZlaVGEM`_>RoCGjN^KQF_h#O%t??bLBneO+<V=ySDXr*sS!b!ASJ
z=xl4$SvsS|V>MsHK#7DZalGt8d-dULU6kiKNpG~M+hnrAUqJ6{4(AGu@0w;-t#i~D
zn4v?4<(=eb(U>?TB*@#*Vrb2ShycD#8IMbns^4x+_ghCfwUyXqYtvCSX)U@`uCh@#
zo0OMG?&{zSlJi=NkcXR?aF1s&ie(-cq56MhI$yd_QDbvn068zy(sxO?ahF7j-q2c5
zF-V?nEs~rQK~Myg07kSC57(&ASl$YMLEHf^>h#<dS&2`{)iJ_V4G-)XXrGlPRW33P
zmRs5&TbUc>(Ke!8rOXXl+)p7j#PzL^j<%vfm!1atjD|V}!e{@WkMTO@5W0B3+v&#b
zRE~)ZdF{1Lj4_5!S4eoLt*Gh2#SI-FkYi`QD@upXrsJfFqqhD&o?aG5!vpYLFo*Wc
zJg%alC&TN+uI)3J9qR@3K_3E<)!~xPv|T>01wY1+&-I;ygzzooU~dIiX<_PMr-rQ9
zPLyr1S;uf}*FUZ|__KI_iqm~GCCk2;p_mR!UXXF^L<`S-WW()Uzy&P$CU2S0MHBkd
zgf5%V6%*pN1W^8LLdt|Lo6s#2`qG5xLkA_dks<~5CJ5!4P#8k_i*dhoemha#lTM(|
zejKeAB$G|(2NN1^Lir~2m<j!ELPJdGx(W3+At&dFS@tv&x@vIU|AkAmaGVuq**l62
zGW{XZz|#<5i26l3EEUHVs2jz6ZXHE)1(nCoVr*SI<aQ?JV9Q70DrUi*+29Y*;kUzg
z{7uJ7zkQR5@&}^m-D0p%avqRpTjU2HkWVw@3$r}>(JQ?ls+fL*MX!G~`_6`b#{bJc
z-H<o<aXqBL5kU+&c<TU%s*$7H65U=UI-yb7U?DgZ0fl;@*j1rfP}2bI4oCG<{`YiK
zS5ujJM-8mN=!Gv8_&#EL9Xq5v*k1Io?O89KF(N6p85rqXanFGI0vgYQcS)SfCR0tg
z5K5Cc{#;9~IxTOx>x~sVpNSD0MB|?)>y#vZvbV7VT(AQv6))nwVYtkavQMm-WGgG>
zfmjjO!b^6zmlb}aT-D!<bvps$<;qj_fR|^zlZh?ft!2|VQO{Fbi@+^Y+Wz?b37zs-
z{A8bI%4zQ~kJz2WZFX7R+_=%J(DnOsl$)z6>N5;-yuxubauuo5-;Z0teD*gDqfj!^
z9e!!e$R4EAgB(%JLzc{m6NwdflOHz4;vANJj9-R!5Y?ksXc%`M;97Tg;igS&P59Jr
zfqLy378;(b5d#rz=yP&R2hqB1)FjPHFQR>h@9f2}MY;4_{%r^vGbzHYQOA1#wZuYQ
zlczd}I-YMH0&Il^`}8g5>pu6;aFum6S@|s7HsWHYgg6)fM4@7)4AeA>NweOfS!8J9
zHO5QK^A=`;!5BH#6SF~M0&(}#&L=vGIMH&}L|qCY6M(!0q_Vw<6k!h2L_C<Rk#`>l
z@-~q_$%~!DFz21uK*PlZ%s%al*T|%J5p8>9jhr1XYFBKt1`9rq%r0=SnAXTG@uF*u
zi&$fHE;92g><Llx_3&yxuv&@)G0-+{wH%xvmPEhSO{aHx9MT)h8R&`EsTzA8*X8uq
z5H#qtsrf5(0d;t1l??7Ie(`M3d+}1yvheQrLcJV!D1R-g6b=QpFLX`S5c})=0TbNr
z=?IPBq7*8x%L^zk{`1<i@KsO?pxK)6Y&u+@j=#g1nKA`<%^n68_F}S!W*NV+4K8AD
zF0a59L2^zPxa-O=#WMw|+{1i~zLy-R5?b8W90{9qs5Q{I^j%{-imJ-9so{Q9bXGhA
z2}meAMqEtLg_0{jSC$}gQ(oz%do<oTy_&o0fY!O4jrBK1bnhulEX>c>dr+9?krq5!
z+dlR+I_S#e4;b<Wr{Bj~D!5iql~+D6w_lBwsfnVxXA8>L${cz#+=9XKF5C~}sSES|
z4(t&#k#H{h8%ZXg`JFOMB9(SXq*z;1)U>St`CP9;-5hZHvpA7{;MgpPpQ9c|44#X`
zRfb$}p3;mSjSG0CCP!UH8^TqJ9dY?Ax0^y~!~k)WjSD^l%`#U7Su9<E#apmzC>uAf
z$>Pqwn<W*Tqu%1E1O<m^1&1pg;-O3`t+tQqxsfg(gTuXAnW{y4zJ+dRg~`D_xhhH2
zkvoz^Lr;^@fI(@aP+O~FkC{6B3fMtEoAvSn=DSB&PXQ?NDg|mgrw|)-y}HhzssyM%
zNRNX8zGf)zQ>x-FM(6y@xk%UWGgtKl@N;In!FC`aTSa*0-Mr8)XPlbO=IwJ8);F@f
zL;XX$L6|9M_11(O*6o@43Pm>Qw~f$^D0E8-U714oT-lmQu9`q5&>a|MEM&sZ$-P}g
z2hYC8sGGC8kLd#**@L;O4pKk=GE+5O*P}!Xu@DP1!ra!FJPe4T7GgXRxMDnlV&|%4
z3cx%crM9r1P6+{zE`sx<oSfZFRQ1f&EJ4ZzSv&`g5tEeb4P`n89(3WOBL-rzR;Pho
z-%uBh6QJ4b#b!(%ih~1cAhp!OYzjv+oqP!bV6QBI_0>r9Oa<8X&$Fb!JwhB1F0AlY
zk~q9rUOX(T<Cfjvh@lYE=jb;QIopVwsZMgTThtTDa+O;wN$5;{`5YTY0DX<<#amby
zA4IHz=tYzDRI0$|m`S2PNHhXOyW#4?j7|<n#(KkFZ_8Q9qHFXIsP(&}h<M@yN^5FK
zA5^1cZ-pDG8RDgSgK$5Gb#49>`CGDxt3MObbhpJ}9Hl=D(jviG!;xT28E_jZQ@V@6
zF(WrqxE^82-p_E%!<Ou8mYCu_tg11stS({DfF2LNhoFf5152|rqo0zOyNl|P(@+2f
ze5-R{9T+x;(EPM8ytV+7r}uSN2`PV-b$ei)cZXcuL)5K2dK1&cI+7*wHu+%>5h0Gs
zFMEgvwKsDZ!VzAdYbk_P+&hCKO&;{qaDdlJ5pApNdg(uTzWc5ml>*0Gvn6s#is<~%
zDu@Yb^M^oMUe2M;y~x5eL)%@0JW1sHM1Dl1*KugEEKCt$4YTNDLVc%!@wuU0LfXTm
zovLYFV;0M#RM97K1lyr?%FC{{zpFz~8qepwphJ1;S^b-%=D$HKrVqE23t2>-K4vS+
zkYA^Y_)3u)d)kfK2!rRw8?sqXSPP$QL>yE?9NscjK2LqCvx4(PR+WzrQ0qv=dW%lO
zRC!x@6uRD2Vrn}qs&i`h1=F{KUt{$qMj%t$HEtttrna*iKc#k~)5-5^hvlj=Wo}Q=
zvr;6xAzpF;0WYc>+hwy}6!3)y0#?&)5&~K>LqNO{JUW5`lIq_Amir$8&#T?%O9}{6
z?ty^k)kfebU?V-ALO}HX`F$N)KyCEpsn+s*FOgKgF)-L#95W*_y`?73Q$0CUP<B|8
z7vcErkS1ayPoi?RF2r>PSP%)w2;}pW%zKV1076rvtgc}xYEzns_n2qkhR~kmbLzY?
zT|b=8>)GgPnu_Y>Toi{8Z#KX4JXmDj63&IVO&It*r5->+2*Fd{A*g1!$s-F_%B%C1
zg7hV|US5OT2DQ!F7Q_?5{*<F-JU^iqfZv}3@%QW4gl>&ZjA`Ut#7&Ycv;|B9Ix<xS
zBSjuwMAM)QTwO6bVs?7W*i6s;VHvH+q7SJtTyvbq<F&I!fVFvpk7Li7UrBR_qd3gH
zg0<lPsH%r30OQC^H|1h<Z}E_3*X$~ENsi5(RgFs;9Jlj$$m9)lG5LKs2||zEkSzws
z8T8+LK8Ka7g5Q#>9uciNu3ZmY;C^=0?K60n`fN1I82anbpkSZb8}J(!N^zesysEei
z@-p}o^aj}-&)PnsdGM&Jpzt|9>yHNOMIBS0$WDDkk|zMoi`S;0X`vqTmXwR=ik*uF
z!OH@b;m%2ZcpVj<W_<hMfv^p62O)mk-rn&EyXIq?T>P?0*xBsu?&jJHS2I#Z%_&3q
z8^N2P=W*aPrxD8bw@NfE_v2k)loEDNRyMtT0Hr!fseT0l$xH$NPskc+O&lnr`-*Cw
z91Pv$(+qs1;bXQ;)iKQ801P>NxgU7tlGjSZE8K`2!5^xgRoO_a7hcj!u#GRt_UKwI
zV_(BI)kD6g$@d|{_v-;#72oiO2FN*>hb8!imf)N3)Y&%TPBnc00Sw~afXg}iEZJTL
z99e(Puw84|7K=Lqd&i+#b>uF{^cALB6VH@nUCprGYFNKO)}N8}62Mcvr?i=^Tk_R~
zILMoMuP{9<v#?Otpt?`V5BiD5%_pIr@P<>A-g9V5=#<%TXg`G!mO&u_z`}X1`c#(d
zFB;gkJSn65W0-$R_USJgi{A3-{-W!kicd1n`tGa*-X!Y7sj0-6hR(%8S9tqxa8km4
zEkVNV%=>j0lcRR&-@^rXx++&sEYOQ^W}SnbV6_K`X0qD=(NNr#lLv^f&Yzs6pdA18
zklY0&1<lTV1lfNU{k<BC^EGte;Ub1Z-V0#(y4E3bX7S9Irw53}RZ5$PVT|}bBbIws
zRv0L1yPEw_q;qH1duUi#p!w-Z*<qk)<0)N*E#a67q+-m#QV$jMS}?(R>dJEjAH(Ku
z{AS*=Wdx1Q8iut^`z)vj1ckh%i|0nu%c^@YiP5%G)nE9)X>FhD=Mcl?RdNAMsj)Ew
zZMc!cd$<7IJ)D$EDEY@gYzR0%M^+dlnm+t)3S#&i-=`r9e=-Xv*KlVw_95wom^>Z}
zG8fwa^_}L)H~X*>0|)jr+)H5VKS!<@B)m1tf&n@gZQGt|0%pDn>;`f$Mnpd<8YiFc
z3D{-}_SR}<(y0W}O0ljHNr`PYlPh<JNx0P_Tm-^`Kwg>#pM81uqq%bHqav!t<Frk)
zO1rb_a2>n$6Pyb$wRh!}M@3z6TUHn>#@L!}l{4_0vaAcMR<8GqdJF}5v^1v00cr~J
z!v!_W=MdHYSvqKZNqEZ}Lz}(|?F1m!RcHyB_w5;-K=pRITsaI&a~*~Vr|o2#>^TH0
z_=7dDx<|LKF=a|L-770~moNt~D0zA+vNp?sw1+%HF*si2pFnqsY+ov;NqUiFCrM&J
zlK+<ORBxnL21R=3qD=I>^B@z0^@c9z;wM2!_uYQFVE>hij{qsY&~4KUBY%&fkpGij
za>!6Is`ciCBF<0UX2IA4{)fwr=_R>bo^H659|kV>d&=6wM63AV2VAaT>yRqEWYml6
zr>Nf1VDN9j9{m@~M9nhN_E=B3YnZ6lv>U1cR2EOi&)d{T6CYKX)ERS89KGV}19|E<
zC_)XALBmB@*SPqiOjJYiRvCv|LUh))gMAr%f&Ug_9w5cq89z<ut8zJzV-+~Hv$+pu
zNveEyxajSEs#8%C{caW|k)RJ$sv+Mnw;3Mf^zhXGCb9>R;zVAV%0#L=XZI+P#L*Pl
zXM`ACQ@q5<1|Fc{_VvGEpc)B&trjHDj1UR6A3hE(c#n8tP{9bhrAk2q><?g!d1Z@{
z;;Wc%QP-ikN^U6b5gevfcd|eN>ydA~!5qj&-gHxW5hA0Hm<^`|+w-@w^JA#XrI+uV
z_?TEIMCQ)lMu|xx!qyc0(6Tx&)8sht;&a`AkICFtL`>u|Id6=}wWY0-J;#cNZBgsx
z^08uEn5V0jBoYE;*TRHM1usTx=EzVVYN|X*Rvstnb^8s@Gn5Gzbgt1~l9h4ITy6>3
zbc1^3pFlKTYgM7yBHf^N1BOh#hbEC7PS!8TIpeVQzI3A8FizC9jh!g>juS~$mR8mx
zgpjTi>1>N+)$yWT-}CU*;r6XtNU?Agef_X=eXcN=aJ#izp+1JW62?_4=JQX$w5P?9
zQ5VN#0J%&mFHV=i{i4pv7sq2QE^dPSdAtZ~I)OOaLu<9ZF^yIO0OAcx1Npv1!hJ`2
zGg`O_nKJruQ8lFLzp-H%Rf%<F%At>ox{cxzS@-hvZW?YswD$l&y?2!YfTNixRbMN&
zJ}&z8xeQ$XA*2hsm-$V*7T;6({f7A_!~B=bcO`!N&G(NeuKcCudmFwB<{{#~MA>5k
z78%+bz2`$u+3i82{0mT|JwWj)Km~2^v6vs+l#$2}Zpx^_4|eU}BN@FZ<8^-MO&Rz=
zV-CT9153Tm@61h72p#`JjpIMFLmYf;0qlESUyXT)RmC1R3F~7%$LE9fl7s577qPPJ
z)j$V*>y_Q@sCmA$IqW}>w)$N*oG8LZ++K7Rj}iG?&jZ`~xN3=+M}B=2y_%y93`h1D
z<cf!gu&SrN_=K`(6M-)a-9ctiX?uYLcbT^5k8hFoLx5quVS2L*m+`7M<I~GI>N<vR
zK3;EVyzaiL0H&?myF$nDCa1CSUR*m#)C--9yMbY-;gT%wWAJv5=Le>e-Qj<_COe`D
zwmpaOSle<@k1!=Pex(M{Kqy*0NYMf7uK!L9cn`~WC&3MAt`pL4SPgJ5xH4boqev4e
z&<-?l9537FZ=)uv+-For-_g(nH^EU8Gd?ElfhOhy3{B*Z(waDnpHJ9gsE%!94o_u2
ztq$BG7U{03FKQ`%{8=k!C5HWi59Q1!L~Bpd9o>>|u!Z(Pe6?vFkR4FW;jARAKX+IQ
zS%1#(gPVG0^Mm!LE<W786%m^d)6}7uE0orf#hV5nW%n{M(<-Fffi4J2#FWPh?Pn;V
zQdI^yLkdK|?cFP5CyR!C=SHMK-?(Wi2tV;&(fT-kQ68Q34Y*PG2xEa@4$~PaoHK><
zP?}XZ*VG6aI7M$S^wHMN5t%nxxIElQkDCT@-TA*>6^qBpomD-bMxIb8U-m+wyaLs#
z2u=*V_Rz;z>5{nl|ISdIlDS8k{UodC96iuFI)Y4ZpJ3Sy-BVO{>EGZ*g7$8Y&+!qB
z5%1|#FD`~b8oD~&Qkzzh(jgeTv{mw9I<`KF<793&&_JC9!h+Rkrcei_26>6z`KwrN
zO*Jo^8^5UfYF;>ygI~N;)*jEJUBdu4=2k$8{C0{6buOaAk87%wacj0LKUFjw@P1DU
zqYs{c4cmvU=rjH6XiIXQ{3ChaY~m=Cb5Rr;F0ysacqG)cA`TbT^EzgpTJwxtHdVCp
z9D&y@+hMWzN&DVm&4We9k}Pn`iDse4)23j-$watjl^T`*8nWs9sCOV7{nc=VMESxK
z8U3?qDil=6uD~C=zIz^89Ej8?>)fJ*8thN!{>ud|*l6}MYtN@Lw>qIiFcLXC+9QWe
z6X7-M!j590pnip^{+di{)w5D=m?ru@l5A|W&T#3m(d~d#V14(||5OQ%(;acg_Jg7G
zFuFN3nMVLa$LQ?{h3F%$ZJ(40(?yLcD`7wZF`S5>ksVd`N%_QdQMbm_6}oC%g$FNt
zs%~iedH+b+UGkObqEYCZV@+Wt!azgbUm@8vLxu@o{&ZLb_M5W740sin&ynsK*eaJW
zN3NbB!r-TTZw73RPAlYBGq4!&5ZuAEQQ{$bIC{F``pwM5{81t^`)BFQqyh$+m&75>
z`fMvvv*AF{C&S-fPH}X%MW6j4WDAr-NZEjtr9jD{GakrKnCCdmIdD=xIf%t`Rjx=E
zb;F;AyYguKHPAz__>kpaV%*0bJ~s4vvlSZUq#-glUDU2#lh&!%)eZF69ub8f&`nE|
zB16<|zXQTzE>~w}8`@#KY%fo}02m+P<Jg_K|NBH=_c~bd>81jHqFB0K9FPMuL_NRj
zs58!V+*Swieh1w_xRcRA>@bs;RfCaW=9o188wgR8P9ynIJ@f#{VX1}(#x~MTIt|=K
zm|7TUu$u}Uo?|(pqOKZM&56mb#G>C!r!|{LO+?d+`lrz)9dfgdp|#<yCheI0nWm-p
zNPcxtW%CIwHNJ#r{SqfHUPfH*#`XZ#X?Ts^M;zSSk`nX8#hD-R2(Q;s1|nn!BRbnm
zqY@leX%4Ar$%Th;-5E@NEbyI9a8?S!o#VNGIXy|&R1{>={#k1sy{{GtJArSgWc}&b
z{wTP6s#xrgzfX}(+izvDhpx`|6}Z#kq<U|L_9vG`rRamIQqWOn7MJd0h$MbZF@6T|
zbu4@-crS^cZtzVI-w!-i;n{_(=!X24lyV1*X^5ErHYyfhgiQ|oTJ8OdlI1AHejJ9(
zzn@e6d5|t9KBrpxeG;-}r%!|E={lWbYFh@uOpmc?iaiO8s@#o9d(dH88fr^J-kV1a
zHPN3rsy=@6s~}wzwfe5>zh$)>BGTVks-vnu^)D+CD^%)bRH}i=fuFHXp-NG*IT#up
zts!%ERjqi>e)Y(EY$8VUdjLdQ`Qz|wX>b6{F>0{&bX@|tbkXrQJaGDEG}enMC8G0a
zGt$Ofo!L$C;(D(GstM%IuUE`)CI%!j{C*l3HlnV)j;-X#liuWb@ZDm8npzy?=d;B_
zy~!1WbfmsMW=j(IuGa;HdJmT*6iU92f-hLs1xs+lk&wRGJgu!BF2Q!Ij+Qh~4xJ;K
zc*r(UUo+eUJPRVS>A+S$?<f)@y$=SnwA8>)QOiN9f<UF!X_Z{$65}-X{-r|k3B?U$
zJ1nQ146)@WXMS2KCH9Gn&V~J8G~@?rm!cK>*M^vWX=Up;Uo)h;42z9j9S5lOe*cEY
zYx(a@s_enZ&*R!ZcAir}pQB|vC~pgzy81$AJ+vpXjt&t{u_kyZ&W+HFdbm}w3=9Kx
zV~U;-kK<xM<{_B$9jK@P>~`>l9?3zkO*#k?Oyc8)_+e7=TvKSo$-sb${~~!!{`@4o
z&kiHX*tQVm6h)~7QN~*9QMcM_Ig^RZCGxMS%&~o{c8xkl;s+~b=<x9x<ALu3)jdwp
zvh2x(qsdfpXSGe@ckz90Y3@RMD;@i&ekH-BdNYpKQOEE~#%K8fa^F*8c-=pL0|t^b
zLd&ZN4;VByt_>s^$4wuVr^*g<MM$l1xO?ybXqkZYA<muHT<iF=uQ3&>y)CEC#msf&
zcDZ^k_S4|B6N)D`z`2;#7*-BKGB)CMsF?r8UuMOBQ%;$S5%s2Ag=8MS1b3~8y^%H0
z#P)W03I0lW>|x4Ha>q7bkI;-!Mhut5CdRN?q}f!PXtBv?f!lM*1;yB+pWN`YNT~JZ
z5k2%SMov|wtxRrigd0PT-Pc6kd|HH8yYv8vI-Cx}pYF#4GHM>SF}3J};&CqK#2ac7
z2&tE!1P=`Uc%6dl#<YG=bZZ|83eX-FG%>#Fg&l=|0aUn(Z&X=b4el9rt^B!!ao~Ca
zEedA<00Z~0qEQIdxf5nF;COK+-|L}LvN~)BCwJ`Ji1=C4c839^u6jto{!7>UM^TZ$
zU;`P1l0lMY;F!*M*r@KtzZ19<s1L`{p&E#(0PYb*TR})Y$}D;9U5E)hikcR~FWebh
zE`H`SMjz|sAdiT7IJY-B=Bn<9fpxT)rz$xYy+R?)mY0c|(P?cR<GQt{bPxFjSa<C$
zPkKby_@MbPdvq2qVfs`e3q4Q+A<l{@WMMS3&~6g&Sx-S?*Km_4<PSkL@2x}U)F7CN
zI4g{4jow?Ij$C3oJ{<c1?VqGEwUFv_uq`P^HG~-XW%SgU7j;hY$jtd7+Vf*eoE?P%
zxeaSaYb2Y4WJ&Lts9jqcv6G0C7Gf+AZtv6MQ7<(zo5)iZGMPwhq9(iJMC4kCC>_gw
zwHK1h>X_=yH8n)GUVsVn(@!&(rCE@Ss5$;%Mf_p{d(m%GV>&vQgu?<z){lJKm-Lb=
z7KrGUu`npQdn<gWj*Qo8MqW$1Gb>!Q<=@f;lIliv>yP1H6K$4P7KmEmXF6KpxjIq?
zw5RFjBwFy%<7JbDqUMml6D&Zde-o~Nhf*_aWKu<Q(W%DcyqsaxB;KO1|2yVm`vXnP
zt8&vqQKQi_MVwBI)AE-kCuerEi*PBXq9FRA*4kV3+<AGS*d#)xq7ah{KTU}pqnryH
zXctAQTRr-eT(?MMwXBP3gW59{oo@E~+*?r-JXuV%sGmnc1KEej4~YCnrY#nG>mP$*
zos8#Jtwxk;$Y!FS$o_?7VPj>BC1R*^3@RG-RnXO$rv}cE&o9Awv)JzP!V=L+<j8VM
zu}ys0EZK9ZsA=1lEGH}#Eo}p4%MD9K?V1;{sV)G$5<D{af-uL-F1!2$d1k4I^8A8e
z0noYDP<0GVLM?=CR&?oaIdxJS<)e82XO7y(0H}Ky<KqZ68vRWc2?Vayqn&2a>0d0e
zidmS;gUhLz8sr(pJ4AET;}+ZN;DB8U?}KeSvV~_MSH%~z<tcAUrV`7Twi0DU+-oAj
zns0lUIYhMAH7LVVFqVT23u0??T@Z=*$v(txtfyxb`Q@lJ7GGl}d_5D;Or7H*agQ4i
zrNurIZ5MoGKw&xquQPx|pVI@Wo`yCtB4t9Pzu;pgwz?5%X2DP<8alnugLL=^IHmJo
zLmH~dHvDAIr*!W<MxM9=-s{#DKt+|PQvoD%L>Wp_$w<=NNMcGT%#x%+u_T-E39YU`
z=i8Z*KzzHpMJu>MW`k95QDfk1Fu$8DyIe%JXoO~=p46Tc_V4NA+?nl>)~)pZs6+?h
z5wte;(!FvwK@MLoT(;WX<jmzFtn#DUvW5c)M<tQL9vSkr<uvDvEi!@)fcB%BFcN9|
z9EISfZcIi`-nCc_Ck%0G61O372NHYjPlEWrZ_RcDlWZ;0IrTI6Aozw3Vg$ITW@}?9
z{biZv6>UA?hVPqfUUbc=k4ESSJt#!y{|Hgd5PL|RMdB<Hd+kTy2mG%PyqK(%B}6MD
z#7&TCSIb59DIn1O%Q9$%s9%2Ai^%Mk(A>vOWb_IVn{u+TE)U)LMlm%WI-yB>bT|^U
zy7S>g+_4aEYs6I@V=NK8v4Jt3le<=k_MRV6$E<OUJ$mvtfdSc-Fk>M}JmaDhc^1Fi
zaZ$7z>LTM<4`DFUvydvAm)kN@c@X0oN4Q-lhPi#scYGZfund=>WAF3`H+JUW&U@$1
zMBFor*RRHAb@8-U4`~T8C)QhVy^eRZ@4CY#{nK_ce^3K4A^cp0=(2VBGz|AGauXDW
zx3d`?U_ea<G$0+beR~Gw;rbZmnL7-^W_B1zY=#TiT9AkfvD~tmJ5;qjsn=ywI0q&~
zMF0S@>tB^1Q%(TUGEdSkYHWuZdYr_i)8>~oXuJNz_Ssu-w0a%gy2u_YMeWFqG!48L
z3v9DPt+-n?;YD5Mxhe*Dl=)8iN012h<9;W(1E&-{QyLYQ^`S`QsG^=$pHdTsf}b^}
zA0)zQA$kL0td%^}<r1aZ26@SLSyW9K9r^U&m-{7(O7)PAgTpLcDydOJ(btqL^4ExD
z-ve}ru1q5#UUrDZ^WqSV4hhhxt`w?<h5DE%U)wF6A878S$Bh87Fc=^RH5a8nA876r
zTy?Q%I2i5+gkZHMp%5?b?w^OQ4J3Ig+^DaFLL2M&MGD;~ZL8n{e~Jq9Iqo%pG$SF6
zDy2nn6o9*010iq~?t|`hY(q_)N8$-2{$g-Zme|{NGrV>XJ(1{aqP_N;dUceYF6xf;
zq;*fgzl{%yV$(+siV^J~%@pm0Jg0h42|mXN9n}5LH}c0-qPN&1+pQMi?IpX0%u(pK
zeNTmO0LW9bVW2?$k?dx%q3D>ZrE|^3<qlyRsi;OymaA8b8eO_FwilSp5gc%OAP(oV
zEe+F1fb!Hw#v)q7U3$QlRh2b19LOAHpDe!%6;;D{NCdA9V1ZUAk7`PvekH&@B<xdJ
zZ;c2W_6)x}8h&LS95BINPQsVaw(;s=zNIdCjK|CG6PBZ9!tgJszdJ;au52dA+CDJv
zh=^<*SpzGnE%K!`nA$`_^}tLEM+tDotDYK!+CG{wZ|nMS3&VCbj9EM3bWHIccNgMu
zBFA<Fu!r1hU$3FZxTQJEz5)U4@VOch6tMU!l<wd7$R;c3CB>PzUxjz2eEM`Urr9*p
zWhXzbc^EQLKIzBWk^^a%Y&*Rn0XI0Halpm7%P&Gb+A-=qr`{if{$&w1a=~N;fBQsc
z4g0^U>n-l=h_FD5wK^Qk-H+^><MWV5RXn2mp>IFuY|D^<THQPh(Tc;6Lj4F3a`7Eh
z^8n)k>8bxE%{HVLN|J(d>;F=&GL*eBAUt3S$~mO;+Fzvxz5Sw)lk&((!VaOmp0|(#
zy|_HA;pq|+$DjIZ0jC3o2tDdS+dEl={RYU}&x%^rzt$Dm7*BSUt3x^Jh-~_ti1Yjb
zw=4{fXgJ;YTTlP`Tnj(b%(_&2kh-r!DUzaU|2mpIYDQyJR8+ESV<>Wtir0MeR5M^f
z#eV02CQQd0M2<T+iKD)`MnM}43nL%eGtNcw=jTMtzMrw}>D3Y4!}YF@EZE?H;H`gA
z$er68NRJJ6X>(Hz+U7)dn1x4^vx3^CcyA^j_&G4y8&rn{{GBz<{3QFX70oLaQX6>q
zNVEDxKC@QTY`-+Ogz_r()5_ZbSayg-w-7Klb~4n_4GLG1VyAUG^|JhKt*GCmdCAxx
z^wqHw7`vVoJJO2%scbGqorrJr5fxlD&pdJ)KSzgE2;i~S%slo|dz#BBQZ#NAr<*bh
zS!-c8)RY}-F<pm*s0F^h`alck<OzxOiBzAwieKk+M(Alpi0&&x*NGZU?wl-<*#&*H
zxD`)9TppjNey;<@%&wLr*5RtM*=DX}-d~@HKx?`G3~nNMX&vtCy4hTwTPK=`3-bOt
z9N3*PNj6;%_svzAvK}{?d>bR5S}z)O-4(;emu8B1b~Jqs2vk%jaje3)QqyZ=xnVWP
zxJ4MgaZu|GOczzvv25zOs=`?LGgw!zua9D2zpJigr_`7F_mJH5h^Q{xJTIEqW{#F4
zo)=a7jL`LtD{OopCr?cRWx-{)uU8qgYitR`vPD))wR|6Pn}th{3|X#9A{lnHI$nN=
z;$UOvyh>_5ts1OF<3590^84pSaL8z2RRO_1$3RV~N0kp{g$*L4Y#R+Zr>@E78$?v6
zJ{7<Uoe-8Gvio8Ft}dmKpZy1tnH_34ZD=Ou_FNqoVJ?Y5EuTCjU)TU`HX1E+a7wS~
z%QWB~Y%%{$&yn)f&(>V&tTs2WL~%=v8z$?%AX?X5sAno#5q#Iu1Gl9w4L4XgI@CrU
zzLwKofcf)q9Jpq7LXLAY>Z?kW59gU+)B%#CnvsQZL=5nyO)lu9e(Oakuqoeq?Bddc
za2ItJ-+Xh+GIi*U_ZBm#=1ZFmG2XhaJCs*zL58GWwGB7#Id=2dBAhmW0BoZfUPhgi
z4K|9$0}tX<^XiSFL*T=;u#0G;cr9WR^jT0hA#?xl1%KcIWDJw8#Q>=n{y`Bkv=b+S
zUwBcB3rxjFsh7mss1-GIN!am|y$mCSdMO17Su@aQ3{r&vspl07Q{>5)M8D3Z4PrhK
zZ!%U*9m_Zn${FM+BHtqNpB`Fv^_JGV?)bLIQJc^((?aEvO`=KEF3>{%e^f`597gdn
ziY3J!gXD;neUiw@J>=z0A}%V$AQltx3lVj7EF(oPgB(w!BGT4Frfe2*EiVItv}zDh
zNW}Zyi_`kSAn&19H#ae_l{+_!n5fwX{x0Dms06A<iAYZw<g-N9AhJbw8MXyURWOJo
zBBF`-Hn}({r$I&%$vgIN8G(0;c+`^#0OZ^20=zfj{YykzVvsKp`3R9QKsrAfpcgk6
z-_hT8R?s>4MuWNp=K+^q$Fo(90NbSc4-Ud&%@PZX7-N=k1sufhlDMYV@jM+5aO;lO
z&lE6v8tP7k`f}b@5fNO<h)`G+B8;F2>*WVq#meTF0N}c37<Oc0(@$X=2!KSx*ww7P
z&48ozOQ_=B^QvxFIpt;C*EDFDeCuV=GHQj6>Ns2lERT}q@NUI=dd48P5qXTr&fR2%
zS433HW(F~ah;NA~q}60qnwAFXCh{_o-^+=wh|W=a0DvTa2Lt{O;VVl-`othF5P6@-
zX<g+vuZZxd@dmM(h=w%3V@t%EXpoDDY(!+8t}^OXk=T-nAg$&^bSC0x5(PB%^QJ*o
zB2wRwuw8C_RWzvJ{w)y4{Mp0LYb8H>RgCHpZ73&H2IV-i2`a&+jX|aoIiAR05~=D*
z5n;HQCZ$dpbS&$ylA{|VSe{(?nwTDy4r0jlRwcw)$~fH^$C7K7L9QZl8IesAWyCho
zq|9_6P_B1n|7{|w_QNEDGat8^r(nMfZ`xwv$AjV>xn-N^-)ky3AeGmhV8pj*RF^Kr
zsmw6Q6-4ePvLTQuK0Hw9_7+g`7Pwi-{&_)>F3LyAZm)}W<^3AMyd0OyUKb;x=7R%L
z*<BHgFtH9$eL6E0<3Y<b$QOu&9SJXaXBo0x#C5G|5a<O1vTqRaOG0t1>INA_<V_+^
z0GZ<LMO_ZoI8<`vbEkZMyJ#1+4s?*<j05Dr;zgDcyfzr*2Sg&v@Zlw_eM5}s8~KCo
z>=OvjC;Y2;7!o&dO`{s5%?->~ZmD3H`M60T%p;J5Hz%LBb{FOC2%;j{LX4!@`^f>#
z@C_VB^yrDCX?JMc>39?(q`<Cz)aDVMmbj+AK?2D*Q(br}1AVc*CnM;IZ3*%Z4LLWY
zy{+Z>hn-5G9)vK>J*Fn%lecBID`dG1p>ySEvUhMLIrU8(M$}uO`thMZyd>hi!pB6g
zCJDzJ_Bp|yU$hD|2J?&*?`<qK$D@OJ2Fs=iKDW(U1hOpok*GTl_PVH!OwFDF81nu}
zdE|WrtTZ*S6N=AEE)`C})rui6uebc8HTGrQh00(V$2=YHTyjWvbJ(}!t#Dh78^{tz
z4mN4%G4&?~Nv`E*CAl?xnMDmx$~%~@U@iO_BSO$!SPxDpT)mD2kg@?%22XpIp}J*J
zwZhA8g`QOw)$9(iOk-N(yfSWU@X=X+Om*N^6%>(^w<P+4{-WzL<NE?Q&T-oL5#Tc8
z{tC#zd+}}l;&N*&^02T2^o_<GQw1w;g$F@#E+7L2e~xOSUCXKMle6k_I&D{9^#*0|
zeslCH^V4{~`Z9dj&_n)fzq#5TMa6~&N0fsGw^4(4z*tWr3Y-+}8AR6Sy@KvS!i+0S
z;VD`1ZP6k2dRf#L>qNluZ(%2&)OK>7nokyJd34D|fq(WX3o%afh8JEgc^l_KzL7iL
z79nE4JpQ%_^E^ZrbuG%@XmnxYfnJnV_hKniu1Z5?Oz}1UC-pvDCMhuu_F^L<F6iRn
zjb!iF>D`mP_oy-lDr)D47q#49Ixrw3n2<&m<NzS))%Bwyaf96lehKUu^K#2$1Xgqx
z;FM+1;8gG4!vvscPQ&6t<b*;l>#LEv_TwqWYw83(S>>NX5kScOM#zB>(rZ84SMGQR
zR^wFg$h;Ml@l$Hx{w|q&4>KH;9@5LZ=<saK-j(z_Q%T*gP8YDg=^Z^Ee`LY-8rWql
zwBZ&8pDUz@cq<U7W|!44ZAzx@$I&{Rz45s!?y;gSVAQJKR22A7bROrh>u4y3umBvL
z7_vjecYYT0JoS|uhF~OW^gPUjaBFY~d~6T=Tj{M(Bc1>mVyk>mA~;M3wI%<QytD&;
zg;O}YaEQAc%jh?Pu-@pc%hq9MsUXIfnr8d%RXW$PeU}NL2H}Vv7K!*bKOcr}!0x5^
zgkNqul&Q^(u^30%n-Rt5h%AFxKG&Jm+_{BL>&Ovo$`oqkmxZ3fU2K?RG4!y_?Lyih
zd@Bab^l0RB{8Jhi6qbn8{L8|^U0FIcS7`6zs88#tj`JYbQA@_T{RQGYS0bG>lg{T`
zVv7@c<v$4>W~AjNq5SCLgj^<}$sfoU-V-4nZwa=ljut<3Wii*(|8N~jt}6`J)Y-*c
z-_lVXP5wXe8#9itL^|_LI{k1dH~MCCDfmC7{;j9$7ZC}9P@m0f@yGEiNQyMw5iFo0
z9s5Cn9AF%76GfbQ6^n(dY=p~3{Qu}Sz@vPO^lS;~ehk%G_;^XN7P9^$+#tqz#w7F{
zPO=qA^}3Ggc<g@@5~=~?aF>1&@mvyna8F?M;)J6Alh7X*Snpl+$q>FJ{HU&|Kmb)Y
zplf!3S{qOW16oW_m;u=hXgNU+1G<lI@G4DScfRmwW@HQ)8K_@STHs&FfQB;WX9i?3
z>rT)C1F{*aD(?jbsJB_nXd(|XxDoSLqi<g?0halFbunH-{0Bwmsf--%T7y`LASzPL
zXvW0NQ-g{%v%6%hug@bAPZAVGXpIPDVAUp9>|;8qXG=zU4UxD5F&*;<3_y5p411)9
zW0N#{jxfFD^7@D9zVHS&c4VRPW6Os6r9HHP4kHn*+k*nbtwwkv8xx6m+Lt)fx}RRi
z=$APp*#FeMUlERo5V_(*Q77s4R&ap>6@3Jbb7*_{tBlHU9fuJx99D}y+`+&j4Dh0j
zCh0$LaMo^D<8!_CAuhXrb1!>X$16b?Du03oVBgmHNYoHd$o3zJXt7UD_((JttL3_n
zL|E;<i<mBZGVX{wo?fcZbqW)Drn6Cg_L1n+(hfdg_hKN}HRJSi8z)MZ@f~203y5q^
zq*r#{DVA0q4jOn3iW~@PtNe1OXk57gqx$;rid1y>0jjyIx=Rd?oC6aJcdM?0i+KVp
zM;u2wj^HXNbOR>E-t*pE1ed8ba>FjsJgNdaYVT0=@fivmwK&y#Je#GGqk6XmD)vx%
z7+`}eSO<A)muMv3m0`Pa({8$D%|(Lw=a|qkEhfNfffw2~vXqi8bBB+byqW1deVLnm
zu*n=b=B)@JpTPOje-t!w1fr_8tw@yA9z;08)IG+Dr`#}qJjfFC+QaEt;A(=e-!Xmm
zKpxpGT!H_D1j$RgMXj;3K(-54zy#!P#n6ZG@>r2&h!GJPyrmkz%;w=h3FX3P#EezL
z{6l3iU0Q?KTv&t<L`*G0@F63JFc)b}TWfR4^lVWr_SGFAd8IX~IpuXO#+!{G>Jg$A
zM^j+DvRmX1N+-Zqy9+eT;!>;R;cU^S@-x&h%}1ZB8F@98<@SiCb>C+r;A^z4I5X4u
z0hnZgpVz*$dXVh9M|7!fhcTQ#^}cRnF-gbhH?=nh^6fpMmdAJ(Qn49$Dg<IaAKwZ7
zUq^u-jEj*La3Fz40gPY%bQBRO@rw#GnsB4g?sR0PMDaS{bNF}h7Cukm>@U+HfKn-3
zr4WO~+aprC_hPf#aZJK@X8_1}U{zc*-bd8@+V_wylEdag`->!<Em!RoRmC#-%3cxG
zBV22|dkESQUK(J)=j!%0<n5}JdrY-ziS%)n*13e9LR7JS^L6erO79T)zW{_e2iBT0
z$AtM;H>!fIs#9Ljy++grY|&giNR33F;m%5mRDFr!dRgX}s3K$-kudz)0|%p+O*$(n
zOx0kvQ9IkB`u_C(16HI~4wJ$qHWrhDX2NLI|J*<}=oW5ZH5nUZc+FP#DnatKkKqK*
z(vwE(q|aOgmLDpxwc5|#2ph?<0tCxl7JMwi(|SJ1OtcN>kuAL;*XNq@YKb}0jb=KN
znSf<;+bpfv3C#(^1O_)Mp{b4A6o|9>d_ysLWue@>1=V@RC!(?^@h*5`BP%BL`VfqL
z2D}R_JG|#+)r2q{wjH^S89|SR#$;ZyY=`CsZOq+<G}&)4&95LweyC}OtlvxDMA6xv
zVf)iBCiNmQw@i@uZ4kR<;6711;&q%HDpBpegrmU{L3b)hKS#<g`$WCk+#LrMIG3Gd
zS$k7afl*WTA)v;{`TInp?i*t$DG+S^7uAG^P3zbDd83~;0iN`*T0>8iraC}T&=TAh
zumgc_%0Kpr>YioywD{w!CR-W$QYU>(BWL+(_47?k1#X%2&M7z2&c~8w;qG9H=d)+t
z{*QLwgGb<hwYzC8v<h1)px`mx3}@lf(noi8vriYtDpJT~MuDaS3Xsz-m3Gf8j=~r{
z{x?RPJhLAy?VS91zvwciHRg^~+kDikQBXhYRXB>Q*H&Gx&;ftZSXZjC0Qma!W{LG`
zf-}0?4{Ke`X$a!_hM3*;8-}_)AlU=Jm-Kbz$^)XBt<6UH>H!fq@;oP?S(A#ZnhU-Y
zto9W36c>!C8K%T@RPQO(0h35yx4`^JOdhgFfoZ-SUr0CZb#OugA9!`yl*^t#q>^0@
zipI98x8>x6qDE3Qk^}2Jt|wV_doo-z?2{g(H1gTP!adYt{vus#_1y=N;0o@X_Z^le
z4~p88PQzjJFUg%?^gm+X_hY8D0pd-&WyCwa9QXV$M}xNWrUq6pKA_wbtrQy5i<b)9
zkUmD9_%|O1<DFSQ%if1X6;E%ZXeCf2{7QI#iX~r!#C*fc<iD<4(*-qpg)Wwi$w-Z^
zF4|CK%<^G+pRq9^={=zb-xO?DvtOr!3WsIW${>YPRy{*4vNwB>f`<qG^mrbMbg1ge
zk@)qs!8Ry7b{kVCV;7F8apSJOhAdb844q|Dk)Y+EdtU2Mq0e(J`io#>el9ZKopk{0
zwq&7lc^wlW3a7QfT1~v1C84l)CAZh}zlu3XE-)9Pb~nVAUL>?P$F%Z4TABdoSh1Ey
ztU>eqCLgm5q-wuU{}}{<UZDOmbbHvpH!!+84p9{_Lu>lnr6SOHPya19d@3Tl-hj^u
z=@oO$UyXvUn!OcV(E~cS1nSy8qoL7M>@uXOZOW-Mfs1@Fvch3p8PWG;<{$SSQJpj&
zQrH!tMze+iKE4RfUJ~$4F!~8kD}vWH@Jbea`yzOdfxpbb3G`t_@GH!^&-Ei$n!Gt4
zRi+5>nL(U32z9NICD2|2|3LfgbJWEm_{#?Vsg;5KMR04LdJ9@$!rKfyV>S|<Wbt^`
zf{o@(Y_yf&d<#h9v#$l4WWnM93wy;d9B9E{0lM0JX<&&KjNXvBR>DyRmfit{8Ui2J
zZupmqdKW#w!F_a0{3$m_+Ny^AhB1jf%P{sQG_tW8i(~qH?i0Oj`5^h{5z#uZkxj_R
zqu8;w4D$sZ(A#fx@QvWHnq#QP@DUaEk9TJ+iZ}*T(LH9Ne?v^4qaA*-#{#bQhvW2r
z9wtVR;Udnt;UT5;mUt#PVr-UBg+L-7%g7Wr53zP*3pALgW|b=J?}k5CetT2|kH`TX
z<D~eS=`~4}ts|O1O6=8{iK*UF$=+&+oYM4gYT#ithGLr?1kHVJp449oCktvh+YGBS
zA62&6`Lva?_c2kg;&!Mp)t7|&@5&1ha{e(9CHl&DkBQL0-%4Z65i}vW82%FWIw5EY
zr6hs6+;P#|^DZYY#mXv$lL1Cq7>=ndud52(iI_2^6|SM$=s@J<({X=lwe`bK_A6A|
zxAicb^18dk_A|<GGzBKb*997I%*AIy_H>HiOhQT6r*M+&b;o<<N5@6|z#mHm$*+!!
zn)P$oFQQ(ShSgor4ul_p5M`0Vfe6Jh<#$>A1a6k|u8<F%5M4ZLu|240T<pptiQ3!i
zbG^5|Xk3g7WB%;N0m!Ds$&qdcV5<CH-GubWm}$s4GFCA3>q&prqMxr}NdsY=-9k+{
z<wrlZY&48BF<jm`A)0xHVM$2$c168E9S$tEf1719bT^ADC@~)~;~1akf^;i4Ahp|8
zYFFz*kN=nsVxw-8xyrRr51n+}K1N!UlFrEi(82=ERbw!%)hsa^oEh!w0q27KIF^+x
zA&TVs4bxW+sb|b^@dJjud_Q<ucT?o51DRw96L^0{ZK!`T3Pzk1HR^4D5jli<UPU1T
zX<akqbLHv|CJ#3_#h%2Z=6jSMWX#cCQN1OJ*MTWrtUlL%stNiJTR^Jj8%c$!uJ`lA
z<+oIMWHH5?k%rWh78Ry9vaUAzd%n(j2=cQ4(OD7N@22s^97Gj7ZjqhRWJ&3I+S=aN
z3$Fy(w_Gvw4~*sGn6>|JsqDnyhW&G}_tARu)XQ~b%~PUgL>glMM|&BFUqX8mvgE*1
zBDCx?dbX3R-k0-EiMHK`PB0a#2^!_%wYnbehP?Atg;1@W^?>>M;MEbw6l6%v(@<`H
zMYo1kV8`uM*bs{=&hcX2Kc{flb~IMh=+1qRjrq3!FB_AWvE*{qcFYy^4aoV&Sg@Ut
zbOE&I+Wvwm!TRuT!N3pA?g|XbYQj3ev4aPdMV+XP`mnUPKH&1t1tWECGG>CsT+mQO
zm*)ZIb7hzyEibw<)p3BasVW7i$1KW^3@8SmP8Mh@(zh%f96>v#-mfjo=ZOeU^I!ip
ztC(l`MfgxPO&iQArYtRLHb<FUoRQ)SloNzPmZqr2Cb>6}T($wLYX3>DA+m_|1l=d|
ziq%6%09yFn!^*;&icHJ+Yzeb{11mpJ>0h-lg+J@-ZYyYr+Kd`t0ud^kBIqtVJ)C(t
zp$S_b=g2_w3JlSRA_BOXXncVS=afV6UBsg`wyi!go(e7XbfIj1TD;eCkS@fFZZtnW
zb@(%i-j_B2#S;Ya)To-2{r~9t68M;p_y6pNC5~iWOAtiFeTBFpLPElZgrJD~s?a)1
zRw=qPNt@WNR;xx^Ej_-ytG7zDj=DlfsJp7Pddx~&T18YV|Mz?5v&r)7-|PEr_A|%x
zJoC&m&ph+YGc)#@>@g_GFG5A|F<iH{0m-({lLy>M&-6y7XWpu|7&cj<T!m!iHtX$F
z-w*LSfj6d<Af(W~Rp`!4CqvYT&#0N6*)PUf1?SBS=U)g(<n8m;@G>%HpW1-rI}o_9
zMcv>kKO;3TifXLeg<eODRG}Orwj8tcwuB1rF-yN`>l$Km((%LC{=~D%?THCiCIn_a
zgp3?pfHEL5@lNlIXsYHZ_(pT5swSS1!_{ZKiL4KP3|7fUI6)!erXXCb{@T)}?Fg&~
z<5nN=awpM&g-CyX_gWsYz?QWNNu1|t%+9_n&V7v+mPTC`x9~Tt9|SJ`BMZ6{eT?mk
zFpHe?uae-VDBbq5=zbirS=P&9>T%S%;uWsrmUZ=BqJPGdBFVDcMEtQ1x+7Yju%xzp
zex0%`agWYLnMk@-d|(Db<o4j5g2ame`i>MEPvEVW94Ypn!1??6Qd~KKR|fh^QSYRs
zb?CoJ`!epymUWV?@z}q@WJ5+R6k|@}n&urS;XBJq&pE@rklQn)9A7*tEifyEAvxK7
zF$$YeKV~$?8C4?*;c|EE+?K<kVfrMsaZ;%cbYP|Q+)4?nXE=B)=o^&bWjTZH#5l(=
z;UE&C4mL}V&rKe5rz8<9xCl8mgVNCARv;|u+_Uiq>UI?neGu{8Gn(=>4L}>F41mXV
zGrQtfbKxL2w<E=HLndC7Q^dqmmS$bzNS9}*fw~^n_0$}T*LfVa{>R{OyqMP!&5h4I
ztkeO#x7ON!i}z8@_{$}VPGM*7Gl&-iaU2Elpn_i5r?S&7z4&e0T2OWn9=?OlCZ6F@
zB{A|XB=#|!Hur$aEdv6|%J8^w<to^LMBVO6Okr9Ul)RhY6-aT*L?r)M^RZ_Hjt9-Y
zrBs#dH-c?QNsBrMyG^8@w$yQ@)>n<SWo=?n%qcz5SlkeY7PnP275Ax>QD5#;zu}3%
zt~P!`d7Uo_l2MANjH-RC8R&=-s-8A86p95nn)~)o<R=UetH7_stlu2A#53~QH&B3n
zd0NfA>g9C;-emvT;*(M_{EEdshS$4bC}b?)Fgx7}{hgke^<xGmO8Z&NI3-P){&3y$
zF4&92d%A!@B)#(5vt^uoDf^}3;WL(|9oj2J2pQMwwE{T_2&g{;*@)rzC_iwPAa<Xz
zbf~+BT*iJu8bPH2)Vy2k&*B_fms=wCtYwm`IhLM@o`)(^|9d(vdQx%ReJs)TIb?>H
zSaMR3Wy^h&9oOYBO>J49kvvaq+d1SG{35l1r~Q5%MS#5t6<b><Z$RKdtSw9LJI01*
z>*DX|;u$VyMcG1KHe(vVRx-<Fn&pO86not)7K6szj|HDv(x|nJ&y4VNe9v7e0F8jk
zsc1tVw80B^GREXT39H}J_lk7$bX<k93B6ud%b1Kr0OcwYRnha#h6uyxpjcqS#`Ji7
znK<%|rAg?iWoVk)8iiFFN~=S?@w^k;V?T3QR5@qq&|zyhOQ>0<x;k?0P2i9vM^W(v
z7DD<cFdhZGEGC_^tg^?hCVQ-X{jvs2@z*&-2L7yoA+Sj9qHSmfMOQ(4d;ovERsrzp
zFJkDomVWgF)7(KT@dwcu*FapXSG@AAWpT7Mmq~^4CqRRMI^kop{(<!anT8buzA{za
z;f{Fsh+1WbC|KcOM_ZA4-Vzd+wiJ>bn%71wIB%(s>#m<TZ*f---l}14v3(x;9lUBy
z|GJ6<6<&v@y!f7sX9#pOuYtlg-%n!b1xqU<qp1o|5$+2XTkvXB@D<qlqj>9rrHQ4V
z*nhz?G_)47Oh&VM!yloh5G2E%4-?0tEDd^Lhon$$YfA0_g?t7UpN~(NL(3hvXxb+*
ziG65xUJ|a0mX7t7FwGq_Rawh5Zv(~4m&C4%mcho~O+?M_ErVU@)v4yy=98Le-@%m5
zAaiBL2YLoo^X79<K-u&`NldqcFx@&xR0n)xy6vcVenvJ?pXJkSeU*&eeKp;#gKp4d
zFU2h&#j+Qg;obuu=m>oLSdE#*4o_;CO#59aVwg_FvK|U4YqW&JVjkJ<KEkUsp(rjO
zRCt0);RzT<P!j^Yz!ySA>mMxfuKNJgzg-(>Ug6%`igt0kkL_xQl4iSxuw9Kvjwh%w
z;^PRghWadTS7nv#Yu95Ow@Pf6Dw1g-;;j1WfIz}7mc@bM$`6)C_Qo(^(GQjR2N9Q3
z&=GOpi>8+>;Vt%pFud*29t~=)x+$6AR;T@%gmBtRmVq;8-UkyFG_S;3cF<W6XRcQ>
zR}%IvP##njZN?d2B;;ceiB(>)T!l3G?W-UY#p%htPZwuP&ts&a{DUkHcY!KDT-5r}
zQolz1Wn8Bs&=61TcKOlL*)`!;Xr(GZpINBfxO$%Obboynv=W}D*@Yl8OdY0f?YfXE
zsYuR)jC!$nz>Ok+UveMtPv5KhQI^aio9#KL)n~%$i#b^ln*m>btuwZtQ5kWougYDs
z%3LfP{kTe6eMWwOGMM-p<|7mV9JSsA6>RNzw8)FAFazST^T;kZ67N1GpL<X>KcgCF
z0B;+bk9c3_l&0f;jV@86<ANj#1!RiCV9Wl4U_AC}-<{OOdx)7o;dY>4U0ep6#Xi=>
z%5-bw&6%Xnmi?kmUTIdoI7{sK$<lsE6gcjP+3oBIxjsNs(&MOZ^3{FZja#J38TtMK
zxUZJg@;-ugI@H<~5LcqEEt@UOYb(0_j0MpB00ICAxyg4ajdBkd2f%o_P*;b+Nm*0W
z#xshxY&(AN`P3l%MMM8I+45()Zov(0kX<s9&zZ>#$u$@LIF%3yE|@-H7}%xq5WZp7
zK)pKqK<;eWn>CcaCo~h+i>kli@Xc<_UZlFBT{toQC<M<lyNYTeCs>Nnl7|TIqP+MV
z{>HRy=&cm6Xeq|%Rf(0&d`_pHpdazu+y{=vsN`ZYIeKP@6DRUrIMs}sB7=6TBB!Mj
zHA)UUD!Z*yU`+pF>6N^rk~UcfLb>(!iFP%R0*O(6bL_68GKpp1XztR8$i*Iz-X*&a
zO{54e5-TO{nw>5!p_W+wjz|tcRXX4zO=$OY&cAd-p|%g1!jIvEgMPnoaQTVD*K@^H
ziTS0<3K8P9bZWU61@aIvg9#X9aXx2p5;g@uy*PCgkk?Mk_F58#oII|1|I>6ebgIjZ
z@2F9MbE6)6ftgvLGZSRV`zmv3Z-`XXay^3rF739xKa0P;mL}8Ro&(>Y`%cNyayfW{
z1}B`s8W;pXPQ4!~?otSvvvt-vXA1~}lPe_eQB6!d@L~BBX<?h&c;EO(0Vp(cTZl(4
zTUuD26)#`53~@Q+$rsDYb}0FWE~A&&u~e(RBKb8Qm4Y6ajD&d47+fwAwC-!j#sHY-
z^7mxj7CKex>l(ByH|Z)Jkb>efP&~gkfJ+<dnA@ork@4$gcqOr&S|?2YJ_Rk#ETSj^
z)W##?krMPp=uhI+5-hK7Q_BEuPt0}kp2d~GnkMEgi`KeOr+~Hh7?99+BIf})%zwgZ
zh7l`YfUAU_6|~`(M^xDjEIX8C`=hM)GIX!10DZO!TmvUFdgNow0<QJM;YtB68ae2q
zHt3?cKPvyzAt=9iw;8TM*OL2=_cara>NMF4kW_So^8q<0Rhbj0L)fjLlUn=WHPP@6
zmIJE=VBR!<%B!a-7<m}2@D;yuNujSO{=);1a5~<+Er}jS&Of3^;c>HF^3+i_?5g%&
z+p?}ed8a2v_swX@M{vTOIH6l4U%qn(tGm%yffixe86e;I8{gQTa;jatt3hNuFUx}R
z{t)$nAXnMi1@abZs`L#y-Ko-x<o9NJ_J^PfUdD%1<Rw8kgH@Y2mXv#wCPFio_S8&-
z62?)~T2w~Lj^N?l7z!)I#8r&`TFC<I{{?lR`ZE4vkqf2Z3+;jD0dc*ui=k)7gD3z9
zRWjA&bx)x=Ru+O!aX(vEKvU#cO>kX>i6eUQF`xyKhQ5ZlxL<^pygiiUX=cDb&$@Cd
z5S7!v(smd9D?m5s??mzuK?qmNKbrgw|3C5<Sv2`IH2Drt!ZzMR|CY*{{-3#v3=;|V
zMqSVkz5ExO)c{<?mSHyBqI&IxooO`4I`fiPaRr<4wrtF>m<b+k!%17M-Ej!@V7Vru
zm_PD8M!Wk&yc>~c)OqtT>&APQN7$6f0V$ZuVFxBn^fBpW%_C<DXri=Kx<mPwGx*K8
zZN#cWCLx(k<qMEmbk2BK7QQT`J8~1_r0W5(_IFF&X{~DL_9S}-;>jfh;rSJmDX5Qc
z8NUrUK?R)xp!vZcD&ZoeT}*-!i_K#|li9kP1wiE=pt0tnT7LIfhDq1EnN{2=QXcC=
zEd*Z%>PN?8;X(iQd-v8IpzAh>L|w%b%*CUz$mQW~>w)jd<WSde)KV<2P#r&CP&`#k
z_wn@<^tu|p#IM3I{z01n=K*v;+0)$FNzPp%y}W>u?0yx)Q*pz5;O1xayS9>@(Pmpu
zA3#sKD$p*_XjMOY1{mm448Q_85tu#8s(C$x?6Hrau7*4hg^2nM!96smJVBv{A;Ld^
z7`guzwQG@l9Mz)^CU_odV=`;#m3Y0MoCf?37bcx@&-j(^w9<kajfeRSfmSm0EoQKi
zA?fka!;Fmj@L&y70bXAbfv4tx<d|E|?k318Y?5*@XeInI0Nw-aDFD;a9}aM@W9y3;
zIUaSqt1NX2MhI=3je`+X(wd!ZD)TYliP%3Z4P)XsmzJAK$uZwMalxkb(ft~$pZ2c{
z#QsgFdcRovhs9nu0YzyilsEa@c_m+Aob}1B%IqiKYY8_Y+?;S^qjBQ*Kk)R|mS#pR
z(P@h%ShV@m(xmntXf4m^(ct^qLzuuW-V~$%#54DAmVz_TqP*M|3_*7l%FMZhyUW=R
zPAz9M?9e#7W3}V`mJVuMsgZKj<ESjh%@N!Fw6wH0Q^XXaye(Vb7iLZUPW<_&rFT!q
zKm})M@4RfqA9aL2G1YWq`1sWqaKR0qH$G~bn10RDqT%CUAI9^GP$3wWM={hn&gK03
z#inbP(8%s!yI(q%j_`MPmc4bY+iL!<sMX?rQF6`FG9)sY6v1=E3rf&buN8mg@3Tdl
zzbwsM9TRoCaUeJ4Xqo+E5C#-+YT`RU#?;gWmR8TpLW8_Jp^d0xJfkjR{@^1H@^XT1
zvMuj%lu(wT_azi#&!F6yGW&8uRi|S{;kmYX>MQY#BRa8E?Eec-9rrsfF8yU`7xaNz
z95PDG9(Y_dx{fD3o(~l9*DZC8KHrGlPNQD;cCc@@)gUF`lD~|w?8jPqvKtESg>u&M
z1f`&7^Cil_k0Ul+x6}`bIfo2{&B2w=gF2%M@EBm3z2iA?<hrHbfUL8yomG^XuU8gN
zX1mOYxc7lX)kAzp^)mZ@?ENR_&W%ITMKjFylW)YZ8<wTUKMCT{4NIe>njb4VuI~dK
zy!t@)yGF4)=fsY&wKL`16Lf}|xQsDChBH%L5f74A;;J?V0g(S^cZiNRE$v#LtcvEs
z)zA6-Csaf2#jK6{L$Rg*Cu(DKtehksy$Pi`dKVgV1WDFkvD%~XsX^sF={};YSgkis
zOk|siWUVSbFXK2M;R6AG!kl9S0;ATX+y!eh>Ks>OWt!(<=%5dv=QP!vq!^hEUNGZ@
zrIq4v$FFLvdKRll&Qj#1U=lFTCXZnPf>EJdv3o%8eJy(K<5V)<I}&3{apT2fq>nQY
zAcx2d{k5bvNuH@cY&pLvK|4vJ$KOTtAGAn2DdWO=1S`Wl7f1w8$P7f8HQK31;1Typ
zKaRXL0kc@K0vWWyg<AQKq83J~oY|SY3d&+yeVxX=9_YVRIRtsI7iiJoJ59PPvFsUs
zOreg*+C#$*@l;tK;|HA7wyd}DgETL|tgji(HECba3=(m9Et&251a=2VeP{<bT^i4M
z+?Kr_X(`b&!;~DH-lOCo4uA4DQVv#Mg*oS$8G`WZ=*khQ%yC^Nlx1FGnRJv%(vio<
z9|q)se^4wzC8DQ6lL|@R!3<YNU(OvU$s~7TU{Z8qfGzu!>T5(<jfYsMs=0fZgngO$
zpa;D(hy6(9__QjT0Pj5!Ah-$HUqoy}s`4urI`}x{Y56oBs)Sh2b+S5~Wrgy)n|I1w
z{81m&s$ISb8I98M;-re)Ospul6$MLh0IpE}dc{}LX=h2C_(AF^q(&XY*`5J+Fx`89
z00$iIbtVaTD+wfAmbHQ3djeUi-U!~+1d3fCd4ifA{)6NTkZ+LuMMgQv9YF~(zJxBN
z1<8J()#dF@oF4nAd73%HO|E8Nx{En~D(&o#$z^iKsZounK(*(FMs@plUz7cq)2^c2
zizug=bF93iKXbMtwSqY&>(do*ENEuxIs@?lX!Rubps@7JUK5<@?BA^N99uTe#Q1V;
z*{f8W3gxs4$R!IZ`dl+y_4#I{6N+T7-$mFzmIe)`FDmEciR&P{EfH1!T@3vPN0zQ)
zm@7gD-bn!^CZ#W+90U+NU-!Av6t*0mr^i(w5whJ_m9hlxE8HAsexPEZd>yb@gh$k{
zwi~rgSIxrJ_vj`ZQl}<5(ArFWlK>UOxp&uVs_Qus$N_Yz$V`v!Gr*QL$VWjelQR1Z
zn4rCNME$})BJy8s<v|TA_qqIL3^hkh%m}!jG+}iyX@d0=CTIM`Y4%5VDVDjTk}+nm
z0)^lf%24QH?PjlI{z{X9{N>w>x(yuyr<N`I!CShdLs`QU@Fg!$Cyuz)Lcvyd93PRT
zFcT{@&>EP<P%~K*MajQ78yUN)62reZZ%8|6^-h68RqFxhL~kF!%zI1`W^Dmi097lk
zn!9J2Ak@?DCwP%TyR{Un(Y#fthO(@3Px<qsedVXRh>aynUPis$thbWrxB&TYWUsI?
zCb0nT2TF?<$m42Vg@<n(Xv2PdaFbA-aLr>5gzO{yRog@k_eQ-tmAQ8T10~}{wKB`#
zs2P1pb_$lO2=1o4%Hg&+V&Vfc`g?{nf_a;`4U+3`vz{ncwu<YkQK*RP#XXA*IV}#{
z3u9$ZlN(>40&GoA<@wmy%O9gHGuh=bDFP-Sh+Yz+3Y=wuG_ydh@&eVskYMl}Z|&jS
z13d)hz5!#XCccF_<6LH?Z}IXlp~7s7`Z^h)Jt?Ir?zj;7B6^1O$^HGx%5DsDSg0~5
zmU81L4B(EJ49?3WV2^dw=W4d(jK)Rn&qcbk{eo9c!}HI|I~a&p(wtzs%lUw-wx6(#
zpSZdxaW&3*9+sZ#@bZA0re*a57E0w7{mFlxJ7OfbuFB`T`}}C0*xc=kUpVLNv41wz
z=T7S<l?FbHg#71JQ;X#%NRz=?zzVa0I|+~L;_POdF29lGH<;x!RhoJuC=CYHMW}m*
zCRLWxlgwiYZ(EF-uGfx0^57M!h~UHu1v7KWXYhR%Q{+$k84*iIk`=fZ@Ae%8MOX4p
z!yJN6Sw9_!UpEn7{{<s4Nlh+JV79+9lU)f{2~2$W*w~5bEdMUcyWor1hYH~QA#lFz
z>6IWQ{tF0G0LoTNT>V!<&WtqLjP^$8D8l(ViNW4ia~RZTe?Lzreu+e6Cajh@iK(&~
z)&(#+l4ADS9(NKA53*$QvVAN$e#VBaxf~AkxE%GoV^Kl{RTN2HjY8+6_UvJ)`*Uv=
zrr5&cgfWs0!ek1RGp51i=;tL5Q*%vW3w#bLms<UnJE;BwEb!k0LiKa=r+;R13uSv$
zN_H`T+228hE8*qB5|)5euRfBv8uQ9&`RQ$vQ4A+kUuZG!DYV3-_#1GQQI?+WeLe*u
zNO2^1d9)B~&@Xv5!sqi=L8x%@vP78tbU1_BZC(%V*bhi)|Br@n`xB_dm|tv}ucBgt
zXMSBQt+KP&;<-JwiN@xeh^GNDS>+jtP^<#EGa3|P1%kjZrA~0?TpO4k=)@jog)XRI
zQsX1DU7-t7b~kB_LE3gYD{;jxiFs@ZG$mHW!D=|a9Rpo+mgKFTn`)xckE6?c*b+1&
zxk+aR%kNZDQ6QtxVF{}tFsdhyg0J%azd^4jrRi1hbQFNnipyPvs#wLWFsrXh5>qN0
zp|1H@VM8Y$;%F$oYdnmF({{U33sHHn03n~&{wNG~Qir2c)?uZj1`%v%=uwmX;i!h;
z<H%fbHGp9p&{Nx$pdpL{i)?ur8bVD)Xiwr<aT`R45Ua5<<t_S|P(12u+&n==kVsbc
z@(gVZO?HU`L<xY$Ium$F0>7!&%24s{CEy=Jg{6woxPLPET|OKJRP(BJ5C+x;0CN`}
zNW2R6m&vU^Q6wqU8P(GhqVYf~*5{D4Lb)wfOsZnkuRcdtkjsA(k5)0-gwI18a}uvn
z7glz7CgWl6a~XUuEZi*D^(RqK#b{}?P8C<G7#)oG1ENV)W8kp!SlD19S-2JW(LnAq
z+!?17qYlN){$A<EI^!{(b}5z@%3CT82Orh3u%Mq0V{<Ksw#J$M;^V4D>$<Z)<eJvc
z_hK9nyX;1N7dI#9EN%x0QD$;J>f+@jNJ=Cyw}(cRZwye1t6~0eWI=oV4pqvQj{sKh
z|1f}9Sna>br?f{QqdP{s+N(vkT=+nD3%g+%*2ccsojZ*k)M$JVM0nFoKz!yQz<pdM
zYEZUpF7#3LqkZE2K%=S4i(zhp@O5@NFkr*V?CJpE0B8ld6#C3FAkeE$hUg}Bc^OUm
zqQBbu!|06G6MYMSfSmeZe1YXRkyPxoZ2=_P)|5Z(wymSCC3pt(DhbBtHGKUUzpaOu
zT+OhzT7p`+xYr!9Ms3`MnxZh7j+*L5Zivfq=|~VSR5RLid2GvF%^-6cpn3(uAXHQP
zH{`CIA1|&|GhD+it0kY`07xRqz4DrnNqGMX8jK0(JL~7~YYe_N^~28h-9w<uV6nTp
z(JFiu_@90t5q2qkEn3QX;^F#4c65RK<Dy8eVT81&%(tia{4!|EN&Jf<4cT4>*)CHT
zMtrO)6w58DLZq=_h<LPy(WuUHRsKeKAk~w9h<9ojamK>0#IH4sF{A!%t7QHeY|Hp$
zzUgQ`ng8FnO6I#FE&m-QCxx=%d8Q@CLFVB&4@w_VDL_X;md0{GJ00RmKcl|bQq!pJ
z>h_gylGo7#D&QS)3|a3|RH&a|o0p$Zz~v{LY~(<!PrZ+0HJ?wJELn^$8owJ9`s*J*
z_NxtW>spL7N)Dj60(8|GF4X)OH5DSbSu0R&9;D^7E3km!zhO{wil<o$*=(54IB1Nx
z_s1~3P}T+?ytkofeJ7ygFxZ|{O5K5C7*P1eok_y$?-1+QU6e*YwC#Y_yM=H#*oZNZ
za6C=2K{B-VKr{kSwaEafRb~g+%IW0}YN!W;i{#E&VGD)|TlcQ$5o~ladZmf<V59x;
z@o-Ub9DpMn3i0aMKeO?e0S}QWVKN$;z9iPRHSq=p(sc}^zbMIQN9aA(w?&I7Hltp<
zzo8NG>H@ttOUZyDYd5wdxT<-kB56yk2(uZT>bwj;kUtqFoI1+^$GZk_;%z&>O7=8K
zct?{jM=SE%)VQbKf0OS`5Y=iKtz1?NWHt!O*Sgei$k7aW1@0XPf&rVI1KY0$+;FUV
z?J&IZVnIkref9oSNzJ?%ep&Ol6HImFwoU?wyERcNtA2y#s$LjfBtyXhuo{S7c$0%h
zZ@wJ@2oBz+XK9<+p8#pxzr?cm@M}tDoYi-hVL9b}0|mL++0hxsO-;@Qbq0#cwb8L9
ziK2aNqhs9@@0r4@8;Ur#FU9QIMw8C7Fg3(~iDrQ4ov&yiE&ve}m^QR3uwO;-oJC3|
zCyLK&8?CxNfdWbz9O#{1YJ{Mnx3F@mV34}d1??_?)L-f^Y;}w##-}l&Qyn8L<{1E1
z5sKuHQg&|ZYSi|zsRD|87<yjQM~cq&61jDZ)Udjz6-$<Ld~(-gm)!k|X3268GGn{A
z1$4nLW9$$-Rr8_kYT0LOix<7?8lgs&?INu%6xiN;@dCaF-+5b?rQUt@^}F?MBP?<5
z*1I*~@bhBFmj+mva>wJ%`Q%(@n0#=+`g(>v=)!%ZtN><-Jabxv*E7Ov9YsshXCLiT
zq5{~y>M!oAhk5;Zq}o0o^$&uC)7u{_vB{kNVog0G%y=|Od|1zDSnpY`51_EhQp0HE
zK&y?F;(R@0;Fu=OiNDFmkWKWEvNQUoP<+f+Q}-QLI(G!p@_VY)OreZE!8G3+mg^$a
z{ZpQxEm-Yn-CL`>c*Jf*)&2ZccBY@b(J4>c8;$yDdt)>gNxb$T-vQVq<GF$#%!Ns2
zsb#Uh^)L~Te7$fMt8sR+sY;j}CJUe|y}we}ai!5n^6iLx8up{opO_S=KhF$hdZFwy
z8;$bzWotZ50?|(>%t?7F%A@+<N^*}-op4ad!3vBMhZyXg|ED4M)JeEN1ls3_Y=eVu
z;GVO($5BnWE*LAQa)Nt^UG<H|u0K$rq$<SXX#h9lYB4|S$zskccZ<r8uwd_M+-WFX
zWdwLLFv#TV*ilEj5ET=9dmvUgJ0d_PLAkAOqbhh~yQ}(!SUVf$s+?3-<UHr)HIXQK
zWviIqz-Zn%;*D~4>S5%u?%qsI<>Pk@V7g69Dk@g&Y+$rE`VSPpHZWqlZ35}Dzv`3F
zeph;8_Q9m-yTInjU~`gfSOM!(k#B+xiwOW5ez?Xje%mxLF~n#Pxg6>W9F2cXb2KSR
zEAW~S2G5WgUS;m-6W`=;yD0H`h|zcQ&!Ei27ri_pStI-(gwr44Pgt}QAz5PL1cRu0
zG3^wX>LN^j1qD(v6EtK~xPZjdRm3+m>KUgK#F&Og^S0A9TPbU3MmnJ0#n!RZY^b)o
zi+H7>(Q|a@FzVJ)8S*upmcQv!HO>aKj(80FjwyV9AL9~&8(_bxlw$0q`xX^Av4+w(
znqWU_mOgw;bZUfw{Bt#t+Q=B(`e$riP}1NJw+@5}>`7Sxnn<Car>0A9vAdDct<KFN
zj8lDlg}PbBd@rgtHafeuB3*mjwFmtTe&^1?v6}B;!l`pR%g`;JF^@VtL2dC%wm}KK
zU&VlT`DLJzciuFoeEAO@MRv>{Lc@D33Oc-^8PHKhaxInzA6iOAf#AL{OY@cmv@iDy
z`qA8)3uhFcj^cc9-dcx+my3&yjYh_eUgDp|#<1|W*-@UL-uRQhl`ZOagml@DV1To-
zr&!DlHJaL{s^psbWXQ@3;)PHnG`R;7d6>st=ocd*S1RV?z%y(r`t+$EYN90l`miZW
zeJ8D`J-I8In^-Dm^%j_iTC{8(Mw+ogqDzEYOs@S#FTUI2LmBKB&x*lKjK*ynpHblH
z4_x=4YDCKi&<I9l;Nb=OXK@OqP%imKtZ8C2bbSOz11C&7x2bCZcclCQiaM_`8eNi+
z<Q^I#!%?f;*%JR9KA_kk8G)W9)x3-_QKkMVWTOX$n5|Zeb8LqsqQg}Fx5x)g4TqDa
zdMdOC+a)e9qfZsuIYiqCXra5hJ&#gU=W0ZlbK;9I67QbZJkW;T+H}rhXbsjqvx+@J
zQ}RcEf`8W8SwRox?BlkM0gQOh(0ZmEC(eW^ZXRQcC$N40>ggg9)S{ouHyOkDT?U=g
zX8_kDu~-Y3T%emIQXP}^e!|MfuBfgrfJ;LT<`@FAe>fy+HZwxz)J)~LRf4<%L$?G6
z;R@v^hcG4*qB92Ean{A(9?l@9zQj}>K*O*ys|;opL@z4wKr(LayvE*By<y9mhWR}y
zHx%caK~Hd)c)FP}F}&;`DS*Gr+$_DqZ@-&+YJ4kfVMdESjWCpw+&w7TAD{@vEVpVx
zaL8>!Mjdq9cS=hr19%wZILRH%2Q4s@#UHyP){d~$6~j7Ptm5%74ElbUVF@S(JWEuY
zdKt|eo-`Fm(pb?$IOXT5!uFBGA{l@zNJ>}*tp%jD&j4KNeV+_I$5Kk}I`hN;Ty8Kh
z|F1^c5p_RUva=dGAOBW*>CH}ZkB*GrmWp4r3P0KlNSOz)j+~u}T`_LcLAOG`;F@xe
zbtg2uJOzoTI%8L1&V>k<1maun;7CBq=mN2!xzVY*(vkRXS|E-#H|hsX+QOC>Vnr(l
zoD<iY8!cQD5Uzw7q86uzKwctxU;HTFMWXt_RJ=2qL`&&!Tpo(?tsM0Mj{}e=D0(AC
z?s<;fr~|+ZPZ@{xyGTW5C^NrfW_@HLxG;Ba0sg;BiVzA#Km5K3cQ0>ybmXqUGnChn
zaz+j$B%kYa25fakcVfI`y$oxbws=bvP+@$B{j?Xu_~xKLS)eisfQ<NL3iG{%-lYD<
z)B*?cC^X7dC<i}7a-8@$gF8XCbAG_Tl_<0n`&~F<2O89|2S=W-*AhGnsybrM#@iD1
zdxL1?o3RQ5s1`gy5ig?Ue5^+{-A|Hmzq^XS*qam$!v`m;aN(tG9bT+Rh;W6;hf9gS
z2&V0Gz(f!0N+>7j%mVq|N%kk$gM;=;p`}&hli|n=Y7SdH{}B)h5tCOd5kycB)65O~
zWNz3eN_i4lio=O#Qn)K0$?9ZhYy3!ZyKt-nCLnYM;vY~){(vv8YR`fX@jKYyc(tJ=
zU#id8EoQxqtfc6aFlQrh`4M{WaM|<=K-~fvvLl8|)IsEj_~+MUegyM_eEE?S7MJx^
z<N&}muui`z{2SySudIbZXO2S`;$aK+7$~+8ug*wh#-|FB%KD2++MT!yAABUSKqh0B
z;T(k<I&)Kwa`;Y)1dqVPW-0DOz*ezC1=6*VZeLyu>UP3ROT>fbgp;D?vR$Z`;!bin
zaM1xm0x(9@;s+fFn91(lAO_*ECzu>28(*i{<_wH?U+|`Da_~HO3NHP`$x@ccEGTmy
z1!;X%bVbTh`4c937s=02#}Z&~G(s3w^4qjG7>1SR8CF?-$u)p`MVcG;o$=6PMx!!J
zv7^BX+;C*e9)KSp*x|_Sg^eg^{!v)UL8oCrdA~>JF{yuf5`^lgoUa}8PHZ}-9Cd*c
zoXwN4l2HFv$`5&l28?2q)YUS3cdYu@P^ITj$VaYe>-4q)p14ctPr$-PV?;W_gqxAq
zxqEynnubu3T*~iUsO%CbtWie^4wL9FPa{ei9;-B*+|@ihbO@e(NLUtte{5mQNWxQ`
zG*)2Axgrg(pq~K~A#{xv!wx4euXiMOQsQuPfXt=o#b_rj$W1W~aN*J)lb%mB0x25Z
zPf@2}ymN2VMe-t$f|^n`#t&+cy7=qGtsr3EinPp9yDh67Ch^Qtn=Pvlq<KR*rMpil
z0&i(2A;`|1fEjLEO)|z4R1=Nkx;s+Y-58t?W4VJ_y#Os>QWy>B0=Mg^oX$3EqhW!6
zE0z99jwy9k-_9g23@hXYs!SX;QW^a6B1Q`tK8?f-h~9VJt0b-b_E%kA?GZx=kio49
z{39S+HU`>My<6eUS1l@*jiGU{I@1!hox!kFfmWpAcvxpL>lT*0&?MYeJ|cfrALbtO
z1$?mdY5XnUV?O%q<_AK=ruK$a{MFiMI1YQHD^l_QH2GW*_lsJ7^Bl&%x!&Fy?YG{J
z-KEs{A*AJhpoaco`H@OfSF6Du4O;Uq{rbx>`kroX?qM!#W7IT`{!i47gEPO+8m`yK
zX@6(m8|}dfw1le8v#gT0sa_NBi2)+ApKS;SB6a5#Bn6o4Mg2GmisZm>wczBQ<+CjR
zm0AAJomz6%N5H?L-dcs;b|u9eusuGLLsacI;xz#7H;%z^7Y?vM&(J#Fp$dSy{g~I$
zU^t}ab0|_$$JHgFcrTfD1xEb~NSC`|KT-?xng+~Kwj2%?K(!DmD(wR$G*JM=1t^8`
zdu7+t2c|BI4hFx~CH-t>EDA$S9xIW1YO%U9eBl219s?Fl+>wC3QHioMr)ARO8HItk
zUuNE9`65^nFTw2dZbj2z29ib5Xok9lEz`wSr`~_;V)}sKlY8gM^3|iCW2#;|IDVJe
zyz>aC{mm5jFUc`?Y?+hsi8_l>2Wwb)%BHkWwnL#iL3D-ak-NCoiuwzb;=OJLM`!es
zYhe~aHFt*CF2QY!7`J#457jE#vkS_%n*8VnHtS1E`pdWQqa+5Zoh4_Zq!J-tTX-*9
z1?Ahgsp>A|(3Yui+xr5uQytm&AIz98?Hc(wn7yg;TlOe~JsJ2MJ2@DE!87JhS(W7E
z`9`N_%s<o-<*vZ%SmptN+HbtuaebkUsL|eNcpnOYKU_6{TRq+X#o<@lki*<#Ox1gg
zsj@f7VH0mORm?~uyR7mHC{j5-xJ;zKVYCu2w>PRzg<*(WWFd&R<N_G}CH3)^TAKh{
zb{F)65|Co~G}2WJB`k?EvK4GGIA+e6<*KQ2#WG42a)ij=v#B<N1brTeLt64|d}!Ul
z<!6c7V#E#Xu5<yYJGxy7<3uE2%(r?5^4lAnlW|`VW1;+3tzzaxEMa8P0#vR0f|%98
zXcwFbThEtv?s>7fgVAvCwr&KAJ@z6Qui+LU1#rb$z`c)fKSDa}_pMxF<B;zX9Z~Pi
zL0(ijyd}?zN*#?3uAkKkS>x^dJcQK^FC{NxQx`5_+@4cUWHr`k^^WDM(6$&|oi*Z8
z%oO?aiMS3B=QYGHOpc9mRUcC3F!@<W!rQ~%_45-Xv_hx#GrbfM=yK1P6==sh04EOu
z!%94m4M0C|BJvDlATB4|`1}PxkZeob1*nrYiJv+eoq7~)qC~?d1v$s1DCIj6`7J3I
z#qtK%tYq58h?OKSb8jlH$P^1=aj<SiC!>k$ho=xIU@DltY|rZ`#)ar_d8i5Nm<sdc
z1Z4cr%s9ae#ClDkWS|i&5Xzc#G_vL=s;0i+zA-c2G&5d6hI(U-;cB>6J<{Q+6x6$?
zsNC6b#jgb+Xxuk%A@axm9(ah4uixT<`DHri&|7dK*ca-Luigp+haSL(L*Hff*h^w>
zXJbeImykl6ZQDaY%At+p>CmympxV5RffkpSM#kqqfK1$o<$++vua0vhc^thWEH};o
z<g_(nZ=?}n*(kh`MhpA5O4$sEyb<T9l@a79s~YbaJy$gEf+_0#&&h`&VUEn*oM(Rb
zu(vA5qjQ#V8RdIsuq(^RmA=9r`$-gJ9kcLIU*SAn$Vgpp&6}-hhsSOJtqmR|Go`5)
zO6#*@R?MB9!^QS4#*;?F2$9qk(G9Mx%6c1s1vcDTg>t^{yK@F#aC#l{9%g|nP-wrv
za+HU`6i062FEDiBLaa#tl<C+zMHcAEc#)ISI+*NG))&leHk{6^hC(!fTXB|jr(AGk
zSI12EExzQ5J>vJSM$3son2exPxVMpb1=_~D0zDw#L?Ack!AvDUdgVDNilhaFVKC%x
zVxiujDei_y4}X|9q#zdm$|5@$8X^~eCKf~)4eP$PT2(xOKl!h*;_tXWKFSEGyBVMW
z@oi?j&Wt^uiUUzb+R%L~sK7{)jjfAwz)y!IOfoqfpEr-4;C3)|BT_M<&<n#IYIs4E
zlx)ezn~^~&Ho5zNnA^?hRQt=_s-a4Yrd*ICz7p?sGn(P<>%-lQw(YRc^0|T}^mWv(
zUWtQjSxZ4w<{en53-AM7azQ>^O*HFnG;p<39;Gv&ko-qPvND7V<oZwU?%v0J-@1FZ
z_qw}#FVVHf?!`;wFoOJhxByvxy$QuvDmS28REKsbRy+Vf(`ZY*roM{hRIG>*PWdA~
z5gVTU4*tqNDv9sA8;wIN_lD|v803(n_o-3gv0sDzC#QWPLV6fOd(g~MQlhVzeFBha
z<Bx(ZTw>ipbCo;qF!PJ$i(EF6AAeUB8+#ZI*U<#`4P5AxivOp%?<DYlKl6eg{Qr#X
ziMYt^sJ;?+nT>e@&BP?l5WJD?(5LD!|M?G<(tZ#L`Tdm9c0>;U2s7n-2o_**hTui$
z;v6;a>+-!>p6=I{w3nNs0yvfiE=q{iomRXWm~klq%4nG=MNUtnxobTfzA6N-NKNT#
zBL#$g`zS<!Pqe#F@$R%XT8!$1Qj7}aP?+;N_S6oS1iGtZ2cYJoR>b@y$npMDnKEMU
z6Nv_*#-~7vNt&wH!m^CKWLeh~6lQ_S+%19Wx|qA^Z^CfQqiKp0x7yI?m<)nQPSITi
zJ=PdnauJs&9(yP95|9Q16;JAVI)<PQ`|K(^%VQ5R3$%qP!Z-22n{4rBFJoBucj#k6
z)%~cN$0ZLivBi;~<?D5NI^-SKeyrHpNVJbOVn?3g<#RmkUL}5KPt;_H@G6jQs+~eP
zjCPpv*4eT-RRLrvny0S6S8qCE;@;(K?QzueED1(t`*osoZzIHIZ$yc=PEsmR-I@d^
z=Mr`RtUKSvrJSjH1hz8Fsk-v~77C)ioC)naT7oxboJRpAP|g3!5y84L64gk!*QSQD
z{k@Kw0dJu<V5Ebf#=Ll=F9_u={rK)sPT<mKHG$I`g7+!9{&=(g81^PgPe<h|V4Qi$
zzeWt<ChphJXUZIggRd@rNSO;$TVE*C8Db%;pcSBbfYPw6YBor>o9&X58<*8VOUoMs
zGfO5n7VndB;h+n6(8IWFip217=Ib2VA;6sMo^erK70W7B%><s5!9cO^?5g~D()EFA
z22`!b{;ruen`v;j%F*xhhy7WdZmxgua2)b!?L~P~)pc2pw_&`#M<%O99xB27rM=pK
z_1o`3+<km*&4FOl;<e)87;Jifuo9hMO5M4&ipkygH2`ZEDv+L=_zz|410_N@i-{1S
z2hgUK!HS#wo(OSYeMZg;7FS}7`jKboD<?QD%WaZ#@5ks*gYU>)npqm`Yz9xk2w0+O
zuh=tas_5RwXl}GzE7JNH;VrE|OtxU{eOUH^E-a7l?yMD~lp}(~rangKbn1-2QKmbW
zwtLh$8KBPsF6F`dHW5m(X@m5GcU0&0L7Hb|M<}KdkD(RK-(@O~hj_|&wr@Qbpf5E1
zr-oW^*Ar2(M%}twmXJ%z+oA2%mQU-j@Vf9CQX3E30rgW1xkR@|LF)m>UW~~6XmC!h
z0ebJ}6k7L_<`%lW2lS@=sHRd-bSmFzsVY6iN^z_-7L|PEb$l?69?NIRd5Bj%9AShV
zW&|z~zsDMljhVrsMqi_g5phfO?Q4WIdc3s)cLlwhKa1e<AQ|ZP9Z!n|eT}GwUy@az
z=4s@q0Fr~S+uYWLPm3@58ljChz;{90hR!N%ag>$JLgrKOHsp0z`*f*`>iOb8d;7qY
z*$=_c%<Be-WEHLYB-Ajidh;eJdJ=oGF2-CrJLGfK#l(I_Tr$H}5slP_GHK2@_cizH
z$8&G0ew>9g&&YVL?1sO^6gA;o1<&U-HSeSBQcZaK8Lf=D9_=Z4$@yQNk^xFh;`MMW
zOuX|ktK_GEEOiBC78!_+{Rak|iYypKPI;^eEwrQLEs)~vPv5x5UeBe=9;LD8vHuT4
zBH4W{YghcvFxAT96qhaWru<lEUr`f;!+j0llbHSj(&Kkx>S6?VrIZ>s0VA9O2lS6>
z^p%oS>Rwc3>MWgFIVrP<rauufdAOPE(8({G$-S$UH8!0#6$pZt>N-uUiMV*9jcY;%
zzp*u0EdQ-ejinqawH=vvEVk_4AP)U<e*ns;<uxVtF@pC5wa1_QY!EM<Z>YXVRkIK~
zC+u$s8Tt`cwgUV*0Q+>!>o7e1oDAZZcq7=@^NF|_Z;UhAyT!=<*vaY)uxi<6`@GO?
z#wA>aBS#*&p*$Yg8&83zJ0%loR4Gpq{MJ|HH~8cn4Bv8DNtO67l;K4G#Ms*?mpMbd
zRJk<TBr6AO^O2Ra+K((TI?<>THWvsJ-9O=3HSb_}5tHCng=^V5f+an%&n^^E1B~{r
zIsl@g5E8E<HEkhyL!-1Q<Xp3in_JH>S1jv~Klw+<vL|0B-K+w)7!(A$0Kwa)8bjpe
zN%qI*+=Dk&^yggim4_25cc+&j?YMId%{vA2%i9E>@IZ$_Fy3enCDZVKsuyfoeAmLv
zSj&t6U&aN6*jm#q!V`?v5pJ}M-G-x@qtZw~eGou1NX3cJJgJ>4jwKi&#_eG7M1s*O
zqV>HsK8E-9t{U&>s2bA*^q0Qi83bRIhq3h1eRxv-s*Eyv1Jy>&Dzt@t2=@{O6&e?K
z%j~;k_gq>BOZ%Aoi2^bof1+~4kVK<Nw-AL#N7e5`8&DLxZ)x%>&G%e5SgF}0_lq<C
zwcubou4{in#IH8&y!MgtBk}-LVEh+aP2obs%Hm+6F+D7Gy6VAdkDv$B*@Kr}!Hml|
zSvcOTKjetyfkyAz!JVm~9>M5%55r8lUlC%U5pFEX5!(kEJv;W!p$;i7dzx1xJGMcI
z@ZU;qa1_e900?l1(cstQS46Wx#=}OPPsD~nMpxtSPsHIt#t_%UNs5l9P!st)<{?Wr
zv6uC0plMVdo*)Y|>oD^iGGU$26XgI@p7f4)|1K+EQIfH=s&dTnW%=X?hg^ub46tWO
zta`~Ft-6&3=i4EFOTByj#dDQqT;q^mkpHRb;ynkNIe4fzioY%cHjy?$GrD18J<?e{
zq1UGoZ=tD9Y?9kwd>B-siSyB5hLluNPXrdq7eD6rorUZ1A6qsLxTm=9&@t8h;2hQf
zjd8ucP;fG;N-z2l+nQ)uoLs9mURB>_9kJj7%=GA9wk)2l0lJO~U4gVHbhu=Z%Uy?i
zT?GAJbeGA^;?*Q0zWPttd?8&gZ5F>J8Bw)A#W$MoldzOb(PgkvzhN{6yl1}QJ;Uno
zxR|xtZ5C4o8!;We$EkT0c@wVV36Alb@dO0D7a!aMrgX_mABY2kjpX)In__6Yi)$Q`
zQ5^6XcbjM!;}^WS_~o^6B;X_GL(zAL(P#K*uj(k}e|yx<%4Q^=b)%XlpFtYL;6-Tm
zd|sR_ohrTjgj9H4bFv)uF92aDNIdkWQBPbLV$^npK1e;|7tgm0h6&~sB?TNJ<<Byu
zWAstkzY0^-GpUmICt!lA%WR;KS0-}hs`&0jG=bsGN)Wp*!yFD<IxW#N)k242?!>f2
z_g?(LW}@?IS9$d^L>4d4R!YP>t`^9n6GwTiZ@_MYzEJB+tTHZ^KkMyzOuUi|nR`GL
zz~U2y%<&aHG0llXI>iaAZ_CSNu!v*!Eo@LyDRK2b<nbA#?BJ@;5wm|$6*w}El(gWT
z-mr#><#uEu{bBX7Mb};24HiuiSpoa&n^|{xF=Je?Tq;=81<HndR@(qxoe3(I!33ga
zL&p2q98g8_Z>-JrRKyMHU-{*+&sfBk@*KL{&+Y*OaM^KDSqV-l+8sJmzNb2_K>kV%
zh#A|{)!t*aswbb(l`>d7+)R7aEWQK95p}>``=qM4mSRLyIg5$Wy+>SJWC;;3wKuAY
zK0}RmLxR)TNkLCxHj`VPhcBR7cOZi5#Z4ggRdxJCE)cos_2-a=3X@PFe>#PG3DVJT
zD^`k+h8lHyU#$nlm^vFpIuT|Hb5-mC%C7Y4OD*grD+nYpj)H<|kA|dNA?^${!UHG3
z*ogNeri(Vij3$F(Dq}JDD*MiDeU_E5JBpdq0pjK?4#3&E4Jr?j4@d(8IRzhoNKv>P
zfASwAh3hwnCx;o0tDFRYymawCeplO8iTt$MSBPW75CSQei#x-Nh~DE+B;J!c3j%<v
zu5i`gNp0wY$S@g?Iwd_xa4+J^pQ&&w7g_iUF(DN}#DSH>BdJC+W5{yxVye-?XtiAI
zN;O*7JP%VJcYC5cj=v+Wr5dqAH(w$<yYHJ1V!`e<Xwhz)AG;mv6}wL&E&mu0u`9n&
zY2~Ky^Fik5-gr|yI^1a4`0O$?kX{#FDMqVY1$beHvd#Ts$8fl6-?M1_BC%A6=TP3M
zhjKw}U^#DMX$>r1{ot7s0%t!?B?Ih3V6@Oq28%ba{Eue&o6n*AWB`iaf&Z{5Z%FK-
zEkkE-E@Rx*P9QD5rb!kkdSbemJi@3yy9Ovyl+a_KhD}il=B*!ZsR5xa8WeY6Qf8x+
zJy0a~A^R?aDvXL!t!9=uX>G`oS21bFg8G-|Y3d)nDK3t{ZpV+vU<qY|l**;AsYZQB
z`va5f(yFoyYN=$9EX5x{EQvKyb^uDXCkWN(n<ye+BaqGdQZz1vO@|gQd@~RH!89oX
z2>Giv`D)s-u_6KFB02ts5F?GqE;DMV7gEi44&(5~#cfRM;PM2odLcFYSA!Z=PAmpR
zxz;sHMd?T*+BF38GaLhWV-s=OZ35)+D9l!aYWW^q>_+R~W4Cldk0{I16Z8ONNxfRS
zN7r~o)lkn0h0znBBYcS*qjxz9tBU?L=Bpa@Sk#3vU_GkJ+Ee@<$ZT>Cl2}!Rhh58B
zRUi=>$%Z-qfux42Ve`>5N8?x(QPGfxP|c<3;@){1dA2LtUZ28>s7hbWD2-%Y@P8nA
zQ`M;JD;lVgypJ<iK5orLHUG9dRSh2ZyWJY4S|UgaC42x1V0)mns*GOI3?9%`93N$*
zRXS33M|2vE0lJh-#jMkDo#_wbHROR{Wa(lt4+V^4i^X%JjZwxUi^Z>_jnP#f!|EY!
z^}c8CbZRPQjxjzCUG}n)*H>2Rt0w|7?#CsFQyg%4X1^r5rx}|jzV#Hwh8s~@>UDK&
z=E*v0Qc$ZsUgQ5cW;D-8jE$fp_$5P8p7j@~dWgt7nVuU;|Ir||UMwi9Ma9~RMN*y;
zUB(&_#{5^sn6bus<8&2qWvtP>>8F?llVbMUvM<8iK|o_i?Cs+hq6!VU<hJNE&S+{Z
zsUn7sGnyoh)n%OnSdMpSqD)J!+2G5(d9I`e*<;t=h#TzaMDXWOLsnwS%`+w774~}n
z79Wl??DfmIp-(Hn1hc!j((AcKoEv9!H$Js$bkA88X?LNUO4a0tZn*yTL)VWfK6G78
zbTKA6`VD;O7J0;`@kW&EhpOmUgn-R}UgVV$GWJO*ML;R*H8Ite?S@{&5Qgf2`w$J>
zgJ~^k2iGq6w-T&#&Z)>QlCLuxiDUeDw167XkLW4-TN90wePGg1Ci$q2za?f&Fxn33
zf!zu+X-znLM6c54fjFi;)e{7ItEr4)t)bj!{Mhgfb(Rm{ky3GXg3+~p9(N^BIaePO
zRm=WA+@kqJi0`A7gkvH)c`{~7HeiZh1KJaqUjrKJZ$EU^{L%e$Q@k?~=p^<8h%V;@
zSY^^5<`#bv-TQ`UI0@+17#iJ3KXl`65?!g|<^?TNgY~x`x?W82wXXe5v22pjvQC6X
z=fX-!wQS02@$n>MaEo4gRd{e3I`|=WaNS(Ow}vf%H~Jiu!l3D**<_=&@%wz?m~4cm
z1*!@uZ_0iMufpu|CRe(GZSdGj0Y$b(I;PV>Fw5VhO#G6gmJ@^Sv~@=D`!v2QgrYb-
zcfz1MvbsflG1+KZ?-@Xd-%*3$po?igZI~;5pNxHMUO(e~6hT$MGlO`ZMsOx@XOG1O
z1k$D=jpWEBW_r9z@BWaPj&{q5$nuf=xhA<jK_#jx8S{K3TPsM$I|s$``V)5&!4#9$
zb$_XzTVjPHjDc6ha?*FYPoPg~I?Bbr1m5}rna<LT;k+tuz95RHz*^Zf2g|bJGTlzt
z?P}ks{Q12Vf5OgIyG5XIrFXe*#wSy$VNXdnf_upEPc-=sCbQLxRC>lnUlXF9DCc?(
zNo>JyvKp&U>j6x$kUc!R;t5)0;hqKb&sFvG+v_^Z`4hc-hz_7)T{#7cRlQBy3BTlu
z$Jru;3l_<5a>R#I4ZHFA<Kn<nn1zGqieIO~r+adWs5T92{=6w7cAC*Rcta=DYY(oX
zqv}l&>C=o3GrMxNP<}}t?|2>t`{hmfH``C=H~*~!`XsAr<LTrY1^I1|Ces!wE9o>E
zegKk$eV#@T4pw&LCVnp0W<yezL6)(~`DwDaHO&YQKG_ij%mNQU!0^eU?R29<pZT0V
z?jj&W5zy10fX(X706=<Za-{(8e7$w%oGjK(H|hr`5$d;OhsVBelK5;o&RBZ?`ERHn
z{o&WFUEYtCZ^(KZ&JZtbJW!uFGpYSPwWSBYw6zWvK8iMnTbW{m-3d}{PIF8oVkd(u
z*>ahQyu!KhPD%ab=I+EdEBLY&NXZk_`3lQokhy7+Sa!eBs)q}RmEagSN{!)K^FZPU
zU|E2AzYyhS`tpCc#(ZZ6(#B5`r|-v<H(-*u$-nI<i3T(9x9%j-lYh%5iZS@x=a-2l
z>`tm~Mm503mP~*;$Mm%?vvx%$L_DBmFfe>MQG7JR=rHKbnc4uYXyMx5R11?b_Zi7C
zb7wB58}}gvD(I{6&|UOa%9@X%xo&Gium`~MCy0o2qh;`$?a)iTvs5p&m>|ZaLz@l!
zTdYhs>|<?U++D&p3Bv(=sSvig^U8${SFBLjI<t-&VgIG_tyK`UQCigg0U6#J>bE^`
zg7`fh0`hBHpmt>{)U(EmIx~&d)7_lS?h?BO+}XYFcRxxtd*hU(S=SIKUDRmLGx)8#
ztjix-2drm0r5-Oq5z%!vA1}g;6B~i(LCb$5Is{IZH+h#AZcJ3N)+2CJ<>p|v|37MJ
zeu?S;hx;~PSW-e}^5e*FqT?*1_o#`_0zLNJvffv870YBKcsFa}{~Bu&-|Q-deFdhC
zjE+=H7hL6vstLb~@r}QFS{Qg;d@;)ijh&E=+U~%??qqLZ$#LjTQ2Zev-aS=3e*b^a
zJ@>M(KVbBz`@r7@xEJ(D8iZvjg=O!fV$uV~6l3uWvFiaNeBNW2*dSD&lTdfPZ=k!C
zg=ouKtD0l&3a%jkHI-irVm6#Jp<l@i90sx0)TOe^OSQkZ6dXF%pYIo`4;oJywcX<T
z2O*AEFN^B4jaJP!l1MNil}vzwrgxSDJ`}SQ1wKs-pKUa0djnb@pAVO^G!(IE%UYA%
z=Xo&5dP?WdEEQt5(X?I6Y8cy}A&`4u8?Lqko~HaFAoQ?ojvOo)@ss!deZE>;m~AAw
zCSWf!>Rfzz%pW%;5C3J*ONY=TIcgb4g!KocfT7DqfuV>#36T4c4&;YGtG*iuY9m_r
z)x4XAd04?GWB*_#fs8?f{M6W`pW%obRHL$YEOu=GDrcJ5GRLStGz`^!6+cBqu1)W%
z_#!I~#DOl<liwlsB?qtcV6B4N(m^OL=0^*zsXsv%b3~oFMy%_h(dBRmIua7~Ad>VR
zFnL}Ni1flIOjcHe1$wbA4v>Siy{z_X=U-E7AzMqADz;=J1#D@0AJ_s;VAgp=vBil#
z!CBZkz(IdPbvBSvv}Uq6GZ%M-^ktv%U=$OlVzO~C8p#)A)(xxYP(p}a7`Qmx;ieGv
zK_OLR1m-O*0zA!V{|kiYOuSlx=m@(cw{o0UQ`|RorK*JNiCvCf0|FdP0!G%2fwW=%
zwQfU&ax%_w67VMjBi6niB@`KrHN>rx#E0|XJD)a1oS27m-qD2Mv3?8&=*FZ?62bG0
z22*Uvz{69xw9FBh(V5pV<2oJd+Ylr4rLTK?10}n+Li0!b2*1T7JjY|pZV&A$?{7*4
zQXt#hR$4H-K2<L6T$wC(FEB!y529F_itHRG2>cG)26hu{f!upZ?3fQn*0m<$!hEB7
zw_PLERO%Cf^Z2X~ftjdpihw#ipdbvrB)TmyX0&+`lqQw!PmWm-xM-|50cuo6G|{9<
zWdb_~fGp=EO;!zxg-O<?3IB(zoFByB3yiL=`w&qBvm1`HF4BSDklTG%i~to2fZ->T
z7b_uqdjueOf)=Ji$SzUHzCb##9b|(umjqfC(~D69c=9;$;$?!#xY&_=tvCf)e#6m4
z?3yS~rZ<E8aj3WqV9JMZFLfO(dTJDq`t{Tn%orv_#bdmUBnS!Q1b9_Xok6%r`9K5>
z-~NHY;<5gQKOjCBGcqPr7_}&a0f%tJ1krAx5jOto;p7iSu&-BUAR$kk-Y_{BQh}R#
zz&wU|=OWOvz20Z=pK{DVnW|B)$`t=wXtb@?Nq;uZ6sH#&o$H3*i|?~k(QuK`YDzrz
zPkp`79ly~VAOGgp8_^l6H`b#Y&>$Wu&+kMH^fuDL#;u%F%X^~~Q-awW_T;OShWo_u
zM~!-}BNu%9|Bij-w$4Jm|I7Yyz~aaL7Xj`b_Gb~0Vn0GbppUVM<<ErgAxLP!SL#pD
zZI~`#f6fHaHN)r{IcpesuJvFleiJmmsR=6sRfXKpWBmJfVqJ#O&Q%9demj9{B_*~s
zfOm&a4|0krY^O5Pt;tC6jO+yVOaoNeWf5HQPwGezr9dm|3Y_#jx<(_Upm-FDtC!&9
zzeooa#yCH&^ng509hRi%Qfnn2t=%!dgLXBqm}1cst256ai@I~&44S!*!RSG2Cz=s6
z>yC@zFB*-+W~UKcchc|d8^3^=ePdL>Oow;RlMXCsvA)<23nIWf6T=14wI4D8aAVm2
z{mJ>}3x#E|QE%M%Q>X#OYV{1WmNel0-vYH&F8k{YXB1x5MoWqTz^^aK^KN5QZ~H{M
zIdJ3j8U+Lh8~h>WFE;G6Gtl7`P|1QN^2|x3aZizsvL)zYs*NG4V5w}3nH|$&FAL-X
zHwRj)D$4DFx&cjG5NCHW@=SN{%8SbOzfWGOFRm;$ng>6b;*%0c>1fgPVWVNgq;J6v
zx_ro+l{B;2PWkHBBK2WxYfbv{9uZmP^@&K01#0+gK!RsvdvGuq;N=RW$}=@E+8|Rj
zJyLZAf<HT7)ksGQieE_PfFr|`6ePdbT_eVuU2C*Hru#N%3Ho*_B<8NZO&g_yq57U9
z-No_|*y_4(d+WX(TcS`6CMtEb;Zu;H0u>zY<q@;Y%Z(6Ce;feN)ludUw@Sxd<CA@Q
z9#f*9x;pd?AngbFUt0QU_Q9S0hKA#`dQz+<c@7;$v6hMG(<w?{@^T3I^)CwFl4QXB
zdF1+~MkCiWVDwWE<AKdjsKTJ16M%8MT8Uw5QUMy_fP8lZC(bvRl>3HM9RR}c_laWJ
zS(8QN*R-SL+nk6r?7%(06mFVE+wbY_*k63zePFKYy!(*g8QBH>*KP>9I~waNxsGux
zW_Q=r6$t$~T_YSRD1Lh|`hYQ7(yG>E2@$gtQ;-$*lc8hZj7vqTyPMBqv~gk{wIK#r
z?4W!4z1~RG@BRNiL;8zl4`@T(?|fq(Bg3vmES)&xh;spG@itKNBc2`O{t^rY`OYy>
z@QBeQ{K8MFJC;U!hQUK^eQO}`;W2F=4_za)oXr3}&t!{t6X}9Z18aSnp3lJYK{Jni
z8>Cb=D5gW)St)My?Osj#W9qf7+m&OD#*Z6k8tsY;KagYXgb!X4Jqx=hZScE<!tens
znEwlM20`vE>gEUYikkJBT*V*Ty03EV7x3f8H;ulI3qPG>Kfz3rBO{8$(@U|p{!WHb
z!xbsla=#Wm#ckAT;5xL64pe-4w(8v`NJEDV1ipOiY#>x;4moVK`jO=<Hz|fCLbQDG
z8G5qm2F#G+8s^Pg%}@L0G@PmnN4U8<OQ&Lh>6+>cJf2h#6Lb<%E7#2yYnJ17uRxdB
zvD|nlIR!*<R8C{)LL5IbORFwS0PUF)bRw}Qx|Jp3kT%~;Yhk8^B5k~xW}7RPtuVTc
zIR?MGHVLSj23_*wK+yw=1LKkA8JP@{EF>xJLDl|5G|Sg5P8w%VVt!MW6<TrhCz1T9
z(XiuG=x#lM>sJM=mDvsD7Q{eS;qXP3)w+s<r$V*yMsI+efY4yh`KEp!u6o1XUw6v0
z51UiIPrrY4M(Ov7vZYPD|ESSCa<m#J+6owl-~Lv>3z**SwgR$Fh&zuOJzPrK5uMCv
z^@MKdc&?baygWXOZO45nuue-x;J_JP7h|EGQ7FVClPt7_g)*0g=&VrIf6>f(R@EPZ
z<;_X?Fu2Q(>T8~Q9HcDXqW}+=_8EB|pKvK`%nL(ZdFc^xz=cKC1ujW5r`Li=4ygs@
ziOUJ#!1<R`WbS}kC378~B_WQ?egP`bz8wZ_{@W&M3s9@cbD!SXIH>AiY%i--UZEi?
z;GC;!#?hIog2F(JvH=ya8aoaG9l2HIjSR71C6=A1yP`)uL2V%T`3FeqG}L4HKVdVL
zjMF@#b8CMWRj@1p1&^{|Gz%&|G5bvo=OVMYjgHsq2#35nCGYSzcm?M)@E6M>Wsiba
z#Z}0w`<<feDkH|#K*N|t7$t=9YPzPS>piqo(X{kq!M|8=DGQd<@{7(6WA=4sk5h0o
zEq(8yCAgfH(WK>de4^jhb=~D~!zOXKGhp^-?hTu~hof_nQ#VS!kHs}wS4+OGeiX`$
z_=_8R4k3OTAqIFbSHCeWv%VAkA48Pc061979T+^cnEsufhl=FY`_(vIfduqKs{x=o
z9_n09nSq&TJ9fCiI%Rl7=_-`qFLa$GUFXmKsG}a!=zuyH%w3ZGMt3xVU0j&2tzTf<
zP)#bnSztP56AUSJ?72J&X)vZx&j5?}K`d|p>Ix=BeLroqBXCg+z&HU$ML#GoYDl`R
zAppgo8rl=(pvo|3Xl2m4382Ziif~xUOc2OMi+hmz;cW4O`^CqZMko8P7hr$paJur?
zC4QsOzYmG)nMQQaDkzK{BXebdP!Sw+@inJ6lrMjW$qqp58C2PujGY^_;n-j?Bg=>h
z-3tYXE52(1>`B!0c_~ohk-_4NETg6CT_$^i{)z)hi%C+a>58E-Y@Rz16_0Sa;;wmC
zE+?z8VU~RhA_fqO10H)zs9Tm~k+Hrar*x6)BoHszLEZR@^zao?8z?TESJ7o|ax9o&
z>iWts#2lDDU=il^Ig5?BaAzXN)DP24zhyX{=)rBK=p+P%U4(-+4SGZNL$A`0Qjz4q
z0UC87OjMb7G@6P^uhu5<6-8wAqvC3|VQ+s8{6u~-4%?M%0R_zzr&lo8_9`eb<89I6
zEuV?V$8i^v4F)hb!*UeG2v40fAL?WxU^KZ0MK(dZ2Zi{dRg}%uDEFVciz1aZ0$K1g
z1M_KKy2^I+1bCeUtx_sohw+VJ{4|<>RgU?b!G9&=fqnB2cY%|E1Z6gufE*Y*5E7+n
zAu5&6$e)W;)BF7g9fi!&1fbq6&Q)c595HEuHZkZ4Fd=j*f$QsvP+%Vmu-lRXrG;6U
zyP6<$aexe4L^wEsuJ68&?T2!npuT+}gRf8qmrS99v^f4iV!+6ONsHuOetTAQh11k`
z^$;as-vsi&I;k8D@Vua_`lyhr@r|$vU&JJeN2=nr9LK!$zab-~EBY*{(h<2B@OZp-
z^c2x1$9OjUZRk@-Z#&SX29fFGvt|Das}_*P4ix8ejK<y8#VY#G_W}LtuC4}?6=4xH
zLeYMY{Zv){g1F288*q_H^?{;8F7}r*Az!}UpwMnY#4@r^U~+Pxb5h*px$GL2Sb-8?
zdPOh1l_=H#l<U|eWFRh7t&y%m8tKq6862bu3?_j`$Y2KwAE-*+;!F)~K!+R8=?o5(
zZUtp>*9taUBULsoMyf@A$yMVZTe}>&lfxXjgWBLO(0*+)`X;$WI|M)*i31o2T|cz#
zL4<*+0BCh#JUH+~6*%j_+Xhp_qSZz><K#r~_G)8<k=tL@Fy<BryW40J{M0uF%Hdgz
zL4mU0WHH2TEUsQdr^%g@M4{UlQ}^rMAlMW1Ni>?%jXMdyjThaY#75IX+{~jZ<L0wT
zV%C#JwEYq^o6?cn;25IvFOY}#i>*(Bh8N<*uTR2px^Ta!<uQ8J^#CB?uIUB1%Lun%
zoEYaZnnp!(8RQ-oi1Fk+i5|l%&Ro6WRr*2X^RTcK&%j7b^>Q{ghB$3Do+sY*7z69J
z*ARc~35dMHUp5^lDz7mT(mN<^735*YR%RR+OB91Jm8MAaGmIq90m4>>cC`f0lxp5k
z^c*;u2lD8C{dYX_VPn+e76pCHcr6D&D&oJ7jul(h;0n5r#)>0rjHp_NPf*zGN7SF7
zAJRpwr;M1+-X5Ain0l;7@Y~<wYy!!@YkmvdD;{|YQ34&XrYOIlxfwp<-FsC4C|)zQ
z{;${w*rU!^@nVEHc&u+j@W8vnQ6wNJ5l1s9%4)kR*SbDdls<*9v%26#McA1|9!C^~
zXHYX=98@1A!}dQAg=kKOL4S~3H{x7XRFp-&qH5sH3Hty{zP^f;wD6zswbQ@Gd{v_n
zi>k1*GawYzXM|QD`QJTAVpSDfA#ZOGQh{WXsu+~>Ur1`G8lgUVGBl2poGA3H9yAu!
z%&;>Z-*xr|+s@Z#2jKjPuV#!!(&xXBys2t5@fEG5k<4YdhKa;}PeYulMnm8b%~7hC
zC#W(?_y8P@QM^@^%NaZXRZ#xd?rNOOz#qAxRQ$Zwh#vM4qaRJP?QD_XqHM}22sV7q
zNb`*Bh3<ci)xK7#>Js`=q;)=G1gIEKed71Mt>O=1*jo(7K4mZZ5peAvkF5QHwaH!H
zBZ)gK@fw_K|1OS|VrgKF;+bUe^5z5}y>wIwTs>gSPXNDVU!e64;5c%x0ABlLjs?`4
z_PLrpX`_9h>s;hAXb9_6M;#RXfVfe#r!HDEE~onp=ppZKDC0u@1~WfI=hw(-GKksw
zq_>LrsgtKz<m`&6BOG}cS-qO@2bmm(H*D)TE91X)IRcftM_%0ta<S|NVg=#oHU)wE
zoa%cQzi~+w@TWw=5x`N^{VSxEA=(ZRFQ?=tvql57?8-56W7Jg^X2}{XsR1p~#hh>9
z_-7<=qx1t%bbRvXn2Z4x<%cO><!S<K*#8;-W<)IE)fb}YI_&72>MhdN8SUCW2nALC
z=0a~JLHaIRESg&D*3ubwsh8?IWA_fRdz}#ywtW~OT9e5T?x_}*J-tme9Su1nkEDxR
z>x|@vpQxT@$YI7*aDC1hc3^?*FiK2%&IoURf-52I_erMfJm@yG3YGrdS4$n0r@s{M
zK4&y))@&WH(x`n9Qqe0*o#?=`M@mGjgQLZd&tZ4?{mCL|z0n|f0gMS6dB2h_-Y;}X
z5vZO@OT*kF3rA>ZSv<SXi2)=IV8+M340A7gM=!Bpz0s~seq;qhem2K-m^xZ)60NTC
z+VzF_YCVF<`}Go6)*JPWl1ZYfz{FLlmuN4Hfv(9f`PN#V*qwxkfyfj3%MSXMT-H=I
z3ZFqjK38Sz!lg))ClFP@;yj_Btc!EGbrPKcA(+PUyUp@R3WmC1%7HO^>VWC;Yis$4
z!!_Ks6yr?wwE3im86@7lZD;P{aU$`59;Y81l|;1+3l2Vyvk225P);ZW$|EL9%7k|u
zGGOWgr+p@-7WsoZ-K9JRomp7N?-k1qYm@|~IDEdrqEA%YoIN2{-(h$rcxD<P4Z-mn
zI*A<{jFA5C<ZIl#r%|Dxfqg}0vZ6Z0Xv_KvS-R42#83f5Wvl_>%x7BmzbZnWH=6fp
zHc<-(&(8r)oSX+!(z_b1ko7j}taWTs=A*R&miI6lb1Dpq(EFiqK5s-D-$jWJpT}YF
zZBP=XGoRPBostcdk*lt5V+h-O_+<FmWEJa;WSpZPAjhdxXKxJcINAJl-KF#p{<hyw
z6=$TVPPL%p(0|p@ocwwqSpJA~oNSB(>0v33q_TYsD-Xl^-Q+>`yVzSTnFubnjuJCp
zFv4v&p)X3dBH?eW+VU!k*)JGP?T3))Bi$i8d;sa%^s*>?!H5}h=y^>NU3P!&^CM|#
zvLdMp$kdxu6ByA|qEgkxLAd`2wC=}E1@Nea$%F6HyWFNu`wkp8etSfQc<2$s?z#x=
zOW6*^NZk&(3Gm**e;`)3b)yfXp58_n4IJh*fXj))ZaJ*yf~8x?VfDQEeqBkhQan4e
zIV-)6U*-a^SWf;>wJf6rrl%*`x2SZtzhM&85eBk8ep&)2sP*+o(SM^c(5T!+tlnre
zt$t>!COGbW@$p8Zt?Rm|7|M1w5@Qpv?X~y%hVqMp70cQn!7~z~T`X%40juXALV|@k
zkbm5x3UhSL)usPNifT8@f3MQ~*!v`|YE$gpX?a(Se+fr=zi&(a`kmn_#TYh+wHnC2
zz>E`W9>Ck7SU7MLmqDPw?my7U>h*ZyO9ejj!DUPspzk)+3W;0vo?<mUlDk+T1)ODt
zW-in)SzIKip+nHJjPAe>E)N1}s%ts3a3Yxm(#Yhy=!ykh-q{?E9{byk&={bz0v%vv
z?LwuckbZp&&2R^%3F=|@DteR<ZIRJMta{n7+i#!@LS(qzqmL7X$<v>TcVC8IGYX3v
zX8CCNgheZgZTJ)<WAu@WKs*Bji1UV<?eo}2H`d8RRkCwQUTu|beHq;VAU>Fr0Tb==
zi^Pa0Sa;C+j>56YXp<6(0=&UIfsA0hhFLjG-k<`5@7%<{=N-jo`s+6%DLyX_2w6eC
zq%>WT?Ea4Ua+BdOUK=N>ZZ^VtoCj#WYYKs)8Y$Z4H)cm+(E~_7APqya1^}u@FXX;K
zV&Z0_S>5D;M1EhyEVy5=8Y{C8>m;7qY)q-qJrGRh)s$%;i@!G;je<V>8c|8^Q;ccq
z^08?CiZL|gGpv+VnKRJxv}0nfE!-_H3Gx3b`wsZ1itg>34J)CA4G;)@>5;k=CG<@X
zkibd}g0eusAZ>vlvEVL(5(vRX$_)szsk`Z+nb1QKBgI5S3DOq9*A1uyM2txJKj+@L
zAsNf(H~hlvJTr67nRCvxTjs7xQfYl!WAlmI72w_&RqLH{B~q#Q&o)?pYb{<*QZ>|E
z#3DzkKLt6r-#fGE4y;87D^|F6epJ=9TKA@f2pUJT<k`bY*P0kCwd^K<{l#Px?5R!z
zb9KHBHmq}fA{QsSc9F~Pq4K9$`Hv;6>P5*!eDK0UK8NwGbeblcnz6>h0W1%2f;*no
z>Z(kc?1Vb0&n3L@dPk^1KAn-eA-f%H#b85EI-Q9`XT#}?cmRevTMjI-{{rJ*AN<R)
zWyfA>StMFlh;f28-a0$$Yvu&?GO9qgvZ;ZWgUDRoKf@`hTpg4{@?ldcxuy)Cj&uE%
z{sf=!F|5246M&I%sC0FdURY01ck2v2N*fG(HVd9W{)z`pvM~_C8RZWYRf&HNQ^M__
z?(&Hg;6;a0<T)hGF7ZnUbB8_-f(ARR4`gO_5S=NiCd1aEqV$kKc_hYk>FmLhi1?pe
zQK&4RHqdb8P+BD<ywC}pL4dB)u`>#@M6qwGs$*9-EWxM~ZlytiULZHT1Wi4K7F-Xo
z2&61JiqBQPQCyyiZSya_q78A6;~0LVgA2>Ipe#<g_H{LRUlzJULRh`w@gZ781F62^
ztyI-ebCfUZx%AnpXXf)KN;D~9M?+hUc`!11&~u3P_aN3q0iX-f=vac4SZ&d7>2<OS
zS91tU^ZqS*T9jbS``)h4Q3&@a>to)paIH%uZ8#&|pL|p5v=a}|3jTzAckrse<l1w9
zf#pVMX@7rWIf_`Wm|4NTBM7TRxc@}+|NF2x)9w4+l=**c7g3e2YF}?k4lKD7_L|y7
z>;<4nF94E~$b~*iL6=c)5ND>VhMBvs!%U1eTd4og6Dp%|%buQ4!6&Wtl1#GzBuwlB
zvFbxC*GNd}O1~^=Sh@?)My^1<YL{#D1A^jL+M^XOkO7;a4y0)Xy+6ChCq1wf4kw+D
zg;uq3bs~J0{1p2fG92BP_ruH}-}l=BrO-1fn5LvhI2!zc>-lp3%}S!RhmW|*uF^Dq
z+?E`lZkVuH=w>H*D|!rrI*IyZtm3oHC6ekZvg)6-gU}%)v>zH%{s_P5#)}@BxdG>(
zs*{t+s?rL?Ay@i>D$(rda;Hl4#1ESuPrLl(<z5V3z?sx`hIEfm@-juTA)Tc5)_5WZ
zLf&2mmc1LI8DLqSgvSstXy6zTym1h(u7f%WFL{OI5f+ncE~cH^^`+Ayab0S2u4r?p
zn)kT`x5X{-mAENhN<TNLPm@2l8*&QK5nQ&w082+^-k_}ySkz7uZ#z^y#udhc6>=>&
z>%s%=BEO((Hs=c@zi=6cN?!3Zk_lsR$+yJyt%S&XGdgd_LbMYaWIfLog}FP#xf!Z%
zjelrOHmSBKyxBprN!?=^BtnVn$xC8!hN?~Q0}RTpg*Hjc&G!d`9D3tE+zcjet--DQ
zYuJnqry*97rd<<Y6uCbvX$n`{-CpdLscJE96<`eiC_U)p8+gh}-5El_v*2J=w`n@S
zt!Xr5k3)Gtn(`@NKtp+3au?haZ@7vcZ6M@_A>x)ym9OeXrg%J4HK~3aCT|P^;Q47g
z(KickIDEQS?m;Ck{a{H~X94Vwfe<AB9$+Xu8>$V*F?++~zwm$hl8&@Y)4^MEUDAfT
zT-i#M@yfGMJ|5j%zVnr!K85L^#!LL<f^x4BzgVKG?`6k45r0+Dk;~%~@m7|qzp)<L
zN}pSlE<QJ0d66`O89#`GQcf+HF^VLlJv`3&4X#uEsZ<EdK1p(H{hxhcpraqv^PU9T
z(1crOsJJ{^)ugkCo=+Xr08rxgC0!#3zV-y4-3#w%SXl%Ge61A^WUKsq5-^a_HKaPT
z2J~w9{y1sh^rh>-D6w9SYUt~$R#h9G=r(2MZe@7tH&9aUQ2_q5oPo=!VO&=#aM#ms
zh^l;>a;aQ}oLrFWBmhD2Z(E_;&Oz&3rh!jH>ruBR_4n?gJAF~u%7lI_ew_oao!^|i
zw%SOttgYm=-6yA!nohe!Y|o_6W|en=qrp?(fW<()KT%&w)V~@azLcx-=~w#`w(Egf
zaI7=#3;l*G1G3k~M3Eit4#2e>d>sK_@gS#ly$~*L&&9cx$ARO>iO?tQ>4i+3Fp4x{
zTuhF_%VBAhN|>m^T>+S(#Fg^`rM-W_&`4I9^|92GXiD3?M-nXt-m^b}7<fvAzI5$^
zAn<dyC3RgF9^u`<w$#BAypLl^2ole`I><Cyz;G@Mt++nrpYPW992^>7qbk1#Qp9QA
zc5zyss+s2=8hsPIm!Y<+Y^(S|9^RDP-Hh}oZwWq!owy<1fl0|fVSfGFbEpsvmhYhg
zn*(SYu>o}s(Ze06cvk7Fi%{$K09U~_tUJG;d%ZYq1XV*(RW3p`C!uDrFYEBym|7r!
z&tIWt{B06?#}+gl4(LIun>A82=BuXkEb31nCiG)c(_WGEngwupe6#R)e0-*#WFTm~
zkIOhhyp^x&;6AaHyQtZT>!K6o%J_^T++zeK*k?hO9KMZJ<!RT8{l&1Is;<r3_eI`U
zzevxM;||WZu1SO753835;`-)pO~f5LRlQWNHWf>E;y|8lrQ)rfxRG>4+AVpqNzl7#
z(`Tn4&<&-Aao>?$2ch54l8F*w@z|x~#NrOHdIUYs-bfyFJTRFIr=AE$Wv29z+MFm=
zQXc>w7T@|OFs#asuR}Zj_y%Py+{F)f;i_VrU1I(&Rezr}5{nLWBJ)*!FkppEe7Xz5
z=Y)yPcdMqECoEUGbHb1h$RW^0X^p=qN9om%pb|LhY5@E7(kNfzGWA1`K3yVNMA|?H
z%Ed{QXXNsesJwjT7{e~gV}<FGuckIQlr7)A*Sb_~H_;lwTh#1PHE6g1JzKgS27d94
z-No*ERBg>K>;N0kT^P#xYB_o{^=d;NIE-cz<$<ez{N?g3lov0ZmJlYb$Z_QJCbIXC
z;YebUFbCI4Y1Y^e6v-)QYbYydmmnNjh*K@yX*K_)YvZP-QZZbDQt$JD`_t7h^@T?6
zqH_;SzXIb&`AZlfvFeZ}Biz!ODoSd>@*-ZnpsGqjBbpx2*~r)9FVO5Jy`rvl4I>(7
z&<ttXB&My20**FBpT@cmD~OGldGSpNC%xWC7jdI8CQ?DOQ(A||-~$ip9$>&Kp~j4A
zHR!R~ZnRR8Ng_8Gxd4;Br7Cor6rhe(xxG}@P*B`FgUbvC-~>fA0O~S9LlEh92!uG_
z#N8~orpgl30l6rUyNv_?yl*s-l@}=G;lQT^?=m+T(#a5=Trs`|_ua5EPHrrN(we{x
zk)J^MbhVwm)%5-es5l|48A`OEfe2qgHe*prnyh-O@BxM$x`qvdCQNLOEZ4yWQd7UU
ziCr!(RTk4#{xa7mQn}Nvy4d^q$6p~`cH2N^dk}-?SG;NVpn<4=AHwjNj|2n0*{e<k
zS<r+9PsuE2p<}sLNVM?1PHYRS&QsilgnY(zK6Tv{CrtiR{a^Ke#eWLUy2gMwWHo5f
zM{DRaH8jjE!6FJV30HR*x!e-GxgtFZ)qj{cwLsNIvlu0ApTIPhuEB8f$0;$PK-EFh
zPtsCDxpR5X*N8<0svfEff#RJ4mA}~!y_*J|Tk`nP35BIkZ(zw#j8|yE1>f3Je+yaY
znK5Z)KtpVrT>LO_3^#XR&Z_MA22RPk&}Grnu^xRd!8P8*cf{pArmGwF1vG?sN|2aW
zsA}nctckmLwoui=Jq<r@6{=ck-r9<$)H)d)iO+K2fW2N~(|xM$&DYS%PI_7p>@D<q
zEmlS9eyB8gpQ=UeX5fpxp@>P;NA=Sdaq~Wv;rVyzJ*$KU4dMK*o;`{8CFup=5CHPY
z3irK`)wrkFaKEZq?{r+%OBg>4HO>%xy9a7?yB#*@H|gz6?Fot4PGs$;=bK%pdx#VF
zt7e&pwWKp+q-DW_n0n+HIjA|@9m|65(ySAP{oiJoO<u*t%$v0u<Mso5ks2qVVet@O
zjIV#WF7~DZB_k4AEuqoEH5)Xf{Q^w^3H3wie)z)XQW;kSNv0f&Y992NwEdk1!614I
zk`LpP;5yTtN?)VX)K{GFB@cslO+F6df>0dV)I7gnS5Vr_-y7cD_SGlf+Prgq0(aZu
z($+t|+aoS{`LfwQB}EaRG<eQy(6lwfR;^vtdr7@-yta-OtX+m3jfl%G>2fCIyw_Gg
z!CL~RKdIYi!w;v2XWTu1?0%kGxM(||(rW6jyY?jX`VFrw?uD)i-S<Bfiw>xC+8=L}
z=&ld>Ao#HMYF5(jf(=otpBkSlFZIv+`JR7yjB}k>fx24Dm<zSfcbOewEu9efz29#C
zGrmJ|Cp(iy+q~Z0`|_|RZldO(N@vIz9rdBXwKHPd_w|BiuS-aEZ*t{__TP>=wlePX
zmd$>1sn&Ujx386)9DaD@#plv?d46ywEyC+=_eP^WK5)XccZ~XC+qgw%_Xgh{omkv^
zh{G#px@bJ8($-y7)jaX7gR0INo{MNhDMNtpW5>_FF$Sz1Q1|Q1KIKCe9o=zfSJH-%
z-CgGOdE{>lC^&NFzVpH3(Cz0nj=P4V>+>_C>ODX1yjNmV!S+SloRWkEE50+gvxRRt
z)++V7ap^75i56)e42yJs@w9&U#&`Ga-ZA3g@0U-e_}qH6I4tSt-oC5<SiMEm98&2u
z^UH>vPVsXO-#W!wl9HVDmS{Kxea8kheEit6b;$l6KdcRYJoQ!41k~8O#hlbxIqKmb
zJ?IuP>9THy_VXbt+hm;%*f4R85c}(dmfx4HJ9%>Zq44b+FU`#U?06s3?+bptZZ8S=
z<lKacdkgP}r<QwOeQWT&pn~`tXTIGw@OPgpQ`;F1-5$NVUgW8Ip##cA+abt3cJAp>
z{wGa=Yj+Lu96o<V?ANjH`Mv*kML<@@pCcd7{w+%^g)HVtzVm`dIzmS!|I+7;vJbW_
zdw<u_LEdZL8<BY=Vp-!q`^;>#;`1?=*YyoZyw{>d+Ksrhxo?<_<6{m7Y^Znh!n|FJ
z8ZK0C*uDSoXQMxI-`J&N&({N=yyI1tz7dW%P<G7qcc<k{&Gii5_s})_T-?dg?cDoD
zOjTu%u$H}gQD`<uY<n0-s{Pz|`^_OQ^$Ynlal!b^C9PUs-Th1F)t~kpZmBpNf8o24
z_JJENJZv|&UqEWVx@#JAtG#^2(HDls=&u9^w&{?#y=+dOdG+FpA2qNK-?nFX?UCUF
zW5qfBZci0=jEHYvS>A2;H?yNA?%rEJ<hc=B9xY9Jr{$E}Z{F7a)M9Q_$kqnuZk}oS
ztvLFys<-~Zsfn(TqRYXDhy7A}=AVvLzt-P8{i%LNfc>3oR}VFBIkMg4QJW`4o%32Z
z0Nyft(Vznfdw+;~V^5HHWNPb??-XAWt%p?xqc!2<U(!EI)*t$Q%=m=9XOh0jiLYDe
z-aKNb@7o`GewVgc*!5d@VRTyfCqL~PI?SNj`o-k529?2kMy_f;rsLf;5y8<HI(+i$
zxmkfbjt_im{|A9F*Y{j2=%wBfwCZr8&!hDPeK#LLC(BxOy7|8DGecGwuap?a{l0z1
z|E3>!W%@3?E$)Ep#SY2A4_A1#?BHV$iCeU7;;Qlb?Ij<6l4d(}Akez=>%~1!IhL+{
zSP**X{(}+k34L`RRGcdo4WO#Y`(N>)gBRZnw0Cu$`0<t8R-)wyy8VrPnQ2`<KN}W*
zBw$hB_lJi)s7Pr%qI1R2d(Nw$HR{)^pJ+oV-MSZl3SYNwVMP4(O>2W6tr>eX-ZS&y
zcljZXp#FtTKkjzRQt{ovt1a7)%6&a>T$@JgPKZTB`_sjq?Jvz~9JErsFJ`C5w5`u2
zq>b&8y*6TRdBqybOn;N;JfbpcUR<-M!MIV|Zhc&*P1@msv+9ZZBDnX?Gy6LSEI99V
z@JGS&`QW(aZ4dT8)g`5T#CvPj>dOqTHxo@o7!t0vi0FE`-SUyCz2et>?<W|qHeMW}
z8+A8u<Iq0CR<C?z@2?HtxOi&tYXO!&mUMaeFrdTXewLEx*Wx1z2E6lS^uQg5(+-a5
zef8Fmzz=#BwYvO#+aS>fs^%A;Z}-6)p2hyQfnD!CYBk{d4|aC?bcXZypw;TvV=gZk
zv*)*Aug+qlu{0QO+<4hDuuIy=IG?(A#x%Yg7t_sjtiGkU|EiD=_ZDuunceTg&hghj
zyEJ@r=+4*w^wdpuzqF=&Ut#5l{o2muUf~CS*c))`<?Fq@gAevD{HD{AnQrM~X_2bP
zobcl1$cJw)9hG&^^LhV-KXiQG+%SJ)oniByd8|79%CPzNkkL8MH@ZKz<q(hHb2non
z&Z<Ww?+*=h&3%;h@x5kWcS>m#`tjY9&BtACzSigQ*43^h@%q#j^LxH~_Wrosb*;R+
zo4bd8GA_}#`RLchyrU{F?Trpmsm(&}4&V3mt0Ng+kpsSup3r9bO4#MDY!|WUC_MJ%
z-#Xl$5qoSz!jMffU%2YN<ZkOO$p;R$9-Wx++`(qOYPWd6Y0RA7=lta+Bg1wd7^Ygk
zazhuNO8=<oGlE9#H7(oU`%1^Ln~$jsnrpGm_Z{7_EZ~4T{JoXqPjwLu$5cAw#D+H~
zM?chr95_<`*`x2io_Xe-m;V?a-Z{v==kn@lo9gB6x7M<?7#2P<%Q`wk?40E49M|`D
z%jiu3yC-yeF?`9}brzX2T3<e-8@c7~BHP{tPrDA>e6G(cPjsU{?K}UK&m!H=h_+)G
z@1J{Ee$m<Rxc}xqR|LG=cVngKJf<?5=M1g;=?R}7LXx+Bk@Vcm<aGz$HT7ySLYkH(
zN7%I^E_C6yS)*;Iu6YJsGkv?X+vC@dCY~LU{>Pe)1FkmQ*>3yU>&F@<1d8sp{x@%P
zn~9OVvNrlPxjSn87@v(T26{%nd<VDJ9&Gc^@A6jfkBZ(r=RRjbr=@$3gl}5=^Q@uC
zfu0sR|KCe3)ar*dMZfi49YpJKReQH71v`(cg4JSWv8vb{MOV@g&d{+B2x~u(<G~-w
zv5lVLKzN64=OJ{QCdW1wx0)%Z%cjfmnW=KTag`kF=ow*zj_=8_hAzG##LBT*NTo|g
z2sXNcg0Rgb#~WFk$ncx9WIVDLwp$37Su8A&@m7p+@jN+QODC7}VX>aYMn*SUN}B~?
z9LreA;zEl|p!7{SHuaGS1u;QazAod+|0?{T5|;TgQvV$}KKQmApIITt&;FO`HOT`K
zj6aVoIZKJ7C<8%B*UypD{}g*<t@qa%su8VLm#3j+wEu~gg8vtqbN?f){~wx4+3^2J
zo8)}49$m<yV98dm_wx2uk_&qX!n_{O+`qtjRu!r-hYB-=7{MUS5Tb<P!hB&CT*x3S
z!v8V&n}NT%pw%P**^32#WXuqv2?!KS!jkGhghYrc&d1+8q^gyUU@*~~FU$s!K>S)F
z%r}G0Oi-;>b_{@N;5rWFh)f`UlO%KaLW_|ZQxgP5KytlmB*&uU46s{-tQg_VYIV#_
z6gD+vm;ec=@HAmMxX%<OvZ^&2#TWV)h6c1?F6hkwb0}{j2*)51EtsQ_^IBC~YX~tG
z%_lKppaP1c1X(pv5NHvRp#sy<ti?hYhye%zi$wsJO66w?6C}1vBsJ2b?td*{u2v$T
zO3^4uEKQ)iL~4JvrbPfIeJ&E-kQzioUK8@4*^puZYQzWu$eayvUqdkxc`<NO{tW!~
z2R+%Iq=MPRpN0xX!GJu%$qT6=RT-nfjd;q0tMLp*b-96yq?)rOg5+KEASl_691L{G
zxyhXgmRL)sHP4iMf3^^WQc8oyf}#okNCuh_sx^<g%3Nf>CUq9_rhmw$b}vLhYQ0oQ
zHWrDunCgrb`a+G<%u>6?q6o<(2`cBzgP_R&YxWq_p8-`*Lwlm623GmPJZSrGGyPG+
z1e1(K4JHf;0x`@a);u^E_2%KgBsY=40PvtbRt+LTWW~k!R}Ch0Q^%v;KliU0v%vZ_
zxzWT-@!~h(_T~jbI4V)^hBQG!EQrh8tCy-#NRgOKIS*3H<B4oi=1g)CMXS_7NJ8p2
zlIEYaSn!a0(L6ycI)_gTDHWH(A7-PP>?+hztF?A4r2Lm`1K5z85<}|o&jy%(sWcwU
zrsGNQf94u0S@2&9$jv3En2u2<0Gf%xKhns*RHA`tsU$E}F#m@d<Rs(JKpGzYmhis~
zLeGX6NuQkCg^z+HuYocRlVtzbBsI=gluxrl1Tv>pbv^?;U^W>w7&f8)L(QLwKk7Pj
z#nHdkYKBG4-{(R_vVT*HYK~}95B*z`C`etE#<2fb#XJ{Hp~3z?mY<7Jn@0O*lh1#y
z81Z*}(Efi?0I7H}{$l>SY=76M{#`!vGkXXj7|x!#z`xh4R_(7-&c7JQAerYGZL>UH
z{i6~TFL+kt|4~8q!2ev_EYFSqxjaq0G~m!USbdiLmnO>+(K!0rUn`BG5w7O)r%$y7
zkhF-Hhov|5oY9zg<uMrQ8V=u>rmQTg5@Ne=u*)ASb<CQ>KC1lPVp5{i2Th6qwZ-r?
zYE%_SeXlCP&*g01rpn6FLN4n8gvP7I;?9ezmS&<nAAhvopcNxcMJPz4RIs$Ez|R@T
zmBt)pI3`i1p*Zb;nv6jmX@(jF4<&8H0$&7DG|`bqQ9KS-Sp=>qPt)&WX;y%4#ZKSg
zKKe5V`Olo38W@ObZ-O9=#>k{ersldX7`i9nktt6EAz(wx6|9g@XTCHuGqSX#AVRc2
zk5<eRAT*{`N%b5smTg6{{3VN6{WU{2Xw`Hr55cqoBynphMV3pVBFj?U2#cUIWx?BD
zTJct=JQ8xgiCKr1S5bdm$xK9>F^7oVF5@9-$z;LcZz5B-X=A`bVFpy+AETr^&CUWX
zh!F%WEf$l$RkhbhKZSnJ(ELlP_KjrpMMA@%x)@L-S8l`-)p5@+RZVNlgJVp=*H=_O
zc&^u~`@C~NjY9JFmSPJ_)0US)*akTt_cNprcR;-L6COc5m?Q5-J(A^EB}c+wh8NR|
zuL$l8k4uq%#If@3jKR2U4rh#}&?iX{s>;*bjtE6^dGoUjSw110PFY5%s(=^kD9m+m
zcs&_E!{d0xj)F0hE8jrI4O!K3%s=jU7mdQkjOrP{>F6SaV!j1+Wqe~gSDv1hMhK&C
z+#*ypppldm96a6__yqiExfaxt>kF+oRo7ywzR%-K)zt)A@71Y6r-5!lyMb<1SCk5L
zcT{WZiNhYMJe!Y)KPtONt<+()a9eax@fS~bAGgJ#TLm5{ocE{7bJdN9s)8F2-5c~=
zb;q|>!5v?9lAF%H<6bYzs~1P@wzw@DJbv{3q!Ys8dx6dLX)TLenDvp9-<>_yaIkyx
zFzZFN<?1gJ$BEXiYMo*0_TP8U4fML4Kj!TF*T#hZ@37$N<@RCvh>deDG>*HzV%W#K
zCcRZ}{X+lu0vs<lxHoz7o-3=)#|sy|@-7RS6;Dq^?BXsQi_WfUt=9kQk-Ygmrw8nx
zIelM;`QtY2ZCfz@WHV3yy@#eI-#8yKXLC1ok=b>!!KVubedCo^2e$x%Y?FNpcb)6(
zVGrAVEpf15>{#)fez(`;vbqt;)^E}l_V)a}^~Fng?5ttH<^iwnSlNHiXkV{MT|b|@
zGhj_c<c2}fJr1-B{drd6;Gq%AZ<G%Cdh4Qbrd09WOLtTeAAUK_dhYGy%_lCb{Z450
z{cy|BF-?ASTaCMT&TeY0rYs|%kLgR>h)u7&`gW5BH_vVEjs}DlZ+LZH@NRwjp4j{^
zO3d2bd^5FFDzA;k^uAC(X!nG5Hx}IKSYh4bw(R=a-$Lwf41Ou`wbyN;zPmcHk28$*
zBH86&V>wiC_;iLx4;Sn9P>(WO@Qw+EpXSNFr;HM%c+rHyeL8{xfpuP?;&@HGifgfq
zONH?t>$`%H(N}QgvX2wDf)U0jICeZN;I+)^f%Q?r#1UeBQ81jXS-zfly@$HlST+_2
zMI1Rc76=-S9P9Fe5%2v}4-Hwu^toz7FE?*<5tq-pzF-Ni(u7olb$vmHw@9i7>iQH6
zcu%Z)Xu=X!rpIwi@AT9v1%uoUS~bg|DU0<Sp=Jy>;>9!yzA>@^@oKOXaKWAZlB4D<
zrDf%n%ogm2ff-y*f`3bvVPY*Cw?JlqH<YEI52>jMd}l%mT2A9_7_JMgS-vg9Eu5fQ
z!m0hGoJreJ27;c$+sm*}!7=E-a3gbZmJ~X&9|pV&R6TT266i|L^bgRNWt4J0(Usx(
z9D{C3d5%GMhU+;E^<=n(nMS|RP3GTAslatQ9mAa*-kafCuCLH4MhYC`z6>tnG}ljQ
zzlLM*0;^!)oQRe+6l`31ygVm`3Qj|Q47Z-DX@UU^x0yLr)7cUfia4hmB*TJ<>z0EV
z?&NyS5QghG`a>CRWX@h?|6wenv_|)U6EfVw3FOaklRWORlz{Dm9P+twB9P(wni@4@
zA0!6@r=nnn>uOfOl2r~G&gnuKZsh2MG2FtLX1IhyEDhJqMz9JM96pla8csvu;=+OI
zX4o9bLB~x{qZqE|<Q>iM3eIu{h6|j+Ut+k0Yu`8-Hw!kdf-)6pI0cSX7;x<v&v1IE
zsd}J=9R)4Nc%lpo6_TZ^97zx&S%!flG)bwz;V&~hpKHKmhU+<3TBOjg-ph&qVwPd#
zx;gDqDLA<n&=!+|p6eu0GAvYZ0<oKcLMhh?XQI5+em;Y?x)iKji|Nh|1wH30bcu~Z
zDL1aYF2h0*$CxhWQgD8unlJxi|I@uB3R=$T=t@5YBWHW1b`d8K?V~A_a(E|kXJ7by
zXE|3Ws%{BjQyH$|4Dp77bB3Tt>?v3|g~!UUVBwlUJ5dC)py4{tTXKfr<Os35qJooC
zEW2we*f;|%V|1)s1Kwr0hWB~J{SDkGV__96+=Q{5;YJRBkKqF6^D7u$RK0vSz?CdR
z&#Cl%hFiH&>;r}yI1Q~5+v#A@IF?<?HGH*#b8OZyT*u+@3>P@dt!228Gem-nLya8c
zb*zGubNvq)UcnKvGTh3!<a&l{IRkyf@FK~R6f**Ro@Hn_20a*VVO^+nsk~fN_PQpn
zyjso{@;Q7XqhqU%6aP&tBcD_0W`^rH%ZUmh&eDktcXEAw3&V}vdUPvrsr{zvJ_hh(
zRzX)?QefK{uH^=Y?F=vC%74OeJ%{gLxbuvvn*IUWScZk`<w*=TaK4hva3?pOr!c&N
zbH-GLo2oR#_@}Xqe9r088D7dcm!08SPEdz}S22)*42J7DXUtUEk0*Ip5jo0YDGR5%
zY=-A^Ez41G&Xl<fFXG0#JcgUCoJ9F7!^8=+li^0L#k&}8<utcj!8uLrVR)%L-YJVg
zLD<VOoScn6Ww?=RK>@>Ur&a5Fd7G`=__>c|S8%SeU%@#=9Z+zt-3Jvm9Q{KIE-$te
zI|{;KmZ9SmdxYW2UWg@yBKD({Yu{0Z8@L7>W4Nt`2Y~-^mZ9ZZc7owfZdv%5LWr~6
zNrsnlbUs(gbA3Ttgi-rVH6+5-M^-_@wd@Oq=W{JP#c%^RyqspZp7V?|45xE0p6MUp
zS(Z`C`RbPp7r248gyA-hK`FyEoS<JRbe?ring2PKVdPryHN#CDgYyixJ|iR{-!NRy
zIpens&*w~ep{o5{Mj5MM;TT_3aL%j0W4M*m+$Dx<x$>78US#GNUtt+~&h}T83Y@Q8
zW4OTe8YjcG++25^;RYs9mHoeG8Ts6}bA#a~PSBf5c}_z=Fx<!q`agwE%}LoT{HPG(
zx`&J57S4&v6$Uj43AY%o<4kay;U<pGPZEyyTR2t!%qrw_gnnVTg;S|A$yRW^;|?od
z!8NQxp-*(G^bhbZ%dm2i-eb6y!+&MCzzKSv;Wo}Eeq(q=wSh}b*aOkOCziCovwR&l
zfK@Wwz~O%|T*LL+hYT;``2WdpE9Xj&WW1|j;u`XpRnT!h`9xek0P;Rn_;8Asp7%ta
zj&ngbH@Sj_^Bm>=mxhzqos~Cn^ry&VMhc}Ip;wqd`J6|+%5W#=IU5*m{8D^tpt?(&
zLdhC}fyL1*j+JB4e}jAT#x!e$2whoCTpm754^_6T%>c(?nFbSG$d|HT=ChUR8;{g1
zuHZ`fR4zZ8OYb=%zBfqS**pt3lSw9?ePxkMU!e<el%G<(htaD7kJilh;L;kFR+@)L
zN~vmh#pG3Vlm_qu$m%jH*`=zX!ba6FAyTCmTB-a6r(1xK>J}(Oy9Ei|-GT*Aw-BL1
z2o=uZuJ9h*^o|uq2!n-@U=uE!cp4$ZJsl;4KOHUfd}<IhPhS%5JsBgMe==71^vO8E
z{$#w6_+*0c){}|ClqZpb_Q@pS=Hr)zlaD8N7aWhL2y-95BIq8!D%^iGRVaL96rR?e
zCgdNlsQ}?9nYT(_UcV+*T+xTpex-eXLry6o#fm+jtAPrFQlIe~{Gavv(`T~$?u?-P
z%x{(aO18o-{AA7MD)K1#<GB1OTsn$N^X8r_=dbtn8l*HS^>dk}qB4c0l2%wN<$a6E
z0-|fE+Sfh%bk*<1mM?3H9`_~XRXywsNsz4Ks&G-LTT5!zRvcT&x0O)!s&38e4gI1z
zGj0&zdl{@)T^7q%HF;ZET0tFLKFFbZ14SWYqi4>YD<0CT1Ifq*f9lm&yleNw!zf`w
zor01H>S=0o;=3{}8;c8BT*_h>i#^P8IW3EIEDmFFB#Wb2Y+<pL#Woh_v$$A}%|aOi
zTr93+v4=%w=)+=P7W=U{jKz^Gj%INzi!Cg+ve?Grd=?i=aX(yWWIzRrh2=714U4rb
z*0DHjdBOBo)IHq2CU=_linh}<-%e4_4@6v75U0&hx7-}0Ru>c*)zPg2<JeOj%D&gZ
zJ>^lv(zTc?Rc@3y%l`|4b`x21^UwG$N--TWh2X|$Ih8c)z4w(gqt&V|E6-?kY{1fN
z_~^&d%7kiC(u}^=Q!cNP>6?YhhBBbcv=$9ZvkEtrG!y8NlJ=Gxr}1Lto62d2l5Qra
zeHyd;=5l(il5Rn1ti4hdfVHqtNwXFfD`|~Pz^SCY<n%T=v=YI+p`6ZF(v9S_p()E}
z8j4lY^^i|%zc>Y`FIT9fqjwP88_4N*=)@*U*OAjJTd=gJoIa?e>&j`xMDC5{^qH2d
zd=oi+f==#6aQ9(r&na|HC;=^{NGMYZw35?Wmakm3t5DL+M6qq;`n8ye6ai{64W3Z)
znTGc$>Duh}$9V-{D!QqpJ!ApyD`}<y4?3;|LAhKwSSzQ^awK@PbAx{um@Mkj+69I<
zwNE3jz@<^`hWPrvv0!$Tw(Ij+-SY*rx2j)rYZkI(?p)+)+YQlH&lO8PR<{$Qx2Q)H
z^x39<(M=V&R9t9KHx=`Dr~?XiZC97{TW`>saX2$w^f9DIrW@0v(@p8I>6Y}kbZdHI
zx-H$2o}XTrUX)&(UYcH(?o4;3SEN^_3w95?#_nU++I{UhyPsWe53?KWk#?g!+HSJP
z+Aa1(yUp&f=i7_zrS>wr)9$iY*emUV!^5F*ggFe3NQco8?JzlF9cGIo&S7;FJ4zj8
z4yVKAsBly|gba@iO-5LTAtN%wm=T>}%81RdWW;4yGfFdHW5Ec4W9@NZ<B(Vo10t_+
z_&9tWI)@%ihy^hq>NbbNQRpa=cn}Ao?~|d;&}I0UB{sx_SXeU>GX%X_pbL2(DBveC
zwPiRm3Nwnp+?63@`ef=d!!nJTv6<FPM`lrGS!PA1N0v6rFH4_g$coOgWW{AAX60uU
zXF0Q6S(RCuY~O5sc4W3GJ1*OnU6@^(?aCH%d~$R-VL65zvoR+&$C~5FDat9!smSrj
z)#m!;8gip^ExC!g`MJfp&fLmeO`dO_J})xQloyw0%PY()&2!NeJcC*=lDpV^Y&u(*
z&1j3YS#1tmk*&;DVe?4RCix{9lA@C=Nr_4MNySOdq{<{svTw3JIWpOl9G7fME=(>p
zC%ck`6rU7bN?3|9B{s#H;z%h<DNCtH@krIC`lT9Dqf;%ZiK+Ri#i`EJ%2Z97Z<;<W
zGR>40mu5>VOe;-ur3vXi>AG~k^e}i(EIh{nk12zvc)&ya;2F`9N02u-VI~bsq=$J-
zFpbS&E`(KFu!s+=5e93=!Uzs1yDXz3!y{9h>6dB9jLx)VCT8Ym7H2v$D>F4&zEE{!
zmI;csWff+XLd`<9Pqr>QEZdkJn{CZ@WEW+ZWmjZ-<Y;sJpycQrOHN`=eok?YGp8~~
zlk1zS&yCDA<;LaO%(;cRrMa$LA<rjImlu|2%!|#l<~j0;^2+im@&uz=NF`seX>EQs
zgDu)-u_fB_ZN)aHt<t7R@=ekwMJAb`U|W&{N_Hj*$(m#xRBVKbEy?-GMaiYf&g2T{
zSd*en(We+vgj7wcE>)juOf^BXW?O1eYAIAJq-oN$X*wv^kY<E>tx#_fRI5)npi^4W
z8S|l5C)BDzr_-aenV?py9nxWPjzpw~2@NTcFk^Iz38u89#KD}2DK?liKcx_6Elw$g
zX`Lx9n70ywc%*8~sXnl?FC_AVOkuEhBqWQ5Y~)yK=`mhE;E}*$;RlY?LU=-1stdm0
zk>&$$@JkDWKSZa+!XpyX9Po+av@&=_Wts>4!dLQ(NQ^A87*!JC8-*B6$}o~t!ascM
Rb$#I?VHiB3?d!eT{2#Hjz61aO

delta 115297
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

diff --git a/ShellBinPkg/ReadMe.txt b/ShellBinPkg/ReadMe.txt
index 788922d225f5..8b7c9f130b03 100644
--- a/ShellBinPkg/ReadMe.txt
+++ b/ShellBinPkg/ReadMe.txt
@@ -2,7 +2,7 @@
                                  OVERVIEW
 ============================================================================
 The binaries of ShellBinPkg are generated with ShellPkg project and built with 
-BaseTools Package (r18507). The binaries are built with no debug information 
+BaseTools Package (r19307). The binaries are built with no debug information 
 by building with "RELEASE" target.
 
 The following steps can help to re-generate these binaries for customization:
diff --git a/ShellBinPkg/UefiShell/AArch64/Shell.efi b/ShellBinPkg/UefiShell/AArch64/Shell.efi
index 056da8d2932a4fac21116b5ebdcaa12515d3e9ac..76b0a03f1010d7f34b624f7d4c9de78e80c28619 100755
GIT binary patch
literal 873664
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%0Djka2~PceA@>9e
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

literal 887136
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%0A)}Pf*cAzE=SwDZ!qY-K!ZxAE$o#TKX6oKjI
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
EA8FRkS^xk5

diff --git a/ShellBinPkg/UefiShell/Arm/Shell.efi b/ShellBinPkg/UefiShell/Arm/Shell.efi
index afa91c4d6caf9be464a61a068f90438028e0135a..4d95e0895184b4878876c43834ab477d90e670c2 100755
GIT binary patch
literal 769088
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%0AoA9-*TTpEqoi$Ld
zS_fmWpD_F-0!^OKI|Xa5t}>Y!M(5WK*<Kia=Bh1>v|UhQWuRJ(wbz!Nh0vq$G~e37
zEQC73(_FP>XCag<da6`gf-KlaKjt`zcCTrwiv2a_m8sW6&hN=4zLYiaaOL62IZAk5
zM0H*ZBd9dVZH8h@vaP3MDi6Qnf{zexiW4;ioEl4smYlFCI_!i+^N&`>08Oo;8@a(_
zIvkBd`?#iTN34Y+`xrs?!lzF?_K|`L=!KtzYFG|ONf~w10rqDjpD{&a23e^vUJYDe
z^C$}ZlL4pMq6UAWTSI@3s??9PTa_qEZ?7_mHCBS{fW)z0A?AwvV1b;(R3A_?^BH)(
zy5uLT;@~;r0iO?Y1QR_ENs}%I*x#hjo}FhPrkyxe5iPtWnFoFHq5@B0iE!pH)i4k*
z(};LAhEg%BS>5U70Uy!MEU^rLLRbNhH^%sak})81fHn9+#P1^bILV|4n*ca#t@*)L
zXbcI#=6VZOw{UV4OqQhZbQL#KQ)T}21S&b8>cY(7efCQ=`B|%xq(XImxS--p46h<+
z#>1>Q+O%zn?t_lY<a$o%TdEQ-p5!SY7VgAK)zsKw#&VYWuq%2+B_zwj46O@<^BwjZ
z)zdwxh_kg+=W$@RlCVUU_RKDiUg{XlODlEW3r^^tg$S4p`lgT0uhbhzk~7xWO2f=o
z6(%N|D>Y%zGGnYPgOBgl5xAZoYMu;d2cMnx5d6Qx;iQGcK>hhjOw6+jgY$mOwy>@M
z33!J2Jg6frLX7zu|6;o91ZcJq{9o!;hEX<Gn6CgX78XD`gdgHRfR?#Jx$~=5dz24O
zSdLz<x9kHsLw|`mux%2&>2Pnx-L?t7H@NRaFR*upH@3wI*uh?~*`*X_rv~h_3*Csi
zfG+}gGj0GlmLhsQd>vtAuBHLy#a7`Rb|c$Yn9NETg`3~Zr;3x|A>)NBc<yaIHh}?d
zbE3C63;+*iwa)CQJOCe)%F_BDvxrdx2m)2I=96SGfGx0fuzn<ohg&tc^{xQZiVHqD
zf(ksjMIg>EM&pY@5eZA`MKtAE9}~o68f8_SjD<7>i85RSwQtt+cN$0Tg4lRbD~z+q
zaWUnJRRGiMCZi+}!Iuto#T4$a5eo+9C1b@dq%{Wv7~?^Arz&GhjK{A6%uAO@_bchH
zFqP7rG@+kWE5}6?h6jW25~k>B7Urx}B@5yJ@;&jccgHVUgquXxnk8dX(4ct);ikl7
zIX0PHgD@nUi6T4IrzPytkS)1{!n}na97E`;W|Pv0N&S$+KLrm>@HtsszG<H`e0FOB
zvFtEJEF8tRUb#%x>uxFy<$M_pu|dG}ArF?cO6&kQ7X3{XMMH)q!<1E1+ThX)V8w|{
zw2P-vul#Y^tN`n4k&>0=rs&euq*06}wN-_h=>h0Hjcmw7)IsYBGGiVG<?po_^-pW{
zZni}$W4LSCUmD|d_8Y|#dXy!DirFW00Rp>`h^qv(d=Ad{kZjBr43$wun*=n0=xxGy
zWk;Rm_Dd!hibfx4aKh5`WSB%es$|xhvJ6JA5)(!3s<D<}9O2?AC~V{B4E5FO@k;%m
zC$wtnXaij<$TM(*F56TDk38ovmR+ynafM1(B`U>E9&}+4Xa=n+U=bsOu1VZc5M93q
zPN-yMq7v{NsY-}WrnQwiv?~k&USv-9T#b0eLq<&35QiU59<y5lO3{((tTBExw0=!8
z5b9O?fD=8c-@WlsW`0n)-W``{w84qy^E6&xoFo2*^-GoZmuA}Z&DONfbB(~9?Koj;
zhCD2JL2EE-M0gm2A$X78<Oh-K-nvBhnlztO$hseM-k_-g8&LObwAmcMgFKa?mTU0X
zM1y#{hxE%BY}{05&!=j1=#!?@5=UeN0CI-0&ZFVAYIseI>C7ynWL&cfgGW6MI0}f;
zpgtJXQSb&*ZRZgrT`^-ahbv_X<rvSS@0vuv(CYUjbdri#MIleNL~t?;^Q9Z~Sg>U>
z*(<_Cnx$<9!zQJmFx&bMQFLPt`eEU!VzWtZVT8?{0%-u{W<1Fa8idER4dVbhz{|F{
z+rlJTlyQk!IbqWh<a8<1S^PwtH)-oKW*vIG^iBA^+h+e5h#;Ubbp?sf<dB!!FOdBZ
z6yMuio<a9FHLhiXetKNQY8mr{UD$yHjT#Nd$@}W;yH!p6BBVnz=0`(>^UbqWppzv?
z4&66$%ylO@H_VAeCtH=UU5IQ<qeC618BhecK?%mkdCP==EJk))+yIb0a0K+DT(fCR
z1jlzehH3o$6g6Uu+pcKrR^|It8He`K9Ft%hX7;%69kb2jz9?+W({Qi)!)^>lmCKl>
zU<S?PGFa-hmKoN7-dNA@L+?^P(t2Gk<_)Ui%^405X!sSI^Zh!-H3F1#y-M=F7PUs(
z#$at?ph;TuQW9RcUB4cdo@pU7te?>RPSs?1QrMvH7ovu2h#o6`ihw^7cf->JN3YPN
z<uHB(=rGo3wy+5<@1Z{o9mJ#GIA>?_*^}}HVNF(?1{6nc+U*cx*i8UC#df)r20a=6
zdOBq)0U+gi98r{Xrw}(en5KYM%xF0aA16je9e{r6iU&@&GT_H&Ri*%)l0qCrA?q$>
zwceqf;GOq0V?AU4jP>sn*Z!39aN`$~$hdNlOsXev3RDd^hv5X%N8g5Y%xic{fC%q^
zy*&YtJ~hEal9TWMFMIFWq(^b(`)Wt*h!Zg<&O5)~IuHsmW+W^L+n8ZIA#@oO2at}s
z!N(gs1V{$F4HzT9X0~7NkG4P8S-<)}|6VJzvg)a)y9JCv9qN8ARhjF4%avKjG3g&B
zJFE8(Vsya!cn(AjrtSxvmCDKxG2g<JMXWytMtVmNr;>f9{Oxon?U+McnZ~pyMn$}U
zkyqSKxcNm`4lwNqMf#b}4||33fDl~fX0ku_?EsDHhI~qs-{ZKJ!*_U3yMYZgWJKyA
z3g4-%`Eg7yc_a*(ag0Ob6OcFJcKYzK{<82KCr|oDd`rxNR$rZlw^{)_W>pRbCp5#g
zwdz>xKTf1Vy?_*FK@CbG0i2rrZhV6Ha1Cnt>CV=F8TXq?l0-C#5e(oAglgeArV%T7
zdAf;XY6dV@<NNvqnVq@=i<6iuvnV@w0LJZNnE}eKya8(|bK6~%qwYSyvXB(9-c3-c
z`ne{6a;g@~7P+>b8%CxhnX+F|CAB9(gZWwld{zugbafKLY`d9~Dej%^p>%!ifFIwC
zWPy;XPZ&`u2Q(G3C~_$VSiN2PqPi&*@VXxwkQ1t0aWd4U-7G&3NoEcz82lw9dp+J=
z3wYq;ls=#E_)@47<&dV3l-1lFnEfaSFuI|d(tH*kijMcxH2vMGRp{Q`1f%i=0xTSJ
z4fF(_{D?~oPp0>Gg9Bt>;JmV^re|O4NV9u8S?h~&ug4%RY(QMUuAl4m4mv}#WxzTJ
zTxkD$s^w}&dj)4Y=~}%~-KAD&vQCn(zO6BK<f$}AbP!iofGAIL$)yli*p@=1QWYK>
zql1;eZ_ym5rH$V&-Z$_1$ORCMq8a=7q;-_Vl)cCb_iG6V7#3@XSQaTUskGklSS|v1
z-p>nr?}V1T5JUVf7LTTCAl`zCGP4sl^tbHhxg8hjLdH#F(HVrL%dW;v<PwSp@VaW<
znJ>E^G$7KhJ`o}X6{(%aZbW6zT1>0+5GOxLdk?*_y;lN3I>Em&dq`)<CPiDx-Id)r
zhbQ(>Aq&AEHk;@GgO7WX;4yk#T4y*MJD!Db3eJ2O?`*vJOkJEGOoH3qf8s`#rq$3I
zjP#O#MZnC_tP8%n15IfsTx7%&06c7~wyt|qxXC!0;$Ymhu<0QeI8(WeV0t~&w=Ho9
z0<;fbxDpthP`)45tNQa^2~IUs3WX^ADTal$7L{BhUUfLj(<vZk0XQqfL=Yrb;K<Yt
ze+Uk_PK5;Iiy*SZG)vPg4Tvq2T!ABlBi4v9!kp72kb4QZJ{426T6*dMKMb;94(GCs
zMv%DhtxOV%nszR`m=+d6(!L;Z7L6s$M!L|Oa5YnnS6wR*E32*sg9AuVPKnHUP{B+&
zVa3(J`L)0t+4Cyd#fUI2Mi6v62#b=CHt=8^+dOP0lmH;9h{dOl;=O<tF@vAu^wiX7
zS9j}3SHr&o*_%<~WHTSG@w<YExeZSoL>w^PkE-EOgz85VTxx#c0o5FDc`u54G)6ri
zbo*O)srSSG>;04I{gadTA5ZT;K6(Ge^!|(8ds9qXAv8u$vu^?}ezX*87=i9M;J6=<
zRtO0T5-R6>GG`PJ<jZ8;^(b8>sc9g{JP}BWQTR=~@|^1uFU@A0PdD3>N%F`vKHV^v
z>3O=jz=;$U)3_fm^XhbSSrIda**Bx5A?GvS>Y-MxKIT1m7yJi-I7ac4$y}1<Q>v3|
z047`@@uoJiLifiJv?o93^0yy~(LE!04ui(B&O^RA?gza~sYhd_mFVj6bj`~<UFETw
zgviPubxw3zKiMrLKKJ0rVUG9e;JH&jYI~iXR+Zs|L3|{0z1e6Kmg444pOe>ISNF+s
z)zR>(*NPN#)oa769tLOe&RA!~&|LelT+8EpDM}F@5P796Jr^^8Gc^_pdKCUh+mJ7n
zVhO<iF+RzlV=e<!n&dYai`Y7^|0E<5M^1HJD`euQ>7k&R(wSoSW&Z<Kw*#w`;2RBI
zIv+f7Yq^=9Yc&EGnG1_&Xh&gW3+-Ac2^FgSRO7V@f^=^YqydvU^EuIp6csJc-gje<
z{!&Eadj5YDV;cjdKc*kEVC@uCao^`LF2yI`=P@()ObWhOC`fSJVvv4cfu`(^R$8i^
znbR#Lf*7jJN-B+V27=d?)`ojNdZmRUnO-U#&sg92J|iG(VN&7eGb$vlw~jxDvZVpZ
zARJYdOA7!<qOH8vvy-bTVzik0Zc^_LA{tr3*`YELV9lKKp}(8>0}j|4--*L!h}RxO
zi3htZ?(n<+CN1GlW4_}_j#_#r6wBO~ZJI-sqeGn!gNrO%=%EL7wECU=g@0eXa8|ga
z#Z@Y{@?wn#Ro>5n_fHFNpiyFrUr;io-t_9fM!F84WCi9JTdLGzjTO+*p;$K3xvTLB
z6r!oPVz$Py=YyNT>w8niT0CSAUEi@~;L|oQ9phAsF{i-`9)5TbUQ{iFm+l2G>(#^1
zpW|3rd>9e^+o55v$Lm(V>J==Z<uyrJGO9aq@9XhM#G@GDR{Su^QOvvaa~z(6xR63=
z)+gL#jgRu902D29CH#TTRAsPL`X+5>g+uY#dl8M@4~X6jZ#{;@aLmU|dzX(LaM30k
zcgM5eJE12Bh`twgi_`s-aS}B?+(C0cxCs^7atR&|PmE`{GWkxGkcfzghSKYqUT_wg
z<;DruFUMH#|FkZinFDQoPBmLa5Qc-oLY9BDSc{kORu$&0TsjI`+?wR?UdZ8ZgHmr#
z`6Uknb*9NZa7j_$e0z!KHgA+^7=9IS=vsizwkX7a)MJSTh!Ium-A|SA6%>bA6~+Uo
z(l(Zg-vr;m^Ufp@4|f>^53k^;*&N$439qrm#K~Wt#D~0E)*NBTk_Y`G$PI9*)FbN%
z9ji^udAGgt&I=wDt;iAiK#MbyiB$=gfH;zEU+IU$A16lWkCGe3K3tnSrqh&l&N5py
zp35a0+O<g$T=(5xM)4i{(_ajhMNa98)RX2S9Wm^bb56CaNVj3u>62bWRthT9o#EwH
zYHwK}NF~r*G<!+GS@W~pw8EXKb8grpY#8mdxf)}PQqwk60k_<av7E4F(4C=g3tKPW
zTWDY^r^cXPGI!NXP;m0r74W*h(<(LKK(~bN+kgsV)Z^R2XeerlAoW3br;$hg!Gcsa
zF-c0#XWK$u6(J~6el?k1Y?9%Ud34~73#rd_Z>1v36lh<Y?7=0KAu!XpN0rM61JK!Y
z9x5uJTXJ5x1%uuwnngG%K+6g&0?=XCTTqNX_CYB>?`&alSA<ni@?y+vT@rMBsuLCs
zudH%Qjk#@s7h2ME(2_iIqN0%q=5#R1@)D_an)Ww8UMlstg=I;n+pBKHoIOS0?Cpti
zq9R9(%aOPDDz%`b+WtH|p_OP0ca7s*=KHnP<hMs9fw?*ri~R|I*JhdX;qt_1^aoDD
z{n0${&SqJkCpp%JtUZ=vElCJe?6G9`cW=>D*#oqW;1^Beue<@Tk^^J8XgNzTi~gjB
zT?%XUm(Z<CJGwb#>I)7Uhu{4-nIL5nT)kmJ*yBH@9@kgNvc(b3N^NV>Qtea1f+VE|
z@f<}b#fb^m918PX0u8T9M5FI7PkOU2O;-e|g#Ky4Xl<?fGPX+3ozUyuC`Pw*H6`EO
z;ibZm;76mM7W9`3Orq1fkyKz?DS59KK`M3YT~7;EQ+m54!KRw(`zfAySL(kTV=Q5m
z%{q9`FGK5f(i>+FKtXl+0fqfnZ*`V6+3^cr(RYgiSSVs;c7X~q*?JdSWnXOxm|a$F
zE@O$Yu4%0V*VEDrZz-vaq<Tq;u?~`tl<1tTLcIo+_+U8ty98U#Bq+Jc7Ppq5Y5__k
z@w;B}pQ%Xo!zzFLSQKN?b6yl{iX|wh`eX=HIR{SxeKiD1^m~W8zt5!|kuaFRU!!3J
z2^2Gcz~rpWWcQ9)qwA3*g-SDN32W{Sq2>0h%xguH2XXg1QB`uM%9W_}(x37qK6x~K
zr&sPx;c9A&U+&hIJ;z#~imKr%ue=dZQYDjV_vv%g1X%@DQN<?O&YL^`9I%W>P`@Bf
zB#pa!BcPD$qg3=%JHsS@+4MpfTdmE{yD+$S+`{!jP@_*SXf&MnXdKoP0k)#^a#;$f
zl!(Ijw(HQcdp7to^&fST*uBe%`nQTXDckS>c}21%{UeGgwOC(8rSyj6johh9Le<e3
z9@X^~P*Ap!t0wHo5MoTlR*OzwsJlGr7b)zgQ_2qpntzTjcwn+Dk)n$@-OJh4xK7m0
z8J6kT(nhwUm+EECV5gKaSx;H*u*P8rleQjvjjHAj>Ai4;K5bvNaFI383~3Q+!D>wp
zG=}APPVX#ZflJ$|ur(!aDSK9VgEA^YU5<4c?6d5rsB|sf>(%vmB?|%Nl1j3y^L0*#
z!sFD?K2HI!d2($kRp`zZOJ8w)x}pt#$9#v=h8M~82z8G9)Z^me*bz?Y4eucA<TVM~
zvC1uENeOy9vJ*IGcaf~F?8$!co5BXxE}yxEWW!Z{k8Dp$rAjQf0wz)n#`<XSE_-@g
zYFnm}4p@Gbs8E7L-*VpC!6I9m-9F62p;_{=miN@H+Lxlnc=e95`z}|*pouiza%3%s
z7f#NMv2lWC#4|02dMjhub6M2bww&}BznHlCn<@6et6UD;KA)seIDvy~l~%{<0hsWQ
zz3P;mhygP4atRe4e-iX{pLDyj2|gKb7$Vs+L2Irv9+Y7xD}9;tXR*EvJ+SX|Z4t9L
zf-^O-<bR&9L53X9Svu$TD`nu96J6vF*h<V!eN(iBO@4^y`alJBjwQz|A^687P44}e
zWv)Hdu%%DW^>3%&2+XC?{7(9t-o4GAL%EiyV}FFDajhjhSpiuM(^nQIBM<Ke8QB%?
zRKM7`gqdSH-duwfEn!}?_4AOGFGEkz0Hl;I8g$*C?#BrUSdt)HGN7+n%3-u!f)_1+
ze>!x74hNOqE>5KuG)x=(GBO?UV-9-{nJp5uvE@{DA{!`wcOLl3x5E`+$GiJA{++~C
zyW1!wt>cG}tT8RH<LlwlT<$5lyPpa<#b0Fp_++ujO3?_Z?<wv)u$G1Xz6wX*k5WoX
zc1F<KU%5jEP9tYTHmWyx`S3hCjOhM4j((f_(Fyk6R46=}I>H|AdejW>@y`1pweBb)
zf<S8Lr=#Ng+*Kp}!w#roU~6tG>=_REi@vm7ZW$e5iLsTQXY3c#7k@wdt<EMp=iPC2
zGdL}}B8jTWq#O`YLS_4sy5Fw%sCanoS-_4H<H095b{2WCL>}0C1>iW^pT+;>jd!4i
z`=%g*F-=!qR}ev}_PubP0VvtnZrM<G+L<KGo@u#+_(rr1lB7~Z#GJem_&6N-^{z;m
z*SOTk->>6a{yy6M{c!j9tKDA|?v-GoHt)O>9VdS6VkG0gQ|9|!yoWwHU&3;65(&a7
z1-yTY(Oc?n?-&!NX<R59-VRPOvfOtsqHA1Dv*ALiM`qlIlY}ttA#!515%=HUg#q<s
z@7f-ECBFBZ{AJ#oK`GMp?Xt<0awbUiUxFIn#7HveIu8Q+AR|EKJ}G8Un7gK|7-z2;
za!1QKL8-ZQ&I3+lZB7>klrqk@_0)iS4K6!`IXp`9a;Ldd<1y|kO=AlP#9Zi5f6x~}
zMe$Mg0t)u?RT=s^zRw@YCV1BEzs&H(6aq4%l9C!6<mPp)ouG?eCEaSPDol?GM3S%D
zAsH=9rlnFg%8c+(eKhMBlThc+7-Nr4N}}h`eG>QdbY$Vc<p<xf4W7ES@=Cy+@a)64
zO2ix@(s5B7TA&B;pFjw>C@omB=0!N`7}h{mG<j0t^XsFq19Vw3F0(O{@06Z0f170b
z-um~$$pgZNdhYU?9&tCv9g0@31%6<LRYeMPVpyG_f2|dBX7sVm_rnXU&3L?{2zaqH
zLkOXwJapAlAFyLUp-xxMzawlmy$LjQEmEYrYbOJ*)jQ<vr&yh%ppC*<mkxSd^xmZ#
zOJiI58_kxp81E}VJG9y}j5Py%M!L`Ez}t3AUYR!A`bm!TxIz`tCZ((TU1n!yFeja6
zfx`(lbZd1m7teAuEg;!*FOO!8Ws@ZwL|<HRW2QO|ym%|<Q&Z+F#?&;3Q5F6pi>9q<
zTK}SpY169g7&3~`A5Z1IlpJD`#I>i!8s+3?mnrBdKuZ!l#RQJJc+vXdgrH*N*T(@h
zxYY=PdGS!#I;=FBlAFY!H(gNlRYEgIlBZurOBh<(p@rBbc%*20BvnX5)lRNi_OFg$
z9h>lXonAnPED@!MCWcb!iRQ92A`hacuTl);La%sK@e%}<4#`$RDgA9_v-%Y{$DER5
z6700|8hOd9d%FpX2y|wlHypMuZ=_KbxAbzD9;1b;Vx_YefehLipSevI^?C`@BA4$@
z44@Jlr?E=juOTk9)UGkG78H+nkc>K?mv%7B<xkOCM&0I`JO|i`Ur=5+)Xv_PT8D8F
zJpjl0C_l#!P`KtHsqtEF1oyE_w*E1BF_zNN*^oU2h-wtCx7cb~1S^%Zq)joWm4DR*
z5-nQb>7bYMFzCxz^C-N92btEw31u+pU<=nAnrti4!2{}ItxJkJF?z&dB&J<zZsAGI
zq1Xyf6pbavWS0eVQiaIBQpMK9(2Gj8Q*C7dS|L5ih>vP$?fIOqEsd7q2$h<N65s@}
z4`+;5xlX*=9(CozYZ%#^0Xe>$IZScWWxqBm(!s)4{rIQO*Xy7KK`%WKUG*FyXiXmC
zS?frO6N$3)B(Yj*S5zX4r}%^&d009f3!!a<8nvZ&w!?UtAnB+D;p3e(Q-0slk@A}I
z`?>7dI-M?$*OF3Z>n+sFvu(@VQzor}nXAjbCJ*LwVP{)-=C+|qCLY3Z;+8x-wFoKH
z(I;vo$jn}C2{&Wh7QPlP*<vhgeL|{B-twDOBKuj8D9a*aAbHRSxcZsX^V&1Du=KG{
z@&J61)Ee18iccyH)ouYS(9$y5TR>uGd9NO4Q?iAr#}|!hHE=#dR-J4aon562p?j%E
zYBsnNSkA2$W8hs(<yPa-W!Z6S|9V9ueUQgv1hQZX(NLzvA1}YpqKvVtUZC=chMaA%
zave1@<c8(R9<sD!6)R=K^7`2xhz>woXsPI(yW3@*%*%S37~YX(#s9XDnX;$D+ICI5
zo~nKsKCpc&sE8N!T-3LFuZ)DZklD-6y_fjBE<3=oEQ=}4Y7sf!d4<;cEM<1>{LWv{
zR_uwY(#~C^MR+%DO{b|Bn%v(}qi+NnU7r?|Lyd^!Xrb|Q{)l^CI<X_;XtmF7h#xs5
zEgNuw>9@fHs@{%m<;#<A^Sk)2k1$&<O12$8<ybAHnVoa;Y2s2H7LClvH=B2KG?cUU
zQQW3Gd;D6c9M{RK^VkkNKN-6u!<l)%mrkSbyZ<IDfZ1Nr);^G?w!+-f0NUifKV(<X
zah02%au&GW?w`|WRD!<VX_9eHh}x=$d>9@=J8WH7cFt+;dRL9dTb`R|EE7}tL7zI9
zD5=Js2@O|55mhOw2eqXzh1%SHjS3Y4UuU>;W_VpQqV)dTXG(hGXSdFaetOkmZrR58
zV#~;PklL)ZW)8@{J3Y75n67aMDsY`;{O`9t<;Q(ZKOXk;4;)SJLts9QWfKL}ZbrB@
zg^^h%?L%%A<=2jP=|><0CD`eMIv1vwW~eH;)>`oY!~)R0SOO>9Bt6jXBVM@$ppLY*
z2g&y@mD6p6(;cWJXSdO(Cc=1(pIu2UbmH`%i-*kgt~$e=Q7DaRv*C2tH^*F5tj|_Z
zhkGhr*&+5gvCAV1{e)uBg7N|1Wcr+8X5E`%x{gL&9!sUOD!~fJNL^J<!a3xODqz+H
zCih`;{k(8xd7@aF>E@_}r&Jc#%>svMq++sCQ1wL-KEf4ojNc=S$1^C5b+QIkbj%3u
z*>2tA-reaMbf?&;{%yj*N-gW3{$}rJpZ2zMB|TM!dl>juEC|!s&!EDKmi#R1=t&mf
z;kuR@Qa*6(ddiEI<<=ylEhqp*OWQnpXq*D9QS>~6-m2k98VND2FC*@^oOGC}joOuW
zgos{V5!S{%L%Mcew6pESu3W=X$+B;SfMPR}<!)qNUvF&A-)|W8W0$Y|p4xt}d8F``
zz}naP^t*gzWz$Yj9#Tq>N#fahT9weZ+T{80a(zE=uUFo~f_1L6`ThjsXQR*et><@6
z|5`W^=PaxCn1}pT+Q|Y83rV^AjagLAJ-8c~H97SHzY&g;stAtIt`g;1?&+;}EQQ)R
zQgy|IDkEia9<6Gjg4n(@!Xvh;VKxKKq}Rgsw*y0OV5UEpqXZnVpXLAokF^xM<9L6F
z+w)aX8a?2_Tsm8FFb=MAWsgvhfM=cnT85By8CfM#r<KZ9sXh8wLQ(i}3NoHuST1!6
z%uNo#ww*+kI&gKZ)imk@SM*NwU<8H8^BLy#X(tCBcNv1DHuroM719jB6~MQ&9L?@4
zlvb(BV2yumxIGWvE5+uka?9&})W1guHyA#dcJpFv^Pr_L&~><Vr$JCt@5PPJ;u}je
zocw4vJ3P}jNq5#o>egviaL|RNHK$yy_Y9W1B`kBUCCp3*rE50>N{8-QIh8!5+`vb0
zCM~`)VXG~T)~WG<A>08kyqQq`!#cwe*ibS9MRDeh_>>T0eH(mgg4UXF!rX&CtwGB7
zreRH)6AE=fv@1PxO_F4fq|mzBZpoL|^x79xnLjSjr8IL$>&T~vq;{6{8npG83aG_;
z9jgJ12Ofq`{5lM$y5YQ+1V*19I)LWEQ7Zp%*pgw{gQKEuZ<VrNnESE&NVt0Eh+kSf
zEbU&&w>Rw9v2+)|`)@K;&ZL`}vpk5@81B3pI`*kO5#YUmc)n@*)sP+Hs`Yagjg1Nn
zJ!NzTGwYJJgS~vr?^uU7%f`n68I-=Z+g?o}pi+8->GD0kbB&^h!U}D@1zdl5Ak?)T
zl=B&rmRpM^P+eVRP?$q8`W+DKRG{NURAfW9UkkE1e9ZM_To0v{g7g-2WD)07!{gTO
zAnqF3Z=@An<itg;S&|IH&Gv7>NKxs7c=vqVC%jZLGEQj1?dTNdF9rOhlE+e6a(>tR
zN@o2uJV~7=U;j`_Q{SJWLgleM$M)Y_OA6nQLfly}tsM>MG%M$A>`-@^xWM49#;s+z
zLm#?QGnVvVS>SMdl-(JMAn~$X4}9&8m0I|EIz>Sq;G@GW$SvqD0+v3qmH#^n$C#xr
z`Ps*NKF3J=V)9Crtq&o&8I-ksO&?&%AZlV(L(-NlYdnISF;XpHIm$i@eGJKgMKG;;
zsVz>Wum^z(&0#nt1#<+Dc_@EX9gxW_W+}4krL%`Iww{8kCM)KFL{;VLbD>TPMZ21`
zTolvOh%n)aK?alA43(de4Cx?bSjk5DKg8cxB9!#zW}ZLv`*<k2o+ry@zoqYCx`W`g
zRdNe^LXn33@Zwvx6=zB|!qjst&EUW`p^|a*=Q*ZTL&hrQ&WQjswRH8|`nwMTrS4ZE
z@Sz$klirR;N`sRAHD;25%Em%B58@2;Tvip&YM_?#xm8hHDHhHIs-yuF9SF}bY{02a
zwSp_DliXRBvE@ydO8vl_RDpLg&+R765iN8*EBWq0(3S_*n9bX4`@0qJ*MduOy)U`6
zJgx6!Wjs21<$2~sE55T6wB%ilJ5)@vo1EWA=&f~i67H5NvO;h}Jo$18yODw_q05^5
zedEGb8BI#gDVUA?lv}b?2zOY4c8RB!$y%%XG>Y6x^*;y=l8<szZm&D6^pg<D{Za<|
zbmD(ndC8cPNJ_rQ0QQL)THn@E6T5-@RBgx&-O}E=-7K|O#qXo(Zih;09=3*#J#7Z5
z)!!OsFr;N!MVCJYWOO8f17QZ51!l6$wk?9c*H3g#T*W3;oz|z^1uU|pgw3Wp^d*5%
z7$nQX+-$v22+Lo=kQ@{gEp_WDkie}OfCoHObheJFe}bhuU>Wh7JG4Q>BM^J=*_fvG
zv)&>IrY(H-8ibp&Ba$O52i-w5-#?1i!nMc70h*|&upK{OYnR(wX;v3cTb=3)VuFs}
z{Wn=MP+>=sMg-@gtfe?9m)wWbDh7(WT&qY8*eMR+weVta)^wwn&fi~+SDa+nKc-^I
zbNo{*xUw}%%dYkgZ%^=w@Am=*;OELWg3daxyk7Cl^xccGu-pFV^Se>@cs=?7?!^6!
zaU+(a>UH|`+J#?qpH>OD8}nj&DlB(nOg;NnrLK3wj_7>AcS94Q9Fn0VfnvO_GORz3
z`F<Jq=lfqx^Xt9h@sD@k{wy|Gyc}>d+qHmR*ZeGAUyaY$fB{C=;tGGmmEfq~{&e~J
z?c<+?DlCnPdzKtaiy#EIp9j?W?xmA=@1Nkd9agxVRQP_;f~W)8z*@Id_~nIP1r<bt
zRwm5H?;8ay6In{81WGJM#EYe<+G-u@WB==M9a@83l&vvc(xzb_vLHzz(!NcJczfT{
zyed)J){Je6aN3VqZy9>5ZY*L&Y?U!Lm=jyLC1f70at`_FDKUo=$dqB+XuO@|56qpT
z{{8kB{#eBQaht|JgdVj0g5PZsw`>~0Nl@4z=v1lhVfn=2W8LYz*1wkbD#UgYlF#sL
zgU;ph83qB>IS#leh0$V7XPHWT7&4#z*k8%a+pc`Hc%{wKTIozlyG=ZWqz6H{FQ!0}
zVh?bTLJ@G2Ua^0g^eNLeVYPn*s<4bm8maKFjsX__S%!i%g*~yOF)CG6aJW6m0QKg4
z+9|jwq+mq>C#s@tCK)M9Etj80x}I~bOB$3>dVD-3KBRMm$$3_fQWGbfm4o76QZDDz
z#s-xN>ipv9JXKdw!>(T3nirCit9>6<ow?<fpr4P0>vt*%gup~WC6g{;Yz==naU47F
zTqIU~6LJ4Qc$K_JVw3yTMzjUUN+B=-lCcEM$B=Dm<>~x`h4Wi`bbvXR0jS{h6hblN
ziasiBNm5T%D<RhEZGY<$3gIohIs58k<0>#gauOH_Z!rcj)yX{}O&1`R`Ma*6BGI=l
zxN&N^Df;~9s*&fK3wk5q#rfz7Y0fCe4Rh~=QBejz{@(4-b?$Zd^5>Yn{lUB+g(@R5
zY;1RvR6e1E+T5Qe6L&SPy&bPr&2;se+A9?}KMO?yf@xPBi!puFqmG14qh$OlOiK_k
zVqWiRx}Vb49?pQ7m9#9kH#281Ib?ln^N+4SJ0uPbo`zGyHJz_k*`UY;*0xv-H+1*j
z2RRb>Hm6%UlO965kEMGsbM-Or@R};2;gT$QiG5pZrJUo#pjDmK*=;L%th8}FBeqB;
znJO{CZoL;RK$@P5Yirfi5<G$yPJKAJN>PpqzhS6U!VK#Q>)`%9m}*+{XkdhXoKFKU
zdRZI5Qoq$a3ti{)kEkV!;cBj-U4!(w-~_=1*YwS4Ese#+7EZ6kc@@A-$atM`>nRY{
z)dn@j>j;~DPrD+_;s}p^moKol^s$sYxiGi<_HM>*tt~i5Mq0<3NC-hvr5cvftNrbt
zmO$y5B-g%LpBX;s<5&;b`<6VY_Pvz^1v>b`dIS$P#A|A{_tuE&l@z!rm}#Nf@1fe`
zj_`DPmd;pukt0K({(;JYx;~o+5W$%(^p+j5U1KKJ<s?(fQ4nKqgUVj0Uz-ud_}zb#
zb-k>iR(y#Zw(TlLHnE^c=#~aqrLM<2{A&|v-_n_B$Jt@bDkra6Sxj0W?`^er3EH17
zwiv5DR&`<Ml2o-#T+(H{r)W9XAnswLC9B`AvDS_f?&__pxYb(zH7W?FdCM;nTsioE
z?I5gc3{`7y1{Mz+8js{)-zeKSq$Y4{#`!0SM{(5Kt=$uijsmBp9~T;QD4HLv;M7k(
zNvAkCO;e8md~2H#(>K@V!XH*e`Ma%@!sAN&t&N?Qfi}jr40yF(Q7L{3NpSCgxLy+P
zwmy4%3Makrm5H?yznT{2qJJ)pvwPyRsilHxKMSMpfS5)!6y7aR>+P1`CKMPHtMzia
zUaQ4CX-HMzO!(d@t)Q+Q*Lw)mN6#|y%<IWIck73gv@cmWP1;KPRD906Yey!T*us4r
z$k)MR7D%;s3UTYXoHNxYI4q~t1fE;57`20DyW?8&e%LHIrm!)`o<@qUR8Gx0@LW|?
z?{9N5lvUBQ>tJ=K1WZe<R6f^I=d@bl2&CJ#oYw7EnXQtwoy*vX7DmQIf^O{s7>rvU
zl(SWO*2X1lVhxCKjcG~&sSW!b`+d;ofm7A&(~Xy_5t1bZ1W1tT>9Y3Nbw1fXhh-7H
zpRWgGXf2K>wMgpPeX2f--zx}`@%iop+E`ha8*{Xk3FfQb#p$Q@hoU9Ei!zMyZXYhZ
zG|!q%Q>jR0uhdzm2HttYe9Swl*=wakEs&P9F}`y+`qF{ZUNB7?PQsfSq@CSM5T~>+
zJrO}Afvpf~Jp4n;ElK7`igXZH^%c6dEqS$exKBkj7r*;&(l%uRNCJeVwNz}2UUDSl
zJ>wr5dK^y?!@M6>gdzZm4GoqL;uH8>(?U1j!8fk|=P6~p7OgVxhU`=Rd3TatzDwMg
zH?e4WzFn642lI|FS)Mb?$xnlRl0j3YQV~spic65`9B5ncvv9Ue4b54fA0zGv3fa9a
z*RSs=)>Aalu%{!HrrpI0mnMq@9WU)<u5AWA4!Om<KN)`OUI9s~?)3hDQzYfnl-m|H
zrrl6Gne3xv-1NcPA$62QY&r25dI-6p+oGq6f$zj~$nM4Ch3lh*DVU*!Dj@!k7@Z{Q
z-LNZMn|yRc_+wGv_#}Sp*YtCB+C@<<$9Y{@h1thZBvjPJ<|f4&P@Uc6lsmuaJc+b!
z>+h|5g}3fHy%{jJWff!*$Xj{uV-pH@!VX$+rp`Q*vJP#<tzJhVj=mrlhll|wzG6{K
zeU+r=<s#xWxCj?&sn5m6v%s~CZBIpS63LA%K#FgsgT{p|U=qENl(RrKr+*8PB92lt
z(cS}y<c@_JbUD0+;1UHsv6-4z_%UOQC1uDfYs1P~W8Cdvb%uOTXLiVIL$_Qe;fRLg
zFp!i-SQ}%_>T&#jCsg;FD4XavT@QMc<RK49{;nQA2_99wmdY3AFQqaBlQ2)IqQ6P0
zk=RNJB_Sx@bKz93#Q*EDj%jgLc$)L?o1HmGH@460d2htbIWL@gVd59Bmdh!|?VFHb
zIpys$gR_zmD5fSQKjsv7??-~Ps}V^Hy%GeNRKg}SiO}Fz)1KLXiC5R+HSd@$A00xP
z2Ibqk*oX4h>DnsqPovbMaHf{p2vpG(t?r$l-LNEyTB0|mc$|{rm@s}$)AeX5oG-Ra
zk8;~$&62kY`shnwr=5C;q#r$BCA+o#FQv**&C^D%w-i>3sRt0H&MB4TQI-CzrpBVq
z@y_+l3tPBDoTxgU6ow+PZHTE+(9t^~MXbuUy-?c4jD%{x-O?j#6#l<3?O*loU+VZc
zW~6(3p8^YA)pA{MiMQ=Bbfzo!s%!(7vSi>pWdTf|OcWI+_#w~sJ!n;SQ2Zf0Tk@#g
z$t|u_$O#p-eBgvPVbH6zu=p2wPi&Pf5Ig*o{w?7_=!PWu@DD7pyf2b34a{@1d)U|b
z=WYlGT75qb7LPrlj6qQVIG1?U!pODq8{#m*TzxQcQgS~ZAIAIy;G!K``5zNRlq%8!
zw6JTRaZ+gn1zLZ1M?aFWJX3z8C+2IFCQ2ygDbZE_ycD)E-@RDg{VH}Mj%mmYOQSE}
z!Jb6sVh%jQA>+?S#Tr;|Ml!122uehv@Wqe_EU<WkwnJ%^F(jE<$%Q+7hb5PfqmyK5
zemyR2oBcu3@J|%|6`7jXh95q^S)>oCL5K9D0le=^@ri8993r>^hCGUkGbEJ!X`R|0
zxO#yq=gc(6-x^EePm<6=ur%8kGH9t7K=KEF;D&aj10O%<E$K)c@^*-<rKXHAfzIbE
z%lkDp@px$<i~H{1hKHqn`RZ2ZeO)e&AR*}`94)8aq?=6M1bLHX&680)|COC}_|;DD
zoFDatXU)&={+qOlSuATK!}LANc_aFo*VPy($A|K5dD2!kq2ro_LlJ0>>+4mN!y@SH
z06bXI%ULW-PG5G>(RhAj^x9-^`Hg<Dhx#l~Jqg&b2v}6}@pN$gA|Sf9^9DbZ4j{6f
zw<Aiq6@TB0{}1Em{?un>?bToTH028JJt5Y|SJelNwy~hjXTe4j%_#n{jEU#%EL-2T
zr7V}eG8dH&>nbmYrnjtJI6tfosPo&L#9nOd5K%R@6|bpm92;s0;TpKmZcaK2=M|C4
z-Y_50tl|N8$jYv(v}`!MJSzzyZqPx5ZVV{JKExDcFjN=gV1wI}L#U~{rkkhid8dH1
zpcB~FU8`%`lMvi3bM@|F>)epuj%&HFcN_-cjW7lj_CAiEmxCgo#_N{@x+l|aS#4(e
zG7<@}{EuCalvnXSiT8D;E&Wa^bs<CukZ9aGM?S~o;F`Xf3Jf0wY${do)L)qwu1ad8
zFr@llnIK*+axq7a@E-vSYfa4k_`?4P!6A5euN#4@0!G?oF^>qORD%OV2xbve;l%Sp
z?PxQ=cq<ZyTT_VncFf_zNkZPQ{mV!y+*Tk?8O?`6QBr&{evn=jnMfG?iRg;keKFD~
z!rCkmK}i{GV8mdX4~ALkhwttSI)W=Hmno_YgT}VfDghvcAn{OgBh5=rA$yFvR0f4p
z?i?WqfCCgbe-?LKj{_*!AoASA6>V!1fBtb7z%jDRy<29e{PZk8j}U(UENIPEJfOAK
zKaeEhqFLtL8kfhM+&h$Yw@T9W@kH-+x~^+k)sU1_KFt-eoKKRGzmd(C<NtAJh-|H7
zCCey!(r(+vn)l}`4tX1mL^+3N^?HPwV0yjDv*o%|)o^LDEqPCkeJ+d>+tVT~Q{u)M
z;6DxA_@e!g-3<9aBWn>dxr{8^`e5PojS7j?o~Vn7Eqho`DCzD&M!;9V6%`vs^z40H
z&x0P9DwC3@)_=fJal#((+bQ)g#S1-tX*n%*F2uC)Lrbf)-%G)md1X5Q)wh@U4OLp7
z<Tv5Jtga5DYay%lvL03k-_piaX;SZn59zD&(Z*0cr`vh^qCdqewZ&W7T4_|=K#9O5
z|2C19wZTK2N15L|#cIt9`?6EL_O<xg`pxf#mWn+*3%vi&v;?rUvTr$iA^b%~RWCG>
zREs<#i)$aRWdLY(o(lnvwQ`}s+(6preGFrsns2oTn%34Hi+D-J*R*Mtij>xeG4J=W
z>`&3(Rz*cu7y7S7Osa$L^vR3m-I!iro8`Yc^78eb#iJ8tDF%N&B1ev^WA<DeZwraN
z?V2aRj=R|M3!dZ;a4an-d{j;$KQ)fyWTUyF#RUk6%@u1o+G{;qUwYIC{O-R=TbISa
z)^B2`h^&d8l@(Nfl)TK5;7VKmGrtoKuE`k_Cv_v8eg+l;UXG$7J+&M{xin*sqcv|l
zvwY_K2!ib~$rkD;Dgt6hD1X0QhCiIbqa?81{P$zo@yDb5{^7!)?3m@I?d3-&(RnW+
zl9C8jO67zO>nfb5E!*d*CTxG1@xRB4!<)NuqmIJMqT|I2e+x%(CETZ<RPn*ds}Bz<
zGZKy|1ay(nCg0A9z6d*J%2OOI#_34eH{tC*Bt9;Sk|wVg_G|#aLNMHpQQJZ<r7TK+
z>I_hwT47!~*o4n@Yn&)glvo<o*yxOJmk7a!pfX3!aQRB$vNRfP-bziz^5s=G#<d$K
z0L>GoC~3{9-G(mTPEwxXdM^!qurr5ugl8@Ao8R@MBtpKYo1mw3Bsc4(HTd18?kT~`
zLF`&eKBtT^M=q6$&aIHc<33HVHlq(xH7>vVZ!)aPV6qSGtVa~SbPkX=rjMj?eVdeV
zPD_DSCw%K+t?y1=CH&kuPG#y`vSLn?mgem#K-Y~n6w}k_C5jPm`qI;WZ8#Kz4<~9B
z*T=3SueQCuGl6_!Bcf_J>jq>Wd}H%CK6*=z%SS0KiQ$?v{5GM0g^u=@T_ukM(3;y9
zC+_e4Sdqh&>l|C$;_u><Y_`v11P@t_V+F-OxXZb#A`g^U@Q@J}_tnh(T)dlSNaF*b
zbeL6LiMcX4r1hE2Q)D1rF@|lPLF3?(Hd=+t3|xxi+3Mf<T{c**zRc&URl5qKE3bC!
zs@AwhE{s(H(AdjRt<R}?0-R4b1paC)_P6X2VuJyCgbULVlhASur=hV#iArOcSPBUE
z9J7Y;0UBoF+0l1HhkZCCjr#e}m~>v16ADR=rg~O}6M{W)8S%V^RdRo<N3=$(@?Wo!
zDKNbmP*P`=oSP!^>-hv|6ksM7*6(0-lRI83oLRpE?c@$>d+l*f>-S;uxeslY{!%^S
zs6yXoc@S>GqYd6n?K}r1?Qq^L>x%<w=b_4m&bG&ArR*^m5<%5VYs9t=wvJCDFtlcZ
z+X&{7?|}!2?^yEF(x82Ly{RoKS4uMK2!gyumSSuP(pR>Xy8X}hZXwbfN`CY}8?TuG
zaa#!;(T3y!-5FsrvNG6K-QzWnx_N+L#FcL7OzWXX(L<8PnvC>nU98q%(EzAiE$+y3
zqy-X}_?;t)pS>iH)^emTXu)U}#U&Z#q(sew@pXvI`y62|BWj9nyE_CQ_L=5=s6u!u
zD$n_sFgU5;PKVZYrI>yW>bY9;GjvD`-4^yr{hnb#!|%%VJ{T8A;Kt2KGE%dakIWQ}
z@h0?p@E41olpj$mwa)SeMYvKAiCJ5BIo>6|lC}@0JCIxj;kI(r|G`#=aEeMuC)y*+
zi6%S3LW0zyEZ8N(vY86m>7%H++RCnBYV{#uBNpkSN#bm8)N8Q^ZXniixUB{8yp~4c
zh*hsNuf9Dyq_{?WGS%n2NjdaPRXf=%B#qNp$f%1T^Eqt`=CcsdCH9P^9)^sW5>{Z=
zHUw$Im>yg&dcos9GKEUU**<BFpR#T>f~;D@ovd!Ml@oi#+|q3D5;j$PlUGZ}&KkNg
zZmo1MJM+K?Z~D+yI<QpCAQ*@d#?)BnvhgMx^bxfCtolC8Wd(B+-zb(IW4}MHp3_J8
zIkM@C8k&dS{Wlr6X1PQ2_wp(3>%<#dby1z-Wz7T>vGw@&5{ldq$!LsEy9l~n?W^*A
z@xt?yoqIlJWySAma141%9MR*%rll3qK?DHz@KVVi<FZ9|GgrJEP+X3&gfp8)c~{|;
zHA*@IU5g#{imlKmbZy3}XlFhz8UnXW=lR+z^pSsX1iuef?Bn}qgqRuId}Bnlrw9G=
zX*0dN%;ln`{9LYOkt7S-Xem7Dr28N;SBmkck!f=}rAwoXqi6BF#su>X$vG085UQ&w
z3X#P;49X?h9Y?dA*FrpEtjveLfH;!hw(I9SFiksy^nWl(zpd@x@0$9L+dIe}=i585
z;Xm9>KZhQBjQ+KUM`xC0&pFp(tgL$a6>%z$(>5DLJ59-7&zjA$zuse5Nr3XG)5qcL
zRD4tF&JqA&2<eW3eV!$-yrt&#xEjZG+L3YeHXLi^`TLQO-VV4Zz*7Wgwb}-hPyPDv
zXZJ7~0!-3dv9W=z6e3K*C6VfKc&k!OGeiX&5>MLVGsLJPWZ-=_=uX(KnUD6CUV(>z
zhLDBS$p_d%dBaKv0Y@7$YE1-|IlfjjR1gMj>d$voNNnY-(o`;SB)62QL@~-D+F^^d
zBHygFQ;?zL&<FR>xy9Z|u2&eZ#u&%Jk$NY|pmyrv!dZW<CwcTGt=eNySF+7Z$vIL^
zNrVE&))Y+F^#vgX!+!RGqy|kNOKppNOKnjaJEGNVNrVb8G?$Y^Kp)YblCw9Gk!;ZQ
z!K^&ikMz=;qPUZ0_a|`;i8T$l@Jh*cg}~{7rBd+FY}{j`d-c8Os+1U<)o@8^0^VY9
zU7GuSlpBOa<&nyAZ|z_<moA4beKYKa>=VgOPj}6Zp*BXc!4;$POjnm@Sr5KNZMe2Q
z@XopB`c(1j%Zz;>y*9TYItu>kSYldz*F){?aOq?w^WI*hYVurf520fQ%F-z7RVL&K
zs|x$oA3L!|FVgbc!x(CcfA|3ON@Ju1Z-dpgM!bJ@(!xq(d+6^jv`=gMw4T+mHMnOv
z6%O<smSqJ$w)4tlO_utR9LT}Hv_!-VSUyXLt=nOLU97gX$JePCgOp(PbCEVfO3RmG
zhVu*X#Wne(enBE<cl<Ojx8qZu<{_p~1Fz!;FW?C>LaQmw)*wISbUn<s3>bI#wh+wg
zJWYr4w*z3DmexsNsMt%ejuXR#DJ(_2syL`g6%!!_V>Dzg81avjXg~_BORfd|-yRGo
zgN@H}dhm9r<m&-HX#o4@ohI;<khdrH3a8g6+^J~)I<8{u@tu!%-+Jct{q+Qv^B>ZQ
z?R0_<7!}Uw7rzBDVG#TR<`hhw190{^f!qNhA=mzyq3?X&<rKzYQU=CtT9OX8*2fdm
zG540|gO2N1n5Sp!c2L+qUp*i186?>4A7H287xRpsN)wkLZ=E=&jbFU*@A01?;`#W`
z!JO~Je<YuFZuUO@bNqiM{=X9csaF1L{C^?-6PVk@DD8MNG(<JW+_~qqGOZ5qG<1d1
z`(aJqDPTU1BuNgS4~(%^ttGRxv~*aqW3p|T{4!SG3~l)`#**Du)(9}EYe}{RtIhI!
z%v|Rp)Ni{%JR8)^9wjGk=6F)5K0$&I%vY|@+EOR&gDOIlaVjRHSPl<cD!e_kj0v3{
zG7A5Yb_xr0F%al~8t+M(NtobS&b$np=z1;ojX^g`860b)^8;9i*SyxweqBzG^Sl2h
zbt6OSR<cq;TIgC!w2hZJ8<GT_by`0frqL5pu1J`KGZcfGmh{R!!Q(M2uiCa{&Ewgz
zg-8xu`Xn^qy%-z+?*fL$Nk~Yk;U3o|BrR>W!DU$Aoh-~8uE&$5F;9O?9*~G1lZUN)
z^M1(51I68Z;J5us-+{b8iMa6Se_gon-v7GrUtf&PaQxr*@4sC5{byI+I=b)^S$Fly
zd>nWE#EzhM<Ch~Gc`g1wiT`g-%l$I-xa~H(B~_u0LDLmR$Qd+2n|4r9jg{ew3G1*#
zG;hU#e~kY`BUrpFj1p`2U|{zO)FP*XYHhOShF3SiO~~|mz)XM+AeRFAZuknmj>^6l
zmxJVA!!IzoAlx?LZt$J}$ALPb8VB!?DD*g~E;^u`Z^Vb|`B|H91r1dU;Msgmh2jgu
zpCf>mf_I~cn0U_JsERh-V*|{1Ojw`;o(D)C#YI{b`RfGdhm(Ud;kQZXj_}JvK|f;R
zZ(=K>pg|l?2(M5YGOG#Fm-O_3hi;LnM52C->*jtEGl)g-#?`J4EXv}m6GU*9T#ime
z3Z@LDsT|YhU<^z_oGG1$^q}q~NkPA&f}*?{Gt(WX(yfc?-md_!pPNqi^23hd`fk3f
zvAXhF458Lpz|($Rzt{SOLer{zE{AYxDPhhhD{Gf`rhryeF$ZM1GMYh`$MiLQs95K3
z!`S7L1!3&Hz>&o5g-GyKv@mv8Cd-NW*uJ%hQIy`~Zww<EOhAmvDKu2j$2%}{3+fVf
zNs**!Yp;2y17!4A9Lg22G2xiM0upUUK%sa?b1l&7A#YUAlpK?qS#+I3Wy=v7rsR3f
z1!kR7R2EAqpTD)9;)(X-TT{SVO@)G@s@4oXiP5wwrE(qXViNE<J@OM^Q7zvb!3v-}
z`yK<VViC#=ZMpi39ZjL(99JmEY_d3b>-~Idlco`^4yO*h{&GsC@vv~c;=fOlkZbfD
zoFze3V%Ab=@W-n3-0I<Jb^2_DBgIC23}xO_tCqCwEfEx^&`UuFo!6LanD(WLmZo#f
zamv;w+q#e6{WqByXQFAWWFKUWdHq#L8nVV}iTAws&;Cf9Nv%Cn&X2x~X0p!oHae-f
zWW^E##vadaitmSGn<Ys*mN=&Er=);vYXzj2%2rDhQdtkS;iAKP%<J<>&(Wv(&z+s8
zm3CvzwK)-ZbH&SCt`un3Q*0$#%FHDnkAN<z>!WVUkS<5~=m5ikn8FL0LQWIY?HQ=C
zOv^yatx!jC7tvSV>w9nm+Ovak!{w3<Xl8|c8M?N{W;uYk8<m8IG0vsQgtwUnOPMGd
zW>umpmh@(a9VzYkb*!G$JKhOJZTA(8?`iK+6Bgs#2}o|oZd71RrCEdh;nYyUZpP#V
z%0UoAu*9dFyY{<sf*9CsgY#+PW<^?CEgErat}Y5u-k!L_@hBfm?yWW@WFRD0i5r&;
zI2fwDcMW(nQ~iu^kyxF;P~$3m;eI5A8fFb)w$WVJ-0I}0j*sGN&$|M_Y8I>VVhq8r
zmsz-K>YvR$Q<SiD_Sm&hVjs|Cl`%*&b8l38Cs*3aKu4&E(*{>6>F};{jd68|L-NK~
zQzuW8XugtglJkjMjH@TNqARqMkTnZl;B+;~YjXJwPK$Oe?q+2pOEjz)<68SOse!=z
zDa|`Scbd=T=Fw&aEDq!oXF6dSo4{Es)ZUj2_M^tQcI80<sSLg9+L<<M7Ka3;mck`y
zRnPUt{xb?z=6alO_ls#yj6V_d8mZb4tZdR)R!Bt%=7zHK_MsXew|Dn}C?g{=rmUS>
z@-S^e3l$QWa7Y4{U@?x89%Kj3$(}$BK9~F=53OuF_-u8f?vvCipwg}S5U`wwa-e)7
z(%}G6t4g^a5Upo^AW<o#(vdnPRHEL2jcDnr))%CMpc($R)cRxGN#POQ8d+#b3^YN@
znBns&)sqZClYTu5I7z_J@5^xqUS1aOa#W6Z=km|Z=DYtM?|L0Ge<Xc^K(rwBL8|5J
zkvA|^J2$x8i+6lilXGjJxQ)hB9MHod(NoTL*O}{F!3^>>EyXT1clC0Myonpy5j~e*
znl243ydPV3$4b`VUiRQR7Py6ttCfbciiNDmZ=sDIsZDv(qNYu>^^(M4H<`;mmcU%i
zi1N*h?KG^lh%Ia>6$xefhHYuS_I<03R(5G5v(TW$*saON5lQYf0a<e@f)3eoY%M`l
zo!okl?Gk#6T;t7{x22r<2!yPm$}*u1=BfR*qi#jgcoD6$--&VMdwV$&=Xx6^>BEDi
z3@rO^Lm@8%9ncCsm0!s;M_!$y?`o2&dF0JT{DdNjYmWhRbCJnB%lQpkoe#?Ze9${7
zCD`sYbAb`_$u~+`RpM5pk`a^Qe$MgEs9&~NKFppO>Wpw~?MTaiWEG1+c~IQPcGUzq
zbqmQwKQoSX{*W}0q(duNDve}}7y*i6MUTp8vc)ZA9vfQ;k8D}xEj$A<ixuHK0`F6A
zBN<5{pMj}(tr342@6t;19kTi;{Loj^=V%0U7Il{V2i(S2X-q7xY=|GfO5Y$_B|l{f
zR5?Zl&<4#epK0GM$<5P}MK`V)dE7p#M<Qg)a$eEH{%Vxu3!_$Q&^8ts@x6*E!B~X`
zZBY=viE}MUM64}Ok#g=~t&!`Xug|Y<i!0KYgxzxY%G8x**^mYz9f==ZTi2#2Q?WJj
z!EE;El0bEL@zj}KOBqSCK|RkT39a*R4O~NlC?n&;(t1Ky#pxQ~c~oEE6MgvIf0Oi}
zAa@j_eLC49=Im{<azU*sr*{#5=uP`_m$^7c={F8wiO?U$LE_px$)5C5z<@kKZyNA5
zYRh3L=CO1=QVsQ~-_&bGS&f}k5Z^CecsAy!SMy%cuIBG;E?j^gbUqOSeltmc<U@Qi
zzplqfNr#N|;hjH6DoitT-rtcs%`peQltz07EzEyDX^w56zhgT{a<oQH)pOhGVVx9l
zYL%YPrAMv&_H?Uqb8YG;O8$&_t=yneV2OisipYkw+%^|gR;JPcf5;NGcxD?St0U`#
zwdM?tPbQuyriX7>7HK-%vKF*nTQ(k9R)lT7KtIK5h6q_>jyCIHZk^?YU#ZcaHaQ`G
zOYtfe!`i}ivL#vq;=A{!Mu$58vok5L97`M>eKEc>AbS4fRc^$q^ueMK9zu_UOr5GT
z?~?;jT{?`7M(dxO`V4tORUL`(b2RR#-|o}%dhN3@(sum8n(d;}2vGu>j3|MnZ)d9S
z68f=DjA_CA%*WW@B}J$&&b7mGh!!A=ie;RwtVwaDOe>#<(1{spBnhQ5uDsrG0|_#`
z)yw4d&^q6}IJ<jY2K6m^Tm226+QZk+EB<eWd=W9wck!F>kw~*QXnL{D)WsgU>%+Fm
z-UEBBIq=`aBELW3iakP&@39vCJb6_i6ZHBGWoq6`9)Pdzv(=;^UF`YpTD)UMXTRXs
z<|o3ZLRDv2f(xugG3+c>pRK24msn8f<yg^l8pod8={!tPR_eH^)JFt~-4b-p3f~Wp
zp0x_Br>nbI>}+__nXr5hltjah(!o<+2>+B;J7GZjdyTj;lwvrV_q{mrh3p1zsR}nU
zIDUuA)mvKbTAyhAum#G$wHa8axWR2xF=yUSHDw_3q0V`b8|ed3>APkBTIFdy0wM;1
z#!wvzSc1-Sp~wsEp0{jZE3H#>bIG5779%I;TKYk?rD!6@`s*T8P_^nOc+Y7+(m2x?
zD1iw-tV|0kRQipqkMw_uR=rLVS)i}VR<U)G#0t4>gye<m=g}&%X&b3JUarS*pJF`n
zM=)0WT9%H*5W52{AnP;OfWZ4Z2Sv+^$9E>?`o6k2?0ehvY_u?Z6hMMzz1t8V6gnBA
z9j8y`V8Plrh<By~-nLPQ^3mjnpsNVNsu-vDftn&8Spx5BTPDdH<xZs1b^o*hRFTmS
z^g%YVYM*VMtQoUb&27mrBB%1Ye~Y#2<M>~9;z1<m$!n{<br%J(&r$dWYy;H-@6r@C
z^pw`L(}J0<0iUMH9ayS5_u1Dv6T8-qs9J#5kf*}CN;?GGhnI{fE<W2*yGk$nliaH#
zwwj-#SFh&rSgX(@&nr*tIZ%Ke7wNG*QF}CptVrf6nx%zDGN#of=%M+c3ATs4P|}1)
z)QaWJcvZPC2*hhf14?``xUe&j-^9K43Njzyf%@b3o{Pwil~J$iWF3!VMu=C)0*Tdx
zfpS8}1T8+M<P!I>*2*N>XmH<sl?PZ%U{Wk#Gt|?hg^L_Xw9)nKZ{R%hHOWa?1nQoT
z$imVdy?zZ!v}J{GBm*++wlk(gN~$=F#%PtH_j)ZoxDGj_A}*t^TD5!``a@PMn>L?I
zF=$IWWCcrzB+)R&sPe&R>PQ-)F;_reaoaPg8bJNra#=0y2-Bopa=3-B)xn&*Mh4X)
z*e^SGfh%aB>b6=>5aomcG^tS(oeWUHZcp(^3lp_C>Yu>;O<e63WMn|PYA>}O-Jr|F
zdzKtU8;SA73rm{T!c%Q&FF#3FcnM!DIi9UHPNzN6`ukgfr+K*q3((`Yc?LW6K53nO
zwyY=eiDgNBR#%+qV;f7vhUL<};eJKJ)bdP*jK4V_W5NkZBi#4;k!Q<%qV?vZphn)j
z|E8^7AD_g0;vF(jWiqeE(r2V|J1~VGm7CcEr_7gK*`w=N#ldEvwX8Q$i~D#QsRUIr
zJ|f3F&P4F_9YHLi#2;7M6f@Gay60UsIX&WXsW68y4A#nR<^~<2PGGn^WLV3dQLvRU
zr$@1foi1|iN7);<ihv@nZK;sO%9vDDLmgkrN<*^!gj|kx?=*QMbGA_opP(N|WE(|d
zzXdV&%rT@xbH}M8qDv?4MSYsiN*!^+MijK<UPP<M@!B3Py9U^pLj}mv-onX9c<uUB
z<l0qwct>e!(mOFPPwKhz9n6gutIJi@FQ_I8@Y^(eAvmC|JW0)3r=hy?FVo6k{ggca
zN2<~@V5&+R*%}2s`KxnXZcUc9$~m3}-SM**@N<fof23%osO`Ynb4JN}ul3b3Dl%~_
zuh^10fFhOlPVCw^%doCHI_>q&ezhNuh*I)ntG&%)I;uF1UUjyMaDvKcWxk(J@MkZn
z?V{jIEZhTYNyVvu895!XrefH{kk3S|maet4(!H_x1Y?S|c4a>ur`<Z7tMPWV^I!!O
z=|M~noW8c8%qxNR4lT|jdMi}$_32H(k7$c3!_~m#c*?0qey8^;I+KJNJ$}*MFl5%$
z?7iExh0K(u=K-4OUWFR&7l95yax*N8s>NjG^|?yq8Sauzd!v|fR9z76%%^KSUq<PY
zm3vdXo0`HM%4@7krk`+EZAjY2wctL7Rk$j9`mEvqoaZgIpd$A5tBG2khaAB=k{Bq@
zxEHibX(Z?M9I8vJ1X*RU`oU%I=uzg<X-ME?=I+42vzc0a>Ri|z>zI0Cls&6k2>!no
z&`SqRTc98_;yySDSBSmDBdnO-fj4m)8jgHq#RwbN!i4P3uapfVqePZn`v+#tX^8qh
zDrQv;Np%<eC%8zmcxSDi>u8^)0k`GplXz9J7k;_^l+mdnbJbiLHpfsBOzjIQk8Q1~
z&{C|0gPD82Do&n5vJZ-sW}nPdrJ3=tuEg7ETY-_@KH-73P`RMyr23L%Vk9@q_JYyD
zL1!J<&)MoAlj?;;79<mNuPg2W0<D>Wtz=cz65y64x;gb{+OM)V3mG|@=2Ralr-s>9
zvH{bY0%S`4WW!p{02v;Hzp9f0Arvw%WH;v+Xk5z}7EqK&hxrscSkH^19;y{Y^dEfs
zz6L5cA54(o37~-J1HGJD8Y;91DdZ|Nlxv=gcV7huTyqfCS)ZkH2A8rQRj0aB8-@q+
z?oR@)wrZdbxI2T0m04N6zcpcBJ+Y)}iFW2qZ>{0CH3M!)DzZWfjMRr)9;UR7U#UKW
z{nMe&NDdIYLyW^W(9kxP00Z!Y^X&LRMkL{?^C2%#7^+DE@y2~u<`|;<R2G;s%BbmO
zy-2)Mhm`7OcthwzMC434$JzJlc;{=EIFee@TB5N9fnM?;NV%SLCCNODGf1_oZl*2g
z(BaoOyRDbQeOQjUcqJ$|%C=tK^}CL~``dvswhyw=_hYDR!^Yo!cW@~u8bNg!&qpI*
zMd&T|cRCZ&m05p!x_LY{u>typM?u!KUXh=23MG36kw_o>s~x@8``%uUcv?Tpv4tJ>
z;q%3@g|n^S+>_RkN3Yw_jkP*~@Dx-Ase^;(=Rtw~Gae0r=kS$>QM;#{=O<!-+Qend
z3@`aiE3|wvdIY;*1Y&0oheDGa7VSCpQ4sJ51;g^^-774tKGRu;%#StJXR3bj8Q#@*
z>tPIBaTsiK-Z84@V$`-OFYjxARpWSj-&af57ZCs$62V{%``Dj*?0s|Xl1jdK-}en?
zesUO=RgRfc(UJG$;^mdW=)0VSE8EB>;T4p4OyZrx;2}0*uD&;p(X{GQs~Sj;d>pYO
z(9ZLsQG`c+#Tw*cuyGG?p`G*UjpAIQVy!C*ni?f%tlHBKj2%543X{1&R8-@Q_Ka1k
zoZ^|IRmZ9cZRT8SGO2o!<6Gr@;4>b##m1SN4zV9`tIFdN6i`}OXWNrd*R&-M%7Yv;
zWwy{l)yCSgzVjHI=m~kwSijCU*9Yj`M_tH-yN{Kr$O=@x$?iA~6yF?ch}zy&r5%c7
zG3JIc17%6MmWyVJYn-qPh54lRc95OqC|rT<;WKb-spYx6QcOO>YOBX}Ur3Ip>Iq&J
zuHd!RZDJf%Psy5F3!8Mj=d?93^XgwrndWb%_!+Apy>LB@QRsph+uD>2odt<?<;;6*
z3Ratlg!5HBt4F&v$R3fomSW1}kSk{kmD*UgzE?+*1=rv)yr^qliSsWfoJT$fXl)sk
zd2(jF`;Fm+<aiXh%XbnP&|Lu3%JQ*$a38o@43Sy;T<&@+u4uJt`#AFZn*H^dyWO!k
znpby>=iM@by!tx6Xae{v$0X+*L86hykbJa2$t@!*##y4tmJt-MXoNX;7{8_SmN6BL
zY0Nh#kGM`BXosXgpF2~o?%bXDov0ScLNf6at~EKUueA^45W7djH;VQZ37+RnK#?=O
zH0j-);HabZHv(cTsx8Ca&<E-b)-$|;<2m~yV}Y$<e?I;N%fJ{|9HdDVBYgtKK5Pt&
z^&q^U`E)-h`bH;{+->-5&*q+H1nJX*5D6JUHL^o*#kJ%Wcgh{e&QW}>yaXwrn}{w)
zYI4#OSx-k^#LG}q)(aY5i~eDLoMFNj>?|i#{Pn_1h0mD-Jm}!C9G?d)z%z#B<`9<q
zfz784RV3+Wheebb!*Xi|%bk#Dtpzv_x3tTbe;!($QNWW)ztL)ZGyBx#g;bRqaVw=>
zv4gEkTL-NY)!Jm%?Z_sW2|2>57{c_S;_=;pNcO!pq0gmKvCO62$dW7R*rmWrcIQqf
zwa-m5Wl9j6JRARs9jHz6bR1WW{}M2OE767?fX8dBNDnVNn)xxtzlzsB6&EeQlCqOy
zZiTS2NIN!1bz9Xod!46JPNn$6-PLV00cYXQQbd)IiN22YMwLW*_E-h|GIkMa%vWP>
z>O01xm#=C~<wMZxd4*!mKQf0W@n4k=>$g18(u!oRQj7bJfJZXh<}Zqtu;~@=K0Y)Q
zqrb{v=m4u(wbl@z!nQn_Q;?~WBUhu$)l!rY+-d4R`uucMa%G6z2N}ve3b|_3QmxjW
z=8z?f?JH4A@?#G59onq<d=VPQRb&HoMTu{u7ubPHF>zg0&R(v8;pVh1g9PV!dfyhU
z=2&m1*y*X$--#wb^AU9(1YPmS&<FYB2kMZG$bR~~4CGmTAmX1qwt5ft>l${gb}eAv
zB=1?Z+D;o;--Oy-C2998W9^lEPZqxAQ01f+ei!>q6fHf;Dw3l{Ma1rV#z#Xxx}cd4
ziEV8?7DKfLV8S1uZ-!bGDDD$wRXKpxcuUTK>S@)_w{@iX+^x3D?=FqrUMnnm$P5Yo
zp149;_82dyOukHhN|i%?pw0rd6p`~imcrHo`;~mjS_-iDF!}63V5xlOObL2i?63Y5
zqr(?C#d-&MJ`sTOe(|i=Hc<?I=UIxt2-K=06Xh@(H5$euTabTOJ|UUvVHOpj%|~%3
z5FizdO3#7%Ya~OGQtf`pogSjv8eQQOTG~^%hh)sVx`!$0n;I!Qt@*JmME>x%<~-L<
zc2RjfGi`S3VHK0fsz`&VgvjIK!}x|+w%%1W?N&rH!17I8#eJ@Q_PD}1WL6auIH!mh
zT_hI8!!OT=G`$)8L3+q>fWQ$RpD2!G1SC<Kp-zqVgbJ+kGXe24@fV2jjE<M(D;0z2
zOp=7MVxMv@D^HeRqv`&{9ba|r!gv?>i*ZtBPc81bGUaJEBD&>gbOm|bjj)LQDL$T&
z?~#NXaekZc2MVY;uZ}n_#5O`*Gzl3Nec^6jJGmZ^tIy{s=$L&RP!`ElW?%QXR|#YF
z1zRqD89u`<?p=w#<>v!~UrbQ@nrpjRdx@|Q@%&%J=<+9MIdY8`0}pA8<b<p77(`8a
z@{BDEcE#G|?1i)5++%5Y4D)=3%*2RD(?hrV<Q&5m9=dy#H&1pTG7~qz6R3&puw&`(
z*zY&*`AB<I<(OIF2XndhiQN-Dlv(L|G!8w%QjWS4*qMt3Anx_3&PY=#;Al@VV=O<N
z{X@|BC~(7~J8P7kaAykNa2gBsf28z!{7-z;ZR=f9x=w2l^~#KXQ>U-R$+gL0^|v_t
z!{W$SX(nhd4>HfmOvk$WskP9m<R4G@F*Zc|GM4AcwI^BR$|t&TUMOSCy@N1x4|~6h
zOMKyX|4rtW^Rvk+Zpo)-f)5`~7FK$cRKudkzan?=&h)$<v2v9S`8YTZrIlIwNr9h+
z9Mze<<I7s`Su;|9HJ0t0n3uH%Ajo&^IW<@a)dl8oU7GH~UVag$uectflaq2yS+czj
zO?y&N4{HyRa@z_I9#5ya{d+*d{ep^j7cczZQx{7MS9|veN7cA>4$i$3>mrGt>!3Jg
zJ+6E~BAgBNm?h7W$H;_aI-iO-kI!vunNcvcbE<orh{b-Zo?wf8%ML_rh9p7#28yDv
zEGZRLO7l~84pd4SD*oOKyp{1uBJlx?i9~J5mpIWUISC(yC!B`goV8rzQyp0$KB$7Y
z1X+4`kJ-uwP-+}H2YA=gw&!9`n|d|0ZF#W-6%qhmKJP_74No#UyCCa2z?bisOO+oY
zIJ`E|imc6?qWd(X@>A3&azHxaZ00(~={#-Y#fWuUYxr_>=rU{Dji0)IX9pLR1Wup+
z#Y7q2{W<<?4M{ztZ7;~P@vZ!{<R1;hdVdz4T)VNqnd~?gm~2duA@oHS(H!zb%evwl
z=U>ugk0Z(vzsNq-XEL-=!M&5&sT^O7)t+zS8RN`lTEiPj>0d)r@_RHzYj1SWj;wE`
z7;%L1Pp|OH>#I73+|18V&i%?`evGWCAiWo|2xec#>PriA?el5BanBdr9APuk#&(2C
zvD3q@Zj5$h;#V|O@`YV${ajKStYvpp0YDNY6=#L+Fh4c+P{=fzfn;l~Z7jczQ}nH(
zX0VndR!pkp=;I$pvPlEyM$jg61tjraz#~0_mVXTRGQuL~@1<AXmdu#@1n&}DmL_r{
zuGD&d`j-|z^GhDD?5Ss)J>t!T+V;(2%F;p?gW@nSV;tkSypj9pWL)lnSd<tZ1+aR$
zsf&3k``P@|#Woeb1h7Ni<?Y)?u~CTt`gk%izW(gnJagQ6P@lA`#8znuj1-DEX~g7u
zNu0z8(bE!RrHhi+o(?1ntstoERH+9Hxcm%QaG7vR&W}KtnJ~jj*Kxj=O40@7YU9n&
zgb{Szjgyh)*R`-QrtW!h<sRl{Osl0}hwDz=1h<lZ<P8k>Q;@50buCOPeXD_xD=N)L
zvdA@VbCeO6j>r)s#oqYgd9)Grc#?bW?hOYzBj-yIz=k1J*TyX|M7}H|TLVu+BNL`Y
zWoeg|elz4%2?=;HfopPZKHvh{rK3!q(eQ2DX*Ie}RRur4`)@LwB2c><G;~>%xhbQx
zJT=sOj-F^UjI|Lxv*o)S_qN>1xu9dFGHe3NB1w+mRH#zFJ&N_&2|mv_zP>#|JKe9e
zSelB?)L9aS`swIieebJuyffCK4c#54^wi9RE60ZWYm`dZj4$Z~5-n;YcPZ^!@MMFr
zVTAVcG4v!v939XfI^Lnz=lm6_q`^M;m%sOT=ferg$7{Suh_3|Q`eJh{;feF<`F1Fs
zm*`YN6$D4wp#l}TKn$s}7EEb9fCnK{H1AFt)!c}#h|`F`<fNCwn0u3}#E}yu`Lsft
zYG%Nd_DZA*1%|bSNG9oSR2NhyY)#=PxH*b382@to7WNn`$Dmn@Ye(u$C!&@kfk_>u
ztp~ZjSqLwJDOM5b>nA2gE&r-vcbTk56AKto-da9rK0=~O^fYS9Xp7+z1QzLuG_}BL
zF)(6|4M*gb1?I>fSoC_#3F8qHNa#D)4!iXA+G1nxdI*$>vnkugE?QDm9Flx!1>kIP
zuf$X~It#zpXUgvgx5{!#q%u}i0;WYu#?V85l7?JaX)A8cx!yM&J&t)*xWUUy5;Btz
z=J*OlU~epN-*K=a71XvaRkDbs!dpwpkt%IFL=Eqh{7Jt$;-(ea?VfJ>T$1G0(jQGR
z9NL6$taG;GRT(~?=iCxCvgq;ph4+H9Z$-Ppt$2SFKZ-x+zpW7}I>}Dp#kG}6GN(ul
z1C7M!n>NX><vYc$hC&BUy%+J}{eXv~f95cF=`S~8OL8?I@@R*VkU3_DQ(Ev$xvNy*
zp|fvK*5h8x{a!Ra-<-DQzY%mfj{grQc<zU^Vb-Mqspl%>2@c8WIL|Y^xCWZhri?sm
zd%Gix5$5ZkNe<C@JyHYu%ic&gT<Y*aIN}WyNjIEJ!nU}~S!slIdONapWaYhyCJ%#K
zqD;akNdd3q0=loF<>N_a^es!9%5EerWRmE%oIE&W^a`!9O{b?(D~XbV3l}c@pa1j1
zh5zG!Uihys#%uoX`}bci{Qk2mZyjCu2|)r)EV7v4b}xleT?!B{g(%T|b{yznOk|4H
zZPV_u5jrckei&5zOAIkzD1i=x8}9{Bwc^*`DED?bU`$vqPedIIMw`MP<G*S~_&4%W
zY&nb08wa@=EY0*C^NqnyLok?EQ3j1iv~y5zPyu>y>4S+heK|#;1K<)+sO~<v`BvQg
z*@U08fF*PSzg#*y0MENIm%4D~Cg&i6^>nrWLx<+gq&qpVdG4M6(qM)$i!?T(m<0Os
z6dyZ6$33O%UJ$<fVS&-<ET*Of@Pr&Nl>$M7*(ZS)0so>zWr~4zVUn`E@^uIYD?<D}
zfvWo;@6W4$7C{FFh7|!lk&=F$OHoRFDgJ5~&LlA>DtaftR_dxS3y^I@elq`(Os#ya
zwJTPIE=SFqC|-e}SB5CNA&gjwTvxj|tvB+Su9jTm<OobzCEnru=45C@me1pIE^K4I
z^nV$rj)djai6EG;%L%`wD<@FJ9FcSgv~RE!g}L+dC~{yYWMdHu16CKh<Y#UN@>L)e
zk3ftovmbk=`8VhHi6YAom{)=`m~5|W5!mVHPJF}eY53fit#Ti&aDOGPBY?ne<_L^a
zM?qzJ`;HuG)eFaO(_!U<@|xehjj5`d`Puk>{3D~x?y(*RjHY*ww9wX(-irHVV=OTW
zKfFqbd#>h9EHypqNcHu6RB+rfCTBQ|f97LSTvvZpFXiodd4l%R!nhR8OatjNHWo=C
zU4UCi2Hu;bDSJj0$f-)w^IJ1MbEX-WWZ~ZzM|}_wa$b`-k30~b5%3}XdU`w7vRB?L
z%#(=1ss4<xo+DhNGC1j%y7{r&3SgOmt`3)x;gJGJoC@hbRMYpOR6l;cS1>S7k-0nl
zp=l*aCS`Mi>!A6k(-O+RPQTxoesiKOKfeh`>N$*}o6=1~uANZyf6`fp)G4L_0;Gfh
z3@?%)N_OB2!^vyCIXQ;cf&e^ruO9gJ^28{8`cByT*MeZ5hT>uI|2DnH@c6-epOw$E
zibK%A^*Sn;F|Gu_ZuscGK}^1g%7dyp{kJFtA(}HvqoeBt;gz^s?@wI(wYW*kWIv0E
zUyiR&95qh-TC`!j9)h^L{%XYHuf_H0zf=yp9n*pqRHd)2UIE{0T4exJhAs0MUu0x*
zb!CZlKI_^@V_$*fImK%UJip#pOFmo-TP~xiH1HtC=d^2tLucQ#f}zh^p^!jSVels{
zjQ+G|e*4~{zzNETfX=Tr{A<O$3PEbPqVQ$vrwHRWm$>gTp6p%g53UBK94l$@3Y&<n
zLJ%t?qt{7GtbnYRI_6ut(2ajHdT;Jb{XtkbI7DZCe_hXG{DdKyUoDtOd6sEZVN@1J
zX3(l|TO6_UEzvaXGCUs9WegGVH`GNc)kC2qLSdnIESWl)=b+_q8l$unSDQv7X#ANx
zc=|iT;d`w)zTSVq<|v?+r^>a7QB>$Cp<1bGqlgg{MI{w`E!{G2e-At4$ebwz6QelP
z#%ot^-%5Y_GnJViH`W!8nNX%2X>F%MIhQ_Yqe6?UUhU=YN1DeS$#L`qy~=onVmD5*
zZ__Y5?cWyPK5FOMRu^o+WO<gj-rhqDrFsU|<S1m7Gas-zF09r<C%6$2I2UZ;9lt{Y
zZ9y!p<16!1N$qdrKJ4yM6akM;EJ<E9e#N~bYdyZYe#)I|OCt5!@oPpHF9nRRub*=7
zTDjexXbnQ>tI{^*^(_B;kDk0pdfZ;ZS{;JhOP(ohfyyb^M)@il!;lc9)6(8Y365UD
zU&}G~BKkoViBD@qVk~`(-P$xgHIWEhcBIFQ(yo>!m#hVn&2GzimXKv(ECc7{;){T{
zTC2JoAfM!7c)yP|?b3~~Q9k+W%9P<`=nC!Oz!+1-aM+fXXTpMfWS=K=6~xx5)y?^=
zYdrJ`(9mS=>DTap-r85=s5Ig3E!7C7mai=iEoEAdpq)RGx;B1WgEpydXj?f`U2Thu
zw2(S(@TfI5Y%%Ql-D1`5GfGNg%atb!J35{<7n+Kn$~=SRxuf9X_4qXJa|Vb+*5Y34
z-=H`nl44;6+J0|pa=;|(U|g$}kOirqwDfH|D6(eZg)TkN3EV`NjE^h)%H#VT&W6YS
zu$Om#F73579$S03+kcbRI9qvI3AHB9qmPyfw##|_C?~`cC|1|W-tR|sm(Oy?ielO-
zi8Y!{c(Kw)C$^lLTS^vDv_|ka%h=^zOI{`G|2bdJ2SqouglvP5D-GKmlPeegHSk%#
zM(rnDxfN5(QXfUm`N);XD|SB5C`^wtk1wg|e;)t0VgLDspH5I)Ue_WFWoz|{i@QZ?
z<g3OL)H71IlCRdoR<6-SbAU!;p9;}Zqe|8KI8k$Qi3OKU@e-9#k>$0W*lQEB+@Y>e
zGSM2W6thE0D42Pcr@WO`OFA-MDzd6{2vkd|X}E!^H7R`>okB;q(Y;8<k78Vk6py2Z
zM%bVNN7CX-D87PvebW-Ue#_VvjZx5SwlNosoBt?iCaFoBF+7#>1Ua|DA$%G?GD-;p
zg;U%eD&U0!g=lkkpMeut&tc&c;CUlvVe1_9w<;!eD0<TsjM`}tHOI}XDuf>Qs0%t7
zzsI#ERHoh%{nrvTD2PPSL5|D<S#Jup3&6Z~0Iu}fN7tCUXG<FtHne#3p@_6#t6n6f
zM|wHZ8dFnzXE9*D#WFdmwBlwbi8?%johw>$76;*(Iv<jjUN#bc37?>W7DMSt*biY(
zE!l^>&xhVp`j9N*kkOU<@t4K8vGkf3X@8XbXi<l;kR9oeN>6EiMLQLGv>`O-7{iO6
z(8;8<%G$Ia3v){;&T$F+R6xMtVG+QxmxXkSzE;aI*j55LxHT`XBur`52^iPqL=+Kx
zBph>S)QM+_NqW68g~_*rTi9c$4oq~D-HS&;GP9Q3)gYtAtF#VCo@LBbb&zV>2{zeG
z7H3$dNlEFgf&B<~DIvQV*H_=yrxHkzj|37$z03wa87NBnQ}zw-larv3A}5I)x(sH%
zLUy_)@hxtW<&mYYY4LI@?3s{w&zaJsjxMGBt#4_YmW*i&8`#tZKaZbSw|=`1_%#~8
z`)@LITMm}N0*jy6Y_*e1GM}>|A*mw-^f^mH%~c6swd<1hdRJfQJVY0_!G*o}IHc^$
z&@y+3Ju}5%Xf4qLg@;^nFfS8>8kv1J7$}PB@mQib2PI)qv`pVdENisy57$awjBO#&
zY%Rf)kk~IeDM1oUQRG4?i!}l(qva7&0pP}q9S6Up-+jE*LZ4PiX+wKhx@O9S50)S(
z5T>VJlV+rXNKrdi_)Cd^61Pedj*e>5qrP0I=Atv0*DIFNqT0Q>t<O1=D0Llq+1Ck>
zeDYa3ows!wE9SuawaaP5l2~-S!<C84OS>QqF_Hk(=hbU$FR5m&T$Err%>`Cj^Rsmu
z(+7SWea82rC;YvM+eh*Gt$3wgb)<}+oADpNiEqauV|f%$*$zoxiCk)14Rnz%<B8bk
z+-pVEFVD91FUK2US1dnpz#Vz5=bKBEbrtS|8BIoN2bq_`x5A_AmN1=D&^Cvt6)UCK
zhRBU_p}7tXq4ilPHMXWLN7J^n8hs~Z0g1R5lJeV-61vmxM^1h--t+3sfV<kgzVM$-
ziRKB57+>t-Kw@F+J^NVTg`^62kt|ttB)%`I9>x>m*z_gJIG|@Ks&MKg4nPGJ-eJ^H
zxLO}v-nMn?<PJuW3n4gW3=nKP@f<kUAW^{&ov5mRA&3fpK8R5`BY|fRFph$5gc`&C
z#m+6*tS^^RZUx(pVthSeUH5M9_{jO3!V`knX*!wQ2WuPn^lXIs6f<58%!Kor*i%>Y
z)rim9wN&=GR!^`%-PW$YvAg<K2p+szyY|K1wGRV=KIv@n`}yulN;U8n#h#zvSnuI%
z6rlcXTuo?95V!`*FL&3!9s;jT_&j@*_TJX@KaIjj>I^dBFlnDA5TK%-O8v72tc1ST
zj~4fRvZjzt{ewCy@Ap%XrWG)ZOqFScZ8lQ#^o)>ESYfL5>QH#r4?2(uwjTEhl;+}h
z|4r&t2L8#7{np4-myN3S2j@fK$K2dU@q`2^ZnsVYkyj;5x6{FE>sjsOb{M&m757Iw
z-QEu~Csrl(!R*_ETd<n`DhBzfb5(w~VDYmF3(Hpx?tcvbQ+|Fp;r~%slE2^J4n3`*
z?6&Q%nVh!avBFdrE9XIN_6Nv{m(Y?pR@<5sT(%2^2%Z}iR4vCT5gHKeQ4Oo#Qw!48
zi?vX+-j6eOb0O_Im}RX1$$aGc6g4zKYO^nRT6i7s5xM6PgstmZ4nYyP*CK1sS{`t+
znn(Wq;ja0(UeV66Jyc~xoV0%kq3*;dZk_;#7AsYQl!d`~>N%zY{75QsZ#IsMDO;=3
z#;(G0JI1DYS&usUHlb-Ls^D_G!Z$x;Qm&|_Tg&&eg_Y!g$fgf@(@Mdo@oCm)6r{Br
zksPPSK+paG6fK|H`?+3gE)Gk?s}@rk096U)j=kO3H3Vd)%7&eGJGZs(YFt|z0D+)B
z9?<oFRzj%=d=?vBTKGJEU;BJ!l76bf(qG=AUwoo)T>E}K!yHd>6)I>&@i^=kSSlw+
zw}dI<!yi_QRHuNJhASaok|kf+LeR=oAM9oz)_;>BP=;si$f`y4Isi=sKcTK<?Q&Qt
zr(A3+0#h~?^(`oEh->?KapCTS9oi<8dH@6#tCh@=MP5HwDj|>!T$&M&!?pMmIGfle
zu0G+2#K$3bPfzI?koQ*8^>HL3?WH+hb)rhOwIg{6rCKVl!CJ?9eibWLfRb7{X65!0
z^$y_|nzx2c!eCFaG;2?L)3Vq998uL-uVHS1g1P_x6NJC-z_)~+RGGdE6U`HqT-(%V
z)lk0?rQBQbJ;sOX;+Nqnsvy*z4F5KbIJ!HP{M8tT<*K8&_KTD14)=`B2;WfTZ4Li&
z5czKr%pFI=6Hr$;&lY}+LyK1FD&D=?eHu8cdc<EUT9u+uq8<^0`#;{fRn_%$#f@;e
zG5`ufXln724=z?q(zr1AgbCAffle^cfn0LIV|?^!YyP!#d1rAXxqfzU;w(Px;M0hh
zf0>)ClhGid=Tn0_m{n|Y2~=%6bL<GYs`IhI>*<xFwv_8<NEo3IH6WhXRVAnoDKs9x
z`)|^irW<c%B?F<eNlMN%cZF5ID<0onZ6~GrX)W%e<@=9Ff>zcqt(c%+?7DDT*H@ku
z+PnU%BRBIIgV@G)c{hXPT4mVkS_GYR=li&1hOOGWXhx|_-F9{^`3a`7MtSt9R1vLC
z<-y4~auV&G={8tzw=r}dSuPa7U^*w1^+>_hL#O^M3jTD+e$y%avZLXIvbVyG-HAKt
zJ^u4S8>IgncTst`9S~_D&%)Ik3LwL@Vqp8FLUrQlK=jsFoz2~0)GK~{=F#SKK-lL^
zqOgr}i&HuQasyV^wV*=g*h_|ttlgb609;$<C|cvM&R`@9;x64XUUo&<RWHNgJ_rd>
z)yhTy>A`jC&g=yct}SF^c=(jXE7#T}eehnd{@;)`XZjq-A$s8u>ov~BQ(o=-st&dA
zNHUlk`8Gz#5m`C!(FVT#=Ls6mj9bK2L(Mr(SxsRC^?OiH5#;IAvOCF{UJG6ArL>Hs
zb?7tQG^TCEVNF71JV%eFA^_6{J8)>N3AH&2!@`JqCt3<G+(k@B3C_W|ws`eg;E)#j
zs5iY|v~0Du4<s}?zx!{}@e^X)4SDhsuz6i&!xDt1j!*SY>T@_&tM572JjlpXy>kTD
z1}bglr+VKB-Kgh_xA5A6v$e;5WDeQ#44LQV{f0}u;Mzq{AFvH}I#{c17a&K5vvsx{
zwSKxjD+|16hUM9JW{_AlE@iBh(W-AbA0w~vDd9C0JUduFU#RTw+ZxFH{xvEdcJ<Qi
zBVPP0PL_Eg&X@UB{JtI`I%myn!DPfk?tVEQd3P;-zZieFjFXtvt64vgZCyKHPB!0O
zrEcoBhmqGr`xwtQw&m**wNe%mM)MN6Ze>p%b<35;^L(WAv=uMG+t&K#&>L2+o`1V0
zvHRr8vckjqejajDXL{P)CmN{pRVwg#sp%j<9Po(a(t_e~`2_QyA(VuTEZmBw5;(yc
zp-}EwUJlORDtFiVhiA#{Lsmd7G7z#>L*^i$&xW5w0Ora<8s`l9J!<PlmxK1>sfCqg
zMg{F(Oj`vFEuZCUT*K9af_efsehBQTZ>a;$xb>8VUZOL{bQ5&prcr#V4}`@Z1ZP@a
z=p=nRkjhQX*`5JWIg*@^8A3hsm@zMH7}lhMuI}L=O>zzm4jCY+Uc(l~_5`&mz@ier
zJr9s#pd429A;^^&4cgdwx(t1`G)F;V8|<hqWsML8;fE>HOQ<C<WzzTNJ!{v1bxRx1
zWZGyPwfzg?dH)%vO;x^+CvN1u@R`(?07fn<rAOhk78>Uq^BB-TOQ1+)D`DzhUFKV!
z(L+K(7%Z*VR-WF`wR9MzFi73KZj@^CdfHj8kWf)bZZNq;LZm~mxwfqew(#gF&*%f`
zS5na%`e=@qWl^%=gdS^*)2AM{RVFw$gn3vt)?%GfmX;@4YVCEi+6e1OpFRjPe)r#G
zu#pbGwOppLrMg;lEs!eBsFLz1@G<N;gDilbZA-ved8rh@AxuKdT?t#ggL!*upcU21
zYQY?8ZiVAY+)pwL{G1!4fYX%y?y9NByA^_`RZBgzCrYO^sOp^DcBw=4fBPBBf^-fY
zL^rH4a9(xU)UwmmQK675=J&CRx>Q3&zALuB*=?}k(EkVV`hL`|X@uhU?YP!ImIo|7
zT7Wiq6VhLT!dTzmhc%I1<uwr=*P2JxY;%VbDAc&J-idAqmi~?`nW7J%a`!bhnPS!Q
zLkPe?648Xbe)zfqUeHq*#eh{16<8g`AdiEHbT=#qwuEo4N17~lS6W_^Yr#;DX7N2T
zj*R50Bckm-J<L_MxC=EKmbD=Ew;>33VrJ^j?@wKFUo8f*hljD?!;k9IC{R73)tIG_
zXmR8ZVIb||rF75<nt>xirt4mcakXs8-m#+)<a_aBSIf~;XPupAXvv_AA*csBy%jLB
z94jc(+$45~1lCYsP9Mn~Dw&jQdHpoPSPbrWBf)6~Y7bkje4;xJDSaYCyDDHR!kO%^
z<Sr#GTJvBWQI{Gaue2*tCrA)v;{K68n>)*yVDv1>ZPzmuXr@H7pODU2o#~<b2z#q6
zN$Rmb)YbJ^=^7~3aN9GZznI^8Sf0k2huTS@YSnzTtdi;B@z?E7OO0xatgS%D7&76X
zPOw6i)Lc?E+(dm&K<#l=cq~aURMPVQd|0>Eg2z`R|9P18G9_%)`*1tM+WwmiPcztU
zZ3sMSC83u{h0xN891q#AH6&!lK2)5U*Ul17?mi5nDl4af2rN$z(OP1=jV9O*bl_^>
z4IRwO?=JL*2ggr2{NK7y9$4;&ry+pPUTogMGXgq!e_}Fy)|Mlb0yu^^@4fPpb&_^z
zK^yQAP%{5{?3dr(-0}Ty?^tf|fSxru*_tF)iG6yBVo3|s`Q|EkCIzrtAvj19D6%}R
z+9M*0fm%)rZZ|<3W94BYcjG(6jGRm1=hFBVM$OxXg3Dq5+Y$0Vj2Q{~pG-kN!mP^i
zA=_Vo+CK!hqx0sWhk_@&?8Gw<%IPVX;q#SHEW@TmV%sbPV&3AR%B7lKYGAGU>ifG)
z(8l;_gwU<Kg>I(CHqPQ^RX^uG1!_shUS0_AxVjC>&N3rLIOnT;li_0%1CPl{XJQR#
zB~<MLEnG;rwnnJSlmri0bqWFd%ad9ahPs|}9GaqSPQpCzXko>4Q&+Nl84?B5M=`G&
zEu3Q4AR~ETi_j+Eay%Rr;zN{J!B7`zU7=DSoDB<Y=pcPcJb8i?Ra2iF&-#Vvq=$`G
z{Jy^MN?fb@BAQJFpVWl|QL26Vbtf6jS+DkttdwvcW3@F{j$0yu8dY-=_7)y#WLmX3
zRD{8=gdB~m9|@>5!0S)Ho?44|+S|T+%w^lE-r6`tp?5e-3Q+H_L78;v)RkWeC^E(3
zG!5?NI4Lwic37W6^MtzRfSyd35b>&QZP9nn#^*;d18FLp&*y&Ry`%e*3$MoAc&10w
zNR|okLh9QEXpMPm!ttBne4g*17KxW)46T0L3*4~Gp9Iey#&h;`4Cxm;IYl<APfA#M
zm9Pnh8&L^|_uI$B!ohhxrk988>Os4vsyVKdvCdcZ04t%#V2-WTNHf><(et+WQcnDr
z`2R-Ggd!1EXz4i>P=afZf?v>IvbKC&(DmK*$>lK&H+I*V#!j-eiZQ?E^p*tNks!6O
zVKuSjB>eV3)n@gUB_&7er;4ZQA!_qc=FkHJbe7Hl3DR1}mJj8m38fYG2+27(ZEe8<
z$_j6>i6i^UxUa?-lzz0|fPxf<rKOf3)%e0kC;q8Ila{@=kaJ5qrpP*1QcF(HlOD1$
z9EWkHA7h`j&x1gh_<#;zuXQ*qDLKc^Rcrlb$OTe!_}smn??(_v_d%c*&z_pS-(qY>
zt$oo)^YXj@Cav0X@g-&9ZqVs8xk%0e#%+;EG)f4$Vhb$QZnShp+sDuOa{kf6lOy5N
zH5S>0PL456zn!wo@nmI)BI@JwyxxYDupM*BL6IhLa~_pPX+$<Gy11VG-xn_YxBvY#
z9)(Ta^2|??##a&LXJn<!ZvKp8XFaESU^PmnDd@C@!2RBLlGc7w#4@t~`dsb$4Df>=
z<b50rr0oZ%uU!B=91^<0oUcu{Jl@59BVb1>-3tiZjbR9OFm?zP>Vh*v=xTa0o<?cW
zW@-`X)a?R2%9%@@inA?Y^lV9<7I{5FLO+*M4&IFbBwbY&F6~r(FV(GOSV5H^=bIE-
zf2pf#maxcRtG*Y~S+Le=EWK1JaaIG0&b~G{=8Q2#Wz_PZhhl$JAA+6Fibtlg?aC=e
zH;)8iQMNn~fh~}s;H;RDLcs}DM-LeC)+GCe3u@w@ksD8Sz+k@#m`Kk^pK<_F0X1xm
z&Cdd|4|nLD!%%O;P;BVsaX#25?YvM};!>g=fk{Ci+CO)F0n+s1^RAV-fWbB&Ie-i!
zA(sNQ-Qejm6-LUQ5z0O@J+xJ&&Pku{#G)R`2B)$vL&XyV1R@9orsv6|uJ&6$xgFCf
zA)!%fq}KoybG#X2*o^rIBP5yISVAPe<2}YM72;%`YTU*9EfxjFLw(v&MVgfXc^*C5
zmPYBHHhe-Jy=NMz|5^N~=>}`(hrT>6)U%cMNwsRGmEHHfHDs9l9pwKya<>nIOLbt~
zhT?E^44I>AZFQlSDYIc>f$H-qP-Ce#1G{V>=GMUHgw~Z+BN0)@bFU(*LD&96LW0aq
zZ59rgCX=%*uU?zFQ<NIxdm$#P-wEhW(W(-R@naCA{*$SKe`RXexfrLeBKIGisLlHm
z4|z<De(Ja_7~-i(AL>;v-48-9=$i6-2F|Up3)rK_C-h0pJa>Sl!W0}hVHsO-5&}?T
zM%>MT)_UzkfIko7UhEBO^-d&lZ%%D`4<}};Q-x7?wh)!x-7EXh4%<L*H|GB$#13b8
zJATuUVxy*;tEO8jsNP_6+dGa=miw`EFNL$;LGgABN_3em>}x~c4}y52LMi-_=`@CE
zcw;pXV=qD{PrqB*1s;gQv~#0p2v1CeTt^E7)(5y*3z2&JHd*#IcvFxXOdJoDKHo!X
ziNYsqQ79}fT7$G4vIi8$bq2@5a8;4f$~=ZY1xJ&};mfOl{03Ni+GU8olcROI<mHfi
zbv~%#6M!Fta8gB7I`itJp7=Yqh0Z;~D92L0fdj2*IYcX7oj86J$uTusqSegD!@1(6
z{d2r~b-ODs{Wd<o75}q`QFlCu&+f+mo745Q>pl!)&sl>UG_C*7hP_|`;r8^KQKYIy
znHV8UTK^IyW`0y^&cAx)-}%?qe;a>yjF(e+ahK2`=GQ_cM}MyerTN@{Z|vTm7?R5R
zCqZ2miWIm0HKJF&dbIlL@yWNNS3Y$j6uD)!S?<3}toQf+yCe$!-hW%sxE+G=cF;oW
z`#js(2j{n<f{-9A788!$cTa#1%<v4`|K5xBjhi8m%*BTK<IoP6nWEN;&s_LY;P~!5
ze#YZ8B6g#Qm|WOM$SiyoF8{p}2M+yw^3lb|*YIgs;Laj?2;403B4S`Ka8?oSP4<9P
z@5yA`@M+En>|1;+5*A&1g>ki=`D!y6WripE)yIGOTA{!$M&S>u8}q;I$o(}ZUH~yv
z1kpz}wrdtt&7MZR8KRm3q||=EH|y_c2z@gKA)}ye_m5+lgkgF9aSok#F3&&37<~Ok
zAk7jwZ4ekvE$1FI1Q#RYUoXbeqv7sNB~Yd%H%<oqV~o@=>2$-_A)DdgGNClWJr*Lu
zml4fRXa+=en5CR3(Ow-cbCG3uHb9ia?1yL1aMfZFfKc3lQyDgZ+A31*5O2rLwIR-w
z$suHGahGsQ-?wA*YBe82<)ge`>iM0j7eHoq-kZkX?GQC8{7sT1Iw5)MgJ4K^QqCMK
z%g|{=*;Nq;WtIJjkg}9_B8z(=M)=+CIm|J8duxw|D$6q6pHCC2@nWYiYqnt>ty`0p
zVjo(+KwV6qp{psM;L6ocvd9fdw*kPFFyvdEw8u;UtkouVZ1!`RA5Vt&Q6wtVkA4>a
zpPA*VC@w1=SpeoPS60`a$E-E8KTRi9L25T!)cg16#$G^OZb4P3dMol8G8h_BKZ(Ep
z-}D1X_~g;V9bVD2`AP(o+FS7J-LsiF)BVYGO<Dje);p677~@u&`7V>e{=2lQ^_$<t
zJcjEJ0Sz{W0yCbJMgf0EiDdpA@R=s-&w_pw_m6&1=ia*gKCt(y0X(q~wR-{U4jNJU
zu<_Yd#o{{BW@)$=x%T~de<S4Y7xBa9d=($RiobFkqeU^r8sf65D8M5AE<u&G2e2hd
zt#yYw3Qr>({Xo0E9>rLHYN}3kB)%Q}Fw#*#pw+D9`;m~*5BF0Wr1&P;WTr;}i7Ucw
zDRzE@M3yI@x5^MYc`oIyVuC!5et?8?v)on+9OkYHSd^{cx+qoKrbnD@?E`l{iSd9@
zg+>(*NA02`=&V7BiFJQ|wRlq7Q>7Qi=F5{3<*0JCPW_g{E`hSN;Q}h0Gv(%1Xb!FC
zYqOZdb96`h85Y0)5e-D|+#igU8|zAc|NK2|i2V<<D0}#78uw9f7<sjIILmyrG4?;g
ziWC0uXJ;Ax#jsQSTnT@pAJr9a1^mdV+7p*&xLv$w^$Hs0Xe#$T3OXRSz4XyS*e*(9
zd8$6Ox+6{LZ9=xJw{^Y4p!s;xNH>%S3gU#v0b^DQ(Hs(E%eCUEu`g8tTWi5se#t`0
z^Vplh>3w>8D6E16Y^o=0DGi5>XQdoraP`rr-vZLg5ZfUXv$XAJire<dH#sMMRcCK1
zqLW;-*2BeUaOX@$=}Rv`b#2uxEMtph%gH1C=;WYp0xe<B9Tg^;X4!Yo`VQ9B^4vEW
z*e(D`d#G`RSSJE}8BlZ8r@JP$v;|nA!z~Xx33E+}wJ4<7ds9=wHM=Qn%$KP=rkJE|
z*^9Hb1g&!6T-b`I(w?zR#e-6%Ngfb$BExXvvnlqZu#p-k%3)8T+CB^SwCDt8V_I?S
zRodKTDeW=3vBT&=NMk<NH6x5x^N4!C3*44vAY~4I(-p<(x&JZgR$AJT<f$2$2xo*h
zS|&Lf(|fL8{T7n@AwPI2nr9Rz(`qjHfvU`m6e<$Tcn80cS*4%^D`upxNhP<mJL0JG
zpuR0x(DS?hCT-_(ldv@xn<QJ6(Vi{7V_f+*6$POjtB7r@lC^VLIuj=JEqkMACx$9t
zht(!SPpr7^?C{$jR3G;^D1BNStIV7oTV&?ZBF;5#2Id-@;zK0II?%1fX)CpvpUBFa
znv7l2{q!(MM_bv+xTn_At5#^6(zOe}j5430S(li^;bJU#{_;%JtW*>v*P}_JV$#QN
zPY(~C^7Yc0uu*?x8{bt7GgGaf9*TG6()n^y6gaz%Ea|>5r6%Ku?E6gzAQiPu^VHMq
z>`?p(Mj6kgC$dabOrIR2YhOPl7^;@p*E}tILFH@BR&1qarQ)G_(?$cj`%t@QJl1W+
zR%|RAOZxJCv==P})@{XBIxOM;eYO`p9oB4x>Xl0t;_1kA8$&P0e{c{vLlf4edL4`Z
zj67`d)@s3$y<f-vY4FfBh&vH?el*oGo<tUONR-y&r_~j*p5?gzyTg+zCD{WJ-+AE4
zDu8l)XLR4rc1hJY`rpS>21_<aRl46hLuTW=blWCM#ptg^F8X@>ycZeXwuhL1|4(Eh
zQ)G`>pO^O-zZFaCN3nwZAb#%0s#SkTY;s^s`=w2)d6X=>)Y`7=>^keA*?xxD{TP+%
zMO*nrR=@ib#FTv!1?uccDtlBtu|=mpKP<W~YIA@K^_VBM2e8*2b%p8LXr|ND+d@f}
za@@{p#dc39#+web9E&+zdKotx<V<b(XT3GR{isJV{<t~d$y6|A*&V11>H6Y2MPPm?
zjLz|>$sTx(7QVrp<y$ZHz`*&^_j7U0)o=ooAiY%ni&!lGRm^;SIxEEq55WOKu>=#v
zy(%;|Y*H@Vq91ld8z<1H9C#F5QK^X3gOlIyPJ$-UqcECB2e*7V{n7_!K;;CPTO~Wd
z)XE>UrC{Ed>XvX7{%v|;xl=iYE3|d;FEOs<(G(WPQ#Nmxk|oQTI<6PV5as65j6)w4
z-1Drf#Dp;(1uS0$&hVxUCj^VTwDm53BbCr_zFf!y(mstP7nNvR!<Lv;`R$A6%rfr^
z*W7j9{#1qYnfdsFkC{$vc~xhw(8I&=vRQlo_}x3vTZ&y^bWU7BRw~z9$rz8(eoDiT
zN4y<eaItmYxNdK1N3*V{z15DzJmbsKjU-ga=Pf|##91tC+rLLLa69Y~J^JSd5q6Y?
z-*#8;HfXe6rH7@Ji;)D@bilNdB|v*+gIamgXIXwhPqEK)S@5oi9;zy<Bbb&Fv~BRQ
z*v*w%V0|1?%aWvb5Vf#iKkOgr&%GH|>`vU<La4U1J`8H9lFdZ6dbh$J5-3xQ*YZv6
z0Nx^Dqg^1tU!ik*j}CEV?z-=4bk<V~x3|Q*<25PeIG|rb5}*0qf0GtEi;u0pvPVge
zmG^+zJo(QEj2R8nkLeNA!ox`$`*wj$47@d^UGh|XgKl6K-B70emU@<w+7aeD-RjT!
zyRGTbj|quw3lGB8fg^4;Z4wfgt(8TeJJ6;j{da_hRo(X;q1)b%5tZ?BW~K8r5ScnE
z*Uin}D7<f-4IzD1>a{e6(EnD1+Hb~>9<zcw&+wskAd%+WE}?1v-K|M&*uGxB$)03A
zey&2clnUvb<vRgenlU|?XrvgJZKX<cI=jBUOxL_3v9^#f+cGtn_oz#@;F+W&N9#N5
zo|~>9h~}BF@Q!2+$4`h~9rr)((lgeJZE)uN|EKs?&hfKBurQ*SoJUKoHjJwr%n)Rm
z`|Gr*VdTewr;k2ij|SA*N(-CKv7~|N8XPtJX`xWMGUwZ2(2+<drwr?e{`uKDH<2av
z8Z5ysTf(f%a_W`6Z4ixQV;;PmJ_T=|jd6L=qFfG~sED=a=aT}1^A>Hun$`{u--}yr
zX)(f?jrU75y<Ecb(Q{5NhfVcPhu4a{fA=_TmnVnY+o*7(SgO1en+?u&UEEw4OMb$K
zhve~CJ|f9oMZG0odx+tPuL{x9uX;vg#Yr;~)|Oi8qgholqZ0^BC6Ank#kvW$7}*48
z(V;)$d@j@S8T7GQ-#MH+bq;Is;zZx$G9O7$Enn?BD}(?jpTxy%P=~*{8X-&XWS~z&
zq%-{Pzez9MCn&v-NouE00RMgb$QhtUpU#ZpH)Jm%=B~5DR%Jvh)AS3qu(ijCjwEn>
zjdgrSm3qyr)!L-ndBV2dsc~8eB@5XXt^$W+m$qk$gR?p696iFjoj-Q0^<Hn{<R6n?
zv?OiJkIC;3Vl|G+)@Th5vz)62Qo|ZHpKb-NRpfTO-s$GL!SebBCf*KfEzx}~u<<J0
zD}fi`#77r?z1tL9;kX!EcS$5ZkKeDvZ&j?{3upQNv-hscavVpVC)#WtVIBahHV&v>
zffDbRY4sS0i-;9Lpm9J-Jsb^<1W1Z2fXyM;5;@jSv>*1%e3<8$H(LMYKmX+(k&#td
z=M*5$Hd#iTx@3BI_}x7`A|LIp=h+h8PW$KSUBzQ9twp^Amv{O^;Lgg)H&a+^_gL|P
z51F7CpFBWi8A$oS3<V$@zVu<FCO1mZ3jW4HNmIol>0T4Qx)OzR<+%z}v=vZc%$KWx
znL4)HdX=*0yvKKs*Eh|(+{TMzL9U?Gp>@rQk=Heo69f`og9h3fUZ-E%6b`hM`PI`%
z>t0l{2sHQMrfL_Pp-5?4`FI%LROw23)Nl7E((RS1a#Hg|inrnQ;)L0;X}>9xe`~_6
zl?kLks{*ww;=p<xyEcs=;Lv<B47Zgzf9m_Ypgg#dBCxsI2?D8Rr70;BNd!$7S2_#C
zZ%R2@zJez+hU2}}wpG!13W`m`Q`%!=rU21;BnoCTq7r7p45au<Sj0zzB(a5oE*`c@
zI(quBRgx5V4P0SpOBE$)UR|oZ(HT+e<rwk68${Y9hmq)K5kF)%Npmv<t|I}7ZT$5~
z8%nb)?f$%pc3W+S`xqoCz3mXj6~~rp%&(<t>YX9>{!89%jRxHB&4tJd39FI;sK|z>
zTB=o&+!vVexaTWE)R}^(6BtIONs$O5dAHQZmOA~+b)dZ@MF*U<GH<=ft#8;U7a2^?
zrR7)_7-aF8fowISwYV*DCnc8!YO#7Lpxlm`Yu>U%wfK>EjrF>>v*?(&oIdKX+V_~_
zucoxHjyBQ+;kRBaJbl5#Rxc&Lmm*7aOIKn%H3h0$>hs_cR94RbR-KknHY~Q~hQ1U+
zG|%(F#9wo{FMTAIrXYU6Iwd_vzLyc5@N8oU6(neXKaAVHCi$Ks_FFv#ks<KLd*~ic
zH2vpE%X=+5jFBSp3TG?rw%~VrD$;S>3^u68F74ZAQ$+n~9BPDJaGYT7v@(HIo3r?F
z5_Rmz*10B5DJza{eky`M(Fef+*^ZxzApa(cAk_Y;Ok#G&<&eGx>8lT|{oB;a{VM3)
z63P;6kWdlK<1$F++F;!nv`%ba5#(kxSaLG+&3LIC^4YG8kp+#%@moFR>_*VUD<khs
zxaf42;~JYk3#g-)(p;3SQfjL+%=EP_Y1EO%BiOW#Y1)<^+G_}~xVwg)ZF%FgqZ`vv
zkk%JNk{)YZbGfIdxJPN{Y8j)Xln;s}9HIG-Q|J{8w*f&bk>^jCAMDJqv?15KaHIq%
z+L55}$lAMHF|h7AnBq#!$U%IzT`Ks|DR6bwrFFRqe+7>q3HQsYoxTV9VI3!wes|jJ
z0L}BH0TRCvH<*Rj@^k(ftksa9w-r7Ea7+p40jD_`id2!}V6H3~m+P}dl5WZ(eGnKC
zl<sS$9j%bJE5g!UIozd`uhAo0GnrMNSd1t{@~!7SwG!H|XJ!D{|B@lr;gC9Y$K_j>
z1=5~^`N+~|h->N}mZ!uG`_m@|)x+idxbk!}sWzguBRbRJxS3XYUMoazpYxVgS9_q;
zzvs=vI_IrE@E97jsbSLu*$U-oMF{h=tS(kYpKnd5uUEDZ{a8XB+KFkBaZZJ3%`|2e
zGCHF<6cF8xW*u4$`+%qqgS-#w{9(^B5ZRvfTQC%8C_Edv^49QUUbgNLTkZmb*IFm@
zT1#T_V_G{gr!N+0;KUAx8HZ#QbNyorGt4zP;u}+Do2KqoxOEP-1MAk5D2&aAxzw<h
z_sH{um@ky8H5yhgSUtfVP_LEyTRO6;=f*L|Slf}+j$2`1w$HyO3;oxltC-jQz?v2=
z?`OghD9mF{OKcPGwRfXEUxZWyQWuB4w)<<_2y45*MC)rog$$4#GFPj6irrzy()8X$
zH7eR@?c=FI?sDwn(>k!~!&l<7YX4eG`+a=+k1?AM;tp1UXf3)DpXxPN<5Q+l$<4KW
zX{V<V8oJ!C_G71y9`BU&%6HXHj4VUD+6Fg!oxqQIJpwzTRH5qrk~(WU_gecg!lz0$
zBQIs&w(JlF*W>Qd>kvii`r;ZrNO0(T@IE}pMO*2ExBMv9a)^HF9=)DEPVibQUT1#s
zWD)M!i}xv)ILp8NFX^q;QyACiE57g)s`llzXOndC3|VYa&ZC6gVs5|dsQ;F*y9(uc
z&GFq(4WEPA--Ua`?D2h@Wj~zYX9AGR5?ZdN&I8d>>~mpzd$`^2Gx~ViPn4tfwZ-+_
zMugxrY2_0b{E0nA#|7xjee^;_uTQ4P+_BhXUwR*Gi^V7q?q>8FL#6(r?SVYUfC>zc
zf;F@o@p)8#m7<<S-LxL}0G8r>-qnX^$Ozw!cOcb8zjTB*Vou&PS~+zHi@fWiSlB?E
zKg?Hafco?I?Q7V#^Q6@rYGu@?MrNj+FMJW*rA6khq(t0D4pdjG`wf=0t<=L>H%wmD
zid)V$IZ^qiWy!UDHv4C*qycB8nqjq3%(tz{wKL8wnYK%w)pE>M&vKr1*U5Qz63LCC
zU$_Wyb3Z0Y$2vn2AT+m~C85ff6Me9xS^#FL8W=v899?WJzC&!|QJvR|VTsun=yBGX
zULMXtZJtQ!_N*m+kzj%@J%C!cc<)V1d$<ZV<0D;!uQ8KkXPG7|k~B7r4lKDG6hsmU
zfA#ooSu?c&p&hlkt5RhtZ9PrlZBp&^c<=psrZTN)$L?41z0j=g$4SW_+jcxKZ8Pv*
zwxgvQ(&Sx|l?Kwahf|w?yg3a)B;ZPBxQpYH>ahdx7JtNf*QDf+CJyS*n<~r3C$-uh
zzr}4SKdp=;Ws#w_dSAy&8i5tzt2b%)7NK%Fc_{h1Hq8fZ(!oQb<`2`jqDkFdz2*}|
zV|az!@RxFkty+D8h&j&F1>lf$m07k_(sgRp?YWsV2V1D5)hNcsmcn0+J?61e5?TYX
zFKR=pwih^(Eo0f^#)uWeN@3AL8imFwwSF*R<`x!(v|OW942ltlB-Pk%4^JM)HS$4~
z4=D!@j2$g`h07Mevd~&ce`|Sf@kavR3#zh<POXpd2dXn??S%9E(T=o{DXlHVhyni+
zb3wP3^07~<lGjiHA0TO`v4pr9exsdB>DSy^JSvy#`tuvbo~0#Mq%R3!A7vYnn0F(6
zW^62k@aykGo+Tw;cT#^d4)MAjXA#x|U_OaePL86Wfbv0XM))L-0lFV&4m^ne$qC+%
zaljdTzAN^EZ^q+G=D>lo`B;AxuBk`;lN~DE+Swp0;}%P>F^%?*)!M%vzB%}2;gK|A
z*{Uh3$__30lG0gev+jG)Mywc#E_0DJ8QTO$u!@IttO@g~nraBXw$-|&hB1%KYv3`|
zz8TVk<wBGA&iR$>x2Yw2p#0O%l22Wd4ykF+rEH`iy~A76Sa(A{4()n1kFB4}^B%MK
zbfv>txgIez%Pd-=5)RH*`l5yA$G`nAqjE+|A;${G@}=d2^UE9$T4!{|^C9|i5AUWm
z7ZS%7hPc}wH@9!pq!jpNiKm6Tq=oH#-6t!1bvPP#g+wd$wm!X_>-)^m!OtEyi-r4J
zb^BTDI~%>f*80aGSlGa?!h6WRkM*_UZ>qfAE%xl=1p9&Co-Mug^Lg@PjK95ud@>%(
zxWSL}^Wp8d`xtJBJLk`rYOhdoVJ%0hb6jRi$LX}5gJMhdQ|m8s^B_Ev;)|bJfBy}%
z{u2CCj37v+@VVCfo4=EoIE5g<uF2iL#}>Ei?gV;vFABMEJ(v;_LY$}qaD^14Qu-E_
za2+KQC#dQ0miTP#g<;R~%?Qs4(QidSynHe@twYC^)@#czh3_Q=2>(b++Wig83<^LY
z?Rm+t?!B2Za(8P`#ZxD%Nm)X@@vfG-x+si*(Vn8*avDQy(|P`qbebD@UrR_bLWGqy
zy=g<<lp)LUa?Z$&(km#+<1YySNg&qe(}$*VI{e%Jk`5;Wf~Nsl&9Gars#qvEc_ohK
zNVpi~bc+P1hH75Y+V^S+Ps;il@z9?mFVKQ|RqkA1hux5-#!l-iY`24Se-0F=&{QS9
zQ8FcodX9h?Kb)?<7gtdQu&R>}RYBU<tad+^YqJR<*S>tLLG9V6S&e6pe?I;DWbX2>
zIJSy(k>`z9{P!Py@GxdOdRdK=Vxq0%T-CWaSr9H|wWU@-4tL=9&_|7NTbkhd)l;eG
z+H=E^k<p7e-;b=3)kJ1BYWa}4Vm$inaR^k$paQitD3OK{UXRAn`rOu$SP{gnFqY;u
z8tKUiMpAq}exm4d%yr3yj%Sk-Ph(y6vNbP#6GK)vFr~QvmJ^l2H-aL^t;5>Ek8qI1
zNr*D#a((Nwl~c&v1`}8hiM~EXul*UE$i;c+v=2wu;K+Q5n5CVf?;54r%E+^Eny0nS
z)wcDnkKbgy`(M&|rBhsU+{ZVR?t2<&E4}tRi4T&{I@3puhs-%~<;Agg7+Ylo%VIsU
zraI(P<#T<8!cTVYqH{$j)}I9W?PQyKdtizlw#*rHjdp!(=LlGOjl{E0zC2qjJ<FSu
zm64=wc`lPVBi#A-aYz$hW&NpB&u1oh3S<)Nb^e)9nfD6A^XJK7ojO*!PN50wk;5r9
z!TlBIrTUhr<COS5DQQV-QJ=NEXN*weQ>?waxLgU|^4#BEqxaQEPc^gZC!84aWZ?14
zu+*oU+y32Rr<&p6{03QEKmXENfMkuSa(bGa!d9&3GuFMectLW&AtFCU%J^^-mxX?+
zs3VzK;`*tg{%@e7uEplMu<x?l=$C4s_U#_MAK_!W463q8ntY`ar0`C=+Xjk<@k@0n
z+e>e#ao@bYmg3Tsexo>|zRWgG&}mx7n2$zMGdaK7tn4qc?Q1<hhKhDhm1eczwoZYy
zQp2*G&=y8sjG&sT^tdg(?$oIbu<O*`k4H*QTM0k*p%iW-&GwOg<$$&wQL{R1C9$J_
zTb-~=980x=yUL^5l&m(HrQUIu<sS^jQpqoCG&DBVQMcS21un;NxTWki+O;~*Jlm!z
zOZ6JwSdq3!xP;i+5qJxQx8S$NiK^YtqAa!?_Y~Iic39dfZ9FsW+o@RH(t_lH6~5Ld
zSc1m%t=hRfie!9GmX+X1ZD3@zs~x|^(7061b3r(NtMElpS~%;Loh--KEf|I%OU~*Q
zWhAZ1sf_AXzOk%Utl(SU2Djv{tbz*KBg<3m1vdS1JfTmG<Na9R-WKQ98dY1Z7~wgR
z12AoQky3P+i<;*lUc5TZ@GNwcB@%O^m4_T_gr%e>S7(`>SBz_0bDp6ns#d-3i^Q5W
z|MtIR`KA{7`uGQoU0O_S0kg{Yo+}9(>)w`vmvV&t_ilG{=^{8)xyzKk#i@OO#t0`4
zlS%3^kHl%rJsu~~KQM#ubS#Y|0vj<Jt=EX`wn(U>_CnJO{OIsN<M~(He!SRJZHh5E
z4?Xs`teuA{@QOs81?wLIZ*4QEeiMB4kd9+0Sn0Brmd8@Cj<HRiM8BUN3UYgD$iEgz
zJMTUS+2!?MTH=${W63%n8H6{I^gI3~`u%pcj&99om%3~(`593@T`fO75mVGX_TRce
z*F9j`;)QjAOEiY^gl}kW{<vpN(QSHh=X9lO1{Qk<nUnYSJEd~zcGml4J}j_6t-q5s
zCTf=)kt^q{aKmUb5zI1AO6+&G5xAi0PK?*PXFd#3em?~IS|sP%H~#h96LU3)MW>AR
z2|*S_lSa4qVoZWawVKs&_9x&tlF>`46h{@e5BpI2pY~`#A(REm%HUSI>pOx(?HR-D
zidx#M;vRIReGV$CF&yEg?|^O9WQP-265jhk$Qjx~D{$y(reyI(V9#76hL{4=)O{@8
z&B2IOlpPX-y}q|Z@V82dgXWY{0>Q+v<y@Wfp>!5{CeNM1rkp#ts$78<NGTHg!!&QY
zb?6ThMWMu&qQ)t^BcK@jS-&3a0v=0=XZAEOhxeM(<M?~5d?p`8Nf21AAJx80?4WL|
zo4qWIrKnAkS{+b0<Q*$YA}%g<N;B>T&9zUk4;)il+Z{&i9ZE^I-nU%hj)(CgB;)8c
z9r%qstoOEBpq=3##`RT?uI%g}yOv0TGOe);r0wsmbt|KN;vy>ZZ~se%v>B>nS!$Br
zm*JdXDY&e=Br0WFX;4^QX_6yj2ik<^QRpRB>$BB#qC%2)f|j|beI1hwZCji2%BB75
zt?h_h4L$AQep*q2i$8^<_!BI%_NB^#$%BvglscN?8g%~KcoBeqH`%JzI#z$V<$d+x
zrwm6g{m=jPH<$j$|N5JM_u8dP@c`7r|NYIS&%eI<;n}5suTCTPD@9=YLKvhwK`f?!
zGeQNzB}dFO11Zqa6J<n9Rp%Z|zYzew8+Ws^0tBvyWG_Texe>VO?<8qt&t2#@qIY6g
z7CoNJpl2~BLP>(g=Q!6}K}?aCPT((M#w$b~U&zyjNDUwpA<Gsr!?}rTPx*5<?o*)V
z5#r0U07=YoIkv(GzxeWIR6F2&yuBX7Au{jB7i?gOukOVyR7<$2eEpjcGwc=rmanNr
zB2QFPrt$LQFJlpqvlKY#1b-ht8wmjEe9P&}m-X8#`tz#(peJ#|>-zJC{=BI_Z|Tq5
z`tx!$QOs~ANbkj9k0&Z_QTo$eGxOtg0FQ$-4}U#al&20}zVzFm2H_R2Tfy$O=23s;
z&Kg3UYxt`Xg)CnJwftV+?Ef|I+K13?_SE?v2MWKL=bSg)ipptz>fen7yuW7s^J4h3
z#Zb4VrvR^kSZeCpm80($!~f%8_*WO-B`Dj3{N|W<i{WoAhPoAwZyjVcBkNbK{jwPT
z{$eN$$=dA%)9Yqy{VxBq82-15p>ADzWAUADXVJQ~!uiXVcZ=aaTnu$9g70-uBa6R&
zb^ps^_`8dtZpAW3e_MWDI<EZf@VmwE4;Dk+iY@=^fR;XK{o3U(^YG41uZQE5`T1Q8
zsT__b5CvxBf2#Np^`62-&BMPCB|f4(h9Q=FCkDSAmY&aS$0C6I@9{TRYmbUAmcU<#
z5Mj^QAI8{!ivQU=N$IGKRBr}}Sc}nmTzKxkdQi(FOB5clB~20Y$%5Ar@Dm29Bk=Er
zL2(dTpOJRXn13|H^+~9{i4gmrgLvA@HvqqeNgwalA$BT_*tR2VxNT`pLc;RP8v&Eb
zVDlvjidMgW;D_|Z75(W4)K=*xUV}`7qpub}-3+mR#Md(I@g|LIe5kR;-HB6_wk9|~
z1+RaN;B{%(^P5>5GYqZobXonTzTf|AUYUa(_im>t_Bs~{daEEFhsNmY1#0IHh^rEg
zhC24U1!~VXSl);30<}>zb10A=S*U%3Zu@P48taek>u`{rsL4XM_n-IE0=3_Fh>`hj
z3Bb>b!1{d))IJ)Zwlz3kALcy2EKqyCf%`s`7pUDHP;FmOzx4O}hCAlB1!{K&s8Nwx
z1DdGSsAKKwW4@nJ`w`?Kq&MHk|Hot`g9wncW(=xNFg%n>;nZH61mjv1Aid<s1~XzU
zPIh@TWl9l{ku1?BCZtK8ei=O$q*0WN-kMg{l*19@>Pl8E7*8jC_SbR31>s>{HM3`Z
zs8==&^>k`jIKg0mcsYzBYlbJ9S(WFjLFG?_K-8qkslEw%(^A0kG32A_Ps_n+ieU*-
z%fd6Mu0`!yiCLbZ%YJ*P`kT0viuJb>xT|sK6TK!nN08F>2U8mNQT(fuww2y-o{jm^
z@8Q~Iw4-6Ygv(8=Er2PF1uSB7F#6Y%R1vze$S)K#-EW%#pnx;+d8V8zdp8n_%W*Oe
z^LjK%7Ba|k5BuipR*Z*n-F)Nwap9Nou_ly=ZOF8LB1NIR<z_0*hwtvrOS~YzdV$w{
zx(g}wlf!UGkvJ}~dK$y}mj6Ee&H@6>EA(8x5dU{0k^dkJfWmE~VTcls^xDlD=F--b
zm(EbUtRTH*^&jG3Lkx4ia4V1J%a7+zT}#|M#rFfbuWg4e2T69^$;Dw9sKriniDh``
zN}~t&s@s<d?x^58)A&X+WEH^Kq^qm}JqhSHC!R{SEmW2ExtfDfX<0U7Bsu1spjJ%O
z(_m3Zq1gX!26`v-@bRQcEHa^w6;oC`vGkWO{Vv`~rT#L}*~4uD!=ea_CMY(hTW4ki
znD3Cu4jcz#eLk60KX<KSW%`*AfJGawhnmX(Tnj#?C42@0yc^{3Y~;xXgCsuJC-vbV
zcb0mQ2k_0>2ed`WYWjE%fIL4~i;hY00T|QGcBWpEtjKpWkE^%>0uznlrqowK%$M`W
zoT|5SX;{{+#^ZzzLKg37kVtKPF1b}RL&K$=o65|e#zb2OI#2K{#4T+aU^xkZE{fK*
ztsl^cb3?f>MpXYOC?oisj)F2;L)2>oT6AD$nRSQAa_F|r=+|*$r(#b6%c}TSV?5lB
zv=l=rjm3uyxJ&RzcL07$Ess5wa!<_I!|RB&BmDb5iK$P>LAAtS6l%@)kC56$FA(;y
z{f1TcC_c(MBwNwZ=Mnwde9j^dDHT%3RWAfXUJ2Lz%kWnHI|zzff2aIA^ZNQUH9H^L
zq!Ef%6d%MjIs$sWi8ycHWyqURlWBS(KF>EROkCcM^=btkw80FonzeJ*0tiD8XsjF@
zr}?)AV@T2e;Q`$<JediQz{n8y{CaZia(6*NO&a_2G$`#U(;tIl{~-GE-jCM~EQwG{
zr<;?oe><)0-wQBUVa>Cj8I1VA_$>j^>q)ZuV&np^O>PVC@bmcQoI|vDz8jv6Lea?R
zF7&#+^+rrf-uBOv7PqNzXA(XLu05F|BKW0t=Oves^d`h&k>~sPs$L3%#WXI?R}+~f
z%a;B+Z{b~sXyvv-KZ#X4mO!kGm`IP%Z02_@#DdlwiLquWhrJx{g`mZ(H#Z}lA{ps@
z|MI5A{MMvKb8P{X`H}W$2dZ6iOU3$$+g_UVX@@Stzf=Z{+yPHtqgA*3T?<eo3_^Au
zgV>J?5U)zrc1Gsgj*|7ZL)7dfrJ|+|NooyrUtx?c_o7@y*iQVtm<5q9_6tM{!CANC
z{8qJ_J&kwxX#97WCoBq&oMEzO(<MaMbP+L1xsViv%gE43>N_~}Rn)yvc|ZPl8p_~R
zNtwQ4%?y*yG?{Q91Q`XJjiR5&l%}r{Hf!SUE1moK?er5k#qBrZ7C-2#?pbCw-k<_~
zCd&*(T-nh`qX0fL%^o;2VR8_AXYkt!)SbWwUqS^+7iLyx|46jmA~H)NG?$-%BCQ*<
z2QhZ9MvVv81~L2e9Ci`|qUbM9>$rNVk45&&i8SBMY=_I}lFDd5x20evUOA<>B8B6k
zjsWdX1lJ_25M5%gIN}%PmWOILFV)Lm%h~}L(_=_cg*Z@h*i%N!ZFpDG=0|bQmAFGa
zsnTrrhbY>>2Wp2vh{Pd+qhYFR0S4B?ThKs0AB9uJA6<=aEvq}nE&*&KZ}Uz&A|3^x
zF9JNZt`cZu@Qzg>^cDeN6T$&0IH(zl&2n>pLQZ^?T&qMg|J;{Un;*9hr@EU0krnYp
z;I2(%hf=FjerMZdHzxt!0PkKnGgc9-IV;$48GcVm&5Pj&$%MJ}+7uKWyq(R8q{EKl
zy*KCJ$k$@5JBJZWP6(9`!$_d1XcJCL!SjnzhIv0wK8wI{r>l7@M@Di3Rvys;VS&Sp
zKc2ovL}t<WC}3TU%H++hJUI)B5%sm)%`y6XYaYiw$>|rx1_3%icKi%(0TW;nVBB1R
zIdFRthNpQ|CJ=$L{|&|7kt5;W3c}MfdwG(Rb-6h({>>m3<icDi`Ne?Z8r-eIyWG1+
zbbc0mXTm%g(8kC64i5|`15b(c)fi4m)BhE8W5Wez21h|14>`aC;V4vRK)pFZ>T-0{
zy%mO=#Np*Il&?&&H*SP<;`K{E3#apP5Dp%wtn)OIMMVSJuYgl}HBt^B+@B<$Nj*cv
z>0C$bdBV`AF_h6JlB#H*2rVAV`N~9zU(WOVZP22pDio=16|;d0>NTeb--vm2FwKkV
zPCpoIJ;7k+@GqmM^p)V>XkI5Div5>w#p}fLdOZXJNu*|r9mH|9Pw-fBXrqk2J%dI~
zUJF9G5&yH0Lpc|Qx&TLBn+Fhv>hi=aTma;o3vvMLf_VOF26{b~?5>3sxDy0WrRAfb
zIZlhJ%Q2*Q#eT`g2q%4YGD))|!R`>k5n*ty$2-9Snk=kc%W&BCEnNW_sa6e2IVr)u
z7Sj06R5RHEwk^mFK<Bvo<2js!A8g<Pc3Rn&1ErY+*McVZriiC?!o`$)7}A27Affy+
zX!CHg^ateoTCnk6+;rfw+d=iaaT(&SwBo=G?*}qh!zyD^j<}8UJ&2qL?f!H83u@^q
zj{t--e0$oXuo>mEDeYBKj#JSiDpiJ9CHiR?jY#i;CNCXlT(U1XSjFsCM6T`TAR?b1
zf-9It)CnV_NJv@KcM(34?c(TL!&3>rI$+J-SwloSRTWn7!$OdXF0#xDhLo{Wr3E3b
zm<f@4nfFcqfEbeN;eXpwWQ{7ZSgs|ofQpSFpde#K7XBqZQFfpt@-U!5Je{c*sbn=w
zFNE=XXQNp<+;%V%0Z&HI3SJzof%(1_m^=wQsNl?1j=O=VDmOdg)sFr7OT`+5)~|-O
zdn4kc2VuSm)Rx06Zoxoqy5(LV3xmH3(mjbW?yro{PGmRV^_wZ0_0-sV+wIAW9C_37
za-C}jfiDNS?p*qPAsp(1RNw)LufGhQ%s5?-pGaar`Rj7aa)1q!_<aDnFc^&Ly)_cv
z31dBE$#18vR#oVB_-0j6dG@A@ND^K)k!od9F!=e^LqGqY`!9ISKVJ(D(5i$&SL8TF
zeV#=sg+&!RMMRP6!7>n0%_{4T0YZ6=VhplzL6Bzw3aP_7ofGJ_&{R_1ob2i(|8cT~
z)W1w2O6PZ`RF^JDbfFjarMR_>n3;f?#@qtDc7oX@oNOTDdoKpW(zH{*6}o--(rBI=
z=dmCB@27a=8G<J*L00itl}krrk4*e=60B;sejhq>A@HM#FBK;(ogBwf9F+s8TH$O7
z|2WIihydpuhCzs52g96hHm`@hTOH<fvw1zN?sFMt57ACHoA;xBd2)ucO#ckPzPXR`
zr<9}D)){=NVNOo-*QXS5MafPlFDh=W409^tT#oR6k1n5bm_4k{KFaC?&SwJO441WP
zG?pM87&w~1V`PxBH0852Z3CoA36UAiXcr2dz{}jYFd&5VLNVBWs+~Ku>%mgwp=!3u
zhHcu`=QV3?dgkrvr19jY=hY~^@p{JoeeW>aXuc&Vdj0v#X74bko6VcgXEu9>Ii2X@
z81~4T(}uMyN<O7`UVD;x10-(c%+o$CQ)T4d^!<8qX;wG`BRjHTZ&hXkCjU7Sk{U&C
zxaI!wx2zHHwV_+yfWsQVH%<-k)$;=6yc2w)n0YjRZiakN_GFWS%Cu(p+SKhgYjAO-
zB#pE02Qd#0h@dcX0pJh99RsK>mwgyuDK%3G8d)ipv9c<2<b1|Mo_v^bUOpP;Nc`8#
z#Mx9p-3aW?v|Mu*^sSY)*@m2jd|r!E@b&S}Z$xpKbyZB<;O_S(=D;3SbO#swE<}bO
zKaaJGc|^v$8Y9x5v@+^Plg<qRj*HlsO^T@Ljt>^lX~ROZvgd0QfN3v<i~1};a2Jhd
zI#zEtr@sEJO-x$tWQ8INW>@2OwjWX<WW9rxnB5}Nh^1=m#FS`x=FiQom!svK&I(pJ
zemUi{KhIS8a+HYK2!CKPhQiHD@&BevX%TpP%cVC%t0Bv`E1i+7&^-v`UXB0RX+kp{
z>sh1_-oiN3cPpsZP6vu(%ua;W8>a(Bns6elw0Hhwz*wX>88FholL0%Se7!ssicf~w
z1{oU}1e#f~D5%WNa?pjqfplc`?xiD+`sZ-m?Be1E;)q$J#+PFhX~}MH$;H&}=9_W3
z+W;4kwThfSquO-1eHd7?9+CUEbEzJG$GpDj(Od$f;SI#RC{GJ18#}QmX)bm>nVzpK
z;q4#<(F{FFY^c+syZSSAn4HWICO2m=&py|5cctz70ZX%@EqX@^R!^{I-sj>CGgR^U
z9<FF9Ubc_&2~`EPHt_Dz#5=+0J87}{^d>^ervZ!hkDq(t8F!$k9O)fSLhoqpnrCAC
za8R6`hhWoW$uhS0_8I3Ew`H$^*~{ES<c9$RkA)A=ZUXHRoIAZioQb(tNZ7p>pK-Bp
zhZX-N5a!kI3tV2c>m_OdUWuDIRaf+0-nJF^PVFjqX0XyZ&jHCS{L{J$RcKXEA3dK?
z<DiN!V&0<0f0*B~0!owd-!6XH3Ak_8t^EzV%RY$Vp`Xx63LBx%V-B-)v|A3&f@*l>
z2~*bFtEl?NY)dD!(z+wTQ)&@HOH~mDs0W%6F<SzUxan~SJCqr$YJ#K-pe+!TS?wy`
zV%W+otIbRp)kd+|(U^$srk!(G4lz?^ZTc`@j2kLhrC6)nMomc&s;BmH&h4<^NLbCM
zrXwfyc-s&V8)K)0ZqpEONG68J7CE1~Y|@g^Vxj(MnsV+;@6miDp6N;E`OUTpF4fJ1
z@O1_Y5qGr4P-Gm*(lBx2%aKI99O3P5_ekyrQNKqblY19749(<_3j%g>1DPSulTC;;
za7(limE{a113UD6E4}!B!qPXB?Zaazq=y}ee^R;yFLWLU3O34yO@{{g&+Q4G2!^|W
zQ1^pi>fy3~vqzHxV4!iOz#>R+wxG?=1QWF#Egw?B^-{&8s#w?&fNr-w)5<AA@0nKY
z2BBvMuOKtYjK2)*DGxY<+L_+p#n;L$X=?jpd}5+s#=99_y#Vt_STz6iQGDcXaW^N`
znl-qcM?}oGCXF#3j}6i7qTUZTUtPnoVp}o8kb33k_X9B^3Dl+NLfhS1+YoC&cv-3`
zOP|Vv>9bYF^?=Q!!*&U3AWh-GdOivoeX7eKF`W5Xu#*r)TM>U2-@xF!P4N>t$j%oe
zRY8h4C>g9<@m~`7TQL$qeZIlf1+t?v5KtuQLs+sWQ#gkzaeC>$Ot@>fpG_#{LAfCP
zMW9EokGF6-qkkF}Wg-h@HmJ9T_cjFEVP?<{fq7Ks=a>Fl;D8*8CHN<C0)Iw`ueK3w
z3#IuHC&B;f8s$D{z^4iCR!Fch?aoj@5Rj!tO}CL~Xj36tgi6zqI>IlXtMyV~G2MJE
z-c+6{s{U@$W_CZZ?+N`yqzG3(k8tyw_zZZR4Z&GW3=8{owL@o4vw}1Prjjl0GLdGA
z-jA<p0G=CZ4tI2BB2rBn%pdLg+0D5&m+w13idn06%IvZCNqK~gYLInn1QUDQyCi5R
z+Y8Fl$~yrUhl<3Z-xBO^Lto(yLSoudm6A~gO6z$lwR=|xk8Fhvvu>%Jc%g)qyagmi
zCu$u-5b3v}?I(qcZHN?FWTyss6g+7Hiu!UQI>cZbAt5o)e-_y$T9=r85X6DOJ-IQv
z+X+5?GMU)7Aoa~a0VI@5JG$68o_C|3eioyT1%qlk?9_(!&|)1iLJ_gPdo8B8gII;b
z8iyCdakHsSb$TV!=;Pc3{ccE^_K5HxE2?46`OxH6ZB<Lw>3aw2EUlpvhfyv>8meO>
z@g{3#XgDpb6*%Q-YAxW+VADI}NUF4<aO9vQMmpIlsDH@Y43Sk>$LZa`2krSXj`YYG
zRC~Fo<*ea3MdIsl=7HXuSXoacItx5nhr>5)*^v2>RLr+$m+{rW7{ciI?x*vH2UP7W
zZiR_>hgqQdYS0YrW<YQpvXfdzTDKQw7&|fF`P)G8hsmcPnT)y#58^|mw-{qgEQm@W
zHv!PTR^<TPKz2vWSCwlpe+9>FD!3y~t8K3Yw3BGt-C)3X6N&6PMp$TX?SctgZ(d>S
z?H~*e{~RN4yLDyU6i>uZ^*6;~%4y-ZLTQ{U60kT7Ah|)Z`c9;*ubqk`d42&)N>dz`
zrO8>aWoeKUgkbmOS?Cu=gKSG`x%-JkDK}W{zWy*Y;w%A(_oOIn#o^!GmB=nRn<7k<
zq4}vb_q(5}lxwH-JfYv_?WpqC5mM-3vm$oM!0<!L2%Y*9K~v855i71*iia+`I7C<6
zU=QzKvs#21BFe^05i@Yq1hyCI?&k4feC(6m`A0;N!a5$aUH(Ji8JDF%B&}yoA&8xM
zGw*8?)PJ6$t-N=K)9(UFaN>9p53~Ex_ECq(G9RL(=4i0AM?MXZn01Cwb)==Q0#tOC
z@R!V-`C(kY2t>4<-%%HSni}y&pw9rHLlKPeMl8sKVJ1PU;+P|D=1>}L=2oVICCPIo
zj>KRSFia79^IdAinYv!d=JI(=1R__jLks!-_Jk`udOH1V?eN4?FdV><AmI0@)FHpT
z#^>W;h~&L|FjEZL26w*;@}PQ{;5-F&3Q@3Ej6`6QJHBsCv~&_gCjk`xavCR~k8i2~
zY+R=?T4V?_s4zfFR}bX#<rQ>PF(IUZFuNGF|M~p@K}~8!g3dc?HKlXFbbe6FU~UnO
zDHCeD)jacg{Lv*J1~2nKl|2_8_O(IVJHc>j>Z)bRJ*hC_rKh?qNb;lg3EVgLVu(oR
zCPp0#jNx>U7T`wt5F0{g{n`Q?S0T4bVT;p6<rox#Fc^u$#%Z?$YR@iqcmnWXt{<St
z6rx;{p(s*2R1jw+*i>&YR_wZb67Q4h?V1LL!VA$Tz;OC^CZZE8Fu@knPKMea+Z$^p
zJP?2KQxFyrSxUPTqjm7>MHODlTt!QJZ*G;Xg3S>pYmi7?3sWL`sn*W%T9`$|CN9Ot
zYWuqc+mS!tE>OvfbGXYuY4OSm{Km^vE+DCXH{=9)P+WoL49!fA&>uASVchP<r@g3A
z2PZ6Q#=!ETWpI?J7BWg%Y7CCw*`c-d7Pk9O2;Gfg$vB)2VlH3_R&GJ@masP`ZB<T(
zg{PX?k$7~8S0o&JxjqBIZ%zEC;Lf}aY?tw6<HP+x52r+D85~mf!HxJ$9I(plq$&*X
zyJ(rXAAfh+c?>A>`iFs;Dq;g*EnO73itX49QD`w4pJ1-#Cms1;GIh<6gaezXU{Y#u
z>O${qulmxq9=JfEfoL`-LJ-JG1o9z-pbaL}CW8<>Wk}I6IW1LE9bC5v&*{f)pXSh7
z!D}%nH&N<TG=Yd{ZFuKVw}U`0clE$y#@=TyRo7YYxt&O>UlLTP_+%1UX*i$fNgcY`
zqaAs<!vd`g%{OzdO+G)P9l6dMpY0NKazR?R7oQ4*nb*$>kSOaDzbd=k9WJqsOAn^4
zF2a$WbofYPOX-pm9rE}WE_OjrL`%VDY-k~qtksCQZN#oAZCqPz5V2Yei2l$s*>=La
z$tCs)v?5HY9~dmPAw1xro7&J}^3kmdx2Q2rd&}fI@X=N8mp643eK1WhR~wyF^mA&*
z3iNJHaTDGT$slj1c-VW}X9Q+Q;jxi#DUh>|DQvj`I=4&l=>&&SFmXZln>6FS8=>Fz
zfVY&;4kpCzPd05JvEAbHxCGm~yqMCHog<N)Y%)F>HAWw1|B_$~ovd74-S?+?uq5#$
zzS(fY3*iwLm%TSbQH)I^V1>Kka;N3<rDvg$)YMvhg>i7yU+W}x=ui>(b!;Wb=h55<
z8nQY%q9Bwic>@f46omVJKH~isq2d`FCfMm@TT4rRJ>yR94qxRk^M1@>MJ(n)r13@k
z54TA86>ZeHY`*Dk0QzF`t-~jov{Pfd1#u0pj+`98Qhutqc&6OV#>x5aI`YaTBQgp~
zjE?Ofq(pE<I|$;1cnP>10m|@Fc4Kj77o{MIBp=1!&qH9K7wHhHsSqB=?!o~wK--)f
zdZ{xsWym#<Yq#k!9R$CsJMP4HjG5Lb+*$P`FeaZxR1Vy@Z%R)?+7t}%4jT<67gOVL
z0WZW)ex@{4<ZM?V^H%vv4)RJ|m)Bo0e)UU8jc-L-YU3HEw7)$Q`*RILtDj0<>fFG-
zQU8a6it$}HI2ZT_!2}ADsN!GZZx5apikU$@0emYW@b#qfN8Bv0$!Z=_j$eg#_u|u6
zVL!p?yPz<B_t7L@x8s{!a%IX|ty;y-ZW*(Td9S+gRp48@U}!o-Xw(qoU(bW$3aKzb
zk`v~$r1DXM*8}?|FeghvA`}&lz`YZK`BDr`8HoA<8LHwr0>JO%e#}4Qho6tv*`Bpt
zyI=$l-2<f7M|>RbQWp>vDA511Lbx^t*CGZYQ!@Y-H&A<9Ju>vPd*rQqW<!9KkN1NF
z8ES*$yF0^iC5BkGFZ?m?SNZUpU;<K`5?$|JnO|$%{y9)Vt5HWElr=Ibn}9JFgddSO
zH$Y-#d1#nRyCR=pwQP5#dTr^#o3E;-i=sKnUK-qfg-R|5-2o<4Vv>);?-9hw64CMY
zvx#j#v+2U%+uhl_j)<*fddYW7HFp1nAi)lU-X>E2f#^w>G*u(5T=gz2nO9P~mljp8
z;FZ>>*9A_aTStft<(F!h=n!NZ!g7Du(@8envd2IxQn)0+=38q=aS8_^5voOCbi~x|
z$28=jFAT~8tD3!huSHb$Ww*523&cqBR9W?Ubdr25eKVQ8tmwk5Zin6D+jb)Qe%LVB
zOxqbxN_~Gi>@C6Z{aaH|OHUs%gfV?L#Q0AUEaG*!V)uYcX_|Zvazb2XmE!$wTqKyd
zyoUIfr!6+B9H*Ql1yqMXjnzDH5ZDVb_A4Qa%J&RX1Aq<0!{>RDQeZu#Ls9&B|NXmw
z`S8-;O(S?*)wiGDxRF7uQTbwofm}Qp?PA0^KY>m?{&OJI`B9c6L99~{?6i11SHhhK
z^_F<2CEzLX2||86g)+TKd@-yPM-i(EqO?X)JU;dh@yqN0KAr+x#X~(1Oz;|j6*qm@
zF|jJBNPv}l$`31`)Y6hx+X)m2J~t`@R=#Feq3)F#;OMcEzL}{x!&O0qm0ZPGTHbNf
zR}J2GxMIO@S!9^l#Mc8ODs)uX>NmW9xHiENttfgB6W2-xpGYU>X}MI_T2YFbL~-0a
ze%%aCgXQ|`Z{s%_T0sH=Enn9HzUtQ6v&nTk_7O*MJ^{BP<PHn2HlNzx+D|hm2`8fy
zZNbxAIP{a<c!bJpL4Rgcapp{oU(DaL+gy={wxt4*0=SaWZzm4IUb*j6K=g9^#UQ>L
zMYT_M*oh0LfN1Pa0r7rRl241HAf6IOKjq<*Nsj3Lx~TLd#1EoCdKU053XvnwDV~Za
zr{IhseiC{?dV@u{nDn4uN`_^3FFxy$X}%bam45ZTdKkz5%Fa-5#C9SbwJ@~AN6**U
zXJNu0R}gms>^G%upb7%163>95ny~-<Y!8<p&!YUK!UUymgL+iJ{@CBoQycj}{IQPN
z!}zOVrYVn%ZbC8--sp@wQ}<=*&4oLhsly6YG$|YPL#Q-jc&dc9)i>_&y1SNJ*oamW
z`dvM#@_D&<T3sq`lf%{1!wp15o5->ZDKm2|TxM>MZvF2nSfJDEL`4>ldox;+*t-5+
zP~F~?`ZKm>eE?<qV_iJOw_sV@m(bt`ft41d#><siC4j!FSWpY2UdwMPgZMW_xITSH
zxm+iBWuQaAtzW$?g{^3RCr*1bcZ)3V2mbxgZ3)bizyqum|EQ0x53aa_7HBQaEw7a=
ztXPOj*TVDwyY3FGwCeA$=W8iiE$#Xp96rWbbQL~#_IKO~kA+X|ugg*TJK9ym(S7|L
zVWHVnrXW`f25m9^agY*`cH6u9^5hJ5yJD*P@{>z7BY<_d7bd{!BEv9Hf}}mTJWusv
zpb?!Ec<SjKSfm;4vX|2j!NQNSkJUkXv!GgEyS`MJ<w~g6Uu1l~jQL@6SBF6Zz6=JF
zw_=S%aRbS+`6>WeNhF|JN#%rIXJ%c@g;oTc`Z2}KTk{JQ3qga<j>cFdp1)#*@=?ct
zlrQdtdAPH@;-<es9n|(9)AD#KsUe0jfPbLQRzA{SP(EVk%11Iapu|_bY#c|9GVvF}
ze0pUZW9fXFr7g6Jblxg}>xNm%$d&T1fExLJ?6rWxcQ*hO4znr?kHE?A+;g#Tp*;mg
zBa)MXuz<3x|K&8<`i-W4#5A1ypBw0nz{=~4#O#z>{1Da$@f(lE^XjU00j7t$&~m3r
zH4ufRb%oO3Oy*4;%^TEi9|-s6E?0cCUuijLtqm19fKe%xwG#)~;8zu>k=v#H=?5d^
zG`V%m2?Z8vNV_5L1QC=oSz;7Vpai~nH1ue(nf;GDz`c;>K<zTnw&9Ls{`b?#rHYn_
zc@S749jY<Ei1*aI^w*y$My_bW-5>;Ej#lENy!!k_eCui<*HBs$8QsN-Hp`jXz(ct9
zx$s`e+E4OT!a8MWg}Y__HX^r(vcQJ{bd#a0o2^OQ%kx%#myH6VC;;hkUY^NBao200
ztMmU&T!htt0kR)d{vdpHf*Sy}SrPcC9J$1sUsS7hAF@4z_}{ws?<Y|+QZEFOt8-~l
zNUyPvL~i0~fZ~CDde>PHrp3sMT;6eGtJ3#e=l8c}VL)}N1^RfGXyy0*z5UBmMgCwF
zQ@kw1cyC0E0N;5?v{KhA1LOVryQ}RG;7eHI8FTZ#PxaSdM@#5GOxI6=QQ{$N+J8R^
zA|oymX@*e4Wc7FguJ6@kh1<V95GI6Vwnm7=H*wL8$$$|w=`hZAc+D$kItOdZi}cM0
zv#tm@qC(9a3)v4)$p_E|E0w=FppWnx6&rzAB4MDAq5y4aCEQ3AXf08*Gv$`GAq<qr
zaSu>z4U=VQWDQheY@mBF)yjsB5;+VqMY03>{$z1<m?u2nK6UUlrrq=_(Br0Ffv#eD
z?9}%Ft^4{;HvJ0pWYbTeC!9V@b1IQskH5#r=pLF@py#J)$NdC)k?D7G+S*T>I~zL-
zw=rSLdbKv=(0#M@V$rTGpRL`9ImDP;CiA3;oRgr@aXFOTxyWg(h^~JzE$8T%0PTtL
z1PpIRMArY|Wa3>EDHfJUnMhMgtWul$)Igypj$xZL>wjY|@5h*!Y$7~%Ej$S0LvAV)
zz6N^6tu3m0xwj{a#_wlN*d623jLUY?ufmu2k>-5K*<=rOoGkHG8;;HwImoH;?u_NV
zaAx;nw9jHvZl^B9<v=FK9fM1d5rxzwqPwoY>w&fQkj~|dJoBNi9|58IM!7DLcE%%F
zBvoQ9?2|=(8t&-15M0krdz!it2fc_Tw5dehW0s`<w7Y`4+~DZD`o9R7`Y8)?FNW-6
zjXsa4Be=#dH$(8ifYZ=ieZC(BqdPGgU0LkGRz3UCq$y08`(~(zK&;VoB=OaT%-~T(
zIO}km18k|-Qo(FxoB3NfE1;Mri&vk;&($dP7NRF#0$UoXN#X_cX;aT$2Wrd=tW0kd
z8PpKY%G+XSfVL7dz>Gd!=S_1{N!|jhv@^hZMbK~r_+E$ykC;u{Rc~6skc}W;hgSS1
z{{3$C<_gH~dw~9)zmo~#c=}Jmx?&2~u&Oup0B0JmiR>~wt|lNbNZ3C@^=ERbd97=_
ziROvKoVacM25le0uJ+4t2BmcjWip*w0-FC{+}Z7VkhR*$Pz209C0bUV4b~WHwMzLk
zne*}*=_z^Kqe=4QCk==38_p%*eAmm#OcwIpc4TyIiyuzVX=bc<rpi2s4WM1y@dGee
zKZAMN{E=g1x#8Q{3svt_F|F^nT$6fK?_9oLc&a-=SRQFEyHamZJ-vRT_nx06Y<Y#h
z>93qAaXSt)z59HJWaN=mb#&<Yqd|Tddkc%dU;Z6IK9{`)&0`#>QM9L9qULW-;z2pH
zz$Hzs1F*JqHB1U6235_ppA-YY+9XjN0T*F%R<To9+qkcC!Bex8&9c*{O?KG6+?3c|
zzBC&>2>7dHL_j(aQ1Hd6CiU~M=_*ub%F@<Xm@*!hgV96)m3J&w8sJeV+f)`a=+|TX
zH{x|CRw@2_442@cpl>!Smwy5KK`7O=3Gh7iQvnA~#k&LlX5fA+c>Hvd065DDQ&-~?
zhadX${yA0fVT$EBJ<a&ypJILlqI%87+8;-M1yFTFrJz&P(qBp{ihS{XKwbMee)5&`
zTSTP4x_&N~#ak%WyOy&ckB{OS#X7&70)gwn(sj4Lyl<&MRefg8@#jz&z@9Aws}s}v
zb~4NBo=q6A#H0PjOt-xb%C{FRKlQhCvi(-bHeG(mHt9V{8X*V0V)x=-f~D^!+jcYF
zQy0~7ICY>Z+a36~1N@EPGrguar;Z(rD|saC2Wx6S$=1!C_*wU6lfrNek6R}Oqm!`v
ziJw)5`%C?)Pul0ZxcbFt$9_4GB@w1a1KTeHM^la-mxcYm7MUM3(2)w23VOdvi<hI^
z@bkHkm#0&zY@lAD^MRk459Y59LAQLp0Oqd^3Dfpot&7K!Fa>i!!xjn_NtBa-#^q4|
zL$Fz=6g#&H^%Cn@w5h-5o?2T5MA@pg;$43g_$V%98IUwxRT}>0aTL_tvO>~pNENRg
z73rcui?em)JOfnFofadx?*@35ppjcTC0Rjr6@_fd2BgQ>DpJ80%#mE8rmuth+C44Y
zVVOHIh^=UTXW$WeD(DV##7l(X;6NEO!0?DOLfYKqt2}EoKm}hgN4yXw@Y2!MV9q)|
zTc~B=yt+Ta8p2f29p-NY_-g@BMMj05H$zqKPkTlGGL?Sm;6#qnNMpj&NLTO$bK;pB
zfhBCLU1GnCPqzJHC!GjmQ(ZxKnB!8g_QsVqG^sZ3WsMY;lcnAj%yB3728dr9iTN{K
z7h2q>*of+LM9fRGyXi5Xv9G6UxC^!}1QI|ejslX=S4RR=ea+A)q`?3n^{{uWG8NB4
z0y(Lq?#%#Vdoc!-So>WC-C>TZQxYX8I}d1vsNe&0MmS$p!1#{-5_YRlH2QV<-J&Y6
zo}w>rUjN2|;2?D7)cOtl(%&@mpjvSImHmK5zxKcbqqP-)cE3nJWD7`XM2VQ%vDYr1
zr^cU5`TC49`wN_=Rw_BzZ3nEMfL;c|uq&EfFIv~zjr-w&W@)ZB`@Ml!5cobWxAU1l
za;zhU3ulK1ovs0O-c}HCs}nM4K41Apw2drouS0NM`wBpOL3)p`{U{3Mr_$}2<OYvJ
zTnjm~G_v1Di3E%40nTt#9(5Jdf&E%k4vH0Yhxyh7f1g3D;0w)hhHc5&%U}<~fT@O*
zi>p0x1hi?yHMMbtBa&#1?GW$^c!w=}Ux^GT=!^i6Q;`|wQ*l71e^o*>bXJ13AN*mz
zwhI1NQC<4^q6o1?GU^QWfJaJhhbOyv=^vvIbvv~3K}>$1OjN*nU%_{Dui+^hABn&m
zMQ$0Sf-ZEY{796WhY4n;rclI<&KitcjW?a+tVj@3Du;5Ukua)A_&(27KI2%3vLQ4&
z^)Fk*V<Dm^<SiK|8}bMu3Euf;4Ak>LT%Yk8#Gb3k4|&;Z!MR7F47F9ra~|VZn>N^E
zPVeFN*J##m1gf~z)OkPjZ4lR`ZwY+_F>#|>={2j{LA%eVAVN>$#Ta@~puz<r$$pi`
z!_u=HCt;2tK8O_ao5_jL#qm{)C;sq+lf$pktk)nCn;d=}1M$@j@W%4Eh9d#c;aA0R
zwzFCX%ZH&mxvR{x$ihTFKNE6e8vnE>fE7Y@P@{MV;#fg_HxPRP+Yj-OLR5$g!cZ-v
z&_ZC65?=|Vv!9>L+JRkt95Ts$gbdi%Tt4$8@^2;3JUBm^zIZvf^24Q%!;F4Eo$``5
zue}=p1ut;X0$%L`sB@`T)oa!UYQJaeJ4=JRPHcY0Z~L)d#HKo=(|)`T?kc-TDCgP^
zu<sLdCR-Un+;`vlZ<UI^DrZyYA_qet;53ev&*iJ)I5V3)xO$wMFCPITWUGyFzIOSS
zA$s*_ecpChf?gpO3B4Hz5du+;YX_hQj0zJWgLmTf(mSBUvh6~L_o!^8x-ht}$7aL~
z-v>2aaO@#2sa3zJ^Yr(E$jan-pjL=GcHfUMxytCZNi9cAHxm2))**bIA?~-MzPkTg
zA<jtO4+h^4R#voOvUhI~8}wlIf3Ac0N-U<g-kk>G{mK4*cF;)~gZA$T$Aowu;#P<=
zX)76NQ$=$eV6Bn6zpjR<?G*fJFz}5q%-0%@-iYBp9nflQ$_(0n>k$4<5L+#z5XB0m
z;zvw`ukQb@Lp<crdr1Dg4zV?0zW(sv3bEKmO+0<YwFn8=v9C$11sE;Gv@Jb5K<&w9
zpf{&njZi>!cs)wZMpha3qscN7mT{HVNf^=(vO;33NR6*hQ_qt?jE4cNzXmh^D28Gc
z_+R4Y$8qb6QTlSrx{lG%eocC#`F&*bDuVPxQnN&0Sg8CcCIh4BYG;c3Um!@~u|k9+
zU^p82aO!X@#KWn>2qJQ!VrUIGS#ej3czuw-k^&=$p0(+xh*AgLEg|&Z0I?4!D#YWJ
zu|nLL!B%v5)(rKTeWHTYw*tcYB?9wg7c5ui6FYDqpflQ$5cHGJ&m+Q~o>fa6kMT1j
z9D9hzv1`Dp)M*I#bkf8TDJ$uh_l)jHVz=)q68<G2KAf>Q#)OX{KAig2o`#sT{fQoP
z-`_U%@s)SNV!?py<TwWMI!umSRwJ1_i^n_scMD8PoVi*|>gz_4G5mFycjpo#Fn*Y*
zyYB8=*e%T2N=TNqE63(geR6;ui<A?ODvk-qP*^$T?8tt{-zfH3*D^5cA#Ty%DvtA1
zA4GWeUgNtSghT%0BuzXW6jP@4yz?Wy4)Iu|%{xI%UquW+=Z6c0#0B)+!i;&MB>NBJ
zBAh%tfa2bvhJF7gzEhGpviGCOS5CW((i(?t6}WK?j%XIIRI8-90Axa}{T<29&FOKk
zkVf)jVzoH$h;|kTP`KA={3_}AFf^SFMM2aZ#Pv*(-EjxhN<R&H)9eD>Y0}Y&5Uh$+
zkgUh%Gr|u7uA{MTM_-C?VGv=rHWcK3FaFQ7TwVxNb~yJxl1Csnxhess8q7ya5XF{L
zxH#;tPOcp>A2gz4f8J^E;gKF$pYp~)9^q9FXPV`jOja#WV>bC27UO{+98;fx^%GZ{
zw5G;xR|0+(CdRB&w7lnRt@DDr9E;{Wq!`A&5D2ij^n)NUbx^)3X9%}kJ^z5u7<@aQ
znffoqg64ZMAw*5jN8@a;pG|oPpOGjgOssG5dm6uU`%6(Y;@%G;p5Xj1zC)?=KGe&n
z;V=SzSBotC!lOv}{V(yZLig!6^do;329tZ(5{xqNd`x|#UNAPC`bi7M=j_ry1x|Ov
z%$`NS?Bb)aV^b<SfIprfai+LuMSkS>uQc-m(u06>H=tH%7(wu{G2}=gEp>kr>On-H
zSz=BxK@`hBpXTplCz&DU5TTMK0G6@P<Lp_1uXPig1^4T^Z{riWqVM6*8w)AkiBbfk
zI+e!#<P|DU@JJVqL3%iG`_Tmd>!3Dpmk(9>`2bU-gW0cPicJ*%QKu2E&k|G11x@K^
zA)!<#lcUIm4%J0w9!%HB8NrK}W41JGV~3!-^aSf9$D+^H6RtRqykq0k;{$ILByg$}
zb%B%%j-*rysH5+n26s}<I75oj(IvV%){n>MWLUJ$vS^H#n#g#!CcUGHlfKG7PMTqf
zACG~ltk}2#$_JYx0pAAHCvly}?yE;UK8uqMWPN-U(%c{Tk7f~|Q1_5gPVB_9M}ZAC
zi5g2%^VLF4X#h2w&m$zGQHw5KI=;C_1twe`+5-j^Z|s?#8!m0HzqZm*WnVhX>?D82
zxu2okyJh%h9HEP~y%$SSNOMYW|4Yj7-vz!8Cb?+wVHQi<>jymL9O<Z)+r#O5w#X}w
zlwQgJ-!W3P_K6KM<q?&?ia7bdOs6RsD`@~-FfRp_IsYraLH6|>Gd4A7%z1F>!_a7s
zHs^TQ4?C*VE7-lC*Ca-Gv72%4`?2%;EFfHu7qmT#@z-AuCi!G8?I{#^FImmZE2$$$
zwq(hbZ>B6(3}l5q2@L)*aM6*sV=NK_g@ufvl}P-JEjS^Je6EVpegYgY>$o&Gi9WZ(
zi*XS9wV<m!J67?2T(8&NfXxW@-{`5D($%_-oXeugF4pr>g`?=fHSj(|Tr{lJ2amb+
zZ#|7uR0dDdXSZJxM?MaofwRvLB#K08H6wQWz*9Wom`Aj_U!UaecF5m91+_k!;)C~t
zUXB!mF+7qLTFQw>H>V^uo`JTmV7tInb{(%TUrLdW8C{fKEJ#r)&87eGj4hS7!bg4>
zl5!(38NV!**tVL<SL>IQ_uQGaXs+=idv<85go;2<k7HASdKTbeSq2lnVm&yeIQ4(W
zFgOeZ@w-`teWwM$!4>9C=-A+_hn9%MgHWj3m;Q6SgH6UaG5mOktu`m<@H@la7iK23
zwJ>XKF8)5T_%yIUHLMh<2Gk&9Hg#H8nfD$VJ+G9~`Ln1^XyRk(M`M{1=MU5*6>h#5
zarkMtG7JE`g#yrrU@ouK_7N}g<n|c5G*W&HV468#SjnBCJEUmM8D&Sg3ps~0OCBfH
zPvPE!9c;PD3_UBq4oR~NF?4wt<D>4HJAZwIuX&XiC`8(a0cMjxPUeFI0?HC5^)m%S
z$pj%5@+SkEbWa(V8LnE0+~71sbwZ20kGa|LT%CB+(tPBE6iC-l&9f(*`R5o1d~KW*
z6k;_9Z5<wRg;F{@`qoy|(4z((!j6CI6{ieN;22IrlI#<i>~0)xxq^cn%ONjKcFIBx
z6+Q|lK&VC1|4AeWA5Ov3(j6F&45M}AFqA`wo`x(E&LfpP)suh`%L&KS4<onNV{G2H
zd|r;f@0)h6<9TikiGI8Rk%I{&^mO4+an8<CsS{E+;yJYR!=<{DGh$%<fUfKD`_~~r
zinx6LOM7ZcH$phtTvvvqhy2|v_J|9@rS>Y!4rBQ&ccNjp;qa8Qnq}Jot-JX<fjRDp
z3KHXxGm^{xWj@K)5cWB9-*?EFejRx81bI0s8AaX8_slTGRyeFzVN9D5Ox<f}p27K@
zFlsM%2)4Oz8gtpog0Uj&O%5kl2=ByeUkSuD-nQnT@;T`wr~11|QtU*=xawPiML8Yk
z#gZmWrk?aZaxdv7p2kSl2hV|p5LNBqX^XYx5&hwM6xZg?l@1&yjvK?hPquOO%B?W0
za?6<9JZs!M$56`ICuNp1PdqGbwF-tNENKBHn8%35?abF?W1qx|3(%p}3+Q6*;s{kC
z+D5mOmDfVQRQm%)OHE*E5roRBB*eUPK#hw-vI&cP4b^L~W;N#T=I79x4zD-k^*Uh+
z;<n+w#`Go^g<Ps6uT$KZC2#FuQ!mYBV<jir&fc=rQ=rG$6cJ5rS^7$qM&jT8m#oob
z4XYnRAty8?vnTxa5_Q@Uc_SoZza->%%sQW`&Y9nyOJd74iC2|h({L#@h9ddFDI+Bu
zi&E)59{F<gd*NkYkAJz^^sHgz^9?jpJDydj`ERe%vNh<u9FfSOI-Js>kzGb3oDd*^
z*v}t-9j*yH>4PKl{3fQN;Pb}hX6mAdT`n02s^_H@?m8~y+y@EcpsD~15s*{HS;pRX
zQkvEi=*V;kL2;vB$GysYS|hnH1m#gnccRpIFJ_(#nY?>C1x(xPO1XSVFuJ54_{o9p
zU%a&OG6o7nm++uX%}Jb_D*q&8^PVEY-mI{kg`rfip}^<ryey^41FDcAeoM!Tg|W>2
z5Z^9O=i;$%LqQvDt(<{I5JH8)4$5*sn-fdJF2^H1RXU+jI*@ugu&FGU?BGiQW?z?B
zhJH{K*fdi(0LWm+)u!=tMIAV7okP}gsGYFCjEzwq{r<#f(i$3l^t_!912eF)^ZrHS
z5ZhBL?!;AoL?p}d1evDBokGk0I=A(n#oewjw6v$7P8og~7=!Z{@xSV3R5DGAln+uE
z7P`H`fw0dK?nGuh9#tpp^wgn9y31JD(f8qz<bi+tUoxD?00sKjB+K|$3F~DM{rcuW
zaFTX7@hOH{(^4i_o84rx`|sQC1{L7f3;NeX#aP)T8deDq6>JNK2$cmdS=HZZHeCx*
z{c>^?l==P`&|7n|ZkA=-uZK9YI!jEZ6-36);-d03e}-UY?!Jma3*&H>Z}@GmM=f`%
z2;Ec92G_L`!$~vI;(rQEmJ+bcYg;@_v5T2@=Tm)!qNmB}B}!@{Bc6uqFCoRqoHW47
zIi`+XsPlh}5he-A$6@o-u`$hhLy;=m|1vTmJvP0rxw8lkUI}xqxU$vINAXL=*LbF^
z>h69l9L1H+6t#T>YnEmW4^<6%?4ZcPd|{n?gfi+}{&t)hyD@;igdnfIG-ac^Pi4+f
zvHx96TF;-1AD^c=8%c^VX-jn$`_{dj!laEc*lNbsrKvSrOGkOgl#TI1+5cMRY=qH%
zlQxpEZRTvv2yHQGV?0N=U?avxw=-*x=A<KySPc#lmKvy@FI5J?+5_f<s0}z(-)D+-
zRVEXnRzcR|uN%{H<ek90ro=3g=QEM%_x*T^2WchIr>j#kO&W2Yv{_#KV##wxSBXo)
zy){LnIxH69tn<Nx`J7aErYOL%gSVN`r{`1xxIK)ubts|<)l2EEwBzaT=6jZPN%Z(l
z2@r_`D*{$+QlXq@riVFClCn&m+9+tW2H-yMoOhq#9E;hrj4NB*gtHduw`ob$M)Zg@
z^pMU#Tc!0kXFcSuo_|i9lPAa0jd8SkbUXOH96^z`n<?5P+3CM!c8wbTJu|rWyyyop
zFYOX)-IP{J)T5foFQc-yb2p?CE_@piGg$JRw$}2EHK1LSYvmS)*3(!NXk|b+7+bA1
zodp(Za_gy7CFVTZz-+~x%4eYN<BPGAmcAZ+<*&pYRrB`I*LQ1OOQZYI@-8Ut8y!xl
zoC+5xnUNhm2@G0oSf}oo!^TUqTGt}uxa6CPKa_9(C8`B~42&$FDy-Sl>DzWZ)d}dY
z<w0bhM5W+vydK26cjG<1x4(&?`;&NgH~yuPz^`|wF#P?l8qw!$8i{}VUq;znJFlEW
z>R3y4O0eFE_f5<lI{`<qDk@=<!D6{{G-%vrX^uP+SFTwvQ?<Na+K1dr@N(eyMOY%v
zMR+S<dc_{;v0kYp%OOrxj$3@&)i>kIu8I~uP|i0CmDR8tSPM9<T(pgrw#-aE`dQ76
z`i?c0nU=hmwU_naQ4UIrovMa9pKZez%-pCFdtAV|HX8kDcjDYmPk|FW@5X1Tp8wvA
zdGrQ5@!A@GGDiOZGlESvWvboW;U>kImoNQmn9_fZgD3tqMAg3t-^=k`B|K0*j$$Gw
zWN{@2b3L8j={kwe`ZW?!8N2iUdv&Iou@en%?r{G)-Z7GcsD0&3gbL0Wo2&8ePRuV?
z=&prgWY~^rQeED20m7YGae%Ufa3|>QH3F;HVW^^I#Y^8DzSF_B?gbxzb3IJu+QaP6
ziu|vQ(HbY?=D+=2HQ;8aE!%f_(7Iog$v=x1^riQbMPF0ZF#EsUqwkoPBoVWWxjJ+&
zW97Y)-9z_)Ti$acMsjL+=uT#ocix(_VXwj*x*J;L-K_Z3GwFP{H37T9D|yW~KPGOE
zc>NQ%#WmVC&2Kok&TZ^<zPR?okbHH4XJCOBQ<6>^f&40s%3yiF9y3B7(Zncx^4*rb
z#G`#jSgsd$wn6%#dtYnr<&#J4w^MqI{7aaX<ML^F@717|ui`HlelXcYwWlbAgnsC$
zj(%{PlyUE^95Aq*eZgQ$$s)@T>6>#7Bd8AU>(()qT5{1Qp~^nyjMs2AROIE$DW$=l
zl8`OietoTd3aN)SXxHadyWG-74^Hr}&i?Y#$@Y86G<|C=5y?((pMy$Fe|_8?eVo6J
z?ljpHU!&HjsmclC{-kytBB|&X5x3}2xuy2C<-IEr0TD&1{;c>YrBH>Rel}N1Jj#8`
zhF#Br2)JsOx-?9cE1|_-Pb1gkZ+x$kU=>1WfwdM}o(zR#uC|A#Hq~;+QtNbo4|R$0
zGOm|RhCg4&3^IWoTc0eN7~`$<>v7vJ5n$t8Q!WbD{+&^BsF@hAUZ%E`WmK|TO32kn
zoRN(YXZO#8wTIp>_A-sVVX3-$x0G6y!Frr*_4-*lE3n)xCBW_H^l@E@j=7putjYhA
zDZg4qwnWxC=8}lOls9hYjr(f6j=Zw@7$1o2J(!A<V6IWFEHtUtAX?4ww%TQxdMKL1
z3whfolk7tk&!eZU@B$;sC%r9bi_ghFYxwPeYp!^^Lyd|&s;S33)^a39ca6YDIRJay
zNm%uw*TTv{uKO}@tn?>e`dQ@K?$bP!JAEIy)gR)HoWDw)WBDaJ=&AhUk>HEuE|rF@
z44VUQO!5p}kWOg7FY1%l%A-jFwY;Q5puBlsGMzQ1AEx5{mDqGH>qRbiCC25GuGK!y
zx)7D}TAQQxd$*-FfUoSHcK71FB!^o)P2cTE@sdq5Y$`zi+D$v?Hw$X|)tv;g*py>y
z-=T}3>OOGiC$vc}U~k}vx<*o(-<-MjL1-uXOeO1a{N19p#FsUD<{8rM0l`qoe#)NT
z1?I%ztr-W^*O-lPNT2C@t2JBlsLBqum3$9vygF5#D20C!H70zY+ptFTT*hRcL3+l@
zt9Fs+?RhR~*N^i^w(IagkF1qVg%;A2Jh}qB*c7CKx9qL8(NaI65)^(E-2P+W>gzd9
z2%7bB&{{KBc;P%UOR-!$QEOV}$H2N4((8QL`ibuXXSOlX)aip%m|OMS#>?|auLtkk
z;Y=eO=PMG$Vr_^=mGwBjt~1m@Pg<mcm#(uyLA0f<dVwSIyQE-^IM7TV(6ujPBW_Z~
z0GRgL6+1=q!Y(DBcTo74C>~no`46>@s(C6)tg~<~xIT*Z-;=dM<(@mvKYI$UMTW>4
zFr3TvOId=?zx^*+VOd{J>emX8x4OiXFp#cRKUGbAIjrxmF1;C57M7WyR67$bJV}Rs
z-Nd;q>~>j9>nSblO3AF4_fd%|yD!JOKw@<{mf(c#8`DuO|Il#d7+7xyoKwNN*1#eI
zU}GJd+Ri)EcMHTf1CAj6w+7z7Z8~eqAarhDe;1Vlw!V9HuGQOPBxFAi%-Ph)8nN}d
zw^ifPOI^P7>zG+v@oe?1UCtfp8TB%9Ivx9HIvqm;DxXzLE~<4^Q;_R7COZNbUys+P
z@iJY(_83gB7ffFbSZ~FO#Yk)Zcc&V3x)v|Z%{-;i;8b#dn3CpE%6{K+q18pA2xYj)
z5U<|vpv8Zjd`&O;ZN2`m<jWpN-nm!)-k37B*FeX9#_NbQSzvE1_4)m;VsGBf_@(tZ
z+o6J0g?cOCy&e#)Q<o#d6TZee>D$_tp1N%ZJyG74D&SU{zCKwYQ5N5}r0htiDnG_|
zZKqu2hp@q7h#OlqVEbrbYd*oF^K%^QZAi$``60b}GDuYlEqRu=<Fw@Uf)jFl{@KyA
zWIA1p;%^p6ruaU+>h0E+3P4&lVr15$e;vI2)nvu!3dm37cKL}l{QSfktv(&r!)k;4
z9z7Jcm3zj2*&pHi>ffaLTT|m$YuS#0Rdq(1e|}h1YiN4w<?0x`s^0L-=8M3pnnUDr
z5m;4s;0Ul%PG!?nO<@&vv`*sM05ubigmMj~m1tE5Si8<@JF>xu`7hPPHP6$+bBzpb
z-&WgR*O52o9CN>pSW7row@UiR=Sa5Sm}aK;nxi#EN4eW$NRF7vSX-8GY@@D4PCDlP
zR%lgU*5z_5w5l<Vs4K0Gn`zaV*P`t-X9~>HDoNp!0@gPn3Oe-R$wW#P8~mt>r|}I-
zEmqog@r@qfJMpVaz5CiD*C5`F@m=Dj{0YRi(6YX_#xU<qGq@k~VFv88VY3lUiIlgV
z?C|5a_M2l5JQZY%AV!>L#)^*6N(D{NLnXscqu~5`oO%B=p232e>x8-GagI_*N@o-X
zDc?{wqzF#2&MLl~6F8g&73;Ei#brP5C~6AB<Rd5atEAnYzVD(kV|^R<vACcTrcd8@
zaqRq!4wy|9G5bZt$A!*Y=L8+Jpn!?31vM|RRYlWT*w7Ik^~(-Eib6}_mU#@R7B|H|
zAGN~50!s}fP%a*e&eAEBR$0`2JdMTiFrNpG_aYS2$@IyYr<1AG(oJ1}VPqUkJBM5j
z89_pyRSGvfaWbvO^#x49=imO9H0qh`7_Kab^sUO)l^7qbd?|E+IqlzSXzglsyoHeX
zp_wC0IMpo2OKji;l8)YbDXP^&7w%ha%y~0nTgn?_Y|D{&fORp)F!H-lci4kR!wlaD
z)QDH}aSDB%SQ{He>f9h9C_ErQ8zc4^=F^SAglquTjkZpt=0LFfF~=TL$mC=FG2~x{
zg6L^Ce)osTz<(BW(K|K)>K&&Ssb~GyA=0ciej1-ER{OfY_hE9##3s&lU8|na(?j>#
zQd=1iciWgP4S%IZx*)wfgyC<ZJCsd4?aJG!G3>GGKj%6Y4$cRpXqA^pGqLn`q~C;l
zy&Lfw4;<h)d!*)e{QGWvCccuZXjghF#gLO8i=^1?kT$4|A;pn#EvA4^>CBhB^QgFU
zcRco2X*H2ve^x~eTWgMVB<eVf{;vPn8S^pje9PMRa+9Fe`-Pv@Vv#ACcs)*rd#}cK
z%y9HVk}ggcbsXSCak@)A|8Y|XOERL30=|n;$MwBG2M7It105*j{v56t>4)6h7_a)R
z<l^g?f!-~tKh_)DBz0+x@Vge${9}~owD*+`dcWT?Dio5wSSRf}93rmM5h<2Uvo0d*
zh9(Vl08!Vs&6g`tLt1vvE$5(bw)2&hUt~(bd19&YS`0^axF2b&<h94K*4~!h@AP)h
zIJuKfl@Fc2=Ps-4;ZF;{Mk{~+V6u@UQ;G-raGjkJY~VG1Y;z{K<TG&?{#i28diG_{
zUK<j6{I$RI=zSdj)2X+-2AO>?Fc}?PkW|>p72yBZh$f*Xss2}C|CzJ9Qus}l?OG&~
zZ2!I8U6DbuHfF1%o{p!hlZ+`DBnqOV?eJcnI^*{z+<3gvS*%p7VW!`&PHP#&3k2y%
zIsGYhE<L8l(5PZHe$O6=)6Dv6%oO~+gRC77{@-YRWhD-+#1<hJNNnwIWS)+_pGERr
zj}dm1gsof8IYwPb#7iW@885pF$B|!ZcI_=<EnQZXY^WAG)c>DF6>E95!9<p_XzQM^
zwV2#N2Lk^>X?18KXSEQcPIcM;#L(V*jA?IKu}5uB{n9eJu%I{@>N|yRGlfj#ktX%5
z8@sfB`{=mDuE*v|P@uKzf>-4Oom6LQrMmiKTYX&8$P!|FQy$dA%*n7Shd73{1d%xs
zwV5{AkEYHw9(46MeivUWX4pYz%H02WviOunk<~Hp)j2Hco(~oysR-ozkzHA3$+L0>
zm6t44ip^ST_g%VzNBnnnS~C%c@M7OhvPPVvgGQ>=`0E|l{b2UdPp7}?qa_DJ($G0)
zF#ELFv_xOI&+?Q0pq0GV-X8j74q+uI{E32aaLKWh*!pamt;c7RTcGc(FS-ys8ijcg
zsbGVbotbrH9*o8@9(Q9coMSyW0F>|UhsWi;=g!FEC*Lp%YgE`NANZ7`j}Ew(XG-oV
z20jG`dV7>w)N_8!2Ye$B#bfR~%<z7^?#BPQt3~wqD0ti21-OC*!Me5DNKY|kdVX0x
z7!OJ2p%@%%4ka%_1vpN0`fd1n!>PRfUCe|>|1mco(ZWfId~;*R>7475nsADhOh4-0
zCpM-H!7g469JDv=dE+s%hOO@&W3=@_fwo0U%B=GrX;-hb#_o!`1jh<iUDlOD$B<Ce
zloC_^mB8VoILC$(&H5R`XK}qu-T2OZ#>s)={vz%DSc%K03h7B4k3s=3IUk1`W<w}d
zam*9nsSz7B#BJIDQ{y+DnDTGpPJQ!-BZ{-_=&0ygTF+`F0+E4rd#_Cs*R4@bN}#k8
zaaX{}IvKpFVRs7Kk{<go^wq59nSRD>6cmjy&Cy%hCw(j<?eF4%=AX~{z-^uf2Obdz
zWmKj|aTMw;H>KFs=&#J-mb4ke>N(vAZsca<R_bgL+i~hAjGG~S5Yl+;{m8lRzd0Fw
zAXe%g#(_}{<8DY7vpWvLlLCPQWxkz`^*;^<+%^_x)A+ddF(yl0mTX(PGCV?-(JbqD
zN|diTk8~>tOv_>I@5lFbrySq5@?uFfl)Vz+t-@4n=-M`4Ia*U|pCxMxQd~(f3vYr%
z9kLkWzTMrG2oK(yaKbm$&F^x!P?R}1)O3Q!Xi8bIxLg6|ngdp}+RFXw=_Hn|e^{f?
za@(P)#b~4tJlRYk=hDWF><x>p^gQs_SX3E8+M#c?JJ2_6=g)WHnCQyCGzkHfzdh8^
z^{>p=^S8gA-jStcc{v)8HNs2NyTf-~o9I&)kCqf7a!^bH4Q0=<?dfe)_(<8YH?uE$
zKAhuuQxt06jJfldMl5{;UG$CyM7>ixn67(e_wCD5yST2<w|@WH?wVJlS<p~k+g;ys
zgKby7=I#0V7dx5x`Hbb;<=R&RUXJv7%q7QSKD0|4?km$7f_e38)3vl~wi}gb(^nFm
zON6y#gXLFu57CSZ3Iz1(HPWJiHQc&I%B!*?`pxN**c*ytttO<Dr~s8x(tDBTBPHnI
zYXjYRbMPJ8WtLoPIX$9nO9AM6NP|?&x;I_th<Tjm8xoyDly8WxbSMY>&?9WH`|wV*
zx5w&xbu<tD?SDy|n7uP?X)#ML%egvc6lRi#WhT=`<^5TlZ96DqWY&~;!^?|cXjv9~
zihgK-bFCIbbcCKDuGQm#Db^|bk$+<&${W#$kkkXeeKWZ{UB5P;QC4^e<8^M-SVIl6
z;A*Y5jruHRuX3vV_t%Y9)QA$xiGEm%(?9Zy%WorJcPxD_Uov(SUp4B>6JD0=zkaFG
zOT}ZI&ElB&gTEzD7<046cxgRrS!ZkU@NSF(#i$*uFI|ptMqXsOz?5=E8)p$!N^+6%
z<6oH<j_0^um}|$fKWTNi($GsqF49r>r>N?VPDh65Tb5a|slu$3Z`2y?vdxVtu&v#A
zZbR*d9|ykc#hfMN+H~DQ_qjD@vvKIBxwXR|IIMK_g%c6ODz{!L^7tQzc_BUU$|Xf2
zpLD6NJl1x7Vu8Q;DvChcd-MbWfmkc9)CP5#cLZha9J>@nPTi8A0eQ&}goeQA+c20)
zdX#4I{k|l}G+D=3>9QzS&)7@cZp66iM_QY8&pWNp`yt&4$^6)l%~Fz<cv&tkmKMvA
z_9<r@ddMizPR-TXso`+LM%8jywS{}(PM&1Zn&CXW{iV3_c0g}U9AjvA&Jrh&+q-Sd
ztE=V|JA6h|YS{==^pBHAFiDK1(?aShYKz&ZjKZoRGk$T_L?s-R9{eV0(r<R#OOC&|
z(_J<#Pz23$j|u!muRNWo#cm0&h0vSm<!lHl2#ov0oB4?<K92*fZCmrD%heJ91?j1_
zTgeXnn^*`&8)@>k0+u-1(xB2EYT0p_`&;G4;kD(h!ZjV+*~v1wt-Zy{mO|SU2xlo4
zEv;Khaaxbs?|^f4u~7ZmvX0VLl@G>TwceTzbw2fO>pK`G4z;Vn6uC0XI|-#Fnt~Qq
zbDU(>ah6yT+G>+dj$q3PJan|B>Xiul@iK=;Q&56*8)8}ug>8bwOiV=zO_q9N1l4Le
zD#I)LbL)pKb)WQU2K?Lqk^%dAvUP}yNK_4Y)6yn%G`CHc6mKPFT(ORWX|Yw4WP$CG
zRp^nF&;gDO(05DD?BBhZQDVC<6EFMKEGd?k_1PRZ3rPvR)jFM5m_OgSp+$e)N50<(
zEzyF59~wTggi37Crd-!<tx8R{_9r3_rotCRj=m4AFCQp*?rkIZVR4<Du&C%0^RUhR
zQ<yC`icPotTkWYV`&bWUQ%kb*H0u7W+u#scJ=F$<wT(z;u{!*2giLp*7Lu{^JZ{_3
zHi!_!CT%?_sjz7GxOwS!L0mQzVM@=+Odmwv2P^*&kGJ4=S}g1D@69d+SLtimdZeq5
z*<hrx$1EHt9X7Iry=<r;hgH7-swZ<+arIo%U1~nZjJX_ZG*YEX9Syw3ueBMXN~kby
zkaw73pzxhHuUQGM#&=`rN@#9OFlvxz3a-hgA&;o&k@h8BRn9b%mQT#1KLWdsRq4oh
z7aNN-=d0Psu^#e9!1G!^^&M9*#W8Eq#ZoxjW}T5`a1<Oup?VCZ_{>Uz!t8$S&a~^R
z#o~-s?VwoNq1!RXWjbyyo1<Qv6SXrm(Z;7O_iL?AW8+>v4?438oaAjglvm?g^Sokl
zGiE_$A4@EKU(VpQ-M#l>RE{tuEhAZ__P3P|tRD)4J8{1@JJ7vzJ>U>n02!`O_}C7W
z!!<@w?*ud&<Wxo9iX(@@2-@|aFs-l1%htQ8S?lh56K$~nnjN)LEb4I-dwU13ebV3A
z#4kFXmb_wJQaDhdMP5@@Y5<BpY@L^moj?NbhIhLYf6pd<eH9~oxq<~!yOeoRBfHTu
z^#gXE&M=-CGAuoCEb#thY3OY8xdPkggj56VH<RRHD_G5xT(fm0aT{ZUJTGT>b6Oo!
zpv>;<FNZurYPt7bNEq6vZK03jn^rfj1#YZ#|1gAtv;w8Qr*e5DA4n;8vGYG|b_?U?
zH12WI`f{wLjPS`hfN6as)wR&jEcGmLWj%TXvCi;#n5-Kye-apuQvNPJA<1yVPxO;y
zyS%KFZG@kt-1_b~0_ez(3Kb*nvBEAqTHU@MmI52!mj|&duf*!I?!lMWMqe}%3xfsM
z8t(|(vBZMAR*`J2Y>P*7|4Mjz;qX!12lcFZ@(rx<kH)sFVga~sD}^ns4+1VnBI6yP
ztb1Aak7|j$86(O9Lm&E#(6#Fm6p}UR>poaIUJALn8+Rcycf<Q%o%pP+6>tu(2G6l1
zdAReE9<N5kWGVEfZY&q~e!1hJxccpsA-Nfzg6r+zHl<R0H@w1&rtFSJvz)fFhHudJ
zU&h`Ni@ds%+BZTLnY{|97q=d-?qnMq!KN)vvUw8!i#Jv0M>Di+AHG{sjw}&(2>uA7
z<$Mc7Qg!5rZ6!!Ik(mnyBiPo4mTuSMZsrbFj|W;r2alxYcJTX7$U$qNwtMtfcec8f
zh-wSYLe8}Xdt|@p4H7Q0;>dxPBBWbeCF-@ECJ?XG$hLBvXyxYA69m5=1$~Z*eP0X9
zDO|_A97mw<1t-Z8MO9gH%AjbXd8)+#>7n9Q7Yb{h(q>-EVvS2D$8~|@5#T??ahG`1
zGnqx0E5W7j=Tb59N#yl?TwitFpVpsXo&{ePV?1}4=w-FO4IISzhk;Rcb&m6?cOr9y
zBkha%P&SiIc^Xjq8j;7=-1+yNSq_(wtWDSvvcV;^eyN7z{qM&AH{*Kz6I2?FDBFFS
z5w&IN{m|vZ<4TH8GcGe_*9C{2?4PaTl+%n#{{JAxynSHQUtao8fmJ&uz88;(h5bvs
zLt7q)g@Qw_FFfyV9ou+1xK#RmUPWQFxh*k|YeL4$76O^p616nB6lHnLGc8(5Q&AdB
z{LiMK-3}Q;>_XT2er(LddIw51!rS3hHm?_BZv?jYLP&UAIKrSp>}OF#)w@T#cb)}L
z5PmVru^2hE5~>vFJA4+@<p@Z0KGYu~_);Iqc(jW`7N$@JbFE@9vwxPO5e~PbS*7-!
zV@3LyrkHmq>9RDcKnnqVIE6_#apVZ+N|}|=flx1<%kumwAfJVNYJ(KG5^kld^R9lE
zknM<jzUm&FrrME53XAby8vZ&{v_wTtC1T*=rse8fUy5<GbK43yTFnt8sAt(xw~FpL
zgh@-2_9=y1&$deHX=IEU1wpt{*TfS;Q$rl*N^D13hb7&A5x+uNH4;O2cb>TUb^lD=
zWgwa1e$GiI>{1Y4&-8-(P?fOpR&d~xDD&()-K$C-p=Et(hIz`(@??h^7G>X<VMubd
zZx;$JDTDMNk?4Z8uwsOE))x?c^q*+16jX(SwJ~_oHKEzsI6Yp{=8?{U=kjWww1Lc%
z5J{5SO+DO6@~?0jX(xE~DSQ;1_R9eG6F|GPB0Iv2M|y>XrG+5bLTkU8JepQQUz`%@
zWe<@SyktZ6V`TaIFakLCdTSf&C)2z4gG<+f7L+SLh$O^2rMc>E{3agT(q3$F#MG|A
zH;uVyK^_KbtGM5HX9rQw<-Q~|vYsj%lBD6g;4~V=XDpQ@6_1ddX;TJCh}(;6Q5XxN
zFl&w5Ew4OVEb?-}$Hls~OGH~tYa~$ZO105SzU9-tin%!fZgEf$+iEZ0>6`lNwF$?i
zW+B~a`#h(#*p|Tk7A`m9wD?ub_P>|Eq}R<wIB^zUrnOqmYxK?U=lSObqNSt}mtosE
z*p^}^(u7yChffMf;%rAKjkTMO&O77t&h_%8oZtC5Jd*L8^YffxozIe+b%qb7v}`HE
zr;%XAN$2IJHOF!?()5<9NZJ-@U(%<3b6)!F=f7h{&*r>T`DoIvdMeSeG-x|wdp(vc
z_=%<RQs0C=<D2apWYh8OYb7wB)t7cg<)^x6h;7ExXbhFY_^jBf`lF?M62Y}gkU+!M
zn9f(j{_qKlwA`HRb6Hw0_+FOR=}I1rYy5oeT9mf#lWPRkMq5h>YVl*+nQ}3xRpW6j
zLJ^H}ZYYbqL|DYAXpu5E>r>ScccbGI{5<bZ<H!KzY7`)e*mdYU*R=Q~>|To6NU854
z6%_vMe@Wk7yCIdWz)hlpF;~z6@X078ZSOXZn`2`$+wRl8){-;e+GBA&ub(^y!;E|m
z<7&yc64n!0`QucA?s>Z3CtR7fB)=8a1gOoE%&x}YH{u<wMl2h=9WgdbP``@E`ptMJ
zyyTzWjO$rsV*~W{xZ=%tcO%~S2f**=igOL5pjIT<EPV`SYuKz&($-|Zgr1k{X>l^!
z<j4qlf*VuT|4rD#@1_Npo?`6*^t~LXl-Pcbp{~umwbCg^UaGu1MS{ei^uHe`QK#2h
z=7?2aV#oZP*FEo|v^0Q!A58WgDatL0Xr276vMyQ}GfUGi%i?nS-P*r={ASVI#UtG!
zo+pcN3&wJBOxcg{!b5>|yOpx)ea?N`yIQMrG@@(*>(AK8n4=d{juJYxOH~P2v{Xsm
zb)crGPC5Bcaj}Z&H>U8U_Ko5O2`MzJ`r`P^ee~M>X+on73-Y(N6?|XW{aKG(MSfp_
zp5yd?8}mce^W?0LW44^_p|X3<kN)Q@;@2^@7p6(J*Jr=IDBWTV)OQ;m*<7{PIY3Vp
z(o8L&z&V@J47$#ig>8f$h^*VzvXqRsAFiDgvw2@HZ@(CHUJteF224L|$GEnCZC=2x
zZV*xc?oC15lh~nBhh|(c@SIx+4(S=mx<t9)n0cjnZ1G<=Cz@A%Ogh2ww^OIew=pmH
zPZ*D`e;>hzHp)mU_%?%L|DFlOvXIt>yw9RI*p3NjEWsFArDy!hFOs~A*{YVZRZB>|
zZq6e@$>bwjShVCrDbvBa4YJI4;%&`xGSx~=A1)~A^8$_U6_-a#FUxd_f@F?y`O@D`
zR$dTrS#=4;<K*?wwT?C_Vlx6%e|hTi68&2`COkuH`Kkq+ly>O&eT>T~FHZvc7HxCN
zSJTTDi{+SbQBG3+&5L}-(mIfKQH2C8mr0M<_j7+oCAjVF)lee&o-}}7mSP1HjO)@Y
zV~;xBjMH)!?JVnq6`VYJw8X*3ArMele_S|Nj*#<LNkj7=LA6}5p_63=?|Y~-Wd0=T
zEZp_i^&7<2acXD%V(1;katiu_pF0T9Psu3Vdj3RE=YDqz3q0z8t9*tKl)-c5FIs4%
z48?WUUzHrB<xoT$#J>oBazEE8ffuz}tdk$;+4@{tJKGl!1e1UJUov^F={h`0k7Rq9
zxY&~N&7Wou0cF3OB$GWgS`^KAuim?VbLgYV77=S2dSZ_kJ`bKs_u$DfSbiU=cG8Ej
z`$St962m;5Y^EPPZyv7Wirt{wGwG84>Acv!d^En?!K3K6QrOn+$ALGo$r|QfTxCHY
z`#p}eGEYJG+Nh_UBeFw6i7(Xi2PNT1`Y0x{1T5o5B+&Y?w4=w#oA}2LgEcy|BM8$r
zFKc!AmC17L*AiQGqWn?h{^Cw^f8Oa2lKpag$C56M7B5ea0q!*(nIzBD8CH4-S4l<*
z1#pH=M%D065=M|EGl@#VsK;?tn;Kzsbu6FZC}njJmQQqnFqr51Bo+5H5Ol5ghW)iL
zLI_;1Sx;U$*_<=aNk~1P?I#NPjx7mLc0^Dy$vdTt2pI>KiJK1a6gUvLD&SJMFb-O!
zu-a0=*2f&9svjz-mtd)T3j@KJwSG&$-lkCrG1n(rSNkkd8Uik_>m$!=vYZq(6=hg5
z7;9Ixe3j%HQ$}k%pOhX^146l5nRggdH6usPEvGGA`amNMRR2qwymXhwG{azyyH&I7
z<B)NRN;*Bnm?RW<Ef@OErT;P+n1r^30ba$pXz4C*P`&Fog%*qy?bg5;VVxqF{=cmy
z=~vxJR4GrziEF1aJI@x&ZKmkGDITo`i4z6Bn5t!_lPgcOxbiD1E3fvaNlla^klDj@
ziolqB#pG1od>>h2f2dMkx7`4O-|@z;`b<jIjz}zNsj`~kq3V(;P@|L{W~&l5g03R|
zDVn)#pcyScwe`6iNoLy^Q>n7k#H9jDWq7OK=mci4xZCiGZ!}xl+Au|qj;e07`8^TF
zzHH-Hkz<Wrz}YMrNe#`NDgrQZ_?mx?jtOq(ZrE4jE@R&|u<9Okj94f2S5YK+l5>BS
zqfOH_j<tJC*D2QShHb~~W&hMPOv;LW?dWQO8qZqw3?%u7pfe#{wI0vI!Tu23_?HEj
zu@@NtD0}p3Mr*D4ZE34pUZ;k)PPwHFGHCg?RPcAbwgZ+(o9sDUZYzyRRqB%urt2)f
z(t>53v{uM;E-F?4i!59m5_pN%&D9P*dl#?q__zNhC4S`mEB!4c_FH&F=9&<gP3!n|
zt?7ssBVFHx7iCY@*Q;4m-jP<I<+w+}*YtKv6~lTbQAD<4*z4HRkniNx{a&;EGm^K^
zHA;xqYY;iBeY&|epWc2@3*aR6`Z_#IYxpr-la+;rnp?zc|MNdwy7WK(!=-=sTD<4~
zL;wBFrO&^<`r+B7e@|%rWrUBU0)LFV{{0K_7>5_)!wca6NlYJvSYeXYb4*TwQ)1T)
zL{lMDs=ViB+Jo5Lb;PZ=1GZLa$zzwd%FSE}JQH6%33q_Uy=mmWQYt;C8H(NGXaO1-
zw_lGLQ&8rZ`pYqb`q$%!-^4t=i*yl*Mi<LZHv<Ga9%STl6Bi2MO<k;W;{acnW`qf0
zX5K>rIu037Ozz~!CLhe=tfw3^EbE2E6oL2)IBvy)=i}DUZU%lDEf!cu)(KR%!L}je
z=rah=O7GU+0VzL-!M+P-V%{lAF1zemG}I0!W|wMSh*g<}kbN-WY<}cZtz_r5X7z0h
zrG2{KpC@GJ`oWHWl`P6}MHF^Qu*MIW6u>wPRi#9s7R<F{M!w#i$c8@9osuP7-&;vd
z$4!5S`wIq$-kWGGA!Ak+49i#bRkLg!FK5gKUDe!oMABF}LY*3N!Y*8V%)?12KZ$P;
z<6qA>vQ^`8`J^FUh^vA7B(9$E<&TD9;fBTs<OlE^a)9Gx6EF2E_@ZS8U5{8J`+77%
z{_;Y=(;|tXvA2M2-AWQYUy-vz<^D7fO;(UY+ZI5CR)0{^JXnzcsjuf50z@Y8`{o<A
z|9n}#nddC|!=2^+0ZB%+RSsc5qpdwa2PyJj(kR`ENxEs1cT9fA%=hOn6cj+oRF}R|
z6H2}R@~VgJBzEKV))`VA9F-<CG9sPTAvKiIlXH0#WFRKvlobfj{sudfd?w!0paQ%j
z+i=uXEVxa35A0+EeHarb?`HQh7PiItWW(GJ>Y||4vdV%v#ow_;3in=IemPcIZSaua
z7iUG3+eYSz{#=uuZM{NZFWhqs$;Z=eDhNy$QDrA8gCieIKfbj1w`l)#&s!6BQ0#hb
zxk~-?f6aeqWZoeHFcDpBF;()frmr|@z7zSpGsz(<o~(`$B}mR?O&wU38>lx*N{OxN
zixD10Oz|*;8$xfsNf9fy3~Sunh@w3VxDH-(JhOA+7R|TcS300#f1VC=@tuf{odkmv
zqG8NF3vE#Ci6PNahAM-Y!hL<2eL;{6uld91h8r>1S-?W@IYozmH4Q`G5vmn73EuqU
zOA*+jBi{s-v~uOjram(@J9y<YoH&6JYFjJsGPF_Qo%35nB;~&P%!xDNh%ENLdgZeo
zo5?#TU0)En7t0|Z#MWBX7eATo>l?d{Jt6^Q8_S~j@^(<s{d~58IJNI~-)h+@Ymg6u
zx$3a`F2-t4d)VIr2>kj|rEI;{)Yi#Vi6N{Qhw6_e;ls-kn#k+R%xZB4nPXluw&0-+
zB*$RXXS<d%k4^6TFJbDn30e+4WpO+16-V>XcpjqKNOHA3Mw?EFh5STXJrH2oDVW-j
z(qB6dug1n%Bq?8quxbNs3=!wfDeS<c0WC-Eb+9#DNu6Gj57#fZj^TQSIo#qeQ_O~H
zEM?-;>&COgr?qP%d~7S8Ma@xLxvHIIqcsP8v^Lb=VMlos^?Ok-*JH^4F_xlv0QrOX
z#oA-dMPpP+mUGntId&Qwm@?Nwycb=}{}jJwl7}C+#TSoElfH5%xcuAylC_<z>80PX
zbhO;?nAOX0I$Ny@=d5!CX4Y27awOR*LD43fm!hZOjo9?^QdF&YpK}1td9Wp)ly4@t
zvTxOykK1k6{+eH%5&l5X`IkyE(Wz!bCGNDdN<Z_%Zf@pZtKEmJQ)`X3@=q3XeWp}S
z*MB`7clXg@yYJXOYr;?TpSkgRCw!z{@5KAJCb_j<{<JaY?&MK=??d_J|MwenSd?kY
z7Ygg|OyP=`Y^u}g^AE%~^CM?D3LLHKdCo?L0)1Un$={)n|F4S|2El5xo(|lO#$?Vm
z`5^w@-lYX3T_4AHDys7gHl+)M`tA3OGKK*k{(cAJAL5hqU9~CveF!XWQK>A~LT|47
z`{}e7(n>z@`8U&b&Kv(>`kq#YzYmzy*YfUv2wdyT_a_`qE;D4{9ii&|DH+hhMwL0z
zBH^qhZOIO<P@$^J*hrZQkgnn6>}ypZL&IgVA*{gW{cuQ7tIGB|Ruv|9EME%7vsSC6
z`z;VH6Ftne@LtJt?=Z9Sves6?A~X2?F&sioETqBx=*NW7t#ft?rusedU|v!Z;B)RK
z>;so27WobIxY;y{P{0@mW^QOD@y_DPosb}xR@SLYIF|RQjIFzv2jQYp`DZ(?SE8+&
zhZgsLb7rju=iK(qthe56_2|dIxoT;iMH;0<{QRB`?jyrv-_}3)T1CBF{maxoEsEMX
zJ`Aa2o$X54O6}`bLdL2NP*@ILw<Zo=tZ8*M<5;WtYDgU&oQcolX(dnikRCFNq<{;I
z9;ZG8y|)a^hQ$~xJ4+U_<oGL!ida_DSDRXphO_|7*>Ok9k7cKC>S<CXsjuhT)!72G
z^|I?;b!1)SZ^zpC4-+M`5ZcbK9S6Hi0^8GYpA@vzGi{Egi5`}|pC<ObTH_TDZbY%+
z`iyl-Z(ZBB){N)YQe)pdA4S?MkEg{kI`v7U`}r>==Daj{W1$sGIq4%OXhY+G^hL|3
z@_-bND79)c=Q4V6l-ZX?L?Qm|f63%9%MeRl-A7Z?&OCCgFw&nK4ee|TD9fBeahT!d
z9Jn{Jg-%$&<D^K%uVZxNknCvwRTho;DJX%|Bs^=;A)1&cOAB%Q{GTPC+u60)jv_U-
zu=Np+Ka+`$?pZIp_0lbA`e3m9)yvECqls<AXl8G%%=qmo|B5BU|M!=dF8x2hd=_nM
ztiuu-={XwN1calfYeNg^-c%y@IW2u=iviJizr630vy@G2>^{3Qg&3^+Xr;05f=e@h
zF7USl?8!RiZUn{Da6?ciH|T?Ks`1bDFuM2Yo@@FqYO4lx+zuj%K?xjo(J_QCtlcy;
zR$yZWEPD_aQu#ke&*AmSi_y%%xH<t%8It<hj^g^Qprdv+7$8b1r+E~hR+JS-a)eB+
zF}TOfLy__Ior9|sL&&WOUN`y6BnNQS-)t225ip`;EEG)fX~i4CJ&5!k9JCu%$Awa0
zl7OjCf%XH+PxLQRu*;T8?xI6Lhr0S)8oEJoK&u4tpx$yb>fIvZ(P_gPG8-y$(}x6L
zudHfz`v&UUL@kyV!XD2;1E~AVkau|-HB|6f5$}y4-=8A}K0vbT1Axp*1umps;SdA1
zD_y#V9W%QbJ&4iV9&kC@>u5CkRpbuklHS0K#7@ar+c&miG+NECJ0dT~u}0XRznx#p
z^U1Jp*MgQ*J{{N8wgUt*<-WFw%M9?%t@$NEm&jsb$(8e5${m6F*?$n!^?n_O%OG8L
z8v0Wz!KSMRYo@~o!M5JA$^z?_-H3Omm3FnoGGR5jrv8y)e>AZz4;{_xu14VVa%iTz
zkqDF#EVd#$9j46lLVTmp(Hd*P6RGO&6(fwI?tf^v;0B-1Vu&xMK5nf9jAAPGdCKNH
z=jQ=-c7y8;JJhH!ozwv#yScv~-jd$jhkg;7U@O%yg!5HZ0TrQ1`lF~hUyI7OxZ<2@
zy>kC<WUsfTihZ5WzsAy;=lgMp1)}p!z-KezpTm%<lCOx8!*7rWyRx56Vg%cM)?CN^
z`>!-x&F=BvkAng{K9D`Pz-!I^a`bNlcdiu9PXd44r*F27c{S*vV-Xnh<9K<-u0rc^
z&5RG9KAmRIn5-~t8>OG`$Fp6zF+-$Aa~5<(qA;eYtKv^80{X0nAAK8Z8*qtnEd%@4
zFrdovg~Hqj&gRi3$gu1`5~A!C*;6(lkLS*K0tS4DBPD8Htaqpfo4ZC&gkVmhwXQ~S
zx6sdYm*g{-<XJnj@vIccuGdO?oU*k7on+aRhzrx^N?+EzXc5^qhqNhB0b`t+STVqu
z5`!phVc}NoXyn;4;`#-?;CJ+>M_jAgFKmY_#n}PQxOrOR7OWFSS}EC3^Z-7$mXB}1
zmx$e5b1Wfebcmk9ehY5Zs_m!fQtA>r){(>w(~Sxr{vaO-*UDJ?2~DLkrCkiN*cX{O
znDvsfg&Jd7+Bfsmrgp@f-}$tug;ph7Pl2G0l4B>{IWF(cH+DihG;VsnE#q1?4neiw
zY+-6P*MhTba=@nG(JL(LJQnhA<9}(mN3HQB_o2h}Zs{PgoX1BGw@8h)gmM>YJW`BJ
zRt$)D#o|@m(jM41E^$>)fbsMkvTH(*3r1&Z7W>Oi?&Wp1%)uj6id39apRtka_SA5o
zg-*$#@yMR7ozE7$Dn7jpL=v)Og0zTpL_X~cJ=iBXiaQlQ5;3ZAI3*%yRjtZs4MpBV
zEsu(XDPW|gws^Il9)!O-jqGBNkzS%d9i*^LHn(u3jVD_jYpqtj^1K*f$?I{rNFLnS
zf~llGbBb1$ggM;S<~2r<=gCade6KTE(~2z^oknk3yR}s-$S>O0MYRGcZ*|~dd}Hed
zooJ);(+(utJ{w4}>lT{TXlqRxl<g5SdEK}+{Z=mWyqp>x*p_i$S}9~>3vN2lkR6sl
zmBx9rDs5F}{&u>uMtsM5reAEr?L7Lg$IL2j`)k^HqFnH2Td!<-Yv+}-w$jWeB>H~b
zOO}E*AC4178tFCCLp&OBdYjzjO1Lq#^lY=&mQ7{rV>;Z~OanC5hwe!h$&iRFtQ~dR
z|1ws|!kPTLv0LJm-;8KyOLjh*_#hH>kSM=Gh7ZqZ3%;$NbN9_ibN9_m*_-F*&9+cQ
z71FF^m{LgeSwv8ZEa6mJCqsU<hnu-(7ae+YIOo>-(A9Z;D5I2R6-D?Q!p89_M~LX5
z+E5D2hy@j~yAp$Jku#>%t(JZZPyE~pw%Xl`b;bv=spYrP1@TWY9@c{#>D$Od^BE7e
z!{TP8mcC)3fQW!Q<hMpt+=5%yHY^W3+X=|f!?vyGdSV2oznh}Buj3t6AtFQ13Q7X0
z#?#w<*0L5td?Q<_g`cm(l5#XLD@|3Zh~jcS)GnA4{AKZAS!JvDZl#)50l-K#e4-5F
z!gF=ORAW|Z8TuL?hb6b-U-5PxmosPUqiCo_+yAe<?~iWms_(orBU6)cQ#F`WP&bGm
zf|Hu$NqUl=q^BPVPH<8a%wV$a9CvW20VjxHf}4u0n~Gpk6HIEr1TpJoMQVZxhKkf=
zO=`L>>vDWpm!r+P9B+;{M@`+-W!<csx~XB^?0!D?-lt!q2??e92gff*`CL7{_wK#l
zd%wTG&%-EGvwc#vL7dS!T-^+-bp2W0C+A9*>MFh%Dv_^#@*U#DdjD;zNXeD|`b-9;
z7UiPa<K*~r^A_Ac^);f-?x{v(YVA))vr_U@W7XA~f@)??Me(}PzmvPE{>Dri6Tp-T
zx536zFY+p0;q^`e+{xB*l=YRP&M1{l*W8bBek0#IdiEOhNUO9umKPdl{XTlJqpoVd
z`ub02%*y6$PSxta=t@cOQtA4WjhC`mMHn2(#GT@dR#}G4M$4T=>QO_hzsgjVM$X;m
z(%b3jr?)dyMQOj(ahwUGIh+&eTsyaOXQDJ!20NMBiGL79#fqs98)xv=%1pW2D5+~_
zQ2q5MTLYD;adapDgbI0s|9A2nYF9aOr?Em)^~(P@{!*=`tX4xda&LXKrFN|w-=V1g
zBlFdKZv7J+*-;%8cgFeqZyqOpv3*zXeyRQbB>A;!Z$Am0s&_kMrLTF1_QRdMQ>9d`
z46CPcZSRayhw$>Hb3dv5;#SIeK5Hf4k33OrA6J5}=_h!RVSS6tA$80BsHmng@zrcw
z^D$TF+c@6fiyUwD3C>u97!fm~%(d|xrO&xzeJdz%{xMQ^Io{LxGJmA%OCP0@?!oh}
z=!@&s(X-XrH_|WilIf@9AE_5P@932E$v^r=9Y78ACU`@q@J1W|9Y{ujsXZM(@5hhw
zrPJ??QtmO6&5^Pm$Hf2Df9jQE^`|7&FY1pjI#Tgx_jThN5do!FdL8f`@KU=$n`Zwx
zT9Es@`fh}>0PA;9W0fLf+_iN^N`~-{VE5v`cj9eN*1TMe_Vwufo$!;d))g?<Vr18%
zt;WMhZM{FqZ;USdY`*Z^NGGn&+p$J{`0uTt3Te}9wVah=)TJ7^P!>S5)pOR1Ys8Au
z>R-p_>Q-&e+J8Or?dbbW7|SWFSwEr~@5BmTk5Tnv?fPZwM!9Mni;7#E`xhjgew}Jo
zMv(Zf6Kx<`?)2HI%aqNevYt-ljBnpE8vfxr&D3n)zR)>(3aqVQzD7m+o6nY<K^}Q4
zxJ3O?lDA84IRzT<Pm?%(D9V$@^s5!cRXjxfsUJok7#-s~!t~jBC9kEw!_{KDF(XvJ
zVzqkM>Gj2;is-8N9wS_}e}&XpXOvq1w2xyy?FTk_-scB|_?=%9;%)B|qUF6p{1*Pm
z?YsMg`0{l^9DB16|AODX0etx>AwGuoU*Wn>4hiw+zmDrq3vu}kIFD=JkI&8cd>Ef^
zyhVur(RxhyUw%w{t6zvu;oR$i@4)wW<MT0mK85dJ1b!BuZ{YLgcM9>^K_Pze<T3Gg
z*9&nAK0J=&Lpnsz&*d1`zr0n51lsDX5WkYav-Rg@V9N(_9ng<Y6rZc{;qT`jin_J;
ze-PLGHa<V;{kP!WxBV;b|D6vBas7+D|BBDJ#4XPWvHxk8_&9KC#wD)*YawQU9|b-L
z{Q8a%%fJ)=EJVlsF7Z{IU&Hsm1zw2zKZW~B_<lWpe**aHKNR8zz?*?je5pm;0zAa`
z4+66vZV?{_Uiev;_z18Q_=mVJ4E*qc5Z3`O-xgvK_<20{Cg7Lx{R}YiH$sd6f8p<h
z7z6%0-~=%GS3<<@Y!M&D@6-7HEnpt_j(@<LFTj&{{xYzojBx^A4}1!EE$|TdZeSbc
z^(j23?_)0UO+5E9d=LFEA^tSfBK{fA3*h^2JdJ*Up97|WAH#k9z|ZapF$nx7=JOul
zhkqo*DDd;ULfi@bpZ^DR`-DsU6YxslD-MOY0T=`h0N)P075E`w4)_`11HeB9E&%^K
z@Y}$D1a1Le@h?I=0}KK$n8N+QDfIIp;4<)Yz)j$v09~JRi9f@5+krR#tq?E6dc194
zh)eMO6ZqZ<{EerCFo55}_io@1K?g6^^$Vc?D)z+>LC5a`zxwx}4}O0I=y?<HAD$KB
zUBF-dN309*T438>gWk^waR<JC0N>97ugCZA0RJ3#5Af>$EyN?hZvjp8^JVn&1ke8y
z)&&^CeshisA9OiQ@pHOGJpB!qxD}tf@VOVCV_?JUfAg4l3qHru{`*^wiU0bpW8wtb
zUwrp5@l~8Zaa@Rx<GgI2fE;;`ZljAI-lp3vkYn%F?UxDhM(6sILcB7g&$kKj`S<Jg
z&qFpi_r4s@cdofmh<|XNkN0Q3`T>3YFADL&5#7E>h;KUWSD>%=sq-$3`D#687smWg
zP8(x(o>L);Zan$*7AfDhKnvU=*A1784ban};Qz%qHvY0jxbWdI^WR#;!go}g-+A9l
zIxtQiKQDe!+&q6=yj)x){sMS`c!l`OFC7;bigxjlhmVV25U&&;`O0x|Qd}%vh4XFV
zm&CQeR^buf`r>in7OxV2^APcuC90<i;p+p@e}dx{Je&P;OtlC5u07Z{4~~`N<JdV4
zj;-0zA$~<%B3>iB;<a!;UnhL1qrVI<W_RNJ<@nV8_nIaT`1x-h7jIiq&%On19`E?i
z^?iNt&(!yuzoqc~|3%^JA3H9-sqg)(Wp(a@8u^^5x4kf}xK#WkP}H0fX&8wtT4#ux
zh3h>q7;nHYzlKlszcjArG1k>0_Jb$o{g!TX1YzBFqkW%ld(nPCx6!OSPV4g=N3-YD
zU5qd3mw5eUFX8$deJvu5&)73Akp+GlpC|FT?DZ|;c6=Ve=UIHr%M^e3uB+1Ev~D+!
zH$2xON>?d5UD(|sJjO}MQ(b72e&ol~x=o(U>Nb1GqrK)oDIjvhlW6avO*wbLwJl<{
z>m+yux&rOtz)A2Kco*%pH=YzZw0F?v^Ba%CHPtb%={DDGU$;4)_BW|(IG%uRb3CVX
zo8!4tw>h4oZs*Y6(rq;Bjy62si!pPZ&6<8s>2?n1Z_{n(MrZteS69b;t8R156S~bY
zFX?s;?JeC#v+h_;SD&+|+c{j}J<s(IC#%<gSGU>kj&8Hx)>M^NF|_+JN78CQpC_%x
zb(^%hU$?n-i@MFVdmQa7?u9rO9z8a$UO(C^SjQaN1$`dPx??ucB37{nNZS>(XF_U^
zZK3V#v388PAJ5^MdiD4@&NI55LwiiO(X2b}2M^`npq@Wxw}>*@q{Fw-c6X{hyoGie
zZ9e};XtQ5FKc>e(It=MH=|CRhH9531`aGI-$HP~sYbZ-Lb-V5Ye7V(7*KqEWx?OwC
zMfbOeGp_}Y;4_L3kF!11d%Bz4lg2e8S5?Qiq1(K-_NaZ%R+H!O+S@SCS<r>!n?id9
zZPIQT?Y_$u?Vdt=4Q<k{^$pO)S18(bq1}r%Y1fDLINGFL25sN3D*i8`J%Kj&P#J9z
zR(t3W?Y1jVLchYU>ueDQ+AvXsiS{hoFj2(2(C&h4f>|P_(9Wa%3uu2E?GEfG(!K3+
z>?gEgqF}rj5B3&J6!8e!KCB;16!8?=HroFe?Mu$HPPMd}Z$c~cbuHo)K6m4@h|kmb
zTybfOX!oHXe0ZFSSJ&ij-IhPp{O|Etb#0%}ZPNQG-R7L0)om}@&+E2<_J#VHX|z2x
zeFe_b*GjZSY=ItJ+YPk2pV`+Bber;lK1e^-glqe(KF`@)sQcyG#&nx&+lTfNuBUuB
zt<Q69AJXj{+Kal4X5I0SRh>KOeTaR*`EKd+TtnLQ94FWCK%e)b-KNL(TC}gx?Ht<U
zx{YStF@byMppR;g3$b2YvwnQ;!e<_z4SbGcEicB0N6u7Z<X8&2&9Q9jHusYk{uRf_
zvD~fOXx1II`zh<M(*6P6Chb>so3!84ZI0sA0d+lTKd9TJ{R6s9+B?^i_D}2cl+B$%
zbuVXrt8SC8oa@O~kLdH{s~_n$`RW=y#~j*iA6M(}5wu72*zQLAKHdH(+Kak9fp%H9
zKZf=NdOY`_-K*QbhxUECJy~=8$I<@2K7TLT9zC8<pnY1mr)sYMB-#(^^Y@|s1Ks|8
zv;%tlXx1HLn&-&}&briI;Ki3q^!UkVN!_l!hHd9wKIa)NBgjt&P2>fy@#_7{Yc7TF
z%RR$&zf7O!x-aSTIkW@%JeqY!ZNHD!^t;-mU*0$xQG0-6Skmnr+WWeVX5C?4S-pNp
zw>jp!b(>?J(`}CVJG#xix})3Ns~4O{4_zEq&&MTo$J%*#r`9HZQrpKIPum;Sb2y%u
zZgV^%x?T5hd~u#b8RO8f@tQ6@X3{FwWc&|7Cokc%i_cbrey)Ai84j@Fcqh*BxwXd-
z&hb*7f6GOj31Wvh!FllfU*H^ndl$Zt&)L4dU7h<)oFk9(+!tS|&JE)n`J4B?@!}H_
z-;FPvGp|ehk~;SuoTD7$xsXSldoRwl<2&#D8=T{4M)1W0<aIxMl{$9|&b?Znd-*S`
zbGPDLhd%epjuUeH@58xE^tq4ga~YiT;v7JHQJ+Jz?og5!aU8u**!LOT<~$~K+l%(A
zYxZ;OJp0*MYd+_Gy*JqZV$J^9)a~bSe)l~4$9WFN@Z7I9-@|{ZbuasRTDRHP%e0M2
zns(|o*Z4-XXCVi2Xy2jFqgi*H(S5Ps5#9EpeY<WOXpif54()q%n{)ZDZlhT_ve>tG
z<1>X%Uhm=K`Z|ugO}9Djbd&qlF0DN7$2R!P#)IdIAA+t0j^5rP_geb5VN2rs4M6UJ
z5g_HrT|i#neW$v<AILFW@C|kS#Xw%)3FP%Qkk?<QufIuOf4r!!_X2r+7|82S=USwl
zI*jk+u{(j(qmw}L*Zn~1&qW}4>)Sx;%@UA0^JyUU<pGdubm7-qr2XjwlE-2|+6jF?
z^4D#^R|4+^UJQH)_)EaYfaJ9j@KwO4faEjrNDHD$LR<_ak97fm1$YgR{51q*tmZDD
z7dQ)iE$}hmrNAeEuLB+ceZY(VxJA4kXaX+-o&vrBI120p-UGZGI19W2_z3V<fos4n
z;17U2dOxk`d=|)cJPqW!j03rj3qW4E2_&6cKLa}dE__X34#xMbKptFwuGa*R&-o6J
z&+&W+&%t%q0Qr04e%aygIR8A5PjZi`=M{cWT~Flmh<qNA*Asaqk>euLo_Y?*^}lpd
zt$z=Y>wg=N>wgx=_1^$;{eJ}H`g=dF*8e&n*FOiOz4&dQv|E8(|L%L$`p*El{+mFq
z|EoWt*8en+>wh1R>;HWq*Z*ZxYW)X+T>nRbT>l>dx&Fyds`bAcNIEt0N!y~DcL2zF
zp8|5;qrhf#9oN@ibBDUV56J6p2a-<nK+<UyNIuyHl1>+ZPe~`A=GSX9|DDqO_Z}eW
ze+Q7`m<IB>3qU@14ao5{@-6w3_dWJCb>9Y%_x%9K`@|oq@hsyy9-Kd)Lpj0qf9NY}
z{l5p~bC!X;a`<=DbGGoEhx`8K^xJt%-S<3@S6=)l>b@(1?EeN}GrHeBtL}RM$ln|3
zar^J8-*Z4dcM8aPodxo_4*^N%M}VaBCXjS~8b~_t1GyhB!o0a3y+H2A08rZRKpvzg
z`==a~e2Vkrhburo(&Js4u4jQf`p>HC?*a1quK{`e_kq0rJ^w+C_hBH%y94BSuhjE&
z=+1TEeRnRY`|by_hZP|2+XwPK&o|XP4It-vBT(`kkn@}ba-NR?InQliGkRX~?^QoG
zkiR$Xqr3F_)5hjF?#K6L&#~@O&$$lB>uv&ayu(0__jVxH<t`w{doPgVJqzS`7l0h^
zp8`4F?*X|kPXf6v&j2YWo(ED+T!?j~oVWx?IdKJ$dcp!y9^3?^JQxOYyp3}3``|aO
z%Y#6UcOA&_J_Y1>p9gZhzN{Lr4P^hf1KIx!kk4(D8&B%}d*(Ijxi*l`-Nku6_YlbE
zUib&<xt9V-hcJ+IxB*ByoB@&!cK}I;`+&{pew$vuERgfK56J!&fb8#aAp1K2lI|Vj
zs=pYJ{S5-y-x!eneGSO|9tX0&#{J;Pm64q4?@l25n+5Wi{EWKq0U-Hc6UhDSo>BCU
z0p<Px^1g8($C(FmoGU=dw?NY65Xf<QKdZ(W14_C8InE^@_Xp(=*T)Cs`kVrCf0TgS
zAMKx0`{NoQ^+*OtJ@Pdm?T9CV9_ZNvU=Bv0m2Z);t_+aJtG}w|bt#bZx)R8P^dOz~
zzo5<s9#r!k0CIng19@cu$oZ}VIp3H4p_*?R$obw0<a{3ma=zaMa$TMTa=wQ^&et=i
z=6fZO^JVOb^G)MB=bHg?zC`lFy+F?QVIb%G7?AUQ0!Tjj0g!z1Jdk?xf-fq)=>t-4
z27uI?JwWQsGr-pX$ADhoeZbcO9|RVFi@+}cH-Ioh#3QgXNS{VNS(;V!`5utJH_G`l
z-%!8b4kY~^0Fr)>0!hCTko%<!B>kQPl76j^D*9alB>lob((g2o^cw?mzkC`<`W1ns
z-xiScbNwepKVC=rU4rkV-;F@hFAF67?gx^7D?n*?0!csjlA_-gK+^9zAnA7#kn?Qh
zr!&|`+$R%2&hud)=lM90^E?FdzDD`AlvVeYfV}TnAn)^jSlwp>NuN`|X7s-U=h<(s
z-k<m2JMTXWWWNssB|icS`2Gy=3&0Dp-yQ^7z-G^V9&&@vz4&+3xJ)3QdkV<s(thA`
z?*ek&+?XHN?OuH6zMlhf-Ijq|w@o0|%>}vNj1E67yQ^_s4!^ACk$G6n<1CQ#@BlfF
z=YX7t4dgs-1#%vFAm{NNAm_0U<UB5g-sC*`&Z9q1e?;|nKalJB7?Ayyf$Yz9x9YDG
z$o@_N+21|D0`Pty*XKJxuFrG8KLlR-(dKkp0bg>R9tZMx*XPxB8$imp_Ot4HBVU%W
z?!50AAn$x0$fMDIjA30V_pbx;`cpt2j=XGrNcHnP<OHuP|AD&h5}fCiHjwi_1LXY2
zfu#2XK+gX$Am{%Cko0~UNP0gDB)u>ClA^Z{NPfTZLB;Qr*vI7eSs?k{!ta!ql&9qP
z)A&w)zZ)p^1Cac_1|+}l0Lkx{%`1L?50HN56p;M>2$1}~52U>GVINUm_5;1ZyMeC-
zemAQ8%zN>@fbW#QT)$;}=lW6pa{V^&eGa$-q&($5<?-kz)%rXQ<a&AU(|QL;dfx-&
zmEQ)Ej?Vx|N8j%&I-UWNj&}n|$47yrqnK87i~&i<Q6Ts2Ss>}S2Bh444oEs)`6)%m
zERb|807=KEfutjmbR?3FMAFd>|CV&*cgjs7=}06U>0gqLMADH+Iuefo8|C3kje`v2
z6rE-k6`dXj@_6DF_5A07r0Zq3D!SeTBwg<W^2&K2>AC|XUA^y9bnO93x&lep0+4hq
z1Gztc1SDOpjH2u9K+<&<NV<L-NV+}?<o>+q{fe$P0ZG?S14-A%fuw8eZHlf}0!i0i
zAn7^=Bwgo#r0Xh>bbT5~x?cDJMb~a1>3SE?3)}#5f3}XQ{n-nA9lnnNeZV5{^}y$V
zmjOK=RB@1AU?;xc0lXae5bz4%v%tH6NyI097kCQTZ2f*3avYBrZI7wvUjgL$odr_9
z6oFj7@9N*rKrZt4X&`@p49MThK(6o0Ce->~3H&)M&`m(D&tpKY&jlY->vI~&eg80!
z>+>VvD?!j3?g2gDfPDh&ybAU|(7^A5*uOj)<>l&v8pkG(<Dg#TmG8-^aU9@0_t_Zy
z8Op&YfZS&;T*rO32mQ$7;45nWVO-DojRHyUM*C|O&t*SP0eR>1x}R5TeUk(>Tc;n#
zXD^j68}-XgdR)VLTzBYk<$;|460q60E*(?zIRoT;&H~Aw-v{!(i+)Sd?M5K!mIIP*
z%Ruty_kof>f#lCi?oj<Sj&CBb`k4W;pCuss`5ut{>;Snw2SE1I0e#AT(m;;8(avB!
z6xZP)=s!M>wN-rHrAz90U&DDmuLR`ts3-Zn10cukeL#)-G?3%I7kZ!a`fhxuTzMGC
zeftQI`*sCLx$-?=0r&*)3&1_#gTR;lN2PZ>z&U)60lx@51$+pY0e%U1FK`|>5BxIl
zJHUs5+rX~?T?Nz_0y}|U1)c(a4LA<`Bj7{8BCrJfI`9zq2+;e57V*cx8-R<zG2l0V
z4*(wpt^r9$Ctl+DBgHoskaX+=l8(0nNyoE5uFE>m_?Eht_w%?6-^nA+_awfP)_hLm
zK^gJj7t}AMCDfhb``2#PxU6vS&8lzS%RY~eBMKZ*;D`c86gZ;55e1GYa72M43LH`3
zhyq6xIHJH21&%0iM1dm;98uti0!I`$qQDUajwo<Mfg=hWQQ(LIM-(`sz!3$GC~!o9
zBMKZ*;D`c86gZ;55e1GYa72OszZ76?=xz8cWKYV^jo0{D!d*G8`t1+g{=Tc;d&}5W
z?;d_%;HqnW>z2&$Rc{}8cP4YyscU<$z54CfzVpp*dXpKw>grQ(QRn;K_ui|n9v#ix
z@|!o0-SUCk^u_9y?rX1k$D7reD~B_gN-wBUN4q~@gv^i?ItU$xM0nU5u`*U$)E#Y)
zE=8B4E78^HSS%YGkL6+$v8mWhEFTkbSG+Yo9?!)m;*;^I_;kG2?z8*t0ejFMvWM;I
z<V-T3oJ|&zbIJMSLb8}#OfDstlPk&9<a%-=xtVNBxl`?_kyIu%ni@+jq~wrLOq@ld
z)95k=14Dt~z(`;wm=Ded3qjjVo84xQSu_{TC3D#v4UL70p~cWrs6FfncZ5sft#HAb
zv$icOYRmEFVpiOar{f(7Z^D=8Oc)6>VI}NDIx&<QuJoK`&tBA81MEOL&>iRr^alC@
z{egjiGlm26&=et8s5R6Ua);VOo=``~8}fxZLtP<7IXjdNb%%OFn;1noydB;N?}qon
z!x7SMExH~pMYp2m=yr4`x*Oe(x?`*Mn!Rq9><xR<-m=T~w!LHT+I#lCePAEjBH>E3
zCfXA2M0>)M=tyj&Hd9-va%wxZliE$~rS?+?sY8w%JEi~-hRbL*+KeIpuz$p#@sIk)
z{8|6Ff5Bh$PXv~OE5X&^dT=eY9x8=4LYtwjP&u?6+6nE3_CotuaaXuC+!l6&j^p86
zcp^L*77<ruC^8!<MAjm$R-4sl^;-khpmh*ClxyD>cgNe~o_I&x7w?R3CCZ8I#7<&2
zv6nbV9OBP`x{|F)j4O?I)&T8>$M6}QMlDT;%wcoH%$TEQ&KwWrLKAXiec}G_KzJ}b
z5+1`yroxBexyXEEAySN_qutS-Xm7MH+8-T=4n~Kf!_kfCCg{2y^~5@2Bk@dpG(HyJ
zjqk<x;|FoBb9bUA(VOT?%qJESq@JQ32Gpna*{r|dpYxae8-5XR1r`Htv)%NV6WCu1
za%U}vRzj<xD&5Ezqt=*}wZ^TSHDOI!Q`Ts7ESimuM|05$a7s4TZhPzw+l&3ym6%9P
zrlwNUshQMlYL4qQgqn6h*2ozX#-y?4Uzfda`nl&;0;_?wz<Qt**a&O}M$N1_4%$qZ
zljf9J9m7^=9eaHvtajQ;WECq^iVRDh9koaaZ_F3#iWxC8X2sI6j<{E@QCHlEo0>L<
zabdUGZo3`aI%DVU&BRt>Gr5)IF2nHfVuu=Mo8dMNjSjyT`{@unX)-Vsm=4SY@`2ev
zAut!14=e;S!O`GYFdOuRJHuUJBW#APupLf^yTd)<ee1wFv_#Yu<;rBWyztsSyVLHn
z4coLW+qTnox7}k?eiZCEd){8Ki}s?uWG~w*_Ntvpj3%;)@x(-8GO;gr*R(@Tyl8=%
ze++lm*faKx1B}%jXb*TWwiR>LTr=0rlDT1Snp<Ystd4IGJ9{{iw~FA!y{HwlrDR))
zt;YJ|1M$IlF}@UEj;j$l5{(opC;F28$!SP7l8Az{2pBcSjI1%PS9HpluHnM0KNnEa
zYc4n+TnH9}i@~K}pE(oChYF#&(0ph?%dqNB+X#8XKFNnukRm;i-pF=jC$byai|j|b
zEW_HdcC9_DO4-&ZB{gN<baW<~mvfqkO+rqWV=IZ(#9CrKQA%K-1;|xEzkk3#=pU+)
z6#3v-Wv}6aA(t2c6cdYyrNnZg`izZ)qJqQeYBdzEw<X=l_M|7-k@O~g$<Aa~(ny*~
zD`_Xw$?jwiDOON>O0A0{FMGlFlUg2iM!F(KBpu01xl@d+L^h=C;r>yxY>#@P9Z^aG
za$GUGC}pZU){cGN9ixt#k1fP@V|y`5r7377VY_OiDP^fw>VolPE;*5$Ois!5oYi_t
z%2X`sI)>}WRLZUn!z<+%<>{h-$-nGh@vl~RcgvryXpJJI$WkC3><;z>dxL#a@~#D^
z%xN=kc1c~K<Vij}8!m+B!k$P+#2fMH^*x9jMug?EmaP?Q)mpRGtzO8xfoN;2Eyh`P
z#uXP^Qqs-F3-MBXBklq(lZ$fpgiTqqmRfi8!wTLJ!pkK6#(*(s3>m}5h><a-441#v
z-&WZJtNu0rj(^ur-mwBUbZ$m+cYDwi><A7AM}irxg9o8~ISWc_#o@hSC9yM*)-&Px
z@G@l6e%OeZ;INTM8GCmhGa9$1V$;%Yn2i-;b8?l6vBlU@Y&k~0TZ^s7O0kXDW^4<)
zc00Bs*Kj}PXq(n}TSed4@uB#nJ!MZz$u%ow#<@FhMp_@+$(`hGaxb}`JV<&{Inbq)
z+JG+Q@`@7Pg9B}f#-g!gEE_Avs<CFQ8zp1I*fh3`vaxOK7`ukyPy2iQ6aE>0TYwbu
z)~s%Sa3DAs9MUvWa&SDD1E;SCl`h#ar$W;q^80KZ$B%?F;Zf+gY(?YFhF75NM5Hg$
z9~p=kmT6g*ZKbVls|=fF4|22>_Skr|*2)^OGxlhWC9!RfBq%S(q{N&}6cTgb-`*tU
z)<AMFIRrb*O4+G&syo$_>P_`kEeX8*rT$Kxe33Bc!awkW_X#nx45a&ba3VMroPixS
zhq)~Vm!&<i5!?!H2X}+}!NZ`-Y=iFXFnwm1X__`HwO+H|9E6U~m}Agm6VPEZ=Bznq
zE|`nvGNdz?Kuo)6dI^VHNYCn%@Ix7Yn+o7H(%8K@qhRd%_x$_*fj|LIQv76v469vQ
zB2_&%E_tD{OA?9_^NE$Dom%4R@1akCY3%#A13Q6TZU5RK#}cAVN%=As>y7utm9$V)
zQ}!xu##>sH|5d&^R}-ZD-ToebA7pJ0^t+M>{h%K0v9%hhJ8ABkd*;4*Ani=Y=BR2@
z@{<*@Bi#}1haRgJ_Sk@w4;xk|Y@!)h<Sy9bN}C>3EHE?0)$YbhW1!gVyMSq9#>gA9
zpyiw~Z!8$++y9ghZhyPq<L`itG%sz*s_a|ycLj`qDdj~Pa~puIJ{lMgP`^3zTMw3k
zwzP};ATg%E19Q-JWodcR=JZHQft;`hnQ?&KKL87J$Z~8M*jd`Hnv{04BP~{IcKl>w
zDlwgyNi5WO7?`B@82%|9h;YB@-wy6zkM3cY9$=pe(`B||uPW~BFumpycH<;QH!XS8
z>3>RV)7fYtIu~8QPFRXkV$rHIq#uz^)apZac1&ynI^nxGbm`W<1bHYM6xxGm4-JNf
z>ULU3cnOkoC9Euykw_*o8X1dZBjb@=WFj&dnTkwDW~5%+k2pG_6;^qN<<)k%qM9$-
z8SRQ1Q8Vg`b!r>1UQ*JE+18di^><H_(qRMs*jBQfRPu5rm4}5@NX^63z=YDrqz&I`
ztW|8&tw1@T_+~G#AIL&JK<1f6a5kw)+pA>yw0E?nS9~E{3@_?=I`i9zY(|!)f4L@o
zqz!4$m$jd?2T$oBI&IIxdN0BnQPu><ndi9rj>&gVl_i7k1(z@(&*`Cg;GeO7BV@xT
z>j$+np)7RPG^Fr6Ec+FBLYs0Q?!n`2h40fI_QHCl<=PF6R`oyf(9uP#%^EE3vh?W=
z!mfxLTDucGnTB;X08KZFm72r~72v5X!6Gk3wqUbS^R-zX%Ll8?2G{muZ)e~;Ojy&_
ztTk^fLd&mPn>Etii`BDW-Sok~8G&Dsi%!9!n}emZ3@>s6*3K>{;({&Ef%P?E_4LLD
zV#BdfSg@1OuLW2?OVFn!=+T|nK0LKHNJbwle>>h2?}z3bhL@Cu&psWWje}-Im!x4H
zvY==vnnE;+8GqhC>py_aFW?uo29)OW1UjJoe1T5s2XN&ND%Srv^a8obXLdpZY@Fj`
z9>~Z7rE3TF`6}qSUh!gjK*c_(^@bu!w)IP2lY2T-XX&;_z1j;LfcG~V^})(>EFv48
zem7=04Evo{U#s0FJseM+PRvO^LdgtFbm*Aa0JOo+skQUE48t%D%dnw$yndg*%Rdbp
zsZ;wt1!%$fppqhLx4RHK$x98deCnQXFLu$ki~=Z5?yKX|jJ04DvHspDId)w7j%wGB
z#4=dT4(YQwbI96SpJ`d=Sk{hhqcl=hd6;lWj)`T=sp=DvLzG{%6j-i!ne!EYgp#pV
z|G1>grkB=bPf7bYf1XIr8e%!62I;XUt*t}+gCMR{YpP8~c|56(lsDx|b*8#fMoMX=
zstwYg8b}Qy282Q9luoU#1#PfiXwZJYJJ>GmQE$+#BQTDHF+qLmnW^wJY|uO`>#>SQ
zJ_!z@SES_lJR~`_`V#m_(U|*Zw$AU&rp93@PH4|vNy0hE!i7{ZwFv8BIkl2ng^i8T
zLYW?uf0v=#=rMYYK5~%cDgG^tUg)x6YY_W%3@bblmA~P78a@R>@ljWe4yCSWNA!VQ
zL>@9=M_IfWJlY1Bj`4rTWPHpGdF25odFy=cr5eAXWNkpQY)RX3r{Xc1kS-(9yj?%z
zv6Pzgq>fe8&l$a9z{lj@=g3qdOF3A?lm0321!aZ2M$3``#Q#QYbq{Swr71>(Wpmry
zsj+j0nrOLAcns|^kB(tbgPDk7*zgR<%N>XstRZSfeV>;$o$6Q7l)TDy=riiQol)(d
zJ5tOUE7xcR&nqDUS4Q-050N+Lc|J7A6|@%=pF1l<`Gz0$T*qWwg5MQ==tn#8KgXsK
zh@`bfs`t3zCF7gCrx%dZaike553Nu@1asb^XEzt0ha_8+v51xUYJ4reF1@|2xVy&F
zrk{<6tQ^BXsfak6wAOt7PDm`;K9=8x_tNdRV3DU`le;7B5y#`~gs(kq)%NPhQb&@~
z^6f`NWGh~-(G}X7lzn>8XCI=zRj&glO2?!N;rPr|S-Roh^l$mg($}OFFZBzaqjb<J
zd@tNB@8?4F!=_wmh~muYh)E$bC!>Ok(6-Bn6RaWzwoV%3S>%;*?nsQI3t(F0zZ^Jl
zBfcr;vK`++l+dsjZCVw}jE$6!;h&4d-=ULS++X7>bN5VQm-oS&8Ib<Wh>TfsrETc{
z?nsZ;UCnJb#~x#RCaq)u#>l<52wA)ei)tgV1zT!2fKzfDg8((cJsHP5Y|v&Mwzm>L
zv*7p7Abv-Fb}YDE?eEq~VEJrK=OOs>@;l~CT6rkR_Kx8n!o=TqMs&d8mz<1HP9dH(
z^8)@t*;qt8qzpfBM|y&aXI$hFy%w!(<M~;@W?kgDY7?{}_FRCaH7~sY5$TTg#5#1O
zrmH4y-;H=~U!p%TkQhu1B`Am2wMW0zEIN)JkBc4rU+DO_((-!eRV*9E3+H4kvly6!
zpF0gtHy<2E3_8=`qgOQyJ@pP)-#)9;>Vkb&_11f&ch+xF)^g3e8=}^$(dIFb<#?6L
zdt@}UA9871<^`y4UT~)F;|yms%u~gpsPWe-mV0lg5BBhY^gxC~Be07{kw?jf3>mj=
zjkLkGZPzk_77BHWibR#5Pxhomei#)oSFBaXq-v$LiaFad8rK8cv@g~VdnT>pyZx2y
z(1@*8SH&Ruq5X$yGBTKl-mBEzoR;t&m-@$v$?VHmukfolmRso`ea{YJy3RdbG!_C?
zI*{K=;5hla-k;snt9bqpz>)P;OLiM^V?`S~Jg=>`<w|s})KtqJT8wP1=(v{CS34S8
zh;8lCF6V(hDexTXP>v4Rj*V0wrRgV+>iPBJI^NFv`OICN50dAM<1)tUNd6u~u2vCg
zScfORiD-@DQ(UR%zQHHq9*(1|GeY}13s@Top{3!2ts(osz3i9yGz&Qvc@EE*M#Bi7
z&u?`kb}>>fvrCBaZo*qC!>^@xMA~lYOj!<o$`t$*5A!LuV`pyH#Pkl&u`+49VIZ1T
zndF$#wP`iS>b`07E2=Pt<w&nR86%MM(f2cUBERE)>XHe>su?Mmfwf;iG=tK=7xI4~
zqNKmPw&aq!WUL`8@Iq4b+^FN8&SzBjxYF(PMwE7U#>KTOMml8Hr&DKrYB_L2M^&A%
zQRYvOV=yP?13bv#Igzu@N>;|%mAC-&;XP?`jlPE-$w)Gj90h&H>muoSMQ_~W#^rfP
z)_LC7cO3tOG~|CxTvg4mc79dwg!G*Sh3C)7kKiGAHuql}{DF?3FW5zGhUZhi423DR
zN5kvzz@2@y9Z?dxxzt^&i9A=WnDIo_Pb|m`_WU{a|2lWZklGh>h8eVib}+4@{{0Pc
zVO%N4O?zqHESgJ*k*py`BG2O)X*8-9X0J(WW6qpMthA^z&t;tj+OLcMxGmhMY0b!m
z^E{p&iDuv-*Ly<KQO5$>t;qz^&#XRY7JAru4)=UD%C(F9TQ_n!y~zT6O@|`#+R@`o
z#R>W_y*0V>qRe+K>v$)n&_-}ZdT2`9FH~YeOYq33F&vFYYy7Y#bJH&K;NC>l|ElUk
zbPO7J0Y2zr6S0<V%Y#TkCn8~%(gheF_v3-enhTLTF1GQ#)o4ey(1~g^dSkUS8J1a*
z(ZE<BizsI<Fwry@sx-}3CFkds`Q-V~OxV$x%;Gd^Omb^JR=YntbyR~HEUuKto<R0<
zN=7=B=cDrMCNgY|9(LN1S<}a5e7fGEqdn)=QQdxI0>}JAGDgn`{Uowfvu2^P^EN{x
zHTmudWV@#kjmbqP;ZsjTGq=J5ppVusvo+oEUib^!mHfN1T=wlwnT;qWT4jcCM9PdJ
zszG*Pr?zUJ8cP8m^SD?6%<Gu+s?Np?%Zi3ES<jI3+p<DqL1t3vE32q2W$}{Ci*KU-
z!VL>1Epxn8-=Gv>1ZGg`mo=*&QL`b$%|;Mw$s%^9;$ox7QIooJs28ATums<rk-AR&
zf>iFQ$OH~w6pzbX#RT&D%4#kdZO9X@Ay23z8?7)}`}By@L0jj@`*g(vWml~&*#kRL
zKDVr7X$K;2U6iG|pMvxhRUGLMIrdgr6)`MV#o1%s$g9(?7?d?RBbAC1$A-3%3F=YV
z0qD%*GMC<qXv=`k5ceR5sbtx(jGVWbj=eZ8bAXOEq^zcI)~PE17ErIT2;ZzMBM+^}
zP!AxlPAZSc%w@KwZfJ(SCFbY_SfEJ{B4-2PAt}eR$SUHr92@oAL7d*u5bBFY;PY^Y
z`QQhvY1?>9`T+9!(s8MS9gU)_zD>}6TIb?=BAdD*XBYP3KBB71%3#dPkaY>vfQ(^f
zWPMV$E-K_i$Yo7OS?Qi;5+NtE+m6Mcs5Dj+*DqHpf)1jT5cK&Mq}Q*!foWYuHP=u>
zCFi(z9RI>D^k5}R<Jbn$uh!nprmTI~u8F&dN*&W`NInO&r+)9?I^db4^MH(9)pCDV
zw7;@~8NG(MP~SVQ@1;VcHfck&W=dvgdyr%7m+`$?3!l`)r8rJVyFRb$Nh}%1>qg8z
zEAyiA67)g6*@kMB4jGd);q|I}`v8ofcFCNFUE^&H=n5fISC}{+)j)+8GWJknIN|7g
zJP7?ry8<;=9jFmt4;&x+uFWp3(!z0{ko)yeXVR5KwU9gSR=$OPmJ_MvlXy=%@)L`w
z4_MYw*tVKHl&>c0r=m5@c}-bH?K=J^t#TP*s`cD_$WC-2zGEV5*k-w{c4Q$sYP{8z
zichzpqlBxvN^Rqu3{2?-^74)~!FbBK(TXvfc47`y2?br(MtW1K?xIdi(!_g0P{?h_
z$k1}YqwDI{ksIK69Zz6iR{~Hn%lnKIQr6a5j~?VH*AVBPhKJ{d{WSw?!;P%7fPcFM
z4ZI)jN2F-M%0T9iQRd6l-_{j%+A>J1{U~(2pxx*S8bMRrcHKH|qT)AcS=Z8A$*m7_
zU!>LFL!CtB+B78>o;Luf_b^uKvLD&VwyFx0bEJ-^4k}13v{2DQD-}&7=Z}84S2vN9
z+Cld8fPM9ykhOsInG7egQM>C(f%-_SBN1wMjT75qek+5Dw{goxg^lv*Ct;P$z%MJr
z*Jb^pve|MnX3qMPyv!at7UHhTB1+nHaG1#L453<0>0hn}P7dKOpn^AsWqk@GP`j0i
zu6D#U8O^kjNneIORWr(=B4JWy(bo}q@;0r->_x0&SjISJ;7@p^2ipa2e!MQLx{BE0
zAu@GtL~;gY_L-K>6l|Sg#L63O=o#dL7f{pLh8&z%#y19FLF~b&KSZ|8g&cgfQpGE^
zTmg|=Wi|IzsxXF=j`u`AAM+nQA#=wEs9>wz)AZwa1A8*lb{G&rSFknMCbJ+T$lkbR
zwjhHF$}KY+qDEek)rv|BTgYYRWmIh~+=i%*h5CVhse4utD=kH4WvqDxb6H1qYFe)D
zxURw}p{i&LQD52)1$)t6LX><L_IQVk$qhp14oh2fU)$r31}@7A)xBy}Ne=Q8>q>sw
z)V|-o!4>VmYSPje_vc_ADVxZdsWVS^uvDqu+kpn#hc7gsBUef`QnNB@Sd@9?)f&E{
zXP%Q@U<MVN*_wLIX<gauK_!`2=HK#_>=11NFRCYL)fSu9CoRjG#I=egwPpLxsdg(=
zYMy;E<E3~)(MEH_^a)u9nv*fsEu-w;u8WFS{fjyH&pU_?=VcA_T+pLyL|mvv=3X{y
zsx8NL?Ji}HlKl=BSEG}zx=K1V|1POLnRo7yS+NXiiWcl5b!-9uZY0)k$lz+3y4oWP
z4=8iq3WXmZ>DjK-GuGBJxUG8L@iocq_UeqpptdD5+7cPBvnTVAO)Hhk$EyFjBlXUH
zO@(q>rD}2eJW(akpm;*o3bmsSkaB3j?~xU--SG8kU9F-%coF;0gPH*P7_^<JMaNi;
z2s%o=uyR8BVx@-KG8F^SJP*!xS8|-bU?(CQ)IH5*+lG#sHPW&+pR<oD=))Jt9+-AV
z(`rr3xpYEI0Osl{ghpi*%Q$L1D0`=LoO~9w`3n_4ex)I|KU7oAGhV5g9?`Yh*~%LP
zhYh|yIxnA)xp_~e`m(DgE6+?{ug>*NHmOQho_PCtD)o07>MdJQr%`7mol{lNxbs$Z
zU2U`7RgyJ^TMZcr%n0_i;`@mgh#uq{Dg~E9%atnh#?^LNt?>M6dHTn#`1$sEd&+|x
zJ$1Jnr-023zVDEAuUT2$ye4ZSeKPu(M|DU+XYl&un-U8$%1-S>+iMUtk&Cht%q8=u
zL$cPtXf7i1rL2uUnT04wuW=9WARL5x;rI1JmUAz;kTGqO9{h;T?<xCrOiJ>SjJhkS
zH7+xI)L<J?N^Jvgs7%V*=WSHL7^rx+v~2Lotl7A<M>pj=7p8n0WLjpEX_4+HY+0?G
zm(>pYs2M#>D(_`M#wkD<w@d!r_*T4Y;nvl(t1?cZ=rSR5;!2ix%UBrY_d-DF?O|C-
zyCSWY4p}Rcl@<OQvO?XEZ{SdalM+SLN_C(z*o*9NRz}A95VKgTiB^^?b+WCMcW{&q
zF5tf|+bTAWF?&@lC*#jvM303W*IHd|{I<@_Q*+Gd_}sqE#c?gD8Ca7vgovW6!N#GS
zmV2hCY|<%YBxg~_FVCTG#t<j)j*v%2@qJo<b|aJ5n^>0b1FfNo1Q!`D`ELT`>M9FH
z0y{O8k<@zb%KJAZyfM;D4z}rx`ZTiJYpAelLw)>QbiPviu@xOe^k*W*QB75B*>?Hf
zhOhDl!ns~6#+Y_V8#~i9OIkm2a>!^+ys)ii<i5~iUFNzJ$<>Uxqb`<DZ)H#WPp-PR
zg1mKaHA#B+xl}B<re<A9&1O-~`Z#8hp6iP8Uxr|ZJJ0i>LB1wW4{NSAP@BT6;W#4*
z?vrwjS7cSp`U~e{y(dL$3+}1Q$0{k)iMmOnQgu};-$!&-T3Jg|bs6cECRN+D7PJSJ
zCU<>WR^s-`N+Kt^m6g_~;@N3g$HFz6Yf|gFuHVwxLiIwur6wv_<o17qNU{?rSl90a
zDLa|=;9i4I(9CkMWJZE^N-y3-=x@kLjG-d6nJ%BJc~fP%E^@zlPOj{*QcvsA^-8S#
z?veS6L32pH-!+CxiJYwe<~tCq0A~h-HQ>yFtV;{OjM|`G@c98Oe22$7@P=I{-mgm|
z8q|l3^$2p++;c0iw@RolEaUyPJ?IUAn!<KjZ`Y3q>R6?oeoEHg(Kl{|_v4XoS#-&o
z%~{lG&ZAP3Jh+0|k#+b9+ptOZP_cOkPms|PFEaaG$m@5bZj)9WJ;Tw4H@_%f^3sc9
z6m}J|hMH*$HCL>-+Q++3)XkJW^fi1kA7RRxfPTbkhfo<t?=mZ^!zN`!eHPv&<<uf7
z)Tq<wk1#sG2&Ir2cSd&Up-|IVsEq1E^qtad1bOzHd^>Ym<`U-cjs-oKW#pl$H8zk1
zq{i5VuX+Gql~UY|H~2bX=}<?eQ9IcS>v{lDzF{4urF5K$=VdJtqmoN_D{2+qtm7T-
zAnGGfX~}4x54Bka^iH>alZ$b-VMJ-EZzmB8EI_U<*hRe0#fqy9segCiQ|=?rBk;Ck
z8{T#F$hez&Pt!(bnHr)WwI1{~Gc|94QDe^{LNbrKU`FZJ@qW`L-p^7x{Gd|(?na#y
zEnE{>k~E?<jMWU_Er?-w-=jKnIf*xb=&voHetZe<r>-W~WJTi^s*HD#qo5VQC~zC<
z7-=CHs9v;n)SMb(2z3h?M2NG9XilJJa29pb#kxAdb!iRK``bk%M8}zolVTSk4;S9r
zr1YcgGf{7vMg<$K+5uD`4MPTxA`&u=_a2y0p#CnPPIm#7x=VOpWfgV@{fRBSsj`E3
z$v$c#DEZnD52n=f!BR6&17<_^^}u^$wr2>Hpc&NgQSwplQR>aZqgg}^4`tjY>a+G>
z*B!!2XhqepSLPfH>GyTRZlJ9<g13XlkOiZUnn&E077nfLHJRPml-Ui+r-Q(uw0kI-
zI^oNt@lF&i!(muKqw<}Sob)0J@|}{Rw2Df|52{L{Jz0I1MjmtoHqtbt#u8*j88LuX
z#0U*p#WIMxZbvHQ5NXfDa-KsLqKFD_+RSUH@-CyQVHa}31u5Z%oaoRslk}U@$e0eG
z)_Yjy8kFRiMC6VZ(7d!m7iCrc8fuj{@V=#i7)n~!dkw%g9f1d&MT}t*wfT7|QHoNY
ztU;P=qMl&~^5g*0q!pe8<w+-`iG}xhC{I)bjB$ya%&Jj}%tMAOq56SRWK+tJJt;w2
zrTlQRnQ3W>QF@F>*}-hwH0oO^H;RxND~RJ#Zj`0eIFM4qEoBC41Nc5@4`jxGlo+G%
zP;;=BDKQFCUMxvzQIfJ^M@kAI<%9<n0-dNLr<~}KQesHTh%9VtMg#MZ5%W?)tVsE=
ziP+H&BEkod53P_69@KAiLOxh{ORWbPsR3CdI*Ryk4$@&76>J5(_gS=;U>#CEY}#d~
zA`=!5C4*PKzimmW&?jZWh?EF9<VB|uF)hfP-4fn*T9eYCjCUON;OPszhwMhhr58~e
zL&||3DFue449KE(VG<S2dB}iyDFId_|8Gj}-;=!GDmmYaNRENGY0}7-^+~=TkzAhx
z&ric^Dj*+TM0M~ADz!>@!>o+BGPxbLPWq%+2Cob7x*K*Gx!sVw&RW$0yw^lN&q^+z
zmOMT$IebO(_on3TJ;~dxlC!;%uPw>deUhg~BuD2YKj&e=%;PP^C7F37N3-5?54D!$
zXg6#WFY5Qn(P_!g1A!rM^r+<LNyN@o#YPc1iWP8l3GX475q}~#3&bAXh&_72%?2Xk
zY1kEg;OHUA&sjtTCJ_<HBN{M|?CcUOhc#JsR7QMu58N!^3Az!n^diq;pt3nF?Suho
zC5%cNVN$*&S&;U@lCF^01kdkC%Rorm-y^L80~OznT`&Y0FbcaMhuWNJS(ifzu+-E}
za3gEtMIDnNxxc3&(>Mw5Cy$8fyo@KVAevYL*O#3LJNzKGv?Dr^SvisfKTDDzgDR#e
Q*Z_;t0+8M)7*>e?2c(O<O8@`>

literal 769536
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

diff --git a/ShellBinPkg/UefiShell/Ia32/Shell.efi b/ShellBinPkg/UefiShell/Ia32/Shell.efi
index 7fb32890cf82024091ea29acb8d5504142811d17..ed018b9cb7c64a55d70a442929c2cbf521c18cd7 100644
GIT binary patch
delta 259553
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
TUu}O_F`xgKH20bO|Ki`D|Hvn5

delta 250795
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%0AU2pa625xh
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%0D@XFWL-3;Q0m{ad
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
CFuwHw

diff --git a/ShellBinPkg/UefiShell/X64/Shell.efi b/ShellBinPkg/UefiShell/X64/Shell.efi
index 13858c1411a671324140ac6ee4689b25764d9a27..10a3a5295036d3d33122b26d99403a172bd599b6 100644
GIT binary patch
delta 269861
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

delta 259864
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


From 72cd938a0a3c17687123c376b99b6bf85a19fbb2 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 09:13:07 +0000
Subject: [PATCH 320/525] Sync missing part of r19180&r19181 from main trunk.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19418 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib.uni            | Bin 140676 -> 139230 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index 448897024f199b23370ee36914188c9084f6a72b..5f9910cfe6387f6864d899577b509e885278f54f 100644
GIT binary patch
delta 163
zcmZoU&2eu($A+|!$rr-d7+og|hRRPa;WV23D%eR>fuW2cks*g6lOcscfgymwnZc7m
zfBL~ZM#<?psf+@X4LBtxCxoyudouU~^(jy0;4s>p6Pmz0nQ5xiWWGoaMy<__QKgKN
zH^eJ6AB&lOEQV2pw+3jEF3=o*AYC&(J(jU}x<V@Bk?pr)8J*atC(LI|+kP*dQHXc?
O15?JT?P}$Waq9r$oHCjK

delta 774
zcmb`FOK1~O6o$_+X=bWTOkZ|v6LSr=Rj73`KIlS2D+KK#R!m$>Q_;lCR53I$HlX67
zph$N<E_k->#*HFE7g;E%v~;1MAg;9(ie0AAl`GFoh!l#h<idUZbN>6CpZWeyeeg+r
zZKwSyNWd9L@_Y``G#|yi(rz)RV;O^<UdYQ4wUa)#<3V{P?US=+w={a<a>X26SiNX?
z<m#f3x)N>H;WqSw4u;H{{W4(s@R;1#A8|AfYjXE|ziZ$qLk;Cm)lj3#6N3}1hMl@y
z4NtyXxNKHX>dl&C(sY4gN92<i5jht+tCYclEad4!5+kyd3f-@bQ*9izQyIuWip5E|
z1OiS&1#Y>!dwe<!qcFznU%w&Tz{JyNfV2#jC^&}R>iG$bD>S2_mu54#q}06yeObdp
z^y>|VNEoQnw@C~hFGG>XG{2C8GF*o|Q&@bm`L^u7pXAKz3|W|Botfkhvx`<H*yDK|
zHG2FOchc82>}$$7?9^&t*Z*?wAaN4y>gH8!^V7@`^o3(E$PA-QD43_nb3HNP5L4?i
zw$oC9d))Vv`PThATEhS8u|ioLJL&Em?qO$Ri+7RT3vh@1ot;Io8{Cz6i9Y&Rz&5H`
z=sjw4a@Mw-8p%1S4RHN5TyryZIk)(%Kf(Y#+{A80@Q=aS*6HK#ae#&op!zI<xoYVq
HPQCgKNjbm1


From b0140b912724bed1f42b97f0523cebb1af3a3703 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 18 Dec 2015 11:35:44 +0000
Subject: [PATCH 321/525] Sync missing part of r19176 from main trunk.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19421 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiShellDebug1CommandsLib.uni            | Bin 139230 -> 69614 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni b/ShellPkg/Library/UefiShellDebug1CommandsLib/UefiShellDebug1CommandsLib.uni
index 5f9910cfe6387f6864d899577b509e885278f54f..4d9eb1f1db23185ccde3b1bcf80c63a16337e498 100644
GIT binary patch
literal 69614
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
S;DPchY2b-!7XQEh+y4bFh`Qwf

literal 139230
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
I{>1735BJf$;s5{u


From 5e6d79abdb449e69f02de8edabd78fd5df4bafef Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 18 Dec 2015 14:35:58 +0000
Subject: [PATCH 322/525] CryptoPkg: remove global variable 'timeval' from
 OpenSslSupport .h

The header file OpenSslSupport.h not only defines a type 'struct timeval'
but also defines a global variable 'timeval' of that type. The RVCT compiler
does not merge this definition into a common symbol, resulting in duplicate
definition errors in the final link. So remove the variable definition.

(Sync patch r19135 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19422 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Include/OpenSslSupport.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CryptoPkg/Include/OpenSslSupport.h b/CryptoPkg/Include/OpenSslSupport.h
index 2c6e23cee3fe..dc89097041dd 100644
--- a/CryptoPkg/Include/OpenSslSupport.h
+++ b/CryptoPkg/Include/OpenSslSupport.h
@@ -114,7 +114,7 @@ struct tm {
 struct timeval {
   long tv_sec;      /* time value, in seconds */
   long tv_usec;     /* time value, in microseconds */
-} timeval;
+};
 
 struct dirent {
   UINT32  d_fileno;         /* file number of entry */

From 6e6407b74fb06f146a8ba25eb2ca2dab43645afd Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Mon, 21 Dec 2015 07:19:08 +0000
Subject: [PATCH 323/525] NetworkPkg: HttpDxe: Remove unused local variables

Fix gcc build errors [-Werror=unused-but-set-variable].

(Sync patch r18573 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Build-tested-by: Laszlo Ersek <lersek@redhat.com>
[lersek@redhat.com: add more details to commit message]
Signed-off-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19425 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c  | 3 +--
 NetworkPkg/HttpDxe/HttpProto.c | 2 --
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index f26d6f4f3faa..0fa437dc327d 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -2,6 +2,7 @@
   Implementation of EFI_HTTP_PROTOCOL protocol interfaces.
 
   Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
@@ -243,7 +244,6 @@ EfiHttpRequest (
   UINTN                         UrlLen;
   CHAR16                        *HostNameStr;
   HTTP_TOKEN_WRAP               *Wrap;
-  HTTP_TCP_TOKEN_WRAP           *TcpWrap;
   CHAR8                         *FileUrl;
   
   if ((This == NULL) || (Token == NULL)) {
@@ -290,7 +290,6 @@ EfiHttpRequest (
   HostName    = NULL;
   Wrap        = NULL;
   HostNameStr = NULL;
-  TcpWrap     = NULL;
 
   //
   // Parse the URI of the remote host.
diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index b7cd0fdfcc53..165e95cc50a9 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -1035,10 +1035,8 @@ HttpConfigureTcp4 (
   EFI_TCP4_CONFIG_DATA       *Tcp4CfgData;
   EFI_TCP4_ACCESS_POINT      *Tcp4AP;
   EFI_TCP4_OPTION            *Tcp4Option;
-  HTTP_TCP_TOKEN_WRAP        *TcpWrap;
 
   ASSERT (HttpInstance != NULL);
-  TcpWrap = &Wrap->TcpWrap;
 
 
   Tcp4CfgData = &HttpInstance->Tcp4CfgData;

From c3dde2ded7f3bc292030a47402cbde7fbde24001 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Mon, 21 Dec 2015 07:19:40 +0000
Subject: [PATCH 324/525] MdeModulePkg: Clean code to follow C Coding style.

Clean code to follow C Coding style.

(Sync patch r18943 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19426 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
index 6b830fdd9be8..143baabdec9d 100644
--- a/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
+++ b/MdeModulePkg/Library/DxeHttpLib/DxeHttpLib.c
@@ -189,7 +189,7 @@ NetHttpParseAuthorityChar (
       *IsRightBracket = TRUE;
     }
     
-    if (Char == ':' && *IsRightBracket == TRUE) {
+    if (Char == ':' && *IsRightBracket) {
       return UrlParserPortStart;
     }
     return UrlParserHostIpv6;

From fa8accd5cc1417cac84ee05456f824f6f24d2f04 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Mon, 21 Dec 2015 07:20:16 +0000
Subject: [PATCH 325/525] NetworkPkg: Fix a bug in HttpBootDriverBindingStop()
 when destroying child.

If Http Driver is being unloaded or DisconnectController() without
invoke HttpBootStart(), this will cause an unexpected ASSERT.

(Sync patch r19005 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Sriram Subramanian <sriram-s@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19427 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpBootDxe/HttpBootDxe.c | 2 --
 1 file changed, 2 deletions(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootDxe.c b/NetworkPkg/HttpBootDxe/HttpBootDxe.c
index a7fc8a8e2e63..9fb33bbb53ab 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootDxe.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootDxe.c
@@ -50,7 +50,6 @@ HttpBootDestroyIp4Children (
 {
   ASSERT (This != NULL);
   ASSERT (Private != NULL);
-  ASSERT (Private->UsingIpv6 == FALSE);
 
   if (Private->Dhcp4Child != NULL) {
     gBS->CloseProtocol (
@@ -111,7 +110,6 @@ HttpBootDestroyIp6Children (
 {
   ASSERT (This != NULL);
   ASSERT (Private != NULL);
-  ASSERT (Private->UsingIpv6 == TRUE);
   
   if (Private->Ip6Child != NULL) {
     gBS->CloseProtocol (

From 172f71a497ab3db32079326aa915a4c139ef4866 Mon Sep 17 00:00:00 2001
From: Zhang Lubo <lubo.zhang@intel.com>
Date: Mon, 21 Dec 2015 07:20:40 +0000
Subject: [PATCH 326/525] NetworkPkg:Fix a bug the 2nd httpboot fail issue.

Httpboot over Ipv4 or Ipv6 stack,for both Identity and chunked transfer
mode,when the last data has been parsed by HttpLib, the
HttpInstance->NextMsg pointer should point a correct location.Now after
the first successful httpboot for ipv4 or ipv6,the
HttpInstance->NextMsgpoint the character after the last byte, it may
be a bad buffer if we don't receive another HttpHeader, so if call a
2nd httpboot, the wrong NextMsg pointer will cause the httpboot fail,
so we need to check this case in HttpBodyParserCallback function in
the first http boot process.

(Sync patch r19423 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
Reviewed-by: Wu Jiaxin <jiaxin.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19428 6f19259b-4bc3-4df7-8a09-765794883524
---
 NetworkPkg/HttpDxe/HttpImpl.c | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/NetworkPkg/HttpDxe/HttpImpl.c b/NetworkPkg/HttpDxe/HttpImpl.c
index 0fa437dc327d..aee3de517ffb 100644
--- a/NetworkPkg/HttpDxe/HttpImpl.c
+++ b/NetworkPkg/HttpDxe/HttpImpl.c
@@ -778,6 +778,8 @@ HttpBodyParserCallback (
   )
 {
   HTTP_TOKEN_WRAP               *Wrap;
+  UINTN                         BodyLength;
+  CHAR8                         *Body;
 
   if (EventType != BodyParseEventOnComplete) {
     return EFI_SUCCESS;
@@ -788,7 +790,14 @@ HttpBodyParserCallback (
   }
 
   Wrap = (HTTP_TOKEN_WRAP *) Context;
-  Wrap->HttpInstance->NextMsg = Data;
+  Body = Wrap->HttpToken->Message->Body;
+  BodyLength = Wrap->HttpToken->Message->BodyLength;
+  if (Data < Body + BodyLength) {
+    Wrap->HttpInstance->NextMsg = Data;
+  } else {
+    Wrap->HttpInstance->NextMsg = NULL;
+  }
+  
 
   //
   // Free Tx4Token or Tx6Token since already received corrsponding HTTP response.

From 306a99809cf93e381576ebf8346620e7d6bb9e41 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Tue, 22 Dec 2015 01:10:58 +0000
Subject: [PATCH 327/525] SecurityPkg: SecureBootConfigDxe: Remove useless code
 in VFR

Remove suppressif TRUE, disableif TRUE code in VFR. They are useless.

(Sync patch r19429 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Tapan Shah <tapandshah@hpe.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19432 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SecureBootConfigDxe/SecureBootConfig.vfr  | 72 +++----------------
 1 file changed, 11 insertions(+), 61 deletions(-)

diff --git a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
index 1eb3599279d8..e53630c833f0 100644
--- a/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
+++ b/SecurityPkg/VariableAuthenticated/SecureBootConfigDxe/SecureBootConfig.vfr
@@ -46,18 +46,6 @@ formset
       text   = STRING_TOKEN(STR_SECURE_BOOT_STATE_PROMPT),
         text   = STRING_TOKEN(STR_SECURE_BOOT_STATE_CONTENT);
 
-    //
-    // Define of Check Box: Attempt Secure Boot
-    //
-    suppressif TRUE;
-      checkbox varid   = SECUREBOOT_CONFIGURATION.HideSecureBoot,
-              questionid = KEY_HIDE_SECURE_BOOT,
-              prompt   = STRING_TOKEN(STR_NULL),
-              help     = STRING_TOKEN(STR_NULL),
-              flags    = INTERACTIVE,
-      endcheckbox;
-    endif;
-
     //
     // Display of Check Box: Attempt Secure Boot
     //
@@ -73,23 +61,14 @@ formset
     //
     // Display of Oneof: 'Secure Boot Mode'
     //
-    disableif TRUE;
-      oneof varid  = SECUREBOOT_CONFIGURATION.SecureBootMode,
-            prompt = STRING_TOKEN(STR_SECURE_BOOT_MODE_PROMPT),
-            help   = STRING_TOKEN(STR_SECURE_BOOT_MODE_HELP),
-            flags  = INTERACTIVE,
-            option text = STRING_TOKEN(STR_STANDARD_MODE),    value = SECURE_BOOT_MODE_STANDARD, flags = 0;
-            option text = STRING_TOKEN(STR_CUSTOM_MODE),      value = SECURE_BOOT_MODE_CUSTOM,   flags = 0;
-      endoneof;
-    endif;
-      oneof name = SecureBootMode,
-            questionid = KEY_SECURE_BOOT_MODE,
-            prompt = STRING_TOKEN(STR_SECURE_BOOT_MODE_PROMPT),
-            help   = STRING_TOKEN(STR_SECURE_BOOT_MODE_HELP),
-            flags  = INTERACTIVE | NUMERIC_SIZE_1,
-            option text = STRING_TOKEN(STR_STANDARD_MODE),    value = SECURE_BOOT_MODE_STANDARD, flags = DEFAULT;
-            option text = STRING_TOKEN(STR_CUSTOM_MODE),      value = SECURE_BOOT_MODE_CUSTOM,   flags = 0;
-      endoneof;
+    oneof name = SecureBootMode,
+          questionid = KEY_SECURE_BOOT_MODE,
+          prompt = STRING_TOKEN(STR_SECURE_BOOT_MODE_PROMPT),
+          help   = STRING_TOKEN(STR_SECURE_BOOT_MODE_HELP),
+          flags  = INTERACTIVE | NUMERIC_SIZE_1,
+          option text = STRING_TOKEN(STR_STANDARD_MODE),    value = SECURE_BOOT_MODE_STANDARD, flags = DEFAULT;
+          option text = STRING_TOKEN(STR_CUSTOM_MODE),      value = SECURE_BOOT_MODE_CUSTOM,   flags = 0;
+    endoneof;
 
     //
     // Display PK include page
@@ -117,29 +96,7 @@ formset
     //
     // Display of SetupMode/UserMode/AuditMode/DeployedMode transition
     //
-    disableif TRUE;
-      oneof varid  = SECUREBOOT_CONFIGURATION.TransSecureBootMode,
-            prompt = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_PROMPT),
-            help   = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_HELP),
-            flags  = INTERACTIVE,
-      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE
-              OR (ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE AND
-                  ideqval SECUREBOOT_CONFIGURATION.PhysicalPresent == 0);
-            option text = STRING_TOKEN(STR_USER_MODE),     value = SECURE_BOOT_MODE_USER_MODE,   flags = 0;
-      endif
-      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_AUDIT_MODE;
-            option text = STRING_TOKEN(STR_SETUP_MODE),    value = SECURE_BOOT_MODE_SETUP_MODE,  flags = 0;
-      endif
-      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_DEPLOYED_MODE;
-            option text = STRING_TOKEN(STR_AUDIT_MODE),    value = SECURE_BOOT_MODE_AUDIT_MODE,  flags = 0;
-      endif
-      suppressif ideqval SECUREBOOT_CONFIGURATION.CurSecureBootMode == SECURE_BOOT_MODE_SETUP_MODE;
-            option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = SECURE_BOOT_MODE_DEPLOYED_MODE,  flags = 0;
-      endif
-            option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = 4,  flags = 0;
-      endoneof;
-    endif;
-      oneof name   = TransSecureBootMode,
+    oneof name   = TransSecureBootMode,
             questionid = KEY_TRANS_SECURE_BOOT_MODE,
             prompt = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_PROMPT),
             help   = STRING_TOKEN(STR_TRANS_SECURE_BOOT_MODE_HELP),
@@ -159,7 +116,7 @@ formset
             option text = STRING_TOKEN(STR_DEPLOYED_MODE), value = SECURE_BOOT_MODE_DEPLOYED_MODE,  flags = 0;
       endif
 
-      endoneof;
+    endoneof;
 
     subtitle text = STRING_TOKEN(STR_NULL);
 
@@ -212,15 +169,8 @@ formset
     subtitle text = STRING_TOKEN(STR_NULL);
 
     //
-    // Define of Check Box: 'Delete PK'
+    // Display of 'Enroll PK'
     //
-    suppressif TRUE;
-      checkbox varid   = SECUREBOOT_CONFIGURATION.DeletePk,
-               prompt   = STRING_TOKEN(STR_NULL),
-               help     = STRING_TOKEN(STR_NULL),
-      endcheckbox;
-    endif;
-
     grayoutif ideqval SECUREBOOT_CONFIGURATION.HasPk == 1;
     goto FORMID_ENROLL_PK_FORM,
          prompt = STRING_TOKEN(STR_ENROLL_PK),

From c329f50012be7c74842355da1e274b4de16b75d5 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Tue, 22 Dec 2015 01:11:19 +0000
Subject: [PATCH 328/525] Nt32Pkg: Fix VS2015 Build Failure

VS2015 separates vcruntime.lib and ucrt.lib from msvcrt.lib. Per MSDN notes,
If you link with the /nodefaultlib option, you will need to link several
extra libraries when you link. For example, whereas you previously might have
just linked msvcrt.lib in order to use the CRT DLL, you will now also
need to link vcruntime.lib and ucrt.lib. More detail is in
http://blogs.msdn.com/b/vcblog/archive/2015/03/03/introducing-the-universal-crt.aspx

(Sync patch r19430 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19433 6f19259b-4bc3-4df7-8a09-765794883524
---
 Nt32Pkg/Sec/SecMain.inf | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Nt32Pkg/Sec/SecMain.inf b/Nt32Pkg/Sec/SecMain.inf
index fee68e095213..01bde2e0a3ab 100644
--- a/Nt32Pkg/Sec/SecMain.inf
+++ b/Nt32Pkg/Sec/SecMain.inf
@@ -65,15 +65,19 @@
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFirmwareFdSize
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtMemorySizeForSecMain
   gEfiNt32PkgTokenSpaceGuid.PcdWinNtFirmwareVolume
-  
+
 [BuildOptions]
   MSFT:*_*_IA32_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:I386 /LTCG Kernel32.lib MSVCRTD.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
+  MSFT:*_VS2015_IA32_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:I386 /LTCG Kernel32.lib MSVCRTD.lib vcruntimed.lib ucrtd.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
+  MSFT:*_VS2015x86_IA32_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:I386 /LTCG Kernel32.lib MSVCRTD.lib vcruntimed.lib ucrtd.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
   MSFT:*_*_IA32_CC_FLAGS == /nologo /W4 /WX /Gy /c /D UNICODE /Od /FIAutoGen.h /EHs-c- /GF /Gs8192 /Zi /Gm /D _CRT_SECURE_NO_WARNINGS /D _CRT_SECURE_NO_DEPRECATE
   MSFT:*_*_IA32_PP_FLAGS == /nologo /E /TC /FIAutoGen.h
   MSFT:*_*_IA32_ASM_FLAGS == /nologo /W3 /WX /c /coff /Cx /Zd /W0 /Zi
   MSFT:*_*_IA32_ASMLINK_FLAGS       == /link /nologo /tiny
 
   MSFT:*_*_X64_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib\AMD64" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib\AMD64" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:AMD64 /LTCG Kernel32.lib MSVCRTD.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
+  MSFT:*_VS2015_X64_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib\AMD64" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib\AMD64" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:AMD64 /LTCG Kernel32.lib MSVCRTD.lib vcruntimed.lib ucrtd.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
+  MSFT:*_VS2015x86_X64_DLINK_FLAGS == /out:"$(BIN_DIR)\SecMain.exe" /base:0x10000000 /pdb:"$(BIN_DIR)\SecMain.pdb" /LIBPATH:"$(VCINSTALLDIR)\Lib\AMD64" /LIBPATH:"$(VCINSTALLDIR)\PlatformSdk\Lib\AMD64" /NOLOGO /SUBSYSTEM:CONSOLE /NODEFAULTLIB /IGNORE:4086 /MAP /OPT:REF /DEBUG /MACHINE:AMD64 /LTCG Kernel32.lib MSVCRTD.lib vcruntimed.lib ucrtd.lib Gdi32.lib User32.lib Winmm.lib Advapi32.lib
   MSFT:*_*_X64_CC_FLAGS == /nologo /W4 /WX /Gy /c /D UNICODE /Od /FIAutoGen.h /EHs-c- /GF /Gs8192 /Zi /Gm /D _CRT_SECURE_NO_WARNINGS /D _CRT_SECURE_NO_DEPRECATE
   MSFT:*_*_X64_PP_FLAGS == /nologo /E /TC /FIAutoGen.h
   MSFT:*_*_X64_ASM_FLAGS == /nologo /W3 /WX /c /Cx /Zd /W0 /Zi

From 6eb6ec20158fe7c85b0edea45c57a1512d59581f Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Tue, 22 Dec 2015 01:19:26 +0000
Subject: [PATCH 329/525] BaseTools: Update Scripts to support VS2015 env

edk2 Edk2Setup.bat depends on those scripts to configure VS env.
Update them to support VS2015.

(Sync patch r19431 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19434 6f19259b-4bc3-4df7-8a09-765794883524
---
 BaseTools/Scripts/SetVisualStudio.bat |  5 +++++
 BaseTools/Scripts/ShowEnvironment.bat | 19 +++++++++++++++----
 BaseTools/get_vsvars.bat              |  1 -
 3 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/BaseTools/Scripts/SetVisualStudio.bat b/BaseTools/Scripts/SetVisualStudio.bat
index d379cd73dff4..de2f91274d32 100755
--- a/BaseTools/Scripts/SetVisualStudio.bat
+++ b/BaseTools/Scripts/SetVisualStudio.bat
@@ -25,6 +25,11 @@
 
 :CheckLatest
 echo.
+@if defined VS140COMNTOOLS (
+   @set "COMMONTOOLSx64=C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\x86_amd64"
+   @goto SetVs
+)
+
 @if defined VS120COMNTOOLS (
    @set "COMMONTOOLSx64=C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\x86_amd64"
    @goto SetVs
diff --git a/BaseTools/Scripts/ShowEnvironment.bat b/BaseTools/Scripts/ShowEnvironment.bat
index 2b320fbc2152..5dd30b45a4b5 100755
--- a/BaseTools/Scripts/ShowEnvironment.bat
+++ b/BaseTools/Scripts/ShowEnvironment.bat
@@ -55,7 +55,7 @@ if defined SRC_CONF @goto SetEnv
 @if defined PYTHON_FREEZER_PATH @echo     PYTHON_FREEZER_PATH  = %PYTHON_FREEZER_PATH%
 @if "%NT32PKG%"=="TRUE" (
     @echo.
-    @echo NOTE: Please configure your build to use the following TOOL_CHAIN_TAG 
+    @echo NOTE: Please configure your build to use the following TOOL_CHAIN_TAG
     @echo       when building NT32Pkg/Nt32Pkg.dsc
     @if defined VCINSTALLDIR @call :CheckVsVer
     @set TEST_VS=
@@ -130,6 +130,17 @@ if defined SRC_CONF @goto SetEnv
     @echo     TOOL_CHAIN_TAG       = VS2013
     @goto :EOF
 )
+
+@set "TEST_VS=C:\Program Files (x86)\Microsoft Visual Studio 14.0\"
+@if "%VSINSTALLDIR%"=="%TEST_VS%" (
+    @echo     TOOL_CHAIN_TAG       = VS2015x86
+    @goto :EOF
+)
+@set "TEST_VS=C:\Program Files\Microsoft Visual Studio 14.0\"
+@if "%VSINSTALLDIR%"=="%TEST_VS%" (
+    @echo     TOOL_CHAIN_TAG       = VS2015
+    @goto :EOF
+)
 @goto :EOF
 
 :SetEnv
@@ -153,7 +164,7 @@ if defined SRC_CONF @goto SetEnv
     @copy /Y "%SRC_CONF%\tools_def.template" "%WORKSPACE%\Conf\tools_def.txt" > nul
     @set FIRST_COPY=TRUE
 )
-@if not exist "%WORKSPACE%\Conf\build_rule.txt" (   
+@if not exist "%WORKSPACE%\Conf\build_rule.txt" (
     @if "%MISSING_BUILD_RULE_TEMPLATE%"=="TRUE" @goto MissingTemplates
     @echo copying ... build_rule.template to %WORKSPACE%\Conf\build_rule.txt
     @copy /Y "%SRC_CONF%\build_rule.template" "%WORKSPACE%\Conf\build_rule.txt" > nul
@@ -171,11 +182,11 @@ if defined SRC_CONF @goto SetEnv
     @if "%MISSING_TARGET_TEMPLATE%"=="TRUE" @goto MissingTemplates
     @echo over-write ... target.template to %WORKSPACE%\Conf\target.txt
     @copy /Y "%SRC_CONF%\target.template" "%WORKSPACE%\Conf\target.txt" > nul
-    
+
     @if "%MISSING_TOOLS_DEF_TEMPLATE%"=="TRUE" @goto MissingTemplates
     @echo over-write ... tools_def.template to %WORKSPACE%\Conf\tools_def.txt
     @copy /Y "%SRC_CONF%\tools_def.template" "%WORKSPACE%\Conf\tools_def.txt" > nul
-    
+
     @if "%MISSING_BUILD_RULE_TEMPLATE%"=="TRUE" @goto MissingTemplates
     @echo over-write ... build_rule.template to %WORKSPACE%\Conf\build_rule.txt
     @copy /Y "%SRC_CONF%\build_rule.template" "%WORKSPACE%\Conf\build_rule.txt" > nul
diff --git a/BaseTools/get_vsvars.bat b/BaseTools/get_vsvars.bat
index b67a81d78052..7649e1dccf47 100644
--- a/BaseTools/get_vsvars.bat
+++ b/BaseTools/get_vsvars.bat
@@ -34,7 +34,6 @@ REM       (Or invoke the relevant vsvars32 file beforehand).
 :main
 if defined VCINSTALLDIR goto :done
   if defined VS140COMNTOOLS  call :read_vsvars  "%VS140COMNTOOLS%"
-  if defined VS130COMNTOOLS  call :read_vsvars  "%VS130COMNTOOLS%"
   if defined VS120COMNTOOLS  call :read_vsvars  "%VS120COMNTOOLS%"
   if defined VS110COMNTOOLS  call :read_vsvars  "%VS110COMNTOOLS%"
   if defined VS100COMNTOOLS  call :read_vsvars  "%VS100COMNTOOLS%"

From 004b82b369eb3070695a2ed1163235bbab20f3e3 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Tue, 22 Dec 2015 08:41:32 +0000
Subject: [PATCH 330/525] MdeModulePkg: Add PCD description to MdeModulePkg.uni

(Sync patch r19438 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19439 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dec |  28 ++++++++++++++--------------
 MdeModulePkg/MdeModulePkg.uni | Bin 188464 -> 199440 bytes
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 3ded8f1de1a5..ea70c7e3dabc 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -962,19 +962,19 @@
   #  Each array entry is 24-byte in length. The array is terminated
   #  by an array entry with a PCI Vendor ID of 0xFFFF. If a platform only contains a
   #  standard 16550 PCI serial device whose class code is 7/0/2, the value is 0xFFFF.
-  #  The C style structure is defined as below:
-  #  typedef struct {
-  #    UINT16  VendorId;          ///< Vendor ID to match the PCI device.  The value 0xFFFF terminates the list of entries.
-  #    UINT16  DeviceId;          ///< Device ID to match the PCI device
-  #    UINT32  ClockRate;         ///< UART clock rate.  Set to 0 for default clock rate of 1843200 Hz
-  #    UINT64  Offset;            ///< The byte offset into to the BAR
-  #    UINT8   BarIndex;          ///< Which BAR to get the UART base address
-  #    UINT8   RegisterStride;    ///< UART register stride in bytes.  Set to 0 for default register stride of 1 byte.
-  #    UINT16  ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
-  #    UINT16  TransmitFifoDepth; ///< UART transmit FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.
-  #    UINT8   Reserved[2];
-  #  } PCI_SERIAL_PARAMETER;
-  #  It contains zero or more instances of the above structure.
+  #  The C style structure is defined as below:<BR>
+  #  typedef struct {<BR>
+  #    UINT16  VendorId;          ///< Vendor ID to match the PCI device. The value 0xFFFF terminates the list of entries.<BR>
+  #    UINT16  DeviceId;          ///< Device ID to match the PCI device.<BR>
+  #    UINT32  ClockRate;         ///< UART clock rate. Set to 0 for default clock rate of 1843200 Hz.<BR>
+  #    UINT64  Offset;            ///< The byte offset into to the BAR.<BR>
+  #    UINT8   BarIndex;          ///< Which BAR to get the UART base address.<BR>
+  #    UINT8   RegisterStride;    ///< UART register stride in bytes. Set to 0 for default register stride of 1 byte.<BR>
+  #    UINT16  ReceiveFifoDepth;  ///< UART receive FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.<BR>
+  #    UINT16  TransmitFifoDepth; ///< UART transmit FIFO depth in bytes. Set to 0 for a default FIFO depth of 16 bytes.<BR>
+  #    UINT8   Reserved[2];<BR>
+  #  } PCI_SERIAL_PARAMETER;<BR>
+  #  It contains zero or more instances of the above structure.<BR>
   #  For example, if a PCI device contains two UARTs, PcdPciSerialParameters needs
   #  to contain  two instances of the above structure, with the VendorId and DeviceId
   #  equals to the Device ID and Vendor ID of the device; If the PCI device uses the
@@ -982,7 +982,7 @@
   #  BarIndex of second one equals to 1; If the PCI device uses the first BAR to
   #  support both UARTs, BarIndex of both instance equals to 0, Offset of first
   #  instance equals to 0 and Offset of second one equals to a value bigger than or
-  #  equal to 8.
+  #  equal to 8.<BR>
   #  For certain UART whose register needs to be accessed in DWORD aligned address,
   #  RegisterStride equals to 4.
   # @Prompt Pci Serial Parameters
diff --git a/MdeModulePkg/MdeModulePkg.uni b/MdeModulePkg/MdeModulePkg.uni
index cf4f580dbe00f37290742a5e8eb968197b45653c..ea385ff17845671140caaf0fdb6d8a489af0fe08 100644
GIT binary patch
delta 3451
zcmcguU2Kz87(U-;6C49!`xrQ9<JZEn0K>Hd*}^dLGhvM&+Zb@+&(i&|1=vPgHo+LU
z@Q%cQC*fQu1`;mx%9(iK1vsnX9~y&+*J`4PQ6`cwP!q)GIj5)X+A?-!ny%l@_nzl{
z-sikOXX2ysQ)d>Oc-48|t^ZMuog57A5lPW6+C*F&6a)HqSoC3S5Gx1d)eTK*^d09R
zXScjFT^;hXhUST;zSwPy0TY&oPac{bQiU!%I}Kc&FOF#MNr2EF8JH&nY+1y^SLLSi
zfSUNsSt9?Pet51M)#U5$55|}3Y<4S`8+WrhQ}4C8p1if{#WP<yf#7Zgl@LRkTRZ+H
z@I8dJ6xU@%qDgJq>;&qDv<f*>UlbW5(6GF*s&@{s=?iP+Kff*YN?@ptQ()Kp`_gCj
zf&o<;0jHQ~74@LdinTGY?ZvNM+X_`juyR0jf;)NBau<{y(AuX&y*mGaGg-mlVj8kv
zyhJ0}{dcgI#+}$i$RU9Di*5KF03@A_0&q~&%hP{(6-DdnO3bN|!`J3Z_r^taZKLz(
z%F#jzLBR(Wk39)A`q5&`D^s;jQgwXnUUI^6dTQmuMzKz;5k2B4W00%=sGipa*ZrV5
zezT4q<hh$0qWP-$S_2CoK~UQ=pU2@Yrk%!B`i|q(&}bM!9mR`Y{hR{RA*?0kqUm%^
z5>De<8>+;dkBar;349`Cy4DxtATy!`CBi{iCv|K@>myB|G1ey0AR_oS%8pxg4}g%4
zQAN^DK%VFhEb_%xSkd26p!Cbo+sm9Gb+_B8!T}MW2VgwWaj`*Glz$QmYg0-`H%7=5
zNFD)=6zpH7mGr+4EceA8ME$Jj(&T--%U3Ig{Vg(DUbUtH^cuv*g7;R<6ny)r0p?P#
z7?h#wp8R>LQnmi#EUC^H*@pou;t+L|=f}O^L9GEvnG<IMlj;!ck}AE|{k)c}3R%v~
z>SC7p?`L6IMtyX3sE(+6nUcVrb+%SC!Zp<|EEkI6m1RYdKmEF_mTiF1F_GB+*bo>m
zrHSCn`bfyr=e!2yf+;^Ak(ymL{-|h1Qqyxp?`jjr>|s5YW40bP^pan)<W#*q%LzxS
zOTm^0tf{aqaONJBCOiAr*l!V=MW^+dmmtmBqc66Aaei0O3DT1DyAOWZZU$kmv9cca
zXEiaN_Ry2)Qr~`up3wE$hwSG(f{I+A8K-PJH7ywezRpFHjTs1;9`l|wCBoF<shR*;
z8@fB7PVRd!a_rb*j58Km4#lKp6nGgVos`E*CFT8kq6r|URE9jD6Cj-HraoFy4BuUN
z!%$2|oe|IqESre#k!aW&XR<9X4P~QR&$!g-R>xCc?{zOi`JDD_XFl8b>Y_F-7)q%?
zQgY;WP0Kw<{|}sXzR1uU-n{2fLNB0uq0=>l#Vg?3jzW%!Zj|QJNV^!4ZwLNs*Gafp
z?8Iu9exvuui5&rX;aWtkIO{G}J(W&nSsWQK!f}TNTqOq=ekw=r&Ogq<$oW6Y)~x3!
zM<LYDdNhY<XK>Llfn5rnn}ui-BB^oOkrI92$MJX1JI7);P3R#oj3+dFdH2uBpsDDY
zQ;SEd9jVY+*DDdyQ=IGLaK`yfTT`Wl1A(ELt5_@i*|0Dwq;um^MZY+VF~e&c2NQUx
zcW*n@HN1J`Hs(Y6YHGq=hJ6-^sf9tzArfRF+4cO3q2@+^^1<s1s;qpb+gQKxX4h-7
zuVyM+*ure{9YF9DGewE2f<>`_89TX-Utf@7Gh3m>NrJW!pVtCjBiN5h!9{f?Wx{Qm
zHC!NM`QbUQwNi-fNyt8m5AS{)Jj_*dkaLSYW3MA`Dn&I?bV;<~W@(X#3cu-AqACi~
z0F1KI;W>YBS(v%2#@ZUwNp?gl+k<o4j}J>hC$9SD5vR;a=nQGxTIn>iX@6NqZCHP_
zvzNJC)nzYiGE`Sp?(0+I4JxS`-f~yg?gQ!0Od9jnvR@nUfa5Ug10-6qOn)(n%PGdy
TiqZ$Z4rAzf><o*AV!rqf`$5^r

delta 18
ZcmbO*jc3CF?uHh|ElfHOSa=z@7yv^t1&{y$


From dbbf51f6bde01d36956a29543ba3ac325b41e729 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:34:09 +0000
Subject: [PATCH 331/525] MdeModulePkg ScsiDiskDxe: Set block I/O media of SCSI
 CDROM to read-only

(Sync patch r19443 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19464 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index d83fa24a4fe0..8d8209b12102 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -256,6 +256,7 @@ ScsiDiskDriverBindingStart (
 
   case EFI_SCSI_TYPE_CDROM:
     ScsiDiskDevice->BlkIo.Media->BlockSize = 0x800;
+    ScsiDiskDevice->BlkIo.Media->ReadOnly  = TRUE;
     MustReadCapacity = FALSE;
     break;
   }

From 7794116bcdf6066b6f5483f116efb00fe69cb25e Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:34:36 +0000
Subject: [PATCH 332/525] MdeModulePkg ScsiDiskDxe: Modify FlushBlocksEx() to
 follow UEFI spec

The function ScsiDiskFlushBlocksEx() in ScsiDiskDxe/ScsiDisk.c originally
always returns EFI_SUCCESS, which is not aligned with the UEFI spec.

This commit adds addtional checks to see if the media in the device is
changed or removed. Check for whether the device can be written is also
added. Corresponding status will be returned according to the check
result.

(Sync patch r19444 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19465 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 71 ++++++++++++++++++--
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h | 10 +--
 2 files changed, 71 insertions(+), 10 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 8d8209b12102..4f58254c3b35 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -1116,10 +1116,12 @@ ScsiDiskWriteBlocksEx (
   @param  This       Indicates a pointer to the calling context.
   @param  Token      A pointer to the token associated with the transaction.
 
-  @retval EFI_SUCCESS       All outstanding data was written to the device.
-  @retval EFI_DEVICE_ERROR  The device reported an error while writing back the
-                            data.
-  @retval EFI_NO_MEDIA      There is no media in the device.
+  @retval EFI_SUCCESS         All outstanding data was written to the device.
+  @retval EFI_DEVICE_ERROR    The device reported an error while attempting to
+                              write data.
+  @retval EFI_WRITE_PROTECTED The device cannot be written to.
+  @retval EFI_NO_MEDIA        There is no media in the device.
+  @retval EFI_MEDIA_CHANGED   The MediaId is not for the current media.
 
 **/
 EFI_STATUS
@@ -1129,15 +1131,72 @@ ScsiDiskFlushBlocksEx (
   IN OUT EFI_BLOCK_IO2_TOKEN     *Token
   )
 {
+  SCSI_DISK_DEV       *ScsiDiskDevice;
+  EFI_BLOCK_IO_MEDIA  *Media;
+  EFI_STATUS          Status;
+  BOOLEAN             MediaChange;
+  EFI_TPL             OldTpl;
+
+  MediaChange    = FALSE;
+  OldTpl         = gBS->RaiseTPL (TPL_CALLBACK);
+  ScsiDiskDevice = SCSI_DISK_DEV_FROM_BLKIO2 (This);
+
+  if (!IS_DEVICE_FIXED(ScsiDiskDevice)) {
+
+    Status = ScsiDiskDetectMedia (ScsiDiskDevice, FALSE, &MediaChange);
+    if (EFI_ERROR (Status)) {
+      Status = EFI_DEVICE_ERROR;
+      goto Done;
+    }
+
+    if (MediaChange) {
+      gBS->ReinstallProtocolInterface (
+            ScsiDiskDevice->Handle,
+            &gEfiBlockIoProtocolGuid,
+            &ScsiDiskDevice->BlkIo,
+            &ScsiDiskDevice->BlkIo
+            );
+      gBS->ReinstallProtocolInterface (
+             ScsiDiskDevice->Handle,
+             &gEfiBlockIo2ProtocolGuid,
+             &ScsiDiskDevice->BlkIo2,
+             &ScsiDiskDevice->BlkIo2
+             );
+      Status = EFI_MEDIA_CHANGED;
+      goto Done;
+    }
+  }
+
+  Media = ScsiDiskDevice->BlkIo2.Media;
+
+  if (!(Media->MediaPresent)) {
+    Status = EFI_NO_MEDIA;
+    goto Done;
+  }
+
+  if (Media->ReadOnly) {
+    Status = EFI_WRITE_PROTECTED;
+    goto Done;
+  }
+
   //
-  // Signal event and return directly.
+  // Wait for the BlockIo2 requests queue to become empty
+  //
+  while (!IsListEmpty (&ScsiDiskDevice->BlkIo2Queue));
+
+  Status = EFI_SUCCESS;
+
+  //
+  // Signal caller event
   //
   if ((Token != NULL) && (Token->Event != NULL)) {
     Token->TransactionStatus = EFI_SUCCESS;
     gBS->SignalEvent (Token->Event);
   }
 
-  return EFI_SUCCESS;
+Done:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
 }
 
 
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
index 836e7caeeda1..b6f801d92aa1 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
@@ -555,10 +555,12 @@ ScsiDiskWriteBlocksEx (
   @param  This       Indicates a pointer to the calling context.
   @param  Token      A pointer to the token associated with the transaction.
 
-  @retval EFI_SUCCESS       All outstanding data was written to the device.
-  @retval EFI_DEVICE_ERROR  The device reported an error while writing back the
-                            data.
-  @retval EFI_NO_MEDIA      There is no media in the device.
+  @retval EFI_SUCCESS         All outstanding data was written to the device.
+  @retval EFI_DEVICE_ERROR    The device reported an error while attempting to
+                              write data.
+  @retval EFI_WRITE_PROTECTED The device cannot be written to.
+  @retval EFI_NO_MEDIA        There is no media in the device.
+  @retval EFI_MEDIA_CHANGED   The MediaId is not for the current media.
 
 **/
 EFI_STATUS

From 1c53b2387cd6a6edb2bea804040127d6e98dded0 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:35:01 +0000
Subject: [PATCH 333/525] MdeModulePkg ScsiDiskDxe: Modify WriteBlocks(Ex)() to
 follow UEFI spec

The functions ScsiDiskWriteBlocks(Ex) in ScsiDiskDxe/ScsiDisk.c do not
check whether the device is allow to be written originally.

This commit will add read-only check to follow the UEFI spec.

(Sync patch r19445 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19466 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 4f58254c3b35..238718501c1b 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -692,6 +692,11 @@ ScsiDiskWriteBlocks (
     goto Done;
   }
 
+  if (Media->ReadOnly) {
+    Status = EFI_WRITE_PROTECTED;
+    goto Done;
+  }
+
   if (BufferSize == 0) {
     Status = EFI_SUCCESS;
     goto Done;
@@ -1048,6 +1053,11 @@ ScsiDiskWriteBlocksEx (
     goto Done;
   }
 
+  if (Media->ReadOnly) {
+    Status = EFI_WRITE_PROTECTED;
+    goto Done;
+  }
+
   if (BufferSize == 0) {
     if ((Token != NULL) && (Token->Event != NULL)) {
       Token->TransactionStatus = EFI_SUCCESS;

From 1a77164911aaf60d45d00caab421e2a7587deaa1 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:35:24 +0000
Subject: [PATCH 334/525] MdeModulePkg DiskIoDxe: Check for MediaPresent in
 DiskIo2ReadWriteDisk()

Add check to see if there is a media in the disk device. If not return
EFI_NO_MEDIA directly.

(Sync patch r19446 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19467 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIo.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIo.c b/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIo.c
index 0f0dbfee8280..97f2d508a277 100644
--- a/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIo.c
+++ b/MdeModulePkg/Universal/Disk/DiskIoDxe/DiskIo.c
@@ -833,6 +833,10 @@ DiskIo2ReadWriteDisk (
   Status    = EFI_SUCCESS;
   Blocking  = (BOOLEAN) ((Token == NULL) || (Token->Event == NULL));
 
+  if (!(Media->MediaPresent)) {
+    return EFI_NO_MEDIA;
+  }
+
   if (Media->MediaId != MediaId) {
     return EFI_MEDIA_CHANGED;
   }

From a14f95dc9eb8490cf2e3eb4f0645008383e7f4c3 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:35:47 +0000
Subject: [PATCH 335/525] MdeModulePkg ScsiBusDxe: Only signal caller event
 when PassThru() succeeds

In ScsiExecuteSCSICommand(), when SCSI devices do not support non-blocking
I/O but an event is passed from caller (UefiScsiLib), the function will
execute the SCSI I/O command in a blocking manner and signal the caller
event when the command completes.

Originally, caller event from UefiScsiLib will be signaled if the SCSI
command fails. UefiScsiLib will continue to signal its caller (BlockIO2
request from ScsiDiskDxe driver), which is not aligned with the UEFI spec
that event will not be signaled when BlockIO2 request returns with error.

This commit will signal ScsiExecuteSCSICommand()'s caller event only when
the SCSI command succeeds.

(Sync patch r19447 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19468 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
index 8eb73e7673fa..b10e25a38e9c 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
@@ -1007,9 +1007,10 @@ ScsiExecuteSCSICommand (
                                                 ExtRequestPacket,
                                                 NULL
                                                 );
-      if (Event != NULL) {
+      if ((!EFI_ERROR(Status)) && (Event != NULL)) {
         //
-        // Signal Event to tell caller to pick up the SCSI IO Packet.
+        // Signal Event to tell caller to pick up the SCSI IO packet if the
+        // PassThru() succeeds.
         //
         gBS->SignalEvent (Event);
       }

From 69fa9171637019d22d834825f4a81f4b9da7c815 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:36:07 +0000
Subject: [PATCH 336/525] MdePkg UefiScsiLib: Close event when SCSI command
 fails

The ScsiExecuteSCSICommand() function in ScsiBusDxe driver will not signal
the event passed from UefiScsiLib when error occurs.

In this case, UefiScsiLib should close the event passing to
ScsiExecuteSCSICommand().

(Sync patch r19448 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19469 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 48 ++++++++++++++++++++++--
 1 file changed, 44 insertions(+), 4 deletions(-)

diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
index d8babcee406a..0a08e4468ed0 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
@@ -1494,7 +1494,17 @@ ScsiRead10CommandEx (
     goto ErrorExit;
   }
 
-  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+  Status = ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+  if (EFI_ERROR(Status)) {
+    //
+    // Since ScsiLibNotify() will not be signaled if ExecuteScsiCommand()
+    // returns with error, close the event here.
+    //
+    gBS->CloseEvent (SelfEvent);
+    goto ErrorExit;
+  } else {
+    return EFI_SUCCESS;
+  }
 
 ErrorExit:
   if (Context != NULL) {
@@ -1668,7 +1678,17 @@ ScsiWrite10CommandEx (
     goto ErrorExit;
   }
 
-  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+  Status = ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+  if (EFI_ERROR(Status)) {
+    //
+    // Since ScsiLibNotify() will not be signaled if ExecuteScsiCommand()
+    // returns with error, close the event here.
+    //
+    gBS->CloseEvent (SelfEvent);
+    goto ErrorExit;
+  } else {
+    return EFI_SUCCESS;
+  }
 
 ErrorExit:
   if (Context != NULL) {
@@ -1842,7 +1862,17 @@ ScsiRead16CommandEx (
     goto ErrorExit;
   }
 
-  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+  Status = ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+  if (EFI_ERROR(Status)) {
+    //
+    // Since ScsiLibNotify() will not be signaled if ExecuteScsiCommand()
+    // returns with error, close the event here.
+    //
+    gBS->CloseEvent (SelfEvent);
+    goto ErrorExit;
+  } else {
+    return EFI_SUCCESS;
+  }
 
 ErrorExit:
   if (Context != NULL) {
@@ -2016,7 +2046,17 @@ ScsiWrite16CommandEx (
     goto ErrorExit;
   }
 
-  return ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, Event);
+  Status = ScsiIo->ExecuteScsiCommand (ScsiIo, CommandPacket, SelfEvent);
+  if (EFI_ERROR(Status)) {
+    //
+    // Since ScsiLibNotify() will not be signaled if ExecuteScsiCommand()
+    // returns with error, close the event here.
+    //
+    gBS->CloseEvent (SelfEvent);
+    goto ErrorExit;
+  } else {
+    return EFI_SUCCESS;
+  }
 
 ErrorExit:
   if (Context != NULL) {

From 6e2692b2205065fa1caa12ea9b4799dbe0d1f0bb Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:36:31 +0000
Subject: [PATCH 337/525] MdeModulePkg ScsiDiskDxe: Close event when SCSI
 command fails

The functions ScsiRead10CommandEx(), ScsiWrite10CommandEx(),
ScsiRead16CommandEx() and ScsiWrite16CommandEx() in UefiScsiLib will not
signal the event passed from ScsiDiskDxe when error occurs.

In this case, ScsiDiskDxe should close the event passing to these APIs in
UefiScsiLib.

(Sync patch r19449 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19470 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 24 ++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 238718501c1b..033be239634c 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -3659,6 +3659,8 @@ ScsiDiskAsyncRead10 (
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
 
+  AsyncIoEvent = NULL;
+
   Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
@@ -3714,6 +3716,10 @@ ScsiDiskAsyncRead10 (
   return EFI_SUCCESS;
 
 ErrorExit:
+  if (AsyncIoEvent != NULL) {
+    gBS->CloseEvent (AsyncIoEvent);
+  }
+
   if (Request != NULL) {
     if (Request->SenseData != NULL) {
       FreePool (Request->SenseData);
@@ -3762,6 +3768,8 @@ ScsiDiskAsyncWrite10 (
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
 
+  AsyncIoEvent = NULL;
+
   Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
@@ -3817,6 +3825,10 @@ ScsiDiskAsyncWrite10 (
   return EFI_SUCCESS;
 
 ErrorExit:
+  if (AsyncIoEvent != NULL) {
+    gBS->CloseEvent (AsyncIoEvent);
+  }
+
   if (Request != NULL) {
     if (Request->SenseData != NULL) {
       FreePool (Request->SenseData);
@@ -3865,6 +3877,8 @@ ScsiDiskAsyncRead16 (
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
 
+  AsyncIoEvent = NULL;
+
   Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
@@ -3920,6 +3934,10 @@ ScsiDiskAsyncRead16 (
   return EFI_SUCCESS;
 
 ErrorExit:
+  if (AsyncIoEvent != NULL) {
+    gBS->CloseEvent (AsyncIoEvent);
+  }
+
   if (Request != NULL) {
     if (Request->SenseData != NULL) {
       FreePool (Request->SenseData);
@@ -3968,6 +3986,8 @@ ScsiDiskAsyncWrite16 (
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
 
+  AsyncIoEvent = NULL;
+
   Request = AllocateZeroPool (sizeof (SCSI_ASYNC_RW_REQUEST));
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
@@ -4023,6 +4043,10 @@ ScsiDiskAsyncWrite16 (
   return EFI_SUCCESS;
 
 ErrorExit:
+  if (AsyncIoEvent != NULL) {
+    gBS->CloseEvent (AsyncIoEvent);
+  }
+
   if (Request != NULL) {
     if (Request->SenseData != NULL) {
       FreePool (Request->SenseData);

From 5feebcef70a383b3fd50416cd968409b62bbbb6d Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:37:00 +0000
Subject: [PATCH 338/525] MdeModulePkg ScsiDiskDxe: Fix async request retry
 times info lost issue

(Sync patch r19450 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19471 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 24 ++++++++++++++++++++
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h |  8 +++++++
 2 files changed, 32 insertions(+)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 033be239634c..70d1306ef3fd 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -2651,6 +2651,7 @@ ScsiDiskAsyncReadSectors (
       Status = ScsiDiskAsyncRead10 (
                  ScsiDiskDevice,
                  Timeout,
+                 0,
                  PtrBuffer,
                  ByteCount,
                  (UINT32) Lba,
@@ -2662,6 +2663,7 @@ ScsiDiskAsyncReadSectors (
       Status = ScsiDiskAsyncRead16 (
                  ScsiDiskDevice,
                  Timeout,
+                 0,
                  PtrBuffer,
                  ByteCount,
                  Lba,
@@ -2812,6 +2814,7 @@ ScsiDiskAsyncWriteSectors (
       Status = ScsiDiskAsyncWrite10 (
                  ScsiDiskDevice,
                  Timeout,
+                 0,
                  PtrBuffer,
                  ByteCount,
                  (UINT32) Lba,
@@ -2823,6 +2826,7 @@ ScsiDiskAsyncWriteSectors (
       Status = ScsiDiskAsyncWrite16 (
                  ScsiDiskDevice,
                  Timeout,
+                 0,
                  PtrBuffer,
                  ByteCount,
                  Lba,
@@ -3486,6 +3490,7 @@ ScsiDiskNotify (
       Status = ScsiDiskAsyncRead10 (
                  ScsiDiskDevice,
                  Request->Timeout,
+                 Request->TimesRetry,
                  Request->InBuffer,
                  Request->DataLength,
                  (UINT32) Request->StartLba,
@@ -3497,6 +3502,7 @@ ScsiDiskNotify (
       Status = ScsiDiskAsyncRead16 (
                  ScsiDiskDevice,
                  Request->Timeout,
+                 Request->TimesRetry,
                  Request->InBuffer,
                  Request->DataLength,
                  Request->StartLba,
@@ -3518,6 +3524,7 @@ ScsiDiskNotify (
         Status = ScsiDiskAsyncRead10 (
                    ScsiDiskDevice,
                    Request->Timeout,
+                   0,
                    Request->InBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
                    OldDataLength - Request->DataLength,
                    (UINT32) Request->StartLba + Request->SectorCount,
@@ -3529,6 +3536,7 @@ ScsiDiskNotify (
         Status = ScsiDiskAsyncRead16 (
                    ScsiDiskDevice,
                    Request->Timeout,
+                   0,
                    Request->InBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
                    OldDataLength - Request->DataLength,
                    Request->StartLba + Request->SectorCount,
@@ -3550,6 +3558,7 @@ ScsiDiskNotify (
       Status = ScsiDiskAsyncWrite10 (
                  ScsiDiskDevice,
                  Request->Timeout,
+                 Request->TimesRetry,
                  Request->OutBuffer,
                  Request->DataLength,
                  (UINT32) Request->StartLba,
@@ -3561,6 +3570,7 @@ ScsiDiskNotify (
       Status = ScsiDiskAsyncWrite16 (
                  ScsiDiskDevice,
                  Request->Timeout,
+                 Request->TimesRetry,
                  Request->OutBuffer,
                  Request->DataLength,
                  Request->StartLba,
@@ -3582,6 +3592,7 @@ ScsiDiskNotify (
         Status = ScsiDiskAsyncWrite10 (
                    ScsiDiskDevice,
                    Request->Timeout,
+                   0,
                    Request->OutBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
                    OldDataLength - Request->DataLength,
                    (UINT32) Request->StartLba + Request->SectorCount,
@@ -3593,6 +3604,7 @@ ScsiDiskNotify (
         Status = ScsiDiskAsyncWrite16 (
                    ScsiDiskDevice,
                    Request->Timeout,
+                   0,
                    Request->OutBuffer + Request->SectorCount * ScsiDiskDevice->BlkIo.Media->BlockSize,
                    OldDataLength - Request->DataLength,
                    Request->StartLba + Request->SectorCount,
@@ -3629,6 +3641,7 @@ ScsiDiskNotify (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer to fill with the read out data.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -3647,6 +3660,7 @@ EFI_STATUS
 ScsiDiskAsyncRead10 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
      OUT UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT32                StartLba,
@@ -3676,6 +3690,7 @@ ScsiDiskAsyncRead10 (
 
   Request->ScsiDiskDevice  = ScsiDiskDevice;
   Request->Timeout         = Timeout;
+  Request->TimesRetry      = TimesRetry;
   Request->InBuffer        = DataBuffer;
   Request->DataLength      = DataLength;
   Request->StartLba        = StartLba;
@@ -3738,6 +3753,7 @@ ScsiDiskAsyncRead10 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer contains the data to write.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -3756,6 +3772,7 @@ EFI_STATUS
 ScsiDiskAsyncWrite10 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
   IN     UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT32                StartLba,
@@ -3785,6 +3802,7 @@ ScsiDiskAsyncWrite10 (
 
   Request->ScsiDiskDevice  = ScsiDiskDevice;
   Request->Timeout         = Timeout;
+  Request->TimesRetry      = TimesRetry;
   Request->OutBuffer       = DataBuffer;
   Request->DataLength      = DataLength;
   Request->StartLba        = StartLba;
@@ -3847,6 +3865,7 @@ ScsiDiskAsyncWrite10 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer to fill with the read out data.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -3865,6 +3884,7 @@ EFI_STATUS
 ScsiDiskAsyncRead16 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
      OUT UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT64                StartLba,
@@ -3894,6 +3914,7 @@ ScsiDiskAsyncRead16 (
 
   Request->ScsiDiskDevice  = ScsiDiskDevice;
   Request->Timeout         = Timeout;
+  Request->TimesRetry      = TimesRetry;
   Request->InBuffer        = DataBuffer;
   Request->DataLength      = DataLength;
   Request->StartLba        = StartLba;
@@ -3956,6 +3977,7 @@ ScsiDiskAsyncRead16 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer contains the data to write.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -3974,6 +3996,7 @@ EFI_STATUS
 ScsiDiskAsyncWrite16 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
   IN     UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT64                StartLba,
@@ -4003,6 +4026,7 @@ ScsiDiskAsyncWrite16 (
 
   Request->ScsiDiskDevice  = ScsiDiskDevice;
   Request->Timeout         = Timeout;
+  Request->TimesRetry      = TimesRetry;
   Request->OutBuffer       = DataBuffer;
   Request->DataLength      = DataLength;
   Request->StartLba        = StartLba;
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
index b6f801d92aa1..7a287d3bb389 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
@@ -1029,6 +1029,7 @@ ScsiDiskWrite16 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer to fill with the read out data.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -1047,6 +1048,7 @@ EFI_STATUS
 ScsiDiskAsyncRead10 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
      OUT UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT32                StartLba,
@@ -1060,6 +1062,7 @@ ScsiDiskAsyncRead10 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer contains the data to write.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -1078,6 +1081,7 @@ EFI_STATUS
 ScsiDiskAsyncWrite10 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
   IN     UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT32                StartLba,
@@ -1091,6 +1095,7 @@ ScsiDiskAsyncWrite10 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer to fill with the read out data.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -1109,6 +1114,7 @@ EFI_STATUS
 ScsiDiskAsyncRead16 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
      OUT UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT64                StartLba,
@@ -1122,6 +1128,7 @@ ScsiDiskAsyncRead16 (
 
   @param  ScsiDiskDevice     The pointer of ScsiDiskDevice.
   @param  Timeout            The time to complete the command.
+  @param  TimesRetry         The number of times the command has been retried.
   @param  DataBuffer         The buffer contains the data to write.
   @param  DataLength         The length of buffer.
   @param  StartLba           The start logic block address.
@@ -1140,6 +1147,7 @@ EFI_STATUS
 ScsiDiskAsyncWrite16 (
   IN     SCSI_DISK_DEV         *ScsiDiskDevice,
   IN     UINT64                Timeout,
+  IN     UINT8                 TimesRetry,
   IN     UINT8                 *DataBuffer,
   IN     UINT32                DataLength,
   IN     UINT64                StartLba,

From 8a3c29386ac147670dda1a2d772a3d90cfad70ef Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:37:22 +0000
Subject: [PATCH 339/525] MdeModulePkg ScsiDiskDxe: Add retry scheme for async
 SCSI I/O command

Some SCSI devices will return EFI_DEVICE_ERROR or EFI_TIMEOUT when the
data length of a SCSI I/O command is too large.

This commit will repeatedly retry sending the SCSI command with a data
length half of its previous value.

(Sync patch r19451 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19472 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 66 +++++++++++++++++---
 1 file changed, 58 insertions(+), 8 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 70d1306ef3fd..1a8d83ecaf93 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -2674,15 +2674,40 @@ ScsiDiskAsyncReadSectors (
     }
     if (EFI_ERROR (Status)) {
       //
-      // Free the SCSI_BLKIO2_REQUEST structure only when the first SCSI
-      // command fails. Otherwise, it will be freed in the callback function
-      // ScsiDiskNotify().
+      // Some devices will return EFI_DEVICE_ERROR or EFI_TIMEOUT when the data
+      // length of a SCSI I/O command is too large.
+      // In this case, we retry sending the SCSI command with a data length
+      // half of its previous value.
       //
+      if ((Status == EFI_DEVICE_ERROR) || (Status == EFI_TIMEOUT)) {
+        if ((MaxBlock > 1) && (SectorCount > 1)) {
+          MaxBlock = MIN (MaxBlock, SectorCount) >> 1;
+          continue;
+        }
+      }
+
       if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+        //
+        // Free the SCSI_BLKIO2_REQUEST structure only when there is no other
+        // SCSI sub-task running. Otherwise, it will be freed in the callback
+        // function ScsiDiskNotify().
+        //
         RemoveEntryList (&BlkIo2Req->Link);
         FreePool (BlkIo2Req);
+
+        //
+        // It is safe to return error status to the caller, since there is no
+        // previous SCSI sub-task executing.
+        //
+        return EFI_DEVICE_ERROR;
+      } else {
+        //
+        // There are previous SCSI commands still running, EFI_SUCCESS should
+        // be returned to make sure that the caller does not free resources
+        // still using by these SCSI commands.
+        //
+        return EFI_SUCCESS;
       }
-      return EFI_DEVICE_ERROR;
     }
 
     //
@@ -2837,15 +2862,40 @@ ScsiDiskAsyncWriteSectors (
     }
     if (EFI_ERROR (Status)) {
       //
-      // Free the SCSI_BLKIO2_REQUEST structure only when the first SCSI
-      // command fails. Otherwise, it will be freed in the callback function
-      // ScsiDiskNotify().
+      // Some devices will return EFI_DEVICE_ERROR or EFI_TIMEOUT when the data
+      // length of a SCSI I/O command is too large.
+      // In this case, we retry sending the SCSI command with a data length
+      // half of its previous value.
       //
+      if ((Status == EFI_DEVICE_ERROR) || (Status == EFI_TIMEOUT)) {
+        if ((MaxBlock > 1) && (SectorCount > 1)) {
+          MaxBlock = MIN (MaxBlock, SectorCount) >> 1;
+          continue;
+        }
+      }
+
       if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+        //
+        // Free the SCSI_BLKIO2_REQUEST structure only when there is no other
+        // SCSI sub-task running. Otherwise, it will be freed in the callback
+        // function ScsiDiskNotify().
+        //
         RemoveEntryList (&BlkIo2Req->Link);
         FreePool (BlkIo2Req);
+
+        //
+        // It is safe to return error status to the caller, since there is no
+        // previous SCSI sub-task executing.
+        //
+        return EFI_DEVICE_ERROR;
+      } else {
+        //
+        // There are previous SCSI commands still running, EFI_SUCCESS should
+        // be returned to make sure that the caller does not free resources
+        // still using by these SCSI commands.
+        //
+        return EFI_SUCCESS;
       }
-      return EFI_DEVICE_ERROR;
     }
 
     //

From 995e33bedcadf2d193085bdf2889ea651b1a6abe Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:37:50 +0000
Subject: [PATCH 340/525] MdeModulePkg ScsiDiskDxe: Raise the Tpl of async IO
 callback to TPL_NOTIFY

When reading data from non-blockingly from a CD-ROM logic partition, the
procedure can be shown by the following call stack:
(The write process is similar)

|-------------------|
| DiskIoDxe (logic) |<---Raise Tpl to TPL_CALLBACK
|-------------------|
 |
 | Sub-task 1 (UnderRun) succeeds
 |
 |    |-----------------|     |-----------------|     |-----------------|
 +--->|  PartitionDxe   |---->| DiskIoDxe (Phy) |---->|   ScsiDiskDxe   |
 |    |-----------------|     |-----------------|     |-----------------|
 |
 | Sub-task 2 (OverRun) fails
 |
 |    |-----------------|     |-----------------|     |-----------------|
 +--->|  PartitionDxe   |---->| DiskIoDxe (Phy) |---->|   ScsiDiskDxe   |
 |    |-----------------|     |-----------------|     |-----------------|
 |                                     ^
 |                                     |
 More subtasks...              Wait indefinitely
 |
 |<---Restore Tpl
 |
 Completes

In PartitionDxe, if the 'Lba' and 'BufferSize' parameters passed to
function PartitionReadBlocksEx() are invalid, the function will issue a
blocking ReadDisk call (in function ProbeMediaStatusEx()).

In DiskIoDxe, blocking I/O request will wait for all the non-blocking I/O
requests to complete first before sending down the blocking request.

If the Tpl of the async I/O callback in ScsiDiskDxe is TPL_CALLBACK and
Sub-task 1 (UnderRun) succeeds but Sub-task 2 (OverRun) fails with an
invalid parameter, DiskIoDxe will wait indefinitely for the event created
by ScsiDiskDxe of Sub-task 1 to signal.

Hence, this commit will raise the Tpl of async IO callback in ScsiDiskDxe
to TPL_NOTIFY so that the indefinite wait in DiskIoDxe can be avoided.

(Sync patch r19452 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19473 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c | 109 +++++++++++++++++--
 MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h |   8 +-
 2 files changed, 105 insertions(+), 12 deletions(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
index 1a8d83ecaf93..74f53c58b302 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.c
@@ -2568,6 +2568,7 @@ ScsiDiskAsyncReadSectors (
   UINT64                Timeout;
   SCSI_BLKIO2_REQUEST   *BlkIo2Req;
   EFI_STATUS            Status;
+  EFI_TPL               OldTpl;
 
   if ((Token == NULL) || (Token->Event == NULL)) {
     return EFI_INVALID_PARAMETER;
@@ -2579,7 +2580,11 @@ ScsiDiskAsyncReadSectors (
   }
 
   BlkIo2Req->Token  = Token;
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&ScsiDiskDevice->BlkIo2Queue, &BlkIo2Req->Link);
+  gBS->RestoreTPL (OldTpl);
+
   InitializeListHead (&BlkIo2Req->ScsiRWQueue);
 
   Status            = EFI_SUCCESS;
@@ -2686,6 +2691,7 @@ ScsiDiskAsyncReadSectors (
         }
       }
 
+      OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
       if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
         //
         // Free the SCSI_BLKIO2_REQUEST structure only when there is no other
@@ -2694,19 +2700,25 @@ ScsiDiskAsyncReadSectors (
         //
         RemoveEntryList (&BlkIo2Req->Link);
         FreePool (BlkIo2Req);
+        BlkIo2Req = NULL;
+        gBS->RestoreTPL (OldTpl);
 
         //
         // It is safe to return error status to the caller, since there is no
         // previous SCSI sub-task executing.
         //
-        return EFI_DEVICE_ERROR;
+        Status = EFI_DEVICE_ERROR;
+        goto Done;
       } else {
+        gBS->RestoreTPL (OldTpl);
+
         //
         // There are previous SCSI commands still running, EFI_SUCCESS should
         // be returned to make sure that the caller does not free resources
         // still using by these SCSI commands.
         //
-        return EFI_SUCCESS;
+        Status = EFI_SUCCESS;
+        goto Done;
       }
     }
 
@@ -2720,7 +2732,24 @@ ScsiDiskAsyncReadSectors (
     BlocksRemaining -= SectorCount;
   }
 
-  return EFI_SUCCESS;
+  Status = EFI_SUCCESS;
+
+Done:
+  if (BlkIo2Req != NULL) {
+    BlkIo2Req->LastScsiRW = TRUE;
+
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+    if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+      RemoveEntryList (&BlkIo2Req->Link);
+      FreePool (BlkIo2Req);
+      BlkIo2Req = NULL;
+
+      gBS->SignalEvent (Token->Event);
+    }
+    gBS->RestoreTPL (OldTpl);
+  }
+
+  return Status;
 }
 
 /**
@@ -2756,6 +2785,7 @@ ScsiDiskAsyncWriteSectors (
   UINT64                Timeout;
   SCSI_BLKIO2_REQUEST   *BlkIo2Req;
   EFI_STATUS            Status;
+  EFI_TPL               OldTpl;
 
   if ((Token == NULL) || (Token->Event == NULL)) {
     return EFI_INVALID_PARAMETER;
@@ -2767,7 +2797,11 @@ ScsiDiskAsyncWriteSectors (
   }
 
   BlkIo2Req->Token  = Token;
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&ScsiDiskDevice->BlkIo2Queue, &BlkIo2Req->Link);
+  gBS->RestoreTPL (OldTpl);
+
   InitializeListHead (&BlkIo2Req->ScsiRWQueue);
 
   Status            = EFI_SUCCESS;
@@ -2874,6 +2908,7 @@ ScsiDiskAsyncWriteSectors (
         }
       }
 
+      OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
       if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
         //
         // Free the SCSI_BLKIO2_REQUEST structure only when there is no other
@@ -2882,19 +2917,25 @@ ScsiDiskAsyncWriteSectors (
         //
         RemoveEntryList (&BlkIo2Req->Link);
         FreePool (BlkIo2Req);
+        BlkIo2Req = NULL;
+        gBS->RestoreTPL (OldTpl);
 
         //
         // It is safe to return error status to the caller, since there is no
         // previous SCSI sub-task executing.
         //
-        return EFI_DEVICE_ERROR;
+        Status = EFI_DEVICE_ERROR;
+        goto Done;
       } else {
+        gBS->RestoreTPL (OldTpl);
+
         //
         // There are previous SCSI commands still running, EFI_SUCCESS should
         // be returned to make sure that the caller does not free resources
         // still using by these SCSI commands.
         //
-        return EFI_SUCCESS;
+        Status = EFI_SUCCESS;
+        goto Done;
       }
     }
 
@@ -2908,7 +2949,24 @@ ScsiDiskAsyncWriteSectors (
     BlocksRemaining -= SectorCount;
   }
 
-  return EFI_SUCCESS;
+  Status = EFI_SUCCESS;
+
+Done:
+  if (BlkIo2Req != NULL) {
+    BlkIo2Req->LastScsiRW = TRUE;
+
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
+    if (IsListEmpty (&BlkIo2Req->ScsiRWQueue)) {
+      RemoveEntryList (&BlkIo2Req->Link);
+      FreePool (BlkIo2Req);
+      BlkIo2Req = NULL;
+
+      gBS->SignalEvent (Token->Event);
+    }
+    gBS->RestoreTPL (OldTpl);
+  }
+
+  return Status;
 }
 
 
@@ -3672,7 +3730,8 @@ ScsiDiskNotify (
 
 Exit:
   RemoveEntryList (&Request->Link);
-  if (IsListEmpty (&Request->BlkIo2Req->ScsiRWQueue)) {
+  if ((IsListEmpty (&Request->BlkIo2Req->ScsiRWQueue)) &&
+      (Request->BlkIo2Req->LastScsiRW)) {
     //
     // The last SCSI R/W command of a BlockIo2 request completes
     //
@@ -3722,6 +3781,7 @@ ScsiDiskAsyncRead10 (
   EFI_STATUS                   Status;
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
+  EFI_TPL                      OldTpl;
 
   AsyncIoEvent = NULL;
 
@@ -3729,7 +3789,10 @@ ScsiDiskAsyncRead10 (
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+  gBS->RestoreTPL (OldTpl);
 
   Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
   Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
@@ -3752,7 +3815,7 @@ ScsiDiskAsyncRead10 (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiDiskNotify,
                   Request,
                   &AsyncIoEvent
@@ -3790,7 +3853,10 @@ ScsiDiskAsyncRead10 (
       FreePool (Request->SenseData);
     }
 
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
     RemoveEntryList (&Request->Link);
+    gBS->RestoreTPL (OldTpl);
+
     FreePool (Request);
   }
 
@@ -3834,6 +3900,7 @@ ScsiDiskAsyncWrite10 (
   EFI_STATUS                   Status;
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
+  EFI_TPL                      OldTpl;
 
   AsyncIoEvent = NULL;
 
@@ -3841,7 +3908,10 @@ ScsiDiskAsyncWrite10 (
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+  gBS->RestoreTPL (OldTpl);
 
   Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
   Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
@@ -3864,7 +3934,7 @@ ScsiDiskAsyncWrite10 (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiDiskNotify,
                   Request,
                   &AsyncIoEvent
@@ -3902,7 +3972,10 @@ ScsiDiskAsyncWrite10 (
       FreePool (Request->SenseData);
     }
 
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
     RemoveEntryList (&Request->Link);
+    gBS->RestoreTPL (OldTpl);
+
     FreePool (Request);
   }
 
@@ -3946,6 +4019,7 @@ ScsiDiskAsyncRead16 (
   EFI_STATUS                   Status;
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
+  EFI_TPL                      OldTpl;
 
   AsyncIoEvent = NULL;
 
@@ -3953,7 +4027,10 @@ ScsiDiskAsyncRead16 (
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+  gBS->RestoreTPL (OldTpl);
 
   Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
   Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
@@ -3976,7 +4053,7 @@ ScsiDiskAsyncRead16 (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiDiskNotify,
                   Request,
                   &AsyncIoEvent
@@ -4014,7 +4091,10 @@ ScsiDiskAsyncRead16 (
       FreePool (Request->SenseData);
     }
 
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
     RemoveEntryList (&Request->Link);
+    gBS->RestoreTPL (OldTpl);
+
     FreePool (Request);
   }
 
@@ -4058,6 +4138,7 @@ ScsiDiskAsyncWrite16 (
   EFI_STATUS                   Status;
   SCSI_ASYNC_RW_REQUEST        *Request;
   EFI_EVENT                    AsyncIoEvent;
+  EFI_TPL                      OldTpl;
 
   AsyncIoEvent = NULL;
 
@@ -4065,7 +4146,10 @@ ScsiDiskAsyncWrite16 (
   if (Request == NULL) {
     return EFI_OUT_OF_RESOURCES;
   }
+
+  OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
   InsertTailList (&BlkIo2Req->ScsiRWQueue, &Request->Link);
+  gBS->RestoreTPL (OldTpl);
 
   Request->SenseDataLength = (UINT8) (6 * sizeof (EFI_SCSI_SENSE_DATA));
   Request->SenseData       = AllocateZeroPool (Request->SenseDataLength);
@@ -4088,7 +4172,7 @@ ScsiDiskAsyncWrite16 (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiDiskNotify,
                   Request,
                   &AsyncIoEvent
@@ -4126,7 +4210,10 @@ ScsiDiskAsyncWrite16 (
       FreePool (Request->SenseData);
     }
 
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
     RemoveEntryList (&Request->Link);
+    gBS->RestoreTPL (OldTpl);
+
     FreePool (Request);
   }
 
diff --git a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
index 7a287d3bb389..2406df51b8df 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
+++ b/MdeModulePkg/Bus/Scsi/ScsiDiskDxe/ScsiDisk.h
@@ -98,7 +98,13 @@ typedef struct {
 typedef struct {
   EFI_BLOCK_IO2_TOKEN                  *Token;
   //
-  // The queue for Scsi Read/Write requests of a BlockIo2
+  // The flag indicates if the last Scsi Read/Write sub-task for a BlockIo2
+  // request is sent to device
+  //
+  BOOLEAN                              LastScsiRW;
+
+  //
+  // The queue for Scsi Read/Write sub-tasks of a BlockIo2 request
   //
   LIST_ENTRY                           ScsiRWQueue;
 

From dedfd54933d99808049a9e07f591ead6ae774b49 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:38:14 +0000
Subject: [PATCH 341/525] MdePkg UefiScsiLib: Raise the Tpl of async IO
 callback to TPL_NOTIFY

Raise the Tpl of async SCSI I/O callback function to TPL_NOTIFY to match
the behavior in ScsiDiskDxe driver.

(Sync patch r19453 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19474 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
index 0a08e4468ed0..d399e2344fa6 100644
--- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
+++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
@@ -1485,7 +1485,7 @@ ScsiRead10CommandEx (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiLibNotify,
                   Context,
                   &SelfEvent
@@ -1669,7 +1669,7 @@ ScsiWrite10CommandEx (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiLibNotify,
                   Context,
                   &SelfEvent
@@ -1853,7 +1853,7 @@ ScsiRead16CommandEx (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiLibNotify,
                   Context,
                   &SelfEvent
@@ -2037,7 +2037,7 @@ ScsiWrite16CommandEx (
   //
   Status = gBS->CreateEvent (
                   EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ScsiLibNotify,
                   Context,
                   &SelfEvent

From 1a412e1683257c28b58daa5447bafb6725add45e Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:38:41 +0000
Subject: [PATCH 342/525] MdeModulePkg ScsiBusDxe: Raise the Tpl of async IO
 callback to TPL_NOTIFY

Raise the Tpl of async SCSI I/O callback function to TPL_NOTIFY to match
the behavior in ScsiDiskDxe driver.

(Sync patch r19454 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19475 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
index b10e25a38e9c..0802b617268f 100644
--- a/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
+++ b/MdeModulePkg/Bus/Scsi/ScsiBusDxe/ScsiBus.c
@@ -1040,7 +1040,7 @@ ScsiExecuteSCSICommand (
       //
       Status = gBS->CreateEvent (
                        EVT_NOTIFY_SIGNAL,
-                       TPL_CALLBACK,
+                       TPL_NOTIFY,
                        NotifyFunction,
                        &EventData,
                        &PacketEvent

From e66b686a933a810175a56a3649778728a85712a5 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 23 Dec 2015 01:39:05 +0000
Subject: [PATCH 343/525] MdeModulePkg UfsPassThruDxe: Raise to TPL_NOTIFY when
 dealing async task

This commit will raise the Tpl to TPL_NOTIFY when adding non-blocking SCSI
I/O requests to the asynchronous task list.

This commit will also raise the Tpl of asynchronous task polling timer to
TPL_NOTIFY.

These changes are made to match the behavior in ScsiDiskDxe driver.

(Sync patch r19455 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19476 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c    | 2 +-
 MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
index aa40e2747097..bfba7aafe854 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThru.c
@@ -882,7 +882,7 @@ UfsPassThruDriverBindingStart (
   //
   Status = gBS->CreateEvent (
                   EVT_TIMER | EVT_NOTIFY_SIGNAL,
-                  TPL_CALLBACK,
+                  TPL_NOTIFY,
                   ProcessAsyncTaskList,
                   Private,
                   &Private->TimerEvent
diff --git a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
index 81653af5a8ad..a9fde3066fa2 100644
--- a/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
+++ b/MdeModulePkg/Bus/Ufs/UfsPassThruDxe/UfsPassThruHci.c
@@ -1512,7 +1512,7 @@ UfsExecScsiCmds (
   // Insert the async SCSI cmd to the Async I/O list
   //
   if (Event != NULL) {
-    OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+    OldTpl = gBS->RaiseTPL (TPL_NOTIFY);
     TransReq->Packet      = Packet;
     TransReq->CallerEvent = Event;
     InsertTailList (&Private->Queue, &TransReq->TransferList);

From eb2569f10dc959ffdea907f8edc4b29f5719619d Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 23 Dec 2015 02:33:53 +0000
Subject: [PATCH 344/525] PcAtChipsetPkg/Rtc: Fix a UEFI Win7 boot hang issue

The patch updates the Century value in CMOS location specified
by FADT.Century to avoid UEFI Win7 hang during booting.
Per the ACPI spec if the FADT.Century is zero, it's not needed
to store the century value in CMOS. But UEFI Win7 treats the
Century storage is optional only when FADT.Century is 0x80.
While Linux strictly follows the ACPI spec and treats Century
storage is optional when FADT.Century is 0.
So if a platform wants to support both UEFI Win7 and Linux,
it needs to report FADT.Century to a traditional value which
doesn't equal to 0 or 0x80 (0x32 mostly). And RTC driver is
enhanced to save the century value to the location specified
by FADT.Century.

(Sync patch r19442 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19478 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PcatRealTimeClockRuntimeDxe/PcRtc.c       | 110 ++++++++++++++++++
 .../PcatRealTimeClockRuntimeDxe/PcRtc.h       |  22 +++-
 .../PcatRealTimeClockRuntimeDxe/PcRtcEntry.c  |  26 ++++-
 .../PcatRealTimeClockRuntimeDxe.inf           |   4 +
 4 files changed, 158 insertions(+), 4 deletions(-)

diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
index 5abb71c032b4..e122ae16990a 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
@@ -500,6 +500,13 @@ PcRtcSetTime (
   RegisterB.Bits.Set  = 1;
   RtcWrite (RTC_ADDRESS_REGISTER_B, RegisterB.Data);
 
+  //
+  // Store the century value to RTC before converting to BCD format.
+  //
+  if (Global->CenturyRtcAddress != 0) {
+    RtcWrite (Global->CenturyRtcAddress, DecimalToBcd8 ((UINT8) (RtcTime.Year / 100)));
+  }
+
   ConvertEfiTimeToRtcTime (&RtcTime, RegisterB);
 
   RtcWrite (RTC_ADDRESS_SECONDS, RtcTime.Second);
@@ -1198,3 +1205,106 @@ IsWithinOneDay (
   return Adjacent;
 }
 
+/**
+  This function find ACPI table with the specified signature in RSDT or XSDT.
+
+  @param Sdt              ACPI RSDT or XSDT.
+  @param Signature        ACPI table signature.
+  @param TablePointerSize Size of table pointer: 4 or 8.
+
+  @return ACPI table or NULL if not found.
+**/
+VOID *
+ScanTableInSDT (
+  IN EFI_ACPI_DESCRIPTION_HEADER    *Sdt,
+  IN UINT32                         Signature,
+  IN UINTN                          TablePointerSize
+  )
+{
+  UINTN                          Index;
+  UINTN                          EntryCount;
+  UINTN                          EntryBase;
+  EFI_ACPI_DESCRIPTION_HEADER    *Table;
+
+  EntryCount = (Sdt->Length - sizeof (EFI_ACPI_DESCRIPTION_HEADER)) / TablePointerSize;
+
+  EntryBase = (UINTN) (Sdt + 1);
+  for (Index = 0; Index < EntryCount; Index++) {
+    //
+    // When TablePointerSize is 4 while sizeof (VOID *) is 8, make sure the upper 4 bytes are zero.
+    //
+    Table = 0;
+    CopyMem (&Table, (VOID *) (EntryBase + Index * TablePointerSize), TablePointerSize);
+    if (Table->Signature == Signature) {
+      return Table;
+    }
+  }
+
+  return NULL;
+}
+
+/**
+  Notification function of ACPI Table change.
+
+  This is a notification function registered on ACPI Table change event.
+  It saves the Century address stored in ACPI FADT table.
+
+  @param  Event        Event whose notification function is being invoked.
+  @param  Context      Pointer to the notification function's context.
+
+**/
+VOID
+EFIAPI
+PcRtcAcpiTableChangeCallback (
+  IN EFI_EVENT        Event,
+  IN VOID             *Context
+  )
+{
+  EFI_STATUS                                    Status;
+  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;
+  EFI_TIME                                      Time;
+  UINT8                                         Century;
+
+  Status = EfiGetSystemConfigurationTable (&gEfiAcpiTableGuid, (VOID **) &Rsdp);
+  if (EFI_ERROR (Status)) {
+    Status = EfiGetSystemConfigurationTable (&gEfiAcpi10TableGuid, (VOID **) &Rsdp);
+  }
+
+  if (EFI_ERROR (Status)) {
+    return;
+  }
+
+  //
+  // Find FADT in XSDT
+  //
+  Fadt = NULL;
+  if (Rsdp->Revision >= EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION) {
+    Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->XsdtAddress;
+    Fadt = ScanTableInSDT (Xsdt, EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE, sizeof (UINT64));
+  }
+
+  if (Fadt == NULL) {
+    //
+    // Find FADT in RSDT
+    //
+    Rsdt = (EFI_ACPI_DESCRIPTION_HEADER *) (UINTN) Rsdp->RsdtAddress;
+    Fadt = ScanTableInSDT (Rsdt, EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE, sizeof (UINT32));
+  }
+
+  if ((Fadt != NULL) &&
+      (Fadt->Century > RTC_ADDRESS_REGISTER_D) && (Fadt->Century < 0x80) &&
+      (mModuleGlobal.CenturyRtcAddress != Fadt->Century)
+      ) {
+    mModuleGlobal.CenturyRtcAddress = Fadt->Century;
+    Status = PcRtcGetTime (&Time, NULL, &mModuleGlobal);
+    if (!EFI_ERROR (Status)) {
+      Century = (UINT8) (Time.Year / 100);
+      Century = DecimalToBcd8 (Century);
+      DEBUG ((EFI_D_INFO, "PcRtc: Write 0x%x to CMOS location 0x%x\n", Century, mModuleGlobal.CenturyRtcAddress));
+      RtcWrite (mModuleGlobal.CenturyRtcAddress, Century);
+    }
+  }
+}
diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.h b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.h
index 026c1086b2fe..7fc19f90434e 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.h
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.h
@@ -19,6 +19,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include <Uefi.h>
 
+#include <Guid/Acpi.h>
+
 #include <Protocol/RealTimeClock.h>
 
 #include <Library/BaseLib.h>
@@ -34,13 +36,15 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/PcdLib.h>
 #include <Library/ReportStatusCodeLib.h>
 
-
 typedef struct {
   EFI_LOCK  RtcLock;
   INT16     SavedTimeZone;
   UINT8     Daylight;
+  UINT8     CenturyRtcAddress;
 } PC_RTC_MODULE_GLOBALS;
 
+extern PC_RTC_MODULE_GLOBALS  mModuleGlobal;
+
 #define PCAT_RTC_ADDRESS_REGISTER 0x70
 #define PCAT_RTC_DATA_REGISTER    0x71
 
@@ -355,4 +359,20 @@ IsLeapYear (
   IN EFI_TIME   *Time
   );
 
+/**
+  Notification function of ACPI Table change.
+
+  This is a notification function registered on ACPI Table change event.
+  It saves the Century address stored in ACPI FADT table.
+
+  @param  Event        Event whose notification function is being invoked.
+  @param  Context      Pointer to the notification function's context.
+
+**/
+VOID
+EFIAPI
+PcRtcAcpiTableChangeCallback (
+  IN EFI_EVENT        Event,
+  IN VOID             *Context
+  );
 #endif
diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
index 9cf398870550..6f2a987f2204 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
@@ -1,7 +1,7 @@
 /** @file
   Provides Set/Get time operations.
 
-Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -14,11 +14,10 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "PcRtc.h"
 
-PC_RTC_MODULE_GLOBALS  mModuleGlobal;
+PC_RTC_MODULE_GLOBALS  mModuleGlobal = { 0 };
 
 EFI_HANDLE             mHandle = NULL;
 
-
 /**
   Returns the current time and date information, and the time-keeping capabilities
   of the hardware platform.
@@ -133,11 +132,32 @@ InitializePcRtc (
   )
 {
   EFI_STATUS  Status;
+  EFI_EVENT   Event;
 
   EfiInitializeLock (&mModuleGlobal.RtcLock, TPL_CALLBACK);
 
   Status = PcRtcInit (&mModuleGlobal);
   ASSERT_EFI_ERROR (Status);
+  
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  PcRtcAcpiTableChangeCallback,
+                  NULL,
+                  &gEfiAcpi10TableGuid,
+                  &Event
+                  );
+  ASSERT_EFI_ERROR (Status);
+  
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  PcRtcAcpiTableChangeCallback,
+                  NULL,
+                  &gEfiAcpiTableGuid,
+                  &Event
+                  );
+  ASSERT_EFI_ERROR (Status);
 
   gRT->GetTime       = PcRtcEfiGetTime;
   gRT->SetTime       = PcRtcEfiSetTime;
diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
index 9e5faf75d6b7..94596cef7845 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
@@ -57,6 +57,10 @@
 [Protocols]
   gEfiRealTimeClockArchProtocolGuid             ## PRODUCES
 
+[Guids]
+  gEfiAcpi10TableGuid                           ## CONSUMES
+  gEfiAcpiTableGuid                             ## CONSUMES
+
 [Depex]
   gEfiVariableArchProtocolGuid AND gEfiVariableWriteArchProtocolGuid
   

From 61198deb21559d869403c1ee327fa51eb0d9178f Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Wed, 23 Dec 2015 02:34:19 +0000
Subject: [PATCH 345/525] PcAtChipsetPkg/PcRtc: Fix GCC build failure.

(Sync patch r19477 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Hao A Wu <hao.a.wu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19479 6f19259b-4bc3-4df7-8a09-765794883524
---
 PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
index 6f2a987f2204..1cfb0cb19889 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtcEntry.c
@@ -14,7 +14,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "PcRtc.h"
 
-PC_RTC_MODULE_GLOBALS  mModuleGlobal = { 0 };
+PC_RTC_MODULE_GLOBALS  mModuleGlobal;
 
 EFI_HANDLE             mHandle = NULL;
 
@@ -135,6 +135,7 @@ InitializePcRtc (
   EFI_EVENT   Event;
 
   EfiInitializeLock (&mModuleGlobal.RtcLock, TPL_CALLBACK);
+  mModuleGlobal.CenturyRtcAddress = 0;
 
   Status = PcRtcInit (&mModuleGlobal);
   ASSERT_EFI_ERROR (Status);

From 1dedc8f2a4ad2d65ba88688b1ea35e52a6056767 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:23:25 +0000
Subject: [PATCH 346/525] MdePkg: Add Ipmi2.0 definitions head file.

Re-add Ipmi2.0 definitions header files based on Ipmi category:
App, Storage and etc.
In V3, the file name has been changed for short.

(Sync patch r19272 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19492 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdePkg/Include/IndustryStandard/Ipmi.h        |  29 +
 .../Include/IndustryStandard/IpmiNetFnApp.h   | 618 ++++++++++++++++++
 .../IndustryStandard/IpmiNetFnBridge.h        | 243 +++++++
 .../IndustryStandard/IpmiNetFnChassis.h       | 304 +++++++++
 .../IndustryStandard/IpmiNetFnFirmware.h      |  26 +
 .../IpmiNetFnGroupExtension.h                 |  26 +
 .../IndustryStandard/IpmiNetFnSensorEvent.h   |  52 ++
 .../IndustryStandard/IpmiNetFnStorage.h       | 534 +++++++++++++++
 .../IndustryStandard/IpmiNetFnTransport.h     | 566 ++++++++++++++++
 9 files changed, 2398 insertions(+)
 create mode 100644 MdePkg/Include/IndustryStandard/Ipmi.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnBridge.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnFirmware.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnGroupExtension.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
 create mode 100644 MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h

diff --git a/MdePkg/Include/IndustryStandard/Ipmi.h b/MdePkg/Include/IndustryStandard/Ipmi.h
new file mode 100644
index 000000000000..fd3a1d2a8fca
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/Ipmi.h
@@ -0,0 +1,29 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_H_
+#define _IPMI_H_
+
+#include <IndustryStandard/IpmiNetFnChassis.h>
+#include <IndustryStandard/IpmiNetFnBridge.h>
+#include <IndustryStandard/IpmiNetFnSensorEvent.h>
+#include <IndustryStandard/IpmiNetFnApp.h>
+#include <IndustryStandard/IpmiNetFnFirmware.h>
+#include <IndustryStandard/IpmiNetFnStorage.h>
+#include <IndustryStandard/IpmiNetFnTransport.h>
+#include <IndustryStandard/IpmiNetFnGroupExtension.h>
+
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h b/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
new file mode 100644
index 000000000000..c0865dae41bd
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
@@ -0,0 +1,618 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  This file contains all NetFn App commands, including:
+    IPM Device "Global" Commands (Chapter 20)
+    Firmware Firewall & Command Discovery Commands (Chapter 21)
+    BMC Watchdog Timer Commands (Chapter 27)
+    IPMI Messaging Support Commands (Chapter 22)
+    RMCP+ Support and Payload Commands (Chapter 24)
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_APP_H_
+#define _IPMI_NET_FN_APP_H_
+
+#pragma pack(1)
+//
+// Net function definition for App command
+//
+#define IPMI_NETFN_APP  0x06
+
+//
+//  Below is Definitions for IPM Device "Global" Commands  (Chapter 20)
+//
+
+//
+//  Definitions for Get Device ID command
+//
+#define IPMI_APP_GET_DEVICE_ID 0x1
+
+//
+//  Constants and Structure definitions for "Get Device ID" command to follow here
+//
+typedef struct {
+  UINT8   DeviceId;
+  UINT8   DeviceRevision : 4;
+  UINT8   Reserved : 3;
+  UINT8   DeviceSdr : 1;
+  UINT8   MajorFirmwareRev : 7;
+  UINT8   UpdateMode : 1;
+  UINT8   MinorFirmwareRev;
+  UINT8   SpecificationVersion;
+  UINT8   SensorDeviceSupport : 1;
+  UINT8   SdrRepositorySupport : 1;
+  UINT8   SelDeviceSupport : 1;
+  UINT8   FruInventorySupport : 1;
+  UINT8   IpmbMessageReceiver : 1;
+  UINT8   IpmbMessageGenerator : 1;
+  UINT8   BridgeSupport : 1;
+  UINT8   ChassisSupport : 1;
+  UINT8   ManufacturerId[3];
+  UINT16  ProductId;
+  UINT32  AuxFirmwareRevInfo;
+} IPMI_MSG_GET_DEVICE_ID_RSP;
+
+
+//
+//  Definitions for Cold Reset command
+//
+#define IPMI_APP_COLD_RESET  0x2
+
+//
+//  Constants and Structure definitions for "Cold Reset" command to follow here
+//
+
+//
+//  Definitions for Warm Reset command
+//
+#define IPMI_APP_WARM_RESET  0x3
+
+//
+//  Constants and Structure definitions for "Warm Reset" command to follow here
+//
+
+//
+//  Definitions for Get Self Results command
+//
+#define IPMI_APP_GET_SELFTEST_RESULTS  0x4
+
+//
+//  Constants and Structure definitions for "Get Self Results" command to follow here
+//
+typedef struct {
+  UINT8  Result;
+  UINT8  Param;
+} IPMI_MSG_SELFTEST_RESULT_RSP;
+
+#define IPMI_APP_SELFTEST_NO_ERROR             0x55
+#define IPMI_APP_SELFTEST_NOT_IMPLEMENTED      0x56
+#define IPMI_APP_SELFTEST_ERROR                0x57
+#define IPMI_APP_SELFTEST_FATAL_HW_ERROR       0x58
+#define IPMI_APP_SELFTEST_INACCESSIBLE_SEL     0x80
+#define IPMI_APP_SELFTEST_INACCESSIBLE_SDR     0x40
+#define IPMI_APP_SELFTEST_INACCESSIBLE_FRU     0x20
+#define IPMI_APP_SELFTEST_IPMB_SIGNAL_FAIL     0x10
+#define IPMI_APP_SELFTEST_SDR_REPOSITORY_EMPTY 0x08
+#define IPMI_APP_SELFTEST_FRU_CORRUPT          0x04
+#define IPMI_APP_SELFTEST_FW_BOOTBLOCK_CORRUPT 0x02
+#define IPMI_APP_SELFTEST_FW_CORRUPT           0x01
+
+//
+//  Definitions for Manufacturing Test ON command
+//
+#define IPMI_APP_MANUFACTURING_TEST_ON 0x5
+
+//
+//  Constants and Structure definitions for "Manufacturing Test ON" command to follow here
+//
+
+//
+//  Definitions for Set ACPI Power State command
+//
+#define IPMI_APP_SET_ACPI_POWERSTATE 0x6
+
+//
+//  Constants and Structure definitions for "Set ACPI Power State" command to follow here
+//
+typedef struct {
+  UINT8 SystemPowerState : 7;
+  UINT8 SystemStateChange : 1;
+  UINT8 DevicePowerState : 7;
+  UINT8 DeviceStateChange : 1;
+} IPMI_ACPI_POWER_STATE;
+
+//
+//  Definitions for Get ACPI Power State command
+//
+#define IPMI_APP_GET_ACPI_POWERSTATE 0x7
+
+//
+//  Constants and Structure definitions for "Get ACPI Power State" command to follow here
+//
+
+//
+//  Definitions for Get Device GUID command
+//
+#define IPMI_APP_GET_DEVICE_GUID 0x8
+
+//
+//  Constants and Structure definitions for "Get Device GUID" command to follow here
+//
+//
+//  Message structure definition for "Get Device Guid" IPMI command
+//
+typedef struct {
+  UINT8 Guid[16];
+} IPMI_MSG_GET_DEVICE_GUID_RSP;
+
+//
+//  Below is Definitions for BMC Watchdog Timer Commands (Chapter 27)
+//
+
+//
+//  Definitions for Reset WatchDog Timer command
+//
+#define IPMI_APP_RESET_WATCHDOG_TIMER  0x22
+
+//
+//  Constants and Structure definitions for "Reset WatchDog Timer" command to follow here
+//
+typedef struct {
+  UINT8 TimerUse : 3;
+  UINT8 Reserved : 3;
+  UINT8 TimerRunning : 1;
+  UINT8 TimerUseExpirationFlagLog : 1;
+} IPMI_WATCHDOG_TIMER_USE;
+
+//
+//  Definitions for Set WatchDog Timer command
+//
+#define IPMI_APP_SET_WATCHDOG_TIMER  0x24
+
+//
+//  Constants and Structure definitions for "Set WatchDog Timer" command to follow here
+//
+typedef struct {
+  IPMI_WATCHDOG_TIMER_USE         TimerUse;
+  UINT8                           TimerActions;
+  UINT8                           PretimeoutInterval;
+  UINT8                           TimerUseExpirationFlagsClear;
+  UINT16                          InitialCountdownValue;
+} IPMI_SET_WATCHDOG_TIMER;
+
+//
+//  Definitions for Get WatchDog Timer command
+//
+#define IPMI_APP_GET_WATCHDOG_TIMER  0x25
+
+//
+//  Constants and Structure definitions for "Get WatchDog Timer" command to follow here
+//
+typedef struct {
+  IPMI_WATCHDOG_TIMER_USE         TimerUse;
+  UINT8                           TimerActions;
+  UINT8                           PretimeoutInterval;
+  UINT8                           TimerUseExpirationFlagsClear;
+  UINT16                          InitialCountdownValue;
+  UINT16                          PresentCountdownValue;
+} IPMI_GET_WATCHDOG_TIMER;
+
+//
+//  Below is Definitions for IPMI Messaging Support Commands (Chapter 22)
+//
+
+//
+//  Definitions for Set BMC Global Enables command
+//
+#define IPMI_APP_SET_BMC_GLOBAL_ENABLES  0x2E
+
+//
+//  Constants and Structure definitions for "Set BMC Global Enables " command to follow here
+//
+
+//
+//  Definitions for Get BMC Global Enables command
+//
+#define IPMI_APP_GET_BMC_GLOBAL_ENABLES  0x2F
+
+//
+//  Constants and Structure definitions for "Get BMC Global Enables " command to follow here
+//
+
+//
+//  Definitions for Clear Message Flags command
+//
+#define IPMI_APP_CLEAR_MESSAGE_FLAGS 0x30
+
+//
+//  Constants and Structure definitions for "Clear Message Flags" command to follow here
+//
+
+//
+//  Definitions for Get Message Flags command
+//
+#define IPMI_APP_GET_MESSAGE_FLAGS 0x31
+
+//
+//  Constants and Structure definitions for "Get Message Flags" command to follow here
+//
+
+//
+//  Definitions for Enable Message Channel Receive command
+//
+#define IPMI_APP_ENABLE_MESSAGE_CHANNEL_RECEIVE  0x32
+
+//
+//  Constants and Structure definitions for "Enable Message Channel Receive" command to follow here
+//
+
+//
+//  Definitions for Get Message command
+//
+#define IPMI_APP_GET_MESSAGE 0x33
+
+//
+//  Constants and Structure definitions for "Get Message" command to follow here
+//
+
+//
+//  Definitions for Send Message command
+//
+#define IPMI_APP_SEND_MESSAGE  0x34
+
+//
+//  Constants and Structure definitions for "Send Message" command to follow here
+//
+
+//
+//  Definitions for Read Event Message Buffer command
+//
+#define IPMI_APP_READ_EVENT_MSG_BUFFER 0x35
+
+//
+//  Constants and Structure definitions for "Read Event Message Buffer" command to follow here
+//
+
+//
+//  Definitions for Get BT Interface Capabilities command
+//
+#define IPMI_APP_GET_BT_INTERFACE_CAPABILITY 0x36
+
+//
+//  Constants and Structure definitions for "Get BT Interface Capabilities" command to follow here
+//
+
+//
+//  Definitions for Get System GUID command
+//
+#define IPMI_APP_GET_SYSTEM_GUID 0x37
+
+//
+//  Constants and Structure definitions for "Get System GUID" command to follow here
+//
+
+//
+//  Definitions for Get Channel Authentication Capabilities command
+//
+#define IPMI_APP_GET_CHANNEL_AUTHENTICATION_CAPABILITIES 0x38
+
+//
+//  Constants and Structure definitions for "Get Channel Authentication Capabilities" command to follow here
+//
+
+//
+//  Definitions for Get Session Challenge command
+//
+#define IPMI_APP_GET_SESSION_CHALLENGE 0x39
+
+//
+//  Constants and Structure definitions for "Get Session Challenge" command to follow here
+//
+
+//
+//  Definitions for Activate Session command
+//
+#define IPMI_APP_ACTIVATE_SESSION  0x3A
+
+//
+//  Constants and Structure definitions for "Activate Session" command to follow here
+//
+
+//
+//  Definitions for Set Session Privelege Level command
+//
+#define IPMI_APP_SET_SESSION_PRIVELEGE_LEVEL 0x3B
+
+//
+//  Constants and Structure definitions for "Set Session Privelege Level" command to follow here
+//
+
+//
+//  Definitions for Close Session command
+//
+#define IPMI_APP_CLOSE_SESSION 0x3C
+
+//
+//  Constants and Structure definitions for "Close Session" command to follow here
+//
+
+//
+//  Definitions for Get Session Info command
+//
+#define IPMI_APP_GET_SESSION_INFO  0x3D
+
+//
+//  Constants and Structure definitions for "Get Session Info" command to follow here
+//
+
+//
+//  Definitions for Get Auth Code command
+//
+#define IPMI_APP_GET_AUTHCODE  0x3F
+
+//
+//  Constants and Structure definitions for "Get AuthCode" command to follow here
+//
+
+//
+//  Definitions for Set Channel Access command
+//
+#define IPMI_APP_SET_CHANNEL_ACCESS  0x40
+
+//
+//  Constants and Structure definitions for "Set Channel Access" command to follow here
+//
+
+//
+//  Definitions for Get Channel Access command
+//
+#define IPMI_APP_GET_CHANNEL_ACCESS  0x41
+
+//
+//  Constants and Structure definitions for "Get Channel Access" command to follow here
+//
+typedef struct {
+  UINT8 ChannelNo : 4;
+  UINT8 Reserve1 : 4;
+  UINT8 Reserve2 : 6;
+  UINT8 MemoryType : 2;
+} IPMI_GET_CHANNEL_ACCESS_COMMAND;
+
+typedef struct {
+  UINT8 AccessMode : 3;
+  UINT8 UserLevelAuthEnabled : 1;
+  UINT8 MessageAuthEnable : 1;
+  UINT8 Alert : 1;
+  UINT8 Reserve1 : 2;
+  UINT8 ChannelPriviledgeLimit : 4;
+  UINT8 Reserve2 : 4;
+} IPMI_GET_CHANNEL_ACCESS_RESPONSE;
+
+//
+//  Definitions for Get Channel Info command
+//
+#define IPMI_APP_GET_CHANNEL_INFO  0x42
+
+//
+//  Constants and Structure definitions for "Get Channel Info" command to follow here
+//
+typedef struct {
+  UINT8   ChannelNo : 4;
+  UINT8   Reserve1 : 4;
+  UINT8   ChannelMediumType : 7;
+  UINT8   Reserve2 : 1;
+  UINT8   ChannelProtocolType : 5;
+  UINT8   Reserve3 : 3;
+  UINT8   ActiveSessionCount : 6;
+  UINT8   SessionSupport : 2;
+  UINT32  VendorId : 24;
+  UINT16  AuxChannelInfo : 16;
+  UINT8   Dummy;
+} IPMI_CHANNEL_INFO;
+
+//
+//  Definitions for Get Channel Info command
+//
+#define IPMI_APP_GET_CHANNEL_INFO  0x42
+
+//
+//  Constants and Structure definitions for "Get Channel Info" command to follow here
+//
+
+//
+//  Definitions for Set User Access command
+//
+#define IPMI_APP_SET_USER_ACCESS 0x43
+
+//
+//  Constants and Structure definitions for "Set User Access" command to follow here
+//
+
+//
+//  Definitions for Get User Access command
+//
+#define IPMI_APP_GET_USER_ACCESS 0x44
+
+//
+//  Constants and Structure definitions for "Get User Access" command to follow here
+//
+
+//
+//  Definitions for Set User Name command
+//
+#define IPMI_APP_SET_USER_NAME 0x45
+
+//
+//  Constants and Structure definitions for "Set User Name" command to follow here
+//
+
+//
+//  Definitions for Get User Name command
+//
+#define IPMI_APP_GET_USER_NAME 0x46
+
+//
+//  Constants and Structure definitions for "Get User Name" command to follow here
+//
+
+//
+//  Definitions for Set User Password command
+//
+#define IPMI_APP_SET_USER_PASSWORD 0x47
+
+//
+//  Constants and Structure definitions for "Set User Password" command to follow here
+//
+
+//
+//  Below is Definitions for RMCP+ Support and Payload Commands (Chapter 24)
+//
+
+//
+//  Definitions for Activate Payload command
+//
+#define IPMI_APP_ACTIVATE_PAYLOAD  0x48
+
+//
+//  Constants and Structure definitions for "Activate Payload" command to follow here
+//
+
+//
+//  Definitions for De-Activate Payload command
+//
+#define IPMI_APP_DEACTIVATE_PAYLOAD  0x49
+
+//
+//  Constants and Structure definitions for "DeActivate Payload" command to follow here
+//
+
+//
+//  Definitions for Get Payload activation Status command
+//
+#define IPMI_APP_GET_PAYLOAD_ACTIVATION_STATUS 0x4a
+
+//
+//  Constants and Structure definitions for "Get Payload activation Status" command to follow here
+//
+
+//
+//  Definitions for Get Payload Instance Info command
+//
+#define IPMI_APP_GET_PAYLOAD_INSTANCE_INFO 0x4b
+
+//
+//  Constants and Structure definitions for "Get Payload Instance Info" command to follow here
+//
+
+//
+//  Definitions for Set User Payload Access command
+//
+#define IPMI_APP_SET_USER_PAYLOAD_ACCESS 0x4C
+
+//
+//  Constants and Structure definitions for "Set User Payload Access" command to follow here
+//
+
+//
+//  Definitions for Get User Payload Access command
+//
+#define IPMI_APP_GET_USER_PAYLOAD_ACCESS 0x4D
+
+//
+//  Constants and Structure definitions for "Get User Payload Access" command to follow here
+//
+
+//
+//  Definitions for Get Channel Payload Support command
+//
+#define IPMI_APP_GET_CHANNEL_PAYLOAD_SUPPORT 0x4E
+
+//
+//  Constants and Structure definitions for "Get Channel Payload Support" command to follow here
+//
+
+//
+//  Definitions for Get Channel Payload Version command
+//
+#define IPMI_APP_GET_CHANNEL_PAYLOAD_VERSION 0x4F
+
+//
+//  Constants and Structure definitions for "Get Channel Payload Version" command to follow here
+//
+
+//
+//  Definitions for Get Channel OEM Payload Info command
+//
+#define IPMI_APP_GET_CHANNEL_OEM_PAYLOAD_INFO  0x50
+
+//
+//  Constants and Structure definitions for "Get Channel OEM Payload Info" command to follow here
+//
+
+//
+//  Definitions for  Master Write-Read command
+//
+#define IPMI_APP_MASTER_WRITE_READ 0x52
+
+//
+//  Constants and Structure definitions for "Master Write Read" command to follow here
+//
+
+//
+//  Definitions for  Get Channel Cipher Suites command
+//
+#define IPMI_APP_GET_CHANNEL_CIPHER_SUITES 0x54
+
+//
+//  Constants and Structure definitions for "Get Channel Cipher Suites" command to follow here
+//
+
+//
+//  Below is Definitions for RMCP+ Support and Payload Commands (Chapter 24, Section 3)
+//
+
+//
+//  Definitions for  Suspend-Resume Payload Encryption command
+//
+#define IPMI_APP_SUSPEND_RESUME_PAYLOAD_ENCRYPTION 0x55
+
+//
+//  Constants and Structure definitions for "Suspend-Resume Payload Encryption" command to follow here
+//
+
+//
+//  Below is Definitions for IPMI Messaging Support Commands (Chapter 22, Section 25 and 9)
+//
+
+//
+//  Definitions for  Set Channel Security Keys command
+//
+#define IPMI_APP_SET_CHANNEL_SECURITY_KEYS 0x56
+
+//
+//  Constants and Structure definitions for "Set Channel Security Keys" command to follow here
+//
+
+//
+//  Definitions for  Get System Interface Capabilities command
+//
+#define IPMI_APP_GET_SYSTEM_INTERFACE_CAPABILITIES 0x57
+
+//
+//  Constants and Structure definitions for "Get System Interface Capabilities" command to follow here
+//
+
+#pragma pack()
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnBridge.h b/MdePkg/Include/IndustryStandard/IpmiNetFnBridge.h
new file mode 100644
index 000000000000..2b5b495f5b60
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnBridge.h
@@ -0,0 +1,243 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+  IPMI Intelligent Chassis Management Bus Bridge Specification Version 1.0,
+  Revision 1.3.
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_BRIDGE_H_
+#define _IPMI_NET_FN_BRIDGE_H_
+
+//
+// Net function definition for Bridge command
+//
+#define IPMI_NETFN_BRIDGE 0x02
+
+//
+//  Definitions for Get Bridge State command
+//
+#define IPMI_BRIDGE_GET_STATE  0x00
+
+//
+//  Constants and Structure definitions for "Get Bridge State" command to follow here
+//
+
+//
+//  Definitions for Set Bridge State command
+//
+#define IPMI_BRIDGE_SET_STATE  0x01
+
+//
+//  Constants and Structure definitions for "Set Bridge State" command to follow here
+//
+
+//
+//  Definitions for Get ICMB Address command
+//
+#define IPMI_BRIDGE_GET_ICMB_ADDRESS 0x02
+
+//
+//  Constants and Structure definitions for "Get ICMB Address" command to follow here
+//
+
+//
+//  Definitions for Set ICMB Address command
+//
+#define IPMI_BRIDGE_SET_ICMB_ADDRESS 0x03
+
+//
+//  Constants and Structure definitions for "Set ICMB Address" command to follow here
+//
+
+//
+//  Definitions for Set Bridge Proxy Address command
+//
+#define IPMI_BRIDGE_SET_PROXY_ADDRESS  0x04
+
+//
+//  Constants and Structure definitions for "Set Bridge Proxy Address" command to follow here
+//
+
+//
+//  Definitions for Get Bridge Statistics command
+//
+#define IPMI_BRIDGE_GET_BRIDGE_STATISTICS  0x05
+
+//
+//  Constants and Structure definitions for "Get Bridge Statistics" command to follow here
+//
+
+//
+//  Definitions for Get ICMB Capabilities command
+//
+#define IPMI_BRIDGE_GET_ICMB_CAPABILITIES  0x06
+
+//
+//  Constants and Structure definitions for "Get ICMB Capabilities" command to follow here
+//
+
+//
+//  Definitions for Clear Bridge Statistics command
+//
+#define IPMI_BRIDGE_CLEAR_STATISTICS 0x08
+
+//
+//  Constants and Structure definitions for "Clear Bridge Statistics" command to follow here
+//
+
+//
+//  Definitions for Get Bridge Proxy Address command
+//
+#define IPMI_BRIDGE_GET_PROXY_ADDRESS  0x09
+
+//
+//  Constants and Structure definitions for "Get Bridge Proxy Address" command to follow here
+//
+
+//
+//  Definitions for Get ICMB Connector Info command
+//
+#define IPMI_BRIDGE_GET_ICMB_CONNECTOR_INFO  0x0A
+
+//
+//  Constants and Structure definitions for "Get ICMB Connector Info " command to follow here
+//
+
+//
+//  Definitions for Get ICMB Connection ID command
+//
+#define IPMI_BRIDGE_GET_ICMB_CONNECTION_ID 0x0B
+
+//
+//  Constants and Structure definitions for "Get ICMB Connection ID" command to follow here
+//
+
+//
+//  Definitions for Get ICMB Connection ID command
+//
+#define IPMI_BRIDGE_SEND_ICMB_CONNECTION_ID  0x0C
+
+//
+//  Constants and Structure definitions for "Send ICMB Connection ID" command to follow here
+//
+
+//
+//  Definitions for Prepare for Discoveery command
+//
+#define IPMI_BRIDGE_PREPARE_FOR_DISCOVERY  0x10
+
+//
+//  Constants and Structure definitions for "Prepare for Discoveery" command to follow here
+//
+
+//
+//  Definitions for Get Addresses command
+//
+#define IPMI_BRIDGE_GET_ADDRESSES  0x11
+
+//
+//  Constants and Structure definitions for "Get Addresses" command to follow here
+//
+
+//
+//  Definitions for Set Discovered command
+//
+#define IPMI_BRIDGE_SET_DISCOVERED 0x12
+
+//
+//  Constants and Structure definitions for "Set Discovered" command to follow here
+//
+
+//
+//  Definitions for Get Chassis Device ID command
+//
+#define IPMI_BRIDGE_GET_CHASSIS_DEVICEID 0x13
+
+//
+//  Constants and Structure definitions for "Get Chassis Device ID" command to follow here
+//
+
+//
+//  Definitions for Set Chassis Device ID command
+//
+#define IPMI_BRIDGE_SET_CHASSIS_DEVICEID 0x14
+
+//
+//  Constants and Structure definitions for "Set Chassis Device ID" command to follow here
+//
+
+//
+//  Definitions for Bridge Request command
+//
+#define IPMI_BRIDGE_REQUEST  0x20
+
+//
+//  Constants and Structure definitions for "Bridge Request" command to follow here
+//
+
+//
+//  Definitions for Bridge Message command
+//
+#define IPMI_BRIDGE_MESSAGE  0x21
+
+//
+//  Constants and Structure definitions for "Bridge Message" command to follow here
+//
+
+//
+//  Definitions for Get Event Count command
+//
+#define IPMI_BRIDGE_GET_EVENT_COUNT  0x30
+
+//
+//  Constants and Structure definitions for "Get Event Count" command to follow here
+//
+
+//
+//  Definitions for Set Event Destination command
+//
+#define IPMI_BRIDGE_SET_EVENT_DESTINATION  0x31
+
+//
+//  Constants and Structure definitions for "Set Event Destination" command to follow here
+//
+
+//
+//  Definitions for Set Event Reception State command
+//
+#define IPMI_BRIDGE_SET_EVENT_RECEPTION_STATE  0x32
+
+//
+//  Constants and Structure definitions for "Set Event Reception State" command to follow here
+//
+
+//
+//  Definitions for Set Event Reception State command
+//
+#define IPMI_BRIDGE_SET_EVENT_RECEPTION_STATE  0x32
+
+//
+//  Constants and Structure definitions for "Set Event Reception State" command to follow here
+//
+
+//
+//  Definitions for Send ICMB Event Message command
+//
+#define IPMI_BRIDGE_SEND_ICMB_EVENT_MESSAGE  0x33
+
+//
+//  Constants and Structure definitions for "Send ICMB Event Message" command to follow here
+//
+
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h b/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
new file mode 100644
index 000000000000..7bf6cf31010e
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
@@ -0,0 +1,304 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  This file contains all NetFn Chassis commands, including:
+    Chassis Commands (Chapter 28)
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_CHASSIS_H_
+#define _IPMI_NET_FN_CHASSIS_H_
+
+#pragma pack (1)
+//
+// Net function definition for Chassis command
+//
+#define IPMI_NETFN_CHASSIS  0x00
+
+//
+//  Below is Definitions for Chassis commands (Chapter 28)
+//
+
+//
+//  Definitions for Get Chassis Capabilities command
+//
+#define IPMI_CHASSIS_GET_CAPABILITIES  0x00
+
+//
+//  Constants and Structure definitions for "Get Chassis Capabilities" command to follow here
+//
+
+//
+//  Definitions for Get Chassis Status command
+//
+#define IPMI_CHASSIS_GET_STATUS  0x01
+
+//
+//  Constants and Structure definitions for "Get Chassis Status" command to follow here
+//
+
+//
+//  Definitions for Chassis Control command
+//
+#define IPMI_CHASSIS_CONTROL 0x02
+
+//
+//  Constants and Structure definitions for "Chassis Control" command to follow here
+//
+
+//
+//  Definitions for Chassis Reset command
+//
+#define IPMI_CHASSIS_RESET 0x03
+
+//
+//  Constants and Structure definitions for "Chassis Reset" command to follow here
+//
+
+//
+//  Definitions for Chassis Identify command
+//
+#define IPMI_CHASSIS_IDENTIFY  0x04
+
+//
+//  Constants and Structure definitions for "Chassis Identify" command to follow here
+//
+
+//
+//  Definitions for Set Chassis Capabilities command
+//
+#define IPMI_CHASSIS_SET_CAPABILITIES  0x05
+
+//
+//  Constants and Structure definitions for "Set Chassis Capabilities" command to follow here
+//
+
+//
+//  Definitions for Set Power Restore Policy command
+//
+#define IPMI_CHASSIS_SET_POWER_RESTORE_POLICY  0x06
+
+//
+//  Constants and Structure definitions for "Set Power Restore Policy" command to follow here
+//
+
+//
+//  Definitions for Get System Restart Cause command
+//
+#define IPMI_CHASSIS_GET_SYSTEM_RESTART_CAUSE  0x07
+
+//
+//  Constants and Structure definitions for "Get System Restart Cause" command to follow here
+//
+typedef enum {
+  Unknown,
+  ChassisControlCommand,
+  ResetViaPushButton,
+  PowerupViaPowerButton,
+  WatchdogExpiration,
+  Oem,
+  AutoPowerOnAlwaysRestore,
+  AutoPowerOnRestorePrevious,
+  ResetViaPef,
+  PowerCycleViaPef,
+  SoftReset,
+  PowerUpViaRtc
+} IPMI_SYSTEM_RESTART_CAUSE;
+
+typedef struct {
+  UINT8   Cause:4;
+  UINT8   Reserved:4;
+  UINT8   ChannelNumber;
+} GET_SYSTEM_RESTART_CAUSE_RESPONSE;
+
+//
+//  Definitions for Set System BOOT options command
+//
+#define IPMI_CHASSIS_SET_SYSTEM_BOOT_OPTIONS 0x08
+
+//
+//  Constants and Structure definitions for "Set System boot options" command to follow here
+//
+typedef struct {
+  UINT8    ParameterSelector:7;
+  UINT8    MarkParameterInvalid:1;
+  UINT8    ParameterData[1];
+} IPMI_SET_BOOT_OPTIONS_REQUEST;
+
+typedef struct {
+  UINT8   CompletionCode:8;
+} IPMI_SET_BOOT_OPTIONS_RESPONSE;
+
+//
+//  Definitions for Get System BOOT options command
+//
+#define IPMI_CHASSIS_GET_SYSTEM_BOOT_OPTIONS 0x09
+
+//
+//  Constants and Structure definitions for "Get System boot options" command to follow here
+//
+typedef struct {
+  UINT8 Parameter;
+  UINT8 Valid;
+  UINT8 Data1;
+  UINT8 Data2;
+  UINT8 Data3;
+  UINT8 Data4;
+  UINT8 Data5;
+} IPMI_GET_THE_SYSTEM_BOOT_OPTIONS;
+
+typedef struct {
+  UINT8   ParameterVersion;
+  UINT8   ParameterValid;
+  UINT8   ChannelNumber;
+  UINT32  SessionId;
+  UINT32  TimeStamp;
+  UINT8   Reserved[3];
+} IPMI_BOOT_INITIATOR;
+
+typedef struct {
+  UINT8    ParameterSelector;
+  UINT8    SetSelector;
+  UINT8    BlockSelector;
+} IPMI_GET_BOOT_OPTIONS_REQUEST;
+
+//
+// Response Parameters for IPMI Get Boot Options
+//
+typedef struct {
+  UINT8   SetInProgress: 2;
+  UINT8   Reserved: 6;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_0;
+
+typedef struct {
+  UINT8   ServicePartitionSelector;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_1;
+
+typedef struct {
+  UINT8   ServicePartitionDiscovered:1;
+  UINT8   ServicePartitionScanRequest:1;
+  UINT8   Reserved: 5;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_2;
+
+typedef struct {
+  UINT8   BmcBootFlagValid: 5;
+  UINT8   Reserved: 3;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_3;
+
+typedef struct {
+  UINT8   WriteMask;
+  UINT8   BootInitiatorAcknowledgeData;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_4;
+
+#define BOOT_OPTION_HANDLED_BY_BIOS 0x01
+
+typedef struct {
+  //
+  // Data 1
+  //
+  UINT8   Reserved0:6;
+  UINT8   PersistentOptions:1;
+  UINT8   BootFlagValid:1;
+  //
+  // Data 2
+  //
+  UINT8   LockReset:1;
+  UINT8   ScreenBlank:1;
+  UINT8   BootDeviceSelector:4;
+  UINT8   LockKeyboard:1;
+  UINT8   CmosClear:1;
+  //
+  //
+  // Data 3
+  UINT8   ConsoleRedirection:2;
+  UINT8   LockSleep:1;
+  UINT8   UserPasswordBypass:1;
+  UINT8   ForceProgressEventTrap:1;
+  UINT8   BiosVerbosity:2;
+  UINT8   LockPower:1;
+  //
+  // Data 4
+  //
+  UINT8   BiosMuxControlOverride:2;
+  UINT8   BiosSharedModeOverride:1;
+  UINT8   Reserved1:4;
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_5;
+
+typedef struct {
+  UINT8   ChannelNumber:4;
+  UINT8   Reserved:4;
+  UINT8   SessionId[4];
+  UINT8   BootInfoTimeStamp[4];
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_6;
+
+typedef struct {
+  UINT8   SetSelector;
+  UINT8   BlockData[16];
+} IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_7;
+
+typedef union {
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_0   Parm0;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_1   Parm1;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_2   Parm2;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_3   Parm3;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_4   Parm4;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_5   Parm5;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_6   Parm6;
+  IPMI_BOOT_OPTIONS_RESPONSE_PARAMETER_7   Parm7;
+} IPMI_BOOT_OPTIONS_PARAMETERS;
+
+typedef struct {
+  UINT8    ParameterVersion:4;
+  UINT8    Reserved:4;
+  UINT8    ParameterSelector:7;
+  UINT8    ParameterValid:1;
+  UINT8    ParameterData[1];
+} IPMI_GET_BOOT_OPTIONS_RESPONSE;
+
+//
+//  Definitions for Set front panel button enables command
+//
+#define IPMI_CHASSIS_SET_FP_BUTTON_ENABLES 0x0A
+
+typedef struct {
+  UINT8    DisablePoweroffButton:1;
+  UINT8    DisableResetButton:1;
+  UINT8    DisableDiagnosticInterruptButton:1;
+  UINT8    DisableStandbyButton:1;
+  UINT8    Reserved:4;
+} IPMI_SET_FRONT_PANEL_BUTTON_ENABLES_REQUEST;
+
+//
+//  Constants and Structure definitions for "Set front panel button enables" command to follow here
+//
+
+//
+//  Definitions for Set Power Cycle Interval command
+//
+#define IPMI_CHASSIS_SET_POWER_CYCLE_INTERVALS 0x0B
+
+//
+//  Constants and Structure definitions for "Set Power Cycle Interval" command to follow here
+//
+
+//
+//  Definitions for Get POH Counter command
+//
+#define IPMI_CHASSIS_GET_POH_COUNTER 0x0F
+
+//
+//  Constants and Structure definitions for "Get POH Counter" command to follow here
+//
+#pragma pack()
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnFirmware.h b/MdePkg/Include/IndustryStandard/IpmiNetFnFirmware.h
new file mode 100644
index 000000000000..62962a1caaba
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnFirmware.h
@@ -0,0 +1,26 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_FIRMWARE_H_
+#define _IPMI_NET_FN_FIRMWARE_H_
+
+//
+// Net function definition for Firmware command
+//
+#define IPMI_NETFN_FIRMWARE 0x08
+
+//
+// All Firmware commands and their structure definitions to follow here
+//
+
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnGroupExtension.h b/MdePkg/Include/IndustryStandard/IpmiNetFnGroupExtension.h
new file mode 100644
index 000000000000..2b73988f2165
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnGroupExtension.h
@@ -0,0 +1,26 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_GROUP_EXTENSION_H_
+#define _IPMI_NET_FN_GROUP_EXTENSION_H_
+
+//
+// Net function definition for Group Extension command
+//
+#define IPMI_NETFN_GROUP_EXT  0x2C
+
+//
+// All Group Extension commands and their structure definitions to follow here
+//
+
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h b/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
new file mode 100644
index 000000000000..bc3563482678
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
@@ -0,0 +1,52 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  This file contains all NetFn Sensor/Event commands, including:
+    Event Commands (Chapter 29)
+    PEF and Alerting Commands (Chapter 30)
+    Sensor Device Commands (Chapter 35)
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_SENSOR_EVENT_H_
+#define _IPMI_NET_FN_SENSOR_EVENT_H_
+
+#pragma pack(1)
+//
+// Net function definition for Sensor command
+//
+#define IPMI_NETFN_SENSOR_EVENT 0x04
+
+//
+// All Sensor commands and their structure definitions to follow here
+//
+
+//
+//  Definitions for Send Platform Event Message command
+//
+#define IPMI_SENSOR_PLATFORM_EVENT_MESSAGE   0x02
+
+typedef struct {
+  UINT8   GeneratorId;
+  UINT8   EvMRevision;
+  UINT8   SensorType;
+  UINT8   SensorNumber;
+  UINT8   EventDirType;
+  UINT8   OEMEvData1;
+  UINT8   OEMEvData2;
+  UINT8   OEMEvData3;
+} IPMI_PLATFORM_EVENT_MESSAGE_DATA;
+
+#pragma pack()
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h b/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
new file mode 100644
index 000000000000..45c7d19f14dd
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
@@ -0,0 +1,534 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  This file contains all NetFn Storage commands, including:
+    FRU Inventory Commands (Chapter 34)
+    SDR Repository (Chapter 33)
+    System Event Log(SEL) Commands (Chapter 31)
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_STORAGE_H_
+#define _IPMI_NET_FN_STORAGE_H_
+
+#pragma pack(1)
+//
+// Net function definition for Storage command
+//
+#define IPMI_NETFN_STORAGE  0x0A
+
+//
+// All Storage commands and their structure definitions to follow here
+//
+
+//
+//  Below is Definitions for FRU Inventory Commands (Chapter 34)
+//
+
+//
+//  Definitions for Get Fru Inventory Area Info command
+//
+#define IPMI_STORAGE_GET_FRU_INVENTORY_AREAINFO  0x10
+
+//
+//  Constants and Structure definitions for "Get Fru Inventory Area Info" command to follow here
+//
+
+//
+//  Definitions for Get Fru Data command
+//
+#define IPMI_STORAGE_READ_FRU_DATA 0x11
+
+//
+//  Constants and Structure definitions for "Get Fru Data" command to follow here
+//
+typedef struct {
+  UINT8   FruDeviceId;
+  UINT16  FruOffset;
+} IPMI_FRU_COMMON_DATA;
+
+typedef struct {
+  IPMI_FRU_COMMON_DATA Data;
+  UINT8                Count;
+} IPMI_FRU_READ_COMMAND;
+
+//
+//  Definitions for Write Fru Data command
+//
+#define IPMI_STORAGE_WRITE_FRU_DATA  0x12
+
+//
+//  Constants and Structure definitions for "Write Fru Data" command to follow here
+//
+typedef struct {
+  IPMI_FRU_COMMON_DATA Data;
+  UINT8                FruData[16];
+} IPMI_FRU_WRITE_COMMAND;
+
+//
+//  Below is Definitions for SDR Repository (Chapter 33)
+//
+
+//
+//  Definitions for Get SDR Repository Info command
+//
+#define IPMI_STORAGE_GET_SDR_REPOSITORY_INFO 0x20
+
+//
+//  Constants and Structure definitions for "Get SDR Repository Info" command to follow here
+//
+typedef struct {
+  UINT8   Version;
+  UINT16  RecordCount;
+  UINT16  FreeSpace;
+  UINT32  RecentAdditionTimeStamp;
+  UINT32  RecentEraseTimeStamp;
+  UINT8   SdrRepAllocInfoCmd : 1;
+  UINT8   SdrRepReserveCmd : 1;
+  UINT8   PartialAddSdrCmd : 1;
+  UINT8   DeleteSdrRepCmd : 1;
+  UINT8   Reserved : 1;
+  UINT8   SdrRepUpdateOp : 2;
+  UINT8   Overflow : 1;
+} IPMI_SDR_REPOSITORY_INFO;
+
+//
+//  Definitions for Get SDR Repository Allocateion Info command
+//
+#define IPMI_STORAGE_GET_SDR_REPOSITORY_ALLOCATION_INFO  0x21
+
+//
+//  Constants and Structure definitions for "Get SDR Repository Allocateion Info" command to follow here
+//
+
+//
+//  Definitions for Reserve SDR Repository command
+//
+#define IPMI_STORAGE_RESERVE_SDR_REPOSITORY  0x22
+
+//
+//  Constants and Structure definitions for "Reserve SDR Repository" command to follow here
+//
+
+//
+//  Definitions for Get SDR command
+//
+#define IPMI_STORAGE_GET_SDR 0x23
+
+//
+//  Constants and Structure definitions for "Get SDR" command to follow here
+//
+
+typedef struct {
+  UINT16  RecordId;                     // 1
+  UINT8   Version;                      // 3
+  UINT8   RecordType;                   // 4
+  UINT8   RecordLength;                 // 5
+  UINT8   OwnerId;                      // 6
+  UINT8   OwnerLun;                     // 7
+  UINT8   SensorNumber;                 // 8
+  UINT8   EntityId;                     // 9
+  UINT8   EntityInstance;               // 10
+  UINT8   EventScanningEnabled : 1;     // 11
+  UINT8   EventScanningDisabled : 1;    // 11
+  UINT8   InitSensorType : 1;           // 11
+  UINT8   InitHysteresis : 1;           // 11
+  UINT8   InitThresholds : 1;           // 11
+  UINT8   InitEvent : 1;                // 11
+  UINT8   InitScanning : 1;             // 11
+  UINT8   Reserved : 1;                 // 11
+  UINT8   EventMessageControl : 2;      // 12
+  UINT8   ThresholdAccessSupport : 2;   // 12
+  UINT8   HysteresisSupport : 2;        // 12
+  UINT8   ReArmSupport : 1;             // 12
+  UINT8   IgnoreSensor : 1;             // 12
+  UINT8   SensorType;                   // 13
+  UINT8   EventType;                    // 14
+  UINT8   Reserved1[7];                 // 15
+  UINT8   UnitType;                     // 22
+  UINT8   Reserved2;                    // 23
+  UINT8   Linearization : 7;            // 24
+  UINT8   Reserved3 : 1;                // 24
+  UINT8   MLo;                          // 25
+  UINT8   Toleremce : 6;                // 26
+  UINT8   MHi : 2;                      // 26
+  UINT8   BLo;                          // 27
+  UINT8   AccuracyLow : 6;              // 28
+  UINT8   BHi : 2;                      // 28
+  UINT8   Reserved4 : 2;                // 29
+  UINT8   AccuracyExp : 2;              // 29
+  UINT8   AccuracyHi : 4;               // 29
+  UINT8   BExp : 4;                     // 30
+  UINT8   RExp : 4;                     // 30
+  UINT8   NominalReadingSpscified : 1;  // 31
+  UINT8   NominalMaxSpscified : 1;      // 31
+  UINT8   NominalMinSpscified : 1;      // 31
+  UINT8   Reserved5 : 5;                // 31
+  UINT8   NominalReading;               // 32
+  UINT8   Reserved6[4];                 // 33
+  UINT8   UpperNonRecoverThreshold;     // 37
+  UINT8   UpperCriticalThreshold;       // 38
+  UINT8   UpperNonCriticalThreshold;    // 39
+  UINT8   LowerNonRecoverThreshold;     // 40
+  UINT8   LowerCriticalThreshold;       // 41
+  UINT8   LowerNonCriticalThreshold;    // 42
+  UINT8   Reserved7[5];                 // 43
+  UINT8   IdStringLength;               // 48
+  UINT8   AsciiIdString[16];            // 49 - 64
+} IPMI_SDR_RECORD_STRUCT_1;
+
+typedef struct {
+  UINT16  RecordId;                     // 1
+  UINT8   Version;                      // 3
+  UINT8   RecordType;                   // 4
+  UINT8   RecordLength;                 // 5
+  UINT8   OwnerId;                      // 6
+  UINT8   OwnerLun;                     // 7
+  UINT8   SensorNumber;                 // 8
+  UINT8   EntityId;                     // 9
+  UINT8   EntityInstance;               // 10
+  UINT8   SensorScanning : 1;           // 11
+  UINT8   EventScanning : 1;            // 11
+  UINT8   InitSensorType : 1;           // 11
+  UINT8   InitHysteresis : 1;           // 11
+  UINT8   InitThresholds : 1;           // 11
+  UINT8   InitEvent : 1;                // 11
+  UINT8   InitScanning : 1;             // 11
+  UINT8   Reserved : 1;                 // 11
+  UINT8   EventMessageControl : 2;      // 12
+  UINT8   ThresholdAccessSupport : 2;   // 12
+  UINT8   HysteresisSupport : 2;        // 12
+  UINT8   ReArmSupport : 1;             // 12
+  UINT8   IgnoreSensor : 1;             // 12
+  UINT8   SensorType;                   // 13
+  UINT8   EventType;                    // 14
+  UINT8   Reserved1[7];                 // 15
+  UINT8   UnitType;                     // 22
+  UINT8   Reserved2[9];                 // 23
+  UINT8   IdStringLength;               // 32
+  UINT8   AsciiIdString[16];            // 33 - 48
+} IPMI_SDR_RECORD_STRUCT_2;
+
+typedef struct {
+  UINT8 Reserved1 : 1;
+  UINT8 ControllerSlaveAddress : 7;
+  UINT8 FruDeviceId;
+  UINT8 BusId : 3;
+  UINT8 Lun : 2;
+  UINT8 Reserved : 2;
+  UINT8 LogicalFruDevice : 1;
+  UINT8 Reserved3 : 4;
+  UINT8 ChannelNumber : 4;
+} IPMI_FRU_DATA_INFO;
+
+typedef struct {
+  UINT16            RecordId;           // 1
+  UINT8             Version;            // 3
+  UINT8             RecordType;         // 4
+  UINT8             RecordLength;       // 5
+  IPMI_FRU_DATA_INFO FruDeviceData;      // 6
+  UINT8             Reserved1;          // 10
+  UINT8             DeviceType;         // 11
+  UINT8             DeviceTypeModifier; // 12
+  UINT8             FruEntityId;        // 13
+  UINT8             FruEntityInstance;  // 14
+  UINT8             OemReserved;        // 15
+  UINT8             Length : 4;         // 16
+  UINT8             Reserved2 : 1;      // 16
+  UINT8             StringType : 3;     // 16
+  UINT8             String[16];         // 17
+} IPMI_SDR_RECORD_STRUCT_11;
+
+typedef struct {
+  UINT16              NextRecordId;       //1
+  UINT16              RecordId;           //3
+  UINT8               Version;            //5
+  UINT8               RecordType;         //6
+  UINT8               RecordLength;       //7
+  UINT8               ManufacturerId[3];  //8
+  UINT8               StringChars[20];
+} IPMI_SDR_RECORD_STRUCT_C0;
+
+typedef struct {
+  UINT16              NextRecordId;       //1
+  UINT16              RecordId;           //3
+  UINT8               Version;            //5
+  UINT8               RecordType;         //6
+  UINT8               RecordLength;       //7
+} IPMI_SDR_RECORD_STRUCT_HEADER;
+
+typedef union {
+  IPMI_SDR_RECORD_STRUCT_1  SensorType1;
+  IPMI_SDR_RECORD_STRUCT_2  SensorType2;
+  IPMI_SDR_RECORD_STRUCT_11 SensorType11;
+  IPMI_SDR_RECORD_STRUCT_C0       SensorTypeC0;
+  IPMI_SDR_RECORD_STRUCT_HEADER   SensorHeader;
+} IPMI_SENSOR_RECORD_STRUCT;
+
+typedef struct {
+  UINT16      ReservationId;
+  UINT16      RecordId;
+  UINT8       RecordOffset;
+  UINT8       BytesToRead;
+} IPMI_GET_SDR;
+
+//
+//  Definitions for Add SDR command
+//
+#define IPMI_STORAGE_ADD_SDR 0x24
+
+//
+//  Constants and Structure definitions for "Add SDR" command to follow here
+//
+
+//
+//  Definitions for Partial Add SDR command
+//
+#define IPMI_STORAGE_PARTIAL_ADD_SDR 0x25
+
+//
+//  Constants and Structure definitions for "Partial Add SDR" command to follow here
+//
+
+//
+//  Definitions for Delete SDR command
+//
+#define IPMI_STORAGE_DELETE_SDR  0x26
+
+//
+//  Constants and Structure definitions for "Delete SDR" command to follow here
+//
+
+//
+//  Definitions for Clear SDR Repository command
+//
+#define IPMI_STORAGE_CLEAR_SDR 0x27
+
+//
+//  Constants and Structure definitions for "Clear SDR Repository" command to follow here
+//
+
+//
+//  Definitions for Get SDR Repository Time command
+//
+#define IPMI_STORAGE_GET_SDR_REPOSITORY_TIME 0x28
+
+//
+//  Constants and Structure definitions for "Get SDR Repository Time" command to follow here
+//
+
+//
+//  Definitions for Set SDR Repository Time command
+//
+#define IPMI_STORAGE_SET_SDR_REPOSITORY_TIME 0x29
+
+//
+//  Constants and Structure definitions for "Set SDR Repository Time" command to follow here
+//
+
+//
+//  Definitions for Enter SDR Repository Update Mode command
+//
+#define IPMI_STORAGE_ENTER_SDR_UPDATE_MODE 0x2A
+
+//
+//  Constants and Structure definitions for "Enter SDR Repository Update Mode" command to follow here
+//
+
+//
+//  Definitions for Exit SDR Repository Update Mode command
+//
+#define IPMI_STORAGE_EXIT_SDR_UPDATE_MODE  0x2B
+
+//
+//  Constants and Structure definitions for "Exit SDR Repository Update Mode" command to follow here
+//
+
+//
+//  Definitions for Run Initialize Agent command
+//
+#define IPMI_STORAGE_RUN_INIT_AGENT  0x2C
+
+//
+//  Constants and Structure definitions for "Run Initialize Agent" command to follow here
+//
+
+//
+//  Below is Definitions for System Event Log(SEL) Commands (Chapter 31)
+//
+
+//
+//  Definitions for Get SEL Info command
+//
+#define IPMI_STORAGE_GET_SEL_INFO  0x40
+
+//
+//  Constants and Structure definitions for "Get SEL Info" command to follow here
+//
+typedef struct {
+  UINT8   Version;              // Version of SEL
+  UINT16  NoOfEntries;          // No of Entries in the SEL
+  UINT16  FreeSpace;            // Free space in Bytes
+  UINT32  RecentAddTimeStamp;   // Most Recent Addition of Time Stamp
+  UINT32  RecentEraseTimeStamp; // Most Recent Erasure of Time Stamp
+  UINT8   OperationSupport;     // Operation Support
+} IPMI_SEL_INFO;
+
+//
+//  Definitions for Get SEL Allocation Info command
+//
+#define IPMI_STORAGE_GET_SEL_ALLOCATION_INFO 0x41
+
+//
+//  Constants and Structure definitions for "Get SEL Allocation Info" command to follow here
+//
+
+//
+//  Definitions for Reserve SEL command
+//
+#define IPMI_STORAGE_RESERVE_SEL 0x42
+
+//
+//  Constants and Structure definitions for "Reserve SEL" command to follow here
+//
+
+//
+//  Definitions for Get SEL Entry command
+//
+#define IPMI_STORAGE_GET_SEL_ENTRY 0x43
+
+//
+//  Constants and Structure definitions for "Get SEL Entry" command to follow here
+//
+#define IPMI_COMPLETE_SEL_RECORD 0xFF
+
+typedef struct {
+  UINT8 ReserveId[2]; // Reservation ID, LS Byte First
+  UINT8 SelRecID[2];  // Sel Record ID, LS Byte First
+  UINT8 Offset;       // Offset Into Record
+  UINT8 BytesToRead;  // Bytes to be Read, 0xFF for entire record
+} IPMI_GET_SEL_ENTRY;
+
+//
+//  Definitions for Add SEL Entry command
+//
+#define IPMI_STORAGE_ADD_SEL_ENTRY 0x44
+
+//
+//  Constants and Structure definitions for "Add SEL Entry" command to follow here
+//
+typedef struct {
+  UINT16  RecordId;
+  UINT8   RecordType;
+  UINT32  TimeStamp;
+  UINT16  GeneratorId;
+  UINT8   EvMRevision;
+  UINT8   SensorType;
+  UINT8   SensorNumber;
+  UINT8   EventDirType;
+  UINT8   OEMEvData1;
+  UINT8   OEMEvData2;
+  UINT8   OEMEvData3;
+} IPMI_SEL_RECORD_DATA;
+
+#define IPMI_SEL_SYSTEM_RECORD                     0x02
+
+#define IPMI_EVM_REVISION                          0x04
+#define IPMI_BIOS_ID                               0x18
+#define IPMI_FORMAT_REV                            0x00
+#define IPMI_FORMAT_REV1                           0x01
+#define IPMI_SOFTWARE_ID                           0x01
+#define IPMI_PLATFORM_VAL_ID                       0x01
+#define IPMI_GENERATOR_ID(i,f)                     ((i << 1) | (f << 1) | IPMI_SOFTWARE_ID)
+
+#define IPMI_SENSOR_TYPE_EVENT_CODE_DISCRETE       0x6F
+
+#define IPMI_OEM_SPECIFIC_DATA                     0x02
+#define IPMI_SENSOR_SPECIFIC_DATA                  0x03
+
+//
+//  Definitions for Partial Add SEL Entry command
+//
+#define IPMI_STORAGE_PARTIAL_ADD_SEL_ENTRY 0x45
+
+//
+//  Constants and Structure definitions for "Partial Add SEL Entry" command to follow here
+//
+
+//
+//  Definitions for Delete SEL Entry command
+//
+#define IPMI_STORAGE_DELETE_SEL_ENTRY  0x46
+
+//
+//  Constants and Structure definitions for "Delete SEL Entry" command to follow here
+//
+typedef struct {
+  UINT8 ReserveId[2];       // Reservation ID, LS byte first
+  UINT8 RecordToDelete[2];  // Record to Delete, LS Byte First
+} IPMI_DELETE_SEL;
+
+//
+//  Definitions for Clear SEL command
+//
+#define IPMI_STORAGE_CLEAR_SEL 0x47
+
+//
+//  Constants and Structure definitions for "Clear SEL" command to follow here
+//
+typedef struct {
+  UINT8 Reserve[2]; // Reserve ID, LSB first
+  UINT8 AscC;       // Ascii for 'C' (0x43)
+  UINT8 AscL;       // Ascii for 'L' (0x4c)
+  UINT8 AscR;       // Ascii for 'R' (0x52)
+  UINT8 Erase;      // 0xAA, Initiate Erase, 0x00 Get Erase Status
+} IPMI_CLEAR_SEL;
+
+//
+//  Definitions for Get SEL Time command
+//
+#define IPMI_STORAGE_GET_SEL_TIME  0x48
+
+//
+//  Constants and Structure definitions for "Get SEL Time" command to follow here
+//
+
+//
+//  Definitions for Set SEL Time command
+//
+#define IPMI_STORAGE_SET_SEL_TIME  0x49
+
+//
+//  Constants and Structure definitions for "Set SEL Time" command to follow here
+//
+
+//
+//  Definitions for Get Auxillary Log Status command
+//
+#define IPMI_STORAGE_GET_AUXILLARY_LOG_STATUS  0x5A
+
+//
+//  Constants and Structure definitions for "Get Auxillary Log Status" command to follow here
+//
+
+//
+//  Definitions for Set Auxillary Log Status command
+//
+#define IPMI_STORAGE_SET_AUXILLARY_LOG_STATUS  0x5B
+
+//
+//  Constants and Structure definitions for "Set Auxillary Log Status" command to follow here
+//
+#pragma pack()
+#endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h b/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h
new file mode 100644
index 000000000000..6fb929721172
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h
@@ -0,0 +1,566 @@
+/** @file
+  IPMI 2.0 definitions from the IPMI Specification Version 2.0, Revision 1.1.
+
+  This file contains all NetFn Transport commands, including:
+    IPM LAN Commands (Chapter 23)
+    IPMI Serial/Modem Commands (Chapter 25)
+    SOL Commands (Chapter 26)
+    Command Forwarding Commands (Chapter 35b)
+
+  See IPMI specification, Appendix G, Command Assignments
+  and Appendix H, Sub-function Assignments.
+
+  Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef _IPMI_NET_FN_TRANSPORT_H_
+#define _IPMI_NET_FN_TRANSPORT_H_
+
+#pragma pack(1)
+//
+// Net function definition for Transport command
+//
+#define IPMI_NETFN_TRANSPORT  0x0C
+
+//
+//  Below is Definitions for IPM LAN Commands (Chapter 23)
+//
+
+//
+//  Definitions for Set Lan Configuration Parameters command
+//
+#define IPMI_TRANSPORT_SET_LAN_CONFIG_PARAMETERS 0x01
+
+//
+//  Constants and Structure definitions for "Set Lan Configuration Parameters" command to follow here
+//
+
+//
+// LAN Management Structure
+//
+typedef enum {
+  IpmiLanReserved1,
+  IpmiLanReserved2,
+  IpmiLanAuthType,
+  IpmiLanIpAddress,
+  IpmiLanIpAddressSource,
+  IpmiLanMacAddress,
+  IpmiLanSubnetMask,
+  IpmiLanIpv4HeaderParam,
+  IpmiLanPrimaryRcmpPort,
+  IpmiLanSecondaryRcmpPort,
+  IpmiLanBmcGeneratedArpCtrl,
+  IpmiLanArpInterval,
+  IpmiLanDefaultGateway,
+  IpmiLanDefaultGatewayMac,
+  IpmiLanBackupGateway,
+  IpmiLanBackupGatewayMac,
+  IpmiLanCommunityString,
+  IpmiLanReserved3,
+  IpmiLanDestinationType,
+  IpmiLanDestinationAddress
+} IPMI_LAN_OPTION_TYPE;
+
+//
+// IP Address Source
+//
+typedef enum {
+  IpmiUnspecified,
+  IpmiStaticAddrsss,
+  IpmiDynamicAddressBmcDhcp,
+  IpmiDynamicAddressBiosDhcp,
+  IpmiDynamicAddressBmcNonDhcp
+} IPMI_IP_ADDRESS_SRC;
+
+//
+// Destination Type
+//
+typedef enum {
+  IpmiPetTrapDestination,
+  IpmiDirectedEventDestination,
+  IpmiReserved1,
+  IpmiReserved2,
+  IpmiReserved3,
+  IpmiReserved4,
+  IpmiReserved5,
+  IpmiOem1,
+  IpmiOem2
+} IPMI_LAN_DEST_TYPE_DEST_TYPE;
+
+typedef struct {
+  UINT8 NoAuth : 1;
+  UINT8 MD2Auth : 1;
+  UINT8 MD5Auth : 1;
+  UINT8 Reserved1 : 1;
+  UINT8 StraightPswd : 1;
+  UINT8 OemType : 1;
+  UINT8 Reserved2 : 2;
+} IPMI_LAN_AUTH_TYPE;
+
+typedef struct {
+  UINT8 IpAddress[4];
+} IPMI_LAN_IP_ADDRESS;
+
+typedef struct {
+  UINT8 AddressSrc : 4;
+  UINT8 Reserved : 4;
+} IPMI_LAN_IP_ADDRESS_SRC;
+
+typedef struct {
+  UINT8 MacAddress[6];
+} IPMI_LAN_MAC_ADDRESS;
+
+typedef struct {
+  UINT8 IpAddress[4];
+} IPMI_LAN_SUBNET_MASK;
+
+typedef struct {
+  UINT8 TimeToLive;
+  UINT8 IpFlag : 3;
+  UINT8 Reserved1 : 5;
+  UINT8 Precedence : 3;
+  UINT8 Reserved2 : 1;
+  UINT8 ServiceType : 4;
+} IPMI_LAN_IPV4_HDR_PARAM;
+
+typedef struct {
+  UINT8 RcmpPortMsb;
+  UINT8 RcmpPortLsb;
+} IPMI_LAN_RCMP_PORT;
+
+typedef struct {
+  UINT8 EnableBmcArpResponse : 1;
+  UINT8 EnableBmcGratuitousArp : 1;
+  UINT8 Reserved : 6;
+} IPMI_LAN_BMC_GENERATED_ARP_CONTROL;
+
+typedef struct {
+  UINT8 ArpInterval;
+} IPMI_LAN_ARP_INTERVAL;
+
+typedef struct {
+  UINT8 Data[18];
+} IPMI_LAN_COMMUNITY_STRING;
+
+typedef struct {
+  UINT8 DestinationSelector : 4;
+  UINT8 Reserved2 : 4;
+  UINT8 DestinationType : 3;
+  UINT8 Reserved1 : 4;
+  UINT8 AlertAcknowledged : 1;
+} IPMI_LAN_DEST_TYPE;
+
+typedef struct {
+  UINT8               DestinationSelector : 4;
+  UINT8               Reserved1 : 4;
+  UINT8               AlertingIpAddressSelector : 4;
+  UINT8               AddressFormat : 4;
+  UINT8               UseDefaultGateway : 1;
+  UINT8               Reserved2 : 7;
+  IPMI_LAN_IP_ADDRESS  AlertingIpAddress;
+  IPMI_LAN_MAC_ADDRESS AlertingMacAddress;
+} IPMI_LAN_DEST_ADDRESS;
+
+typedef union {
+  IPMI_LAN_AUTH_TYPE                 IpmiLanAuthType;
+  IPMI_LAN_IP_ADDRESS                IpmiLanIpAddress;
+  IPMI_LAN_IP_ADDRESS_SRC            IpmiLanIpAddressSrc;
+  IPMI_LAN_MAC_ADDRESS               IpmiLanMacAddress;
+  IPMI_LAN_SUBNET_MASK               IpmiLanSubnetMask;
+  IPMI_LAN_IPV4_HDR_PARAM            IpmiLanIpv4HdrParam;
+  IPMI_LAN_RCMP_PORT                 IpmiLanPrimaryRcmpPort;
+  IPMI_LAN_BMC_GENERATED_ARP_CONTROL IpmiLanArpControl;
+  IPMI_LAN_ARP_INTERVAL              IpmiLanArpInterval;
+  IPMI_LAN_COMMUNITY_STRING          IpmiLanCommunityString;
+  IPMI_LAN_DEST_TYPE                 IpmiLanDestType;
+  IPMI_LAN_DEST_ADDRESS              IpmiLanDestAddress;
+} IPMI_LAN_OPTIONS;
+
+//
+//  Definitions for Get Lan Configuration Parameters command
+//
+#define IPMI_TRANSPORT_GET_LAN_CONFIG_PARAMETERS 0x02
+
+//
+//  Constants and Structure definitions for "Get Lan Configuration Parameters" command to follow here
+//
+
+//
+//  Definitions for Suspend BMC ARPs command
+//
+#define IPMI_TRANSPORT_SUSPEND_BMC_ARPS  0x03
+
+//
+//  Constants and Structure definitions for "Suspend BMC ARPs" command to follow here
+//
+
+//
+//  Definitions for Get IP-UDP-RMCP Statistics command
+//
+#define IPMI_TRANSPORT_GET_PACKET_STATISTICS 0x04
+
+//
+//  Constants and Structure definitions for "Get IP-UDP-RMCP Statistics" command to follow here
+//
+
+//
+//  Below is Definitions for IPMI Serial/Modem Commands (Chapter 25)
+//
+
+//
+//  Definitions for Set Serial/Modem Configuration command
+//
+#define IPMI_TRANSPORT_SET_SERIAL_CONFIGURATION  0x10
+
+//
+//  Constants and Structure definitions for "Set Serial/Modem Configuration" command to follow here
+//
+
+//
+// EMP OPTION DATA
+//
+typedef struct {
+  UINT8 NoAuthentication : 1;
+  UINT8 MD2Authentication : 1;
+  UINT8 MD5Authentication : 1;
+  UINT8 Reserved1 : 1;
+  UINT8 StraightPassword : 1;
+  UINT8 OemProprietary : 1;
+  UINT8 Reservd2 : 2;
+} IPMI_EMP_AUTH_TYPE;
+
+typedef struct {
+  UINT8 EnableBasicMode : 1;
+  UINT8 EnablePPPMode : 1;
+  UINT8 EnableTerminalMode : 1;
+  UINT8 Reserved1 : 2;
+  UINT8 SnoopOsPPPNegotiation : 1;
+  UINT8 Reserved2 : 1;
+  UINT8 DirectConnect : 1;
+} IPMI_EMP_CONNECTION_TYPE;
+
+typedef struct {
+  UINT8 InactivityTimeout : 4;
+  UINT8 Reserved : 4;
+} IPMI_EMP_INACTIVITY_TIMEOUT;
+
+typedef struct {
+  UINT8 IpmiCallback : 1;
+  UINT8 CBCPCallback : 1;
+  UINT8 Reserved1 : 6;
+  UINT8 CbcpEnableNoCallback : 1;
+  UINT8 CbcpEnablePreSpecifiedNumber : 1;
+  UINT8 CbcpEnableUserSpecifiedNumber : 1;
+  UINT8 CbcpEnableCallbackFromList : 1;
+  UINT8 Reserved : 4;
+  UINT8 CallbackDestination1;
+  UINT8 CallbackDestination2;
+  UINT8 CallbackDestination3;
+} IPMI_EMP_CHANNEL_CALLBACK_CONTROL;
+
+typedef struct {
+  UINT8 CloseSessionOnDCDLoss : 1;
+  UINT8 EnableSessionInactivityTimeout : 1;
+  UINT8 Reserved : 6;
+} IPMI_EMP_SESSION_TERMINATION;
+
+typedef struct {
+  UINT8 Reserved1 : 5;
+  UINT8 EnableDtrHangup : 1;
+  UINT8 FlowControl : 2;
+  UINT8 BitRate : 4;
+  UINT8 Reserved2 : 4;
+  UINT8 SaveSetting : 1;
+  UINT8 SetComPort : 1;
+  UINT8 Reserved3 : 6;
+} IPMI_EMP_MESSAGING_COM_SETTING;
+
+typedef struct {
+  UINT8 RingDurationInterval : 6;
+  UINT8 Reserved1 : 2;
+  UINT8 RingDeadTime : 4;
+  UINT8 Reserved : 4;
+} IPMI_EMP_MODEM_RING_TIME;
+
+typedef struct {
+  UINT8 Reserved;
+  UINT8 InitString[48];
+} IPMI_EMP_MODEM_INIT_STRING;
+
+typedef struct {
+  UINT8 EscapeSequence[5];
+} IPMI_EMP_MODEM_ESC_SEQUENCE;
+
+typedef struct {
+  UINT8 HangupSequence[8];
+} IPMI_EMP_MODEM_HANGUP_SEQUENCE;
+
+typedef struct {
+  UINT8 ModelDialCommend[8];
+} IPMI_MODEM_DIALUP_COMMAND;
+
+typedef struct {
+  UINT8 PageBlackoutInterval;
+} IPMI_PAGE_BLACKOUT_INTERVAL;
+
+typedef struct {
+  UINT8 CommunityString[18];
+} IPMI_EMP_COMMUNITY_STRING;
+
+typedef struct {
+  UINT8 Reserved5 : 4;
+  UINT8 DialStringSelector : 4;
+} IPMI_DIAL_PAGE_DESTINATION;
+
+typedef struct {
+  UINT8 TapAccountSelector : 4;
+  UINT8 Reserved : 4;
+} IPMI_TAP_PAGE_DESTINATION;
+
+typedef struct {
+  UINT8 PPPAccountSetSelector;
+  UINT8 DialStringSelector;
+} IPMI_PPP_ALERT_DESTINATION;
+
+typedef union {
+  IPMI_DIAL_PAGE_DESTINATION    DialPageDestination;
+  IPMI_TAP_PAGE_DESTINATION     TapPageDestination;
+  IPMI_PPP_ALERT_DESTINATION    PppAlertDestination;
+} IPMI_DEST_TYPE_SPECIFIC;
+
+typedef struct {
+  UINT8 DestinationSelector : 4;
+  UINT8 Reserved1 : 4;
+  UINT8 DestinationType : 4;
+  UINT8 Reserved2 : 3;
+  UINT8 AlertAckRequired : 1;
+  UINT8 AlertAckTimeoutSeconds;
+  UINT8 NumRetriesCall : 3;
+  UINT8 Reserved3 : 1;
+  UINT8 NumRetryAlert : 3;
+  UINT8 Reserved4 : 1;
+  IPMI_DEST_TYPE_SPECIFIC DestinationTypeSpecific;
+} IPMI_EMP_DESTINATION_INFO;
+
+typedef struct {
+  UINT8 DestinationSelector : 4;
+  UINT8 Reserved1 : 4;
+  UINT8 Parity : 3;
+  UINT8 CharacterSize : 1;
+  UINT8 StopBit : 1;
+  UINT8 DtrHangup : 1;
+  UINT8 FlowControl : 2;
+  UINT8 BitRate : 4;
+  UINT8 Reserved2 : 4;
+  UINT8 SaveSetting : 1;
+  UINT8 SetComPort : 1;
+  UINT8 Reserved3 : 6;
+} IPMI_EMP_DESTINATION_COM_SETTING;
+
+typedef struct {
+  UINT8 DialStringSelector : 4;
+  UINT8 Reserved1 : 4;
+  UINT8 Reserved2;
+  UINT8 DialString[48];
+} IPMI_DESTINATION_DIAL_STRING;
+
+typedef union {
+  UINT32  IpAddressLong;
+  UINT8   IpAddress[4];
+} IPMI_PPP_IP_ADDRESS;
+
+typedef struct {
+  UINT8 IpAddressSelector : 4;
+  UINT8 Reserved1 : 4;
+  IPMI_PPP_IP_ADDRESS PppIpAddress;
+} IPMI_DESTINATION_IP_ADDRESS;
+
+typedef struct {
+  UINT8 TapSelector;
+  UINT8 TapServiceSelector : 4;
+  UINT8 TapDialStringSelector : 4;
+} IPMI_DESTINATION_TAP_ACCOUNT;
+
+typedef struct {
+  UINT8 TapSelector;
+  UINT8 PagerIdString[16];
+} IPMI_TAP_PAGER_ID_STRING;
+
+typedef union {
+  UINT8                              OptionData;
+  IPMI_EMP_AUTH_TYPE                 EmpAuthType;
+  IPMI_EMP_CONNECTION_TYPE           EmpConnectionType;
+  IPMI_EMP_INACTIVITY_TIMEOUT        EmpInactivityTimeout;
+  IPMI_EMP_CHANNEL_CALLBACK_CONTROL  EmpCallbackControl;
+  IPMI_EMP_SESSION_TERMINATION       EmpSessionTermination;
+  IPMI_EMP_MESSAGING_COM_SETTING     EmpMessagingComSetting;
+  IPMI_EMP_MODEM_RING_TIME           EmpModemRingTime;
+  IPMI_EMP_MODEM_INIT_STRING         EmpModemInitString;
+  IPMI_EMP_MODEM_ESC_SEQUENCE        EmpModemEscSequence;
+  IPMI_EMP_MODEM_HANGUP_SEQUENCE     EmpModemHangupSequence;
+  IPMI_MODEM_DIALUP_COMMAND          EmpModemDialupCommand;
+  IPMI_PAGE_BLACKOUT_INTERVAL        EmpPageBlackoutInterval;
+  IPMI_EMP_COMMUNITY_STRING          EmpCommunityString;
+  IPMI_EMP_DESTINATION_INFO          EmpDestinationInfo;
+  IPMI_EMP_DESTINATION_COM_SETTING   EmpDestinationComSetting;
+  UINT8                              CallRetryBusySignalInterval;
+  IPMI_DESTINATION_DIAL_STRING       DestinationDialString;
+  IPMI_DESTINATION_IP_ADDRESS        DestinationIpAddress;
+  IPMI_DESTINATION_TAP_ACCOUNT       DestinationTapAccount;
+  IPMI_TAP_PAGER_ID_STRING           TapPagerIdString;
+} IPMI_EMP_OPTIONS;
+
+//
+//  Definitions for Get Serial/Modem Configuration command
+//
+#define IPMI_TRANSPORT_GET_SERIAL_CONFIGURATION  0x11
+
+//
+//  Constants and Structure definitions for "Get Serial/Modem Configuration" command to follow here
+//
+
+//
+//  Definitions for Set Serial/Modem Mux command
+//
+#define IPMI_TRANSPORT_SET_SERIAL_MUX  0x12
+
+//
+//  Constants and Structure definitions for "Set Serial/Modem Mux" command to follow here
+//
+typedef struct {
+  UINT8 ChannelNo : 4;
+  UINT8 Reserved1 : 4;
+  UINT8 MuxSetting : 4;
+  UINT8 Reserved2 : 4;
+} IPMI_SET_MUX_COMMAND;
+
+typedef struct {
+  UINT8 MuxSetToBmc : 1;
+  UINT8 CommandStatus : 1;
+  UINT8 MessagingSessionActive : 1;
+  UINT8 AlertInProgress : 1;
+  UINT8 Reserved2 : 2;
+  UINT8 MuxToBmcAllowed : 1;
+  UINT8 MuxToSystemBlocked : 1;
+} IPMI_MUX_CONFIG;
+
+//
+//  Definitions for Get TAP Response Code command
+//
+#define IPMI_TRANSPORT_GET_TAP_RESPONSE_CODE 0x13
+
+//
+//  Constants and Structure definitions for "Get TAP Response Code" command to follow here
+//
+
+//
+//  Definitions for Set PPP UDP Proxy Transmit Data command
+//
+#define IPMI_TRANSPORT_SET_PPP_UDP_PROXY_TXDATA  0x14
+
+//
+//  Constants and Structure definitions for "Set PPP UDP Proxy Transmit Data" command to follow here
+//
+
+//
+//  Definitions for Get PPP UDP Proxy Transmit Data command
+//
+#define IPMI_TRANSPORT_GET_PPP_UDP_PROXY_TXDATA  0x15
+
+//
+//  Constants and Structure definitions for "Get PPP UDP Proxy Transmit Data" command to follow here
+//
+
+//
+//  Definitions for Send PPP UDP Proxy Packet command
+//
+#define IPMI_TRANSPORT_SEND_PPP_UDP_PROXY_PACKET 0x16
+
+//
+//  Constants and Structure definitions for "Send PPP UDP Proxy Packet" command to follow here
+//
+
+//
+//  Definitions for Get PPP UDP Proxy Receive Data command
+//
+#define IPMI_TRANSPORT_GET_PPP_UDP_PROXY_RX  0x17
+
+//
+//  Constants and Structure definitions for "Get PPP UDP Proxy Receive Data" command to follow here
+//
+
+//
+//  Definitions for Serial/Modem connection active command
+//
+#define IPMI_TRANSPORT_SERIAL_CONNECTION_ACTIVE  0x18
+
+//
+//  Constants and Structure definitions for "Serial/Modem connection active" command to follow here
+//
+
+//
+//  Definitions for Callback command
+//
+#define IPMI_TRANSPORT_CALLBACK  0x19
+
+//
+//  Constants and Structure definitions for "Callback" command to follow here
+//
+
+//
+//  Definitions for Set user Callback Options command
+//
+#define IPMI_TRANSPORT_SET_USER_CALLBACK_OPTIONS 0x1A
+
+//
+//  Constants and Structure definitions for "Set user Callback Options" command to follow here
+//
+
+//
+//  Definitions for Get user Callback Options command
+//
+#define IPMI_TRANSPORT_GET_USER_CALLBACK_OPTIONS 0x1B
+
+//
+//  Constants and Structure definitions for "Get user Callback Options" command to follow here
+//
+
+//
+//  Below is Definitions for SOL Commands (Chapter 26)
+//
+
+//
+//  Definitions for SOL activating command
+//
+#define IPMI_TRANSPORT_SOL_ACTIVATING  0x20
+
+//
+//  Constants and Structure definitions for "SOL activating" command to follow here
+//
+
+//
+//  Definitions for Set SOL Configuration Parameters command
+//
+#define IPMI_TRANSPORT_SET_SOL_CONFIG_PARAM  0x21
+
+//
+//  Constants and Structure definitions for "Set SOL Configuration Parameters" command to follow here
+//
+
+//
+//  Definitions for Get SOL Configuration Parameters command
+//
+#define IPMI_TRANSPORT_GET_SOL_CONFIG_PARAM  0x22
+
+//
+//  Constants and Structure definitions for "Get SOL Configuration Parameters" command to follow here
+//
+#pragma pack()
+#endif

From 26db317acc4e0c2cc7023f24a8128cd9b86bacf0 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:24:24 +0000
Subject: [PATCH 347/525] MdePkg: Update Ipmi2.0 definitions header file.

Update Ipmi2.0 definitions header files for data structure
name suffix for request/response data and completion code.

(Sync patch r19484 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19493 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Include/IndustryStandard/IpmiNetFnApp.h   | 61 +++++++-------
 .../IndustryStandard/IpmiNetFnChassis.h       | 31 ++++---
 .../IndustryStandard/IpmiNetFnSensorEvent.h   |  2 +-
 .../IndustryStandard/IpmiNetFnStorage.h       | 80 ++++++++++---------
 .../IndustryStandard/IpmiNetFnTransport.h     |  4 +-
 5 files changed, 95 insertions(+), 83 deletions(-)

diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h b/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
index c0865dae41bd..31f9e839ea81 100644
--- a/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnApp.h
@@ -43,6 +43,7 @@
 //  Constants and Structure definitions for "Get Device ID" command to follow here
 //
 typedef struct {
+  UINT8   CompletionCode;
   UINT8   DeviceId;
   UINT8   DeviceRevision : 4;
   UINT8   Reserved : 3;
@@ -62,7 +63,7 @@ typedef struct {
   UINT8   ManufacturerId[3];
   UINT16  ProductId;
   UINT32  AuxFirmwareRevInfo;
-} IPMI_MSG_GET_DEVICE_ID_RSP;
+} IPMI_GET_DEVICE_ID_RESPONSE;
 
 
 //
@@ -89,12 +90,13 @@ typedef struct {
 #define IPMI_APP_GET_SELFTEST_RESULTS  0x4
 
 //
-//  Constants and Structure definitions for "Get Self Results" command to follow here
+//  Constants and Structure definitions for "Get Self Test Results" command to follow here
 //
 typedef struct {
+  UINT8  CompletionCode;
   UINT8  Result;
   UINT8  Param;
-} IPMI_MSG_SELFTEST_RESULT_RSP;
+} IPMI_SELF_TEST_RESULT_RESPONSE;
 
 #define IPMI_APP_SELFTEST_NO_ERROR             0x55
 #define IPMI_APP_SELFTEST_NOT_IMPLEMENTED      0x56
@@ -127,11 +129,11 @@ typedef struct {
 //  Constants and Structure definitions for "Set ACPI Power State" command to follow here
 //
 typedef struct {
-  UINT8 SystemPowerState : 7;
-  UINT8 SystemStateChange : 1;
-  UINT8 DevicePowerState : 7;
-  UINT8 DeviceStateChange : 1;
-} IPMI_ACPI_POWER_STATE;
+  UINT8  AcpiSystemPowerState  : 7;
+  UINT8  AcpiSystemStateChange : 1;
+  UINT8  AcpiDevicePowerState  : 7;
+  UINT8  AcpiDeviceStateChange : 1;
+} IPMI_SET_ACPI_POWER_STATE_REQUEST;
 
 //
 //  Definitions for Get ACPI Power State command
@@ -154,8 +156,9 @@ typedef struct {
 //  Message structure definition for "Get Device Guid" IPMI command
 //
 typedef struct {
-  UINT8 Guid[16];
-} IPMI_MSG_GET_DEVICE_GUID_RSP;
+  UINT8  CompletionCode;
+  UINT8  Guid[16];
+} IPMI_GET_DEVICE_GUID_RESPONSE;
 
 //
 //  Below is Definitions for BMC Watchdog Timer Commands (Chapter 27)
@@ -190,7 +193,7 @@ typedef struct {
   UINT8                           PretimeoutInterval;
   UINT8                           TimerUseExpirationFlagsClear;
   UINT16                          InitialCountdownValue;
-} IPMI_SET_WATCHDOG_TIMER;
+} IPMI_SET_WATCHDOG_TIMER_REQUEST;
 
 //
 //  Definitions for Get WatchDog Timer command
@@ -201,13 +204,14 @@ typedef struct {
 //  Constants and Structure definitions for "Get WatchDog Timer" command to follow here
 //
 typedef struct {
+  UINT8                           CompletionCode;
   IPMI_WATCHDOG_TIMER_USE         TimerUse;
   UINT8                           TimerActions;
   UINT8                           PretimeoutInterval;
   UINT8                           TimerUseExpirationFlagsClear;
   UINT16                          InitialCountdownValue;
   UINT16                          PresentCountdownValue;
-} IPMI_GET_WATCHDOG_TIMER;
+} IPMI_GET_WATCHDOG_TIMER_RESPONSE;
 
 //
 //  Below is Definitions for IPMI Messaging Support Commands (Chapter 22)
@@ -384,20 +388,21 @@ typedef struct {
 //  Constants and Structure definitions for "Get Channel Access" command to follow here
 //
 typedef struct {
-  UINT8 ChannelNo : 4;
-  UINT8 Reserve1 : 4;
-  UINT8 Reserve2 : 6;
-  UINT8 MemoryType : 2;
-} IPMI_GET_CHANNEL_ACCESS_COMMAND;
+  UINT8  ChannelNo : 4;
+  UINT8  Reserve1 : 4;
+  UINT8  Reserve2 : 6;
+  UINT8  MemoryType : 2;
+} IPMI_GET_CHANNEL_ACCESS_REQUEST;
 
 typedef struct {
-  UINT8 AccessMode : 3;
-  UINT8 UserLevelAuthEnabled : 1;
-  UINT8 MessageAuthEnable : 1;
-  UINT8 Alert : 1;
-  UINT8 Reserve1 : 2;
-  UINT8 ChannelPriviledgeLimit : 4;
-  UINT8 Reserve2 : 4;
+  UINT8  CompletionCode;
+  UINT8  AccessMode : 3;
+  UINT8  UserLevelAuthEnabled : 1;
+  UINT8  MessageAuthEnable : 1;
+  UINT8  Alert : 1;
+  UINT8  Reserve1 : 2;
+  UINT8  ChannelPriviledgeLimit : 4;
+  UINT8  Reserve2 : 4;
 } IPMI_GET_CHANNEL_ACCESS_RESPONSE;
 
 //
@@ -409,6 +414,7 @@ typedef struct {
 //  Constants and Structure definitions for "Get Channel Info" command to follow here
 //
 typedef struct {
+  UINT8   CompletionCode;
   UINT8   ChannelNo : 4;
   UINT8   Reserve1 : 4;
   UINT8   ChannelMediumType : 7;
@@ -417,10 +423,9 @@ typedef struct {
   UINT8   Reserve3 : 3;
   UINT8   ActiveSessionCount : 6;
   UINT8   SessionSupport : 2;
-  UINT32  VendorId : 24;
-  UINT16  AuxChannelInfo : 16;
-  UINT8   Dummy;
-} IPMI_CHANNEL_INFO;
+  UINT8   VendorId[3];
+  UINT16  AuxChannelInfo;
+} IPMI_GET_CHANNEL_INFO_RESPONSE;
 
 //
 //  Definitions for Get Channel Info command
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h b/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
index 7bf6cf31010e..b549dc436630 100644
--- a/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnChassis.h
@@ -117,10 +117,11 @@ typedef enum {
 } IPMI_SYSTEM_RESTART_CAUSE;
 
 typedef struct {
-  UINT8   Cause:4;
-  UINT8   Reserved:4;
-  UINT8   ChannelNumber;
-} GET_SYSTEM_RESTART_CAUSE_RESPONSE;
+  UINT8  CompletionCode;
+  UINT8  Cause:4;
+  UINT8  Reserved:4;
+  UINT8  ChannelNumber;
+} IPMI_GET_SYSTEM_RESTART_CAUSE_RESPONSE;
 
 //
 //  Definitions for Set System BOOT options command
@@ -136,10 +137,6 @@ typedef struct {
   UINT8    ParameterData[1];
 } IPMI_SET_BOOT_OPTIONS_REQUEST;
 
-typedef struct {
-  UINT8   CompletionCode:8;
-} IPMI_SET_BOOT_OPTIONS_RESPONSE;
-
 //
 //  Definitions for Get System BOOT options command
 //
@@ -148,6 +145,13 @@ typedef struct {
 //
 //  Constants and Structure definitions for "Get System boot options" command to follow here
 //
+typedef struct {
+  UINT8    ParameterSelector:7;
+  UINT8    Reserved:1;
+  UINT8    SetSelector;
+  UINT8    BlockSelector;
+} IPMI_GET_BOOT_OPTIONS_REQUEST;
+
 typedef struct {
   UINT8 Parameter;
   UINT8 Valid;
@@ -167,12 +171,6 @@ typedef struct {
   UINT8   Reserved[3];
 } IPMI_BOOT_INITIATOR;
 
-typedef struct {
-  UINT8    ParameterSelector;
-  UINT8    SetSelector;
-  UINT8    BlockSelector;
-} IPMI_GET_BOOT_OPTIONS_REQUEST;
-
 //
 // Response Parameters for IPMI Get Boot Options
 //
@@ -259,6 +257,7 @@ typedef union {
 } IPMI_BOOT_OPTIONS_PARAMETERS;
 
 typedef struct {
+  UINT8    CompletionCode;
   UINT8    ParameterVersion:4;
   UINT8    Reserved:4;
   UINT8    ParameterSelector:7;
@@ -269,7 +268,7 @@ typedef struct {
 //
 //  Definitions for Set front panel button enables command
 //
-#define IPMI_CHASSIS_SET_FP_BUTTON_ENABLES 0x0A
+#define IPMI_CHASSIS_SET_FRONT_PANEL_BUTTON_ENABLES 0x0A
 
 typedef struct {
   UINT8    DisablePoweroffButton:1;
@@ -277,7 +276,7 @@ typedef struct {
   UINT8    DisableDiagnosticInterruptButton:1;
   UINT8    DisableStandbyButton:1;
   UINT8    Reserved:4;
-} IPMI_SET_FRONT_PANEL_BUTTON_ENABLES_REQUEST;
+} IPMI_CHASSIS_SET_FRONT_PANEL_BUTTON_ENABLES_REQUEST;
 
 //
 //  Constants and Structure definitions for "Set front panel button enables" command to follow here
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h b/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
index bc3563482678..a3cfad1bcda0 100644
--- a/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnSensorEvent.h
@@ -46,7 +46,7 @@ typedef struct {
   UINT8   OEMEvData1;
   UINT8   OEMEvData2;
   UINT8   OEMEvData3;
-} IPMI_PLATFORM_EVENT_MESSAGE_DATA;
+} IPMI_PLATFORM_EVENT_MESSAGE_DATA_REQUEST;
 
 #pragma pack()
 #endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h b/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
index 45c7d19f14dd..7abcd4a3be4e 100644
--- a/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnStorage.h
@@ -5,6 +5,7 @@
     FRU Inventory Commands (Chapter 34)
     SDR Repository (Chapter 33)
     System Event Log(SEL) Commands (Chapter 31)
+    SEL Record Formats (Chapter 32)
 
   See IPMI specification, Appendix G, Command Assignments
   and Appendix H, Sub-function Assignments.
@@ -89,6 +90,7 @@ typedef struct {
 //  Constants and Structure definitions for "Get SDR Repository Info" command to follow here
 //
 typedef struct {
+  UINT8   CompletionCode;
   UINT8   Version;
   UINT16  RecordCount;
   UINT16  FreeSpace;
@@ -101,7 +103,7 @@ typedef struct {
   UINT8   Reserved : 1;
   UINT8   SdrRepUpdateOp : 2;
   UINT8   Overflow : 1;
-} IPMI_SDR_REPOSITORY_INFO;
+} IPMI_GET_SDR_REPOSITORY_INFO;
 
 //
 //  Definitions for Get SDR Repository Allocateion Info command
@@ -281,7 +283,7 @@ typedef struct {
   UINT16      RecordId;
   UINT8       RecordOffset;
   UINT8       BytesToRead;
-} IPMI_GET_SDR;
+} IPMI_GET_SDR_REQUEST;
 
 //
 //  Definitions for Add SDR command
@@ -377,13 +379,14 @@ typedef struct {
 //  Constants and Structure definitions for "Get SEL Info" command to follow here
 //
 typedef struct {
+  UINT8   CompletionCode;
   UINT8   Version;              // Version of SEL
   UINT16  NoOfEntries;          // No of Entries in the SEL
   UINT16  FreeSpace;            // Free space in Bytes
   UINT32  RecentAddTimeStamp;   // Most Recent Addition of Time Stamp
   UINT32  RecentEraseTimeStamp; // Most Recent Erasure of Time Stamp
   UINT8   OperationSupport;     // Operation Support
-} IPMI_SEL_INFO;
+} IPMI_GET_SEL_INFO_RESPONSE;
 
 //
 //  Definitions for Get SEL Allocation Info command
@@ -411,14 +414,12 @@ typedef struct {
 //
 //  Constants and Structure definitions for "Get SEL Entry" command to follow here
 //
-#define IPMI_COMPLETE_SEL_RECORD 0xFF
-
 typedef struct {
   UINT8 ReserveId[2]; // Reservation ID, LS Byte First
   UINT8 SelRecID[2];  // Sel Record ID, LS Byte First
   UINT8 Offset;       // Offset Into Record
   UINT8 BytesToRead;  // Bytes to be Read, 0xFF for entire record
-} IPMI_GET_SEL_ENTRY;
+} IPMI_GET_SEL_ENTRY_REQUEST;
 
 //
 //  Definitions for Add SEL Entry command
@@ -428,34 +429,6 @@ typedef struct {
 //
 //  Constants and Structure definitions for "Add SEL Entry" command to follow here
 //
-typedef struct {
-  UINT16  RecordId;
-  UINT8   RecordType;
-  UINT32  TimeStamp;
-  UINT16  GeneratorId;
-  UINT8   EvMRevision;
-  UINT8   SensorType;
-  UINT8   SensorNumber;
-  UINT8   EventDirType;
-  UINT8   OEMEvData1;
-  UINT8   OEMEvData2;
-  UINT8   OEMEvData3;
-} IPMI_SEL_RECORD_DATA;
-
-#define IPMI_SEL_SYSTEM_RECORD                     0x02
-
-#define IPMI_EVM_REVISION                          0x04
-#define IPMI_BIOS_ID                               0x18
-#define IPMI_FORMAT_REV                            0x00
-#define IPMI_FORMAT_REV1                           0x01
-#define IPMI_SOFTWARE_ID                           0x01
-#define IPMI_PLATFORM_VAL_ID                       0x01
-#define IPMI_GENERATOR_ID(i,f)                     ((i << 1) | (f << 1) | IPMI_SOFTWARE_ID)
-
-#define IPMI_SENSOR_TYPE_EVENT_CODE_DISCRETE       0x6F
-
-#define IPMI_OEM_SPECIFIC_DATA                     0x02
-#define IPMI_SENSOR_SPECIFIC_DATA                  0x03
 
 //
 //  Definitions for Partial Add SEL Entry command
@@ -477,7 +450,7 @@ typedef struct {
 typedef struct {
   UINT8 ReserveId[2];       // Reservation ID, LS byte first
   UINT8 RecordToDelete[2];  // Record to Delete, LS Byte First
-} IPMI_DELETE_SEL;
+} IPMI_DELETE_SEL_REQUEST;
 
 //
 //  Definitions for Clear SEL command
@@ -493,7 +466,7 @@ typedef struct {
   UINT8 AscL;       // Ascii for 'L' (0x4c)
   UINT8 AscR;       // Ascii for 'R' (0x52)
   UINT8 Erase;      // 0xAA, Initiate Erase, 0x00 Get Erase Status
-} IPMI_CLEAR_SEL;
+} IPMI_CLEAR_SEL_REQUEST;
 
 //
 //  Definitions for Get SEL Time command
@@ -530,5 +503,40 @@ typedef struct {
 //
 //  Constants and Structure definitions for "Set Auxillary Log Status" command to follow here
 //
+
+#define IPMI_COMPLETE_SEL_RECORD 0xFF
+
+//
+//  Below is Definitions for SEL Record Formats (Chapter 32)
+//
+typedef struct {
+  UINT16  RecordId;
+  UINT8   RecordType;
+  UINT32  TimeStamp;
+  UINT16  GeneratorId;
+  UINT8   EvMRevision;
+  UINT8   SensorType;
+  UINT8   SensorNumber;
+  UINT8   EventDirType;
+  UINT8   OEMEvData1;
+  UINT8   OEMEvData2;
+  UINT8   OEMEvData3;
+} IPMI_SEL_EVENT_RECORD_DATA;
+
+#define IPMI_SEL_SYSTEM_RECORD                     0x02
+
+#define IPMI_EVM_REVISION                          0x04
+#define IPMI_BIOS_ID                               0x18
+#define IPMI_FORMAT_REV                            0x00
+#define IPMI_FORMAT_REV1                           0x01
+#define IPMI_SOFTWARE_ID                           0x01
+#define IPMI_PLATFORM_VAL_ID                       0x01
+#define IPMI_GENERATOR_ID(i,f)                     ((i << 1) | (f << 1) | IPMI_SOFTWARE_ID)
+
+#define IPMI_SENSOR_TYPE_EVENT_CODE_DISCRETE       0x6F
+
+#define IPMI_OEM_SPECIFIC_DATA                     0x02
+#define IPMI_SENSOR_SPECIFIC_DATA                  0x03
+
 #pragma pack()
 #endif
diff --git a/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h b/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h
index 6fb929721172..1e9bbe2755a6 100644
--- a/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h
+++ b/MdePkg/Include/IndustryStandard/IpmiNetFnTransport.h
@@ -439,7 +439,7 @@ typedef struct {
   UINT8 Reserved1 : 4;
   UINT8 MuxSetting : 4;
   UINT8 Reserved2 : 4;
-} IPMI_SET_MUX_COMMAND;
+} IPMI_SET_SERIAL_MODEM_MUX_COMMAND_REQUEST;
 
 typedef struct {
   UINT8 MuxSetToBmc : 1;
@@ -449,7 +449,7 @@ typedef struct {
   UINT8 Reserved2 : 2;
   UINT8 MuxToBmcAllowed : 1;
   UINT8 MuxToSystemBlocked : 1;
-} IPMI_MUX_CONFIG;
+} IPMI_SET_SERIAL_MODEM_MUX_COMMAND_RESPONSE;
 
 //
 //  Definitions for Get TAP Response Code command

From 10041d17c71fcd5cbb8c5f9d111f297d85e9cfab Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:25:00 +0000
Subject: [PATCH 348/525] MdeModulePkg: Add IpmiLib and Ppi/Protocol header
 file.

Add IpmiLib and Ppi/Protocol header file. Update dec file
for new IpmiLib and Ppi/Protocol header file.

In V5,change for coding style.

(Sync patch r19485 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19494 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/Include/Library/IpmiLib.h       | 51 ++++++++++++++
 MdeModulePkg/Include/Ppi/IpmiPpi.h           | 65 ++++++++++++++++++
 MdeModulePkg/Include/Protocol/IpmiProtocol.h | 72 ++++++++++++++++++++
 MdeModulePkg/MdeModulePkg.dec                | 11 +++
 4 files changed, 199 insertions(+)
 create mode 100644 MdeModulePkg/Include/Library/IpmiLib.h
 create mode 100644 MdeModulePkg/Include/Ppi/IpmiPpi.h
 create mode 100644 MdeModulePkg/Include/Protocol/IpmiProtocol.h

diff --git a/MdeModulePkg/Include/Library/IpmiLib.h b/MdeModulePkg/Include/Library/IpmiLib.h
new file mode 100644
index 000000000000..71b0c1a5a377
--- /dev/null
+++ b/MdeModulePkg/Include/Library/IpmiLib.h
@@ -0,0 +1,51 @@
+/** @file
+  This library abstract how to access IPMI device via IPMI command.
+
+Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved. <BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _IPMI_LIB_H_
+#define _IPMI_LIB_H_
+
+#include <Uefi.h>
+#include <IndustryStandard/Ipmi.h>
+
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+EFI_STATUS
+EFIAPI
+IpmiSubmitCommand (
+  IN     UINT8     NetFunction,
+  IN     UINT8     Command,
+  IN     UINT8     *RequestData,
+  IN     UINT32    RequestDataSize,
+     OUT UINT8     *ResponseData,
+  IN OUT UINT32    *ResponseDataSize
+  );
+
+#endif
diff --git a/MdeModulePkg/Include/Ppi/IpmiPpi.h b/MdeModulePkg/Include/Ppi/IpmiPpi.h
new file mode 100644
index 000000000000..b8f706342414
--- /dev/null
+++ b/MdeModulePkg/Include/Ppi/IpmiPpi.h
@@ -0,0 +1,65 @@
+/** @file
+  Ppi for Ipmi of SMS.
+
+  Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _IPMI_PPI_H_
+#define _IPMI_PPI_H_
+
+typedef struct _PEI_IPMI_PPI PEI_IPMI_PPI;
+
+#define PEI_IPMI_PPI_GUID \
+  { \
+    0xa9731431, 0xd968, 0x4277, 0xb7, 0x52, 0xa3, 0xa9, 0xa6, 0xae, 0x18, 0x98 \
+  }
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         This              This point for PEI_IPMI_PPI structure.
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *PEI_IPMI_SUBMIT_COMMAND) (
+  IN     PEI_IPMI_PPI                      *This,
+  IN     UINT8                             NetFunction,
+  IN     UINT8                             Command,
+  IN     UINT8                             *RequestData,
+  IN     UINT32                            RequestDataSize,
+     OUT UINT8                             *ResponseData,
+  IN OUT UINT32                            *ResponseDataSize
+  );
+
+//
+// IPMI PPI
+//
+struct _PEI_IPMI_PPI {
+  PEI_IPMI_SUBMIT_COMMAND       IpmiSubmitCommand;
+};
+
+extern EFI_GUID gPeiIpmiPpiGuid;
+
+#endif
diff --git a/MdeModulePkg/Include/Protocol/IpmiProtocol.h b/MdeModulePkg/Include/Protocol/IpmiProtocol.h
new file mode 100644
index 000000000000..a02ca6cb7385
--- /dev/null
+++ b/MdeModulePkg/Include/Protocol/IpmiProtocol.h
@@ -0,0 +1,72 @@
+/** @file
+  Protocol of Ipmi for both SMS and SMM.
+
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _IPMI_PROTOCOL_H_
+#define _IPMI_PROTOCOL_H_
+
+typedef struct _IPMI_PROTOCOL IPMI_PROTOCOL;
+
+#define IPMI_PROTOCOL_GUID \
+  { \
+    0xdbc6381f, 0x5554, 0x4d14, 0x8f, 0xfd, 0x76, 0xd7, 0x87, 0xb8, 0xac, 0xbf \
+  }
+
+#define SMM_IPMI_PROTOCOL_GUID \
+  { \
+    0x5169af60, 0x8c5a, 0x4243, 0xb3, 0xe9, 0x56, 0xc5, 0x6d, 0x18, 0xee, 0x26 \
+  }
+
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         This              This point for IPMI_PROTOCOL structure.
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+typedef
+EFI_STATUS
+(EFIAPI *IPMI_SUBMIT_COMMAND) (
+  IN     IPMI_PROTOCOL                 *This,
+  IN     UINT8                         NetFunction,
+  IN     UINT8                         Command,
+  IN     UINT8                         *RequestData,
+  IN     UINT32                        RequestDataSize,
+     OUT UINT8                         *ResponseData,
+  IN OUT UINT32                        *ResponseDataSize
+  );
+
+//
+// IPMI COMMAND PROTOCOL
+//
+struct _IPMI_PROTOCOL{
+  IPMI_SUBMIT_COMMAND       IpmiSubmitCommand;
+};
+
+extern EFI_GUID gIpmiProtocolGuid;
+extern EFI_GUID gSmmIpmiProtocolGuid;
+
+#endif
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index ea70c7e3dabc..16d60e72d2b2 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -131,6 +131,10 @@
   #
   PlatformVarCleanupLib|Include/Library/PlatformVarCleanupLib.h
 
+  ## @libraryclass  Provides interfaces about Ipmi submit generic commond.
+  #
+  IpmiLib|Include/Library/IpmiLib.h
+
 [Guids]
   ## MdeModule package token space guid
   # Include/Guid/MdeModulePkgTokenSpace.h
@@ -357,6 +361,9 @@
   ## Include/Ppi/UfsHostController.h
   gEdkiiPeiUfsHostControllerPpiGuid  =  { 0xdc54b283, 0x1a77, 0x4cd6, { 0x83, 0xbb, 0xfd, 0xda, 0x46, 0x9a, 0x2e, 0xc6 }}
 
+  ## Include/Ppi/IpmiPpi.h
+  gPeiIpmiPpiGuid               =  { 0xa9731431, 0xd968, 0x4277, { 0xb7, 0x52, 0xa3, 0xa9, 0xa6, 0xae, 0x18, 0x98 }}
+
 [Protocols]
   ## Load File protocol provides capability to load and unload EFI image into memory and execute it.
   #  Include/Protocol/LoadPe32Image.h
@@ -449,6 +456,10 @@
   ## Include/Protocol/SmmReadyToBoot.h
   gEdkiiSmmReadyToBootProtocolGuid = { 0x6e057ecf, 0xfa99, 0x4f39, { 0x95, 0xbc, 0x59, 0xf9, 0x92, 0x1d, 0x17, 0xe4 } }
 
+  ## Include/Protocol/IpmiProtocol.h
+  gIpmiProtocolGuid    = { 0xdbc6381f, 0x5554, 0x4d14, { 0x8f, 0xfd, 0x76, 0xd7, 0x87, 0xb8, 0xac, 0xbf } }
+  gSmmIpmiProtocolGuid = { 0x5169af60, 0x8c5a, 0x4243, { 0xb3, 0xe9, 0x56, 0xc5, 0x6d, 0x18, 0xee, 0x26 } }
+
 #
 # [Error.gEfiMdeModulePkgTokenSpaceGuid]
 #   0x80000001 | Invalid value provided.

From 73cf2334c2df2c8d153f54916f9f189526c8525f Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:25:24 +0000
Subject: [PATCH 349/525] MdeModulePkg: White space clean up for
 MdeModulePkg.dec

White space clean up for MdeModulePkg.dec

(Sync patch r19486 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19495 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dec | 88 +++++++++++++++++------------------
 1 file changed, 44 insertions(+), 44 deletions(-)

diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 16d60e72d2b2..3c2d42fecc8f 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -4,13 +4,13 @@
 # and libraries instances, which are used for those modules.
 #
 # Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
-# This program and the accompanying materials are licensed and made available under 
-# the terms and conditions of the BSD License that accompanies this distribution.  
+# This program and the accompanying materials are licensed and made available under
+# the terms and conditions of the BSD License that accompanies this distribution.
 # The full text of the license may be found at
-# http://opensource.org/licenses/bsd-license.php.                                                                          
-# 
-# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
-# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.  
+# http://opensource.org/licenses/bsd-license.php.
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #
 ##
 
@@ -97,11 +97,11 @@
   ##  @libraryclass  Provide capability to maintain the data integrity cross S3 phase.
   #
   LockBoxLib|Include/Library/LockBoxLib.h
-  
+
   ##  @libraryclass  Provide the CPU exception handler.
   #
   CpuExceptionHandlerLib|Include/Library/CpuExceptionHandlerLib.h
-  
+
   ##  @libraryclass    Provides platform specific display interface.
   #
   CustomizedDisplayLib|Include/Library/CustomizedDisplayLib.h
@@ -202,7 +202,7 @@
   ## Guid is defined for SMM variable module to notify SMM variable wrapper module when variable write service was ready.
   #  Include/Guid/SmmVariableCommon.h
   gSmmVariableWriteGuid  = { 0x93ba1826, 0xdffb, 0x45dd, { 0x82, 0xa7, 0xe7, 0xdc, 0xaa, 0x3b, 0xbd, 0xf3 }}
-  
+
   ## Performance protocol guid that also acts as the performance HOB guid and performance variable GUID
   #  Include/Guid/Performance.h
   gPerformanceProtocolGuid       = { 0x76B6BDFA, 0x2ACD, 0x4462, { 0x9E, 0x3F, 0xCB, 0x58, 0xC9, 0x69, 0xD9, 0x37 } }
@@ -225,14 +225,14 @@
   #  Include/Guid/StatusCodeDataTypeDebug.h
   gEfiStatusCodeDataTypeDebugGuid  = { 0x9A4E9246, 0xD553, 0x11D5, { 0x87, 0xE2, 0x00, 0x06, 0x29, 0x45, 0xC3, 0xB9 }}
 
-  ##  A configuration Table Guid for Load module at fixed address 
+  ##  A configuration Table Guid for Load module at fixed address
   #  Include/Guid/LoadModuleAtFixedAddress.h
   gLoadFixedAddressConfigurationTableGuid  = { 0x2CA88B53,0xD296,0x4080, { 0xA4,0xA5,0xCA,0xD9,0xBA,0xE2,0x4B,0x9 } }
 
   ## GUID used to store the global debug mask value into an EFI Variable
-  # Include/Guid/DebugMask.h  
+  # Include/Guid/DebugMask.h
   gEfiGenericVariableGuid = { 0x59d1c24f, 0x50f1, 0x401a, {0xb1, 0x01, 0xf3, 0x3e, 0x0d, 0xae, 0xd4, 0x43} }
-  
+
   ##  Event for the DXE Core to signal idle events
   #  Include/Guid/EventIdle.h
   gIdleLoopEventGuid  = { 0x3c8d294c, 0x5fc3, 0x4451, { 0xbb, 0x31, 0xc4, 0xc0, 0x32, 0x29, 0x5e, 0x6c } }
@@ -265,7 +265,7 @@
   ## Include/Guid/UsbKeyBoardLayout.h
   gUsbKeyboardLayoutPackageGuid      = { 0xc0f3b43, 0x44de, 0x4907, { 0xb4, 0x78, 0x22, 0x5f, 0x6f, 0x62, 0x89, 0xdc }}
   gUsbKeyboardLayoutKeyGuid          = { 0x3a4d7a7c, 0x18a, 0x4b42, { 0x81, 0xb3, 0xdc, 0x10, 0xe3, 0xb5, 0x91, 0xbd }}
-  
+
   ## Include/Guid/HiiResourceSampleHii.h
   gHiiResourceSamleFormSetGuid       = { 0x4f4ef7f0, 0xaa29, 0x4ce9, { 0xba, 0x41, 0x64, 0x3e, 0x1, 0x23, 0xa9, 0x9f }}
 
@@ -289,7 +289,7 @@
 
   ## Include/Guid/ZeroGuid.h
   gZeroGuid                          = { 0x0, 0x0, 0x0, {0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0}}
-  
+
   ## Include/Guid/MtcVendor.h
   gMtcVendorGuid                     = { 0xeb704011, 0x1402, 0x11d3, { 0x8e, 0x77, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b }}
 
@@ -306,7 +306,7 @@
 
   ## Include/Guid/StatusCodeDataTypeVariable.h
   gEdkiiStatusCodeDataTypeVariableGuid = { 0xf6ee6dbb, 0xd67f, 0x4ea0, { 0x8b, 0x96, 0x6a, 0x71, 0xb1, 0x9d, 0x84, 0xad }}
-  
+
   ## Include/Guid/MemoryProfile.h
   gEdkiiMemoryProfileGuid              = { 0x821c9a09, 0x541a, 0x40f6, { 0x9f, 0x43, 0xa, 0xd1, 0x93, 0xa1, 0x2c, 0xfe }}
 
@@ -323,7 +323,7 @@
 
   ## Include/Guid/HiiBootMaintenanceFormset.h
   gEfiIfrBootMaintenanceGuid      = { 0xb2dedc91, 0xd59f, 0x48d2, { 0x89, 0x8a, 0x12, 0x49, 0xc, 0x74, 0xa4, 0xe0 }}
-  
+
 [Ppis]
   ## Include/Ppi/AtaController.h
   gPeiAtaControllerPpiGuid       = { 0xa45e60d1, 0xc719, 0x44aa, { 0xb0, 0x7a, 0xaa, 0x77, 0x7f, 0x85, 0x90, 0x6d }}
@@ -389,15 +389,15 @@
   ## This protocol provides boot-time service to do fault tolerant write capability for block devices in SMM environment.
   #  Include/Protocol/SmmFaultTolerantWrite.h
   gEfiSmmFaultTolerantWriteProtocolGuid = { 0x3868fc3b, 0x7e45, 0x43a7, { 0x90, 0x6c, 0x4b, 0xa4, 0x7d, 0xe1, 0x75, 0x4d }}
-  
+
   ## This protocol is used to abstract the swap operation of boot block and backup block of boot FV.
   #  Include/Protocol/SwapAddressRange.h
   gEfiSwapAddressRangeProtocolGuid = { 0x1259F60D, 0xB754, 0x468E, { 0xA7, 0x89, 0x4D, 0xB8, 0x5D, 0x55, 0xE8, 0x7E }}
-  
+
   ## This protocol is used to abstract the swap operation of boot block and backup block of boot FV in SMM environment.
   #  Include/Protocol/SmmSwapAddressRange.h
   gEfiSmmSwapAddressRangeProtocolGuid = { 0x67c4f112, 0x3385, 0x4e55, { 0x9c, 0x5b, 0xc0, 0x5b, 0x71, 0x7c, 0x42, 0x28 }}
-  
+
   ## This protocol is intended for use as a means to store data in the EFI SMM environment.
   #  Include/Protocol/SmmVariableProtocol.h
   gEfiSmmVariableProtocolGuid = { 0xed32d533, 0x99e6, 0x4209, { 0x9c, 0xc0, 0x2d, 0x72, 0xcd, 0xd9, 0x98, 0xa7 }}
@@ -417,12 +417,12 @@
   gEfiSmmFirmwareVolumeBlockProtocolGuid = { 0xd326d041, 0xbd31, 0x4c01, { 0xb5, 0xa8, 0x62, 0x8b, 0xe8, 0x7f, 0x6, 0x53 }}
 
   ## This protocol allows the error level mask for DEBUG() macros to be adjusted for DXE Phase modules
-  # Include/Guid/DebugMask.h  
+  # Include/Guid/DebugMask.h
   gEfiDebugMaskProtocolGuid = { 0x4c8a2451, 0xc207, 0x405b, {0x96, 0x94, 0x99, 0xea, 0x13, 0x25, 0x13, 0x41} }
 
   ## Include/Protocol/LockBox.h
   gEfiLockBoxProtocolGuid        = { 0xbd445d79, 0xb7ad, 0x4f04, { 0x9a, 0xd8, 0x29, 0xbd, 0x20, 0x40, 0xeb, 0x3c }}
-  
+
   ## Include/Protocol/FormBrowserEx.h
   gEfiFormBrowserExProtocolGuid = { 0x1f73b18d, 0x4630, 0x43c1, { 0xa1, 0xde, 0x6f, 0x80, 0x85, 0x5d, 0x7d, 0xa4 } }
 
@@ -443,7 +443,7 @@
 
   ## Include/Protocol/UfsHostController.h
   gEdkiiUfsHostControllerProtocolGuid = { 0xebc01af5, 0x7a9, 0x489e, { 0xb7, 0xce, 0xdc, 0x8, 0x9e, 0x45, 0x9b, 0x2f } }
-  
+
   ## Include/Protocol/EsrtManagement.h
   gEsrtManagementProtocolGuid         = { 0xa340c064, 0x723c, 0x4a9c, { 0xa4, 0xdd, 0xd5, 0xb4, 0x7a, 0x26, 0xfb, 0xb0 }}
 
@@ -547,7 +547,7 @@
   #   FALSE - Does not turn off usb legacy support.<BR>
   # @Prompt Turn off USB legacy support.
   gEfiMdeModulePkgTokenSpaceGuid.PcdTurnOffUsbLegacySupport|FALSE|BOOLEAN|0x00010047
-  
+
   ## Indicates if HiiImageProtocol will be installed.
   #  FALSE is for size reduction.<BR><BR>
   #   TRUE  - Installs HiiImageProtocol.<BR>
@@ -857,7 +857,7 @@
   #   FALSE - 16550 serial Tx operations will not be blocked if DSR is not asserted.<BR>
   # @Prompt Enable serial port cable detetion.
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialDetectCable|FALSE|BOOLEAN|0x00020006
-    
+
   ## Base address of 16550 serial port registers in MMIO or I/O space. Default is 0x3F8.
   # @Prompt Base address of serial port registers.
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialRegisterBase|0x03F8|UINT64|0x00020002
@@ -900,7 +900,7 @@
   ## Maximum address that the DXE Core will allocate the EFI_SYSTEM_TABLE_POINTER
   #  structure. The default value for this PCD is 0, which means that the DXE Core
   #  will allocate the buffer from the EFI_SYSTEM_TABLE_POINTER structure on a 4MB
-  #  boundary as close to the top of memory as feasible.  If this PCD is set to a 
+  #  boundary as close to the top of memory as feasible.  If this PCD is set to a
   #  value other than 0, then the DXE Core will first attempt to allocate the
   #  EFI_SYSTEM_TABLE_POINTER structure on a 4MB boundary below the address specified
   #  by this PCD, and if that allocation fails, retry the allocation on a 4MB
@@ -911,11 +911,11 @@
   ## Indicates if to shadow PEIM on S3 boot path after memory is ready.<BR><BR>
   #   TRUE  - Shadow PEIM on S3 boot path after memory is ready.<BR>
   #   FALSE - Not shadow PEIM on S3 boot path after memory is ready.<BR>
-  # @Prompt Shadow Peim On S3 Boot. 
+  # @Prompt Shadow Peim On S3 Boot.
   gEfiMdeModulePkgTokenSpaceGuid.PcdShadowPeimOnS3Boot|FALSE|BOOLEAN|0x30001028
 
   ## Indicates if to shadow PEIM and PeiCore after memory is ready.<BR><BR>
-  #  This PCD is used on other boot path except for S3 boot. 
+  #  This PCD is used on other boot path except for S3 boot.
   #   TRUE  - Shadow PEIM and PeiCore after memory is ready.<BR>
   #   FALSE - Not shadow PEIM after memory is ready.<BR>
   # @Prompt Shadow Peim and PeiCore on boot
@@ -956,19 +956,19 @@
   gEfiMdeModulePkgTokenSpaceGuid.PcdMemoryProfileMemoryType|0x0|UINT64|0x30001042
 
   ## PCI Serial Device Info. It is an array of Device, Function, and Power Management
-  #  information that describes the path that contains zero or more PCI to PCI briges 
-  #  followed by a PCI serial device.  Each array entry is 4-bytes in length.  The 
-  #  first byte is the PCI Device Number, then second byte is the PCI Function Number, 
-  #  and the last two bytes are the offset to the PCI power management capabilities 
-  #  register used to manage the D0-D3 states.  If a PCI power management capabilities 
-  #  register is not present, then the last two bytes in the offset is set to 0.  The 
-  #  array is terminated by an array entry with a PCI Device Number of 0xFF.  For a 
+  #  information that describes the path that contains zero or more PCI to PCI briges
+  #  followed by a PCI serial device.  Each array entry is 4-bytes in length.  The
+  #  first byte is the PCI Device Number, then second byte is the PCI Function Number,
+  #  and the last two bytes are the offset to the PCI power management capabilities
+  #  register used to manage the D0-D3 states.  If a PCI power management capabilities
+  #  register is not present, then the last two bytes in the offset is set to 0.  The
+  #  array is terminated by an array entry with a PCI Device Number of 0xFF.  For a
   #  non-PCI fixed address serial device, such as an ISA serial device, the value is 0xFF.
   # @Prompt Pci Serial Device Info
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialPciDeviceInfo|{0xFF}|VOID*|0x00010067
 
   ## PCI Serial Parameters. It is an array of VendorID, DeviceID, ClockRate, Offset,
-  #  BarIndex, RegisterStride, ReceiveFifoDepth, TransmitFifoDepth information that 
+  #  BarIndex, RegisterStride, ReceiveFifoDepth, TransmitFifoDepth information that
   #  describes the parameters of special PCI serial devices.
   #  Each array entry is 24-byte in length. The array is terminated
   #  by an array entry with a PCI Vendor ID of 0xFFFF. If a platform only contains a
@@ -999,10 +999,10 @@
   # @Prompt Pci Serial Parameters
   gEfiMdeModulePkgTokenSpaceGuid.PcdPciSerialParameters|{0xFF, 0xFF}|VOID*|0x00010071
 
-  ## Serial Port Extended Transmit FIFO Size.  The default is 64 bytes. 
+  ## Serial Port Extended Transmit FIFO Size.  The default is 64 bytes.
   # @Prompt Serial Port Extended Transmit FIFO Size in Bytes
   gEfiMdeModulePkgTokenSpaceGuid.PcdSerialExtendedTxFifoSize|64|UINT32|0x00010068
-  
+
   ## This PCD points to the file name GUID of the BootManagerMenuApp
   #  Platform can customize the PCD to point to different application for Boot Manager Menu
   # @Prompt Boot Manager Menu File
@@ -1199,7 +1199,7 @@
   # @Prompt Foreground color for browser subtile.
   # @ValidRange 0x80000004 | 0x00 - 0x0F
   gEfiMdeModulePkgTokenSpaceGuid.PcdBrowserSubtitleTextColor|0x01|UINT8|0x00010057
-  
+
   ## Specify the foreground color for prompt and Question value text in HII Form Browser. The default value is EFI_BLACK.
   #  Only following values defined in UEFI specification are valid:<BR><BR>
   #  0x00 (EFI_BLACK)<BR>
@@ -1221,7 +1221,7 @@
   # @Prompt Foreground color for browser field.
   # @ValidRange 0x80000004 | 0x00 - 0x0F
   gEfiMdeModulePkgTokenSpaceGuid.PcdBrowserFieldTextColor|0x00|UINT8|0x00010058
-  
+
   ## Specify the foreground color for highlighted prompt and Question value text in HII Form Browser.
   #  The default value is EFI_LIGHTGRAY. Only following values defined in UEFI specification are valid:<BR><BR>
   #  0x00 (EFI_BLACK)<BR>
@@ -1243,7 +1243,7 @@
   # @Prompt Foreground color for highlighted browser field.
   # @ValidRange 0x80000004 | 0x00 - 0x0F
   gEfiMdeModulePkgTokenSpaceGuid.PcdBrowserFieldTextHighlightColor|0x07|UINT8|0x00010059
-  
+
   ## Specify the background color for highlighted prompt and Question value text in HII Form Browser.
   #  The default value is EFI_BACKGROUND_BLACK. Only following values defined in UEFI specification are valid:<BR><BR>
   #  0x00 (EFI_BACKGROUND_BLACK)<BR>
@@ -1443,21 +1443,21 @@
   # @Prompt LMFA PEI code page number.
   # @ValidList  0x80000001 | 0
   gEfiMdeModulePkgTokenSpaceGuid.PcdLoadFixAddressPeiCodePageNumber|0|UINT32|0x00000029
-  
+
   ## Specify memory size with page number for DXE boot time code when
   #  Loading Module at Fixed Address feature is enabled.
   #  The value will be set by the build tool.
   # @Prompt LMFA DXE boot code page number.
   # @ValidList  0x80000001 | 0
   gEfiMdeModulePkgTokenSpaceGuid.PcdLoadFixAddressBootTimeCodePageNumber|0|UINT32|0x0000002a
-  
+
   ## Specify memory size with page number for DXE runtime code when
   #  Loading Module at Fixed Address feature is enabled.
   #  The value will be set by the build tool.
   # @Prompt LMFA DXE runtime code page number.
   # @ValidList  0x80000001 | 0
   gEfiMdeModulePkgTokenSpaceGuid.PcdLoadFixAddressRuntimeCodePageNumber|0|UINT32|0x0000002b
- 
+
   ## Specify memory size with page number for SMM code when
   #  Loading Module at Fixed Address feature is enabled.
   #  The value will be set by the build tool.
@@ -1482,7 +1482,7 @@
   # @ValidList  0x80000001 | 0x0
   gEfiMdeModulePkgTokenSpaceGuid.PcdS3BootScriptTablePrivateSmmDataPtr|0x0|UINT64|0x00030001
 
-  ## This dynamic PCD hold an address to point to the memory of page table. The page table establishes a 1:1 
+  ## This dynamic PCD hold an address to point to the memory of page table. The page table establishes a 1:1
   #  Virtual to Physical mapping according to the processor physical address bits.
   # @Prompt Identify Mapping Page Table pointer.
   # @ValidList  0x80000001 | 0x0

From d826359d7fde1d969f4902cf3c7c363008f945ab Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:25:52 +0000
Subject: [PATCH 350/525] MdeModulePkg: Add BaseIpmiLib Null Library Instance.

Add BaseIpmiLib Null Library Instance for BMC-LESS
platform.

In V5, change for coding style.

(Sync patch r19487 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19496 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/BaseIpmiLibNull/BaseIpmiLibNull.c | 53 +++++++++++++++++++
 .../BaseIpmiLibNull/BaseIpmiLibNull.inf       | 38 +++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.c
 create mode 100644 MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.inf

diff --git a/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.c b/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.c
new file mode 100644
index 000000000000..a7db3f13f80b
--- /dev/null
+++ b/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.c
@@ -0,0 +1,53 @@
+/** @file
+  A emptry template implementation of Ipmi Library.
+
+  Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/IpmiLib.h>
+
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+EFI_STATUS
+EFIAPI
+IpmiSubmitCommand (
+  IN     UINT8     NetFunction,
+  IN     UINT8     Command,
+  IN     UINT8     *RequestData,
+  IN     UINT32    RequestDataSize,
+     OUT UINT8     *ResponseData,
+  IN OUT UINT32    *ResponseDataSize
+  )
+{
+  //
+  // Do nothing, just return EFI_UNSUPPORTED.
+  //
+  return EFI_UNSUPPORTED;
+}
diff --git a/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.inf b/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.inf
new file mode 100644
index 000000000000..fc9d06d24b78
--- /dev/null
+++ b/MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.inf
@@ -0,0 +1,38 @@
+## @file
+#  Null Instance of IPMI Library.
+#
+#  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                   = 0x00010005
+  BASE_NAME                     = BaseIpmiLibNull
+  FILE_GUID                     = 46805D61-0BB8-4680-A9BE-C96C751AB5A4
+  MODULE_TYPE                   = BASE
+  VERSION_STRING                = 1.0
+  LIBRARY_CLASS                 = IpmiLib
+
+#
+#  VALID_ARCHITECTURES          = IA32 X64
+#
+
+[Sources]
+  BaseIpmiLibNull.c
+
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  DebugLib

From e1c6340b5cde32b46651b2ab50fc96c28747d724 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:26:18 +0000
Subject: [PATCH 351/525] MdeModulePkg: Add PeiIpmiLibIpmiPpi Library Instance.

Add PeiIpmiLibIpmiPpi Library Instance based on Ipmi Ppi.

In V5, change for code style.

(Sync patch r19488 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19497 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.c     | 81 +++++++++++++++++++
 .../PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf   | 41 ++++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.c
 create mode 100644 MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf

diff --git a/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.c b/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.c
new file mode 100644
index 000000000000..cb6a007360d8
--- /dev/null
+++ b/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.c
@@ -0,0 +1,81 @@
+/** @file
+  Implementation of Ipmi Library in PEI Phase for SMS.
+
+  Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiPei.h>
+#include <Ppi/IpmiPpi.h>
+#include <Library/IpmiLib.h>
+#include <Library/PeiServicesLib.h>
+#include <Library/DebugLib.h>
+
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+EFI_STATUS
+EFIAPI
+IpmiSubmitCommand (
+  IN     UINT8     NetFunction,
+  IN     UINT8     Command,
+  IN     UINT8     *RequestData,
+  IN     UINT32    RequestDataSize,
+     OUT UINT8     *ResponseData,
+  IN OUT UINT32    *ResponseDataSize
+  )
+{
+  EFI_STATUS   Status;
+  PEI_IPMI_PPI *IpmiPpi;
+
+  Status = PeiServicesLocatePpi(
+            &gPeiIpmiPpiGuid,
+            0,
+            NULL,
+            (VOID **) &IpmiPpi
+            );
+  if (EFI_ERROR (Status)) {
+    //
+    // Ipmi Ppi is not installed. So, IPMI device is not present.
+    //
+    DEBUG ((EFI_D_ERROR, "IpmiSubmitCommand in Pei Phase under SMS Status - %r\n", Status));
+    return EFI_NOT_FOUND;
+  }
+
+  Status = IpmiPpi->IpmiSubmitCommand (
+                            IpmiPpi,
+                            NetFunction,
+                            Command,
+                            RequestData,
+                            RequestDataSize,
+                            ResponseData,
+                            ResponseDataSize
+                            );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return EFI_SUCCESS;
+}
diff --git a/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf b/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf
new file mode 100644
index 000000000000..e2e2646f919f
--- /dev/null
+++ b/MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf
@@ -0,0 +1,41 @@
+## @file
+#  Instance of IPMI Library in PEI phase for SMS.
+#
+#  Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PeiIpmiLibIpmiPpi
+  FILE_GUID                      = 43679142-87C4-44AD-AF02-B47F782D6CF3
+  MODULE_TYPE                    = PEIM
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = IpmiLib|PEIM PEI_CORE
+
+#
+#  VALID_ARCHITECTURES          = IA32 X64
+#
+
+[Sources]
+  PeiIpmiLibIpmiPpi.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  DebugLib
+  BaseMemoryLib
+  PeiServicesLib
+
+[Ppis]
+  gPeiIpmiPpiGuid      ## SOMETIMES_CONSUMES

From e559d691916cc405c380a1a3be08d4a9d3a2da94 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:26:45 +0000
Subject: [PATCH 352/525] MdeModulePkg: Add DxeIpmiLibIpmiProtocol Library
 Instance.

Add DxeIpmiLibIpmiProtocol Library Instance based on
Ipmi Protocol in DXE phase.

In V5,change for coding style.

(Sync patch r19489 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19498 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../DxeIpmiLibIpmiProtocol.c                  | 81 +++++++++++++++++++
 .../DxeIpmiLibIpmiProtocol.inf                | 40 +++++++++
 2 files changed, 121 insertions(+)
 create mode 100644 MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.c
 create mode 100644 MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.inf

diff --git a/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.c b/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.c
new file mode 100644
index 000000000000..d15c6bd5618e
--- /dev/null
+++ b/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.c
@@ -0,0 +1,81 @@
+/** @file
+  Implementation of Ipmi Library in DXE Phase for SMS.
+
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiDxe.h>
+#include <Protocol/IpmiProtocol.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DebugLib.h>
+
+IPMI_PROTOCOL *mIpmiProtocol = NULL;
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+EFI_STATUS
+EFIAPI
+IpmiSubmitCommand (
+  IN     UINT8     NetFunction,
+  IN     UINT8     Command,
+  IN     UINT8     *RequestData,
+  IN     UINT32    RequestDataSize,
+     OUT UINT8     *ResponseData,
+  IN OUT UINT32    *ResponseDataSize
+  )
+{
+  EFI_STATUS  Status;
+
+  if (mIpmiProtocol == NULL) {
+    Status = gBS->LocateProtocol (
+              &gIpmiProtocolGuid,
+              NULL,
+              (VOID **) &mIpmiProtocol
+              );
+    if (EFI_ERROR (Status)) {
+      //
+      // Dxe Ipmi Protocol is not installed. So, IPMI device is not present.
+      //
+      DEBUG ((EFI_D_ERROR, "IpmiSubmitCommand in Dxe Phase under SMS Status - %r\n", Status));
+      return EFI_NOT_FOUND;
+    }
+  }
+
+  Status = mIpmiProtocol->IpmiSubmitCommand (
+                            mIpmiProtocol,
+                            NetFunction,
+                            Command,
+                            RequestData,
+                            RequestDataSize,
+                            ResponseData,
+                            ResponseDataSize
+                            );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return EFI_SUCCESS;
+}
diff --git a/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.inf b/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.inf
new file mode 100644
index 000000000000..5b56b39656ed
--- /dev/null
+++ b/MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.inf
@@ -0,0 +1,40 @@
+## @file
+#  Instance of IPMI Library in DXE phase for SMS.
+#
+#  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = DxeIpmiLibIpmiProtocol
+  FILE_GUID                      = 62408AD5-4EAC-432B-AB9B-C4B85BFAED02
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = IpmiLib|DXE_RUNTIME_DRIVER DXE_DRIVER DXE_CORE UEFI_DRIVER UEFI_APPLICATION
+
+#
+#  VALID_ARCHITECTURES          = IA32 X64
+#
+
+[Sources]
+  DxeIpmiLibIpmiProtocol.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  UefiBootServicesTableLib
+  DebugLib
+
+[Protocols]
+  gIpmiProtocolGuid      ## SOMETIMES_CONSUMES

From eb9ecf95c288b5de52085515a831b3a04fed4088 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:27:16 +0000
Subject: [PATCH 353/525] MdeModulePkg: Add SmmIpmiLibSmmIpmiProtocol Library
 Instance.

Add SmmIpmiLibSmmIpmiProtocol Library Instance based on
Ipmi smm protocol in SMM mode.

In V5, change for code style.

(Sync patch r19490 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19499 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../SmmIpmiLibSmmIpmiProtocol.c               | 82 +++++++++++++++++++
 .../SmmIpmiLibSmmIpmiProtocol.inf             | 40 +++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.c
 create mode 100644 MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.inf

diff --git a/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.c b/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.c
new file mode 100644
index 000000000000..70d12a21386c
--- /dev/null
+++ b/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.c
@@ -0,0 +1,82 @@
+/** @file
+  Implementation of Ipmi Library for SMM.
+
+  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiSmm.h>
+#include <Protocol/IpmiProtocol.h>
+#include <Library/IpmiLib.h>
+#include <Library/SmmServicesTableLib.h>
+#include <Library/DebugLib.h>
+
+IPMI_PROTOCOL *mIpmiProtocol = NULL;
+
+/**
+  This service enables submitting commands via Ipmi.
+
+  @param[in]         NetFunction       Net function of the command.
+  @param[in]         Command           IPMI Command.
+  @param[in]         RequestData       Command Request Data.
+  @param[in]         RequestDataSize   Size of Command Request Data.
+  @param[out]        ResponseData      Command Response Data. The completion code is the first byte of response data.
+  @param[in, out]    ResponseDataSize  Size of Command Response Data.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully submit to the device and a response was successfully received.
+  @retval EFI_NOT_FOUND          The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_NOT_READY          Ipmi Device is not ready for Ipmi command access.
+  @retval EFI_DEVICE_ERROR       Ipmi Device hardware error.
+  @retval EFI_TIMEOUT            The command time out.
+  @retval EFI_UNSUPPORTED        The command was not successfully sent to the device.
+  @retval EFI_OUT_OF_RESOURCES   The resource allcation is out of resource or data size error.
+**/
+EFI_STATUS
+EFIAPI
+IpmiSubmitCommand (
+  IN     UINT8     NetFunction,
+  IN     UINT8     Command,
+  IN     UINT8     *RequestData,
+  IN     UINT32    RequestDataSize,
+     OUT UINT8     *ResponseData,
+  IN OUT UINT32    *ResponseDataSize
+  )
+{
+  EFI_STATUS  Status;
+
+  if (mIpmiProtocol == NULL) {
+    Status = gSmst->SmmLocateProtocol (
+                  &gSmmIpmiProtocolGuid,
+                  NULL,
+                  (VOID **) &mIpmiProtocol
+                  );
+    if (EFI_ERROR (Status)) {
+      //
+      // Smm Ipmi Protocol is not installed. So, IPMI device is not present.
+      //
+      DEBUG ((EFI_D_ERROR, "IpmiSubmitCommand for SMM Status - %r\n", Status));
+      return EFI_NOT_FOUND;
+    }
+  }
+
+  Status = mIpmiProtocol->IpmiSubmitCommand (
+                            mIpmiProtocol,
+                            NetFunction,
+                            Command,
+                            RequestData,
+                            RequestDataSize,
+                            ResponseData,
+                            ResponseDataSize
+                            );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return EFI_SUCCESS;
+}
diff --git a/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.inf b/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.inf
new file mode 100644
index 000000000000..f13e5a433b7c
--- /dev/null
+++ b/MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.inf
@@ -0,0 +1,40 @@
+## @file
+#  Instance of SMM IPMI Library.
+#
+#  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = SmmIpmiLibSmmIpmiProtocol
+  FILE_GUID                      = B422FB70-E835-448D-A921-EBA460E105B6
+  MODULE_TYPE                    = DXE_SMM_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = IpmiLib|DXE_SMM_DRIVER SMM_CORE
+
+#
+#  VALID_ARCHITECTURES          = IA32 X64
+#
+
+[Sources]
+  SmmIpmiLibSmmIpmiProtocol.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  DebugLib
+  SmmServicesTableLib
+
+[Protocols]
+  gSmmIpmiProtocolGuid      ## SOMETIMES_CONSUMES

From afa2e481bd0c91f5079c90797474458f97bd6250 Mon Sep 17 00:00:00 2001
From: Daocheng Bu <daocheng.bu@intel.com>
Date: Wed, 23 Dec 2015 12:27:37 +0000
Subject: [PATCH 354/525] MdeModulePkg: Update MdeModulePkg.dsc file for
 IpmiLib.

Update MdeModulePkg.dsc file to include Ipmi Libraries.

(Sync patch r19491 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Daocheng Bu <daocheng.bu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19500 6f19259b-4bc3-4df7-8a09-765794883524
---
 MdeModulePkg/MdeModulePkg.dsc | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index d8d8885f167d..562abe8d7223 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -284,6 +284,10 @@
   MdeModulePkg/Library/VarCheckHiiLib/VarCheckHiiLib.inf
   MdeModulePkg/Library/VarCheckPcdLib/VarCheckPcdLib.inf
   MdeModulePkg/Library/PlatformVarCleanupLib/PlatformVarCleanupLib.inf
+  MdeModulePkg/Library/BaseIpmiLibNull/BaseIpmiLibNull.inf
+  MdeModulePkg/Library/DxeIpmiLibIpmiProtocol/DxeIpmiLibIpmiProtocol.inf
+  MdeModulePkg/Library/PeiIpmiLibIpmiPpi/PeiIpmiLibIpmiPpi.inf
+  MdeModulePkg/Library/SmmIpmiLibSmmIpmiProtocol/SmmIpmiLibSmmIpmiProtocol.inf
 
   MdeModulePkg/Universal/BdsDxe/BdsDxe.inf
   MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenuApp.inf

From 4800ebb9aeafadbe5ba145fda7df245ccc600fe5 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 24 Dec 2015 00:57:18 +0000
Subject: [PATCH 355/525] UefiCpuPkg/PiSmmCpuDxeSmm: Correct CPUID leaf used to
 detect SMM mode

Use Bit 29 of CPUID leaf CPUID_EXTENDED_CPU_SIG (0x80000001) to
determine the SMM save state mode.  The previous version of this
code used CPUID leaf CPUID_VERSION_INFO (0x00000001).

(Sync patch r19503 from main trunk.)

Cc: Jeff Fan <jeff.fan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19505 6f19259b-4bc3-4df7-8a09-765794883524
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index 532ac0974b7d..684dbd701d6c 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -910,13 +910,18 @@ PiCpuSmmEntry (
   //
   // Retrieve CPU Family
   //
-  AsmCpuid (CPUID_VERSION_INFO, &RegEax, NULL, NULL, &RegEdx);
+  AsmCpuid (CPUID_VERSION_INFO, &RegEax, NULL, NULL, NULL);
   FamilyId = (RegEax >> 8) & 0xf;
   ModelId = (RegEax >> 4) & 0xf;
   if (FamilyId == 0x06 || FamilyId == 0x0f) {
     ModelId = ModelId | ((RegEax >> 12) & 0xf0);
   }
 
+  RegEdx = 0;
+  AsmCpuid (CPUID_EXTENDED_FUNCTION, &RegEax, NULL, NULL, NULL);
+  if (RegEax >= CPUID_EXTENDED_CPU_SIG) {
+    AsmCpuid (CPUID_EXTENDED_CPU_SIG, NULL, NULL, NULL, &RegEdx);
+  }
   //
   // Determine the mode of the CPU at the time an SMI occurs
   //   Intel(R) 64 and IA-32 Architectures Software Developer's Manual

From f8ab19a63afab7d791e6a9ab04b12f06da24172f Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 24 Dec 2015 06:47:42 +0000
Subject: [PATCH 356/525] PcAtChipsetPkg/PcRtc: Add assertion to pass static
 code checker

(Sync patch r19514 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Shumin Qiu <Shumin.Qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19516 6f19259b-4bc3-4df7-8a09-765794883524
---
 PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
index e122ae16990a..bf221768c8e7 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcRtc.c
@@ -1277,6 +1277,8 @@ PcRtcAcpiTableChangeCallback (
     return;
   }
 
+  ASSERT (Rsdp != NULL);
+
   //
   // Find FADT in XSDT
   //

From c88b7d63a800b53db8a6d6a3dd659c7d86e8e452 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 24 Dec 2015 06:48:07 +0000
Subject: [PATCH 357/525] PcAtChipsetPkg/PcRtc: Modify INF file content to
 follow INF spec

(Sync patch r19515 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Shumin Qiu <Shumin.Qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19517 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../PcatRealTimeClockRuntimeDxe.inf                           | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
index 94596cef7845..8b992d07b855 100644
--- a/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
+++ b/PcAtChipsetPkg/PcatRealTimeClockRuntimeDxe/PcatRealTimeClockRuntimeDxe.inf
@@ -58,8 +58,8 @@
   gEfiRealTimeClockArchProtocolGuid             ## PRODUCES
 
 [Guids]
-  gEfiAcpi10TableGuid                           ## CONSUMES
-  gEfiAcpiTableGuid                             ## CONSUMES
+  gEfiAcpi10TableGuid                           ## CONSUMES ## Event
+  gEfiAcpiTableGuid                             ## CONSUMES ## Event
 
 [Depex]
   gEfiVariableArchProtocolGuid AND gEfiVariableWriteArchProtocolGuid

From 906952ec699878ea73ad3f6611b1d59fea087a8a Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 24 Dec 2015 07:01:07 +0000
Subject: [PATCH 358/525] Remove some empty directories.

(Sync patch r19518 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>



git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19519 6f19259b-4bc3-4df7-8a09-765794883524

From 74670513bdac1d3200c086f22286d0976df72b8a Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:08:54 +0000
Subject: [PATCH 359/525] ShellPkg: Fix memory leak in SimpleTextOutput on
 file.

Free 'SimpleTextOut->Mode' buffer before 'SimpleTextOut' is free.

(Sync patch r19480 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19530 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ConsoleWrappers.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Application/Shell/ConsoleWrappers.c b/ShellPkg/Application/Shell/ConsoleWrappers.c
index 04a7513a3346..46af141eba99 100644
--- a/ShellPkg/Application/Shell/ConsoleWrappers.c
+++ b/ShellPkg/Application/Shell/ConsoleWrappers.c
@@ -484,7 +484,8 @@ CreateSimpleTextOutOnFile(
     *HandleLocation = ProtocolToReturn->TheHandle;
     return ((EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL*)ProtocolToReturn);
   } else {
-    FreePool(ProtocolToReturn);
+    SHELL_FREE_NON_NULL(ProtocolToReturn->SimpleTextOut.Mode);
+    SHELL_FREE_NON_NULL(ProtocolToReturn);
     return (NULL);
   }
 }
@@ -511,6 +512,7 @@ CloseSimpleTextOutOnFile(
     ((SHELL_EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL*)SimpleTextOut)->TheHandle, 
     &gEfiSimpleTextOutProtocolGuid, 
     &(((SHELL_EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL*)SimpleTextOut)->SimpleTextOut));
+  FreePool(SimpleTextOut->Mode);
   FreePool(SimpleTextOut);
   return (Status);
 }

From 7e1448f90cd4c087b83afb06b3bc6b170d4070fe Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:09:27 +0000
Subject: [PATCH 360/525] ShellPkg: Fix memory leak in ShellProtocol.

1. Close unused file handle.
2. Free the local allocated buffer function returned.

(Sync patch r19481 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19531 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index def3bd35c208..2ddb64d8c7d6 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -1361,6 +1361,7 @@ EfiShellDeleteFileByName(
   //
   // now delete the file
   //
+  ShellFileHandleRemove(FileHandle);
   return (ShellInfoObject.NewEfiShellProtocol->DeleteFile(FileHandle));
 }
 
@@ -2338,6 +2339,8 @@ ShellSearchHandle(
               // recurse with the next part of the pattern
               //
               Status = ShellSearchHandle(NextFilePatternStart, UnicodeCollation, ShellInfoNode->Handle, FileList, ShellInfoNode, MapName);
+              EfiShellClose(ShellInfoNode->Handle);
+              ShellInfoNode->Handle = NULL;
             }
           } else if (!EFI_ERROR(Status)) {
             //
@@ -2456,6 +2459,7 @@ EfiShellFindFiles(
             ; PatternCurrentLocation++);
         PatternCurrentLocation++;
         Status = ShellSearchHandle(PatternCurrentLocation, gUnicodeCollation, RootFileHandle, FileList, NULL, MapName);
+        EfiShellClose(RootFileHandle);
       }
       FreePool(RootDevicePath);
     }
@@ -3260,6 +3264,7 @@ EfiShellGetAlias(
 
     if (Volatile == NULL) {
       GetVariable2 (AliasLower, &gShellAliasGuid, (VOID **)&AliasVal, NULL);
+      FreePool(AliasLower);
       return (AddBufferToFreeList(AliasVal));
     }
     RetSize = 0;
@@ -3273,6 +3278,7 @@ EfiShellGetAlias(
       if (RetVal != NULL) {
         FreePool(RetVal);
       }
+      FreePool(AliasLower);
       return (NULL);
     }
     if ((EFI_VARIABLE_NON_VOLATILE & Attribs) == EFI_VARIABLE_NON_VOLATILE) {

From a32e66b2a9fdc4129ccf8c508b1d6cc156e0d8b6 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:09:49 +0000
Subject: [PATCH 361/525] ShellPkg: Refine the code logic of 'command history'.

Add the PCD to PcdShellMaxHistoryCommandCount indicate the max count of history commands.

(Sync patch r19520 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19532 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c   | 29 +++++++++++++++++++++++++++-
 ShellPkg/Application/Shell/Shell.inf | 25 ++++++++++++------------
 ShellPkg/ShellPkg.dec                |  3 +++
 3 files changed, 44 insertions(+), 13 deletions(-)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 36063227a2d8..97b8c8d6fbee 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1288,13 +1288,40 @@ AddLineToCommandHistory(
   )
 {
   BUFFER_LIST *Node;
+  BUFFER_LIST *Walker;
+  UINT16       MaxHistoryCmdCount;
+  UINT16       Count;
+  
+  Count = 0;
+  MaxHistoryCmdCount = PcdGet16(PcdShellMaxHistoryCommandCount);
+  
+  if (MaxHistoryCmdCount == 0) {
+    return ;
+  }
+
 
   Node = AllocateZeroPool(sizeof(BUFFER_LIST));
   ASSERT(Node != NULL);
   Node->Buffer = AllocateCopyPool(StrSize(Buffer), Buffer);
   ASSERT(Node->Buffer != NULL);
 
-  InsertTailList(&ShellInfoObject.ViewingSettings.CommandHistory.Link, &Node->Link);
+  for ( Walker = (BUFFER_LIST*)GetFirstNode(&ShellInfoObject.ViewingSettings.CommandHistory.Link)
+      ; !IsNull(&ShellInfoObject.ViewingSettings.CommandHistory.Link, &Walker->Link)
+      ; Walker = (BUFFER_LIST*)GetNextNode(&ShellInfoObject.ViewingSettings.CommandHistory.Link, &Walker->Link)
+   ){
+    Count++;
+  }
+  if (Count < MaxHistoryCmdCount){
+    InsertTailList(&ShellInfoObject.ViewingSettings.CommandHistory.Link, &Node->Link);
+  } else {
+    Walker = (BUFFER_LIST*)GetFirstNode(&ShellInfoObject.ViewingSettings.CommandHistory.Link);
+    RemoveEntryList(&Walker->Link);
+    if (Walker->Buffer != NULL) {
+      FreePool(Walker->Buffer);
+    }
+    FreePool(Walker);
+    InsertTailList(&ShellInfoObject.ViewingSettings.CommandHistory.Link, &Node->Link);
+  }
 }
 
 /**
diff --git a/ShellPkg/Application/Shell/Shell.inf b/ShellPkg/Application/Shell/Shell.inf
index 09aecf717bd7..253bfdbb224e 100644
--- a/ShellPkg/Application/Shell/Shell.inf
+++ b/ShellPkg/Application/Shell/Shell.inf
@@ -95,18 +95,19 @@
   gEfiDevicePathProtocolGuid                              ## CONSUMES
 
 [Pcd]
-  gEfiShellPkgTokenSpaceGuid.PcdShellSupportLevel         ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellSupportOldProtocols  ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellRequireHiiPlatform   ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellSupportFrameworkHii  ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellPageBreakDefault     ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellLibAutoInitialize    ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellInsertModeDefault    ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellScreenLogCount       ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellMapNameLength        ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellPrintBufferSize      ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellForceConsole         ## CONSUMES
-  gEfiShellPkgTokenSpaceGuid.PcdShellSupplier             ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellSupportLevel           ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellSupportOldProtocols    ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellRequireHiiPlatform     ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellSupportFrameworkHii    ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellPageBreakDefault       ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellLibAutoInitialize      ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellInsertModeDefault      ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellScreenLogCount         ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellMapNameLength          ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellPrintBufferSize        ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellForceConsole           ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellSupplier               ## CONSUMES
+  gEfiShellPkgTokenSpaceGuid.PcdShellMaxHistoryCommandCount ## CONSUMES
 
 [BuildOptions.AARCH64]
   # The tiny code model used by AARCH64 only supports binaries of up to 1 MB in
diff --git a/ShellPkg/ShellPkg.dec b/ShellPkg/ShellPkg.dec
index b2f632601eb1..76a2b7db978f 100644
--- a/ShellPkg/ShellPkg.dec
+++ b/ShellPkg/ShellPkg.dec
@@ -101,6 +101,9 @@
 
   ## This determines how many bytes are read out of files at a time for file operations (type, copy, etc...)
   gEfiShellPkgTokenSpaceGuid.PcdShellFileOperationSize|0x1000|UINT32|0x0000000A
+  
+  ## This determines the max count of history commands
+  gEfiShellPkgTokenSpaceGuid.PcdShellMaxHistoryCommandCount|0x0020|UINT16|0x00000014
 
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
   ## This flag is used to control the protocols produced by the shell

From 210d155761f4e83df3d30bc3ddb5b9998ea71e7c Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:12:21 +0000
Subject: [PATCH 362/525] ShellPkg: Fix memory leak when running Shell script.

When we run following script in Shell:
"
for %a run (1 200)
  echo %a
  memmap
endfor
"
We may find memory leak in system. This patch free buffer in 'BufferToFreeList' to avoid this issue.

(Sync patch r19521 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19533 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c | 38 ++++++++++++++++++++++++++++++
 ShellPkg/Application/Shell/Shell.h | 23 ++++++++++++++++++
 2 files changed, 61 insertions(+)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 97b8c8d6fbee..465f4f3974c1 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1276,6 +1276,36 @@ AddBufferToFreeList(
   return (Buffer);
 }
 
+
+/**
+  Create a new buffer list and stores the old one to OldBufferList 
+
+  @param OldBufferList   The temporary list head used to store the nodes in BufferToFreeList.
+**/
+VOID
+SaveBufferList (
+  OUT LIST_ENTRY     *OldBufferList
+  )
+{
+  CopyMem (OldBufferList, &ShellInfoObject.BufferToFreeList.Link, sizeof (LIST_ENTRY));
+  InitializeListHead (&ShellInfoObject.BufferToFreeList.Link);
+}
+
+/**
+  Restore previous nodes into BufferToFreeList .
+
+  @param OldBufferList   The temporary list head used to store the nodes in BufferToFreeList.
+**/
+VOID
+RestoreBufferList (
+  IN OUT LIST_ENTRY     *OldBufferList
+  )
+{
+  FreeBufferList (&ShellInfoObject.BufferToFreeList);
+  CopyMem (&ShellInfoObject.BufferToFreeList.Link, OldBufferList, sizeof (LIST_ENTRY));
+}
+
+
 /**
   Add a buffer to the Line History List
 
@@ -2661,6 +2691,7 @@ RunScriptFileHandle (
   CONST CHAR16        *CurDir;
   UINTN               LineCount;
   CHAR16              LeString[50];
+  LIST_ENTRY          OldBufferList;
 
   ASSERT(!ShellCommandGetScriptExit());
 
@@ -2763,6 +2794,8 @@ RunScriptFileHandle (
               PrintBuffSize/sizeof(CHAR16) - 1
               );
 
+    SaveBufferList(&OldBufferList);
+
     //
     // NULL out comments
     //
@@ -2897,15 +2930,19 @@ RunScriptFileHandle (
 
           ShellCommandRegisterExit(FALSE, 0);
           Status = EFI_SUCCESS;
+          RestoreBufferList(&OldBufferList);
           break;
         }
         if (ShellGetExecutionBreakFlag()) {
+          RestoreBufferList(&OldBufferList);
           break;
         }
         if (EFI_ERROR(Status)) {
+          RestoreBufferList(&OldBufferList);
           break;
         }
         if (ShellCommandGetExit()) {
+          RestoreBufferList(&OldBufferList);
           break;
         }
       }
@@ -2924,6 +2961,7 @@ RunScriptFileHandle (
         NewScriptFile->CurrentCommand->Reset = TRUE;
       }
     }
+    RestoreBufferList(&OldBufferList);
   }
 
 
diff --git a/ShellPkg/Application/Shell/Shell.h b/ShellPkg/Application/Shell/Shell.h
index 57263204e388..351b94188eab 100644
--- a/ShellPkg/Application/Shell/Shell.h
+++ b/ShellPkg/Application/Shell/Shell.h
@@ -382,5 +382,28 @@ TrimSpaces(
   IN CHAR16 **String
   );
 
+/**
+  
+  Create a new buffer list and stores the old one to OldBufferList  
+
+  @param OldBufferList   The temporary list head used to store the nodes in BufferToFreeList.
+**/
+VOID
+SaveBufferList (
+  OUT LIST_ENTRY     *OldBufferList
+  );
+
+/**
+  Restore previous nodes into BufferToFreeList .
+
+  @param OldBufferList   The temporary list head used to store the nodes in BufferToFreeList.
+**/
+VOID
+RestoreBufferList (
+  IN OUT LIST_ENTRY     *OldBufferList
+  );
+
+
+
 #endif //_SHELL_INTERNAL_HEADER_
 

From c1d5a11d81519ab78b9e13d171f87effc4653f8b Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:12:50 +0000
Subject: [PATCH 363/525] ShellPkg: Fix the TAB-auto-completion memory leak.

(Sync patch r19522 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19534 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/Shell.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/ShellPkg/Application/Shell/Shell.c b/ShellPkg/Application/Shell/Shell.c
index 465f4f3974c1..40ae68d5a81f 100644
--- a/ShellPkg/Application/Shell/Shell.c
+++ b/ShellPkg/Application/Shell/Shell.c
@@ -1205,6 +1205,7 @@ DoShellPrompt (
   CONST CHAR16  *CurDir;
   UINTN         BufferSize;
   EFI_STATUS    Status;
+  LIST_ENTRY    OldBufferList;
 
   CurDir  = NULL;
 
@@ -1218,6 +1219,7 @@ DoShellPrompt (
     return EFI_OUT_OF_RESOURCES;
   }
 
+  SaveBufferList(&OldBufferList);
   CurDir = ShellInfoObject.NewEfiShellProtocol->GetEnv(L"cwd");
 
   //
@@ -1247,6 +1249,7 @@ DoShellPrompt (
   //
   // Done with this command
   //
+  RestoreBufferList(&OldBufferList);
   FreePool (CmdLine);
   return Status;
 }

From 22ac7aba0f6fd4d1537fe18c43565abfeb360c61 Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:13:23 +0000
Subject: [PATCH 364/525] ShellPkg: Fix memory leak in
 'InternalShellExecuteDevicePath'.

(Sync patch r19523 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19535 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index 2ddb64d8c7d6..a6bf9c29b4f6 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -1468,6 +1468,7 @@ InternalShellExecuteDevicePath(
     if (NewHandle != NULL) {
       gBS->UnloadImage(NewHandle);
     }
+    FreePool (NewCmdLine);
     return (Status);
   }
   Status = gBS->OpenProtocol(

From d291c4b327ca65b1d5f22efe9b4cf86c9bc08962 Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:13:44 +0000
Subject: [PATCH 365/525] ShellPkg: Fix memory leak in 'ShellOpenFileByName'.

(Sync patch r19524 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19536 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellLib/UefiShellLib.c | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/ShellPkg/Library/UefiShellLib/UefiShellLib.c b/ShellPkg/Library/UefiShellLib/UefiShellLib.c
index 44ac382980c0..9e815c56a6c8 100644
--- a/ShellPkg/Library/UefiShellLib/UefiShellLib.c
+++ b/ShellPkg/Library/UefiShellLib/UefiShellLib.c
@@ -673,6 +673,7 @@ ShellOpenFileByName(
   EFI_STATUS                    Status;
   EFI_FILE_INFO                 *FileInfo;
   CHAR16                        *FileNameCopy;
+  EFI_STATUS                    Status2;
 
   //
   // ASSERT if FileName is NULL
@@ -719,8 +720,12 @@ ShellOpenFileByName(
       FileInfo = FileFunctionMap.GetFileInfo(*FileHandle);
       ASSERT(FileInfo != NULL);
       FileInfo->Attribute = Attributes;
-      Status = FileFunctionMap.SetFileInfo(*FileHandle, FileInfo);
+      Status2 = FileFunctionMap.SetFileInfo(*FileHandle, FileInfo);
       FreePool(FileInfo);
+      if (EFI_ERROR (Status2)) {
+        gEfiShellProtocol->CloseFile(*FileHandle);
+      }
+      Status = Status2;
     }
     return (Status);
   }

From 16057b01349f75003583e6f522cc202f61c22588 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 02:14:05 +0000
Subject: [PATCH 366/525] Subject: [PATCH 5/9] ShellPkg: Fix memory leak in
 function'ManBufferFindSections'.

(Sync patch r19525 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Yao Jiewen <Jiewen.Yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19537 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellManParser.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ShellPkg/Application/Shell/ShellManParser.c b/ShellPkg/Application/Shell/ShellManParser.c
index f12775f86585..80028a6216ff 100644
--- a/ShellPkg/Application/Shell/ShellManParser.c
+++ b/ShellPkg/Application/Shell/ShellManParser.c
@@ -196,6 +196,7 @@ ManBufferFindSections(
         SectionLen = StrLen(SectionName);
         SectionName = StrStr(Sections, SectionName);
         if (SectionName == NULL) {
+          SHELL_FREE_NON_NULL(TempString);
           continue;
         }
         if (*(SectionName + SectionLen) == CHAR_NULL || *(SectionName + SectionLen) == L',') {
@@ -231,6 +232,7 @@ ManBufferFindSections(
     }
     SHELL_FREE_NON_NULL(TempString);
   }
+  SHELL_FREE_NON_NULL(TempString);
   if (!Found && !EFI_ERROR(Status)) {
     return (EFI_NOT_FOUND);
   }

From 02990786fc540e4322733b5ab5b5a59f4d6c52b0 Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:14:27 +0000
Subject: [PATCH 367/525] ShellPkg: Fix memory leak in
 function'ShellCommandRunHelp'.

When run help command Shell may have memory leak. This patch fix this bug.

(Sync patch r19526 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19538 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellLevel3CommandsLib/Help.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ShellPkg/Library/UefiShellLevel3CommandsLib/Help.c b/ShellPkg/Library/UefiShellLevel3CommandsLib/Help.c
index c8d0e7887cff..619cdd38a711 100644
--- a/ShellPkg/Library/UefiShellLevel3CommandsLib/Help.c
+++ b/ShellPkg/Library/UefiShellLevel3CommandsLib/Help.c
@@ -311,6 +311,7 @@ ShellCommandRunHelp (
   ShellStatus         = SHELL_SUCCESS;
   CommandToGetHelpOn  = NULL;
   SectionToGetHelpOn  = NULL;
+  SortedCommandList   = NULL;
   Found               = FALSE;
 
   //
@@ -471,6 +472,7 @@ ShellCommandRunHelp (
   if (SectionToGetHelpOn != NULL) {
     FreePool(SectionToGetHelpOn);
   }
+  SHELL_FREE_NON_NULL(SortedCommandList);
 
   return (ShellStatus);
 }

From d3fcd9cfb456b1ac4397644b2fb0e53967a50899 Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:14:50 +0000
Subject: [PATCH 368/525] ShellPkg: Fix memory leak in function
 'ShellCommandCreateInitialMappingsAndPaths'.

(Sync patch r19527 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19539 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c b/ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c
index 63886690d07e..ceda7ab81e38 100644
--- a/ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c
+++ b/ShellPkg/Library/UefiShellCommandLib/UefiShellCommandLib.c
@@ -1261,6 +1261,9 @@ ShellCommandCreateInitialMappingsAndPaths(
         ; MapListNode = (SHELL_MAP_LIST *)GetFirstNode(&gShellMapList.Link)
        ){
           RemoveEntryList(&MapListNode->Link);
+          SHELL_FREE_NON_NULL(MapListNode->DevicePath);
+          SHELL_FREE_NON_NULL(MapListNode->MapName);
+          SHELL_FREE_NON_NULL(MapListNode->CurrentDirectoryPath);
           FreePool(MapListNode);
     } // for loop
   }

From 0dd73893d00a5d7be3d22b3ff318781942d5052e Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:15:16 +0000
Subject: [PATCH 369/525] ShellPkg: Fix memory leak in
 function'ShellCommandConsistMappingInitialize'.

(Sync patch r19528 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19540 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c b/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
index 86e8dc59a895..41754dd905d6 100644
--- a/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
+++ b/ShellPkg/Library/UefiShellCommandLib/ConsistMapping.c
@@ -1401,6 +1401,7 @@ ShellCommandConsistMappingInitialize (
                                     (VOID **)&SimpleFileSystem
                                     );
       if (EFI_ERROR(Status)) {
+        FreePool (HIDevicePath);
         continue;
       }
     }

From af71a010d1753bf4c84a41d1d201bc7409cdf350 Mon Sep 17 00:00:00 2001
From: Yao Jiewen <Jiewen.Yao@intel.com>
Date: Fri, 25 Dec 2015 02:15:44 +0000
Subject: [PATCH 370/525] ShellPkg: Fix memory leak in function
 'EfiShellSetCurDir' and 'EfiShellSetMap'.

(Sync patch r19529 from main trunk.)

Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yao Jiewen <Jiewen.Yao@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19541 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellProtocol.c | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/ShellPkg/Application/Shell/ShellProtocol.c b/ShellPkg/Application/Shell/ShellProtocol.c
index a6bf9c29b4f6..22d398757fb5 100644
--- a/ShellPkg/Application/Shell/ShellProtocol.c
+++ b/ShellPkg/Application/Shell/ShellProtocol.c
@@ -185,6 +185,9 @@ EfiShellSetMap(
        ){
           if (StringNoCaseCompare(&MapListNode->MapName, &Mapping) == 0) {
             RemoveEntryList(&MapListNode->Link);
+            SHELL_FREE_NON_NULL(MapListNode->DevicePath);
+            SHELL_FREE_NON_NULL(MapListNode->MapName);
+            SHELL_FREE_NON_NULL(MapListNode->CurrentDirectoryPath);
             FreePool(MapListNode);
             return (EFI_SUCCESS);
           }
@@ -2951,6 +2954,8 @@ EfiShellSetCurDir(
     }
 
     if (MapListItem == NULL) {
+      FreePool (DirectoryName);
+      SHELL_FREE_NON_NULL(MapName);
       return (EFI_NOT_FOUND);
     }
 
@@ -2967,6 +2972,7 @@ EfiShellSetCurDir(
         ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
         MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, DirectoryName+StrLen(MapName), 0);
       }
+      FreePool (MapName);
     } else {
       ASSERT((MapListItem->CurrentDirectoryPath == NULL && Size == 0) || (MapListItem->CurrentDirectoryPath != NULL));
       MapListItem->CurrentDirectoryPath = StrnCatGrow(&MapListItem->CurrentDirectoryPath, &Size, DirectoryName, 0);
@@ -2982,6 +2988,7 @@ EfiShellSetCurDir(
     // cant have a mapping in the directory...
     //
     if (StrStr(DirectoryName, L":") != NULL) {
+      FreePool (DirectoryName);
       return (EFI_INVALID_PARAMETER);
     }
     //
@@ -2989,6 +2996,7 @@ EfiShellSetCurDir(
     //
     MapListItem = ShellCommandFindMapItem(FileSystem);
     if (MapListItem == NULL) {
+      FreePool (DirectoryName);
       return (EFI_INVALID_PARAMETER);
     }
 //    gShellCurDir = MapListItem;
@@ -3013,6 +3021,7 @@ EfiShellSetCurDir(
       }
     }
   }
+  FreePool (DirectoryName);
   //
   // if updated the current directory then update the environment variable
   //

From 17bcd74b0375a4b8a76a43bd7033a59f6ee84e40 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Fri, 25 Dec 2015 02:57:52 +0000
Subject: [PATCH 371/525] MdeModulePkg/BootManagerMenu: Fix bug that boots to
 undesired option

(Sync patch r19542 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Eric Dong <eric.dong@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19543 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BootManagerMenuApp/BootManagerMenu.c      | 68 ++++++++++++-------
 1 file changed, 45 insertions(+), 23 deletions(-)

diff --git a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
index 2f90883cbbfd..8748ac0e0590 100644
--- a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
+++ b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
@@ -242,7 +242,48 @@ IsBootManagerMenu (
 
   return (BOOLEAN) (!EFI_ERROR (Status) && (BootOption->OptionNumber == BootManagerMenu.OptionNumber));
 }
- 
+
+/**
+  Return whether to ignore the boot option.
+
+  @param BootOption  Pointer to EFI_BOOT_MANAGER_LOAD_OPTION to check.
+
+  @retval TRUE  Ignore the boot optin.
+  @retval FALSE Do not ignore the boot option.
+**/
+BOOLEAN
+IgnoreBootOption (
+  IN   EFI_BOOT_MANAGER_LOAD_OPTION  *BootOption
+  )
+{
+  EFI_STATUS                    Status;
+  EFI_DEVICE_PATH_PROTOCOL      *ImageDevicePath;
+
+  //
+  // Ignore myself.
+  //
+  Status = gBS->HandleProtocol (gImageHandle, &gEfiLoadedImageDevicePathProtocolGuid, (VOID **) &ImageDevicePath);
+  ASSERT_EFI_ERROR (Status);
+  if (CompareMem (BootOption->FilePath, ImageDevicePath, GetDevicePathSize (ImageDevicePath)) == 0) {
+    return TRUE;
+  }
+
+  //
+  // Do not ignore Boot Manager Menu.
+  //
+  if (IsBootManagerMenu (BootOption)) {
+    return FALSE;
+  }
+
+  //
+  // Ignore the hidden/inactive boot option.
+  //
+  if (((BootOption->Attributes & LOAD_OPTION_HIDDEN) != 0) || ((BootOption->Attributes & LOAD_OPTION_ACTIVE) == 0)) {
+    return TRUE;
+  }
+
+  return FALSE;
+}
 
 /**
   This funciton uses to initialize boot menu data
@@ -262,18 +303,13 @@ InitializeBootMenuData (
   OUT  BOOT_MENU_POPUP_DATA          *BootMenuData
   )
 {
-  EFI_STATUS                    Status;
   UINTN                         Index;
   UINTN                         StrIndex;
-  EFI_DEVICE_PATH_PROTOCOL      *ImageDevicePath;
       
   if (BootOption == NULL || BootMenuData == NULL) {
     return EFI_INVALID_PARAMETER;
   }
 
-  Status = gBS->HandleProtocol (gImageHandle, &gEfiLoadedImageDevicePathProtocolGuid, (VOID **) &ImageDevicePath);
-  ASSERT_EFI_ERROR (Status);
-
   BootMenuData->TitleToken[0] = STRING_TOKEN (STR_BOOT_POPUP_MENU_TITLE_STRING);
   BootMenuData->PtrTokens     = AllocateZeroPool (BootOptionCount * sizeof (EFI_STRING_ID));
   ASSERT (BootMenuData->PtrTokens != NULL);
@@ -282,18 +318,7 @@ InitializeBootMenuData (
   // Skip boot option which created by BootNext Variable
   //
   for (StrIndex = 0, Index = 0; Index < BootOptionCount; Index++) {
-    //
-    // Don't display the hidden/inactive boot option except setup application.
-    //
-    if ((((BootOption[Index].Attributes & LOAD_OPTION_HIDDEN) != 0) || ((BootOption[Index].Attributes & LOAD_OPTION_ACTIVE) == 0)) &&
-        !IsBootManagerMenu (&BootOption[Index])) {      
-      continue;
-    }
-
-    //
-    // Don't display myself
-    //
-    if (CompareMem (BootOption[Index].FilePath, ImageDevicePath, GetDevicePathSize (ImageDevicePath)) == 0) {
+    if (IgnoreBootOption (&BootOption[Index])) {
       continue;
     }
 
@@ -640,13 +665,10 @@ BootFromSelectOption (
   ASSERT (BootOptions != NULL);
 
   for (ItemNum = 0, Index = 0; Index < BootOptionCount; Index++) {
-    //
-    // Don't display the hidden/inactive boot option except setup application.
-    //
-    if ((((BootOptions[Index].Attributes & LOAD_OPTION_HIDDEN) != 0) || ((BootOptions[Index].Attributes & LOAD_OPTION_ACTIVE) == 0)) &&
-        !IsBootManagerMenu (&BootOptions[Index])) {      
+    if (IgnoreBootOption (&BootOptions[Index])) {
       continue;
     }
+
     if (ItemNum++ == SelectItem) {
       EfiBootManagerBoot (&BootOptions[Index]);
       break;

From 09060cfcf1602a6c69ae1000486d857fe24824e6 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 03:11:33 +0000
Subject: [PATCH 372/525] ShellPkg: Refine the code format.

1. Add function header comment.
2. Non-Boolean comparisons should explicitly use a compare operator.

(Sync patch r19424 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19544 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellPkg/Application/Shell/ShellManParser.c | 23 +++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/ShellPkg/Application/Shell/ShellManParser.c b/ShellPkg/Application/Shell/ShellManParser.c
index 80028a6216ff..222cdafd6ebe 100644
--- a/ShellPkg/Application/Shell/ShellManParser.c
+++ b/ShellPkg/Application/Shell/ShellManParser.c
@@ -15,7 +15,26 @@
 
 #include "Shell.h"
 
-CHAR16 EFIAPI InternalShellCharToUpper (IN CHAR16  Char);
+/**
+  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 
+InternalShellCharToUpper (
+  IN CHAR16  Char
+  );
 
 /**
   Verifies that the filename has .MAN on the end.
@@ -632,7 +651,7 @@ ManFileFindTitleSection(
   // Do not pass any leading path information that may be present to IsTitleHeader().
   //
   Start = StrLen(Command);
-  while (Start
+  while ((Start != 0)
          && (*(Command + Start - 1) != L'\\')
          && (*(Command + Start - 1) != L'/')
          && (*(Command + Start - 1) != L':')) {

From 6aca51860d48202785b9be420922130181c5f275 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Date: Fri, 25 Dec 2015 03:12:08 +0000
Subject: [PATCH 373/525] ShellPkg: Add AIP IPv6 UNDI support to Shell dh

Update Shell DH command to decode and print the value of gEfiAdapterInfoUndiIpv6SupportGuid AIP instance.

(Sync patch r19437 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19545 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../UefiHandleParsingLib.c                    | 21 +++++++++++++++++--
 .../UefiHandleParsingLib.inf                  |  4 +++-
 .../UefiHandleParsingLib.uni                  |  4 +++-
 3 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
index 6f093ffe0e82..4c46e5e48de7 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.c
@@ -1,9 +1,9 @@
 /** @file
   Provides interface to advanced shell functionality for parsing both handle and protocol database.
 
-  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
-  (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
   Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+  (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -690,6 +690,10 @@ AdapterInformationDumpInformation (
         TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoSanMacAddressGuid");
         SHELL_FREE_NON_NULL (RetVal);
         RetVal = TempRetVal;
+      } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoUndiIpv6SupportGuid)) {
+        TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoUndiIpv6SupportGuid");
+        SHELL_FREE_NON_NULL (RetVal);
+        RetVal = TempRetVal;
       } else {
 
         GuidStr = GetStringNameFromGuid (&InfoTypesBuffer[GuidIndex], NULL);
@@ -782,6 +786,19 @@ AdapterInformationDumpInformation (
                          );
           SHELL_FREE_NON_NULL (RetVal);
           RetVal = TempRetVal;
+        } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoUndiIpv6SupportGuid) == TRUE) {
+          TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_UNDI_IPV6_INFO), NULL);
+          if (TempStr == NULL) {
+            goto ERROR_EXIT;
+          }
+
+          TempRetVal = CatSPrint (
+                         RetVal,
+                         TempStr,
+                         ((EFI_ADAPTER_INFO_UNDI_IPV6_SUPPORT *)InformationBlock)->Ipv6Support
+                         );   
+          SHELL_FREE_NON_NULL (RetVal);
+          RetVal = TempRetVal;
         } else {
           TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_UNKNOWN_INFO_TYPE), NULL);
           if (TempStr == NULL) {
diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
index 4a19e3945057..52eed8604ebb 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.inf
@@ -1,7 +1,8 @@
 ##  @file
 #  Provides interface to advanced shell functionality for parsing both handle and protocol database.
-#  (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
 #  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved. <BR>
+#  (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
+#  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -309,6 +310,7 @@
   gEfiAdapterInfoMediaStateGuid                           ## SOMETIMES_CONSUMES ## GUID
   gEfiAdapterInfoNetworkBootGuid                          ## SOMETIMES_CONSUMES ## GUID
   gEfiAdapterInfoSanMacAddressGuid                        ## SOMETIMES_CONSUMES ## GUID
+  gEfiAdapterInfoUndiIpv6SupportGuid                      ## SOMETIMES_CONSUMES ## GUID
 
 [Pcd.common]
   gEfiShellPkgTokenSpaceGuid.PcdShellPrintBufferSize      ## CONSUMES
diff --git a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
index f7d54855fb66..3dd8896930ba 100644
--- a/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
+++ b/ShellPkg/Library/UefiHandleParsingLib/UefiHandleParsingLib.uni
@@ -1,7 +1,8 @@
 // /**
 //
-// (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
 // Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved. <BR>
+// (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>
+// (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 // This program and the accompanying materials
 // are licensed and made available under the terms and conditions of the BSD License
 // which accompanies this distribution. The full text of the license may be found at
@@ -395,5 +396,6 @@
                                                           "    iScsiIpv6Boot          : %%H%d%%N\r\n"
                                                           "    FCoeBoot               : %%H%d%%N\r\n"
 #string STR_SAN_MAC_ADDRESS_INFO          #language en-US "    SanMacAddress: %%H%02x-%02x-%02x-%02x-%02x-%02x%%N \r\n"
+#string STR_UNDI_IPV6_INFO                #language en-US "    UNDI IPv6 Supported: %%H%d%%N \r\n"
 #string STR_UNKNOWN_INFO_TYPE             #language en-US "    The 'InformationType' - %%H%g%%N can't be recongnized\r\n"
 

From b90babbd2047741a082350e4526143709ab05971 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Fri, 25 Dec 2015 04:14:43 +0000
Subject: [PATCH 374/525] Update the file format.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Eric Dong <eric.gong@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19547 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/OpensslLib/Install.sh | 158 ++++++++++++------------
 1 file changed, 79 insertions(+), 79 deletions(-)

diff --git a/CryptoPkg/Library/OpensslLib/Install.sh b/CryptoPkg/Library/OpensslLib/Install.sh
index 82a7f409f105..543439529448 100755
--- a/CryptoPkg/Library/OpensslLib/Install.sh
+++ b/CryptoPkg/Library/OpensslLib/Install.sh
@@ -1,79 +1,79 @@
-#!/bin/sh
-
-cd openssl-1.0.2e
-cp e_os2.h                    ../../../Include/openssl
-cp crypto/crypto.h            ../../../Include/openssl
-cp crypto/opensslv.h          ../../../Include/openssl
-cp crypto/opensslconf.h       ../../../Include/openssl
-cp crypto/ebcdic.h            ../../../Include/openssl
-cp crypto/symhacks.h          ../../../Include/openssl
-cp crypto/ossl_typ.h          ../../../Include/openssl
-cp crypto/objects/objects.h   ../../../Include/openssl
-cp crypto/objects/obj_mac.h   ../../../Include/openssl
-cp crypto/md4/md4.h           ../../../Include/openssl
-cp crypto/md5/md5.h           ../../../Include/openssl
-cp crypto/sha/sha.h           ../../../Include/openssl
-cp crypto/mdc2/mdc2.h         ../../../Include/openssl
-cp crypto/hmac/hmac.h         ../../../Include/openssl
-cp crypto/ripemd/ripemd.h     ../../../Include/openssl
-cp crypto/whrlpool/whrlpool.h ../../../Include/openssl
-cp crypto/des/des.h           ../../../Include/openssl
-cp crypto/des/des_old.h       ../../../Include/openssl
-cp crypto/aes/aes.h           ../../../Include/openssl
-cp crypto/rc2/rc2.h           ../../../Include/openssl
-cp crypto/rc4/rc4.h           ../../../Include/openssl
-cp crypto/idea/idea.h         ../../../Include/openssl
-cp crypto/bf/blowfish.h       ../../../Include/openssl
-cp crypto/cast/cast.h         ../../../Include/openssl
-cp crypto/camellia/camellia.h ../../../Include/openssl
-cp crypto/seed/seed.h         ../../../Include/openssl
-cp crypto/modes/modes.h       ../../../Include/openssl
-cp crypto/bn/bn.h             ../../../Include/openssl
-cp crypto/ec/ec.h             ../../../Include/openssl
-cp crypto/rsa/rsa.h           ../../../Include/openssl
-cp crypto/dsa/dsa.h           ../../../Include/openssl
-cp crypto/ecdsa/ecdsa.h       ../../../Include/openssl
-cp crypto/dh/dh.h             ../../../Include/openssl
-cp crypto/ecdh/ecdh.h         ../../../Include/openssl
-cp crypto/dso/dso.h           ../../../Include/openssl
-cp crypto/engine/engine.h     ../../../Include/openssl
-cp crypto/buffer/buffer.h     ../../../Include/openssl
-cp crypto/bio/bio.h           ../../../Include/openssl
-cp crypto/stack/stack.h       ../../../Include/openssl
-cp crypto/stack/safestack.h   ../../../Include/openssl
-cp crypto/lhash/lhash.h       ../../../Include/openssl
-cp crypto/rand/rand.h         ../../../Include/openssl
-cp crypto/err/err.h           ../../../Include/openssl
-cp crypto/evp/evp.h           ../../../Include/openssl
-cp crypto/asn1/asn1.h         ../../../Include/openssl
-cp crypto/asn1/asn1_mac.h     ../../../Include/openssl
-cp crypto/asn1/asn1t.h        ../../../Include/openssl
-cp crypto/pem/pem.h           ../../../Include/openssl
-cp crypto/pem/pem2.h          ../../../Include/openssl
-cp crypto/x509/x509.h         ../../../Include/openssl
-cp crypto/x509/x509_vfy.h     ../../../Include/openssl
-cp crypto/x509v3/x509v3.h     ../../../Include/openssl
-cp crypto/conf/conf.h         ../../../Include/openssl
-cp crypto/conf/conf_api.h     ../../../Include/openssl
-cp crypto/txt_db/txt_db.h     ../../../Include/openssl
-cp crypto/pkcs7/pkcs7.h       ../../../Include/openssl
-cp crypto/pkcs12/pkcs12.h     ../../../Include/openssl
-cp crypto/comp/comp.h         ../../../Include/openssl
-cp crypto/ocsp/ocsp.h         ../../../Include/openssl
-cp crypto/ui/ui.h             ../../../Include/openssl
-cp crypto/ui/ui_compat.h      ../../../Include/openssl
-cp crypto/krb5/krb5_asn.h     ../../../Include/openssl
-cp crypto/cms/cms.h           ../../../Include/openssl
-cp crypto/pqueue/pqueue.h     ../../../Include/openssl
-cp crypto/ts/ts.h             ../../../Include/openssl
-cp crypto/srp/srp.h           ../../../Include/openssl
-cp crypto/cmac/cmac.h         ../../../Include/openssl
-cp ssl/ssl.h                  ../../../Include/openssl
-cp ssl/ssl2.h                 ../../../Include/openssl
-cp ssl/ssl3.h                 ../../../Include/openssl
-cp ssl/ssl23.h                ../../../Include/openssl
-cp ssl/tls1.h                 ../../../Include/openssl
-cp ssl/dtls1.h                ../../../Include/openssl
-cp ssl/kssl.h                 ../../../Include/openssl
-cp ssl/srtp.h                 ../../../Include/openssl
-cd ..
+#!/bin/sh
+
+cd openssl-1.0.2e
+cp e_os2.h                    ../../../Include/openssl
+cp crypto/crypto.h            ../../../Include/openssl
+cp crypto/opensslv.h          ../../../Include/openssl
+cp crypto/opensslconf.h       ../../../Include/openssl
+cp crypto/ebcdic.h            ../../../Include/openssl
+cp crypto/symhacks.h          ../../../Include/openssl
+cp crypto/ossl_typ.h          ../../../Include/openssl
+cp crypto/objects/objects.h   ../../../Include/openssl
+cp crypto/objects/obj_mac.h   ../../../Include/openssl
+cp crypto/md4/md4.h           ../../../Include/openssl
+cp crypto/md5/md5.h           ../../../Include/openssl
+cp crypto/sha/sha.h           ../../../Include/openssl
+cp crypto/mdc2/mdc2.h         ../../../Include/openssl
+cp crypto/hmac/hmac.h         ../../../Include/openssl
+cp crypto/ripemd/ripemd.h     ../../../Include/openssl
+cp crypto/whrlpool/whrlpool.h ../../../Include/openssl
+cp crypto/des/des.h           ../../../Include/openssl
+cp crypto/des/des_old.h       ../../../Include/openssl
+cp crypto/aes/aes.h           ../../../Include/openssl
+cp crypto/rc2/rc2.h           ../../../Include/openssl
+cp crypto/rc4/rc4.h           ../../../Include/openssl
+cp crypto/idea/idea.h         ../../../Include/openssl
+cp crypto/bf/blowfish.h       ../../../Include/openssl
+cp crypto/cast/cast.h         ../../../Include/openssl
+cp crypto/camellia/camellia.h ../../../Include/openssl
+cp crypto/seed/seed.h         ../../../Include/openssl
+cp crypto/modes/modes.h       ../../../Include/openssl
+cp crypto/bn/bn.h             ../../../Include/openssl
+cp crypto/ec/ec.h             ../../../Include/openssl
+cp crypto/rsa/rsa.h           ../../../Include/openssl
+cp crypto/dsa/dsa.h           ../../../Include/openssl
+cp crypto/ecdsa/ecdsa.h       ../../../Include/openssl
+cp crypto/dh/dh.h             ../../../Include/openssl
+cp crypto/ecdh/ecdh.h         ../../../Include/openssl
+cp crypto/dso/dso.h           ../../../Include/openssl
+cp crypto/engine/engine.h     ../../../Include/openssl
+cp crypto/buffer/buffer.h     ../../../Include/openssl
+cp crypto/bio/bio.h           ../../../Include/openssl
+cp crypto/stack/stack.h       ../../../Include/openssl
+cp crypto/stack/safestack.h   ../../../Include/openssl
+cp crypto/lhash/lhash.h       ../../../Include/openssl
+cp crypto/rand/rand.h         ../../../Include/openssl
+cp crypto/err/err.h           ../../../Include/openssl
+cp crypto/evp/evp.h           ../../../Include/openssl
+cp crypto/asn1/asn1.h         ../../../Include/openssl
+cp crypto/asn1/asn1_mac.h     ../../../Include/openssl
+cp crypto/asn1/asn1t.h        ../../../Include/openssl
+cp crypto/pem/pem.h           ../../../Include/openssl
+cp crypto/pem/pem2.h          ../../../Include/openssl
+cp crypto/x509/x509.h         ../../../Include/openssl
+cp crypto/x509/x509_vfy.h     ../../../Include/openssl
+cp crypto/x509v3/x509v3.h     ../../../Include/openssl
+cp crypto/conf/conf.h         ../../../Include/openssl
+cp crypto/conf/conf_api.h     ../../../Include/openssl
+cp crypto/txt_db/txt_db.h     ../../../Include/openssl
+cp crypto/pkcs7/pkcs7.h       ../../../Include/openssl
+cp crypto/pkcs12/pkcs12.h     ../../../Include/openssl
+cp crypto/comp/comp.h         ../../../Include/openssl
+cp crypto/ocsp/ocsp.h         ../../../Include/openssl
+cp crypto/ui/ui.h             ../../../Include/openssl
+cp crypto/ui/ui_compat.h      ../../../Include/openssl
+cp crypto/krb5/krb5_asn.h     ../../../Include/openssl
+cp crypto/cms/cms.h           ../../../Include/openssl
+cp crypto/pqueue/pqueue.h     ../../../Include/openssl
+cp crypto/ts/ts.h             ../../../Include/openssl
+cp crypto/srp/srp.h           ../../../Include/openssl
+cp crypto/cmac/cmac.h         ../../../Include/openssl
+cp ssl/ssl.h                  ../../../Include/openssl
+cp ssl/ssl2.h                 ../../../Include/openssl
+cp ssl/ssl3.h                 ../../../Include/openssl
+cp ssl/ssl23.h                ../../../Include/openssl
+cp ssl/tls1.h                 ../../../Include/openssl
+cp ssl/dtls1.h                ../../../Include/openssl
+cp ssl/kssl.h                 ../../../Include/openssl
+cp ssl/srtp.h                 ../../../Include/openssl
+cd ..

From fa1025b0dc7e3a300a52044f071b9f2a513e6394 Mon Sep 17 00:00:00 2001
From: Qiu Shumin <shumin.qiu@intel.com>
Date: Fri, 25 Dec 2015 04:47:43 +0000
Subject: [PATCH 375/525] ShellBinPkg: Ia32/X64 Shell binary update.

The binaries of ShellBinPkg are generated with ShellPkg project 19529. The binaries are built with no debug information by building with "RELEASE" target.

(Sync patch r19548 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qiu Shumin <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19549 6f19259b-4bc3-4df7-8a09-765794883524
---
 ShellBinPkg/MinUefiShell/Ia32/Shell.efi | Bin 347552 -> 348256 bytes
 ShellBinPkg/MinUefiShell/X64/Shell.efi  | Bin 392832 -> 393760 bytes
 ShellBinPkg/ReadMe.txt                  |   2 +-
 ShellBinPkg/UefiShell/Ia32/Shell.efi    | Bin 810496 -> 811200 bytes
 ShellBinPkg/UefiShell/X64/Shell.efi     | Bin 907264 -> 908192 bytes
 5 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/ShellBinPkg/MinUefiShell/Ia32/Shell.efi b/ShellBinPkg/MinUefiShell/Ia32/Shell.efi
index 293547e09159a47d78b44715f15a3e43c24f818b..f17342427bf2b657c243acbf472075e91eb3f47b 100644
GIT binary patch
delta 104684
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
U=+(!yUVthSG@IAm9lz821JnA<J^%m!

delta 104395
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
UL~2^UXp6EHo^_GR@uq**4>KrDkN^Mx

diff --git a/ShellBinPkg/MinUefiShell/X64/Shell.efi b/ShellBinPkg/MinUefiShell/X64/Shell.efi
index e79060ca5eaccff4b96eaf51828009ab8f7eed0d..7026fe266e47d44188be40d4ab6525cf1fca6f1e 100644
GIT binary patch
delta 109100
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
T%x%c-USL6PPd9=~TMz#acfcr>

delta 107813
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%0A=^!L}^WLNt6
zyPMQD%9ix^t)V0IDQ4~;fRtrifBzPT;f_dabQkVbmN;&%Qp;A5@UiT}{sFprtJ#+R
zO<RmrD|!7-rIeSI`cS3EZ1{kHmS3!*EFIPpt3FwNj>R-1&uwAS7PUjrySvH`qdCC0
z#$)&ztO2O0jb-x&m|N@ufJ96ryL+YAbH&URBlj8A31TNu=Lh!70JHmGwaztGXP|G5
z&V)X|+6)YcdUGY1WaQOAv$Yi(Xf>Z_lCizQ8(D#>?%&6>=i^w`z<{9*sIojTAC`{;
zY0;Z{N^iEF)K9kI)dyk**6UD*M6UlYwzGPxhL%k%pR6Hf6nt1au<U^iY+tSb0J=f_
z(Mo-AyTo&eP8AJy$~Uj3dMTKf%DoEC0I<kOqi{SZlCFpkMjWBm-zGD`a~jof)J~9M
z9$K4<s;&N%&c5KU0giM(0+Q*7a9H-Bd)n=6*5D>s(N+%*){bLG2RGMtW@Uq0>gt|n
zrXl2;x(->{UOQE6jx)_-0Fw4n7vQ!FIDbb$)Ko?WBAV=t(AAsFeQ0-WU6wjDLVKNM
z4Gq(7W#12N2NUE&-`2f7j}3V(5V^H^uXP$U`7Ow5PudBdX^pX5{^SEqIt*PK!g0Qj
zxyHX*Mx7!8Ox_zXd@KNc=a9Nn2IC^AIoXjarO0uqB#(Xo(Hh#%VYP?(>sHTYt%sSl
zR+ci%$9*LDQa*bQduLc%UGQACepsaL!5nsJSg<W{%D-h;;VopSFhPdxB*WOHugI_x
zMh_W0W>?GL4H=>!LmbI)xSx>0IZNCxgM@JwIc+aaC(hQT1H;G0%!RPEq|C}RGmQoE
z12!|(qcfm~`W{(vA;=N0gQ%6MLrCDfasL+X88ib04JYA_l5i)PA{=Cz2__bK{$R+F
zZ0}Jm7H_4<G~}gBkf$5uak_$>JsaN0)<J21)PLF!{h#*7EA5|bfcDQ)`(ZEJzcmv|
zw)a4P3aW;Muj(uGaS|vf1H+Vb31e-{%n&oKfET?^M#+|q2+&Spdq%YP9Y~aN%1$Zc
zSV*$Hk0(#;BRIs)WZID(8rg4AsUkd=Lf>Q}oM2BvkM*5rvwkCkbq!{-IV1gT3nzh0
z*j42$%mLHV8N`*;;z^8oW^ciCK7nzan5NB8#6FVjHyNPtT)BU3u(eZ)T|XKSTmwWS
zg_YSuVC!<y;P6ult}`)+mcpzx@ONCAizL5Dj`=5zH5_GX=s8QLQQrcQ&sJZGU&|6k
z4Xqc3@xw4qss}Z~nz0VC9iwL2?qN`>qSjAI#T&$ORl>Vvi-=7`ts4okQAM->qAHx-
zK!{B$!jljgF&b+#yjc`I*KGz~BB~|Hwg2X;Hvv<bFU8CiS9fc1I{?Wz#mQisM~AG~
zvQF!1+m(iS+>zWF(op!VUJlU0CnGu;f!qi3fw<)(A-zbs>~ukMo_9tSC$7#E@*U*9
z#Tf<Che#dP;eTyZAsM6HfKoDw9{fiFXT0tSP$4g+LRMu!TJ2X3cxxbXtsIP@7>+Gl
z#&PqgJoaLAV;ho|sB@Zk`9!38apY*ss!K3zWvn<<@e(p&3ki=Z&L{TOfzjbldf8w2
zo5JC)Kso)8q@>%nA-prC3(>6rW!J@r2%lX_yC+;H`CZ|2mNKJ-d|xZl4t}^nWSoKG
zZxr>u)1fRn@rA`8-#0J{$~iodX~#B-ESn}!VT8hl0a2&Ja38O<(bc-jY-Dm#aekP_
z8Uqn#b$|%i_m;7~V_WF<MzDEfy%`(ZtlQ{kN~_l$Rh_odOPd#JgSR*j#eO`D4s|;U
zLKOJleUXJycewnw_3Y``m`;NsW_Ts;CE4fEQ7LYq^K7wf7-Fdd^ri&ouOTX-EJp!}
zMi-9JTR70yO|~Iqrw+q6c;w*vk%n)@(Jmc#`a_mJ9*QiI$PJJz<DUWxR|j911WgYJ
zdWq^uC>ib3ZiPs|_G?m<e1Qim5`8L)LZW?uK%#b;BPoPLh|vT_?X1Pykx3(g4F^1u
ze#*5l;AMR5X8K*i{SUH;aqVoEJi*sK0{xwji*l#Znn2iE)P>FH0__cRWY9;CNKK<d
z?YqLf^pmHG*^j{*m<rkIW5CqG!YEw^<m|hcD&7cs@cRUQLwS@}`WX;X-WtKXH}*QV
zlp$4f`+G=|^S#<?616JpbxK1OXlMvnZ5?0TkepO5MJH7lvydn!>lO+9twylOQCaA~
zB1P^F-Qvn4HkG9GlNH2veyU=<aE6WI%C4$*-*$sW)7jOSRW%QKvG>L|j_pP)OH`Jt
z7E$#Qo(xiP#8JvSz~XVI3FayM&@&=Gr;<-*m&TiIWdK#l5WgQN4X;CD;7~oq(SvRu
zR*U!e3F(|B7Ge2rF`G(wEi^}_fRVJ~Cp4JpBgXn#S~K(p)eT`#6i%G^HUv;*gGCyv
zkWWYbGB#sESfdwiG|E$gM)L|%ENzCcNv0%H96LIpzOBG6I#wM|?W3}CMHP7x+#7+_
zE5|;@%(J8~inDOxssJ;RJ2CBGH3fBOoDq2y^JpaPa7r;8r}iSzQq0#OY=o2iOF0-K
z8WU&)Eqa2Wu$a8bBH>%|obXhpE+jH^0jY=ZNRk?J1V%vj2wUY7AKWZ)NLp@xOpHVj
ziF*(Q{GWwv!yAok*9EU~nm-e1bg;QbFbbeJEe{zra>TGaSXh&{$dtvs`T-zx7z)N#
z+ZeLcA{+A~dhg7o`Z5BQ3DHw}=+fLF;!y*_h1vw44md8Q^dOg#${iRaats(VzENnd
zn6GBNCd%4+?9xR4RO1wiNemTlQV(mth{x4*(qPg)@RUbjfus{tI?c!a8yR>Sui251
z^%5$eUaneCt?|{5ENN1(HknPC)Kc4<t-#-b?AW9rt&ZKB)KPcZpP487`Q%R)b$8*B
zEL;AmYEBxCmjxQKw<gzYl&w(A{vV1l*IhL%)zpA(n%qG5j~ClNxdk}ip4?h{fqA}}
z*f|>`3;(doYJwx%g-I5Ej!v()|3R8|j*EYMLT7~|(=VJP1bCMo4oqHTDMqmDH$$}E
zZ2y}*10PPr^^3ThqzNfw^kvY*QPSgAfa%!JVOlwo1y2d^Jpur9u!SBNHjJ3*&TvYe
z6hcT7vrcKL`=A|LKP9q$Ta_e=3?~dDdvOHgQ`+e+g|J3%&9+T_qe>7uE;aZ-@2U?I
zwq#t`n=~({#gUOdQ5}~u8tU0(o#jMO%zc5ROG$DmuPGvP*m4Em0=<ws!EFOUbzChU
zrm>dO>fgkQcvE1Slb?j)G8X*yY~3$!unliF82t&UmF8DDufR{5^IFUlr-yXF1sw1v
zoxGkKxg!_RY8w3awOKx-{GW0824Ub$5-FH|+iN(z1OPz?-8*~t4Q6^LDttu^vWCl&
z{5Ma{KzlLyX?RDwk1KCKR7}@b1CG}P;xm^1&Y+rgMDU--9=iFmxjQ_1<5>0zUKIuh
z9O5RDTwQ5anCpn69xK=wRhgZ*!ko|V9mF)koCLzX3enKG7t2{8-&u$CncAuL>v|Hc
zoJ3p0mQ6L=^5OfH{8%koG3Z)DYtUfm-g1S{byD2@hE0SW*T55Y(Sp#>MtnL6mYY^D
z?(s=&+UJP#w@#!8!^L?XR5M)^szxdmCbqs7@Xnur{2i=`#S2?6g-3njVayUstwTR<
z66mmzF)@{{&jOG^i%o^H+6@+3^gtclg>6YLo0Pkj+1`!Twr2a^Z5Lb*gRy)Z^~@3!
zRhi96@{HplxKVvlp9Q!k@1%bIIOaXAE#8}XNFB#@X__SXlU_CorhuibfNu~BQ=!HF
zRv3?bj|?oY`i|Ue1icoPIW4SB`FtXOc|)gSHno<gOT&tTtEWj6Bay!hfl#f-vY)2~
z_P~2Wkj<nSi({81H_>Pr&hG)y|2{^{!%OsVB;`T}$6wQF@==+jv%qUtIWI@#Q!TSh
zHxJ6yVVq8hP`sFz%%i2Qm<I}(l)GEl2<6(PFnU<*Q==$d0<qA&MT5{LLJQnAE#Z4!
zBLNJj;in;QGCMXsB%-^MLZ95(!H}cFBUki4mxk@gT!`Y(TL8(qsWu!g8a~6@GJmVL
zb~5W|4YqxPXc?_y)g_;^VKntA<uZ5`pGRsJcNeR(waP*xlEkb3s%|GxX=fK8Isd5b
ztN;wm27no6URY%|Y0o(cpm-Gorj&gx)v)W<y72)j6xyVgCA3_bjiIBCi+=gPZ12lC
zqF)hOD71bJYNr@iQro088@K9X(UY5K^0L^^R7|_UGXXpTPU%9K9$4G46i0{xnP^o5
zpZ!_gp<tzf-5NB|N^M{@U^HSK*xs~Zw%3HXrdngjb`8%*<3W3$%2ZFh;qdtqlEUyi
zpg8Y>4~t(^%9jcy7x4867l1saAPF-^#e4vapf4uqI2AgT=rhIz;qoc|j-mnmr81bt
zg|0eQh4!|4pn4TTer7V;JEN(0ebFFA{qFeX3_;=wUc>N&J)F@m?kft?<z8k?EqvAD
zQ>EmslpIP46%?=OH;UE>5&6r7wCNgFHkoD2jB0%4Lt;|GC(#s_YjM*DRL0J-f`82}
z&Ft=(mxYEWO7aC~7c5?5MzGLXjR&|0DiQd^2?oWyR77rnit}wF-+@|meU)||<vbDO
zh~T#f$OXRm6(r})732piZiQ=2%xtg2a%VLf@<@br6dD;bbIFu&$(VmP6UHO=@UC_c
zPl(E%0MqYd=F1hVxf**#!I~v`FnsqhNv?<VO8D&f$XVobGG6xvS4Djue7piO69|V{
zr>q{lp8~?*!M7(ZVrRGcuw%1ZXn$e9&2HB32*pkIgsOwDLVg;pIdPI*Qye#9=1)Ue
zkB9&au$996wge5qw8wgj`^2TUMRg2bE<#PTiG!}!=d=m_M8N5FNFWd*_cG)D7f2PU
zjF~h}WXE%Y>)m@smSh<H6jL|5Cf1PG*n>GHzsAG?mFtMgS0QFuH!-*c{81)rGB>r$
z?frtnxbRcN2{bQ|zoRO~Of2UFfHNL~|I2wiA;i`;We6M-r03Jv&beMAn^W(rSHQA(
z3OF1lzds-m!hxb0q5-SxghV?$@(Ap-XnRaN@`#7u&%i5Jmpy3R-2)9fx6&^N4NbDZ
zd4af~)?;30DMeUX1$Btl&G*q+^m%Iq`uv#s{P}cZRl<j+(-R?l3BQP+bk`sBNvX-o
zcYoezh4Xs2UIjCD;Edmjong8fEPB3o!%aGLQ0#$bA-KRoM!SNmQ`tAy>odc9?kk>;
zfE*vsuRG|ihs3{-ufmBF2~%_5>(G_c#kdz>!-~P;SPXFh-?xhh$#7{mTfoo23{a8E
zwfXdom}PcsN1cuMGt2^Z^i6NH)2{vxE})_jD8vuEp>51O#`?b3GcYm}aI9-l)TSR4
zP>!BM0gE3)0mt2-0GS<r&r5rpU3f1dGVdFjA0Gul0ci81AVgo}a|%FAodh2<|Aa2p
zl6=^AlD2lTF17&MYFZlY(?g`_G)<b<{wP%BqcVs~fn-n8@DFLNlT+~jdG3N$8i}zo
zY@P8`TcbdgZxFZTXt0b6CBiyP?M2(g{12f9I+q7>Sz^#s?kU(1L@tHy%lUNxXp605
zWk?2XVa9Y*?7|25;>?Fs7uA#t=W=gvK544bG<C3g=Qn_Wue_W%m5oVnqfKMk=?y&&
z!8b@$vorf9-DeDDHaH>$jj!rp3((!$Iu}?o&HHH(`VxfZJ&7F+39UZ@>o6T7M7t`)
z7YYLIXi$jqA}a6ufNoTD4`GoDf@~+Ald3D6V?|S6ftv1Y6!U>k$O;mXB*CE4w+IH1
zl8|n|DwfmM9jZU_HZ}PS`#s!$No(McqId+wXX<DS7Yj7yT`(m4B9*c#XZ2FELKk@|
z0tF=N6y1_)?-1YsIMbhWipbr_UBe@V@oaHpqC!|dcZyc>5poNhl{J4qfJyKB1+*bW
zWt}r-iZq?W)aO1l(Ys0$o-FhIj&(7sNkl$L1V*N(zp*p#H`VrJ58n5(O(R=ddz%ze
zPTj68;pI~CC*3)SR=-rL`FR-;(BzpFja@js9AL$1?NOZ8Mt4ekY@zqv5YzSRhsXrb
z6dAYpry%IV>T1T@9;#_W#o6g3uDZ#{NY~Ut={{{aiueq+Dx(?8%?QvAWj8Y-+z%rD
zrkTBu`DOYKbiXR5%;|?TB9!i<2<jC7;|iq(Vuo7~4^e6$4>|o)d?hqbsR2ybG=EEU
zN|d;W`jot&!*IJCqe*u*`Hw6+)2sVhuz)Xwxfk*e!~o)YSs`c21$7!F33~u66|?n{
ze9}1|i)CE<$GrJ$s-~=@m-!?1Tc)|mM~E5YzQ=JDCA5J$&;9>Jg}3ao-m-m6Ht$F&
z=iej}-`v@h25Uv*NI=UhxUV=VW3H$2?u?{Jy$Ta9C)NW}v&qzOFHe4#exM4uSM`-F
zNt@)!yMcoOFU6SgODJNI-wvCEf{wZllI$s-{32PNs7#}p)`+JGGGmr_p_v3pPrwTG
zx>%vg`CiEEd`-%*sZ#A0<6v+lsZvR*7wnx6{QG<==0`CPuNLi+<WS!3<4o<gh&?KJ
zh$0pfoxTAa1`Hb|H2ixv>R=(?xQbo>z}M8RH;k$YG8YIH5JP*y4~*)`YJKR_xD=zM
zLZW+8(1>Uot`za`(-ao>p`Ug)8~I^)&yJJ84{n}rMSPk<7D`qLHiwf%yiaEa$b6>`
zp+-H3nDQjRuLa(sUXMoIQ7P=&hk?dUU;)#kS`O2QWM){{$2Nf2%4gv+mfR+*RbCb_
zX08x3Pag?1a66za8my{!3FzAfz6y%{{BP74peik**2@1ubqDH>g4&~^OjR6P0e4El
z9s8M;FHG$_3;g-0G`P5HQ1DxrdzdD;Qi7U@c51*AVpu6BMsFP9uPDA2rl>5v)(E_M
z4KFILm0=C03HKdaZ1**+`hkY%GAZoja<<PNuKk<+W)HR96^n~uB}CvhtFSw4F6*cc
zr3@dNA)`~Gtvs~<>^zNNs5hp%a{o?bJj>w2a^9##ArCGRPf%i^<LCnvKJXV;5gPTK
zh$2>sEZq1OqiX@u7Nue%2n$=HR}fnvtgA}weMIevu!7#{FW?frtRTw9%z<R;c70J#
zWZ)1h#vaEHY9X^TAsjQ!mgrz>V+zYokB8HV&zRT!MJFpF@;Y3LS#Gfhr`X`xf@wqf
z6(~SS({C+)N->wMfdpTSLW;w+yVC`d!H-b}nO2@h=Rias)ex`r`146rNv?x8yy9OB
zx4L8ft2%Qzl@?%$9v^4*0Zb_Cr{AEg)rzug{K7a<kt$@~g4(%R;Z#;kmPl)LU$Gx3
z;eA@X>^gmsK^&UyAS%ZYGwn36=DP6~n57nbAdI)sujD;diE(W}NG$HM`wD^RqL-~d
z33EUlxt=78QiFO6Tk)hySZBl?cxw`kzyc7Vo84awPm81jw(8y~SI2b3@UY78@7Jk%
zEuJDeSqnkzIDEM-Ce|+*UqGCS4TufKD&AB`g<dW8@o{|JS;!wfJ~i#7kYVUZ&S{n9
zmtcvC=2z<RH&F-o5fB_38r*Od*DKS-3YL;e1L{qFOwM!a$ZZVAd(;`n!{SH9kBlD?
z&r%(FHg$=Q4QVEP(gB$!yt^vm<F&MyISc_DZC9Xe?n8Z1F9S{rg{3(Rf3(KdxBydx
zKOYOEBXqGuUZsd<VL5kpd$}YGRp^fq{aK<vL-exV9rWUTB^%w4R$o|ZEj&&UpG`3V
zZTpI-6UKMN<lKfnz%wGuD=5R8fSStw-p=1CBDh2x@gAV@13k?zKu!Q6J|8$qiBI=b
zm6MHGWNAdRL510#Pf&;!tAOX-jai3OqWLQ9>3D_at*Ua8F>94dGgO6Dv@vF7sjwu#
z=w%fQMI|2x=Yq2{TDoZaF-91t;n-cMw`Oh4Bn>|}MiI%AYAFYcdcmN<2x5RV|8sG0
zP=xoj`HeT|Tn8qK7lDiDn9j^E_o8}2S0?g27;vQfO9U0(zbBGCAX!nzOY2vAk^cQ2
zI!)f0Mf$ltSo$aa+U0EBCoOe5lUU&=J#1ZstVrsLEs==AGk1wjVKnqo5_x&bUgHv?
zJuR*>HI?S+!u3RfSG^;!u+gfxbfg%uVc3nO`Kj9|{WI8;<S<0Q?d8m<4NGV<nre~l
zijPlF#-i<?MX+&){`ik#0#~6V`X0q)Ldj`l*HlI#At#aLW(WGe1zD5j8%}T9{2@HU
z1uz9d!<@>ri^DpK%c18+5rdbRK`+`8h(J+{%P>Vg%N@v<L-KVW#U?Ip+iXENE!Wt5
ziCLZ)G!fe!s%QzCScVihe(4V<u;Yu{`SyUJ;+ke=0%=M80tC8XsvpjbOH2`UF^80l
zbxX92{aer?5sDT*E)CKytic-yc}kpaypxFM3i#U}v(Zap+s%bKDZ^g%!r>7yJ!o)*
z;I8+CVjp3d%&8#3AF$#jk-f6IRj>VOj8MNl^`wY;;wD0f%gzMxEaH3w-9UK^VSjI@
z!`<t=S7M3I-B@qttF2&@*dT2Y%VkYHJAj-fW03N)P&oU8%^KT10hbfqDJF5~pC*cM
zr7FgG7AN+$;+v7G&CsDDRCfy)CCEXL67QIb?}LW^0uh7)@og9RLS?ovKu7G`3GB>L
zf8A?uv)`6B(M^wI#$`=X!`?yUha5kBP~%Br&}iI7uQYx@Yr}ps{^EbVMa@)Cz6BUv
z7-7Gg&{d%Uc*`&$hC9T7Mg7s0r7sIJly;?(_$252ZtT!9Uym#Cq`C{d$wYQ*S)<f(
zZ&NR0BfB91KKNzOfVC6H5DvpKQ1c(Kt|N@0DSv?iEr;O)c<3A_wVM8#Xf+n?03O_x
zS(c}CY$)2mrz%B7W2U5NsI&`tR>OXJI80aD((7gThDWwydf#?orOO+d7Yic&67j$n
zNb$`O{G=nII8+MkAdb2GS9scv#ZgBJD(Mq?gp^JD{sY<ZAIRqaKvw?;lKmgZ2mgW0
z)5ftKD;mdip_oV3?~Elq<D&rd_P@iluZ`Nbg`#gI{GBO8hVMHguEG=14=-o>m65uW
zU0COpe!AwdY}iV_uKT*eWD}1r)bGTP@LcgGu;)NY{tYh!qlbo@ok@fGTX;Y*r$wpy
zE3MNb=qs%)Hg@^{e5ExskLGF_oDcDE>B1^kHqn)KVNF+c)UE5nhOKI=o6&`Rv?^FP
zs0;gURo6zbuq{V_r0NXA@QddldB6WMnPSu=W|K^;vW=dFtgfv~jM?2`bzg0>E2Im1
zIQ}bpA7pe#8bNck812s^F<Q7W9nH3V8l=r;XFv6AoF;VVBH4GX2e~r?)YFJsHcXFZ
zHP=LUDi_YvQ1>UaK6L<?XUrX<5q8)eAh3G^f*klN4ev{6xz|(*pp5(;o3qAOcjgVI
z-PWMBp(u)&CXBW?65Mbh3Rx|D$i`v%fSf$;u%X%Ag2J#Sid|gOs$N^A*;Hb_nwWph
z>VLMP{s%ZfMVnvZky8s6&9(h^ANs7Fw%*txfq4BI5IqTT=-YMewe^-?72p6oa#j#{
zHcMP@tvBn60I$L$Czrr~veWCc>a9|!bp&py19&(avmvDZP6b?W8Q|6gZrX>f*^sKU
zUS+>;h^==BaL5!)=(EHuoyBf!+4`XZ{`C^TR|uTgo75wdo+UYBB_6a6I~pv&Ar{*>
zqD{6^VGLEcPZbWN5G5l@QY%qs9K$C~8uaB2dNTh_zO4`T#F)JaZo<Z+kyg-X#EyTk
z!b?NEG$itCDQw)PZzny3(^f`LQYhM81jP)ZkS!#TJ`M|14)U17XNEa?K0m2HNR@bx
zqa+6MGbi<10l-PbWejv$b9kg6h1V|^z-tcCcC|3u=7!Q~tdSHyyqgj2n&!n1h@$>4
zS~xP+m!b`gb3jJ4OIk<1UO`;}O8ML+>KR%Qp{(B=#(vt|sNUdwq2?jf$Wm(LTUHC7
zChE<4d_G%uvmHD3c?aE=cI@frZFMu-u~uIsX#ZgEe34?S{e!5t3}-+&-Ca=cK{DFK
zRgs|;kM$kG@FhFES-uYl`jcLUk6$7G=C=a~p~>xN52HJXs`sSoyHFj%jmNu25N-k<
z<QPZeb4VdD=oiiCSc8TPO9(|X6ZYbFTvX)mU}((z8ihp13@C2^Rndp2)hA+PJ+W`X
zH_lIhkX{T%dZaZN1|Jg#N&87SzFnem(RTt2GUc6vOan<Kzht)I%Z`CVP&M9|cygh>
zH-0&5EYf$!6Unu#*Jvjv>%VNvo_*=7`?C#exTRbDcTgW}Dsas*CzIIplh~9kDfNsB
zd?mp*5&REUxTSZ!ohXAmiohobyo9y-YDWF$3V2s3z<(0hqX+x$s|a25Q1<IrLG^L~
zN38@xn_YqajG4bK(lu?(9(>)r-nS(J8-qvASi&x2AzR1P@2Y?ciUIzZz)h3bnyr#<
z-Vio-jgNNBl5JkPu`QVQw$a)%Z1y&@*H${zv}de`mMD<H8qjMh3}ojvvvv$C-PTCA
zEQH<P)<KsP!kTRl)$M4(25cYL^3#DdlrUqYA4TdE8-8Rkiz`j{Tad>TIY5;1Td?!n
zlfB0^$HA=#IA*nlG6$lF0jklIMeJy<(+^@JcEq;7OD|^N%UJkwDprTfqJ%WA!<5y8
zmLo*k74ememE~6Kl9#bFJ1l;hZX`(`#CLSP!X=j?OJsDy&`eQt7P&LhtnBu&xordk
z-4Cy=;rabvimzvjc24)~At0ql!%-&JI-k|u)mRtMgtgrjr!zHU@9t_`Q@nqDu0QL2
z+?V}SvnD&S%iGoh&FsdD7Z&*_WGBD;mYK|05wip;;#R>Kmwc+PNS-<KGE~Vs^H{G9
z##Bm?3y>J7o=tQqs2><7BSVDy%gMMPTR9p*wLVq=OD(d5^AI-foBqaJ><uN^18=<{
z;9K8}o%|+JH@+|X=Nq4(F#=VGck2rhd(s0MVbP70ewfL4$yYx-kahZYK$|~0W2!B>
z0l@R7G%b??#1%1o%$yWi4j4@{@z%ZmYEyRb+xX}sK?ts%BFTF)X@xc^{G9WR#HfKQ
ztjI$7Z3c?=9Fz|aQJhaQ9yvdg?l-XxyW8V3`=s5?bRP$@?A`r*z7E6;&ze{R`-hmy
zv{q#!@hdUP!~)r~-F~`=Xy*G}=!885!r(9Bk#mond^%)C5_TQ6MA4n=DM3JVIh+Va
z2?E?#Mp88p{vO#({4OQCwI{9P-vNXfp1Dh3g*wllv+du#?bqZ05=JgR(iX<I3y_op
zSw|B@*57TyqV@y@or$MX(mP<8FUk03yxs#>zG+|hUV`A3&-bwOJzm<iY{i~P?Q>SN
zr%_Vezbbj-_8O0lp{1ix?6*hcTUr%>(`={;-%_O3cO+8KgU#7aNDSHa56vv}`)E%O
zc(a$i;g{Hq?;~vVh8PX-08C+;H_IUrcSi$c&|Otv76Je2qySs0z$pa0p#n`Ra2Nqk
zE5I~-SgFt=J8?yG9j^yBjx3ub4{_sbb1N&8!tawTsCS;v?eQ<cJSEm;uYcfoDimS3
ziPuEoWReYz97&y|b!B&HMS8((dwq3<0qoPgk)GqC!6fG7boin^o_tU=ySdj}Hz1Nd
z-TSWg7Mrr~w$0>E>)UzWH;I}fJ~v?dm41N6lpC|i&V)(}cw3?XT1jTfBWmKC^_Pf_
za;n8VQ81vNM8rQwkxXJk6@y~<Pt24<mR3*bLRn=mhiez<2`k<|tzPYLAnL$O6Tl8{
z$#(W*{c>U(eBOcD7LM!J-7pEn%4^xCoDl5-b|$A;%VF(lL?_r?WAJ{YOy4ppkt)%6
z+9e)BHPLN?@kSk3qXTAL-S#Z@Kzv9YaDrvjq}2<~Ed>8e3|<{haY5n%X=ncCdNCsS
zaMBkCn(LZJu#y8G>pJ?dQ3nHU({f!kiqv@5K|bBh(ZI~7!I+&GuYpf6aC`X^Jzexa
zHzCPB5a*TmjhPG3eafTGh=8zkqs3}<;K-hJr>>FH7xS&+8!_MZ<3)@d16Xh;G(y$7
zqFM^>Wzs&`239<SD$)UmTJw@pGo5PUS}Fn()WlNP(N`JPdvTCYhn6wBcqhep9`JU`
zk9W|Uu997g??>(waYi(Hh{`!fz-<sMqvMDhEf{NpG|cl*eC^u}X=y3LoN#ZzMjUFX
zo0LRf;b3bI)vmJ$INIb=f?!8|w(n4oma`uZ`E)GCNL8Pa;FFB_a@KQ?G<=`5knjF4
z>ZyUg5n9Msve3gpt)_z@UR;pE4d@A?0Kw2s)eR&4Q7^Fs{#uXCJM7~=Gl?WF!Us~;
z9uBNGop8#5gM0;Iv3l(M;h?&)09)kK7I9wTFpaFo+>XQ=ADF0be<WjX?J(7=#|9h;
zHN68LgapVopsKo7T9++9l0534*3?i5KI}oAGtH=rut&)GifHWwN4$GD50|ItgrkI(
zu|I`h%X7A^&Ys*75WS9CK@!?w3aQJw<n}RsiFX}vSyGYcv?p7W8)#~WRT>h#4HQWf
z2kIrB?1$VCyc+jUuAjRv)p3{-JXzq;#E=nfNjl~GlaizNXg*7LPO?1fH7OsOL>}6q
z_hp|PZQSnBZxo;*zlQr84*fkU(Fb-M`s>P1w530*{6tPbf9zLw{ivVzHhX&Xwcv^z
zS52+cJQg`bSkRIN*tXseujI?%G@X+%i#?^v6TBCjbFA@zkAcj=x<uzVj-Hi#?M5*-
z<nEpsr;!@euLUcMTvY3{$hGkE2xP%B1hwcIjmtAWhCH#u;3XhfgvzmX`t{gCtv{Qd
z*QCDG0$AKP(I$*8+lE$nudd>Aya)3<Y#a9r)|C40<x6D6{0M1C?loGfJSw>ym0}Vm
z&cH%l%)b=y{u3>7uOSvkw^|mLTrPJNb)c0Y{6oTL<kmtv6N!GN!Uuy48GDV!byqF_
zGDK-(n7|cFZk4$t7SClV$5XW3*r&%^+meW9#_K~ML?Mqt0jpF7ZX&(%^{==^fA60~
zJ^3e=_$jfX*uK*~_~j@rr%Q8o>}`<;N30#UaPCwTJyHCN(r=E~1$)WsiP1ex5R9%b
zu!HG**`7edYf*mE@W!&yCxR32qDs!s@GNBO7h006b0;bv>G_jTw^dY*f*P%$DhPE)
zMXh6}PdId|Itxef_Q~3HXNYJ*9C(Wm>U}1kY~~q+I<$b(_7eKs&T>yS@N)}>{dh=+
zT+n^|Nhc)*2`v=!#_ZwAB$tbwH7o9q(E6}``3<yRus8A(n<SBa$n?)+?cRe9<Eurq
z##Zp5UP?EL*qQvMu$Bk;VcN6IT+mp%p2Zeyv-PSirjFH(EbU=sD#Gx~(mwP;X&R}p
zLA3cy<@E1CfFU_yYURLp$d9Dr{+;0ze(|X0gw_93OZ6GFHG@J;jRjw<P{JF4x$p)%
zC@v6(bZp`&Q*g;T(n6lH)f$A}ga2*7z<fBE=V12J>u{S+MNXnJz$R)llk_x_;x`g#
z+Ga}Fya8kdmOK6ikfgY+k@QqvNz(I2q7%KmDN~~7_e80X-w@9dUMM`jkZ?4MKOL)`
z#%!nC=sxsdJ5MJJ_XQQ5#Xasw9BCwtne=a9h?r0x<Uu_bNp;C$Pm^fBLRO1^D1%<<
zhbr3FfQl)v{#Kw8CYS-=kJ&;&ZSTT{EoEYi*ZTx#e1}IY)@Eq+dw1fUl4^0#v61PL
zo_$gnQ71VH6d7-LL#PsNW@ih7#&;Ejf@qwc1{5zF(tsv~-+?5v+K`QH4I*FqG7bHJ
z;s)i5p;lb|$48N{khFtleMLSGigM>iAeqJfhBwWJ-R!k9p+Q-%KxUKN)mKWKF3IwB
zYG^FmdZwqgEqi>%-xjroMmU!~SaP(f7~kH2V65_YVSJyG4%$I0%2ksiSY4dsDSD$}
zA_d&42_vmKLw9wpIzv~o-{{%wmQc$Np9(9YAsV5y@hc!`<MmxV(1;5Z%8P&yji94E
zTdZPLS7R!85PFSk3m+;{JQg>Yig|mI<~`B{ce1NRzLTc9K(p$pe*^@J7rU;s8p=vo
zB~z}DskM+Pmt@-0MD)9xBGZAL5DA~Z(eP#@lK8$5|5dn5ICqgFO=lyD-?62Gkg7i?
z^{4@m6)^P6Ks=I&$4u~6Ea{OjVZ}H*0R_EuQ90y*1CFL~FkSrtwtS+tcZZ%~%cLNX
z8&z^yj7NQwMk&LJl3V>Goqfiqvymm<wr-g4Bv*GdEtWb*=Oi7CV`MczeXTi&0Ii<k
z+mq-f9YymAO0#6>);IIJW6KMQtov!+_-rX}B6>inetKK4fG34g1K4a9@niUzoRROA
zB6nnuN{n6H5GhI-6X*rQ-eO97aMAya33Q*cm~*gl1`6q5NFMw$u~z7dc_HgoI@H#}
z43NY0Gh)g3eMoo!uY7itCy0KOkj{O%4rEHwQ0ZiM3gPfExVJeEAO^LQJW!X{RKO%V
zwoz~>gj8H!uApl$g6N17eMGuIYJe@@r_BTrUk3{Ku_4=8o3jmT))y=KNoGFQkiCAk
znJpVi61M?A#1HwO#6^!17u}~TPg5sEw=!m00L85&1N~cVF&=3(=w6cZcl-`CW@>;#
zA5U+iKDtmJ;TO&55#%&x)>E+G39Qfnu+(3|X8l3rIBBxE#ec6Y+p9$hZ?>a#;_;Qg
z%3~eD9i}p}ZNNXH+78p(V2L8dDl$Rvy_|Xg4_3f@Cc)rGQSWP|-uPFjE~v1+3Kjd{
zoL~57vQmS@7RC+pFpvy%iYIJ@b9d0=h69m2(BN9-Pv^XbnlZ7<&Y^^}F=OT_{D4^T
zd$jzBAAS<)9)clM-l_<)TMU*dM3I3yuz?_I2kNS#IRe;%b4_hm77;&X$}I<<<mlEx
zX@1GkZN>J&Ml2nM5Il0O0n5)d7C|6fu=oPq8BXuxVcbV<ai!o;1!e+R7KnfbyJLr`
z8*rr97t~oAbFsAK(rLC;j|0p-|FApfQ<0Jze%6~=ewd+c!}5OU;LE<EYQ_8kniSn!
zt#mU6IsFTE-N93A?S<|JZ=!M-j-rj6A?)D=lUMtNLZT<1s}kX}<7c=ZYkV=u;~A*_
zFna2pTiBZyD|C@;_xMZcTAz2maK)bOIBlvmKB6%za;S!hU+jKyS+CU%Ji+u=gYZ4u
zmREb|?j2{-uWr$fXN|9Q)jndwuLWt#*@9~=eOA3mimZU7))tA5?pkp}0z-U?9lzG1
zc8_Otd!!tzf#WIr`&zKJ88cshPgmn9TYr6A@YIc>6N~Z4!A1`OaDDvq3wc^G1_u<R
zbt7x};|K1?Hwe;SHn9Cau5;g}lwvoqF+VkMe?uvmH?a49a_GMKoEdJ+b+@b)6-I1g
zi*HPF@3cvjoEw?T%`o>CO6l8;yF1_Xa0x!P-c?if46{gb_~qbtax2`moj<FL1C;Cn
z$LqHqQ08|#kbQEyo$ky!cI<YL`|qm+%ZA(7gWEptXOz;Tt*q{yQM%Ua*t9z<b*I;|
z+P}o;K3mI@e;KN~`Wf5&%UfOtNHBSLX^69~l<~KIrZ*zkFW0i>cl~t-KHJ^n?m4Z?
zgHK&qliLBiWB9i&?)Mgpb}E*$$IhYdMJq&U`EoYow<hj?Dy1pQ+55k-=1*24m>P($
z2pM7_4et!EA+>s7iFq`GQf2Qd5;k4MI^TD^Q7c>UnMZ^&ITQNF5giGYQY(BB>!_$u
z0e0Xu6eKx_Q}JP7(8WE@SB7Vi!Y+oeh>|s&d~DU&JyNRruVP`pKW|>Dl>Wwphmg~O
zCw+1m2ezV_ISTgLO4k2Ds(ZZBqjM|Swg-c19|O+OA78FEl&)lT%G>B}-eFzJ6Mb`L
zA!=~wKLuJjuo-h78v|MY{vEcaJkAm}TSz{e&|+gX9doiuHWx+k;e^~yg44egfcwyR
zJ7Ym5{VO2TNLzY^s>4ba@^Fy*T@XWvODoui4};vVD5bAgu<ssP-8(C#&=suRA3^SI
zm6B!!8~KN~dv~QbH<mNoAG6)JDWwt1nfA{h_Z3PhY&mQ5=iGL$&k!waTL!6cIH%!X
z;L2TiWn5GY=Hx4K^-^kOE@M~!9PA#bl!BJAPJcCa_g6}lOWCNuyxqqy7aV_D%F_QD
z?rsKS^x&K2?3cerg`@)a_^4LAxtzEZP40yvC@^qA{3M2$u4zqP&Za!_)y-JW7Cs8r
zy}g|6dSo)qMAe+*Aa@?2C8iGOHZNya9|h>xa`x;|yl(1p*5&cWI^Th9RTEp5u-_kh
z`xjG7?l1s~eN+CXEFwj?X>@Ju>QWZ;BslIIkr+YZytt3XLW<!tsEMltr^w5B*b-AN
zK%bDRya<Fh5AF*={#wcwJqgmG%e$UPy6={<r%!e?|82=jL2kn8b6yt`oZ;(mjhl>u
zx>}R5l8QFE$|bC_BDm`lRLPktq>vW8AUQ;f8V2wT0#|oEltA+cw2g$Ip8U+%xW6NG
z2N_%acNg6cOW4)FKd)oLB(Bni`zOrtw4p9+G5g|aD_yI_?EKT<{(&IKIWL+N{}hcS
z=Ame_6~XC1lsf*m0No_eRRV3r{T|WrBm&(e(8?+?o-StpkFIZl>-qZs?|kY*(Z?t1
zLm^TjDk4!7rQ#Ds?riRt80Ol?oljJ#j}L}9GuL4owqdimG$YJ4%4MU?t!>6>ZDzB%
z)BpK8=iOz#zkiPhpZ9saUgvdQ=XGwc^E$W0=MlPscUCWXZr0tz`t|dz1D{f>$1)_I
zr;dcEyA~n{6YVN4Av8xcl=}p06D!PHCE^>280IW7{)B;RTw=Bn2C35{)~lzk&U+E8
zd$Dr$vls1Lo~xdv&C1p7U$%ECRH46Cte*d}tIJXq`e4QC3kapDP_GrMy<Y{n*i@+g
ziq*Ye1-cASAza9`_*Dy+aVqrr^3~tGYUfh4Le}M}%U8dA)y<``!ZldFI=R&1@>t=v
z*jMM5{!l-dLa1zBe^V339FYcm%U2kj{Z_ntg7xsaj`cDk*z*?=NbEPjo?p(JGuF*(
zsfJGcFM8^7Zf7jc#c`e#BxpJRk+G&OSLVv#3p=l-V=Y`ZsNhLEkI}Ixms56$y=Lc2
zbSzRg;xa#}V`GDM%#q+`NGT@*U8wMrU0LNGatujfH&j{92RgC?L8ePMpNAP@*^=iN
zIZHc)g29p}94jc1_JARVpPhGbVt%?Nm-%of_LlDJOFYks4cEmi=fQfGq^ov`&(kw=
zjo}5<ozemtUV%NsFY8&G`in2Z@XRiZ&c+E_oc_$UG!pBnqs-DzyvTj4ux>6P%VZ)6
z%ebWq8|JcftPK8S<2S1?AD3Y&c+keHRAo(@w^YHUHe_=HL>0c|zo8SL<Oax^LH#`K
z+t{;|52(s~U4BWC+#+p!QB~H`<r5Wjvhkd%EW+h26+E8JUsPp@E*>iQb~f+j%<47Y
zlC1>8Pfimw3h~Q5O6#;rtD6OB4TwQnQ<m_x&MdI*dZn#@vOphA^vj7JhGjOt?u?@9
zm(9Ig*wz|v<ta76(P(=2C_n4Mw(IJg=aZ|kk6k}P#_Y*q;Ck4`eXFxr(`i8D$*uF}
z<Ba<|V+q~#osG|_&b)Qs+xWWbY>;*BXpmsp9?B2f1Zj)0C`jL(Aqg&eH)hmE*leFf
zaVMQ1OX`A{^Rv9(oo<^;rxXTC64TLR3jJmUdLE&vN`W-(xI#x(pe?pQ;Ng8Id<-TD
z#NE3BKZByfd?WPb!+e7)YuxhrVkd_ZTKUo~!ADhme2xzgbOtfmy5y`Y-lHNNY0n?H
zvPQa48+SLL7Iw7pa06==o(Cqdd2Y~;G5#1-mW5A@IzEYZ!&-cT?PN(~as%5$WBggr
zBrWFa5Zij6^fV1M5qJ5VM#{e-9CJ)K$2*?F%8Y{D1&pLQf-yAC*2M#4B^u}xfQnaA
zCx%J$5tV6MkyI(%kEZWHRx%Mqkd7iCEBqc^v1;!@C2$eABpy?P)z+QO=7Vam240_O
zT!X<i!4Z3mUrzf4lv}g;${H+CH#?huQ-cNQ#%A+-HQ0#ZzZ3VtxBwE4Pg6SzbkYLV
zD9~C9L{Xrz7MMZ-Pc4v6f$CbIEds?gF<{5px)H<u*?fnQ&DRaf=1tvLFP&>PpX0_t
zb$@2@J#H)@;tyo0#Fg6lKu|wMNF2u?9B1q53}wZmiR0=Z3CA=?d<+zBn7{(b67E)$
z)pomD9z7b+i&?yFO%&?BEdFLqHbS>Fiyx`U8qn`8Q0pR>@JBUSptTR_G5y={;zdwo
z+8jMI9_U;J1w0)?Pa<Azkw1oh_#x*^k}>W~+8ieag1R&|;XOsf2lTk;jQGUp1X|O9
zZdLG~Y*K_TZUWqSJhs%$Em7$<jG%6S@-4Mk-I47{2;39!8%F%lQrly+$G8@xvR+ip
zP*E<?i7woEp8m=ix5L^^jbwy8aR_iCZb@~+UnAZwiLtw=R1tdu&POz4p1h4aYhXUU
zR3+BCa$;0}4rQvuB3?@@OGd~Ojmi=utuM>u@4K^lx|vJ)0dUogUCOVyGr!o@X<&l)
zMCr#EfBexg9}xdxC1o03$sheS{76?9TF$vg#~`}lOTx&uW*U*fqdb^bcr~P2k_I)#
zQ}ZZ#Q?;U)(p=e!&?-&8Q`3fWg6N8TyJ=^J46gp^rU&2Z!3OBkm+<EvtVO`rpetU0
zQ)m?(-5CN+kRTL`tnL?<@Lne7p}V$(k2SHeF3V-dVW_&0Uo$aZ-CQs;u?St-65h5p
z>)Nd+Brc}S8%Q~jzR4)WcUAh<oL(gh@cme|<)idnqQ2MD_igpv)XGoSX0f`z7jxG-
zEWqfAWJ|t_bfhyxrtV94Y#r9PT`I|foJPW^DWT`|9)bg2c7ywcKD_X;lRl^xq|paf
zlug4H@Xd8tQ(cwC92biR*KY|XRENcGGB#9AwaGdfzl7KHWWl-?OL(*=y8qK@e3&Pz
zt8-k!=X$a`I&^I#yfDseUd%Upf#a!6e#VP=5AJ}x(&YT;gVNHJ^aXBJV5vyChr(tk
z!Ksf0ZZ&aC*ly~AuviDGlA0(`cm`qL^ap4$KxqqVQH2Qw30jqh>Q}uN^O(BmpnNj<
zq`E9xcPoSMt;<?_?2=_%Adcf0B-u-LQ{)2vh$y>fa=&`4srBl7@Erm)QV%E>=*28e
zpa3P%9fU<YP$_`|!01?Cfcyb6?(fkYjy*5h?NER-D|S;0Gz{#TM?FUJSVMvRrOENn
zeX4r>@mgDf_zr!nnV+r4Ou8Ovyr>?luWK`(zpBSN=uTwt4)xg#xAll79>IQ+9oJ_W
z{8)YF;j@RJmkCOWIfM|JbgsxHJIikRJcIvRp9M782Y3md(KT(QkNWtq(+5SFM;}z=
z6Eb+LH;ZrD7Xb7p30bj1c!G`bz=A3`hw(kE80h$x{0SSD!S{GGPu({&_*rk}8?z4J
z63>GUZqiM&9-)-XCl(q*jbJBV^2rk$uxJU*g1ucIt=KV244aSV@t_7QL|2r~hc;kQ
zx?|~lBmJIB=QkR#1Q(u8WQM&nd5eaup>9b!@7a(I?4Aj*aDY`<5{l_PX0`@L*gxQx
zNc2=+OH4Ki|0PwzT>+QXIPW()3fmoBDy`F*`lj>08?q)=8IL-28}MdZXW-@NQ_fFJ
zBZRE~SdFBPZv<Et4<>dhJcz=H6=8{wd@USA;ffx848`&Mt(0>gw4ia@_<kSO!W2%>
z^{S;0#<gKoPj>L2M$FsT5vYV?MLs2?A;DYQdE-XR-xym4Yz1J-c0RBXM(4rld{HA*
z@tNs-Pa`(cItoN$t$@nnP&mI%L$L+o<2(BB#mCq5LAShZr4O=(-k}dF$yxYFv`c;H
ziAyrLpks-~<%rZyPohLcBypy8+7)%i^a@i5(M*!jUNKy~##j2X>blGse4{T5ba}Ce
zI7a=kh+pz$U3IC8cwIl{qZ_}7NBUv-J!at}{LriJvGAFG%)9CaDqPzI-e@)R;$Ql)
z!L?k$0NYON!As~sSA@6IBJS(YM(dg{<V*e8fx5voD%lO2P|I?#JKI6H<&n(#@AvRQ
zjagS04~37);5!?$R=VDM_>IPFsLLu@D-GMy55zWM?O4+}$gaJAH*k87GJfq0m}qN!
z1%&F;9jN)~{DY><<kFzOOmkTJful{?m&|3M9P15R7xH<{SUr~uD!5=F-_ndVa&bq`
zfyjLq@^j7D%!In1z&&E=0TF-LCEHsy0DzyqjqcPhT}c*v+1%(_M^KbK?=kcw)j)j-
zU?5+U#<QD4qqbfAN^{nEWLGdV+kV7ZESl`}1N)adCHoeHup9W+|7HI?suKG}-%9pI
z#r`1r?i|{MDE<Z<-0tn<GXtT|266y59L2a4$adG<Cj0mcVgNQ(f$Gc-zBq^tzzyFr
z(Jkl+a;gxQY4ZMd{eT@Lr92vn*GaV*VEf2QVjMdz#pnSTq{blCG?;~Tazi|LTas)K
za2jrSAvp=;ybJv8{kni~Grq(v#3h$P9jIvm7{u87cLgqe0bd`?1_e$e8V)U@-VVn%
z+&ECK_=_NL|0bYL%VQ1trXO=0IN#MY6oUogC*mjPK3b_*d<@-NJW?PRTc*Ocn9m=y
zU?HY?UXr*UprQz-1G=hF^LbcHHbnQuhkQ*-)<!q)Lw>F$TV>j!X4VnZcAgxSiu-;$
zpBlot=<M71p%B(bm%N(SXoW`Yx0-io#o}}~R~=Z`iY;R<*OYJ2a}KW^%GSArso;#+
z{9q`%=<*K+E=as_7JsJ=^LM$ef>UPkBW>72UDM8dUl<!%_v4w8$_+m`vGB5r_Bm4N
zS32>QZCOK?NeX{$1|NW+F1r(-)fSC4CWdcp%ZAiFj&1;n1mY)$oV23fAsPLCNAA&%
z9n`hy$n)E=SU2~LvH~V<CUR4hkv9rwUJ=bzu=@&hcj?E5i~jp*_M#ndwdwOVfSQg$
z%QHP@oasrFYx*TM`1EkrrN#u{%V4|)KON3Gc==Kso9jaq%79HWF>?*7QWtQsS?y|u
z)(X~VIqwj`TIkX@@(B^Fty}tfDc-k`65`pH@y{bz<IX)4bcKW(1}>}AYHWtt1kKDf
z8_hULY?weHyq>FKj8S~L)ZiQ2vwGNxW9nE=jh#NG5E;6hial(G`tlo#+}MKefbWvo
zWWFt+og!!xcss<jYdU2>d)Q~tS3qP%-ICeV^Y^9PXDDPh{bZo@8Z`buA`QFbkLeTo
z$;?eOnolQY=`$%55w&;&FKW+PSYJV4vu)u)8h5hvPgJN-h5lBdA{F{wh0dtZT@?~4
zRHQ;rROm+)a-hyDOHZrfNWoc!@>R$Oq2f%OCA4>7)vc)nwCm5Jr69s275YVm#;H)T
z3XN2uKUHY33jM1>{Z+_FCVrMaS%v;kxNiT!#c4R2ykzM+vi00Ek~OwA0T`nGkczR(
zuoap`fnIr!L^C;6$4@5i%Q=BZ6Z5c2R=Se1U`}uR7wGUC^%MQ3Hb#^!D#~AoLPv5D
zg>LuN$a6IE<K^U275SnpEBim_*K73hSF-P{=%@dm>{Ata<2!KqSL|s@|2+UXdJ31i
za3jAL>J^UR7z6=I<>ebD*C3}r2kCdCZgBM%vJs0ZlzD^KR5b2|$gXhQhuAj5Ud~gZ
zSa;pm>-fGX79SM^M)FdlOQ61nW>S8Qsd4EfQWMVUN)p50Ye}m{%|U1S1hjPF;DK%(
zSq5u$caltx<0oeaoH=6QUZf}Y_n~H`6@Q|5%>*yx!I;sGm*RO3_7-my&06cQ3Na>{
zMOtl?M%nwA{nc1=05H0-1M8L;a0*IS=2BI~PL@!Thn%Tm7Nv!*zYpT#esx^Yk${8O
zrKb8)WLgxIJ^lA@OBqw}lXH<|Ox{B}p~t0Z6JJ*|_laTps6XM+*BF0?k%(^57!5T9
zNZE36<lC<QRB`eqPB(~CRmn;3w3g3|VS!1%z#W1a#KEc%6@O{810SbFzKzDEo4DBy
zhtjB24^cui2Lbmn@Zg(mS>aGqY4R*m(VE<nIzTLYm*0<J-nA@}I5*YFTsj<k=JZ3}
z<=&lHs5NAwWFlST-{Cta6V?;0Y*gP3*&`<Un<eUOcc2z)s0W|HPh@MG&;cvjX;d)w
z1y2@s8ar)7N-B-HH`{@BnMV69Xt69shrels;vGuDuHklkRyrJMO!hQp{)%kkYoH{`
zB%*a1Q3f%Hm>exJHp0BGVa6+r5^x=1)@zt#VASnF`MhN;3y7T!01m!Kmmh#VOyjM(
zvdb*qR9JI4c9X*T;L0vs7A3Fjvhnw0S);BmF~*r~ZHvF9wqsM9xm-k7GJCQnV2_fz
z$je29DF`^Id%RqPpMs!+!Arzk7srMr&zu0=+YO%MA^H=DE_9!Qk9H>Dc!ESee+$T`
zg#7grLgI#oZ)9625FwzhyfGw|e;&tzd;d*z<&XB@pu@)qliQdMO=Pa3;zk2{7Ya{|
z2(>g;dMf?~MDn5nW5ziu3#@&+90Uw!IacwIcvj!q22o3U&nhth7C_&qXIL?pcPAJ#
zXp4i0f_7*V`bo*5x>$FFIOL0W@SBJOiWPTb&_;;Fh_FH|#uziy)F%;6hqMDS$zuT1
zsTimayU4=j!aUE5XSI9QE0@!PyL()~1%GsR59AG%kud`&P7P?DZPSmHoB$|IjwVrU
zG0x@)W~qbKVM{Gh%tN{`KX#J$?ZV=%A9s}+FB%Jtr&K|9&h3;u3TSBt-2-CdS>-9k
z%aA0x{XGCXq(TSPMFgdcYtbQS>L>!70RTq^y3kDSqEzDmwAgc{z1`$yE)(T~E{k(j
zA0fi=n^J#(3dHlngsLv?!5-3BT6UA<Xy`8DCXejOdKsI-CkTmVb;LIFaIukZ=*oPP
z7s*wk6UA%E7Y=x-X^MpCchV2!$Ccy;Z+|K{cuGw+K<RQ2n?4I)CG`NBB?&L%x>38~
zA3t8h%<44yWCykNe7fEW*>w=>5w3i(@d4h&%o@hzQC+m_cLXCTbw0rhovOS)K%Q2p
zPF*Z+GQzM(`|D9BydSGP#L7IZ<{z1vuXPr!5dmrb8vgBK*~Ta%BQ$U;fFbZI88oHS
z5AtP%xPPW-`Fc>|LGNl%7OoSlw{yvFW;_!~k0i)zw!nQWT14eMt)dn}&l6XT#QVfp
zM&msaSnZ^V1g70z^c=6+do^_%Kz7qd&?2?t{!~FAfn!P*Druf*j~KMu9=Dj#isIxT
znqA;>iab%oKTlwu{->!^g%?7`&lgTwd=p^N8tei8BZ1Xz_!(I*C}K~k9zU8|V;DkL
zPx`2D=S{j{TK(rTCC5?zMmH8$tNCaIk?&Ecz#bSo#7Vxl8}kfs{)kcyn_cQi$}PXC
z?5__2#?Cl<5X#_!sBw@#=*H^#HQq&OVX6=RxtZ>Wz~dj()7nj?zACvryhV5BAHG{9
z*OZcLNy*hDhIUhqB+D1$Nq;zxPl7KZHt(V(B-l=^9&xcQ-`<^hTaS(e!_3RFYwrVY
zId6gu$@2bol0gj_ZxCXzhFB;O>b8`Gp+F4L5aS4eyZ`)2#C(xJqEJ6~ni{L!6il)L
z-l`0~2XG#p$UFk)NtPf@CsLa`tRSLXrzlflH&mznp967Jl3Np5VA!Nv;BCVt2)U`g
zVgy=x3AUEe$pAPxdlL=_6BY&CipRm^g5N2ts%Xz|C$jij{zD*!-Oz6YB;N?hMJL`i
ziS3B#Op34@)(;2#0l_o3Qs4fiKdtf5T$W~<Nt8FcVFnTXMMT3vbO??(OnG_39;^X-
z$UF96U910sTBcq%eVecB!8~dOfiTJDgj04n*FyA@`Tia((su?3aY?K(gUl<WFcfkj
zg_*;ULWDEuMsSaw>`gX;PwB~OkEs16GM5$WLj_6#{R~M!{tJ~uXCl9_g*1aP@Dk2d
zeV>$h$5Ne=6;q+h5_*YcU<25lC(wmRX^0XxBJ4vr!RGo%{KoI~WMkM~o|McQ)*KCH
ziRdfJWZuE&Co^p1;#-qh<N6=aP>EZ|?4~7<R?tQQ?4PxwcYy!-mt+=J>)__sGX0!4
z?*$)y&|==B7wg<^CB%mG#e*UJ7bN|aO;mR3MBa0SJWt4dgxpU^o8d$zKi!M@G|3`=
z5^644bKfi4#YB6OXs1Y8)0j+d=*{}X4X4(l?I_lZU7yPklt|maH^@+dSR;S)L>dj=
zHtbt`B2363vh)qL91Gvxn??5vkl2f6R6dxkj}W3M^Jc2I_My1$3=eb6OJCsWXo105
zAdYMVFVsbBAXb&SK-`vD#Lic(Qb#+8_jp7f)}-B`YpPEKeKYYXdTUjw%~Yv30;ei9
z^@bP3A@mT%eNneXI$zs|_2?HsT?QRbgj|K<5ke%_J}DQ@!lid4x#pJ3wV_<D+On}h
zE=^R(g{PfH`zyKnvL>AlU9Bt^%;a*pu8NJokz7sXkOR5UooaGPd%8e`@=bkNyl*og
zuum;wdO&JRNn0R#P}fT$V+K$t?r?oS)`6YpG5wgQu>=)T;!q9`#6mu<ADh(b+4}(E
zl}zIz+@ghkqCkjph`iMt5BhncQed>m8jUjxS9#U`EHv)t_ox;>!84CdjTy8*i4?ey
zVnT3LEa+kjaLv60S#T_GwEwJB+&gG}HPq6YhNC`wL4W2Kbb`hn*l{ImiA5u@0Mcxa
z>?%yeu2RRYf1h9I&pexc@&WYG2jxWlSre*-<%cWiHuHQ@3$W1K)tl2z{I^Z425&il
zRrg!F4up=m<W&#1IN_2Rm^g-rG^+1s>1}p><1{{G0Q1s4v+`L3Sa7XT9<m{Q*B|xY
zRt@$42tP1@#aDMg{iL&(sHwc_K<4e{I-dyjCkK+}!f<LJZ!?g!4ZH6~hDffM!=(vP
zwWj3eK-|s~x8DFqtjUOVgkE4q)CmLm=7G#NjH{?>(?|mq{}aH>cweR;;^$NR<to0P
zO4WZLe?(EED@Q%ORwmt7MNOip7bz-cnUwU60aD<b19;LPL@hQ-fmNzgRMeM%A=O84
z^5$Hos6~Jy>bolH+5vp~AlA6sipo)ItEk&l)D0B%JBqp(@Fd#>X*`kjA^uoYS{jr7
zqBPYfy|h#oLBqM+{SDU4XChRO3vQ?^-$g}}hBD@O@Q$Kq%}2K}_zg^tx6a`!-(af-
z)tEzq%Olw_bbX6`CMYAC7&GZ&d=%_`coAW*R3f3xbh)xM<cWjw_hd;!0+LyXzEWM5
zw29AslTB}Q<T7!AS5}P<u}~vaGOsuCwWd1qmBNjKnGb`}J(x9fud2{Kgx*K!YHRq!
z!K}V1=oex`oA8ZUUr>XI@cwlU-#D1Hu~u~lOIZ4jq+Ger3AfwYO%G}jxIp~=E`iU8
z!qxaqf1<NErDP4o;U@h|WE=#gbR?X1)x(m00h<VQJ4rmm2hN+=O?PGMEf60O7tmBm
zi5RHEp*`D4dI%TpN5KT|g_BRZtF!sUAuO={=ZP|hKPMv#e^VCDucF<6*ylkPYvVOn
zdkk*Jq+13b{v>(Ml8nN|IDU!v^q<XtAHr;PUBCd1OPWC!nuD3$mHLT1bW86HWz7<<
z_5kby4ffePlu4stNGnl0X_(ld?F?GVIZ1@uG{OuJmN?Scdbr7}Q%91|9fz?HueZqH
z$*OA3YCy}C_1`9ofKvOMCk}(3_v!mQIgB;r%Z9Od7RWCTV=20&vAq3o=G*kURB8$F
zcti}{raWMO4iN2teN6f*y`>Y>y_@$M$?Ecr!<kWcKAG<x&YH3}3FbLmUT-nRxl#lA
zeYtFVvjIbGnU;hc%rrokgIAQ6o~}xBj^cChE+cohs!5WbL~?*gB0y678IWYI)&xar
zXWnB3^YzUox9NYx+z&{_Jpfy#^ZO&QwDidcNO+_tKRkks3jH94q{_El5_6xDiuDfv
z!{yPm%3O-3DJ~O6g3GHOeBMa3wOTQJ??_hPcQi=<E5aN9i5w>*2k1uj;GUycqgq{2
zbjW`+`B`>T=9=^Fqp*`8GMX<Qg)A+d`Z~V_fK+5@+*Bz{&1x8&u!51)S)J`%oW%bb
zg<UjrJMpfgnZNJJDX+8n8juP$A5I}Qb&RvRS7LHHk?$MLMtd=`sOSP)I;ZsyObM07
zZ?$>I7}mLd`?DxX+bJ7HO^mBgM3rZxMmfIP`0_FAdac{BGLvp*WU_Y+WbzrGo5FhN
zs%9U^OJR!`OFz(K9Gi$mhCmRaN_Jif7HEq>XrGTTJy++P2ou0>zQqbyGXHEm2JR4E
zJf4m7v38OC1CUHkJs8HKRwmj2b%(wv&zckY)Cut6+=tr*MU#yA=mVMtW?Ar3mUMh;
zD^VZ5bfghUb?`wMvVI-{4CV7hXR!7o)*JW_6R?E2WCDLa0j(xw0<S-j#k((2!<Q$~
zbs{=l22Y*H+V;H)FAvVGKS7G>QCJuxc9Rcg)$~jzb`qj*uQWclrcC|~n4C`<EDh;Q
zIp&c>Wy?#+!X#5%;jboQu_$sp@A5YDX+EBCH0Pm{Ak<?G6axTCq%XR_Gv<{cHHa<@
zj^QicW~MrU|3&&(JP2vxhrz5#WE_-)K7;lb&~__*cL2l}2uaS$dW9cr66@cm2&m!{
zNEBq->6`2vd{3e8Pt-T@D<(@7a5ws1t-kM|tcsVY?;ZFqSpb5gar~1>aLb1)r58g<
zIpLrYs~19=?x6SxpprKD$fOTi*p8zQTG)1{59$qnMly0?dnbL!g>8J`7^ElqXk5qI
z;7`g-yeAy1K0{7Or)qjsB%B5g)Qg#}kAWW(Y$7LOiOO#H{!Qtm7g6M($<o&b9h5EC
zA9tbJ*^_5e^F`X?Pri6E3+VGcprLqV9Pf)4`=V8f*>aRM<cvXX@URP9{<-3ZBP4?y
zGwEJrI*o{$+7l$WNhX|r>=|+rh`Q2fC}&fcFZ-AKPhl&Yg!HDJ0%&YP459(A%<r8j
z1KK@-o%oMaSo?vAkPEV$#iMP-J4hDySCp=y?`X(Edy+_&>CzchE{pW++VsVvq%4>5
zqdl{f;lG2#gd3zEpEwoM&gI-Tm4!#gKa)-55mo&@R9agWptPc(LO&`1Dw}6i!c;bw
z=z}&L%%Tq}n})I6aT?p@)h=1f)&nt|hPtvF5Bu;_(^!;sKIoB?AA2GvAEMz1f92@&
z#ta&bnl`mQ8zMQV8<|i>^2X`ephbo|f=n(&Q-+5~cM@ed^(HRsLtMjt8is5alWaKH
zh$N(bpNK6hrMB2er|!5XOH-GRj4d}?8%fIb=<CExP?o%dT7~f+wp&4*Eo~*KB2Y5J
z*~&uES28OQiTuKJ*0M$h`2uK(j3nB|tEIB0{rB~tq~%G>8yMrL;eRK84Piu0hYyIl
zZw}$q>8}t}F67~Xn$w7>WgH5{`!Z&MSjCs5ve3v=<UTNH9DaqvRvC@PjE<E#;256d
zAbamXa3G`4k3ULft=kR+2TFckdE`{u8nv(mRg_#3_WdN1U&cLw;hjv;ulZ05^Ydzm
zL6(#%_vZAMWKt<s{=S6`?$#M|d8+YyRRw$g#%m=><3LATI91*|pG2cV<>?I=O3&62
zdHWT46Jb1h2CM77JenH3VHm;b={?~xhrd08HT0UYjKnhhfvJ1W6eNcHV3r1#H~(-3
zYwG=J3ZZfDuU(RTNMutLnfR6$&tUC!`p3NSOxB2H^R6?QnW0am&}sg~OjtW;cKETj
zgS&?oyrLntADU}Lm86VB{8cF<xie)(k^qCiizAVsFIDf5S@7k^lS#X?NtSZ+`ULU>
z%E3h0m?*1&lKSRo=;H`wI1+}SL!2!E`_3?j;LB#QhJN$mq&OY@0Q3+n+B5q{3@dii
z9%^%qW(jmX69@DBS*(7Yy2v@Mz32*htWJmE2Xs@DIh)NI!b8(&Hgjhic-U<8N5}ZU
z*(|F0z9`u;%?W6kd(nx4*~&K&EqzQf{WlN^#$N=JQQi5`+2}Q<@msT*r!^Zi(7wvq
z?1&tB(dq}}X`-R5E*Qym)Qf2JC(KkGP{naIvGktY&7v%yDy{>noSIa=<0zt3k}=~J
zS%x->m@Om9+5A34!L>h$5pNgH*pIy=xER~u3=wi_X-%SOB@Qe3syXmVhakGVu=^3s
zck)GFnQUHy?U6{3pN3s;fP=fn;p{$=;fa*LwUhz!+D%vcGMvLZFTR*A{W>lvramaV
z5^~}bz6m;K!mp~pPbYi>t42@-cN`MIG)2%H3|4~xi;vVemv#NGkb7Y|LBitQC~A8A
zB*F29IQ)<#%M*e+LkwR3eLm#wAXyUhd`Q)OWok^FYPQ-<sWP22Vuyv`lpaN=@pld|
zqULL9hmqN4D<B0mm!EmU7r({sNEf9ke(LgHS@nvD=$|c-QN`c#7gzh*;(4!mSbhqH
zbU7ZHihI*4wWi{)0Rz+GvG~<AH2`BSX)1J@RCRll@jsaU%cED+bGcWFPRE{*2&OcY
ztwbA6cpnqZAz*Q%3WhU!1}cs}Pn8^}g5x&gNGG?5<MGcc1PbJJ=CkfmTX8(Tc%9U~
zEZ_T35()JNSRi^sL`Td>X6c(#2V6w^N-VbV&GT6YLvyew@y{XmlDNxTE?{0(CxB!H
z*Xm-xV&w<2Jrv&fgaQUq+o&dt6ryIAkp8V(Vu!a2jf?tWs4RA*@v_WT_zm{4)R~NO
zgF>>oYFzZ<EI`yaH~8mLP8Rah3$PvjDw*eYL(8_%z*e+9@q^5hcMs$V9SZyc&2dq=
z8KLQo;15Qlxhft_Ce2yK(xY1GCt!3%kp>*FDrxsVh4*G89mJ?b#Ag+8d!n@b3JU-8
zl_>N?@-d%b#iE@-iINfqQ7(`uZV)9!^Wr`UmvSZ$GM|tSr%-<NQ^+fWXQc20_cA(6
z-1~p*XGigZEa)tK0>M$g-OX8H@$_B(#864Hxm4d;#y*_`>)yd6dQlvkp@HIsjRS`2
z19;CgHmu>__kn>VP0>thU|J82jco%-#?oqT%_;ms8uP5@hsiA-ns9bV9c(;+1$)Ea
zebwk%d-vLfm{*M0#TzYTby{JcKFX$pgE6xzRm=3#o|cWcVJ71B=u5TepYqZ)I9ncb
zpM}h`{VjNqRP2pZj4HM*YBPK=IOGlEWum!5@H&L1k5W>YG&T{6O@?GsdxFNs(gL>&
z5f_wVi+((C5sRt!=_xsKWg?@(Z5t&w&)<wbUvF>Dmn>p_wQrRJQGfBCigc+Q<GG7i
zBWsI3C>>*_17*!_U<irrbHIaca#6P~k->nHTie^o;V7u6>Cj!!*bns(pwgAJ^FbR!
za50Q&`Q1umtLbeywr&Ls+^@Gn8PuWm-Aur7RcW!!N=nI!+67ML4tTqG=F~$z0Es`W
zL{L8DzJYoK2J4A|H!+Bp3=GpK9xnHUv%K#)9J=n~hH@Mtfmh5~*d&0af{=KFvSic8
z62|c~Dp~}6b%^t?7CmEy(#LzeIGshb&+kPX^F=qrz;$O4bKQ&?ACi!2ZFPcVbWxg!
zg@VnMebNtL-K7^FoWXp?Ii<mBkXg6|8@y5$x}yR@oMj=%!f47u+ljzu&4t9KVJcC`
z?}=L8ONOq9L9noJaWB>(>CFuJs50hD!?3kUe<Ybw^Q<!)TLSV#6NpjlEay1%pwDD0
zch6+4tan=C=nEPX?f%#sie&SUEYVvhNN<8f93aGb4Uqx_UgaH!dMS}PguI|369|a~
zF=BU?5cwJ+M8?wp(G$sKb;O%Is)q0rnan?I{(Q=1Rch1}QF8o6i}=HM>OpTOMRYVS
z_QP<UARn00FYd|fFJ`S;cEI4@&F1=(I5keH8F{U0PIoQT6+e*$l7wv|rv4b3CD8|b
z-eRnwUc!yCGCWU4vOs&1Zg!joA3cueEM|2F{}ZDDI{lY$S!WI2RHcgMB2$gV!4Ac$
zd9+5M|8LBZxsEF7KX}Lz=GAmX8K-k&rTi|$$(R#V2rmx3q}30#R^PhEfhkMa7Unqx
zg_uzKZDNNp!nmmMODc#Yvv^}J56EI!EgPcRp!Q5bpPRFfRv_zwClwQ|2ELDi2C@$!
zza->KUX;ZS`<{Vant<0npnJKBsmNxapUAmKWIieUNH!Z{9D|BRFILJoDhJNy&22an
z(V-h3Yh$fh9)I7)I<uwxrVYo5b|mm;Hr7%%U=|Nt#_HEC#9kQ(bV`^x;|sE!QJZIq
zWB7<=EW~;b!4jbJwSnpkT7*~xGYW%_n;I_9!~QORF#ae7K;2#052vtr{tvN;A>dj$
z)=3tf{=*`xf`!@`R87o~Agg@iFHgLsvHceuu(G!gY}*oBe_|V5!IlmNl4K$dtBKT9
zLbQm7RYX|PVJ9hvh_+LLEY^~gvZc#yv<Jg(h{I0~Ib}o->nP%vCst{ERgQ1WD9>@3
zxMvlJZm>}snW~BX3gjc@*hv8-`mP*C<;1PI5-A-bJ%n42uyvG3GfIX~qTbU=t<Y@Q
z15Z}$iGXxF@RO59(tR<Kc+wM6W^4sNn_5G}$y5MIAMQ+&XeAV^B%vF3aD|K}iED)<
zAK(*OU5385Gf4todhvt|R@d~#E8#rExYszXD_^&q1+-|2Rw3p{*8z3!sbkIQ;b8nE
zwLdD+ad>XDt%~GNcpk(5T#oZP^}F&aE0|BsH>44a)iG?*gDBlCyxj`c+<Hw}BEzZv
z!&-C@<3}KEyP*`^#G^^*$h%ai;hZ84CE_+j97V)7{TvX>M@?wki1wyQM=;5eB3%)8
z!3V)lWDo;Dp_nC2rPS@bXax(i`YFDjQtKiIj@Un3M(9pLbbd{U+KSjp#92g~MZ`A!
zDR_%s7lLlDsG<qcS_$zOWYXPGD82;*y5G*%tYp5`hi*b<e}v|~Y0i(WWE~REH<RTd
z``!>r?I}{DNz3VBNKos|hY{kLhS)6;f5;dqgrFn56ysfPeusry@1Txp!y0wy2{#=b
za@;VxAd+Z`3t!9{{8ru{S4eTRyF4k<8c3BxR}fL8>LA8r8UwM7&j-g$_TF%GSQ;BZ
zyE})Qv8;_t{ODM~IJ{2inUWQ24HxaCgqWhr-D@_(9_d?*+9H3#KA<1ezy@Y)aPX96
zYqCoi-gu>r0~p;dTcTh;O#;**wE^U@kUY2^R?0JPD1=Rq8c0}+3D|m&h}M?mbzMV5
z*m=3slt`PYP*w7UKL8;6_j)BVVFVB@^E{kpn(5#rhe=!srhcgg?UJ9^ru78QI-8+u
zEWf@AD;OKeGO!hv=w@M#EH`m&lZ1t`%<)G3MDDekMO!B~tti|R0mwoPIp@6~#t#7l
zZ45t72&0DR1%$Fr3Q&0~6=NF+pJURf0x3E&X2maUMJn3|aze(z&ihz5F=_}pm&#@Q
zF(Ik50oqg6o)Hi)$5Z23I9Q@R9VDs?3FW1sz9E!7Y%9E%T6Q<Tr3B~z0|A1NszT&v
zxvDO}o7Dj=1;hIQPdLwGO7TKV?gI2>ASn=jN?(;U*i6PR)8J9QY7MsF&Lsuf4KEr)
znh}sjRFR?>O2A#Lf)IFxue|?EX(EXWh<H2^|L|s6mS}YCs(9@s^aMiZ5Zb1H3`f}O
zO}Yo*x1*gx2!R|_bU1Ax&1C7QyCS-i67amM49X7YCQp5r^<rQ1Q|~gra87+e`Y3eN
z_PL(a;}?ioFi4>O0P0tJ(Ryq>nQLlIW>3|{kC?<8tz}-ZT`0B<nDpT^!gNO*n!C1C
zOalNa5c`z{w5og)WKD_n12RwOC-M1fS>3v4J3&{JFnS@{v)~4qzarST{PVTUXXpz0
z?x^t2<u`s}s}sQ&lNDo=BYI0&<`{ajUlA-%%z%ks;(N$b4y4o~kg20!-VqV0A!H47
z6I*#pj!8@aln%^PKj@yOwqoue)br64^Qo)}PcRw8z6-+vc;^yrXXysiEW<7YuxHVx
zUnikwXh&X_ei;JTKJbUXlSAfpl<PnE$RSqHNTM+=SNL@y`Q%|c%%{m9=LH<=g@Y&X
zYVWZ|-Ug&yxz+T71hi_4W&vNI`918ulO9BD@7Xs7T?ySz2ICa`^%E#-cEfjd<d#ag
zp55;OmQ6y)y9+Chy!A%NBWj$IUC!<AX<nsBKrJ4hglH9ENFnY3gjhd8HRTv9NH6>^
zX^tYjR+$u(+y0kwrK0SGzQ3F)C}$I;P5%*T(AF;mIjN4E;8|=ut*zX0auIrHlZ%z6
zh`;ui0!{-A5xO^mwhvGd_8Y*n*0FkZZpbRE>?FO&mm$0c$iH5PCGuBSSygM_nEqHo
z@<Gaf!4V2mqZK@3^xH`O+D(h_x-NLf)-D&u9#w@%QOAE9O*Plj4D}Xu?!g$!L7s?~
z$rOknU_nJ4&@oAvio2B!&q83r+<ZWCHy-Lk?g!29Nggc>6cNstWTT3uN1k!8JTf2q
z$q^3<5hGeKko{jTUu07UZv@@376J{JZI0x=!M;Y?Hh`8pVKRUEKJ&5ux*SN_<0$-U
zgE=<jcQ9uBfa(Z3sJyK-q(m9tQc@qTe3pEV^rMRB(KhCD+?#$uY$j5y$<T_ylKe^~
zPy=+RBI^Om@zmlj0*oSA8^~sfml?57u&vl$hw3RMml{W`<*<m`8Y{65uFU#N>{SEn
z7-HQ>V;!Ke{+3iydOFeeIN{h`$At9A2Jk~PFQs%TyEl<tv(1Wo1&NM!#nO<p5&^s>
zl3qYv<JZ9`hmL<z3^FB+8NUBt{YT1<=1G~J4*5V&9W;U7gOH?udO@UI|5wPtP<o2<
z4XmCu$xcK5BkbBwogey0zH%UTKBHLWnx94-duSY6Nsb;JrFt%iTF*hMY5v*yN}6BT
zN2;gB1*j)ki~BENr1^IsaY8As3w&fwf__k$8aP-osdCOzQ$O__*#rd0O*oi*AQS0z
z+*FuS=$7zM;9&R);JmWjuGs!x^8I-}cO$Fo{200my)Fv*#*NIs>NQ#K1)uT-^WZl&
zvYNW-6ZxMTnNRgUY!C<aFIfcgx|^7v$L$EJ@A7Z}D)VsELGP!$*CyuP<sdL+7vSd3
zYDIn-h*LwH_aHYh={~hSRy5v`3{aXEu@wsMQOMTikwSGfU%005U7KL(`yviC&!44W
z7sQYJ`X<)(tr@aC%3`FkW{?^khD)eyT$mRWh>3_)Qe?LGbVdPSGZ!8@%W5gIk0K{o
zxT^$WgDhXf6B+jL8Me2hEL}BcEpQWQWc}Gr(gEmt{G-jRmgi_-MG1lJhJljuBJ~Gf
z@r#?8r%M|Nxgs9$zc#a`d}S9_t)na0p%=#rN=`qxI>fDH;;H|INYw@<oJ~_c41K<g
zk1#E~K|4p<t^EL3Jv1H7TYkWr1#Tx>w|ocdeL0;h5O=j{<z;E8VRhw+7(0}we*lwa
zk(|^?UC>J!R`_@A$vDDph^mil+~^5U5pBRG*IqJw_c?T(0QEQRBau*gCn{QtuW%!Y
zaqs{pF(7#&h`1^*&H#Jzq>@hJJ~+u;z}kJUw^X<volp>$5lEyh!fMkqEj-vNIMlW$
z&w^;5{VRLrkLp3Lc#WIw3XPn&9yNIYvBwUPVa|AUl4oya<8;T3{GY9?BWuq?x3Qgm
zTcF>PhB4{6f0q1Zwqve}S6=`U8(yMVDRiI)FWtt*u_QijJ9{r=nU^dUJ$`bQqN5O-
z6Oo4IuU?^$!V^e2AzPHlLq25vVyh}d8X-QVSaoGA<#?&4kfR9s86jVGmtu?0WGTp+
zy>%o%^C9zbO7_OFJD=kwZU|&md615|h8#pZl+0gs5Iv8g+bFsw(boz|wm{B#LQd+=
z<33`MA&Cl+Nr-!dXeeVTiFzvJI6?|S>bmp26srgjq~%43QbO$OR*}{(3i$#9q`D4q
zZ8u*3V-_AVOCdfdgeNM4=w2z-T!maiNH0RR=*BZXMp~{45l;v_2Z(1v5-QR%Dr5j5
z>FO$RJb^#>m<<X^2LuuxHUZI#5dAB~TC9+p3E7*F5ea<u4(8qc7Mv}#&^wM=)^Nm+
z#~`2`g~WDdEP!HQSo*Q7$NJBS*k*X2{4^M3#vKJG89N!(#g+fGgEe-qqEagLKuW_Y
zrFCZRwUgO{Zvi4tIAN<A_OO(;L7tGN5A`@}pHjdOx*1j4c2zX&!msSag)D=H@|wF?
z%aCO<s^O$Nc+%U%Vp!J-g{)A>9fUkX$j)8)lwB+&BuF8~5aKo=O3Cunsz*zOG!wFj
zkUw|f7k9CkkgoxODF4&~;w2%LSBiB+A+Hhg6(Of~;W3{uzmRbX@c|*4(Cno{rC1Xb
zGJ}v!3E7|vU-Joz3!y}iRxlwt6XJ9{NvNvgV}*1hq&(!lE1o-l%KTl;_Z@N30`>L_
zTJ!Kv*{H-;igbKUkd7rjPL=qyQOG1hjw9r~I8ydRe;-`KlGwl*UCFvXh@%;!W<e|d
z$8OxDRQf4uR4SrCywBVaa|y-lN-;I@W-8=LLM|m_^EkfrGuGT?8W1So=OO&-&sa<J
zHYK0ouAMz0yy|Y&ujdrdgXc~oqS3X=A~v>y=X8Z!M#w{iYyxDWJ(Vg+2}#?+3DSOF
zQkMVfA^elwtgY*62_gB<wj}w7g`|N6k~vfZoZx<N5PdpRGU|v#x<YOsBusEDC3NQV
z_OQsV9tx2}h)0CD7gG_djzWeI@-ZRL0f`qJNr7)l91iOt;|E&s(mgCJ<UJ5Vgi8j{
z1MMItRARPXA-^OfG7VQ}3?IFh4G#$TMfU13geWG&^=KF<k8lH;7$hwlO!l6LT7&rS
zd$CL86v&W9DMrkkT%ukV&AmQnk#AY$WLvc^G92`!$(|*8aYq_fxHaN|xCw3vINn-%
z!GeBP--9B^$$usCuM|0L)Y>f*e@TOxqa0h{3OFMs4&X;VXT7XrFsVwkJ;inV(dY?Q
zVA(guZq{jQTiV{l5h(8R-7lh}wA?I!LH;AvA^&g~aAII5DBMO|Tra?d>>vty5rE87
zyxUX0npylDI5OtvM;jNPaKI`UB8B4$g{NZdKq@jAvs*wyGX9P6jP^j_-CPM@D&a}t
z=*ae9s)oHC4=5t!K8V$9Ja_gU5kTn1il;tHQ9aS9TH}#{^6fCQqG0w$SVL0-u^flF
z9E`{_B8v92K<P%h(#-DkkUX@OpG&YjfWw2mflH5k=wNY5%xd$H)|5LS6N{o?xT6V1
zxYN|<I4G{r)CbybBR%Lz;R#s{m1FoiG@>llDX>$c=}GIJbh?`MYda56Gr1o?D%UJd
zqozW^!>d8TJ4nILkdT}#l^99X6{KFsU~_s7i7mfVigSDMd;3^qhkspACA7`mXK%yA
zJ}*t|0+B{M(3Z#*8G;0IE@+6ck~vl%_|PwLRp3o>bwdxXl!D#qd18c*<rh*yF3h9E
z2><7)5PJT_xU4aSaZATMNQ9}bc~sj`at$@E_sO)fCl$$MYw@B3Lg0~%x{3F4UnaeR
zmnku#@!@{hnPHFGiMaxvQb_HVV6(oUv<#@Yo!e)$%&qF^V5vorrW)iJAgOiCr6{+^
zH_gZHIrfOy-tr6qYn0&dmeZR_w!<eWjB>pQy9#k*O687~5wbDhv5*Ji96ssb@LZH1
zgv?b!4up_4tNt=J&Lr8sEvX$5Uzl1up)@xEeh5cA=#X)83i#sPZp*Jpj=8bvhh^9)
z)w3s1vt*K{_&+J-q+D^agetJyf%MIO4R%<;im*P3Q}lL|XBqJ}AW(0M#L%9tC|Xi3
z?!U*C=XO(#ueG=fW!$7(?5#m(as@|3hhQjk5TEzpVf$Gp>l#dg#dR~RKzd7e0VZZ<
zTOUvOD$D(ZsjX3`-Ub<>i(*hBI8+9uX+IZ+2fSIwRV@usP9C(6k_YGE8M=Ud?<n_F
zRav94d~0h+%}`Gz2u5yW>Z<*!e^|g6`&GH)0jv)MI3qc`>C!v2GYmc0sZ)59i-{3G
zmX;o*CY?g3e$bH}1T)Zm7J)_#5P4BvR>hTLmEr_boGfbPICj~qBI<k@)o>N$GHT^G
z)~7!p5}iFSODI_-^!?U~gg$&Np_3FRTP0N7sv@dMB{b<vlnBXKIiYtbj;&HUq5);d
zYVuxQkx<fW2@Ro0%Tz*1vnmq$OvW`d|G#q7jN;fUC6p$KP5p2^Y`NyDlxZ$fsr%nT
zM1mlsy5M^BWB3g;Wjg5y7RZc@US34U3i)3LS#4`gB}@+JU(2<FuoK@km4vzDEsOD+
z#TCM2l?$U}8ANebC|Tac@uM;!cFL%Rk*}p=mGz}DMWSuyWz_RjLVEJdX!WJlYYF{z
zjcT~bml(n)hab@eRS2Lu3iLn^P^bdADo`eYd=yA8K~_UH!3+xa3g2K>m6$z4Nq`wK
z28bAldkW;HKtm|vcM7DK8M+bZm;&h(mHQWt4q`Vz2hm2#^S2T6R+%yHID1cqWQzOB
zV!H(f<waEU8vh`Nxepjk#JEdnP=zuMRi?Xf72Ik6dztn^5kc}*sxx&MDVeXS9O>h$
zy!zM7r_aA%p}OO7HN0vRPX9%Vd*R49hMhRHTPw-|SJdF`GfWDiX`+A;I+wh%t+rE7
zum4;2Uu8H#cy8wlzGmLRPq%>$JUD3nIA<VD-|Lo|@Nf7KU|3shtD;i}6zJWSpZS`#
zasTu%b%uryoiHx`iu{N@Vcd8aw*|hvjW;`tYyOUg@iz~%Al*A*JnJxP=-oGi(tuFX
z5qmbZN~!4rX5PeeqnV#P%sPhX!3;b%If7>pO%Zp{6h||c9TajQA>lg0T(u1k{e~^B
zH4H?U;Frzy#kMXy?;93St1(5k_rW1BI>hfFf<w6e2z#r+cm|Cd51hs2hby7B^_Z~Q
zuG;buTq;&=;>(V(pjNKbbJ~WWGqwn9M5Ec+TREisJkcu*s17GmeE=Jz!J@)=@ew?T
z`niSIJjz;+`W{nEN`m-O)$tLhH&PMA7tzKgG3f*1KEH_eFk!biGDrucJ&(Xs(ti{b
za0(KNu+~Hr9}Xhi1<)<RsIHVaPNieh`|*#Cvc|fXp8Ud5R)5S)Ko6Qw48_|p5@Gl{
zQ)UQafI=>wh{mvj>0~a4>gfInNM9Q>1d&C_khO<h>SYK<h$&@=wi2PA=gE8IvY^P1
z_5%4~C`>5%+)1W-*QC3r$i#37&e-y#d1O)v0B;NwNQEF)#`68SEVR}N(jZxzc2f{B
z3k>DYb6N8S`=~P0gGa4tmLv&qbw(CA+Vo56@YrK4&ZLLgTRi2JG~goQ&yY`6AIvu#
zW8N*)ygmu9(@(*25@qnM1K@rm1k5nVkI;Yv33xh$-#f<q>lrYe|8GH+zE5fEx7X%P
zj<aUEvmU(Hapvj158&eZ@G?hdlv=Q{QNPK9&jUiY^nJeeIE(e^x*Ke}NEMtBty_W#
zP9Yi>lamc4-Y<<mJ<fuxlQ+ng7((NgofasP0?0+16(1n_5{g#i(#M39A$<r58z~$(
z7@O2`vf_P&7s-f95r$gx>%MYUL@f*|g<DiJRSJ>`Mf-cbJF$WD@(~uNvE7Dl59-Db
zoM1l2EIGB(PL9lr;df84@SZ*9khEcbbQDMP9#8(L(j4SbkjzawU^%p7mTbfE!33iR
z$@-yy4P&=BIz%tUD{LZRIe+_G*3>=jIk>^n4xxq-012ko;=Qgg59^5cNILWesHxH~
zQrs4G8CjgS1N^DU6aVW-vlwreQYEJvwB%FhUAIEoOJq*>Bx2fDLBzX3Oms1a0dT<k
zqvH3KQgxQLb~7&a)bGT(6>JtGQM^c&A2Ic&`ao}qP`ky6z&y_ToW!ac?W=<pj7!gh
z6_|#=vNvWNML>*c&)+%8OoLO1xteNyMHFIVgiJp~w!uO%zP)OLa?fw8`6@uC_Oz<m
z17#_Wk<6&CW(^ocz)yp??i6cWwI-A&&f9s5Q>?bX8QhDpAX<8;7Kvonr$2p7wO_bN
z)#|pa<qJ+RZ_|9tlwZr<q_uo6P~qMG7Zte{1z{xC>GMMz=%QO>=?bYqR#E6xWG&<R
z)2vNODCStCiZoQ0QP3$>7eACv&uy~0z(MsxGg((s0I>JzMTOH7OD$s8NtxT(O+f6c
zh{>JxiJ}e%BxeBl5`DwweDi5$s@`TJ_GjRFK=C-6A3e=NJ+9Ie4bKym*C><GiM!?M
zOjh<T>HmU=!nDfX)v-7LUWc4f;8(227m|$JiKyWHrA=0#YB}QxNqgjvf`CwXu<a8p
zz92)E=5cl_#=!g-z&OF|!5*Y>6c)x`c@le~;)7fC^{pN|T1nXjv{a;3^+|AApt{+v
zDGSd>j961z`ZZE>D9(^oS~3X$6C^{EqLWgH?}cd@f#kA7nBD9mSD*A3;bHktzKvi{
z#aos{FjZl^QjCendSrI$6P4Ms*|-xtI~UcR&ZLw0^gdP~?{XG<HhY1o#-mK?<?xYI
zh@1g-_F>M&J7pWYCPtHJ(9R_ABli!PAkJ!~F||)hglB3GNNb;rjc)pX$!9|=H_k}m
zg4XWPIP^i~DY&PiPmp4JBOMTnngQJ99P^I23$5gkssN+`?W)ugmcMX^$wLAoAM=op
zZd4l(Z)+ARoXs$y1|N2gMaBoi+5cL;#>44Tk+0#aFyp*g409RL^{>b;1dhlF&W=0N
zTwnjQfft=amw)je{_GqJX!QtA7v!yiMe#e(v`5Z1us}~_-0CRn?er!pBOR9VK6xy`
z+IKq%i2FVQq~eU3iPQt2E>dv<KCTQ-y%^wIV3iU)xeQ)k!QC|a@G`iQf^Vl00rWm)
z@ZTv*cGDeN?y%)qg>xC=JB7HY5aK~oO`yXH{^e%HsIUyaUBSQAGLTya*XB)6kYP%A
zhk{#XA<>B%k2M->w0W%EG+IkAO#_m7)mMW})L@Z-`FyAt4%A?@aNOoc1&h;QG%=s2
zB^;t)sZl5_PtGo|I-Y0#c67jLd}?!vu$Z;Fb$<m9xq!{2^Q-fu3#<*6%@$o??Q1TD
zp-V^5a#cQWGJfF#YtYvFA0%lvw8c+O3Q!`~59gl?;6sADq!6dJ@X|$U%LIE5|CB5y
zN`Zt-OL?Pw7UZ6X5MdJSL2@li<oNO7`K)1!F_e~Cj}Nw+>5TFc%+DbxRZ^-_mBhts
zEuZDHMy|V%za)FSKiC)WAM<hKyl-1xqX74a-^YSZ0rRb$k8UaEF!kA$@)6HR7qFJr
z&&f`%$XylexTm)OZD>t}rTwGfMsO#86-@Nx(p6_j1@KULqasH_hsb|F{N#K{`M=!=
z0}n0Y#f49Irf~<DM0+eUX_$x4n4D=OfH5A-^^<98Wiv<Hc&&@fci0^S6SJ^MoF0Tm
zX^_YFY`pQnIpkdA$zCo`RE2?9(iV~TgBprXq|P0>o(vz2%AG7wl&kT;`AT}SE#s>%
zvRLcdw<|`YE_A9+`XcS7FV>ZfMv*?G3;kIDa_&J`8ejGTCaNEnZ9tAk>581jBUeSg
zj_Ci;=+h)DejqHJCs5CY)#zZBjz)*;JZvGD*ep-@<ZoGR-}wW{)`~xbg;=OjKNO1(
zG<ho@tupn>{+TX2G+aRzS~e!o<0+7G`Ff=KR7>@bhS2>>)zUZ0#+5Hji^|QPkwlA<
zl{q>FTIveNVCp4D8O&Q|w6b@{BvyYGD;8AMG)pJI+y<9`V2VYWy`*~JUocJ-uLiFi
z{6it)5!G~JD2Ji?D4t1G_~6T|u65TYWC>dO2=#(GO?3&0-IOmoiUP6xzi_!-C>h2o
zJYwQ!lsWR4C*5!57*!SQrd(1M683>c;j7$8RG6ySzK_d(BB~?Xi8f0z|MxO88vaR>
zO7KM97T)JIudupJE+|kq^lu5b_k;nX-}*bMKxJFutfSKY0Sp(|!-kSFQ&zS&KvvS9
zRG-nFsKXCox4Kqpc6~B<{6}>*y#=$<N}3x_%-oQ@m~83p-1-<}OCc`vq8;w}VuhS0
z<cob)fN`2)ga1l?=L!q#K4iR9pnStMbFHkbhmdfZaP^j2S_hcD5AMM?Oon2_0tuyU
zs+jR({n7ArrDhrpUcle@js?57!nzK53d<{7noebR(o!nPe6b6&BYD+o@fj-UPDrf;
zDm3ldpo-KNBEl2tozn#vl+*b40LR7`)E;rJKI+GkiuzF?oT=i&7MMYuGDt|1MGFA4
zn=C3wMh#qM?H$Bfz_ITs5x9{W>3#)@0H~7&+J^KsV*;nc&WL^W`PlE7zcu)`a>G3U
zHF1G9r>|tUPhL{ij7~#z5vj!Z0c8iNkfq6@nM&?cB$uPWqV{XaH9;2P$d+Aqi6cC)
zNB~;+vkU0ug(0e?e7BhL{Rrz7Q0c>Zv=CwMrYmWJI*wYQ0{$Y0M37y6svqU$Ts@wA
zm3bKa9cbIixDpc%-Fot=SFzu`%6z``D%)orB#Wt#bV|3K-$ilSlLw#xoFIT0RhOhQ
zxl);6+&xUfYRxY^E_|N<@YHq$e-C8F1BtP(Qqqe<QqrHg%y1*{LV)EB6YVWBJe9(6
z<mV~DH8!UG+|hxa#}Fy?dG0kF+V$nPuQ5-LuP9N>gVyAt^svV!PYej=)eBjKbN%4b
z(!H$Y(&~%4`g~j=t3Ps$7X~b~e-~?O4x%uSG(cOHj2V+raYzeOKm#%2U$sw-pvEyA
zVPtTG%v7Q1C4(MAC_XgMO@c4bz=cg3XMFkHLb!T*2Vr8KeOfMRnPKmD4&pvPFw>h8
zP)o4+3}t|VfzQ*2i5)LxwR;0O?DxOeY=tG`qtpLlCn{_MV4LxkKd?Zi=ZAm5YYu-F
z^XosbHSQb9*I-W))JJB;<450>FZz-7s<Cd3v;}eBNRf#5;y?X}GTtTllOOSV!&1S0
zujA2_$%1#kjw?w!^U2p)fcHz;*U~;3W5)N$JQ6*QA%;{o&69t59fy;TfTZjwEO}&U
z3lY%mJW0z`X;NblYl;@j2jE0oQ7G0k?xZ%t(NJ9i_Wr#x(Q?msC`UNSl!@Y43%!?P
zN|s|>_82o=9`qw<=oXQ#uR2%;5a28Tp=Wu&8@S1+Njjf$gEa`cwMq%Mybe-F(qMqg
zHgaRKF{ddITbh$haE8SfiQy)mgBY&Sl(fBv4l>&Log2t{P40Y?`HcAotuXX@_>gF0
z1|GOVwr*3uoI-rQLJdN_dxPrTS;;dm(#c{H#rQVvKT~=ZPN%aLZ+oxMk`7`AfRQ?j
z(H85}*ukN+G|IujsR|aX5H~E4+mTeY2~TA|B0BZv2X10xY;tWWy)k1m=@Y4<1r^Yn
z<OQOcOs*i(F}1chDZihPw*ST_x|5qF1`#ULORXBIPlfJEs51x{L-|gcf^)1pe<cOM
zRM2yL#b^9sHpUl<)gOU?e7W+rDBkB5tEJobgm-$%Os(k>4H`72P`kL+1f`M^pK(XN
zIP(K~`jQ3&pXpw%#cx;g-M5&ZbJr)R_UY$Kx!X<V85}6Po%kXu6laonC^%7Xg+RXO
zg+TeytGFh-!EF}keuCO59LP8lLFXbc(m&;cZ{xC^R{Xu&Y*;`e%(3F_Q=O>0wFggM
zCUt1L1ak}}Jh9BmE}h347BSCi%_dUD;R2}1V~Uu``Uv$4!Wc8u3R0ABro!*433%YC
zR14hJa!-1m$Wx@LBXQo<Q6o#&$a++eZP&;;K-AHg79G-4>5-GEY@D_Se`>=_;1X(N
zn@S=^&chG}w<DUsi@5AhwaX`h7lJk}e7l?oq{f4(8+Z8$Z&>|1mpA)~dDpv&#Y#X!
zF=qioc}g{gZacM`3i*hiuzPO5FJJi+t8e%Ya|U&Y74I(bLqD-a9#PqpTYbk$m~Oo1
z&nz(Ht}k(=t*5zUFlk##t3WzA${^C6hZXD|+~d1`W}VzQ!EA;!{9t|kA!LZ+FMeh-
z{q<P{$rHbV8LEwCBpCb!^IZ0Z=4gb{A9DT+3-%c}8&#{me965+H>9~3TQ^tHem1}J
z3(KxnW543J+jwBs9p=Gw|2*K!e`R%<8{hdW`mfXm{PM5NKREk=5|U<h`|rT*CO0zB
z?m}rgmd-X|VnLNJPjqU?{qC|PH#bDl6iKnXc-mbS(E4BlrH^E>3WiRZJ}~@XD{O9=
zO7_7dlzRyg?<oKAE^FaFi$FNyEsaIj=Rj=Y_3q*3`e)vJ+&$LKno^B=Lb+lfhoxN@
zIBC<fG;E#iU0sTEq_k&5Bq%XBb;aOhCV_(x#^4kzRa+>$Ww3m3sx84-T9t#-8Z=BL
z^lVqE{^7_3mT*U!dn0hig^<|$nOrIc-j{tEjE4f@0U~LSl~7%t1ifH9qs!~icyD8O
z=3oh-^BS~wl{jE0=<WJEU9cEyUofqlulL9j`J-~ae%12T9F$tVx>LUDk~nrlJ?ujw
zhSg=TJYP-{T$Zmz)YxR@oGnEr8wn?=vmLPAgtAcJ%)1w}x*qjl!l4+P=m-1bV5FL&
z`Rrom=l?C_!qxbJ$WJ3#NQrdP>RP27ZLP<1i*dw%Y+o30kU0&rzpg((IBh1Eo<_WL
zA-SO{@{ALx0OVlJ4D+4>u@EqEV=Kf2Ie8ZQDssx{O|&P_k0*LexFvlr$s@ym3u(u`
zM!Vz4P<w7Qn$k_glrCT#U;Z0j4jKGAKk^$^Vz)0uXMz_Ya<SnD=C$TlXg!TOl6)}<
zb+i};G%l?`3MG9Z!KiO#Ns5wjq-fL9Ycd#@U9?msD=sU<*M$-ho&7-MDoDg)3CS)L
zdjP;l<CW9E3bx3^V@N^yeG_>q#-()*F<3&PLbwoPyDHutFBOpLLfvw401c#g(&DO;
zW3*x(uaYCHJQM^XNhV>;{7Y)WbnAOX-Bttt2r!<4!ktH#@Rf1hs8)ZlHA3+bH8etb
zc_VI(R@oGf$CBj6%=L<Gn#Q(h9IyL33k(WHVbHDY!Km`5$?US5tEK1B`<Q2KS8TX3
zs9eLJP2p32XR)rMK?MpN+RCx=+~1jpt9c4^KoeCQOy)(uvj*0`wXFV~q7r|E*)%lp
ziw3@~foWr-Ho?U%Z^*AX8DV2S5$6zwmj(l*C6b1$%q@yZ$M2M4)`AJ_$`D4g!~h&L
z$vzWDK7g3)i+uhcFwu@-fFVH-;mSMuOM}QK7ob|%CsaX}jhQqCQk|JKl~O7aMepLb
zLu0REM~CUN(Ig)T82XcG$g>;n;9FbHi$Ei!*;8V~SWgR%hg;no=<!R#F-dYwSP-M+
zyxGa79}e^KJ_}De;;4+cF6hfJsiirgJ<J87pn6DOES5qMnS>>ME5*ZP7Fk$gQ0p;$
zk$I|b(;fNE``F`n^gdiqQ8M6%Ao~+T<jc2tqd&1=cKaT+kV-{&`E8!~Cu_p0@accD
zmi1=<e+YXH<n%N^7PWRY)bO|Ykw00I_4_MI$G?t})xMh8uuE2GoJq8s&S=Op3K=I#
zK9k7V?UAd{d1{n{@j~9^Z|@>0S0ts?sn_zib0U0Zcs+e~c`aB%Mq3h`mnsq3r8HtR
zK(;5S{FbH}c<>vQ!9w$Z;)_bi7|5Yj1SqeV-aZF5Ps93+;@2MF{^`{t`SS-X(fa-R
z($XWcHlTwducmpn>d*4UWjxJ-racUR82bR+XJJ@#88sjl=Bv1$sPfnxF>0$AWWsG$
zQGx&g`52Jrv<GuxL>z4?t_X<Ve}ltLF2%XsAC4@i=Tn6Ps|^?U)xS_O_4&)cFtvV8
z{RY^!!}t|rpWz7Acx%_c>D}kbG`_urG{_?$CLwLux5TEQ6>`2mLKYUe4e!m7wC@pZ
z52Ec1+T!2f29pucLoI~Tpvcs=IkMZr3w7rm9U5tadjLxA?K{%bat_^Dj7?ifA2OaF
z`<uC2!x337L0jGu6O*M)05W3N1pP--vJZ%bw_*WPMvL!;>=h4$6o+ua0}9jkL84{U
zfBqs9tf2n+EmVGLyTy%3aGY!Yoa)xuL?>KZe3cJ)$oxiadi4tPnEsef<;#r*A3Z}j
z{glokS92a1NS$gPw-<dhcw|XS_KbLnh!EJA@t%TPBs^dIq`@=EXu_KA)Smq2Lsq|C
zLxS5~<I(%$*pVA`7}8{+)1Muvs-chzpzSomuYCzAP>jF5<RSmCI@VS?H8`CG9Q0Mv
z<=9cSYXY-r?3xr4^+W{s*C`VE4A}ygT%oUTz!8F9T7*Qv)2mECT8e;xJA05UDv$6o
zQ&cem>68nbW(@d`wDTb*q-{acVz(4L122@cK}y=8)0vXCx{}t6gdx{!((ZOr(%z*-
zL|7yk-rXTB`o(`J6Lp{=tPW+uHwVMvx-kO_lMr7&_7^_tUo6J|bhf;kpqeu0Cp0<R
zcQLl}(zX<nFlfct=lL7uP>$S>pvsTj4=Kz2CY5_j5|XE4bbLisQjDQ6?PSGfUKlB~
zD*ryJ5tRNW2JA9Sd;_`gA1$oFrKEQpOlD(Nd^BybJS&=1=RuEHJ+CAn5ktfrL|RB4
znMA4R$N$WSKVn|)kI#T%<;C>nMRMxsHWvd^@fH~+Nr+34{PRc5-Tl+o$zv6{H3Z}`
zuNdh1lX;HAyZX~m2=*t^g5K~-0~iKscp&w?z$?x^6Z;pWElwJ|ds}Ld?2U3QUPWIj
z8xR^j96wkxe}SBU_$_cRT}kT<iCKKYV>}4973~Has>%vk+(lU`L(>vL(^({X?eu?&
zY>G-ymX|$NheR=uoDoBirhTqUv7J(~n|f2nh#J`gb*xg0IYCwjo{LBG&-oc*R2Qe7
zQfHPg7LQr`1lQ9IL}D~nlsixVyrp^vWEpF~F=dOmH!wDobWe$i=&4Jsof4DPQ|@*-
zPR#7Cv56g?TEb$miUIMfkoa<vtU9MnVE7ud6<{XyRbn+mOTk5``1S!#sM}Nubf<ce
z*w77Y{!OWHwN7pT_)rowjK0P%ng*_N>m#wlPZr!is9$hO2~w%>+=)k}TvcsG*@}X*
zXm<D^+FGO)K^&s~M=RHF$|~nWLosR3iHfakhWEHS0kNC5?i)PyDH~Mt1o|C&|Nc<?
zJLfQ76g}p*p0cJLK7ImiVN9i)P@yE0SDr|Jn;7L<I>8TPX&8@<H({7D6yG2pC@xJ%
zx`;g-;*E(s`Wb6%YA93Bqjs37E`-u2-{Nzg;krh17ry@)^RL+vF_Gc2<&DshyyO}4
zvo1zH(KgqkH$Y3fh*m3`>||1$ZGJ8iH)bq^<%6MAXeL5|2tyH6qQ<NXuG5yHz2fy;
z4wDtU{3Nd-xv~w|u8>PI8<#-gScaIw?ax_t&yYmQEBYw9lmeMA*5g;)pTPG%XAR?n
z<CP|GYB1?ysp$)31c^thB@|MXt0I_P?NA0vs`w~6A|OFigdu?LA{W2KagP_w$88?P
zmFENcJt;L!y20aKu*SHwa{LPx=(<NvglO}Q$(euff;FkL&Y83jpM0ocrRo;>BOmdV
z&SPYAm=Oo7Q-U`LOS{fG5eGFY^?*|A(|}<&B%w%i1ZV{R2fNMN!22|74(N*@;h7}c
z=~7dN>mbCICODMo?1Baj=6zqX=-7-OV3(eyS$|pC%@{@s(Y7mnhBRd~x<H`RbP6lP
ziCJ$)Oa1_1qv5_E`L&m9cH)aTqWqVf95{PeM9n7}w_3}M{;pq0QU5&&QRy_i==6}P
z<aG;{HT5m2(%TJ%gv2d;xU%^n-|&j{jQtf5AZ8E(mpEc=_;1yR$YY$a?y%J*-Z>#6
z-XXOs<UfQ>vZzS^kFxgwi~4x}$B)HREC>oGMN~vo>>w5p3#iDUps2C;ZW6m-G-?im
zB<SUg#<HfWiHRomXe?+HyRiVq9%D&N*$Xkj6g4rC|7&*l;CScreV*U{o(JyUv$M0a
zv$M0ayR-XlJ1`G5x&U6xKVRc5OR$G_c?7YRFMKPyHe`lk&xvl^{ta#uzNO<YL>`>F
z=$kZ|Dp4{IMPu!Ng#$~n3;8Uj@KRKs65gVO$|`|g29hr(Oa4-^$D^b41`)vF7t#%O
z9D#bYIP6Oc!|}iIuSz^3M!Zanp(5B+PYo35>S=BbqBTi9_~hJ&zFF;8h}&W1xP3q_
zUrXr`m@i=Bb-)JRP;oL;5JT|lQOuIGc{s+Z0!hMqEs%0w0uqEJCQ%rj-Fq>?a2T6l
zw0nS7OB212hC!aZ4m=MQcF)xZSrgj~jLk||G=1xg;!zsz`Xqtvmb2!zGY>;1j}ypG
z@X1~SSZeH~P^kjfj?2c3$5-w<)R;?)pJKy(Qebpma%_cgiE~Negb>cVgfkI1$ts}o
z(hGG#y2k_E4hRB81Ikd#!!IDA#RI;`gVhQ7VHlc_Wa_izI5icP=%=G#2z1JCJlBJ@
z9KIaA1X?#WgTPqqIVWyEBDFdvYN0f_X)`=Mn4E@mig`;c!`llyyaXJWKmY2&%&-t9
zPX7RU^;h1Vu?DQhAN*OyB0JuJZh*p}^wN@A=#t)rB*~Ma`lmR0FlSrT7Q7Carg-i9
zfL~#(r7c5I=vPMJ_(R3(lV4mMxbfPw4DW5=DPAv@V!HEs5YXr^CN9Cw6}bgU5ECWw
zeDR*j(u2S3$!fC2zwkAlER>D?h406A%zE7mV>A}t%7w-9q|k|3F-m0PW|vm@@}FR%
z35mbTFL<j63k)oVKFfl8JWWL=UGiIh^7slYIHc(i*&*g)wE|aM=?5U46C3aIITcs~
z|I>{nh7Zo7k_J=@7gO)^Z53GUh%`{17~8R%&*CIkQYQjsb?i3W^^!8&q5KaouE4_B
zSA)2}nMIBcL7$g#8KS2CHCTAjFV`ae6X-d;%qjc1zZ518YQfVQjwf-4x?n&2LNAaP
zon8=+;hL0nl4XDMjb_%kdM88^;O;#874%}uAb!KlLQ)!F@}`{%g442rUhDE6<XRQL
zVjj3NKgI;)z#`R4DT@LB)<B+6k=0^H3;B?WEUevzfyht0>dqaq=bsUmq+5+w3|PUy
zDLj<!mmi=Mw9l@md{;#_HhMy5DlrxF4O9|WVW5+ESmP4B(z`l(1;e{Z+>gd}cib))
z$N|fCYydJkQi~n4nHU=ns}o9@9d#ZaLI!vmG?B{v96fuG8ihsFPgF8WLIJUJ10})@
zLKv(Od`l53Lk86$E~`B`LLH{p3$N5eM{Gu(p*EfAYrNi$sA7nY{xSum9jT8~?eT%)
zZ3vb46Q{bAlsrtbdQhhw@t9tV6bizZih3T%k`}`}V4w75Tn^w5`Kq1V_P?)T>69`b
zrf8s|`b5@KOz*;nd9emQ-@+9x_0g{U!yR6%hwaU_u2l&~rzHoaL~w-9Vfk!~YjL8B
zkk;Zn0J*DWWeUV@z(n=MC`>Q5zM{~n!F&|{JA}Vh<7Y{jd<DZ`jGT9e>yU+UEV+a)
z+rR?(l*+8K?Sl(YCrr61{)f~_wkL*+qR-p{x=OWiUVo}AuC{ve6v2s}&arSIA@()n
zQ1C`w@Si`TBP2`TG6N-BHcX<%!ekb%9F|q7nI;nc7Q(NF`Qu4sK%<_`UsHwEZ4nHK
z6Z)6Q6g^p-LxDe*Z3h(aa{!UpeW}PvOcV7|c&{p~w(SS(Ea?f1m&5As90JO6uQgxL
zL3>)8Q7a#qocz#%a7oiJrH5K)qv|3RrU^E90bHHAFOY>9O)R-q0Bmx)Qn~{02WUZ{
z4zQ%&QCsEO4^)A3qS=r9*D5Ta`>Y~*hTbi`khqi#s@U^{N-e-NzcVIZ&a2WWVKX>i
zd<Cgc=#`^w$338nF_xCn3eWMLRaxDDJ$)$%)JM*+Qk(sw5TESkwyG@9HnqJPTd4}V
zx?@3&s_W>FAc`~MNGytlw}+4p*^BW~o(K$iXoYq<LliQ&7AAGsP0yj_Wnf%sv)2Y2
z2WfQ%_g1FH{pj=ZT-c(jn0r*0z3AgOUcVX(>Ys}tiUxbyNq`BY>K%~{h8KrI!rhmm
zEv4uSAsI3LZ!m}60-+3ulYIItA-e`waG}n<D49E|u@KvIOktp$6ubr@BEqngvmscK
zIw*Ty^Z~d5&>VADAZulYR9C^>q-^CY6ozcjUj$qitAOibaZoA-_IZ22nE!+>Dko#8
zPT~z7;m!7^Zl*~+_>KM&N0g}(CQ@s~IC|qP;^up#wNii%^CT3hx{{iGmLOw!xB5YE
z-l95&sT9byRB^jic1l+h+P)UV?B`A=7DLP>V(<5SMs*e#wjWIAB>qPJIAZEY;iZo^
z<$1{|3SBJto_|uEMTAY0c)yp!qZgrsX}s3o^FOMyhOBWKukFK{<6eEM4@>HE3;rW)
z^sK!o9JQn6(x*eEMN+X*+22T`RC5^gK2M7JocK$^=(P^=7N{T2W8Wf&rd!v$^4mVF
zvF-VtG)Zuq+cQj2^!hM0i`;gg)o)sJrDe3HP!#87^p9N7!iy}RFjzphG=pgqA9a%!
zBq;Y1l3+%DflZ@+*AHAcKcpcB$Z}gjysjo{wbR?8o5~ewG}4_Ns*z|7W&SCiP?z~N
zeh%e22kX3a&$-EdNhGS=KG`&v0`jht{Dv>9YjdKDQp=KqtQ&hGXwv4CYHAbaFLu4Y
z{urjm(ap;#gQit2qTWL-4t14V73hSqY8Y(*5}G1$b_jDEDx^#{+d;`^Z|ZM+P7T(y
z(Oje>o-=aEGuS;ir^*f$6M-Wyu7&xyB&^-}sTwRI>gDa_7$))o$X-U;8`<QdGl@=2
zPvG@xG8_BpIA33r)roAdTL}y;VBWW_yjFL?PFs1cj_S$p*JO>t7D1#FPbdDNW~g$K
zD)scw5!75~#DlxMtsko&_7lp^N&JJ<82UUP`dlLMK9zU{V*6b_*N;WAwY~T!ek{1=
z0*U{yG>YQ22mGoZi)XWr@j!nzsL#JmqyoQzm1CCz*B$7lz#o1s6}UBExu3`uKPQ52
z5iBtt3XF9`?}`09O)7rraVLJ*pEc^$=9p`IR2yY7q!hcPi?>iqOBHsDjKz_7vh$(`
zrVmbfmv=6yRM8yBeb`ZwX|Rnpe(;iR^b2ZaP-+B9N}KHFPmd~Vg>K<Sb$yc3q}Cva
zzHlEskZdctXL6sCLJH9xwhbcqIZ*@kbUuMKbcOMYKJdXHlJvH?XUp6NWw<(pW?|ze
zs#s`~Td_@1taCfjp>9DXdJ!E*oosLn)7k@d09BuCdMyOBjxfILq{gJD$dPPEm=uNp
z4JrbtyAMyQ#e&$XEqrV(*3u(}uc*bEvtfDsNG%o~91Gi9)X8UW;zOwWpFVpB{6Q8L
z!o!wHE!ME<-{_YI{6NRKxU9&d9c7V=-zWoZ@5ECASWEWa5&jf(Yb-!M=Q89=@HuiU
z#Zjj_-xa`GF)@(8QHwQWRgcKxnX@}@8^{{Pn9*yfMPSy<^W4;)M&=Ee)uPcD98Ky)
zZsM|c=PLtQ<K&URDBpk6upHw23hZf#gn(nH0m!_yiS$z~=${3D)II9nAm79C>Nf5f
z1m<e?;E_SF)<ubYP!Mb3cX_K;5yc^*OFrj3h}CH|8P+l3bGSaHBJ+_AN>$E)KD9vv
z4X{}BCMB3mg^Wt%_YhMS_$m;j5>tpc4!bJ%<F7-!elQDU_qy`9U{;6iiQ_|qS!k^{
zKt{&=lo~+0dFdg(JeXO0Uw~Ot#Z!SdV)$plEUlN{HCdSjq~o-xnkSBKkh%zG%Wj@P
z-mm+R+DUS7pbm+`VSW#4NdPiiXAjD$MZNu4P}nc$Gi31hm*6K+n7AbIA7EAFS+!Y$
z?SypE+=l9IQdkL&KKDTO>BovJS+(~!mbYrb;HbP+tA+xdeJ~EAm{7SAcpQ_7B^jaO
zISAZ6=;Mau+H&Was#MuC7}&-2YrJ;|3-c|6a3(%q*s(}Ps2uCcGecNozc&H(**D-H
z1k_DzcCpAu<aFh^AuQD6C4Mu61^cfguNRdoNed+}0d{4G;FasJ9%Jg%Cw}UD3N1vF
z%CWk0s+*}hc}beOet_k+m#+9Z5qp_nu2)^H3YWKsIJ~#RRaYj@7fz4WzEvjhF_&>c
z+=)8OGI`(oAnZPbw**`NYX}eSqK5E+Gy$N~thrVcT{Mj5nLWux$E#iExR1vpK-ty4
zH}=c%*med+&H1yEWMF?1<OQ)Dj7dWW>r963dT)ZC6CF`YXJ@LOqmCCE61X(@jiGwr
z9aU2IFTjIa{1NDho{~xiqIxZ@K2(I;D-ceV!FXK|5$#HX$WCTd!Pzgl-9ynqGO2ny
z{&QVc`?&|mQB(<vvmDfQ_#66+GU`({lvk$j;1tTvW!EmjHJCy<+B(zGPsK*;;h|pG
zO7HZf2X+Mxhl5WdWjBAkkI$^f`~ub@2kum;kX(|Vannh6Y$5U2z5MNZtbVKTk5qZ3
zz0qMlx}NNkOQ>;Rz*Tm1Ctg&KHAC2IKq%|nXdQTc{#eKE&GIHDW`B`9E)Q}Y1-T~s
z^uhL+vbyW`^7)~xVT}c_SCCr52TE$m(R^1Zvs9sTge116(Yz2O8~=c^HObfo;VFvd
zhfqOxn%{rM+tz0dn;e5FDVhYT*`x%Z;%F^}fjgj6!c&weU?8t`=UMextJ)JW9W5uy
zA!N~z?PwIgP@lCQ7}AG!E+31)FR`X{Uu^_u1dwk*hwh$gjrsc`&CF=s{bvcm8-^uB
zPVPboI}vGx8vFc3J~RxgT|ZRj3&L2>#y?>3l+*+3e&!x<1s$mi!4uhfxAlOi4*Y%?
zYg6-4KDwLRE?e9;Jh}mEW!nq5T3J*pg&)!Lk|~G={{{|_3_qU_!8!)LWOaBq!7mX3
z3_5v`CPPKV=d@J-JC2Kd<dWsgLL|o>Cu#*^u%wPvF5G1UGrR(xF+#-$fZ@*Y<qpg@
z@oyS1|A59cF+}<}q|>Wc%{3`?!O9tRgW1Cv9udy^gndj6<M8f)uiU-Vf!bUkJ}ei|
z3n{OofWH~e>JAzs!PQhubLJi3z*a56<_2{nc@dKHTR9=m7wv#5-?@9vwfRWV<(aYx
zaPSU(3$27w*RFPfS8vGbvdJBI%Z99ht#K$ZjHv+4*~zwu6<?{zW)nO}=k+eeO&Uw>
zR*chqt=1)eSeC)hLZVmux};4DPph7j^=kMm>P5S~xWSv2>ENs2#!XFhCF+|JJKM_@
zH)QJ_D0X4GO>(!;4w*0Pa-{ecX81sD;1;DP+kp}WN~OyN3AdFfAO<hT+{#Yc#g<tA
zoFggp2t<J-203ko7!uKrGW~0$gU_J8#HUKPK~7GJ9FxUPp<;tkEbLI5H-SagnbgqL
z@85=JR(=$7;24~<2CV?1$MsYVxQH5#{I~Bw3X6altt9p8G`85ygFqv}(c53Dx2@c+
zPy!J<`LD9}k>D2UP`b|%O3x)QCmp*{a6l(G*m{afiv^ML_?L4xWxn{U)P*yc?2De%
zwa@_Ho<(m+I6T~hw<f1|dx{0^?y>FC{cVs(wKVGCQsoz-lNaG^$2qZ^@Fi-7AE9P=
z6ZBnz(g_Q6K%J#0WkE!fTnz*m_n-Yv4GLX_2o{gU0H3@h1V{eBVs$8+{d9_BcsOn?
z9Tt;ppUuxVW~pH%Ul5asj?h~=ztXeY#S2xx=5Z0ML8oAJ!eo0p>LfdWg5KT(3*&(k
zv$_mVuZf!6mi9&Z%YC5x$@c0v!bBri0-pFc(H;T((+HS~E*L+FNE}3(D0ec_>scLx
z<+gWi$qUgaJx>sNlGw`^CL}?TLd*C(Lwt7ZhKo|45!G)J7S%eV6(WYw(uHtw|7*t%
zNAuB5SUtAu1YgvIg)}|_LoTjD!CiX<7%!o*MP7Iohe`2ajR&6LCz`O9Eu^Kyb6qMK
z;}MQL^do&;;t9qgN-QI{Q_ar7dlKDl@_J3#5S!^0fE?bj@1R@WqHY;|8hNo8M16J(
zphyg%#M_iu3yFvhS~B$v{_+G5q^9hG-*@48$<3;Tc-`2a09+S6h>&YBZ-TTEcV(l$
z2Pc`<92x?lBXkklac*`=#_2%vgi!$)U?U-gRM3dDDW69-!*t^54L-gZYvR|9x}?K9
z{B1BxZ($I1Px1B5STn!XC>wjv*_r6_Fj;5B)+_vWGZxgeKHTHn7a<@tgDCc-x_EmN
zOz*~}&~99!5LY~T{pPHmuRk0g3e&OUwl5*Ry~NX+vjE$>I8zb*1uejRO!hW5H8dj_
zOutCWKDe^-EzoN~Zbu8~N%R*;4|GrWqx5h}_jaX6O4+}U1myo6wNh_Eynlj9m;0VW
zArRa!P7Rgk@3YuP+Ig9hNGW?x^1qwIkxha1r6?R+<+UUg_BdaRjN}n5*ek6%%dN-M
zLh-#?s`SZ`v8xyegAs#}0#DsBh++^1JNi@*pU3c9Em+I&0hm;vJ1ki^*!c}<70gW6
zQV;}ND5l5qRxMc_-<=dgP2&)t#U+-ue0WP1U31BCSEr;wGhfU*&NsAV{_Mx)d|yk}
zeoXKjxJ`waCH>ignj$qG2O-508fIzJTnW7{x+=MrU17<vai51$Xh-FYXnU2qNCrBX
zKKT(205S?u8$U>y{I2potyqFzwdLek%M+?8G{^CNVH0n)4tqD_TJVFd*wP-gub_Wb
z0(A^#F$XC&gf@)LfFi!V6><I-eEQPYMgJ@x^x4Ndcp&U+m$^NXrKGL)rj_A_U#&)C
z>KVh{ShpENr#z|QX93IIA)E2M*d<}|j*-XEfMr`~b&u{CSzcdmA=D2lgd?qX4_vDw
z7>VGvb>w5Bm}TTg%}6-;&`@j_%=dKGRsQ?&I23YF7ZQd-<TVix8cMO`ccDI(FM5PY
ze~`8dRucX(jsM#bCB-%2{BjhlZySUNTxw!3NAH@>-V#Zk1*P-hSlLO#RFG8Uj2J4<
z3E(|}Wc=Voyal*8iZPIS3|%h<W8;&v7(Wn5=0Q}E=_E=cJF1AB6W^fOwR1_FRbOob
zYj-tkoq!BAzgQ%W`%-pkoiXM82Kol%!`&f!2^6i!B*}MD4j4@KGwYEQ6wKkf7^j?j
zVKp#rkr-l84SDYf%?tGOJW5YmA?Qy6UMqEs-PR)foAN5rETsP&q#~oZ>O;cx$+k+u
zmx=H>$hVw)8c|;XPh@Nm&JiP4z^KC?YXt?H+Z1QsDA(#RJ};U@q&|<_(jRy6L>G>f
zF|eO*O0l1V?{G$>VOh=<nU+SB#|ev~jKhJcY2s@?{!26q=uinHtp{i=AD>Lepnu9O
zN&E>n6y)R<K>1~=I}yA~8y5J?QDC61<gY+5?d|_dE*lUY2}Q)Zf0|nNPZJ%W7F4r`
zb!GJj6NhGT2)$hltIoHyVX=K?z?~?ng%^ZGn0&IMAVS%S1!6hi(!YcyzAhSJtiWvU
zy2h(4@d`w=M6w2oU$SXI)SG|6qua8^9ecEuy$>Z99+c`a0s!=~MsGl)WL$ClAtHZH
zd@X&WDdBVJc*hKM5kJ1BEo<hT1vkS5y2<m~vf$+XZHVY`>T?N-YCa&K%2$9Y?o-3%
ziGX9!-%H*-4nfUTv4PGUq(zsKo6Doxu@>Gxpm(@R=**vQ$AWFORS9ZK;Qd_5c`H@M
zW7xCY=~PBdlyM*kzu=$-FOd!5a!vbVk|<ruvYUUpH-hB#)F&Lx<`}dP9Df38;tLdz
zi8nWb&bMSO9f5r)Oz21aPLMAZPVq_1Lv2Q`<00)?%dmXxt<$v!6fLRlJD_qyMQ%fC
z+ye3N0-w^J^|XEaI`-gUG^h`ECbl<%S#nqJAAof9-JVy5BjH1xaG4V9hr&lwvw~U5
z8A3T}ZGm#`mO0g3qqQkvlTLUG3G&?^6s3R*DkH59=G}p}k71b!E5HY;@YQDQO<T4?
zQh4}sGaYc7uTsu##!SO9OFbOh911}^iwCQ^^x@@q`QsS&dAD)z0z?(vKNE#gue0~_
zg%#@q<Ke80VsYVBWJ2z<NW|R{4k%i}(s*mK!x|Ir@$fomj$Otd$0A(i-*<SO4*32$
zjCbw8nj~-AN44%1YRx)Iw)qzawLt~Eqs=^@JTlkovsx35$aEn)ELVU?c{FnGcle$T
zthrANGL;61w+iFGc3`iupm4r04x4<oy>e9U23HwV+jC;N>$z1rU2wk<g8)|Pe}&EX
z5zBDmJn9Cg=to>Qie-c{_#T2|(*a2s7U-4XXT&OaD6n;RO2Z0gS0<IiB~y)Hx?%M0
zShK5ONcb90;_`7G){!-|dBbX>U(;4k;;-oO&V>-9*o3$-vZPs350rPB6iuvoheCIA
z*AY^O&!pG_g@b<R^S;*D#9wDyAgMqx#~lpnC?mF;^0q!$DrsF_S_Q;DAY#Al;e{Pp
zpx=6sM=2izA$KDs9N)vAbY#y5)`Vv!ulYzgFbyqCw}7C5-g%S1)QJUFeWf1BBh^P7
zJ<T_CVl8WYepJ>=8m`nkqTexow-dA4is2@@!u|woVRT+hVv^6|c_=CCsl{jU4E%uX
z?}!&5I|zLgm@X6h#3hwPQ#o;@xj#wXXR)_*jn0TQyURE1E3RkNum@wPUbeCpyhn3=
zYFWI^63&2IDdG&0+!_*VtdGT7w1{lW0$F)*IF?+B59CvU7;_4Pa-NgsxY-YVvOmGM
zc;KlTQ7(a^Ydnm%Hu6n>R%$xVZgqg=c>zp<YWg!8_&XdUF?Kgk>B4%~ARk0(4J|HQ
z7q8~=EnQe})wjtJCK3Hzi5GTZ6Kw4fP(z#HnYdG9(5t8lJTHp$=-(7ACXdzK+9@sQ
za{%Oak#58V(RUZdo~<%aRUNAfSLoC!wkiA$gik9j6be`$_z=oq2ueUfo;ISZ;Aj(;
znQHRA@vM<YM}8|F6NIl{LKD+VJMCBHIVxovYle`5oD;p_)~oYJ7R-wv{1(ko2wl)m
zg}jD>o&V6p1ve-~qAJL-M;?xn5gi_cOTjvXI~ur@Ucmy&xSnqg_MOa|R*!_QNPZL!
z#Hc~KMG6=qcJj+H^m1)jt=V$L-O`ez22wpy6dj~-v<O5Va=eQ{3A}h~geHFcVgeh|
z_7j>$BEu<UIN${w(5HGvf`u<vsj-Kyi*ysfkzhWmD;pWrM>>c!Gxo`*@c=m<!(Enl
zeae^hP*O%?M3^|{(tU`{`1)=vsGS9;5FxFR(mti$mBB`0E(sOhjcda|Op;QD_X+pH
zPu$whJ9T3Lsa|sAlmX0yDk6bJSFJdGWN))<ZJ}zj84`tOiQ?(FYG-go_mASSc_}yZ
zR`LzqSm2m(L6Bam%05hIA4ClT>~YBaD}<o0FIDC0qZ1!M>g4``LA;fj<||9!G^+Kx
zR%lpJal2I2Zala<t8E)a=qij`S5l+^M9kAtQso54OO>71hz&GG7<iI$fk^HWBlNbt
zKdDCr$~+V9%KO0Jxrj;{K=HBAXv>k-a>^}iJ7g8o;{n^!8dtv2<mPz-Vi7|O+(thv
zD;2WKVHdrSE)VLa$vYUVAH$E^N-R?5Fyw*bM;$nTvNt=9Sj2=S)p|fkbKow4*RoiT
zc+#O5*T&S2%xXy2T6J@U6nxv00T37MN6}ss1qtquI)u|04$Gg<qOO_MrG)8u1eAE`
zbuq0ve=U)9VEtC`Gl^K6Z^-{hWDOdcL5b>*OKi@Ij<7YQ5qhnZ;Sr*rH}BYkMfNtS
zcz$`4O+>h~D#|t6@ri7$j(|D(w}4sb_cB<hzlETP#-`)9dIRXM)h2b%-#=A(ZVwjW
zw|y>E&h6%;hRao0pC1+&$cyT87`C7QZHrcnhP46p6N}LQV^LwT3<W#)$%cPT7h!1!
zb0v0FlM^~x&UxBUW_q16#Z#ss$YixE{IW|VSCYV>E&l2fNe?f+B#DKvN!9tLBo@^s
z{4ZoeXI&x<e=KhI0jYGN|4L&?|JO{=pG@=*pyko5hnMqeRu;`Zf6NoC%)(|Z=Yy>*
zr1n}&j@3?{Pc{|>ONu4~`SoS6S8ZuYyzy**SCkRnbN`wwr^Ip=e%OIFpiZ*F^xd4y
z3qjPsJt3pRK=W0F#Of;iFDr}hM?p~7H;({Y;9H%TuJ6`nH#f;Pn+%wve*#TP`fetO
zH0{NZ^0c}-h%bu#7yH6ue%FWj^L5Frnr$jvuKzU^e>a2nfXK?a@9lS!whnK8gs1MD
z4tt-Q3XbKKM2ksyXyt!UhTL@<fD{O|djmBw-wZCDU6BQP?2qX$;TBe=vjGmvhcEG{
zp12V5Q{vBI`BmC#tNnN2B>N;j5^n*Xa0H_WOnACyYSl+T3L|v`jh9q;p2-q=0$B+<
zSwSl#XXTSy{GkT-)nKavzo)?+Bz+Hx{x2(_`aDIdZe{*;PZr@lJe{7g-d`a8t-@>c
z!pJz@1dyB*lKQ+%)EwT;@RgelQX=Cc*$ipYf24K^{adQuJUFV7&c-UJueJvp;itLH
zgndB3NjH&_aTUkmRycP7lx*)2nQ$-^zu>R&O}$tTyyfnfUaWhUpRjfyE<BWTZ|pRs
z!dP7uiR6xub*9y)V(}FoX%NJ&YDrPWghRA8M8l03@`TS!VSd$fAP5&jIZOGEy|Ifw
z)tB!|VV27MmV!Y?r<JpKK?-YTs|i%OxR6*3=-^qXJ9%$)p~6ZebZPRN3#3T8;w$$8
z3KOqwB!(ypmRL|bR0C0d+8Q;(f*FZ-A8l1>vFxMSjqE7^gzlGOu^}TiU%~fP_%O~o
zc+?AvA2ox;2>MV;*=O-%(ANnoD8b}PxFZWTSL2_jvWNzDRE#<nj!+Chq+x-mh4Q85
zyO^lKr}Ren$&>25L2uS5ys<IEr%>Z^8Mfu{sl73(a+o4@B_7x<7UwZHQB8A2{4Bj4
z-84chLQSY?u*88bfU0?snaY}w29IwljoI@$YUxB%pV88Z=0Egib%O(CF)GsXBx(Rm
zEMX58#T9woJ_yM8_EjF!2kV-rVXzVoDI<d$b1Lu&eb~6rv~jYLD!+(Enn;awZvzHA
zx+M<FH|B41xah+=)TrKy%*%^V@U7?=!oGn=ry&S_b`Bqu#@gdGIIpL%5Z|fDij3Ho
zqyc=?27WM&y})Yj=56}2*6i=yd~#pb%Qj-9EU_-Sa4tmwiO1`x$<%v+22;m&czaM{
zO-j6pM7RO8muUr6Ixm%A|3y^zRW|dyN^<dsUeuWqZWXhzH3@0W?Id6Q2LAtAjP;$f
zI!GB;&cKq^nln{8kX6sRg@j(M!ma&Sm`6|kd_PQOSrA{|kJV}O_6y(!Rhf>8(RQh)
ze4EHQ@%E?m{B+hD{PW4C<6x=wr?e8%_KPX}n||1XT!AC^{aJ8>7Lvjl;UOuU@>xu?
zFspr4IIW$~l8ac+JNIV^RldjiF%|XhdcLGTi;mxeXK?On>(s2$ZToVJ$D$)TrZeYt
zB8N%8rqXmh|EE8TYyQo<dKwj`Hn}d+v+KI}6L_FK4pIqmZwDXu3`=P?rY;RG1y#?A
zXzGaQ5bMZ~#4jx5;g{2gbQBLcJNZ}7u#UY3I;G6z%R67PQ06@4O_<-2Bhwpzp+(<@
z0nMcg3q^*6mj;=K`RVa#z`uOV0PJ{#JV%}0E&Ox-BED__3y7Hr-6uo(K0GwXNKfbY
zpawIO6(9?!Kn2K|^zFC7CdIc&y=gn2|1yBpjVk^Lii8(Kc_!kOOCHdYjDAp%kKo~;
zQ_6V|0(9<{zIxB`GVe4HD*o)te9S;r$M#bRJioY;vjU1d6PF@vs6bo?<gi@hjXO2F
zA_YVjHNZA+I(8Ea#6cul<4(OGAGWK!bJ}1ElaJ8{Qa67!x!e+09LD#u8|kAkJx#FR
zcJ4>Z$e`;2o2X7i<j6sL$v#%>mW#jT;R_l~Xiw*7dU9AM%%&>Q=__&SU)eSp6{*l7
z9KWzwRifBRDX_jjlRc5a4eg$n*~A+vPdZ_TY1m8u`YH6oK*!-cYK7gE`0ImMc*Pq}
zXlsGreF3*jY>Q;o_^m;#;q>Z*Wuv@~kwI*K6LZtb2!bI)h7+!qMK#^j#0#lt#npg8
zO-3R^?l@A&xqzdA7Lwyb_x#4|CG>_sF7}5xN_!soEvbOiH~GxL%->S9kZ2^vQ@g`P
zl7A%@^0x+~8FA_2;lZpyNL&TXbl#`VVmGfObnMPxII@DPDg58TEHLuYOv%UseC57O
zjI3Epi~uG3=3H-kd|H<9{1~egCFv=kab+P-9Kz~(?Z@f>9xZ&z5X2^m1^lfcESwEp
z$n%CUM3><njv*`v*YrIaf<e{Glh+!`>Us3y?S`^&k4AjhP!>_`7W~=ho7A-~eZpTK
z$~yI4e~(1d_T+SM1kpu+$)i4QqO-1%qPqfEE?xRU&2mV>O1-}~y>;(;=MfJchLFG;
z^LfHBcrOv-<+2(EF5JwJvSd7@MPsbk>Y=)~fcKj~z3hnUWoK%jkXyQt#wf(ek${_2
z;bU4ZQ6ER)y)c%O`-di4OZc>aLQFkc4g68SPoO*F2-QZn;6y2pD5C@U>UML>`CzGZ
zqTldUj7*X}99Vbfuqrr|oY8z&MMtJ$MEH(|OmaeK;K#0&71@cJ960mENhG`Z9gWV2
zP%>OH(s*tLjmx6weT;maP@VUtsp`D+h%Xq<n%llZ0%1r;>am#jfvn|D8mTdE&8s9z
zU|Wik#AAGcVo@huW^<G&_hC>Cmmv?wKuaqbs1sH--2_iJg6Q)S7{&8JLj0^;qiR0c
z@Vr4eUkrQ5qermFs0mf&YlieYvEp$*@Dq%f5c_bae9chy&y1{}7*PO@mYA2#<Euun
z*zUbB^kHs`m)IbBFTx})MPu|x@^!uMqzyT}4vR-iG?DZ%9Ny1Dx8w_aj;kCSqIr#x
z%-=@Eq5CaBvP5;qnJ%gNyQmgQR7<McJ80?{sCJS$EGWCAQQ7NPxGH1ql>e4t6IEpv
zA6Fq$R3VGP%UGX@e2OjFfQ%3~T2p0fk-8%M#+5Nz6|$=Oe+v<tWDY+Us+THb8zN0p
zT=JQUeC~D6kXh*D#FNHg1v~mca1l5IX8_1DFPcF~v|DRFeH0taE|l;uMzKb<=aEP;
zg0xtrmv88{MlW=a$8&g<(dfY!=kTb}Yyf+44$m3Q2C|no^1Gwim5}-GNwwUNc_^I5
z4O9AfT!u5+inX=uclpIJY~6^>ucHsx5s8R<?C5aY8BtRX1I6e!GKg#+1|>&-bOG-R
z_$5MsPx)uad^nVJW#W<$TIxuWv!OF3zLc>Mp`^afFN}r7oBlrkeJoqUu2tmrajZVu
zQ;}~U$Aa11C;aR<_(gN^Jf77_9D)%pIqp<OHw3t}pxcr9Fwqbr3079Dk8T!KB?(y6
zGY-hM$Uq!WZzenm^5}XI#DUGXzq#)OW~o&|`=Ye|R)oP=&#l@o<1dV7ZP^~PDsHv;
zzr~Fq>*H2jU-j%(To;14ifgTli_^u?l-E_<YzL2<z@q)Wt%SBi*uw<aJ~~7yI=#jh
zO~CTQ@d|w11XOz?h99c-Ah&AIAj9Rx$7uEJ#z$|0xcEr;i+fCDO=`8n8Z}jWSs45`
zUF~VF@%V|%zrHja_UmpWz9LiNB5~m{&zQ(s*E&FJ&mgfxor96H(g$|_`9#)m{7V?n
zk`L3Y0-sFcIRgd-hKydNnJ-3BGJvDqD$<O~aH~jd_3Xw)Wp^(AdBl560v7^n$izjC
zyz*YnjYI8x*(7kWjTyO^?9Rn9N(LAG-MAR~h`4xceRM}@QBU>k#zhQ4T(W5PhzCq&
z4QqxgE^L@dNI8sN%6m^{J;P$u{OF6ZXwsR~q<%|?zBzOTmPBu&pC|F$$t<GYFVnF*
z==n?coQzRcyH`(p1*dgM;-(_coDrjd<i$OnWwkp!1{KlxFS$mNgteGWq~<^7NFP1v
zX%pPtg6C^^E~{k0#3jR%o{B0SC49)Utd9R1AdzsGE_NU@LN3nQseCC?I?!Qn=S!85
z03VPFTK-t=SPa3EHeh1_!;rN}%+>G&32!@dEdK`it+gmmqD)Jl=3>rV#vJZ-Ef9ac
zO10Nat@;BGm~NS|T0^lV1!CmwrzI=vU-PqKHTaB}Na+-ER4g97MW_!Gd{&)s_Mvj&
z;1l!freK;=P@-x?*RMds=-eGuE>tZ1jc<64`3LSELpJfMup{Jw=E=LM`fz6Xh39al
zF&aD}UXBEqLrgTFXObG|pT>v>7IFKt!+W*|ErG*!6w6meY*a}Z-_u$XmY?Yo=giSC
zfbu<0E%8e%e1$3?4<&vDK`0M2z3#-UxwvgNfXdqU%2Pi6c@|c$C#cQB%?l<pJp!-L
zG)_!Lk;My)UK!0ld>&Ka1Ecwk=UHv<wJkxs8BxS?826aMTCmnndE^vUtIyxR!Of=$
z6n!$mQnFb#+qIOcXL2I|6N6_-Pv#oh@-*}WL5aa=dH5%rpmF=eifpLCd}t~r8Q+iM
ztEaHA>Q`Ezyvfvb4olxr{NxnYeDriO{iT=B&=r3OE`@fqcV}R|ynq#yW{&bSIj55s
zg6qQZTPl+OpHh=&$+8`mWGdxr5}CttawP9Nl{E@>{`0>}+4X?0n9BTvpI|Y-2}cb4
zCr(Okc2aKrV8PT}lOLJNLOLd55xksAME*)+*wdm~*iPJ3CV~|YP!6h(oX0SK1PALz
z@_=cq5wnftU8dn2-Xyu~fC_&5J8_+n4xC{wSiXd%S38}!gJyKj3Q~TSZm#t0W$CmK
zDR%~uznLq2Sy?(3IZe(J_=j{qSNgQypOK=X0%*GJ+^7&r=-3+d$=+oIDpLAlmHwkE
zy`@U8jQrRwFv%$RFGujm>6l%7K7yxCXU&r~O@ey?*Rrhtthg_Qm7H~wrNm90G=~-{
zXG)UZ$A-b6(R!Vz_A*3gHwQt|U^#a<&zsH~dT(lq#_X_IHf96<+jJIT>p{a|IgLr7
zojV`2NI8uiiGGGkm1*qMX{8#A*L{%2wxT@t3$W8-^CIXgUXF<@=6}GHv#OH4*KjSG
zeGinDVH+GOjwt*l;LMgKIh#C;Z=b;$Gy7kB%uHqpf94lAUe-I~rNWw*5m{Q4Mea9-
zao?FNxcXS4@+Vc@VYxk&$IJv34@D*REW}n?qdX_p?SN(W2Njpi&A|x&A8R$ei0_z*
z1-A?L`4=-;hXEs2f;!z$w2g{}u}A?xUHs*+{4qpVuU;`J|H4g}H?<(7JGN45R)?Mo
z@QiOY4D|Su51z$BIt`zQ+%(LjIK7H4!GMClouF8LWOxO0y#H`H^(Ve-7HjAC?B5LX
z@P2VH^k5$8!HJjn-?P|gHfI7KKAVL_zl@O&`m&E0wflbsgD(9&pT#R=b<C|H1EhZ-
z(|w^qeaG=#vzcE+HI<NEn$V2KP&X1dUV#hA#`B+Nv)5S-J71U%;TQkJKT2nf>c2yL
zq26g!Z&+?xilmVu1j7@l?_hpE9qTa<F(lyeg~x<_&Ba`XIoW=TqP)#lRr(}DI#%#-
z57kY&$PJ-#=SAGorzP>9d03b9h@gq8X*uboOsS6)O!$CAx7F;!6OBA@IB=W&Nh@EH
z!P?t~W794AW<u$8k#zav`9Bz~fnjnd2FxeDH-8HVBt3rsB#qbvlQ;=DSUigwl`PMM
zG+~ZnRU=M&#7qftN8P1r|6m|OBdYi0xCX|1KVS(g$yUKR1m*~&azN@ZSuShr46oVk
z9KAgixloXE5!wSnWFE?y)3=FG4}|%Hj<}6Ti5$FX5)%{LnhM5oEh}pDyZrLLtNaq0
zwRn(&wWK>gJcqTg%^X-tmx_vnDn17g8bv!O{wUbRcm>J0mlLyKym9@sY+|_)IsJDj
zHfn^&^Q73a0fE@+J_E6#dKkc7lw!+3%i{D?O_V{)3GGP$q<+gVEXkPoei-7<SeJ}=
zT;iMPc!`$!(gz~FGie0H%oFmMQGCM-%+D4=#A0W8%?Y#GNh>>+62WMw6rN7SSpGmA
zaz+#vVGrLTNRT-h#i{m3DpMsnAa+`S2DaM!A-Eld=)8SEb3gD)3%*H10wS#xMi6*I
zueYoLie#g<qPTY?PnnBltFfc`jJY@xA4?=0=1(CD#s6TC>1p@>%~g<3HpP^oFdtyz
z;(pw@V)aUIm4K;UWi-ggP(if2t3^5>clnVb{5z~*jKszFKH1G+f5rH^WR=c{h$m!x
ztNLWuBCCv3?W1`8c`UGg66v&V-<vd|;CJYLx-%AZ&xjNE_|SP+;rgAwIFE(3$?Gpi
zaY7>XxP`|u^_Yb0T0Qnxa}nr$j~C8k6C&OQr^zL!QsSW2L!8}ViA8uF#hQ?QbVfID
zl`&Fs)ubw^jOJ<`jUVN?%J~+awf)Bg`w4#Ml1C8V_aduddj>%taOAPR7A36s4TV4X
zD>KP8Z1iK1GDm9T$NfOg;XNx2+IWw&@etrB`U|Rj)?6=-IWc&uibB=<XdG=v{l=t_
z%MR6)-av5|uHk;^2c*+>7BbEUnNnL2bAZwyr~xR{t=YC?1fphhJ2}RQ5_Np1Y_{u&
zgedL7xNZ0A2k2D}^L>1Q`RW+XG5*4n1`ceh?8B$#v(OG-_9bD_OJ;QwO#ndN%j*(n
zU|HE@K=f;fp5Eo53s_*~G*!T&ES|7{HL2WEJ=V_Rvlp;deql!HpQZ877O+OP1Z-Qn
zWZ#y;pYa~3`);z2O_#D?1EGU`I%=5Pk_^?yfJ10|X+$oS{bP(bTK1NdVp0TLcA&*2
zUoIfEL0q`wlKpME@C;-ogUo+rKNN+!$^LCnH^_c5QIfJpGz6?V0#-_8521epEkcEk
z$uI9GaC0F0GQned!*48PjUy-bA=#^*k%r$?ic9JhP->a}(3I$x+dT3m*3?!L@oGm<
zY$j=LW0cbtOMcK-jGRa01i_pFfTMp)2yQH>im2IGg?~*&M@WlXL1mz^)}e9)0|NAD
zpyx(WmHq`B0%Akm1k?_CIi?R5KfqVHfvPP$3GgllDy<%MZ?CbjfT}A-=xC8um-y?8
zSTOHsW7Yje{z7f!7BX^jkO~>ua*ImE#27P~gR+-QLMMSlPeC`p-yqV1uEbw`@aOC)
zdr(UF49N}7g$=uk{4lI$M;~)h0PPIUkh{&It4hd-c33N-76l;Z)}-WQv>D`SvbpJZ
zeXwG`<GhW+P=0_^YyFbuxzv-;W#UCT^q{O1YPz}N`W3*iXBkh6ZG=juq?bf|ENa7T
zz%Ux)0d2sRq`8u;m&Hp}56%srnaKh@?(wCWEG+)DRF{50RrOe_bV3G^xVmEU*N_&i
z*O2Hk$#JKOi}%0eKZA;G<mU!`S>$x-OVt^&m#qcB(Z3l4TpcBfg@B6dRnaM-VC2}O
zsSHH^#&nruA|OD&lS2KH+9O#~a(n4j_%Pk_tno!^`Ut-<$y6J+Rv$b-wR-29#Bzan
z5uUwj^$x1lhZM<DdQvGe#(fV;m;3%!`-1Sv`oao?VP66PG<&o*0%n1uaEA81g#py9
zdCz_YN~gg2=N?^@<gn`gk)o4fcBGn%4p>!G!U_VSJx5FXc?LAZmp{t#=F&FM5B>Q&
zFSB6VSQP1IG=`x#Hx5Ga%G&NI@}Qi;Vc?Ph4`Co(KI#ww@S1g(9jFOHXmeLvm)y`Y
zB7u!9B*9GyAB<hNwpq}g;Dd&y?)0OpsZURp4fhNHj{Z?-yQaO+)UlYKiB%N+p_{sz
z%0Sdts~ll~0R2f%Gy=sh3A3Ejb*ERGK`KZJ{hq0iFm^9r_44~!=;fV~4DIdTU$yt&
z*NN={(GG@DwKu&}6TQKrv}z(16;DOY01G-A1}~$a{U~@3;**P%AIDDMm2U)y_|S`k
z<hb1VUbfD>SVtc$c$+u(AU53IL(6Ra6dx17hhvn7a~;uut%IapgF!l`ob>t&hh;ys
zRs<B#93aCpe(95#I$bd|<2_qB=2-lAcs)2TKJ0Xkxg~iCc9O~xa|C`Dk#g*SyYpX?
z6Nu!A{5Ebhf0g58onn0XtU8usxq}}MzY6{`KI~eK<uWA_J0d)vKbMVDOe<*b7A;0w
zs+A#qm>9M5zWjOF%5?xk!}LHwx#1*8(-ab!+3dzoMyapSClM;<3YAbRi)~OOw7Ke8
zQo~SD|C(#Oqmxe}bgVq@Bm-P&?W`5baioD6?<>$=vFdr=^cCEv;$`DQUtu#-Qo$5;
z&#@Hc5Kj+Tk1NgU4&Jj6bWFhZXlKHR2W+~AHPEmSz=mm<&r}}pDr;lAh(&$nJ&<`y
zy5}Z={AZ;Eh5_d2p8}RVh^6@FWc?FSEmwPFkk|Ga20ZC<p%#TCNL2TKcn)J=)75w{
zuhgAjH&>uGDRn@45E<&)AhY!UCPOFml=DaL1rx&&F^h2^Mvn!3WusZTs<vDC0&kUr
zC547QJUNHej~pm_lkydY;x`!=myLJ}!(w?~Vew`DRt{@tlgf_}T{?f#y$!U1X7Duo
zy)>Bwf+PL#WsCaZ5E9;0K}hYRfkbEB2x&VZWz7#%Ng<S<&RbH_N}0bGrb<`D3lKTA
zUT1w=ElK*vg&=RkrhvGGM=Wu?b08FX#XUKdld99kD&vI#&2+B9f5guFiaRtz&Kl<n
z{q5xolZ%74ST*{W2Gu3qe2b=99dq$A_AVwFN8S{DJNIK`C6+wEk{oVN(nbYdhj!&@
zS7d?>nD1MfBZzX~WTMPbI7#M^MNp2lREj)uhiu{@T+Qgbm17G1dH7PC@VM3*P44iH
zKyS%C4GLl`vQxI-fLJtC$&l9BPDM$?lI}n(B*a)klyaoxO^VK4N~XPgyc&h*kSwo?
zr}P`L#G3jgqMa}OUC6SaBFS=m2G3v0;%otm#$=*FHzkSpCn{cA8+fUxc<Dlje-Pq4
zLM-LwN0l5($$wJvP)SGe(%HaE_42%IOy|q&ETqlI48^|KhS|Gp!;SLCIq?p@ai7Fl
zYu3+*V0b1xM!oe<EWXWe+Yt}e?Nh|jpj7F}HbGCGcv}ru`J#Bd?8XZLfXo|p1AhrH
z|6=q63|I%TVGbcl-y~XPAzePC@+7M~zjZ~P?v$rF@}RFrrMPweSj5HHFs_>q;W(xo
zgj}6z97Z2>E*S%h$bV%3dt#(@bn|dNhiNKE{fe<uT_6~1^_m?AG8rHv<7p)s**WpH
zW00cw8}d6!NtIwMQAVI~9Z(bT2nMAi=-5vs?eGTMsBt^uzAte<V?6KeU@a{_-+|AX
zL*tmkBJdkX|IXwq94xkdMIdAE3bu>p*dhT>l5g^BJHR%pIy6VYj-(3C6l@_O;bKqj
zv5duqoPd4AHK)EHdj&aN%L>4Fu_qtA42r*nzz**};=$4!VyWdgDbP5op4{cQKr<bC
zwHsmqi5lZ__FrgLkdP8^SQ^3_6DFYyaiLsQD1Q=zcykI2j|-)p3q|hs*l-j>;XER(
z*JS)$I26W>l6DXZrFFc4Ey1viMCv`?j@2uwVYsB;VQzp%!YPEiSfU;bOCh?TRcU#q
z3}juBI9Og(5MAONh^ivf`+bS|G89pTysolmB0#x*hj@XWf>U8d+rdyhDfopH@>&eW
zbkr*Zu>CWB{&g1A+-HVdSj^6m6+oEi$my^nBS52$p~UP0USm0{Wt*ysICZleL$dUK
zNWv;PO1efDy%R(2K~8~SJ|2tnc!U{Vj>;E{LHj7OuV@$wTaW8j+^QqIh?1@z(Lq(B
zpdyf0bc!9CQsKJzAzxOt%m3ix93?3Rknyi1eq%ZAV+k2UG}S#A0H36>jM^&MOL$OH
zR$d*1BX$#^vne-ucCs&Y!kQ@*uXAT8-Ud><xua>3wjkkjqN#t6<k{i`Jv$b*#=@=Z
zUJGjWlf$Xz=8>*q8ljxGR8|)kVkw>xiQ$TZ1bQUju!03unS;!9LUZ6~eqse%>Gd&e
zBlNQ=AN2-?;~_oxyf;|w=vAF0YqvUrHF+&ez$jT}IC-0>n!|Fn68%DZPe2WEJ3$qG
z`VCe$C=2@G5-;iCIz;{=^>QMA`UVT~TZl(%$?-A~ZcgM)SF$?KT^xx7glx)rP%%`8
z7I9oQLorjGn7Kf5vI6;ZB@z+t2_W~*YR3j;PcLDYR7SNfla@JBCgXAqUs}Nwi-z)D
zD_PSvi7>ft0oYi3A**;sH2DJ2VKSCjUYv`HzFH9rbr4v<XzsI$wP9CA@WfTDU+@xG
zrT;}?>KVRk6^p3;`d1A3E?Ac&d5JEg_>ZgDoGMinOdJ`>C#`0K{J!iU#k@NfHEV+f
z0dapAzqpz;tUl|8D>LrV8ObZGVX>BbFi_Ie?Jwo_{3+gV4S0Ghp69H=s_Lv$eCrz4
z-p>Jo(5z)KpgW)Fo*Bv?u3>d+N7AIn-p30aBjXBM3UBnIxf<RGn#5ai+_q4A8c*V^
zhhH;A;k)*rKz9?1x<mPT&bm)*E{%-0gA(>q!s#JIG6^GKs-Rx<rEr|4=94~9<?fEr
zm7Vm$9!T;4*r6HBzr&CYC%~UJKxp9^H_d}cS%7un5Z-ew!U=Z`;m@vR(Z1&|lTukO
z$S?12C-SXpSzIe;J0%Yq6fWSmyUSPyeX88B<aL7AdXv@lZ;qKl>7AMN@IY&(6yk}O
zUYS2EV5Z}=^x-uKV|qLVpF!s!tMk#sfOldm8G0+^{?`)onofMxn+QJhgDlE|&pgB>
zgkd<6>bZiWI!g7mJizv+9>csJ5W99nvdT~?53%79ukjXw&pef;Uv|~Z9cQ|v8tkHa
z9h^ZX6GF<UerTZDN#?+Xyq18#vbeByGNX6S|0n~&XEIBOtB`b6$Q3f-YWVdYQmzn_
zxbcuGOK&CXhI1FLjB%=vj{l<&u}S8r<3jaSWlTkU$0%1JmU4x7hzyw}2!-(aq)Ofu
zfZ!rf7$=1(^Oj1q8*%{s=eDvVOu&~|`<TD{HZCyO^}bX;>0aH)cbi*{9so_onlfOH
z{xK-!1IqTLgvwie9|P9v0yD{2Pj#wv>t0^v9oEqA0cH>7R)0hXH48tLN1dTSFw7zx
zBR!mSWFCdwE0h}Lj}mgbL%gChig9+Mj$&Vkax6cQvLoNveR5nQ-)V=+bC)J6y(mu=
z<N@jqDjTTn6>7EkoVF8SSe*BP1Lw`MR;LH5^r|^^k|<do6jL!lH4jLUWVFUO5r#B$
zotQdd-1l9aL@z!9#%Nxw<A)0OOWgF~`Z<rD9RrHd|06L`C!^o?7(gWmt3!m$Rk2QI
z2tXBny-3wo$b?yyFclAT6<Wq-97&ACbPw3i!bH`fw*y=hap0o#;NSalMo}P6ea6qc
z%bK#Q9rz#g{ag$WeUAlI-_)2ILrwMX#mIJGM-TH6@3FwpgMFw(a|&5r+Fm_ZvYdhn
zC9l`Tg^7Iidn_erw`?`?TGPisf>W+jW1JDq2k^h&V_|-mX<nfgT~cVj!TU*jd09<|
zYgmkQE~QqKJ}?MpI$x5FS|IAJLdoPjJ_kU|VtG))XYmM`YVOHx>sZ9ZZE~1J6r&ve
za0p+TPAm$|z<7>r+U%c+SGt<zo@83S=VLGi3vsTWqQ02UbX(O6K)O-Fr>+FOyL~vu
zllRH<u<)?;%s(PGvP@Jz=-wJC=dCmxW}PXKSO4T4;v?6yX2D%x!PONR)~rbpC`NL6
zO%#pfAFO9#9-jQvdX{7x^{#8;<LGpR3czHBPI}M(!ZrUfr^&AN1^~G<MI!Z`2bj2A
zB&#8h1Ewf+n)_Tqt3e^g68=$*pDby}3wf;Qm{(8hWx6IFySQTmM#Fh+`K}G{E1R^U
zeK;Bp+%HS-g2hB4Js;ja-QGVNgBgk#ehx)k&_$54IENwujwZ^mOu_&mzLjU1<OIDH
zAz#+W%cN$dT3zdS`MYIRGHmUkZ@1A0yE`T^>|P`Aox-FfKiL01k8wc8j6q>T#V5In
z8@lvM7D^89uOf?R$yt=o;$uisWcq>(h*p3P9<Q&kKc$SDPtFuzK~M0mRDSY(=G(E}
z2&F)DtPF(X#WXmAcz-U;i2r((Bo`^NUh*|9Xs7FYH53NWxs%uUfW@-g(LCh?M5XPA
zvC!-BbOF>=5g`3hc^MRV6kG8~5e1_tMuqN(!XfW&VyJ{>bby(N7xg!)R;C5M`={JY
zaC)k2XAiU`nzRb)m+KFP#dm<?*jPMRua{~~E;&h2<e`{fYoTOs!3Jv42nf0{XB%0A
zs*hkziuU69@76qWBMY;f1;E9%RW#oLU0e4apR|$1^*Z~e;)WL6emm*L&Ab%JO+|31
z_M3)NAXt%v%FAb-37-o#PhqDXi(H}Ni*0IsxYCDMA8yv1dY0RM0BfyAgu5`qr0*f<
z(g&eiCg)T9gX%p|wLXuGYCm8gO465lEufMt9_Q7dFmF4FIGtX2c}ivClqrE)vp!|o
zh+le2Rv<?0l=Vw*02k-gW(_>cF9?i;Ekj>dm$DXN5!1XelHdLiM=&e!h99wdRj%(<
z{KjwNy+6X+j{f9jz1u>SMDGS^ON|q*-u-q@DYpm!9Q~pF1)@eT$a@MxBnX*aj{Mzm
ziA)`Es>1#o5Ls=)|3<>xWc(U#ypl3L;<1H4`Uv|i-!vilx}Bza+=~0;p}SxHjQGV%
ztuPs&j$Hx;f}kFtW##KbiGCXBJAaT}Aze!L2`md`n!Qy@mevaMC_^d)Ng3)PgBEDM
z7z^>EBI#{aEJ_kMkqs%woMcFFBrFceRQ7RKgh(gw<$RvXbXYzP2J<M+jN(9KaUL?w
zgSM;dN^oDN-8(mu`)-EfJ|tTKTMSz2^iQa`wudKeM&w^KCMuNV8tZlwY8l$vJzx_Z
zj0A<UCZLbd5Mrk)IV=NfD{yZK&X{|khJ>5ngQP*kMROErqAG5&cL_w+?!Bf3|86sj
zzzbZxKW0JE56MDdDO(qI{1YihT0UP7P{M(DP^b7k@vbyw`J(M7e8|VlI{1U3L{3ij
zeB4${*FjLxUt$7PV!0&+L(^utBaolx)<p*-Nmct6F!aQ#C@MDwC5e+s{I8E$J-?J5
z#1=MCu#O>#^=ZkQeZoe!ZtI0Xfv&Y1Oje}ixHazftm8#5WiE&-@lL-k-&2dovo8^}
zB+s*ms89LlpRnG&KEu3M=DUtzfSjDT-)9{a_s}P>gHlUwk>H3NB;3j5YclyPE}$4Y
zRJ#tUiCqZD!w*EOo)v3%@qt@dl<y6=M3Ufe5G;E6Jm2AkrY*77Usx=5y;0iL>O_%K
z0};?bdf~9Es|`w&_5Til+%wdGm`t4mOf>oi?CH+-o<b)jXsqz}5dJxh|F(pco?Bdt
zYty~d)pjp_#5-=qNP4y@AH5Y_>$z}LULBuTan5qgS`Pa{;Z5fUqr>51J4CinhuelW
z$-Sn_sD?6}n2KYfv~VzLuphR8X4R3KO8eVF!oRKYzwS=$X1Na~CA7*wvpNzif7g=F
zORwWiIO5Nbp5m1WX^U^BcZD(RELSY)?6$+)tPx}-CoFbz33P%K7(pXj8_3so+rEVL
zFY2zYRseOpe^u<*EX9=(<FI<7FCIcBeSI48O@z&)t}Nd#Q5x&=8mP#fdFNnQag4tp
zm1_T4j0Y*T;_0)vGx-jVwhci5<Y=u7coj)lTR1P+#=@I=z&)d0`Ia<BSi4H=3rUqg
z4B{aiMoOZ~(}Z&sud^L<;$I?oM|@k3!v?8$1iuMfx=2*`XY*;>F^At6!C%?VI@`ua
z=&mc@D^kjL0_CJ}2XC05X~k4DD*8@EeC4*FqVl>z7FcYfqxOs8WYKSZ)IJEz(b)cz
z)N1t_9g8>(Bxrv%x%RefEmi++YIck7WOp5OkYQQvgxbKnogmfqdB9NQDu^YwJr&uz
zE1$801q5WHNww^<o4JPc*BbNpcCfIj!?&T?cA<4fHRk64@NWfxlmV&88y`UH%`3Ub
zPS(ZNd>O`8R56pf00ois!EQPQk(?7Z;w1|c0dNdz4KAvI3(*UViI2XPN+4&3byWuH
zPn%SZHh=*ARv4IWOYIYYJm4k-VlLZtld(nEm@`j<@8o7j2SFuC4KcGJ&7>Xk7#M%G
z?e->QKsS+KjF*uW-hW~Gpt|6e4dhb<HW-dXx{+I5v+gkeTaQ#6VHPe!{ar)lUL1ox
zC$69Ncd2KPq;9^Yg#NTX`0qjd$Dm%$fAGs{N3;iobPsAlS%<-i)b7P*mFWx0L}Q`w
zq)Zf_qesJYB0)KG>9h_rq~18WS10w$#aX9@vg+mHXTW69LKGS0gKD5i=LW<Iz&udI
zC?ep^m66BMw?+zrOlF8F7;%cK$-DQkytHOJ@AxSTYJC$5i;e2V*s3n1pR3L1NR#V#
zI*YF(Sd4(Vq}vPcp@&fsl{WBKKV>bR*>6WtNX^6r4_>GjsR-UwX1Tmis)!ifSt`hV
zJUaSg?X^H$l@K*!qq|}<iMGRgOB3z)ZC}T|cH@Be_jRaE++4oz8pt+DI`%QKP#~V7
z`#_*@`Ksc7ZfE?$HO%(c!ZYy;EIfqi6*JdM=?CQ|0*L;306VzEMV-!k!){zBG7zn!
zcT_Omn0G@Tt#&#^e72-tq?2w*b5Rtp0u`1XkhoKG5HMwK1P-BrP{h(5lm<|LGHyDu
z$qTGHhl2<isd}VK*v<BNmG0~y$oHLi+dV9T-TQ=(+QWua%fUDg+W<cH*5@bouttsd
zex`a_fr#%Y1$hC0+;lKOmDmFqke{v3YkbBmaW5)ll8vXrUQXC^fbGQMMv2;ma+uFz
z94L2m{)_rjvNbkgV6fjVt+3a7{FTpeZ$njn_%n=G-KjL!MF8V^Q_*rK%FB^h*}0eG
zf`aQwmar61c6oGo4CS*7f#hk>tc><oE=qc(iHO<GI?YfAPJ%~&O#=$O1k0XJ3#o~B
zp5paHDdB00^Q;x@=1ZY`&|Vh993Sx&dvUAo!QOn+Ue@`!S6_8AP_#Gr$!?c{YSTfA
z?I-{V<hel8%xE^T5pYp*1*||}X|D2u%0jwrQh6MJ0R3tRdh7G3o|w_$DPMou!@t^R
zpVIc)cuZ1~-saQyL0P8-k+QlOkcIW6NShD)kZOBQaLl>n8&sT)p+Zo^IcOSCZ%@=;
zAnF%mIeJN8n@aC#wT29Eu?}`){=^D^($Vzsv~cnu7Rxto_y4y|;j#O%xO5zFdBQ1-
zPFv#MNIc^kOTpuDHta)satvZv&X+B<tt~xUet~hMW|{c5>?kyb?cO6<ONW}|I*7IE
zl2E?*6pTQFJu<3@YyaScd_C$O4$E<Pe<0CBG*C2x(VhYp6>CxnJ3Ywn#KHVf=WkL)
zFhzNn|GS?BRNq5J*I`+R+~WFMJnR6Aw(SleIjY5`(`YAyk>8AADZw$VTG8`_L^kqe
zWYD7kmX6FTk>_&?u0X~Mu3k6`xr$=NzIWg>%G>5~Ne8kfA*({6oI{W^F+z9c(DVu*
zfESw}r@e^8v+hk)9b>!~33g&H{?7q6JRq+<0WpFflT{lb<+`OkpPq{wphoxPujH}@
zaf8spGOinY^eWujR-ZItkjjkrQsJQ|J?Q)1GY%JFL-L$x*Pefu%bNOyMI-IvFOmkf
zUapEEcq!gNmh3T-W9SbW`c5Izb%;|_X|Rf|v4OZUTmClRlCz`gdPKC;s%63eyH+wx
z^8}xqukc&Mp$n0FL=RRwrsB9ywgJC=kOj28gbL_J43xE1nau|Qx7zFc4Em+XloQjL
z>%qL~A-vwA?x#HE5NqH1L*juhPo-uHbuENt!8R9pChYaFW}Wh~#@6-8ejq)e3u2p<
ze|Cs<x7|OLnC5|NYDD)XQw!+|_C)*lbn$xk9Nb(paFMImJ375WdV`)!{`{<MuFn4t
zBnN$70zhuOltzJ=(FPs=93~QkPLt<u3Y{c=Uf~ZRd|ExOM~xki4DdCDT50wEe5=}8
z4;A%RlQUuAJ3eRL)u+P%NN)n=+5Pz0&snIg?K*0hb7E$aYoJ1(r@o)I0|oTa4DCRn
z3HGm@Z&I4ND8VWnb6nrM8U!4jlJN)+;(08w(x{OOC?1D{_au$DNrG^>9&S+dB&R-K
ztXgf8XjpwR9|%Mzp|vvewVGu5(Z3Ro;CLnGkQl5m=`C<gtFvHyoPDv@BnMW|v0oCS
zFdc)i;F8$Q(@QBiT$HGzNIEVWU5Lhc50g!KHN;FEB7qC~U=iRq!tGdvrpK)icj-hW
ztqD(tMJ2?$(o0Xrz3k=|C_v{yhH-8gC>XXGc~^=eQWKF1;QJPt<vNN1&=#rl6uqD%
z2dzmHHk5#pAV6<G#SBOeEEV+t6PNvAiAE_7Dudj3kSoFkcb0odAnv-!v<zBkyY8Vt
zkqSh2Sqvyw`tEhjiSmT&keWZV69^7Mp!IouL@N6Pn!sTV07fvco`>r;9>PS?0yvu0
zF(?RaBMwcMHT&W_%xkfDc?LqpxcHvLJ144OBA8&mMZ7gzNv-rSo%Sebq#>i#zBR$}
zGU_?f@U}zqMvw(fG}zg)!+%+l6yBwVIigSL)qtPk34x;VJy?(puaZSZ>V4Gps7qwX
zAzX4&r3-0U22Q8Q5Ty3%u`X@}_C<%ePE8~#;s}OLpN*VFCot}Pg!#Pq>nv6GIw{xC
zWcx|0{Ygq}v-BjTn}E*k2(EqFNU`~-K4_W7i}P?#&)YbGoa|YW65A@{2=%dR-ALL~
z??TO^Z>HM+#m(YAi(8|Mbzhp1HZdW#9`ACL1=}9`WIZBt7X#Zt=I$qH?#vBQ1TITQ
zXaF@%nipz>%frl9QEz#WUA>mmXYq#${V?FLe7{01N|Wv0ccqq~k@8CVd(jKt)92wG
zt!gSOnqhik%}&ajSG^4O2kKyzp@1Npsn6D$kAaNaRyfSHsi-!Dfs0-2<_}dOuXl_E
zc7E|K2(!Ye#K9iq3{GwZufWkUDH#qGUc3TJikG62K}n3hPgQ*dx6z>W_0smzEqvxN
z=5KBTg4Q+oRhhbX06p<K$5?RS&lvFJ60fr!GTKKJIs@>1{ya}R&N|p$q7!2dZy)qg
z(Xu5~?WQ~#-2(u1HN+n^kmN^6czwII1n%5PYqQhVxZ*jqjP()LCmjR2fW&#iD{29}
zW<}PxKjq=m&=ZpSE+pkr#I-m_=}_((OFd&MWmL8D$|u<1#$9UDRXEZ!dYE376n-1<
zl08pZ9nBMAP0>bI#F{QV=LD<Q|3(x@*b90(LNX{xJPTAgAxcF|j-wjR*<TVfgCvef
zrQ%$7E61Ib6Z<h>2J8kCPcX42alSeK`veQ#7kZKvSK1ePfyGy|jVI3>pYwE#6ra~#
zQQsY3SKsSt+X$Zpv}}k^_!#xQUVn#7P|w%Ls_*lo)c2}a)psPt|KJn;vikNV-yWa2
z>f2`8NRBE#>&b7!=bahqdzJoPtKr{GRPe#A&_(e1T7R3SD|m=5_{>!GT!G%vjZdKd
zj@RF#HQmYb*=905qZ8yyy^&#mCS^033g@Zs8Pq57>8=@F{G5Wj{!`l!M&>jHskT6U
zADXYe&u6Lcvj2*n{|-QCj_0*SCAq%GQvyD&=W5&3^Z)hjwPi&@WSSdMx4cFgp_=yp
zMau>Mf1x?$|B=@JADS-Ql>bNC#Amyz<UZ3UbE|np4U5I~IJ1SxG_{4PLK`HtSy7|G
zzQ|jwusL3n?YVG8Xw}vW4w_{yB{}5Q&(xswv946<v@AiNoP+%DDxP(1hqkF4Uhk`K
zrU`V^@G}(5g^#C(=g^!SpB#<vsS9{!s{yVH8ctW~x#Ls34?cMc-&RIQ@n=e*YfkVf
zEdZe=^qI2R0I#ax=Z$bWorurqPYn3p3ZAyb9gZ&JiC_)-toqnJ0dRe-${Aw~s%ZR=
z4EVI?fRA;P0Zwnsz-O}&POm#1h`&%n4d_|}`h*xnT|tZb4<lTQdQ}-iD{3@+)z{k-
ze--xmdYi3X_}bxS->@-?u&LOpg{_~*>hH<Pd})fg_mE6%&C%!Qsfrbs(iCEUjy``-
zXemCrEltH3PUz!;mr_5Y;4%^aD)O0Q%mG0zmA;E{#{J{P$BZ=xcvR*aMw$bnw3tn4
z7s_Mlb~i<0Z^!*pjYm;#Z+@|#IiP`VJkx0Gce;Ok^uvtPY-KACOG2I@T{ogBGqJQ1
zGKX$NQzSOh+&_N2?>JP+U&EH`8b6~YWZ}Ddn*(g*MbIZ6d+hF?0R1o;d-3#%NLPXl
z)bKPz9fLGHRO9PMQ?LtPH-rmbTm5KinxWZ#X1Xc>kyi2(-=lmr>u`^O;J2<$j!Y__
zTu;L@4Sa=acp<`#+&}g8L%abVrs2f~`VADEKN@bXF(zCirC~eM{nOa>V9??S4KFk_
zX;Tf~skPUYy%~>6gTgfDEBc!Q#?a9?`ebU+#?w7Q__UJ$(R2n~j@0nG26&W)!z0nZ
z)K_c1VX!$MIa&kr3^gaSP9I+bIa-{jPnw~{+wnys&`|AFs;SseH`+I(&+@b7xrkL@
z(|Uu9C{&d`c?NxmQ()5!LwD$?;QVx&xrVKiMv62Lr6pndj5hR{E(&ZaG-zwQhG!a>
zNYL;Z27A#}!FkePbB&;G8Y$i&sP25xAP6c^Cr28RY4d<Sz6K>rQee|)g8;1>o@o$x
zvWEK_G`**S^B?;{qkFlK3>8n&@H|7eO4aa4gQoY^@OT5$eRy9eMNpbfHW}pD7q{Ia
z`5B$O-jLjnKR|zo>hH>JU~+(l)9k?gGmu9OLH`+~Va0~V9<1SMhHOJz_y+h;4c}?t
zZWw<s3cYm}_W+Z&*&1uKp&O-Z_+3M@WoUT3K}E-Fc(I{0?Vp<p4SGL8;oJU`Fi8_y
zZm7;=SHXrRd{)B?4QApw4bL+a{Je(Wl}*m;4l`Hrn8J@@#IsG+Nuv!7HqAxKQ1o;S
zFEqd#y5I&aY~-S&y#oDc8l`>=HTfDELC=azzJ^A4LFZg<5cXUR&orp>JYK&q^z}uZ
zeAkd|KJJr+Mb$GD(|UvC7rII_aQBji`x+G0#uq&U1<T}pN8@V|uK_nA`DKl4G9YJZ
zc%H#rFV^sQL)EkSH$%}$UeU>EhN`@(;X4hY*YizNp`i{-G=8C>n5BFd834OZHW>u^
z8sC6QMLAr_2CB<6{H{UwUgtFiAlq`CyxgD%dQxo)HJHRV_&2b;W18q}z6MQiq2ZZY
zZ3|ye1Fp;congQ?t7Owo1AG-<1TC?x*5q~?M6yQ1BMl<w8ou6Ou-9t%T|;krQ^Q9a
zn&>SBuW6cLP=&X7U+9zV9i1=K(A(bC@H|6x-qY}S1ALu^-!({oy@qERT+0m#UelCj
zXyx~LeW+sc2RdJ|K}R-f_zXk+Kh*G@2IcsOkD*axlTHpbu(8<%H<0_7??N|=`a~z+
zHAr=fhG!b2u$5oL+`wZSpGm!QyT-~hbbUSFHZ3=3<W7x0!%*5Tz6+Wf^{Gx?Zm8mJ
z7u-;XJ-Bon**??BcMXExtKp*!-0kCip|C4DdJS1_uqp?1j$*?omFt2VRE(lR=u>Q{
z&mmqPlaeu?t5nl^gU@qV!y^siIile%7g#@<^7M~FLq(4A8hv1Gj_Ks}22DE77m+1B
z!DkKw)=3wZLAa;*(c!>4jT?*cHJf{2NE>rTBl{Xk{6fQb8U%D!!_y3%?3{+j8=B@k
z9|KRw;{u;ah34~bz^JW2Bd<3g7ize#q0oyOZZhcTml{6Wz|18LpJAYXS;1|l<px4m
zbcT3C^Ip~PorZS3rr{<7{JMr`8VbJQf=e~jb1#B@r4yDLI`d8b4fM+6YrcV|@wYTq
zyrGe9^ZJ<c2HnxgCWDsU<qyznJig)I5Z1REYp0=a-Q!WINdC^1Y+(I+{(zEy(8)6l
z#{Ea`0i{Y7IyuwOa!w5&ZOHbMhDRFeU4+}%(b4I=0(~+K6~3>)rk#dtzwlku4YegU
z6&psTUv;)(gGDcPku!`;4>Wwap*FaF72J*aT_>9iT>PQo>kaMjr-m0BI^;tazCr6A
z@xEv<kH@?QHU3{3%h#affAc6vKIn-~UT#pue|TREK2iVb<VZuSKh^M1L)j&K5hQ7o
zOVdD!G*}uB?Hc$R+S9d|>1(LEYcX?%p+$!4;tLIQMkshq(@sOnkK|F9lvG`*^Nr4D
z+@4}?STBCRS%T8^_hkJ&SAFy4yF7z<=mfK`XWC&}<*i*wQ`mf1Wz-ci?Uczwjma9@
zwCYHCbQj!(ztNDs)$qLM2>)_|xuwlm?BhH|*F_I(xPHp-J(^A_@M!sTFT=C1e*XW;
zx_Vf*sVID3-%ByA+WM)qgi^Ie>X6Y$6$%1Dq%wG5Fo?lJ2M>VKiov4?gk1@V3=FOW
zN(P4O`0x5BaR#JD6+;B2ct9mc3>iIi$iR@HLk5I6&OP@@FL-$0`|iCy=lJ`s9qC?2
z5tjvP+q+Yd-#UpS3g0h)%QT#S4nJ8i`{i^pGJNy1*3IMnYp{k7q1pN0=)KZ}Bxg@*
z;Qxq9_QQ%{qJO{AzklV`9rA%kxQ_3L@uFYE`S9uKs}c2x{!jM$@9yzW_xOH2U-15i
zSB~EiC4|47QlE&F!X1%XjPF#<936J<wK@mI@c3Tq{mbsN(^U_iHA7DJE}#gYZ;JpT
zfe7sVar$gAJw!hpesm8U-Iog1hwrzPGpFyE{iz9lLF$uhb^kn_%0n(%*<L@t;T~=8
zw??l!qp$cdia1AHBCZi7hmTVbRYVQZK<p#Bh#n$EoFP^m9kRlPHR2Xga(TiwVh6E{
zs397NeMB44Mf4CU;ta9c;cY@{Y}g=@2RyNis359{+Ji?wf75z;^UeVGo5WfX+uMIy
zAU{ISx8L!={4Z>Ze7~D>^7%u_shXF@;W)rxwcvP<y$~FOT|bB8G1#pO$nhS(ja+;@
zSb}4G<su({hR1iv_7ZOppBt`>98Y*II2QDe;8*z7$;~fl!Etz%b0+w!oVPDy|7)Co
zEBLjBJA{Oy0k3c_I9_2TxXc68f**7KL-WNmI1VpyJ`)_bHT0|4j|$m>pNH{~pA19;
z?yhZ{cWB`_ys!iEW%FKk!(Zn7>ubm_a{iOx=QtM@9bV@A_vW{(;W&JS^C!)BMH}Ac
z`N`epyM9drZfUH<fa|+vqF}#RJ=h427TGuW`A2AxDBuVcd?NZ$;U5Kmi5R;Ke~AW^
z=(*q$FW`mXsDRYGoe76nws=?J+~Gi^HxA%A^=O&3q)S8XaqHrvw;s1Xz9Z|g5u0&8
zwqiSW<3T+9;Na|g&M2V?OJ+%xER$7IC+lRBY!kvHCNquc%wQ(#GmF{GWdr81iY?iS
z)ojf+Y|BV0rE;pJdTOL*+E1<2PTh2ndg(F+Nr?${+Q}dpL5?Ov6TgWrvo`B6mGvA*
z(xhk-G~p>@Y|a+DBu$DYK|57aHSO-wG)bBiUOGxiuSJ?w015iLyQDN_={#LP@^wnG
zcBW=pW@dKgWh`4{t89}=xsrGDUasf;+|38MGs<UqmDl+?-{x}BDSCxbSjC{A#k^P+
z>w-+$6Lq3Z^ocpKC*Fij7L(OvGm)msv^&+O{i!=0O=r_;T2HrAx$Km^(kQKRP||W<
zF3WYZWT3Z**|<a7RHYg<sZBk~=z^{sx}lP<_+4N3`@ZXs{Fz_*wZHY{acA5c8)Iuc
z7}N25yd1B`Bxna}pao`N2VTH}MX(AsffOoXH`K#^=!T<k7FJ;$ZbLchM7_v}tY{F?
zXdW%2bwuKJtj66~gNb0rUd&==5wGG+EG0_PP4uLnxZqVY8*1=L29J7Rj|J9Huw@CZ
z6R<-CD@?G#1GyLJD&3?~rexhr&-$60jj~x*Wp%dA<h%n?8@UBS(|n#UL1j|33$@S+
zv#<-VU{bLtR>h`}hUvepHyk>hPnXm6l$7mKEw$1t?b0h*xhPlVrX*&IgpJ`;p<Sxe
zK6UAc&S*tzx}~z;@q51ETOcC!83<YXWGs(WkkJGg-SKR^02%A?285IYCFliuKtefG
z!(M2HR_Hn*4Hw}O^dpfRDUk{a>X8W=dZ6I~^y|es+(2GT<5|3jYmiP()TEb~i3QSm
z2~-CkXw8k?1E2K30I&Li1%A1~06ZH76nvWnbMUSTmf&9<tii)A6e5L=9JayC4ph{I
znlv!gfXez%TQhrF!~*C-y8&%Bn9agD*u4tZV7L^u!SZgTf$9Co2HQsw1LLb`1=epP
q3C!>8%s1dEV8at&1QTE$S1<$C@fPMl`+U-YX`m$rOoWHWH~s^8TLOFl

diff --git a/ShellBinPkg/ReadMe.txt b/ShellBinPkg/ReadMe.txt
index 8b7c9f130b03..618f15c536c4 100644
--- a/ShellBinPkg/ReadMe.txt
+++ b/ShellBinPkg/ReadMe.txt
@@ -2,7 +2,7 @@
                                  OVERVIEW
 ============================================================================
 The binaries of ShellBinPkg are generated with ShellPkg project and built with 
-BaseTools Package (r19307). The binaries are built with no debug information 
+BaseTools Package (r19529). The binaries are built with no debug information 
 by building with "RELEASE" target.
 
 The following steps can help to re-generate these binaries for customization:
diff --git a/ShellBinPkg/UefiShell/Ia32/Shell.efi b/ShellBinPkg/UefiShell/Ia32/Shell.efi
index ed018b9cb7c64a55d70a442929c2cbf521c18cd7..36d6b9c52ab372a100680063c8c367b1b4e6d21d 100644
GIT binary patch
delta 235021
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%0DZJGD!5(`xL-&1(eg*;@(Hw
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
Y#q*E<DT7)Ym5VAk`ne?g$|lYK3!?!e6#xJL

delta 234106
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

diff --git a/ShellBinPkg/UefiShell/X64/Shell.efi b/ShellBinPkg/UefiShell/X64/Shell.efi
index 10a3a5295036d3d33122b26d99403a172bd599b6..18d3afa9ed37457c9339059147b2490b9a2748ba 100644
GIT binary patch
delta 235473
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

delta 234125
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%0D&
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
K-us)C$NVRr*Jd;T


From 10a33f53f4bbbe853061d2d4f6bf524c3364acc5 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Tue, 29 Dec 2015 03:10:32 +0000
Subject: [PATCH 376/525] Revert "CryptoPkg/OpensslLib: upgrade OpenSSL version
 to 1.0.2e"

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19554 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 380 ++++++++++
 .../OpensslLib/EDKII_openssl-1.0.2e.patch     | 707 ------------------
 CryptoPkg/Library/OpensslLib/Install.cmd      |   2 +-
 CryptoPkg/Library/OpensslLib/Install.sh       |   2 +-
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |   2 +-
 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt  |  26 +-
 6 files changed, 396 insertions(+), 723 deletions(-)
 create mode 100644 CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
 delete mode 100644 CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
new file mode 100644
index 000000000000..72e5f3da54c4
--- /dev/null
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -0,0 +1,380 @@
+diff U3 crypto/bio/bio.h crypto/bio/bio.h
+--- crypto/bio/bio.h	Thu Jun 11 21:50:12 2015
++++ crypto/bio/bio.h	Fri Jun 12 11:00:52 2015
+@@ -646,10 +646,10 @@
+ int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix,
+                         asn1_ps_func **psuffix_free);
+ 
+-# ifndef OPENSSL_NO_FP_API
+ BIO_METHOD *BIO_s_file(void);
+ BIO *BIO_new_file(const char *filename, const char *mode);
+ BIO *BIO_new_fp(FILE *stream, int close_flag);
++# ifndef OPENSSL_NO_FP_API
+ #  define BIO_s_file_internal    BIO_s_file
+ # endif
+ BIO *BIO_new(BIO_METHOD *type);
+diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
+--- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
++++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
+@@ -460,6 +460,23 @@
+     return (ret);
+ }
+ 
++# else
++
++BIO_METHOD *BIO_s_file(void)
++{
++    return NULL;
++}
++
++BIO *BIO_new_file(const char *filename, const char *mode)
++{
++    return NULL;
++}
++
++BIO *BIO_new_fp(FILE *stream, int close_flag)
++{
++    return NULL;
++}
++
+ # endif                         /* OPENSSL_NO_STDIO */
+ 
+ #endif                          /* HEADER_BSS_FILE_C */
+diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
+--- crypto/dh/dh_pmeth.c	Thu Jun 11 21:50:12 2015
++++ crypto/dh/dh_pmeth.c	Fri Jun 12 11:08:48 2015
+@@ -449,6 +449,9 @@
+         *keylen = ret;
+         return 1;
+     } else if (dctx->kdf_type == EVP_PKEY_DH_KDF_X9_42) {
++#ifdef OPENSSL_NO_CMS
++        return 0;
++#else
+         unsigned char *Z = NULL;
+         size_t Zlen = 0;
+         if (!dctx->kdf_outlen || !dctx->kdf_oid)
+@@ -478,6 +481,7 @@
+             OPENSSL_free(Z);
+         }
+         return ret;
++#endif
+     }
+     return 1;
+ }
+diff U3 crypto/pem/pem.h crypto/pem/pem.h
+--- crypto/pem/pem.h	Thu Jun 11 21:50:12 2015
++++ crypto/pem/pem.h	Fri Jun 12 10:58:18 2015
+@@ -324,6 +324,7 @@
+ 
+ #  define DECLARE_PEM_read_fp(name, type) /**/
+ #  define DECLARE_PEM_write_fp(name, type) /**/
++#  define DECLARE_PEM_write_fp_const(name, type) /**/
+ #  define DECLARE_PEM_write_cb_fp(name, type) /**/
+ # else
+ 
+diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
+--- crypto/pkcs7/pk7_smime.c	Thu Jun 11 21:01:06 2015
++++ crypto/pkcs7/pk7_smime.c	Fri Jun 12 11:23:38 2015
+@@ -254,7 +254,8 @@
+     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
+     PKCS7_SIGNER_INFO *si;
+     X509_STORE_CTX cert_ctx;
+-    char buf[4096];
++    char *buf = NULL;
++    int bufsiz;
+     int i, j = 0, k, ret = 0;
+     BIO *p7bio;
+     BIO *tmpin, *tmpout;
+@@ -365,9 +366,14 @@
+     } else
+         tmpout = out;
+ 
++    bufsiz = 4096;
++    buf = OPENSSL_malloc(bufsiz);
++    if (buf == NULL) {
++        goto err;
++    }
+     /* We now have to 'read' from p7bio to calculate digests etc. */
+     for (;;) {
+-        i = BIO_read(p7bio, buf, sizeof(buf));
++        i = BIO_read(p7bio, buf, bufsiz);
+         if (i <= 0)
+             break;
+         if (tmpout)
+@@ -406,6 +412,10 @@
+     BIO_free_all(p7bio);
+ 
+     sk_X509_free(signers);
++
++    if (buf != NULL) {
++      OPENSSL_free(buf);
++    }
+ 
+     return ret;
+ }
+diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
+--- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
++++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
+@@ -116,7 +116,7 @@
+ #include <openssl/rand.h>
+ #include "rand_lcl.h"
+ 
+-#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE))
++#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE) || defined(OPENSSL_SYS_UEFI))
+ 
+ # include <sys/types.h>
+ # include <sys/time.h>
+@@ -439,7 +439,7 @@
+                                  * defined(OPENSSL_SYS_VXWORKS) ||
+                                  * defined(OPENSSL_SYS_NETWARE)) */
+ 
+-#if defined(OPENSSL_SYS_VXWORKS)
++#if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI)
+ int RAND_poll(void)
+ {
+     return 0;
+diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
+--- crypto/rsa/rsa_ameth.c	Thu Jun 11 21:50:12 2015
++++ crypto/rsa/rsa_ameth.c	Fri Jun 12 10:45:38 2015
+@@ -68,10 +68,12 @@
+ #endif
+ #include "asn1_locl.h"
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_sign(CMS_SignerInfo *si);
+ static int rsa_cms_verify(CMS_SignerInfo *si);
+ static int rsa_cms_decrypt(CMS_RecipientInfo *ri);
+ static int rsa_cms_encrypt(CMS_RecipientInfo *ri);
++#endif
+ 
+ static int rsa_pub_encode(X509_PUBKEY *pk, const EVP_PKEY *pkey)
+ {
+@@ -665,6 +667,7 @@
+     return rv;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_verify(CMS_SignerInfo *si)
+ {
+     int nid, nid2;
+@@ -683,6 +686,7 @@
+     }
+     return 0;
+ }
++#endif
+ 
+ /*
+  * Customised RSA item verification routine. This is called when a signature
+@@ -705,6 +709,7 @@
+     return -1;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_sign(CMS_SignerInfo *si)
+ {
+     int pad_mode = RSA_PKCS1_PADDING;
+@@ -729,6 +734,7 @@
+     X509_ALGOR_set0(alg, OBJ_nid2obj(NID_rsassaPss), V_ASN1_SEQUENCE, os);
+     return 1;
+ }
++#endif
+ 
+ static int rsa_item_sign(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
+                          X509_ALGOR *alg1, X509_ALGOR *alg2,
+@@ -785,6 +791,7 @@
+     return pss;
+ }
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_decrypt(CMS_RecipientInfo *ri)
+ {
+     EVP_PKEY_CTX *pkctx;
+@@ -857,7 +864,9 @@
+         X509_ALGOR_free(maskHash);
+     return rv;
+ }
++#endif
+ 
++#ifndef OPENSSL_NO_CMS
+ static int rsa_cms_encrypt(CMS_RecipientInfo *ri)
+ {
+     const EVP_MD *md, *mgf1md;
+@@ -920,6 +929,7 @@
+         ASN1_STRING_free(os);
+     return rv;
+ }
++#endif
+ 
+ const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[] = {
+     {
+diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
+--- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
++++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
+@@ -1653,6 +1653,10 @@
+ 
+ static int check_cert_time(X509_STORE_CTX *ctx, X509 *x)
+ {
++#ifdef OPENSSL_SYS_UEFI
++    /* Bypass Certificate Time Checking for UEFI version. */
++    return 1;
++#else
+     time_t *ptime;
+     int i;
+ 
+@@ -1692,6 +1696,7 @@
+     }
+ 
+     return 1;
++#endif
+ }
+ 
+ static int internal_verify(X509_STORE_CTX *ctx)
+diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
+--- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
++++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015
+@@ -127,8 +127,10 @@
+     &v3_idp,
+     &v3_alt[2],
+     &v3_freshest_crl,
++#ifndef OPENSSL_SYS_UEFI
+     &v3_ct_scts[0],
+     &v3_ct_scts[1],
++#endif
+ };
+ 
+ /* Number of standard extensions */
+diff U3 crypto/crypto.h crypto/crypto.h
+--- crypto/crypto.h	Thu Jun 11 21:01:06 2015
++++ crypto/crypto.h	Fri Jun 12 11:33:27 2015
+@@ -235,15 +235,15 @@
+ # ifndef OPENSSL_NO_LOCKING
+ #  ifndef CRYPTO_w_lock
+ #   define CRYPTO_w_lock(type)     \
+-        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,NULL,0)
+ #   define CRYPTO_w_unlock(type)   \
+-        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,NULL,0)
+ #   define CRYPTO_r_lock(type)     \
+-        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,NULL,0)
+ #   define CRYPTO_r_unlock(type)   \
+-        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,__FILE__,__LINE__)
++        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,NULL,0)
+ #   define CRYPTO_add(addr,amount,type)    \
+-        CRYPTO_add_lock(addr,amount,type,__FILE__,__LINE__)
++        CRYPTO_add_lock(addr,amount,type,NULL,0)
+ #  endif
+ # else
+ #  define CRYPTO_w_lock(a)
+@@ -378,19 +378,19 @@
+ # define MemCheck_off()  CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE)
+ # define is_MemCheck_on() CRYPTO_is_mem_check_on()
+ 
+-# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,__FILE__,__LINE__)
+-# define OPENSSL_strdup(str)     CRYPTO_strdup((str),__FILE__,__LINE__)
++# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,NULL,0)
++# define OPENSSL_strdup(str)     CRYPTO_strdup((str),NULL,0)
+ # define OPENSSL_realloc(addr,num) \
+-        CRYPTO_realloc((char *)addr,(int)num,__FILE__,__LINE__)
++        CRYPTO_realloc((char *)addr,(int)num,NULL,0)
+ # define OPENSSL_realloc_clean(addr,old_num,num) \
+-        CRYPTO_realloc_clean(addr,old_num,num,__FILE__,__LINE__)
++        CRYPTO_realloc_clean(addr,old_num,num,NULL,0)
+ # define OPENSSL_remalloc(addr,num) \
+-        CRYPTO_remalloc((char **)addr,(int)num,__FILE__,__LINE__)
++        CRYPTO_remalloc((char **)addr,(int)num,NULL,0)
+ # define OPENSSL_freeFunc        CRYPTO_free
+ # define OPENSSL_free(addr)      CRYPTO_free(addr)
+ 
+ # define OPENSSL_malloc_locked(num) \
+-        CRYPTO_malloc_locked((int)num,__FILE__,__LINE__)
++        CRYPTO_malloc_locked((int)num,NULL,0)
+ # define OPENSSL_free_locked(addr) CRYPTO_free_locked(addr)
+ 
+ const char *SSLeay_version(int type);
+@@ -545,7 +545,7 @@
+ long CRYPTO_get_mem_debug_options(void);
+ 
+ # define CRYPTO_push_info(info) \
+-        CRYPTO_push_info_(info, __FILE__, __LINE__);
++        CRYPTO_push_info_(info, NULL, 0);
+ int CRYPTO_push_info_(const char *info, const char *file, int line);
+ int CRYPTO_pop_info(void);
+ int CRYPTO_remove_all_info(void);
+@@ -588,7 +588,7 @@
+ 
+ /* die if we have to */
+ void OpenSSLDie(const char *file, int line, const char *assertion);
+-# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(__FILE__, __LINE__, #e),1))
++# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(NULL, 0, #e),1))
+ 
+ unsigned long *OPENSSL_ia32cap_loc(void);
+ # define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc()))
+@@ -605,14 +605,14 @@
+ #  define fips_md_init_ctx(alg, cx) \
+         int alg##_Init(cx##_CTX *c) \
+         { \
+-        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
++        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
+                 "Low level API call to digest " #alg " forbidden in FIPS mode!"); \
+         return private_##alg##_Init(c); \
+         } \
+         int private_##alg##_Init(cx##_CTX *c)
+ 
+ #  define fips_cipher_abort(alg) \
+-        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
++        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
+                 "Low level API call to cipher " #alg " forbidden in FIPS mode!")
+ 
+ # else
+diff U3 crypto/opensslconf.h crypto/opensslconf.h
+--- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
++++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
+@@ -159,9 +159,12 @@
+ /* Should we define BN_DIV2W here? */
+ 
+ /* Only one for the following should be defined */
++/* Bypass the following definitions for UEFI version. */
++#if !defined(OPENSSL_SYS_UEFI)
+ #undef SIXTY_FOUR_BIT_LONG
+ #undef SIXTY_FOUR_BIT
+ #define THIRTY_TWO_BIT
++#endif
+ #endif
+ 
+ #if defined(HEADER_RC4_LOCL_H) && !defined(CONFIG_HEADER_RC4_LOCL_H)
+diff U3 crypto/err/err.c crypto/err/err.c
+--- crypto/err/err.c
++++ crypto/err/err.c
+@@ -1072,7 +1072,12 @@ void ERR_set_error_data(char *data, int flags)
+     es->err_data_flags[i] = flags;
+ }
+ 
++/* Add EFIAPI for UEFI version. */
++#if defined(OPENSSL_SYS_UEFI)
++void EFIAPI ERR_add_error_data(int num, ...)
++#else
+ void ERR_add_error_data(int num, ...)
++#endif
+ {
+     va_list args;
+     va_start(args, num);
+diff U3 crypto/err/err.h crypto/err/err.h
+--- crypto/err/err.h
++++ crypto/err/err.h
+@@ -344,7 +344,14 @@ void ERR_print_errors_fp(FILE *fp);
+ # ifndef OPENSSL_NO_BIO
+ void ERR_print_errors(BIO *bp);
+ # endif
++
++/* Add EFIAPI for UEFI version. */
++#if defined(OPENSSL_SYS_UEFI)
++void EFIAPI ERR_add_error_data(int num, ...);
++#else
+ void ERR_add_error_data(int num, ...);
++#endif
++
+ void ERR_add_error_vdata(int num, va_list args);
+ void ERR_load_strings(int lib, ERR_STRING_DATA str[]);
+ void ERR_unload_strings(int lib, ERR_STRING_DATA str[]);
diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
deleted file mode 100644
index e4eaff6eadd2..000000000000
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
+++ /dev/null
@@ -1,707 +0,0 @@
-diff U3 crypto/bio/bio.h crypto/bio/bio.h
---- crypto/bio/bio.h	Thu Jun 11 21:50:12 2015
-+++ crypto/bio/bio.h	Fri Jun 12 11:00:52 2015
-@@ -646,10 +646,10 @@
- int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix,
-                         asn1_ps_func **psuffix_free);
- 
--# ifndef OPENSSL_NO_FP_API
- BIO_METHOD *BIO_s_file(void);
- BIO *BIO_new_file(const char *filename, const char *mode);
- BIO *BIO_new_fp(FILE *stream, int close_flag);
-+# ifndef OPENSSL_NO_FP_API
- #  define BIO_s_file_internal    BIO_s_file
- # endif
- BIO *BIO_new(BIO_METHOD *type);
-diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
---- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
-+++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
-@@ -467,6 +467,23 @@
-     return (ret);
- }
- 
-+# else
-+
-+BIO_METHOD *BIO_s_file(void)
-+{
-+    return NULL;
-+}
-+
-+BIO *BIO_new_file(const char *filename, const char *mode)
-+{
-+    return NULL;
-+}
-+
-+BIO *BIO_new_fp(FILE *stream, int close_flag)
-+{
-+    return NULL;
-+}
-+
- # endif                         /* OPENSSL_NO_STDIO */
- 
- #endif                          /* HEADER_BSS_FILE_C */
-diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
---- crypto/dh/dh_pmeth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/dh/dh_pmeth.c	Fri Jun 12 11:08:48 2015
-@@ -449,6 +449,9 @@
-         *keylen = ret;
-         return 1;
-     } else if (dctx->kdf_type == EVP_PKEY_DH_KDF_X9_42) {
-+#ifdef OPENSSL_NO_CMS
-+        return 0;
-+#else
-         unsigned char *Z = NULL;
-         size_t Zlen = 0;
-         if (!dctx->kdf_outlen || !dctx->kdf_oid)
-@@ -478,6 +481,7 @@
-             OPENSSL_free(Z);
-         }
-         return ret;
-+#endif
-     }
-     return 1;
- }
-diff U3 crypto/pem/pem.h crypto/pem/pem.h
---- crypto/pem/pem.h	Thu Jun 11 21:50:12 2015
-+++ crypto/pem/pem.h	Fri Jun 12 10:58:18 2015
-@@ -324,6 +324,7 @@
- 
- #  define DECLARE_PEM_read_fp(name, type) /**/
- #  define DECLARE_PEM_write_fp(name, type) /**/
-+#  define DECLARE_PEM_write_fp_const(name, type) /**/
- #  define DECLARE_PEM_write_cb_fp(name, type) /**/
- # else
- 
-diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
---- crypto/pkcs7/pk7_smime.c	Thu Jun 11 21:01:06 2015
-+++ crypto/pkcs7/pk7_smime.c	Fri Jun 12 11:23:38 2015
-@@ -254,7 +254,8 @@
-     STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
-     PKCS7_SIGNER_INFO *si;
-     X509_STORE_CTX cert_ctx;
--    char buf[4096];
-+    char *buf = NULL;
-+    int bufsiz;
-     int i, j = 0, k, ret = 0;
-     BIO *p7bio = NULL;
-     BIO *tmpin = NULL, *tmpout = NULL;
-@@ -275,12 +276,6 @@
-         return 0;
-     }
- 
--    /* Check for data and content: two sets of data */
--    if (!PKCS7_get_detached(p7) && indata) {
--        PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_CONTENT_AND_DATA_PRESENT);
--        return 0;
--    }
--
-     sinfos = PKCS7_get_signer_info(p7);
- 
-     if (!sinfos || !sk_PKCS7_SIGNER_INFO_num(sinfos)) {
-@@ -355,9 +350,14 @@
-     } else
-         tmpout = out;
- 
-+    bufsiz = 4096;
-+    buf = OPENSSL_malloc(bufsiz);
-+    if (buf == NULL) {
-+        goto err;
-+    }
-     /* We now have to 'read' from p7bio to calculate digests etc. */
-     for (;;) {
--        i = BIO_read(p7bio, buf, sizeof(buf));
-+        i = BIO_read(p7bio, buf, bufsiz);
-         if (i <= 0)
-             break;
-         if (tmpout)
-@@ -394,6 +394,10 @@
-     }
-     BIO_free_all(p7bio);
-     sk_X509_free(signers);
-+
-+    if (buf != NULL) {
-+      OPENSSL_free(buf);
-+    }
-     return ret;
- }
- 
-diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
---- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
-+++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
-@@ -116,7 +116,7 @@
- #include <openssl/rand.h>
- #include "rand_lcl.h"
- 
--#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE))
-+#if !(defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_VMS) || defined(OPENSSL_SYS_OS2) || defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_NETWARE) || defined(OPENSSL_SYS_UEFI))
- 
- # include <sys/types.h>
- # include <sys/time.h>
-@@ -439,7 +439,7 @@
-                                  * defined(OPENSSL_SYS_VXWORKS) ||
-                                  * defined(OPENSSL_SYS_NETWARE)) */
- 
--#if defined(OPENSSL_SYS_VXWORKS)
-+#if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI)
- int RAND_poll(void)
- {
-     return 0;
-diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
---- crypto/rsa/rsa_ameth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/rsa/rsa_ameth.c	Fri Jun 12 10:45:38 2015
-@@ -68,10 +68,12 @@
- #endif
- #include "asn1_locl.h"
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_sign(CMS_SignerInfo *si);
- static int rsa_cms_verify(CMS_SignerInfo *si);
- static int rsa_cms_decrypt(CMS_RecipientInfo *ri);
- static int rsa_cms_encrypt(CMS_RecipientInfo *ri);
-+#endif
- 
- static int rsa_pub_encode(X509_PUBKEY *pk, const EVP_PKEY *pkey)
- {
-@@ -665,6 +667,7 @@
-     return rv;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_verify(CMS_SignerInfo *si)
- {
-     int nid, nid2;
-@@ -683,6 +686,7 @@
-     }
-     return 0;
- }
-+#endif
- 
- /*
-  * Customised RSA item verification routine. This is called when a signature
-@@ -705,6 +709,7 @@
-     return -1;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_sign(CMS_SignerInfo *si)
- {
-     int pad_mode = RSA_PKCS1_PADDING;
-@@ -729,6 +734,7 @@
-     X509_ALGOR_set0(alg, OBJ_nid2obj(NID_rsassaPss), V_ASN1_SEQUENCE, os);
-     return 1;
- }
-+#endif
- 
- static int rsa_item_sign(EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn,
-                          X509_ALGOR *alg1, X509_ALGOR *alg2,
-@@ -785,6 +791,7 @@
-     return pss;
- }
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_decrypt(CMS_RecipientInfo *ri)
- {
-     EVP_PKEY_CTX *pkctx;
-@@ -857,7 +864,9 @@
-         X509_ALGOR_free(maskHash);
-     return rv;
- }
-+#endif
- 
-+#ifndef OPENSSL_NO_CMS
- static int rsa_cms_encrypt(CMS_RecipientInfo *ri)
- {
-     const EVP_MD *md, *mgf1md;
-@@ -920,6 +929,7 @@
-         ASN1_STRING_free(os);
-     return rv;
- }
-+#endif
- 
- const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[] = {
-     {
-diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
---- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
-+++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
-@@ -940,6 +940,8 @@
-         ctx->current_crl = crl;
-     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
-         ptime = &ctx->param->check_time;
-+    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
-+        return 1;
-     else
-         ptime = NULL;
- 
-@@ -1663,6 +1665,8 @@
- 
-     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
-         ptime = &ctx->param->check_time;
-+    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
-+        return 1;
-     else
-         ptime = NULL;
- 
-diff U3 crypto/x509/x509_vfy.h crypto/x509/x509_vfy.h
---- crypto/x509/x509_vfy.h	Thu Jul 09 19:57:16 2015
-+++ crypto/x509/x509_vfy.h	Thu Oct 29 14:05:57 2015
-@@ -438,6 +438,8 @@
-  * will force the behaviour to match that of previous versions.
-  */
- # define X509_V_FLAG_NO_ALT_CHAINS               0x100000
-+/* Do not check certificate/CRL validity against current time */
-+# define X509_V_FLAG_NO_CHECK_TIME               0x200000
- 
- # define X509_VP_FLAG_DEFAULT                    0x1
- # define X509_VP_FLAG_OVERWRITE                  0x2
-diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
---- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
-+++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015
-@@ -127,8 +127,10 @@
-     &v3_idp,
-     &v3_alt[2],
-     &v3_freshest_crl,
-+#ifndef OPENSSL_SYS_UEFI
-     &v3_ct_scts[0],
-     &v3_ct_scts[1],
-+#endif
- };
- 
- /* Number of standard extensions */
-diff U3 crypto/crypto.h crypto/crypto.h
---- crypto/crypto.h	Thu Jun 11 21:01:06 2015
-+++ crypto/crypto.h	Fri Jun 12 11:33:27 2015
-@@ -235,15 +235,15 @@
- # ifndef OPENSSL_NO_LOCKING
- #  ifndef CRYPTO_w_lock
- #   define CRYPTO_w_lock(type)     \
--        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,NULL,0)
- #   define CRYPTO_w_unlock(type)   \
--        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,NULL,0)
- #   define CRYPTO_r_lock(type)     \
--        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,NULL,0)
- #   define CRYPTO_r_unlock(type)   \
--        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,__FILE__,__LINE__)
-+        CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,NULL,0)
- #   define CRYPTO_add(addr,amount,type)    \
--        CRYPTO_add_lock(addr,amount,type,__FILE__,__LINE__)
-+        CRYPTO_add_lock(addr,amount,type,NULL,0)
- #  endif
- # else
- #  define CRYPTO_w_lock(a)
-@@ -378,19 +378,19 @@
- # define MemCheck_off()  CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE)
- # define is_MemCheck_on() CRYPTO_is_mem_check_on()
- 
--# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,__FILE__,__LINE__)
--# define OPENSSL_strdup(str)     CRYPTO_strdup((str),__FILE__,__LINE__)
-+# define OPENSSL_malloc(num)     CRYPTO_malloc((int)num,NULL,0)
-+# define OPENSSL_strdup(str)     CRYPTO_strdup((str),NULL,0)
- # define OPENSSL_realloc(addr,num) \
--        CRYPTO_realloc((char *)addr,(int)num,__FILE__,__LINE__)
-+        CRYPTO_realloc((char *)addr,(int)num,NULL,0)
- # define OPENSSL_realloc_clean(addr,old_num,num) \
--        CRYPTO_realloc_clean(addr,old_num,num,__FILE__,__LINE__)
-+        CRYPTO_realloc_clean(addr,old_num,num,NULL,0)
- # define OPENSSL_remalloc(addr,num) \
--        CRYPTO_remalloc((char **)addr,(int)num,__FILE__,__LINE__)
-+        CRYPTO_remalloc((char **)addr,(int)num,NULL,0)
- # define OPENSSL_freeFunc        CRYPTO_free
- # define OPENSSL_free(addr)      CRYPTO_free(addr)
- 
- # define OPENSSL_malloc_locked(num) \
--        CRYPTO_malloc_locked((int)num,__FILE__,__LINE__)
-+        CRYPTO_malloc_locked((int)num,NULL,0)
- # define OPENSSL_free_locked(addr) CRYPTO_free_locked(addr)
- 
- const char *SSLeay_version(int type);
-@@ -545,7 +545,7 @@
- long CRYPTO_get_mem_debug_options(void);
- 
- # define CRYPTO_push_info(info) \
--        CRYPTO_push_info_(info, __FILE__, __LINE__);
-+        CRYPTO_push_info_(info, NULL, 0);
- int CRYPTO_push_info_(const char *info, const char *file, int line);
- int CRYPTO_pop_info(void);
- int CRYPTO_remove_all_info(void);
-@@ -588,7 +588,7 @@
- 
- /* die if we have to */
- void OpenSSLDie(const char *file, int line, const char *assertion);
--# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(__FILE__, __LINE__, #e),1))
-+# define OPENSSL_assert(e)       (void)((e) ? 0 : (OpenSSLDie(NULL, 0, #e),1))
- 
- unsigned long *OPENSSL_ia32cap_loc(void);
- # define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc()))
-@@ -605,14 +605,14 @@
- #  define fips_md_init_ctx(alg, cx) \
-         int alg##_Init(cx##_CTX *c) \
-         { \
--        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
-+        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
-                 "Low level API call to digest " #alg " forbidden in FIPS mode!"); \
-         return private_##alg##_Init(c); \
-         } \
-         int private_##alg##_Init(cx##_CTX *c)
- 
- #  define fips_cipher_abort(alg) \
--        if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \
-+        if (FIPS_mode()) OpenSSLDie(NULL, 0, \
-                 "Low level API call to cipher " #alg " forbidden in FIPS mode!")
- 
- # else
-diff U3 crypto/opensslconf.h crypto/opensslconf.h
---- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
-+++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
-@@ -5,15 +5,72 @@
- extern "C" {
- #endif
- /* OpenSSL was configured with the following options: */
-+#ifndef OPENSSL_SYSNAME_UEFI
-+# define OPENSSL_SYSNAME_UEFI
-+#endif
- #ifndef OPENSSL_DOING_MAKEDEPEND
- 
- 
-+#ifndef OPENSSL_NO_BF
-+# define OPENSSL_NO_BF
-+#endif
-+#ifndef OPENSSL_NO_CAMELLIA
-+# define OPENSSL_NO_CAMELLIA
-+#endif
-+#ifndef OPENSSL_NO_CAPIENG
-+# define OPENSSL_NO_CAPIENG
-+#endif
-+#ifndef OPENSSL_NO_CAST
-+# define OPENSSL_NO_CAST
-+#endif
-+#ifndef OPENSSL_NO_CMS
-+# define OPENSSL_NO_CMS
-+#endif
-+#ifndef OPENSSL_NO_DEPRECATED
-+# define OPENSSL_NO_DEPRECATED
-+#endif
-+#ifndef OPENSSL_NO_DGRAM
-+# define OPENSSL_NO_DGRAM
-+#endif
-+#ifndef OPENSSL_NO_DSA
-+# define OPENSSL_NO_DSA
-+#endif
-+#ifndef OPENSSL_NO_DYNAMIC_ENGINE
-+# define OPENSSL_NO_DYNAMIC_ENGINE
-+#endif
-+#ifndef OPENSSL_NO_EC
-+# define OPENSSL_NO_EC
-+#endif
- #ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
- # define OPENSSL_NO_EC_NISTP_64_GCC_128
- #endif
-+#ifndef OPENSSL_NO_ECDH
-+# define OPENSSL_NO_ECDH
-+#endif
-+#ifndef OPENSSL_NO_ECDSA
-+# define OPENSSL_NO_ECDSA
-+#endif
-+#ifndef OPENSSL_NO_ENGINE
-+# define OPENSSL_NO_ENGINE
-+#endif
-+#ifndef OPENSSL_NO_ENGINES
-+# define OPENSSL_NO_ENGINES
-+#endif
-+#ifndef OPENSSL_NO_FILENAMES
-+# define OPENSSL_NO_FILENAMES
-+#endif
-+#ifndef OPENSSL_NO_FP_API
-+# define OPENSSL_NO_FP_API
-+#endif
- #ifndef OPENSSL_NO_GMP
- # define OPENSSL_NO_GMP
- #endif
-+#ifndef OPENSSL_NO_GOST
-+# define OPENSSL_NO_GOST
-+#endif
-+#ifndef OPENSSL_NO_IDEA
-+# define OPENSSL_NO_IDEA
-+#endif
- #ifndef OPENSSL_NO_JPAKE
- # define OPENSSL_NO_JPAKE
- #endif
-@@ -23,30 +80,90 @@
- #ifndef OPENSSL_NO_LIBUNBOUND
- # define OPENSSL_NO_LIBUNBOUND
- #endif
-+#ifndef OPENSSL_NO_LOCKING
-+# define OPENSSL_NO_LOCKING
-+#endif
- #ifndef OPENSSL_NO_MD2
- # define OPENSSL_NO_MD2
- #endif
-+#ifndef OPENSSL_NO_MDC2
-+# define OPENSSL_NO_MDC2
-+#endif
-+#ifndef OPENSSL_NO_POSIX_IO
-+# define OPENSSL_NO_POSIX_IO
-+#endif
-+#ifndef OPENSSL_NO_RC2
-+# define OPENSSL_NO_RC2
-+#endif
- #ifndef OPENSSL_NO_RC5
- # define OPENSSL_NO_RC5
- #endif
-+#ifndef OPENSSL_NO_RCS
-+# define OPENSSL_NO_RCS
-+#endif
- #ifndef OPENSSL_NO_RFC3779
- # define OPENSSL_NO_RFC3779
- #endif
-+#ifndef OPENSSL_NO_RIPEMD
-+# define OPENSSL_NO_RIPEMD
-+#endif
-+#ifndef OPENSSL_NO_SCRYPT
-+# define OPENSSL_NO_SCRYPT
-+#endif
-+#ifndef OPENSSL_NO_SCT
-+# define OPENSSL_NO_SCT
-+#endif
- #ifndef OPENSSL_NO_SCTP
- # define OPENSSL_NO_SCTP
- #endif
-+#ifndef OPENSSL_NO_SEED
-+# define OPENSSL_NO_SEED
-+#endif
-+#ifndef OPENSSL_NO_SHA0
-+# define OPENSSL_NO_SHA0
-+#endif
-+#ifndef OPENSSL_NO_SOCK
-+# define OPENSSL_NO_SOCK
-+#endif
-+#ifndef OPENSSL_NO_SRP
-+# define OPENSSL_NO_SRP
-+#endif
- #ifndef OPENSSL_NO_SSL_TRACE
- # define OPENSSL_NO_SSL_TRACE
- #endif
-+#ifndef OPENSSL_NO_SSL2
-+# define OPENSSL_NO_SSL2
-+#endif
-+#ifndef OPENSSL_NO_SSL3
-+# define OPENSSL_NO_SSL3
-+#endif
-+#ifndef OPENSSL_NO_STDIO
-+# define OPENSSL_NO_STDIO
-+#endif
- #ifndef OPENSSL_NO_STORE
- # define OPENSSL_NO_STORE
- #endif
-+#ifndef OPENSSL_NO_UI
-+# define OPENSSL_NO_UI
-+#endif
- #ifndef OPENSSL_NO_UNIT_TEST
- # define OPENSSL_NO_UNIT_TEST
- #endif
-+#ifndef OPENSSL_NO_WHIRLPOOL
-+# define OPENSSL_NO_WHIRLPOOL
-+#endif
- 
- #endif /* OPENSSL_DOING_MAKEDEPEND */
- 
-+#ifndef OPENSSL_NO_ASM
-+# define OPENSSL_NO_ASM
-+#endif
-+#ifndef OPENSSL_NO_ERR
-+# define OPENSSL_NO_ERR
-+#endif
-+#ifndef OPENSSL_NO_HW
-+# define OPENSSL_NO_HW
-+#endif
- #ifndef OPENSSL_NO_DYNAMIC_ENGINE
- # define OPENSSL_NO_DYNAMIC_ENGINE
- #endif
-@@ -56,12 +173,66 @@
-    who haven't had the time to do the appropriate changes in their
-    applications.  */
- #ifdef OPENSSL_ALGORITHM_DEFINES
-+# if defined(OPENSSL_NO_BF) && !defined(NO_BF)
-+#  define NO_BF
-+# endif
-+# if defined(OPENSSL_NO_CAMELLIA) && !defined(NO_CAMELLIA)
-+#  define NO_CAMELLIA
-+# endif
-+# if defined(OPENSSL_NO_CAPIENG) && !defined(NO_CAPIENG)
-+#  define NO_CAPIENG
-+# endif
-+# if defined(OPENSSL_NO_CAST) && !defined(NO_CAST)
-+#  define NO_CAST
-+# endif
-+# if defined(OPENSSL_NO_CMS) && !defined(NO_CMS)
-+#  define NO_CMS
-+# endif
-+# if defined(OPENSSL_NO_DEPRECATED) && !defined(NO_DEPRECATED)
-+#  define NO_DEPRECATED
-+# endif
-+# if defined(OPENSSL_NO_DGRAM) && !defined(NO_DGRAM)
-+#  define NO_DGRAM
-+# endif
-+# if defined(OPENSSL_NO_DSA) && !defined(NO_DSA)
-+#  define NO_DSA
-+# endif
-+# if defined(OPENSSL_NO_DYNAMIC_ENGINE) && !defined(NO_DYNAMIC_ENGINE)
-+#  define NO_DYNAMIC_ENGINE
-+# endif
-+# if defined(OPENSSL_NO_EC) && !defined(NO_EC)
-+#  define NO_EC
-+# endif
- # if defined(OPENSSL_NO_EC_NISTP_64_GCC_128) && !defined(NO_EC_NISTP_64_GCC_128)
- #  define NO_EC_NISTP_64_GCC_128
- # endif
-+# if defined(OPENSSL_NO_ECDH) && !defined(NO_ECDH)
-+#  define NO_ECDH
-+# endif
-+# if defined(OPENSSL_NO_ECDSA) && !defined(NO_ECDSA)
-+#  define NO_ECDSA
-+# endif
-+# if defined(OPENSSL_NO_ENGINE) && !defined(NO_ENGINE)
-+#  define NO_ENGINE
-+# endif
-+# if defined(OPENSSL_NO_ENGINES) && !defined(NO_ENGINES)
-+#  define NO_ENGINES
-+# endif
-+# if defined(OPENSSL_NO_FILENAMES) && !defined(NO_FILENAMES)
-+#  define NO_FILENAMES
-+# endif
-+# if defined(OPENSSL_NO_FP_API) && !defined(NO_FP_API)
-+#  define NO_FP_API
-+# endif
- # if defined(OPENSSL_NO_GMP) && !defined(NO_GMP)
- #  define NO_GMP
- # endif
-+# if defined(OPENSSL_NO_GOST) && !defined(NO_GOST)
-+#  define NO_GOST
-+# endif
-+# if defined(OPENSSL_NO_IDEA) && !defined(NO_IDEA)
-+#  define NO_IDEA
-+# endif
- # if defined(OPENSSL_NO_JPAKE) && !defined(NO_JPAKE)
- #  define NO_JPAKE
- # endif
-@@ -71,27 +242,78 @@
- # if defined(OPENSSL_NO_LIBUNBOUND) && !defined(NO_LIBUNBOUND)
- #  define NO_LIBUNBOUND
- # endif
-+# if defined(OPENSSL_NO_LOCKING) && !defined(NO_LOCKING)
-+#  define NO_LOCKING
-+# endif
- # if defined(OPENSSL_NO_MD2) && !defined(NO_MD2)
- #  define NO_MD2
- # endif
-+# if defined(OPENSSL_NO_MDC2) && !defined(NO_MDC2)
-+#  define NO_MDC2
-+# endif
-+# if defined(OPENSSL_NO_POSIX_IO) && !defined(NO_POSIX_IO)
-+#  define NO_POSIX_IO
-+# endif
-+# if defined(OPENSSL_NO_RC2) && !defined(NO_RC2)
-+#  define NO_RC2
-+# endif
- # if defined(OPENSSL_NO_RC5) && !defined(NO_RC5)
- #  define NO_RC5
- # endif
-+# if defined(OPENSSL_NO_RCS) && !defined(NO_RCS)
-+#  define NO_RCS
-+# endif
- # if defined(OPENSSL_NO_RFC3779) && !defined(NO_RFC3779)
- #  define NO_RFC3779
- # endif
-+# if defined(OPENSSL_NO_RIPEMD) && !defined(NO_RIPEMD)
-+#  define NO_RIPEMD
-+# endif
-+# if defined(OPENSSL_NO_SCRYPT) && !defined(NO_SCRYPT)
-+#  define NO_SCRYPT
-+# endif
-+# if defined(OPENSSL_NO_SCT) && !defined(NO_SCT)
-+#  define NO_SCT
-+# endif
- # if defined(OPENSSL_NO_SCTP) && !defined(NO_SCTP)
- #  define NO_SCTP
- # endif
-+# if defined(OPENSSL_NO_SEED) && !defined(NO_SEED)
-+#  define NO_SEED
-+# endif
-+# if defined(OPENSSL_NO_SHA0) && !defined(NO_SHA0)
-+#  define NO_SHA0
-+# endif
-+# if defined(OPENSSL_NO_SOCK) && !defined(NO_SOCK)
-+#  define NO_SOCK
-+# endif
-+# if defined(OPENSSL_NO_SRP) && !defined(NO_SRP)
-+#  define NO_SRP
-+# endif
- # if defined(OPENSSL_NO_SSL_TRACE) && !defined(NO_SSL_TRACE)
- #  define NO_SSL_TRACE
- # endif
-+# if defined(OPENSSL_NO_SSL2) && !defined(NO_SSL2)
-+#  define NO_SSL2
-+# endif
-+# if defined(OPENSSL_NO_SSL3) && !defined(NO_SSL3)
-+#  define NO_SSL3
-+# endif
-+# if defined(OPENSSL_NO_STDIO) && !defined(NO_STDIO)
-+#  define NO_STDIO
-+# endif
- # if defined(OPENSSL_NO_STORE) && !defined(NO_STORE)
- #  define NO_STORE
- # endif
-+# if defined(OPENSSL_NO_UI) && !defined(NO_UI)
-+#  define NO_UI
-+# endif
- # if defined(OPENSSL_NO_UNIT_TEST) && !defined(NO_UNIT_TEST)
- #  define NO_UNIT_TEST
- # endif
-+# if defined(OPENSSL_NO_WHIRLPOOL) && !defined(NO_WHIRLPOOL)
-+#  define NO_WHIRLPOOL
-+# endif
- #endif
- 
- /* crypto/opensslconf.h.in */
-@@ -152,7 +374,7 @@
- #endif
- #endif
- 
--#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H)
-+#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H) && !defined(OPENSSL_SYSNAME_UEFI)
- #define CONFIG_HEADER_BN_H
- #undef BN_LLONG
- 
-diff U3 e_os.h e_os.h
---- e_os.h	Thu Jul 09 19:57:16 2015
-+++ e_os.h	Thu Oct 29 16:54:10 2015
-@@ -136,7 +136,7 @@
- #  define MSDOS
- # endif
- 
--# if defined(MSDOS) && !defined(GETPID_IS_MEANINGLESS)
-+# if (defined(MSDOS) || defined(OPENSSL_SYS_UEFI)) && !defined(GETPID_IS_MEANINGLESS)
- #  define GETPID_IS_MEANINGLESS
- # endif
- 
-diff U3 e_os2.h e_os2.h
---- e_os2.h	Thu Jul 09 19:57:16 2015
-+++ e_os2.h	Thu Oct 29 15:08:19 2015
-@@ -97,7 +97,14 @@
-  * For 32 bit environment, there seems to be the CygWin environment and then
-  * all the others that try to do the same thing Microsoft does...
-  */
--# if defined(OPENSSL_SYSNAME_UWIN)
-+/*
-+ * UEFI lives here because it might be built with a Microsoft toolchain and
-+ * we need to avoid the false positive match on Windows.
-+ */
-+# if defined(OPENSSL_SYSNAME_UEFI)
-+#  undef OPENSSL_SYS_UNIX
-+#  define OPENSSL_SYS_UEFI
-+# elif defined(OPENSSL_SYSNAME_UWIN)
- #  undef OPENSSL_SYS_UNIX
- #  define OPENSSL_SYS_WIN32_UWIN
- # else
diff --git a/CryptoPkg/Library/OpensslLib/Install.cmd b/CryptoPkg/Library/OpensslLib/Install.cmd
index b9b6fc6f7094..ef0a4bdcebc9 100755
--- a/CryptoPkg/Library/OpensslLib/Install.cmd
+++ b/CryptoPkg/Library/OpensslLib/Install.cmd
@@ -1,4 +1,4 @@
-cd openssl-1.0.2e
+cd openssl-1.0.2d
 copy e_os2.h                    ..\..\..\Include\openssl
 copy crypto\crypto.h            ..\..\..\Include\openssl
 copy crypto\opensslv.h          ..\..\..\Include\openssl
diff --git a/CryptoPkg/Library/OpensslLib/Install.sh b/CryptoPkg/Library/OpensslLib/Install.sh
index 543439529448..877e775b81af 100755
--- a/CryptoPkg/Library/OpensslLib/Install.sh
+++ b/CryptoPkg/Library/OpensslLib/Install.sh
@@ -1,6 +1,6 @@
 #!/bin/sh
 
-cd openssl-1.0.2e
+cd openssl-1.0.2d
 cp e_os2.h                    ../../../Include/openssl
 cp crypto/crypto.h            ../../../Include/openssl
 cp crypto/opensslv.h          ../../../Include/openssl
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 1b7eb07fab90..aaf0a2982e10 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -20,7 +20,7 @@
   MODULE_TYPE                    = BASE
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
-  DEFINE OPENSSL_PATH            = openssl-1.0.2e
+  DEFINE OPENSSL_PATH            = openssl-1.0.2d
   DEFINE OPENSSL_FLAGS           = -DOPENSSL_SYSNAME_UWIN -DOPENSSL_SYS_UEFI -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DGETPID_IS_MEANINGLESS -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
   DEFINE OPENSSL_EXFLAGS         = -DOPENSSL_SMALL_FOOTPRINT -DOPENSSL_NO_SHA0 -DOPENSSL_NO_LHASH -DOPENSSL_NO_HW -DOPENSSL_NO_OCSP -DOPENSSL_NO_LOCKING -DOPENSSL_NO_DEPRECATED -DOPENSSL_NO_RIPEMD -DOPENSSL_NO_RC2 -DOPENSSL_NO_IDEA -DOPENSSL_NO_BF -DOPENSSL_NO_CAST -DOPENSSL_NO_WHIRLPOOL -DOPENSSL_NO_DSA -DOPENSSL_NO_EC -DOPENSSL_NO_ECDH -DOPENSSL_NO_ECDSA -DOPENSSL_NO_SRP -DOPENSSL_NO_ENGINE
 
diff --git a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
index f575d7147bdf..59e74ee9b0d9 100644
--- a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
+++ b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
@@ -17,36 +17,36 @@ cryptography. This patch will enable openssl building under UEFI environment.
 ================================================================================
                                 OpenSSL-Version
 ================================================================================
-  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2e.
-    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
+  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2d.
+    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
 
 
 ================================================================================
                       HOW to Install Openssl for UEFI Building
 ================================================================================
-1.  Download OpenSSL 1.0.2e from official website:
-    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
+1.  Download OpenSSL 1.0.2d from official website:
+    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
 
-    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2e.tar.tar.
-          When you do the download, rename the "openssl-1.0.2e.tar.tar" to
-          "openssl-1.0.2e.tar.gz" or rename the local downloaded file with ".tar.tar"
+    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2d.tar.tar.
+          When you do the download, rename the "openssl-1.0.2d.tar.tar" to
+          "openssl-1.0.2d.tar.gz" or rename the local downloaded file with ".tar.tar"
           extension to ".tar.gz".
 
-2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2e
+2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2d
 
     NOTE: If you use WinZip to unpack the openssl source in Windows, please
           uncheck the WinZip smart CR/LF conversion option (WINZIP: Options -->
           Configuration --> Miscellaneous --> "TAR file smart CR/LF conversion").
 
-3.  Apply this patch: EDKII_openssl-1.0.2e.patch, and make installation
+3.  Apply this patch: EDKII_openssl-1.0.2d.patch, and make installation
 
     For Windows Environment:
     ------------------------
     1) Make sure the patch utility has been installed in your machine.
        Install Cygwin or get the patch utility binary from
           http://gnuwin32.sourceforge.net/packages/patch.htm
-    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2e
-    3) patch -p0 -i ..\EDKII_openssl-1.0.2e.patch
+    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2d
+    3) patch -p0 -i ..\EDKII_openssl-1.0.2d.patch
     4) cd ..
     5) Install.cmd
 
@@ -54,8 +54,8 @@ cryptography. This patch will enable openssl building under UEFI environment.
     -----------------------
     1) Make sure the patch utility has been installed in your machine.
        Patch utility is available from http://directory.fsf.org/project/patch/
-    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2e
-    3) patch -p0 -i ../EDKII_openssl-1.0.2e.patch
+    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2d
+    3) patch -p0 -i ../EDKII_openssl-1.0.2d.patch
     4) cd ..
     5) ./Install.sh
 

From 2bf9eb4e3d6ae641e3806868d31aae31f0db6f08 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:11:08 +0000
Subject: [PATCH 377/525] CryptoPkg/BaseCryptLib: Add missing OpenSSL includes

OpenSSL 1.1 has cleaned up its include files a little, and it will now
be necessary to directly include things like <openssl/bn.h> if we want
to use them, rather than assuming they are included indirectly from
other headers.

(Sync patch r18698 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19555 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Pk/CryptDh.c       | 3 ++-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaBasic.c | 3 ++-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaExt.c   | 3 ++-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c     | 2 +-
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptDh.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptDh.c
index 942b3d103e26..9cbf182c70f5 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptDh.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptDh.c
@@ -1,7 +1,7 @@
 /** @file
   Diffie-Hellman Wrapper Implementation over OpenSSL.
 
-Copyright (c) 2010 - 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -13,6 +13,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 **/
 
 #include "InternalCryptLib.h"
+#include <openssl/bn.h>
 #include <openssl/dh.h>
 
 
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaBasic.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaBasic.c
index 3e4309899c94..e49db51e7284 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaBasic.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaBasic.c
@@ -7,7 +7,7 @@
   3) RsaSetKey
   4) RsaPkcs1Verify
 
-Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -20,6 +20,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "InternalCryptLib.h"
 
+#include <openssl/bn.h>
 #include <openssl/rsa.h>
 #include <openssl/objects.h>
 
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaExt.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaExt.c
index b890704a2ee8..b941d6fac602 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaExt.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptRsaExt.c
@@ -7,7 +7,7 @@
   3) RsaCheckKey
   4) RsaPkcs1Sign
 
-Copyright (c) 2009 - 2013, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -20,6 +20,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "InternalCryptLib.h"
 
+#include <openssl/bn.h>
 #include <openssl/rsa.h>
 #include <openssl/err.h>
 #include <openssl/objects.h>
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
index 70b135a754e9..fba356f8e758 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
@@ -14,7 +14,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "InternalCryptLib.h"
 #include <openssl/x509.h>
-
+#include <openssl/rsa.h>
 
 /**
   Construct a X509 object from DER-encoded certificate data.

From f59acbe142b1363aeb02b36df2de67942a868b39 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:11:37 +0000
Subject: [PATCH 378/525] CryptoPkg/BaseCryptLib: Use i2d_X509_NAME() instead
 of abusing X509_NAME

In OpenSSL 1.1, the X509_NAME becomes an opaque structure and we will no
longer get away with accessing its members directly. Use i2d_X509_NAME()
instead.

(Sync patch r18699 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19556 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
index fba356f8e758..5d6be6fce9e5 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
@@ -245,6 +245,7 @@ X509GetSubjectName (
   BOOLEAN    Status;
   X509       *X509Cert;
   X509_NAME  *X509Name;
+  UINTN      X509NameSize;
 
   //
   // Check input parameters.
@@ -274,13 +275,14 @@ X509GetSubjectName (
     goto _Exit;
   }
 
-  if (*SubjectSize < (UINTN) X509Name->bytes->length) {
-    *SubjectSize = (UINTN) X509Name->bytes->length;
+  X509NameSize = i2d_X509_NAME(X509Name, NULL);
+  if (*SubjectSize < X509NameSize) {
+    *SubjectSize = X509NameSize;
     goto _Exit;
   }
-  *SubjectSize = (UINTN) X509Name->bytes->length;
+  *SubjectSize = X509NameSize;
   if (CertSubject != NULL) {
-    CopyMem (CertSubject, (UINT8 *) X509Name->bytes->data, *SubjectSize);
+    i2d_X509_NAME(X509Name, &CertSubject);
     Status = TRUE;
   }
 

From 5f297eae34598d1be5c3ca1383502f8733dc051e Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:12:05 +0000
Subject: [PATCH 379/525] CryptoPkg/BaseCryptLib: Use accessor functions for
 X509_ATTRIBUTE

In OpenSSL 1.1, the X509_ATTRIBUTE becomes an opaque structure and we will
no longer get away with accessing its members directly. Use the accessor
functions X509_ATTRIBUTE_get0_object0() and X509_ATTRIBUTE_get0_type()
instead.

Also be slightly more defensive about unlikely failure modes.

(Sync patch r18700 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19557 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
index 7d269b04588f..f01bbb243b05 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
@@ -613,6 +613,7 @@ ImageTimestampVerify (
   UINTN                        Index;
   STACK_OF(X509_ATTRIBUTE)     *Sk;
   X509_ATTRIBUTE               *Xa;
+  ASN1_OBJECT                  *XaObj;
   ASN1_TYPE                    *Asn1Type;
   ASN1_OCTET_STRING            *EncDigest;
   UINT8                        *TSToken;
@@ -692,11 +693,18 @@ ImageTimestampVerify (
     // Search valid RFC3161 timestamp counterSignature based on OBJID.
     //
     Xa = sk_X509_ATTRIBUTE_value (Sk, (int)Index);
-    if ((Xa->object->length != sizeof (mSpcRFC3161OidValue)) ||
-        (CompareMem (Xa->object->data, mSpcRFC3161OidValue, sizeof (mSpcRFC3161OidValue)) != 0)) {
+    if (Xa == NULL) {
       continue;
     }
-    Asn1Type = sk_ASN1_TYPE_value (Xa->value.set, 0);
+    XaObj = X509_ATTRIBUTE_get0_object(Xa);
+    if (XaObj == NULL) {
+      continue;
+    }
+    if ((XaObj->length != sizeof (mSpcRFC3161OidValue)) ||
+        (CompareMem (XaObj->data, mSpcRFC3161OidValue, sizeof (mSpcRFC3161OidValue)) != 0)) {
+      continue;
+    }
+    Asn1Type = X509_ATTRIBUTE_get0_type(Xa, 0);
   }
 
   if (Asn1Type == NULL) {

From 5d2f923e1665842f3fdf1f3d4dbfb2596c0ca4a0 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:12:37 +0000
Subject: [PATCH 380/525] CryptoPkg/BaseCryptLib: Use accessor functions for
 ASN1_OBJECT

OpenSSL 1.1 introduces new OBJ_get0_data() and OBJ_length() accessor
functions and makes ASN1_OBJECT an opaque type.

Unlike the accessors in previous commits which *did* actually exist
already but just weren't mandatory, these don't exist in older versions
of OpenSSL. So introduce macros which do the right thing, for
compatibility.

(Sync patch r18701 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19558 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h | 9 ++++++++-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c       | 4 ++--
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h b/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
index 35a8eb1cbcb8..0ce2591bb41d 100644
--- a/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
+++ b/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
@@ -1,7 +1,7 @@
 /** @file  
   Internal include file for BaseCryptLib.
 
-Copyright (c) 2010 - 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -23,6 +23,13 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "OpenSslSupport.h"
 
+#include <openssl/opensslv.h>
+
+#if OPENSSL_VERSION_NUMBER < 0x10100000L
+#define OBJ_get0_data(o) ((o)->data)
+#define OBJ_length(o) ((o)->length)
+#endif
+
 //
 // Environment Setting for OpenSSL-based UEFI Crypto Library.
 //
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
index f01bbb243b05..efb40b823421 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
@@ -700,8 +700,8 @@ ImageTimestampVerify (
     if (XaObj == NULL) {
       continue;
     }
-    if ((XaObj->length != sizeof (mSpcRFC3161OidValue)) ||
-        (CompareMem (XaObj->data, mSpcRFC3161OidValue, sizeof (mSpcRFC3161OidValue)) != 0)) {
+    if ((OBJ_length(XaObj) != sizeof (mSpcRFC3161OidValue)) ||
+        (CompareMem (OBJ_get0_data(XaObj), mSpcRFC3161OidValue, sizeof (mSpcRFC3161OidValue)) != 0)) {
       continue;
     }
     Asn1Type = X509_ATTRIBUTE_get0_type(Xa, 0);

From e2ca08e86a9d598ff2e4be36c2982a186b6fa997 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:13:10 +0000
Subject: [PATCH 381/525] CryptoPkg/BaseCryptLib: Clean up checking of PKCS#7
 contents type

Use the new OBJ_get0_data() accessor to compare the data, and actually
check the length of the object too.

(Sync patch r18702 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19559 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticode.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticode.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticode.c
index 9e933558e65b..857281d75f94 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticode.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticode.c
@@ -77,7 +77,7 @@ AuthenticodeVerify (
   UINT8        *SpcIndirectDataContent;
   UINT8        Asn1Byte;
   UINTN        ContentSize;
-  UINT8        *SpcIndirectDataOid;
+  CONST UINT8  *SpcIndirectDataOid;
 
   //
   // Check input parameters.
@@ -115,8 +115,9 @@ AuthenticodeVerify (
   //       some authenticode-specific structure. Use opaque ASN.1 string to retrieve
   //       PKCS#7 ContentInfo here.
   //
-  SpcIndirectDataOid = (UINT8 *)(Pkcs7->d.sign->contents->type->data);
-  if (CompareMem (
+  SpcIndirectDataOid = OBJ_get0_data(Pkcs7->d.sign->contents->type);
+  if (OBJ_length(Pkcs7->d.sign->contents->type) != sizeof(mSpcIndirectOidValue) ||
+      CompareMem (
         SpcIndirectDataOid,
         mSpcIndirectOidValue,
         sizeof (mSpcIndirectOidValue)

From 595dd756ad6401871356da0e39fda74fb8259647 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:13:44 +0000
Subject: [PATCH 382/525] CryptoPkg/BaseCryptLib: Use X509_V_FLAG_PARTIAL_CHAIN

Since OpenSSL 1.0.2 we can set this flag on the X509_STORE to instruct
OpenSSL to accept non-self-signed certificates as trusted. So we don't
need two entirely identical copies of a verify_cb() function which makes
it ignore the resulting errors.

We also *didn't* use that verify_cb() function for X509VerifyCert(), but
probably should have done. So that can get X509_V_FLAG_PARTIAL_CHAIN for
consistency, too.

(Sync patch r18703 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19560 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BaseCryptLib/Pk/CryptPkcs7Verify.c        | 93 ++-----------------
 CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c   | 87 +----------------
 CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c |  6 ++
 3 files changed, 15 insertions(+), 171 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
index d49fbb7afded..8d0d9f1ff990 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
@@ -30,87 +30,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 UINT8 mOidValue[9] = { 0x2A, 0x86, 0x48, 0x86, 0xF7, 0x0D, 0x01, 0x07, 0x02 };
 
-/**
-  Verification callback function to override any existing callbacks in OpenSSL
-  for intermediate certificate supports.
-
-  @param[in]  Status   Original status before calling this callback.
-  @param[in]  Context  X509 store context.
-
-  @retval     1        Current X509 certificate is verified successfully.
-  @retval     0        Verification failed.
-
-**/
-int
-X509VerifyCb (
-  IN int            Status,
-  IN X509_STORE_CTX *Context
-  )
-{
-  X509_OBJECT  *Obj;
-  INTN         Error;
-  INTN         Index;
-  INTN         Count;
-
-  Obj   = NULL;
-  Error = (INTN) X509_STORE_CTX_get_error (Context);
-
-  //
-  // X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT and X509_V_ERR_UNABLE_TO_GET_ISSUER_
-  // CERT_LOCALLY mean a X509 certificate is not self signed and its issuer
-  // can not be found in X509_verify_cert of X509_vfy.c.
-  // In order to support intermediate certificate node, we override the
-  // errors if the certification is obtained from X509 store, i.e. it is
-  // a trusted ceritifcate node that is enrolled by user.
-  // Besides,X509_V_ERR_CERT_UNTRUSTED and X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE
-  // are also ignored to enable such feature.
-  //
-  if ((Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT) ||
-      (Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY)) {
-    Obj = (X509_OBJECT *) malloc (sizeof (X509_OBJECT));
-    if (Obj == NULL) {
-      return 0;
-    }
-
-    Obj->type      = X509_LU_X509;
-    Obj->data.x509 = Context->current_cert;
-
-    CRYPTO_w_lock (CRYPTO_LOCK_X509_STORE);
-
-    if (X509_OBJECT_retrieve_match (Context->ctx->objs, Obj)) {
-      Status = 1;
-    } else {
-      //
-      // If any certificate in the chain is enrolled as trusted certificate,
-      // pass the certificate verification.
-      //
-      if (Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY) {
-        Count = (INTN) sk_X509_num (Context->chain);
-        for (Index = 0; Index < Count; Index++) {
-          Obj->data.x509 = sk_X509_value (Context->chain, (int) Index);
-          if (X509_OBJECT_retrieve_match (Context->ctx->objs, Obj)) {
-            Status = 1;
-            break;
-          }
-        }
-      }
-    }
-
-    CRYPTO_w_unlock (CRYPTO_LOCK_X509_STORE);
-  }
-
-  if ((Error == X509_V_ERR_CERT_UNTRUSTED) ||
-      (Error == X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE)) {
-    Status = 1;
-  }
-
-  if (Obj != NULL) {
-    OPENSSL_free (Obj);
-  }
-
-  return Status;
-}
-
 /**
   Check input P7Data is a wrapped ContentInfo structure or not. If not construct
   a new structure to wrap P7Data.
@@ -923,12 +842,6 @@ Pkcs7Verify (
     goto _Exit;
   }
 
-  //
-  // Register customized X509 verification callback function to support
-  // trusted intermediate certificate anchor.
-  //
-  CertStore->verify_cb = X509VerifyCb;
-
   //
   // For generic PKCS#7 handling, InData may be NULL if the content is present
   // in PKCS#7 structure. So ignore NULL checking here.
@@ -942,6 +855,12 @@ Pkcs7Verify (
     goto _Exit;
   }
 
+  //
+  // Allow partial certificate chains, terminated by a non-self-signed but
+  // still trusted intermediate certificate.
+  //
+  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
+
   //
   // OpenSSL PKCS7 Verification by default checks for SMIME (email signing) and
   // doesn't support the extended key usage for Authenticode Code Signing.
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
index efb40b823421..449a08db2c63 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
@@ -136,87 +136,6 @@ ASN1_SEQUENCE (TS_TST_INFO) = {
 IMPLEMENT_ASN1_FUNCTIONS (TS_TST_INFO)
 
 
-/**
-  Verification callback function to override any existing callbacks in OpenSSL
-  for intermediate TSA certificate supports.
-
-  @param[in]  Status   Original status before calling this callback.
-  @param[in]  Context  X509 store context.
-
-  @retval     1        Current X509 certificate is verified successfully.
-  @retval     0        Verification failed.
-
-**/
-int
-TSVerifyCallback (
-  IN int             Status,
-  IN X509_STORE_CTX  *Context
-  )
-{
-  X509_OBJECT  *Obj;
-  INTN         Error;
-  INTN         Index;
-  INTN         Count;
-
-  Obj   = NULL;
-  Error = (INTN) X509_STORE_CTX_get_error (Context);
-
-  //
-  // X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT and X509_V_ERR_UNABLE_TO_GET_ISSUER_
-  // CERT_LOCALLY mean a X509 certificate is not self signed and its issuer
-  // can not be found in X509_verify_cert of X509_vfy.c.
-  // In order to support intermediate certificate node, we override the
-  // errors if the certification is obtained from X509 store, i.e. it is
-  // a trusted ceritifcate node that is enrolled by user.
-  // Besides,X509_V_ERR_CERT_UNTRUSTED and X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE
-  // are also ignored to enable such feature.
-  //
-  if ((Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT) ||
-      (Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY)) {
-    Obj = (X509_OBJECT *) malloc (sizeof (X509_OBJECT));
-    if (Obj == NULL) {
-      return 0;
-    }
-
-    Obj->type      = X509_LU_X509;
-    Obj->data.x509 = Context->current_cert;
-
-    CRYPTO_w_lock (CRYPTO_LOCK_X509_STORE);
-
-    if (X509_OBJECT_retrieve_match (Context->ctx->objs, Obj)) {
-      Status = 1;
-    } else {
-      //
-      // If any certificate in the chain is enrolled as trusted certificate,
-      // pass the certificate verification.
-      //
-      if (Error == X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY) {
-        Count = (INTN) sk_X509_num (Context->chain);
-        for (Index = 0; Index < Count; Index++) {
-          Obj->data.x509 = sk_X509_value (Context->chain, (int) Index);
-          if (X509_OBJECT_retrieve_match (Context->ctx->objs, Obj)) {
-            Status = 1;
-            break;
-          }
-        }
-      }
-    }
-
-    CRYPTO_w_unlock (CRYPTO_LOCK_X509_STORE);
-  }
-
-  if ((Error == X509_V_ERR_CERT_UNTRUSTED) ||
-      (Error == X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE)) {
-    Status = 1;
-  }
-
-  if (Obj != NULL) {
-    OPENSSL_free (Obj);
-  }
-
-  return Status;
-}
-
 /**
   Convert ASN.1 GeneralizedTime to EFI Time.
 
@@ -506,10 +425,10 @@ TimestampTokenVerify (
   }
 
   //
-  // Register customized X509 verification callback function to support
-  // trusted intermediate TSA certificate anchor.
+  // Allow partial certificate chains, terminated by a non-self-signed but
+  // still trusted intermediate certificate.
   //
-  CertStore->verify_cb = TSVerifyCallback;
+  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
 
   X509_STORE_set_purpose (CertStore, X509_PURPOSE_ANY);
 
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
index 5d6be6fce9e5..669a7af3db03 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
@@ -463,6 +463,12 @@ X509VerifyCert (
     goto _Exit;
   }
 
+  //
+  // Allow partial certificate chains, terminated by a non-self-signed but
+  // still trusted intermediate certificate.
+  //
+  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
+
   //
   // Set up X509_STORE_CTX for the subsequent verification operation.
   //

From 5891158d251263b68c4f63d8233fd5f59f19103b Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:14:24 +0000
Subject: [PATCH 383/525] CryptoPkg/BaseCryptLib: Use X509_V_FLAG_NO_CHECK_TIME

OpenSSL HEAD is in the process of adding this flag to disable the validity
time checking. Backport it to 1.0.2 and use it too, for consistency.

https://rt.openssl.org/Ticket/Display.html?id=3951&user=guest&pass=guest

(Sync patch r18704 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19561 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../BaseCryptLib/Pk/CryptPkcs7Verify.c        |  5 +-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c   |  5 +-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c |  5 +-
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 49 ++++++++++++-------
 4 files changed, 39 insertions(+), 25 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
index 8d0d9f1ff990..6a84137632b7 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
@@ -857,9 +857,10 @@ Pkcs7Verify (
 
   //
   // Allow partial certificate chains, terminated by a non-self-signed but
-  // still trusted intermediate certificate.
+  // still trusted intermediate certificate. Also disable time checks.
   //
-  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
+  X509_STORE_set_flags (CertStore,
+                        X509_V_FLAG_PARTIAL_CHAIN | X509_V_FLAG_NO_CHECK_TIME);
 
   //
   // OpenSSL PKCS7 Verification by default checks for SMIME (email signing) and
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
index 449a08db2c63..d49581221c4a 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptTs.c
@@ -426,9 +426,10 @@ TimestampTokenVerify (
 
   //
   // Allow partial certificate chains, terminated by a non-self-signed but
-  // still trusted intermediate certificate.
+  // still trusted intermediate certificate. Also disable time checks.
   //
-  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
+  X509_STORE_set_flags (CertStore,
+                        X509_V_FLAG_PARTIAL_CHAIN | X509_V_FLAG_NO_CHECK_TIME);
 
   X509_STORE_set_purpose (CertStore, X509_PURPOSE_ANY);
 
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
index 669a7af3db03..7dc459675965 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptX509.c
@@ -465,9 +465,10 @@ X509VerifyCert (
 
   //
   // Allow partial certificate chains, terminated by a non-self-signed but
-  // still trusted intermediate certificate.
+  // still trusted intermediate certificate. Also disable time checks.
   //
-  X509_STORE_set_flags (CertStore, X509_V_FLAG_PARTIAL_CHAIN);
+  X509_STORE_set_flags (CertStore,
+                        X509_V_FLAG_PARTIAL_CHAIN | X509_V_FLAG_NO_CHECK_TIME);
 
   //
   // Set up X509_STORE_CTX for the subsequent verification operation.
diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
index 72e5f3da54c4..220d44ef3b91 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -210,25 +210,36 @@ diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
 diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
 --- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
 +++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
-@@ -1653,6 +1653,10 @@
- 
- static int check_cert_time(X509_STORE_CTX *ctx, X509 *x)
- {
-+#ifdef OPENSSL_SYS_UEFI
-+    /* Bypass Certificate Time Checking for UEFI version. */
-+    return 1;
-+#else
-     time_t *ptime;
-     int i;
- 
-@@ -1692,6 +1696,7 @@
-     }
- 
-     return 1;
-+#endif
- }
- 
- static int internal_verify(X509_STORE_CTX *ctx)
+@@ -935,6 +935,8 @@
+         ctx->current_crl = crl;
+     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
+         ptime = &ctx->param->check_time;
++    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
++        return 1;
+     else
+         ptime = NULL;
+ 
+@@ -1658,6 +1660,8 @@
+ 
+     if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
+         ptime = &ctx->param->check_time;
++    else if (ctx->param->flags & X509_V_FLAG_NO_CHECK_TIME)
++        return 1;
+     else
+         ptime = NULL;
+ 
+diff U3 crypto/x509/x509_vfy.h crypto/x509/x509_vfy.h
+--- crypto/x509/x509_vfy.h	Thu Jul 09 19:57:16 2015
++++ crypto/x509/x509_vfy.h	Thu Oct 29 14:05:57 2015
+@@ -438,6 +438,8 @@
+  * will force the behaviour to match that of previous versions.
+  */
+ # define X509_V_FLAG_NO_ALT_CHAINS               0x100000
++/* Do not check certificate/CRL validity against current time */
++# define X509_V_FLAG_NO_CHECK_TIME               0x200000
+ 
+ # define X509_VP_FLAG_DEFAULT                    0x1
+ # define X509_VP_FLAG_OVERWRITE                  0x2
 diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
 --- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
 +++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015

From b3a7a7a6ca563380dcbf2e6247e6b66dd2876c5d Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:14:53 +0000
Subject: [PATCH 384/525] CryptoPkg/OpensslLib: Undefine NO_BUILTIN_VA_FUNCS to
 fix varargs breakage
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Instead of patching OpenSSL to add EFIAPI to the one varargs function we
actually *noticed* breakage in, let's fix the problem in a more coherent
way by undefining NO_BUILTIN_VA_FUNCS.

That way, the VA_START and similar macros will actually do the right
thing for non-EFIAPI functions, which is to use the GCC builtins.

It's still fairly broken elsewhere in the tree, with the VA_START macro
being used from both EFIAPI and non-EFIAPI functions — and being broken
in the latter case. We probably ought to make EFIAPI a no-op everywhere
and add -mabi=ms to the GCC builds. But that's a project for another day.
For now, just fix the OpenSSL build in a cleaner fashion.

(Sync patch r18705 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19562 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 34 -------------------
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |  2 +-
 2 files changed, 1 insertion(+), 35 deletions(-)

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
index 220d44ef3b91..497233947d68 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -355,37 +355,3 @@ diff U3 crypto/opensslconf.h crypto/opensslconf.h
  #endif
  
  #if defined(HEADER_RC4_LOCL_H) && !defined(CONFIG_HEADER_RC4_LOCL_H)
-diff U3 crypto/err/err.c crypto/err/err.c
---- crypto/err/err.c
-+++ crypto/err/err.c
-@@ -1072,7 +1072,12 @@ void ERR_set_error_data(char *data, int flags)
-     es->err_data_flags[i] = flags;
- }
- 
-+/* Add EFIAPI for UEFI version. */
-+#if defined(OPENSSL_SYS_UEFI)
-+void EFIAPI ERR_add_error_data(int num, ...)
-+#else
- void ERR_add_error_data(int num, ...)
-+#endif
- {
-     va_list args;
-     va_start(args, num);
-diff U3 crypto/err/err.h crypto/err/err.h
---- crypto/err/err.h
-+++ crypto/err/err.h
-@@ -344,7 +344,14 @@ void ERR_print_errors_fp(FILE *fp);
- # ifndef OPENSSL_NO_BIO
- void ERR_print_errors(BIO *bp);
- # endif
-+
-+/* Add EFIAPI for UEFI version. */
-+#if defined(OPENSSL_SYS_UEFI)
-+void EFIAPI ERR_add_error_data(int num, ...);
-+#else
- void ERR_add_error_data(int num, ...);
-+#endif
-+
- void ERR_add_error_vdata(int num, va_list args);
- void ERR_load_strings(int lib, ERR_STRING_DATA str[]);
- void ERR_unload_strings(int lib, ERR_STRING_DATA str[]);
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index aaf0a2982e10..51ad52c502b8 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -902,7 +902,7 @@
   INTEL:*_*_IPF_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w -DSIXTY_FOUR_BIT
 
   GCC:*_*_IA32_CC_FLAGS     = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DTHIRTY_TWO_BIT
-  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG
+  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG -UNO_BUILTIN_VA_FUNCS
   GCC:*_*_IPF_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG
   GCC:*_*_ARM_CC_FLAGS      = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DTHIRTY_TWO_BIT
   GCC:*_*_AARCH64_CC_FLAGS  = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG

From 34885c5af41df1a9f33b77e7af090347c9819199 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:15:37 +0000
Subject: [PATCH 385/525] CryptoPkg: Fix OpenSSL BN wordsize and
 OPENSSL_SYS_UEFI handling

We were manually setting -DSIXTY_FOUR_BIT_LONG or -DTHIRTY_TWO_BIT on
the compiler command line when building OpensslLib itself, but not when
building BaseCryptLib.

But when building BaseCryptLib, we weren't setting OPENSSL_SYS_UEFI
*either*. This meant that *that* build was picking up the definition
from <openssl/opensslconf.h>, and was thus *different* to the version
the library was built with, in some cases.

So set OPENSSL_SYS_UEFI consistently in OpensslSupport.h and *also*
define either SIXTY_FOUR_BIT or THIRTY_TWO_BIT there too.

(Sync patch r18706 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19563 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Include/OpenSslSupport.h            | 25 +++++++++++
 .../Library/BaseCryptLib/InternalCryptLib.h   |  7 ---
 .../InternalCryptLib.h                        | 10 +----
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 45 ++++++++++++++-----
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   | 31 +++++++------
 5 files changed, 76 insertions(+), 42 deletions(-)

diff --git a/CryptoPkg/Include/OpenSslSupport.h b/CryptoPkg/Include/OpenSslSupport.h
index dc89097041dd..239ae8bd6f41 100644
--- a/CryptoPkg/Include/OpenSslSupport.h
+++ b/CryptoPkg/Include/OpenSslSupport.h
@@ -23,6 +23,31 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #define MAX_STRING_SIZE  0x1000
 
+//
+// OpenSSL relies on explicit configuration for word size in crypto/bn,
+// but we want it to be automatically inferred from the target. So we
+// bypass what's in <openssl/opensslconf.h> for OPENSSL_SYS_UEFI, and
+// define our own here.
+//
+#ifdef CONFIG_HEADER_BN_H
+#error CONFIG_HEADER_BN_H already defined
+#endif
+
+#define CONFIG_HEADER_BN_H
+
+#if defined(MDE_CPU_X64) || defined(MDE_CPU_AARCH64) || defined(MDE_CPU_IA64)
+//
+// With GCC we would normally use SIXTY_FOUR_BIT_LONG, but MSVC needs
+// SIXTY_FOUR_BIT, because 'long' is 32-bit and only 'long long' is
+// 64-bit. Since using 'long long' works fine on GCC too, just do that.
+//
+#define SIXTY_FOUR_BIT
+#elif defined(MDE_CPU_IA32) || defined(MDE_CPU_ARM) || defined(MDE_CPU_EBC)
+#define THIRTY_TWO_BIT
+#else
+#error Unknown target architecture
+#endif
+
 //
 // File operations are not required for building Open SSL, 
 // so FILE is mapped to VOID * to pass build
diff --git a/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h b/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
index 0ce2591bb41d..92cc96303869 100644
--- a/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
+++ b/CryptoPkg/Library/BaseCryptLib/InternalCryptLib.h
@@ -30,12 +30,5 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define OBJ_length(o) ((o)->length)
 #endif
 
-//
-// Environment Setting for OpenSSL-based UEFI Crypto Library.
-//
-#ifndef OPENSSL_SYSNAME_UWIN
-#define OPENSSL_SYSNAME_UWIN
-#endif
-
 #endif
 
diff --git a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/InternalCryptLib.h b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/InternalCryptLib.h
index 959ad0a0f542..24c767ced65a 100644
--- a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/InternalCryptLib.h
+++ b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/InternalCryptLib.h
@@ -1,7 +1,7 @@
 /** @file  
   Internal include file for BaseCryptLibRuntimeCryptProtocol.
 
-Copyright (c) 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -19,13 +19,5 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/DebugLib.h>
 #include <Library/BaseCryptLib.h>
 
-//
-// Environment Setting for OpenSSL-based UEFI Crypto Library.
-//
-#ifndef OPENSSL_SYSNAME_UWIN
-#define OPENSSL_SYSNAME_UWIN
-#endif
-
-
 #endif
 
diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
index 497233947d68..fb16e877ecd6 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -342,16 +342,41 @@ diff U3 crypto/crypto.h crypto/crypto.h
 diff U3 crypto/opensslconf.h crypto/opensslconf.h
 --- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
 +++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
-@@ -159,9 +159,12 @@
- /* Should we define BN_DIV2W here? */
- 
- /* Only one for the following should be defined */
-+/* Bypass the following definitions for UEFI version. */
-+#if !defined(OPENSSL_SYS_UEFI)
- #undef SIXTY_FOUR_BIT_LONG
- #undef SIXTY_FOUR_BIT
- #define THIRTY_TWO_BIT
+@@ -5,6 +5,9 @@
+ extern "C" {
+ #endif
+ /* OpenSSL was configured with the following options: */
++#ifndef OPENSSL_SYSNAME_UEFI
++# define OPENSSL_SYSNAME_UEFI
 +#endif
+ #ifndef OPENSSL_DOING_MAKEDEPEND
+ 
+ 
+@@ -152,7 +155,7 @@
+ #endif
  #endif
  
- #if defined(HEADER_RC4_LOCL_H) && !defined(CONFIG_HEADER_RC4_LOCL_H)
+-#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H)
++#if defined(HEADER_BN_H) && !defined(CONFIG_HEADER_BN_H) && !defined(OPENSSL_SYSNAME_UEFI)
+ #define CONFIG_HEADER_BN_H
+ #undef BN_LLONG
+ 
+diff U3 e_os2.h e_os2.h
+--- e_os2.h	Thu Jul 09 19:57:16 2015
++++ e_os2.h	Thu Oct 29 15:08:19 2015
+@@ -97,7 +97,14 @@
+  * For 32 bit environment, there seems to be the CygWin environment and then
+  * all the others that try to do the same thing Microsoft does...
+  */
+-# if defined(OPENSSL_SYSNAME_UWIN)
++/*
++ * UEFI lives here because it might be built with a Microsoft toolchain and
++ * we need to avoid the false positive match on Windows.
++ */
++# if defined(OPENSSL_SYSNAME_UEFI)
++#  undef OPENSSL_SYS_UNIX
++#  define OPENSSL_SYS_UEFI
++# elif defined(OPENSSL_SYSNAME_UWIN)
+ #  undef OPENSSL_SYS_UNIX
+ #  define OPENSSL_SYS_WIN32_UWIN
+ # else
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 51ad52c502b8..0be9ee6ec981 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -21,14 +21,13 @@
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
   DEFINE OPENSSL_PATH            = openssl-1.0.2d
-  DEFINE OPENSSL_FLAGS           = -DOPENSSL_SYSNAME_UWIN -DOPENSSL_SYS_UEFI -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DGETPID_IS_MEANINGLESS -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
+  DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DGETPID_IS_MEANINGLESS -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
   DEFINE OPENSSL_EXFLAGS         = -DOPENSSL_SMALL_FOOTPRINT -DOPENSSL_NO_SHA0 -DOPENSSL_NO_LHASH -DOPENSSL_NO_HW -DOPENSSL_NO_OCSP -DOPENSSL_NO_LOCKING -DOPENSSL_NO_DEPRECATED -DOPENSSL_NO_RIPEMD -DOPENSSL_NO_RC2 -DOPENSSL_NO_IDEA -DOPENSSL_NO_BF -DOPENSSL_NO_CAST -DOPENSSL_NO_WHIRLPOOL -DOPENSSL_NO_DSA -DOPENSSL_NO_EC -DOPENSSL_NO_ECDH -DOPENSSL_NO_ECDSA -DOPENSSL_NO_SRP -DOPENSSL_NO_ENGINE
 
 #
 # OPENSSL_FLAGS is set to define the following flags to be compatible with
 # EDK II build system and UEFI executiuon environment
 #
-#   OPENSSL_SYSNAME_UWIN
 #   OPENSSL_SYS_UEFI
 #   L_ENDIAN
 #   _CRT_SECURE_NO_DEPRECATE
@@ -893,19 +892,19 @@
   # C4702: Potentially uninitialized local variable name used
   # C4311: pointer truncation from 'type' to 'type'
   #
-  MSFT:*_*_IA32_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DTHIRTY_TWO_BIT /wd4244 /wd4701 /wd4702 /wd4706
-  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DSIXTY_FOUR_BIT /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706 /wd4311
-  MSFT:*_*_IPF_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -DSIXTY_FOUR_BIT /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
+  MSFT:*_*_IA32_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4244 /wd4701 /wd4702 /wd4706
+  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706 /wd4311
+  MSFT:*_*_IPF_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
 
-  INTEL:*_*_IA32_CC_FLAGS   = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w -DTHIRTY_TWO_BIT
-  INTEL:*_*_X64_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w -DSIXTY_FOUR_BIT
-  INTEL:*_*_IPF_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w -DSIXTY_FOUR_BIT
+  INTEL:*_*_IA32_CC_FLAGS   = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
+  INTEL:*_*_X64_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
+  INTEL:*_*_IPF_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
 
-  GCC:*_*_IA32_CC_FLAGS     = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DTHIRTY_TWO_BIT
-  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG -UNO_BUILTIN_VA_FUNCS
-  GCC:*_*_IPF_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG
-  GCC:*_*_ARM_CC_FLAGS      = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DTHIRTY_TWO_BIT
-  GCC:*_*_AARCH64_CC_FLAGS  = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG
+  GCC:*_*_IA32_CC_FLAGS     = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -UNO_BUILTIN_VA_FUNCS
+  GCC:*_*_IPF_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  GCC:*_*_ARM_CC_FLAGS      = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  GCC:*_*_AARCH64_CC_FLAGS  = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
 
   # suppress the following warnings in openssl so we don't break the build with warnings-as-errors:
   # 1295: Deprecated declaration <entity> - give arg types
@@ -919,6 +918,6 @@
   #  513: a value of type <type> cannot be assigned to an entity of type <type>
   #  188: enumerated type mixed with another type (i.e. passing an integer as an enum without a cast)
   # 1296: Extended constant initialiser used
-  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) --library_interface=aeabi_clib99 --fpu=vfpv3 -DTHIRTY_TWO_BIT --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
-  XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DTHIRTY_TWO_BIT
-  XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -DSIXTY_FOUR_BIT_LONG
+  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) --library_interface=aeabi_clib99 --fpu=vfpv3 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
+  XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w

From b72472105b6f9976a1d84de7191eb9da8891ddd8 Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:16:05 +0000
Subject: [PATCH 386/525] CryptoPkg/OpensslLib: Eliminate GETPID_IS_MEANINGLESS
 definition

OpenSSL ought to work this out for itself when OPENSSL_SYS_UEFI is set.

(Sync patch r18707 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19564 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../Library/OpensslLib/EDKII_openssl-1.0.2d.patch    | 12 ++++++++++++
 CryptoPkg/Library/OpensslLib/OpensslLib.inf          |  3 +--
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
index fb16e877ecd6..4e1fd5b68861 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -361,6 +361,18 @@ diff U3 crypto/opensslconf.h crypto/opensslconf.h
  #define CONFIG_HEADER_BN_H
  #undef BN_LLONG
  
+diff U3 e_os.h e_os.h
+--- e_os.h	Thu Jul 09 19:57:16 2015
++++ e_os.h	Thu Oct 29 16:54:10 2015
+@@ -136,7 +136,7 @@
+ #  define MSDOS
+ # endif
+ 
+-# if defined(MSDOS) && !defined(GETPID_IS_MEANINGLESS)
++# if (defined(MSDOS) || defined(OPENSSL_SYS_UEFI)) && !defined(GETPID_IS_MEANINGLESS)
+ #  define GETPID_IS_MEANINGLESS
+ # endif
+ 
 diff U3 e_os2.h e_os2.h
 --- e_os2.h	Thu Jul 09 19:57:16 2015
 +++ e_os2.h	Thu Oct 29 15:08:19 2015
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 0be9ee6ec981..72d8949db451 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -21,7 +21,7 @@
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
   DEFINE OPENSSL_PATH            = openssl-1.0.2d
-  DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DGETPID_IS_MEANINGLESS -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
+  DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
   DEFINE OPENSSL_EXFLAGS         = -DOPENSSL_SMALL_FOOTPRINT -DOPENSSL_NO_SHA0 -DOPENSSL_NO_LHASH -DOPENSSL_NO_HW -DOPENSSL_NO_OCSP -DOPENSSL_NO_LOCKING -DOPENSSL_NO_DEPRECATED -DOPENSSL_NO_RIPEMD -DOPENSSL_NO_RC2 -DOPENSSL_NO_IDEA -DOPENSSL_NO_BF -DOPENSSL_NO_CAST -DOPENSSL_NO_WHIRLPOOL -DOPENSSL_NO_DSA -DOPENSSL_NO_EC -DOPENSSL_NO_ECDH -DOPENSSL_NO_ECDSA -DOPENSSL_NO_SRP -DOPENSSL_NO_ENGINE
 
 #
@@ -43,7 +43,6 @@
 #   OPENSSL_NO_ERR
 #   OPENSSL_NO_KRB5
 #   OPENSSL_NO_DYNAMIC_ENGINE
-#   GETPID_IS_MEANINGLESS
 #   OPENSSL_NO_STDIO
 #   OPENSSL_NO_POSIX_IO
 #   OPENSSL_NO_FP_API

From 6db2b5b42f92143a78fe40f646b3217ccd8bd3dc Mon Sep 17 00:00:00 2001
From: David Woodhouse <David.Woodhouse@intel.com>
Date: Tue, 29 Dec 2015 03:16:33 +0000
Subject: [PATCH 387/525] CryptoPkg/OpensslLib: Move OPENSSL_NO_xxx defines
 into opensslconf.h

Putting these on the command line as we do at the moment means that they
are *only* visible when actually building the OpenSSL code itself. When
building other things like BaseCryptLib, they were missing. Which could
lead to discrepancies in structures defined by the header files, between
the OpenSSL code and the EDK II code which calls it.

Move the definitions into opensslconf.h where they would normally live
in a standard build of OpenSSL.

Note: Do *not* set OPENSSL_NO_LHASH or OPENSSL_NO_OCSP since those weren't
effectively disabled before; the directories was still being included in
the build. If we actually disable then, the build breaks. We can hopefully
fix at least OCSP upstream later, but one thing at a time...

(Sync patch r18708 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: David Woodhouse <David.Woodhouse@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19565 6f19259b-4bc3-4df7-8a09-765794883524
---
 .../OpensslLib/EDKII_openssl-1.0.2d.patch     | 304 +++++++++++++++++-
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |  57 +---
 2 files changed, 317 insertions(+), 44 deletions(-)

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
index 4e1fd5b68861..6be397b8b959 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
@@ -342,7 +342,7 @@ diff U3 crypto/crypto.h crypto/crypto.h
 diff U3 crypto/opensslconf.h crypto/opensslconf.h
 --- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
 +++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
-@@ -5,6 +5,9 @@
+@@ -5,15 +5,72 @@
  extern "C" {
  #endif
  /* OpenSSL was configured with the following options: */
@@ -352,7 +352,307 @@ diff U3 crypto/opensslconf.h crypto/opensslconf.h
  #ifndef OPENSSL_DOING_MAKEDEPEND
  
  
-@@ -152,7 +155,7 @@
++#ifndef OPENSSL_NO_BF
++# define OPENSSL_NO_BF
++#endif
++#ifndef OPENSSL_NO_CAMELLIA
++# define OPENSSL_NO_CAMELLIA
++#endif
++#ifndef OPENSSL_NO_CAPIENG
++# define OPENSSL_NO_CAPIENG
++#endif
++#ifndef OPENSSL_NO_CAST
++# define OPENSSL_NO_CAST
++#endif
++#ifndef OPENSSL_NO_CMS
++# define OPENSSL_NO_CMS
++#endif
++#ifndef OPENSSL_NO_DEPRECATED
++# define OPENSSL_NO_DEPRECATED
++#endif
++#ifndef OPENSSL_NO_DGRAM
++# define OPENSSL_NO_DGRAM
++#endif
++#ifndef OPENSSL_NO_DSA
++# define OPENSSL_NO_DSA
++#endif
++#ifndef OPENSSL_NO_DYNAMIC_ENGINE
++# define OPENSSL_NO_DYNAMIC_ENGINE
++#endif
++#ifndef OPENSSL_NO_EC
++# define OPENSSL_NO_EC
++#endif
+ #ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
+ # define OPENSSL_NO_EC_NISTP_64_GCC_128
+ #endif
++#ifndef OPENSSL_NO_ECDH
++# define OPENSSL_NO_ECDH
++#endif
++#ifndef OPENSSL_NO_ECDSA
++# define OPENSSL_NO_ECDSA
++#endif
++#ifndef OPENSSL_NO_ENGINE
++# define OPENSSL_NO_ENGINE
++#endif
++#ifndef OPENSSL_NO_ENGINES
++# define OPENSSL_NO_ENGINES
++#endif
++#ifndef OPENSSL_NO_FILENAMES
++# define OPENSSL_NO_FILENAMES
++#endif
++#ifndef OPENSSL_NO_FP_API
++# define OPENSSL_NO_FP_API
++#endif
+ #ifndef OPENSSL_NO_GMP
+ # define OPENSSL_NO_GMP
+ #endif
++#ifndef OPENSSL_NO_GOST
++# define OPENSSL_NO_GOST
++#endif
++#ifndef OPENSSL_NO_IDEA
++# define OPENSSL_NO_IDEA
++#endif
+ #ifndef OPENSSL_NO_JPAKE
+ # define OPENSSL_NO_JPAKE
+ #endif
+@@ -23,30 +80,90 @@
+ #ifndef OPENSSL_NO_LIBUNBOUND
+ # define OPENSSL_NO_LIBUNBOUND
+ #endif
++#ifndef OPENSSL_NO_LOCKING
++# define OPENSSL_NO_LOCKING
++#endif
+ #ifndef OPENSSL_NO_MD2
+ # define OPENSSL_NO_MD2
+ #endif
++#ifndef OPENSSL_NO_MDC2
++# define OPENSSL_NO_MDC2
++#endif
++#ifndef OPENSSL_NO_POSIX_IO
++# define OPENSSL_NO_POSIX_IO
++#endif
++#ifndef OPENSSL_NO_RC2
++# define OPENSSL_NO_RC2
++#endif
+ #ifndef OPENSSL_NO_RC5
+ # define OPENSSL_NO_RC5
+ #endif
++#ifndef OPENSSL_NO_RCS
++# define OPENSSL_NO_RCS
++#endif
+ #ifndef OPENSSL_NO_RFC3779
+ # define OPENSSL_NO_RFC3779
+ #endif
++#ifndef OPENSSL_NO_RIPEMD
++# define OPENSSL_NO_RIPEMD
++#endif
++#ifndef OPENSSL_NO_SCRYPT
++# define OPENSSL_NO_SCRYPT
++#endif
++#ifndef OPENSSL_NO_SCT
++# define OPENSSL_NO_SCT
++#endif
+ #ifndef OPENSSL_NO_SCTP
+ # define OPENSSL_NO_SCTP
+ #endif
++#ifndef OPENSSL_NO_SEED
++# define OPENSSL_NO_SEED
++#endif
++#ifndef OPENSSL_NO_SHA0
++# define OPENSSL_NO_SHA0
++#endif
++#ifndef OPENSSL_NO_SOCK
++# define OPENSSL_NO_SOCK
++#endif
++#ifndef OPENSSL_NO_SRP
++# define OPENSSL_NO_SRP
++#endif
+ #ifndef OPENSSL_NO_SSL_TRACE
+ # define OPENSSL_NO_SSL_TRACE
+ #endif
++#ifndef OPENSSL_NO_SSL2
++# define OPENSSL_NO_SSL2
++#endif
++#ifndef OPENSSL_NO_SSL3
++# define OPENSSL_NO_SSL3
++#endif
++#ifndef OPENSSL_NO_STDIO
++# define OPENSSL_NO_STDIO
++#endif
+ #ifndef OPENSSL_NO_STORE
+ # define OPENSSL_NO_STORE
+ #endif
++#ifndef OPENSSL_NO_UI
++# define OPENSSL_NO_UI
++#endif
+ #ifndef OPENSSL_NO_UNIT_TEST
+ # define OPENSSL_NO_UNIT_TEST
+ #endif
++#ifndef OPENSSL_NO_WHIRLPOOL
++# define OPENSSL_NO_WHIRLPOOL
++#endif
+ 
+ #endif /* OPENSSL_DOING_MAKEDEPEND */
+ 
++#ifndef OPENSSL_NO_ASM
++# define OPENSSL_NO_ASM
++#endif
++#ifndef OPENSSL_NO_ERR
++# define OPENSSL_NO_ERR
++#endif
++#ifndef OPENSSL_NO_HW
++# define OPENSSL_NO_HW
++#endif
+ #ifndef OPENSSL_NO_DYNAMIC_ENGINE
+ # define OPENSSL_NO_DYNAMIC_ENGINE
+ #endif
+@@ -56,12 +173,66 @@
+    who haven't had the time to do the appropriate changes in their
+    applications.  */
+ #ifdef OPENSSL_ALGORITHM_DEFINES
++# if defined(OPENSSL_NO_BF) && !defined(NO_BF)
++#  define NO_BF
++# endif
++# if defined(OPENSSL_NO_CAMELLIA) && !defined(NO_CAMELLIA)
++#  define NO_CAMELLIA
++# endif
++# if defined(OPENSSL_NO_CAPIENG) && !defined(NO_CAPIENG)
++#  define NO_CAPIENG
++# endif
++# if defined(OPENSSL_NO_CAST) && !defined(NO_CAST)
++#  define NO_CAST
++# endif
++# if defined(OPENSSL_NO_CMS) && !defined(NO_CMS)
++#  define NO_CMS
++# endif
++# if defined(OPENSSL_NO_DEPRECATED) && !defined(NO_DEPRECATED)
++#  define NO_DEPRECATED
++# endif
++# if defined(OPENSSL_NO_DGRAM) && !defined(NO_DGRAM)
++#  define NO_DGRAM
++# endif
++# if defined(OPENSSL_NO_DSA) && !defined(NO_DSA)
++#  define NO_DSA
++# endif
++# if defined(OPENSSL_NO_DYNAMIC_ENGINE) && !defined(NO_DYNAMIC_ENGINE)
++#  define NO_DYNAMIC_ENGINE
++# endif
++# if defined(OPENSSL_NO_EC) && !defined(NO_EC)
++#  define NO_EC
++# endif
+ # if defined(OPENSSL_NO_EC_NISTP_64_GCC_128) && !defined(NO_EC_NISTP_64_GCC_128)
+ #  define NO_EC_NISTP_64_GCC_128
+ # endif
++# if defined(OPENSSL_NO_ECDH) && !defined(NO_ECDH)
++#  define NO_ECDH
++# endif
++# if defined(OPENSSL_NO_ECDSA) && !defined(NO_ECDSA)
++#  define NO_ECDSA
++# endif
++# if defined(OPENSSL_NO_ENGINE) && !defined(NO_ENGINE)
++#  define NO_ENGINE
++# endif
++# if defined(OPENSSL_NO_ENGINES) && !defined(NO_ENGINES)
++#  define NO_ENGINES
++# endif
++# if defined(OPENSSL_NO_FILENAMES) && !defined(NO_FILENAMES)
++#  define NO_FILENAMES
++# endif
++# if defined(OPENSSL_NO_FP_API) && !defined(NO_FP_API)
++#  define NO_FP_API
++# endif
+ # if defined(OPENSSL_NO_GMP) && !defined(NO_GMP)
+ #  define NO_GMP
+ # endif
++# if defined(OPENSSL_NO_GOST) && !defined(NO_GOST)
++#  define NO_GOST
++# endif
++# if defined(OPENSSL_NO_IDEA) && !defined(NO_IDEA)
++#  define NO_IDEA
++# endif
+ # if defined(OPENSSL_NO_JPAKE) && !defined(NO_JPAKE)
+ #  define NO_JPAKE
+ # endif
+@@ -71,27 +242,78 @@
+ # if defined(OPENSSL_NO_LIBUNBOUND) && !defined(NO_LIBUNBOUND)
+ #  define NO_LIBUNBOUND
+ # endif
++# if defined(OPENSSL_NO_LOCKING) && !defined(NO_LOCKING)
++#  define NO_LOCKING
++# endif
+ # if defined(OPENSSL_NO_MD2) && !defined(NO_MD2)
+ #  define NO_MD2
+ # endif
++# if defined(OPENSSL_NO_MDC2) && !defined(NO_MDC2)
++#  define NO_MDC2
++# endif
++# if defined(OPENSSL_NO_POSIX_IO) && !defined(NO_POSIX_IO)
++#  define NO_POSIX_IO
++# endif
++# if defined(OPENSSL_NO_RC2) && !defined(NO_RC2)
++#  define NO_RC2
++# endif
+ # if defined(OPENSSL_NO_RC5) && !defined(NO_RC5)
+ #  define NO_RC5
+ # endif
++# if defined(OPENSSL_NO_RCS) && !defined(NO_RCS)
++#  define NO_RCS
++# endif
+ # if defined(OPENSSL_NO_RFC3779) && !defined(NO_RFC3779)
+ #  define NO_RFC3779
+ # endif
++# if defined(OPENSSL_NO_RIPEMD) && !defined(NO_RIPEMD)
++#  define NO_RIPEMD
++# endif
++# if defined(OPENSSL_NO_SCRYPT) && !defined(NO_SCRYPT)
++#  define NO_SCRYPT
++# endif
++# if defined(OPENSSL_NO_SCT) && !defined(NO_SCT)
++#  define NO_SCT
++# endif
+ # if defined(OPENSSL_NO_SCTP) && !defined(NO_SCTP)
+ #  define NO_SCTP
+ # endif
++# if defined(OPENSSL_NO_SEED) && !defined(NO_SEED)
++#  define NO_SEED
++# endif
++# if defined(OPENSSL_NO_SHA0) && !defined(NO_SHA0)
++#  define NO_SHA0
++# endif
++# if defined(OPENSSL_NO_SOCK) && !defined(NO_SOCK)
++#  define NO_SOCK
++# endif
++# if defined(OPENSSL_NO_SRP) && !defined(NO_SRP)
++#  define NO_SRP
++# endif
+ # if defined(OPENSSL_NO_SSL_TRACE) && !defined(NO_SSL_TRACE)
+ #  define NO_SSL_TRACE
+ # endif
++# if defined(OPENSSL_NO_SSL2) && !defined(NO_SSL2)
++#  define NO_SSL2
++# endif
++# if defined(OPENSSL_NO_SSL3) && !defined(NO_SSL3)
++#  define NO_SSL3
++# endif
++# if defined(OPENSSL_NO_STDIO) && !defined(NO_STDIO)
++#  define NO_STDIO
++# endif
+ # if defined(OPENSSL_NO_STORE) && !defined(NO_STORE)
+ #  define NO_STORE
+ # endif
++# if defined(OPENSSL_NO_UI) && !defined(NO_UI)
++#  define NO_UI
++# endif
+ # if defined(OPENSSL_NO_UNIT_TEST) && !defined(NO_UNIT_TEST)
+ #  define NO_UNIT_TEST
+ # endif
++# if defined(OPENSSL_NO_WHIRLPOOL) && !defined(NO_WHIRLPOOL)
++#  define NO_WHIRLPOOL
++# endif
+ #endif
+ 
+ /* crypto/opensslconf.h.in */
+@@ -152,7 +374,7 @@
  #endif
  #endif
  
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 72d8949db451..c8408921b959 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -21,34 +21,7 @@
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
   DEFINE OPENSSL_PATH            = openssl-1.0.2d
-  DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -DOPENSSL_NO_CAMELLIA -DOPENSSL_NO_SEED -DOPENSSL_NO_RC5 -DOPENSSL_NO_MDC2 -DOPENSSL_NO_SOCK -DOPENSSL_NO_CMS -DOPENSSL_NO_JPAKE -DOPENSSL_NO_CAPIENG -DOPENSSL_NO_ERR -DOPENSSL_NO_KRB5 -DOPENSSL_NO_DYNAMIC_ENGINE -DOPENSSL_NO_STDIO -DOPENSSL_NO_POSIX_IO -DOPENSSL_NO_FP_API -DOPENSSL_NO_DGRAM -DOPENSSL_NO_ASM
-  DEFINE OPENSSL_EXFLAGS         = -DOPENSSL_SMALL_FOOTPRINT -DOPENSSL_NO_SHA0 -DOPENSSL_NO_LHASH -DOPENSSL_NO_HW -DOPENSSL_NO_OCSP -DOPENSSL_NO_LOCKING -DOPENSSL_NO_DEPRECATED -DOPENSSL_NO_RIPEMD -DOPENSSL_NO_RC2 -DOPENSSL_NO_IDEA -DOPENSSL_NO_BF -DOPENSSL_NO_CAST -DOPENSSL_NO_WHIRLPOOL -DOPENSSL_NO_DSA -DOPENSSL_NO_EC -DOPENSSL_NO_ECDH -DOPENSSL_NO_ECDSA -DOPENSSL_NO_SRP -DOPENSSL_NO_ENGINE
-
-#
-# OPENSSL_FLAGS is set to define the following flags to be compatible with
-# EDK II build system and UEFI executiuon environment
-#
-#   OPENSSL_SYS_UEFI
-#   L_ENDIAN
-#   _CRT_SECURE_NO_DEPRECATE
-#   _CRT_NONSTDC_NO_DEPRECATE
-#   OPENSSL_NO_CAMELLIA
-#   OPENSSL_NO_SEED
-#   OPENSSL_NO_RC5
-#   OPENSSL_NO_MDC2
-#   OPENSSL_NO_SOCK
-#   OPENSSL_NO_CMS
-#   OPENSSL_NO_JPAKE
-#   OPENSSL_NO_CAPIENG
-#   OPENSSL_NO_ERR
-#   OPENSSL_NO_KRB5
-#   OPENSSL_NO_DYNAMIC_ENGINE
-#   OPENSSL_NO_STDIO
-#   OPENSSL_NO_POSIX_IO
-#   OPENSSL_NO_FP_API
-#   OPENSSL_NO_DGRAM
-#   OPENSSL_NO_ASM
-#
+  DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -DOPENSSL_SMALL_FOOTPRINT -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE
 
 #
 #  VALID_ARCHITECTURES           = IA32 X64 IPF ARM AARCH64
@@ -891,19 +864,19 @@
   # C4702: Potentially uninitialized local variable name used
   # C4311: pointer truncation from 'type' to 'type'
   #
-  MSFT:*_*_IA32_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4244 /wd4701 /wd4702 /wd4706
-  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706 /wd4311
-  MSFT:*_*_IPF_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
+  MSFT:*_*_IA32_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) /wd4244 /wd4701 /wd4702 /wd4706
+  MSFT:*_*_X64_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706 /wd4311
+  MSFT:*_*_IPF_CC_FLAGS     = -U_WIN32 -U_WIN64 -U_MSC_VER $(OPENSSL_FLAGS) /wd4133 /wd4244 /wd4245 /wd4267 /wd4701 /wd4305 /wd4306 /wd4702 /wd4706
 
-  INTEL:*_*_IA32_CC_FLAGS   = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
-  INTEL:*_*_X64_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
-  INTEL:*_*_IPF_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) /w
+  INTEL:*_*_IA32_CC_FLAGS   = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) /w
+  INTEL:*_*_X64_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) /w
+  INTEL:*_*_IPF_CC_FLAGS    = -U_WIN32 -U_WIN64 -U_MSC_VER -U__ICC $(OPENSSL_FLAGS) /w
 
-  GCC:*_*_IA32_CC_FLAGS     = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
-  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w -UNO_BUILTIN_VA_FUNCS
-  GCC:*_*_IPF_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
-  GCC:*_*_ARM_CC_FLAGS      = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
-  GCC:*_*_AARCH64_CC_FLAGS  = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  GCC:*_*_IA32_CC_FLAGS     = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w
+  GCC:*_*_X64_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w -UNO_BUILTIN_VA_FUNCS
+  GCC:*_*_IPF_CC_FLAGS      = -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w
+  GCC:*_*_ARM_CC_FLAGS      = $(OPENSSL_FLAGS) -w
+  GCC:*_*_AARCH64_CC_FLAGS  = $(OPENSSL_FLAGS) -w
 
   # suppress the following warnings in openssl so we don't break the build with warnings-as-errors:
   # 1295: Deprecated declaration <entity> - give arg types
@@ -917,6 +890,6 @@
   #  513: a value of type <type> cannot be assigned to an entity of type <type>
   #  188: enumerated type mixed with another type (i.e. passing an integer as an enum without a cast)
   # 1296: Extended constant initialiser used
-  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) --library_interface=aeabi_clib99 --fpu=vfpv3 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
-  XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
-  XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) $(OPENSSL_EXFLAGS) -w
+  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) --library_interface=aeabi_clib99 --fpu=vfpv3 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
+  XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w
+  XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w

From ce302ad5bf3bd9ac52cf624b95747f9d8e6217cd Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Tue, 29 Dec 2015 03:17:18 +0000
Subject: [PATCH 388/525] [CryptoPkg] Correct one typo in the API comments.

Correct one typo (SingerChainCerts --> SignerChainCerts) in the comments
for Pkcs7GetCertificatesList() API.

(Sync patch r18944 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Shumin Qiu <shumin.qiu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19566 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Include/Library/BaseCryptLib.h                      | 2 +-
 CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c          | 4 ++--
 CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c      | 2 +-
 .../Pk/CryptPkcs7VerifyNull.c                                 | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/CryptoPkg/Include/Library/BaseCryptLib.h b/CryptoPkg/Include/Library/BaseCryptLib.h
index 390e302f98c8..0371d73b86b1 100644
--- a/CryptoPkg/Include/Library/BaseCryptLib.h
+++ b/CryptoPkg/Include/Library/BaseCryptLib.h
@@ -1992,7 +1992,7 @@ Pkcs7FreeSigners (
 
   @param[in]  P7Data            Pointer to the PKCS#7 message.
   @param[in]  P7Length          Length of the PKCS#7 message in bytes.
-  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+  @param[out] SignerChainCerts  Pointer to the certificates list chained to signer's
                                 certificate. It's caller's responsiblity to free the buffer.
   @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
   @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
index 6a84137632b7..559610d7b24e 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7Verify.c
@@ -435,7 +435,7 @@ Pkcs7FreeSigners (
 
   @param[in]  P7Data            Pointer to the PKCS#7 message.
   @param[in]  P7Length          Length of the PKCS#7 message in bytes.
-  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+  @param[out] SignerChainCerts  Pointer to the certificates list chained to signer's
                                 certificate. It's caller's responsiblity to free the buffer.
   @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
   @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
@@ -521,7 +521,7 @@ Pkcs7GetCertificatesList (
   //
   // Obtains Signer's Certificate from PKCS#7 data
   // NOTE: Only one signer case will be handled in this function, which means SignerInfos
-  //       should include only one singer's certificate.
+  //       should include only one signer's certificate.
   //
   Signers = PKCS7_get0_signers (Pkcs7, NULL, PKCS7_BINARY);
   if ((Signers == NULL) || (sk_X509_num (Signers) != 1)) {
diff --git a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
index b9affe427503..05433ffb9363 100644
--- a/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
+++ b/CryptoPkg/Library/BaseCryptLib/Pk/CryptPkcs7VerifyNull.c
@@ -74,7 +74,7 @@ Pkcs7FreeSigners (
 
   @param[in]  P7Data            Pointer to the PKCS#7 message.
   @param[in]  P7Length          Length of the PKCS#7 message in bytes.
-  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+  @param[out] SignerChainCerts  Pointer to the certificates list chained to signer's
                                 certificate. It's caller's responsiblity to free the buffer.
   @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
   @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's
diff --git a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
index b9affe427503..05433ffb9363 100644
--- a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
+++ b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/Pk/CryptPkcs7VerifyNull.c
@@ -74,7 +74,7 @@ Pkcs7FreeSigners (
 
   @param[in]  P7Data            Pointer to the PKCS#7 message.
   @param[in]  P7Length          Length of the PKCS#7 message in bytes.
-  @param[out] SingerChainCerts  Pointer to the certificates list chained to signer's
+  @param[out] SignerChainCerts  Pointer to the certificates list chained to signer's
                                 certificate. It's caller's responsiblity to free the buffer.
   @param[out] ChainLength       Length of the chained certificates list buffer in bytes.
   @param[out] UnchainCerts      Pointer to the unchained certificates lists. It's caller's

From bcd093fbbe55fca2f0814ca343c5e7112ef650e1 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Tue, 29 Dec 2015 03:17:46 +0000
Subject: [PATCH 389/525] CryptoPkg/OpensslLib: add softfloat dependency for
 ARM

UEFI on 32-bit ARM does not allow the use of hardware floating point,
so in order to be able to run OpenSslLib, we need to fulfil its
floating point arithmetic dependencies using a software library.

(Sync patch r19033 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19567 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/OpensslLib/OpensslLib.inf | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index c8408921b959..a6d511e83922 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -850,6 +850,9 @@
 [LibraryClasses]
   DebugLib
 
+[LibraryClasses.ARM]
+  ArmSoftFloatLib
+
 [BuildOptions]
   #
   # Disables the following Visual Studio compiler warnings brought by openssl source, so we do not break the build with /WX option:
@@ -890,6 +893,6 @@
   #  513: a value of type <type> cannot be assigned to an entity of type <type>
   #  188: enumerated type mixed with another type (i.e. passing an integer as an enum without a cast)
   # 1296: Extended constant initialiser used
-  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) --library_interface=aeabi_clib99 --fpu=vfpv3 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
+  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) --library_interface=aeabi_clib99 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
   XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w
   XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w

From 571736cb8157676f98189d4255e6930aa9664776 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Tue, 29 Dec 2015 03:18:09 +0000
Subject: [PATCH 390/525] CryptoPkg ARM: add ArmSoftFloatLib resolution to
 CryptoPkg.dsc

In order to build the ARM version of CryptoPkg from its own .DSC file,
it needs a resolution for the ArmSoftFloatLib dependency of OpensslLib.

(Sync patch r19145 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19568 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/CryptoPkg.dsc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CryptoPkg/CryptoPkg.dsc b/CryptoPkg/CryptoPkg.dsc
index 19a0fbcf4361..043704067a22 100644
--- a/CryptoPkg/CryptoPkg.dsc
+++ b/CryptoPkg/CryptoPkg.dsc
@@ -63,6 +63,9 @@
   # Add support for stack protector
   NULL|MdePkg/Library/BaseStackCheckLib/BaseStackCheckLib.inf
 
+[LibraryClasses.ARM]
+  ArmSoftFloatLib|ArmPkg/Library/ArmSoftFloatLib/ArmSoftFloatLib.inf
+
 [LibraryClasses.common.PEIM]
   BaseCryptLib|CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
 

From 354465188725b84b8ae50303a982bac8fe99b1b7 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Tue, 29 Dec 2015 03:18:38 +0000
Subject: [PATCH 391/525] CryptoPkg/BaseCryptLib: make
 mVirtualAddressChangeEvent STATIC

Make mVirtualAddressChangeEvent STATIC to prevent it from conflicting
with other variables of the same name that may be defined in other
libraries (e.g., MdeModulePkg/Universal/Variable/RuntimeDxe)
This also removes the risk of mVirtualAddressChangeEvent being merged with
other uninitialized variables with external linkage by toolchains that perform
COMMON allocation.

(Sync patch r19146 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19569 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
index 79bb0678e376..616ee7717e72 100644
--- a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
+++ b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
@@ -64,7 +64,7 @@ RT_MEMORY_PAGE_TABLE  *mRTPageTable = NULL;
 //
 // Event for Runtime Address Conversion.
 //
-EFI_EVENT             mVirtualAddressChangeEvent;
+STATIC EFI_EVENT      mVirtualAddressChangeEvent;
 
 
 /**

From 6cdcc26706e1226e500c86412ff95d0c8ecf6611 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Tue, 29 Dec 2015 03:19:04 +0000
Subject: [PATCH 392/525] CryptoPkg/OpensslLib: comment out unused code

This comments out the pqueue and ts_* source files from the OpensslLib
build, since they have no users.

(Sync patch r19147 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19570 6f19259b-4bc3-4df7-8a09-765794883524
---
 CryptoPkg/Library/OpensslLib/OpensslLib.inf | 24 ++++++++++-----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index a6d511e83922..b54a173845b9 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -813,22 +813,22 @@
   #
   # PQUEUE
   #
-  $(OPENSSL_PATH)/crypto/pqueue/pqueue.c
+  #$(OPENSSL_PATH)/crypto/pqueue/pqueue.c
 
   #
   # TS
   #
-  $(OPENSSL_PATH)/crypto/ts/ts_err.c
-  $(OPENSSL_PATH)/crypto/ts/ts_req_utils.c
-  $(OPENSSL_PATH)/crypto/ts/ts_req_print.c
-  $(OPENSSL_PATH)/crypto/ts/ts_rsp_utils.c
-  $(OPENSSL_PATH)/crypto/ts/ts_rsp_print.c
-  $(OPENSSL_PATH)/crypto/ts/ts_rsp_sign.c
-  $(OPENSSL_PATH)/crypto/ts/ts_rsp_verify.c
-  $(OPENSSL_PATH)/crypto/ts/ts_verify_ctx.c
-  $(OPENSSL_PATH)/crypto/ts/ts_lib.c
-  $(OPENSSL_PATH)/crypto/ts/ts_conf.c
-  $(OPENSSL_PATH)/crypto/ts/ts_asn1.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_err.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_req_utils.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_req_print.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_rsp_utils.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_rsp_print.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_rsp_sign.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_rsp_verify.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_verify_ctx.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_lib.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_conf.c
+  #$(OPENSSL_PATH)/crypto/ts/ts_asn1.c
 
   #
   # SRP - Disabled by OPENSSL_NO_SRP

From a959329850ad389052657857ce34d77ddf4f83bb Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Tue, 29 Dec 2015 03:19:40 +0000
Subject: [PATCH 393/525] CryptoPkg/OpensslLib: upgrade OpenSSL version to
 1.0.2e

OpenSSL has released version 1.0.2e with security fixes.
Upgrade the supported OpenSSL version in CryptoPkg/OpensslLib
from 1.0.2d to 1.0.2e.
(Note: This is based on Ard's previous patch with extra fix
       https://rt.openssl.org/Ticket/Display.html?id=4175)

(Sync patch r19218 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Singed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/branches/UDK2015@19571 6f19259b-4bc3-4df7-8a09-765794883524
---
 ....0.2d.patch => EDKII_openssl-1.0.2e.patch} | 31 +++++++++++++------
 CryptoPkg/Library/OpensslLib/Install.cmd      |  2 +-
 CryptoPkg/Library/OpensslLib/Install.sh       |  2 +-
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |  2 +-
 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt  | 26 ++++++++--------
 5 files changed, 38 insertions(+), 25 deletions(-)
 rename CryptoPkg/Library/OpensslLib/{EDKII_openssl-1.0.2d.patch => EDKII_openssl-1.0.2e.patch} (94%)

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
similarity index 94%
rename from CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
rename to CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
index 6be397b8b959..e4eaff6eadd2 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2d.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
@@ -16,7 +16,7 @@ diff U3 crypto/bio/bio.h crypto/bio/bio.h
 diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
 --- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
 +++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
-@@ -460,6 +460,23 @@
+@@ -467,6 +467,23 @@
      return (ret);
  }
  
@@ -83,9 +83,22 @@ diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
 +    char *buf = NULL;
 +    int bufsiz;
      int i, j = 0, k, ret = 0;
-     BIO *p7bio;
-     BIO *tmpin, *tmpout;
-@@ -365,9 +366,14 @@
+     BIO *p7bio = NULL;
+     BIO *tmpin = NULL, *tmpout = NULL;
+@@ -275,12 +276,6 @@
+         return 0;
+     }
+ 
+-    /* Check for data and content: two sets of data */
+-    if (!PKCS7_get_detached(p7) && indata) {
+-        PKCS7err(PKCS7_F_PKCS7_VERIFY, PKCS7_R_CONTENT_AND_DATA_PRESENT);
+-        return 0;
+-    }
+-
+     sinfos = PKCS7_get_signer_info(p7);
+ 
+     if (!sinfos || !sk_PKCS7_SIGNER_INFO_num(sinfos)) {
+@@ -355,9 +350,14 @@
      } else
          tmpout = out;
  
@@ -101,17 +114,17 @@ diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
          if (i <= 0)
              break;
          if (tmpout)
-@@ -406,6 +412,10 @@
+@@ -394,6 +394,10 @@
+     }
      BIO_free_all(p7bio);
- 
      sk_X509_free(signers);
 +
 +    if (buf != NULL) {
 +      OPENSSL_free(buf);
 +    }
- 
      return ret;
  }
+ 
 diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
 --- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
 +++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
@@ -210,7 +223,7 @@ diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
 diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
 --- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
 +++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
-@@ -935,6 +935,8 @@
+@@ -940,6 +940,8 @@
          ctx->current_crl = crl;
      if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
          ptime = &ctx->param->check_time;
@@ -219,7 +232,7 @@ diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
      else
          ptime = NULL;
  
-@@ -1658,6 +1660,8 @@
+@@ -1663,6 +1665,8 @@
  
      if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
          ptime = &ctx->param->check_time;
diff --git a/CryptoPkg/Library/OpensslLib/Install.cmd b/CryptoPkg/Library/OpensslLib/Install.cmd
index ef0a4bdcebc9..b9b6fc6f7094 100755
--- a/CryptoPkg/Library/OpensslLib/Install.cmd
+++ b/CryptoPkg/Library/OpensslLib/Install.cmd
@@ -1,4 +1,4 @@
-cd openssl-1.0.2d
+cd openssl-1.0.2e
 copy e_os2.h                    ..\..\..\Include\openssl
 copy crypto\crypto.h            ..\..\..\Include\openssl
 copy crypto\opensslv.h          ..\..\..\Include\openssl
diff --git a/CryptoPkg/Library/OpensslLib/Install.sh b/CryptoPkg/Library/OpensslLib/Install.sh
index 877e775b81af..543439529448 100755
--- a/CryptoPkg/Library/OpensslLib/Install.sh
+++ b/CryptoPkg/Library/OpensslLib/Install.sh
@@ -1,6 +1,6 @@
 #!/bin/sh
 
-cd openssl-1.0.2d
+cd openssl-1.0.2e
 cp e_os2.h                    ../../../Include/openssl
 cp crypto/crypto.h            ../../../Include/openssl
 cp crypto/opensslv.h          ../../../Include/openssl
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index b54a173845b9..216c1bb764eb 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -20,7 +20,7 @@
   MODULE_TYPE                    = BASE
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
-  DEFINE OPENSSL_PATH            = openssl-1.0.2d
+  DEFINE OPENSSL_PATH            = openssl-1.0.2e
   DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -DOPENSSL_SMALL_FOOTPRINT -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE
 
 #
diff --git a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
index 59e74ee9b0d9..f575d7147bdf 100644
--- a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
+++ b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
@@ -17,36 +17,36 @@ cryptography. This patch will enable openssl building under UEFI environment.
 ================================================================================
                                 OpenSSL-Version
 ================================================================================
-  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2d.
-    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
+  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2e.
+    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
 
 
 ================================================================================
                       HOW to Install Openssl for UEFI Building
 ================================================================================
-1.  Download OpenSSL 1.0.2d from official website:
-    http://www.openssl.org/source/openssl-1.0.2d.tar.gz
+1.  Download OpenSSL 1.0.2e from official website:
+    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
 
-    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2d.tar.tar.
-          When you do the download, rename the "openssl-1.0.2d.tar.tar" to
-          "openssl-1.0.2d.tar.gz" or rename the local downloaded file with ".tar.tar"
+    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2e.tar.tar.
+          When you do the download, rename the "openssl-1.0.2e.tar.tar" to
+          "openssl-1.0.2e.tar.gz" or rename the local downloaded file with ".tar.tar"
           extension to ".tar.gz".
 
-2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2d
+2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2e
 
     NOTE: If you use WinZip to unpack the openssl source in Windows, please
           uncheck the WinZip smart CR/LF conversion option (WINZIP: Options -->
           Configuration --> Miscellaneous --> "TAR file smart CR/LF conversion").
 
-3.  Apply this patch: EDKII_openssl-1.0.2d.patch, and make installation
+3.  Apply this patch: EDKII_openssl-1.0.2e.patch, and make installation
 
     For Windows Environment:
     ------------------------
     1) Make sure the patch utility has been installed in your machine.
        Install Cygwin or get the patch utility binary from
           http://gnuwin32.sourceforge.net/packages/patch.htm
-    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2d
-    3) patch -p0 -i ..\EDKII_openssl-1.0.2d.patch
+    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2e
+    3) patch -p0 -i ..\EDKII_openssl-1.0.2e.patch
     4) cd ..
     5) Install.cmd
 
@@ -54,8 +54,8 @@ cryptography. This patch will enable openssl building under UEFI environment.
     -----------------------
     1) Make sure the patch utility has been installed in your machine.
        Patch utility is available from http://directory.fsf.org/project/patch/
-    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2d
-    3) patch -p0 -i ../EDKII_openssl-1.0.2d.patch
+    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2e
+    3) patch -p0 -i ../EDKII_openssl-1.0.2e.patch
     4) cd ..
     5) ./Install.sh
 

From 1fb07e5e60e01158d1866a4d432627a3329dacfe Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Date: Tue, 22 Dec 2015 01:42:26 +0000
Subject: [PATCH 394/525] MdePkg: Add HTTP 1.1 industry standard definitions.

Add common HTTP 1.1 industry standard definitions for use in HTTP
clients/applications. List includes: HTTP methods, request/response
headers, and encodings.

(Sync patch r19435 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
---
 MdePkg/Include/IndustryStandard/Http11.h | 208 +++++++++++++++++++++++
 1 file changed, 208 insertions(+)
 create mode 100644 MdePkg/Include/IndustryStandard/Http11.h

diff --git a/MdePkg/Include/IndustryStandard/Http11.h b/MdePkg/Include/IndustryStandard/Http11.h
new file mode 100644
index 000000000000..6c22f94d8ac4
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/Http11.h
@@ -0,0 +1,208 @@
+/** @file
+  Hypertext Transfer Protocol -- HTTP/1.1 Standard definitions, from RFC 2616    
+
+  This file contains common HTTP 1.1 definitions from RFC 2616 
+   
+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+**/
+
+#ifndef __HTTP_11_H__
+#define __HTTP_11_H__
+
+#pragma pack(1)
+
+///
+/// HTTP Version (currently HTTP 1.1)
+/// 
+/// The version of an HTTP message is indicated by an HTTP-Version field
+/// in the first line of the message.
+///
+#define HTTP_VERSION        "HTTP/1.1"
+
+
+///
+/// HTTP Request Method definitions
+/// 
+/// The Method  token indicates the method to be performed on the
+/// resource identified by the Request-URI. The method is case-sensitive.
+///
+#define HTTP_METHOD_OPTIONS "OPTIONS"
+#define HTTP_METHOD_GET     "GET"
+#define HTTP_METHOD_HEAD    "HEAD"
+#define HTTP_METHOD_POST    "POST"
+#define HTTP_METHOD_PUT     "PUT"
+#define HTTP_METHOD_DELETE  "DELETE"
+#define HTTP_METHOD_TRACE   "TRACE"
+#define HTTP_METHOD_CONNECT "CONNECT"
+#define HTTP_METHOD_PATCH   "PATCH"
+
+#define HTTP_METHOD_MAXIMUM_LEN  sizeof ("CONNECT")
+
+///
+/// Accept Request Header
+/// The Accept request-header field can be used to specify certain media types which are 
+/// acceptable for the response. Accept headers can be used to indicate that the request 
+/// is specifically limited to a small set of desired types, as in the case of a request 
+/// for an in-line image.
+///
+#define HTTP_HEADER_ACCEPT             "Accept"
+
+
+/// 
+/// Accept-Charset Request Header
+/// The Accept-Charset request-header field can be used to indicate what character sets 
+/// are acceptable for the response. This field allows clients capable of understanding 
+/// more comprehensive or special-purpose character sets to signal that capability to a 
+/// server which is capable of representing documents in those character sets.
+///
+#define HTTP_HEADER_ACCEPT_CHARSET     "Accept-Charset"
+
+/// 
+/// Accept-Language Request Header
+/// The Accept-Language request-header field is similar to Accept, 
+/// but restricts the set of natural languages that are preferred 
+/// as a response to the request.
+///
+#define HTTP_HEADER_ACCEPT_LANGUAGE    "Accept-Language"
+
+///
+/// Accept-Ranges Request Header
+/// The Accept-Ranges response-header field allows the server to
+/// indicate its acceptance of range requests for a resource:
+///
+#define HTTP_HEADER_ACCEPT_RANGES      "Accept-Ranges"
+
+
+/// 
+/// Accept-Encoding Request Header
+/// The Accept-Encoding request-header field is similar to Accept, 
+/// but restricts the content-codings that are acceptable in the response.
+///
+#define HTTP_HEADER_ACCEPT_ENCODING    "Accept-Encoding"
+
+///
+/// Content-Encoding Header
+/// The Content-Encoding entity-header field is used as a modifier to the media-type. 
+/// When present, its value indicates what additional content codings have been applied 
+/// to the entity-body, and thus what decoding mechanisms must be applied in order to 
+/// obtain the media-type referenced by the Content-Type header field. Content-Encoding 
+/// is primarily used to allow a document to be compressed without losing the identity 
+/// of its underlying media type.
+///
+#define HTTP_HEADER_CONTENT_ENCODING   "Content-Encoding"
+
+/// 
+/// HTTP Content-Encoding Compression types
+///
+
+#define HTTP_CONTENT_ENCODING_IDENTITY "identity"  /// No transformation is used. This is the default value for content coding.
+#define HTTP_CONTENT_ENCODING_GZIP     "gzip"      /// Content-Encoding: GNU zip format (described in RFC 1952).
+#define HTTP_CONTENT_ENCODING_COMPRESS "compress"  /// encoding format produced by the common UNIX file compression program "compress". 
+#define HTTP_CONTENT_ENCODING_DEFLATE  "deflate"   /// The "zlib" format defined in RFC 1950 in combination with the "deflate" 
+                                                    /// compression mechanism described in RFC 1951.
+
+
+///
+/// Content-Type Header
+/// The Content-Type entity-header field indicates the media type of the entity-body sent to 
+/// the recipient or, in the case of the HEAD method, the media type that would have been sent 
+/// had the request been a GET.
+///
+#define HTTP_HEADER_CONTENT_TYPE       "Content-Type"
+//
+// Common Media Types defined in http://www.iana.org/assignments/media-types/media-types.xhtml
+//
+#define HTTP_CONTENT_TYPE_APP_JSON          "application/json"
+#define HTTP_CONTENT_TYPE_APP_OCTET_STREAM  "application/octet-stream"
+                                           
+#define HTTP_CONTENT_TYPE_TEXT_HTML         "text/html"
+#define HTTP_CONTENT_TYPE_TEXT_PLAIN        "text/plain"
+#define HTTP_CONTENT_TYPE_TEXT_CSS          "text/css"
+#define HTTP_CONTENT_TYPE_TEXT_XML          "text/xml"
+                                           
+#define HTTP_CONTENT_TYPE_IMAGE_GIF         "image/gif"
+#define HTTP_CONTENT_TYPE_IMAGE_JPEG        "image/jpeg"
+#define HTTP_CONTENT_TYPE_IMAGE_PNG         "image/png"
+#define HTTP_CONTENT_TYPE_IMAGE_SVG_XML     "image/svg+xml"
+
+
+///
+/// Content-Length Header
+/// The Content-Length entity-header field indicates the size of the entity-body, 
+/// in decimal number of OCTETs, sent to the recipient or, in the case of the HEAD 
+/// method, the size of the entity-body that would have been sent had the request been a GET.
+///
+#define HTTP_HEADER_CONTENT_LENGTH     "Content-Length"
+                                                                                                              
+///
+/// Transfer-Encoding Header
+/// The Transfer-Encoding general-header field indicates what (if any) type of transformation 
+/// has been applied to the message body in order to safely transfer it between the sender 
+/// and the recipient. This differs from the content-coding in that the transfer-coding 
+/// is a property of the message, not of the entity.
+///
+#define HTTP_HEADER_TRANSFER_ENCODING  "Transfer-Encoding"
+
+
+///
+/// Host Request Header
+///
+/// The Host request-header field specifies the Internet host and port number of the resource 
+/// being requested, as obtained from the original URI given by the user or referring resource 
+///
+#define  HTTP_HEADER_HOST              "Host"
+
+
+///
+/// The If-Match request-header field is used with a method to make it conditional.
+/// A client that has one or more entities previously obtained from the resource 
+/// can verify that one of those entities is current by including a list of their 
+/// associated entity tags in the If-Match header field. 
+/// The purpose of this feature is to allow efficient updates of cached information 
+/// with a minimum amount of transaction overhead. It is also used, on updating requests, 
+/// to prevent inadvertent modification of the wrong version of a resource. 
+/// As a special case, the value "*" matches any current entity of the resource.
+///
+#define  HTTP_HEADER_IF_MATCH          "If-Match"
+
+
+///
+/// The If-None-Match request-header field is used with a method to make it conditional. 
+/// A client that has one or more entities previously obtained from the resource can verify 
+/// that none of those entities is current by including a list of their associated entity 
+/// tags in the If-None-Match header field. The purpose of this feature is to allow efficient 
+/// updates of cached information with a minimum amount of transaction overhead. It is also used 
+/// to prevent a method (e.g. PUT) from inadvertently modifying an existing resource when the 
+/// client believes that the resource does not exist.
+///
+#define  HTTP_HEADER_IF_NONE_MATCH     "If-None-Match"
+
+
+
+/// 
+/// Authorization Request Header
+/// The Authorization field value consists of credentials
+/// containing the authentication information of the user agent for
+/// the realm of the resource being requested.
+///
+#define  HTTP_HEADER_AUTHORIZATION     "Authorization"
+
+///
+/// ETAG Response Header
+/// The ETag response-header field provides the current value of the entity tag 
+/// for the requested variant. 
+///
+#define  HTTP_HEADER_ETAG              "ETag"
+
+
+
+
+#pragma pack()
+#endif

From 4f1812dfa972a3193a36c33631d762db0bdd4bb3 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Date: Tue, 22 Dec 2015 02:02:11 +0000
Subject: [PATCH 395/525] NetworkPkg : Remove unused local variables to fix gcc
 build errors.

(Sync patch r19436 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <elhaj@hpe.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
---
 NetworkPkg/HttpDxe/HttpProto.c | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/NetworkPkg/HttpDxe/HttpProto.c b/NetworkPkg/HttpDxe/HttpProto.c
index 165e95cc50a9..9660b6fb6716 100644
--- a/NetworkPkg/HttpDxe/HttpProto.c
+++ b/NetworkPkg/HttpDxe/HttpProto.c
@@ -568,13 +568,9 @@ HttpCloseTcpRxEvent (
   )
 {
   HTTP_PROTOCOL            *HttpInstance;
-  EFI_TCP4_IO_TOKEN        *Rx4Token;
-  EFI_TCP6_IO_TOKEN        *Rx6Token;
 
   ASSERT (Wrap != NULL);
   HttpInstance   = Wrap->HttpInstance;
-  Rx4Token       = NULL;
-  Rx6Token       = NULL;
   
   if (HttpInstance->LocalAddressIsIPv6) {
     if (Wrap->TcpWrap.Rx6Token.CompletionToken.Event != NULL) {

From 2d06a29d4e8023e751fa286169f821601c9b5bd0 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Wed, 23 Dec 2015 06:54:52 +0000
Subject: [PATCH 396/525] NetworkPkg: Remove a CopyMem to speed up the HTTP
 boot download.

This patch updates the HTTP boot driver to use the caller provided buffer
directly in identity transfer-coding mode, this could save one time CopyMem
operation to benefit the download performance.

(Sync patch r19482 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Zhang Lubo <lubo.zhang@intel.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>
---
 NetworkPkg/HttpBootDxe/HttpBootClient.c | 271 ++++++++++++++----------
 1 file changed, 163 insertions(+), 108 deletions(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.c b/NetworkPkg/HttpBootDxe/HttpBootClient.c
index b81b03c96070..a2cad0a6fba4 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.c
@@ -456,81 +456,6 @@ HttpBootCreateHttpIo (
   return EFI_SUCCESS;
 }
 
-/**
-  Get the file content from cached data.
-
-  @param[in]          Private         The pointer to the driver's private data.
-  @param[in]          Uri             Uri of the file to be retrieved from cache.
-  @param[in, out]     BufferSize      On input the size of Buffer in bytes. On output with a return
-                                      code of EFI_SUCCESS, the amount of data transferred to
-                                      Buffer. On output with a return code of EFI_BUFFER_TOO_SMALL,
-                                      the size of Buffer required to retrieve the requested file.
-  @param[out]         Buffer          The memory buffer to transfer the file to. IF Buffer is NULL,
-                                      then the size of the requested file is returned in
-                                      BufferSize.
-
-  @retval EFI_SUCCESS          Successfully created.
-  @retval Others               Failed to create HttpIo.
-
-**/
-EFI_STATUS
-HttpBootGetFileFromCache (
-  IN     HTTP_BOOT_PRIVATE_DATA   *Private,
-  IN     CHAR16                   *Uri,
-  IN OUT UINTN                    *BufferSize,
-     OUT UINT8                    *Buffer
-  )
-{
-  LIST_ENTRY                  *Entry;
-  LIST_ENTRY                  *Entry2;
-  HTTP_BOOT_CACHE_CONTENT     *Cache;
-  HTTP_BOOT_ENTITY_DATA       *EntityData;
-  UINTN                       CopyedSize;
-  
-  if (Uri == NULL || BufferSize == 0 || Buffer == NULL) {
-    return EFI_INVALID_PARAMETER;
-  }
-
-  NET_LIST_FOR_EACH (Entry, &Private->CacheList) {
-    Cache = NET_LIST_USER_STRUCT (Entry, HTTP_BOOT_CACHE_CONTENT, Link);
-    //
-    // Compare the URI to see whether we already have a cache for this file.
-    //
-    if ((Cache->RequestData != NULL) &&
-        (Cache->RequestData->Url != NULL) &&
-        (StrCmp (Uri, Cache->RequestData->Url) == 0)) 
-    {
-      //
-      // Hit cache, check buffer size.
-      //
-      if (*BufferSize < Cache->EntityLength) {
-        *BufferSize = Cache->EntityLength;
-        return EFI_BUFFER_TOO_SMALL;
-      }
-
-      //
-      // Fill data to buffer.
-      //
-      CopyedSize = 0;
-      NET_LIST_FOR_EACH (Entry2, &Cache->EntityDataList) {
-        EntityData = NET_LIST_USER_STRUCT (Entry2, HTTP_BOOT_ENTITY_DATA, Link);
-        if (*BufferSize > CopyedSize) {
-          CopyMem (
-            Buffer + CopyedSize,
-            EntityData->DataStart,
-            MIN (EntityData->DataLength, *BufferSize - CopyedSize)
-            );
-          CopyedSize += MIN (EntityData->DataLength, *BufferSize - CopyedSize);
-        }
-      }
-      *BufferSize = CopyedSize;
-      return EFI_SUCCESS;
-    }
-  }
-
-  return EFI_NOT_FOUND;
-}
-
 /**
   Release all the resource of a cache item.
 
@@ -609,6 +534,91 @@ HttpBootFreeCacheList (
   }
 }
 
+/**
+  Get the file content from cached data.
+
+  @param[in]          Private         The pointer to the driver's private data.
+  @param[in]          Uri             Uri of the file to be retrieved from cache.
+  @param[in, out]     BufferSize      On input the size of Buffer in bytes. On output with a return
+                                      code of EFI_SUCCESS, the amount of data transferred to
+                                      Buffer. On output with a return code of EFI_BUFFER_TOO_SMALL,
+                                      the size of Buffer required to retrieve the requested file.
+  @param[out]         Buffer          The memory buffer to transfer the file to. IF Buffer is NULL,
+                                      then the size of the requested file is returned in
+                                      BufferSize.
+
+  @retval EFI_SUCCESS          Successfully created.
+  @retval Others               Failed to create HttpIo.
+
+**/
+EFI_STATUS
+HttpBootGetFileFromCache (
+  IN     HTTP_BOOT_PRIVATE_DATA   *Private,
+  IN     CHAR16                   *Uri,
+  IN OUT UINTN                    *BufferSize,
+     OUT UINT8                    *Buffer
+  )
+{
+  LIST_ENTRY                  *Entry;
+  LIST_ENTRY                  *Entry2;
+  HTTP_BOOT_CACHE_CONTENT     *Cache;
+  HTTP_BOOT_ENTITY_DATA       *EntityData;
+  UINTN                       CopyedSize;
+  
+  if (Uri == NULL || BufferSize == 0 || Buffer == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Search file in the cache list, the cache entry will be released upon a successful
+  // match.
+  //
+  NET_LIST_FOR_EACH (Entry, &Private->CacheList) {
+    Cache = NET_LIST_USER_STRUCT (Entry, HTTP_BOOT_CACHE_CONTENT, Link);
+    //
+    // Compare the URI to see whether we already have a cache for this file.
+    //
+    if ((Cache->RequestData != NULL) &&
+        (Cache->RequestData->Url != NULL) &&
+        (StrCmp (Uri, Cache->RequestData->Url) == 0)) 
+    {
+      //
+      // Hit cache, check buffer size.
+      //
+      if (*BufferSize < Cache->EntityLength) {
+        *BufferSize = Cache->EntityLength;
+        return EFI_BUFFER_TOO_SMALL;
+      }
+
+      //
+      // Fill data to buffer.
+      //
+      CopyedSize = 0;
+      NET_LIST_FOR_EACH (Entry2, &Cache->EntityDataList) {
+        EntityData = NET_LIST_USER_STRUCT (Entry2, HTTP_BOOT_ENTITY_DATA, Link);
+        if (*BufferSize > CopyedSize) {
+          CopyMem (
+            Buffer + CopyedSize,
+            EntityData->DataStart,
+            MIN (EntityData->DataLength, *BufferSize - CopyedSize)
+            );
+          CopyedSize += MIN (EntityData->DataLength, *BufferSize - CopyedSize);
+        }
+      }
+      *BufferSize = CopyedSize;
+
+      //
+      // On success, free the cached data to release the memory resource.
+      //
+      RemoveEntryList (&Cache->Link);
+      HttpBootFreeCache (Cache);
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_NOT_FOUND;
+}
+
 /**
   A callback function to intercept events during message parser.
 
@@ -719,6 +729,8 @@ HttpBootGetBootFile (
   HTTP_BOOT_CACHE_CONTENT    *Cache;
   UINT8                      *Block;
   CHAR16                     *Url;
+  BOOLEAN                    IdentityMode;
+  UINTN                      ReceivedSize;
   
   ASSERT (Private != NULL);
   ASSERT (Private->HttpCreated);
@@ -921,51 +933,94 @@ HttpBootGetBootFile (
   //
   Block = NULL;
   if (!HeaderOnly) {
+    //
+    // 3.4.1, check whether we are in identity transfer-coding.
+    //
+    ContentLength = 0;
+    Status = HttpGetEntityLength (Parser, &ContentLength);
+    if (!EFI_ERROR (Status)) {
+      IdentityMode = TRUE;
+    } else {
+      IdentityMode = FALSE;
+    }
+
+    //
+    // 3.4.2, start the message-body download, the identity and chunked transfer-coding
+    // is handled in different path here.
+    //
     ZeroMem (&ResponseBody, sizeof (HTTP_IO_RESOPNSE_DATA));
-    while (!HttpIsMessageComplete (Parser)) {
+    if (IdentityMode) {
       //
-      // Allocate a block to hold the message-body, if caller doesn't provide
-      // a buffer, the block will be cached and we will allocate a new one here.
+      // In identity transfer-coding there is no need to parse the message body,
+      // just download the message body to the user provided buffer directly.
       //
-      if (Block == NULL || Context.BufferSize == 0) {
-        Block = AllocatePool (HTTP_BOOT_BLOCK_SIZE);
-        if (Block == NULL) {
-          Status = EFI_OUT_OF_RESOURCES;
+      ReceivedSize = 0;
+      while (ReceivedSize < ContentLength) {
+        ResponseBody.Body       = (CHAR8*) Buffer + ReceivedSize;
+        ResponseBody.BodyLength = *BufferSize - ReceivedSize;
+        Status = HttpIoRecvResponse (
+                   &Private->HttpIo,
+                   FALSE,
+                   &ResponseBody
+                   );
+        if (EFI_ERROR (Status)) {
           goto ERROR_6;
         }
-        Context.NewBlock = TRUE;
-        Context.Block = Block;
-      } else {
-        Context.NewBlock = FALSE;
-      }
-
-      ResponseBody.Body       = (CHAR8*) Block;
-      ResponseBody.BodyLength = HTTP_BOOT_BLOCK_SIZE;
-      Status = HttpIoRecvResponse (
-                 &Private->HttpIo,
-                 FALSE,
-                 &ResponseBody
-                 );
-      if (EFI_ERROR (Status)) {
-        goto ERROR_6;
+        ReceivedSize += ResponseBody.BodyLength;
       }
-
+    } else {
       //
-      // Parse the new received block of the message-body, the block will be saved in cache.
+      // In "chunked" transfer-coding mode, so we need to parse the received
+      // data to get the real entity content.
       //
-      Status = HttpParseMessageBody (
-                 Parser,
-                 ResponseBody.BodyLength,
-                 ResponseBody.Body
-                 );
-      if (EFI_ERROR (Status)) {
-        goto ERROR_6;
+      Block = NULL;
+      while (!HttpIsMessageComplete (Parser)) {
+        //
+        // Allocate a buffer in Block to hold the message-body.
+        // If caller provides a buffer, this Block will be reused in every HttpIoRecvResponse().
+        // Otherwise a buffer, the buffer in Block will be cached and we should allocate a new before
+        // every HttpIoRecvResponse().
+        //
+        if (Block == NULL || Context.BufferSize == 0) {
+          Block = AllocatePool (HTTP_BOOT_BLOCK_SIZE);
+          if (Block == NULL) {
+            Status = EFI_OUT_OF_RESOURCES;
+            goto ERROR_6;
+          }
+          Context.NewBlock = TRUE;
+          Context.Block = Block;
+        } else {
+          Context.NewBlock = FALSE;
+        }
+
+        ResponseBody.Body       = (CHAR8*) Block;
+        ResponseBody.BodyLength = HTTP_BOOT_BLOCK_SIZE;
+        Status = HttpIoRecvResponse (
+                   &Private->HttpIo,
+                   FALSE,
+                   &ResponseBody
+                   );
+        if (EFI_ERROR (Status)) {
+          goto ERROR_6;
+        }
+
+        //
+        // Parse the new received block of the message-body, the block will be saved in cache.
+        //
+        Status = HttpParseMessageBody (
+                   Parser,
+                   ResponseBody.BodyLength,
+                   ResponseBody.Body
+                   );
+        if (EFI_ERROR (Status)) {
+          goto ERROR_6;
+        }
       }
     }
   }
-  
+
   //
-  // 3.5 Message-body receive & parse is completed, get the file size.
+  // 3.5 Message-body receive & parse is completed, we should be able to get the file size now.
   //
   Status = HttpGetEntityLength (Parser, &ContentLength);
   if (EFI_ERROR (Status)) {

From f24b415887c88e342aa5386e0a3e7db1e8ac340a Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Fri, 8 Jan 2016 02:21:25 +0000
Subject: [PATCH 397/525] MdeModulePkg: update SNP.GetStatus to handle multiple
 recycled TX buffer.

This patch fixes a bug in SNP.GetStatus() interface. The UNDI driver may return
multiple transmitted buffers in a single GetStatus command, while SNP.GetStatus
could only return one pointer each time, the rest of them are lost. This patch
fixes this issue by store these recycled pointer in a temporary buffer in SNP
driver.

(Sync patch r19623 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
---
 .../Universal/Network/SnpDxe/Get_status.c     | 73 +++++++++++++++----
 MdeModulePkg/Universal/Network/SnpDxe/Snp.c   | 16 +++-
 MdeModulePkg/Universal/Network/SnpDxe/Snp.h   | 18 ++++-
 3 files changed, 89 insertions(+), 18 deletions(-)

diff --git a/MdeModulePkg/Universal/Network/SnpDxe/Get_status.c b/MdeModulePkg/Universal/Network/SnpDxe/Get_status.c
index 053297605b78..8f2ab9b24ab5 100644
--- a/MdeModulePkg/Universal/Network/SnpDxe/Get_status.c
+++ b/MdeModulePkg/Universal/Network/SnpDxe/Get_status.c
@@ -2,7 +2,7 @@
   Implementation of reading the current interrupt status and recycled transmit
   buffer status from a network interface.
 
-Copyright (c) 2004 - 2010, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed
 and made available under the terms and conditions of the BSD License which
 accompanies this distribution. The full text of the license may be found at
@@ -16,15 +16,15 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include "Snp.h"
 
 /**
-  Call undi to get the status of the interrupts, get the list of transmit
-  buffers that completed transmitting.
+  Call undi to get the status of the interrupts, get the list of recycled transmit
+  buffers that completed transmitting. The recycled transmit buffer address will
+  be saved into Snp->RecycledTxBuf.
 
   @param  Snp                     Pointer to snp driver structure.
   @param  InterruptStatusPtr      A non null pointer to contain the interrupt
                                   status.
-  @param  TransmitBufferListPtrs  A non null pointer to contain the list of
-                                  pointers of previous transmitted buffers whose
-                                  transmission was completed asynchrnously.
+  @param  GetTransmittedBuf       Set to TRUE to retrieve the recycled transmit
+                                  buffer address.
 
   @retval EFI_SUCCESS         The status of the network interface was retrieved.
   @retval EFI_DEVICE_ERROR    The command could not be sent to the network
@@ -35,19 +35,23 @@ EFI_STATUS
 PxeGetStatus (
   SNP_DRIVER *Snp,
   UINT32     *InterruptStatusPtr,
-  VOID       **TransmitBufferListPtr
+  BOOLEAN    GetTransmittedBuf
   )
 {
   PXE_DB_GET_STATUS *Db;
   UINT16            InterruptFlags;
+  UINT32            Index;
+  UINT64            *Tmp;
 
+  Tmp               = NULL;
   Db                = Snp->Db;
   Snp->Cdb.OpCode   = PXE_OPCODE_GET_STATUS;
 
   Snp->Cdb.OpFlags  = 0;
 
-  if (TransmitBufferListPtr != NULL) {
+  if (GetTransmittedBuf) {
     Snp->Cdb.OpFlags |= PXE_OPFLAGS_GET_TRANSMITTED_BUFFERS;
+    ZeroMem (Db->TxBuffer, sizeof (Db->TxBuffer));
   }
 
   if (InterruptStatusPtr != NULL) {
@@ -116,13 +120,34 @@ PxeGetStatus (
 
   }
 
-  if (TransmitBufferListPtr != NULL) {
-    *TransmitBufferListPtr =
-      (
-        ((Snp->Cdb.StatFlags & PXE_STATFLAGS_GET_STATUS_NO_TXBUFS_WRITTEN) != 0) ||
-        ((Snp->Cdb.StatFlags & PXE_STATFLAGS_GET_STATUS_TXBUF_QUEUE_EMPTY) != 0)
-      ) ? 0 : (VOID *) (UINTN) Db->TxBuffer[0];
-
+  if (GetTransmittedBuf) {
+    if ((Snp->Cdb.StatFlags & PXE_STATFLAGS_GET_STATUS_NO_TXBUFS_WRITTEN) == 0) {
+      //
+      // UNDI has written some transmitted buffer addresses into the DB. Store them into Snp->RecycledTxBuf.
+      //
+      for (Index = 0; Index < MAX_XMIT_BUFFERS; Index++) {
+        if (Db->TxBuffer[Index] != 0) {
+          if (Snp->RecycledTxBufCount == Snp->MaxRecycledTxBuf) {
+            //
+            // Snp->RecycledTxBuf is full, reallocate a new one.
+            //
+            if ((Snp->MaxRecycledTxBuf + SNP_TX_BUFFER_INCREASEMENT) >= SNP_MAX_TX_BUFFER_NUM) {
+              return EFI_DEVICE_ERROR;
+            }
+            Tmp = AllocatePool (sizeof (UINT64) * (Snp->MaxRecycledTxBuf + SNP_TX_BUFFER_INCREASEMENT));
+            if (Tmp == NULL) {
+              return EFI_DEVICE_ERROR;
+            }
+            CopyMem (Tmp, Snp->RecycledTxBuf, sizeof (UINT64) * Snp->RecycledTxBufCount);
+            FreePool (Snp->RecycledTxBuf);
+            Snp->RecycledTxBuf    =  Tmp;
+            Snp->MaxRecycledTxBuf += SNP_TX_BUFFER_INCREASEMENT;
+          }
+          Snp->RecycledTxBuf[Snp->RecycledTxBufCount] = Db->TxBuffer[Index];
+          Snp->RecycledTxBufCount++;
+        }
+      }
+    }
   }
 
   //
@@ -216,7 +241,23 @@ SnpUndi32GetStatus (
     goto ON_EXIT;
   }
 
-  Status = PxeGetStatus (Snp, InterruptStatus, TxBuf);
+  if (Snp->RecycledTxBufCount == 0 && TxBuf != NULL) {
+    Status = PxeGetStatus (Snp, InterruptStatus, TRUE);
+  } else {
+    Status = PxeGetStatus (Snp, InterruptStatus, FALSE);
+  }
+
+  if (TxBuf != NULL) {
+    //
+    // Get a recycled buf from Snp->RecycledTxBuf
+    //
+    if (Snp->RecycledTxBufCount == 0) {
+      *TxBuf = NULL;
+    } else {
+      Snp->RecycledTxBufCount--;
+      *TxBuf = (VOID *) (UINTN) Snp->RecycledTxBuf[Snp->RecycledTxBufCount];
+    }
+  }
 
 ON_EXIT:
   gBS->RestoreTPL (OldTpl);
diff --git a/MdeModulePkg/Universal/Network/SnpDxe/Snp.c b/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
index db5b6267a613..5ff294f8b59b 100644
--- a/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
+++ b/MdeModulePkg/Universal/Network/SnpDxe/Snp.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of driver entry point and driver binding protocol.
 
-Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed
 and made available under the terms and conditions of the BSD License which
 accompanies this distribution. The full text of the license may be found at
@@ -403,6 +403,14 @@ SimpleNetworkDriverStart (
 
   Snp->TxRxBufferSize     = 0;
   Snp->TxRxBuffer         = NULL;
+
+  Snp->RecycledTxBuf = AllocatePool (sizeof (UINT64) * SNP_TX_BUFFER_INCREASEMENT);
+  if (Snp->RecycledTxBuf == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto Error_DeleteSNP;
+  }
+  Snp->MaxRecycledTxBuf    = SNP_TX_BUFFER_INCREASEMENT;
+  Snp->RecycledTxBufCount  = 0;
  
   if (Nii->Revision >= EFI_NETWORK_INTERFACE_IDENTIFIER_PROTOCOL_REVISION) {
     Snp->IfNum = Nii->IfNum;
@@ -678,6 +686,10 @@ SimpleNetworkDriverStart (
 
 Error_DeleteSNP:
 
+  if (Snp->RecycledTxBuf != NULL) {
+    FreePool (Snp->RecycledTxBuf);
+  }
+
   PciIo->FreeBuffer (
            PciIo,
            SNP_MEM_PAGES (sizeof (SNP_DRIVER)),
@@ -790,6 +802,8 @@ SimpleNetworkDriverStop (
   PxeShutdown (Snp);
   PxeStop (Snp);
 
+  FreePool (Snp->RecycledTxBuf);
+
   PciIo = Snp->PciIo;
   PciIo->FreeBuffer (
            PciIo,
diff --git a/MdeModulePkg/Universal/Network/SnpDxe/Snp.h b/MdeModulePkg/Universal/Network/SnpDxe/Snp.h
index f1d0ab36dbcf..67f65ffc422f 100644
--- a/MdeModulePkg/Universal/Network/SnpDxe/Snp.h
+++ b/MdeModulePkg/Universal/Network/SnpDxe/Snp.h
@@ -1,7 +1,7 @@
 /** @file
     Declaration of strctures and functions for SnpDxe driver.
 
-Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed
 and made available under the terms and conditions of the BSD License which
 accompanies this distribution. The full text of the license may be found at
@@ -49,6 +49,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define PCI_BAR_MEM_MODE      0x00000000
 #define PCI_BAR_MEM_64BIT     0x00000004
 
+#define SNP_TX_BUFFER_INCREASEMENT    MAX_XMIT_BUFFERS
+#define SNP_MAX_TX_BUFFER_NUM         65536
+
 typedef
 EFI_STATUS
 (EFIAPI *ISSUE_UNDI32_COMMAND) (
@@ -130,6 +133,19 @@ typedef struct {
   // i.e. PXE_STATFLAGS_GET_STATUS_NO_MEDIA_SUPPORTED
   //
   BOOLEAN                MediaStatusSupported;
+
+  //
+  // Array of the recycled transmit buffer address from UNDI.
+  //
+  UINT64                 *RecycledTxBuf;
+  //
+  // The maximum number of recycled buffer pointers in RecycledTxBuf.
+  //
+  UINT32                 MaxRecycledTxBuf;
+  //
+  // Current number of recycled buffer pointers in RecycledTxBuf.
+  //
+  UINT32                 RecycledTxBufCount;
 } SNP_DRIVER;
 
 #define EFI_SIMPLE_NETWORK_DEV_FROM_THIS(a) CR (a, SNP_DRIVER, Snp, SNP_DRIVER_SIGNATURE)

From 9b0c2eceebbe81300bcc9a0df142ad7c2da1e2f4 Mon Sep 17 00:00:00 2001
From: Fu Siyuan <siyuan.fu@intel.com>
Date: Fri, 8 Jan 2016 02:38:34 +0000
Subject: [PATCH 398/525] MdeModulePkg: Update MNP driver to recycle TX buffer
 asynchronously.

This patch updates the MNP driver to recycle TX buffer asynchronously, instead
of using a while loop wait after each transmit command.

(Sync patch r19624 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>
---
 .../Universal/Network/MnpDxe/MnpConfig.c      | 266 +++++++++++++++---
 .../Universal/Network/MnpDxe/MnpDriver.h      |   7 +-
 .../Universal/Network/MnpDxe/MnpImpl.h        |  54 +++-
 MdeModulePkg/Universal/Network/MnpDxe/MnpIo.c | 127 ++++-----
 .../Universal/Network/MnpDxe/MnpMain.c        |   7 +-
 5 files changed, 348 insertions(+), 113 deletions(-)

diff --git a/MdeModulePkg/Universal/Network/MnpDxe/MnpConfig.c b/MdeModulePkg/Universal/Network/MnpDxe/MnpConfig.c
index 046d4dfddccb..d1a4cb5dd2a3 100644
--- a/MdeModulePkg/Universal/Network/MnpDxe/MnpConfig.c
+++ b/MdeModulePkg/Universal/Network/MnpDxe/MnpConfig.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of Managed Network Protocol private services.
 
-Copyright (c) 2005 - 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2005 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions
 of the BSD License which accompanies this distribution.  The full
@@ -209,6 +209,208 @@ MnpFreeNbuf (
   gBS->RestoreTPL (OldTpl);
 }
 
+/**
+  Add Count of TX buffers to MnpDeviceData->AllTxBufList and MnpDeviceData->FreeTxBufList.
+  The length of the buffer is specified by MnpDeviceData->BufferLength.
+
+  @param[in, out]  MnpDeviceData         Pointer to the MNP_DEVICE_DATA.
+  @param[in]       Count                 Number of TX buffers to add.
+
+  @retval EFI_SUCCESS           The specified amount of TX buffers are allocated.
+  @retval EFI_OUT_OF_RESOURCES  Failed to allocate a TX buffer.
+
+**/
+EFI_STATUS
+MnpAddFreeTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData,
+  IN     UINTN             Count
+  )
+{
+  EFI_STATUS        Status;
+  UINT32            Index;
+  MNP_TX_BUF_WRAP   *TxBufWrap;
+
+  NET_CHECK_SIGNATURE (MnpDeviceData, MNP_DEVICE_DATA_SIGNATURE);
+  ASSERT ((Count > 0) && (MnpDeviceData->BufferLength > 0));
+
+  Status = EFI_SUCCESS;
+  for (Index = 0; Index < Count; Index++) {
+    TxBufWrap = (MNP_TX_BUF_WRAP*) AllocatePool (sizeof (MNP_TX_BUF_WRAP) + MnpDeviceData->BufferLength - 1);
+    if (TxBufWrap == NULL) {
+      DEBUG ((EFI_D_ERROR, "MnpAddFreeTxBuf: TxBuf Alloc failed.\n"));
+
+      Status = EFI_OUT_OF_RESOURCES;
+      break;
+    }
+    DEBUG ((EFI_D_INFO, "MnpAddFreeTxBuf: Add TxBufWrap %p, TxBuf %p\n", TxBufWrap, TxBufWrap->TxBuf));
+    TxBufWrap->Signature = MNP_TX_BUF_WRAP_SIGNATURE;
+    TxBufWrap->InUse     = FALSE;
+    InsertTailList (&MnpDeviceData->FreeTxBufList, &TxBufWrap->WrapEntry);
+    InsertTailList (&MnpDeviceData->AllTxBufList, &TxBufWrap->AllEntry);
+  }
+
+  MnpDeviceData->TxBufCount += Index;
+  return Status;
+}
+
+/**
+  Allocate a free TX buffer from MnpDeviceData->FreeTxBufList. If there is none
+  in the queue, first try to recycle some from SNP, then try to allocate some and add 
+  them into the queue, then fetch the NET_BUF from the updated FreeTxBufList.
+
+  @param[in, out]  MnpDeviceData        Pointer to the MNP_DEVICE_DATA.
+
+  @return     Pointer to the allocated free NET_BUF structure, if NULL the
+              operation is failed.
+
+**/
+UINT8 *
+MnpAllocTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData
+  )
+{
+  EFI_TPL           OldTpl;
+  UINT8             *TxBuf;
+  EFI_STATUS        Status;
+  LIST_ENTRY        *Entry;
+  MNP_TX_BUF_WRAP   *TxBufWrap;
+  
+  NET_CHECK_SIGNATURE (MnpDeviceData, MNP_DEVICE_DATA_SIGNATURE);
+
+  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+
+  if (IsListEmpty (&MnpDeviceData->FreeTxBufList)) {
+    //
+    // First try to recycle some TX buffer from SNP
+    //
+    Status = MnpRecycleTxBuf (MnpDeviceData);
+    if (EFI_ERROR (Status)) {
+      TxBuf = NULL;
+      goto ON_EXIT;
+    }
+
+    //
+    // If still no free TX buffer, allocate more.
+    //
+    if (IsListEmpty (&MnpDeviceData->FreeTxBufList)) {
+      if ((MnpDeviceData->TxBufCount + MNP_TX_BUFFER_INCREASEMENT) > MNP_MAX_TX_BUFFER_NUM) {
+        DEBUG (
+          (EFI_D_ERROR,
+          "MnpAllocTxBuf: The maximum TxBuf size is reached for MNP driver instance %p.\n",
+          MnpDeviceData)
+          );
+
+        TxBuf = NULL;
+        goto ON_EXIT;
+      }
+
+      Status = MnpAddFreeTxBuf (MnpDeviceData, MNP_TX_BUFFER_INCREASEMENT);
+      if (IsListEmpty (&MnpDeviceData->FreeTxBufList)) {
+        DEBUG (
+          (EFI_D_ERROR,
+          "MnpAllocNbuf: Failed to add TxBuf into the FreeTxBufList, %r.\n",
+          Status)
+          );
+
+        TxBuf = NULL;
+        goto ON_EXIT;
+      }
+    }
+  }
+
+  ASSERT (!IsListEmpty (&MnpDeviceData->FreeTxBufList));
+  Entry = MnpDeviceData->FreeTxBufList.ForwardLink;
+  RemoveEntryList (MnpDeviceData->FreeTxBufList.ForwardLink);
+  TxBufWrap = NET_LIST_USER_STRUCT_S (Entry, MNP_TX_BUF_WRAP, WrapEntry, MNP_TX_BUF_WRAP_SIGNATURE);
+  TxBufWrap->InUse = TRUE;
+  TxBuf = TxBufWrap->TxBuf;
+
+ON_EXIT:
+  gBS->RestoreTPL (OldTpl);
+
+  return TxBuf;
+}
+
+/**
+  Try to reclaim the TX buffer into the buffer pool.
+
+  @param[in, out]  MnpDeviceData         Pointer to the mnp device context data.
+  @param[in, out]  TxBuf                 Pointer to the TX buffer to free.
+
+**/
+VOID
+MnpFreeTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData,
+  IN OUT UINT8             *TxBuf
+  )
+{
+  MNP_TX_BUF_WRAP   *TxBufWrap;
+  EFI_TPL           OldTpl;
+
+  NET_CHECK_SIGNATURE (MnpDeviceData, MNP_DEVICE_DATA_SIGNATURE);
+
+  if (TxBuf == NULL) {
+    return;
+  }
+
+  TxBufWrap = NET_LIST_USER_STRUCT (TxBuf, MNP_TX_BUF_WRAP, TxBuf);
+  if (TxBufWrap->Signature != MNP_TX_BUF_WRAP_SIGNATURE) {
+    DEBUG (
+      (EFI_D_ERROR,
+      "MnpFreeTxBuf: Signature check failed in MnpFreeTxBuf.\n")
+      );
+    return;
+  }
+
+  if (!TxBufWrap->InUse) {
+    DEBUG (
+      (EFI_D_WARN,
+      "MnpFreeTxBuf: Duplicated recycle report from SNP.\n")
+      );
+    return;
+  }
+  
+  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
+  InsertTailList (&MnpDeviceData->FreeTxBufList, &TxBufWrap->WrapEntry);
+  TxBufWrap->InUse = FALSE;
+  gBS->RestoreTPL (OldTpl);
+}
+
+/**
+  Try to recycle all the transmitted buffer address from SNP.
+
+  @param[in, out]  MnpDeviceData     Pointer to the mnp device context data.
+
+  @retval EFI_SUCCESS             Successed to recyclethe transmitted buffer address.
+  @retval Others                  Failed to recyclethe transmitted buffer address.
+
+**/
+EFI_STATUS
+MnpRecycleTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData
+  )
+{
+  UINT8                         *TxBuf;
+  EFI_SIMPLE_NETWORK_PROTOCOL   *Snp;
+  EFI_STATUS                    Status;
+
+  Snp = MnpDeviceData->Snp;
+  ASSERT (Snp != NULL);
+
+  do {
+    TxBuf = NULL;
+    Status = Snp->GetStatus (Snp, NULL, (VOID **) &TxBuf);
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+
+    if (TxBuf != NULL) {
+      MnpFreeTxBuf (MnpDeviceData, TxBuf);
+    }
+  } while (TxBuf != NULL);
+
+  return EFI_SUCCESS;
+}
 
 /**
   Initialize the mnp device context data.
@@ -314,13 +516,9 @@ MnpInitializeDeviceData (
   //
   // Allocate buffer pool for tx.
   //
-  MnpDeviceData->TxBuf = AllocatePool (MnpDeviceData->BufferLength);
-  if (MnpDeviceData->TxBuf == NULL) {
-    DEBUG ((EFI_D_ERROR, "MnpInitializeDeviceData: AllocatePool failed.\n"));
-
-    Status = EFI_OUT_OF_RESOURCES;
-    goto ERROR;
-  }
+  InitializeListHead (&MnpDeviceData->FreeTxBufList);
+  InitializeListHead (&MnpDeviceData->AllTxBufList);
+  MnpDeviceData->TxBufCount = 0;
 
   //
   // Create the system poll timer.
@@ -370,20 +568,6 @@ MnpInitializeDeviceData (
     goto ERROR;
   }
 
-  //
-  // Create the timer for tx timeout check.
-  //
-  Status = gBS->CreateEvent (
-                  EVT_TIMER,
-                  TPL_CALLBACK,
-                  NULL,
-                  NULL,
-                  &MnpDeviceData->TxTimeoutEvent
-                  );
-  if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_ERROR, "MnpInitializeDeviceData: CreateEvent for tx timeout event failed.\n"));
-  }
-
 ERROR:
   if (EFI_ERROR (Status)) {
     //
@@ -405,10 +589,6 @@ MnpInitializeDeviceData (
       gBS->CloseEvent (MnpDeviceData->PollTimer);
     }
 
-    if (MnpDeviceData->TxBuf != NULL) {
-      FreePool (MnpDeviceData->TxBuf);
-    }
-
     if (MnpDeviceData->RxNbufCache != NULL) {
       MnpFreeNbuf (MnpDeviceData, MnpDeviceData->RxNbufCache);
     }
@@ -445,6 +625,10 @@ MnpDestroyDeviceData (
   IN     EFI_HANDLE        ImageHandle
   )
 {
+  LIST_ENTRY         *Entry;
+  LIST_ENTRY         *NextEntry;
+  MNP_TX_BUF_WRAP    *TxBufWrap;
+
   NET_CHECK_SIGNATURE (MnpDeviceData, MNP_DEVICE_DATA_SIGNATURE);
 
   //
@@ -462,15 +646,21 @@ MnpDestroyDeviceData (
   //
   // Close the event.
   //
-  gBS->CloseEvent (MnpDeviceData->TxTimeoutEvent);
   gBS->CloseEvent (MnpDeviceData->TimeoutCheckTimer);
   gBS->CloseEvent (MnpDeviceData->MediaDetectTimer);
   gBS->CloseEvent (MnpDeviceData->PollTimer);
 
   //
-  // Free the tx buffer.
+  // Free the Tx buffer pool.
   //
-  FreePool (MnpDeviceData->TxBuf);
+  NET_LIST_FOR_EACH_SAFE(Entry, NextEntry, &MnpDeviceData->AllTxBufList) {
+    TxBufWrap = NET_LIST_USER_STRUCT (Entry, MNP_TX_BUF_WRAP, AllEntry);
+    RemoveEntryList (Entry);
+    FreePool (TxBufWrap);
+    MnpDeviceData->TxBufCount--;
+  }
+  ASSERT (IsListEmpty (&MnpDeviceData->AllTxBufList));
+  ASSERT (MnpDeviceData->TxBufCount == 0);
 
   //
   // Free the RxNbufCache.
@@ -957,7 +1147,7 @@ MnpStartSnp (
 /**
   Stop the simple network.
 
-  @param[in]  Snp               Pointer to the simple network protocol.
+  @param[in]  MnpDeviceData     Pointer to the MNP_DEVICE_DATA.
 
   @retval EFI_SUCCESS           The simple network is stopped.
   @retval Others                Other errors as indicated.
@@ -965,13 +1155,23 @@ MnpStartSnp (
 **/
 EFI_STATUS
 MnpStopSnp (
-  IN EFI_SIMPLE_NETWORK_PROTOCOL     *Snp
+  IN  MNP_DEVICE_DATA   *MnpDeviceData
   )
 {
   EFI_STATUS  Status;
-
+  EFI_SIMPLE_NETWORK_PROTOCOL     *Snp;
+  
+  Snp = MnpDeviceData->Snp;
   ASSERT (Snp != NULL);
 
+  //
+  // Recycle all the transmit buffer from SNP.
+  //
+  Status = MnpRecycleTxBuf (MnpDeviceData);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
   //
   // Shut down the simple network.
   //
@@ -1162,7 +1362,7 @@ MnpStop (
   //
   // Stop the simple network.
   //
-  Status = MnpStopSnp (MnpDeviceData->Snp);
+  Status = MnpStopSnp (MnpDeviceData);
   return Status;
 }
 
diff --git a/MdeModulePkg/Universal/Network/MnpDxe/MnpDriver.h b/MdeModulePkg/Universal/Network/MnpDxe/MnpDriver.h
index 35a9b710dbfa..126d9682001c 100644
--- a/MdeModulePkg/Universal/Network/MnpDxe/MnpDriver.h
+++ b/MdeModulePkg/Universal/Network/MnpDxe/MnpDriver.h
@@ -1,7 +1,7 @@
 /** @file
   Declaration of strctures and functions for MnpDxe driver.
 
-Copyright (c) 2005 - 2012, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2005 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions
 of the BSD License which accompanies this distribution.  The full
@@ -67,7 +67,9 @@ typedef struct {
   LIST_ENTRY                    GroupAddressList;
   UINT32                        GroupAddressCount;
 
-  EFI_EVENT                     TxTimeoutEvent;
+  LIST_ENTRY                    FreeTxBufList;
+  LIST_ENTRY                    AllTxBufList;
+  UINT32                        TxBufCount;
 
   NET_BUF_QUEUE                 FreeNbufQue;
   INTN                          NbufCnt;
@@ -90,7 +92,6 @@ typedef struct {
   UINT32                        BufferLength;
   UINT32                        PaddingSize;
   NET_BUF                       *RxNbufCache;
-  UINT8                         *TxBuf;
 } MNP_DEVICE_DATA;
 
 #define MNP_DEVICE_DATA_FROM_THIS(a) \
diff --git a/MdeModulePkg/Universal/Network/MnpDxe/MnpImpl.h b/MdeModulePkg/Universal/Network/MnpDxe/MnpImpl.h
index f94e2083065a..c66be6487b82 100644
--- a/MdeModulePkg/Universal/Network/MnpDxe/MnpImpl.h
+++ b/MdeModulePkg/Universal/Network/MnpDxe/MnpImpl.h
@@ -1,7 +1,7 @@
 /** @file
   Declaration of structures and functions of MnpDxe driver.
 
-Copyright (c) 2005 - 2010, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2005 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions
 of the BSD License which accompanies this distribution.  The full
@@ -27,6 +27,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define MNP_INIT_NET_BUFFER_NUM       512
 #define MNP_NET_BUFFER_INCREASEMENT   64
 #define MNP_MAX_NET_BUFFER_NUM        65536
+#define MNP_TX_BUFFER_INCREASEMENT    64
+#define MNP_MAX_TX_BUFFER_NUM         65536
 
 #define MNP_MAX_RCVD_PACKET_QUE_SIZE  256
 
@@ -92,6 +94,15 @@ typedef struct {
   UINT64                            TimeoutTick;
 } MNP_RXDATA_WRAP;
 
+#define MNP_TX_BUF_WRAP_SIGNATURE   SIGNATURE_32 ('M', 'T', 'B', 'W')
+
+typedef struct {
+  UINT32                  Signature;
+  LIST_ENTRY              WrapEntry;  // Link to FreeTxBufList
+  LIST_ENTRY              AllEntry;   // Link to AllTxBufList
+  BOOLEAN                 InUse;
+  UINT8                   TxBuf[1];
+} MNP_TX_BUF_WRAP;
 
 /**
   Initialize the mnp device context data.
@@ -342,8 +353,11 @@ MnpIsValidTxToken (
   @param[out]  PktLen              Pointer to a UINT32 variable used to record the packet's
                                    length.
 
+  @retval EFI_SUCCESS           TxPackage is built.
+  @retval EFI_OUT_OF_RESOURCES  The deliver fails due to lack of memory resource.
+
 **/
-VOID
+EFI_STATUS
 MnpBuildTxPacket (
   IN     MNP_SERVICE_DATA                    *MnpServiceData,
   IN     EFI_MANAGED_NETWORK_TRANSMIT_DATA   *TxData,
@@ -352,7 +366,11 @@ MnpBuildTxPacket (
   );
 
 /**
-  Synchronously send out the packet.
+  Synchronously send out the packet. 
+
+  This functon places the packet buffer to SNP driver's tansmit queue. The packet
+  can be considered successfully sent out once SNP acccetp the packet, while the
+  packet buffer recycle is deferred for better performance.
 
   @param[in]       MnpServiceData      Pointer to the mnp service context data.
   @param[in]       Packet              Pointer to the pakcet buffer.
@@ -448,6 +466,36 @@ MnpFreeNbuf (
   IN OUT NET_BUF           *Nbuf
   );
 
+/**
+  Allocate a free TX buffer from MnpDeviceData->FreeTxBufList. If there is none
+  in the queue, first try to recycle some from SNP, then try to allocate some and add 
+  them into the queue, then fetch the NET_BUF from the updated FreeTxBufList.
+
+  @param[in, out]  MnpDeviceData        Pointer to the MNP_DEVICE_DATA.
+
+  @return     Pointer to the allocated free NET_BUF structure, if NULL the
+              operation is failed.
+
+**/
+UINT8 *
+MnpAllocTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData
+  );
+
+/**
+  Try to recycle all the transmitted buffer address from SNP.
+
+  @param[in, out]  MnpDeviceData     Pointer to the mnp device context data.
+
+  @retval EFI_SUCCESS             Successed to recyclethe transmitted buffer address.
+  @retval Others                  Failed to recyclethe transmitted buffer address.
+
+**/
+EFI_STATUS
+MnpRecycleTxBuf (
+  IN OUT MNP_DEVICE_DATA   *MnpDeviceData
+  );
+
 /**
   Remove the received packets if timeout occurs.
 
diff --git a/MdeModulePkg/Universal/Network/MnpDxe/MnpIo.c b/MdeModulePkg/Universal/Network/MnpDxe/MnpIo.c
index 7f03b848ef39..1cbfc30e5c21 100644
--- a/MdeModulePkg/Universal/Network/MnpDxe/MnpIo.c
+++ b/MdeModulePkg/Universal/Network/MnpDxe/MnpIo.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of Managed Network Protocol I/O functions.
 
-Copyright (c) 2005 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2005 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions
 of the BSD License which accompanies this distribution.  The full
@@ -102,7 +102,6 @@ MnpIsValidTxToken (
   return TRUE;
 }
 
-
 /**
   Build the packet to transmit from the TxData passed in.
 
@@ -113,8 +112,11 @@ MnpIsValidTxToken (
   @param[out]  PktLen              Pointer to a UINT32 variable used to record the packet's
                                    length.
 
+  @retval EFI_SUCCESS           TxPackage is built.
+  @retval EFI_OUT_OF_RESOURCES  The deliver fails due to lack of memory resource.
+
 **/
-VOID
+EFI_STATUS
 MnpBuildTxPacket (
   IN     MNP_SERVICE_DATA                    *MnpServiceData,
   IN     EFI_MANAGED_NETWORK_TRANSMIT_DATA   *TxData,
@@ -125,14 +127,24 @@ MnpBuildTxPacket (
   EFI_SIMPLE_NETWORK_MODE *SnpMode;
   UINT8                   *DstPos;
   UINT16                  Index;
-  MNP_DEVICE_DATA         *MnpDerviceData;
-
-  MnpDerviceData = MnpServiceData->MnpDeviceData;
-
+  MNP_DEVICE_DATA         *MnpDeviceData;
+  UINT8                   *TxBuf;
+  
+  MnpDeviceData = MnpServiceData->MnpDeviceData;
+  
+  TxBuf = MnpAllocTxBuf (MnpDeviceData);
+  if (TxBuf == NULL) {
+    return EFI_OUT_OF_RESOURCES;
+  }
+  
   //
-  // Reserve space for vlan tag.
+  // Reserve space for vlan tag if needed.
   //
-  *PktBuf = MnpDerviceData->TxBuf + NET_VLAN_TAG_LEN;
+  if (MnpServiceData->VlanId != 0) {
+    *PktBuf = TxBuf + NET_VLAN_TAG_LEN;
+  } else {
+    *PktBuf = TxBuf;
+  }
   
   if ((TxData->DestinationAddress == NULL) && (TxData->FragmentCount == 1)) {
     CopyMem (
@@ -148,7 +160,7 @@ MnpBuildTxPacket (
     // one fragment, copy the data into the packet buffer. Reserve the
     // media header space if necessary.
     //
-    SnpMode = MnpDerviceData->Snp->Mode; 
+    SnpMode = MnpDeviceData->Snp->Mode; 
     DstPos  = *PktBuf;
     *PktLen = 0;
     if (TxData->DestinationAddress != NULL) {
@@ -177,11 +189,17 @@ MnpBuildTxPacket (
     //
     *PktLen += TxData->DataLength + TxData->HeaderLength;
   }
+
+  return EFI_SUCCESS;
 }
 
 
 /**
-  Synchronously send out the packet.
+  Synchronously send out the packet. 
+
+  This functon places the packet buffer to SNP driver's tansmit queue. The packet
+  can be considered successfully sent out once SNP acccetp the packet, while the
+  packet buffer recycle is deferred for better performance.
 
   @param[in]       MnpServiceData      Pointer to the mnp service context data.
   @param[in]       Packet              Pointer to the pakcet buffer.
@@ -205,14 +223,13 @@ MnpSyncSendPacket (
   EFI_SIMPLE_NETWORK_PROTOCOL       *Snp;
   EFI_MANAGED_NETWORK_TRANSMIT_DATA *TxData;
   UINT32                            HeaderSize;
-  UINT8                             *TxBuf;
   MNP_DEVICE_DATA                   *MnpDeviceData;
   UINT16                            ProtocolType;
 
   MnpDeviceData = MnpServiceData->MnpDeviceData;
   Snp           = MnpDeviceData->Snp;
   TxData        = Token->Packet.TxData;
-
+  Token->Status = EFI_SUCCESS;
   HeaderSize    = Snp->Mode->MediaHeaderSize - TxData->HeaderLength;
 
   //
@@ -224,19 +241,7 @@ MnpSyncSendPacket (
     // Media not present, skip packet transmit and report EFI_NO_MEDIA
     //
     DEBUG ((EFI_D_WARN, "MnpSyncSendPacket: No network cable detected.\n"));
-    Status = EFI_NO_MEDIA;
-    goto SIGNAL_TOKEN;
-  }
-
-  //
-  // Start the timeout event.
-  //
-  Status = gBS->SetTimer (
-                  MnpDeviceData->TxTimeoutEvent,
-                  TimerRelative,
-                  MNP_TX_TIMEOUT_TIME
-                  );
-  if (EFI_ERROR (Status)) {
+    Token->Status = EFI_NO_MEDIA;
     goto SIGNAL_TOKEN;
   }
 
@@ -250,10 +255,25 @@ MnpSyncSendPacket (
     ProtocolType = TxData->ProtocolType;
   }
 
-  for (;;) {
-    //
-    // Transmit the packet through SNP.
-    //
+  //
+  // Transmit the packet through SNP.
+  //
+  Status = Snp->Transmit (
+                  Snp,
+                  HeaderSize,
+                  Length,
+                  Packet,
+                  TxData->SourceAddress,
+                  TxData->DestinationAddress,
+                  &ProtocolType
+                  );
+  if (Status == EFI_NOT_READY) {
+    Status = MnpRecycleTxBuf (MnpDeviceData);
+    if (EFI_ERROR (Status)) {
+      Token->Status = EFI_DEVICE_ERROR;
+      goto SIGNAL_TOKEN;
+    }
+
     Status = Snp->Transmit (
                     Snp,
                     HeaderSize,
@@ -262,52 +282,15 @@ MnpSyncSendPacket (
                     TxData->SourceAddress,
                     TxData->DestinationAddress,
                     &ProtocolType
-                    );
-    if ((Status != EFI_SUCCESS) && (Status != EFI_NOT_READY)) {
-      Status = EFI_DEVICE_ERROR;
-      break;
-    }
-
-    //
-    // If Status is EFI_SUCCESS, the packet is put in the transmit queue.
-    // if Status is EFI_NOT_READY, the transmit engine of the network interface is busy.
-    // Both need to sync SNP.
-    //
-    TxBuf = NULL;
-    do {
-      //
-      // Get the recycled transmit buffer status.
-      //
-      Snp->GetStatus (Snp, NULL, (VOID **) &TxBuf);
-
-      if (!EFI_ERROR (gBS->CheckEvent (MnpDeviceData->TxTimeoutEvent))) {
-        Status = EFI_TIMEOUT;
-        break;
-      }
-    } while (TxBuf == NULL);
-
-    if ((Status == EFI_SUCCESS) || (Status == EFI_TIMEOUT)) {
-      break;
-    } else {
-      //
-      // Status is EFI_NOT_READY. Restart the timer event and call Snp->Transmit again.
-      //
-      gBS->SetTimer (
-            MnpDeviceData->TxTimeoutEvent,
-            TimerRelative,
-            MNP_TX_TIMEOUT_TIME
-            );
-    }
+                    ); 
+  }
+  
+  if (EFI_ERROR (Status)) {
+    Token->Status = EFI_DEVICE_ERROR;
   }
-
-  //
-  // Cancel the timer event.
-  //
-  gBS->SetTimer (MnpDeviceData->TxTimeoutEvent, TimerCancel, 0);
 
 SIGNAL_TOKEN:
 
-  Token->Status = Status;
   gBS->SignalEvent (Token->Event);
 
   //
diff --git a/MdeModulePkg/Universal/Network/MnpDxe/MnpMain.c b/MdeModulePkg/Universal/Network/MnpDxe/MnpMain.c
index 4c0f3ddd9a99..31c2e3e5b849 100644
--- a/MdeModulePkg/Universal/Network/MnpDxe/MnpMain.c
+++ b/MdeModulePkg/Universal/Network/MnpDxe/MnpMain.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of Managed Network Protocol public services.
 
-Copyright (c) 2005 - 2010, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2005 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions
 of the BSD License which accompanies this distribution.  The full
@@ -552,7 +552,10 @@ MnpTransmit (
   //
   // Build the tx packet
   //
-  MnpBuildTxPacket (MnpServiceData, Token->Packet.TxData, &PktBuf, &PktLen);
+  Status = MnpBuildTxPacket (MnpServiceData, Token->Packet.TxData, &PktBuf, &PktLen);
+  if (EFI_ERROR (Status)) {
+    goto ON_EXIT;
+  }
 
   //
   //  OK, send the packet synchronously.

From 8e0c04fcf60a56b78da4291efceba665b59e4039 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 11 Jan 2016 05:15:18 +0000
Subject: [PATCH 399/525] SecurityPkg: Add Tpm2Startup return code check.

Tpm2Startup does not check TPM device return code.
It might cause problem, that error is not detected
in Tcg2Peim, for example, S3 resume case.

(Sync patch r19634 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
---
 .../Library/Tpm2CommandLib/Tpm2Startup.c      | 29 ++++++++++++++++---
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Startup.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Startup.c
index e8af4033ce81..f67043b84b9d 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Startup.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Startup.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 Startup related command.
 
-Copyright (c) 2013, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -59,6 +59,7 @@ Tpm2Startup (
   TPM2_STARTUP_COMMAND              Cmd;
   TPM2_STARTUP_RESPONSE             Res;
   UINT32                            ResultBufSize;
+  TPM_RC                            ResponseCode;
 
   Cmd.Header.tag         = SwapBytes16(TPM_ST_NO_SESSIONS);
   Cmd.Header.paramSize   = SwapBytes32(sizeof(Cmd));
@@ -67,8 +68,20 @@ Tpm2Startup (
 
   ResultBufSize = sizeof(Res);
   Status = Tpm2SubmitCommand (sizeof(Cmd), (UINT8 *)&Cmd, &ResultBufSize, (UINT8 *)&Res);
-
-  return Status;
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
+
+  ResponseCode = SwapBytes32(Res.Header.responseCode);
+  switch (ResponseCode)  {
+  case TPM_RC_SUCCESS:
+  case TPM_RC_INITIALIZE:
+    // TPM_RC_INITIALIZE can be returned if Tpm2Startup is not required.
+    return EFI_SUCCESS;
+  default:
+    DEBUG ((EFI_D_ERROR, "Tpm2Startup: Response Code error! 0x%08x\r\n", ResponseCode));
+    return EFI_DEVICE_ERROR;
+  }
 }
 
 /**
@@ -97,6 +110,14 @@ Tpm2Shutdown (
 
   ResultBufSize = sizeof(Res);
   Status = Tpm2SubmitCommand (sizeof(Cmd), (UINT8 *)&Cmd, &ResultBufSize, (UINT8 *)&Res);
+  if (EFI_ERROR(Status)) {
+    return Status;
+  }
+
+  if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
+    DEBUG ((EFI_D_ERROR, "Tpm2Shutdown: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
+    return EFI_DEVICE_ERROR;
+  }
 
-  return Status;
+  return EFI_SUCCESS;
 }

From 2eec0dd2b3f4ccbf4b32c9739d42f22c87caa9f4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 11 Jan 2016 05:18:32 +0000
Subject: [PATCH 400/525] SecurityPkg: Clear AuthSession content after use.

Some commands in Tpm2CommandLib accept AuthSession
as input parameter and copy to local command buffer.
After use, this AuthSession content should be zeroed,
because there might be some secrete there.

(Sync patch r19635 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
---
 .../Tpm2CommandLib/Tpm2DictionaryAttack.c     |  34 ++-
 .../Tpm2EnhancedAuthorization.c               |  18 +-
 .../Library/Tpm2CommandLib/Tpm2Hierarchy.c    | 138 ++++++++---
 .../Library/Tpm2CommandLib/Tpm2Integrity.c    |  22 +-
 .../Tpm2CommandLib/Tpm2Miscellaneous.c        |  18 +-
 .../Library/Tpm2CommandLib/Tpm2NVStorage.c    | 225 +++++++++++++-----
 6 files changed, 333 insertions(+), 122 deletions(-)

diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2DictionaryAttack.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2DictionaryAttack.c
index 2f6488fb97f6..3198b8a4b895 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2DictionaryAttack.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2DictionaryAttack.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 DictionaryAttack related command.
 
-Copyright (c) 2013, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -104,19 +104,27 @@ Tpm2DictionaryAttackLockReset (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2DictionaryAttackLockReset - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   if (SwapBytes32(RecvBuffer.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Tpm2DictionaryAttackLockReset - responseCode - %x\n", SwapBytes32(RecvBuffer.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -187,17 +195,25 @@ Tpm2DictionaryAttackParameters (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2DictionaryAttackParameters - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   if (SwapBytes32(RecvBuffer.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Tpm2DictionaryAttackParameters - responseCode - %x\n", SwapBytes32(RecvBuffer.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBufferSize, sizeof(SendBufferSize));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2EnhancedAuthorization.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2EnhancedAuthorization.c
index d11f54346329..6f6b3693f861 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2EnhancedAuthorization.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2EnhancedAuthorization.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 EnhancedAuthorization related command.
 
-Copyright (c) 2014, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -161,16 +161,18 @@ Tpm2PolicySecret (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2PolicySecret - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   if (SwapBytes32(RecvBuffer.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Tpm2PolicySecret - responseCode - %x\n", SwapBytes32(RecvBuffer.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   //
@@ -189,7 +191,13 @@ Tpm2PolicySecret (
   Buffer += sizeof(UINT16);
   CopyMem (PolicyTicket->digest.buffer, Buffer, PolicyTicket->digest.size);
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Hierarchy.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Hierarchy.c
index 11f122943467..9bfbdad394c0 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Hierarchy.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Hierarchy.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 Hierarchy related command.
 
-Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -186,19 +186,27 @@ Tpm2SetPrimaryPolicy (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2SetPrimaryPolicy - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   if (SwapBytes32(RecvBuffer.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Tpm2SetPrimaryPolicy - responseCode - %x\n", SwapBytes32(RecvBuffer.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -246,12 +254,13 @@ Tpm2Clear (
   ResultBufSize = sizeof(Res);
   Status = Tpm2SubmitCommand (CmdSize, (UINT8 *)&Cmd, &ResultBufSize, (UINT8 *)&Res);
   if (EFI_ERROR(Status)) {
-    return Status;
+    goto Done;
   }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "Clear: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -260,7 +269,8 @@ Tpm2Clear (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "Clear: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -268,7 +278,8 @@ Tpm2Clear (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Clear: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   //
@@ -276,8 +287,13 @@ Tpm2Clear (
   //
 
   // None
-
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
 
 /**
@@ -332,12 +348,13 @@ Tpm2ClearControl (
   ResultBufSize = sizeof(Res);
   Status = Tpm2SubmitCommand (CmdSize, (UINT8 *)&Cmd, &ResultBufSize, (UINT8 *)&Res);
   if (EFI_ERROR(Status)) {
-    return Status;
+    goto Done;
   }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ClearControl: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -346,7 +363,8 @@ Tpm2ClearControl (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ClearControl: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -354,7 +372,8 @@ Tpm2ClearControl (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "ClearControl: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   //
@@ -362,8 +381,13 @@ Tpm2ClearControl (
   //
 
   // None
-
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
 
 /**
@@ -436,10 +460,14 @@ Tpm2HierarchyChangeAuth (
              &ResultBufSize,
              ResultBuf
              );
+  if (EFI_ERROR(Status)) {
+    goto Done;
+  }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "HierarchyChangeAuth: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -448,7 +476,8 @@ Tpm2HierarchyChangeAuth (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "HierarchyChangeAuth: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -456,10 +485,17 @@ Tpm2HierarchyChangeAuth (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG((EFI_D_ERROR,"HierarchyChangeAuth: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
 
 /**
@@ -522,10 +558,14 @@ Tpm2ChangeEPS (
              &ResultBufSize,
              ResultBuf
              );
+  if (EFI_ERROR(Status)) {
+    goto Done;
+  }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ChangeEPS: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -534,7 +574,8 @@ Tpm2ChangeEPS (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ChangeEPS: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -542,10 +583,17 @@ Tpm2ChangeEPS (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG((EFI_D_ERROR,"ChangeEPS: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
 
 /**
@@ -608,10 +656,14 @@ Tpm2ChangePPS (
              &ResultBufSize,
              ResultBuf
              );
+  if (EFI_ERROR(Status)) {
+    goto Done;
+  }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ChangePPS: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -620,7 +672,8 @@ Tpm2ChangePPS (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "ChangePPS: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -628,10 +681,17 @@ Tpm2ChangePPS (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG((EFI_D_ERROR,"ChangePPS: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
 
 /**
@@ -704,10 +764,14 @@ Tpm2HierarchyControl (
              &ResultBufSize,
              ResultBuf
              );
+  if (EFI_ERROR(Status)) {
+    goto Done;
+  }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "HierarchyControl: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -716,7 +780,8 @@ Tpm2HierarchyControl (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "HierarchyControl: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -724,8 +789,15 @@ Tpm2HierarchyControl (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG((EFI_D_ERROR,"HierarchyControl: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Integrity.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Integrity.c
index cfb27ecd6b74..fa4318dd5fba 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Integrity.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Integrity.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 Integrity related command.
 
-Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -490,10 +490,14 @@ Tpm2PcrAllocate (
              &ResultBufSize,
              ResultBuf
              );
+  if (EFI_ERROR(Status)) {
+    goto Done;
+  }
 
   if (ResultBufSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "Tpm2PcrAllocate: Failed ExecuteCommand: Buffer Too Small\r\n"));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -502,7 +506,8 @@ Tpm2PcrAllocate (
   RespSize = SwapBytes32(Res.Header.paramSize);
   if (RespSize > sizeof(Res)) {
     DEBUG ((EFI_D_ERROR, "Tpm2PcrAllocate: Response size too large! %d\r\n", RespSize));
-    return EFI_BUFFER_TOO_SMALL;
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Done;
   }
 
   //
@@ -510,7 +515,8 @@ Tpm2PcrAllocate (
   //
   if (SwapBytes32(Res.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG((EFI_D_ERROR,"Tpm2PcrAllocate: Response Code error! 0x%08x\r\n", SwapBytes32(Res.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   //
@@ -521,5 +527,11 @@ Tpm2PcrAllocate (
   *SizeNeeded = SwapBytes32(Res.SizeNeeded);
   *SizeAvailable = SwapBytes32(Res.SizeAvailable);
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&Cmd, sizeof(Cmd));
+  ZeroMem (&Res, sizeof(Res));
+  return Status;
 }
diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Miscellaneous.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Miscellaneous.c
index 914ad7f70bef..5bd870fb9eb4 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2Miscellaneous.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2Miscellaneous.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 Miscellanenous related command.
 
-Copyright (c) 2013, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -98,17 +98,25 @@ Tpm2SetAlgorithmSet (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2SetAlgorithmSet - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   if (SwapBytes32(RecvBuffer.Header.responseCode) != TPM_RC_SUCCESS) {
     DEBUG ((EFI_D_ERROR, "Tpm2SetAlgorithmSet - responseCode - %x\n", SwapBytes32(RecvBuffer.Header.responseCode)));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
index c4714d3e1933..5fe48e180463 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
@@ -1,7 +1,7 @@
 /** @file
   Implement TPM2 NVStorage related command.
 
-Copyright (c) 2013, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -347,12 +347,13 @@ Tpm2NvDefineSpace (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvDefineSpace - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
@@ -365,24 +366,37 @@ Tpm2NvDefineSpace (
     break;
   case TPM_RC_SIZE + RC_NV_DefineSpace_publicInfo:
   case TPM_RC_SIZE + RC_NV_DefineSpace_auth:
-    return EFI_BAD_BUFFER_SIZE;
+    Status = EFI_BAD_BUFFER_SIZE;
+    break;
   case TPM_RC_ATTRIBUTES:
   case TPM_RC_ATTRIBUTES + RC_NV_DefineSpace_publicInfo:
-    return EFI_UNSUPPORTED;
+    Status = EFI_UNSUPPORTED;
+    break;
   case TPM_RC_ATTRIBUTES + RC_NV_DefineSpace_authHandle:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_NV_DEFINED:
-    return EFI_ALREADY_STARTED;
+    Status = EFI_ALREADY_STARTED;
+    break;
   case TPM_RC_VALUE + RC_NV_DefineSpace_publicInfo:
   case TPM_RC_VALUE + RC_NV_DefineSpace_authHandle:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_NV_SPACE:
-    return EFI_OUT_OF_RESOURCES;
+    Status = EFI_OUT_OF_RESOURCES;
+    break;
   default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
-  
-  return EFI_SUCCESS;
+
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -441,12 +455,13 @@ Tpm2NvUndefineSpace (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvUndefineSpace - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
@@ -459,21 +474,33 @@ Tpm2NvUndefineSpace (
     break;
   case TPM_RC_ATTRIBUTES:
   case TPM_RC_ATTRIBUTES + RC_NV_UndefineSpace_nvIndex:
-    return EFI_UNSUPPORTED;
+    Status = EFI_UNSUPPORTED;
+    break;
   case TPM_RC_NV_AUTHORIZATION:
-    return EFI_SECURITY_VIOLATION;
+    Status = EFI_SECURITY_VIOLATION;
+    break;
   case TPM_RC_HANDLE + RC_NV_UndefineSpace_nvIndex: // TPM_RC_NV_DEFINED:
-    return EFI_NOT_FOUND;
+    Status = EFI_NOT_FOUND;
+    break;
   case TPM_RC_HANDLE + RC_NV_UndefineSpace_authHandle: // TPM_RC_NV_DEFINED:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_VALUE + RC_NV_UndefineSpace_authHandle:
   case TPM_RC_VALUE + RC_NV_UndefineSpace_nvIndex:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -543,12 +570,13 @@ Tpm2NvRead (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvRead - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
   if (ResponseCode != TPM_RC_SUCCESS) {
@@ -559,30 +587,45 @@ Tpm2NvRead (
     // return data
     break;
   case TPM_RC_NV_AUTHORIZATION:
-    return EFI_SECURITY_VIOLATION;
+    Status = EFI_SECURITY_VIOLATION;
+    break;
   case TPM_RC_NV_LOCKED:
-    return EFI_ACCESS_DENIED;
+    Status = EFI_ACCESS_DENIED;
+    break;
   case TPM_RC_NV_RANGE:
-    return EFI_BAD_BUFFER_SIZE;
+    Status = EFI_BAD_BUFFER_SIZE;
+    break;
   case TPM_RC_NV_UNINITIALIZED:
-    return EFI_NOT_READY;
+    Status = EFI_NOT_READY;
+    break;
   case TPM_RC_HANDLE + RC_NV_Read_nvIndex: // TPM_RC_NV_DEFINED:
-    return EFI_NOT_FOUND;
+    Status = EFI_NOT_FOUND;
+    break;
   case TPM_RC_HANDLE + RC_NV_Read_authHandle: // TPM_RC_NV_DEFINED:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_VALUE + RC_NV_Read_nvIndex:
   case TPM_RC_VALUE + RC_NV_Read_authHandle:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_BAD_AUTH + RC_NV_Read_authHandle + TPM_RC_S:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_AUTH_UNAVAILABLE:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_AUTH_FAIL + RC_NV_Read_authHandle + TPM_RC_S:
-    return EFI_INVALID_PARAMETER;
-  default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_ATTRIBUTES + RC_NV_Read_authHandle + TPM_RC_S:
-    return EFI_UNSUPPORTED;
+    Status = EFI_UNSUPPORTED;
+    break;
+  default:
+    Status = EFI_DEVICE_ERROR;
+    break;
+  }
+  if (Status != EFI_SUCCESS) {
+    goto Done;
   }
 
   //
@@ -591,7 +634,13 @@ Tpm2NvRead (
   OutData->size = SwapBytes16 (RecvBuffer.Data.size);
   CopyMem (OutData->buffer, &RecvBuffer.Data.buffer, OutData->size);
   
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -661,12 +710,13 @@ Tpm2NvWrite (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvWrite - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
   if (ResponseCode != TPM_RC_SUCCESS) {
@@ -674,33 +724,54 @@ Tpm2NvWrite (
   }
   switch (ResponseCode) {
   case TPM_RC_SUCCESS:
-    return EFI_SUCCESS;
+    // return data
+    break;
   case TPM_RC_ATTRIBUTES:
-    return EFI_UNSUPPORTED;
+    Status = EFI_UNSUPPORTED;
+    break;
   case TPM_RC_NV_AUTHORIZATION:
-    return EFI_SECURITY_VIOLATION;
+    Status = EFI_SECURITY_VIOLATION;
+    break;
   case TPM_RC_NV_LOCKED:
-    return EFI_ACCESS_DENIED;
+    Status = EFI_ACCESS_DENIED;
+    break;
   case TPM_RC_NV_RANGE:
-    return EFI_BAD_BUFFER_SIZE;
+    Status = EFI_BAD_BUFFER_SIZE;
+    break;
   case TPM_RC_HANDLE + RC_NV_Write_nvIndex: // TPM_RC_NV_DEFINED:
-    return EFI_NOT_FOUND;
+    Status = EFI_NOT_FOUND;
+    break;
   case TPM_RC_HANDLE + RC_NV_Write_authHandle: // TPM_RC_NV_DEFINED:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_VALUE + RC_NV_Write_nvIndex:
   case TPM_RC_VALUE + RC_NV_Write_authHandle:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_BAD_AUTH + RC_NV_Write_authHandle + TPM_RC_S:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_AUTH_UNAVAILABLE:
-    return EFI_INVALID_PARAMETER;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_AUTH_FAIL + RC_NV_Write_authHandle + TPM_RC_S:
-    return EFI_INVALID_PARAMETER;
-  default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_INVALID_PARAMETER;
+    break;
   case TPM_RC_ATTRIBUTES + RC_NV_Write_authHandle + TPM_RC_S:
-    return EFI_UNSUPPORTED;
+    Status = EFI_UNSUPPORTED;
+    break;
+  default:
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
+
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -759,12 +830,13 @@ Tpm2NvReadLock (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvReadLock - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
@@ -776,10 +848,17 @@ Tpm2NvReadLock (
     // return data
     break;
   default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -838,12 +917,13 @@ Tpm2NvWriteLock (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvWriteLock - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
@@ -855,10 +935,17 @@ Tpm2NvWriteLock (
     // return data
     break;
   default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }
 
 /**
@@ -914,12 +1001,13 @@ Tpm2NvGlobalWriteLock (
   RecvBufferSize = sizeof (RecvBuffer);
   Status = Tpm2SubmitCommand (SendBufferSize, (UINT8 *)&SendBuffer, &RecvBufferSize, (UINT8 *)&RecvBuffer);
   if (EFI_ERROR (Status)) {
-    return Status;
+    goto Done;
   }
 
   if (RecvBufferSize < sizeof (TPM2_RESPONSE_HEADER)) {
     DEBUG ((EFI_D_ERROR, "Tpm2NvGlobalWriteLock - RecvBufferSize Error - %x\n", RecvBufferSize));
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    goto Done;
   }
 
   ResponseCode = SwapBytes32(RecvBuffer.Header.responseCode);
@@ -931,8 +1019,15 @@ Tpm2NvGlobalWriteLock (
     // return data
     break;
   default:
-    return EFI_DEVICE_ERROR;
+    Status = EFI_DEVICE_ERROR;
+    break;
   }
 
-  return EFI_SUCCESS;
+Done:
+  //
+  // Clear AuthSession Content
+  //
+  ZeroMem (&SendBuffer, sizeof(SendBuffer));
+  ZeroMem (&RecvBuffer, sizeof(RecvBuffer));
+  return Status;
 }

From da16d95cdf2f29a853e41ec3ce7096f3202fa727 Mon Sep 17 00:00:00 2001
From: Chao Zhang <chao.b.zhang@intel.com>
Date: Tue, 12 Jan 2016 00:37:02 +0000
Subject: [PATCH 401/525] SecurityPkg: TcgDxe,Tcg2Dxe,TrEEDxe: New PCD for TCG
 event log and TCG2 final event log area

TCG event log and TCG2 final event log area length can be configurable to meet platform event log
requirement.
PcdTcgLogAreaMinLen    : 0x10000  based on minimum requirement in TCG ACPI Spec 00.37
PcdTcg2FinalLogAreaLen : 0x8000   based on experience value

(Sync patch r19639 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Chao Zhang <chao.b.zhang@intel.com>
Reviewed-by: Yao Jiewen <jiewen.yao@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>
---
 SecurityPkg/SecurityPkg.dec         |  11 ++++++++++-
 SecurityPkg/SecurityPkg.uni         | Bin 39586 -> 41236 bytes
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c   |  15 ++++++---------
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf |   4 +++-
 SecurityPkg/Tcg/TcgDxe/TcgDxe.c     |  14 ++++++--------
 SecurityPkg/Tcg/TcgDxe/TcgDxe.inf   |   3 ++-
 SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c   |  12 +++++-------
 SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf |   3 ++-
 8 files changed, 34 insertions(+), 28 deletions(-)

diff --git a/SecurityPkg/SecurityPkg.dec b/SecurityPkg/SecurityPkg.dec
index d568b4757a0b..b5f4eb75f2d1 100644
--- a/SecurityPkg/SecurityPkg.dec
+++ b/SecurityPkg/SecurityPkg.dec
@@ -5,7 +5,7 @@
 #  It also provides the definitions(including PPIs/PROTOCOLs/GUIDs and library classes)
 #  and libraries instances, which are used for those features.
 #
-# Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
 # (C) Copyright 2015 Hewlett Packard Enterprise Development LP <BR>
 # This program and the accompanying materials are licensed and made available under
 # the terms and conditions of the BSD License which accompanies this distribution.
@@ -389,6 +389,15 @@
   #
   gEfiSecurityPkgTokenSpaceGuid.PcdRsa2048Sha256PublicKeyBuffer|{0x91, 0x29, 0xc4, 0xbd, 0xea, 0x6d, 0xda, 0xb3, 0xaa, 0x6f, 0x50, 0x16, 0xfc, 0xdb, 0x4b, 0x7e, 0x3c, 0xd6, 0xdc, 0xa4, 0x7a, 0x0e, 0xdd, 0xe6, 0x15, 0x8c, 0x73, 0x96, 0xa2, 0xd4, 0xa6, 0x4d}|VOID*|0x00010013
 
+  ## This PCD defines minimum length(in bytes) of the system preboot TCG event log area(LAML).
+  #  For PC Client Implementation spec up to and including 1.2 the minimum log size is 64KB.
+  # @Prompt Minimum length(in bytes) of the system preboot TCG event log area(LAML).
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcgLogAreaMinLen|0x10000|UINT32|0x00010017
+
+  ## This PCD defines length(in bytes) of the TCG2 Final event log area.
+  # @Prompt Length(in bytes) of the TCG2 Final event log area.
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcg2FinalLogAreaLen|0x8000|UINT32|0x00010018
+
 [PcdsDynamic, PcdsDynamicEx]
 
   ## This PCD indicates Hash mask for TPM 2.0.<BR><BR>
diff --git a/SecurityPkg/SecurityPkg.uni b/SecurityPkg/SecurityPkg.uni
index 4e49008dc6b9a2615360df5e03e7d495d0775a9f..a22cd5a60db5778b9b20dd54e36b17d3e17aa0e5 100644
GIT binary patch
delta 873
zcmcgqJxc>Y5PdnsLeWC7un-ojqzObct(?J#c!GssW3w@LdT_Z5IU{IceuHcvorQlu
zLDGwzWjg&gzS%qch@hsi*qhmTvvY6W%<a(WKRNd=PNDkn>O2q3jeBHNe`?7?f)lvt
zz=y^jLd5Xs$3}0h_p*D47P>qNks!=J!zqe3SD}Fm-hHGfF(X01ui!pyN-VXgyl&gS
zG?<exrf`57wrPEw+qx2qEFVQKWHe7xBpsK;Je16}8~#FiG+Qx`!9uUef`KI{#1zR(
zWB=BO8t>$5BPg3uZFpE`uN`LYQwPNpk)Y@+I_!{g+v?rQW18`hFJhu8F(1eDy7WZv
zgkMdp31#jIiyIY`v1*ZQ65j=oxl5%Gm#n2|MW`y)u#3%H>gnY=<1s5o9Kh#IdEXIj
ly$N<Ao4RoOsQtqZK>v|TKKiTi(NDUw6Z50eE11KKJ#Q;ft#JSV

delta 16
YcmbPoh-uMQrVTfk7)>|dWI8z=06ujGU;qFB

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index 7076772f30a3..280a731bd36c 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -56,9 +56,6 @@ typedef struct {
   EFI_GUID                               *VendorGuid;
 } VARIABLE_TYPE;
 
-#define  EFI_TCG_LOG_AREA_SIZE        0x10000
-#define  EFI_TCG_FINAL_LOG_AREA_SIZE  0x1000
-
 #define  TCG2_DEFAULT_MAX_COMMAND_SIZE        0x1000
 #define  TCG2_DEFAULT_MAX_RESPONSE_SIZE       0x1000
 
@@ -1470,19 +1467,19 @@ SetupEventLog (
       Status = gBS->AllocatePages (
                       AllocateMaxAddress,
                       EfiACPIMemoryNVS,
-                      EFI_SIZE_TO_PAGES (EFI_TCG_LOG_AREA_SIZE),
+                      EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcgLogAreaMinLen)),
                       &Lasa
                       );
       if (EFI_ERROR (Status)) {
         return Status;
       }
       mTcgDxeData.EventLogAreaStruct[Index].Lasa = Lasa;
-      mTcgDxeData.EventLogAreaStruct[Index].Laml = EFI_TCG_LOG_AREA_SIZE;
+      mTcgDxeData.EventLogAreaStruct[Index].Laml = PcdGet32 (PcdTcgLogAreaMinLen);
       //
       // To initialize them as 0xFF is recommended 
       // because the OS can know the last entry for that.
       //
-      SetMem ((VOID *)(UINTN)Lasa, EFI_TCG_LOG_AREA_SIZE, 0xFF);
+      SetMem ((VOID *)(UINTN)Lasa, PcdGet32 (PcdTcgLogAreaMinLen), 0xFF);
       //
       // Create first entry for Log Header Entry Data
       //
@@ -1571,13 +1568,13 @@ SetupEventLog (
       Status = gBS->AllocatePages (
                       AllocateMaxAddress,
                       EfiACPIMemoryNVS,
-                      EFI_SIZE_TO_PAGES (EFI_TCG_FINAL_LOG_AREA_SIZE),
+                      EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcg2FinalLogAreaLen)),
                       &Lasa
                       );
       if (EFI_ERROR (Status)) {
         return Status;
       }
-      SetMem ((VOID *)(UINTN)Lasa, EFI_TCG_FINAL_LOG_AREA_SIZE, 0xFF);
+      SetMem ((VOID *)(UINTN)Lasa, PcdGet32 (PcdTcg2FinalLogAreaLen), 0xFF);
 
       //
       // Initialize
@@ -1588,7 +1585,7 @@ SetupEventLog (
 
       mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogFormat = mTcg2EventInfo[Index].LogFormat;
       mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa = Lasa + sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
-      mTcgDxeData.FinalEventLogAreaStruct[Index].Laml = EFI_TCG_FINAL_LOG_AREA_SIZE - sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
+      mTcgDxeData.FinalEventLogAreaStruct[Index].Laml = PcdGet32 (PcdTcg2FinalLogAreaLen) - sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
       mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogSize = 0;
       mTcgDxeData.FinalEventLogAreaStruct[Index].LastEvent = (VOID *)(UINTN)mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa;
       mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogStarted = FALSE;
diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
index ca6741b3ad4d..fd120e553834 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.inf
@@ -7,7 +7,7 @@
 #  This external input must be validated carefully to avoid security issue like
 #  buffer overflow, integer overflow.
 #
-# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -100,6 +100,8 @@
   gEfiSecurityPkgTokenSpaceGuid.PcdStatusCodeSubClassTpmDevice              ## SOMETIMES_CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdTcg2HashAlgorithmBitmap                  ## CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdTcg2NumberOfPCRBanks                     ## CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcgLogAreaMinLen                         ## CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcg2FinalLogAreaLen                      ## CONSUMES
 
 [Depex]
   TRUE
diff --git a/SecurityPkg/Tcg/TcgDxe/TcgDxe.c b/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
index 80919414ab44..e1bf6c6989cb 100644
--- a/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
+++ b/SecurityPkg/Tcg/TcgDxe/TcgDxe.c
@@ -53,8 +53,6 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "TpmComm.h"
 
-#define  EFI_TCG_LOG_AREA_SIZE        0x10000
-
 #define TCG_DXE_DATA_FROM_THIS(this)  \
   BASE_CR (this, TCG_DXE_DATA, TcgProtocol)
 
@@ -653,7 +651,7 @@ SetupEventLog (
     Status = gBS->AllocatePages (
                     AllocateMaxAddress,
                     EfiACPIMemoryNVS,
-                    EFI_SIZE_TO_PAGES (EFI_TCG_LOG_AREA_SIZE),
+                    EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcgLogAreaMinLen)),
                     &Lasa
                     );
     if (EFI_ERROR (Status)) {
@@ -664,8 +662,8 @@ SetupEventLog (
     // To initialize them as 0xFF is recommended 
     // because the OS can know the last entry for that.
     //
-    SetMem ((VOID *)(UINTN)mTcgClientAcpiTemplate.Lasa, EFI_TCG_LOG_AREA_SIZE, 0xFF);
-    mTcgClientAcpiTemplate.Laml = EFI_TCG_LOG_AREA_SIZE;
+    SetMem ((VOID *)(UINTN)mTcgClientAcpiTemplate.Lasa, PcdGet32 (PcdTcgLogAreaMinLen), 0xFF);
+    mTcgClientAcpiTemplate.Laml = PcdGet32 (PcdTcgLogAreaMinLen);
   
   } else {
     Lasa = mTcgServerAcpiTemplate.Lasa;
@@ -673,7 +671,7 @@ SetupEventLog (
     Status = gBS->AllocatePages (
                     AllocateMaxAddress,
                     EfiACPIMemoryNVS,
-                    EFI_SIZE_TO_PAGES (EFI_TCG_LOG_AREA_SIZE),
+                    EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcgLogAreaMinLen)),
                     &Lasa
                     );
     if (EFI_ERROR (Status)) {
@@ -684,8 +682,8 @@ SetupEventLog (
     // To initialize them as 0xFF is recommended 
     // because the OS can know the last entry for that.
     //
-    SetMem ((VOID *)(UINTN)mTcgServerAcpiTemplate.Lasa, EFI_TCG_LOG_AREA_SIZE, 0xFF);
-    mTcgServerAcpiTemplate.Laml = EFI_TCG_LOG_AREA_SIZE;
+    SetMem ((VOID *)(UINTN)mTcgServerAcpiTemplate.Lasa, PcdGet32 (PcdTcgLogAreaMinLen), 0xFF);
+    mTcgServerAcpiTemplate.Laml = PcdGet32 (PcdTcgLogAreaMinLen);
   }
 
   GuidHob.Raw = GetHobList ();
diff --git a/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf b/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
index 0976304883f2..e5409dfefd50 100644
--- a/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
+++ b/SecurityPkg/Tcg/TcgDxe/TcgDxe.inf
@@ -2,7 +2,7 @@
 #  Produces TCG protocol and measures boot environment
 #  This module will produce TCG protocol and measure boot environment.
 #
-# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -75,6 +75,7 @@
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorId         ## SOMETIMES_CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision   ## SOMETIMES_CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdStatusCodeSubClassTpmDevice   ## SOMETIMES_CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcgLogAreaMinLen              ## CONSUMES
 
 [Depex]
   TRUE
diff --git a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
index 41e7207eaffa..3974ca5494fe 100644
--- a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
+++ b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.c
@@ -55,8 +55,6 @@ typedef struct {
   EFI_GUID                               *VendorGuid;
 } VARIABLE_TYPE;
 
-#define  EFI_TCG_LOG_AREA_SIZE        0x10000
-
 #define  TREE_DEFAULT_MAX_COMMAND_SIZE        0x1000
 #define  TREE_DEFAULT_MAX_RESPONSE_SIZE       0x1000
 
@@ -949,19 +947,19 @@ SetupEventLog (
       Status = gBS->AllocatePages (
                       AllocateMaxAddress,
                       EfiACPIMemoryNVS,
-                      EFI_SIZE_TO_PAGES (EFI_TCG_LOG_AREA_SIZE),
+                      EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcgLogAreaMinLen)),
                       &Lasa
                       );
       if (EFI_ERROR (Status)) {
         return Status;
       }
       mTcgDxeData.EventLogAreaStruct[Index].Lasa = Lasa;
-      mTcgDxeData.EventLogAreaStruct[Index].Laml = EFI_TCG_LOG_AREA_SIZE;
+      mTcgDxeData.EventLogAreaStruct[Index].Laml = PcdGet32 (PcdTcgLogAreaMinLen);
       //
       // To initialize them as 0xFF is recommended 
       // because the OS can know the last entry for that.
       //
-      SetMem ((VOID *)(UINTN)Lasa, EFI_TCG_LOG_AREA_SIZE, 0xFF);
+      SetMem ((VOID *)(UINTN)Lasa, PcdGet32 (PcdTcgLogAreaMinLen), 0xFF);
   }
 
   //
@@ -969,10 +967,10 @@ SetupEventLog (
   //
     if (PcdGet8 (PcdTpmPlatformClass) == TCG_PLATFORM_TYPE_CLIENT) {
       mTcgClientAcpiTemplate.Lasa = mTcgDxeData.EventLogAreaStruct[0].Lasa;
-      mTcgClientAcpiTemplate.Laml = EFI_TCG_LOG_AREA_SIZE;
+      mTcgClientAcpiTemplate.Laml = PcdGet32 (PcdTcgLogAreaMinLen);
     } else {
       mTcgServerAcpiTemplate.Lasa = mTcgDxeData.EventLogAreaStruct[0].Lasa;
-      mTcgServerAcpiTemplate.Laml = EFI_TCG_LOG_AREA_SIZE;
+      mTcgServerAcpiTemplate.Laml = PcdGet32 (PcdTcgLogAreaMinLen);
     }
 
   //
diff --git a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
index 258ab46db94d..c22e8f00045b 100644
--- a/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
+++ b/SecurityPkg/Tcg/TrEEDxe/TrEEDxe.inf
@@ -7,7 +7,7 @@
 #  This external input must be validated carefully to avoid security issue like
 #  buffer overflow, integer overflow.
 #
-# Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -94,6 +94,7 @@
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorId                    ## SOMETIMES_CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision              ## SOMETIMES_CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdStatusCodeSubClassTpmDevice              ## SOMETIMES_CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTcgLogAreaMinLen                         ## CONSUMES
 
 [Depex]
   TRUE

From 6de848dfd2dfc33890989bd7a27d74997ae88ec8 Mon Sep 17 00:00:00 2001
From: Paulo Alcantara <paulo.alc.cavalcanti@hp.com>
Date: Tue, 12 Jan 2016 01:37:48 +0000
Subject: [PATCH 402/525] NetworkPkg: Fix some typos in Http boot driver.

(Sync patch r19640 from main trunk.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Paulo Alcantara <paulo.alc.cavalcanti@hp.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
---
 NetworkPkg/HttpBootDxe/HttpBootClient.c  | 8 ++++----
 NetworkPkg/HttpBootDxe/HttpBootClient.h  | 2 +-
 NetworkPkg/HttpBootDxe/HttpBootSupport.c | 4 ++--
 NetworkPkg/HttpBootDxe/HttpBootSupport.h | 8 ++++----
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.c b/NetworkPkg/HttpBootDxe/HttpBootClient.c
index a2cad0a6fba4..f0817e92e21e 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.c
@@ -719,8 +719,8 @@ HttpBootGetBootFile (
   EFI_STATUS                 Status;
   CHAR8                      *HostName;
   EFI_HTTP_REQUEST_DATA      *RequestData;
-  HTTP_IO_RESOPNSE_DATA      *ResponseData;
-  HTTP_IO_RESOPNSE_DATA      ResponseBody;
+  HTTP_IO_RESPONSE_DATA      *ResponseData;
+  HTTP_IO_RESPONSE_DATA      ResponseBody;
   HTTP_IO                    *HttpIo;
   HTTP_IO_HEADER             *HttpIoHeader;
   VOID                       *Parser;
@@ -884,7 +884,7 @@ HttpBootGetBootFile (
   //
   // 3.1 First step, use zero BodyLength to only receive the response headers.
   //
-  ResponseData = AllocateZeroPool (sizeof(HTTP_IO_RESOPNSE_DATA));
+  ResponseData = AllocateZeroPool (sizeof(HTTP_IO_RESPONSE_DATA));
   if (ResponseData == NULL) {
     Status = EFI_OUT_OF_RESOURCES;
     goto ERROR_4;
@@ -948,7 +948,7 @@ HttpBootGetBootFile (
     // 3.4.2, start the message-body download, the identity and chunked transfer-coding
     // is handled in different path here.
     //
-    ZeroMem (&ResponseBody, sizeof (HTTP_IO_RESOPNSE_DATA));
+    ZeroMem (&ResponseBody, sizeof (HTTP_IO_RESPONSE_DATA));
     if (IdentityMode) {
       //
       // In identity transfer-coding there is no need to parse the message body,
diff --git a/NetworkPkg/HttpBootDxe/HttpBootClient.h b/NetworkPkg/HttpBootDxe/HttpBootClient.h
index 06b91098fc38..e618316f10e6 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootClient.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootClient.h
@@ -41,7 +41,7 @@ typedef struct {
 typedef struct {
   LIST_ENTRY                 Link;            // Link to the CacheList in driver's private data.
   EFI_HTTP_REQUEST_DATA      *RequestData;
-  HTTP_IO_RESOPNSE_DATA      *ResponseData;   // Not include any message-body data.
+  HTTP_IO_RESPONSE_DATA      *ResponseData;   // Not include any message-body data.
   UINTN                      EntityLength;
   LIST_ENTRY                 EntityDataList;  // Entity data (message-body)
 } HTTP_BOOT_CACHE_CONTENT;
diff --git a/NetworkPkg/HttpBootDxe/HttpBootSupport.c b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
index 1fc4e768806c..f9bbe4b1a0e7 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootSupport.c
+++ b/NetworkPkg/HttpBootDxe/HttpBootSupport.c
@@ -914,7 +914,7 @@ HttpIoSendRequest (
                                 FALSE to continue receive the previous response message.
   @param[out]  ResponseData     Point to a wrapper of the received response data.
   
-  @retval EFI_SUCCESS            The HTTP resopnse is received.
+  @retval EFI_SUCCESS            The HTTP response is received.
   @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.
   @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.
   @retval EFI_DEVICE_ERROR       An unexpected network or system error occurred.
@@ -925,7 +925,7 @@ EFI_STATUS
 HttpIoRecvResponse (
   IN      HTTP_IO                  *HttpIo,
   IN      BOOLEAN                  RecvMsgHeader,
-     OUT  HTTP_IO_RESOPNSE_DATA    *ResponseData
+     OUT  HTTP_IO_RESPONSE_DATA    *ResponseData
   )
 {
   EFI_STATUS                 Status;
diff --git a/NetworkPkg/HttpBootDxe/HttpBootSupport.h b/NetworkPkg/HttpBootDxe/HttpBootSupport.h
index d5956720a7cf..2eba14e0267f 100644
--- a/NetworkPkg/HttpBootDxe/HttpBootSupport.h
+++ b/NetworkPkg/HttpBootDxe/HttpBootSupport.h
@@ -168,7 +168,7 @@ typedef union {
 } HTTP_IO_CONFIG_DATA;
 
 //
-// HTTO_IO wrapper of the EFI HTTP service.
+// HTTP_IO wrapper of the EFI HTTP service.
 //
 typedef struct {
   UINT8                     IpVersion;
@@ -196,7 +196,7 @@ typedef struct {
   EFI_HTTP_HEADER             *Headers;
   UINTN                       BodyLength;
   CHAR8                       *Body;
-} HTTP_IO_RESOPNSE_DATA;
+} HTTP_IO_RESPONSE_DATA;
 
 /**
   Retrieve the host address using the EFI_DNS6_PROTOCOL.
@@ -303,7 +303,7 @@ HttpIoSendRequest (
                                 FALSE to continue receive the previous response message.
   @param[out]  ResponseData     Point to a wrapper of the received response data.
   
-  @retval EFI_SUCCESS            The HTTP resopnse is received.
+  @retval EFI_SUCCESS            The HTTP response is received.
   @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.
   @retval EFI_OUT_OF_RESOURCES   Failed to allocate memory.
   @retval EFI_DEVICE_ERROR       An unexpected network or system error occurred.
@@ -314,7 +314,7 @@ EFI_STATUS
 HttpIoRecvResponse (
   IN      HTTP_IO                  *HttpIo,
   IN      BOOLEAN                  RecvMsgHeader,
-     OUT  HTTP_IO_RESOPNSE_DATA    *ResponseData
+     OUT  HTTP_IO_RESPONSE_DATA    *ResponseData
   );
 
 #endif

From e1821a2f5e56405419bb7c0cbd5746734469459a Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Wed, 30 Dec 2015 08:10:55 +0000
Subject: [PATCH 403/525] NetworkPkg: Support DNS4/6 GeneralLookUp feature

This patch is used to support DNS4/6 GeneralLookUp feature.

Cc: Subramanian Sriram <sriram-s@hpe.com>
Cc: El-Haj-Mahmoud Samer <samer.el-haj-mahmoud@hpe.com>
Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Ye Ting <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19579 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit fcae1a993676997c8c21e95b7e69663683c326db)
---
 NetworkPkg/DnsDxe/DnsImpl.c     | 321 +++++++++++++++++++++++++-------
 NetworkPkg/DnsDxe/DnsImpl.h     |  34 +++-
 NetworkPkg/DnsDxe/DnsProtocol.c | 247 +++++++++++++++++++++++-
 3 files changed, 522 insertions(+), 80 deletions(-)

diff --git a/NetworkPkg/DnsDxe/DnsImpl.c b/NetworkPkg/DnsDxe/DnsImpl.c
index 4f7320e403bf..8725670a8e8a 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.c
+++ b/NetworkPkg/DnsDxe/DnsImpl.c
@@ -1013,6 +1013,61 @@ AddDns6ServerIp (
   return EFI_SUCCESS;
 }
 
+/**
+  Fill QName for IP querying. QName is a domain name represented as 
+  a sequence of labels, where each label consists of a length octet 
+  followed by that number of octets. The domain name terminates with 
+  the zero length octet for the null label of the root. Caller should 
+  take responsibility to the buffer in QName.
+
+  @param  HostName          Queried HostName    
+
+  @retval NULL      Failed to fill QName.
+  @return           QName filled successfully.
+  
+**/ 
+UINT8 *
+EFIAPI
+DnsFillinQNameForQueryIp (
+  IN  CHAR16              *HostName
+  )
+{
+  CHAR8                 *QueryName;
+  CHAR8                 *Header;
+  CHAR8                 *Tail;
+  UINTN                 Len;
+  UINTN                 Index;
+
+  QueryName  = NULL;
+  Header     = NULL;
+  Tail       = NULL;
+
+  QueryName = AllocateZeroPool (DNS_DEFAULT_BLKSIZE);
+  if (QueryName == NULL) {
+    return NULL;
+  }
+  
+  Header = QueryName;
+  Tail = Header + 1;
+  Len = 0;
+  for (Index = 0; HostName[Index] != 0; Index++) {
+    *Tail = (CHAR8) HostName[Index];
+    if (*Tail == '.') {
+      *Header = (CHAR8) Len;
+      Header = Tail;
+      Tail ++;
+      Len = 0;
+    } else {
+      Tail++;
+      Len++;
+    }
+  }
+  *Header = (CHAR8) Len;
+  *Tail = 0;
+
+  return QueryName;
+}
+
 /**
   Find out whether the response is valid or invalid.
 
@@ -1100,6 +1155,7 @@ ParseDnsResponse (
   DNS6_TOKEN_ENTRY      *Dns6TokenEntry;
   
   UINT32                IpCount;
+  UINT32                RRCount;
   UINT32                AnswerSectionNum;
   
   EFI_IPv4_ADDRESS      *HostAddr4;
@@ -1108,6 +1164,9 @@ ParseDnsResponse (
   EFI_DNS4_CACHE_ENTRY  *Dns4CacheEntry;
   EFI_DNS6_CACHE_ENTRY  *Dns6CacheEntry;
 
+  DNS_RESOURCE_RECORD   *Dns4RR;
+  DNS6_RESOURCE_RECORD  *Dns6RR;
+
   EFI_STATUS            Status;
 
   EFI_TPL               OldTpl;
@@ -1117,6 +1176,7 @@ ParseDnsResponse (
   Dns6TokenEntry   = NULL;
   
   IpCount          = 0;
+  RRCount          = 0;
   AnswerSectionNum = 0;
   
   HostAddr4        = NULL;
@@ -1124,6 +1184,9 @@ ParseDnsResponse (
   
   Dns4CacheEntry   = NULL;
   Dns6CacheEntry   = NULL;
+  
+  Dns4RR           = NULL;
+  Dns6RR           = NULL;
 
   *Completed       = TRUE;
   Status           = EFI_SUCCESS;
@@ -1197,29 +1260,81 @@ ParseDnsResponse (
   }
   
   //
-  // Check the Query type, do some buffer allocations.
+  // Do some buffer allocations.
   //
   if (Instance->Service->IpVersion == IP_VERSION_4) {
     ASSERT (Dns4TokenEntry != NULL);
-    if (QuerySection->Type == DNS_TYPE_A) {
-      Dns4TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS_HOST_TO_ADDR_DATA));
-      ASSERT (Dns4TokenEntry->Token->RspData.H2AData != NULL);
-      Dns4TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv4_ADDRESS));
-      ASSERT (Dns4TokenEntry->Token->RspData.H2AData->IpList != NULL);
+
+    if (Dns4TokenEntry->GeneralLookUp) {
+      //
+      // It's the GeneralLookUp querying.
+      //
+      Dns4TokenEntry->Token->RspData.GLookupData = AllocatePool (sizeof (DNS_RESOURCE_RECORD));
+      if (Dns4TokenEntry->Token->RspData.GLookupData == NULL) {
+        Status = EFI_OUT_OF_RESOURCES;
+        goto ON_EXIT;
+      }
+      Dns4TokenEntry->Token->RspData.GLookupData->RRList = AllocatePool (DnsHeader->AnswersNum * sizeof (DNS_RESOURCE_RECORD));
+      if (Dns4TokenEntry->Token->RspData.GLookupData->RRList == NULL) {
+        Status = EFI_OUT_OF_RESOURCES;
+        goto ON_EXIT;
+      }
     } else {
-      Status = EFI_UNSUPPORTED;
-      goto ON_EXIT;
+      //
+      // It's not the GeneralLookUp querying. Check the Query type.
+      //
+      if (QuerySection->Type == DNS_TYPE_A) {
+        Dns4TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS_HOST_TO_ADDR_DATA));
+        if (Dns4TokenEntry->Token->RspData.H2AData == NULL) {
+          Status = EFI_OUT_OF_RESOURCES;
+          goto ON_EXIT;
+        }
+        Dns4TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv4_ADDRESS));
+        if (Dns4TokenEntry->Token->RspData.H2AData->IpList == NULL) {
+          Status = EFI_OUT_OF_RESOURCES;
+          goto ON_EXIT;
+        }
+      } else {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
     }
   } else {
     ASSERT (Dns6TokenEntry != NULL);
-    if (QuerySection->Type == DNS_TYPE_AAAA) {
-      Dns6TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS6_HOST_TO_ADDR_DATA));
-      ASSERT (Dns6TokenEntry->Token->RspData.H2AData != NULL);
-      Dns6TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv6_ADDRESS));
-      ASSERT (Dns6TokenEntry->Token->RspData.H2AData->IpList != NULL);
+
+    if (Dns6TokenEntry->GeneralLookUp) {
+      //
+      // It's the GeneralLookUp querying.
+      //
+      Dns6TokenEntry->Token->RspData.GLookupData = AllocatePool (sizeof (DNS_RESOURCE_RECORD));
+      if (Dns6TokenEntry->Token->RspData.GLookupData == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
+      Dns6TokenEntry->Token->RspData.GLookupData->RRList = AllocatePool (DnsHeader->AnswersNum * sizeof (DNS_RESOURCE_RECORD));
+      if (Dns6TokenEntry->Token->RspData.GLookupData->RRList == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
     } else {
-      Status = EFI_UNSUPPORTED;
-      goto ON_EXIT;
+      //
+      // It's not the GeneralLookUp querying. Check the Query type.
+      //
+      if (QuerySection->Type == DNS_TYPE_AAAA) {
+        Dns6TokenEntry->Token->RspData.H2AData = AllocatePool (sizeof (DNS6_HOST_TO_ADDR_DATA));
+        if (Dns6TokenEntry->Token->RspData.H2AData == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
+        Dns6TokenEntry->Token->RspData.H2AData->IpList = AllocatePool (DnsHeader->AnswersNum * sizeof (EFI_IPv6_ADDRESS));
+        if (Dns6TokenEntry->Token->RspData.H2AData->IpList == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
+      } else {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
     }
   }
 
@@ -1241,9 +1356,68 @@ ParseDnsResponse (
     AnswerSection->Ttl = NTOHL (AnswerSection->Ttl);
     AnswerSection->DataLength = NTOHS (AnswerSection->DataLength);
 
-    ASSERT (AnswerSection->Class == DNS_CLASS_INET);
+    //
+    // Check whether it's the GeneralLookUp querying.
+    //
+    if (Instance->Service->IpVersion == IP_VERSION_4 && Dns4TokenEntry->GeneralLookUp) {
+      ASSERT (Dns4TokenEntry != NULL);
+      
+      Dns4RR = Dns4TokenEntry->Token->RspData.GLookupData->RRList;
+      AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
+
+      //
+      // Fill the ResourceRecord.
+      //
+      Dns4RR[RRCount].QName = AllocateZeroPool (AsciiStrLen (QueryName) + 1);
+      if (Dns4RR[RRCount].QName == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
+      CopyMem (Dns4RR[RRCount].QName, QueryName, AsciiStrLen (QueryName));
+      Dns4RR[RRCount].QType = AnswerSection->Type;
+      Dns4RR[RRCount].QClass = AnswerSection->Class;
+      Dns4RR[RRCount].TTL = AnswerSection->Ttl;
+      Dns4RR[RRCount].DataLength = AnswerSection->DataLength;
+      Dns4RR[RRCount].RData = AllocateZeroPool (Dns4RR[RRCount].DataLength);
+      if (Dns4RR[RRCount].RData == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
+      CopyMem (Dns4RR[RRCount].RData, AnswerData, Dns4RR[RRCount].DataLength);
+      
+      RRCount ++;
+    } else if (Instance->Service->IpVersion == IP_VERSION_6 && Dns6TokenEntry->GeneralLookUp) {
+      ASSERT (Dns6TokenEntry != NULL);
+      
+      Dns6RR = Dns6TokenEntry->Token->RspData.GLookupData->RRList;
+      AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
 
-    if (AnswerSection->Type == QuerySection->Type) {
+      //
+      // Fill the ResourceRecord.
+      //
+      Dns6RR[RRCount].QName = AllocateZeroPool (AsciiStrLen (QueryName) + 1);
+      if (Dns6RR[RRCount].QName == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
+      CopyMem (Dns6RR[RRCount].QName, QueryName, AsciiStrLen (QueryName));
+      Dns6RR[RRCount].QType = AnswerSection->Type;
+      Dns6RR[RRCount].QClass = AnswerSection->Class;
+      Dns6RR[RRCount].TTL = AnswerSection->Ttl;
+      Dns6RR[RRCount].DataLength = AnswerSection->DataLength;
+      Dns6RR[RRCount].RData = AllocateZeroPool (Dns6RR[RRCount].DataLength);
+      if (Dns6RR[RRCount].RData == NULL) {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
+      CopyMem (Dns6RR[RRCount].RData, AnswerData, Dns6RR[RRCount].DataLength);
+      
+      RRCount ++;
+    } else {
+      //
+      // It's not the GeneralLookUp querying. 
+      // Check the Query type, parse the response packet.
+      //
       switch (AnswerSection->Type) {
       case DNS_TYPE_A:
         //
@@ -1274,12 +1448,21 @@ ParseDnsResponse (
         // Allocate new CacheEntry pool.
         //
         Dns4CacheEntry = AllocateZeroPool (sizeof (EFI_DNS4_CACHE_ENTRY));
-        ASSERT (Dns4CacheEntry != NULL);
+        if (Dns4CacheEntry == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         Dns4CacheEntry->HostName = AllocateZeroPool (2 * (StrLen(Dns4TokenEntry->QueryHostName) + 1));
-        ASSERT (Dns4CacheEntry->HostName != NULL);
+        if (Dns4CacheEntry->HostName == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         CopyMem (Dns4CacheEntry->HostName, Dns4TokenEntry->QueryHostName, 2 * (StrLen(Dns4TokenEntry->QueryHostName) + 1));
         Dns4CacheEntry->IpAddress = AllocateZeroPool (sizeof (EFI_IPv4_ADDRESS));
-        ASSERT (Dns4CacheEntry->IpAddress != NULL);
+        if (Dns4CacheEntry->IpAddress == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         CopyMem (Dns4CacheEntry->IpAddress, AnswerData, sizeof (EFI_IPv4_ADDRESS));
         Dns4CacheEntry->Timeout = AnswerSection->Ttl;
         
@@ -1316,12 +1499,21 @@ ParseDnsResponse (
         // Allocate new CacheEntry pool.
         //
         Dns6CacheEntry = AllocateZeroPool (sizeof (EFI_DNS6_CACHE_ENTRY));
-        ASSERT (Dns6CacheEntry != NULL);
+        if (Dns6CacheEntry == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         Dns6CacheEntry->HostName = AllocateZeroPool (2 * (StrLen(Dns6TokenEntry->QueryHostName) + 1));
-        ASSERT (Dns6CacheEntry->HostName != NULL);
+        if (Dns6CacheEntry->HostName == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         CopyMem (Dns6CacheEntry->HostName, Dns6TokenEntry->QueryHostName, 2 * (StrLen(Dns6TokenEntry->QueryHostName) + 1));
         Dns6CacheEntry->IpAddress = AllocateZeroPool (sizeof (EFI_IPv6_ADDRESS));
-        ASSERT (Dns6CacheEntry->IpAddress != NULL);
+        if (Dns6CacheEntry->IpAddress == NULL) {
+          Status = EFI_UNSUPPORTED;
+          goto ON_EXIT;
+        }
         CopyMem (Dns6CacheEntry->IpAddress, AnswerData, sizeof (EFI_IPv6_ADDRESS));
         Dns6CacheEntry->Timeout = AnswerSection->Ttl;
         
@@ -1344,19 +1536,29 @@ ParseDnsResponse (
 
   if (Instance->Service->IpVersion == IP_VERSION_4) {
     ASSERT (Dns4TokenEntry != NULL);
-    if (QuerySection->Type == DNS_TYPE_A) {
-      Dns4TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+    
+    if (Dns4TokenEntry->GeneralLookUp) {
+      Dns4TokenEntry->Token->RspData.GLookupData->RRCount = RRCount;
     } else {
-      Status = EFI_UNSUPPORTED;
-      goto ON_EXIT;
+      if (QuerySection->Type == DNS_TYPE_A) {
+        Dns4TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+      } else {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
     }
   } else {
     ASSERT (Dns6TokenEntry != NULL);
-    if (QuerySection->Type == DNS_TYPE_AAAA) {
-      Dns6TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+
+    if (Dns6TokenEntry->GeneralLookUp) {
+      Dns6TokenEntry->Token->RspData.GLookupData->RRCount = RRCount;
     } else {
-      Status = EFI_UNSUPPORTED;
-      goto ON_EXIT;
+      if (QuerySection->Type == DNS_TYPE_AAAA) {
+        Dns6TokenEntry->Token->RspData.H2AData->IpCount = IpCount;
+      } else {
+        Status = EFI_UNSUPPORTED;
+        goto ON_EXIT;
+      }
     }
   }
 
@@ -1560,35 +1762,31 @@ DoDnsQuery (
 }
 
 /**
-  Construct the Packet to query Ip.
+  Construct the Packet according query section.
 
   @param  Instance              The DNS instance
-  @param  HostName              Queried HostName  
-  @param  Type                  DNS query Type
-  @param  Packet                The packet for querying Ip
+  @param  QueryName             Queried Name  
+  @param  Type                  Queried Type 
+  @param  Class                 Queried Class 
+  @param  Packet                The packet for query
 
   @retval EFI_SUCCESS           The packet is constructed.
   @retval Others                Failed to construct the Packet.
 
 **/
 EFI_STATUS
-ConstructDNSQueryIp (
+ConstructDNSQuery (
   IN  DNS_INSTANCE              *Instance,
-  IN  CHAR16                    *HostName,
+  IN  CHAR8                     *QueryName,
   IN  UINT16                    Type,
+  IN  UINT16                    Class,
   OUT NET_BUF                   **Packet
   )
 {
   NET_FRAGMENT        Frag;
   DNS_HEADER          *DnsHeader;
-  CHAR8               *QueryName;
-  DNS_QUERY_SECTION   *QuerySection;
-  CHAR8               *Header;
-  CHAR8               *Tail;
-  UINTN               Len;
-  UINTN               Index;
+  DNS_QUERY_SECTION   *DnsQuery;
   
-
   Frag.Bulk = AllocatePool (DNS_DEFAULT_BLKSIZE * sizeof (UINT8));
   if (Frag.Bulk == NULL) {
     return EFI_OUT_OF_RESOURCES;
@@ -1620,37 +1818,20 @@ ConstructDNSQueryIp (
   //
   // Fill Query name
   //
-  QueryName = (CHAR8 *) (Frag.Bulk + Frag.Len);
-  Header = QueryName;
-  Tail = Header + 1;
-  Len = 0;
-  for (Index = 0; HostName[Index] != 0; Index++) {
-    *Tail = (CHAR8) HostName[Index];
-    if (*Tail == '.') {
-      *Header = (CHAR8) Len;
-      Header = Tail;
-      Tail ++;
-      Len = 0;
-    } else {
-      Tail++;
-      Len++;
-    }
-  }
-  *Header = (CHAR8) Len;
-  *Tail = 0;
-  Frag.Len = (UINT32) (Frag.Len + StrLen (HostName) + 2); /// 1 for header, 1 for tail.
-
+  CopyMem (Frag.Bulk + Frag.Len, QueryName, AsciiStrLen (QueryName));
+  Frag.Len = (UINT32) (Frag.Len + AsciiStrLen (QueryName));
+  *(Frag.Bulk + Frag.Len) = 0;
+  Frag.Len ++;
+  
   //
   // Rest query section
   //
-  QuerySection = (DNS_QUERY_SECTION *) (Frag.Bulk + Frag.Len);
-  QuerySection->Type = Type;
-  QuerySection->Class = DNS_CLASS_INET;
+  DnsQuery = (DNS_QUERY_SECTION *) (Frag.Bulk + Frag.Len);
 
-  QuerySection->Type = HTONS (QuerySection->Type);
-  QuerySection->Class = HTONS (QuerySection->Class);
+  DnsQuery->Type = HTONS (Type);
+  DnsQuery->Class = HTONS (Class);
 
-  Frag.Len += sizeof (*QuerySection);
+  Frag.Len += sizeof (*DnsQuery);
 
   //
   // Wrap the Frag in a net buffer.
diff --git a/NetworkPkg/DnsDxe/DnsImpl.h b/NetworkPkg/DnsDxe/DnsImpl.h
index c3a889bcd515..a13355f85517 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.h
+++ b/NetworkPkg/DnsDxe/DnsImpl.h
@@ -119,6 +119,7 @@ typedef struct {
   UINT32                     PacketToLive;
   CHAR16                     *QueryHostName;
   EFI_IPv4_ADDRESS           QueryIpAddress;
+  BOOLEAN                    GeneralLookUp;
   EFI_DNS4_COMPLETION_TOKEN  *Token;
 } DNS4_TOKEN_ENTRY;
 
@@ -126,6 +127,7 @@ typedef struct {
   UINT32                     PacketToLive;
   CHAR16                     *QueryHostName;
   EFI_IPv6_ADDRESS           QueryIpAddress;
+  BOOLEAN                    GeneralLookUp;
   EFI_DNS6_COMPLETION_TOKEN  *Token;
 } DNS6_TOKEN_ENTRY;
 
@@ -567,6 +569,24 @@ AddDns6ServerIp (
   IN EFI_IPv6_ADDRESS           ServerIp
   );
 
+/**
+  Fill QName for IP querying. QName is a domain name represented as 
+  a sequence of labels, where each label consists of a length octet 
+  followed by that number of octets. The domain name terminates with 
+  the zero length octet for the null label of the root.
+
+  @param  HostName          Queried HostName    
+
+  @retval NULL      Failed to fill QName.
+  @return           QName filled successfully.
+  
+**/ 
+UINT8 *
+EFIAPI
+DnsFillinQNameForQueryIp (
+  IN  CHAR16              *HostName
+  );
+
 /**
   Find out whether the response is valid or invalid.
 
@@ -658,22 +678,24 @@ DoDnsQuery (
   );
 
 /**
-  Construct the Packet to query Ip.
+  Construct the Packet according query section.
 
   @param  Instance              The DNS instance
-  @param  HostName              Queried HostName  
-  @param  Type                  DNS query Type
-  @param  Packet                The packet for querying Ip
+  @param  QueryName             Queried Name  
+  @param  Type                  Queried Type 
+  @param  Class                 Queried Class 
+  @param  Packet                The packet for query
 
   @retval EFI_SUCCESS           The packet is constructed.
   @retval Others                Failed to construct the Packet.
 
 **/
 EFI_STATUS
-ConstructDNSQueryIp (
+ConstructDNSQuery (
   IN  DNS_INSTANCE              *Instance,
-  IN  CHAR16                    *HostName,
+  IN  CHAR8                     *QueryName,
   IN  UINT16                    Type,
+  IN  UINT16                    Class,
   OUT NET_BUF                   **Packet
   );
 
diff --git a/NetworkPkg/DnsDxe/DnsProtocol.c b/NetworkPkg/DnsDxe/DnsProtocol.c
index 70857c2b2f49..e7aa227994ed 100644
--- a/NetworkPkg/DnsDxe/DnsProtocol.c
+++ b/NetworkPkg/DnsDxe/DnsProtocol.c
@@ -329,6 +329,8 @@ Dns4HostNameToIp (
   LIST_ENTRY            *Entry;
   LIST_ENTRY            *Next;
   
+  CHAR8                 *QueryName;
+  
   DNS4_TOKEN_ENTRY      *TokenEntry;
   NET_BUF               *Packet;
   
@@ -336,6 +338,7 @@ Dns4HostNameToIp (
   
   Status     = EFI_SUCCESS;
   Item       = NULL;
+  QueryName  = NULL;
   TokenEntry = NULL;
   Packet     = NULL;
   
@@ -438,10 +441,19 @@ Dns4HostNameToIp (
   TokenEntry->QueryHostName = HostName;
   TokenEntry->Token = Token;
 
+  //
+  // Construct QName.
+  //
+  QueryName = DnsFillinQNameForQueryIp (TokenEntry->QueryHostName);
+  if (QueryName == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_EXIT;
+  }
+  
   //
   // Construct DNS Query Packet.
   //
-  Status = ConstructDNSQueryIp (Instance, TokenEntry->QueryHostName, DNS_TYPE_A, &Packet);
+  Status = ConstructDNSQuery (Instance, QueryName, DNS_TYPE_A, DNS_CLASS_INET, &Packet);
   if (EFI_ERROR (Status)) {
     if (TokenEntry != NULL) {
       FreePool (TokenEntry);
@@ -477,6 +489,10 @@ Dns4HostNameToIp (
   }
   
 ON_EXIT:
+  if (QueryName != NULL) {
+    FreePool (QueryName);
+  }
+  
   gBS->RestoreTPL (OldTpl);
   return Status;
 }
@@ -544,7 +560,110 @@ Dns4GeneralLookUp (
   IN  EFI_DNS4_COMPLETION_TOKEN        *Token
   )
 {
-  return EFI_UNSUPPORTED;
+  EFI_STATUS            Status;
+  
+  DNS_INSTANCE          *Instance;
+  
+  EFI_DNS4_CONFIG_DATA  *ConfigData;
+  
+  DNS4_TOKEN_ENTRY      *TokenEntry;
+  NET_BUF               *Packet;
+  
+  EFI_TPL               OldTpl;
+  
+  Status     = EFI_SUCCESS;
+  TokenEntry = NULL;
+  Packet     = NULL;
+  
+  //
+  // Validate the parameters
+  //
+  if ((This == NULL) || (QName == NULL) || Token == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+  
+  OldTpl   = gBS->RaiseTPL (TPL_CALLBACK);
+  
+  Instance = DNS_INSTANCE_FROM_THIS_PROTOCOL4 (This);
+  
+  ConfigData = &(Instance->Dns4CfgData);
+  
+  Instance->MaxRetry = ConfigData->RetryCount;
+  
+  Token->Status = EFI_NOT_READY;
+  Token->RetryCount = 0;
+  Token->RetryInterval = ConfigData->RetryInterval;
+
+  if (Instance->State != DNS_STATE_CONFIGED) {
+    Status = EFI_NOT_STARTED;
+    goto ON_EXIT;
+  }
+
+  //
+  // Check the MaxRetry and RetryInterval values.
+  //
+  if (Instance->MaxRetry == 0) {
+    Instance->MaxRetry = DNS_DEFAULT_RETRY;
+  }
+
+  if (Token->RetryInterval < DNS_DEFAULT_TIMEOUT) {
+    Token->RetryInterval = DNS_DEFAULT_TIMEOUT;
+  }
+
+  //
+  // Construct DNS TokenEntry.
+  //
+  TokenEntry = AllocateZeroPool (sizeof(DNS4_TOKEN_ENTRY));
+  if (TokenEntry == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_EXIT;
+  }
+  
+  TokenEntry->PacketToLive = Token->RetryInterval;
+  TokenEntry->GeneralLookUp = TRUE;
+  TokenEntry->Token = Token;
+
+  //
+  // Construct DNS Query Packet.
+  //
+  Status = ConstructDNSQuery (Instance, QName, QType, QClass, &Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    goto ON_EXIT;
+  }
+
+  //
+  // Save the token into the Dns4TxTokens map.
+  //
+  Status = NetMapInsertTail (&Instance->Dns4TxTokens, TokenEntry, Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    NetbufFree (Packet);
+    
+    goto ON_EXIT;
+  }
+  
+  //
+  // Dns Query Ip
+  //
+  Status = DoDnsQuery (Instance, Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    NetbufFree (Packet);
+  }
+  
+ON_EXIT:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
 }
 
 /**
@@ -978,6 +1097,8 @@ Dns6HostNameToIp (
   LIST_ENTRY            *Entry;
   LIST_ENTRY            *Next;
   
+  CHAR8                 *QueryName;
+  
   DNS6_TOKEN_ENTRY      *TokenEntry;
   NET_BUF               *Packet;
   
@@ -985,6 +1106,7 @@ Dns6HostNameToIp (
   
   Status     = EFI_SUCCESS;
   Item       = NULL;
+  QueryName  = NULL;
   TokenEntry = NULL;
   Packet     = NULL;
 
@@ -1087,10 +1209,20 @@ Dns6HostNameToIp (
   TokenEntry->QueryHostName = HostName;
   TokenEntry->Token = Token;
 
+
+  //
+  // Construct QName.
+  //
+  QueryName = DnsFillinQNameForQueryIp (TokenEntry->QueryHostName);
+  if (QueryName == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_EXIT;
+  }
+  
   //
   // Construct DNS Query Packet.
   //
-  Status = ConstructDNSQueryIp (Instance, TokenEntry->QueryHostName, DNS_TYPE_AAAA, &Packet);
+  Status = ConstructDNSQuery (Instance, QueryName, DNS_TYPE_AAAA, DNS_CLASS_INET, &Packet);
   if (EFI_ERROR (Status)) {
     if (TokenEntry != NULL) {
       FreePool (TokenEntry);
@@ -1126,6 +1258,10 @@ Dns6HostNameToIp (
   }
   
 ON_EXIT:
+  if (QueryName != NULL) {
+    FreePool (QueryName);
+  }
+  
   gBS->RestoreTPL (OldTpl);
   return Status;
 }
@@ -1193,7 +1329,110 @@ Dns6GeneralLookUp (
   IN  EFI_DNS6_COMPLETION_TOKEN         *Token
   )
 {
-  return EFI_UNSUPPORTED;
+  EFI_STATUS            Status;
+  
+  DNS_INSTANCE          *Instance;
+  
+  EFI_DNS6_CONFIG_DATA  *ConfigData;
+  
+  DNS6_TOKEN_ENTRY      *TokenEntry;
+  NET_BUF               *Packet;
+  
+  EFI_TPL               OldTpl;
+  
+  Status     = EFI_SUCCESS;
+  TokenEntry = NULL;
+  Packet     = NULL;
+  
+  //
+  // Validate the parameters
+  //
+  if ((This == NULL) || (QName == NULL) || Token == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+  
+  OldTpl   = gBS->RaiseTPL (TPL_CALLBACK);
+  
+  Instance = DNS_INSTANCE_FROM_THIS_PROTOCOL6 (This);
+  
+  ConfigData = &(Instance->Dns6CfgData);
+  
+  Instance->MaxRetry = ConfigData->RetryCount;
+  
+  Token->Status = EFI_NOT_READY;
+  Token->RetryCount = 0;
+  Token->RetryInterval = ConfigData->RetryInterval;
+
+  if (Instance->State != DNS_STATE_CONFIGED) {
+    Status = EFI_NOT_STARTED;
+    goto ON_EXIT;
+  }
+
+  //
+  // Check the MaxRetry and RetryInterval values.
+  //
+  if (Instance->MaxRetry == 0) {
+    Instance->MaxRetry = DNS_DEFAULT_RETRY;
+  }
+
+  if (Token->RetryInterval < DNS_DEFAULT_TIMEOUT) {
+    Token->RetryInterval = DNS_DEFAULT_TIMEOUT;
+  }
+
+  //
+  // Construct DNS TokenEntry.
+  //
+  TokenEntry = AllocateZeroPool (sizeof(DNS6_TOKEN_ENTRY));
+  if (TokenEntry == NULL) {
+    Status = EFI_OUT_OF_RESOURCES;
+    goto ON_EXIT;
+  }
+  
+  TokenEntry->PacketToLive = Token->RetryInterval;
+  TokenEntry->GeneralLookUp = TRUE;
+  TokenEntry->Token = Token;
+
+  //
+  // Construct DNS Query Packet.
+  //
+  Status = ConstructDNSQuery (Instance, QName, QType, QClass, &Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    goto ON_EXIT;
+  }
+
+  //
+  // Save the token into the Dns6TxTokens map.
+  //
+  Status = NetMapInsertTail (&Instance->Dns6TxTokens, TokenEntry, Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    NetbufFree (Packet);
+    
+    goto ON_EXIT;
+  }
+  
+  //
+  // Dns Query Ip
+  //
+  Status = DoDnsQuery (Instance, Packet);
+  if (EFI_ERROR (Status)) {
+    if (TokenEntry != NULL) {
+      FreePool (TokenEntry);
+    }
+    
+    NetbufFree (Packet);
+  }
+  
+ON_EXIT:
+  gBS->RestoreTPL (OldTpl);
+  return Status;
 }
 
 /**

From f9d8df5a9424268ccee22a5d11b9552ef9a132dc Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Wed, 6 Jan 2016 00:55:38 +0000
Subject: [PATCH 404/525] NetworkPkg: Removing or adding some ASSERT statement

Refine the code by removing or adding some ASSERT statement
to make the code more readable.

Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>
Reviewed-by: Ye Ting  <ting.ye@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19592 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 8339166dd1d8a9b106ee2ee259e5d953d07c5b7c)
---
 NetworkPkg/DnsDxe/DnsImpl.c     | 4 ----
 NetworkPkg/DnsDxe/DnsProtocol.c | 8 ++++++++
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/NetworkPkg/DnsDxe/DnsImpl.c b/NetworkPkg/DnsDxe/DnsImpl.c
index 8725670a8e8a..823bcf379295 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.c
+++ b/NetworkPkg/DnsDxe/DnsImpl.c
@@ -1360,8 +1360,6 @@ ParseDnsResponse (
     // Check whether it's the GeneralLookUp querying.
     //
     if (Instance->Service->IpVersion == IP_VERSION_4 && Dns4TokenEntry->GeneralLookUp) {
-      ASSERT (Dns4TokenEntry != NULL);
-      
       Dns4RR = Dns4TokenEntry->Token->RspData.GLookupData->RRList;
       AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
 
@@ -1387,8 +1385,6 @@ ParseDnsResponse (
       
       RRCount ++;
     } else if (Instance->Service->IpVersion == IP_VERSION_6 && Dns6TokenEntry->GeneralLookUp) {
-      ASSERT (Dns6TokenEntry != NULL);
-      
       Dns6RR = Dns6TokenEntry->Token->RspData.GLookupData->RRList;
       AnswerData = (UINT8 *) AnswerSection + sizeof (*AnswerSection);
 
diff --git a/NetworkPkg/DnsDxe/DnsProtocol.c b/NetworkPkg/DnsDxe/DnsProtocol.c
index e7aa227994ed..a3f3de976619 100644
--- a/NetworkPkg/DnsDxe/DnsProtocol.c
+++ b/NetworkPkg/DnsDxe/DnsProtocol.c
@@ -462,6 +462,8 @@ Dns4HostNameToIp (
     goto ON_EXIT;
   }
 
+  ASSERT (Packet != NULL);
+
   //
   // Save the token into the Dns4TxTokens map.
   //
@@ -635,6 +637,8 @@ Dns4GeneralLookUp (
     goto ON_EXIT;
   }
 
+  ASSERT (Packet != NULL);
+
   //
   // Save the token into the Dns4TxTokens map.
   //
@@ -1231,6 +1235,8 @@ Dns6HostNameToIp (
     goto ON_EXIT;
   }
 
+  ASSERT (Packet != NULL);
+
   //
   // Save the token into the Dns6TxTokens map.
   //
@@ -1404,6 +1410,8 @@ Dns6GeneralLookUp (
     goto ON_EXIT;
   }
 
+  ASSERT (Packet != NULL);
+
   //
   // Save the token into the Dns6TxTokens map.
   //

From c69e1e6442888db71b4bb06356b5689a2bfac1ee Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Wed, 6 Jan 2016 12:34:46 +0000
Subject: [PATCH 405/525] NetworkPkg: DnsDxe: fix return type of
 DnsFillinQNameForQueryIp()

Change the return type of DnsFillinQNameForQueryIp() from (UINT8*) to
(CHAR*). This brings the function in sync with both its internal variables
and all of its call sites, fixing the following gcc build breakage:

> NetworkPkg/DnsDxe/DnsImpl.c: In function 'DnsFillinQNameForQueryIp':
> NetworkPkg/DnsDxe/DnsImpl.c:1068:3: error: pointer targets in return
>                                     differ in signedness
>                                     [-Werror=pointer-sign]
>    return QueryName;
>    ^

The code was added in git commit fcae1a99 (SVN r19579).

Cc: Subramanian Sriram <sriram-s@hpe.com>
Cc: El-Haj-Mahmoud Samer <samer.el-haj-mahmoud@hpe.com>
Cc: Ye Ting <ting.ye@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Cc: Jiaxin Wu <jiaxin.wu@intel.com>
Cc: Ye Ting <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Fu Siyuan <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19609 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit c9c28f38b1f8fc9cde33e63f212776762be99475)
---
 NetworkPkg/DnsDxe/DnsImpl.c | 2 +-
 NetworkPkg/DnsDxe/DnsImpl.h | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/NetworkPkg/DnsDxe/DnsImpl.c b/NetworkPkg/DnsDxe/DnsImpl.c
index 823bcf379295..71daccea800d 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.c
+++ b/NetworkPkg/DnsDxe/DnsImpl.c
@@ -1026,7 +1026,7 @@ AddDns6ServerIp (
   @return           QName filled successfully.
   
 **/ 
-UINT8 *
+CHAR8 *
 EFIAPI
 DnsFillinQNameForQueryIp (
   IN  CHAR16              *HostName
diff --git a/NetworkPkg/DnsDxe/DnsImpl.h b/NetworkPkg/DnsDxe/DnsImpl.h
index a13355f85517..847cd15973ef 100644
--- a/NetworkPkg/DnsDxe/DnsImpl.h
+++ b/NetworkPkg/DnsDxe/DnsImpl.h
@@ -581,7 +581,7 @@ AddDns6ServerIp (
   @return           QName filled successfully.
   
 **/ 
-UINT8 *
+CHAR8 *
 EFIAPI
 DnsFillinQNameForQueryIp (
   IN  CHAR16              *HostName

From 99f0b564db66039d53bef11ffa3a292670523944 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 18 Jan 2016 04:49:22 +0000
Subject: [PATCH 406/525] MdeModulePkg: Add new library class PciHostBridgeLib

PciHostBridgeDxe driver needs PciHostBridgeLib implemented by platform
to provide the root bridge related information and may call into
PciHostBridgeLib when resource conflicts happen.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19655 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 9e9a30bd1699ec050fd8956ccad16aa5bf2b2e4d)
---
 .../Include/Library/PciHostBridgeLib.h        | 97 +++++++++++++++++++
 MdeModulePkg/MdeModulePkg.dec                 |  6 +-
 2 files changed, 102 insertions(+), 1 deletion(-)
 create mode 100644 MdeModulePkg/Include/Library/PciHostBridgeLib.h

diff --git a/MdeModulePkg/Include/Library/PciHostBridgeLib.h b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
new file mode 100644
index 000000000000..b1dba0f754d7
--- /dev/null
+++ b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
@@ -0,0 +1,97 @@
+/** @file
+  PCI Host Bridge Library consumed by PciHostBridgeDxe driver returning
+  the platform specific information about the PCI Host Bridge.
+
+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials are
+  licensed and made available under the terms and conditions of
+  the BSD License which accompanies this distribution.  The full
+  text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#ifndef __PCI_HOST_BRIDGE_LIB_H__
+#define __PCI_HOST_BRIDGE_LIB_H__
+
+//
+// (Base > Limit) indicates an aperture is not available.
+//
+typedef struct {
+  UINT64 Base;
+  UINT64 Limit;
+} PCI_ROOT_BRIDGE_APERTURE;
+
+typedef struct {
+  UINT32                   Segment;              ///< Segment number.
+  UINT64                   Supports;             ///< Supported attributes.
+                                                 ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
+                                                 ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  UINT64                   Attributes;           ///< Initial attributes.
+                                                 ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
+                                                 ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  BOOLEAN                  DmaAbove4G;           ///< DMA above 4GB memory.
+                                                 ///< Set to TRUE when root bridge supports DMA above 4GB memory.
+  UINT64                   AllocationAttributes; ///< Allocation attributes.
+                                                 ///< Refer to EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM and
+                                                 ///< EFI_PCI_HOST_BRIDGE_MEM64_DECODE used by GetAllocAttributes()
+                                                 ///< in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.
+  PCI_ROOT_BRIDGE_APERTURE Bus;                  ///< Bus aperture which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE Io;                   ///< IO aperture which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE Mem;                  ///< MMIO aperture below 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE MemAbove4G;           ///< MMIO aperture above 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE PMem;                 ///< Prefetchable MMIO aperture below 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE PMemAbove4G;          ///< Prefetchable MMIO aperture above 4GB which can be used by the root bridge.
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;          ///< Device path.
+} PCI_ROOT_BRIDGE;
+
+/**
+  Return all the root bridge instances in an array.
+
+  @param Count  Return the count of root bridge instances.
+
+  @return All the root bridge instances in an array.
+          The array should be passed into PciHostBridgeFreeRootBridges()
+          when it's not used.
+**/
+PCI_ROOT_BRIDGE *
+EFIAPI
+PciHostBridgeGetRootBridges (
+  UINTN *Count
+  );
+
+/**
+  Free the root bridge instances array returned from PciHostBridgeGetRootBridges().
+
+  @param  The root bridge instances array.
+  @param  The count of the array.
+**/
+VOID
+EFIAPI
+PciHostBridgeFreeRootBridges (
+  PCI_ROOT_BRIDGE *Bridges,
+  UINTN           Count
+  );
+
+/**
+  Inform the platform that the resource conflict happens.
+
+  @param HostBridgeHandle Handle of the Host Bridge.
+  @param Configuration    Pointer to PCI I/O and PCI memory resource descriptors.
+                          The Configuration contains the resources for all the
+                          root bridges. The resource for each root bridge is
+                          terminated with END descriptor and an additional END
+                          is appended indicating the end of the entire resources.
+                          The resource descriptor field values follow the description
+                          in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.SubmitResources().
+**/
+VOID
+EFIAPI
+PciHostBridgeResourceConflict (
+  EFI_HANDLE           HostBridgeHandle,
+  VOID                 *Configuration
+  );
+
+#endif
diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
index 3c2d42fecc8f..9c28def15493 100644
--- a/MdeModulePkg/MdeModulePkg.dec
+++ b/MdeModulePkg/MdeModulePkg.dec
@@ -3,7 +3,7 @@
 # It also provides the definitions(including PPIs/PROTOCOLs/GUIDs and library classes)
 # and libraries instances, which are used for those modules.
 #
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under
 # the terms and conditions of the BSD License that accompanies this distribution.
 # The full text of the license may be found at
@@ -135,6 +135,10 @@
   #
   IpmiLib|Include/Library/IpmiLib.h
 
+  ## @libraryclass  Provides interfaces for platform to return root bridge information to PciHostBridgeDxe driver.
+  #
+  PciHostBridgeLib|Include/Library/PciHostBridgeLib.h
+
 [Guids]
   ## MdeModule package token space guid
   # Include/Guid/MdeModulePkgTokenSpace.h

From bc97154cd7d0c8367a13f32f2c6921664a40a07e Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 18 Jan 2016 04:49:54 +0000
Subject: [PATCH 407/525] MdeModulePkg: Add PciHostBridgeLibNull

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19656 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 7ff66d3c4a38435e045aa07714ffe69e25d2ff70)
---
 .../PciHostBridgeLibNull.c                    | 104 ++++++++++++++++++
 .../PciHostBridgeLibNull.inf                  |  36 ++++++
 .../PciHostBridgeLibNull.uni                  |  20 ++++
 MdeModulePkg/MdeModulePkg.dsc                 |   3 +-
 4 files changed, 162 insertions(+), 1 deletion(-)
 create mode 100644 MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
 create mode 100644 MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
 create mode 100644 MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.uni

diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
new file mode 100644
index 000000000000..41861b0c535a
--- /dev/null
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
@@ -0,0 +1,104 @@
+/** @file
+  Null instance of PCI Host Bridge Library with empty functions.
+
+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials are
+  licensed and made available under the terms and conditions of
+  the BSD License which accompanies this distribution.  The full
+  text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#include <PiDxe.h>
+#include <Library/PciHostBridgeLib.h>
+#include <Library/DebugLib.h>
+
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *mPciHostBridgeLibAcpiAddressSpaceTypeStr[] = {
+  L"Mem", L"I/O", L"Bus"
+};
+
+/**
+  Return all the root bridge instances in an array.
+
+  @param Count  Return the count of root bridge instances.
+
+  @return All the root bridge instances in an array.
+          The array should be passed into PciHostBridgeFreeRootBridges()
+          when it's not used.
+**/
+PCI_ROOT_BRIDGE *
+EFIAPI
+PciHostBridgeGetRootBridges (
+  UINTN *Count
+  )
+{
+  *Count = 0;
+  return NULL;
+}
+
+/**
+  Free the root bridge instances array returned from PciHostBridgeGetRootBridges().
+
+  @param  The root bridge instances array.
+  @param  The count of the array.
+**/
+VOID
+EFIAPI
+PciHostBridgeFreeRootBridges (
+  PCI_ROOT_BRIDGE *Bridges,
+  UINTN           Count
+  )
+{
+  return;
+}
+
+/**
+  Inform the platform that the resource conflict happens.
+
+  @param HostBridgeHandle Handle of the Host Bridge.
+  @param Configuration    Pointer to PCI I/O and PCI memory resource descriptors.
+                          The Configuration contains the resources for all the
+                          root bridges. The resource for each root bridge is
+                          terminated with END descriptor and an additional END
+                          is appended indicating the end of the entire resources.
+                          The resource descriptor field values follow the description
+                          in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.SubmitResources().
+**/
+VOID
+EFIAPI
+PciHostBridgeResourceConflict (
+  EFI_HANDLE                        HostBridgeHandle,
+  VOID                              *Configuration
+  )
+{
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  UINTN                             RootBridgeIndex;
+  DEBUG ((EFI_D_ERROR, "PciHostBridge: Resource conflict happens!\n"));
+
+  RootBridgeIndex = 0;
+  Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Configuration;
+  while (Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR) {
+    DEBUG ((EFI_D_ERROR, "RootBridge[%d]:\n", RootBridgeIndex++));
+    for (; Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR; Descriptor++) {
+      ASSERT (Descriptor->ResType <
+              sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr) / sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr[0])
+              );
+      DEBUG ((EFI_D_ERROR, " %s: Length/Alignment = 0x%lx / 0x%lx\n",
+              mPciHostBridgeLibAcpiAddressSpaceTypeStr[Descriptor->ResType], Descriptor->AddrLen, Descriptor->AddrRangeMax));
+      if (Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
+        DEBUG ((EFI_D_ERROR, "     Granularity/SpecificFlag = %ld / %02x%s\n",
+                Descriptor->AddrSpaceGranularity, Descriptor->SpecificFlag,
+                ((Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0) ? L" (Prefetchable)" : L""
+                ));
+      }
+    }
+    //
+    // Skip the END descriptor for root bridge
+    //
+    ASSERT (Descriptor->Desc == ACPI_END_TAG_DESCRIPTOR);
+    Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) ((EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor + 1);
+  }
+}
diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
new file mode 100644
index 000000000000..6b3021184493
--- /dev/null
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
@@ -0,0 +1,36 @@
+## @file
+#  Null instance of PCI Host Bridge Library with empty functions.
+#
+#  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PciHostBridgeLibNull
+  MODULE_UNI_FILE                = PciHostBridgeLibNull.uni
+  FILE_GUID                      = A19A6C36-7053-4E2C-8BD0-E8286230E473
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PciHostBridgeLib
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  PciHostBridgeLibNull.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.uni b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.uni
new file mode 100644
index 000000000000..7b0fdee32432
--- /dev/null
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.uni
@@ -0,0 +1,20 @@
+// /** @file
+// Null instance of PCI Host Bridge Library with empty functions.
+//
+// Null instance of PCI Host Bridge Library with empty functions.
+//
+// Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+
+#string STR_MODULE_ABSTRACT             #language en-US "Null instance of PCI Host Bridge Library with empty functions."
+
+#string STR_MODULE_DESCRIPTION          #language en-US "Null instance of PCI Host Bridge Library with empty functions."
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index 562abe8d7223..b1f564ff8bb6 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -2,7 +2,7 @@
 # EFI/PI Reference Module Package for All Architectures
 #
 # (C) Copyright 2014 Hewlett-Packard Development Company, L.P.<BR>
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
 #    are licensed and made available under the terms and conditions of the BSD License
@@ -95,6 +95,7 @@
   S3BootScriptLib|MdeModulePkg/Library/PiDxeS3BootScriptLib/DxeS3BootScriptLib.inf
   CpuExceptionHandlerLib|MdeModulePkg/Library/CpuExceptionHandlerLibNull/CpuExceptionHandlerLibNull.inf
   PlatformBootManagerLib|MdeModulePkg/Library/PlatformBootManagerLibNull/PlatformBootManagerLibNull.inf
+  PciHostBridgeLib|MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
   TpmMeasurementLib|MdeModulePkg/Library/TpmMeasurementLibNull/TpmMeasurementLibNull.inf
   AuthVariableLib|MdeModulePkg/Library/AuthVariableLibNull/AuthVariableLibNull.inf
   VarCheckLib|MdeModulePkg/Library/VarCheckLib/VarCheckLib.inf

From 6e981036198618a9ef1721d6c0e55667239d5f83 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 18 Jan 2016 04:50:04 +0000
Subject: [PATCH 408/525] MdePkg: Add PciSegmentLib instance based on PciLib

This PciSegmentLib instance only supports Segment 0 access.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19657 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 32fa5588ff703507e82bd9c64d56e1baa4076f60)
---
 .../BasePciSegmentLibPci.inf                  |   43 +
 .../BasePciSegmentLibPci.uni                  |   21 +
 .../BasePciSegmentLibPci/PciSegmentLib.c      | 1286 +++++++++++++++++
 MdePkg/MdePkg.dsc                             |    3 +-
 4 files changed, 1352 insertions(+), 1 deletion(-)
 create mode 100644 MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf
 create mode 100644 MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.uni
 create mode 100644 MdePkg/Library/BasePciSegmentLibPci/PciSegmentLib.c

diff --git a/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf b/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf
new file mode 100644
index 000000000000..7dbb22282efc
--- /dev/null
+++ b/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf
@@ -0,0 +1,43 @@
+## @file
+# Instance of PCI Segment Library based on PCI Library.
+#
+# PCI Segment Library that layers on top of the PCI Library which only
+#  supports segment 0 PCI configuration access.
+#
+# Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php.
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = BasePciSegmentLibPci
+  MODULE_UNI_FILE                = BasePciSegmentLibPci.uni
+  FILE_GUID                      = AABF95D6-F40C-405F-8360-6A59794B8040
+  MODULE_TYPE                    = BASE
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PciSegmentLib
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
+#
+
+[Sources]
+  PciSegmentLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+
+[LibraryClasses]
+  BaseLib
+  PciLib
+  DebugLib
diff --git a/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.uni b/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.uni
new file mode 100644
index 000000000000..f5893d96d0f1
--- /dev/null
+++ b/MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.uni
@@ -0,0 +1,21 @@
+// /** @file
+// Instance of PCI Segment Library based on PCI Library.
+//
+// PCI Segment Library that layers on top of the PCI Library which only
+//  supports segment 0 PCI configuration access.
+//
+// Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php.
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+
+#string STR_MODULE_ABSTRACT             #language en-US "Instance of PCI Segment Library based on PCI Library."
+
+#string STR_MODULE_DESCRIPTION          #language en-US "PCI Segment Library that layers on top of the PCI Library which only supports segment 0 PCI configuration access."
diff --git a/MdePkg/Library/BasePciSegmentLibPci/PciSegmentLib.c b/MdePkg/Library/BasePciSegmentLibPci/PciSegmentLib.c
new file mode 100644
index 000000000000..dc2745bf3ad2
--- /dev/null
+++ b/MdePkg/Library/BasePciSegmentLibPci/PciSegmentLib.c
@@ -0,0 +1,1286 @@
+/** @file
+  PCI Segment Library that layers on top of the PCI Library which only
+   supports segment 0 PCI configuration access.
+
+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials are
+  licensed and made available under the terms and conditions of
+  the BSD License which accompanies this distribution.  The full
+  text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php.
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Base.h>
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/PciLib.h>
+#include <Library/PciSegmentLib.h>
+
+/**
+  Assert the validity of a PCI Segment address.
+  A valid PCI Segment address should not contain 1's in bits 28..31 and 48..63
+  and the segment should be 0.
+
+  @param  A The address to validate.
+  @param  M Additional bits to assert to be zero.
+
+**/
+#define ASSERT_INVALID_PCI_SEGMENT_ADDRESS(A,M) \
+  ASSERT (((A) & (0xfffffffff0000000ULL | (M))) == 0)
+
+/**
+  Convert the PCI Segment library address to PCI library address.
+
+  @param A The address to convert.
+**/
+#define PCI_SEGMENT_TO_PCI_ADDRESS(A) ((UINTN) (UINT32) A)
+
+/**
+  Register a PCI device so PCI configuration registers may be accessed after
+  SetVirtualAddressMap().
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address The address that encodes the PCI Bus, Device, Function and
+                  Register.
+
+  @retval RETURN_SUCCESS           The PCI device was registered for runtime access.
+  @retval RETURN_UNSUPPORTED       An attempt was made to call this function
+                                   after ExitBootServices().
+  @retval RETURN_UNSUPPORTED       The resources required to access the PCI device
+                                   at runtime could not be mapped.
+  @retval RETURN_OUT_OF_RESOURCES  There are not enough resources available to
+                                   complete the registration.
+
+**/
+RETURN_STATUS
+EFIAPI
+PciSegmentRegisterForRuntimeAccess (
+  IN UINTN  Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+  return PciRegisterForRuntimeAccess (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Reads an 8-bit PCI configuration register.
+
+  Reads and returns the 8-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 8-bit PCI configuration register specified by Address.
+
+**/
+UINT8
+EFIAPI
+PciSegmentRead8 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+
+  return PciRead8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes an 8-bit PCI configuration register.
+
+  Writes the 8-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentWrite8 (
+  IN UINT64                    Address,
+  IN UINT8                     Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 0);
+
+  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of an 8-bit PCI configuration register with an 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     OrData
+  )
+{
+  return PciWrite8 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), (UINT8) (PciSegmentRead8 (Address) | OrData));
+}
+
+/**
+  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentAnd8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData
+  )
+{
+  return PciSegmentWrite8 (Address, (UINT8) (PciSegmentRead8 (Address) & AndData));
+}
+
+/**
+  Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit value,
+  followed a  bitwise OR with another 8-bit value.
+
+  Reads the 8-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the 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 8-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData    The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (Address, (UINT8) ((PciSegmentRead8 (Address) & AndData) | OrData));
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in an 8-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to read.
+  @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 value of the bit field read from the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldRead8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead8 (PciSegmentRead8 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  8-bit register is returned.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to write.
+  @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 value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldWrite8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     Value
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldWrite8 (PciSegmentRead8 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit PCI configuration, performs a bitwise OR, and
+  writes the result back to the bit field in the 8-bit port.
+
+  Reads the 8-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 8-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized. Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to write.
+  @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 PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldOr8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldOr8 (PciSegmentRead8 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit PCI configuration register, performs a bitwise
+  AND, and writes the result back to the bit field in the 8-bit register.
+
+  Reads the 8-bit PCI configuration register specified by Address, performs a
+  bitwise AND between the read result and the value specified by AndData, and
+  writes the result to the 8-bit PCI configuration register specified by
+  Address. The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are
+  serialized. Extra left bits in AndData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to write.
+  @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 PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldAnd8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     AndData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldAnd8 (PciSegmentRead8 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in an 8-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  8-bit port.
+
+  Reads the 8-bit PCI configuration register specified by Address, 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 8-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to write.
+  @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 PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT8
+EFIAPI
+PciSegmentBitFieldAndThenOr8 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT8                     AndData,
+  IN UINT8                     OrData
+  )
+{
+  return PciSegmentWrite8 (
+           Address,
+           BitFieldAndThenOr8 (PciSegmentRead8 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a 16-bit PCI configuration register.
+
+  Reads and returns the 16-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 16-bit PCI configuration register specified by Address.
+
+**/
+UINT16
+EFIAPI
+PciSegmentRead16 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
+
+  return PciRead16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes a 16-bit PCI configuration register.
+
+  Writes the 16-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+
+**/
+UINT16
+EFIAPI
+PciSegmentWrite16 (
+  IN UINT64                    Address,
+  IN UINT16                    Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 1);
+
+  return PciWrite16 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of a 16-bit PCI configuration register with
+  a 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 16-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address The address that encodes the PCI Segment, Bus, Device, Function and
+                  Register.
+  @param  OrData  The value to OR with the PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16 (Address) | OrData));
+}
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentAnd16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) (PciSegmentRead16 (Address) & AndData));
+}
+
+/**
+  Performs a bitwise AND of a 16-bit PCI configuration register with a 16-bit value,
+  followed a  bitwise OR with another 16-bit value.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the 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 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData    The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (Address, (UINT16) ((PciSegmentRead16 (Address) & AndData) | OrData));
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in a 16-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, 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  Address   The PCI configuration register to read.
+  @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 value of the bit field read from the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldRead16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead16 (PciSegmentRead16 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  16-bit register is returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, 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  Address   The PCI configuration register to write.
+  @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 value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldWrite16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    Value
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldWrite16 (PciSegmentRead16 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, 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  Address   The PCI configuration register to write.
+  @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 PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldOr16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldOr16 (PciSegmentRead16 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in a 16-bit PCI configuration, performs a bitwise OR,
+  and writes the result back to the bit field in the 16-bit port.
+
+  Reads the 16-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 16-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+  Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 16-bit boundary, 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  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  StartBit  The ordinal of the least significant bit in the bit field.
+                    The ordinal of the least significant bit in a byte is bit 0.
+  @param  EndBit    The ordinal of the most significant bit in the bit field.
+                    The ordinal of the most significant bit in a byte is bit 7.
+  @param  AndData   The value to AND with the read value from the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldAnd16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    AndData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldAnd16 (PciSegmentRead16 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in a 16-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  16-bit port.
+
+  Reads the 16-bit PCI configuration register specified by Address, 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 16-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register to write.
+  @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 PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT16
+EFIAPI
+PciSegmentBitFieldAndThenOr16 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT16                    AndData,
+  IN UINT16                    OrData
+  )
+{
+  return PciSegmentWrite16 (
+           Address,
+           BitFieldAndThenOr16 (PciSegmentRead16 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a 32-bit PCI configuration register.
+
+  Reads and returns the 32-bit PCI configuration register specified by Address.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+
+  @return The 32-bit PCI configuration register specified by Address.
+
+**/
+UINT32
+EFIAPI
+PciSegmentRead32 (
+  IN UINT64                    Address
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
+
+  return PciRead32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address));
+}
+
+/**
+  Writes a 32-bit PCI configuration register.
+
+  Writes the 32-bit PCI configuration register specified by Address with the value specified by Value.
+  Value is returned.  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  Value       The value to write.
+
+  @return The parameter of Value.
+
+**/
+UINT32
+EFIAPI
+PciSegmentWrite32 (
+  IN UINT64                    Address,
+  IN UINT32                    Value
+  )
+{
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (Address, 3);
+
+  return PciWrite32 (PCI_SEGMENT_TO_PCI_ADDRESS (Address), Value);
+}
+
+/**
+  Performs a bitwise OR of a 32-bit PCI configuration register with a 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise OR between the read result and the value specified by OrData,
+  and writes the result to the 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) | OrData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the read result and the value specified by AndData,
+  and writes the result to the 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentAnd32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData
+  )
+{
+  return PciSegmentWrite32 (Address, PciSegmentRead32 (Address) & AndData);
+}
+
+/**
+  Performs a bitwise AND of a 32-bit PCI configuration register with a 32-bit value,
+  followed a  bitwise OR with another 32-bit value.
+
+  Reads the 32-bit PCI configuration register specified by Address,
+  performs a bitwise AND between the 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 32-bit PCI configuration register specified by Address.
+  The value written to the PCI configuration register is returned.
+  This function must guarantee that all PCI read and write operations are serialized.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, then ASSERT().
+
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.
+  @param  AndData   The value to AND with the PCI configuration register.
+  @param  OrData    The value to OR with the PCI configuration register.
+
+  @return The value written to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (Address, (PciSegmentRead32 (Address) & AndData) | OrData);
+}
+
+/**
+  Reads a bit field of a PCI configuration register.
+
+  Reads the bit field in a 32-bit PCI configuration register. The bit field is
+  specified by the StartBit and the EndBit. The value of the bit field is
+  returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, 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  Address   The PCI configuration register 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 value of the bit field read from the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldRead32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit
+  )
+{
+  return BitFieldRead32 (PciSegmentRead32 (Address), StartBit, EndBit);
+}
+
+/**
+  Writes a bit field to a PCI configuration register.
+
+  Writes Value to the bit field of the PCI configuration register. The bit
+  field is specified by the StartBit and the EndBit. All other bits in the
+  destination PCI configuration register are preserved. The new value of the
+  32-bit register is returned.
+
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, 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  Address   The PCI configuration register 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 value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldWrite32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    Value
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldWrite32 (PciSegmentRead32 (Address), StartBit, EndBit, Value)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit PCI configuration, performs a bitwise OR, and
+  writes the result back to the bit field in the 32-bit port.
+
+  Reads the 32-bit PCI configuration register specified by Address, performs a
+  bitwise OR between the read result and the value specified by
+  OrData, and writes the result to the 32-bit PCI configuration register
+  specified by Address. The value written to the PCI configuration register is
+  returned. This function must guarantee that all PCI read and write operations
+  are serialized. Extra left bits in OrData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register 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 PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldOr32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldOr32 (PciSegmentRead32 (Address), StartBit, EndBit, OrData)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit PCI configuration register, performs a bitwise
+  AND, and writes the result back to the bit field in the 32-bit register.
+
+
+  Reads the 32-bit PCI configuration register specified by Address, performs a bitwise
+  AND between the read result and the value specified by AndData, and writes the result
+  to the 32-bit PCI configuration register specified by Address. The value written to
+  the PCI configuration register is returned.  This function must guarantee that all PCI
+  read and write operations are serialized.  Extra left bits in AndData are stripped.
+  If any reserved bits in Address are set, then ASSERT().
+  If Address is not aligned on a 32-bit boundary, 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  Address   The PCI configuration register 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 PCI configuration register.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldAnd32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    AndData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldAnd32 (PciSegmentRead32 (Address), StartBit, EndBit, AndData)
+           );
+}
+
+/**
+  Reads a bit field in a 32-bit port, performs a bitwise AND followed by a
+  bitwise OR, and writes the result back to the bit field in the
+  32-bit port.
+
+  Reads the 32-bit PCI configuration register specified by Address, 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 32-bit PCI
+  configuration register specified by Address. The value written to the PCI
+  configuration register is returned. This function must guarantee that all PCI
+  read and write operations are serialized. Extra left bits in both AndData and
+  OrData are stripped.
+
+  If any reserved bits in Address are set, 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  Address   The PCI configuration register 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 PCI configuration register.
+  @param  OrData    The value to OR with the result of the AND operation.
+
+  @return The value written back to the PCI configuration register.
+
+**/
+UINT32
+EFIAPI
+PciSegmentBitFieldAndThenOr32 (
+  IN UINT64                    Address,
+  IN UINTN                     StartBit,
+  IN UINTN                     EndBit,
+  IN UINT32                    AndData,
+  IN UINT32                    OrData
+  )
+{
+  return PciSegmentWrite32 (
+           Address,
+           BitFieldAndThenOr32 (PciSegmentRead32 (Address), StartBit, EndBit, AndData, OrData)
+           );
+}
+
+/**
+  Reads a range of PCI configuration registers into a caller supplied buffer.
+
+  Reads the range of PCI configuration registers specified by StartAddress and
+  Size into the buffer specified by Buffer. This function only allows the PCI
+  configuration registers from a single PCI function to be read. Size is
+  returned. When possible 32-bit PCI configuration read cycles are used to read
+  from StartAdress to StartAddress + Size. Due to alignment restrictions, 8-bit
+  and 16-bit PCI configuration read cycles may be used at the beginning and the
+  end of the range.
+
+  If any reserved bits in StartAddress are set, then ASSERT().
+  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
+  If Size > 0 and Buffer is NULL, then ASSERT().
+
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,
+                        Function and Register.
+  @param  Size          The size in bytes of the transfer.
+  @param  Buffer        The pointer to a buffer receiving the data read.
+
+  @return Size
+
+**/
+UINTN
+EFIAPI
+PciSegmentReadBuffer (
+  IN  UINT64                   StartAddress,
+  IN  UINTN                    Size,
+  OUT VOID                     *Buffer
+  )
+{
+  UINTN                                ReturnValue;
+
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
+  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
+
+  if (Size == 0) {
+    return Size;
+  }
+
+  ASSERT (Buffer != NULL);
+
+  //
+  // Save Size for return
+  //
+  ReturnValue = Size;
+
+  if ((StartAddress & BIT0) != 0) {
+    //
+    // Read a byte if StartAddress is byte aligned
+    //
+    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
+    StartAddress += sizeof (UINT8);
+    Size -= sizeof (UINT8);
+    Buffer = (UINT8*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
+    //
+    // Read a word if StartAddress is word aligned
+    //
+    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*)Buffer + 1;
+  }
+
+  while (Size >= sizeof (UINT32)) {
+    //
+    // Read as many double words as possible
+    //
+    WriteUnaligned32 (Buffer, PciSegmentRead32 (StartAddress));
+    StartAddress += sizeof (UINT32);
+    Size -= sizeof (UINT32);
+    Buffer = (UINT32*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16)) {
+    //
+    // Read the last remaining word if exist
+    //
+    WriteUnaligned16 (Buffer, PciSegmentRead16 (StartAddress));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*)Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT8)) {
+    //
+    // Read the last remaining byte if exist
+    //
+    *(volatile UINT8 *)Buffer = PciSegmentRead8 (StartAddress);
+  }
+
+  return ReturnValue;
+}
+
+/**
+  Copies the data in a caller supplied buffer to a specified range of PCI
+  configuration space.
+
+  Writes the range of PCI configuration registers specified by StartAddress and
+  Size from the buffer specified by Buffer. This function only allows the PCI
+  configuration registers from a single PCI function to be written. Size is
+  returned. When possible 32-bit PCI configuration write cycles are used to
+  write from StartAdress to StartAddress + Size. Due to alignment restrictions,
+  8-bit and 16-bit PCI configuration write cycles may be used at the beginning
+  and the end of the range.
+
+  If any reserved bits in StartAddress are set, then ASSERT().
+  If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().
+  If Size > 0 and Buffer is NULL, then ASSERT().
+
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,
+                        Function and Register.
+  @param  Size          The size in bytes of the transfer.
+  @param  Buffer        The pointer to a buffer containing the data to write.
+
+  @return The parameter of Size.
+
+**/
+UINTN
+EFIAPI
+PciSegmentWriteBuffer (
+  IN UINT64                    StartAddress,
+  IN UINTN                     Size,
+  IN VOID                      *Buffer
+  )
+{
+  UINTN                                ReturnValue;
+
+  ASSERT_INVALID_PCI_SEGMENT_ADDRESS (StartAddress, 0);
+  ASSERT (((StartAddress & 0xFFF) + Size) <= 0x1000);
+
+  if (Size == 0) {
+    return 0;
+  }
+
+  ASSERT (Buffer != NULL);
+
+  //
+  // Save Size for return
+  //
+  ReturnValue = Size;
+
+  if ((StartAddress & BIT0) != 0) {
+    //
+    // Write a byte if StartAddress is byte aligned
+    //
+    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
+    StartAddress += sizeof (UINT8);
+    Size -= sizeof (UINT8);
+    Buffer = (UINT8*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16) && (StartAddress & BIT1) != 0) {
+    //
+    // Write a word if StartAddress is word aligned
+    //
+    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*) Buffer + 1;
+  }
+
+  while (Size >= sizeof (UINT32)) {
+    //
+    // Write as many double words as possible
+    //
+    PciSegmentWrite32 (StartAddress, ReadUnaligned32 (Buffer));
+    StartAddress += sizeof (UINT32);
+    Size -= sizeof (UINT32);
+    Buffer = (UINT32*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT16)) {
+    //
+    // Write the last remaining word if exist
+    //
+    PciSegmentWrite16 (StartAddress, ReadUnaligned16 (Buffer));
+    StartAddress += sizeof (UINT16);
+    Size -= sizeof (UINT16);
+    Buffer = (UINT16*) Buffer + 1;
+  }
+
+  if (Size >= sizeof (UINT8)) {
+    //
+    // Write the last remaining byte if exist
+    //
+    PciSegmentWrite8 (StartAddress, *(UINT8*) Buffer);
+  }
+
+  return ReturnValue;
+}
diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index 4ea367ccc070..404115d97ed9 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -1,7 +1,7 @@
 ## @file
 # EFI/PI MdePkg Package
 #
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 # Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
 #
 #    This program and the accompanying materials
@@ -68,6 +68,7 @@
   MdePkg/Library/BasePciExpressLib/BasePciExpressLib.inf
   MdePkg/Library/BasePciLibCf8/BasePciLibCf8.inf
   MdePkg/Library/BasePciLibPciExpress/BasePciLibPciExpress.inf
+  MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf
   MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
   MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
   MdePkg/Library/BasePeCoffExtraActionLibNull/BasePeCoffExtraActionLibNull.inf

From d5ad92456367d34026246d02648c36e2f4808cf4 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Mon, 18 Jan 2016 04:50:18 +0000
Subject: [PATCH 409/525] MdeModulePkg: Add generic PciHostBridgeDxe driver.

This driver links to PciHostBridgeLib provided by platform/silicon to
produce PciRootBridgeIo and PciHostBridgeResourceAllocation protocol.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19658 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 4a50cf4ebd7e1ba5b9218a37fb33093fb23ec5ec)
---
 .../Bus/Pci/PciHostBridgeDxe/PciHostBridge.c  | 1134 ++++++++++++
 .../Bus/Pci/PciHostBridgeDxe/PciHostBridge.h  |  252 +++
 .../Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf |   55 +
 .../Pci/PciHostBridgeDxe/PciHostResource.h    |   47 +
 .../Bus/Pci/PciHostBridgeDxe/PciRootBridge.h  |  568 ++++++
 .../Pci/PciHostBridgeDxe/PciRootBridgeIo.c    | 1561 +++++++++++++++++
 MdeModulePkg/MdeModulePkg.dsc                 |    2 +
 7 files changed, 3619 insertions(+)
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostResource.h
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
 create mode 100644 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
new file mode 100644
index 000000000000..08285d84d501
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
@@ -0,0 +1,1134 @@
+/** @file
+
+  Provides the basic interfaces to abstract a PCI Host Bridge Resource Allocation.
+
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PciHostBridge.h"
+#include "PciRootBridge.h"
+#include "PciHostResource.h"
+
+
+EFI_METRONOME_ARCH_PROTOCOL *mMetronome;
+EFI_CPU_IO2_PROTOCOL        *mCpuIo;
+
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *mAcpiAddressSpaceTypeStr[] = {
+  L"Mem", L"I/O", L"Bus"
+};
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *mPciResourceTypeStr[] = {
+  L"I/O", L"Mem", L"PMem", L"Mem64", L"PMem64", L"Bus"
+};
+
+/**
+
+  Entry point of this driver.
+
+  @param ImageHandle  Image handle of this driver.
+  @param SystemTable  Pointer to standard EFI system table.
+
+  @retval EFI_SUCCESS       Succeed.
+  @retval EFI_DEVICE_ERROR  Fail to install PCI_ROOT_BRIDGE_IO protocol.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializePciHostBridge (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  )
+{
+  EFI_STATUS                  Status;
+  PCI_HOST_BRIDGE_INSTANCE    *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE    *RootBridge;
+  PCI_ROOT_BRIDGE             *RootBridges;
+  UINTN                       RootBridgeCount;
+  UINTN                       Index;
+  PCI_ROOT_BRIDGE_APERTURE    *MemApertures[4];
+  UINTN                       MemApertureIndex;
+
+  RootBridges = PciHostBridgeGetRootBridges (&RootBridgeCount);
+  if ((RootBridges == NULL) || (RootBridgeCount == 0)) {
+    return EFI_UNSUPPORTED;
+  }
+
+  Status = gBS->LocateProtocol (&gEfiMetronomeArchProtocolGuid, NULL, (VOID **) &mMetronome);
+  ASSERT_EFI_ERROR (Status);
+  Status = gBS->LocateProtocol (&gEfiCpuIo2ProtocolGuid, NULL, (VOID **) &mCpuIo);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Most systems in the world including complex servers have only one Host Bridge.
+  //
+  HostBridge = AllocateZeroPool (sizeof (PCI_HOST_BRIDGE_INSTANCE));
+  ASSERT (HostBridge != NULL);
+
+  HostBridge->Signature        = PCI_HOST_BRIDGE_SIGNATURE;
+  HostBridge->CanRestarted     = TRUE;
+  InitializeListHead (&HostBridge->RootBridges);
+
+  HostBridge->ResAlloc.NotifyPhase          = NotifyPhase;
+  HostBridge->ResAlloc.GetNextRootBridge    = GetNextRootBridge;
+  HostBridge->ResAlloc.GetAllocAttributes   = GetAttributes;
+  HostBridge->ResAlloc.StartBusEnumeration  = StartBusEnumeration;
+  HostBridge->ResAlloc.SetBusNumbers        = SetBusNumbers;
+  HostBridge->ResAlloc.SubmitResources      = SubmitResources;
+  HostBridge->ResAlloc.GetProposedResources = GetProposedResources;
+  HostBridge->ResAlloc.PreprocessController = PreprocessController;
+
+  Status = gBS->InstallMultipleProtocolInterfaces (
+                  &HostBridge->Handle,
+                  &gEfiPciHostBridgeResourceAllocationProtocolGuid, &HostBridge->ResAlloc,
+                  NULL
+                  );
+  if (EFI_ERROR (Status)) {
+    FreePool (HostBridge);
+    PciHostBridgeFreeRootBridges (RootBridges, RootBridgeCount);
+    return Status;
+  }
+
+  //
+  // Create Root Bridge Device Handle in this Host Bridge
+  //
+  for (Index = 0; Index < RootBridgeCount; Index++) {
+    //
+    // Create Root Bridge Handle Instance
+    //
+    RootBridge = CreateRootBridge (&RootBridges[Index], HostBridge->Handle);
+    ASSERT (RootBridge != NULL);
+    if (RootBridge == NULL) {
+      continue;
+    }
+
+    if (RootBridges[Index].Io.Limit > RootBridges[Index].Io.Base) {
+      Status = gDS->AddIoSpace (
+                      EfiGcdIoTypeIo,
+                      RootBridges[Index].Io.Base,
+                      RootBridges[Index].Io.Limit - RootBridges[Index].Io.Base + 1
+                      );
+      ASSERT_EFI_ERROR (Status);
+    }
+
+    //
+    // Add all the Mem/PMem aperture to GCD
+    // Mem/PMem shouldn't overlap with each other
+    // Root bridge which needs to combine MEM and PMEM should only report
+    // the MEM aperture in Mem
+    //
+    MemApertures[0] = &RootBridges[Index].Mem;
+    MemApertures[1] = &RootBridges[Index].MemAbove4G;
+    MemApertures[2] = &RootBridges[Index].PMem;
+    MemApertures[3] = &RootBridges[Index].PMemAbove4G;
+
+    for (MemApertureIndex = 0; MemApertureIndex < sizeof (MemApertures) / sizeof (MemApertures[0]); MemApertureIndex++) {
+      if (MemApertures[MemApertureIndex]->Limit > MemApertures[MemApertureIndex]->Base) {
+        Status = gDS->AddMemorySpace (
+                        EfiGcdMemoryTypeMemoryMappedIo,
+                        MemApertures[MemApertureIndex]->Base,
+                        MemApertures[MemApertureIndex]->Limit - MemApertures[MemApertureIndex]->Base + 1,
+                        EFI_MEMORY_UC
+                        );
+        ASSERT_EFI_ERROR (Status);
+        Status = gDS->SetMemorySpaceAttributes (
+                        MemApertures[MemApertureIndex]->Base,
+                        MemApertures[MemApertureIndex]->Limit - MemApertures[MemApertureIndex]->Base + 1,
+                        EFI_MEMORY_UC
+                        );
+        ASSERT_EFI_ERROR (Status);
+      }
+    }
+    //
+    // Insert Root Bridge Handle Instance
+    //
+    Status = gBS->InstallMultipleProtocolInterfaces (
+                    &RootBridge->Handle,
+                    &gEfiDevicePathProtocolGuid, RootBridge->DevicePath,
+                    &gEfiPciRootBridgeIoProtocolGuid, &RootBridge->RootBridgeIo,
+                    NULL
+                    );
+    ASSERT_EFI_ERROR (Status);
+    InsertTailList (&HostBridge->RootBridges, &RootBridge->Link);
+  }
+  PciHostBridgeFreeRootBridges (RootBridges, RootBridgeCount);
+  return Status;
+}
+
+/**
+  This routine constructs the resource descriptors for all root bridges and call PciHostBridgeResourceConflict().
+
+  @param HostBridge The Host Bridge Instance where the resource adjustment happens.
+**/
+VOID
+ResourceConflict (
+  IN  PCI_HOST_BRIDGE_INSTANCE *HostBridge
+  )
+{
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Resources;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  EFI_ACPI_END_TAG_DESCRIPTOR       *End;
+  PCI_ROOT_BRIDGE_INSTANCE          *RootBridge;
+  LIST_ENTRY                        *Link;
+  UINTN                             RootBridgeCount;
+  PCI_RESOURCE_TYPE                 Index;
+  PCI_RES_NODE                      *ResAllocNode;
+
+  RootBridgeCount = 0;
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridgeCount++;
+  }
+
+  Resources = AllocatePool (
+                RootBridgeCount * (TypeMax * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR)) +
+                sizeof (EFI_ACPI_END_TAG_DESCRIPTOR)
+                );
+  ASSERT (Resources != NULL);
+
+  for (Link = GetFirstNode (&HostBridge->RootBridges), Descriptor = Resources
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    for (Index = TypeIo; Index < TypeMax; Index++) {
+      ResAllocNode = &RootBridge->ResAllocNode[Index];
+
+      Descriptor->Desc = ACPI_ADDRESS_SPACE_DESCRIPTOR;
+      Descriptor->Len = sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) - 3;
+      Descriptor->AddrRangeMin = ResAllocNode->Base;
+      Descriptor->AddrRangeMax = ResAllocNode->Alignment;
+      Descriptor->AddrLen = ResAllocNode->Length;
+      switch (ResAllocNode->Type) {
+
+      case TypeIo:
+        Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_IO;
+        break;
+
+      case TypePMem32:
+        Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+      case TypeMem32:
+        Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_MEM;
+        Descriptor->AddrSpaceGranularity = 32;
+        break;
+
+      case TypePMem64:
+        Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+      case TypeMem64:
+        Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_MEM;
+        Descriptor->AddrSpaceGranularity = 64;
+        break;
+
+      case TypeBus:
+        Descriptor->ResType = ACPI_ADDRESS_SPACE_TYPE_BUS;
+        break;
+
+      default:
+        break;
+      }
+
+      Descriptor++;
+    }
+    //
+    // Terminate the root bridge resources.
+    //
+    End = (EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor;
+    End->Desc = ACPI_END_TAG_DESCRIPTOR;
+    End->Checksum = 0x0;
+
+    Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) (End + 1);
+  }
+  //
+  // Terminate the host bridge resources.
+  //
+  End = (EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor;
+  End->Desc = ACPI_END_TAG_DESCRIPTOR;
+  End->Checksum = 0x0;
+
+  DEBUG ((DEBUG_ERROR, "Call PciHostBridgeResourceConflict().\n"));
+  PciHostBridgeResourceConflict (HostBridge->Handle, Resources);
+  FreePool (Resources);
+}
+
+UINT64
+AllocateResource (
+  BOOLEAN Mmio,
+  UINT64  Length,
+  UINTN   BitsOfAlignment,
+  UINT64  BaseAddress,
+  UINT64  Limit
+  )
+{
+  EFI_STATUS Status;
+
+  if (BaseAddress < Limit) {
+    //
+    // Have to make sure Aligment is handled since we are doing direct address allocation
+    //
+    BaseAddress = ALIGN_VALUE (BaseAddress, LShiftU64 (1, BitsOfAlignment));
+
+    while (BaseAddress + Length <= Limit + 1) {
+      if (Mmio) {
+        Status = gDS->AllocateMemorySpace (
+                        EfiGcdAllocateAddress,
+                        EfiGcdMemoryTypeMemoryMappedIo,
+                        BitsOfAlignment,
+                        Length,
+                        &BaseAddress,
+                        gImageHandle,
+                        NULL
+                        );
+      } else {
+        Status = gDS->AllocateIoSpace (
+                        EfiGcdAllocateAddress,
+                        EfiGcdIoTypeIo,
+                        BitsOfAlignment,
+                        Length,
+                        &BaseAddress,
+                        gImageHandle,
+                        NULL
+                        );
+      }
+
+      if (!EFI_ERROR (Status)) {
+        return BaseAddress;
+      }
+      BaseAddress += LShiftU64 (1, BitsOfAlignment);
+    }
+  }
+  return MAX_UINT64;
+}
+/**
+
+  Enter a certain phase of the PCI enumeration process.
+
+  @param This   The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
+  @param Phase  The phase during enumeration.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  Wrong phase parameter passed in.
+  @retval EFI_NOT_READY          Resources have not been submitted yet.
+
+**/
+EFI_STATUS
+EFIAPI
+NotifyPhase (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE    Phase
+  )
+{
+  PCI_HOST_BRIDGE_INSTANCE              *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE              *RootBridge;
+  LIST_ENTRY                            *Link;
+  EFI_PHYSICAL_ADDRESS                  BaseAddress;
+  UINT64                                AddrLen;
+  UINTN                                 BitsOfAlignment;
+  UINT64                                Alignment;
+  EFI_STATUS                            Status;
+  EFI_STATUS                            ReturnStatus;
+  PCI_RESOURCE_TYPE                     Index;
+  PCI_RESOURCE_TYPE                     Index1;
+  PCI_RESOURCE_TYPE                     Index2;
+  BOOLEAN                               ResNodeHandled[TypeMax];
+  UINT64                                MaxAlignment;
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+
+  switch (Phase) {
+  case EfiPciHostBridgeBeginEnumeration:
+    if (!HostBridge->CanRestarted) {
+      return EFI_NOT_READY;
+    }
+    //
+    // Reset Root Bridge
+    //
+    for (Link = GetFirstNode (&HostBridge->RootBridges)
+          ; !IsNull (&HostBridge->RootBridges, Link)
+          ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+          ) {
+      RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+      for (Index = TypeIo; Index < TypeMax; Index++) {
+        RootBridge->ResAllocNode[Index].Type   = Index;
+        RootBridge->ResAllocNode[Index].Base   = 0;
+        RootBridge->ResAllocNode[Index].Length = 0;
+        RootBridge->ResAllocNode[Index].Status = ResNone;
+
+        RootBridge->ResourceSubmitted = FALSE;
+      }
+    }
+
+    HostBridge->CanRestarted = TRUE;
+    break;
+
+  case EfiPciHostBridgeBeginBusAllocation:
+    //
+    // No specific action is required here, can perform any chipset specific programing
+    //
+    HostBridge->CanRestarted = FALSE;
+    break;
+
+  case EfiPciHostBridgeEndBusAllocation:
+    //
+    // No specific action is required here, can perform any chipset specific programing
+    //
+    break;
+
+  case EfiPciHostBridgeBeginResourceAllocation:
+    //
+    // No specific action is required here, can perform any chipset specific programing
+    //
+    break;
+
+  case EfiPciHostBridgeAllocateResources:
+    ReturnStatus = EFI_SUCCESS;
+
+    //
+    // Make sure the resource for all root bridges has been submitted.
+    //
+    for (Link = GetFirstNode (&HostBridge->RootBridges)
+         ; !IsNull (&HostBridge->RootBridges, Link)
+         ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+         ) {
+      RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+      if (!RootBridge->ResourceSubmitted) {
+        return EFI_NOT_READY;
+      }
+    }
+
+    DEBUG ((EFI_D_INFO, "PciHostBridge: NotifyPhase (AllocateResources)\n"));
+    for (Link = GetFirstNode (&HostBridge->RootBridges)
+         ; !IsNull (&HostBridge->RootBridges, Link)
+         ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+         ) {
+      for (Index = TypeIo; Index < TypeBus; Index++) {
+        ResNodeHandled[Index] = FALSE;
+      }
+
+      RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+      DEBUG ((EFI_D_INFO, " RootBridge: %s\n", RootBridge->DevicePathStr));
+
+      for (Index1 = TypeIo; Index1 < TypeBus; Index1++) {
+        if (RootBridge->ResAllocNode[Index1].Status == ResNone) {
+          ResNodeHandled[Index1] = TRUE;
+        } else {
+          //
+          // Allocate the resource node with max alignment at first
+          //
+          MaxAlignment = 0;
+          Index = TypeMax;
+          for (Index2 = TypeIo; Index2 < TypeBus; Index2++) {
+            if (ResNodeHandled[Index2]) {
+              continue;
+            }
+            if (MaxAlignment <= RootBridge->ResAllocNode[Index2].Alignment) {
+              MaxAlignment = RootBridge->ResAllocNode[Index2].Alignment;
+              Index = Index2;
+            }
+          }
+
+          ASSERT (Index < TypeMax);
+          ResNodeHandled[Index] = TRUE;
+          AddrLen = RootBridge->ResAllocNode[Index].Length;
+          Alignment = RootBridge->ResAllocNode[Index].Alignment;
+          BitsOfAlignment = LowBitSet64 (Alignment + 1);
+          BaseAddress = MAX_UINT64;
+
+          switch (Index) {
+          case TypeIo:
+            BaseAddress = AllocateResource (
+                            FALSE,
+                            RootBridge->ResAllocNode[Index].Length,
+                            MIN (15, BitsOfAlignment),
+                            ALIGN_VALUE (RootBridge->Io.Base, Alignment + 1),
+                            RootBridge->Io.Limit
+                            );
+            break;
+
+          case TypeMem64:
+            BaseAddress = AllocateResource (
+                            TRUE,
+                            RootBridge->ResAllocNode[Index].Length,
+                            MIN (63, BitsOfAlignment),
+                            ALIGN_VALUE (RootBridge->MemAbove4G.Base, Alignment + 1),
+                            RootBridge->MemAbove4G.Limit
+                            );
+            if (BaseAddress != MAX_UINT64) {
+              break;
+            }
+            //
+            // If memory above 4GB is not available, try memory below 4GB
+            //
+
+          case TypeMem32:
+            BaseAddress = AllocateResource (
+                            TRUE,
+                            RootBridge->ResAllocNode[Index].Length,
+                            MIN (31, BitsOfAlignment),
+                            ALIGN_VALUE (RootBridge->Mem.Base, Alignment + 1),
+                            RootBridge->Mem.Limit
+                            );
+            break;
+
+          case TypePMem64:
+            BaseAddress = AllocateResource (
+                            TRUE,
+                            RootBridge->ResAllocNode[Index].Length,
+                            MIN (63, BitsOfAlignment),
+                            ALIGN_VALUE (RootBridge->PMemAbove4G.Base, Alignment + 1),
+                            RootBridge->PMemAbove4G.Limit
+                            );
+            if (BaseAddress != MAX_UINT64) {
+              break;
+            }
+            //
+            // If memory above 4GB is not available, try memory below 4GB
+            //
+          case TypePMem32:
+            BaseAddress = AllocateResource (
+                            TRUE,
+                            RootBridge->ResAllocNode[Index].Length,
+                            MIN (31, BitsOfAlignment),
+                            ALIGN_VALUE (RootBridge->PMem.Base, Alignment + 1),
+                            RootBridge->PMem.Limit
+                            );
+            break;
+
+          default:
+            ASSERT (FALSE);
+            break;
+          }
+
+          DEBUG ((DEBUG_INFO, "  %s: Base/Length/Alignment = %lx/%lx/%lx - ",
+                  mPciResourceTypeStr[Index], BaseAddress, RootBridge->ResAllocNode[Index].Length, Alignment));
+          if (BaseAddress != MAX_UINT64) {
+            RootBridge->ResAllocNode[Index].Base = BaseAddress;
+            RootBridge->ResAllocNode[Index].Status = ResAllocated;
+            DEBUG ((DEBUG_INFO, "Success\n"));
+          } else {
+            ReturnStatus = EFI_OUT_OF_RESOURCES;
+            DEBUG ((DEBUG_ERROR, "Out Of Resource!\n"));
+          }
+        }
+      }
+    }
+
+    if (ReturnStatus == EFI_OUT_OF_RESOURCES) {
+      ResourceConflict (HostBridge);
+    }
+
+    //
+    // Set resource to zero for nodes where allocation fails
+    //
+    for (Link = GetFirstNode (&HostBridge->RootBridges)
+          ; !IsNull (&HostBridge->RootBridges, Link)
+          ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+          ) {
+      RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+      for (Index = TypeIo; Index < TypeBus; Index++) {
+        if (RootBridge->ResAllocNode[Index].Status != ResAllocated) {
+          RootBridge->ResAllocNode[Index].Length = 0;
+        }
+      }
+    }
+    return ReturnStatus;
+
+  case EfiPciHostBridgeSetResources:
+    //
+    // HostBridgeInstance->CanRestarted = FALSE;
+    //
+    break;
+
+  case EfiPciHostBridgeFreeResources:
+    //
+    // HostBridgeInstance->CanRestarted = FALSE;
+    //
+    ReturnStatus = EFI_SUCCESS;
+    for (Link = GetFirstNode (&HostBridge->RootBridges)
+         ; !IsNull (&HostBridge->RootBridges, Link)
+         ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+         ) {
+      RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+      for (Index = TypeIo; Index < TypeBus; Index++) {
+        if (RootBridge->ResAllocNode[Index].Status == ResAllocated) {
+          switch (Index) {
+          case TypeIo:
+            Status = gDS->FreeIoSpace (RootBridge->ResAllocNode[Index].Base, RootBridge->ResAllocNode[Index].Length);
+            if (EFI_ERROR (Status)) {
+              ReturnStatus = Status;
+            }
+            break;
+
+          case TypeMem32:
+          case TypePMem32:
+          case TypeMem64:
+          case TypePMem64:
+            Status = gDS->FreeMemorySpace (RootBridge->ResAllocNode[Index].Base, RootBridge->ResAllocNode[Index].Length);
+            if (EFI_ERROR (Status)) {
+              ReturnStatus = Status;
+            }
+            break;
+
+          default:
+            ASSERT (FALSE);
+            break;
+          }
+
+          RootBridge->ResAllocNode[Index].Type = Index;
+          RootBridge->ResAllocNode[Index].Base = 0;
+          RootBridge->ResAllocNode[Index].Length = 0;
+          RootBridge->ResAllocNode[Index].Status = ResNone;
+        }
+      }
+
+      RootBridge->ResourceSubmitted = FALSE;
+    }
+
+    HostBridge->CanRestarted = TRUE;
+    return ReturnStatus;
+
+  case EfiPciHostBridgeEndResourceAllocation:
+    //
+    // The resource allocation phase is completed.  No specific action is required
+    // here. This notification can be used to perform any chipset specific programming.
+    //
+    break;
+
+  case EfiPciHostBridgeEndEnumeration:
+    //
+    // The Host Bridge Enumeration is completed. No specific action is required here.
+    // This notification can be used to perform any chipset specific programming.
+    //
+    break;
+
+  default:
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+
+  Return the device handle of the next PCI root bridge that is associated with
+  this Host Bridge.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  Returns the device handle of the next PCI Root Bridge.
+                           On input, it holds the RootBridgeHandle returned by the most
+                           recent call to GetNextRootBridge().The handle for the first
+                           PCI Root Bridge is returned if RootBridgeHandle is NULL on input.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_NOT_FOUND          Next PCI root bridge not found.
+  @retval EFI_INVALID_PARAMETER  Wrong parameter passed in.
+
+**/
+EFI_STATUS
+EFIAPI
+GetNextRootBridge (
+  IN     EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN OUT EFI_HANDLE                                       *RootBridgeHandle
+  )
+{
+  BOOLEAN                   ReturnNext;
+  LIST_ENTRY                *Link;
+  PCI_HOST_BRIDGE_INSTANCE  *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+
+  if (RootBridgeHandle == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  ReturnNext = (BOOLEAN) (*RootBridgeHandle == NULL);
+
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+      ; !IsNull (&HostBridge->RootBridges, Link)
+      ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+      ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (ReturnNext) {
+      *RootBridgeHandle = RootBridge->Handle;
+      return EFI_SUCCESS;
+    }
+
+    ReturnNext = (BOOLEAN) (*RootBridgeHandle == RootBridge->Handle);
+  }
+
+  if (ReturnNext) {
+    ASSERT (IsNull (&HostBridge->RootBridges, Link));
+    return EFI_NOT_FOUND;
+  } else {
+    return EFI_INVALID_PARAMETER;
+  }
+}
+
+/**
+
+  Returns the attributes of a PCI Root Bridge.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The device handle of the PCI Root Bridge
+                           that the caller is interested in.
+  @param Attributes        The pointer to attributes of the PCI Root Bridge.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  Attributes parameter passed in is NULL or
+                                 RootBridgeHandle is not an EFI_HANDLE
+                                 that was returned on a previous call to
+                                 GetNextRootBridge().
+
+**/
+EFI_STATUS
+EFIAPI
+GetAttributes (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT UINT64                                           *Attributes
+  )
+{
+  LIST_ENTRY                *Link;
+  PCI_HOST_BRIDGE_INSTANCE  *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+
+  if (Attributes == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+      ; !IsNull (&HostBridge->RootBridges, Link)
+      ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+      ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      *Attributes = RootBridge->AllocationAttributes;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+
+  This is the request from the PCI enumerator to set up
+  the specified PCI Root Bridge for bus enumeration process.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The PCI Root Bridge to be set up.
+  @param Configuration     Pointer to the pointer to the PCI bus resource descriptor.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_OUT_OF_RESOURCES   Not enough pool to be allocated.
+  @retval EFI_INVALID_PARAMETER  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+StartBusEnumeration (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT VOID                                             **Configuration
+  )
+{
+  LIST_ENTRY                *Link;
+  PCI_HOST_BRIDGE_INSTANCE  *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  EFI_ACPI_END_TAG_DESCRIPTOR       *End;
+
+  if (Configuration == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      *Configuration = AllocatePool (sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR));
+      if (*Configuration == NULL) {
+        return EFI_OUT_OF_RESOURCES;
+      }
+
+      Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) *Configuration;
+      Descriptor->Desc                  = ACPI_ADDRESS_SPACE_DESCRIPTOR;
+      Descriptor->Len                   = sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) - 3;
+      Descriptor->ResType               = ACPI_ADDRESS_SPACE_TYPE_BUS;
+      Descriptor->GenFlag               = 0;
+      Descriptor->SpecificFlag          = 0;
+      Descriptor->AddrSpaceGranularity  = 0;
+      Descriptor->AddrRangeMin          = RootBridge->Bus.Base;
+      Descriptor->AddrRangeMax          = 0;
+      Descriptor->AddrTranslationOffset = 0;
+      Descriptor->AddrLen               = RootBridge->Bus.Limit - RootBridge->Bus.Base + 1;
+
+      End = (EFI_ACPI_END_TAG_DESCRIPTOR *) (Descriptor + 1);
+      End->Desc = ACPI_END_TAG_DESCRIPTOR;
+      End->Checksum = 0x0;
+
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+
+  This function programs the PCI Root Bridge hardware so that
+  it decodes the specified PCI bus range.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The PCI Root Bridge whose bus range is to be programmed.
+  @param Configuration     The pointer to the PCI bus resource descriptor.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  Wrong parameters passed in.
+
+**/
+EFI_STATUS
+EFIAPI
+SetBusNumbers (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN EFI_HANDLE                                       RootBridgeHandle,
+  IN VOID                                             *Configuration
+  )
+{
+  LIST_ENTRY                *Link;
+  PCI_HOST_BRIDGE_INSTANCE  *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  EFI_ACPI_END_TAG_DESCRIPTOR       *End;
+  UINTN                     BusStart;
+  UINTN                     BusEnd;
+  UINTN                     BusLen;
+
+  if (Configuration == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Configuration;
+  End = (EFI_ACPI_END_TAG_DESCRIPTOR *) (Descriptor + 1);
+
+  //
+  // Check the Configuration is valid
+  //
+  if ((Descriptor->Desc != ACPI_ADDRESS_SPACE_DESCRIPTOR) ||
+      (Descriptor->ResType != ACPI_ADDRESS_SPACE_TYPE_BUS) ||
+      (End->Desc != ACPI_END_TAG_DESCRIPTOR)
+     ) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      BusStart  = (UINTN) Descriptor->AddrRangeMin;
+      BusLen    = (UINTN) Descriptor->AddrLen;
+      BusEnd    = BusStart + BusLen - 1;
+
+      if (Descriptor->AddrLen == 0) {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      if ((Descriptor->AddrRangeMin < RootBridge->Bus.Base) ||
+          (Descriptor->AddrRangeMin + Descriptor->AddrLen - 1 > RootBridge->Bus.Limit)
+         ) {
+        return EFI_INVALID_PARAMETER;
+      }
+      //
+      // Update the Bus Range
+      //
+      RootBridge->ResAllocNode[TypeBus].Base    = Descriptor->AddrRangeMin;
+      RootBridge->ResAllocNode[TypeBus].Length  = Descriptor->AddrLen;
+      RootBridge->ResAllocNode[TypeBus].Status  = ResAllocated;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+
+  Submits the I/O and memory resource requirements for the specified PCI Root Bridge.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The PCI Root Bridge whose I/O and memory resource requirements.
+                           are being submitted.
+  @param Configuration     The pointer to the PCI I/O and PCI memory resource descriptor.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  Wrong parameters passed in.
+**/
+EFI_STATUS
+EFIAPI
+SubmitResources (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN EFI_HANDLE                                       RootBridgeHandle,
+  IN VOID                                             *Configuration
+  )
+{
+  LIST_ENTRY                        *Link;
+  PCI_HOST_BRIDGE_INSTANCE          *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE          *RootBridge;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  PCI_RESOURCE_TYPE                 Type;
+
+  //
+  // Check the input parameter: Configuration
+  //
+  if (Configuration == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      DEBUG ((EFI_D_INFO, "PciHostBridge: SubmitResources for %s\n", RootBridge->DevicePathStr));
+      //
+      // Check the resource descriptors.
+      // If the Configuration includes one or more invalid resource descriptors, all the resource
+      // descriptors are ignored and the function returns EFI_INVALID_PARAMETER.
+      //
+      for (Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Configuration; Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR; Descriptor++) {
+        if (Descriptor->ResType > ACPI_ADDRESS_SPACE_TYPE_BUS) {
+          return EFI_INVALID_PARAMETER;
+        }
+
+        DEBUG ((EFI_D_INFO, " %s: Granularity/SpecificFlag = %ld / %02x%s\n",
+                mAcpiAddressSpaceTypeStr[Descriptor->ResType], Descriptor->AddrSpaceGranularity, Descriptor->SpecificFlag,
+                (Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0 ? L" (Prefetchable)" : L""
+                ));
+        DEBUG ((EFI_D_INFO, "      Length/Alignment = 0x%lx / 0x%lx\n", Descriptor->AddrLen, Descriptor->AddrRangeMax));
+        switch (Descriptor->ResType) {
+        case ACPI_ADDRESS_SPACE_TYPE_MEM:
+          if (Descriptor->AddrSpaceGranularity != 32 && Descriptor->AddrSpaceGranularity != 64) {
+            return EFI_INVALID_PARAMETER;
+          }
+          if (Descriptor->AddrSpaceGranularity == 32 && Descriptor->AddrLen >= SIZE_4GB) {
+            return EFI_INVALID_PARAMETER;
+          }
+          //
+          // If the PCI root bridge does not support separate windows for nonprefetchable and
+          // prefetchable memory, then the PCI bus driver needs to include requests for
+          // prefetchable memory in the nonprefetchable memory pool.
+          //
+          if (((RootBridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0) &&
+              ((Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0)
+             ) {
+            return EFI_INVALID_PARAMETER;
+          }
+        case ACPI_ADDRESS_SPACE_TYPE_IO:
+          //
+          // Check aligment, it should be of the form 2^n-1
+          //
+          if (GetPowerOfTwo64 (Descriptor->AddrRangeMax + 1) != (Descriptor->AddrRangeMax + 1)) {
+            return EFI_INVALID_PARAMETER;
+          }
+          break;
+        default:
+          ASSERT (FALSE);
+          break;
+        }
+      }
+      if (Descriptor->Desc != ACPI_END_TAG_DESCRIPTOR) {
+        return EFI_INVALID_PARAMETER;
+      }
+
+      for (Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Configuration; Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR; Descriptor++) {
+        if (Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
+          if (Descriptor->AddrSpaceGranularity == 32) {
+            if ((Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0) {
+              Type = TypePMem32;
+            } else {
+              Type = TypeMem32;
+            }
+          } else {
+            ASSERT (Descriptor->AddrSpaceGranularity == 64);
+            if ((Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0) {
+              Type = TypePMem64;
+            } else {
+              Type = TypeMem64;
+            }
+          }
+        } else {
+          ASSERT (Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_IO);
+          Type = TypeIo;
+        }
+        RootBridge->ResAllocNode[Type].Length    = Descriptor->AddrLen;
+        RootBridge->ResAllocNode[Type].Alignment = Descriptor->AddrRangeMax;
+        RootBridge->ResAllocNode[Type].Status    = ResSubmitted;
+      }
+      RootBridge->ResourceSubmitted = TRUE;
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+
+  This function returns the proposed resource settings for the specified
+  PCI Root Bridge.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The PCI Root Bridge handle.
+  @param Configuration     The pointer to the pointer to the PCI I/O
+                           and memory resource descriptor.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_OUT_OF_RESOURCES   Not enough pool to be allocated.
+  @retval EFI_INVALID_PARAMETER  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+GetProposedResources (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT VOID                                             **Configuration
+  )
+{
+  LIST_ENTRY                        *Link;
+  PCI_HOST_BRIDGE_INSTANCE          *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE          *RootBridge;
+  UINTN                             Index;
+  UINTN                             Number;
+  VOID                              *Buffer;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  EFI_ACPI_END_TAG_DESCRIPTOR       *End;
+  UINT64                            ResStatus;
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+      ; !IsNull (&HostBridge->RootBridges, Link)
+      ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+      ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      for (Index = 0, Number = 0; Index < TypeBus; Index++) {
+        if (RootBridge->ResAllocNode[Index].Status != ResNone) {
+          Number++;
+        }
+      }
+
+      Buffer = AllocateZeroPool (Number * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR));
+      if (Buffer == NULL) {
+        return EFI_OUT_OF_RESOURCES;
+      }
+
+      Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) Buffer;
+      for (Index = 0; Index < TypeBus; Index++) {
+        ResStatus = RootBridge->ResAllocNode[Index].Status;
+        if (ResStatus != ResNone) {
+          Descriptor->Desc                  = ACPI_ADDRESS_SPACE_DESCRIPTOR;
+          Descriptor->Len                   = sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) - 3;;
+          Descriptor->GenFlag               = 0;
+          Descriptor->AddrRangeMin          = RootBridge->ResAllocNode[Index].Base;
+          Descriptor->AddrRangeMax          = 0;
+          Descriptor->AddrTranslationOffset = (ResStatus == ResAllocated) ? EFI_RESOURCE_SATISFIED : PCI_RESOURCE_LESS;
+          Descriptor->AddrLen               = RootBridge->ResAllocNode[Index].Length;
+
+          switch (Index) {
+
+          case TypeIo:
+            Descriptor->ResType              = ACPI_ADDRESS_SPACE_TYPE_IO;
+            break;
+
+          case TypePMem32:
+            Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+          case TypeMem32:
+            Descriptor->ResType              = ACPI_ADDRESS_SPACE_TYPE_MEM;
+            Descriptor->AddrSpaceGranularity = 32;
+            break;
+
+          case TypePMem64:
+            Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+          case TypeMem64:
+            Descriptor->ResType              = ACPI_ADDRESS_SPACE_TYPE_MEM;
+            Descriptor->AddrSpaceGranularity = 64;
+            break;
+          }
+
+          Descriptor++;
+        }
+      }
+      End = (EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor;
+      End->Desc      = ACPI_END_TAG_DESCRIPTOR;
+      End->Checksum  = 0;
+
+      *Configuration = Buffer;
+
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+
+  This function is called for all the PCI controllers that the PCI
+  bus driver finds. Can be used to Preprogram the controller.
+
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  The PCI Root Bridge handle.
+  @param PciAddress        Address of the controller on the PCI bus.
+  @param Phase             The Phase during resource allocation.
+
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+PreprocessController (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL          *This,
+  IN  EFI_HANDLE                                                RootBridgeHandle,
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS               PciAddress,
+  IN  EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE              Phase
+  )
+{
+  LIST_ENTRY                *Link;
+  PCI_HOST_BRIDGE_INSTANCE  *HostBridge;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+
+  if ((UINT32) Phase > EfiPciBeforeResourceCollection) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  HostBridge = PCI_HOST_BRIDGE_FROM_THIS (This);
+  for (Link = GetFirstNode (&HostBridge->RootBridges)
+       ; !IsNull (&HostBridge->RootBridges, Link)
+       ; Link = GetNextNode (&HostBridge->RootBridges, Link)
+       ) {
+    RootBridge = ROOT_BRIDGE_FROM_LINK (Link);
+    if (RootBridgeHandle == RootBridge->Handle) {
+      return EFI_SUCCESS;
+    }
+  }
+
+  return EFI_INVALID_PARAMETER;
+}
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
new file mode 100644
index 000000000000..288823c7784a
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
@@ -0,0 +1,252 @@
+/** @file
+
+  The Header file of the Pci Host Bridge Driver.
+
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _PCI_HOST_BRIDGE_H_
+#define _PCI_HOST_BRIDGE_H_
+
+
+#include <PiDxe.h>
+#include <IndustryStandard/Acpi.h>
+#include <Library/UefiDriverEntryPoint.h>
+#include <Library/MemoryAllocationLib.h>
+#include <Library/PciHostBridgeLib.h>
+#include <Protocol/PciHostBridgeResourceAllocation.h>
+
+#include "PciRootBridge.h"
+
+#define PCI_HOST_BRIDGE_SIGNATURE SIGNATURE_32 ('p', 'h', 'b', 'g')
+typedef struct {
+  UINTN                                             Signature;
+  EFI_HANDLE                                        Handle;
+  LIST_ENTRY                                        RootBridges;
+  BOOLEAN                                           CanRestarted;
+  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL  ResAlloc;
+} PCI_HOST_BRIDGE_INSTANCE;
+
+#define PCI_HOST_BRIDGE_FROM_THIS(a) CR (a, PCI_HOST_BRIDGE_INSTANCE, ResAlloc, PCI_HOST_BRIDGE_SIGNATURE)
+
+//
+// Driver Entry Point
+//
+/**
+
+  Entry point of this driver.
+
+  @param ImageHandle  -  Image handle of this driver.
+  @param SystemTable  -  Pointer to standard EFI system table.
+
+  @retval EFI_SUCCESS       -  Succeed.
+  @retval EFI_DEVICE_ERROR  -  Fail to install PCI_ROOT_BRIDGE_IO protocol.
+
+**/
+EFI_STATUS
+EFIAPI
+InitializePciHostBridge (
+  IN EFI_HANDLE         ImageHandle,
+  IN EFI_SYSTEM_TABLE   *SystemTable
+  );
+
+//
+//  HostBridge Resource Allocation interface
+//
+/**
+
+  Enter a certain phase of the PCI enumeration process.
+
+  @param This   -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
+  @param Phase  -  The phase during enumeration.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_INVALID_PARAMETER  -  Wrong phase parameter passed in.
+  @retval EFI_NOT_READY          -  Resources have not been submitted yet.
+
+**/
+EFI_STATUS
+EFIAPI
+NotifyPhase (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL   *This,
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PHASE      Phase
+  );
+
+/**
+
+  Return the device handle of the next PCI root bridge that is associated with
+  this Host Bridge.
+
+  @param This              - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  RootBridgeHandle  -  Returns the device handle of the next PCI Root Bridge.
+                       On input, it holds the RootBridgeHandle returned by the most
+                       recent call to GetNextRootBridge().The handle for the first
+                       PCI Root Bridge is returned if RootBridgeHandle is NULL on input.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_NOT_FOUND          -  Next PCI root bridge not found.
+  @retval EFI_INVALID_PARAMETER  -  Wrong parameter passed in.
+
+**/
+EFI_STATUS
+EFIAPI
+GetNextRootBridge (
+  IN     EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN OUT EFI_HANDLE                                       *RootBridgeHandle
+  );
+
+/**
+
+  Returns the attributes of a PCI Root Bridge.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
+  @param RootBridgeHandle  -  The device handle of the PCI Root Bridge
+                              that the caller is interested in
+  @param Attributes        -  The pointer to attributes of the PCI Root Bridge
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_INVALID_PARAMETER  -  Attributes parameter passed in is NULL or
+                            @retval RootBridgeHandle is not an EFI_HANDLE
+                            @retval that was returned on a previous call to
+                            @retval GetNextRootBridge().
+
+**/
+EFI_STATUS
+EFIAPI
+GetAttributes (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT UINT64                                           *Attributes
+  );
+
+/**
+
+  This is the request from the PCI enumerator to set up
+  the specified PCI Root Bridge for bus enumeration process.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  -  The PCI Root Bridge to be set up.
+  @param Configuration     -  Pointer to the pointer to the PCI bus resource descriptor.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_OUT_OF_RESOURCES   -  Not enough pool to be allocated.
+  @retval EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+StartBusEnumeration (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT VOID                                             **Configuration
+  );
+
+/**
+
+  This function programs the PCI Root Bridge hardware so that
+  it decodes the specified PCI bus range.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  -  The PCI Root Bridge whose bus range is to be programmed.
+  @param Configuration     -  The pointer to the PCI bus resource descriptor.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_INVALID_PARAMETER  -  Wrong parameters passed in.
+
+**/
+EFI_STATUS
+EFIAPI
+SetBusNumbers (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN EFI_HANDLE                                       RootBridgeHandle,
+  IN VOID                                             *Configuration
+  );
+
+/**
+
+  Submits the I/O and memory resource requirements for the specified PCI Root Bridge.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance
+  @param RootBridgeHandle  -  The PCI Root Bridge whose I/O and memory resource requirements
+                              are being submitted
+  @param Configuration     -  The pointer to the PCI I/O and PCI memory resource descriptor
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_INVALID_PARAMETER  -  Wrong parameters passed in.
+
+**/
+EFI_STATUS
+EFIAPI
+SubmitResources (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN EFI_HANDLE                                       RootBridgeHandle,
+  IN VOID                                             *Configuration
+  );
+
+/**
+
+  This function returns the proposed resource settings for the specified
+  PCI Root Bridge.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  -  The PCI Root Bridge handle.
+  @param Configuration     -  The pointer to the pointer to the PCI I/O
+                              and memory resource descriptor.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_OUT_OF_RESOURCES   -  Not enough pool to be allocated.
+  @retval EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+GetProposedResources (
+  IN  EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL *This,
+  IN  EFI_HANDLE                                       RootBridgeHandle,
+  OUT VOID                                             **Configuration
+  );
+
+/**
+
+  This function is called for all the PCI controllers that the PCI
+  bus driver finds. Can be used to Preprogram the controller.
+
+  @param This              -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  -  The PCI Root Bridge handle.
+  @param PciAddress        -  Address of the controller on the PCI bus.
+  @param Phase             -  The Phase during resource allocation.
+
+  @retval EFI_SUCCESS            -  Succeed.
+  @retval EFI_INVALID_PARAMETER  -  RootBridgeHandle is not a valid handle.
+
+**/
+EFI_STATUS
+EFIAPI
+PreprocessController (
+  IN EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL          *This,
+  IN EFI_HANDLE                                                RootBridgeHandle,
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS               PciAddress,
+  IN EFI_PCI_CONTROLLER_RESOURCE_ALLOCATION_PHASE              Phase
+  );
+
+/**
+  This routine constructs the resource descriptors for all root bridges and call PciHostBridgeResourceConflict().
+
+  @param HostBridge The Host Bridge Instance where the resource adjustment happens.
+**/
+VOID
+ResourceConflict (
+  IN  PCI_HOST_BRIDGE_INSTANCE *HostBridge
+  );
+
+extern EFI_METRONOME_ARCH_PROTOCOL *mMetronome;
+extern EFI_CPU_IO2_PROTOCOL        *mCpuIo;
+#endif
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf
new file mode 100644
index 000000000000..ab5d87e1cf0a
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf
@@ -0,0 +1,55 @@
+## @file
+#   Generic PCI Host Bridge driver.
+#
+#  Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PciHostBridgeDxe
+  FILE_GUID                      = 128FB770-5E79-4176-9E51-9BB268A17DD1
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = InitializePciHostBridge
+
+[Sources]
+  PciHostBridge.h
+  PciRootBridge.h
+  PciHostBridge.c
+  PciRootBridgeIo.c
+  PciHostResource.h
+
+[Packages]
+  MdePkg/MdePkg.dec
+  MdeModulePkg/MdeModulePkg.dec
+
+[LibraryClasses]
+  UefiDriverEntryPoint
+  UefiBootServicesTableLib
+  DebugLib
+  DxeServicesTableLib
+  DevicePathLib
+  BaseMemoryLib
+  BaseLib
+  PciSegmentLib
+  PciHostBridgeLib
+
+[Protocols]
+  gEfiMetronomeArchProtocolGuid                   ## CONSUMES
+  gEfiCpuIo2ProtocolGuid                          ## CONSUMES
+  gEfiDevicePathProtocolGuid                      ## BY_START
+  gEfiPciRootBridgeIoProtocolGuid                 ## BY_START
+  gEfiPciHostBridgeResourceAllocationProtocolGuid ## BY_START
+
+[Depex]
+  gEfiCpuIo2ProtocolGuid AND
+  gEfiMetronomeArchProtocolGuid
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostResource.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostResource.h
new file mode 100644
index 000000000000..f35222b634b7
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostResource.h
@@ -0,0 +1,47 @@
+/** @file
+
+  The Header file of the Pci Host Bridge Driver.
+
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+#ifndef _PCI_HOST_RESOURCE_H_
+#define _PCI_HOST_RESOURCE_H_
+
+#include <PiDxe.h>
+
+#define PCI_RESOURCE_LESS         0xFFFFFFFFFFFFFFFE
+
+typedef enum {
+  TypeIo    = 0,
+  TypeMem32,
+  TypePMem32,
+  TypeMem64,
+  TypePMem64,
+  TypeBus,
+  TypeMax
+} PCI_RESOURCE_TYPE;
+
+typedef enum {
+  ResNone,
+  ResSubmitted,
+  ResAllocated,
+  ResStatusMax
+} RES_STATUS;
+
+typedef struct {
+  PCI_RESOURCE_TYPE Type;
+  UINT64            Base;
+  UINT64            Length;
+  UINT64            Alignment;
+  RES_STATUS        Status;
+} PCI_RES_NODE;
+
+#endif
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
new file mode 100644
index 000000000000..2915981ea553
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
@@ -0,0 +1,568 @@
+/** @file
+
+  The PCI Root Bridge header file.
+
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _PCI_ROOT_BRIDGE_H_
+#define _PCI_ROOT_BRIDGE_H_
+
+#include <PiDxe.h>
+#include <IndustryStandard/Acpi.h>
+#include <IndustryStandard/Pci.h>
+
+//
+// Driver Consumed Protocol Prototypes
+//
+#include <Protocol/Metronome.h>
+#include <Protocol/CpuIo2.h>
+#include <Protocol/DevicePath.h>
+#include <Protocol/PciRootBridgeIo.h>
+#include <Library/DebugLib.h>
+#include <Library/DevicePathLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/DxeServicesTableLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PciSegmentLib.h>
+#include "PciHostResource.h"
+
+
+typedef enum {
+  IoOperation,
+  MemOperation,
+  PciOperation
+} OPERATION_TYPE;
+
+#define MAP_INFO_SIGNATURE  SIGNATURE_32 ('_', 'm', 'a', 'p')
+typedef struct {
+  UINT32                                    Signature;
+  LIST_ENTRY                                Link;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_OPERATION Operation;
+  UINTN                                     NumberOfBytes;
+  UINTN                                     NumberOfPages;
+  EFI_PHYSICAL_ADDRESS                      HostAddress;
+  EFI_PHYSICAL_ADDRESS                      MappedHostAddress;
+} MAP_INFO;
+#define MAP_INFO_FROM_LINK(a) CR (a, MAP_INFO, Link, MAP_INFO_SIGNATURE)
+
+#define PCI_ROOT_BRIDGE_SIGNATURE SIGNATURE_32 ('_', 'p', 'r', 'b')
+
+typedef struct {
+  UINT32                            Signature;
+  LIST_ENTRY                        Link;
+  EFI_HANDLE                        Handle;
+  UINT64                            AllocationAttributes;
+  UINT64                            Attributes;
+  UINT64                            Supports;
+  PCI_RES_NODE                      ResAllocNode[TypeMax];
+  PCI_ROOT_BRIDGE_APERTURE          Bus;
+  PCI_ROOT_BRIDGE_APERTURE          Io;
+  PCI_ROOT_BRIDGE_APERTURE          Mem;
+  PCI_ROOT_BRIDGE_APERTURE          PMem;
+  PCI_ROOT_BRIDGE_APERTURE          MemAbove4G;
+  PCI_ROOT_BRIDGE_APERTURE          PMemAbove4G;
+  BOOLEAN                           DmaAbove4G;
+  VOID                              *ConfigBuffer;
+  EFI_DEVICE_PATH_PROTOCOL          *DevicePath;
+  CHAR16                            *DevicePathStr;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL   RootBridgeIo;
+
+  BOOLEAN                           ResourceSubmitted;
+  LIST_ENTRY                        Maps;
+} PCI_ROOT_BRIDGE_INSTANCE;
+
+#define ROOT_BRIDGE_FROM_THIS(a) CR (a, PCI_ROOT_BRIDGE_INSTANCE, RootBridgeIo, PCI_ROOT_BRIDGE_SIGNATURE)
+
+#define ROOT_BRIDGE_FROM_LINK(a) CR (a, PCI_ROOT_BRIDGE_INSTANCE, Link, PCI_ROOT_BRIDGE_SIGNATURE)
+
+/**
+
+  Construct the Pci Root Bridge Io protocol.
+
+  @param Protocol          -  Protocol to initialize.
+  @param HostBridgeHandle  -  Handle to the HostBridge.
+
+  @retval EFI_SUCCESS  -  Success.
+  @retval Others       -  Fail.
+
+**/
+PCI_ROOT_BRIDGE_INSTANCE *
+CreateRootBridge (
+  IN PCI_ROOT_BRIDGE       *Bridge,
+  IN EFI_HANDLE            HostBridgeHandle
+  );
+
+//
+// Protocol Member Function Prototypes
+//
+/**
+
+  Poll an address in memory mapped space until an exit condition is met
+  or a timeout occurs.
+
+  @param This     -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Width    -  Width of the memory operation.
+  @param Address  -  The base address of the memory operation.
+  @param Mask     -  Mask used for polling criteria.
+  @param Value    -  Comparison value used for polling exit criteria.
+  @param Delay    -  Number of 100ns units to poll.
+  @param Result   -  Pointer to the last value read from memory location.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_TIMEOUT            -  Delay expired before a match occurred.
+  @retval EFI_OUT_OF_RESOURCES   -  Fail due to lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPollMem (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN  UINT64                                 Address,
+  IN  UINT64                                 Mask,
+  IN  UINT64                                 Value,
+  IN  UINT64                                 Delay,
+  OUT UINT64                                 *Result
+  )
+;
+
+/**
+
+  Poll an address in I/O space until an exit condition is met
+  or a timeout occurs.
+
+  @param This     -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Width    -  Width of I/O operation.
+  @param Address  -  The base address of the I/O operation.
+  @param Mask     -  Mask used for polling criteria.
+  @param Value    -  Comparison value used for polling exit criteria.
+  @param Delay    -  Number of 100ns units to poll.
+  @param Result   -  Pointer to the last value read from memory location.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_TIMEOUT            -  Delay expired before a match occurred.
+  @retval EFI_OUT_OF_RESOURCES   -  Fail due to lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPollIo (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN  UINT64                                 Address,
+  IN  UINT64                                 Mask,
+  IN  UINT64                                 Value,
+  IN  UINT64                                 Delay,
+  OUT UINT64                                 *Result
+  )
+;
+
+/**
+
+  Allow read from memory mapped I/O space.
+
+  @param This     -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Width    -  The width of memory operation.
+  @param Address  -  Base address of the memory operation.
+  @param Count    -  Number of memory opeartion to perform.
+  @param Buffer   -  The destination buffer to store data.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_OUT_OF_RESOURCES   -  Fail due to lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMemRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *Buffer
+  )
+;
+
+/**
+
+  Allow write to memory mapped I/O space.
+
+  @param This     -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Width    -  The width of memory operation.
+  @param Address  -  Base address of the memory operation.
+  @param Count    -  Number of memory opeartion to perform.
+  @param Buffer   -  The source buffer to write data from.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_OUT_OF_RESOURCES   -  Fail due to lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMemWrite (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *Buffer
+  )
+;
+
+/**
+
+  Enable a PCI driver to read PCI controller registers in the
+  PCI root bridge I/O space.
+
+  @param This         -  A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width        -  Signifies the width of the memory operation.
+  @param UserAddress  -  The base address of the I/O operation.
+  @param Count        -  The number of I/O operations to perform.
+  @param UserBuffer   -  The destination buffer to store the results.
+
+  @retval EFI_SUCCESS            -  The data was read from the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to a lack of
+                            @retval resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoIoRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 UserAddress,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *UserBuffer
+  )
+;
+
+/**
+
+  Enable a PCI driver to write to PCI controller registers in the
+  PCI root bridge I/O space.
+
+  @param This         -  A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width        -  Signifies the width of the memory operation.
+  @param UserAddress  -  The base address of the I/O operation.
+  @param Count        -  The number of I/O operations to perform.
+  @param UserBuffer   -  The source buffer to write data from.
+
+  @retval EFI_SUCCESS            -  The data was written to the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to a lack of
+                            @retval resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoIoWrite (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 UserAddress,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *UserBuffer
+  )
+;
+
+/**
+
+  Copy one region of PCI root bridge memory space to be copied to
+  another region of PCI root bridge memory space.
+
+  @param This         -  A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Width        -  Signifies the width of the memory operation.
+  @param DestAddress  -  Destination address of the memory operation.
+  @param SrcAddress   -  Source address of the memory operation.
+  @param Count        -  Number of memory operations to perform.
+
+  @retval EFI_SUCCESS            -  The data was copied successfully.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to a lack of
+                            @retval resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoCopyMem (
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL          *This,
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH    Width,
+  IN UINT64                                   DestAddress,
+  IN UINT64                                   SrcAddress,
+  IN UINTN                                    Count
+  )
+;
+
+/**
+
+  Allows read from PCI configuration space.
+
+  @param This     -  A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width    -  Signifies the width of the memory operation.
+  @param Address  -  The address within the PCI configuration space
+                     for the PCI controller.
+  @param Count    -  The number of PCI configuration operations
+                     to perform.
+  @param Buffer   -  The destination buffer to store the results.
+
+  @retval EFI_SUCCESS            -  The data was read from the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to a lack of
+                            @retval resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPciRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *Buffer
+  )
+;
+
+/**
+
+  Allows write to PCI configuration space.
+
+  @param This     -  A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width    -  Signifies the width of the memory operation.
+  @param Address  -  The address within the PCI configuration space
+                     for the PCI controller.
+  @param Count    -  The number of PCI configuration operations
+                     to perform.
+  @param Buffer   -  The source buffer to get the results.
+
+  @retval EFI_SUCCESS            -  The data was written to the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to a lack of
+                            @retval resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPciWrite (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  IN OUT VOID                                   *Buffer
+  )
+;
+
+/**
+
+  Provides the PCI controller-specific address needed to access
+  system memory for DMA.
+
+  @param This           -  A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Operation      -  Indicate if the bus master is going to read or write
+                           to system memory.
+  @param HostAddress    -  The system memory address to map on the PCI controller.
+  @param NumberOfBytes  -  On input the number of bytes to map.
+                           On output the number of bytes that were mapped.
+  @param DeviceAddress  -  The resulting map address for the bus master PCI
+                           controller to use to access the system memory's HostAddress.
+  @param Mapping        -  The value to pass to Unmap() when the bus master DMA
+                           operation is complete.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
+  @retval EFI_UNSUPPORTED        -  The HostAddress cannot be mapped as a common
+                            @retval buffer.
+  @retval EFI_DEVICE_ERROR       -  The System hardware could not map the requested
+                            @retval address.
+  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to
+                            @retval lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMap (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL            *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_OPERATION  Operation,
+  IN     VOID                                       *HostAddress,
+  IN OUT UINTN                                      *NumberOfBytes,
+  OUT    EFI_PHYSICAL_ADDRESS                       *DeviceAddress,
+  OUT    VOID                                       **Mapping
+  )
+;
+
+/**
+
+  Completes the Map() operation and releases any corresponding resources.
+
+  @param This     -  Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  Mapping  -  The value returned from Map() operation.
+
+  @retval EFI_SUCCESS            -  The range was unmapped successfully.
+  @retval EFI_INVALID_PARAMETER  -  Mapping is not a value that was returned
+                            @retval by Map operation.
+  @retval EFI_DEVICE_ERROR       -  The data was not committed to the target
+                            @retval system memory.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoUnmap (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN  VOID                             *Mapping
+  )
+;
+
+/**
+
+  Allocates pages that are suitable for a common buffer mapping.
+
+  @param This         -  Pointer to EFI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Type         -  Not used and can be ignored.
+  @param MemoryType   -  Type of memory to allocate.
+  @param Pages        -  Number of pages to allocate.
+  @param HostAddress  -  Pointer to store the base system memory address
+                         of the allocated range.
+  @param Attributes   -  Requested bit mask of attributes of the allocated
+                         range.
+
+  @retval EFI_SUCCESS            -  The requested memory range were allocated.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_UNSUPPORTED        -  Attributes is unsupported.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoAllocateBuffer (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN  EFI_ALLOCATE_TYPE                Type,
+  IN  EFI_MEMORY_TYPE                  MemoryType,
+  IN  UINTN                            Pages,
+  OUT VOID                             **HostAddress,
+  IN  UINT64                           Attributes
+  )
+;
+
+/**
+
+  Free memory allocated in AllocateBuffer.
+
+  @param This         -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+                         instance.
+  @param Pages        -  Number of pages to free.
+  @param HostAddress  -  The base system memory address of the
+                         allocated range.
+
+  @retval EFI_SUCCESS            -  Requested memory pages were freed.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoFreeBuffer (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN  UINTN                            Pages,
+  OUT VOID                             *HostAddress
+  )
+;
+
+/**
+
+  Flushes all PCI posted write transactions from a PCI host
+  bridge to system memory.
+
+  @param This  - Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+
+  @retval EFI_SUCCESS       -  PCI posted write transactions were flushed
+                       @retval from PCI host bridge to system memory.
+  @retval EFI_DEVICE_ERROR  -  Fail due to hardware error.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoFlush (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This
+  )
+;
+
+/**
+
+  Get the attributes that a PCI root bridge supports and
+  the attributes the PCI root bridge is currently using.
+
+  @param This        -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+                        instance.
+  @param Supports    -  A pointer to the mask of attributes that
+                        this PCI root bridge supports.
+  @param Attributes  -  A pointer to the mask of attributes that
+                        this PCI root bridge is currently using.
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoGetAttributes (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  OUT UINT64                           *Supported,
+  OUT UINT64                           *Attributes
+  )
+;
+
+/**
+
+  Sets the attributes for a resource range on a PCI root bridge.
+
+  @param This            -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Attributes      -  The mask of attributes to set.
+  @param ResourceBase    -  Pointer to the base address of the resource range
+                            to be modified by the attributes specified by Attributes.
+  @param ResourceLength  -  Pointer to the length of the resource range to be modified.
+
+  @retval EFI_SUCCESS            -  Success.
+  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
+  @retval EFI_OUT_OF_RESOURCES   -  Not enough resources to set the attributes upon.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoSetAttributes (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN     UINT64                           Attributes,
+  IN OUT UINT64                           *ResourceBase,
+  IN OUT UINT64                           *ResourceLength
+  )
+;
+
+/**
+
+  Retrieves the current resource settings of this PCI root bridge
+  in the form of a set of ACPI 2.0 resource descriptor.
+
+  @param This       -  Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
+  @param Resources  -  Pointer to the ACPI 2.0 resource descriptor that
+                       describe the current configuration of this PCI root
+                       bridge.
+
+  @retval EFI_SUCCESS      -  Success.
+  @retval EFI_UNSUPPORTED  -  Current configuration of the PCI root bridge
+                      @retval could not be retrieved.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoConfiguration (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  OUT VOID                             **Resources
+  )
+;
+
+
+extern EFI_METRONOME_ARCH_PROTOCOL *mMetronome;
+extern EFI_CPU_IO2_PROTOCOL         *mCpuIo;
+#endif
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
new file mode 100644
index 000000000000..79b1da2d7e38
--- /dev/null
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
@@ -0,0 +1,1561 @@
+/** @file
+
+  PCI Root Bridge Io Protocol code.
+
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PciHostBridge.h"
+#include "PciRootBridge.h"
+#include "PciHostResource.h"
+
+#define NO_MAPPING  (VOID *) -1
+
+//
+// Lookup table for increment values based on transfer widths
+//
+UINT8 mInStride[] = {
+  1, // EfiPciWidthUint8
+  2, // EfiPciWidthUint16
+  4, // EfiPciWidthUint32
+  8, // EfiPciWidthUint64
+  0, // EfiPciWidthFifoUint8
+  0, // EfiPciWidthFifoUint16
+  0, // EfiPciWidthFifoUint32
+  0, // EfiPciWidthFifoUint64
+  1, // EfiPciWidthFillUint8
+  2, // EfiPciWidthFillUint16
+  4, // EfiPciWidthFillUint32
+  8  // EfiPciWidthFillUint64
+};
+
+//
+// Lookup table for increment values based on transfer widths
+//
+UINT8 mOutStride[] = {
+  1, // EfiPciWidthUint8
+  2, // EfiPciWidthUint16
+  4, // EfiPciWidthUint32
+  8, // EfiPciWidthUint64
+  1, // EfiPciWidthFifoUint8
+  2, // EfiPciWidthFifoUint16
+  4, // EfiPciWidthFifoUint32
+  8, // EfiPciWidthFifoUint64
+  0, // EfiPciWidthFillUint8
+  0, // EfiPciWidthFillUint16
+  0, // EfiPciWidthFillUint32
+  0  // EfiPciWidthFillUint64
+};
+
+/**
+  Construct the Pci Root Bridge instance.
+
+  @param Bridge            The root bridge instance.
+  @param HostBridgeHandle  Handle to the HostBridge.
+
+  @return The pointer to PCI_ROOT_BRIDGE_INSTANCE just created
+          or NULL if creation fails.
+**/
+PCI_ROOT_BRIDGE_INSTANCE *
+CreateRootBridge (
+  IN PCI_ROOT_BRIDGE       *Bridge,
+  IN EFI_HANDLE            HostBridgeHandle
+  )
+{
+  PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
+  PCI_RESOURCE_TYPE        Index;
+  CHAR16                   *DevicePathStr;
+
+  DevicePathStr = NULL;
+
+  DEBUG ((EFI_D_INFO, "RootBridge: "));
+  DEBUG ((EFI_D_INFO, "%s\n", DevicePathStr = ConvertDevicePathToText (Bridge->DevicePath, FALSE, FALSE)));
+  DEBUG ((EFI_D_INFO, "Support/Attr: %lx / %lx\n", Bridge->Supports, Bridge->Attributes));
+  DEBUG ((EFI_D_INFO, "  DmaAbove4G: %s\n", Bridge->DmaAbove4G ? L"Yes" : L"No"));
+  DEBUG ((EFI_D_INFO, "   AllocAttr: %lx (%s%s)\n", Bridge->AllocationAttributes,
+          (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0 ? L"CombineMemPMem " : L"",
+          (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) != 0 ? L"Mem64Decode" : L""
+          ));
+  DEBUG ((EFI_D_INFO, "         Bus: %lx - %lx\n", Bridge->Bus.Base, Bridge->Bus.Limit));
+  DEBUG ((EFI_D_INFO, "          Io: %lx - %lx\n", Bridge->Io.Base, Bridge->Io.Limit));
+  DEBUG ((EFI_D_INFO, "         Mem: %lx - %lx\n", Bridge->Mem.Base, Bridge->Mem.Limit));
+  DEBUG ((EFI_D_INFO, "  MemAbove4G: %lx - %lx\n", Bridge->MemAbove4G.Base, Bridge->MemAbove4G.Limit));
+  DEBUG ((EFI_D_INFO, "        PMem: %lx - %lx\n", Bridge->PMem.Base, Bridge->PMem.Limit));
+  DEBUG ((EFI_D_INFO, " PMemAbove4G: %lx - %lx\n", Bridge->PMemAbove4G.Base, Bridge->PMemAbove4G.Limit));
+
+  //
+  // Make sure Mem and MemAbove4G apertures are valid
+  //
+  if (Bridge->Mem.Base < Bridge->Mem.Limit) {
+    ASSERT (Bridge->Mem.Limit < SIZE_4GB);
+    if (Bridge->Mem.Limit >= SIZE_4GB) {
+      return NULL;
+    }
+  }
+  if (Bridge->MemAbove4G.Base < Bridge->MemAbove4G.Limit) {
+    ASSERT (Bridge->MemAbove4G.Base >= SIZE_4GB);
+    if (Bridge->MemAbove4G.Base < SIZE_4GB) {
+      return NULL;
+    }
+  }
+  if (Bridge->PMem.Base < Bridge->PMem.Limit) {
+    ASSERT (Bridge->PMem.Limit < SIZE_4GB);
+    if (Bridge->PMem.Limit >= SIZE_4GB) {
+      return NULL;
+    }
+  }
+  if (Bridge->PMemAbove4G.Base < Bridge->PMemAbove4G.Limit) {
+    ASSERT (Bridge->PMemAbove4G.Base >= SIZE_4GB);
+    if (Bridge->PMemAbove4G.Base < SIZE_4GB) {
+      return NULL;
+    }
+  }
+
+  if ((Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0) {
+    //
+    // If this bit is set, then the PCI Root Bridge does not
+    // support separate windows for Non-prefetchable and Prefetchable
+    // memory.
+    //
+    ASSERT (Bridge->PMem.Base >= Bridge->PMem.Limit);
+    ASSERT (Bridge->PMemAbove4G.Base >= Bridge->PMemAbove4G.Limit);
+    if ((Bridge->PMem.Base < Bridge->PMem.Limit) ||
+        (Bridge->PMemAbove4G.Base < Bridge->PMemAbove4G.Limit)
+        ) {
+      return NULL;
+    }
+  }
+
+  if ((Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) == 0) {
+    //
+    // If this bit is not set, then the PCI Root Bridge does not support
+    // 64 bit memory windows.
+    //
+    ASSERT (Bridge->MemAbove4G.Base >= Bridge->MemAbove4G.Limit);
+    ASSERT (Bridge->PMemAbove4G.Base >= Bridge->PMemAbove4G.Limit);
+    if ((Bridge->MemAbove4G.Base < Bridge->MemAbove4G.Limit) ||
+        (Bridge->PMemAbove4G.Base < Bridge->PMemAbove4G.Limit)
+        ) {
+      return NULL;
+    }
+  }
+
+  RootBridge = AllocateZeroPool (sizeof (PCI_ROOT_BRIDGE_INSTANCE));
+  ASSERT (RootBridge != NULL);
+
+  RootBridge->Signature = PCI_ROOT_BRIDGE_SIGNATURE;
+  RootBridge->Supports = Bridge->Supports;
+  RootBridge->Attributes = Bridge->Attributes;
+  RootBridge->DmaAbove4G = Bridge->DmaAbove4G;
+  RootBridge->AllocationAttributes = Bridge->AllocationAttributes;
+  RootBridge->DevicePath = DuplicateDevicePath (Bridge->DevicePath);
+  RootBridge->DevicePathStr = DevicePathStr;
+  RootBridge->ConfigBuffer = AllocatePool (
+    TypeMax * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR)
+    );
+  ASSERT (RootBridge->ConfigBuffer != NULL);
+  InitializeListHead (&RootBridge->Maps);
+
+  CopyMem (&RootBridge->Bus, &Bridge->Bus, sizeof (PCI_ROOT_BRIDGE_APERTURE));
+  CopyMem (&RootBridge->Io, &Bridge->Io, sizeof (PCI_ROOT_BRIDGE_APERTURE));
+  CopyMem (&RootBridge->Mem, &Bridge->Mem, sizeof (PCI_ROOT_BRIDGE_APERTURE));
+  CopyMem (&RootBridge->MemAbove4G, &Bridge->MemAbove4G, sizeof (PCI_ROOT_BRIDGE_APERTURE));
+
+
+  for (Index = TypeIo; Index < TypeMax; Index++) {
+    RootBridge->ResAllocNode[Index].Type   = Index;
+    RootBridge->ResAllocNode[Index].Base   = 0;
+    RootBridge->ResAllocNode[Index].Length = 0;
+    RootBridge->ResAllocNode[Index].Status = ResNone;
+  }
+
+  RootBridge->RootBridgeIo.SegmentNumber  = Bridge->Segment;
+  RootBridge->RootBridgeIo.ParentHandle   = HostBridgeHandle;
+  RootBridge->RootBridgeIo.PollMem        = RootBridgeIoPollMem;
+  RootBridge->RootBridgeIo.PollIo         = RootBridgeIoPollIo;
+  RootBridge->RootBridgeIo.Mem.Read       = RootBridgeIoMemRead;
+  RootBridge->RootBridgeIo.Mem.Write      = RootBridgeIoMemWrite;
+  RootBridge->RootBridgeIo.Io.Read        = RootBridgeIoIoRead;
+  RootBridge->RootBridgeIo.Io.Write       = RootBridgeIoIoWrite;
+  RootBridge->RootBridgeIo.CopyMem        = RootBridgeIoCopyMem;
+  RootBridge->RootBridgeIo.Pci.Read       = RootBridgeIoPciRead;
+  RootBridge->RootBridgeIo.Pci.Write      = RootBridgeIoPciWrite;
+  RootBridge->RootBridgeIo.Map            = RootBridgeIoMap;
+  RootBridge->RootBridgeIo.Unmap          = RootBridgeIoUnmap;
+  RootBridge->RootBridgeIo.AllocateBuffer = RootBridgeIoAllocateBuffer;
+  RootBridge->RootBridgeIo.FreeBuffer     = RootBridgeIoFreeBuffer;
+  RootBridge->RootBridgeIo.Flush          = RootBridgeIoFlush;
+  RootBridge->RootBridgeIo.GetAttributes  = RootBridgeIoGetAttributes;
+  RootBridge->RootBridgeIo.SetAttributes  = RootBridgeIoSetAttributes;
+  RootBridge->RootBridgeIo.Configuration  = RootBridgeIoConfiguration;
+
+  return RootBridge;
+}
+
+/**
+  Check parameters for IO,MMIO,PCI read/write services of PCI Root Bridge IO.
+
+  The I/O operations are carried out exactly as requested. The caller is
+  responsible for satisfying any alignment and I/O width restrictions that a PI
+  System on a platform might require. For example on some platforms, width
+  requests of EfiCpuIoWidthUint64 do not work. Misaligned buffers, on the other
+  hand, will be handled by the driver.
+
+  @param[in] This           A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+
+  @param[in] OperationType  I/O operation type: IO/MMIO/PCI.
+
+  @param[in] Width          Signifies the width of the I/O or Memory operation.
+
+  @param[in] Address        The base address of the I/O operation.
+
+  @param[in] Count          The number of I/O operations to perform. The number
+                            of bytes moved is Width size * Count, starting at
+                            Address.
+
+  @param[in] Buffer         For read operations, the destination buffer to
+                            store the results. For write operations, the source
+                            buffer from which to write data.
+
+  @retval EFI_SUCCESS            The parameters for this request pass the
+                                 checks.
+
+  @retval EFI_INVALID_PARAMETER  Width is invalid for this PI system.
+
+  @retval EFI_INVALID_PARAMETER  Buffer is NULL.
+
+  @retval EFI_UNSUPPORTED        The Buffer is not aligned for the given Width.
+
+  @retval EFI_UNSUPPORTED        The address range specified by Address, Width,
+                                 and Count is not valid for this PI system.
+**/
+EFI_STATUS
+RootBridgeIoCheckParameter (
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN OPERATION_TYPE                         OperationType,
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN UINT64                                 Address,
+  IN UINTN                                  Count,
+  IN VOID                                   *Buffer
+  )
+{
+  PCI_ROOT_BRIDGE_INSTANCE                     *RootBridge;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS  *PciRbAddr;
+  UINT64                                       Base;
+  UINT64                                       Limit;
+  UINT32                                       Size;
+
+  //
+  // Check to see if Buffer is NULL
+  //
+  if (Buffer == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Check to see if Width is in the valid range
+  //
+  if ((UINT32) Width >= EfiPciWidthMaximum) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // For FIFO type, the target address won't increase during the access,
+  // so treat Count as 1
+  //
+  if (Width >= EfiPciWidthFifoUint8 && Width <= EfiPciWidthFifoUint64) {
+    Count = 1;
+  }
+
+  Width = (EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH) (Width & 0x03);
+  Size  = 1 << Width;
+
+  //
+  // Check to see if Address is aligned
+  //
+  if ((Address & (Size - 1)) != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+
+  //
+  // Check to see if any address associated with this transfer exceeds the
+  // maximum allowed address.  The maximum address implied by the parameters
+  // passed in is Address + Size * Count.  If the following condition is met,
+  // then the transfer is not supported.
+  //
+  //    Address + Size * Count > Limit + 1
+  //
+  // Since Limit can be the maximum integer value supported by the CPU and
+  // Count can also be the maximum integer value supported by the CPU, this
+  // range check must be adjusted to avoid all oveflow conditions.
+  //
+  if (OperationType == IoOperation) {
+    //
+    // Allow Legacy IO access
+    //
+    if (Address + MultU64x32 (Count, Size) <= 0x1000) {
+      if ((RootBridge->Attributes & (
+           EFI_PCI_ATTRIBUTE_ISA_IO | EFI_PCI_ATTRIBUTE_VGA_PALETTE_IO | EFI_PCI_ATTRIBUTE_VGA_IO |
+           EFI_PCI_ATTRIBUTE_IDE_PRIMARY_IO | EFI_PCI_ATTRIBUTE_IDE_SECONDARY_IO |
+           EFI_PCI_ATTRIBUTE_ISA_IO_16 | EFI_PCI_ATTRIBUTE_VGA_PALETTE_IO_16 | EFI_PCI_ATTRIBUTE_VGA_IO_16)) != 0) {
+        return EFI_SUCCESS;
+      }
+    }
+    Base = RootBridge->Io.Base;
+    Limit = RootBridge->Io.Limit;
+  } else if (OperationType == MemOperation) {
+    //
+    // Allow Legacy MMIO access
+    //
+    if ((Address >= 0xA0000) && (Address + MultU64x32 (Count, Size)) <= 0xC0000) {
+      if ((RootBridge->Attributes & EFI_PCI_ATTRIBUTE_VGA_MEMORY) != 0) {
+        return EFI_SUCCESS;
+      }
+    }
+    //
+    // By comparing the Address against Limit we know which range to be used
+    // for checking
+    //
+    if (Address + MultU64x32 (Count, Size) <= RootBridge->Mem.Limit + 1) {
+      Base = RootBridge->Mem.Base;
+      Limit = RootBridge->Mem.Limit;
+    } else {
+      Base = RootBridge->MemAbove4G.Base;
+      Limit = RootBridge->MemAbove4G.Limit;
+    }
+  } else {
+    PciRbAddr = (EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS*) &Address;
+    if (PciRbAddr->Bus < RootBridge->Bus.Base ||
+        PciRbAddr->Bus > RootBridge->Bus.Limit) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    if (PciRbAddr->Device > PCI_MAX_DEVICE ||
+        PciRbAddr->Function > PCI_MAX_FUNC) {
+      return EFI_INVALID_PARAMETER;
+    }
+
+    if (PciRbAddr->ExtendedRegister != 0) {
+      Address = PciRbAddr->ExtendedRegister;
+    } else {
+      Address = PciRbAddr->Register;
+    }
+    Base = 0;
+    Limit = 0xFFF;
+  }
+
+  if (Address < Base) {
+      return EFI_INVALID_PARAMETER;
+  }
+
+  if (Address + MultU64x32 (Count, Size) > Limit + 1) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Polls an address in memory mapped I/O space until an exit condition is met,
+  or a timeout occurs.
+
+  This function provides a standard way to poll a PCI memory location. A PCI
+  memory read operation is performed at the PCI memory address specified by
+  Address for the width specified by Width. The result of this PCI memory read
+  operation is stored in Result. This PCI memory read operation is repeated
+  until either a timeout of Delay 100 ns units has expired, or (Result & Mask)
+  is equal to Value.
+
+  @param[in]   This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in]   Width     Signifies the width of the memory operations.
+  @param[in]   Address   The base address of the memory operations. The caller
+                         is responsible for aligning Address if required.
+  @param[in]   Mask      Mask used for the polling criteria. Bytes above Width
+                         in Mask are ignored. The bits in the bytes below Width
+                         which are zero in Mask are ignored when polling the
+                         memory address.
+  @param[in]   Value     The comparison value used for the polling exit
+                         criteria.
+  @param[in]   Delay     The number of 100 ns units to poll. Note that timer
+                         available may be of poorer granularity.
+  @param[out]  Result    Pointer to the last value read from the memory
+                         location.
+
+  @retval EFI_SUCCESS            The last data returned from the access matched
+                                 the poll exit criteria.
+  @retval EFI_INVALID_PARAMETER  Width is invalid.
+  @retval EFI_INVALID_PARAMETER  Result is NULL.
+  @retval EFI_TIMEOUT            Delay expired before a match occurred.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to a
+                                 lack of resources.
+**/
+
+EFI_STATUS
+EFIAPI
+RootBridgeIoPollMem (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN  UINT64                                 Address,
+  IN  UINT64                                 Mask,
+  IN  UINT64                                 Value,
+  IN  UINT64                                 Delay,
+  OUT UINT64                                 *Result
+  )
+{
+  EFI_STATUS  Status;
+  UINT64      NumberOfTicks;
+  UINT32      Remainder;
+
+  if (Result == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((UINT32)Width > EfiPciWidthUint64) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // No matter what, always do a single poll.
+  //
+  Status = This->Mem.Read (This, Width, Address, 1, Result);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  if ((*Result & Mask) == Value) {
+    return EFI_SUCCESS;
+  }
+
+  if (Delay == 0) {
+    return EFI_SUCCESS;
+
+  } else {
+
+    //
+    // Determine the proper # of metronome ticks to wait for polling the
+    // location.  The nuber of ticks is Roundup (Delay /
+    // mMetronome->TickPeriod)+1
+    // The "+1" to account for the possibility of the first tick being short
+    // because we started in the middle of a tick.
+    //
+    // BugBug: overriding mMetronome->TickPeriod with UINT32 until Metronome
+    // protocol definition is updated.
+    //
+    NumberOfTicks = DivU64x32Remainder (Delay, (UINT32) mMetronome->TickPeriod,
+                      &Remainder);
+    if (Remainder != 0) {
+      NumberOfTicks += 1;
+    }
+    NumberOfTicks += 1;
+
+    while (NumberOfTicks != 0) {
+
+      mMetronome->WaitForTick (mMetronome, 1);
+
+      Status = This->Mem.Read (This, Width, Address, 1, Result);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+
+      if ((*Result & Mask) == Value) {
+        return EFI_SUCCESS;
+      }
+
+      NumberOfTicks -= 1;
+    }
+  }
+  return EFI_TIMEOUT;
+}
+
+/**
+  Reads from the I/O space of a PCI Root Bridge. Returns when either the
+  polling exit criteria is satisfied or after a defined duration.
+
+  This function provides a standard way to poll a PCI I/O location. A PCI I/O
+  read operation is performed at the PCI I/O address specified by Address for
+  the width specified by Width.
+  The result of this PCI I/O read operation is stored in Result. This PCI I/O
+  read operation is repeated until either a timeout of Delay 100 ns units has
+  expired, or (Result & Mask) is equal to Value.
+
+  @param[in] This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in] Width     Signifies the width of the I/O operations.
+  @param[in] Address   The base address of the I/O operations. The caller is
+                       responsible for aligning Address if required.
+  @param[in] Mask      Mask used for the polling criteria. Bytes above Width in
+                       Mask are ignored. The bits in the bytes below Width
+                       which are zero in Mask are ignored when polling the I/O
+                       address.
+  @param[in] Value     The comparison value used for the polling exit criteria.
+  @param[in] Delay     The number of 100 ns units to poll. Note that timer
+                       available may be of poorer granularity.
+  @param[out] Result   Pointer to the last value read from the memory location.
+
+  @retval EFI_SUCCESS            The last data returned from the access matched
+                                 the poll exit criteria.
+  @retval EFI_INVALID_PARAMETER  Width is invalid.
+  @retval EFI_INVALID_PARAMETER  Result is NULL.
+  @retval EFI_TIMEOUT            Delay expired before a match occurred.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to a
+                                 lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPollIo (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN  UINT64                                 Address,
+  IN  UINT64                                 Mask,
+  IN  UINT64                                 Value,
+  IN  UINT64                                 Delay,
+  OUT UINT64                                 *Result
+  )
+{
+  EFI_STATUS  Status;
+  UINT64      NumberOfTicks;
+  UINT32      Remainder;
+
+  //
+  // No matter what, always do a single poll.
+  //
+
+  if (Result == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if ((UINT32)Width > EfiPciWidthUint64) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  Status = This->Io.Read (This, Width, Address, 1, Result);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  if ((*Result & Mask) == Value) {
+    return EFI_SUCCESS;
+  }
+
+  if (Delay == 0) {
+    return EFI_SUCCESS;
+
+  } else {
+
+    //
+    // Determine the proper # of metronome ticks to wait for polling the
+    // location.  The number of ticks is Roundup (Delay /
+    // mMetronome->TickPeriod)+1
+    // The "+1" to account for the possibility of the first tick being short
+    // because we started in the middle of a tick.
+    //
+    NumberOfTicks = DivU64x32Remainder (Delay, (UINT32)mMetronome->TickPeriod,
+                      &Remainder);
+    if (Remainder != 0) {
+      NumberOfTicks += 1;
+    }
+    NumberOfTicks += 1;
+
+    while (NumberOfTicks != 0) {
+
+      mMetronome->WaitForTick (mMetronome, 1);
+
+      Status = This->Io.Read (This, Width, Address, 1, Result);
+      if (EFI_ERROR (Status)) {
+        return Status;
+      }
+
+      if ((*Result & Mask) == Value) {
+        return EFI_SUCCESS;
+      }
+
+      NumberOfTicks -= 1;
+    }
+  }
+  return EFI_TIMEOUT;
+}
+
+/**
+  Enables a PCI driver to access PCI controller registers in the PCI root
+  bridge memory space.
+
+  The Mem.Read(), and Mem.Write() functions enable a driver to access PCI
+  controller registers in the PCI root bridge memory space.
+  The memory operations are carried out exactly as requested. The caller is
+  responsible for satisfying any alignment and memory width restrictions that a
+  PCI Root Bridge on a platform might require.
+
+  @param[in]   This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in]   Width     Signifies the width of the memory operation.
+  @param[in]   Address   The base address of the memory operation. The caller
+                         is responsible for aligning the Address if required.
+  @param[in]   Count     The number of memory operations to perform. Bytes
+                         moved is Width size * Count, starting at Address.
+  @param[out]  Buffer    For read operations, the destination buffer to store
+                         the results. For write operations, the source buffer
+                         to write data from.
+
+  @retval EFI_SUCCESS            The data was read from or written to the PCI
+                                 root bridge.
+  @retval EFI_INVALID_PARAMETER  Width is invalid for this PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  Buffer is NULL.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to a
+                                 lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMemRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  OUT    VOID                                   *Buffer
+  )
+{
+  EFI_STATUS                             Status;
+
+  Status = RootBridgeIoCheckParameter (This, MemOperation, Width, Address,
+                                       Count, Buffer);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return mCpuIo->Mem.Read (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
+}
+
+/**
+  Enables a PCI driver to access PCI controller registers in the PCI root
+  bridge memory space.
+
+  The Mem.Read(), and Mem.Write() functions enable a driver to access PCI
+  controller registers in the PCI root bridge memory space.
+  The memory operations are carried out exactly as requested. The caller is
+  responsible for satisfying any alignment and memory width restrictions that a
+  PCI Root Bridge on a platform might require.
+
+  @param[in]   This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in]   Width     Signifies the width of the memory operation.
+  @param[in]   Address   The base address of the memory operation. The caller
+                         is responsible for aligning the Address if required.
+  @param[in]   Count     The number of memory operations to perform. Bytes
+                         moved is Width size * Count, starting at Address.
+  @param[in]   Buffer    For read operations, the destination buffer to store
+                         the results. For write operations, the source buffer
+                         to write data from.
+
+  @retval EFI_SUCCESS            The data was read from or written to the PCI
+                                 root bridge.
+  @retval EFI_INVALID_PARAMETER  Width is invalid for this PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  Buffer is NULL.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to a
+                                 lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMemWrite (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  IN     VOID                                   *Buffer
+  )
+{
+  EFI_STATUS                             Status;
+
+  Status = RootBridgeIoCheckParameter (This, MemOperation, Width, Address,
+                                       Count, Buffer);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return mCpuIo->Mem.Write (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
+}
+
+/**
+  Enables a PCI driver to access PCI controller registers in the PCI root
+  bridge I/O space.
+
+  @param[in]   This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in]   Width       Signifies the width of the memory operations.
+  @param[in]   Address     The base address of the I/O operation. The caller is
+                           responsible for aligning the Address if required.
+  @param[in]   Count       The number of I/O operations to perform. Bytes moved
+                           is Width size * Count, starting at Address.
+  @param[out]  Buffer      For read operations, the destination buffer to store
+                           the results. For write operations, the source buffer
+                           to write data from.
+
+  @retval EFI_SUCCESS              The data was read from or written to the PCI
+                                   root bridge.
+  @retval EFI_INVALID_PARAMETER    Width is invalid for this PCI root bridge.
+  @retval EFI_INVALID_PARAMETER    Buffer is NULL.
+  @retval EFI_OUT_OF_RESOURCES     The request could not be completed due to a
+                                   lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoIoRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL        *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH  Width,
+  IN     UINT64                                 Address,
+  IN     UINTN                                  Count,
+  OUT    VOID                                   *Buffer
+  )
+{
+  EFI_STATUS                                    Status;
+  Status = RootBridgeIoCheckParameter (
+             This, IoOperation, Width,
+             Address, Count, Buffer
+             );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return mCpuIo->Io.Read (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
+}
+
+/**
+  Enables a PCI driver to access PCI controller registers in the PCI root
+  bridge I/O space.
+
+  @param[in]   This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in]   Width       Signifies the width of the memory operations.
+  @param[in]   Address     The base address of the I/O operation. The caller is
+                           responsible for aligning the Address if required.
+  @param[in]   Count       The number of I/O operations to perform. Bytes moved
+                           is Width size * Count, starting at Address.
+  @param[in]   Buffer      For read operations, the destination buffer to store
+                           the results. For write operations, the source buffer
+                           to write data from.
+
+  @retval EFI_SUCCESS              The data was read from or written to the PCI
+                                   root bridge.
+  @retval EFI_INVALID_PARAMETER    Width is invalid for this PCI root bridge.
+  @retval EFI_INVALID_PARAMETER    Buffer is NULL.
+  @retval EFI_OUT_OF_RESOURCES     The request could not be completed due to a
+                                   lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoIoWrite (
+  IN       EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL         *This,
+  IN       EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH   Width,
+  IN       UINT64                                  Address,
+  IN       UINTN                                   Count,
+  IN       VOID                                    *Buffer
+  )
+{
+  EFI_STATUS                                    Status;
+  Status = RootBridgeIoCheckParameter (
+             This, IoOperation, Width,
+             Address, Count, Buffer
+             );
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+  return mCpuIo->Io.Write (mCpuIo, (EFI_CPU_IO_PROTOCOL_WIDTH) Width, Address, Count, Buffer);
+}
+
+/**
+  Enables a PCI driver to copy one region of PCI root bridge memory space to
+  another region of PCI root bridge memory space.
+
+  The CopyMem() function enables a PCI driver to copy one region of PCI root
+  bridge memory space to another region of PCI root bridge memory space. This
+  is especially useful for video scroll operation on a memory mapped video
+  buffer.
+  The memory operations are carried out exactly as requested. The caller is
+  responsible for satisfying any alignment and memory width restrictions that a
+  PCI root bridge on a platform might require.
+
+  @param[in] This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+                         instance.
+  @param[in] Width       Signifies the width of the memory operations.
+  @param[in] DestAddress The destination address of the memory operation. The
+                         caller is responsible for aligning the DestAddress if
+                         required.
+  @param[in] SrcAddress  The source address of the memory operation. The caller
+                         is responsible for aligning the SrcAddress if
+                         required.
+  @param[in] Count       The number of memory operations to perform. Bytes
+                         moved is Width size * Count, starting at DestAddress
+                         and SrcAddress.
+
+  @retval  EFI_SUCCESS             The data was copied from one memory region
+                                   to another memory region.
+  @retval  EFI_INVALID_PARAMETER   Width is invalid for this PCI root bridge.
+  @retval  EFI_OUT_OF_RESOURCES    The request could not be completed due to a
+                                   lack of resources.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoCopyMem (
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL              *This,
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH        Width,
+  IN UINT64                                       DestAddress,
+  IN UINT64                                       SrcAddress,
+  IN UINTN                                        Count
+  )
+{
+  EFI_STATUS  Status;
+  BOOLEAN     Forward;
+  UINTN       Stride;
+  UINTN       Index;
+  UINT64      Result;
+
+  if ((UINT32) Width > EfiPciWidthUint64) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  if (DestAddress == SrcAddress) {
+    return EFI_SUCCESS;
+  }
+
+  Stride = (UINTN) (1 << Width);
+
+  Forward = TRUE;
+  if ((DestAddress > SrcAddress) &&
+      (DestAddress < (SrcAddress + Count * Stride))) {
+    Forward = FALSE;
+    SrcAddress = SrcAddress + (Count - 1) * Stride;
+    DestAddress = DestAddress + (Count - 1) * Stride;
+  }
+
+  for (Index = 0; Index < Count; Index++) {
+    Status = RootBridgeIoMemRead (
+               This,
+               Width,
+               SrcAddress,
+               1,
+               &Result
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    Status = RootBridgeIoMemWrite (
+               This,
+               Width,
+               DestAddress,
+               1,
+               &Result
+               );
+    if (EFI_ERROR (Status)) {
+      return Status;
+    }
+    if (Forward) {
+      SrcAddress += Stride;
+      DestAddress += Stride;
+    } else {
+      SrcAddress -= Stride;
+      DestAddress -= Stride;
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+
+/**
+  PCI configuration space access.
+
+  @param This     A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Read     TRUE indicating it's a read operation.
+  @param Width    Signifies the width of the memory operation.
+  @param Address  The address within the PCI configuration space
+                  for the PCI controller.
+  @param Count    The number of PCI configuration operations
+                  to perform.
+  @param Buffer   The destination buffer to store the results.
+
+  @retval EFI_SUCCESS            The data was read/written from/to the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  Invalid parameters found.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPciAccess (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL       *This,
+  IN     BOOLEAN                               Read,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width,
+  IN     UINT64                                Address,
+  IN     UINTN                                 Count,
+  IN OUT VOID                                  *Buffer
+  )
+{
+  EFI_STATUS                                   Status;
+  PCI_ROOT_BRIDGE_INSTANCE                     *RootBridge;
+  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDRESS  PciAddress;
+  UINT8                                        *Uint8Buffer;
+  UINT8                                        InStride;
+  UINT8                                        OutStride;
+  UINTN                                        Size;
+
+  Status = RootBridgeIoCheckParameter (This, PciOperation, Width, Address, Count, Buffer);
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
+  //
+  // Read Pci configuration space
+  //
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+  CopyMem (&PciAddress, &Address, sizeof (PciAddress));
+
+  if (PciAddress.ExtendedRegister == 0) {
+    PciAddress.ExtendedRegister = PciAddress.Register;
+  }
+
+  Address = PCI_SEGMENT_LIB_ADDRESS (
+              RootBridge->RootBridgeIo.SegmentNumber,
+              PciAddress.Bus,
+              PciAddress.Device,
+              PciAddress.Function,
+              PciAddress.ExtendedRegister
+              );
+
+  //
+  // Select loop based on the width of the transfer
+  //
+  InStride  = mInStride[Width];
+  OutStride = mOutStride[Width];
+  Size      = (UINTN) (1 << (Width & 0x03));
+  for (Uint8Buffer = Buffer; Count > 0; Address += InStride, Uint8Buffer += OutStride, Count--) {
+    if (Read) {
+      PciSegmentReadBuffer (Address, Size, Uint8Buffer);
+    } else {
+      PciSegmentWriteBuffer (Address, Size, Uint8Buffer);
+    }
+  }
+  return EFI_SUCCESS;
+}
+
+/**
+  Allows read from PCI configuration space.
+
+  @param This     A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width    Signifies the width of the memory operation.
+  @param Address  The address within the PCI configuration space
+                  for the PCI controller.
+  @param Count    The number of PCI configuration operations
+                  to perform.
+  @param Buffer   The destination buffer to store the results.
+
+  @retval EFI_SUCCESS           The data was read from the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER Invalid parameters found.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPciRead (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL       *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width,
+  IN     UINT64                                Address,
+  IN     UINTN                                 Count,
+  IN OUT VOID                                  *Buffer
+  )
+{
+  return RootBridgeIoPciAccess (This, TRUE, Width, Address, Count, Buffer);
+}
+
+/**
+  Allows write to PCI configuration space.
+
+  @param This     A pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
+  @param Width    Signifies the width of the memory operation.
+  @param Address  The address within the PCI configuration space
+                  for the PCI controller.
+  @param Count    The number of PCI configuration operations
+                  to perform.
+  @param Buffer   The source buffer to get the results.
+
+  @retval EFI_SUCCESS            The data was written to the PCI root bridge.
+  @retval EFI_INVALID_PARAMETER  Invalid parameters found.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoPciWrite (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL       *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_WIDTH Width,
+  IN     UINT64                                Address,
+  IN     UINTN                                 Count,
+  IN OUT VOID                                  *Buffer
+  )
+{
+  return RootBridgeIoPciAccess (This, FALSE, Width, Address, Count, Buffer);
+}
+
+/**
+
+  Provides the PCI controller-specific address needed to access
+  system memory for DMA.
+
+  @param This           A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Operation      Indicate if the bus master is going to read or write
+                        to system memory.
+  @param HostAddress    The system memory address to map on the PCI controller.
+  @param NumberOfBytes  On input the number of bytes to map.
+                        On output the number of bytes that were mapped.
+  @param DeviceAddress  The resulting map address for the bus master PCI
+                        controller to use to access the system memory's HostAddress.
+  @param Mapping        The value to pass to Unmap() when the bus master DMA
+                        operation is complete.
+
+  @retval EFI_SUCCESS            Success.
+  @retval EFI_INVALID_PARAMETER  Invalid parameters found.
+  @retval EFI_UNSUPPORTED        The HostAddress cannot be mapped as a common buffer.
+  @retval EFI_DEVICE_ERROR       The System hardware could not map the requested address.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to lack of resources.
+
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoMap (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL            *This,
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_OPERATION  Operation,
+  IN     VOID                                       *HostAddress,
+  IN OUT UINTN                                      *NumberOfBytes,
+  OUT    EFI_PHYSICAL_ADDRESS                       *DeviceAddress,
+  OUT    VOID                                       **Mapping
+  )
+{
+  EFI_STATUS                                        Status;
+  PCI_ROOT_BRIDGE_INSTANCE                          *RootBridge;
+  EFI_PHYSICAL_ADDRESS                              PhysicalAddress;
+  MAP_INFO                                          *MapInfo;
+
+  if (HostAddress == NULL || NumberOfBytes == NULL || DeviceAddress == NULL ||
+      Mapping == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Make sure that Operation is valid
+  //
+  if ((UINT32) Operation >= EfiPciOperationMaximum) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+
+  PhysicalAddress = (EFI_PHYSICAL_ADDRESS) (UINTN) HostAddress;
+  if (!RootBridge->DmaAbove4G && ((PhysicalAddress + *NumberOfBytes) > SIZE_4GB)) {
+    //
+    // If the root bridge can not handle performing DMA above 4GB but
+    // any part of the DMA transfer being mapped is above 4GB, then
+    // map the DMA transfer to a buffer below 4GB.
+    //
+
+    if (Operation == EfiPciOperationBusMasterCommonBuffer ||
+        Operation == EfiPciOperationBusMasterCommonBuffer64) {
+      //
+      // Common Buffer operations can not be remapped.  If the common buffer
+      // if above 4GB, then it is not possible to generate a mapping, so return
+      // an error.
+      //
+      return EFI_UNSUPPORTED;
+    }
+
+    //
+    // Allocate a MAP_INFO structure to remember the mapping when Unmap() is
+    // called later.
+    //
+    MapInfo = AllocatePool (sizeof (MAP_INFO));
+    if (MapInfo == NULL) {
+      *NumberOfBytes = 0;
+      return EFI_OUT_OF_RESOURCES;
+    }
+
+    //
+    // Initialize the MAP_INFO structure
+    //
+    MapInfo->Signature         = MAP_INFO_SIGNATURE;
+    MapInfo->Operation         = Operation;
+    MapInfo->NumberOfBytes     = *NumberOfBytes;
+    MapInfo->NumberOfPages     = EFI_SIZE_TO_PAGES (MapInfo->NumberOfBytes);
+    MapInfo->HostAddress       = PhysicalAddress;
+    MapInfo->MappedHostAddress = SIZE_4GB - 1;
+
+    //
+    // Allocate a buffer below 4GB to map the transfer to.
+    //
+    Status = gBS->AllocatePages (
+                    AllocateMaxAddress,
+                    EfiBootServicesData,
+                    MapInfo->NumberOfPages,
+                    &MapInfo->MappedHostAddress
+                    );
+    if (EFI_ERROR (Status)) {
+      FreePool (MapInfo);
+      *NumberOfBytes = 0;
+      return Status;
+    }
+
+    //
+    // If this is a read operation from the Bus Master's point of view,
+    // then copy the contents of the real buffer into the mapped buffer
+    // so the Bus Master can read the contents of the real buffer.
+    //
+    if (Operation == EfiPciOperationBusMasterRead ||
+        Operation == EfiPciOperationBusMasterRead64) {
+      CopyMem (
+        (VOID *) (UINTN) MapInfo->MappedHostAddress,
+        (VOID *) (UINTN) MapInfo->HostAddress,
+        MapInfo->NumberOfBytes
+        );
+    }
+
+    InsertTailList (&RootBridge->Maps, &MapInfo->Link);
+
+    //
+    // The DeviceAddress is the address of the maped buffer below 4GB
+    //
+    *DeviceAddress = MapInfo->MappedHostAddress;
+    //
+    // Return a pointer to the MAP_INFO structure in Mapping
+    //
+    *Mapping       = MapInfo;
+  } else {
+    //
+    // If the root bridge CAN handle performing DMA above 4GB or
+    // the transfer is below 4GB, so the DeviceAddress is simply the
+    // HostAddress
+    //
+    *DeviceAddress = PhysicalAddress;
+    *Mapping       = NO_MAPPING;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Completes the Map() operation and releases any corresponding resources.
+
+  The Unmap() function completes the Map() operation and releases any
+  corresponding resources.
+  If the operation was an EfiPciOperationBusMasterWrite or
+  EfiPciOperationBusMasterWrite64, the data is committed to the target system
+  memory.
+  Any resources used for the mapping are freed.
+
+  @param[in] This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in] Mapping   The mapping value returned from Map().
+
+  @retval EFI_SUCCESS            The range was unmapped.
+  @retval EFI_INVALID_PARAMETER  Mapping is not a value that was returned by Map().
+  @retval EFI_DEVICE_ERROR       The data was not committed to the target system memory.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoUnmap (
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN VOID                             *Mapping
+  )
+{
+  MAP_INFO                 *MapInfo;
+  LIST_ENTRY               *Link;
+  PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+  //
+  // See if the Map() operation associated with this Unmap() required a mapping
+  // buffer. If a mapping buffer was not required, then this function simply
+  // returns EFI_SUCCESS.
+  //
+  if (Mapping == NO_MAPPING) {
+    return EFI_SUCCESS;
+  }
+
+  MapInfo = NO_MAPPING;
+  for (Link = GetFirstNode (&RootBridge->Maps)
+       ; !IsNull (&RootBridge->Maps, Link)
+       ; Link = GetNextNode (&RootBridge->Maps, Link)
+       ) {
+    MapInfo = MAP_INFO_FROM_LINK (Link);
+    if (MapInfo == Mapping) {
+      break;
+    }
+  }
+  //
+  // Mapping is not a valid value returned by Map()
+  //
+  if (MapInfo != Mapping) {
+    return EFI_INVALID_PARAMETER;
+  }
+  RemoveEntryList (&MapInfo->Link);
+
+  //
+  // If this is a write operation from the Bus Master's point of view,
+  // then copy the contents of the mapped buffer into the real buffer
+  // so the processor can read the contents of the real buffer.
+  //
+  if (MapInfo->Operation == EfiPciOperationBusMasterWrite ||
+      MapInfo->Operation == EfiPciOperationBusMasterWrite64) {
+    CopyMem (
+      (VOID *) (UINTN) MapInfo->HostAddress,
+      (VOID *) (UINTN) MapInfo->MappedHostAddress,
+      MapInfo->NumberOfBytes
+      );
+  }
+
+  //
+  // Free the mapped buffer and the MAP_INFO structure.
+  //
+  gBS->FreePages (MapInfo->MappedHostAddress, MapInfo->NumberOfPages);
+  FreePool (Mapping);
+  return EFI_SUCCESS;
+}
+
+/**
+  Allocates pages that are suitable for an EfiPciOperationBusMasterCommonBuffer
+  or EfiPciOperationBusMasterCommonBuffer64 mapping.
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Type        This parameter is not used and must be ignored.
+  @param MemoryType  The type of memory to allocate, EfiBootServicesData or
+                     EfiRuntimeServicesData.
+  @param Pages       The number of pages to allocate.
+  @param HostAddress A pointer to store the base system memory address of the
+                     allocated range.
+  @param Attributes  The requested bit mask of attributes for the allocated
+                     range. Only the attributes
+                     EFI_PCI_ATTRIBUTE_MEMORY_WRITE_COMBINE,
+                     EFI_PCI_ATTRIBUTE_MEMORY_CACHED, and
+                     EFI_PCI_ATTRIBUTE_DUAL_ADDRESS_CYCLE may be used with this
+                     function.
+
+  @retval EFI_SUCCESS            The requested memory pages were allocated.
+  @retval EFI_INVALID_PARAMETER  MemoryType is invalid.
+  @retval EFI_INVALID_PARAMETER  HostAddress is NULL.
+  @retval EFI_UNSUPPORTED        Attributes is unsupported. The only legal
+                                 attribute bits are MEMORY_WRITE_COMBINE,
+                                 MEMORY_CACHED, and DUAL_ADDRESS_CYCLE.
+  @retval EFI_OUT_OF_RESOURCES   The memory pages could not be allocated.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoAllocateBuffer (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN  EFI_ALLOCATE_TYPE                Type,
+  IN  EFI_MEMORY_TYPE                  MemoryType,
+  IN  UINTN                            Pages,
+  OUT VOID                             **HostAddress,
+  IN  UINT64                           Attributes
+  )
+{
+  EFI_STATUS                Status;
+  EFI_PHYSICAL_ADDRESS      PhysicalAddress;
+  PCI_ROOT_BRIDGE_INSTANCE  *RootBridge;
+  EFI_ALLOCATE_TYPE         AllocateType;
+
+  //
+  // Validate Attributes
+  //
+  if ((Attributes & EFI_PCI_ATTRIBUTE_INVALID_FOR_ALLOCATE_BUFFER) != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  //
+  // Check for invalid inputs
+  //
+  if (HostAddress == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // The only valid memory types are EfiBootServicesData and
+  // EfiRuntimeServicesData
+  //
+  if (MemoryType != EfiBootServicesData &&
+      MemoryType != EfiRuntimeServicesData) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+
+  AllocateType = AllocateAnyPages;
+  if (!RootBridge->DmaAbove4G) {
+    //
+    // Limit allocations to memory below 4GB
+    //
+    AllocateType    = AllocateMaxAddress;
+    PhysicalAddress = (EFI_PHYSICAL_ADDRESS) (SIZE_4GB - 1);
+  }
+  Status = gBS->AllocatePages (
+                  AllocateType,
+                  MemoryType,
+                  Pages,
+                  &PhysicalAddress
+                  );
+  if (!EFI_ERROR (Status)) {
+    *HostAddress = (VOID *) (UINTN) PhysicalAddress;
+  }
+
+  return Status;
+}
+
+/**
+  Frees memory that was allocated with AllocateBuffer().
+
+  The FreeBuffer() function frees memory that was allocated with
+  AllocateBuffer().
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Pages       The number of pages to free.
+  @param HostAddress The base system memory address of the allocated range.
+
+  @retval EFI_SUCCESS            The requested memory pages were freed.
+  @retval EFI_INVALID_PARAMETER  The memory range specified by HostAddress and
+                                 Pages was not allocated with AllocateBuffer().
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoFreeBuffer (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN  UINTN                            Pages,
+  OUT VOID                             *HostAddress
+  )
+{
+  return gBS->FreePages ((EFI_PHYSICAL_ADDRESS) (UINTN) HostAddress, Pages);
+}
+
+/**
+  Flushes all PCI posted write transactions from a PCI host bridge to system
+  memory.
+
+  The Flush() function flushes any PCI posted write transactions from a PCI
+  host bridge to system memory. Posted write transactions are generated by PCI
+  bus masters when they perform write transactions to target addresses in
+  system memory.
+  This function does not flush posted write transactions from any PCI bridges.
+  A PCI controller specific action must be taken to guarantee that the posted
+  write transactions have been flushed from the PCI controller and from all the
+  PCI bridges into the PCI host bridge. This is typically done with a PCI read
+  transaction from the PCI controller prior to calling Flush().
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+
+  @retval EFI_SUCCESS        The PCI posted write transactions were flushed
+                             from the PCI host bridge to system memory.
+  @retval EFI_DEVICE_ERROR   The PCI posted write transactions were not flushed
+                             from the PCI host bridge due to a hardware error.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoFlush (
+  IN EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL           *This
+  )
+{
+  return EFI_SUCCESS;
+}
+
+/**
+  Gets the attributes that a PCI root bridge supports setting with
+  SetAttributes(), and the attributes that a PCI root bridge is currently
+  using.
+
+  The GetAttributes() function returns the mask of attributes that this PCI
+  root bridge supports and the mask of attributes that the PCI root bridge is
+  currently using.
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Supported   A pointer to the mask of attributes that this PCI root
+                     bridge supports setting with SetAttributes().
+  @param Attributes  A pointer to the mask of attributes that this PCI root
+                     bridge is currently using.
+
+  @retval  EFI_SUCCESS           If Supports is not NULL, then the attributes
+                                 that the PCI root bridge supports is returned
+                                 in Supports. If Attributes is not NULL, then
+                                 the attributes that the PCI root bridge is
+                                 currently using is returned in Attributes.
+  @retval  EFI_INVALID_PARAMETER Both Supports and Attributes are NULL.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoGetAttributes (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  OUT UINT64                           *Supported,
+  OUT UINT64                           *Attributes
+  )
+{
+  PCI_ROOT_BRIDGE_INSTANCE *RootBridge;
+
+  if (Attributes == NULL && Supported == NULL) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+  //
+  // Set the return value for Supported and Attributes
+  //
+  if (Supported != NULL) {
+    *Supported  = RootBridge->Supports;
+  }
+
+  if (Attributes != NULL) {
+    *Attributes = RootBridge->Attributes;
+  }
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Sets attributes for a resource range on a PCI root bridge.
+
+  The SetAttributes() function sets the attributes specified in Attributes for
+  the PCI root bridge on the resource range specified by ResourceBase and
+  ResourceLength. Since the granularity of setting these attributes may vary
+  from resource type to resource type, and from platform to platform, the
+  actual resource range and the one passed in by the caller may differ. As a
+  result, this function may set the attributes specified by Attributes on a
+  larger resource range than the caller requested. The actual range is returned
+  in ResourceBase and ResourceLength. The caller is responsible for verifying
+  that the actual range for which the attributes were set is acceptable.
+
+  @param This            A pointer to the
+                         EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Attributes      The mask of attributes to set. If the
+                         attribute bit MEMORY_WRITE_COMBINE,
+                         MEMORY_CACHED, or MEMORY_DISABLE is set,
+                         then the resource range is specified by
+                         ResourceBase and ResourceLength. If
+                         MEMORY_WRITE_COMBINE, MEMORY_CACHED, and
+                         MEMORY_DISABLE are not set, then
+                         ResourceBase and ResourceLength are ignored,
+                         and may be NULL.
+  @param ResourceBase    A pointer to the base address of the
+                         resource range to be modified by the
+                         attributes specified by Attributes.
+  @param ResourceLength  A pointer to the length of the resource
+                                   range to be modified by the attributes
+                                   specified by Attributes.
+
+  @retval  EFI_SUCCESS           The current configuration of this PCI root bridge
+                                 was returned in Resources.
+  @retval  EFI_UNSUPPORTED       The current configuration of this PCI root bridge
+                                 could not be retrieved.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoSetAttributes (
+  IN     EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL  *This,
+  IN     UINT64                           Attributes,
+  IN OUT UINT64                           *ResourceBase,
+  IN OUT UINT64                           *ResourceLength
+  )
+{
+  PCI_ROOT_BRIDGE_INSTANCE            *RootBridge;
+
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+
+  if ((Attributes & (~RootBridge->Supports)) != 0) {
+    return EFI_UNSUPPORTED;
+  }
+
+  RootBridge->Attributes = Attributes;
+  return EFI_SUCCESS;
+}
+
+/**
+  Retrieves the current resource settings of this PCI root bridge in the form
+  of a set of ACPI 2.0 resource descriptors.
+
+  There are only two resource descriptor types from the ACPI Specification that
+  may be used to describe the current resources allocated to a PCI root bridge.
+  These are the QWORD Address Space Descriptor (ACPI 2.0 Section 6.4.3.5.1),
+  and the End Tag (ACPI 2.0 Section 6.4.2.8). The QWORD Address Space
+  Descriptor can describe memory, I/O, and bus number ranges for dynamic or
+  fixed resources. The configuration of a PCI root bridge is described with one
+  or more QWORD Address Space Descriptors followed by an End Tag.
+
+  @param[in]   This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[out]  Resources   A pointer to the ACPI 2.0 resource descriptors that
+                           describe the current configuration of this PCI root
+                           bridge. The storage for the ACPI 2.0 resource
+                           descriptors is allocated by this function. The
+                           caller must treat the return buffer as read-only
+                           data, and the buffer must not be freed by the
+                           caller.
+
+  @retval  EFI_SUCCESS     The current configuration of this PCI root bridge
+                           was returned in Resources.
+  @retval  EFI_UNSUPPORTED The current configuration of this PCI root bridge
+                           could not be retrieved.
+**/
+EFI_STATUS
+EFIAPI
+RootBridgeIoConfiguration (
+  IN  EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL     *This,
+  OUT VOID                                **Resources
+  )
+{
+  PCI_RESOURCE_TYPE                 Index;
+  PCI_ROOT_BRIDGE_INSTANCE          *RootBridge;
+  PCI_RES_NODE                      *ResAllocNode;
+  EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Descriptor;
+  EFI_ACPI_END_TAG_DESCRIPTOR       *End;
+
+  //
+  // Get this instance of the Root Bridge.
+  //
+  RootBridge = ROOT_BRIDGE_FROM_THIS (This);
+  ZeroMem (
+    RootBridge->ConfigBuffer,
+    TypeMax * sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) + sizeof (EFI_ACPI_END_TAG_DESCRIPTOR)
+    );
+  Descriptor = RootBridge->ConfigBuffer;
+  for (Index = TypeIo; Index < TypeMax; Index++) {
+
+    ResAllocNode = &RootBridge->ResAllocNode[Index];
+
+    if (ResAllocNode->Status != ResAllocated) {
+      continue;
+    }
+
+    Descriptor->Desc = ACPI_ADDRESS_SPACE_DESCRIPTOR;
+    Descriptor->Len  = sizeof (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR) - 3;
+    Descriptor->AddrRangeMin  = ResAllocNode->Base;
+    Descriptor->AddrRangeMax  = ResAllocNode->Base + ResAllocNode->Length - 1;
+    Descriptor->AddrLen       = ResAllocNode->Length;
+    switch (ResAllocNode->Type) {
+
+    case TypeIo:
+      Descriptor->ResType       = ACPI_ADDRESS_SPACE_TYPE_IO;
+      break;
+
+    case TypePMem32:
+      Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+    case TypeMem32:
+      Descriptor->ResType               = ACPI_ADDRESS_SPACE_TYPE_MEM;
+      Descriptor->AddrSpaceGranularity  = 32;
+      break;
+
+    case TypePMem64:
+      Descriptor->SpecificFlag = EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE;
+    case TypeMem64:
+      Descriptor->ResType               = ACPI_ADDRESS_SPACE_TYPE_MEM;
+      Descriptor->AddrSpaceGranularity  = 64;
+      break;
+
+    case TypeBus:
+      Descriptor->ResType       = ACPI_ADDRESS_SPACE_TYPE_BUS;
+      break;
+
+    default:
+      break;
+    }
+
+    Descriptor++;
+  }
+  //
+  // Terminate the entries.
+  //
+  End = (EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor;
+  End->Desc     = ACPI_END_TAG_DESCRIPTOR;
+  End->Checksum = 0x0;
+
+  *Resources = RootBridge->ConfigBuffer;
+  return EFI_SUCCESS;
+}
diff --git a/MdeModulePkg/MdeModulePkg.dsc b/MdeModulePkg/MdeModulePkg.dsc
index b1f564ff8bb6..53f81f9dbea3 100644
--- a/MdeModulePkg/MdeModulePkg.dsc
+++ b/MdeModulePkg/MdeModulePkg.dsc
@@ -43,6 +43,7 @@
   IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
   PciLib|MdePkg/Library/BasePciLibCf8/BasePciLibCf8.inf
   PciCf8Lib|MdePkg/Library/BasePciCf8Lib/BasePciCf8Lib.inf
+  PciSegmentLib|MdePkg/Library/BasePciSegmentLibPci/BasePciSegmentLibPci.inf
   CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
   PeCoffLib|MdePkg/Library/BasePeCoffLib/BasePeCoffLib.inf
   PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
@@ -207,6 +208,7 @@
   MdeModulePkg/Application/HelloWorld/HelloWorld.inf
   MdeModulePkg/Application/MemoryProfileInfo/MemoryProfileInfo.inf
 
+  MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridgeDxe.inf
   MdeModulePkg/Bus/Pci/PciSioSerialDxe/PciSioSerialDxe.inf
   MdeModulePkg/Bus/Pci/PciBusDxe/PciBusDxe.inf
   MdeModulePkg/Bus/Pci/IncompatiblePciDeviceSupportDxe/IncompatiblePciDeviceSupportDxe.inf

From a786b267c7937ba8988b5d26fbc573d29f55595a Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Tue, 26 Jan 2016 05:49:18 +0000
Subject: [PATCH 410/525] MdeModulePkg/PciHostBridgeDxe: Fix GCC build failure.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19744 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit ccf660168eac4ca250d2a22cb9a4af504e2cef74)
---
 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
index 79b1da2d7e38..6a9294d3495b 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
@@ -17,7 +17,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include "PciRootBridge.h"
 #include "PciHostResource.h"
 
-#define NO_MAPPING  (VOID *) -1
+#define NO_MAPPING  (VOID *) (UINTN) -1
 
 //
 // Lookup table for increment values based on transfer widths

From c4a1c2f32a5121b32db4e77a661cf923ca937add Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 18 Jan 2016 05:48:32 +0000
Subject: [PATCH 411/525] SecurityPkg: Replace TREE macro with TCG2.

Since Tcg2Dxe driver follows TCG spec, we should use
TCG2 MACRO, instead of TREE macro.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19659 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 87361c6a54e52a61e85c3605dc57c924e5ae3870)
---
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index 280a731bd36c..be4db3ec8a14 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -2474,11 +2474,11 @@ DriverEntry (
   }
 
   mTcgDxeData.BsCap.SupportedEventLogs = EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2 | EFI_TCG2_EVENT_LOG_FORMAT_TCG_2;
-  if ((mTcgDxeData.BsCap.ActivePcrBanks & TREE_BOOT_HASH_ALG_SHA1) == 0) {
+  if ((mTcgDxeData.BsCap.ActivePcrBanks & EFI_TCG2_BOOT_HASH_ALG_SHA1) == 0) {
     //
     // No need to expose TCG1.2 event log if SHA1 bank does not exist.
     //
-    mTcgDxeData.BsCap.SupportedEventLogs &= ~TREE_EVENT_LOG_FORMAT_TCG_1_2;
+    mTcgDxeData.BsCap.SupportedEventLogs &= ~EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2;
   }
 
   DEBUG ((EFI_D_INFO, "Tcg2.SupportedEventLogs - 0x%08x\n", mTcgDxeData.BsCap.SupportedEventLogs));

From d9497509447af72bfef65d3e5e9c30e4201cac27 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 18 Jan 2016 05:49:39 +0000
Subject: [PATCH 412/525] SecurityPkg: Correct NumberOfPCRBanks calculation.

Previously, NumberOfPCRBanks is calculated based on TPM
capability. However, there might be a case that TPM hardware
support 1 algorithm, but BIOS does not support and BIOS
mask it via PCD. This causes the conflict between
HashAlgorithmBitmap and NumberOfPCRBanks.
So we move the NumberOfPCRBanks calculation based on
HashAlgorithmBitmap to make sure the data is consistent.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19660 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit a3cad6f86701b951998cc656ac03f8e8dc5f0f98)
---
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index be4db3ec8a14..d34604ed7d80 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -2412,11 +2412,9 @@ DriverEntry (
   if (EFI_ERROR (Status)) {
     DEBUG ((EFI_D_ERROR, "Tpm2GetCapabilityPcrs fail!\n"));
     TpmHashAlgorithmBitmap = EFI_TCG2_BOOT_HASH_ALG_SHA1;
-    NumberOfPCRBanks = 1;
     ActivePCRBanks = EFI_TCG2_BOOT_HASH_ALG_SHA1;
   } else {
     DEBUG ((EFI_D_INFO, "Tpm2GetCapabilityPcrs Count - %08x\n", Pcrs.count));
-    NumberOfPCRBanks = 0;
     TpmHashAlgorithmBitmap = 0;
     ActivePCRBanks = 0;
     for (Index = 0; Index < Pcrs.count; Index++) {
@@ -2424,35 +2422,30 @@ DriverEntry (
       switch (Pcrs.pcrSelections[Index].hash) {
       case TPM_ALG_SHA1:
         TpmHashAlgorithmBitmap |= EFI_TCG2_BOOT_HASH_ALG_SHA1;
-        NumberOfPCRBanks ++;
         if (!IsZeroBuffer (Pcrs.pcrSelections[Index].pcrSelect, Pcrs.pcrSelections[Index].sizeofSelect)) {
           ActivePCRBanks |= EFI_TCG2_BOOT_HASH_ALG_SHA1;
         }        
         break;
       case TPM_ALG_SHA256:
         TpmHashAlgorithmBitmap |= EFI_TCG2_BOOT_HASH_ALG_SHA256;
-        NumberOfPCRBanks ++;
         if (!IsZeroBuffer (Pcrs.pcrSelections[Index].pcrSelect, Pcrs.pcrSelections[Index].sizeofSelect)) {
           ActivePCRBanks |= EFI_TCG2_BOOT_HASH_ALG_SHA256;
         }
         break;
       case TPM_ALG_SHA384:
         TpmHashAlgorithmBitmap |= EFI_TCG2_BOOT_HASH_ALG_SHA384;
-        NumberOfPCRBanks ++;
         if (!IsZeroBuffer (Pcrs.pcrSelections[Index].pcrSelect, Pcrs.pcrSelections[Index].sizeofSelect)) {
           ActivePCRBanks |= EFI_TCG2_BOOT_HASH_ALG_SHA384;
         }
         break;
       case TPM_ALG_SHA512:
         TpmHashAlgorithmBitmap |= EFI_TCG2_BOOT_HASH_ALG_SHA512;
-        NumberOfPCRBanks ++;
         if (!IsZeroBuffer (Pcrs.pcrSelections[Index].pcrSelect, Pcrs.pcrSelections[Index].sizeofSelect)) {
           ActivePCRBanks |= EFI_TCG2_BOOT_HASH_ALG_SHA512;
         }
         break;
       case TPM_ALG_SM3_256:
         TpmHashAlgorithmBitmap |= EFI_TCG2_BOOT_HASH_ALG_SM3_256;
-        NumberOfPCRBanks ++;
         if (!IsZeroBuffer (Pcrs.pcrSelections[Index].pcrSelect, Pcrs.pcrSelections[Index].sizeofSelect)) {
           ActivePCRBanks |= EFI_TCG2_BOOT_HASH_ALG_SM3_256;
         }
@@ -2463,6 +2456,16 @@ DriverEntry (
   mTcgDxeData.BsCap.HashAlgorithmBitmap = TpmHashAlgorithmBitmap & PcdGet32 (PcdTcg2HashAlgorithmBitmap);
   mTcgDxeData.BsCap.ActivePcrBanks = ActivePCRBanks & PcdGet32 (PcdTcg2HashAlgorithmBitmap);
 
+  //
+  // Need calculate NumberOfPCRBanks here, because HashAlgorithmBitmap might be removed by PCD.
+  //
+  NumberOfPCRBanks = 0;
+  for (Index = 0; Index < 32; Index++) {
+    if ((mTcgDxeData.BsCap.HashAlgorithmBitmap & (1u << Index)) != 0) {
+      NumberOfPCRBanks++;
+    }
+  }
+
   if (PcdGet32 (PcdTcg2NumberOfPCRBanks) == 0) {
     mTcgDxeData.BsCap.NumberOfPCRBanks = NumberOfPCRBanks;
   } else {

From beb714bf682016ce725853a8c82805a822de8cf4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 18 Jan 2016 05:51:18 +0000
Subject: [PATCH 413/525] SecurityPkg: Update final event log calculation.

This patch updated final event log calculation based on
TCG EFI PROTOCOL rev9, 7.1.2 "All options implementation".
The previous logic is to save event to final event log
once GetEventLog() is called. 7.1.1 shows that we should
save event log to both normal even log area and final event
log area after GetEventLog() is called.
And there is no need to record TCG12 format log to final
event log area, and normal event log area can be BootServices
memory because OS will not access it directly.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19661 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit fd46e831bc33e9c4fc9b95c58e3032354cc13170)
---
 SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c | 122 ++++++++++++++++++++----------
 1 file changed, 84 insertions(+), 38 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
index d34604ed7d80..d1aa20d66924 100644
--- a/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
+++ b/SecurityPkg/Tcg/Tcg2Dxe/Tcg2Dxe.c
@@ -817,11 +817,10 @@ TcgDxeLogEvent (
     return EFI_INVALID_PARAMETER;
   }
 
-  if (!mTcgDxeData.GetEventLogCalled[Index]) {
-    EventLogAreaStruct = &mTcgDxeData.EventLogAreaStruct[Index];
-  } else {
-    EventLogAreaStruct = &mTcgDxeData.FinalEventLogAreaStruct[Index];
-  }
+  //
+  // Record to normal event log
+  //
+  EventLogAreaStruct = &mTcgDxeData.EventLogAreaStruct[Index];
 
   if (EventLogAreaStruct->EventLogTruncated) {
     return EFI_VOLUME_FULL;
@@ -838,15 +837,50 @@ TcgDxeLogEvent (
              NewEventSize
              );
   
-  if (Status == EFI_DEVICE_ERROR) {
-    return EFI_DEVICE_ERROR;
-  } else if (Status == EFI_OUT_OF_RESOURCES) {
+  if (Status == EFI_OUT_OF_RESOURCES) {
     EventLogAreaStruct->EventLogTruncated = TRUE;
     return EFI_VOLUME_FULL;
   } else if (Status == EFI_SUCCESS) {
     EventLogAreaStruct->EventLogStarted = TRUE;
-    if (mTcgDxeData.GetEventLogCalled[Index]) {
+  }
+
+  //
+  // If GetEventLog is called, record to FinalEventsTable, too.
+  //
+  if (mTcgDxeData.GetEventLogCalled[Index]) {
+    if (mTcgDxeData.FinalEventsTable[Index] == NULL) {
+      //
+      // no need for FinalEventsTable
+      //
+      return EFI_SUCCESS;
+    }
+    EventLogAreaStruct = &mTcgDxeData.FinalEventLogAreaStruct[Index];
+
+    if (EventLogAreaStruct->EventLogTruncated) {
+      return EFI_VOLUME_FULL;
+    }
+
+    EventLogAreaStruct->LastEvent = (UINT8*)(UINTN)EventLogAreaStruct->Lasa;
+    Status = TcgCommLogEvent (
+               &EventLogAreaStruct->LastEvent,
+               &EventLogAreaStruct->EventLogSize,
+               (UINTN)EventLogAreaStruct->Laml,
+               NewEventHdr,
+               NewEventHdrSize,
+               NewEventData,
+               NewEventSize
+               );
+    if (Status == EFI_OUT_OF_RESOURCES) {
+      EventLogAreaStruct->EventLogTruncated = TRUE;
+      return EFI_VOLUME_FULL;
+    } else if (Status == EFI_SUCCESS) {
+      EventLogAreaStruct->EventLogStarted = TRUE;
+      //
+      // Increase the NumberOfEvents in FinalEventsTable
+      //
       (mTcgDxeData.FinalEventsTable[Index])->NumberOfEvents ++;
+      DEBUG ((EFI_D_INFO, "FinalEventsTable->NumberOfEvents - 0x%x\n", (mTcgDxeData.FinalEventsTable[Index])->NumberOfEvents));
+      DEBUG ((EFI_D_INFO, "  Size - 0x%x\n", (UINTN)EventLogAreaStruct->LastEvent - (UINTN)mTcgDxeData.FinalEventsTable[Index]));
     }
   }
 
@@ -1466,7 +1500,7 @@ SetupEventLog (
       Lasa = (EFI_PHYSICAL_ADDRESS) (SIZE_4GB - 1);
       Status = gBS->AllocatePages (
                       AllocateMaxAddress,
-                      EfiACPIMemoryNVS,
+                      EfiBootServicesData,
                       EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcgLogAreaMinLen)),
                       &Lasa
                       );
@@ -1564,41 +1598,53 @@ SetupEventLog (
   //
   for (Index = 0; Index < sizeof(mTcg2EventInfo)/sizeof(mTcg2EventInfo[0]); Index++) {
     if ((mTcgDxeData.BsCap.SupportedEventLogs & mTcg2EventInfo[Index].LogFormat) != 0) {
-      Lasa = (EFI_PHYSICAL_ADDRESS) (SIZE_4GB - 1);
-      Status = gBS->AllocatePages (
-                      AllocateMaxAddress,
-                      EfiACPIMemoryNVS,
-                      EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcg2FinalLogAreaLen)),
-                      &Lasa
-                      );
-      if (EFI_ERROR (Status)) {
-        return Status;
-      }
-      SetMem ((VOID *)(UINTN)Lasa, PcdGet32 (PcdTcg2FinalLogAreaLen), 0xFF);
+      if (mTcg2EventInfo[Index].LogFormat == EFI_TCG2_EVENT_LOG_FORMAT_TCG_2) {
+        Lasa = (EFI_PHYSICAL_ADDRESS) (SIZE_4GB - 1);
+        Status = gBS->AllocatePages (
+                        AllocateMaxAddress,
+                        EfiACPIMemoryNVS,
+                        EFI_SIZE_TO_PAGES (PcdGet32 (PcdTcg2FinalLogAreaLen)),
+                        &Lasa
+                        );
+        if (EFI_ERROR (Status)) {
+          return Status;
+        }
+        SetMem ((VOID *)(UINTN)Lasa, PcdGet32 (PcdTcg2FinalLogAreaLen), 0xFF);
 
-      //
-      // Initialize
-      //
-      mTcgDxeData.FinalEventsTable[Index] = (VOID *)(UINTN)Lasa;
-      (mTcgDxeData.FinalEventsTable[Index])->Version = EFI_TCG2_FINAL_EVENTS_TABLE_VERSION;
-      (mTcgDxeData.FinalEventsTable[Index])->NumberOfEvents = 0;
-
-      mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogFormat = mTcg2EventInfo[Index].LogFormat;
-      mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa = Lasa + sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
-      mTcgDxeData.FinalEventLogAreaStruct[Index].Laml = PcdGet32 (PcdTcg2FinalLogAreaLen) - sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
-      mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogSize = 0;
-      mTcgDxeData.FinalEventLogAreaStruct[Index].LastEvent = (VOID *)(UINTN)mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa;
-      mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogStarted = FALSE;
-      mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogTruncated = FALSE;
+        //
+        // Initialize
+        //
+        mTcgDxeData.FinalEventsTable[Index] = (VOID *)(UINTN)Lasa;
+        (mTcgDxeData.FinalEventsTable[Index])->Version = EFI_TCG2_FINAL_EVENTS_TABLE_VERSION;
+        (mTcgDxeData.FinalEventsTable[Index])->NumberOfEvents = 0;
+
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogFormat = mTcg2EventInfo[Index].LogFormat;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa = Lasa + sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
+        mTcgDxeData.FinalEventLogAreaStruct[Index].Laml = PcdGet32 (PcdTcg2FinalLogAreaLen) - sizeof(EFI_TCG2_FINAL_EVENTS_TABLE);
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogSize = 0;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].LastEvent = (VOID *)(UINTN)mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogStarted = FALSE;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogTruncated = FALSE;
 
-      if (mTcg2EventInfo[Index].LogFormat == EFI_TCG2_EVENT_LOG_FORMAT_TCG_2) {
         //
-        // Install to configuration table
+        // Install to configuration table for EFI_TCG2_EVENT_LOG_FORMAT_TCG_2 
         //
-        Status = gBS->InstallConfigurationTable (&gEfiTcg2FinalEventsTableGuid, (VOID *)mTcgDxeData.FinalEventsTable[1]);
+        Status = gBS->InstallConfigurationTable (&gEfiTcg2FinalEventsTableGuid, (VOID *)mTcgDxeData.FinalEventsTable[Index]);
         if (EFI_ERROR (Status)) {
           return Status;
         }
+      } else {
+        //
+        // No need to handle EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2
+        //
+        mTcgDxeData.FinalEventsTable[Index] = NULL;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogFormat = mTcg2EventInfo[Index].LogFormat;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].Lasa = 0;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].Laml = 0;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogSize = 0;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].LastEvent = 0;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogStarted = FALSE;
+        mTcgDxeData.FinalEventLogAreaStruct[Index].EventLogTruncated = FALSE;
       }
     }
   }

From e01cc35b83918086ca184e2ee338d484f0fd6933 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 19 Jan 2016 13:17:10 +0000
Subject: [PATCH 414/525] MdePkg: Update MorLock comment to latest doc.

Microsoft updated secure MOR lock document with version 2.
So we update comment here.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19687 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 31a9d3b419accbbc5463c71221b3b30a46f9ee73)
---
 .../MemoryOverwriteRequestControlLock.h          | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/MdePkg/Include/IndustryStandard/MemoryOverwriteRequestControlLock.h b/MdePkg/Include/IndustryStandard/MemoryOverwriteRequestControlLock.h
index 771306b88298..8a3473139673 100644
--- a/MdePkg/Include/IndustryStandard/MemoryOverwriteRequestControlLock.h
+++ b/MdePkg/Include/IndustryStandard/MemoryOverwriteRequestControlLock.h
@@ -3,7 +3,7 @@
   Microsoft Secure MOR implementation.
   https://msdn.microsoft.com/en-us/library/windows/hardware/mt270973(v=vs.85).aspx
 
-  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -28,14 +28,14 @@
 // VendorGuid: {BB983CCF-151D-40E1-A07B-4A17BE168292}
 // Name:       MemoryOverwriteRequestControlLock
 // Attributes: NV+BS+RT
-// Size:       0x1 byte
+// GetVariable value in Data parameter: 0x0 (unlocked); 0x1 (locked without key); 0x2 (locked with key)
+// SetVariable value in Data parameter: 0x0 (unlocked); 0x1 (locked);
+//                                      Revision 2 additionally accepts an 8-byte value that represents a shared secret key.
 //
-// The BIOS initializes MemoryOverwriteRequestControlLock to a value of 0x00
-// before BDS (BOOT#### processing). When the OS loader calls SetVariable by
-// specifying 0x01, the access mode for both MemoryOverwriteRequestControlLock
-// and MemoryOverwriteRequestControl is changed to read-only. If any other
-// value is specified in the SetVariable call, it fails with the 
-// EFI_INVALID_PARAMETER error code.
+
+//
+// Note: Setting MemoryOverwriteRequestControlLock does not commit to flash (just changes the internal lock state).
+// Getting the variable returns the internal state and never exposes the key.
 //
 
 extern EFI_GUID gEfiMemoryOverwriteRequestControlLockGuid;

From cf7a5d2fcd3241c6b6a70debd78c1480719aff43 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 19 Jan 2016 13:20:50 +0000
Subject: [PATCH 415/525] MdeModulePkg: Add MorLockSmm to variable driver.

Microsoft published secure MOR implementation at https://msdn.microsoft.com/en-us/library/windows/hardware/mt270973(v=vs.85).aspx
with revision 2 update. See URL for tech detail.
Previous revision 1 is handled in SecurityPkg\Tcg\ MemoryOverwriteRequestControlLock.
But the VarCheck API can not satisfy revision 2 requirement.
So we decide include MOR lock control into variable driver directly.

This patch add standalone TcgMorLockSmm implementation.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19688 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit abad83e6c2533b1e4b71b51763a0526fadc794c5)
---
 .../Variable/RuntimeDxe/TcgMorLockSmm.c       | 394 ++++++++++++++++++
 1 file changed, 394 insertions(+)
 create mode 100644 MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockSmm.c

diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockSmm.c b/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockSmm.c
new file mode 100644
index 000000000000..461b0fc88597
--- /dev/null
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockSmm.c
@@ -0,0 +1,394 @@
+/** @file
+  TCG MOR (Memory Overwrite Request) Lock Control support (SMM version).
+
+  This module initilizes MemoryOverwriteRequestControlLock variable.
+  This module adds Variable Hook and check MemoryOverwriteRequestControlLock.
+
+Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiDxe.h>
+#include <Guid/MemoryOverwriteControl.h>
+#include <IndustryStandard/MemoryOverwriteRequestControlLock.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include "Variable.h"
+
+typedef struct {
+  CHAR16                                 *VariableName;
+  EFI_GUID                               *VendorGuid;
+} VARIABLE_TYPE;
+
+VARIABLE_TYPE  mMorVariableType[] = {
+  {MEMORY_OVERWRITE_REQUEST_VARIABLE_NAME,      &gEfiMemoryOverwriteControlDataGuid},
+  {MEMORY_OVERWRITE_REQUEST_CONTROL_LOCK_NAME,  &gEfiMemoryOverwriteRequestControlLockGuid},
+};
+
+#define MOR_LOCK_DATA_UNLOCKED           0x0
+#define MOR_LOCK_DATA_LOCKED_WITHOUT_KEY 0x1
+#define MOR_LOCK_DATA_LOCKED_WITH_KEY    0x2
+
+#define MOR_LOCK_V1_SIZE      1
+#define MOR_LOCK_V2_KEY_SIZE  8
+
+typedef enum {
+  MorLockStateUnlocked = 0,
+  MorLockStateLocked = 1,
+} MOR_LOCK_STATE;
+
+UINT8           mMorLockKey[MOR_LOCK_V2_KEY_SIZE];
+BOOLEAN         mMorLockKeyEmpty = TRUE;
+BOOLEAN         mMorLockPassThru = FALSE;
+MOR_LOCK_STATE  mMorLockState = MorLockStateUnlocked;
+
+/**
+  Returns if this is MOR related variable.
+
+  @param  VariableName the name of the vendor's variable, it's a Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+
+  @retval  TRUE            The variable is MOR related.
+  @retval  FALSE           The variable is NOT MOR related.
+**/
+BOOLEAN
+IsAnyMorVariable (
+  IN CHAR16                                 *VariableName,
+  IN EFI_GUID                               *VendorGuid
+  )
+{
+  UINTN   Index;
+
+  for (Index = 0; Index < sizeof(mMorVariableType)/sizeof(mMorVariableType[0]); Index++) {
+    if ((StrCmp (VariableName, mMorVariableType[Index].VariableName) == 0) &&
+        (CompareGuid (VendorGuid, mMorVariableType[Index].VendorGuid))) {
+      return TRUE;
+    }
+  }
+  return FALSE;
+}
+
+/**
+  Returns if this is MOR lock variable.
+
+  @param  VariableName the name of the vendor's variable, it's a Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+
+  @retval  TRUE            The variable is MOR lock variable.
+  @retval  FALSE           The variable is NOT MOR lock variable.
+**/
+BOOLEAN
+IsMorLockVariable (
+  IN CHAR16                                 *VariableName,
+  IN EFI_GUID                               *VendorGuid
+  )
+{
+  if ((StrCmp (VariableName, MEMORY_OVERWRITE_REQUEST_CONTROL_LOCK_NAME) == 0) &&
+      (CompareGuid (VendorGuid, &gEfiMemoryOverwriteRequestControlLockGuid))) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Set MOR lock variable.
+
+  @param  Data         MOR Lock variable data.
+
+  @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 was supplied, or the
+                                  DataSize exceeds the maximum allowed.
+  @retval  EFI_INVALID_PARAMETER  VariableName is an empty Unicode 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 saved due to a hardware failure.
+  @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_AUTHENTICATED_WRITE_ACCESS
+                                  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.
+**/
+EFI_STATUS
+SetMorLockVariable (
+  IN UINT8  Data
+  )
+{
+  EFI_STATUS  Status;
+
+  mMorLockPassThru = TRUE;
+  Status = VariableServiceSetVariable (
+             MEMORY_OVERWRITE_REQUEST_CONTROL_LOCK_NAME,
+             &gEfiMemoryOverwriteRequestControlLockGuid,
+             EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+             sizeof(Data),
+             &Data
+             );
+  mMorLockPassThru = FALSE;
+  return Status;
+}
+
+/**
+  This service is an MorLock checker handler for the SetVariable().
+
+  @param  VariableName the name of the vendor's variable, as a
+                       Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+  @param  Attributes   Point to memory location to return the attributes of variable. If the point
+                       is NULL, the parameter would be ignored.
+  @param  DataSize     The size in bytes of Data-Buffer.
+  @param  Data         Point to the content of the variable.
+
+  @retval  EFI_SUCCESS            The MorLock check pass, and Variable driver can store the variable data.
+  @retval  EFI_INVALID_PARAMETER  The MorLock data or data size or attributes is not allowed.
+  @retval  EFI_ACCESS_DENIED      The MorLock is locked.
+  @retval  EFI_WRITE_PROTECTED    The MorLock deletion is not allowed.
+  @retval  EFI_ALREADY_STARTED    The MorLock variable is handled inside this function.
+                                  Variable driver can just return EFI_SUCCESS.
+**/
+EFI_STATUS
+SetVariableCheckHandlerMorLock (
+  IN CHAR16     *VariableName,
+  IN EFI_GUID   *VendorGuid,
+  IN UINT32     Attributes,
+  IN UINTN      DataSize,
+  IN VOID       *Data
+  )
+{
+  EFI_STATUS  Status;
+
+  //
+  // Basic Check
+  //
+  if (Attributes == 0 || DataSize == 0 || Data == NULL) {
+    return EFI_WRITE_PROTECTED;
+  }
+
+  if ((Attributes != (EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS)) ||
+      ((DataSize != MOR_LOCK_V1_SIZE) && (DataSize != MOR_LOCK_V2_KEY_SIZE))) {
+    return EFI_INVALID_PARAMETER;
+  }
+
+  //
+  // Do not check if the request is passthru.
+  //
+  if (mMorLockPassThru) {
+    return EFI_SUCCESS;
+  }
+
+  if (mMorLockState == MorLockStateUnlocked) {
+    //
+    // In Unlocked State
+    //
+    if (DataSize == MOR_LOCK_V1_SIZE) {
+      //
+      // V1 - lock permenantly
+      //
+      if (*(UINT8 *)Data == MOR_LOCK_DATA_UNLOCKED) {
+        //
+        // Unlock
+        //
+        Status = SetMorLockVariable (MOR_LOCK_DATA_UNLOCKED);
+        if (!EFI_ERROR (Status)) {
+          //
+          // return EFI_ALREADY_STARTED to skip variable set.
+          //
+          return EFI_ALREADY_STARTED;
+        } else {
+          //
+          // SetVar fail
+          //
+          return Status;
+        }
+      } else if (*(UINT8 *)Data == MOR_LOCK_DATA_LOCKED_WITHOUT_KEY) {
+        //
+        // Lock without key
+        //
+        Status = SetMorLockVariable (MOR_LOCK_DATA_LOCKED_WITHOUT_KEY);
+        if (!EFI_ERROR (Status)) {
+          //
+          // Lock success
+          //
+          mMorLockState = MorLockStateLocked;
+          //
+          // return EFI_ALREADY_STARTED to skip variable set.
+          //
+          return EFI_ALREADY_STARTED;
+        } else {
+          //
+          // SetVar fail
+          //
+          return Status;
+        }
+      } else {
+        return EFI_INVALID_PARAMETER;
+      }
+    } else if (DataSize == MOR_LOCK_V2_KEY_SIZE) {
+      //
+      // V2 lock and provision the key
+      //
+
+      //
+      // Need set here because the data value on flash is different
+      //
+      Status = SetMorLockVariable (MOR_LOCK_DATA_LOCKED_WITH_KEY);
+      if (EFI_ERROR(Status)) {
+        //
+        // SetVar fail, do not provision the key
+        //
+        return Status;
+      } else {
+        //
+        // Lock success, provision the key
+        //
+        mMorLockKeyEmpty = FALSE;
+        CopyMem (mMorLockKey, Data, MOR_LOCK_V2_KEY_SIZE);
+        mMorLockState = MorLockStateLocked;
+        //
+        // return EFI_ALREADY_STARTED to skip variable set.
+        //
+        return EFI_ALREADY_STARTED;
+      }
+    } else {
+      ASSERT (FALSE);
+      return EFI_OUT_OF_RESOURCES;
+    }
+  } else {
+    //
+    // In Locked State
+    //
+    if (mMorLockKeyEmpty || (DataSize != MOR_LOCK_V2_KEY_SIZE)) {
+      return EFI_ACCESS_DENIED;
+    }
+    if ((CompareMem (Data, mMorLockKey, MOR_LOCK_V2_KEY_SIZE) == 0)) {
+      //
+      // Key match - unlock
+      //
+
+      //
+      // Need set here because the data value on flash is different
+      //
+      Status = SetMorLockVariable (MOR_LOCK_DATA_UNLOCKED);
+      if (EFI_ERROR (Status)) {
+        //
+        // SetVar fail
+        //
+        return Status;
+      } else {
+        //
+        // Unlock Success
+        //
+        mMorLockState = MorLockStateUnlocked;
+        mMorLockKeyEmpty = TRUE;
+        ZeroMem (mMorLockKey, sizeof(mMorLockKey));
+        //
+        // return EFI_ALREADY_STARTED to skip variable set.
+        //
+        return EFI_ALREADY_STARTED;
+      }
+    } else {
+      //
+      // Key mismatch - Prevent Dictionary Attack
+      //
+      mMorLockState = MorLockStateLocked;
+      mMorLockKeyEmpty = TRUE;
+      ZeroMem (mMorLockKey, sizeof(mMorLockKey));
+      return EFI_ACCESS_DENIED;
+    }
+  }
+}
+
+/**
+  This service is an MOR/MorLock checker handler for the SetVariable().
+
+  @param  VariableName the name of the vendor's variable, as a
+                       Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+  @param  Attributes   Point to memory location to return the attributes of variable. If the point
+                       is NULL, the parameter would be ignored.
+  @param  DataSize     The size in bytes of Data-Buffer.
+  @param  Data         Point to the content of the variable.
+
+  @retval  EFI_SUCCESS            The MOR/MorLock check pass, and Variable driver can store the variable data.
+  @retval  EFI_INVALID_PARAMETER  The MOR/MorLock data or data size or attributes is not allowed for MOR variable.
+  @retval  EFI_ACCESS_DENIED      The MOR/MorLock is locked.
+  @retval  EFI_ALREADY_STARTED    The MorLock variable is handled inside this function.
+                                  Variable driver can just return EFI_SUCCESS.
+**/
+EFI_STATUS
+SetVariableCheckHandlerMor (
+  IN CHAR16     *VariableName,
+  IN EFI_GUID   *VendorGuid,
+  IN UINT32     Attributes,
+  IN UINTN      DataSize,
+  IN VOID       *Data
+  )
+{
+  //
+  // do not handle non-MOR variable
+  //
+  if (!IsAnyMorVariable (VariableName, VendorGuid)) {
+    return EFI_SUCCESS;
+  }
+
+  //
+  // MorLock variable
+  //
+  if (IsMorLockVariable (VariableName, VendorGuid)) {
+    return SetVariableCheckHandlerMorLock (
+             VariableName,
+             VendorGuid,
+             Attributes,
+             DataSize,
+             Data
+             );
+  }
+
+  //
+  // Mor Variable
+  //
+
+  //
+  // Basic Check
+  //
+  if ((Attributes != (EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS)) ||
+      (DataSize != sizeof(UINT8)) ||
+      (Data == NULL)) {
+    return EFI_INVALID_PARAMETER;
+  }
+  if (mMorLockState == MorLockStateLocked) {
+    //
+    // If lock, deny access
+    //
+    return EFI_ACCESS_DENIED;
+  }
+  //
+  // grant access
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialization for MOR Lock Control.
+
+  @retval EFI_SUCEESS     MorLock initialization success.
+  @return Others          Some error occurs.
+**/
+EFI_STATUS
+MorLockInit (
+  VOID
+  )
+{
+  //
+  // Set variable to report capability to OS
+  //
+  return SetMorLockVariable (0);
+}

From b47b351f64311af37520e7c389e8b3bdccca8c41 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 19 Jan 2016 13:21:18 +0000
Subject: [PATCH 416/525] MdeModulePkg: Add MorLockDxe to variable driver.

Per secure MOR implementation document, it is not proper to add MOR lock in non-SMM version, because DXE version can not provide protection.

This patch add standalone TcgMorLockDxe implementation.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19689 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit a0994dbe3c66cc54c93623a4c1d011327a2197ce)
---
 .../Variable/RuntimeDxe/TcgMorLockDxe.c       | 89 +++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockDxe.c

diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockDxe.c b/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockDxe.c
new file mode 100644
index 000000000000..c32eb3b1ac4b
--- /dev/null
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/TcgMorLockDxe.c
@@ -0,0 +1,89 @@
+/** @file
+  TCG MOR (Memory Overwrite Request) Lock Control support (DXE version).
+
+  This module clears MemoryOverwriteRequestControlLock variable to indicate
+  MOR lock control unsupported.
+
+Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiDxe.h>
+#include <Guid/MemoryOverwriteControl.h>
+#include <IndustryStandard/MemoryOverwriteRequestControlLock.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include "Variable.h"
+
+extern EDKII_VARIABLE_LOCK_PROTOCOL     mVariableLock;
+
+/**
+  This service is an MOR/MorLock checker handler for the SetVariable().
+
+  @param  VariableName the name of the vendor's variable, as a
+                       Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+  @param  Attributes   Point to memory location to return the attributes of variable. If the point
+                       is NULL, the parameter would be ignored.
+  @param  DataSize     The size in bytes of Data-Buffer.
+  @param  Data         Point to the content of the variable.
+
+  @retval  EFI_SUCCESS            The MOR/MorLock check pass, and Variable driver can store the variable data.
+  @retval  EFI_INVALID_PARAMETER  The MOR/MorLock data or data size or attributes is not allowed for MOR variable.
+  @retval  EFI_ACCESS_DENIED      The MOR/MorLock is locked.
+  @retval  EFI_ALREADY_STARTED    The MorLock variable is handled inside this function.
+                                  Variable driver can just return EFI_SUCCESS.
+**/
+EFI_STATUS
+SetVariableCheckHandlerMor (
+  IN CHAR16     *VariableName,
+  IN EFI_GUID   *VendorGuid,
+  IN UINT32     Attributes,
+  IN UINTN      DataSize,
+  IN VOID       *Data
+  )
+{
+  //
+  // Just let it pass. No need provide protection for DXE version.
+  //
+  return EFI_SUCCESS;
+}
+
+/**
+  Initialization for MOR Lock Control.
+
+  @retval EFI_SUCEESS     MorLock initialization success.
+  @return Others          Some error occurs.
+**/
+EFI_STATUS
+MorLockInit (
+  VOID
+  )
+{
+  //
+  // Always clear variable to report unsupported to OS.
+  // The reason is that the DXE version is not proper to provide *protection*.
+  // BIOS should use SMM version variable driver to provide such capability.
+  //
+  VariableServiceSetVariable (
+    MEMORY_OVERWRITE_REQUEST_CONTROL_LOCK_NAME,
+    &gEfiMemoryOverwriteRequestControlLockGuid,
+    EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS,
+    0,
+    NULL
+    );
+
+  //
+  // Need set this variable to be read-only to prevent other module set it.
+  //
+  VariableLockRequestToLock (&mVariableLock, MEMORY_OVERWRITE_REQUEST_CONTROL_LOCK_NAME, &gEfiMemoryOverwriteRequestControlLockGuid);
+  return EFI_SUCCESS;
+}

From cb9eb5e1f080a4a7f90de64f8638ef5060434c58 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 19 Jan 2016 13:22:05 +0000
Subject: [PATCH 417/525] MdeModulePkg: Add MorLock to variable driver.

This patch adds MorLock function to Variable main function.
It also updates corresponding INF file to pass build.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19690 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 2f6aa774fe38cf1dad5376e59cb2812989ef14c7)
---
 .../Universal/Variable/RuntimeDxe/Variable.c  | 60 ++++++++++++++++++-
 .../RuntimeDxe/VariableRuntimeDxe.inf         |  6 +-
 .../Variable/RuntimeDxe/VariableSmm.inf       |  6 +-
 3 files changed, 69 insertions(+), 3 deletions(-)

diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/Variable.c b/MdeModulePkg/Universal/Variable/RuntimeDxe/Variable.c
index 31e1937c2f19..43360ee6cd7f 100644
--- a/MdeModulePkg/Universal/Variable/RuntimeDxe/Variable.c
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/Variable.c
@@ -16,7 +16,7 @@
   VariableServiceSetVariable() should also check authenticate data to avoid buffer overflow,
   integer overflow. It should also check attribute to avoid authentication bypass.
 
-Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -105,6 +105,43 @@ SecureBootHook (
   IN EFI_GUID                               *VendorGuid
   );
 
+/**
+  Initialization for MOR Lock Control.
+
+  @retval EFI_SUCEESS     MorLock initialization success.
+  @return Others          Some error occurs.
+**/
+EFI_STATUS
+MorLockInit (
+  VOID
+  );
+
+/**
+  This service is an MOR/MorLock checker handler for the SetVariable().
+
+  @param  VariableName the name of the vendor's variable, as a
+                       Null-Terminated Unicode String
+  @param  VendorGuid   Unify identifier for vendor.
+  @param  Attributes   Point to memory location to return the attributes of variable. If the point
+                       is NULL, the parameter would be ignored.
+  @param  DataSize     The size in bytes of Data-Buffer.
+  @param  Data         Point to the content of the variable.
+
+  @retval  EFI_SUCCESS            The MOR/MorLock check pass, and Variable driver can store the variable data.
+  @retval  EFI_INVALID_PARAMETER  The MOR/MorLock data or data size or attributes is not allowed for MOR variable.
+  @retval  EFI_ACCESS_DENIED      The MOR/MorLock is locked.
+  @retval  EFI_ALREADY_STARTED    The MorLock variable is handled inside this function.
+                                  Variable driver can just return EFI_SUCCESS.
+**/
+EFI_STATUS
+SetVariableCheckHandlerMor (
+  IN CHAR16     *VariableName,
+  IN EFI_GUID   *VendorGuid,
+  IN UINT32     Attributes,
+  IN UINTN      DataSize,
+  IN VOID       *Data
+  );
+
 /**
   Routine used to track statistical information about variable usage.
   The data is stored in the EFI system table so it can be accessed later.
@@ -3181,6 +3218,21 @@ VariableServiceSetVariable (
     }
   }
 
+  //
+  // Special Handling for MOR Lock variable.
+  //
+  Status = SetVariableCheckHandlerMor (VariableName, VendorGuid, Attributes, PayloadSize, (VOID *) ((UINTN) Data + DataSize - PayloadSize));
+  if (Status == EFI_ALREADY_STARTED) {
+    //
+    // EFI_ALREADY_STARTED means the SetVariable() action is handled inside of SetVariableCheckHandlerMor().
+    // Variable driver can just return SUCCESS.
+    //
+    return EFI_SUCCESS;
+  }
+  if (EFI_ERROR (Status)) {
+    return Status;
+  }
+
   Status = VarCheckLibSetVariableCheck (VariableName, VendorGuid, Attributes, PayloadSize, (VOID *) ((UINTN) Data + DataSize - PayloadSize), mRequestSource);
   if (EFI_ERROR (Status)) {
     return Status;
@@ -3946,6 +3998,12 @@ VariableWriteServiceInitialize (
   }
 
   ReleaseLockOnlyAtBootTime (&mVariableModuleGlobal->VariableGlobal.VariableServicesLock);
+
+  //
+  // Initialize MOR Lock variable.
+  //
+  MorLockInit ();
+
   return Status;
 }
 
diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
index 62c1568a50e0..5e7b5c534160 100644
--- a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableRuntimeDxe.inf
@@ -9,7 +9,7 @@
 #  This external input must be validated carefully to avoid security issues such as
 #  buffer overflow or integer overflow.
 #
-# Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -42,6 +42,7 @@
   VariableDxe.c
   Variable.h
   Measurement.c
+  TcgMorLockDxe.c
   VarCheck.c
   VariableExLib.c
 
@@ -95,6 +96,9 @@
   ## SOMETIMES_PRODUCES   ## Variable:L"Lang"
   gEfiGlobalVariableGuid
 
+  gEfiMemoryOverwriteControlDataGuid            ## CONSUMES   ## Variable:L"MemoryOverwriteRequestControl"
+  gEfiMemoryOverwriteRequestControlLockGuid     ## PRODUCES   ## Variable:L"MemoryOverwriteRequestControlLock"
+
   gEfiEventVirtualAddressChangeGuid             ## CONSUMES             ## Event
   gEfiSystemNvDataFvGuid                        ## CONSUMES             ## GUID
   gEfiEndOfDxeEventGroupGuid                    ## CONSUMES             ## Event
diff --git a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableSmm.inf b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableSmm.inf
index efcd3179d79c..02f01064f39c 100644
--- a/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableSmm.inf
+++ b/MdeModulePkg/Universal/Variable/RuntimeDxe/VariableSmm.inf
@@ -18,7 +18,7 @@
 #  may not be modified without authorization. If platform fails to protect these resources,
 #  the authentication service provided in this driver will be broken, and the behavior is undefined.
 #
-# Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -52,6 +52,7 @@
   VarCheck.c
   Variable.h
   VariableExLib.c
+  TcgMorLockSmm.c
 
 [Packages]
   MdePkg/MdePkg.dec
@@ -103,6 +104,9 @@
   ## SOMETIMES_PRODUCES   ## Variable:L"Lang"
   gEfiGlobalVariableGuid
 
+  gEfiMemoryOverwriteControlDataGuid            ## CONSUMES   ## Variable:L"MemoryOverwriteRequestControl"
+  gEfiMemoryOverwriteRequestControlLockGuid     ## PRODUCES   ## Variable:L"MemoryOverwriteRequestControlLock"
+
   gSmmVariableWriteGuid                         ## PRODUCES             ## GUID # Install protocol
   gEfiSystemNvDataFvGuid                        ## CONSUMES             ## GUID
   gEdkiiFaultTolerantWriteGuid                  ## SOMETIMES_CONSUMES   ## HOB

From 533f9a84141a486f2a5cdff83eba7e00fa2e8c88 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 19 Jan 2016 13:23:30 +0000
Subject: [PATCH 418/525] SecurityPkg: Mark MorLock module deprecated.

This module only handles MOR lock v1.
Now MOR lock V2 solution is published and added in variable driver. So this module can be deprecated.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>
Reviewed-by: "Zeng, Star" <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19691 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit c3bcc1083ef0d7d3eb48620b5381d59276e167ad)
---
 .../Tcg/MemoryOverwriteRequestControlLock/TcgMorLockSmm.inf  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLockSmm.inf b/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLockSmm.inf
index bde03bb12c8a..61fd1b7e1dfb 100644
--- a/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLockSmm.inf
+++ b/SecurityPkg/Tcg/MemoryOverwriteRequestControlLock/TcgMorLockSmm.inf
@@ -3,7 +3,10 @@
 #
 #  This module will add Variable Hook and allow MemoryOverwriteRequestControlLock variable set only once.
 #
-# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+#  NOTE: This module only handles secure MOR V1 and is deprecated.
+#  The secure MOR V2 is handled inside of variable driver.
+#
+# Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at

From 0246cee85adaa62413bd784eb07c4e59760b7d1a Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Fri, 22 Jan 2016 06:30:08 +0000
Subject: [PATCH 419/525] SecurityPkg: Update TCG PPI "1.3" for TCG2.

The Tcg2Smm follows TCG PPI 1.3 specification.
This patch updates the ASL code string to 1.3.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19733 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 0179180d6dbacc1bed53c3b6a886693790f75365)
---
 SecurityPkg/Tcg/Tcg2Smm/Tpm.asl | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl b/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
index 80dfb3bd4e58..2abd4af9ef61 100644
--- a/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
+++ b/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
@@ -2,7 +2,7 @@
   The TPM2 definition block in ACPI table for TCG2 physical presence  
   and MemoryClear.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -187,7 +187,7 @@ DefinitionBlock (
             //
             // a) Get Physical Presence Interface Version
             //
-            Return ("1.2")
+            Return ("1.3")
           }
           Case (2)
           {

From 25c18d5a964b2419748fe56c7f51f337be467cb8 Mon Sep 17 00:00:00 2001
From: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Date: Fri, 8 Jan 2016 01:36:45 +0000
Subject: [PATCH 420/525] SecurityPkg : Tpm2DeviceLibDTpm :  Rename
 TisTpmCommand to avoid name collision

Change TisTpmCommand to Tpm2TisTpmCommand. Makes function name more clear.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Samer El-Haj-Mahmoud <samer.el-haj-mahmoud@hpe.com>
Reviewed-by: Chao Zhang <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19622 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit c2967d35d84fce6caf6691d2d892d20e8c273601)
---
 SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
index a1862796a537..4eab72f811fe 100644
--- a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
@@ -2,6 +2,7 @@
   TIS (TPM Interface Specification) functions used by dTPM2.0 library.
   
 Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+(C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -369,7 +370,7 @@ TisPcRequestUseTpm (
 
 **/
 EFI_STATUS
-TisTpmCommand (
+Tpm2TisTpmCommand (
   IN     TIS_PC_REGISTERS_PTR       TisReg,
   IN     UINT8                      *BufferIn,
   IN     UINT32                     SizeIn,
@@ -477,7 +478,7 @@ TisTpmCommand (
     }
   }
   DEBUG_CODE (
-    DEBUG ((EFI_D_INFO, "TisTpmCommand ReceiveHeader - "));
+    DEBUG ((EFI_D_INFO, "Tpm2TisTpmCommand ReceiveHeader - "));
     for (Index = 0; Index < sizeof (TPM2_RESPONSE_HEADER); Index++) {
       DEBUG ((EFI_D_INFO, "%02x ", BufferOut[Index]));
     }
@@ -552,7 +553,7 @@ DTpm2SubmitCommand (
   IN UINT8             *OutputParameterBlock
   )
 {
-  return TisTpmCommand (
+  return Tpm2TisTpmCommand (
            (TIS_PC_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress),
            InputParameterBlock,
            InputParameterBlockSize,

From d1152e3b95b4f7ef42ff1c69bbf9814b571603de Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:26:45 +0000
Subject: [PATCH 421/525] MdePkg: Add TPM PTP definition.

TPM PTP (Platform TPM Profile) is TCG standard.
Add definition here.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19738 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit fb7abacad93b19489e24570277caeef4bb17abad)
---
 MdePkg/Include/IndustryStandard/TpmPtp.h | 522 +++++++++++++++++++++++
 1 file changed, 522 insertions(+)
 create mode 100644 MdePkg/Include/IndustryStandard/TpmPtp.h

diff --git a/MdePkg/Include/IndustryStandard/TpmPtp.h b/MdePkg/Include/IndustryStandard/TpmPtp.h
new file mode 100644
index 000000000000..079651268810
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/TpmPtp.h
@@ -0,0 +1,522 @@
+/** @file
+  Platform TPM Profile Specification definition for TPM2.0.
+  It covers both FIFO and CRB interface.
+
+Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _TPM_PTP_H_
+#define _TPM_PTP_H_
+
+//
+// PTP FIFO definition
+//
+
+//
+// Set structure alignment to 1-byte
+//
+#pragma pack (1)
+
+//
+// Register set map as specified in PTP specification Chapter 5
+//
+typedef struct {
+  ///
+  /// Used to gain ownership for this particular port.
+  ///
+  UINT8                             Access;             // 0
+  UINT8                             Reserved1[7];       // 1
+  ///
+  /// Controls interrupts.
+  ///
+  UINT32                            IntEnable;          // 8
+  ///
+  /// SIRQ vector to be used by the TPM.
+  ///
+  UINT8                             IntVector;          // 0ch
+  UINT8                             Reserved2[3];       // 0dh
+  ///
+  /// What caused interrupt.
+  ///
+  UINT32                            IntSts;             // 10h
+  ///
+  /// Shows which interrupts are supported by that particular TPM.
+  ///
+  UINT32                            InterfaceCapability;// 14h
+  ///
+  /// Status Register. Provides status of the TPM.
+  ///
+  UINT8                             Status;             // 18h
+  ///
+  /// Number of consecutive writes that can be done to the TPM.
+  ///
+  UINT16                            BurstCount;         // 19h
+  ///
+  /// Additional Status Register.
+  ///
+  UINT8                             StatusEx;           // 1Bh
+  UINT8                             Reserved3[8];
+  ///
+  /// Read or write FIFO, depending on transaction.
+  ///
+  UINT32                            DataFifo;           // 24h
+  UINT8                             Reserved4[8];       // 28h
+  ///
+  /// Used to identify the Interface types supported by the TPM.
+  ///
+  UINT32                            InterfaceId;        // 30h
+  UINT8                             Reserved5[0x4c];    // 34h
+  ///
+  /// Extended ReadFIFO or WriteFIFO, depending on the current bus cycle (read or write)
+  ///
+  UINT32                            XDataFifo;          // 80h
+  UINT8                             Reserved6[0xe7c];   // 84h
+  ///
+  /// Vendor ID
+  ///
+  UINT16                            Vid;                // 0f00h
+  ///
+  /// Device ID
+  ///
+  UINT16                            Did;                // 0f02h
+  ///
+  /// Revision ID
+  ///
+  UINT8                             Rid;                // 0f04h
+  UINT8                             Reserved[0xfb];     // 0f05h
+} PTP_FIFO_REGISTERS;
+
+//
+// Restore original structure alignment
+//
+#pragma pack ()
+
+//
+// Define pointer types used to access TIS registers on PC
+//
+typedef PTP_FIFO_REGISTERS  *PTP_FIFO_REGISTERS_PTR;
+
+//
+// Define bits of FIFO Interface Identifier Register
+//
+typedef union {
+  struct {
+    UINT32   InterfaceType:4;
+    UINT32   InterfaceVersion:4;
+    UINT32   CapLocality:1;
+    UINT32   Reserved1:2;
+    UINT32   CapDataXferSizeSupport:2;
+    UINT32   CapFIFO:1;
+    UINT32   CapCRB:1;
+    UINT32   CapIFRes:2;
+    UINT32   InterfaceSelector:2;
+    UINT32   IntfSelLock:1;
+    UINT32   Reserved2:4;
+    UINT32   Reserved3:8;
+  } Bits;
+  UINT32   Uint32;
+} PTP_FIFO_INTERFACE_IDENTIFIER;
+
+//
+// Define bits of FIFO Interface Capability Register
+//
+typedef union {
+  struct {
+    UINT32   DataAvailIntSupport:1;
+    UINT32   StsValidIntSupport:1;
+    UINT32   LocalityChangeIntSupport:1;
+    UINT32   InterruptLevelHigh:1;
+    UINT32   InterruptLevelLow:1;
+    UINT32   InterruptEdgeRising:1;
+    UINT32   InterruptEdgeFalling:1;
+    UINT32   CommandReadyIntSupport:1;
+    UINT32   BurstCountStatic:1;
+    UINT32   DataTransferSizeSupport:2;
+    UINT32   Reserved:17;
+    UINT32   InterfaceVersion:3;
+    UINT32   Reserved2:1;
+  } Bits;
+  UINT32   Uint32;
+} PTP_FIFO_INTERFACE_CAPABILITY;
+
+///
+/// InterfaceVersion
+///
+#define INTERFACE_CAPABILITY_INTERFACE_VERSION_TIS_12  0x0
+#define INTERFACE_CAPABILITY_INTERFACE_VERSION_TIS_13  0x2
+#define INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP     0x3
+
+
+//
+// Define bits of ACCESS and STATUS registers
+//
+
+///
+/// This bit is a 1 to indicate that the other bits in this register are valid.
+///
+#define PTP_FIFO_VALID                BIT7
+///
+/// Indicate that this locality is active.
+///
+#define PTP_FIFO_ACC_ACTIVE           BIT5
+///
+/// Set to 1 to indicate that this locality had the TPM taken away while
+/// this locality had the TIS_PC_ACC_ACTIVE bit set.
+///
+#define PTP_FIFO_ACC_SEIZED           BIT4
+///
+/// Set to 1 to indicate that TPM MUST reset the
+/// TIS_PC_ACC_ACTIVE bit and remove ownership for localities less than the
+/// locality that is writing this bit.
+///
+#define PTP_FIFO_ACC_SEIZE            BIT3
+///
+/// When this bit is 1, another locality is requesting usage of the TPM.
+///
+#define PTP_FIFO_ACC_PENDIND          BIT2
+///
+/// Set to 1 to indicate that this locality is requesting to use TPM.
+///
+#define PTP_FIFO_ACC_RQUUSE           BIT1
+///
+/// A value of 1 indicates that a T/OS has not been established on the platform
+///
+#define PTP_FIFO_ACC_ESTABLISH        BIT0
+
+///
+/// This field indicates that STS_DATA and STS_EXPECT are valid
+///
+#define PTP_FIFO_STS_VALID            BIT7
+///
+/// When this bit is 1, TPM is in the Ready state,
+/// indicating it is ready to receive a new command.
+///
+#define PTP_FIFO_STS_READY            BIT6
+///
+/// Write a 1 to this bit to cause the TPM to execute that command.
+///
+#define PTP_FIFO_STS_GO               BIT5
+///
+/// This bit indicates that the TPM has data available as a response.
+///
+#define PTP_FIFO_STS_DATA             BIT4
+///
+/// The TPM sets this bit to a value of 1 when it expects another byte of data for a command.
+///
+#define PTP_FIFO_STS_EXPECT           BIT3
+///
+/// Indicates that the TPM has completed all self-test actions following a TPM_ContinueSelfTest command.
+///
+#define PTP_FIFO_STS_SELFTEST_DONE    BIT2
+///
+/// Writes a 1 to this bit to force the TPM to re-send the response.
+///
+#define PTP_FIFO_STS_RETRY            BIT1
+
+///
+/// TPM Family Identifier.
+/// 00: TPM 1.2 Family
+/// 01: TPM 2.0 Family
+///
+#define PTP_FIFO_STS_EX_TPM_FAMILY    (BIT2 | BIT3)
+#define PTP_FIFO_STS_EX_TPM_FAMILY_OFFSET    (2)
+#define PTP_FIFO_STS_EX_TPM_FAMILY_TPM12    (0)
+#define PTP_FIFO_STS_EX_TPM_FAMILY_TPM20    (BIT2)
+///
+/// A write of 1 after tpmGo and before dataAvail aborts the currently executing command, resulting in a response of TPM_RC_CANCELLED.
+/// A write of 1 after dataAvail and before tpmGo is ignored by the TPM.
+///
+#define PTP_FIFO_STS_EX_CANCEL        BIT0
+
+
+//
+// PTP CRB definition
+//
+
+//
+// Set structure alignment to 1-byte
+//
+#pragma pack (1)
+
+//
+// Register set map as specified in PTP specification Chapter 5
+//
+typedef struct {
+  ///
+  /// Used to determine current state of Locality of the TPM.
+  ///
+  UINT32                            LocalityState;             // 0
+  UINT8                             Reserved1[4];              // 4
+  ///
+  /// Used to gain control of the TPM by this Locality.
+  ///
+  UINT32                            LocalityControl;           // 8
+  ///
+  /// Used to determine whether Locality has been granted or Seized.
+  ///
+  UINT32                            LocalityStatus;            // 0ch
+  UINT8                             Reserved2[0x20];           // 10h
+  ///
+  /// Used to identify the Interface types supported by the TPM.
+  ///
+  UINT32                            InterfaceId;               // 30h
+  ///
+  /// Vendor ID
+  ///
+  UINT16                            Vid;                       // 34h
+  ///
+  /// Device ID
+  ///
+  UINT16                            Did;                       // 36h
+  ///
+  /// Optional Register used in low memory environments prior to CRB_DATA_BUFFER availability.
+  ///
+  UINT64                            CrbControlExtension;       // 38h
+  ///
+  /// Register used to initiate transactions for the CRB interface.
+  ///
+  UINT32                            CrbControlRequest;         // 40h
+  ///
+  /// Register used by the TPM to provide status of the CRB interface.
+  ///
+  UINT32                            CrbControlStatus;          // 44h
+  ///
+  /// Register used by software to cancel command processing.
+  ///
+  UINT32                            CrbControlCancel;          // 48h
+  ///
+  /// Register used to indicate presence of command or response data in the CRB buffer.
+  ///
+  UINT32                            CrbControlStart;           // 4Ch
+  ///
+  /// Register used to configure and respond to interrupts.
+  ///
+  UINT32                            CrbInterruptEnable;        // 50h
+  UINT32                            CrbInterruptStatus;        // 54h
+  ///
+  /// Size of the Command buffer.
+  ///
+  UINT32                            CrbControlCommandSize;     // 58h
+  ///
+  /// Command buffer start address
+  ///
+  UINT32                            CrbControlCommandAddressLow;   // 5Ch
+  UINT32                            CrbControlCommandAddressHigh;  // 60h
+  ///
+  /// Size of the Response buffer
+  ///
+  UINT32                            CrbControlResponseSize;    // 64h
+  ///
+  /// Address of the start of the Response buffer
+  ///
+  UINT64                            CrbControlResponseAddrss;  // 68h
+  UINT8                             Reserved4[0x10];           // 70h
+  ///
+  /// Command/Response Data may be defined as large as 3968 (0xF80).
+  ///
+  UINT8                             CrbDataBuffer[0xF80];      // 80h
+} PTP_CRB_REGISTERS;
+
+//
+// Define pointer types used to access CRB registers on PTP
+//
+typedef PTP_CRB_REGISTERS  *PTP_CRB_REGISTERS_PTR;
+
+//
+// Define bits of CRB Interface Identifier Register
+//
+typedef union {
+  struct {
+    UINT32   InterfaceType:4;
+    UINT32   InterfaceVersion:4;
+    UINT32   CapLocality:1;
+    UINT32   Reserved1:2;
+    UINT32   CapDataXferSizeSupport:2;
+    UINT32   CapFIFO:1;
+    UINT32   CapCRB:1;
+    UINT32   CapIFRes:2;
+    UINT32   InterfaceSelector:2;
+    UINT32   IntfSelLock:1;
+    UINT32   Reserved2:4;
+    UINT32   Rid:8;
+  } Bits;
+  UINT32   Uint32;
+} PTP_CRB_INTERFACE_IDENTIFIER;
+
+///
+/// InterfaceType
+///
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO  0x0
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB   0x1
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_TIS   0xF
+
+///
+/// InterfaceVersion
+///
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_FIFO  0x0
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_CRB   0x1
+
+///
+/// InterfaceSelector
+///
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_SELECTOR_FIFO  0x0
+#define PTP_INTERFACE_IDENTIFIER_INTERFACE_SELECTOR_CRB   0x1
+
+//
+// Define bits of Locality State Register
+//
+
+///
+/// This bit indicates whether all other bits of this register contain valid values, if it is a 1.
+///
+#define PTP_CRB_LOCALITY_STATE_TPM_REG_VALID_STATUS       BIT7
+
+///
+/// 000 - Locality 0
+/// 001 - Locality 1
+/// 010 - Locality 2
+/// 011 - Locality 3
+/// 100 - Locality 4
+///
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_MASK       (BIT2 | BIT3 | BIT4)
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_0          (0)
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_1          (BIT2)
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_2          (BIT3)
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_3          (BIT2 | BIT3)
+#define PTP_CRB_LOCALITY_STATE_ACTIVE_LOCALITY_4          (BIT4)
+
+///
+/// A 0 indicates to the host that no locality is assigned.
+/// A 1 indicates a locality has been assigned.
+///
+#define PTP_CRB_LOCALITY_STATE_LOCALITY_ASSIGNED          BIT1
+
+///
+/// The TPM clears this bit to 0 upon receipt of _TPM_Hash_End
+/// The TPM sets this bit to a 1 when the TPM_LOC_CTRL_x.resetEstablishment field is set to 1.
+///
+#define PTP_CRB_LOCALITY_STATE_TPM_ESTABLISHED            BIT0
+
+//
+// Define bits of Locality Control Register
+//
+
+///
+/// Writes (1): Reset TPM_LOC_STATE_x.tpmEstablished bit if the write occurs from Locality 3 or 4.
+///
+#define PTP_CRB_LOCALITY_CONTROL_RESET_ESTABLISHMENT_BIT  BIT3
+
+///
+/// Writes (1): The TPM gives control of the TPM to the locality setting this bit if it is the higher priority locality.
+///
+#define PTP_CRB_LOCALITY_CONTROL_SEIZE                    BIT2
+
+///
+/// Writes (1): The active Locality is done with the TPM.
+///
+#define PTP_CRB_LOCALITY_CONTROL_RELINQUISH               BIT1
+
+///
+/// Writes (1): Interrupt the TPM and generate a locality arbitration algorithm.
+///
+#define PTP_CRB_LOCALITY_CONTROL_REQUEST_ACCESS           BIT0
+
+//
+// Define bits of Locality Status Register
+//
+
+///
+/// 0: A higher locality has not initiated a Seize arbitration process.
+/// 1: A higher locality has Seized the TPM from this locality.
+///
+#define PTP_CRB_LOCALITY_STATUS_BEEN_SEIZED               BIT1
+
+///
+/// 0: Locality has not been granted to the TPM.
+/// 1: Locality has been granted access to the TPM
+///
+#define PTP_CRB_LOCALITY_STATUS_GRANTED                   BIT0
+
+//
+// Define bits of CRB Control Area Request Register
+//
+
+///
+/// Used by Software to indicate transition the TPM to and from the Idle state
+/// 1: Set by Software to indicate response has been read from the response buffer and TPM can transition to Idle
+/// 0: Cleared to 0 by TPM to acknowledge the request when TPM enters Idle state.
+/// TPM SHALL complete this transition within TIMEOUT_C.
+///
+#define PTP_CRB_CONTROL_AREA_REQUEST_GO_IDLE              BIT1
+
+///
+/// Used by Software to request the TPM transition to the Ready State.
+/// 1: Set to 1 by Software to indicate the TPM should be ready to receive a command.
+/// 0: Cleared to 0 by TPM to acknowledge the request.
+/// TPM SHALL complete this transition within TIMEOUT_C.
+///
+#define PTP_CRB_CONTROL_AREA_REQUEST_COMMAND_READY        BIT0
+
+//
+// Define bits of CRB Control Area Status Register
+//
+
+///
+/// Used by TPM to indicate it is in the Idle State
+/// 1: Set by TPM when in the Idle State
+/// 0: Cleared by TPM on receipt of TPM_CRB_CTRL_REQ_x.cmdReady when TPM transitions to the Ready State.
+/// SHALL be cleared by TIMEOUT_C.
+///
+#define PTP_CRB_CONTROL_AREA_STATUS_TPM_IDLE              BIT1
+
+///
+/// Used by the TPM to indicate current status.
+/// 1: Set by TPM to indicate a FATAL Error
+/// 0: Indicates TPM is operational
+///
+#define PTP_CRB_CONTROL_AREA_STATUS_TPM_STATUS            BIT0
+
+//
+// Define bits of CRB Control Cancel Register
+//
+
+///
+/// Used by software to cancel command processing Reads return correct value
+/// Writes (0000 0001h): Cancel a command
+/// Writes (0000 0000h): Clears field when command has been cancelled
+///
+#define PTP_CRB_CONTROL_CANCEL                            BIT0
+
+//
+// Define bits of CRB Control Start Register
+//
+
+///
+/// When set by software, indicates a command is ready for processing.
+/// Writes (0000 0001h): TPM transitions to Command Execution
+/// Writes (0000 0000h): TPM clears this field and transitions to Command Completion
+///
+#define PTP_CRB_CONTROL_START                             BIT0
+
+//
+// Restore original structure alignment
+//
+#pragma pack ()
+
+//
+// Default TimeOut value
+//
+#define PTP_TIMEOUT_A               (750 * 1000)   // 750ms
+#define PTP_TIMEOUT_B               (2000 * 1000)  // 2s
+#define PTP_TIMEOUT_C               (200 * 1000)   // 200ms
+#define PTP_TIMEOUT_D               (30 * 1000)    // 30ms
+
+#endif
\ No newline at end of file

From a85ecfa18ad0e7705f60576e9b3751afb2402d9a Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:26:58 +0000
Subject: [PATCH 422/525] MdePkg: Add TPM TIS definition.

TPM TIS (TPM Interface Specification) is TCG standard.
Add definition here.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19739 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit ac6f9d7c127523a9509ede36e053adff8acfdbe1)
---
 MdePkg/Include/IndustryStandard/TpmTis.h | 183 +++++++++++++++++++++++
 1 file changed, 183 insertions(+)
 create mode 100644 MdePkg/Include/IndustryStandard/TpmTis.h

diff --git a/MdePkg/Include/IndustryStandard/TpmTis.h b/MdePkg/Include/IndustryStandard/TpmTis.h
new file mode 100644
index 000000000000..519fa794d122
--- /dev/null
+++ b/MdePkg/Include/IndustryStandard/TpmTis.h
@@ -0,0 +1,183 @@
+/** @file
+  TPM Interface Specification definition.
+  It covers both TPM1.2 and TPM2.0.
+
+Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#ifndef _TPM_TIS_H_
+#define _TPM_TIS_H_
+
+//
+// Set structure alignment to 1-byte
+//
+#pragma pack (1)
+
+//
+// Register set map as specified in TIS specification Chapter 10
+//
+typedef struct {
+  ///
+  /// Used to gain ownership for this particular port.
+  ///
+  UINT8                             Access;             // 0
+  UINT8                             Reserved1[7];       // 1
+  ///
+  /// Controls interrupts.
+  ///
+  UINT32                            IntEnable;          // 8
+  ///
+  /// SIRQ vector to be used by the TPM.
+  ///
+  UINT8                             IntVector;          // 0ch
+  UINT8                             Reserved2[3];       // 0dh
+  ///
+  /// What caused interrupt.
+  ///
+  UINT32                            IntSts;             // 10h
+  ///
+  /// Shows which interrupts are supported by that particular TPM.
+  ///
+  UINT32                            IntfCapability;     // 14h
+  ///
+  /// Status Register. Provides status of the TPM.
+  ///
+  UINT8                             Status;             // 18h
+  ///
+  /// Number of consecutive writes that can be done to the TPM.
+  ///
+  UINT16                            BurstCount;         // 19h
+  UINT8                             Reserved3[9];
+  ///
+  /// Read or write FIFO, depending on transaction.
+  ///
+  UINT32                            DataFifo;           // 24h
+  UINT8                             Reserved4[0xed8];   // 28h
+  ///
+  /// Vendor ID
+  ///
+  UINT16                            Vid;                // 0f00h
+  ///
+  /// Device ID
+  ///
+  UINT16                            Did;                // 0f02h
+  ///
+  /// Revision ID
+  ///
+  UINT8                             Rid;                // 0f04h
+  UINT8                             Reserved[0x7b];     // 0f05h
+  ///
+  /// Alias to I/O legacy space.
+  ///
+  UINT32                            LegacyAddress1;     // 0f80h
+  ///
+  /// Additional 8 bits for I/O legacy space extension.
+  ///
+  UINT32                            LegacyAddress1Ex;   // 0f84h
+  ///
+  /// Alias to second I/O legacy space.
+  ///
+  UINT32                            LegacyAddress2;     // 0f88h
+  ///
+  /// Additional 8 bits for second I/O legacy space extension.
+  ///
+  UINT32                            LegacyAddress2Ex;   // 0f8ch
+  ///
+  /// Vendor-defined configuration registers.
+  ///
+  UINT8                             VendorDefined[0x70];// 0f90h
+} TIS_PC_REGISTERS;
+
+//
+// Restore original structure alignment
+//
+#pragma pack ()
+
+//
+// Define pointer types used to access TIS registers on PC
+//
+typedef TIS_PC_REGISTERS  *TIS_PC_REGISTERS_PTR;
+
+//
+// Define bits of ACCESS and STATUS registers
+//
+
+///
+/// This bit is a 1 to indicate that the other bits in this register are valid.
+///
+#define TIS_PC_VALID                BIT7
+///
+/// Indicate that this locality is active.
+///
+#define TIS_PC_ACC_ACTIVE           BIT5
+///
+/// Set to 1 to indicate that this locality had the TPM taken away while
+/// this locality had the TIS_PC_ACC_ACTIVE bit set.
+///
+#define TIS_PC_ACC_SEIZED           BIT4
+///
+/// Set to 1 to indicate that TPM MUST reset the
+/// TIS_PC_ACC_ACTIVE bit and remove ownership for localities less than the
+/// locality that is writing this bit.
+///
+#define TIS_PC_ACC_SEIZE            BIT3
+///
+/// When this bit is 1, another locality is requesting usage of the TPM.
+///
+#define TIS_PC_ACC_PENDIND          BIT2
+///
+/// Set to 1 to indicate that this locality is requesting to use TPM.
+///
+#define TIS_PC_ACC_RQUUSE           BIT1
+///
+/// A value of 1 indicates that a T/OS has not been established on the platform
+///
+#define TIS_PC_ACC_ESTABLISH        BIT0
+
+///
+/// This field indicates that STS_DATA and STS_EXPECT are valid
+///
+#define TIS_PC_STS_VALID            BIT7
+///
+/// When this bit is 1, TPM is in the Ready state,
+/// indicating it is ready to receive a new command.
+///
+#define TIS_PC_STS_READY            BIT6
+///
+/// Write a 1 to this bit to cause the TPM to execute that command.
+///
+#define TIS_PC_STS_GO               BIT5
+///
+/// This bit indicates that the TPM has data available as a response.
+///
+#define TIS_PC_STS_DATA             BIT4
+///
+/// The TPM sets this bit to a value of 1 when it expects another byte of data for a command.
+///
+#define TIS_PC_STS_EXPECT           BIT3
+///
+/// Indicates that the TPM has completed all self-test actions following a TPM_ContinueSelfTest command.
+///
+#define TIS_PC_STS_SELFTEST_DONE    BIT2
+///
+/// Writes a 1 to this bit to force the TPM to re-send the response.
+///
+#define TIS_PC_STS_RETRY            BIT1
+
+//
+// Default TimeOut value
+//
+#define TIS_TIMEOUT_A               (750  * 1000)  // 750ms
+#define TIS_TIMEOUT_B               (2000 * 1000)  // 2s
+#define TIS_TIMEOUT_C               (750  * 1000)  // 750ms
+#define TIS_TIMEOUT_D               (750  * 1000)  // 750ms
+
+#endif
\ No newline at end of file

From f201bcd70809851990583982a7fddf8554253618 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:29:38 +0000
Subject: [PATCH 423/525] SecurityPkg: Add TPM PTP support in TPM2 device lib.

TPM2 hardware may support PTP FIFO/TIS interface
or PTP CRB interface. The original lib only handles
PTP FIFO/TIS interface. This patch adds PTP CRB
interface support.
The current logic is that lib will runtime detect
TPM device interface (CRB or FIFO/TIS) and call
proper function to access hardware.

It is compatible for old TPM2 FIFO/TIS device and
new TPM2 CRB device.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19740 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 79e748cf29f6d9a92f28d44d20eef8d6c24c4092)
---
 .../Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf   |  10 +-
 .../Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.uni   | Bin 2270 -> 2418 bytes
 .../Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.c   |  15 +-
 .../Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.inf |  10 +-
 .../Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.uni | Bin 1958 -> 2370 bytes
 .../Library/Tpm2DeviceLibDTpm/Tpm2Ptp.c       | 537 ++++++++++++++++++
 .../Library/Tpm2DeviceLibDTpm/Tpm2Tis.c       | 169 +-----
 7 files changed, 567 insertions(+), 174 deletions(-)
 create mode 100644 SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Ptp.c

diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf
index 2d41e7ccd2ee..976972d98d2e 100644
--- a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.inf
@@ -1,11 +1,12 @@
 ## @file
-#  Provides TPM 2.0 TIS functions for DTPM
+#  Provides TPM 2.0 TIS/PTP functions for DTPM
 #  
-#  This library implements TIS (TPM Interface Specification) functions which is 
-#  used for every TPM 2.0 command. Choosing this library means platform uses and 
+#  This library implements TIS (TPM Interface Specification) and
+#  PTP (Platform TPM Profile) functions which is
+#  used for every TPM 2.0 command. Choosing this library means platform uses and
 #  only uses TPM 2.0 DTPM device.
 #
-# Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -32,6 +33,7 @@
 
 [Sources]
   Tpm2Tis.c
+  Tpm2Ptp.c
   Tpm2DeviceLibDTpm.c
 
 [Packages]
diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.uni b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2DeviceLibDTpm.uni
index 1a760b62933274b05d2041664d342db875984d35..807ba8bdfde728a2485c5678aed08ed52af90c7a 100644
GIT binary patch
delta 179
zcmca7_(^Dj54%1?07D2vz~udG>Jy9F91|Jx7*ZH`8MqkqflvV=38XcEtQ>|!h7yJ}
zhJ1!1hFqW+P#c3USWOX7ER7)(s3LXpMRv{2GK@NmjAolXnaWvU7Hr<nCeCOHF`f)#
KH(zAuWdr~;_ard@

delta 38
ucmew)bWd=C&tx%nwTV@2o81@#7#U4APiHD;*(}B`#yHuHQDt%;#}fbo9t>~*

diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.c b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.c
index 6a6a0423730c..a50d266b8e8a 100644
--- a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.c
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.c
@@ -3,7 +3,7 @@
   It can be registered to Tpm2 Device router, to be active TPM2 engine,
   based on platform setting.
 
-Copyright (c) 2013, Intel Corporation. All rights reserved. <BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved. <BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -21,6 +21,16 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include <Guid/TpmInstance.h>
 
+/**
+  Dump PTP register information.
+
+  @param[in] Register                Pointer to PTP register.
+**/
+VOID
+DumpPtpInfo (
+  IN VOID *Register
+  );
+
 /**
   This service enables the sending of commands to the TPM2.
 
@@ -79,6 +89,9 @@ Tpm2InstanceLibDTpmConstructor (
     //
     // Unsupported means platform policy does not need this instance enabled.
     //
+    if (Status == EFI_SUCCESS) {
+      DumpPtpInfo ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+    }
     return EFI_SUCCESS;
   }
   return Status;
diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.inf b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.inf
index 2a8f78beeb60..22efb1ef4c97 100644
--- a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.inf
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.inf
@@ -1,10 +1,11 @@
 ## @file
-#  Provides a DTPM instance for TPM 2.0
+#  Provides a DTPM instance for TPM 2.0 TIS/PTP.
 #
-#  This library can be registered to Tpm 2.0 device router, to be active TPM 2.0 
-#  engine, based on platform setting.
+#  This library can be registered to Tpm 2.0 device router, to be active TPM 2.0
+#  engine, based on platform setting. It supports both TIS (TPM Interface Specification)
+#  and PTP (Platform TPM Profile) functions.
 #
-# Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -32,6 +33,7 @@
 
 [Sources]
   Tpm2Tis.c
+  Tpm2Ptp.c
   Tpm2InstanceLibDTpm.c
 
 [Packages]
diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.uni b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2InstanceLibDTpm.uni
index 6a8a2b95803aaf6faa09d216caad5298279a3839..3319d778c72eac093284d66b75b4e125fe8d3032 100644
GIT binary patch
delta 456
zcmZ3+e@JLT4!;6J2!kg>FoQlr0FV_hIgwR(V%>{+1)yLFg91Y_Ln%W65au%!0r|y1
zkt86ygdqdSf@oA=&;V&<@CAx^GUNf}Qh{pI7!nzhfh+}}(FH&{nIRJ>mI<U2fhsbA
zX5=wwGVn5R0WH=Cs!9a%Q-Czs5ey0rKtlr<a=?nyz?SC%C1KVC04>M|8<zt#S`#Rf
z26Sc~&~TX1#gpS%MJHD<8Zeq|UdcF}1>KvQ?b%`(>EuZa&%ylW3Un@6o@3BsPy&Y?
GDEt7ijZ!=S

delta 40
scmX>kw2Xg3&cvEulTFx!CVMd%Fq&+xW}42jS&2P{kxPkzmw^k60Ti$b4gdfE

diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Ptp.c b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Ptp.c
new file mode 100644
index 000000000000..a627bbdedf7a
--- /dev/null
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Ptp.c
@@ -0,0 +1,537 @@
+/** @file
+  PTP (Platform TPM Profile) CRB (Command Response Buffer) interface used by dTPM2.0 library.
+
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <IndustryStandard/Tpm20.h>
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/IoLib.h>
+#include <Library/TimerLib.h>
+#include <Library/DebugLib.h>
+#include <Library/Tpm2DeviceLib.h>
+#include <Library/PcdLib.h>
+
+#include <IndustryStandard/TpmPtp.h>
+#include <IndustryStandard/TpmTis.h>
+
+typedef enum {
+  PtpInterfaceTis,
+  PtpInterfaceFifo,
+  PtpInterfaceCrb,
+  PtpInterfaceMax,
+} PTP_INTERFACE_TYPE;
+
+//
+// Execution of the command may take from several seconds to minutes for certain
+// commands, such as key generation.
+//
+#define PTP_TIMEOUT_MAX             (90000 * 1000)  // 90s
+
+//
+// Max TPM command/reponse length
+//
+#define TPMCMDBUFLENGTH             0x500
+
+/**
+  Check whether TPM PTP register exist.
+
+  @param[in] Reg  Pointer to PTP register.
+
+  @retval    TRUE    TPM PTP exists.
+  @retval    FALSE   TPM PTP is not found.
+**/
+BOOLEAN
+IsPtpPresence (
+  IN VOID *Reg
+  )
+{
+  UINT8                             RegRead;
+
+  RegRead = MmioRead8 ((UINTN)Reg);
+  if (RegRead == 0xFF) {
+    //
+    // No TPM chip
+    //
+    return FALSE;
+  }
+  return TRUE;
+}
+
+/**
+  Check whether the value of a TPM chip register satisfies the input BIT setting.
+
+  @param[in]  Register     Address port of register to be checked.
+  @param[in]  BitSet       Check these data bits are set.
+  @param[in]  BitClear     Check these data bits are clear.
+  @param[in]  TimeOut      The max wait time (unit MicroSecond) when checking register.
+
+  @retval     EFI_SUCCESS  The register satisfies the check bit.
+  @retval     EFI_TIMEOUT  The register can't run into the expected status in time.
+**/
+EFI_STATUS
+PtpCrbWaitRegisterBits (
+  IN      UINT32                    *Register,
+  IN      UINT32                    BitSet,
+  IN      UINT32                    BitClear,
+  IN      UINT32                    TimeOut
+  )
+{
+  UINT32                            RegRead;
+  UINT32                            WaitTime;
+
+  for (WaitTime = 0; WaitTime < TimeOut; WaitTime += 30){
+    RegRead = MmioRead32 ((UINTN)Register);
+    if ((RegRead & BitSet) == BitSet && (RegRead & BitClear) == 0) {
+      return EFI_SUCCESS;
+    }
+    MicroSecondDelay (30);
+  }
+  return EFI_TIMEOUT;
+}
+
+/**
+  Get the control of TPM chip.
+
+  @param[in] CrbReg                Pointer to CRB register.
+
+  @retval    EFI_SUCCESS           Get the control of TPM chip.
+  @retval    EFI_INVALID_PARAMETER CrbReg is NULL.
+  @retval    EFI_NOT_FOUND         TPM chip doesn't exit.
+  @retval    EFI_TIMEOUT           Can't get the TPM control in time.
+**/
+EFI_STATUS
+PtpCrbRequestUseTpm (
+  IN      PTP_CRB_REGISTERS_PTR      CrbReg
+  )
+{
+  EFI_STATUS                        Status;
+
+  if (!IsPtpPresence (CrbReg)) {
+    return EFI_NOT_FOUND;
+  }
+
+  MmioWrite32((UINTN)&CrbReg->LocalityControl, PTP_CRB_LOCALITY_CONTROL_REQUEST_ACCESS);
+  Status = PtpCrbWaitRegisterBits (
+             &CrbReg->LocalityStatus,
+             PTP_CRB_LOCALITY_STATUS_GRANTED,
+             0,
+             PTP_TIMEOUT_A
+             );
+  return Status;
+}
+
+/**
+  Send a command to TPM for execution and return response data.
+
+  @param[in]      CrbReg        TPM register space base address.
+  @param[in]      BufferIn      Buffer for command data.
+  @param[in]      SizeIn        Size of command data.
+  @param[in, out] BufferOut     Buffer for response data.
+  @param[in, out] SizeOut       Size of response data.
+
+  @retval EFI_SUCCESS           Operation completed successfully.
+  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.
+  @retval EFI_DEVICE_ERROR      Unexpected device behavior.
+  @retval EFI_UNSUPPORTED       Unsupported TPM version
+
+**/
+EFI_STATUS
+PtpCrbTpmCommand (
+  IN     PTP_CRB_REGISTERS_PTR      CrbReg,
+  IN     UINT8                      *BufferIn,
+  IN     UINT32                     SizeIn,
+  IN OUT UINT8                      *BufferOut,
+  IN OUT UINT32                     *SizeOut
+  )
+{
+  EFI_STATUS                        Status;
+  UINT32                            Index;
+  UINT32                            TpmOutSize;
+  UINT16                            Data16;
+  UINT32                            Data32;
+
+  DEBUG_CODE (
+    UINTN  DebugSize;
+
+    DEBUG ((EFI_D_VERBOSE, "PtpCrbTpmCommand Send - "));
+    if (SizeIn > 0x100) {
+      DebugSize = 0x40;
+    } else {
+      DebugSize = SizeIn;
+    }
+    for (Index = 0; Index < DebugSize; Index++) {
+      DEBUG ((EFI_D_VERBOSE, "%02x ", BufferIn[Index]));
+    }
+    if (DebugSize != SizeIn) {
+      DEBUG ((EFI_D_VERBOSE, "...... "));
+      for (Index = SizeIn - 0x20; Index < SizeIn; Index++) {
+        DEBUG ((EFI_D_VERBOSE, "%02x ", BufferIn[Index]));
+      }
+    }
+    DEBUG ((EFI_D_VERBOSE, "\n"));
+  );
+  TpmOutSize = 0;
+
+  //
+  // STEP 0:
+  // Ready is any time the TPM is ready to receive a command, following a write
+  // of 1 by software to Request.cmdReady, as indicated by the Status field
+  // being cleared to 0.
+  //
+  MmioWrite32((UINTN)&CrbReg->CrbControlRequest, PTP_CRB_CONTROL_AREA_REQUEST_COMMAND_READY);
+  Status = PtpCrbWaitRegisterBits (
+             &CrbReg->CrbControlRequest,
+             0,
+             PTP_CRB_CONTROL_AREA_REQUEST_COMMAND_READY,
+             PTP_TIMEOUT_C
+             );
+  if (EFI_ERROR (Status)) {
+    Status = EFI_DEVICE_ERROR;
+    goto Exit;
+  }
+  Status = PtpCrbWaitRegisterBits (
+             &CrbReg->CrbControlStatus,
+             0,
+             PTP_CRB_CONTROL_AREA_STATUS_TPM_IDLE,
+             PTP_TIMEOUT_C
+             );
+  if (EFI_ERROR (Status)) {
+    Status = EFI_DEVICE_ERROR;
+    goto Exit;
+  }
+
+  //
+  // STEP 1:
+  // Command Reception occurs following a Ready state between the write of the
+  // first byte of a command to the Command Buffer and the receipt of a write
+  // of 1 to Start.
+  //
+  for (Index = 0; Index < SizeIn; Index++) {
+    MmioWrite8 ((UINTN)&CrbReg->CrbDataBuffer[Index], BufferIn[Index]);
+  }
+  MmioWrite32 ((UINTN)&CrbReg->CrbControlCommandAddressHigh, (UINT32)RShiftU64 ((UINTN)CrbReg->CrbDataBuffer, 32));
+  MmioWrite32 ((UINTN)&CrbReg->CrbControlCommandAddressLow, (UINT32)(UINTN)CrbReg->CrbDataBuffer);
+  MmioWrite32 ((UINTN)&CrbReg->CrbControlCommandSize, sizeof(CrbReg->CrbDataBuffer));
+
+  MmioWrite64 ((UINTN)&CrbReg->CrbControlResponseAddrss, (UINT32)(UINTN)CrbReg->CrbDataBuffer);
+  MmioWrite32 ((UINTN)&CrbReg->CrbControlResponseSize, sizeof(CrbReg->CrbDataBuffer));
+
+  //
+  // STEP 2:
+  // Command Execution occurs after receipt of a 1 to Start and the TPM
+  // clearing Start to 0.
+  //
+  MmioWrite32((UINTN)&CrbReg->CrbControlStart, PTP_CRB_CONTROL_START);
+  Status = PtpCrbWaitRegisterBits (
+             &CrbReg->CrbControlStart,
+             0,
+             PTP_CRB_CONTROL_START,
+             PTP_TIMEOUT_MAX
+             );
+  if (EFI_ERROR (Status)) {
+    Status = EFI_DEVICE_ERROR;
+    goto Exit;
+  }
+
+  //
+  // STEP 3:
+  // Command Completion occurs after completion of a command (indicated by the
+  // TPM clearing TPM_CRB_CTRL_Start_x to 0) and before a write of a 1 by the
+  // software to Request.goIdle.
+  //
+
+  //
+  // Get response data header
+  //
+  for (Index = 0; Index < sizeof (TPM2_RESPONSE_HEADER); Index++) {
+    BufferOut[Index] = MmioRead8 ((UINTN)&CrbReg->CrbDataBuffer[Index]);
+  }
+  DEBUG_CODE (
+    DEBUG ((EFI_D_VERBOSE, "PtpCrbTpmCommand ReceiveHeader - "));
+    for (Index = 0; Index < sizeof (TPM2_RESPONSE_HEADER); Index++) {
+      DEBUG ((EFI_D_VERBOSE, "%02x ", BufferOut[Index]));
+    }
+    DEBUG ((EFI_D_VERBOSE, "\n"));
+  );
+  //
+  // Check the reponse data header (tag, parasize and returncode)
+  //
+  CopyMem (&Data16, BufferOut, sizeof (UINT16));
+  // TPM2 should not use this RSP_COMMAND
+  if (SwapBytes16 (Data16) == TPM_ST_RSP_COMMAND) {
+    DEBUG ((EFI_D_ERROR, "TPM2: TPM_ST_RSP error - %x\n", TPM_ST_RSP_COMMAND));
+    Status = EFI_UNSUPPORTED;
+    goto Exit;
+  }
+
+  CopyMem (&Data32, (BufferOut + 2), sizeof (UINT32));
+  TpmOutSize  = SwapBytes32 (Data32);
+  if (*SizeOut < TpmOutSize) {
+    Status = EFI_BUFFER_TOO_SMALL;
+    goto Exit;
+  }
+  *SizeOut = TpmOutSize;
+  //
+  // Continue reading the remaining data
+  //
+  for (Index = sizeof (TPM2_RESPONSE_HEADER); Index < TpmOutSize; Index++) {
+    BufferOut[Index] = MmioRead8 ((UINTN)&CrbReg->CrbDataBuffer[Index]);
+  }
+Exit:
+  DEBUG_CODE (
+    DEBUG ((EFI_D_VERBOSE, "PtpCrbTpmCommand Receive - "));
+    for (Index = 0; Index < TpmOutSize; Index++) {
+      DEBUG ((EFI_D_VERBOSE, "%02x ", BufferOut[Index]));
+    }
+    DEBUG ((EFI_D_VERBOSE, "\n"));
+  );
+
+  //
+  // STEP 4:
+  // Idle is any time TPM_CRB_CTRL_STS_x.Status.goIdle is 1.
+  //
+  MmioWrite32((UINTN)&CrbReg->CrbControlRequest, PTP_CRB_CONTROL_AREA_REQUEST_GO_IDLE);
+  return Status;
+}
+
+/**
+  Send a command to TPM for execution and return response data.
+
+  @param[in]      TisReg        TPM register space base address.
+  @param[in]      BufferIn      Buffer for command data.
+  @param[in]      SizeIn        Size of command data.
+  @param[in, out] BufferOut     Buffer for response data.
+  @param[in, out] SizeOut       Size of response data.
+
+  @retval EFI_SUCCESS           Operation completed successfully.
+  @retval EFI_BUFFER_TOO_SMALL  Response data buffer is too small.
+  @retval EFI_DEVICE_ERROR      Unexpected device behavior.
+  @retval EFI_UNSUPPORTED       Unsupported TPM version
+
+**/
+EFI_STATUS
+Tpm2TisTpmCommand (
+  IN     TIS_PC_REGISTERS_PTR       TisReg,
+  IN     UINT8                      *BufferIn,
+  IN     UINT32                     SizeIn,
+  IN OUT UINT8                      *BufferOut,
+  IN OUT UINT32                     *SizeOut
+  );
+
+/**
+  Get the control of TPM chip by sending requestUse command TIS_PC_ACC_RQUUSE
+  to ACCESS Register in the time of default TIS_TIMEOUT_A.
+
+  @param[in] TisReg                Pointer to TIS register.
+
+  @retval    EFI_SUCCESS           Get the control of TPM chip.
+  @retval    EFI_INVALID_PARAMETER TisReg is NULL.
+  @retval    EFI_NOT_FOUND         TPM chip doesn't exit.
+  @retval    EFI_TIMEOUT           Can't get the TPM control in time.
+**/
+EFI_STATUS
+TisPcRequestUseTpm (
+  IN     TIS_PC_REGISTERS_PTR       TisReg
+  );
+
+/**
+  Return PTP interface type.
+
+  @param[in] Register                Pointer to PTP register.
+
+  @return PTP interface type.
+**/
+PTP_INTERFACE_TYPE
+GetPtpInterface (
+  IN VOID *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+  PTP_FIFO_INTERFACE_CAPABILITY InterfaceCapability;
+
+  if (!IsPtpPresence (Register)) {
+    return PtpInterfaceMax;
+  }
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  InterfaceCapability.Uint32 = MmioRead32 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->InterfaceCapability);
+
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_CRB) &&
+      (InterfaceId.Bits.CapCRB != 0)) {
+    return PtpInterfaceCrb;
+  }
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_FIFO) &&
+      (InterfaceId.Bits.CapFIFO != 0) &&
+      (InterfaceCapability.Bits.InterfaceVersion == INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP)) {
+    return PtpInterfaceFifo;
+  }
+  return PtpInterfaceTis;
+}
+
+/**
+  Dump PTP register information.
+
+  @param[in] Register                Pointer to PTP register.
+**/
+VOID
+DumpPtpInfo (
+  IN VOID *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+  PTP_FIFO_INTERFACE_CAPABILITY InterfaceCapability;
+  UINT8                         StatusEx;
+  UINT16                        Vid;
+  UINT16                        Did;
+  UINT8                         Rid;
+  PTP_INTERFACE_TYPE            PtpInterface;
+
+  if (!IsPtpPresence (Register)) {
+    return ;
+  }
+
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  InterfaceCapability.Uint32 = MmioRead32 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->InterfaceCapability);
+  StatusEx = MmioRead8 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->StatusEx);
+
+  //
+  // Dump InterfaceId Register for PTP
+  //
+  DEBUG ((EFI_D_INFO, "InterfaceId - 0x%08x\n", InterfaceId.Uint32));
+  DEBUG ((EFI_D_INFO, "  InterfaceType    - 0x%02x\n", InterfaceId.Bits.InterfaceType));
+  if (InterfaceId.Bits.InterfaceType != PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_TIS) {
+    DEBUG ((EFI_D_INFO, "  InterfaceVersion - 0x%02x\n", InterfaceId.Bits.InterfaceVersion));
+    DEBUG ((EFI_D_INFO, "  CapFIFO          - 0x%x\n", InterfaceId.Bits.CapFIFO));
+    DEBUG ((EFI_D_INFO, "  CapCRB           - 0x%x\n", InterfaceId.Bits.CapCRB));
+  }
+
+  //
+  // Dump Capability Register for TIS and FIFO
+  //
+  DEBUG ((EFI_D_INFO, "InterfaceCapability - 0x%08x\n", InterfaceCapability.Uint32));
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_TIS) ||
+      (InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO)) {
+    DEBUG ((EFI_D_INFO, "  InterfaceVersion - 0x%x\n", InterfaceCapability.Bits.InterfaceVersion));
+  }
+
+  //
+  // Dump StatusEx Register for PTP FIFO
+  //
+  DEBUG ((EFI_D_INFO, "StatusEx - 0x%02x\n", StatusEx));
+  if (InterfaceCapability.Bits.InterfaceVersion == INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP) {
+    DEBUG ((EFI_D_INFO, "  TpmFamily - 0x%x\n", (StatusEx & PTP_FIFO_STS_EX_TPM_FAMILY) >> PTP_FIFO_STS_EX_TPM_FAMILY_OFFSET));
+  }
+
+  Vid = 0xFFFF;
+  Did = 0xFFFF;
+  Rid = 0xFF;
+  PtpInterface = GetPtpInterface (Register);
+  DEBUG ((EFI_D_INFO, "PtpInterface - %x\n", PtpInterface));
+  switch (PtpInterface) {
+  case PtpInterfaceCrb:
+    Vid = MmioRead16 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->Vid);
+    Did = MmioRead16 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->Did);
+    Rid = (UINT8)InterfaceId.Bits.Rid;
+    break;
+  case PtpInterfaceFifo:
+  case PtpInterfaceTis:
+    Vid = MmioRead16 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->Vid);
+    Did = MmioRead16 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->Did);
+    Rid = MmioRead8 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->Rid);
+    break;
+  default:
+    break;
+  }
+  DEBUG ((EFI_D_INFO, "VID - 0x%04x\n", Vid));
+  DEBUG ((EFI_D_INFO, "DID - 0x%04x\n", Did));
+  DEBUG ((EFI_D_INFO, "RID - 0x%02x\n", Rid));
+}
+
+/**
+  This service enables the sending of commands to the TPM2.
+
+  @param[in]      InputParameterBlockSize  Size of the TPM2 input parameter block.
+  @param[in]      InputParameterBlock      Pointer to the TPM2 input parameter block.
+  @param[in,out]  OutputParameterBlockSize Size of the TPM2 output parameter block.
+  @param[in]      OutputParameterBlock     Pointer to the TPM2 output parameter block.
+
+  @retval EFI_SUCCESS            The command byte stream was successfully sent to the device and a response was successfully received.
+  @retval EFI_DEVICE_ERROR       The command was not successfully sent to the device or a response was not successfully received from the device.
+  @retval EFI_BUFFER_TOO_SMALL   The output parameter block is too small.
+**/
+EFI_STATUS
+EFIAPI
+DTpm2SubmitCommand (
+  IN UINT32            InputParameterBlockSize,
+  IN UINT8             *InputParameterBlock,
+  IN OUT UINT32        *OutputParameterBlockSize,
+  IN UINT8             *OutputParameterBlock
+  )
+{
+  PTP_INTERFACE_TYPE  PtpInterface;
+
+  PtpInterface = GetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  switch (PtpInterface) {
+  case PtpInterfaceCrb:
+    return PtpCrbTpmCommand (
+           (PTP_CRB_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress),
+           InputParameterBlock,
+           InputParameterBlockSize,
+           OutputParameterBlock,
+           OutputParameterBlockSize
+           );
+  case PtpInterfaceFifo:
+  case PtpInterfaceTis:
+    return Tpm2TisTpmCommand (
+           (TIS_PC_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress),
+           InputParameterBlock,
+           InputParameterBlockSize,
+           OutputParameterBlock,
+           OutputParameterBlockSize
+           );
+  default:
+    return EFI_NOT_FOUND;
+  }
+}
+
+/**
+  This service requests use TPM2.
+
+  @retval EFI_SUCCESS      Get the control of TPM2 chip.
+  @retval EFI_NOT_FOUND    TPM2 not found.
+  @retval EFI_DEVICE_ERROR Unexpected device behavior.
+**/
+EFI_STATUS
+EFIAPI
+DTpm2RequestUseTpm (
+  VOID
+  )
+{
+  PTP_INTERFACE_TYPE  PtpInterface;
+
+  PtpInterface = GetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  switch (PtpInterface) {
+  case PtpInterfaceCrb:
+    return PtpCrbRequestUseTpm ((PTP_CRB_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  case PtpInterfaceFifo:
+  case PtpInterfaceTis:
+    return TisPcRequestUseTpm ((TIS_PC_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  default:
+    return EFI_NOT_FOUND;
+  }
+}
diff --git a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
index 4eab72f811fe..bee8bb35fd75 100644
--- a/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
+++ b/SecurityPkg/Library/Tpm2DeviceLibDTpm/Tpm2Tis.c
@@ -1,7 +1,7 @@
 /** @file
   TIS (TPM Interface Specification) functions used by dTPM2.0 library.
   
-Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved.<BR>
 (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
@@ -23,168 +23,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/Tpm2DeviceLib.h>
 #include <Library/PcdLib.h>
 
-//
-// Set structure alignment to 1-byte
-//
-#pragma pack (1)
-
-//
-// Register set map as specified in TIS specification Chapter 10
-//
-typedef struct {
-  ///
-  /// Used to gain ownership for this particular port.
-  ///
-  UINT8                             Access;             // 0
-  UINT8                             Reserved1[7];       // 1
-  ///
-  /// Controls interrupts.
-  ///
-  UINT32                            IntEnable;          // 8
-  ///
-  /// SIRQ vector to be used by the TPM.
-  ///
-  UINT8                             IntVector;          // 0ch
-  UINT8                             Reserved2[3];       // 0dh
-  ///
-  /// What caused interrupt.
-  ///
-  UINT32                            IntSts;             // 10h
-  ///
-  /// Shows which interrupts are supported by that particular TPM.
-  ///
-  UINT32                            IntfCapability;     // 14h
-  ///
-  /// Status Register. Provides status of the TPM.
-  ///
-  UINT8                             Status;             // 18h
-  ///
-  /// Number of consecutive writes that can be done to the TPM.
-  ///
-  UINT16                            BurstCount;         // 19h
-  ///
-  /// TPM2 support CANCEL at BIT[24] of STATUS register (WO)
-  ///
-  UINT8                             StatusEx;           // 1Bh
-  UINT8                             Reserved3[8];
-  ///
-  /// Read or write FIFO, depending on transaction.
-  ///
-  UINT32                            DataFifo;           // 24h
-  UINT8                             Reserved4[0xed8];   // 28h
-  ///
-  /// Vendor ID
-  ///
-  UINT16                            Vid;                // 0f00h
-  ///
-  /// Device ID
-  ///
-  UINT16                            Did;                // 0f02h
-  ///
-  /// Revision ID
-  ///
-  UINT8                             Rid;                // 0f04h
-  ///
-  /// TCG defined configuration registers.
-  ///
-  UINT8                             TcgDefined[0x7b];   // 0f05h
-  ///
-  /// Alias to I/O legacy space.
-  ///
-  UINT32                            LegacyAddress1;     // 0f80h
-  ///
-  /// Additional 8 bits for I/O legacy space extension.
-  ///
-  UINT32                            LegacyAddress1Ex;   // 0f84h
-  ///
-  /// Alias to second I/O legacy space.
-  ///
-  UINT32                            LegacyAddress2;     // 0f88h
-  ///
-  /// Additional 8 bits for second I/O legacy space extension.
-  ///
-  UINT32                            LegacyAddress2Ex;   // 0f8ch
-  ///
-  /// Vendor-defined configuration registers.
-  ///
-  UINT8                             VendorDefined[0x70];// 0f90h
-} TIS_PC_REGISTERS;
-
-//
-// Restore original structure alignment
-//
-#pragma pack ()
-
-//
-// Define pointer types used to access TIS registers on PC
-//
-typedef TIS_PC_REGISTERS  *TIS_PC_REGISTERS_PTR;
-
-//
-// Define bits of ACCESS and STATUS registers
-//
-
-///
-/// This bit is a 1 to indicate that the other bits in this register are valid.
-///
-#define TIS_PC_VALID                BIT7
-///
-/// Indicate that this locality is active.
-///
-#define TIS_PC_ACC_ACTIVE           BIT5
-///
-/// Set to 1 to indicate that this locality had the TPM taken away while
-/// this locality had the TIS_PC_ACC_ACTIVE bit set.
-///
-#define TIS_PC_ACC_SEIZED           BIT4
-///
-/// Set to 1 to indicate that TPM MUST reset the
-/// TIS_PC_ACC_ACTIVE bit and remove ownership for localities less than the
-/// locality that is writing this bit.
-///
-#define TIS_PC_ACC_SEIZE            BIT3
-///
-/// When this bit is 1, another locality is requesting usage of the TPM.
-///
-#define TIS_PC_ACC_PENDIND          BIT2
-///
-/// Set to 1 to indicate that this locality is requesting to use TPM.
-///
-#define TIS_PC_ACC_RQUUSE           BIT1
-///
-/// A value of 1 indicates that a T/OS has not been established on the platform
-///
-#define TIS_PC_ACC_ESTABLISH        BIT0
-
-///
-/// When this bit is 1, TPM is in the Ready state, 
-/// indicating it is ready to receive a new command.
-///
-#define TIS_PC_STS_READY            BIT6
-///
-/// Write a 1 to this bit to cause the TPM to execute that command.
-///
-#define TIS_PC_STS_GO               BIT5
-///
-/// This bit indicates that the TPM has data available as a response.
-///
-#define TIS_PC_STS_DATA             BIT4
-///
-/// The TPM sets this bit to a value of 1 when it expects another byte of data for a command.
-///
-#define TIS_PC_STS_EXPECT           BIT3
-///
-/// Writes a 1 to this bit to force the TPM to re-send the response.
-///
-#define TIS_PC_STS_RETRY            BIT1
-
-//
-// Default TimeOut value
-//
-#define TIS_TIMEOUT_A               (1000 * 1000)  // 1s
-#define TIS_TIMEOUT_B               (2000 * 1000)  // 2s
-#define TIS_TIMEOUT_C               (1000 * 1000)  // 1s
-#define TIS_TIMEOUT_D               (1000 * 1000)  // 1s
+#include <IndustryStandard/TpmTis.h>
 
 #define TIS_TIMEOUT_MAX             (90000 * 1000)  // 90s
 
@@ -546,7 +385,7 @@ Tpm2TisTpmCommand (
 **/
 EFI_STATUS
 EFIAPI
-DTpm2SubmitCommand (
+DTpm2TisSubmitCommand (
   IN UINT32            InputParameterBlockSize,
   IN UINT8             *InputParameterBlock,
   IN OUT UINT32        *OutputParameterBlockSize,
@@ -571,7 +410,7 @@ DTpm2SubmitCommand (
 **/
 EFI_STATUS
 EFIAPI
-DTpm2RequestUseTpm (
+DTpm2TisRequestUseTpm (
   VOID
   )
 {

From b9f166153e2fbafd2f22245e328b802261a678c5 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:30:17 +0000
Subject: [PATCH 424/525] SecurityPkg: Add TPM PTP support in TCG2 SMM.

TPM2 hardware may support PTP FIFO/TIS interface
or PTP CRB interface. The original ACPI table only
handles PTP FIFO/TIS interface. This patch adds
PTP CRB interface support.
The current logic is that SMM driver will runtime
detect TPM device interface (CRB or FIFO/TIS) and
publish TPM2 table based on result.

It is compatible for old TPM2 FIFO/TIS device and
new TPM2 CRB device.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19741 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit d967d6d96fc18d7a53d32223f5813b12cda19e8d)
---
 SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.c   | 64 ++++++++++++++++++++++++++++-
 SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.h   |  5 ++-
 SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.inf |  4 +-
 SecurityPkg/Tcg/Tcg2Smm/Tpm.asl     |  2 +-
 4 files changed, 71 insertions(+), 4 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.c b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.c
index 503cc18dd98f..dab1f532cc9a 100644
--- a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.c
+++ b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.c
@@ -9,7 +9,7 @@
 
   PhysicalPresenceCallback() and MemoryClearCallback() will receive untrusted input and do some check.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -22,6 +22,48 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 #include "Tcg2Smm.h"
 
+typedef enum {
+  PtpInterfaceTis,
+  PtpInterfaceFifo,
+  PtpInterfaceCrb,
+  PtpInterfaceMax,
+} PTP_INTERFACE_TYPE;
+
+/**
+  Return PTP interface type.
+
+  @param[in] Register                Pointer to PTP register.
+
+  @return PTP interface type.
+**/
+PTP_INTERFACE_TYPE
+GetPtpInterface (
+  IN VOID *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+  PTP_FIFO_INTERFACE_CAPABILITY InterfaceCapability;
+
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  InterfaceCapability.Uint32 = MmioRead32 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->InterfaceCapability);
+
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_CRB) &&
+      (InterfaceId.Bits.CapCRB != 0)) {
+    return PtpInterfaceCrb;
+  }
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_FIFO) &&
+      (InterfaceId.Bits.CapFIFO != 0) &&
+      (InterfaceCapability.Bits.InterfaceVersion == INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP)) {
+    return PtpInterfaceFifo;
+  }
+  return PtpInterfaceTis;
+}
+
 EFI_TPM2_ACPI_TABLE  mTpm2AcpiTemplate = {
   {
     EFI_ACPI_5_0_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE,
@@ -288,6 +330,8 @@ PublishTpm2 (
   EFI_ACPI_TABLE_PROTOCOL        *AcpiTable;
   UINTN                          TableKey;
   UINT64                         OemTableId;
+  EFI_TPM2_ACPI_CONTROL_AREA     *ControlArea;
+  PTP_INTERFACE_TYPE             InterfaceType;
 
   //
   // Measure to PCR[0] with event EV_POST_CODE ACPI DATA
@@ -301,6 +345,24 @@ PublishTpm2 (
     sizeof(mTpm2AcpiTemplate)
     );
 
+  InterfaceType = GetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  switch (InterfaceType) {
+  case PtpInterfaceCrb:
+    mTpm2AcpiTemplate.StartMethod = EFI_TPM2_ACPI_TABLE_START_METHOD_COMMAND_RESPONSE_BUFFER_INTERFACE;
+    mTpm2AcpiTemplate.AddressOfControlArea = PcdGet64 (PcdTpmBaseAddress) + 0x40;
+    ControlArea = (EFI_TPM2_ACPI_CONTROL_AREA *)(UINTN)mTpm2AcpiTemplate.AddressOfControlArea;
+    ControlArea->CommandSize  = 0xF80;
+    ControlArea->ResponseSize = 0xF80;
+    ControlArea->Command      = PcdGet64 (PcdTpmBaseAddress) + 0x80;
+    ControlArea->Response     = PcdGet64 (PcdTpmBaseAddress) + 0x80;
+    break;
+  case PtpInterfaceFifo:
+  case PtpInterfaceTis:
+    break;
+  default:
+    break;
+  }
+
   CopyMem (mTpm2AcpiTemplate.Header.OemId, PcdGetPtr (PcdAcpiDefaultOemId), sizeof (mTpm2AcpiTemplate.Header.OemId));
   OemTableId = PcdGet64 (PcdAcpiDefaultOemTableId);
   CopyMem (&mTpm2AcpiTemplate.Header.OemTableId, &OemTableId, sizeof (UINT64));
diff --git a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.h b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.h
index ebd71edb772d..62374a2ee535 100644
--- a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.h
+++ b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.h
@@ -1,7 +1,7 @@
 /** @file
   The header file for Tcg2 SMM driver.
   
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -37,6 +37,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/TpmMeasurementLib.h>
 #include <Library/Tpm2DeviceLib.h>
 #include <Library/Tcg2PhysicalPresenceLib.h>
+#include <Library/IoLib.h>
+
+#include <IndustryStandard/TpmPtp.h>
 
 #pragma pack(1)
 typedef struct {
diff --git a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.inf b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.inf
index ef30ec79e0f3..0cc0cc689d6a 100644
--- a/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.inf
+++ b/SecurityPkg/Tcg/Tcg2Smm/Tcg2Smm.inf
@@ -9,7 +9,7 @@
 #  This driver will have external input - variable and ACPINvs data in SMM mode.
 #  This external input must be validated carefully to avoid security issue.
 #
-# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -50,6 +50,7 @@
   TpmMeasurementLib
   Tpm2DeviceLib
   Tcg2PhysicalPresenceLib
+  IoLib
 
 [Guids]
   ## SOMETIMES_PRODUCES ## Variable:L"MemoryOverwriteRequestControl"
@@ -70,6 +71,7 @@
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultOemRevision      ## SOMETIMES_CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorId        ## SOMETIMES_CONSUMES
   gEfiMdeModulePkgTokenSpaceGuid.PcdAcpiDefaultCreatorRevision  ## SOMETIMES_CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTpmBaseAddress               ## CONSUMES
 
 [Depex]
   gEfiAcpiTableProtocolGuid AND
diff --git a/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl b/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
index 2abd4af9ef61..776f43e972f9 100644
--- a/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
+++ b/SecurityPkg/Tcg/Tcg2Smm/Tpm.asl
@@ -2,7 +2,7 @@
   The TPM2 definition block in ACPI table for TCG2 physical presence  
   and MemoryClear.
 
-Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 

From ea96ffd805566199340640ae3c38690cb18c4cfb Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:30:35 +0000
Subject: [PATCH 425/525] SecurityPkg: Add TPM PTP detection in TPM12 device
 lib.

The TPM RequestUseTpm API can only set register to
use the hardware, but it can not be used to distinguish
TPM12 or TPM2 device.
TPM PTP defines same address with TIS, so we need
detect the TPM device is PTP or TIS in RequestUseTpm.
Also, Tcg2Config driver call RequestUseTpm to detect
TPM hardware device. So we have to add check here.
There is no need to support PTP CRB style SubmitCommand(),
because TPM2 device can not accept TPM12 style command.

This patch also uses TpmTis.h instead of duplicate
definition.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19742 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 8e997ab8d32ea9c4882912ad514e6a20901cf54e)
---
 .../Library/Tpm12DeviceLibDTpm/Tpm12Tis.c     | 281 ++++++++----------
 1 file changed, 122 insertions(+), 159 deletions(-)

diff --git a/SecurityPkg/Library/Tpm12DeviceLibDTpm/Tpm12Tis.c b/SecurityPkg/Library/Tpm12DeviceLibDTpm/Tpm12Tis.c
index 2fb360fa12c9..3d88030d254e 100644
--- a/SecurityPkg/Library/Tpm12DeviceLibDTpm/Tpm12Tis.c
+++ b/SecurityPkg/Library/Tpm12DeviceLibDTpm/Tpm12Tis.c
@@ -1,7 +1,7 @@
 /** @file
   TIS (TPM Interface Specification) functions used by TPM1.2.
   
-Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2013 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -22,164 +22,15 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <Library/Tpm12CommandLib.h>
 #include <Library/PcdLib.h>
 
-//
-// Set structure alignment to 1-byte
-//
-#pragma pack (1)
-
-//
-// Register set map as specified in TIS specification Chapter 10
-//
-typedef struct {
-  ///
-  /// Used to gain ownership for this particular port.
-  ///
-  UINT8                             Access;             // 0
-  UINT8                             Reserved1[7];       // 1
-  ///
-  /// Controls interrupts.
-  ///
-  UINT32                            IntEnable;          // 8
-  ///
-  /// SIRQ vector to be used by the TPM.
-  ///
-  UINT8                             IntVector;          // 0ch
-  UINT8                             Reserved2[3];       // 0dh
-  ///
-  /// What caused interrupt.
-  ///
-  UINT32                            IntSts;             // 10h
-  ///
-  /// Shows which interrupts are supported by that particular TPM.
-  ///
-  UINT32                            IntfCapability;     // 14h
-  ///
-  /// Status Register. Provides status of the TPM.
-  ///
-  UINT8                             Status;             // 18h
-  ///
-  /// Number of consecutive writes that can be done to the TPM.
-  ///
-  UINT16                            BurstCount;         // 19h
-  UINT8                             Reserved3[9];
-  ///
-  /// Read or write FIFO, depending on transaction.
-  ///
-  UINT32                            DataFifo;           // 24h
-  UINT8                             Reserved4[0xed8];   // 28h
-  ///
-  /// Vendor ID
-  ///
-  UINT16                            Vid;                // 0f00h
-  ///
-  /// Device ID
-  ///
-  UINT16                            Did;                // 0f02h
-  ///
-  /// Revision ID
-  ///
-  UINT8                             Rid;                // 0f04h
-  ///
-  /// TCG defined configuration registers.
-  ///
-  UINT8                             TcgDefined[0x7b];   // 0f05h
-  ///
-  /// Alias to I/O legacy space.
-  ///
-  UINT32                            LegacyAddress1;     // 0f80h
-  ///
-  /// Additional 8 bits for I/O legacy space extension.
-  ///
-  UINT32                            LegacyAddress1Ex;   // 0f84h
-  ///
-  /// Alias to second I/O legacy space.
-  ///
-  UINT32                            LegacyAddress2;     // 0f88h
-  ///
-  /// Additional 8 bits for second I/O legacy space extension.
-  ///
-  UINT32                            LegacyAddress2Ex;   // 0f8ch
-  ///
-  /// Vendor-defined configuration registers.
-  ///
-  UINT8                             VendorDefined[0x70];// 0f90h
-} TIS_PC_REGISTERS;
-
-//
-// Restore original structure alignment
-//
-#pragma pack ()
-
-//
-// Define pointer types used to access TIS registers on PC
-//
-typedef TIS_PC_REGISTERS  *TIS_PC_REGISTERS_PTR;
-
-//
-// Define bits of ACCESS and STATUS registers
-//
-
-///
-/// This bit is a 1 to indicate that the other bits in this register are valid.
-///
-#define TIS_PC_VALID                BIT7
-///
-/// Indicate that this locality is active.
-///
-#define TIS_PC_ACC_ACTIVE           BIT5
-///
-/// Set to 1 to indicate that this locality had the TPM taken away while
-/// this locality had the TIS_PC_ACC_ACTIVE bit set.
-///
-#define TIS_PC_ACC_SEIZED           BIT4
-///
-/// Set to 1 to indicate that TPM MUST reset the
-/// TIS_PC_ACC_ACTIVE bit and remove ownership for localities less than the
-/// locality that is writing this bit.
-///
-#define TIS_PC_ACC_SEIZE            BIT3
-///
-/// When this bit is 1, another locality is requesting usage of the TPM.
-///
-#define TIS_PC_ACC_PENDIND          BIT2
-///
-/// Set to 1 to indicate that this locality is requesting to use TPM.
-///
-#define TIS_PC_ACC_RQUUSE           BIT1
-///
-/// A value of 1 indicates that a T/OS has not been established on the platform
-///
-#define TIS_PC_ACC_ESTABLISH        BIT0
-
-///
-/// When this bit is 1, TPM is in the Ready state, 
-/// indicating it is ready to receive a new command.
-///
-#define TIS_PC_STS_READY            BIT6
-///
-/// Write a 1 to this bit to cause the TPM to execute that command.
-///
-#define TIS_PC_STS_GO               BIT5
-///
-/// This bit indicates that the TPM has data available as a response.
-///
-#define TIS_PC_STS_DATA             BIT4
-///
-/// The TPM sets this bit to a value of 1 when it expects another byte of data for a command.
-///
-#define TIS_PC_STS_EXPECT           BIT3
-///
-/// Writes a 1 to this bit to force the TPM to re-send the response.
-///
-#define TIS_PC_STS_RETRY            BIT1
+#include <IndustryStandard/TpmPtp.h>
+#include <IndustryStandard/TpmTis.h>
 
-//
-// Default TimeOut value
-//
-#define TIS_TIMEOUT_A               (750  * 1000)  // 750ms
-#define TIS_TIMEOUT_B               (2000 * 1000)  // 2s
-#define TIS_TIMEOUT_C               (750  * 1000)  // 750ms
-#define TIS_TIMEOUT_D               (750  * 1000)  // 750ms
+typedef enum {
+  PtpInterfaceTis,
+  PtpInterfaceFifo,
+  PtpInterfaceCrb,
+  PtpInterfaceMax,
+} PTP_INTERFACE_TYPE;
 
 //
 // Max TPM command/reponse length
@@ -550,6 +401,103 @@ Tpm12SubmitCommand (
            );
 }
 
+/**
+  Return PTP interface type.
+
+  @param[in] Register                Pointer to PTP register.
+
+  @return PTP interface type.
+**/
+PTP_INTERFACE_TYPE
+Tpm12GetPtpInterface (
+  IN VOID *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+  PTP_FIFO_INTERFACE_CAPABILITY InterfaceCapability;
+
+  if (!Tpm12TisPcPresenceCheck (Register)) {
+    return PtpInterfaceMax;
+  }
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  InterfaceCapability.Uint32 = MmioRead32 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->InterfaceCapability);
+
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_CRB) &&
+      (InterfaceId.Bits.CapCRB != 0)) {
+    return PtpInterfaceCrb;
+  }
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_FIFO) &&
+      (InterfaceId.Bits.CapFIFO != 0) &&
+      (InterfaceCapability.Bits.InterfaceVersion == INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP)) {
+    return PtpInterfaceFifo;
+  }
+  return PtpInterfaceTis;
+}
+
+/**
+  Check whether the value of a TPM chip register satisfies the input BIT setting.
+
+  @param[in]  Register     Address port of register to be checked.
+  @param[in]  BitSet       Check these data bits are set.
+  @param[in]  BitClear     Check these data bits are clear.
+  @param[in]  TimeOut      The max wait time (unit MicroSecond) when checking register.
+
+  @retval     EFI_SUCCESS  The register satisfies the check bit.
+  @retval     EFI_TIMEOUT  The register can't run into the expected status in time.
+**/
+EFI_STATUS
+Tpm12PtpCrbWaitRegisterBits (
+  IN      UINT32                    *Register,
+  IN      UINT32                    BitSet,
+  IN      UINT32                    BitClear,
+  IN      UINT32                    TimeOut
+  )
+{
+  UINT32                            RegRead;
+  UINT32                            WaitTime;
+
+  for (WaitTime = 0; WaitTime < TimeOut; WaitTime += 30){
+    RegRead = MmioRead32 ((UINTN)Register);
+    if ((RegRead & BitSet) == BitSet && (RegRead & BitClear) == 0) {
+      return EFI_SUCCESS;
+    }
+    MicroSecondDelay (30);
+  }
+  return EFI_TIMEOUT;
+}
+
+/**
+  Get the control of TPM chip.
+
+  @param[in] CrbReg                Pointer to CRB register.
+
+  @retval    EFI_SUCCESS           Get the control of TPM chip.
+  @retval    EFI_INVALID_PARAMETER CrbReg is NULL.
+  @retval    EFI_NOT_FOUND         TPM chip doesn't exit.
+  @retval    EFI_TIMEOUT           Can't get the TPM control in time.
+**/
+EFI_STATUS
+Tpm12PtpCrbRequestUseTpm (
+  IN      PTP_CRB_REGISTERS_PTR      CrbReg
+  )
+{
+  EFI_STATUS                        Status;
+
+  MmioWrite32((UINTN)&CrbReg->LocalityControl, PTP_CRB_LOCALITY_CONTROL_REQUEST_ACCESS);
+  Status = Tpm12PtpCrbWaitRegisterBits (
+             &CrbReg->LocalityStatus,
+             PTP_CRB_LOCALITY_STATUS_GRANTED,
+             0,
+             PTP_TIMEOUT_A
+             );
+  return Status;
+}
+
 /**
   This service requests use TPM12.
 
@@ -563,5 +511,20 @@ Tpm12RequestUseTpm (
   VOID
   )
 {
-  return Tpm12TisPcRequestUseTpm ((TIS_PC_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  PTP_INTERFACE_TYPE  PtpInterface;
+
+  //
+  // Special handle for TPM1.2 to check PTP too, because PTP/TIS share same register address.
+  // Some other program might leverage this function to check the existence of TPM chip.
+  //
+  PtpInterface = Tpm12GetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  switch (PtpInterface) {
+  case PtpInterfaceCrb:
+    return Tpm12PtpCrbRequestUseTpm ((PTP_CRB_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  case PtpInterfaceFifo:
+  case PtpInterfaceTis:
+    return Tpm12TisPcRequestUseTpm ((TIS_PC_REGISTERS_PTR) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+  default:
+    return EFI_NOT_FOUND;
+  }
 }

From cd7621f23a1c984459fa2ee52ee782bba1794ddf Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Tue, 26 Jan 2016 01:30:55 +0000
Subject: [PATCH 426/525] SecurityPkg: Add TPM PTP support in TCG2 Config.

This patch add PTP CRB support in BIOS Setup.
It can:
1) Display the PTP capability (TIS/FIFO/CRB)
2) Display the PTP current interface (TIS/FIFO/CRB)
3) Let user select CRB/FIFO, if supported.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19743 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 518b6f6565095f328bd90589874fb1abfee27afd)
---
 SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr     |  28 ++-
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDriver.c |  31 +--
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDxe.inf  |   4 +-
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c   | 221 +++++++++++++++++-
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h |  22 +-
 .../Tcg/Tcg2Config/Tcg2ConfigStrings.uni      | Bin 13376 -> 15732 bytes
 6 files changed, 281 insertions(+), 25 deletions(-)

diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr b/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
index b3504441d083..a72f8246d100 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2Config.vfr
@@ -1,7 +1,7 @@
 /** @file
   VFR file used by the TCG2 configuration component.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -51,6 +51,32 @@ formset
             option text = STRING_TOKEN(STR_TCG2_TPM_2_0_DTPM),     value = TPM_DEVICE_2_0_DTPM,     flags = RESET_REQUIRED;
     endoneof;
 
+    suppressif ideqvallist TCG2_CONFIGURATION.TpmDevice == TPM_DEVICE_NULL TPM_DEVICE_1_2;
+    text
+      help   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_STATE_HELP),
+      text   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_STATE_PROMPT),
+        text   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_STATE_CONTENT);
+
+    text
+      help   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_CAPABILITY_HELP),
+      text   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_CAPABILITY_PROMPT),
+        text   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_CAPABILITY_CONTENT);
+
+    suppressif ideqval TCG2_CONFIGURATION_INFO.TpmDeviceInterfacePtpFifoSupported == 0
+            OR ideqval TCG2_CONFIGURATION_INFO.TpmDeviceInterfacePtpCrbSupported == 0;
+    oneof varid  = TCG2_CONFIGURATION_INFO.TpmDeviceInterfaceAttempt,
+          questionid = KEY_TPM_DEVICE_INTERFACE,
+          prompt = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_PROMPT),
+          help   = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_HELP),
+          flags  = INTERACTIVE,
+            option text = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_TIS),          value = TPM_DEVICE_INTERFACE_TIS,          flags = RESET_REQUIRED;
+            option text = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_PTP_FIFO),     value = TPM_DEVICE_INTERFACE_PTP_FIFO,     flags = RESET_REQUIRED;
+            option text = STRING_TOKEN(STR_TCG2_DEVICE_INTERFACE_PTP_CRB),      value = TPM_DEVICE_INTERFACE_PTP_CRB,      flags = DEFAULT | MANUFACTURING | RESET_REQUIRED;
+    endoneof;
+    endif;
+
+    endif;
+
     subtitle text = STRING_TOKEN(STR_NULL);
 
     suppressif ideqvallist TCG2_CONFIGURATION.TpmDevice == TPM_DEVICE_NULL TPM_DEVICE_1_2;
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDriver.c b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDriver.c
index 881368345b82..968670f04d51 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDriver.c
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDriver.c
@@ -1,7 +1,7 @@
 /** @file
   The module entry point for Tcg2 configuration module.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -158,20 +158,6 @@ Tcg2ConfigDriverEntryPoint (
   PrivateData->PCRBanksDesired = CurrentActivePCRBanks;
   UpdateDefaultPCRBanks (Tcg2ConfigBin + sizeof(UINT32), ReadUnaligned32((UINT32 *)Tcg2ConfigBin) - sizeof(UINT32), CurrentActivePCRBanks);
 
-  //
-  // Save to variable so platform driver can get it.
-  //
-  Status = gRT->SetVariable (
-                  TCG2_STORAGE_NAME,
-                  &gTcg2ConfigFormSetGuid,
-                  EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS,
-                  sizeof(Tcg2Configuration),
-                  &Tcg2Configuration
-                  );
-  if (EFI_ERROR (Status)) {
-    DEBUG ((EFI_D_ERROR, "Tcg2ConfigDriver: Fail to set TCG2_STORAGE_NAME\n"));
-  }
-
   //
   // Sync data from PCD to variable, so that we do not need detect again in S3 phase.
   //
@@ -184,6 +170,7 @@ Tcg2ConfigDriverEntryPoint (
   }
 
   PrivateData->TpmDeviceDetected = Tcg2DeviceDetection.TpmDeviceDetected;
+  Tcg2Configuration.TpmDevice = Tcg2DeviceDetection.TpmDeviceDetected;
 
   //
   // Save to variable so platform driver can get it.
@@ -207,6 +194,20 @@ Tcg2ConfigDriverEntryPoint (
     ASSERT_EFI_ERROR (Status);
   }
 
+  //
+  // Save to variable so platform driver can get it.
+  //
+  Status = gRT->SetVariable (
+                  TCG2_STORAGE_NAME,
+                  &gTcg2ConfigFormSetGuid,
+                  EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                  sizeof(Tcg2Configuration),
+                  &Tcg2Configuration
+                  );
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "Tcg2ConfigDriver: Fail to set TCG2_STORAGE_NAME\n"));
+  }
+
   //
   // We should lock Tcg2DeviceDetection, because it contains information needed at S3.
   //
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDxe.inf b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDxe.inf
index ba76541bd94e..dd2247b957c7 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDxe.inf
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigDxe.inf
@@ -4,7 +4,7 @@
 #  By this module, user may select TPM device, clear TPM state, etc.
 #  NOTE: This module is only for reference only, each platform should have its own setup page.
 #
-# Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2015 - 2106, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution. The full text of the license may be found at
@@ -57,6 +57,7 @@
   Tpm2DeviceLib
   Tpm2CommandLib
   Tcg2PhysicalPresenceLib
+  IoLib
 
 [Guids]
   ## PRODUCES           ## HII
@@ -75,6 +76,7 @@
 [Pcd]
   gEfiSecurityPkgTokenSpaceGuid.PcdTpmInstanceGuid            ## CONSUMES
   gEfiSecurityPkgTokenSpaceGuid.PcdTcg2HashAlgorithmBitmap    ## CONSUMES
+  gEfiSecurityPkgTokenSpaceGuid.PcdTpmBaseAddress             ## CONSUMES
 
 [Depex]
   gEfiTcg2ProtocolGuid              AND
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
index 0d2956074a40..db38bd45a329 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigImpl.c
@@ -2,7 +2,7 @@
   HII Config Access protocol implementation of TCG2 configuration module.
   NOTE: This module is only for reference only, each platform should have its own setup page.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -16,8 +16,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include "Tcg2ConfigImpl.h"
 #include <Library/PcdLib.h>
 #include <Library/Tpm2CommandLib.h>
+#include <Library/IoLib.h>
 #include <Guid/TpmInstance.h>
 
+#include <IndustryStandard/TpmPtp.h>
+
 #define EFI_TCG2_EVENT_LOG_FORMAT_ALL   (EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2 | EFI_TCG2_EVENT_LOG_FORMAT_TCG_2)
 
 TPM_INSTANCE_ID  mTpmInstanceId[TPM_DEVICE_MAX + 1] = TPM_INSTANCE_ID_LIST;
@@ -56,6 +59,147 @@ HII_VENDOR_DEVICE_PATH          mTcg2HiiVendorDevicePath = {
 
 UINT8  mCurrentPpRequest;
 
+/**
+  Return PTP interface type.
+
+  @param[in] Register                Pointer to PTP register.
+
+  @return PTP interface type.
+**/
+UINT8
+GetPtpInterface (
+  IN VOID *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+  PTP_FIFO_INTERFACE_CAPABILITY InterfaceCapability;
+
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  InterfaceCapability.Uint32 = MmioRead32 ((UINTN)&((PTP_FIFO_REGISTERS *)Register)->InterfaceCapability);
+
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_CRB) &&
+      (InterfaceId.Bits.CapCRB != 0)) {
+    return TPM_DEVICE_INTERFACE_PTP_CRB;
+  }
+  if ((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO) &&
+      (InterfaceId.Bits.InterfaceVersion == PTP_INTERFACE_IDENTIFIER_INTERFACE_VERSION_FIFO) &&
+      (InterfaceId.Bits.CapFIFO != 0) &&
+      (InterfaceCapability.Bits.InterfaceVersion == INTERFACE_CAPABILITY_INTERFACE_VERSION_PTP)) {
+    return TPM_DEVICE_INTERFACE_PTP_FIFO;
+  }
+  return TPM_DEVICE_INTERFACE_TIS;
+}
+
+/**
+  Return if PTP CRB is supported.
+
+  @param[in] Register                Pointer to PTP register.
+  
+  @retval TRUE  PTP CRB is supported.
+  @retval FALSE PTP CRB is unsupported.
+**/
+BOOLEAN
+IsPtpCrbSupported (
+  IN VOID                 *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+
+  if (((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) ||
+       (InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO)) &&
+      (InterfaceId.Bits.CapCRB != 0)) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Return if PTP FIFO is supported.
+
+  @param[in] Register                Pointer to PTP register.
+  
+  @retval TRUE  PTP FIFO is supported.
+  @retval FALSE PTP FIFO is unsupported.
+**/
+BOOLEAN
+IsPtpFifoSupported (
+  IN VOID                 *Register
+  )
+{
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+
+  //
+  // Check interface id
+  //
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+
+  if (((InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_CRB) ||
+       (InterfaceId.Bits.InterfaceType == PTP_INTERFACE_IDENTIFIER_INTERFACE_TYPE_FIFO)) &&
+      (InterfaceId.Bits.CapFIFO != 0)) {
+    return TRUE;
+  }
+  return FALSE;
+}
+
+/**
+  Set PTP interface type.
+
+  @param[in] Register                Pointer to PTP register.
+  @param[in] PtpInterface            PTP interface type.
+  
+  @retval EFI_SUCCESS                PTP interface type is set.
+  @retval EFI_INVALID_PARAMETER      PTP interface type is invalid.
+  @retval EFI_UNSUPPORTED            PTP interface type is unsupported.
+  @retval EFI_WRITE_PROTECTED        PTP interface is locked.
+**/
+EFI_STATUS
+SetPtpInterface (
+  IN VOID                 *Register,
+  IN UINT8                PtpInterface
+  )
+{
+  UINT8                         PtpInterfaceCurrent;
+  PTP_CRB_INTERFACE_IDENTIFIER  InterfaceId;
+
+  PtpInterfaceCurrent = GetPtpInterface (Register);
+  if ((PtpInterfaceCurrent != TPM_DEVICE_INTERFACE_PTP_FIFO) && 
+      (PtpInterfaceCurrent != TPM_DEVICE_INTERFACE_PTP_CRB)) {
+    return EFI_UNSUPPORTED;
+  }
+  InterfaceId.Uint32 = MmioRead32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId);
+  if (InterfaceId.Bits.IntfSelLock != 0) {
+    return EFI_WRITE_PROTECTED;
+  }
+
+  switch (PtpInterface) {
+  case TPM_DEVICE_INTERFACE_PTP_FIFO:
+    if (InterfaceId.Bits.CapFIFO == 0) {
+      return EFI_UNSUPPORTED;
+    }
+    InterfaceId.Bits.InterfaceSelector = PTP_INTERFACE_IDENTIFIER_INTERFACE_SELECTOR_FIFO;
+    MmioWrite32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId, InterfaceId.Uint32);
+    return EFI_SUCCESS;
+  case TPM_DEVICE_INTERFACE_PTP_CRB:
+    if (InterfaceId.Bits.CapCRB == 0) {
+      return EFI_UNSUPPORTED;
+    }
+    InterfaceId.Bits.InterfaceSelector = PTP_INTERFACE_IDENTIFIER_INTERFACE_SELECTOR_CRB;
+    MmioWrite32 ((UINTN)&((PTP_CRB_REGISTERS *)Register)->InterfaceId, InterfaceId.Uint32);
+    return EFI_SUCCESS;
+  default:
+    return EFI_INVALID_PARAMETER;
+  }
+}
+
 /**
   This function allows a caller to extract the current configuration for one
   or more named elements from the target driver.
@@ -267,9 +411,27 @@ Tcg2Callback (
      OUT EFI_BROWSER_ACTION_REQUEST            *ActionRequest
   )
 {
+  EFI_INPUT_KEY               Key;
+
   if ((This == NULL) || (Value == NULL) || (ActionRequest == NULL)) {
     return EFI_INVALID_PARAMETER;
   }
+
+  if (Action == EFI_BROWSER_ACTION_CHANGING) {
+    if (QuestionId == KEY_TPM_DEVICE_INTERFACE) {
+      EFI_STATUS  Status;
+      Status = SetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress), Value->u8);
+      if (EFI_ERROR (Status)) {
+        CreatePopUp (
+          EFI_LIGHTGRAY | EFI_BACKGROUND_BLUE,
+          &Key,
+          L"Error: Fail to set PTP interface!",
+          NULL
+          );
+        return EFI_DEVICE_ERROR;
+      }
+    }
+  }
   
   if (Action == EFI_BROWSER_ACTION_CHANGED) {
     if (QuestionId == KEY_TPM_DEVICE) {
@@ -504,6 +666,7 @@ InstallTcg2ConfigForm (
   TPML_PCR_SELECTION              Pcrs;
   CHAR16                          TempBuffer[1024];
   TCG2_CONFIGURATION_INFO         Tcg2ConfigInfo;
+  UINT8                           TpmDeviceInterfaceDetected;
 
   DriverHandle = NULL;
   ConfigAccess = &PrivateData->ConfigAccess;
@@ -557,7 +720,7 @@ InstallTcg2ConfigForm (
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_STATE_CONTENT), L"TPM 1.2", NULL);
     break;
   case TPM_DEVICE_2_0_DTPM:
-    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_STATE_CONTENT), L"TPM 2.0 (DTPM)", NULL);
+    HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_STATE_CONTENT), L"TPM 2.0", NULL);
     break;
   default:
     HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_STATE_CONTENT), L"Unknown", NULL);
@@ -604,6 +767,60 @@ InstallTcg2ConfigForm (
   FillBufferWithBootHashAlg (TempBuffer, sizeof(TempBuffer), PrivateData->ProtocolCapability.ActivePcrBanks);
   HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_ACTIVE_PCR_BANKS_CONTENT), TempBuffer, NULL);
 
+  //
+  // Update TPM device interface type
+  //
+  if (PrivateData->TpmDeviceDetected == TPM_DEVICE_2_0_DTPM) {
+    TpmDeviceInterfaceDetected = GetPtpInterface ((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+    switch (TpmDeviceInterfaceDetected) {
+    case TPM_DEVICE_INTERFACE_TIS:
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_STATE_CONTENT), L"TIS", NULL);
+      break;
+    case TPM_DEVICE_INTERFACE_PTP_FIFO:
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_STATE_CONTENT), L"PTP FIFO", NULL);
+      break;
+    case TPM_DEVICE_INTERFACE_PTP_CRB:
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_STATE_CONTENT), L"PTP CRB", NULL);
+      break;
+     default:
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_STATE_CONTENT), L"Unknown", NULL);
+      break;
+    }
+
+    Tcg2ConfigInfo.TpmDeviceInterfaceAttempt = TpmDeviceInterfaceDetected;
+    switch (TpmDeviceInterfaceDetected) {
+    case TPM_DEVICE_INTERFACE_TIS:
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpFifoSupported = FALSE;
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpCrbSupported  = FALSE;
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_CAPABILITY_CONTENT), L"TIS", NULL);
+      break;
+    case TPM_DEVICE_INTERFACE_PTP_FIFO:
+    case TPM_DEVICE_INTERFACE_PTP_CRB:
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpFifoSupported = IsPtpFifoSupported((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpCrbSupported  = IsPtpCrbSupported((VOID *) (UINTN) PcdGet64 (PcdTpmBaseAddress));
+      TempBuffer[0] = 0;
+      if (Tcg2ConfigInfo.TpmDeviceInterfacePtpFifoSupported) {
+        if (TempBuffer[0] != 0) {
+          StrCatS (TempBuffer, sizeof(TempBuffer) / sizeof (CHAR16), L", ");
+        }
+        StrCatS (TempBuffer, sizeof(TempBuffer) / sizeof (CHAR16), L"PTP FIFO");
+      }
+      if (Tcg2ConfigInfo.TpmDeviceInterfacePtpCrbSupported) {
+        if (TempBuffer[0] != 0) {
+          StrCatS (TempBuffer, sizeof(TempBuffer) / sizeof (CHAR16), L", ");
+        }
+        StrCatS (TempBuffer, sizeof(TempBuffer) / sizeof (CHAR16), L"PTP CRB");
+      }
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_CAPABILITY_CONTENT), TempBuffer, NULL);
+      break;
+    default:
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpFifoSupported = FALSE;
+      Tcg2ConfigInfo.TpmDeviceInterfacePtpCrbSupported  = FALSE;
+      HiiSetString (PrivateData->HiiHandle, STRING_TOKEN (STR_TCG2_DEVICE_INTERFACE_CAPABILITY_CONTENT), L"Unknown", NULL);
+      break;
+    }
+  }
+
   //
   // Set ConfigInfo, to control the check box.
   //
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
index c6b3d32f49a4..20eaa508fad2 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigNvData.h
@@ -1,7 +1,7 @@
 /** @file
   Header file for NV data structure definition.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -40,6 +40,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define KEY_TPM2_PCR_BANKS_REQUEST_2            0x2005
 #define KEY_TPM2_PCR_BANKS_REQUEST_3            0x2006
 #define KEY_TPM2_PCR_BANKS_REQUEST_4            0x2007
+#define KEY_TPM_DEVICE_INTERFACE                       0x2008
 
 #define TPM_DEVICE_NULL           0
 #define TPM_DEVICE_1_2            1
@@ -48,6 +49,12 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #define TPM_DEVICE_MAX            TPM_DEVICE_2_0_DTPM
 #define TPM_DEVICE_DEFAULT        TPM_DEVICE_1_2
 
+#define TPM_DEVICE_INTERFACE_TIS       0
+#define TPM_DEVICE_INTERFACE_PTP_FIFO  1
+#define TPM_DEVICE_INTERFACE_PTP_CRB   2
+#define TPM_DEVICE_INTERFACE_MAX       TPM_DEVICE_INTERFACE_PTP_FIFO
+#define TPM_DEVICE_INTERFACE_DEFAULT   TPM_DEVICE_INTERFACE_PTP_CRB
+
 #define TCG2_PROTOCOL_VERSION_DEFAULT        0x0001
 #define EFI_TCG2_EVENT_LOG_FORMAT_DEFAULT    EFI_TCG2_EVENT_LOG_FORMAT_TCG_1_2
 
@@ -59,11 +66,14 @@ typedef struct {
 } TCG2_CONFIGURATION;
 
 typedef struct {
-  UINT8  Sha1Supported;
-  UINT8  Sha256Supported;
-  UINT8  Sha384Supported;
-  UINT8  Sha512Supported;
-  UINT8  Sm3Supported;
+  BOOLEAN  Sha1Supported;
+  BOOLEAN  Sha256Supported;
+  BOOLEAN  Sha384Supported;
+  BOOLEAN  Sha512Supported;
+  BOOLEAN  Sm3Supported;
+  UINT8    TpmDeviceInterfaceAttempt;
+  BOOLEAN  TpmDeviceInterfacePtpFifoSupported;
+  BOOLEAN  TpmDeviceInterfacePtpCrbSupported;
 } TCG2_CONFIGURATION_INFO;
 
 //
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigStrings.uni b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigStrings.uni
index be548b86ff6398647285519704c049b9ca2c38e1..e99fe9688047e42f6b91c35be6ba13bd39b28c5a 100644
GIT binary patch
delta 929
zcma))&q@Mu5XZljt!bKtgs23o1+J-Sf1xNtO;IS_%1bA+FbX0pywoAGC(z~zBoAG~
z7pOPr)@yX=0UBKvQ8(Gc?EZGx?|eV=oB6o>eW*39B0><cf(Vwe@%~yj(U&k~%^-_B
zk~l&NF<KSEbSk9nA~Lu^1tr|!0!5soM7MUohT>aMBs3J*V!u3BI!2IBGM{CBr#O>B
zt|ymZ|M))+En}D>t~AwV&9o#~)_aJNVD<t(V_Z9iIM?3i$m4{wGFQ#vpzTZ}roecI
zfa-$7uSF|zl_JU<XSl*OM+NsPlTW8BH6|VOD0#bHIo)2J`_g?&x`}Kq2fYQd?b+G-
zx}ccgp|TXAplP~GJZ$<ieHD<TLn+s*-_+{3y$iZ~8{qsjDx6VYu-%7qfP$yp*)*yy
zX2y8q)Va-T{i$#i)J>#@WyjXXrs_Sz^vc#2rCqD4Rx(vXsI_KpTIt!aK(c#+ew-qS
Zb9)qZZd1f9@wb<r+^!d+)QUPs-G4kEyDb0!

delta 38
ucmexTbs%HHl8u`taBeOWUc$?(z@Wk4!Vtm`z~IZEIa!cHb+etKnG66QA`6@V


From 072dd977d64d9c6ec051fbcb6318dff02bc5fbfd Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 27 Jan 2016 12:16:47 +0000
Subject: [PATCH 427/525] SecurityPkg: Correct data copy in Tpm2NvReadPublic.

1) NvPublic.dataSize data should be got from original
receive buffer, instead of returned NvPublic.

2) NvNameSize means the size of NvName without size field.
The original code treats it to be size of NvName with size
field, so the last 2 bytes are missing.

This patch fixed problem.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Zhang, Chao B" <chao.b.zhang@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19756 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit b1b1d6469964b61e710b08f25cbf01a7156d2ea5)
---
 SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c b/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
index 5fe48e180463..950802213232 100644
--- a/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
+++ b/SecurityPkg/Library/Tpm2CommandLib/Tpm2NVStorage.c
@@ -250,11 +250,11 @@ Tpm2NvReadPublic (
   NvPublic->nvPublic.nameAlg = SwapBytes16 (NvPublic->nvPublic.nameAlg);
   WriteUnaligned32 ((UINT32 *)&NvPublic->nvPublic.attributes, SwapBytes32 (ReadUnaligned32 ((UINT32 *)&NvPublic->nvPublic.attributes)));
   NvPublic->nvPublic.authPolicy.size = SwapBytes16 (NvPublic->nvPublic.authPolicy.size);
-  Buffer = (UINT8 *)&NvPublic->nvPublic.authPolicy;
+  Buffer = (UINT8 *)&RecvBuffer.NvPublic.nvPublic.authPolicy;
   Buffer += sizeof(UINT16) + NvPublic->nvPublic.authPolicy.size;
   NvPublic->nvPublic.dataSize = SwapBytes16 (ReadUnaligned16 ((UINT16 *)Buffer));
 
-  CopyMem (NvName, (UINT8 *)&RecvBuffer + sizeof(TPM2_RESPONSE_HEADER) + sizeof(UINT16) + NvPublicSize, NvNameSize);
+  CopyMem (NvName->name, (UINT8 *)&RecvBuffer + sizeof(TPM2_RESPONSE_HEADER) + sizeof(UINT16) + NvPublicSize + sizeof(UINT16), NvNameSize);
   NvName->size = NvNameSize;
   
   return EFI_SUCCESS;

From b1a0d7d86e24e392f7a449fe3038814a63bae5d6 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 29 Jan 2016 04:46:47 +0000
Subject: [PATCH 428/525] BaseTools: Fix the bug for VOID* Patchable PCD
 declaration in Library

VOID* Patchable PCD in Library has the different declaration from the
one in Driver, this issue that will cause GCC LTO build failure.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19766 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit d66670f9ea830c8f6e1f21b2deeca58128e3bfde)
---
 BaseTools/Source/Python/AutoGen/GenC.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/GenC.py b/BaseTools/Source/Python/AutoGen/GenC.py
index 93be71885097..3f0dfd90d9e2 100644
--- a/BaseTools/Source/Python/AutoGen/GenC.py
+++ b/BaseTools/Source/Python/AutoGen/GenC.py
@@ -1,7 +1,7 @@
 ## @file
 # Routines for generating AutoGen.h and AutoGen.c
 #
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -1099,7 +1099,8 @@ def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):
     Type = ''
     Array = ''
     if Pcd.DatumType == 'VOID*':
-        Type = '(VOID *)'
+        if Pcd.DefaultValue[0]== '{':
+            Type = '(VOID *)'
         Array = '[]'
     PcdItemType = Pcd.Type
     PcdExCNameList  = []
@@ -1161,7 +1162,15 @@ def CreateLibraryPcdCode(Info, AutoGenC, AutoGenH, Pcd):
                 AutoGenH.Append('#define %s(Value)  LibPcdSet%sS(%s, (Value))\n' % (SetModeStatusName, DatumSizeLib, PcdTokenName))
     if PcdItemType == TAB_PCDS_PATCHABLE_IN_MODULE:
         PcdVariableName = '_gPcd_' + gItemTypeStringDatabase[TAB_PCDS_PATCHABLE_IN_MODULE] + '_' + TokenCName
-        AutoGenH.Append('extern volatile %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType, TokenCName, Array) )
+        if DatumType == 'VOID*':
+            ArraySize = int(Pcd.MaxDatumSize, 0)
+            if Pcd.DefaultValue[0] == 'L':
+                ArraySize = ArraySize / 2
+            Array = '[%d]' % ArraySize
+            DatumType = ['UINT8', 'UINT16'][Pcd.DefaultValue[0] == 'L']
+            AutoGenH.Append('extern %s _gPcd_BinaryPatch_%s%s;\n' %(DatumType, TokenCName, Array))
+        else:
+            AutoGenH.Append('extern volatile  %s  %s%s;\n' % (DatumType, PcdVariableName, Array))
         AutoGenH.Append('#define %s  %s_gPcd_BinaryPatch_%s\n' %(GetModeName, Type, TokenCName))
         if Pcd.DatumType == 'VOID*':
             AutoGenH.Append('#define %s(SizeOfBuffer, Buffer)  LibPatchPcdSetPtrAndSize((VOID *)_gPcd_BinaryPatch_%s, &_gPcd_BinaryPatch_Size_%s, (UINTN)_PCD_PATCHABLE_%s_SIZE, (SizeOfBuffer), (Buffer))\n' % (SetModeName, Pcd.TokenCName, Pcd.TokenCName, Pcd.TokenCName))

From 7b9d00aca0221ca24190a5d899c6b58490674c99 Mon Sep 17 00:00:00 2001
From: Larry Hauch <larry.hauch@intel.com>
Date: Wed, 23 Dec 2015 18:30:20 +0000
Subject: [PATCH 429/525] BaseTools: Fix Makefile to correctly break during a
 build failure

Updated the Makefile so that nmake will correctly fail if the cxfreeze command fails to complete successfully.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Larry Hauch <larry.hauch@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19501 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 179475645373a6842b6da8739c469d8b99672319)
---
 BaseTools/Source/Python/Makefile | 40 ++++++++++++++++++--------------
 1 file changed, 23 insertions(+), 17 deletions(-)

diff --git a/BaseTools/Source/Python/Makefile b/BaseTools/Source/Python/Makefile
index d3f1baa83109..4eea515d9b9c 100644
--- a/BaseTools/Source/Python/Makefile
+++ b/BaseTools/Source/Python/Makefile
@@ -242,43 +242,49 @@ SetPythonPath:
   set PYTHONPATH=$(BASE_TOOLS_PATH)\Source\Python
 
 $(BIN_DIR)\build.exe: $(BASE_TOOLS_PATH)\Source\Python\build\build.py $(COMMON_PYTHON) $(CMD_BUILD) $(CMD_GENFDS)
-  @pushd . & @cd build & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) build.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) build\build.py
 
 $(BIN_DIR)\GenFds.exe: $(BASE_TOOLS_PATH)\Source\Python\GenFds\GenFds.py $(COMMON_PYTHON) $(CMD_GENFDS)
-  @pushd . & @cd GenFds & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) GenFds.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) GenFds\GenFds.py
 
 $(BIN_DIR)\Trim.exe: $(BASE_TOOLS_PATH)\Source\Python\Trim\Trim.py $(COMMON_PYTHON)
-  @pushd . & @cd Trim & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Trim.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Trim\Trim.py
 
 $(BIN_DIR)\GenDepex.exe: $(BASE_TOOLS_PATH)\Source\Python\AutoGen\GenDepex.py $(COMMON_PYTHON)
-  @pushd . & @cd AutoGen & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) GenDepex.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) AutoGen\GenDepex.py
 
 $(BIN_DIR)\TargetTool.exe: $(BASE_TOOLS_PATH)\Source\Python\TargetTool\TargetTool.py $(COMMON_PYTHON)
-  @pushd . & @cd TargetTool & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) TargetTool.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) TargetTool\TargetTool.py
 
 $(BIN_DIR)\GenPatchPcdTable.exe: $(BASE_TOOLS_PATH)\Source\Python\GenPatchPcdTable\GenPatchPcdTable.py $(COMMON_PYTHON)
-  @pushd . & @cd GenPatchPcdTable & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) GenPatchPcdTable.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) GenPatchPcdTable\GenPatchPcdTable.py
 
 $(BIN_DIR)\PatchPcdValue.exe: $(BASE_TOOLS_PATH)\Source\Python\PatchPcdValue\PatchPcdValue.py $(COMMON_PYTHON)
-  @pushd . & @cd PatchPcdValue & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) PatchPcdValue.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) PatchPcdValue\PatchPcdValue.py
 
 $(BIN_DIR)\BPDG.exe: $(BASE_TOOLS_PATH)\Source\Python\BPDG\BPDG.py $(COMMON_PYTHON) $(CMD_BPDG)
-  @pushd . & @cd BPDG & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) BPDG.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) BPDG\BPDG.py
 
 $(BIN_DIR)\UPT.exe: $(BASE_TOOLS_PATH)\Source\Python\UPT\UPT.py $(CMD_UPT)
-  @pushd . & @cd UPT & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) UPT.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) UPT\UPT.py
 
-$(BIN_DIR)\Rsa2048Sha256Sign.exe: $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\Rsa2048Sha256Sign.py
-  @pushd . & @cd Rsa2048Sha256Sign & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Rsa2048Sha256Sign.py & @popd
-  @pushd . & @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\TestSigningPrivateKey.pem $(BIN_DIR)\TestSigningPrivateKey.pem & @popd
+$(BIN_DIR)\Rsa2048Sha256Sign.exe: $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\Rsa2048Sha256Sign.py $(BIN_DIR)\TestSigningPrivateKey.pem
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Rsa2048Sha256Sign\Rsa2048Sha256Sign.py
+
+$(BIN_DIR)\TestSigningPrivateKey.pem: $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\TestSigningPrivateKey.pem
+  @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\TestSigningPrivateKey.pem $(BIN_DIR)\TestSigningPrivateKey.pem
   
 $(BIN_DIR)\Rsa2048Sha256GenerateKeys.exe: $(BASE_TOOLS_PATH)\Source\Python\Rsa2048Sha256Sign\Rsa2048Sha256GenerateKeys.py
-  @pushd . & @cd Rsa2048Sha256Sign & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Rsa2048Sha256GenerateKeys.py & @popd
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Rsa2048Sha256Sign\Rsa2048Sha256GenerateKeys.py
+
+$(BIN_DIR)\Ecc.exe: $(BASE_TOOLS_PATH)\Source\Python\Ecc\Ecc.py $(CMD_ECC) $(BIN_DIR)\config.ini $(BIN_DIR)\exception.xml
+  @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Ecc\Ecc.py
+
+$(BIN_DIR)\config.ini: $(BASE_TOOLS_PATH)\Source\Python\Ecc\config.ini
+  @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Ecc\config.ini $(BIN_DIR)\config.ini
 
-$(BIN_DIR)\Ecc.exe: $(BASE_TOOLS_PATH)\Source\Python\Ecc\Ecc.py $(CMD_ECC)
-  @pushd . & @cd Ecc & @$(FREEZE) --include-modules=$(MODULES) --install-dir=$(BIN_DIR) Ecc.py & @popd
-  @pushd . & @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Ecc\config.ini $(BIN_DIR)\config.ini & @popd
-  @pushd . & @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Ecc\exception.xml $(BIN_DIR)\exception.xml & @popd
+$(BIN_DIR)\exception.xml: $(BASE_TOOLS_PATH)\Source\Python\Ecc\exception.xml
+  @copy /Y /B $(BASE_TOOLS_PATH)\Source\Python\Ecc\exception.xml $(BIN_DIR)\exception.xml
   
 clean:
 cleanall:  

From c72f8b3ee6ad1936831f42b37a09065daad1e0eb Mon Sep 17 00:00:00 2001
From: Hess Chen <hesheng.chen@intel.com>
Date: Wed, 30 Dec 2015 02:22:02 +0000
Subject: [PATCH 430/525] BaseTool/ECC: Add UTF-8 support on ECC tool

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hess Chen <hesheng.chen@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19575 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 975889279df2eb3d3338cb88afb3faa71ddde4d6)
---
 .../Source/Python/Ecc/MetaFileWorkspace/MetaFileParser.py   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/BaseTools/Source/Python/Ecc/MetaFileWorkspace/MetaFileParser.py b/BaseTools/Source/Python/Ecc/MetaFileWorkspace/MetaFileParser.py
index 123d694939ec..aaea1ab3fc06 100644
--- a/BaseTools/Source/Python/Ecc/MetaFileWorkspace/MetaFileParser.py
+++ b/BaseTools/Source/Python/Ecc/MetaFileWorkspace/MetaFileParser.py
@@ -2000,9 +2000,11 @@ def __init__(self, FilePath, IsExtraUni=False, IsModuleUni=True):
     
     def __read(self):
         try:
-            self.FileIn = CodecOpenLongFilePath(self.FilePath, Mode = 'rb', Encoding = 'utf_16').read()
+            self.FileIn = CodecOpenLongFilePath(self.FilePath, Mode='rb', Encoding='utf_8').read()
         except UnicodeError:
-            self.FileIn = CodecOpenLongFilePath(self.FilePath, Mode = 'rb', Encoding = 'utf_16_le').read()
+            self.FileIn = CodecOpenLongFilePath(self.FilePath, Mode='rb', Encoding='utf_16').read()
+        except UnicodeError:
+            self.FileIn = CodecOpenLongFilePath(self.FilePath, Mode='rb', Encoding='utf_16_le').read()
         except IOError:
             self.FileIn = ""
     

From 0b68e5f3e0b8d751c3c9c68c306cc62ddc8b70cf Mon Sep 17 00:00:00 2001
From: Hess Chen <hesheng.chen@intel.com>
Date: Wed, 30 Dec 2015 02:22:30 +0000
Subject: [PATCH 431/525] BaseTool/UPT: Fix a typo issue

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hess Chen <hesheng.chen@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19576 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit bc003bc0769f2ad37700d34dfde83eac323b51c7)
---
 BaseTools/Source/Python/UPT/Logger/StringTable.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Source/Python/UPT/Logger/StringTable.py b/BaseTools/Source/Python/UPT/Logger/StringTable.py
index a481c6785d61..69e36f3b85c5 100644
--- a/BaseTools/Source/Python/UPT/Logger/StringTable.py
+++ b/BaseTools/Source/Python/UPT/Logger/StringTable.py
@@ -45,7 +45,7 @@
 MSG_COPYRIGHT = _("Copyright (c) 2011 - 2015 Intel Corporation All Rights Reserved.")
 MSG_VERSION_COPYRIGHT = _("\n  %s\n  %s" % (MSG_VERSION, MSG_COPYRIGHT))
 MSG_USAGE = _("%s [options]\n%s" % ("UPT", MSG_VERSION_COPYRIGHT))
-MSG_DESCRIPTION = _("The UEFIUPT is used to create, " + \
+MSG_DESCRIPTION = _("The UEFIPT is used to create, " + \
                     "install or remove a UEFI Distribution Package. " + \
                     "If WORKSPACE environment variable is present, " + \
                     "then UPT will install packages to the location specified by WORKSPACE, " + \

From 49cd7a23d8c2d4a4a2a2b58768dd73134d0576b5 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Mon, 4 Jan 2016 09:31:33 +0000
Subject: [PATCH 432/525] BaseTools CLANG35: use linux-gnu target triplets
 explicitly

Since we are combining Clang with the GNU linker, make that explicit in
the target triplet. This affects certain builtin defines and other compiler
behavior that may be unspecified otherwise.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19583 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit d4dcd5542a88eeee5a268284a4dfe026918f1720)
---
 BaseTools/Conf/tools_def.template | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index 6e26bbca934b..8d3f20999303 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -5183,9 +5183,12 @@ RELEASE_GCC49_AARCH64_CC_FLAGS   = DEF(GCC49_AARCH64_CC_FLAGS) -Wno-unused-but-s
 *_CLANG35_*_ASLCC_PATH           = ENV(CLANG35_BIN)clang
 *_CLANG35_*_ASLPP_PATH           = ENV(CLANG35_BIN)clang
 
+DEFINE CLANG35_ARM_TARGET        = -target armv7-none-linux-gnueabi
+DEFINE CLANG35_AARCH64_TARGET    = -target aarch64-none-linux-gnu
+
 DEFINE CLANG35_WARNING_OVERRIDES = -Wno-parentheses-equality -Wno-tautological-compare -Wno-tautological-constant-out-of-range-compare -Wno-empty-body
-DEFINE CLANG35_ARM_CC_FLAGS      = DEF(GCC_ARM_CC_FLAGS) -target armv7-a -mstrict-align -mllvm -arm-use-movt=0 DEF(CLANG35_WARNING_OVERRIDES)
-DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) -target aarch64 -mcmodel=small -mstrict-align DEF(CLANG35_WARNING_OVERRIDES)
+DEFINE CLANG35_ARM_CC_FLAGS      = DEF(GCC_ARM_CC_FLAGS) DEF(CLANG35_ARM_TARGET) -mstrict-align -mllvm -arm-use-movt=0 DEF(CLANG35_WARNING_OVERRIDES)
+DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) DEF(CLANG35_AARCH64_TARGET) -mcmodel=small -mstrict-align DEF(CLANG35_WARNING_OVERRIDES)
 
 ##################
 # CLANG35 ARM definitions
@@ -5197,7 +5200,7 @@ DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) -target aarch64 -mc
 
 *_CLANG35_ARM_ASLCC_FLAGS        = DEF(GCC_ASLCC_FLAGS)
 *_CLANG35_ARM_ASLDLINK_FLAGS     = DEF(GCC_ARM_ASLDLINK_FLAGS)
-*_CLANG35_ARM_ASM_FLAGS          = DEF(GCC_ASM_FLAGS) $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) -target armv7-a -Qunused-arguments
+*_CLANG35_ARM_ASM_FLAGS          = DEF(GCC_ASM_FLAGS) DEF(CLANG35_ARM_TARGET) $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) -Qunused-arguments
 *_CLANG35_ARM_DLINK_FLAGS        = DEF(GCC_ARM_DLINK_FLAGS)
 *_CLANG35_ARM_DLINK2_FLAGS       = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
 *_CLANG35_ARM_PLATFORM_FLAGS     =
@@ -5218,7 +5221,7 @@ RELEASE_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(P
 
 *_CLANG35_AARCH64_ASLCC_FLAGS    = DEF(GCC_ASLCC_FLAGS)
 *_CLANG35_AARCH64_ASLDLINK_FLAGS = DEF(GCC_AARCH64_ASLDLINK_FLAGS)
-*_CLANG35_AARCH64_ASM_FLAGS      = DEF(GCC_ASM_FLAGS) $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) -target aarch64 -Qunused-arguments
+*_CLANG35_AARCH64_ASM_FLAGS      = DEF(GCC_ASM_FLAGS) DEF(CLANG35_AARCH64_TARGET) $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) -Qunused-arguments
 *_CLANG35_AARCH64_DLINK_FLAGS    = DEF(GCC_AARCH64_DLINK_FLAGS) -z common-page-size=0x1000
 *_CLANG35_AARCH64_DLINK2_FLAGS   = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x228
 *_CLANG35_AARCH64_PLATFORM_FLAGS =

From 19bf0d12f54b5d40efdfe84266b64d2751d6d45e Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Mon, 4 Jan 2016 09:31:42 +0000
Subject: [PATCH 433/525] BaseTools CLANG35: use -target in PP flags as well

The Clang preprocessor may rely on builtin defines that are target
dependent, so we should add the -target argument also when invoking
the preprocessor directly.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19584 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit c2a892d7c8a78143006bb7fdc95fb18f7e2fc685)
---
 BaseTools/Conf/tools_def.template | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index 8d3f20999303..0cc85a6f359d 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -5169,9 +5169,7 @@ RELEASE_GCC49_AARCH64_CC_FLAGS   = DEF(GCC49_AARCH64_CC_FLAGS) -Wno-unused-but-s
 *_CLANG35_*_ASL_PATH             = DEF(UNIX_IASL_BIN)
 
 *_CLANG35_*_PP_FLAGS             = DEF(GCC_PP_FLAGS)
-*_CLANG35_*_ASLPP_FLAGS          = DEF(GCC_ASLPP_FLAGS)
 *_CLANG35_*_ASLCC_FLAGS          = DEF(GCC_ASLCC_FLAGS)
-*_CLANG35_*_VFRPP_FLAGS          = DEF(GCC_VFRPP_FLAGS)
 *_CLANG35_*_APP_FLAGS            =
 *_CLANG35_*_ASL_FLAGS            = DEF(IASL_FLAGS)
 *_CLANG35_*_ASL_OUTFLAGS         = DEF(IASL_OUTFLAGS)
@@ -5204,9 +5202,10 @@ DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) DEF(CLANG35_AARCH64
 *_CLANG35_ARM_DLINK_FLAGS        = DEF(GCC_ARM_DLINK_FLAGS)
 *_CLANG35_ARM_DLINK2_FLAGS       = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x220
 *_CLANG35_ARM_PLATFORM_FLAGS     =
-*_CLANG35_ARM_PP_FLAGS           = DEF(GCC_PP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_ARM_PP_FLAGS           = DEF(GCC_PP_FLAGS) DEF(CLANG35_ARM_TARGET) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
 *_CLANG35_ARM_RC_FLAGS           = DEF(GCC_ARM_RC_FLAGS)
-*_CLANG35_ARM_VFRPP_FLAGS        = DEF(GCC_VFRPP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_ARM_VFRPP_FLAGS        = DEF(GCC_VFRPP_FLAGS) DEF(CLANG35_ARM_TARGET) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_ARM_ASLPP_FLAGS        = DEF(GCC_ASLPP_FLAGS) DEF(CLANG35_ARM_TARGET)
 
   DEBUG_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -O0
 RELEASE_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -Oz
@@ -5225,9 +5224,10 @@ RELEASE_CLANG35_ARM_CC_FLAGS     = DEF(CLANG35_ARM_CC_FLAGS) $(ARCHCC_FLAGS) $(P
 *_CLANG35_AARCH64_DLINK_FLAGS    = DEF(GCC_AARCH64_DLINK_FLAGS) -z common-page-size=0x1000
 *_CLANG35_AARCH64_DLINK2_FLAGS   = DEF(GCC_DLINK2_FLAGS_COMMON) --defsym=PECOFF_HEADER_SIZE=0x228
 *_CLANG35_AARCH64_PLATFORM_FLAGS =
-*_CLANG35_AARCH64_PP_FLAGS       = DEF(GCC_PP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_AARCH64_PP_FLAGS       = DEF(GCC_PP_FLAGS) DEF(CLANG35_AARCH64_TARGET) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
 *_CLANG35_AARCH64_RC_FLAGS       = DEF(GCC_AARCH64_RC_FLAGS)
-*_CLANG35_AARCH64_VFRPP_FLAGS    = DEF(GCC_VFRPP_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_AARCH64_VFRPP_FLAGS    = DEF(GCC_VFRPP_FLAGS) DEF(CLANG35_AARCH64_TARGET) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS)
+*_CLANG35_AARCH64_ASLPP_FLAGS    = DEF(GCC_ASLPP_FLAGS) DEF(CLANG35_AARCH64_TARGET)
 
   DEBUG_CLANG35_AARCH64_CC_FLAGS = DEF(CLANG35_AARCH64_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -O0
 RELEASE_CLANG35_AARCH64_CC_FLAGS = DEF(CLANG35_AARCH64_CC_FLAGS) $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) -Oz

From 67031ab4e29e8a53b3a7a5180f86c902c5832e40 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 6 Jan 2016 01:13:35 +0000
Subject: [PATCH 434/525] BaseTools: Fix 'caculate' typos

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19604 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 64957e357bca8d1f9fec2fabaa7aa9a3a8721f1f)
---
 BaseTools/Source/C/GenBootSector/GenBootSector.c | 2 +-
 BaseTools/Source/C/GenFv/GenFvInternalLib.c      | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/C/GenBootSector/GenBootSector.c b/BaseTools/Source/C/GenBootSector/GenBootSector.c
index 40cb19fb59e1..c218548a4c49 100644
--- a/BaseTools/Source/C/GenBootSector/GenBootSector.c
+++ b/BaseTools/Source/C/GenBootSector/GenBootSector.c
@@ -278,7 +278,7 @@ GetBootSectorOffset (
 Description:
   Get the offset of boot sector.
   For non-MBR disk, offset is just 0
-  for disk with MBR, offset needs to be caculated by parsing MBR
+  for disk with MBR, offset needs to be calculated by parsing MBR
 
   NOTE: if no one is active, we will patch MBR to select first partition as active.
 
diff --git a/BaseTools/Source/C/GenFv/GenFvInternalLib.c b/BaseTools/Source/C/GenFv/GenFvInternalLib.c
index 10bb88b0a88c..6ab8a24d4e84 100644
--- a/BaseTools/Source/C/GenFv/GenFvInternalLib.c
+++ b/BaseTools/Source/C/GenFv/GenFvInternalLib.c
@@ -2787,7 +2787,7 @@ Routine Description:
   }
   
   //
-  // Caculate the required sizes for all FFS files.
+  // Calculate the required sizes for all FFS files.
   //
   CurrentOffset = sizeof (EFI_FIRMWARE_VOLUME_HEADER);
   
@@ -2904,7 +2904,7 @@ Routine Description:
     }
   }
   CurrentOffset += VtfFileSize;
-  DebugMsg (NULL, 0, 9, "FvImage size", "The caculated fv image size is 0x%x and the current set fv image size is 0x%x", (unsigned) CurrentOffset, (unsigned) FvInfoPtr->Size);
+  DebugMsg (NULL, 0, 9, "FvImage size", "The calculated fv image size is 0x%x and the current set fv image size is 0x%x", (unsigned) CurrentOffset, (unsigned) FvInfoPtr->Size);
   
   if (FvInfoPtr->Size == 0) { 
     //

From 425af91dc6963a04d87bbeea3b59ea42527bbdf5 Mon Sep 17 00:00:00 2001
From: Michael Thomas <malinka@entropy-development.com>
Date: Mon, 11 Jan 2016 07:42:03 +0000
Subject: [PATCH 435/525] BaseTools/VfrCompile: honor CC if it is set

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Thomas <malinka@entropy-development.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19636 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 819a2394f17f6e4e97893481e4acb95401e7b380)
---
 BaseTools/Source/C/VfrCompile/Pccts/dlg/makefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Source/C/VfrCompile/Pccts/dlg/makefile b/BaseTools/Source/C/VfrCompile/Pccts/dlg/makefile
index 406725d19503..dfcf3eebeb65 100644
--- a/BaseTools/Source/C/VfrCompile/Pccts/dlg/makefile
+++ b/BaseTools/Source/C/VfrCompile/Pccts/dlg/makefile
@@ -114,7 +114,7 @@ PCCTS_H=../h
 #
 #   UNIX
 #
-CC=cc
+CC?=cc
 COPT=-O
 ANTLR=${BIN_DIR}/antlr
 DLG=${BIN_DIR}/dlg

From 3c250f53fb2cc67e71341cfd6017b97cdfb12bd5 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Mon, 11 Jan 2016 08:50:39 +0000
Subject: [PATCH 436/525] BaseTools AARCH64: add separate GCC build rule for
 XIP objects

This introduces a special .c to .obj build rule for GCC/AARCH64 that
takes into account additional compiler flags that have been specified
via *_*_*_CC_XIPFLAGS. These will be passed after (and in addition to)
the ordinary CC_FLAGS.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19637 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 3a02a87f9f4dd5ba6741e64e20e5ab67fe4f303b)
---
 BaseTools/Conf/build_rule.template | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/BaseTools/Conf/build_rule.template b/BaseTools/Conf/build_rule.template
index 3637ef47414e..91bcc1828cb5 100644
--- a/BaseTools/Conf/build_rule.template
+++ b/BaseTools/Conf/build_rule.template
@@ -161,6 +161,19 @@
         "$(CC)" $(CC_FLAGS) -o ${dst} $(INC) ${src}
         "$(SYMRENAME)" $(SYMRENAME_FLAGS) ${dst}
 
+[C-Code-File.BASE.AARCH64,C-Code-File.SEC.AARCH64,C-Code-File.PEI_CORE.AARCH64,C-Code-File.PEIM.AARCH64]
+    <InputFile>
+        ?.c
+
+    <ExtraDependency>
+        $(MAKE_FILE)
+
+    <OutputFile>
+        $(OUTPUT_DIR)(+)${s_dir}(+)${s_base}.obj
+
+    <Command.GCC>
+        "$(CC)" $(CC_FLAGS) $(CC_XIPFLAGS) -o ${dst} $(INC) ${src}
+
 [C-Header-File]
     <InputFile>
         *.h, *.H

From 8c64675a3b4f8308434aa7ebd3e8e692e325d2f2 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Mon, 11 Jan 2016 08:50:49 +0000
Subject: [PATCH 437/525] BaseTools AARCH64: build XIP modules with strict
 alignment

GCC for AARCH64 recognizes byte swapping load and store sequences
and may replace them with wider loads or stores combined with rev
instructions. In some cases (i.e., with GCC version 5 and later)
this may result in unaligned accesses, which are not allowed before
we turn the MMU on.

So build any modules or static libraries that may execute with the MMU
off with -mstrict-align. Other modules don't need this switch, so we
can remove it from the CLANG35/AARCH64 common CC flags.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19638 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit d764d59849b782c11424f27c2148ecb057533a76)
---
 BaseTools/Conf/tools_def.template | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index 0cc85a6f359d..c42a434165c0 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -4324,6 +4324,7 @@ DEFINE GCC_X64_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mno-red-zone -Wno-ad
 DEFINE GCC_IPF_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -minline-int-divide-min-latency
 DEFINE GCC_ARM_CC_FLAGS            = DEF(GCC_ALL_CC_FLAGS) -mlittle-endian -mabi=aapcs -fno-short-enums -save-temps -fsigned-char -ffunction-sections -fdata-sections -fomit-frame-pointer -Wno-address -mthumb -mfloat-abi=soft
 DEFINE GCC_AARCH64_CC_FLAGS        = DEF(GCC_ALL_CC_FLAGS) -mlittle-endian -fno-short-enums -save-temps -fverbose-asm -fsigned-char  -ffunction-sections -fdata-sections -fomit-frame-pointer -fno-builtin -Wno-address -fno-asynchronous-unwind-tables
+DEFINE GCC_AARCH64_CC_XIPFLAGS     = -mstrict-align
 DEFINE GCC_DLINK_FLAGS_COMMON      = -nostdlib --pie
 DEFINE GCC_DLINK2_FLAGS_COMMON     = --script=$(EDK_TOOLS_PATH)/Scripts/GccBase.lds
 DEFINE GCC_IA32_X64_DLINK_COMMON   = DEF(GCC_DLINK_FLAGS_COMMON) --gc-sections
@@ -4398,6 +4399,7 @@ DEFINE GCC47_ARM_ASM_FLAGS           = DEF(GCC46_ARM_ASM_FLAGS)
 DEFINE GCC47_AARCH64_ASM_FLAGS       = $(ARCHASM_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_ASM_FLAGS) -mlittle-endian
 DEFINE GCC47_ARM_CC_FLAGS            = DEF(GCC46_ARM_CC_FLAGS) -mno-unaligned-access
 DEFINE GCC47_AARCH64_CC_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) -mcmodel=large DEF(GCC_AARCH64_CC_FLAGS)
+DEFINE GCC47_AARCH64_CC_XIPFLAGS     = DEF(GCC_AARCH64_CC_XIPFLAGS)
 DEFINE GCC47_ARM_DLINK_FLAGS         = DEF(GCC46_ARM_DLINK_FLAGS)
 DEFINE GCC47_ARM_DLINK2_FLAGS        = DEF(GCC46_ARM_DLINK2_FLAGS)
 DEFINE GCC47_AARCH64_DLINK_FLAGS     = DEF(GCC_AARCH64_DLINK_FLAGS)
@@ -4418,6 +4420,7 @@ DEFINE GCC48_ARM_ASM_FLAGS           = DEF(GCC47_ARM_ASM_FLAGS)
 DEFINE GCC48_AARCH64_ASM_FLAGS       = DEF(GCC47_AARCH64_ASM_FLAGS)
 DEFINE GCC48_ARM_CC_FLAGS            = DEF(GCC47_ARM_CC_FLAGS)
 DEFINE GCC48_AARCH64_CC_FLAGS        = DEF(GCC47_AARCH64_CC_FLAGS)
+DEFINE GCC48_AARCH64_CC_XIPFLAGS     = DEF(GCC47_AARCH64_CC_XIPFLAGS)
 DEFINE GCC48_ARM_DLINK_FLAGS         = DEF(GCC47_ARM_DLINK_FLAGS)
 DEFINE GCC48_ARM_DLINK2_FLAGS        = DEF(GCC47_ARM_DLINK2_FLAGS)
 DEFINE GCC48_AARCH64_DLINK_FLAGS     = DEF(GCC47_AARCH64_DLINK_FLAGS)
@@ -4438,6 +4441,7 @@ DEFINE GCC49_ARM_ASM_FLAGS           = DEF(GCC48_ARM_ASM_FLAGS)
 DEFINE GCC49_AARCH64_ASM_FLAGS       = DEF(GCC48_AARCH64_ASM_FLAGS)
 DEFINE GCC49_ARM_CC_FLAGS            = DEF(GCC48_ARM_CC_FLAGS)
 DEFINE GCC49_AARCH64_CC_FLAGS        = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC44_ALL_CC_FLAGS) -mcmodel=tiny DEF(GCC_AARCH64_CC_FLAGS)
+DEFINE GCC49_AARCH64_CC_XIPFLAGS     = DEF(GCC48_AARCH64_CC_XIPFLAGS)
 DEFINE GCC49_ARM_DLINK_FLAGS         = DEF(GCC48_ARM_DLINK_FLAGS)
 DEFINE GCC49_ARM_DLINK2_FLAGS        = DEF(GCC48_ARM_DLINK2_FLAGS)
 DEFINE GCC49_AARCH64_DLINK_FLAGS     = DEF(GCC48_AARCH64_DLINK_FLAGS)
@@ -4897,6 +4901,7 @@ RELEASE_GCC47_ARM_CC_FLAGS       = DEF(GCC47_ARM_CC_FLAGS) -Wno-unused-but-set-v
 *_GCC47_AARCH64_PP_FLAGS         = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC47_AARCH64_RC_FLAGS         = DEF(GCC_AARCH64_RC_FLAGS)
 *_GCC47_AARCH64_VFRPP_FLAGS      = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_VFRPP_FLAGS)
+*_GCC47_AARCH64_CC_XIPFLAGS      = DEF(GCC47_AARCH64_CC_XIPFLAGS)
 
   DEBUG_GCC47_AARCH64_CC_FLAGS   = DEF(GCC47_AARCH64_CC_FLAGS) -O0
 RELEASE_GCC47_AARCH64_CC_FLAGS   = DEF(GCC47_AARCH64_CC_FLAGS) -Wno-unused-but-set-variable
@@ -5024,6 +5029,7 @@ RELEASE_GCC48_ARM_CC_FLAGS       = DEF(GCC48_ARM_CC_FLAGS) -Wno-unused-but-set-v
 *_GCC48_AARCH64_PP_FLAGS         = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC48_AARCH64_RC_FLAGS         = DEF(GCC_AARCH64_RC_FLAGS)
 *_GCC48_AARCH64_VFRPP_FLAGS      = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_VFRPP_FLAGS)
+*_GCC48_AARCH64_CC_XIPFLAGS      = DEF(GCC48_AARCH64_CC_XIPFLAGS)
 
   DEBUG_GCC48_AARCH64_CC_FLAGS   = DEF(GCC48_AARCH64_CC_FLAGS) -O0
 RELEASE_GCC48_AARCH64_CC_FLAGS   = DEF(GCC48_AARCH64_CC_FLAGS) -Wno-unused-but-set-variable
@@ -5151,6 +5157,7 @@ RELEASE_GCC49_ARM_CC_FLAGS       = DEF(GCC49_ARM_CC_FLAGS) -Wno-unused-but-set-v
 *_GCC49_AARCH64_PP_FLAGS         = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_PP_FLAGS)
 *_GCC49_AARCH64_RC_FLAGS         = DEF(GCC_AARCH64_RC_FLAGS)
 *_GCC49_AARCH64_VFRPP_FLAGS      = $(ARCHCC_FLAGS) $(PLATFORM_FLAGS) DEF(GCC_VFRPP_FLAGS)
+*_GCC49_AARCH64_CC_XIPFLAGS      = DEF(GCC49_AARCH64_CC_XIPFLAGS)
 
   DEBUG_GCC49_AARCH64_CC_FLAGS   = DEF(GCC49_AARCH64_CC_FLAGS) -O0
 RELEASE_GCC49_AARCH64_CC_FLAGS   = DEF(GCC49_AARCH64_CC_FLAGS) -Wno-unused-but-set-variable
@@ -5186,7 +5193,7 @@ DEFINE CLANG35_AARCH64_TARGET    = -target aarch64-none-linux-gnu
 
 DEFINE CLANG35_WARNING_OVERRIDES = -Wno-parentheses-equality -Wno-tautological-compare -Wno-tautological-constant-out-of-range-compare -Wno-empty-body
 DEFINE CLANG35_ARM_CC_FLAGS      = DEF(GCC_ARM_CC_FLAGS) DEF(CLANG35_ARM_TARGET) -mstrict-align -mllvm -arm-use-movt=0 DEF(CLANG35_WARNING_OVERRIDES)
-DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) DEF(CLANG35_AARCH64_TARGET) -mcmodel=small -mstrict-align DEF(CLANG35_WARNING_OVERRIDES)
+DEFINE CLANG35_AARCH64_CC_FLAGS  = DEF(GCC_AARCH64_CC_FLAGS) DEF(CLANG35_AARCH64_TARGET) -mcmodel=small DEF(CLANG35_WARNING_OVERRIDES)
 
 ##################
 # CLANG35 ARM definitions

From f4b872f4e7439e77ec92d5a7684de01096790ed6 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Mon, 18 Jan 2016 01:42:20 +0000
Subject: [PATCH 438/525] BaseTools: Fix GenPatchPcdTable to support '-'
 characters in file names

The Regular Expression parsing of lines in MAP files does not currently
support the use of '-' in the column for the filename the symbol is
sources from, it cause a build break from the GenPatchPcdTable.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19649 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 8b54f22f60d1ecdfc4beb1f0965b52f7063b93ad)
---
 BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py b/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
index 36e539f67458..59bc7c4c3e29 100644
--- a/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
+++ b/BaseTools/Source/Python/GenPatchPcdTable/GenPatchPcdTable.py
@@ -37,7 +37,7 @@
 
 #============================================== Code ===============================================
 secRe = re.compile('^([\da-fA-F]+):([\da-fA-F]+) +([\da-fA-F]+)[Hh]? +([.\w\$]+) +(\w+)', re.UNICODE)
-symRe = re.compile('^([\da-fA-F]+):([\da-fA-F]+) +([\.:\\\\\w\?@\$]+) +([\da-fA-F]+)', re.UNICODE)
+symRe = re.compile('^([\da-fA-F]+):([\da-fA-F]+) +([\.\-:\\\\\w\?@\$]+) +([\da-fA-F]+)', re.UNICODE)
 
 def parsePcdInfoFromMapFile(mapfilepath, efifilepath):
     """ Parse map file to get binary patch pcd information 

From 705dc80054346b44f81316786e178251f6b2752d Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Mon, 18 Jan 2016 01:46:25 +0000
Subject: [PATCH 439/525] BaseTools: VOID* PCDs in VPD region must be aligned
 based on value type
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Base on build spec update, ASCII strings(“string”), will be byte aligned,
Unicode strings(L”string”) will be two-byte aligned, Byte arrays,
{0x00, 0x01} will be 8-byte aligned.
This patch is going to halt with an error message if a VOID* PCD has an
offset value that is not aligned based on the syntax of the PCD value.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19650 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5a13737abf9d12d99a15961fa94716b507c701a2)
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index 4c627dfb555a..abac47758d36 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -317,6 +317,11 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
             GlobalData.gFdfParser = Fdf
             GlobalData.gAutoGenPhase = False
             PcdSet = Fdf.Profile.PcdDict
+            FdDict = Fdf.Profile.FdDict[Fdf.CurrentFdName]
+            for FdRegion in FdDict.RegionList:
+                if str(FdRegion.RegionType) is 'FILE' and self.Platform.VpdToolGuid in str(FdRegion.RegionDataList):
+                    if int(FdRegion.Offset) % 8 != 0:
+                        EdkLogger.error("build", FORMAT_INVALID, 'The VPD Base Address %s must be 8-byte aligned.' % (FdRegion.Offset))
             ModuleList = Fdf.Profile.InfList
             self.FdfProfile = Fdf.Profile
             for fvname in self.FvTargetList:
@@ -1138,6 +1143,18 @@ def CollectPlatformDynamicPcds(self):
                     Pcd = VpdPcdDict[PcdKey]
                     for (SkuName,Sku) in Pcd.SkuInfoList.items():
                         Sku.VpdOffset = Sku.VpdOffset.strip()
+                        PcdValue = Sku.DefaultValue
+                        if PcdValue == "":
+                            PcdValue  = Pcd.DefaultValue
+                        if Sku.VpdOffset != '*':
+                            if PcdValue.startswith("{"):
+                                Alignment = 8
+                            elif PcdValue.startswith("L"):
+                                Alignment = 2
+                            else:
+                                Alignment = 1
+                            if int(Sku.VpdOffset) % Alignment != 0:
+                                EdkLogger.error("build", FORMAT_INVALID, 'The offset value of PCD %s.%s should be %s-byte aligned.' % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName, Alignment))
                         VpdFile.Add(Pcd, Sku.VpdOffset)
                         # if the offset of a VPD is *, then it need to be fixed up by third party tool.
                         if not NeedProcessVpdMapFile and Sku.VpdOffset == "*":
@@ -1193,6 +1210,17 @@ def CollectPlatformDynamicPcds(self):
 #                                Sku = DscPcdEntry.SkuInfoList[DscPcdEntry.SkuInfoList.keys()[0]]
                                 Sku.VpdOffset = Sku.VpdOffset.strip()
                                 PcdValue = Sku.DefaultValue
+                                if PcdValue == "":
+                                    PcdValue  = DscPcdEntry.DefaultValue
+                                if Sku.VpdOffset != '*':
+                                    if PcdValue.startswith("{"):
+                                        Alignment = 8
+                                    elif PcdValue.startswith("L"):
+                                        Alignment = 2
+                                    else:
+                                        Alignment = 1
+                                    if int(Sku.VpdOffset) % Alignment != 0:
+                                        EdkLogger.error("build", FORMAT_INVALID, 'The offset value of PCD %s.%s should be %s-byte aligned.' % (DscPcdEntry.TokenSpaceGuidCName, DscPcdEntry.TokenCName, Alignment))
                                 VpdFile.Add(DscPcdEntry, Sku.VpdOffset)
                                 if not NeedProcessVpdMapFile and Sku.VpdOffset == "*":
                                     NeedProcessVpdMapFile = True 

From af9a5cc9403b6be29071656e033866a675645286 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Mon, 18 Jan 2016 01:47:50 +0000
Subject: [PATCH 440/525] BaseTools: VPD Tool to allocate VPD region be aligned
 based on value type
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Base on build spec update, ASCII strings(“string”), will be byte aligned,
Unicode strings(L”string”) will be two-byte aligned, Byte arrays,
{0x00, 0x01} will be 8-byte aligned.
This patch is going to update VPD Tool to allocate VOID* PCDs to an offset
value that is aligned based in syntax of the PCD value.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19651 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 22061fab23a2bc9bf39cb3d1bd0ff0f1264d3859)
---
 BaseTools/Source/Python/BPDG/GenVpd.py | 38 ++++++++++++++++++--------
 1 file changed, 26 insertions(+), 12 deletions(-)

diff --git a/BaseTools/Source/Python/BPDG/GenVpd.py b/BaseTools/Source/Python/BPDG/GenVpd.py
index d1da99fe5faa..ee7e04295f12 100644
--- a/BaseTools/Source/Python/BPDG/GenVpd.py
+++ b/BaseTools/Source/Python/BPDG/GenVpd.py
@@ -344,7 +344,7 @@ def ParserInputFile (self):
                 #
                 # Enhanced for support "|" character in the string.
                 #
-                ValueList = ['', '', '', '','']    
+                ValueList = ['', '', '', '','']
 
                 ValueRe = re.compile(r'\s*L?\".*\|.*\"\s*$')
                 PtrValue = ValueRe.findall(line)
@@ -359,7 +359,7 @@ def ParserInputFile (self):
                 ValueList[0:len(TokenList)] = TokenList
 
                 if ValueUpdateFlag:
-                    ValueList[4] = PtrValue[0]                              
+                    ValueList[4] = PtrValue[0]
                 self.FileLinesList[count] = ValueList
                 # Store the line number
                 self.FileLinesList[count].append(str(count + 1))
@@ -400,14 +400,28 @@ def ParserInputFile (self):
                 PCD.SkuId        = PCD.SkuId.strip(' ')
                 PCD.PcdOffset    = PCD.PcdOffset.strip(' ')
                 PCD.PcdSize      = PCD.PcdSize.strip(' ')
-                PCD.PcdValue     = PCD.PcdValue.strip(' ')               
+                PCD.PcdValue     = PCD.PcdValue.strip(' ')
                 PCD.Lineno       = PCD.Lineno.strip(' ')
-                                      
+
                 #
                 # Store the original pcd value.
                 # This information will be useful while generate the output map file.
                 #
-                PCD.PcdUnpackValue    =  str(PCD.PcdValue)                              
+                PCD.PcdUnpackValue    =  str(PCD.PcdValue)
+
+                #
+                # If value is Unicode string (e.g. L""), then use 2-byte alignment
+                # If value is byte array (e.g. {}), then use 8-byte alignment
+                #
+                PCD.PcdOccupySize     =  int(PCD.PcdSize)
+                if PCD.PcdUnpackValue.startswith("{"):
+                    Alignment = 8
+                elif PCD.PcdUnpackValue.startswith("L"):
+                    Alignment = 2
+                else:
+                    Alignment = 1
+                if PCD.PcdOccupySize % Alignment != 0:
+                    PCD.PcdOccupySize = (PCD.PcdOccupySize / Alignment + 1) * Alignment
 
                 #
                 # Translate PCD size string to an integer value.
@@ -490,7 +504,7 @@ def FixVpdOffset (self):
             for Pcd in self.PcdUnknownOffsetList :
                 Pcd.PcdBinOffset = NowOffset
                 Pcd.PcdOffset    = str(hex(Pcd.PcdBinOffset))
-                NowOffset       += Pcd.PcdBinSize
+                NowOffset       += Pcd.PcdOccupySize
                 
             self.PcdFixedOffsetSizeList = self.PcdUnknownOffsetList
             return
@@ -514,14 +528,14 @@ def FixVpdOffset (self):
                                 None)
 
             # Overlapped   
-            if PcdNow.PcdBinOffset + PcdNow.PcdBinSize > PcdNext.PcdBinOffset :
+            if PcdNow.PcdBinOffset + PcdNow.PcdOccupySize > PcdNext.PcdBinOffset :
                 EdkLogger.error("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE,
                                 "The offset of %s at line: %s is overlapped with %s at line: %s in file %s" % \
                                 (PcdNow.PcdCName, PcdNow.Lineno, PcdNext.PcdCName, PcdNext.Lineno, PcdNext.FileName),
                                 None)
 
             # Has free space, raise a warning message   
-            if PcdNow.PcdBinOffset + PcdNow.PcdBinSize < PcdNext.PcdBinOffset :
+            if PcdNow.PcdBinOffset + PcdNow.PcdOccupySize < PcdNext.PcdBinOffset :
                 EdkLogger.warn("BPDG", BuildToolError.ATTRIBUTE_GET_FAILURE,
                                "The offsets have free space of between %s at line: %s and %s at line: %s in file %s" % \
                                (PcdNow.PcdCName, PcdNow.Lineno, PcdNext.PcdCName, PcdNext.Lineno, PcdNext.FileName),
@@ -547,7 +561,7 @@ def FixVpdOffset (self):
                     countOfUnfixedList = 0
                     while(countOfUnfixedList < lenOfUnfixedList) :
                         eachUnfixedPcd      = self.PcdUnknownOffsetList[countOfUnfixedList]
-                        needFixPcdSize      = eachUnfixedPcd.PcdBinSize
+                        needFixPcdSize      = eachUnfixedPcd.PcdOccupySize
                         # Not been fixed
                         if eachUnfixedPcd.PcdOffset == '*' :
                             # The offset un-fixed pcd can write into this free space
@@ -572,7 +586,7 @@ def FixVpdOffset (self):
                                 LastOffset              += needFixPcdSize                            
                             else :
                                 # It can not insert into those two pcds, need to check still has other space can store it.
-                                LastOffset             = NowOffset + self.PcdFixedOffsetSizeList[FixOffsetSizeListCount].PcdBinSize
+                                LastOffset             = NowOffset + self.PcdFixedOffsetSizeList[FixOffsetSizeListCount].PcdOccupySize
                                 FixOffsetSizeListCount += 1
                                 break
                                                                                  
@@ -582,7 +596,7 @@ def FixVpdOffset (self):
                         
             # No free space, smoothly connect with previous pcd. 
             elif LastOffset == NowOffset :
-                LastOffset = NowOffset + eachFixedPcd.PcdBinSize
+                LastOffset = NowOffset + eachFixedPcd.PcdOccupySize
                 FixOffsetSizeListCount += 1
             # Usually it will not enter into this thunk, if so, means it overlapped. 
             else :
@@ -601,7 +615,7 @@ def FixVpdOffset (self):
             LastPcd    = self.PcdFixedOffsetSizeList[lenOfList-1]
             NeedFixPcd = self.PcdUnknownOffsetList[0]
             
-            NeedFixPcd.PcdBinOffset = LastPcd.PcdBinOffset + LastPcd.PcdBinSize
+            NeedFixPcd.PcdBinOffset = LastPcd.PcdBinOffset + LastPcd.PcdOccupySize
             NeedFixPcd.PcdOffset    = str(hex(NeedFixPcd.PcdBinOffset))
             
             # Insert this pcd into fixed offset pcd list's tail.

From 4824064e426d0cb6e80569e36cd16c8656beae57 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 19 Jan 2016 12:58:52 +0000
Subject: [PATCH 441/525] BaseTools: process the files by the priority in
 BUILDRULEORDER

By the BUILDRULEORDER feature to process files listed in INF [Sources]
sections in priority order, if a filename is listed with multiple
extensions, the tools will use only the file that matches the first
extension in the space separated list.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19686 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 4cb7bade0abdbbd4658ee2343c82ae050018e635)
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 29 +++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index abac47758d36..e9f4888aa199 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -1,7 +1,7 @@
 ## @file
 # Generate AutoGen.h, AutoGen.c and *.depex files
 #
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -2741,9 +2741,36 @@ def _GetSourceFileList(self):
                 if F.Dir not in self.IncludePathList and self.AutoGenVersion >= 0x00010005:
                     self.IncludePathList.insert(0, F.Dir)
                 self._SourceFileList.append(F)
+
+            self._MatchBuildRuleOrder(self._SourceFileList)
+
+            for F in self._SourceFileList:
                 self._ApplyBuildRule(F, TAB_UNKNOWN_FILE)
         return self._SourceFileList
 
+    def _MatchBuildRuleOrder(self, FileList):
+        Order_Dict = {}
+        self._GetModuleBuildOption()
+        for SingleFile in FileList:
+            if self.BuildRuleOrder and SingleFile.Ext in self.BuildRuleOrder and SingleFile.Ext in self.BuildRules:
+                key = SingleFile.Path.split(SingleFile.Ext)[0]
+                if key in Order_Dict:
+                    Order_Dict[key].append(SingleFile.Ext)
+                else:
+                    Order_Dict[key] = [SingleFile.Ext]
+
+        RemoveList = []
+        for F in Order_Dict:
+            if len(Order_Dict[F]) > 1:
+                Order_Dict[F].sort(key=lambda i: self.BuildRuleOrder.index(i))
+                for Ext in Order_Dict[F][1:]:
+                    RemoveList.append(F + Ext)
+                   
+        for item in RemoveList:
+            FileList.remove(item)
+
+        return FileList
+
     ## Return the list of unicode files
     def _GetUnicodeFileList(self):
         if self._UnicodeFileList == None:

From e1247f987263db48852e2f1bf131e1c9588a8db5 Mon Sep 17 00:00:00 2001
From: Charles Duffy <chaduffy@cisco.com>
Date: Wed, 20 Jan 2016 05:09:06 +0000
Subject: [PATCH 442/525] BaseTools: Improve shell wrappers for Python build
 commands

- Use `python2` executable if it exists, to avoid breakage on systems (such as
  Arch Linux) where `python` is Python 3.
- Quote all references to `$0`, for safety when located in a directory
  containing spaces in its name.
- Use the `exec` shell command to avoid leaving the shell wrapper in the
  process table when invoking the actual build tool.
- Use `"$@"` rather than `$*` to pass arguments through directly rather than
  concatenating to a string, and then string-splitting and glob-expanding its
  contents.
- Use `$BASH_SOURCE` in preference to `$0` (which is only guaranteed to be
  process name, *not* source path).

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Charles Duffy <chaduffy@cisco.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19694 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 6928c1d3eed8fb3ab0b136f0ebdcef50f7bda2f3)
---
 BaseTools/Bin/CYGWIN_NT-5.1-i686/Ecc             | 13 +++++++++++--
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenDepex        | 15 +++++++++++++--
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFds          | 13 +++++++++++--
 BaseTools/Bin/CYGWIN_NT-5.1-i686/TargetTool      | 13 +++++++++++--
 BaseTools/Bin/CYGWIN_NT-5.1-i686/Trim            | 13 +++++++++++--
 BaseTools/Bin/CYGWIN_NT-5.1-i686/build           | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/BPDG             | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/Ecc              | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/GenDepex         | 15 +++++++++++++--
 BaseTools/BinWrappers/PosixLike/GenFds           | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/GenPatchPcdTable | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/PatchPcdValue    | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/TargetTool       | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/Trim             | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/UPT              | 13 +++++++++++--
 BaseTools/BinWrappers/PosixLike/build            | 13 +++++++++++--
 16 files changed, 180 insertions(+), 32 deletions(-)

diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Ecc b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Ecc
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Ecc
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Ecc
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenDepex b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenDepex
index bd3141a758a8..214d88fff1b1 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenDepex
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenDepex
@@ -1,3 +1,14 @@
 #!/usr/bin/env bash
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/AutoGen/`basename $0`.py $*
+#python `dirname $0`/RunToolFromSource.py `basename $0` $*
+
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFds b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFds
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFds
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFds
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/TargetTool b/BaseTools/Bin/CYGWIN_NT-5.1-i686/TargetTool
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/TargetTool
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/TargetTool
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Trim b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Trim
index 2cb8b86a9931..7cac4f7c4fff 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Trim
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Trim
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+exe=$(basename "$full_cmd")
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$exe/$exe.py" "$@"
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/build b/BaseTools/Bin/CYGWIN_NT-5.1-i686/build
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/build
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/build
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/BPDG b/BaseTools/BinWrappers/PosixLike/BPDG
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/BPDG
+++ b/BaseTools/BinWrappers/PosixLike/BPDG
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/Ecc b/BaseTools/BinWrappers/PosixLike/Ecc
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/Ecc
+++ b/BaseTools/BinWrappers/PosixLike/Ecc
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/GenDepex b/BaseTools/BinWrappers/PosixLike/GenDepex
index bd3141a758a8..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/GenDepex
+++ b/BaseTools/BinWrappers/PosixLike/GenDepex
@@ -1,3 +1,14 @@
 #!/usr/bin/env bash
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/AutoGen/`basename $0`.py $*
+#python `dirname $0`/RunToolFromSource.py `basename $0` $*
+
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/GenFds b/BaseTools/BinWrappers/PosixLike/GenFds
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/GenFds
+++ b/BaseTools/BinWrappers/PosixLike/GenFds
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/GenPatchPcdTable b/BaseTools/BinWrappers/PosixLike/GenPatchPcdTable
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/GenPatchPcdTable
+++ b/BaseTools/BinWrappers/PosixLike/GenPatchPcdTable
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/PatchPcdValue b/BaseTools/BinWrappers/PosixLike/PatchPcdValue
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/PatchPcdValue
+++ b/BaseTools/BinWrappers/PosixLike/PatchPcdValue
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/TargetTool b/BaseTools/BinWrappers/PosixLike/TargetTool
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/TargetTool
+++ b/BaseTools/BinWrappers/PosixLike/TargetTool
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/Trim b/BaseTools/BinWrappers/PosixLike/Trim
index 2cb8b86a9931..7cac4f7c4fff 100755
--- a/BaseTools/BinWrappers/PosixLike/Trim
+++ b/BaseTools/BinWrappers/PosixLike/Trim
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+exe=$(basename "$full_cmd")
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$exe/$exe.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/UPT b/BaseTools/BinWrappers/PosixLike/UPT
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/UPT
+++ b/BaseTools/BinWrappers/PosixLike/UPT
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/build b/BaseTools/BinWrappers/PosixLike/build
index 2cb8b86a9931..214d88fff1b1 100755
--- a/BaseTools/BinWrappers/PosixLike/build
+++ b/BaseTools/BinWrappers/PosixLike/build
@@ -1,5 +1,14 @@
 #!/usr/bin/env bash
 #python `dirname $0`/RunToolFromSource.py `basename $0` $*
-PYTHONPATH="`dirname $0`/../../Source/Python" \
-    python "`dirname $0`/../../Source/Python"/`basename $0`/`basename $0`.py $*
 
+# If a python2 command is available, use it in preference to python
+if command -v python2 >/dev/null 2>&1; then
+    python_exe=python2
+fi
+
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
+
+export PYTHONPATH="$dir/../../Source/Python"
+exec "${python_exe:-python}" "$dir/../../Source/Python/$cmd/$cmd.py" "$@"

From c56829fa73f6293daf8b097a8c8c55679e564368 Mon Sep 17 00:00:00 2001
From: Charles Duffy <chaduffy@cisco.com>
Date: Wed, 20 Jan 2016 05:12:02 +0000
Subject: [PATCH 443/525] BaseTools: Improve shell wrapper for C build commands

- Avoid obsolescent forms of test builtin (`-a` and `-o`; see APPLICATION USAGE
  section of http://pubs.opengroup.org/onlinepubs/9699919799/utilities/test.html).
- Quote all expansions to prevent string-splitting and globbing.
- Avoid unspecified "exit -1" (only single-byte integers are valid); instead,
  use identical exit status to shell command-not-found.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Charles Duffy <chaduffy@cisco.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19695 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5e407648358d639ed19d228303527133e4c95c25)
---
 .../Bin/CYGWIN_NT-5.1-i686/BootSectImage      | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiLdrImage  | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiRom       | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenCrc32     | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFfs       | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFv        | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFw        | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenPage      | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenSec       | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/GenVtf       | 30 +++++++++----------
 .../Bin/CYGWIN_NT-5.1-i686/GnuGenBootSector   | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaCompress | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/Split        | 30 +++++++++----------
 .../Bin/CYGWIN_NT-5.1-i686/TianoCompress      | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/VfrCompile   | 30 +++++++++----------
 BaseTools/Bin/CYGWIN_NT-5.1-i686/VolInfo      | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/BootSectImage | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/EfiLdrImage   | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/EfiRom        | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenCrc32      | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenFfs        | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenFv         | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenFw         | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenPage       | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenSec        | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/GenVtf        | 30 +++++++++----------
 .../BinWrappers/PosixLike/GnuGenBootSector    | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/LzmaCompress  | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/Split         | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/TianoCompress | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/VfrCompile    | 30 +++++++++----------
 BaseTools/BinWrappers/PosixLike/VolInfo       | 30 +++++++++----------
 32 files changed, 480 insertions(+), 480 deletions(-)

diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/BootSectImage b/BaseTools/Bin/CYGWIN_NT-5.1-i686/BootSectImage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/BootSectImage
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/BootSectImage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiLdrImage b/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiLdrImage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiLdrImage
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiLdrImage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiRom b/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiRom
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiRom
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/EfiRom
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenCrc32 b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenCrc32
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenCrc32
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenCrc32
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFfs b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFfs
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFfs
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFfs
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFv b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFv
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFv
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFv
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFw b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFw
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFw
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenFw
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenPage b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenPage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenPage
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenPage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenSec b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenSec
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenSec
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenSec
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenVtf b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenVtf
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenVtf
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GenVtf
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GnuGenBootSector b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GnuGenBootSector
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/GnuGenBootSector
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/GnuGenBootSector
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaCompress b/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaCompress
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaCompress
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaCompress
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Split b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Split
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/Split
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/Split
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/TianoCompress b/BaseTools/Bin/CYGWIN_NT-5.1-i686/TianoCompress
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/TianoCompress
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/TianoCompress
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/VfrCompile b/BaseTools/Bin/CYGWIN_NT-5.1-i686/VfrCompile
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/VfrCompile
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/VfrCompile
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/VolInfo b/BaseTools/Bin/CYGWIN_NT-5.1-i686/VolInfo
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/VolInfo
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/VolInfo
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/BootSectImage b/BaseTools/BinWrappers/PosixLike/BootSectImage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/BootSectImage
+++ b/BaseTools/BinWrappers/PosixLike/BootSectImage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/EfiLdrImage b/BaseTools/BinWrappers/PosixLike/EfiLdrImage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/EfiLdrImage
+++ b/BaseTools/BinWrappers/PosixLike/EfiLdrImage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/EfiRom b/BaseTools/BinWrappers/PosixLike/EfiRom
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/EfiRom
+++ b/BaseTools/BinWrappers/PosixLike/EfiRom
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenCrc32 b/BaseTools/BinWrappers/PosixLike/GenCrc32
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenCrc32
+++ b/BaseTools/BinWrappers/PosixLike/GenCrc32
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenFfs b/BaseTools/BinWrappers/PosixLike/GenFfs
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenFfs
+++ b/BaseTools/BinWrappers/PosixLike/GenFfs
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenFv b/BaseTools/BinWrappers/PosixLike/GenFv
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenFv
+++ b/BaseTools/BinWrappers/PosixLike/GenFv
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenFw b/BaseTools/BinWrappers/PosixLike/GenFw
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenFw
+++ b/BaseTools/BinWrappers/PosixLike/GenFw
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenPage b/BaseTools/BinWrappers/PosixLike/GenPage
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenPage
+++ b/BaseTools/BinWrappers/PosixLike/GenPage
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenSec b/BaseTools/BinWrappers/PosixLike/GenSec
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenSec
+++ b/BaseTools/BinWrappers/PosixLike/GenSec
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GenVtf b/BaseTools/BinWrappers/PosixLike/GenVtf
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GenVtf
+++ b/BaseTools/BinWrappers/PosixLike/GenVtf
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/GnuGenBootSector b/BaseTools/BinWrappers/PosixLike/GnuGenBootSector
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/GnuGenBootSector
+++ b/BaseTools/BinWrappers/PosixLike/GnuGenBootSector
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/LzmaCompress b/BaseTools/BinWrappers/PosixLike/LzmaCompress
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/LzmaCompress
+++ b/BaseTools/BinWrappers/PosixLike/LzmaCompress
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/Split b/BaseTools/BinWrappers/PosixLike/Split
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/Split
+++ b/BaseTools/BinWrappers/PosixLike/Split
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/TianoCompress b/BaseTools/BinWrappers/PosixLike/TianoCompress
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/TianoCompress
+++ b/BaseTools/BinWrappers/PosixLike/TianoCompress
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/VfrCompile b/BaseTools/BinWrappers/PosixLike/VfrCompile
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/VfrCompile
+++ b/BaseTools/BinWrappers/PosixLike/VfrCompile
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 
diff --git a/BaseTools/BinWrappers/PosixLike/VolInfo b/BaseTools/BinWrappers/PosixLike/VolInfo
index 4821d24fa7ed..0945d86d9209 100755
--- a/BaseTools/BinWrappers/PosixLike/VolInfo
+++ b/BaseTools/BinWrappers/PosixLike/VolInfo
@@ -1,29 +1,29 @@
 #!/usr/bin/env bash
-#python `dirname $0`/RunToolFromSource.py `basename $0` $*
-#exec `dirname $0`/../../../../C/bin/`basename $0` $*
 
-TOOL_BASENAME=`basename $0`
+full_cmd=${BASH_SOURCE:-$0} # see http://mywiki.wooledge.org/BashFAQ/028 for a discussion of why $0 is not a good choice here
+dir=$(dirname "$full_cmd")
+cmd=${full_cmd##*/}
 
-if [ -n "$WORKSPACE" -a -e $WORKSPACE/Conf/BaseToolsCBinaries ]
+if [ -n "$WORKSPACE" ] && [ -e "$WORKSPACE/Conf/BaseToolsCBinaries" ]
 then
-  exec $WORKSPACE/Conf/BaseToolsCBinaries/$TOOL_BASENAME
-elif [ -n "$WORKSPACE" -a -e $EDK_TOOLS_PATH/Source/C ]
+  exec "$WORKSPACE/Conf/BaseToolsCBinaries/$cmd"
+elif [ -n "$WORKSPACE" ] && [ -e "$EDK_TOOLS_PATH/Source/C" ]
 then
-  if [ ! -e $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME ]
+  if [ ! -e "$EDK_TOOLS_PATH/Source/C/bin/$cmd" ]
   then
-    echo BaseTools C Tool binary was not found \($TOOL_BASENAME\)
-    echo You may need to run:
+    echo "BaseTools C Tool binary was not found ($cmd)"
+    echo "You may need to run:"
     echo "  make -C $EDK_TOOLS_PATH/Source/C"
   else
-    exec $EDK_TOOLS_PATH/Source/C/bin/$TOOL_BASENAME $*
+    exec "$EDK_TOOLS_PATH/Source/C/bin/$cmd" "$@"
   fi
-elif [ -e `dirname $0`/../../Source/C/bin/$TOOL_BASENAME ]
+elif [ -e "$dir/../../Source/C/bin/$cmd" ]
 then
-  exec `dirname $0`/../../Source/C/bin/$TOOL_BASENAME $*
+  exec "$dir/../../Source/C/bin/$cmd" "$@"
 else
-  echo Unable to find the real \'$TOOL_BASENAME\' to run
-  echo This message was printed by
+  echo "Unable to find the real '$cmd' to run"
+  echo "This message was printed by"
   echo "  $0"
-  exit -1
+  exit 127
 fi
 

From 95b952db0be8052ad9bcfb77db1e96ea93753882 Mon Sep 17 00:00:00 2001
From: Charles Duffy <chaduffy@cisco.com>
Date: Wed, 20 Jan 2016 05:14:10 +0000
Subject: [PATCH 444/525] BaseTools: Use python2 if available in
 Tests/GNUmakefile

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Charles Duffy <chaduffy@cisco.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19696 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 87157f76f05469dc5c349fe53c4402e408136f2e)
---
 BaseTools/Tests/GNUmakefile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Tests/GNUmakefile b/BaseTools/Tests/GNUmakefile
index b7cb226da97c..0c11f6aae946 100644
--- a/BaseTools/Tests/GNUmakefile
+++ b/BaseTools/Tests/GNUmakefile
@@ -14,7 +14,7 @@
 all: test
 
 test:
-	@python RunTests.py
+	@if command -v python2 >/dev/null 2>&1; then python2 RunTests.py; else python RunTests.py; fi
 
 clean:
 	find . -name '*.pyc' -exec rm '{}' ';'

From c796b65c1ea43b7d29a456e2715b626be64eb739 Mon Sep 17 00:00:00 2001
From: Charles Duffy <chaduffy@cisco.com>
Date: Wed, 20 Jan 2016 05:15:55 +0000
Subject: [PATCH 445/525] BaseTools: Improve LzmaF86Compress wrapper

- Remove test usage declared obsolescent by POSIX
- Pass argv array through as literal rather than forming into a string, then
  string-splitting and glob-expanding same.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Charles Duffy <chaduffy@cisco.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19697 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 8d0776f3e60482ed621e45b2b52db8a604d7e5a2)
---
 BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaF86Compress | 15 ++++++++-------
 BaseTools/BinWrappers/PosixLike/LzmaF86Compress  | 15 ++++++++-------
 2 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaF86Compress b/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaF86Compress
index c3e49cf29d8f..50af530cbdb4 100755
--- a/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaF86Compress
+++ b/BaseTools/Bin/CYGWIN_NT-5.1-i686/LzmaF86Compress
@@ -12,11 +12,12 @@
 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #
 
-for arg in $*; do
-  if [ "arg" = "-e" -o "arg" = "-d" ]; then
-    FLAG=--f86
-    break;
-  fi
-done
+for arg; do
+  case $arg in
+    -e|-d)
+      set -- "$@" --f86
+      break
+    ;;
+esac
 
-LzmaCompress $* $FLAG
+exec LzmaCompress "$@"
diff --git a/BaseTools/BinWrappers/PosixLike/LzmaF86Compress b/BaseTools/BinWrappers/PosixLike/LzmaF86Compress
index 18946a4d2dc4..50af530cbdb4 100755
--- a/BaseTools/BinWrappers/PosixLike/LzmaF86Compress
+++ b/BaseTools/BinWrappers/PosixLike/LzmaF86Compress
@@ -12,11 +12,12 @@
 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #
 
-for arg in $*; do
-  if [ "$arg" = "-e" -o "$arg" = "-d" ]; then
-    FLAG=--f86
-    break;
-  fi
-done
+for arg; do
+  case $arg in
+    -e|-d)
+      set -- "$@" --f86
+      break
+    ;;
+esac
 
-LzmaCompress $* $FLAG
+exec LzmaCompress "$@"

From 926dd14537a8f99649db5ad0be1df551b2bcb704 Mon Sep 17 00:00:00 2001
From: Eugene Cohen <eugene@hp.com>
Date: Thu, 21 Jan 2016 09:10:55 +0000
Subject: [PATCH 446/525] BaseTools: make build report tolerant of FVs
 specified by name

Check if the FV name is in the FV dictionary before using it which fixes
a crash during build report generation when FVs are specified by path in
the FDF.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eugene Cohen <eugene@hp.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19705 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit a243297253afb3f4e5b4047bab49548c73dfdcd7)
---
 BaseTools/Source/Python/build/BuildReport.py | 72 +++++++++++---------
 1 file changed, 38 insertions(+), 34 deletions(-)

diff --git a/BaseTools/Source/Python/build/BuildReport.py b/BaseTools/Source/Python/build/BuildReport.py
index d459a0113acb..04a4d7dbd5b6 100644
--- a/BaseTools/Source/Python/build/BuildReport.py
+++ b/BaseTools/Source/Python/build/BuildReport.py
@@ -4,7 +4,7 @@
 # This module contains the functionality to generate build report after
 # build all target completes successfully.
 #
-# Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -1175,18 +1175,20 @@ class FdRegionReport(object):
     # @param Wa              Workspace context information
     #
     def _DiscoverNestedFvList(self, FvName, Wa):
-        for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:
-            for Section in Ffs.SectionList:
-                try:
-                    for FvSection in Section.SectionList:
-                        if FvSection.FvName in self.FvList:
-                            continue
-                        self._GuidsDb[Ffs.NameGuid.upper()] = FvSection.FvName
-                        self.FvList.append(FvSection.FvName)
-                        self.FvInfo[FvSection.FvName] = ("Nested FV", 0, 0)
-                        self._DiscoverNestedFvList(FvSection.FvName, Wa)
-                except AttributeError:
-                    pass
+        FvDictKey=FvName.upper()
+        if FvDictKey in Wa.FdfProfile.FvDict:
+            for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:
+                for Section in Ffs.SectionList:
+                    try:
+                        for FvSection in Section.SectionList:
+                            if FvSection.FvName in self.FvList:
+                                continue
+                            self._GuidsDb[Ffs.NameGuid.upper()] = FvSection.FvName
+                            self.FvList.append(FvSection.FvName)
+                            self.FvInfo[FvSection.FvName] = ("Nested FV", 0, 0)
+                            self._DiscoverNestedFvList(FvSection.FvName, Wa)
+                    except AttributeError:
+                        pass
 
     ##
     # Constructor function for class FdRegionReport
@@ -1264,27 +1266,29 @@ def __init__(self, FdRegion, Wa):
         # Collect the GUID map in the FV firmware volume
         #
         for FvName in self.FvList:
-            for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:
-                try:
-                    #
-                    # collect GUID map for binary EFI file in FDF file.
-                    #
-                    Guid = Ffs.NameGuid.upper()
-                    Match = gPcdGuidPattern.match(Ffs.NameGuid)
-                    if Match:
-                        PcdTokenspace = Match.group(1)
-                        PcdToken = Match.group(2)
-                        if (PcdToken, PcdTokenspace) in PlatformPcds:
-                            GuidValue = PlatformPcds[(PcdToken, PcdTokenspace)]
-                            Guid = GuidStructureByteArrayToGuidString(GuidValue).upper()
-                    for Section in Ffs.SectionList:
-                        try:
-                            ModuleSectFile = mws.join(Wa.WorkspaceDir, Section.SectFileName)
-                            self._GuidsDb[Guid] = ModuleSectFile
-                        except AttributeError:
-                            pass
-                except AttributeError:
-                    pass
+            FvDictKey=FvName.upper()
+            if FvDictKey in Wa.FdfProfile.FvDict:
+                for Ffs in Wa.FdfProfile.FvDict[FvName.upper()].FfsList:
+                    try:
+                        #
+                        # collect GUID map for binary EFI file in FDF file.
+                        #
+                        Guid = Ffs.NameGuid.upper()
+                        Match = gPcdGuidPattern.match(Ffs.NameGuid)
+                        if Match:
+                            PcdTokenspace = Match.group(1)
+                            PcdToken = Match.group(2)
+                            if (PcdToken, PcdTokenspace) in PlatformPcds:
+                                GuidValue = PlatformPcds[(PcdToken, PcdTokenspace)]
+                                Guid = GuidStructureByteArrayToGuidString(GuidValue).upper()
+                        for Section in Ffs.SectionList:
+                            try:
+                                ModuleSectFile = mws.join(Wa.WorkspaceDir, Section.SectFileName)
+                                self._GuidsDb[Guid] = ModuleSectFile
+                            except AttributeError:
+                                pass
+                    except AttributeError:
+                        pass
 
 
     ##

From 7c43c0b0310adcee16a1f465f7b5cfdf9692a5d1 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Tue, 26 Jan 2016 08:45:34 +0000
Subject: [PATCH 447/525] BaseTools: Fix the bug when no FD section in the FDF
 file

Check if the Fdf.CurrentFdName is not None and in Fdf.Profile.FdDict
before using it which fix a crash issue when no FD section in FDF file.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19747 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit cb04330eee96f3afc8d9f060b69859e3c068c3c9)
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index e9f4888aa199..dfb5b72b13f4 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -317,11 +317,12 @@ def _Init(self, WorkspaceDir, ActivePlatform, Target, Toolchain, ArchList, MetaF
             GlobalData.gFdfParser = Fdf
             GlobalData.gAutoGenPhase = False
             PcdSet = Fdf.Profile.PcdDict
-            FdDict = Fdf.Profile.FdDict[Fdf.CurrentFdName]
-            for FdRegion in FdDict.RegionList:
-                if str(FdRegion.RegionType) is 'FILE' and self.Platform.VpdToolGuid in str(FdRegion.RegionDataList):
-                    if int(FdRegion.Offset) % 8 != 0:
-                        EdkLogger.error("build", FORMAT_INVALID, 'The VPD Base Address %s must be 8-byte aligned.' % (FdRegion.Offset))
+            if Fdf.CurrentFdName and Fdf.CurrentFdName in Fdf.Profile.FdDict:
+                FdDict = Fdf.Profile.FdDict[Fdf.CurrentFdName]
+                for FdRegion in FdDict.RegionList:
+                    if str(FdRegion.RegionType) is 'FILE' and self.Platform.VpdToolGuid in str(FdRegion.RegionDataList):
+                        if int(FdRegion.Offset) % 8 != 0:
+                            EdkLogger.error("build", FORMAT_INVALID, 'The VPD Base Address %s must be 8-byte aligned.' % (FdRegion.Offset))
             ModuleList = Fdf.Profile.InfList
             self.FdfProfile = Fdf.Profile
             for fvname in self.FvTargetList:

From f3962f2ff0a5a841a1c35ec00b0902aab153006a Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 29 Jan 2016 04:44:54 +0000
Subject: [PATCH 448/525] BaseTools: Fix a bug for VpdOffset calculate

The VpdOffset value in the DSC both support integer and Hex value, so we
fix the bug to support both format.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19765 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit ca85291f1f020652254457cc9edbb3caf6a2ed56)
---
 BaseTools/Source/Python/AutoGen/AutoGen.py | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index dfb5b72b13f4..55a59dabc07e 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -1154,7 +1154,14 @@ def CollectPlatformDynamicPcds(self):
                                 Alignment = 2
                             else:
                                 Alignment = 1
-                            if int(Sku.VpdOffset) % Alignment != 0:
+                            try:
+                                VpdOffset = int(Sku.VpdOffset)
+                            except:
+                                try:
+                                    VpdOffset = int(Sku.VpdOffset, 16)
+                                except:
+                                    EdkLogger.error("build", FORMAT_INVALID, "Invalid offset value %s for PCD %s.%s." % (Sku.VpdOffset, Pcd.TokenSpaceGuidCName, Pcd.TokenCName))
+                            if VpdOffset % Alignment != 0:
                                 EdkLogger.error("build", FORMAT_INVALID, 'The offset value of PCD %s.%s should be %s-byte aligned.' % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName, Alignment))
                         VpdFile.Add(Pcd, Sku.VpdOffset)
                         # if the offset of a VPD is *, then it need to be fixed up by third party tool.
@@ -1220,7 +1227,14 @@ def CollectPlatformDynamicPcds(self):
                                         Alignment = 2
                                     else:
                                         Alignment = 1
-                                    if int(Sku.VpdOffset) % Alignment != 0:
+                                    try:
+                                        VpdOffset = int(Sku.VpdOffset)
+                                    except:
+                                        try:
+                                            VpdOffset = int(Sku.VpdOffset, 16)
+                                        except:
+                                            EdkLogger.error("build", FORMAT_INVALID, "Invalid offset value %s for PCD %s.%s." % (Sku.VpdOffset, DscPcdEntry.TokenSpaceGuidCName, DscPcdEntry.TokenCName))
+                                    if VpdOffset % Alignment != 0:
                                         EdkLogger.error("build", FORMAT_INVALID, 'The offset value of PCD %s.%s should be %s-byte aligned.' % (DscPcdEntry.TokenSpaceGuidCName, DscPcdEntry.TokenCName, Alignment))
                                 VpdFile.Add(DscPcdEntry, Sku.VpdOffset)
                                 if not NeedProcessVpdMapFile and Sku.VpdOffset == "*":

From 7be61547f59d48aed0e93c44d7eec5949ead8f6f Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 29 Jan 2016 04:48:55 +0000
Subject: [PATCH 449/525] BaseTools:Incremental build not work if VPD values in
 DSC changed by -D

If a -D flag is passed into build that selects different lines in
[PcdsDynamicExVpd], then build does not see any changes to the timestamp
of the DSC file and the VPD tool is not used to regenerate the VPD
region based in the statements that are active. so we changed the detect
condition and use SaveFileOnChange function to generate VPD.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19767 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit e459de78001be89d37cc286d0fcd57f92e1a438a)
---
 BaseTools/Source/Python/AutoGen/AutoGen.py    |  7 +--
 BaseTools/Source/Python/Common/VpdInfoFile.py | 44 +++++++------------
 2 files changed, 17 insertions(+), 34 deletions(-)

diff --git a/BaseTools/Source/Python/AutoGen/AutoGen.py b/BaseTools/Source/Python/AutoGen/AutoGen.py
index 55a59dabc07e..776743a71072 100644
--- a/BaseTools/Source/Python/AutoGen/AutoGen.py
+++ b/BaseTools/Source/Python/AutoGen/AutoGen.py
@@ -1256,7 +1256,6 @@ def CollectPlatformDynamicPcds(self):
                                 "Fail to get FLASH_DEFINITION definition in DSC file %s which is required when DSC contains VPD PCD." % str(self.Platform.MetaFile))
 
             if VpdFile.GetCount() != 0:
-                DscTimeStamp = self.Platform.MetaFile.TimeStamp
                 FvPath = os.path.join(self.BuildDir, "FV")
                 if not os.path.exists(FvPath):
                     try:
@@ -1264,13 +1263,9 @@ def CollectPlatformDynamicPcds(self):
                     except:
                         EdkLogger.error("build", FILE_WRITE_FAILURE, "Fail to create FV folder under %s" % self.BuildDir)
 
-
                 VpdFilePath = os.path.join(FvPath, "%s.txt" % self.Platform.VpdToolGuid)
 
-
-                if not os.path.exists(VpdFilePath) or os.path.getmtime(VpdFilePath) < DscTimeStamp:
-                    VpdFile.Write(VpdFilePath)
-
+                if VpdFile.Write(VpdFilePath):
                     # retrieve BPDG tool's path from tool_def.txt according to VPD_TOOL_GUID defined in DSC file.
                     BPDGToolName = None
                     for ToolDef in self.ToolDefinition.values():
diff --git a/BaseTools/Source/Python/Common/VpdInfoFile.py b/BaseTools/Source/Python/Common/VpdInfoFile.py
index 1a68e9bee172..dc8ece9608a8 100644
--- a/BaseTools/Source/Python/Common/VpdInfoFile.py
+++ b/BaseTools/Source/Python/Common/VpdInfoFile.py
@@ -6,7 +6,7 @@
 # is pointed by *_*_*_VPD_TOOL_GUID in conf/tools_def.txt 
 #
 #
-# Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -21,6 +21,7 @@
 import Common.BuildToolError as BuildToolError
 import subprocess
 from Common.LongFilePathSupport import OpenLongFilePath as open
+from Common.Misc import SaveFileOnChange
 
 FILE_COMMENT_TEMPLATE = \
 """
@@ -124,34 +125,21 @@ def Write(self, FilePath):
         if not (FilePath != None or len(FilePath) != 0):
             EdkLogger.error("VpdInfoFile", BuildToolError.PARAMETER_INVALID,  
                             "Invalid parameter FilePath: %s." % FilePath)        
-        try:
-            fd = open(FilePath, "w")
-        except:
-            EdkLogger.error("VpdInfoFile", 
-                            BuildToolError.FILE_OPEN_FAILURE, 
-                            "Fail to open file %s for written." % FilePath)
-        
-        try:
-            # write file header
-            fd.write(FILE_COMMENT_TEMPLATE)
 
-            # write each of PCD in VPD type
-            Pcds = self._VpdArray.keys()
-            Pcds.sort()
-            for Pcd in Pcds:
-                i = 0
-                for Offset in self._VpdArray[Pcd]:
-                    PcdValue = str(Pcd.SkuInfoList[Pcd.SkuInfoList.keys()[i]].DefaultValue).strip()
-                    if PcdValue == "" :
-                        PcdValue  = Pcd.DefaultValue
-                        
-                    fd.write("%s.%s|%s|%s|%s|%s  \n" % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName, str(Pcd.SkuInfoList.keys()[i]),str(Offset).strip(), str(Pcd.MaxDatumSize).strip(),PcdValue))
-                    i += 1
-        except:
-            EdkLogger.error("VpdInfoFile",
-                            BuildToolError.FILE_WRITE_FAILURE,
-                            "Fail to write file %s" % FilePath) 
-        fd.close()
+        Content = FILE_COMMENT_TEMPLATE
+        Pcds = self._VpdArray.keys()
+        Pcds.sort()
+        for Pcd in Pcds:
+            i = 0
+            for Offset in self._VpdArray[Pcd]:
+                PcdValue = str(Pcd.SkuInfoList[Pcd.SkuInfoList.keys()[i]].DefaultValue).strip()
+                if PcdValue == "" :
+                    PcdValue  = Pcd.DefaultValue
+
+                Content += "%s.%s|%s|%s|%s|%s  \n" % (Pcd.TokenSpaceGuidCName, Pcd.TokenCName, str(Pcd.SkuInfoList.keys()[i]),str(Offset).strip(), str(Pcd.MaxDatumSize).strip(),PcdValue)
+                i += 1
+
+        return SaveFileOnChange(FilePath, Content, False)
 
     ## Read an existing VPD PCD info file.
     #

From 4e564c27c424bd15e6fa1844727e54d6f67e5a74 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Fri, 29 Jan 2016 04:54:37 +0000
Subject: [PATCH 450/525] BaseTools: Update BaseTools to pass VS2015 compiler

Fix some errors to pass VS2015 compiler.
1. warning C4456: declaration of xxx hides previous local declaration
2. warning C4005: 'UINT8_MAX': macro redefinition

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19768 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5aec6991e7d6af8420eefa4c0fd3bf4de323def2)
---
 BaseTools/Source/C/GenFw/Elf32Convert.c       |  4 +--
 BaseTools/Source/C/GenVtf/GenVtf.c            | 16 ++++-----
 .../Source/C/LzmaCompress/Sdk/C/LzmaDec.c     |  2 +-
 .../Source/C/LzmaCompress/Sdk/C/LzmaEnc.c     | 33 ++++++++-----------
 BaseTools/Source/C/VfrCompile/VfrSyntax.g     |  5 ++-
 5 files changed, 29 insertions(+), 31 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index eede64576940..9bf58555c076 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -1,7 +1,7 @@
 /** @file
 Elf32 Convert solution
 
-Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 Portions copyright (c) 2013, ARM Ltd. All rights reserved.<BR>
 
 This program and the accompanying materials are licensed and made available
@@ -815,7 +815,7 @@ WriteRelocations32 (
 
         FoundRelocations = TRUE;
         for (RelIdx = 0; RelIdx < RelShdr->sh_size; RelIdx += RelShdr->sh_entsize) {
-          Elf_Rel  *Rel = (Elf_Rel *)((UINT8*)mEhdr + RelShdr->sh_offset + RelIdx);
+          Rel = (Elf_Rel *)((UINT8*)mEhdr + RelShdr->sh_offset + RelIdx);
 
           if (mEhdr->e_machine == EM_386) { 
             switch (ELF_R_TYPE(Rel->r_info)) {
diff --git a/BaseTools/Source/C/GenVtf/GenVtf.c b/BaseTools/Source/C/GenVtf/GenVtf.c
index 6f66ddc84292..9a3f5081a70c 100644
--- a/BaseTools/Source/C/GenVtf/GenVtf.c
+++ b/BaseTools/Source/C/GenVtf/GenVtf.c
@@ -2,7 +2,7 @@
 This file contains functions required to generate a boot strap file (BSF) also 
 known as the Volume Top File (VTF)
 
-Copyright (c) 1999 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed and made available 
 under the terms and conditions of the BSD License which accompanies this 
 distribution.  The full text of the license may be found at
@@ -2652,20 +2652,20 @@ Routine Description:
     SymFileName = VTF_SYM_FILE;
   } else {
     INTN OutFileNameLen = strlen(OutFileName1);
-    INTN Index;
+    INTN NewIndex;
 
-    for (Index = OutFileNameLen; Index > 0; --Index) {
-      if (OutFileName1[Index] == '/' || OutFileName1[Index] == '\\') {
+    for (NewIndex = OutFileNameLen; NewIndex > 0; --NewIndex) {
+      if (OutFileName1[NewIndex] == '/' || OutFileName1[NewIndex] == '\\') {
         break;
       }
     }
-    if (Index == 0) {
+    if (NewIndex == 0) {
       SymFileName = VTF_SYM_FILE;
     } else {
-      INTN SymFileNameLen = Index + 1 + strlen(VTF_SYM_FILE);
+      INTN SymFileNameLen = NewIndex + 1 + strlen(VTF_SYM_FILE);
       SymFileName = malloc(SymFileNameLen + 1);
-      memcpy(SymFileName, OutFileName1, Index + 1);
-      memcpy(SymFileName + Index + 1, VTF_SYM_FILE, strlen(VTF_SYM_FILE));
+      memcpy(SymFileName, OutFileName1, NewIndex + 1);
+      memcpy(SymFileName + NewIndex + 1, VTF_SYM_FILE, strlen(VTF_SYM_FILE));
       SymFileName[SymFileNameLen] = '\0';
     }
     if (DebugMode) {
diff --git a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaDec.c b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaDec.c
index eb5250174b18..87bea866e4a1 100644
--- a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaDec.c
+++ b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaDec.c
@@ -266,7 +266,7 @@ static int MY_FAST_CALL LzmaDec_DecodeReal(CLzmaDec *p, SizeT limit, const Byte
         prob = probs + RepLenCoder;
       }
       {
-        unsigned limit, offset;
+        unsigned offset;
         CLzmaProb *probLen = prob + LenChoice;
         IF_BIT_0(probLen)
         {
diff --git a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
index 95c3c9ff5fc7..9b2dd16ffa48 100644
--- a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
+++ b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
@@ -3,7 +3,7 @@
     LzmaEnc.c -- LZMA Encoder
     2009-02-02 : Igor Pavlov : Public domain
 
-  Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2011 - 2016, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -132,9 +132,9 @@ void LzmaEnc_FastPosInit(Byte *g_FastPos)
   }
 }
 
-#define BSR2_RET(pos, res) { UInt32 i = 6 + ((kNumLogBits - 1) & \
+#define BSR2_RET(pos, res) { UInt32 ij = 6 + ((kNumLogBits - 1) & \
   (0 - (((((UInt32)1 << (kNumLogBits + 6)) - 1) - pos) >> 31))); \
-  res = p->g_FastPos[pos >> i] + (i * 2); }
+  res = p->g_FastPos[pos >> ij] + (ij * 2); }
 /*
 #define BSR2_RET(pos, res) { res = (pos < (1 << (kNumLogBits + 6))) ? \
   p->g_FastPos[pos >> 6] + 12 : \
@@ -1148,20 +1148,18 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
     #ifdef SHOW_STAT2
     if (position >= 0)
     {
-      unsigned i;
+      unsigned ii;
       printf("\n pos = %4X", position);
-      for (i = cur; i <= lenEnd; i++)
-      printf("\nprice[%4X] = %d", position - cur + i, p->opt[i].price);
+      for (ii = cur; ii <= lenEnd; ii++)
+      printf("\nprice[%4X] = %d", position - cur + ii, p->opt[ii].price);
     }
     #endif
 
   for (;;)
   {
-    UInt32 numAvailFull, newLen, numPairs, posPrev, state, posState, startLen;
-    UInt32 curPrice, curAnd1Price, matchPrice, repMatchPrice;
+    UInt32 numAvailFull, newLen, posPrev, state, startLen;
+    UInt32 curPrice, curAnd1Price;
     Bool nextIsChar;
-    Byte curByte, matchByte;
-    const Byte *data;
     COptimal *curOpt;
     COptimal *nextOpt;
 
@@ -1224,7 +1222,6 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
       prevOpt = &p->opt[posPrev];
       if (pos < LZMA_NUM_REPS)
       {
-        UInt32 i;
         reps[0] = prevOpt->backs[pos];
         for (i = 1; i <= pos; i++)
           reps[i] = prevOpt->backs[i - 1];
@@ -1233,7 +1230,6 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
       }
       else
       {
-        UInt32 i;
         reps[0] = (pos - LZMA_NUM_REPS);
         for (i = 1; i < LZMA_NUM_REPS; i++)
           reps[i] = prevOpt->backs[i - 1];
@@ -1319,12 +1315,11 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
             GET_PRICE_1(p->isRep[state2]);
         /* for (; lenTest2 >= 2; lenTest2--) */
         {
-          UInt32 curAndLenPrice;
           COptimal *opt;
           UInt32 offset = cur + 1 + lenTest2;
           while (lenEnd < offset)
             p->opt[++lenEnd].price = kInfinityPrice;
-          curAndLenPrice = nextRepMatchPrice + GetRepPrice(p, 0, lenTest2, state2, posStateNext);
+          UInt32 curAndLenPrice = nextRepMatchPrice + GetRepPrice(p, 0, lenTest2, state2, posStateNext);
           opt = &p->opt[offset];
           if (curAndLenPrice < opt->price)
           {
@@ -1430,7 +1425,7 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
     }
     if (newLen >= startLen)
     {
-      UInt32 normalMatchPrice = matchPrice + GET_PRICE_0(p->isRep[state]);
+      normalMatchPrice = matchPrice + GET_PRICE_0(p->isRep[state]);
       UInt32 offs, curBack, posSlot;
       UInt32 lenTest;
       while (lenEnd < cur + newLen)
@@ -1443,7 +1438,8 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
       GetPosSlot2(curBack, posSlot);
       for (lenTest = /*2*/ startLen; ; lenTest++)
       {
-        UInt32 curAndLenPrice = normalMatchPrice + p->lenEnc.prices[posState][lenTest - LZMA_MATCH_LEN_MIN];
+        UInt32 curAndLenPrice;
+        curAndLenPrice = normalMatchPrice + p->lenEnc.prices[posState][lenTest - LZMA_MATCH_LEN_MIN];
         UInt32 lenToPosState = GetLenToPosState(lenTest);
         COptimal *opt;
         if (curBack < kNumFullDistances)
@@ -1488,8 +1484,7 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
             /* for (; lenTest2 >= 2; lenTest2--) */
             {
               UInt32 offset = cur + lenTest + 1 + lenTest2;
-              UInt32 curAndLenPrice;
-              COptimal *opt;
+
               while (lenEnd < offset)
                 p->opt[++lenEnd].price = kInfinityPrice;
               curAndLenPrice = nextRepMatchPrice + GetRepPrice(p, 0, lenTest2, state2, posStateNext);
@@ -1697,7 +1692,7 @@ static void FillDistancesPrices(CLzmaEnc *p)
 
     {
       UInt32 *distancesPrices = p->distancesPrices[lenToPosState];
-      UInt32 i;
+
       for (i = 0; i < kStartPosModelIndex; i++)
         distancesPrices[i] = posSlotPrices[i];
       for (; i < kNumFullDistances; i++)
diff --git a/BaseTools/Source/C/VfrCompile/VfrSyntax.g b/BaseTools/Source/C/VfrCompile/VfrSyntax.g
index d74fec8815c1..55a9a23ff2d7 100644
--- a/BaseTools/Source/C/VfrCompile/VfrSyntax.g
+++ b/BaseTools/Source/C/VfrCompile/VfrSyntax.g
@@ -1,7 +1,7 @@
 /*++ @file
 Vfr Syntax
 
-Copyright (c) 2004 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -23,6 +23,9 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 >>
 
 <<
+#ifdef UINT8_MAX
+#undef UINT8_MAX
+#endif
 #include "stdio.h"
 #include "PBlackBox.h"
 #include "DLexerBase.h"

From 420b02b4afce5622c239610681842912b3433964 Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Fri, 12 Feb 2016 10:06:58 +0100
Subject: [PATCH 451/525] BaseTools/GenFw AARCH64: add support for relative
 data relocations

This adds support to the ELF to PE/COFF conversion performed by GenFw for
the AArch64 ELF relocation types R_AARCH64_PREL64, R_AARCH64_PREL32 and
R_AARCH64_PREL16. Since we already require the ELF and PE/COFF section
layouts to be identical in order to support other relative relocation
types, this is simply a matter of whitelisting these new relocation types
in the same way.

While we're at it, clean up the code a bit, and add a comment explaining
why these relocations are ignored in WriteRelocations64 ().

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit 0b6249f5902f85a9c1a438878b27f8d7ef960a41)
---
 BaseTools/Source/C/GenFw/Elf64Convert.c | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index 90d80a22daf2..fb85b3821b38 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -767,6 +767,9 @@ WriteSections64 (
           case R_AARCH64_LD_PREL_LO19:
           case R_AARCH64_CALL26:
           case R_AARCH64_JUMP26:
+          case R_AARCH64_PREL64:
+          case R_AARCH64_PREL32:
+          case R_AARCH64_PREL16:
             //
             // The GCC toolchains (i.e., binutils) may corrupt section relative
             // relocations when emitting relocation sections into fully linked
@@ -855,20 +858,13 @@ WriteRelocations64 (
 
             switch (ELF_R_TYPE(Rel->r_info)) {
             case R_AARCH64_ADR_PREL_LO21:
-              break;
-
             case R_AARCH64_CONDBR19:
-              break;
-
             case R_AARCH64_LD_PREL_LO19:
-              break;
-
             case R_AARCH64_CALL26:
-              break;
-
             case R_AARCH64_JUMP26:
-              break;
-
+            case R_AARCH64_PREL64:
+            case R_AARCH64_PREL32:
+            case R_AARCH64_PREL16:
             case R_AARCH64_ADR_PREL_PG_HI21:
             case R_AARCH64_ADD_ABS_LO12_NC:
             case R_AARCH64_LDST8_ABS_LO12_NC:
@@ -876,6 +872,12 @@ WriteRelocations64 (
             case R_AARCH64_LDST32_ABS_LO12_NC:
             case R_AARCH64_LDST64_ABS_LO12_NC:
             case R_AARCH64_LDST128_ABS_LO12_NC:
+              //
+              // No fixups are required for relative relocations, provided that
+              // the relative offsets between sections have been preserved in
+              // the ELF to PE/COFF conversion. We have already asserted that
+              // this is the case in WriteSections64 ().
+              //
               break;
 
             case R_AARCH64_ABS64:

From 950f60c4eb622d5a800ee929c479bf8a3fd5b7ed Mon Sep 17 00:00:00 2001
From: edk2 dev <edk2.dev@edk2.org>
Date: Tue, 16 Feb 2016 10:47:30 +0800
Subject: [PATCH 452/525] BaseTools-Source: Update displayed version
 information

Standardize the --version and --help text command-line options

Updated tools to correctly display the Build number when using command-line
option --version and exit successfully after termination.
Ecc was also updated to print informational messages after the options are
parsed.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Larry Hauch <larry.hauch@intel.com>
Reviewed-by: Erik Bjorge <erik.c.bjorge@intel.com>
(cherry picked from commit fbf2338143952da2c63241e51379504a15aa3ea9)
---
 .../Source/C/BootSectImage/bootsectimage.c    | 14 +++++-----
 BaseTools/Source/C/EfiLdrImage/EfiLdrImage.c  | 17 ++++++------
 BaseTools/Source/C/Split/Split.c              | 14 +++++-----
 BaseTools/Source/C/VfrCompile/VfrCompiler.cpp |  8 +++---
 BaseTools/Source/C/VfrCompile/VfrCompiler.h   |  4 +--
 BaseTools/Source/C/VolInfo/VolInfo.c          | 26 ++++++++++++-------
 BaseTools/Source/Python/BPDG/BPDG.py          |  6 ++---
 BaseTools/Source/Python/BPDG/StringTable.py   | 14 +++++-----
 BaseTools/Source/Python/Ecc/Ecc.py            | 11 ++++----
 .../Source/Python/UPT/Logger/StringTable.py   |  6 ++---
 BaseTools/Source/Python/UPT/UPT.py            |  4 +--
 11 files changed, 65 insertions(+), 59 deletions(-)

diff --git a/BaseTools/Source/C/BootSectImage/bootsectimage.c b/BaseTools/Source/C/BootSectImage/bootsectimage.c
index b4fb340c2bb7..453a463f26d4 100644
--- a/BaseTools/Source/C/BootSectImage/bootsectimage.c
+++ b/BaseTools/Source/C/BootSectImage/bootsectimage.c
@@ -4,7 +4,7 @@
   Patch the BPB information in boot sector image file.
   Patch the MBR code in MBR image file.
 
-Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials                          
 are licensed and made available under the terms and conditions of the BSD License         
 which accompanies this distribution.  The full text of the license may be found at        
@@ -33,8 +33,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //
 // Utility version information
 //
-#define UTILITY_MAJOR_VERSION 0
-#define UTILITY_MINOR_VERSION 1
+#define UTILITY_MAJOR_VERSION 1
+#define UTILITY_MINOR_VERSION 0
 
 void
 Version (
@@ -56,10 +56,7 @@ Routine Description:
 
 --*/
 {
-  printf ("%s Version %d.%d %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
-  printf ("Copyright (c) 1999-2014 Intel Corporation. All rights reserved.\n");
-  printf ("\n  The BootSectImage tool prints information or patch destination file by source\n");
-  printf ("  file for BIOS Parameter Block (BPB) or Master Boot Record (MBR).\n");
+  printf ("%s Version %d.%d Build %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
 }
 
 void
@@ -82,6 +79,9 @@ Routine Description:
 --*/
 {
   Version();
+  printf ("Copyright (c) 1999-2016 Intel Corporation. All rights reserved.\n");
+  printf ("\n  The BootSectImage tool prints information or patch destination file by source\n");
+  printf ("  file for BIOS Parameter Block (BPB) or Master Boot Record (MBR).\n");
   printf ("\nUsage: \n\
    BootSectImage\n\
      [-f, --force force patch even if the FAT type of SrcImage and DstImage mismatch]\n\
diff --git a/BaseTools/Source/C/EfiLdrImage/EfiLdrImage.c b/BaseTools/Source/C/EfiLdrImage/EfiLdrImage.c
index 31d697ec5152..79618677f656 100644
--- a/BaseTools/Source/C/EfiLdrImage/EfiLdrImage.c
+++ b/BaseTools/Source/C/EfiLdrImage/EfiLdrImage.c
@@ -6,7 +6,7 @@ FILE := EFILDR_HEADER
         <PeImageFileContent> +
 The order of EFILDR_IMAGE is same as the order of placing PeImageFileContent.
   
-Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials                          
 are licensed and made available under the terms and conditions of the BSD License         
 which accompanies this distribution.  The full text of the license may be found at        
@@ -51,8 +51,8 @@ typedef struct {
 //
 // Utility version information
 //
-#define UTILITY_MAJOR_VERSION 0
-#define UTILITY_MINOR_VERSION 1
+#define UTILITY_MAJOR_VERSION 1
+#define UTILITY_MINOR_VERSION 0
 
 void
 Version (
@@ -74,9 +74,8 @@ Routine Description:
 
 --*/
 {
-  printf ("%s Version %d.%d %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
-  printf ("Copyright (c) 1999-2014 Intel Corporation. All rights reserved.\n");
-  printf ("\n  The EfiLdrImage tool is used to combine PE files into EFILDR image with Efi loader header.\n");
+  printf ("%s Version %d.%d Build %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
+  exit (0);
 }
 
 VOID
@@ -85,7 +84,9 @@ Usage (
   )
 {
   printf ("Usage: EfiLdrImage -o OutImage LoaderImage PeImage1 PeImage2 ... PeImageN\n");
-  exit (1);
+  printf ("%s Version %d.%d Build %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
+  printf ("Copyright (c) 1999-2016 Intel Corporation. All rights reserved.\n");
+  printf ("\n  The EfiLdrImage tool is used to combine PE files into EFILDR image with Efi loader header.\n");
 }
 
 EFI_STATUS
@@ -180,7 +181,7 @@ Routine Description:
   SetUtilityName (UTILITY_NAME);
 
   if (argc == 1) {
-    Usage();
+    printf ("Usage: EfiLdrImage -o OutImage LoaderImage PeImage1 PeImage2 ... PeImageN\n");
     return STATUS_ERROR;
   }
   
diff --git a/BaseTools/Source/C/Split/Split.c b/BaseTools/Source/C/Split/Split.c
index 44a09681d36a..953f5df94fdd 100644
--- a/BaseTools/Source/C/Split/Split.c
+++ b/BaseTools/Source/C/Split/Split.c
@@ -2,7 +2,7 @@
 
   Split a file into two pieces at the request offset.
 
-Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials are licensed and made available
 under the terms and conditions of the BSD License which accompanies this
 distribution.  The full text of the license may be found at
@@ -34,8 +34,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //
 // Utility version information
 //
-#define UTILITY_MAJOR_VERSION 0
-#define UTILITY_MINOR_VERSION 1
+#define UTILITY_MAJOR_VERSION 1
+#define UTILITY_MINOR_VERSION 0
 
 void
 Version (
@@ -57,10 +57,7 @@ Routine Description:
 
 --*/
 {
-  printf ("%s Version %d.%d %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
-  printf ("Copyright (c) 1999-2015 Intel Corporation. All rights reserved.\n");
-  printf ("\n  SplitFile creates two Binary files either in the same directory as the current working\n");
-  printf ("  directory or in the specified directory.\n");
+  printf ("%s Version %d.%d Build %s\n", UTILITY_NAME, UTILITY_MAJOR_VERSION, UTILITY_MINOR_VERSION, __BUILD_VERSION);
 }
 
 void
@@ -83,6 +80,9 @@ Routine Description:
 --*/
 {
   Version();
+  printf ("Copyright (c) 1999-2016 Intel Corporation. All rights reserved.\n");
+  printf ("\n  SplitFile creates two Binary files either in the same directory as the current working\n");
+  printf ("  directory or in the specified directory.\n");
   printf ("\nUsage: \n\
    Split\n\
      -f, --filename inputFile to split\n\
diff --git a/BaseTools/Source/C/VfrCompile/VfrCompiler.cpp b/BaseTools/Source/C/VfrCompile/VfrCompiler.cpp
index 063266a91fa5..c4d77ad15fdf 100644
--- a/BaseTools/Source/C/VfrCompile/VfrCompiler.cpp
+++ b/BaseTools/Source/C/VfrCompile/VfrCompiler.cpp
@@ -2,7 +2,7 @@
   
   VfrCompiler main class and main function.
 
-Copyright (c) 2004 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials                          
 are licensed and made available under the terms and conditions of the BSD License         
 which accompanies this distribution.  The full text of the license may be found at        
@@ -412,8 +412,8 @@ CVfrCompiler::Usage (
   UINT32 Index;
   CONST  CHAR8 *Help[] = {
     " ", 
-    "VfrCompile version " VFR_COMPILER_VERSION __BUILD_VERSION,
-    "Copyright (c) 2004-2014 Intel Corporation. All rights reserved.",
+    "VfrCompile version " VFR_COMPILER_VERSION "Build " __BUILD_VERSION,
+    "Copyright (c) 2004-2016 Intel Corporation. All rights reserved.",
     " ",
     "Usage: VfrCompile [options] VfrFile",
     " ",
@@ -451,7 +451,7 @@ CVfrCompiler::Version (
 {
   UINT32 Index;
   CONST  CHAR8 *Help[] = {
-    "VfrCompile version " VFR_COMPILER_VERSION __BUILD_VERSION,
+    "VfrCompile version " VFR_COMPILER_VERSION "Build " __BUILD_VERSION,
     NULL
     };
   for (Index = 0; Help[Index] != NULL; Index++) {
diff --git a/BaseTools/Source/C/VfrCompile/VfrCompiler.h b/BaseTools/Source/C/VfrCompile/VfrCompiler.h
index 6a6779c0ca47..f61c4836b6bf 100644
--- a/BaseTools/Source/C/VfrCompile/VfrCompiler.h
+++ b/BaseTools/Source/C/VfrCompile/VfrCompiler.h
@@ -2,7 +2,7 @@
   
   VfrCompiler internal defintions.
 
-Copyright (c) 2004 - 2011, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2004 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials                          
 are licensed and made available under the terms and conditions of the BSD License         
 which accompanies this distribution.  The full text of the license may be found at        
@@ -23,7 +23,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include "ParseInf.h"
 
 #define PROGRAM_NAME                       "VfrCompile"
-#define VFR_COMPILER_VERSION               " 2.00 (UEFI 2.4) "
+#define VFR_COMPILER_VERSION               " 2.01 (UEFI 2.4) "
 //
 // This is how we invoke the C preprocessor on the VFR source file
 // to resolve #defines, #includes, etc. To make C source files
diff --git a/BaseTools/Source/C/VolInfo/VolInfo.c b/BaseTools/Source/C/VolInfo/VolInfo.c
index 87e78d48a872..4fa87d41eea0 100644
--- a/BaseTools/Source/C/VolInfo/VolInfo.c
+++ b/BaseTools/Source/C/VolInfo/VolInfo.c
@@ -1,7 +1,7 @@
 /** @file
 The tool dumps the contents of a firmware volume
 
-Copyright (c) 1999 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -46,8 +46,8 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 EFI_GUID  gEfiCrc32GuidedSectionExtractionProtocolGuid = EFI_CRC32_GUIDED_SECTION_EXTRACTION_PROTOCOL_GUID;
 
-#define UTILITY_MAJOR_VERSION      0
-#define UTILITY_MINOR_VERSION      83
+#define UTILITY_MAJOR_VERSION      1
+#define UTILITY_MINOR_VERSION      0
 
 #define UTILITY_NAME         "VolInfo"
 
@@ -168,12 +168,11 @@ Routine Description:
   //
   // Print utility header
   //
-  printf ("%s Version %d.%d %s, %s\n",
+  printf ("%s Version %d.%d Build %s\n",
     UTILITY_NAME,
     UTILITY_MAJOR_VERSION,
     UTILITY_MINOR_VERSION,
-    __BUILD_VERSION,
-    __DATE__
+    __BUILD_VERSION
     );
 
   //
@@ -231,7 +230,7 @@ Routine Description:
   //
   if (argc != 1) {
     Usage ();
-    return -1;
+    return STATUS_ERROR;
   }
   //
   // Look for help options
@@ -239,9 +238,14 @@ Routine Description:
   if ((strcmp(argv[0], "-h") == 0) || (strcmp(argv[0], "--help") == 0) || 
       (strcmp(argv[0], "-?") == 0) || (strcmp(argv[0], "/?") == 0)) {
     Usage();
-    return STATUS_ERROR;
+    return STATUS_SUCCESS;
+  }
+  //
+  // Version has already been printed, return success.
+  //
+  if (strcmp(argv[0], "--version") == 0) {
+    return STATUS_SUCCESS;
   }
-
   //
   // Open the file containing the FV
   //
@@ -1846,7 +1850,7 @@ Routine Description:
   //
   // Copyright declaration
   // 
-  fprintf (stdout, "Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.\n\n");
+  fprintf (stdout, "Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.\n\n");
   fprintf (stdout, "  Display Tiano Firmware Volume FFS image information\n\n");
 
   //
@@ -1857,6 +1861,8 @@ Routine Description:
             Parse basename to file-guid cross reference file(s).\n");
   fprintf (stdout, "  --offset offset\n\
             Offset of file to start processing FV at.\n");
+  fprintf (stdout, "  --version\n\
+            Display version of this tool and exit.\n");
   fprintf (stdout, "  -h, --help\n\
             Show this help message and exit.\n");
 
diff --git a/BaseTools/Source/Python/BPDG/BPDG.py b/BaseTools/Source/Python/BPDG/BPDG.py
index b12403139df0..08e29f055a40 100644
--- a/BaseTools/Source/Python/BPDG/BPDG.py
+++ b/BaseTools/Source/Python/BPDG/BPDG.py
@@ -6,7 +6,7 @@
 #  file of PCD layout for use during the build when the platform integrator selects to use 
 #  automatic offset calculation.
 #
-#  Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -33,7 +33,7 @@
 import GenVpd
 
 PROJECT_NAME       = st.LBL_BPDG_LONG_UNI
-VERSION            = (st.LBL_BPDG_VERSION + " " + gBUILD_VERSION)
+VERSION            = (st.LBL_BPDG_VERSION + " Build " + gBUILD_VERSION)
 
 ## Tool entrance method
 #
@@ -91,7 +91,7 @@ def MyOptionParser():
     #
     # Process command line firstly.
     #
-    parser = OptionParser(version="%s - Version %s\n" % (PROJECT_NAME, VERSION),
+    parser = OptionParser(version="%s - Version %s" % (PROJECT_NAME, VERSION),
                           description='',
                           prog='BPDG',
                           usage=st.LBL_BPDG_USAGE
diff --git a/BaseTools/Source/Python/BPDG/StringTable.py b/BaseTools/Source/Python/BPDG/StringTable.py
index a661da0f9476..56b64b60ff7b 100644
--- a/BaseTools/Source/Python/BPDG/StringTable.py
+++ b/BaseTools/Source/Python/BPDG/StringTable.py
@@ -1,7 +1,7 @@
 ## @file
 # This file is used to define strings used in the BPDG tool
 #
-# Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -32,7 +32,7 @@
 #
 #  This file lists all VPD informations for a platform fixed/adjusted by BPDG tool.
 # 
-# Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2010 -2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -46,14 +46,14 @@
 
 
 LBL_BPDG_LONG_UNI           = (u"Intel(r) Binary Product Data Generation Tool (Intel(r) BPDG)")
-LBL_BPDG_VERSION            = (u"0.1")
+LBL_BPDG_VERSION            = (u"1.0")
 LBL_BPDG_USAGE              = \
 (
-"""
-BPDG options -o Filename.bin -m Filename.map Filename.txt
-Intel(r) Binary Product Data Generation Tool (Intel(r) BPDG)
-Copyright (c) 2010 Intel Corporation All Rights Reserved.
+"""BPDG options -o Filename.bin -m Filename.map Filename.txt
+Copyright (c) 2010 - 2016, Intel Corporation All Rights Reserved.
 
+  Intel(r) Binary Product Data Generation Tool (Intel(r) BPDG)
+  
 Required Flags:
   -o BIN_FILENAME, --vpd-filename=BIN_FILENAME
             Specify the file name for the VPD binary file
diff --git a/BaseTools/Source/Python/Ecc/Ecc.py b/BaseTools/Source/Python/Ecc/Ecc.py
index c2ad4faff446..3fd4f2043bee 100644
--- a/BaseTools/Source/Python/Ecc/Ecc.py
+++ b/BaseTools/Source/Python/Ecc/Ecc.py
@@ -1,7 +1,7 @@
 ## @file
 # This file is used to be the main entrance of ECC tool
 #
-# Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -49,9 +49,9 @@
 class Ecc(object):
     def __init__(self):
         # Version and Copyright
-        self.VersionNumber = ("0.01" + " " + gBUILD_VERSION)
+        self.VersionNumber = ("1.0" + " Build " + gBUILD_VERSION)
         self.Version = "%prog Version " + self.VersionNumber
-        self.Copyright = "Copyright (c) 2009 - 2010, Intel Corporation  All rights reserved."
+        self.Copyright = "Copyright (c) 2009 - 2016, Intel Corporation  All rights reserved."
 
         self.InitDefaultConfigIni()
         self.OutputFile = 'output.txt'
@@ -65,6 +65,7 @@ def __init__(self):
 
         # Parse the options and args
         self.ParseOption()
+        EdkLogger.info(time.strftime("%H:%M:%S, %b.%d %Y ", time.localtime()) + "[00:00]" + "\n")
         
         #
         # Check EFI_SOURCE (Edk build convention). EDK_SOURCE will always point to ECP
@@ -104,7 +105,7 @@ def __init__(self):
         GlobalData.gGlobalDefines["EDK_SOURCE"] = EdkSourceDir
         GlobalData.gGlobalDefines["ECP_SOURCE"] = EcpSourceDir
         
-        
+        EdkLogger.info("Loading ECC configuration ... done")
         # Generate checkpoints list
         EccGlobalData.gConfig = Configuration(self.ConfigFile)
 
@@ -327,7 +328,6 @@ def GetRealPathCase(self, path):
     # Parse options
     #
     def ParseOption(self):
-        EdkLogger.quiet("Loading ECC configuration ... done")
         (Options, Target) = self.EccOptionParser()
 
         if Options.Workspace:
@@ -437,7 +437,6 @@ def EccOptionParser(self):
     # Initialize log system
     EdkLogger.Initialize()
     EdkLogger.IsRaiseError = False
-    EdkLogger.quiet(time.strftime("%H:%M:%S, %b.%d %Y ", time.localtime()) + "[00:00]" + "\n")
 
     StartTime = time.clock()
     Ecc = Ecc()
diff --git a/BaseTools/Source/Python/UPT/Logger/StringTable.py b/BaseTools/Source/Python/UPT/Logger/StringTable.py
index 69e36f3b85c5..c5430735b964 100644
--- a/BaseTools/Source/Python/UPT/Logger/StringTable.py
+++ b/BaseTools/Source/Python/UPT/Logger/StringTable.py
@@ -1,7 +1,7 @@
 ## @file
 # This file is used to define strings used in the UPT tool
 #
-# Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2011 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 # This program and the accompanying materials are licensed and made available 
 # under the terms and conditions of the BSD License which accompanies this 
@@ -39,10 +39,10 @@
 ##
 # Version and Copyright
 #
-MSG_VERSION_NUMBER = _("1.0")
+MSG_VERSION_NUMBER = _("1.1")
 MSG_VERSION = _("UEFI Packaging Tool (UEFIPT) - Revision " + \
                 MSG_VERSION_NUMBER)
-MSG_COPYRIGHT = _("Copyright (c) 2011 - 2015 Intel Corporation All Rights Reserved.")
+MSG_COPYRIGHT = _("Copyright (c) 2011 - 2016 Intel Corporation All Rights Reserved.")
 MSG_VERSION_COPYRIGHT = _("\n  %s\n  %s" % (MSG_VERSION, MSG_COPYRIGHT))
 MSG_USAGE = _("%s [options]\n%s" % ("UPT", MSG_VERSION_COPYRIGHT))
 MSG_DESCRIPTION = _("The UEFIPT is used to create, " + \
diff --git a/BaseTools/Source/Python/UPT/UPT.py b/BaseTools/Source/Python/UPT/UPT.py
index 17decda5c3e6..b64cc2cf3b32 100644
--- a/BaseTools/Source/Python/UPT/UPT.py
+++ b/BaseTools/Source/Python/UPT/UPT.py
@@ -2,7 +2,7 @@
 #
 # This file is the main entry for UPT 
 #
-# Copyright (c) 2011 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2011 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 # This program and the accompanying materials are licensed and made available 
 # under the terms and conditions of the BSD License which accompanies this 
@@ -99,7 +99,7 @@ def SetLogLevel(Opt):
 def Main():
     Logger.Initialize()
 
-    Parser = OptionParser(version=(MSG_VERSION + ' ' + gBUILD_VERSION), description=MSG_DESCRIPTION,
+    Parser = OptionParser(version=(MSG_VERSION + ' Build ' + gBUILD_VERSION), description=MSG_DESCRIPTION,
                           prog="UPT.exe", usage=MSG_USAGE)
 
     Parser.add_option("-d", "--debug", action="store", type="int", dest="debug_level", help=ST.HLP_PRINT_DEBUG_INFO)

From 29bda2b678457618ddef33e4db827ba8340ef606 Mon Sep 17 00:00:00 2001
From: Michael LeMay <michael.lemay@intel.com>
Date: Fri, 29 Jan 2016 11:23:21 +0800
Subject: [PATCH 453/525] BaseTools/GenFw: Exit with error when header lookup
 fails

This patch revises GetPhdrByIndex and GetShdrByIndex to cause GenFw to
exit with an error message when a section header lookup fails.  The
current behavior of those functions in such circumstances is to return
NULL, which can cause GenFw to subsequently fault when it attempts to
dereference the null pointer.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael LeMay <michael.lemay@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>
(cherry picked from commit 17751c5fa473fd4f830007590d59e8d15a2d2935)
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 10 +++++++---
 BaseTools/Source/C/GenFw/Elf64Convert.c |  7 +++++--
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index 9bf58555c076..dbdf05671bd1 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -191,8 +191,11 @@ GetShdrByIndex (
   UINT32 Num
   )
 {
-  if (Num >= mEhdr->e_shnum)
-    return NULL;
+  if (Num >= mEhdr->e_shnum) {
+    Error (NULL, 0, 3000, "Invalid", "GetShdrByIndex: Index %u is too high.", Num);
+    exit(EXIT_FAILURE);
+  }
+
   return (Elf_Shdr*)((UINT8*)mShdrBase + Num * mEhdr->e_shentsize);
 }
 
@@ -203,7 +206,8 @@ GetPhdrByIndex (
   )
 {
   if (num >= mEhdr->e_phnum) {
-    return NULL;
+    Error (NULL, 0, 3000, "Invalid", "GetPhdrByIndex: Index %u is too high.", num);
+    exit(EXIT_FAILURE);
   }
 
   return (Elf_Phdr *)((UINT8*)mPhdrBase + num * mEhdr->e_phentsize);
diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index fb85b3821b38..974f3ca53a3e 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -197,8 +197,11 @@ GetShdrByIndex (
   UINT32 Num
   )
 {
-  if (Num >= mEhdr->e_shnum)
-    return NULL;
+  if (Num >= mEhdr->e_shnum) {
+    Error (NULL, 0, 3000, "Invalid", "GetShdrByIndex: Index %u is too high.", Num);
+    exit(EXIT_FAILURE);
+  }
+
   return (Elf_Shdr*)((UINT8*)mShdrBase + Num * mEhdr->e_shentsize);
 }
 

From 8686dac588656ebe5024e72ad93ec0b19615778f Mon Sep 17 00:00:00 2001
From: Michael LeMay <michael.lemay@intel.com>
Date: Fri, 29 Jan 2016 12:17:13 +0800
Subject: [PATCH 454/525] BaseTools/GenFw: Enhance error message for bad symbol
 definitions

This patch expands the error message that is output when GenFw
encounters a bad symbol definition or an unsupported symbol type.  It
displays the symbol name, the symbol address, and a message that
describes both possibilities (bad symbol definition or unsupported
symbol type).  It also provides two examples of unsupported symbol
types.

Furthermore, this patch revises the conditional for detecting bad
symbol definitions to eliminate a redundant test (a Sym->st_shndx
value of SHN_ABS should certainly be greater than mEhdr->e_shnum) and
to change another test from 'Sym->st_shndx > mEhdr->e_shnum' to
'Sym->st_shndx >= mEhdr->e_shnum' for consistency with the test in
GetShdrByIndex.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael LeMay <michael.lemay@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>
(cherry picked from commit 621bb723a4e00cb93e8a94c6126de4976dde1d9e)
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 62 +++++++++++++++++++++++--
 BaseTools/Source/C/GenFw/Elf64Convert.c | 62 +++++++++++++++++++++++--
 BaseTools/Source/C/GenFw/ElfConvert.h   |  1 +
 3 files changed, 119 insertions(+), 6 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index dbdf05671bd1..41091e0888ba 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -266,6 +266,53 @@ IsDataShdr (
   return (BOOLEAN) (Shdr->sh_flags & (SHF_WRITE | SHF_ALLOC)) == (SHF_ALLOC | SHF_WRITE);
 }
 
+STATIC
+BOOLEAN
+IsStrtabShdr (
+  Elf_Shdr *Shdr
+  )
+{
+  Elf_Shdr *Namedr = GetShdrByIndex(mEhdr->e_shstrndx);
+
+  return (BOOLEAN) (strcmp((CHAR8*)mEhdr + Namedr->sh_offset + Shdr->sh_name, ELF_STRTAB_SECTION_NAME) == 0);
+}
+
+STATIC
+Elf_Shdr *
+FindStrtabShdr (
+  VOID
+  )
+{
+  UINT32 i;
+  for (i = 0; i < mEhdr->e_shnum; i++) {
+    Elf_Shdr *shdr = GetShdrByIndex(i);
+    if (IsStrtabShdr(shdr)) {
+      return shdr;
+    }
+  }
+  return NULL;
+}
+
+STATIC
+const UINT8 *
+GetSymName (
+  Elf_Sym *Sym
+  )
+{
+  if (Sym->st_name == 0) {
+    return NULL;
+  }
+
+  Elf_Shdr *StrtabShdr = FindStrtabShdr();
+  if (StrtabShdr == NULL) {
+    return NULL;
+  }
+
+  assert(Sym->st_name < StrtabShdr->sh_size);
+
+  return (UINT8*)mEhdr + StrtabShdr->sh_offset + Sym->st_name;
+}
+
 //
 // Elf functions interface implementation
 //
@@ -671,9 +718,18 @@ WriteSections32 (
         // header location.
         //
         if (Sym->st_shndx == SHN_UNDEF
-            || Sym->st_shndx == SHN_ABS
-            || Sym->st_shndx > mEhdr->e_shnum) {
-          Error (NULL, 0, 3000, "Invalid", "%s bad symbol definition.", mInImageName);
+            || Sym->st_shndx >= mEhdr->e_shnum) {
+          const UINT8 *SymName = GetSymName(Sym);
+          if (SymName == NULL) {
+            SymName = (const UINT8 *)"<unknown>";
+          }
+
+          Error (NULL, 0, 3000, "Invalid",
+                 "%s: Bad definition for symbol '%s'@%p or unsupported symbol type.  "
+                 "For example, absolute and undefined symbols are not supported.",
+                 mInImageName, SymName, Sym->st_value);
+
+          exit(EXIT_FAILURE);
         }
         SymShdr = GetShdrByIndex(Sym->st_shndx);
 
diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index 974f3ca53a3e..5afd2ab7cab3 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -258,6 +258,53 @@ IsDataShdr (
   return (BOOLEAN) (Shdr->sh_flags & (SHF_WRITE | SHF_ALLOC)) == (SHF_ALLOC | SHF_WRITE);
 }
 
+STATIC
+BOOLEAN
+IsStrtabShdr (
+  Elf_Shdr *Shdr
+  )
+{
+  Elf_Shdr *Namedr = GetShdrByIndex(mEhdr->e_shstrndx);
+
+  return (BOOLEAN) (strcmp((CHAR8*)mEhdr + Namedr->sh_offset + Shdr->sh_name, ELF_STRTAB_SECTION_NAME) == 0);
+}
+
+STATIC
+Elf_Shdr *
+FindStrtabShdr (
+  VOID
+  )
+{
+  UINT32 i;
+  for (i = 0; i < mEhdr->e_shnum; i++) {
+    Elf_Shdr *shdr = GetShdrByIndex(i);
+    if (IsStrtabShdr(shdr)) {
+      return shdr;
+    }
+  }
+  return NULL;
+}
+
+STATIC
+const UINT8 *
+GetSymName (
+  Elf_Sym *Sym
+  )
+{
+  if (Sym->st_name == 0) {
+    return NULL;
+  }
+
+  Elf_Shdr *StrtabShdr = FindStrtabShdr();
+  if (StrtabShdr == NULL) {
+    return NULL;
+  }
+
+  assert(Sym->st_name < StrtabShdr->sh_size);
+
+  return (UINT8*)mEhdr + StrtabShdr->sh_offset + Sym->st_name;
+}
+
 //
 // Elf functions interface implementation
 //
@@ -667,9 +714,18 @@ WriteSections64 (
         // header location.
         //
         if (Sym->st_shndx == SHN_UNDEF
-            || Sym->st_shndx == SHN_ABS
-            || Sym->st_shndx > mEhdr->e_shnum) {
-          Error (NULL, 0, 3000, "Invalid", "%s bad symbol definition.", mInImageName);
+            || Sym->st_shndx >= mEhdr->e_shnum) {
+          const UINT8 *SymName = GetSymName(Sym);
+          if (SymName == NULL) {
+            SymName = (const UINT8 *)"<unknown>";
+          }
+
+          Error (NULL, 0, 3000, "Invalid",
+                 "%s: Bad definition for symbol '%s'@%p or unsupported symbol type.  "
+                 "For example, absolute and undefined symbols are not supported.",
+                 mInImageName, SymName, Sym->st_value);
+
+          exit(EXIT_FAILURE);
         }
         SymShdr = GetShdrByIndex(Sym->st_shndx);
 
diff --git a/BaseTools/Source/C/GenFw/ElfConvert.h b/BaseTools/Source/C/GenFw/ElfConvert.h
index 56f165eae59b..abf434dd11c8 100644
--- a/BaseTools/Source/C/GenFw/ElfConvert.h
+++ b/BaseTools/Source/C/GenFw/ElfConvert.h
@@ -34,6 +34,7 @@ extern UINT32 mOutImageType;
 // Common EFI specific data.
 //
 #define ELF_HII_SECTION_NAME ".hii"
+#define ELF_STRTAB_SECTION_NAME ".strtab"
 #define MAX_COFF_ALIGNMENT 0x10000
 
 //

From ca8c81a859ea65df818cb34fa0c73911f031aafb Mon Sep 17 00:00:00 2001
From: Michael LeMay <michael.lemay@intel.com>
Date: Fri, 29 Jan 2016 09:53:47 -0800
Subject: [PATCH 455/525] BaseTools/GenFw: Correct datatypes in diagnostic
 messages and check for string termination

This patch revises multiple diagnostic messages to use correct
datatypes.  It also checks that a symbol name that is about to be used
in a diagnostic message is terminated by a null character within the
contents of the string table section so that the print routine does
not read past the end of the string table section contents when
reading the symbol name.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael LeMay <michael.lemay@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>
(cherry picked from commit ea3e924a0c91e2dd7fbb5e2f79899367222f27eb)
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 15 ++++++++++++---
 BaseTools/Source/C/GenFw/Elf64Convert.c | 15 ++++++++++++---
 2 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index 41091e0888ba..d115291b062c 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -21,6 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <io.h>
 #endif
 #include <assert.h>
+#include <stdbool.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -310,7 +311,15 @@ GetSymName (
 
   assert(Sym->st_name < StrtabShdr->sh_size);
 
-  return (UINT8*)mEhdr + StrtabShdr->sh_offset + Sym->st_name;
+  UINT8* StrtabContents = (UINT8*)mEhdr + StrtabShdr->sh_offset;
+
+  bool foundEnd = false;
+  for (UINT32 i = Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
+    foundEnd = StrtabContents[i] == 0;
+  }
+  assert(foundEnd);
+
+  return StrtabContents + Sym->st_name;
 }
 
 //
@@ -539,7 +548,7 @@ ScanSections32 (
     NtHdr->Pe32.OptionalHeader.Magic = EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC;
     break;
   default:
-    VerboseMsg ("%s unknown e_machine type. Assume IA-32", (UINTN)mEhdr->e_machine);
+    VerboseMsg ("%s unknown e_machine type %hu. Assume IA-32", mInImageName, mEhdr->e_machine);
     NtHdr->Pe32.FileHeader.Machine = EFI_IMAGE_MACHINE_IA32;
     NtHdr->Pe32.OptionalHeader.Magic = EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC;
   }
@@ -725,7 +734,7 @@ WriteSections32 (
           }
 
           Error (NULL, 0, 3000, "Invalid",
-                 "%s: Bad definition for symbol '%s'@%p or unsupported symbol type.  "
+                 "%s: Bad definition for symbol '%s'@%#x or unsupported symbol type.  "
                  "For example, absolute and undefined symbols are not supported.",
                  mInImageName, SymName, Sym->st_value);
 
diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index 5afd2ab7cab3..3b5f63010388 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -21,6 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include <io.h>
 #endif
 #include <assert.h>
+#include <stdbool.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -302,7 +303,15 @@ GetSymName (
 
   assert(Sym->st_name < StrtabShdr->sh_size);
 
-  return (UINT8*)mEhdr + StrtabShdr->sh_offset + Sym->st_name;
+  UINT8* StrtabContents = (UINT8*)mEhdr + StrtabShdr->sh_offset;
+
+  bool foundEnd = false;
+  for (UINT32 i = Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
+    foundEnd = StrtabContents[i] == 0;
+  }
+  assert(foundEnd);
+
+  return StrtabContents + Sym->st_name;
 }
 
 //
@@ -337,7 +346,7 @@ ScanSections64 (
     mCoffOffset += sizeof (EFI_IMAGE_NT_HEADERS64);
   break;
   default:
-    VerboseMsg ("%s unknown e_machine type. Assume X64", (UINTN)mEhdr->e_machine);
+    VerboseMsg ("%s unknown e_machine type %hu. Assume X64", mInImageName, mEhdr->e_machine);
     mCoffOffset += sizeof (EFI_IMAGE_NT_HEADERS64);
   break;
   }
@@ -721,7 +730,7 @@ WriteSections64 (
           }
 
           Error (NULL, 0, 3000, "Invalid",
-                 "%s: Bad definition for symbol '%s'@%p or unsupported symbol type.  "
+                 "%s: Bad definition for symbol '%s'@%#llx or unsupported symbol type.  "
                  "For example, absolute and undefined symbols are not supported.",
                  mInImageName, SymName, Sym->st_value);
 

From e49bfe75abda5a2070ff6d9f9a0a4a1e57dad078 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Wed, 17 Feb 2016 16:57:44 +0800
Subject: [PATCH 456/525] BaseTools/GenFw: Fix a bug for GCC build

current GCC build report error: 'for' loop initial declarations are only
allowed in C99 or C11 mode, the patch fix this failure.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit a754c70ceec880038f0e61e413398e96468b34f1)
---
 BaseTools/Source/C/GenFw/Elf32Convert.c | 3 ++-
 BaseTools/Source/C/GenFw/Elf64Convert.c | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/BaseTools/Source/C/GenFw/Elf32Convert.c b/BaseTools/Source/C/GenFw/Elf32Convert.c
index d115291b062c..8fca7fba2a25 100644
--- a/BaseTools/Source/C/GenFw/Elf32Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf32Convert.c
@@ -314,7 +314,8 @@ GetSymName (
   UINT8* StrtabContents = (UINT8*)mEhdr + StrtabShdr->sh_offset;
 
   bool foundEnd = false;
-  for (UINT32 i = Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
+  UINT32 i;
+  for (i = Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
     foundEnd = StrtabContents[i] == 0;
   }
   assert(foundEnd);
diff --git a/BaseTools/Source/C/GenFw/Elf64Convert.c b/BaseTools/Source/C/GenFw/Elf64Convert.c
index 3b5f63010388..024a2a0d5357 100644
--- a/BaseTools/Source/C/GenFw/Elf64Convert.c
+++ b/BaseTools/Source/C/GenFw/Elf64Convert.c
@@ -306,7 +306,8 @@ GetSymName (
   UINT8* StrtabContents = (UINT8*)mEhdr + StrtabShdr->sh_offset;
 
   bool foundEnd = false;
-  for (UINT32 i = Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
+  UINT32 i;
+  for (i= Sym->st_name; (i < StrtabShdr->sh_size) && !foundEnd; i++) {
     foundEnd = StrtabContents[i] == 0;
   }
   assert(foundEnd);

From 74ec05b5fe90ebfb783d57ca5abcdc2c23960d9e Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Wed, 17 Feb 2016 14:48:28 +0800
Subject: [PATCH 457/525] BaseTools: report an error message when failed to
 start build command
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

when build.py was failing to build packages but was not providing any
error message except for “Failed to start command.” this patch provide
the error message.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit 790f60f22efb829903b6d308decaa4b1506ab928)
---
 BaseTools/Source/Python/build/build.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/BaseTools/Source/Python/build/build.py b/BaseTools/Source/Python/build/build.py
index 3cd385d69d99..5253cb48f95d 100644
--- a/BaseTools/Source/Python/build/build.py
+++ b/BaseTools/Source/Python/build/build.py
@@ -2,7 +2,7 @@
 # build a platform or a module
 #
 #  Copyright (c) 2014, Hewlett-Packard Development Company, L.P.<BR>
-#  Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -287,6 +287,7 @@ def LaunchCommand(Command, WorkingDir):
         Proc.wait()
     except: # in case of aborting
         # terminate the threads redirecting the program output
+        EdkLogger.quiet("(Python %s on %s) " % (platform.python_version(), sys.platform) + traceback.format_exc())
         if EndOfProcedure != None:
             EndOfProcedure.set()
         if Proc == None:

From a5b41f761d91ddda9934be850ddd54a8dff2363c Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Wed, 17 Feb 2016 11:24:47 +0800
Subject: [PATCH 458/525] BaseTools/VolInfo: add some generic options

The Help information provided by VolInfo does not follow the EDK II Tools
Design doc, so this patch update the help text and add the generic
options: -d, -v, -q, -s.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit 730ffca1943d8965f68faa55216ba5857635bcd2)
---
 BaseTools/Source/C/VolInfo/VolInfo.c | 141 ++++++++++++++++++---------
 1 file changed, 94 insertions(+), 47 deletions(-)

diff --git a/BaseTools/Source/C/VolInfo/VolInfo.c b/BaseTools/Source/C/VolInfo/VolInfo.c
index 4fa87d41eea0..4fb634fe099b 100644
--- a/BaseTools/Source/C/VolInfo/VolInfo.c
+++ b/BaseTools/Source/C/VolInfo/VolInfo.c
@@ -39,6 +39,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 #include "OsPath.h"
 #include "ParseGuidedSectionTools.h"
 #include "StringFuncs.h"
+#include "ParseInf.h"
 
 //
 // Utility global variables
@@ -163,6 +164,7 @@ Routine Description:
   EFI_STATUS                  Status;
   int                         Offset;
   BOOLEAN                     ErasePolarity;
+  UINT64                      LogLevel;
 
   SetUtilityName (UTILITY_NAME);
   //
@@ -175,28 +177,46 @@ Routine Description:
     __BUILD_VERSION
     );
 
-  //
-  // Save, and then skip filename arg
-  //
-  mUtilityFilename = argv[0];
+  if (argc == 1) {
+    Usage ();
+    return -1;
+  }
+
   argc--;
   argv++;
-
+  LogLevel = 0;
   Offset = 0;
 
+  //
+  // Look for help options
+  //
+  if ((strcmp(argv[0], "-h") == 0) || (strcmp(argv[0], "--help") == 0) ||
+      (strcmp(argv[0], "-?") == 0) || (strcmp(argv[0], "/?") == 0)) {
+    Usage();
+    return  STATUS_SUCCESS;
+  }
+  //
+  // Version has already be printed, so just return success
+  //
+  if (strcmp(argv[0], "--version") == 0) {
+    return  STATUS_SUCCESS;
+  }
+
   //
   // If they specified -x xref guid/basename cross-reference files, process it.
   // This will print the basename beside each file guid. To use it, specify
   // -x xref_filename to processdsc, then use xref_filename as a parameter
   // here.
   //
-  while (argc > 2) {
+  while (argc > 0) {
     if ((strcmp(argv[0], "-x") == 0) || (strcmp(argv[0], "--xref") == 0)) {
       ParseGuidBaseNameFile (argv[1]);
       printf("ParseGuidBaseNameFile: %s\n", argv[1]);
       argc -= 2;
       argv += 2;
-    } else if (strcmp(argv[0], "--offset") == 0) {
+      continue;
+    }
+    if (strcmp(argv[0], "--offset") == 0) {
       //
       // Hex or decimal?
       //
@@ -220,38 +240,55 @@ Routine Description:
 
       argc -= 2;
       argv += 2;
-    } else {
-      Usage ();
-      return -1;
+      continue;
     }
+
+    if ((stricmp (argv[0], "-v") == 0) || (stricmp (argv[0], "--verbose") == 0)) {
+      SetPrintLevel (VERBOSE_LOG_LEVEL);
+      argc --;
+      argv ++;
+      continue;
+    }
+
+    if ((stricmp (argv[0], "-q") == 0) || (stricmp (argv[0], "--quiet") == 0)) {
+      SetPrintLevel (KEY_LOG_LEVEL);
+      argc --;
+      argv ++;
+      continue;
+    }
+
+    if ((stricmp (argv[0], "-d") == 0) || (stricmp (argv[0], "--debug") == 0)) {
+      Status = AsciiStringToUint64 (argv[1], FALSE, &LogLevel);
+      if (EFI_ERROR (Status)) {
+        Error (NULL, 0, 1003, "Invalid option value", "%s = %s", argv[0], argv[1]);
+        return -1;
+      }
+      if (LogLevel > 9) {
+        Error (NULL, 0, 1003, "Invalid option value", "Debug Level range is 0-9, current input level is %d", (int) LogLevel);
+        return -1;
+      }
+      SetPrintLevel (LogLevel);
+      DebugMsg (NULL, 0, 9, "Debug Mode Set", "Debug Output Mode Level %s is set!", argv[1]);
+      argc -= 2;
+      argv += 2;
+      continue;
+    }
+
+    mUtilityFilename = argv[0];
+    argc --;
+    argv ++;
   }
-  //
-  // Check for proper number of arguments
-  //
-  if (argc != 1) {
-    Usage ();
-    return STATUS_ERROR;
-  }
-  //
-  // Look for help options
-  //
-  if ((strcmp(argv[0], "-h") == 0) || (strcmp(argv[0], "--help") == 0) || 
-      (strcmp(argv[0], "-?") == 0) || (strcmp(argv[0], "/?") == 0)) {
-    Usage();
-    return STATUS_SUCCESS;
-  }
-  //
-  // Version has already been printed, return success.
-  //
-  if (strcmp(argv[0], "--version") == 0) {
-    return STATUS_SUCCESS;
-  }
+
   //
   // Open the file containing the FV
   //
-  InputFile = fopen (LongFilePath (argv[0]), "rb");
+  if (mUtilityFilename == NULL) {
+    Error (NULL, 0, 1001, "Missing option", "Input files are not specified");
+    return GetUtilityStatus ();
+  }
+  InputFile = fopen (LongFilePath (mUtilityFilename), "rb");
   if (InputFile == NULL) {
-    Error (NULL, 0, 0001, "Error opening the input file", argv[0]);
+    Error (NULL, 0, 0001, "Error opening the input file", mUtilityFilename);
     return GetUtilityStatus ();
   }
   //
@@ -266,7 +303,7 @@ Routine Description:
   //
   Status = ReadHeader (InputFile, &FvSize, &ErasePolarity);
   if (EFI_ERROR (Status)) {
-    Error (NULL, 0, 0003, "error parsing FV image", "%s Header is invalid", argv[0]);
+    Error (NULL, 0, 0003, "error parsing FV image", "%s Header is invalid", mUtilityFilename);
     fclose (InputFile);
     return GetUtilityStatus ();
   }
@@ -286,12 +323,12 @@ Routine Description:
   BytesRead = fread (FvImage, 1, FvSize, InputFile);
   fclose (InputFile);
   if ((unsigned int) BytesRead != FvSize) {
-    Error (NULL, 0, 0004, "error reading FvImage from", argv[0]);
+    Error (NULL, 0, 0004, "error reading FvImage from", mUtilityFilename);
     free (FvImage);
     return GetUtilityStatus ();
   }
 
-  LoadGuidedSectionToolsTxt (argv[0]);
+  LoadGuidedSectionToolsTxt (mUtilityFilename);
 
   PrintFvInfo (FvImage, FALSE);
 
@@ -1291,8 +1328,7 @@ Routine Description:
       break;
 
     case EFI_SECTION_USER_INTERFACE:
-      // name = &((EFI_USER_INTERFACE_SECTION *) Ptr)->FileNameString;
-      // printf ("  String: %s\n", &name);
+      printf ("  String: %ls\n", (CHAR16 *) &((EFI_USER_INTERFACE_SECTION *) Ptr)->FileNameString);
       break;
 
     case EFI_SECTION_FIRMWARE_VOLUME_IMAGE:
@@ -1856,15 +1892,26 @@ Routine Description:
   //
   // Details Option
   //
-  fprintf (stdout, "Options:\n");
-  fprintf (stdout, "  -x xref, --xref xref\n\
-            Parse basename to file-guid cross reference file(s).\n");
-  fprintf (stdout, "  --offset offset\n\
-            Offset of file to start processing FV at.\n");
-  fprintf (stdout, "  --version\n\
-            Display version of this tool and exit.\n");
+  fprintf (stdout, "optional arguments:\n");
   fprintf (stdout, "  -h, --help\n\
-            Show this help message and exit.\n");
-
+            Show this help message and exit\n");
+  fprintf (stdout, "  --version\n\
+           Show program's version number and exit\n");
+  fprintf (stdout, "  -d [DEBUG], --debug [DEBUG]\n\
+            Output DEBUG statements, where DEBUG_LEVEL is 0 (min) - 9 (max)\n");
+  fprintf (stdout, "  -v, --verbose\n\
+            Print informational statements\n");
+  fprintf (stdout, "  -q, --quiet\n\
+            Returns the exit code, error messages will be displayed\n");
+  fprintf (stdout, "  -s, --silent\n\
+            Returns only the exit code; informational and error\n\
+            messages are not displayed\n");
+  fprintf (stdout, "  -x XREF_FILENAME, --xref XREF_FILENAME\n\
+            Parse the basename to file-guid cross reference file(s)\n");
+  fprintf (stdout, "  -f OFFSET, --offset OFFSET\n\
+            The offset from the start of the input file to start \n\
+            processing an FV\n");
+  fprintf (stdout, "  --sfo\n\
+            Reserved for future use\n");
 }
 

From 8c7c7414c0f9b4c2404a31a4c4c7f34469285ff9 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Sun, 14 Feb 2016 08:17:16 +0100
Subject: [PATCH 459/525] BaseTools: LzmaCompress: fix gcc-6 warning
 "misleading-indentation"

The way the first use of the "_maxMode" variable is commented out (i.e.,
together with the enclosing "if" statement) in GetOptimum() triggers the
"misleading-indentation" warning that is new in gcc-6.0, for the block of
code that originally depended on the "if" statement. Gcc believes
(mistakenly) that the programmer believes (mistakenly) that the block
depends on (repIndex == 0) higher up.

Restore the if statement, with a controlling expression that comprises the
constant 1 and "_maxMode" commented out.

Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Cole Robinson <crobinso@redhat.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Yonghong Zhu <yonghong.zhu@intel.com>
Reported-by: Cole Robinson <crobinso@redhat.com>
Suggested-by: Jordan Justen <jordan.l.justen@intel.com>
Build-tested-by: Cole Robinson <crobinso@redhat.com>
Ref: https://bugzilla.redhat.com/show_bug.cgi?id=1307439
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit 6cc7ada465a7c5a6dab6e32abd5a4b6f1734c1d0)
---
 BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
index 9b2dd16ffa48..c6717eeea3a0 100644
--- a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
+++ b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
@@ -1367,7 +1367,7 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
       if (repIndex == 0)
         startLen = lenTest + 1;
         
-      /* if (_maxMode) */
+      if (1 /* _maxMode */)
         {
           UInt32 lenTest2 = lenTest + 1;
           UInt32 limit = lenTest2 + p->numFastBytes;

From 51ffc53f4ab7b454754b29981eba081335804485 Mon Sep 17 00:00:00 2001
From: Larry Hauch <larry.hauch@intel.com>
Date: Mon, 8 Feb 2016 15:18:27 -0800
Subject: [PATCH 460/525] BaseTools/Conf/XMLSchema: Reformat XML using Visual
 Studio 2013

There are no functional changes in this patch.
The only change is to the XML format, updated using Visual Studio
Edit->Advanced->Format Document.

Different XML Schema editors use different formats for indentation and
line breaks. Visual Studio 2013 uses a two space indentation for content.

Cc: Zhu Yonghong <yonghong.zhu@intel.com>

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Larry Hauch <larry.hauch@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>
(cherry picked from commit cbf14fa0845d118a85cb691a02f3793ffce45e82)
---
 .../Conf/XMLSchema/DistributionPackage.xsd    | 5735 +++++++++--------
 1 file changed, 3080 insertions(+), 2655 deletions(-)

diff --git a/BaseTools/Conf/XMLSchema/DistributionPackage.xsd b/BaseTools/Conf/XMLSchema/DistributionPackage.xsd
index 5fbbd59f93c7..6e31d2def1df 100644
--- a/BaseTools/Conf/XMLSchema/DistributionPackage.xsd
+++ b/BaseTools/Conf/XMLSchema/DistributionPackage.xsd
@@ -14,2754 +14,3179 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 -->
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
     targetNamespace="http://www.uefi.org/2012/1.0" xmlns="http://www.uefi.org/2012/1.0">
-    <xs:element name="DistributionPackage">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> This schema defines the UEFI/PI Distribution Package description (PKG)
-                file. It describes the content of:</xs:documentation>
-            <xs:documentation xml:lang="en-us"> 1) Package descriptions with definitions and headers.</xs:documentation>
-            <xs:documentation xml:lang="en-us"> 2) Modules in either source or binary format. (Note that Binary format
-                is for FFS leaf section file types only, complete FFS files cannot be distributed using this
-                distribution format.) </xs:documentation>
-            <xs:documentation xml:lang="en-us"> 3) The distribution of custom tools used to modify the binary images to
-                create UEFI/PI compliant images. </xs:documentation>
-            <xs:documentation xml:lang="en-us"> 4) Finally, it can be used to distribute other miscellaneous content
-                that is not specific to UEFI/PI images. </xs:documentation>
-            <xs:documentation xml:lang="en-us"> The Package Surface Area describes the content of packages, while the
-                Module Surface Area provides information relevant to source and/or binary distributions.
+  <xs:element name="DistributionPackage">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        This schema defines the UEFI/PI Distribution Package description (PKG)
+        file. It describes the content of:
+      </xs:documentation>
+      <xs:documentation xml:lang="en-us"> 1) Package descriptions with definitions and headers.</xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        2) Modules in either source or binary format. (Note that Binary format
+        is for FFS leaf section file types only, complete FFS files cannot be distributed using this
+        distribution format.)
+      </xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        3) The distribution of custom tools used to modify the binary images to
+        create UEFI/PI compliant images.
+      </xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        4) Finally, it can be used to distribute other miscellaneous content
+        that is not specific to UEFI/PI images.
+      </xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        The Package Surface Area describes the content of packages, while the
+        Module Surface Area provides information relevant to source and/or binary distributions.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="DistributionHeader" minOccurs="1" maxOccurs="1">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This header contains (legal) information usually required
+              for distributing both binary and/or source code.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element ref="PackageSurfaceArea" minOccurs="0" maxOccurs="unbounded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us"> The list of packages in this distribution. </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Packages are groups of files and/or modules that are similar
+              in nature.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Packages are uniquely identified by a package GUID and a
+              package version.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              A package can declare public mappings of C names to GUID
+              values.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              A package can provide header files for library classes
+              and/or other industry standard definitions.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              A package can also declare public mappings of platform
+              configuration database (PCD) &quot;knobs&quot; to control features and operation of modules
+              within a platform.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Finally, a package lists the library instances and/or
+              modules that are provided in a distribution package.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element ref="ModuleSurfaceArea" minOccurs="0" maxOccurs="unbounded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The listing of UEFI/PI compliant modules in this
+              distribution that are NOT part of a Package. Every module that is provided as part of a
+              package needs to be described in a PackageSurfaceArea.Modules section.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              The ModuleSurfaceArea section describes how each module in a
+              distribution is coded, or, in the case of a binary module distribution, how it was built.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              UEFI/PI compliant libraries and modules are uniquely
+              identified by the Module's GUID and version number.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              This section will typically be used for modules that don't
+              require any additional files that would be included in a package. For example, the Enhanced
+              FAT driver binary does not need to have a package description, as no additional files are
+              provided.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element ref="Tools" minOccurs="0" maxOccurs="unbounded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is for distributing vendor specific executable
+              tools, tool source code and/or configuration files. These tools are primarily for
+              manipulating code and/or binary images.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us"> Tools in this section can:</xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              1) Parse build meta-data files to create source code files
+              and build scripts.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us"> 2) Modify image files to conform to UEFI/PI specifications. </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              3) Generate binary files from certain types of text/unicode
+              files.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us"> 4) Generate PCI Option Roms or Firmware Device images. </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              5) Implement external encoding/decoding/signature/GUIDed
+              tools.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              6) Distribution Package create/install/remove tools.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element ref="MiscellaneousFiles" minOccurs="0" maxOccurs="unbounded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The list of miscellaneous files in this distribution. Any
+              files that are not listed in either the Package, Module or Tools sections can be listed
+              here. This section can be used to distribute specifications for packages and modules that
+              are not &quot;industry standards&quot; such as a specification for a chipset or a video
+              device.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element ref="UserExtensions" minOccurs="0" maxOccurs="unbounded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The UserExtensions section is used to disseminate processing
+              instructions that may be custom to the content provided by the distribution. This section
+              contains information that is common to all aspects of this disribution.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+      </xs:sequence>
+
+    </xs:complexType>
+  </xs:element>
+  <!-- End of the DistributionPackage Description  -->
+
+  <xs:element name="DistributionHeader">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        This section defines the content of the UEIF/PI compliant Distribution
+        Package Header. This is the only required element of a UEFI/PI compliant distribution package.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="1" maxOccurs="1" name="Name">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the User Interface Name for this Distribution
+              Package.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Each Distribution Package is uniquely identified by it's
+              GUID and Version number.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:normalizedString">
+                <xs:attribute name="BaseName" type="xs:NMTOKEN" use="optional">
+                  <xs:annotation>
+                    <xs:documentation xml:lang="en-us">
+                      The reference name of the Distribution
+                      Package file. This single word name can be used by tools as a keyword or for
+                      directory and/or file creation.
+                    </xs:documentation>
+                    <xs:documentation xml:lang="en-us">
+                      White space and special characters (dash and
+                      underscore characters may be used) are not permitted in this name.
+                    </xs:documentation>
+                  </xs:annotation>
+                </xs:attribute>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This 128-bit GUID and the Version attribute uniquely
+              identify this Distribution Package.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Backward compatible releases of a distribution package need
+              only change the version number, while non-backward compatible changes require the GUID to
+              change (resetting the version number to 1.0 is optional.)
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="RegistryFormatGuid">
+                <xs:attribute name="Version" type="xs:decimal" use="required">
+                  <xs:annotation>
+                    <xs:documentation xml:lang="en-us">
+                      This value, along with the GUID, is used to
+                      uniquely identify this object. The higher the number, the more recent the
+                      content.
+                    </xs:documentation>
+                  </xs:annotation>
+                </xs:attribute>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="1" name="Vendor" type="xs:normalizedString">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A string identifying who created this distribution package.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="1" name="Date" type="xs:dateTime">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The date and time this distribution was created. The format
+              is: YYYY-MM-DDThh:mm:ss, for example: 2001-01-31T13:30:00 (note the T character separator
+              between the calendar date and the time.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="unbounded" name="Copyright">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The copyright for this file that is generated by the creator
+              of the distribution. If a derivative work is generated from an existing distribution, then
+              the existing copyright must be maintained, and additional copyrights may be appended to the
+              end of this element. It may also be the primary copyright for all code provided in the
+              Distribution Package.
             </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:string">
+                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="unbounded" name="License">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A license that describes any restrictions on the use of this
+              distribution. If a derivative work is allowed by the original license and a derivative work
+              is generated from an existing distribution, then the existing license must be maintained,
+              and additional licenses may be appended to the end of this element. It may also be the
+              primary license for all code provided in the distribution file. Alternatively, this may
+              point to a filename that contains the License. The file (included in the content zip file)
+              will be stored in the same location as the distribution package's .pkg file.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:string">
+                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="unbounded" name="Abstract">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A one line description of the Distribution Package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:normalizedString">
+                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A complete description of the Distribution Package. This
+              description may include the release name of the file, the version of the file, and a
+              complete description of the file contents and/or features including a description of the
+              updates since the previous file release.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:string">
+                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="0" maxOccurs="1" name="Signature" type="Md5Sum">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The packaging utilities will use this MD5 sum value of the
+              included ZIP file containing files and/or code. If this element is not present, then
+              installation tools should assume that the content is correct, or that other methods may be
+              needed to verify content.
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="1" name="XmlSpecification" type="xs:decimal" default="1.1">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us"> This version of this XML Schema is 1.1 </xs:documentation>
+            <xs:documentation xml:lang="en-us"> Changes to 1.1 from 1.0 </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              #1 Updated to present date and new version which is
+              important to reflect the present state of the matter
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              #2 Added definition/enumeration of UNDEFIND type 2 is
+              important since there is a large body of legacy code for which the GUID’s and other
+              code/data objects were not decorated with their usage. This document will allow for
+              importing today’s source artifacts and producing decorations using the ‘Undefined’ versus
+              having an error
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              #3 Allow for inclusion of ARM and future architecture
+              types
+            </xs:documentation>
+          </xs:annotation>
+        </xs:element>
+      </xs:sequence>
+      <xs:attribute name="ReadOnly" type="xs:boolean" default="false" use="optional">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            If set to true, all content within this Distribution Package
+            should NOT be modified. The default permits modification of all content.
+          </xs:documentation>
         </xs:annotation>
-        <xs:complexType>
+      </xs:attribute>
+      <xs:attribute name="RePackage" type="xs:boolean" default="false" use="optional">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            If set to true, then the content can be repackaged into another
+            distribution package. The default prohibits repackaging the Distribution content.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+    </xs:complexType>
+  </xs:element>
+  <!-- End of the DistributionHeader element. -->
+
+  <xs:element name="PackageSurfaceArea">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        A package is a collection of related objects - Includes, Libraries and
+        Modules.
+      </xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        Each package is uniquely identified by it's GUID and Version number.
+        Backward compatible releases of a package need only change the version number, while non-backward
+        compatible changes require the GUID to change (resetting the version number to 1.0 is optional.)
+      </xs:documentation>
+    </xs:annotation>
+    <xs:complexType>
+      <xs:sequence>
+
+        <xs:element minOccurs="1" maxOccurs="1" name="Header">
+          <xs:complexType>
             <xs:sequence>
-                <xs:element ref="DistributionHeader" minOccurs="1" maxOccurs="1">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This header contains (legal) information usually required
-                            for distributing both binary and/or source code. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element ref="PackageSurfaceArea" minOccurs="0" maxOccurs="unbounded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The list of packages in this distribution. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Packages are groups of files and/or modules that are similar
-                            in nature.</xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Packages are uniquely identified by a package GUID and a
-                            package version. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> A package can declare public mappings of C names to GUID
-                            values. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> A package can provide header files for library classes
-                            and/or other industry standard definitions. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> A package can also declare public mappings of platform
-                            configuration database (PCD) &quot;knobs&quot; to control features and operation of modules
-                            within a platform. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Finally, a package lists the library instances and/or
-                            modules that are provided in a distribution package. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element ref="ModuleSurfaceArea" minOccurs="0" maxOccurs="unbounded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The listing of UEFI/PI compliant modules in this
-                            distribution that are NOT part of a Package. Every module that is provided as part of a
-                            package needs to be described in a PackageSurfaceArea.Modules section. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> The ModuleSurfaceArea section describes how each module in a
-                            distribution is coded, or, in the case of a binary module distribution, how it was built. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> UEFI/PI compliant libraries and modules are uniquely
-                            identified by the Module's GUID and version number. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> This section will typically be used for modules that don't
-                            require any additional files that would be included in a package. For example, the Enhanced
-                            FAT driver binary does not need to have a package description, as no additional files are
-                            provided. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element ref="Tools" minOccurs="0" maxOccurs="unbounded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is for distributing vendor specific executable
-                            tools, tool source code and/or configuration files. These tools are primarily for
-                            manipulating code and/or binary images. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Tools in this section can:</xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 1) Parse build meta-data files to create source code files
-                            and build scripts. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 2) Modify image files to conform to UEFI/PI specifications. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 3) Generate binary files from certain types of text/unicode
-                            files. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 4) Generate PCI Option Roms or Firmware Device images. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 5) Implement external encoding/decoding/signature/GUIDed
-                            tools. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 6) Distribution Package create/install/remove tools.
-                        </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element ref="MiscellaneousFiles" minOccurs="0" maxOccurs="unbounded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The list of miscellaneous files in this distribution. Any
-                            files that are not listed in either the Package, Module or Tools sections can be listed
-                            here. This section can be used to distribute specifications for packages and modules that
-                            are not &quot;industry standards&quot; such as a specification for a chipset or a video
-                            device. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element ref="UserExtensions" minOccurs="0" maxOccurs="unbounded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The UserExtensions section is used to disseminate processing
-                            instructions that may be custom to the content provided by the distribution. This section
-                            contains information that is common to all aspects of this disribution. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-            </xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="1" name="Name">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the User Interface Name for this
+                    package.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:normalizedString">
+                      <xs:attribute name="BaseName" type="xs:NMTOKEN" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This is a single word BaseName
+                            of the package. This BaseName can be used by tools as a keyword
+                            and for directory/file creation.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This GUID and the Version attribute uniquely
+                    identify a given package.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="RegistryFormatGuid">
+                      <xs:attribute name="Version" type="xs:decimal" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This value, along with the GUID,
+                            is used to uniquely identify this object.
+                          </xs:documentation>
+                          <xs:documentation xml:lang="en-us">
+                            Backward compatible changes must
+                            make sure this number is incremented from the most recent
+                            version. Non-backward compatible changes require a new GUID, and
+                            the version can be reset.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Copyright">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    If the package requires a different copyright
+                    than the distribution package, this element can list one or more copyright
+                    lines.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
 
-        </xs:complexType>
-    </xs:element>
-    <!-- End of the DistributionPackage Description  -->
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="License">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    If the package requires licenses that are
+                    different from the distribution package license, this element can contain one or
+                    more license text paragraphs (or license filenames.)
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
 
-    <xs:element name="DistributionHeader">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> This section defines the content of the UEIF/PI compliant Distribution
-                Package Header. This is the only required element of a UEFI/PI compliant distribution package.
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Abstract">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    A one line description of this package.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:normalizedString">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    A complete description of a package. This
+                    description may include the release name of the package, the version of the
+                    package, and a complete description of the package contents and/or features
+                    including a description of the updates since the previous package’s release.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="1" name="PackagePath" type="xs:anyURI">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This element is the location (in the ZIP file)
+                    for the root directory of a package.
+                  </xs:documentation>
+                </xs:annotation>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea Header element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="ClonedFrom">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              The term cloned is used here to indicate that this package
+              as been copied and modified to a completely different package. An example might be for a new
+              generation of chipsets that have few or no elements in common with the original.
             </xs:documentation>
-        </xs:annotation>
-        <xs:complexType>
+          </xs:annotation>
+          <xs:complexType>
             <xs:sequence>
-                <xs:element minOccurs="1" maxOccurs="1" name="Name">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the User Interface Name for this Distribution
-                            Package. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Each Distribution Package is uniquely identified by it's
-                            GUID and Version number. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:normalizedString">
-                                <xs:attribute name="BaseName" type="xs:NMTOKEN" use="optional">
-                                    <xs:annotation>
-                                        <xs:documentation xml:lang="en-us"> The reference name of the Distribution
-                                            Package file. This single word name can be used by tools as a keyword or for
-                                            directory and/or file creation. </xs:documentation>
-                                        <xs:documentation xml:lang="en-us"> White space and special characters (dash and
-                                            underscore characters may be used) are not permitted in this name.
-                                        </xs:documentation>
-                                    </xs:annotation>
-                                </xs:attribute>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This 128-bit GUID and the Version attribute uniquely
-                            identify this Distribution Package. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Backward compatible releases of a distribution package need
-                            only change the version number, while non-backward compatible changes require the GUID to
-                            change (resetting the version number to 1.0 is optional.) </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="RegistryFormatGuid">
-                                <xs:attribute name="Version" type="xs:decimal" use="required">
+              <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This GUID and the Version attribute uniquely
+                    identify the Package that this Package was copied from.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="RegistryFormatGuid">
+                      <xs:attribute name="Version" type="xs:decimal" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This value, along with the GUID,
+                            is used to uniquely identify the package that this package was
+                            cloned from.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea ClonedFrom element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="LibraryClassDeclarations">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              Library Classes are public interfaces that can be used by
+              modules. One or more library instances can implement a library class, however only one
+              library instance can be linked to an individual module. This provides the platform
+              integrator with the flexibility of choosing one library instance's implementation over a
+              different library instance.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="LibraryClass">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile" type="xs:anyURI">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          The header file provides definitions
+                          and function prototypes for a library class. Modules can be coded
+                          against these functions, using the definitions in this header,
+                          without concerning themselves about the libraries' implementation
+                          details. This is a PackagePath relative path and filename for the
+                          include file.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element minOccurs="0" maxOccurs="1" name="RecommendedInstance">
+                      <xs:complexType>
+                        <xs:sequence>
+                          <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                This GUID and the
+                                Version attribute uniquely identify the Recommended Library
+                                Instance.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:simpleContent>
+                                <xs:extension base="RegistryFormatGuid">
+                                  <xs:attribute name="Version" type="xs:decimal"
+                                  use="optional">
                                     <xs:annotation>
-                                        <xs:documentation xml:lang="en-us"> This value, along with the GUID, is used to
-                                            uniquely identify this object. The higher the number, the more recent the
-                                            content. </xs:documentation>
+                                      <xs:documentation xml:lang="en-us">
+                                        This value, along with
+                                        the GUID, is used to uniquely identify this object. If this
+                                        value is not specified, then any version of the library
+                                        instance is recommended.
+                                      </xs:documentation>
                                     </xs:annotation>
-                                </xs:attribute>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="1" name="Vendor" type="xs:normalizedString">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A string identifying who created this distribution package.
-                        </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="1" name="Date" type="xs:dateTime">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The date and time this distribution was created. The format
-                            is: YYYY-MM-DDThh:mm:ss, for example: 2001-01-31T13:30:00 (note the T character separator
-                            between the calendar date and the time. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="unbounded" name="Copyright">
+                                  </xs:attribute>
+                                </xs:extension>
+                              </xs:simpleContent>
+                            </xs:complexType>
+                          </xs:element>
+                        </xs:sequence>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Keyword" type="xs:NCName" use="required">
                     <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The copyright for this file that is generated by the creator
-                            of the distribution. If a derivative work is generated from an existing distribution, then
-                            the existing copyright must be maintained, and additional copyrights may be appended to the
-                            end of this element. It may also be the primary copyright for all code provided in the
-                            Distribution Package. </xs:documentation>
+                      <xs:documentation xml:lang="en-us">
+                        The single word name of the Library
+                        Class that module developers will use to identify a library class
+                        dependency.
+                      </xs:documentation>
                     </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:string">
-                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                    
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="unbounded" name="License">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A license that describes any restrictions on the use of this
-                            distribution. If a derivative work is allowed by the original license and a derivative work
-                            is generated from an existing distribution, then the existing license must be maintained,
-                            and additional licenses may be appended to the end of this element. It may also be the
-                            primary license for all code provided in the distribution file. Alternatively, this may
-                            point to a filename that contains the License. The file (included in the content zip file)
-                            will be stored in the same location as the distribution package's .pkg file.
+                  </xs:attribute>
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea LibraryClassDeclarations element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="IndustryStandardIncludes">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used to list header files for industry
+              standards not under the auspices of UEFI.org. For example, headers that contain definitions
+              and data structures for the USB specifications.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="IndustryStandardHeader">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile" type="xs:anyURI">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          The package relative path and
+                          filename (in the content zip file) of the industry standard include
+                          file.
                         </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:string">
-                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="unbounded" name="Abstract">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A one line description of the Distribution Package.
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea IndustryStdIncludes element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PackageIncludes">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              All top level header files that are included by a package
+              that are not listed above. They cannot be:
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us"> 1) Local to a module (module specific.) </xs:documentation>
+            <xs:documentation xml:lang="en-us"> 2) An industry standard header. </xs:documentation>
+            <xs:documentation xml:lang="en-us"> 3) A library class header. </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="PackageHeader">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          This is the Package relative path
+                          and filename location within the content ZIP file.
                         </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:normalizedString">
-                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A complete description of the Distribution Package. This
-                            description may include the release name of the file, the version of the file, and a
-                            complete description of the file contents and/or features including a description of the
-                            updates since the previous file release. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
+                      </xs:annotation>
+                      <xs:complexType>
                         <xs:simpleContent>
-                            <xs:extension base="xs:string">
-                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                            </xs:extension>
+                          <xs:extension base="xs:anyURI">
+                            <xs:attributeGroup ref="SupportedArchMod"/>
+                          </xs:extension>
                         </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="0" maxOccurs="1" name="Signature" type="Md5Sum">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The packaging utilities will use this MD5 sum value of the
-                            included ZIP file containing files and/or code. If this element is not present, then
-                            installation tools should assume that the content is correct, or that other methods may be
-                            needed to verify content. </xs:documentation>
-                    </xs:annotation>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="1" name="XmlSpecification" type="xs:decimal" default="1.1">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This version of this XML Schema is 1.1 </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Changes to 1.1 from 1.0 </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> #1 Updated to present date and new version which is
-                            important to reflect the present state of the matter</xs:documentation>
-                        <xs:documentation xml:lang="en-us"> #2 Added definition/enumeration of UNDEFIND type 2 is
-                            important since there is a large body of legacy code for which the GUID’s and other
-                            code/data objects were not decorated with their usage. This document will allow for
-                            importing today’s source artifacts and producing decorations using the ‘Undefined’ versus
-                            having an error</xs:documentation>
-                        <xs:documentation xml:lang="en-us">#3 Allow for inclusion of ARM and future architecture
-                            types</xs:documentation>
-                    </xs:annotation>
-                </xs:element>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                </xs:complexType>
+              </xs:element>
             </xs:sequence>
-            <xs:attribute name="ReadOnly" type="xs:boolean" default="false" use="optional">
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea PackageIncluces element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="Modules">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element ref="ModuleSurfaceArea" minOccurs="1" maxOccurs="unbounded">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> If set to true, all content within this Distribution Package
-                        should NOT be modified. The default permits modification of all content. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This section lists the Module Surface Area for
+                    all modules provided with this package.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:attribute>
-            <xs:attribute name="RePackage" type="xs:boolean" default="false" use="optional">
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea Modules element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="GuidDeclarations">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section defines the mapping of GUID C names to GUID
+              values as a Registry Format GUID.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Modules that use these GUIDs must specify their dependency
+              on this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> If set to true, then the content can be repackaged into another
-                        distribution package. The default prohibits repackaging the Distribution content.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us"> Individual GUID Declarations </xs:documentation>
                 </xs:annotation>
-            </xs:attribute>
-        </xs:complexType>
-    </xs:element>
-    <!-- End of the DistributionHeader element. -->
-
-    <xs:element name="PackageSurfaceArea">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> A package is a collection of related objects - Includes, Libraries and
-                Modules. </xs:documentation>
-            <xs:documentation xml:lang="en-us"> Each package is uniquely identified by it's GUID and Version number.
-                Backward compatible releases of a package need only change the version number, while non-backward
-                compatible changes require the GUID to change (resetting the version number to 1.0 is optional.)
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
+                        type="RegistryFormatGuid"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
+                  <xs:attribute name="GuidTypes" type="GuidListType" use="optional"/>
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea GuidDeclarations element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="ProtocolDeclarations">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section defines the mapping of Protocol C names to GUID
+              values as a Registry Format GUID.
             </xs:documentation>
-        </xs:annotation>
-        <xs:complexType>
+            <xs:documentation xml:lang="en-us">
+              Modules that use these Protocols must specify their
+              dependency on this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
             <xs:sequence>
-
-                <xs:element minOccurs="1" maxOccurs="1" name="Header">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="Name">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is the User Interface Name for this
-                                        package. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:normalizedString">
-                                            <xs:attribute name="BaseName" type="xs:NMTOKEN" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This is a single word BaseName
-                                                        of the package. This BaseName can be used by tools as a keyword
-                                                        and for directory/file creation. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This GUID and the Version attribute uniquely
-                                        identify a given package. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="RegistryFormatGuid">
-                                            <xs:attribute name="Version" type="xs:decimal" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This value, along with the GUID,
-                                                        is used to uniquely identify this object. </xs:documentation>
-                                                    <xs:documentation xml:lang="en-us"> Backward compatible changes must
-                                                        make sure this number is incremented from the most recent
-                                                        version. Non-backward compatible changes require a new GUID, and
-                                                        the version can be reset. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Copyright">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> If the package requires a different copyright
-                                        than the distribution package, this element can list one or more copyright
-                                        lines. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="License">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> If the package requires licenses that are
-                                        different from the distribution package license, this element can contain one or
-                                        more license text paragraphs (or license filenames.) </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Abstract">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A one line description of this package.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:normalizedString">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A complete description of a package. This
-                                        description may include the release name of the package, the version of the
-                                        package, and a complete description of the package contents and/or features
-                                        including a description of the updates since the previous package’s release.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="1" name="PackagePath" type="xs:anyURI">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This element is the location (in the ZIP file)
-                                        for the root directory of a package. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea Header element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="ClonedFrom">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> The term cloned is used here to indicate that this package
-                            as been copied and modified to a completely different package. An example might be for a new
-                            generation of chipsets that have few or no elements in common with the original.
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    Individual Protocol Declarations
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
+                        type="RegistryFormatGuid"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea ProtocolDeclarations element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PpiDeclarations">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section defines the mapping of Ppi C names to GUID
+              values as a Registry Format GUID.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Modules that use these Ppis must specify their dependency on
+              this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us"> Individual PPI Declarations </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
+                        type="RegistryFormatGuid"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea PpiDeclarations element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PcdDeclarations">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used to declare platform configuration knobs
+              that are defined by this package.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              Modules that use these PCD values must specify their
+              dependency on this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdEntry">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="TokenSpaceGuidCname"
+                        type="xs:NCName">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          Specifies the C name of the Token
+                          Space GUID of which this PCD Entry is a member. This C name should
+                          also be listed in the GUIDs section, (specified above,) where the C
+                          name is assigned to a GUID value.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element minOccurs="1" maxOccurs="1" name="Token">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          Specifies the 32-bit token value for
+                          this PCD Entry. The Token number must be unique to the Token Space
+                          that declares the PCD.
+                        </xs:documentation>
+                        <xs:documentation xml:lang="en-us">
+                          The minLength of 3 is required to
+                          handle the "0x" prefix to the hex number.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:simpleType>
+                        <xs:restriction base="HexNumber">
+                          <xs:minLength value="3"/>
+                          <xs:maxLength value="10"/>
+                        </xs:restriction>
+                      </xs:simpleType>
+                    </xs:element>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="1" maxOccurs="1" name="DatumType" type="PcdDatumTypes">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          A string that contains the data type
+                          of this PCD Entry. PCD data types are restricted to the following
+                          set:UINT8, UINT16, UINT32, UINT64, VOID*, BOOLEAN.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element minOccurs="1" maxOccurs="1" name="ValidUsage" type="PcdItemListType">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          A string that contains one or more
+                          PCD Item types separated by spaces. The PCD Item types are
+                          restricted to FeaturePcd, FixedPcd, PatchPcd, Pcd and/or PcdEx.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element minOccurs="1" maxOccurs="1" name="DefaultValue"
+                        type="xs:normalizedString"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          This is a recommended maximum data
+                          size for VOID* data types, the actual value should be defined by the
+                          Platform Integrator. It is not required for the other data types.
+                        </xs:documentation>
+                        <xs:documentation xml:lang="en-us">
+                          The minLength of 3 is required to
+                          handle the "0x" prefix to the hex number.
                         </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This GUID and the Version attribute uniquely
-                                        identify the Package that this Package was copied from. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="RegistryFormatGuid">
-                                            <xs:attribute name="Version" type="xs:decimal" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This value, along with the GUID,
-                                                        is used to uniquely identify the package that this package was
-                                                        cloned from. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea ClonedFrom element.  -->
 
-                <xs:element minOccurs="0" maxOccurs="1" name="LibraryClassDeclarations">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> Library Classes are public interfaces that can be used by
-                            modules. One or more library instances can implement a library class, however only one
-                            library instance can be linked to an individual module. This provides the platform
-                            integrator with the flexibility of choosing one library instance's implementation over a
-                            different library instance. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
+                      </xs:annotation>
+                      <xs:simpleType>
+                        <xs:restriction base="HexNumber">
+                          <xs:minLength value="3"/>
+                        </xs:restriction>
+                      </xs:simpleType>
+                    </xs:element>
+                    <xs:element minOccurs="0" maxOccurs="unbounded" name="Prompt">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-US">
+                          This entry contains prompt
+                          information, that may used by tools to assist platform integrators
+                          with choosing the correct values
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:complexType>
+                        <xs:simpleContent>
+                          <xs:extension base="xs:string">
+                            <xs:attribute name="Lang" type="xs:language" default="en-us"
+                                use="optional"/>
+                          </xs:extension>
+                        </xs:simpleContent>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+
+                    <xs:element minOccurs="0" maxOccurs="unbounded" name="PcdError">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          Valid Error messages that may be
+                          implemented in a module for the PCD Entry. Only One Error Number per
+                          PcdError, (multiple ErrorMessage entries are permitted) and multiple
+                          PcdError elements are permitted.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:complexType>
                         <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="LibraryClass">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile" type="xs:anyURI">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> The header file provides definitions
-                                                    and function prototypes for a library class. Modules can be coded
-                                                    against these functions, using the definitions in this header,
-                                                    without concerning themselves about the libraries' implementation
-                                                    details. This is a PackagePath relative path and filename for the
-                                                    include file. </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="RecommendedInstance">
-                                            <xs:complexType>
-                                                <xs:sequence>
-                                                    <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This GUID and the
-                                                            Version attribute uniquely identify the Recommended Library
-                                                            Instance. </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="RegistryFormatGuid">
-                                                            <xs:attribute name="Version" type="xs:decimal"
-                                                            use="optional">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This value, along with
-                                                            the GUID, is used to uniquely identify this object. If this
-                                                            value is not specified, then any version of the library
-                                                            instance is recommended. </xs:documentation>
-                                                            </xs:annotation>
-                                                            </xs:attribute>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                        </xs:complexType>
-                                                    </xs:element>
-                                                </xs:sequence>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Keyword" type="xs:NCName" use="required">
-                                        <xs:annotation>
-                                            <xs:documentation xml:lang="en-us"> The single word name of the Library
-                                                Class that module developers will use to identify a library class
-                                                dependency. </xs:documentation>
-                                        </xs:annotation>
-                                    </xs:attribute>
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                </xs:complexType>
+                          <xs:choice minOccurs="1" maxOccurs="1">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                One of the following
+                                types of comparisons, which must be able to evaluate to
+                                either true or false.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
+                              <xs:annotation>
+                                <xs:documentation xml:lang="en-us">
+                                  The PCD Value must be
+                                  space separated list of values. Values are restricted to the
+                                  data type of this PCD.
+                                </xs:documentation>
+                              </xs:annotation>
+                              <xs:complexType>
+                                <xs:simpleContent>
+                                  <xs:extension base="xs:normalizedString">
+                                    <xs:attribute name="Lang" type="xs:language" use="optional"
+                                                            />
+                                  </xs:extension>
+                                </xs:simpleContent>
+                              </xs:complexType>
                             </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea LibraryClassDeclarations element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="IndustryStandardIncludes">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used to list header files for industry
-                            standards not under the auspices of UEFI.org. For example, headers that contain definitions
-                            and data structures for the USB specifications. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="IndustryStandardHeader">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile" type="xs:anyURI">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> The package relative path and
-                                                    filename (in the content zip file) of the industry standard include
-                                                    file. </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                </xs:complexType>
+                            <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange"
+                                type="xs:normalizedString">
+                              <xs:annotation>
+                                <xs:documentation xml:lang="en-us">
+                                  The PCD must be within a
+                                  specifed range of numeric values. Restricted to C style
+                                  Relational, Equality and Logicial Operators and parenthesis
+                                  are valid. Only the CName for this PCD is permitted in the
+                                  ValidValueRange expression. All other values must be
+                                  numeric.
+                                </xs:documentation>
+                                <xs:documentation xml:lang="en-us">
+                                  LValue (op RValue)+
+                                </xs:documentation>
+                              </xs:annotation>
                             </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea IndustryStdIncludes element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PackageIncludes">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> All top level header files that are included by a package
-                            that are not listed above. They cannot be:</xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 1) Local to a module (module specific.) </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 2) An industry standard header. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> 3) A library class header. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="PackageHeader">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="HeaderFile">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> This is the Package relative path
-                                                    and filename location within the content ZIP file.
-                                                </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:simpleContent>
-                                                    <xs:extension base="xs:anyURI">
-                                                        <xs:attributeGroup ref="SupportedArchMod"/>
-                                                    </xs:extension>
-                                                </xs:simpleContent>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                </xs:complexType>
+                            <xs:element minOccurs="0" maxOccurs="1" name="Expression"
+                                type="xs:normalizedString">
+                              <xs:annotation>
+                                <xs:documentation xml:lang="en-us">
+                                  A in-fix logical
+                                  expression using C style logical operators.
+                                </xs:documentation>
+                              </xs:annotation>
                             </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea PackageIncluces element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="Modules">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element ref="ModuleSurfaceArea" minOccurs="1" maxOccurs="unbounded">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This section lists the Module Surface Area for
-                                        all modules provided with this package. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea Modules element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="GuidDeclarations">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section defines the mapping of GUID C names to GUID
-                            values as a Registry Format GUID. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Modules that use these GUIDs must specify their dependency
-                            on this package. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Individual GUID Declarations </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
-                                            type="RegistryFormatGuid"/>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
-                                    <xs:attribute name="GuidTypes" type="GuidListType" use="optional"/>
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea GuidDeclarations element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="ProtocolDeclarations">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section defines the mapping of Protocol C names to GUID
-                            values as a Registry Format GUID. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Modules that use these Protocols must specify their
-                            dependency on this package. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Individual Protocol Declarations
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
-                                            type="RegistryFormatGuid"/>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea ProtocolDeclarations element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PpiDeclarations">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section defines the mapping of Ppi C names to GUID
-                            values as a Registry Format GUID. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Modules that use these Ppis must specify their dependency on
-                            this package. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Entry">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Individual PPI Declarations </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="GuidValue"
-                                            type="RegistryFormatGuid"/>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="UiName" type="xs:normalizedString" use="optional"/>
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea PpiDeclarations element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PcdDeclarations">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used to declare platform configuration knobs
-                            that are defined by this package. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> Modules that use these PCD values must specify their
-                            dependency on this package. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdEntry">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="TokenSpaceGuidCname"
-                                            type="xs:NCName">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> Specifies the C name of the Token
-                                                    Space GUID of which this PCD Entry is a member. This C name should
-                                                    also be listed in the GUIDs section, (specified above,) where the C
-                                                    name is assigned to a GUID value. </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="Token">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> Specifies the 32-bit token value for
-                                                    this PCD Entry. The Token number must be unique to the Token Space
-                                                    that declares the PCD. </xs:documentation>
-                                                <xs:documentation xml:lang="en-us"> The minLength of 3 is required to
-                                                    handle the "0x" prefix to the hex number. </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:simpleType>
-                                                <xs:restriction base="HexNumber">
-                                                    <xs:minLength value="3"/>
-                                                    <xs:maxLength value="10"/>
-                                                </xs:restriction>
-                                            </xs:simpleType>
-                                        </xs:element>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="DatumType" type="PcdDatumTypes">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> A string that contains the data type
-                                                    of this PCD Entry. PCD data types are restricted to the following
-                                                    set:UINT8, UINT16, UINT32, UINT64, VOID*, BOOLEAN.
-                                                </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="ValidUsage" type="PcdItemListType">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> A string that contains one or more
-                                                    PCD Item types separated by spaces. The PCD Item types are
-                                                    restricted to FeaturePcd, FixedPcd, PatchPcd, Pcd and/or PcdEx.
-                                                </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="DefaultValue"
-                                            type="xs:normalizedString"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> This is a recommended maximum data
-                                                    size for VOID* data types, the actual value should be defined by the
-                                                    Platform Integrator. It is not required for the other data types. </xs:documentation>
-                                                <xs:documentation xml:lang="en-us"> The minLength of 3 is required to
-                                                    handle the "0x" prefix to the hex number. </xs:documentation>
-
-                                            </xs:annotation>
-                                            <xs:simpleType>
-                                                <xs:restriction base="HexNumber">
-                                                    <xs:minLength value="3"/>
-                                                </xs:restriction>
-                                            </xs:simpleType>
-                                        </xs:element>
-                                        <xs:element minOccurs="0" maxOccurs="unbounded" name="Prompt">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-US"> This entry contains prompt
-                                                    information, that may used by tools to assist platform integrators
-                                                    with choosing the correct values </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:simpleContent>
-                                                    <xs:extension base="xs:string">
-                                                        <xs:attribute name="Lang" type="xs:language" default="en-us"
-                                                            use="optional"/>
-                                                    </xs:extension>
-                                                </xs:simpleContent>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-
-                                        <xs:element minOccurs="0" maxOccurs="unbounded" name="PcdError">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> Valid Error messages that may be
-                                                    implemented in a module for the PCD Entry. Only One Error Number per
-                                                    PcdError, (multiple ErrorMessage entries are permitted) and multiple
-                                                    PcdError elements are permitted. </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:sequence>
-                                                    <xs:choice minOccurs="1" maxOccurs="1">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> One of the following
-                                                            types of comparisons, which must be able to evaluate to
-                                                            either true or false. </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The PCD Value must be
-                                                            space separated list of values. Values are restricted to the
-                                                            data type of this PCD. </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="xs:normalizedString">
-                                                            <xs:attribute name="Lang" type="xs:language" use="optional"
-                                                            />
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                            </xs:complexType>
-                                                        </xs:element>
-                                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange"
-                                                            type="xs:normalizedString">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The PCD must be within a
-                                                            specifed range of numeric values. Restricted to C style
-                                                            Relational, Equality and Logicial Operators and parenthesis
-                                                            are valid. Only the CName for this PCD is permitted in the
-                                                            ValidValueRange expression. All other values must be
-                                                            numeric.</xs:documentation>
-                                                            <xs:documentation xml:lang="en-us"> LValue (op RValue)+
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                        </xs:element>
-                                                        <xs:element minOccurs="0" maxOccurs="1" name="Expression"
-                                                            type="xs:normalizedString">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> A in-fix logical
-                                                            expression using C style logical operators.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                        </xs:element>
-                                                    </xs:choice>
-                                                    <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> A hexadecimal value for
-                                                            the error message as defined by specifications. </xs:documentation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number. </xs:documentation>
-
-                                                        </xs:annotation>
-                                                        <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                        </xs:simpleType>
-                                                    </xs:element>
-                                                    <xs:element minOccurs="1" maxOccurs="unbounded" name="ErrorMessage">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This string should be
-                                                            defined by specifications. There are pre-defined error
-                                                            number ranges in the UEFI/PI specificaiton.
-                                                            </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="xs:string">
-                                                            <xs:attribute name="Lang" type="xs:language" default="en-us"
-                                                            use="optional"/>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                        </xs:complexType>
-                                                    </xs:element>
-                                                </xs:sequence>
-                                            </xs:complexType>
-                                        </xs:element>
-                                    </xs:sequence>
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea PcdDeclarations element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PcdRelationshipChecks">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used to describe any PCD interdependencies
-                            or relationships. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdCheck" type="xs:normalizedString">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This entry must used
-                                        TokenSpaceGuidCName.PcdCname for every named PCD. Restricted to Relational,
-                                        Equality and Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and
-                                        parenthesis are valid. Only the TokenSpaceGuidCName.PcdCname us permitted to
-                                        name PCDs in the expression. All other values must be numeric. </xs:documentation>
-                                    <xs:documentation xml:lang="en-us"> LValue (op RValue)+ </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="MiscellaneousFiles">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section contains files that are not part of the code
-                            distributed with this package. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Only required if different from the Package
-                                        Copyright. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Only required if different from the Package
-                                        License. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Abstract" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A one line description of this section's
-                                        content. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Description" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A complete description of the files in this
-                                        section. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is the PackagePath relative path and
-                                        filename location within the ZIP file. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:anyURI">
-                                            <xs:attribute name="Executable" type="xs:boolean" default="false"
-                                                use="optional">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> If true, used by installation
-                                                        tools to ensure that a file that must be executable has the
-                                                        correct properties to permit execution. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea Misc element.  -->
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="UserExtensions">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used for any processing instructions that
-                            may be custom to the content provided by this package that are common to this package.
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType mixed="true">
-                        <xs:sequence>
-                            <xs:any processContents="lax" minOccurs="0" maxOccurs="1"/>
-                        </xs:sequence>
-                        <xs:attribute name="UserId" type="xs:NCName" use="required">
-                            <xs:annotation>
-                                <xs:documentation xml:lang="en-us"> This is a single word identifier for grouping
-                                    similar content that does not fit into previously defined sections or other sections
-                                    of the Distribution. </xs:documentation>
-                            </xs:annotation>
-                        </xs:attribute>
-                        <xs:attribute name="Identifier" type="xs:string" use="required">
-                            <xs:annotation>
-                                <xs:documentation xml:lang="en-us"> This can be used to differentiate multiple sections
-                                    with a grouping. </xs:documentation>
-                                <xs:documentation xml:lang="en-us"> For example, a PRE_PROCESS Identifier might indicate
-                                    specific steps and tools required before processing module content, while a
-                                    different UserExtensions section with a POST_PROCESS Identifier might describe steps
-                                    that need to be executed after operations on the modules in this package.
-                                </xs:documentation>
-                            </xs:annotation>
-                        </xs:attribute>
-                        <xs:anyAttribute processContents="lax"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageSurfaceArea UserExtensions element. -->
-
-            </xs:sequence>
-        </xs:complexType>
-    </xs:element>
-    <!-- End of the PackageSurfaceArea element. -->
-
-    <xs:element name="ModuleSurfaceArea">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> Each module is uniquely identified by it's GUID and Version number.
-                Backward compatible releases of a module need only change the version number, while non-backward
-                compatible changes require the GUID to change (resetting the version number to 1.0 is optional.)
-            </xs:documentation>
-        </xs:annotation>
-        <xs:complexType>
-            <xs:sequence>
-
-                <xs:element minOccurs="1" maxOccurs="1" name="Header">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="Name">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is the User Interface Name for this Module.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:normalizedString">
-                                            <xs:attribute name="BaseName" type="xs:NMTOKEN" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This is a single word BaseName
-                                                        that will be used to create a module meta-data file. </xs:documentation>
-                                                    <xs:documentation xml:lang="en-us"> This name should also be used to
-                                                        create output file names and directories. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This GUID and the Version attribute uniquely
-                                        identify a given Module. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="RegistryFormatGuid">
-                                            <xs:attribute name="Version" type="xs:decimal" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This value, along with the GUID,
-                                                        is used to uniquely identify this object. </xs:documentation>
-                                                    <xs:documentation xml:lang="en-us"> Backward compatible changes must
-                                                        make sure this number is incremented from the most recent
-                                                        version. Non-backward compatible changes require a new GUID, and
-                                                        the version can be reset. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Copyright">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the Copyright is
-                                        different from either the Package or Distribution copyright. Multiple copyright
-                                        lines are permitted within this section. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="License">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the license is
-                                        different from either the Package or Distribution license. Multiple licenses are
-                                        permitted within this section. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Abstract">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A brief text description of the module.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:normalizedString">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> A complete description of the module contents
-                                        and/or features including a description of the updates since the previous module
-                                        release. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Module Surface Area Header Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="ModuleProperties">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> List general information about a module, including the
-                            Supported Architectures, this module's type, specifications the module is coded against, and
-                            other informational content. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="ModuleType" type="ModuleTypes">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> One of the Enumerated module types that limit
-                                        the use of a module. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="1" name="Path" type="xs:anyURI">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> For stand-alone modules that are NOT part of any
-                                        package, this is the path to the root of the module as listed in the ZIP file.
-                                        For modules included in a package, this is the location, relative to the root of
-                                        the package (PackagePath) this module belongs to. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="PcdIsDriver">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This element is only required for the PEIM that
-                                        produces the PCD PPI or the DXE Driver that produces the PCD Protocol.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:simpleType>
-                                    <xs:restriction base="xs:NCName">
-                                        <xs:enumeration value="PEI_PCD_DRIVER"/>
-                                        <xs:enumeration value="DXE_PCD_DRIVER"/>
-                                    </xs:restriction>
-                                </xs:simpleType>
-                            </xs:element>
-
-                            <xs:element minOccurs="0" maxOccurs="1" name="UefiSpecificationVersion" type="xs:decimal"/>
-
-                            <xs:element minOccurs="0" maxOccurs="1" name="PiSpecificationVersion" type="xs:decimal"/>
-
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Specification">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is a list of other specifications that this
-                                        module is written against. These entries can be used in #define statements
-                                        (depending on the build system implementation, they may be autogenerated.)
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:NCName">
-                                            <xs:attribute name="Version" type="xs:decimal" use="required"/>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="BootMode">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> Different firmware execution paths may be taken
-                                        based on a given state of the hardware, firmware, or through feature settings. A
-                                        BootMode may be declared (PRODUCES) or discovered (CONSUMES) based on these
-                                        states and feature settings. If the usage is UNDEFINE, it implies that a Boot
-                                        Mode is used, but the package creator does not know how it is used. The
-                                        supported boot modes map to the PI specification Boot Modes. The boot modes
-                                        listed with Recovery are to indicate that the BootMode is valid during a
-                                        recovery boot. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence minOccurs="0">
-                                        <xs:element minOccurs="1" maxOccurs="1" name="SupportedBootModes">
-                                            <xs:simpleType>
-                                                <xs:list>
-                                                    <xs:simpleType>
-                                                        <xs:restriction base="xs:NCName">
-                                                            <xs:enumeration value="FULL"/>
-                                                            <xs:enumeration value="MINIMAL"/>
-                                                            <xs:enumeration value="NO_CHANGE"/>
-                                                            <xs:enumeration value="DIAGNOSTICS"/>
-                                                            <xs:enumeration value="DEFAULT"/>
-                                                            <xs:enumeration value="S2_RESUME"/>
-                                                            <xs:enumeration value="S3_RESUME"/>
-                                                            <xs:enumeration value="S4_RESUME"/>
-                                                            <xs:enumeration value="S5_RESUME"/>
-                                                            <xs:enumeration value="FLASH_UPDATE"/>
-                                                            <xs:enumeration value="RECOVERY_FULL"/>
-                                                            <xs:enumeration value="RECOVERY_MINIMAL"/>
-                                                            <xs:enumeration value="RECOVERY_NO_CHANGE"/>
-                                                            <xs:enumeration value="RECOVERY_DIAGNOSTICS"/>
-                                                            <xs:enumeration value="RECOVERY_DEFAULT"/>
-                                                            <xs:enumeration value="RECOVERY_S2_RESUME"/>
-                                                            <xs:enumeration value="RECOVERY_S3_RESUME"/>
-                                                            <xs:enumeration value="RECOVERY_S4_RESUME"/>
-                                                            <xs:enumeration value="RECOVERY_S5_RESUME"/>
-                                                            <xs:enumeration value="RECOVERY_FLASH_UPDATE"/>
-                                                            <xs:enumeration value="UNDEFINED"/>
-                                                        </xs:restriction>
-                                                    </xs:simpleType>
-                                                </xs:list>
-                                            </xs:simpleType>
-                                        </xs:element>
-
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module always supports
-                                                            the given boot modes. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module may support a
-                                                            given mode on some execution paths. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will change the
-                                                            boot mode. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIME_PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will change the
-                                                            boot mode on some exection paths. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="UNDEFINED">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The package creator does not
-                                                            know how the boot mode is used. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Event" nillable="true">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> The functions that make up the Event, Timer, and
-                                        Task Priority Services are used during preboot to create, close, signal, and
-                                        wait for events; to set timers; and to raise and restore task priority levels as
-                                        defined in the UEFI specification. GUIDed events should be listed in the Guids
-                                        section. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will register a
-                                                            notification function and calls the function when it is
-                                                            signaled. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will register a
-                                                            notification function and calls the function when it is
-                                                            signaled on some execution paths. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will signal all
-                                                            events in an event group. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module will signal all
-                                                            events in an event group under some execution paths.
-                                                        </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="UNDEFINED">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The package creator does not
-                                                            know how an event is used. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="EventType" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="EVENT_TYPE_PERIODIC_TIMER"/>
-                                                <xs:enumeration value="EVENT_TYPE_RELATIVE_TIMER"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-
-
-                                    </xs:attribute>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="HOB" nillable="false">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is a list of non-GUIDed Hand Off Blocks
-                                        (HOBs) produced or consumed by this module. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="HobType" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="PHIT"/>
-                                                <xs:enumeration value="MEMORY_ALLOCATION"/>
-                                                <xs:enumeration value="RESOURCE_DESCRIPTOR"/>
-                                                <xs:enumeration value="FIRMWARE_VOLUME"/>
-                                                <xs:enumeration value="LOAD_PEIM"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> A HOB must be present in the
-                                                            system. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> If present, the HOB will be
-                                                            used. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The HOB is always produced
-                                                            by the module. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The HOB may be produced by
-                                                            the module under some execution paths. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="UNDEFINED">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The package creator knows
-                                                            that a HOB is used, but does not know how it is used.
-                                                        </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-
-                        </xs:sequence>
-                        <xs:attributeGroup ref="SupportedArchMod"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of ModuleProperties Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="ClonedFrom">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section may be included for Modules that are copied
-                            from a different module. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This GUID and the Version attribute uniquely
-                                        identify the Module that this Module was copied from. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="RegistryFormatGuid">
-                                            <xs:attribute name="Version" type="xs:decimal" use="required">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> This value, along with the GUID,
-                                                        is used to uniquely identify this object. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!--  End of ClonedFrom Section. -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="LibraryClassDefinitions">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A list of the different Library Classes consumed by a
-                            driver, core and/or application module, or produced by a Library module. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="LibraryClass">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="Keyword" type="xs:NCName">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us "> Used by tools to identify different
-                                                    instances of libraries that provide the library class. This keyword
-                                                    identifies the library class this module needs to be linked against.
-                                                </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="RecommendedInstance">
-                                            <xs:complexType>
-                                                <xs:all>
-                                                    <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This GUID and the
-                                                            Version attribute uniquely identify the recommended Library
-                                                            Instance for this module . </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="RegistryFormatGuid">
-                                                            <xs:attribute name="Version" type="xs:decimal"
-                                                            use="optional">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This value, along with
-                                                            the GUID, is used to uniquely identify this object.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            </xs:attribute>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                        </xs:complexType>
-                                                    </xs:element>
-                                                </xs:all>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> Library instances can provide code
-                                                    for a library class, or may require other library instances
-                                                    themselves. Since different execution paths in a library (or module)
-                                                    may need different library classes based on some setting, library
-                                                    classes may not alway be required. </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="PRODUCES"/>
-                                                <xs:enumeration value="CONSUMES"/>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-
-                                    <xs:attributeGroup ref="SupportedArchMod"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional">
-                                        <xs:annotation>
-                                            <xs:documentation xml:lang="en-us"> A FeatureFlag attribute must evaluate to
-                                                either true or false - it may be a fixed value of true or false, a C
-                                                name or an in-fix expression. </xs:documentation>
-                                        </xs:annotation>
-                                    </xs:attribute>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of LibraryClassDefinitions Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="SourceFiles">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is the module relative
-                                        (ModuleProperties.Path) path and filename location within the ZIP file.
-                                    </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:anyURI">
-                                            <xs:attribute name="Family" type="FamilyTypes" use="optional">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> The Family attribute is used to
-                                                        restrict usage to a given family of compilers, such as GCC or
-                                                        MSFT. Since not all code processing tools use the same syntax,
-                                                        especially for assembly, this field can be used to identify
-                                                        different syntax. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                            <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                            <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                            <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of SourceFiles Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="BinaryFiles">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="BinaryFile">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> This is the module relative
-                                                    (ModuleProperties.Path) path and filename location within the ZIP
-                                                    file. </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:simpleContent>
-                                                    <xs:extension base="xs:anyURI">
-                                                        <xs:attribute name="FileType" use="optional">
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="xs:NCName">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> Binary file distribution
-                                                            is limited to UEFI/PI FFS leaf section file types.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:enumeration value="GUID"/>
-                                                            <xs:enumeration value="FREEFORM"/>
-                                                            <xs:enumeration value="UEFI_IMAGE"/>
-                                                            <xs:enumeration value="PE32">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> A UEFI/PI FFS Leaf
-                                                            section file type, not a raw PE32 file. </xs:documentation>
-                                                            </xs:annotation>
-                                                            </xs:enumeration>
-                                                            <xs:enumeration value="PIC"/>
-                                                            <xs:enumeration value="PEI_DEPEX"/>
-                                                            <xs:enumeration value="DXE_DEPEX"/>
-                                                            <xs:enumeration value="SMM_DEPEX"/>
-                                                            <xs:enumeration value="COMPAT16"/>
-                                                            <xs:enumeration value="DISPOSABLE"/>
-                                                            <xs:enumeration value="TE"/>
-                                                            <xs:enumeration value="VER"/>
-                                                            <xs:enumeration value="UI"/>
-                                                            <xs:enumeration value="BIN"/>
-                                                            <xs:enumeration value="FV"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                        </xs:attribute>
-                                                        <xs:attribute name="GUID" use="optional"
-                                                            type="RegistryFormatGuid"/>
-                                                        <xs:attribute name="SupArchList" type="ArchListType"
-                                                            use="optional"/>
-                                                        <xs:attribute name="SupModList" type="ModuleListType"
-                                                            use="optional"/>
-                                                        <xs:attribute name="FeatureFlag" type="xs:normalizedString"
-                                                            use="optional"/>
-                                                    </xs:extension>
-                                                </xs:simpleContent>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element minOccurs="0" maxOccurs="unbounded" name="AsBuilt">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> This section contains information
-                                                    about how the module was coded, such as Compiler Tools, Flags, PCDs
-                                                    (only PatchPcd and/or PcdEx) and Library Class Instances used to
-                                                    build the binary. </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:sequence>
-
-                                                    <xs:element minOccurs="0" maxOccurs="unbounded" name="PatchPcdValue">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The element is the
-                                                            Patchable PCD Value that was used during the build.
-                                                            </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:sequence>
-                                                            <xs:element minOccurs="1" maxOccurs="1"
-                                                            name="TokenSpaceGuidValue" type="RegistryFormatGuid"/>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="PcdCName"
-                                                            type="xs:NCName"/>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="Token">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            <xs:maxLength value="10"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="DatumType" 
-                                                            type="PcdDatumTypes"/>
-                                                            <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This field is required
-                                                            if the Pcd Datum Type is VOID* </xs:documentation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="Value"
-                                                            type="xs:normalizedString"/>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="Offset">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element ref="HelpText" minOccurs="0"
-                                                            maxOccurs="unbounded"/>
-                                                            <xs:element minOccurs="0" maxOccurs="unbounded"
-                                                            name="PcdError">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> Error information
-                                                            implemented by the module. </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:complexType>
-                                                            <xs:sequence>
-                                                            <xs:choice>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
-                                                                <xs:complexType>
-                                                                  <xs:simpleContent>
-                                                                    <xs:extension base="xs:normalizedString">
-                                                                    <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                                                                    </xs:extension>
-                                                                  </xs:simpleContent>
-                                                                </xs:complexType>
-                                                              </xs:element>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange" type="xs:normalizedString"/>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="Expression" type="xs:normalizedString"/>
-                                                            </xs:choice>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="0" maxOccurs="unbounded"
-                                                            name="ErrorMessage">
-                                                            <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="xs:string">
-                                                            <xs:attribute name="Lang" type="xs:language" default="en-us"
-                                                            use="optional"/>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                            </xs:complexType>
-                                                            </xs:element>
-                                                            </xs:sequence>
-                                                            </xs:complexType>
-                                                            </xs:element>
-                                                            </xs:sequence>
-                                                        </xs:complexType>
-                                                    </xs:element>
-
-                                                    <xs:element minOccurs="0" maxOccurs="unbounded" name="PcdExValue">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The element is the
-                                                            DynamicEx PCD Value that was used during the build.
-                                                            </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:sequence>
-                                                            <xs:element minOccurs="1" maxOccurs="1"
-                                                            name="TokenSpaceGuidValue" type="RegistryFormatGuid"/>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="Token">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            <xs:maxLength value="10"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="DatumType"
-                                                            type="PcdDatumTypes"/>
-                                                            <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This field is required
-                                                            if the Pcd Datum Type is VOID* </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="Value"
-                                                            type="xs:normalizedString"/>
-                                                            <xs:element ref="HelpText" minOccurs="0"
-                                                            maxOccurs="unbounded"/>
-                                                            <xs:element minOccurs="0" maxOccurs="unbounded"
-                                                            name="PcdError">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> Error information
-                                                            implemented by the module. </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:complexType>
-                                                            <xs:sequence>
-                                                            <xs:choice>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
-                                                                <xs:complexType>
-                                                                  <xs:simpleContent>
-                                                                    <xs:extension base="xs:normalizedString">
-                                                                    <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                                                                      </xs:extension>
-                                                                  </xs:simpleContent>
-                                                                </xs:complexType>
-                                                              </xs:element>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange" type="xs:normalizedString"/>
-                                                              <xs:element minOccurs="0" maxOccurs="1" name="Expression" type="xs:normalizedString"/>
-                                                            </xs:choice>
-                                                            <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> The minLength of 3 is
-                                                            required to handle the "0x" prefix to the hex number.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:simpleType>
-                                                            <xs:restriction base="HexNumber">
-                                                            <xs:minLength value="3"/>
-                                                            </xs:restriction>
-                                                            </xs:simpleType>
-                                                            </xs:element>
-                                                            <xs:element minOccurs="0" maxOccurs="unbounded"
-                                                            name="ErrorMessage">
-                                                            <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="xs:string">
-                                                            <xs:attribute name="Lang" type="xs:language" default="en-us"
-                                                            use="optional"/>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                            </xs:complexType>
-                                                            </xs:element>
-                                                            </xs:sequence>
-                                                            </xs:complexType>
-                                                            </xs:element>
-                                                            </xs:sequence>
-                                                        </xs:complexType>
-                                                    </xs:element>
-
-                                                    <xs:element minOccurs="0" maxOccurs="1" name="LibraryInstances">
-                                                        <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This is the actual
-                                                            library instance that was used to link against the module.
-                                                            </xs:documentation>
-                                                        </xs:annotation>
-                                                        <xs:complexType>
-                                                            <xs:sequence>
-                                                            <xs:element minOccurs="1" maxOccurs="unbounded" name="GUID">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This GUID and the
-                                                            Version attribute uniquely identify the actual Library
-                                                            Instance linked in this module. </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:complexType>
-                                                            <xs:simpleContent>
-                                                            <xs:extension base="RegistryFormatGuid">
-                                                            <xs:attribute name="Version" type="xs:decimal"
-                                                            use="required">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This value, along with
-                                                            the GUID, is used to uniquely identify this object.
-                                                            </xs:documentation>
-                                                            </xs:annotation>
-                                                            </xs:attribute>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                            </xs:complexType>
-                                                            </xs:element>
-                                                            </xs:sequence>
-                                                        </xs:complexType>
-                                                    </xs:element>
-
-                                                    <xs:element minOccurs="0" maxOccurs="unbounded" name="BuildFlags">
-                                                        <xs:complexType mixed="true">
-                                                            <xs:simpleContent>
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> Any description of OS,
-                                                            Tool, and flags for the individual tool can go in this
-                                                            section. </xs:documentation>
-                                                            </xs:annotation>
-                                                            <xs:extension base="xs:string">
-                                                            <xs:anyAttribute processContents="lax"/>
-                                                            </xs:extension>
-                                                            </xs:simpleContent>
-                                                        </xs:complexType>
-                                                    </xs:element>
-                                                </xs:sequence>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <!-- End of AsBuilt -->
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                </xs:complexType>
-                            </xs:element>
-
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of BinaryFiles Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PackageDependencies">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Package">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                                            <xs:complexType>
-                                                <xs:simpleContent>
-                                                    <xs:extension base="xs:string">
-                                                        <xs:attribute name="Lang" type="xs:language" default="en-us"
-                                                            use="optional"/>
-                                                    </xs:extension>
-                                                </xs:simpleContent>
-                                            </xs:complexType>
-                                        </xs:element>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="GUID">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> This GUID and the Version attribute
-                                                    uniquely identify Package that this Module depends on.
-                                                </xs:documentation>
-                                            </xs:annotation>
-                                            <xs:complexType>
-                                                <xs:simpleContent>
-                                                    <xs:extension base="RegistryFormatGuid">
-                                                        <xs:attribute name="Version" type="xs:decimal" use="optional">
-                                                            <xs:annotation>
-                                                            <xs:documentation xml:lang="en-us"> This value, along with
-                                                            the GUID, is used to uniquely identify this object. If the
-                                                            version attribute is not specified, the most recent version
-                                                            of the package can be used. </xs:documentation>
-                                                            </xs:annotation>
-                                                        </xs:attribute>
-                                                    </xs:extension>
-                                                </xs:simpleContent>
-                                            </xs:complexType>
-                                        </xs:element>
-                                    </xs:sequence>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PackageDependencies -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="Guids">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="GuidCName">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="VariableName"
-                                            type="xs:normalizedString">
-                                            <xs:annotation>
-                                                <xs:documentation xml:lang="en-us"> Only valid for Variable GUID types. </xs:documentation>
-                                                <xs:documentation> This can be either a Hex Array or C string in unicode
-                                                    format: L"string" Data. </xs:documentation>
-                                            </xs:annotation>
-                                        </xs:element>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us">The module does not install
-                                                            the GUID, and the GUID must be present for the module to
-                                                            execute. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module does not install
-                                                            the GUID, however, the GUID will be used if it is present.
-                                                        </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The module always installs
-                                                            the GUID. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The Module will install the
-                                                            GUID under certain execution paths. </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                                <xs:enumeration value="UNDEFINED">
-                                                    <xs:annotation>
-                                                        <xs:documentation xml:lang="en-us"> The package creator knows
-                                                            that a GUID is used, but does not know how it is used.
-                                                        </xs:documentation>
-                                                    </xs:annotation>
-                                                </xs:enumeration>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="GuidType" type="GuidListType" use="required"/>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Guids Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="Protocols">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A listing of protocols required or produced by this module.
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Protocol" nillable="true">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>                                       
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="PRODUCES"/>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES"/>
-                                                <xs:enumeration value="CONSUMES"/>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES"/>
-                                                <xs:enumeration value="TO_START"/>
-                                                <xs:enumeration value="BY_START"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="Notify" type="xs:boolean" use="optional"/>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Protocols Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PPIs">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> A listing of PPIs required or produced by this module.
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Ppi" nillable="true">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>                                        
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="Usage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="PRODUCES"/>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES"/>
-                                                <xs:enumeration value="CONSUMES"/>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-                                    </xs:attribute>
-                                    <xs:attribute name="Notify" type="xs:boolean" use="optional"/>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PPIs Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="Externs">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> These elements specify additional information about the
-                            module. This area may be used by tools to generate code. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Extern">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:choice minOccurs="1">
-                                            <xs:sequence>
-                                                <xs:element minOccurs="0" maxOccurs="1" name="EntryPoint"
-                                                    type="xs:NCName"/>
-                                                <xs:element minOccurs="0" maxOccurs="1" name="UnloadImage"
-                                                    type="xs:NCName"/>
-                                            </xs:sequence>
-                                            <xs:sequence>
-                                                <xs:element minOccurs="0" maxOccurs="1" name="Constructor"
-                                                    type="xs:NCName"/>
-                                                <xs:element minOccurs="0" maxOccurs="1" name="Destructor"
-                                                    type="xs:NCName"/>
-                                            </xs:sequence>
-                                        </xs:choice>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Externs Section -->
-
-                <xs:element minOccurs="0" maxOccurs="1" name="PcdCoded">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section describes how a platform is coded with respect
-                            to the platform configuration knobs. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdEntry">
-                                <xs:complexType>
-                                    <xs:sequence>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
-                                        <xs:element minOccurs="1" maxOccurs="1" name="TokenSpaceGuidCName"
-                                            type="xs:NCName"/>
-                                        <xs:element minOccurs="0" maxOccurs="1" name="DefaultValue"
-                                            type="xs:normalizedString"/>
-                                        <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
-                                    </xs:sequence>
-                                    <xs:attribute name="PcdItemType" type="PcdItemTypes" use="required"/>
-                                    <xs:attribute name="PcdUsage" use="required">
-                                        <xs:simpleType>
-                                            <xs:restriction base="xs:NCName">
-                                                <xs:enumeration value="PRODUCES"/>
-                                                <xs:enumeration value="SOMETIMES_PRODUCES"/>
-                                                <xs:enumeration value="CONSUMES"/>
-                                                <xs:enumeration value="SOMETIMES_CONSUMES"/>
-                                                <xs:enumeration value="UNDEFINED"/>
-                                            </xs:restriction>
-                                        </xs:simpleType>
-
-
-                                    </xs:attribute>
-                                    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                                    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                                    <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PcdCoded Section -->
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="PeiDepex">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the PEI dependency expression for a Dependency
-                            Section. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element name="Expression" type="xs:string" minOccurs="1" maxOccurs="1">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> An in-fix expression, of C identifiers and TRUE,
-                                        FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
-                                        notation. The operators are restricted to grammar defined in the PI
-                                        specification. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
-                        </xs:sequence>
-                        <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                        <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                        <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of PeiDepex Section -->
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="DxeDepex">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the DXE dependency expression for a Dependency
-                            Section. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element name="Expression" type=" xs:string " minOccurs="1" maxOccurs="1">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> An in-fix expression, of C identifiers and TRUE,
-                                        FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
-                                        notation. The operators are restricted to grammar defined in the PI
-                                        specification. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
-                        </xs:sequence>
-                        <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                        <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                        <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of DxeDepex Section -->
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="SmmDepex">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the SMM dependency expression for a Dependency
-                            Section. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element name="Expression" type=" xs:string " minOccurs="1" maxOccurs="1">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> An in-fix expression, of C identifiers and TRUE,
-                                        FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
-                                        notation. The operators are restricted to grammar defined in the PI
-                                        specification. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
-                        </xs:sequence>
-                        <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-                        <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-                        <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of SmmDepex Section -->
-
-
-                <xs:element minOccurs="0" maxOccurs="1" name="MiscellaneousFiles">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used to provide comments and/or list
-                            auxiliary files, such as pdb or map files. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is the path and filename location within
-                                        the ZIP file. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:anyURI">
-                                            <xs:attribute name="Executable" type="xs:boolean" default="false"
-                                                use="optional">
-                                                <xs:annotation>
-                                                    <xs:documentation xml:lang="en-us"> If true, used by installation
-                                                        tools to ensure that a file that must be executable has the
-                                                        correct properties to permit execution. </xs:documentation>
-                                                </xs:annotation>
-                                            </xs:attribute>
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Module Surface Area Misc Section -->
-
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="UserExtensions">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This section is used for any processing instructions that
-                            may be custom to the content provided by the distribution that are common to module. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> The content is vendor specific. </xs:documentation>
-                        <xs:documentation xml:lang="en-us"> The content can be plain text as well as any user-defined,
-                            properly formatted XML structure. </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType mixed="true">
-                        <xs:attribute name="UserId" type="xs:NCName" use="required">
-                            <xs:annotation>
-                                <xs:documentation xml:lang="en-us"> This is a single word identifier for grouping
-                                    similar content. For example, ReferenceBuild might be used to identify non-PI
-                                    compliant build steps, with two different UserExtensions sections, one with an
-                                    Identifier of Prebuild, and another of PostBuild. Both UserExtensions sections would
-                                    use the same UserId. </xs:documentation>
-                            </xs:annotation>
-                        </xs:attribute>
-                        <xs:attribute name="Identifier" type="xs:string" use="required">
-                            <xs:annotation>
-                                <xs:documentation xml:lang="en-us"> This can be any string used to differentiate or
-                                    identify this section from other UserExtensions sections. </xs:documentation>
-                                <xs:documentation xml:lang="en-us"> For example, a PRE_PROCESS Identifier might indicate
-                                    specific steps and tools required before processing module content, while a
-                                    different UserExtensions section with a POST_PROCESS Identifier might describe steps
-                                    that need to be executed after operations on this module. </xs:documentation>
-                            </xs:annotation>
-                        </xs:attribute>
-                        <xs:anyAttribute processContents="lax"/>
-                    </xs:complexType>
-                </xs:element>
-                <!-- End of Module Surface Area UserExtensions Section -->
-
-            </xs:sequence>
-            <xs:attribute name="BinaryModule" type="xs:boolean" default="false" use="optional">
-                <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This attribute is used when the binaries are distributed for
-                        this module and no code generation from source files is required. If set, then the BinaryFiles
-                        section should be used, and any files listed in the SourceFiles section do not have to be built.
-                        Additionally, the AsBuilt section for each binary file must be included. </xs:documentation>
-                </xs:annotation>
-            </xs:attribute>
-        </xs:complexType>
-
-    </xs:element>
-    <!-- End of the ModuleSurfaceArea element. -->
-
-    <xs:element name="Tools">
-        <xs:complexType>
-            <xs:sequence>
-                <xs:element minOccurs="0" maxOccurs="1" name="Header">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="1" maxOccurs="1" name="Name" type="xs:normalizedString">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us">This is the User Interface Name for this Tools
-                                        Distribution.</xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the Copyright is
-                                        different from the Distribution Package copyright. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the License is
-                                        different from the Distribution Package license. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Abstract">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the Abstract is
-                                        different from the Distribution Package Abstract. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:normalizedString">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                                        </xs:extension>                                        
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Description">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the Description is
-                                        different from the Distribution Package Description. </xs:documentation>
-                                </xs:annotation>
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                                        </xs:extension>                                        
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                                
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the path and filename location within the ZIP file.
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:anyURI">
-                                <xs:attribute name="OS" type="SupportedOs" use="optional">
-                                    <xs:annotation>
-                                        <xs:documentation xml:lang="en-us"> This is required for tools that execute; it
-                                            should not be used for configuration files. </xs:documentation>
-                                    </xs:annotation>
-                                </xs:attribute>
-                                <xs:attribute name="Executable" type="xs:boolean" default="false" use="optional">
-                                    <xs:annotation>
-                                        <xs:documentation xml:lang="en-us"> If true, used by installation tools to
-                                            ensure that a file that must be executable has the correct properties to
-                                            permit execution. </xs:documentation>
-                                    </xs:annotation>
-                                </xs:attribute>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-            </xs:sequence>
-        </xs:complexType>
-    </xs:element>
-    <!-- End of the Tools element. -->
-
-    <xs:element name="MiscellaneousFiles">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> This section contains a list of files that are not part of the code
-                distributed with modules, packages or tools. </xs:documentation>
-        </xs:annotation>
-        <xs:complexType>
-            <xs:sequence>
-                <xs:element minOccurs="0" maxOccurs="1" name="Header">
-                    <xs:complexType>
-                        <xs:sequence>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Name" type="xs:normalizedString">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> The User interface name for this content.
-                                    </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the Copyright is
-                                        different from the Distribution Package Copyright. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
-                                <xs:annotation>
-                                    <xs:documentation xml:lang="en-us"> This is only required if the License is
-                                        different from the Distribution Package License. </xs:documentation>
-                                </xs:annotation>
-                            </xs:element>
-                            <xs:element minOccurs="0" maxOccurs="1" name="Abstract" type="xs:normalizedString"/>
-                            <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
-                                <xs:complexType>
-                                    <xs:simpleContent>
-                                        <xs:extension base="xs:string">
-                                            <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
-                                            />
-                                        </xs:extension>
-                                    </xs:simpleContent>
-                                </xs:complexType>
-                            </xs:element>
-                        </xs:sequence>
-                    </xs:complexType>
-                </xs:element>
-                <xs:element minOccurs="0" maxOccurs="unbounded" name="Filename">
-                    <xs:annotation>
-                        <xs:documentation xml:lang="en-us"> This is the path and filename location within the ZIP file.
-                        </xs:documentation>
-                    </xs:annotation>
-                    <xs:complexType>
-                        <xs:simpleContent>
-                            <xs:extension base="xs:anyURI">
-                                <xs:attribute name="Executable" type="xs:boolean" default="false" use="optional">
-                                    <xs:annotation>
-                                        <xs:documentation xml:lang="en-us"> If true, used by installation tools to
-                                            ensure that a file that must be executable has the correct properties to
-                                            permit execution. </xs:documentation>
-                                    </xs:annotation>
-                                </xs:attribute>
-                            </xs:extension>
-                        </xs:simpleContent>
-                    </xs:complexType>
-                </xs:element>
-            </xs:sequence>
-        </xs:complexType>
-    </xs:element>
-    <!-- End of the Misc element. -->
+                          </xs:choice>
+                          <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                A hexadecimal value for
+                                the error message as defined by specifications.
+                              </xs:documentation>
+                              <xs:documentation xml:lang="en-us">
+                                The minLength of 3 is
+                                required to handle the "0x" prefix to the hex number.
+                              </xs:documentation>
 
-    <xs:element name="UserExtensions">
-        <xs:complexType mixed="true">
-            <xs:sequence>
-                <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
+                            </xs:annotation>
+                            <xs:simpleType>
+                              <xs:restriction base="HexNumber">
+                                <xs:minLength value="3"/>
+                              </xs:restriction>
+                            </xs:simpleType>
+                          </xs:element>
+                          <xs:element minOccurs="1" maxOccurs="unbounded" name="ErrorMessage">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                This string should be
+                                defined by specifications. There are pre-defined error
+                                number ranges in the UEFI/PI specificaiton.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:simpleContent>
+                                <xs:extension base="xs:string">
+                                  <xs:attribute name="Lang" type="xs:language" default="en-us"
+                                  use="optional"/>
+                                </xs:extension>
+                              </xs:simpleContent>
+                            </xs:complexType>
+                          </xs:element>
+                        </xs:sequence>
+                      </xs:complexType>
+                    </xs:element>
+                  </xs:sequence>
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                </xs:complexType>
+              </xs:element>
             </xs:sequence>
-            <xs:attribute name="UserId" type="xs:NCName" use="required">
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea PcdDeclarations element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PcdRelationshipChecks">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used to describe any PCD interdependencies
+              or relationships.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdCheck" type="xs:normalizedString">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This is a single word identifier for grouping similar content.
-                        For example, ReferenceBuild might be used to identify non-PI compliant build steps, with two
-                        different UserExtensions sections, one with an Identifier of Prebuild, and another of PostBuild.
-                        Both UserExtensions sections would use the same UserId. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This entry must used
+                    TokenSpaceGuidCName.PcdCname for every named PCD. Restricted to Relational,
+                    Equality and Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and
+                    parenthesis are valid. Only the TokenSpaceGuidCName.PcdCname us permitted to
+                    name PCDs in the expression. All other values must be numeric.
+                  </xs:documentation>
+                  <xs:documentation xml:lang="en-us"> LValue (op RValue)+ </xs:documentation>
                 </xs:annotation>
-            </xs:attribute>
-            <xs:attribute name="Identifier" type="xs:string" use="optional">
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="MiscellaneousFiles">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section contains files that are not part of the code
+              distributed with this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This can be any string used to differentiate or identify this
-                        section from other UserExtensions sections. </xs:documentation>
-                    <xs:documentation xml:lang="en-us"> For example, a PRE_PROCESS Identifier might indicate specific
-                        steps and tools required before processing distribution package content, while a different
-                        UserExtensions section with a POST_PROCESS Identifier might describe steps that need to be
-                        executed after operations on this content. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    Only required if different from the Package
+                    Copyright.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:attribute>
-            <xs:anyAttribute processContents="lax"/>
-        </xs:complexType>
-    </xs:element>
-    <!-- The following elsements are common definitions used with the ref attribute for elements. -->
-
-    <xs:element name="HelpText">
-        <xs:complexType>
-            <xs:simpleContent>
-                <xs:extension base="xs:string">
-                    <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
-                </xs:extension>
-            </xs:simpleContent>
-        </xs:complexType>
-    </xs:element>
-
-    <!-- The following attribute groups are used in various elements above. -->
-
-    <xs:attributeGroup name="SupportedArchMod">
-        <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
-        <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
-    </xs:attributeGroup>
-
-    <!-- The following data types are used to restrict content. -->
-
-    <xs:simpleType name="ArchListType">
-        <xs:list itemType="ArchTypes"/>
-    </xs:simpleType>
-
-    <xs:simpleType name="ArchTypes">
-        <xs:restriction base="xs:NCName">
-            <xs:enumeration value="IA32"/>
-            <xs:enumeration value="X64"/>
-            <xs:enumeration value="IPF"/>
-            <xs:enumeration value="EBC"/>
-            <xs:enumeration value="ARM"/>
-            <xs:pattern value="([A-Z])([a-zA-Z0-9])*">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> Any processor architecture not listed above. The Architecture
-                        must be a target architecture of one or more compiler tool chains. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    Only required if different from the Package
+                    License.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:pattern>
-        </xs:restriction>
-    </xs:simpleType>
-
-
-    <xs:simpleType name="FamilyTypes">
-        <xs:restriction base="xs:NCName">
-            <xs:enumeration value="MSFT"/>
-            <xs:enumeration value="GCC"/>
-            <xs:pattern value="[A-Z][a-zA-Z0-9]*">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Abstract" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> Any other family of build utilities for which compiler tools
-                        exist. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    A one line description of this section's
+                    content.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:pattern>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="GuidListType">
-        <xs:list itemType="GuidTypes"/>
-    </xs:simpleType>
-
-    <xs:simpleType name="GuidTypes">
-        <xs:restriction base="xs:NCName">
-            <xs:enumeration value="Event"/>
-            <xs:enumeration value="File"/>
-            <xs:enumeration value="FV"/>
-            <xs:enumeration value="GUID"/>
-            <xs:enumeration value="HII"/>
-            <xs:enumeration value="Hii"/>
-            <xs:enumeration value="HOB"/>
-            <xs:enumeration value="SystemTable"/>
-            <xs:enumeration value="TokenSpaceGuid"/>
-            <xs:enumeration value="Variable"/>
-            <xs:enumeration value="UNDEFINED"/>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="HexNumber">
-        <xs:restriction base="xs:hexBinary">
-            <xs:pattern value="0x([a-fA-F0-9])+"/>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="Md5Sum">
-        <xs:restriction base="xs:normalizedString">
-            <xs:pattern value="[a-zA-Z0-9]{32}"/>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="ModuleListType">
-        <xs:list itemType="ModuleTypes"/>
-    </xs:simpleType>
-
-    <xs:simpleType name="ModuleTypes">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> The following module types are defined by specifications. </xs:documentation>
-            <xs:documentation xml:lang="en-us"> Module types for components and libraries defined for this distribution
-                mechanism. </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:NCName">
-            <xs:enumeration value="BASE ">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Description" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> Use of this module is not restricted. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    A complete description of the files in this
+                    section.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="DXE_CORE">
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to the DXE core.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the PackagePath relative path and
+                    filename location within the ZIP file.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="DXE_DRIVER">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:anyURI">
+                      <xs:attribute name="Executable" type="xs:boolean" default="false"
+                          use="optional">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            If true, used by installation
+                            tools to ensure that a file that must be executable has the
+                            correct properties to permit execution.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea Misc element.  -->
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="UserExtensions">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used for any processing instructions that
+              may be custom to the content provided by this package that are common to this package.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType mixed="true">
+            <xs:sequence>
+              <xs:any processContents="lax" minOccurs="0" maxOccurs="1"/>
+            </xs:sequence>
+            <xs:attribute name="UserId" type="xs:NCName" use="required">
+              <xs:annotation>
+                <xs:documentation xml:lang="en-us">
+                  This is a single word identifier for grouping
+                  similar content that does not fit into previously defined sections or other sections
+                  of the Distribution.
+                </xs:documentation>
+              </xs:annotation>
+            </xs:attribute>
+            <xs:attribute name="Identifier" type="xs:string" use="required">
+              <xs:annotation>
+                <xs:documentation xml:lang="en-us">
+                  This can be used to differentiate multiple sections
+                  with a grouping.
+                </xs:documentation>
+                <xs:documentation xml:lang="en-us">
+                  For example, a PRE_PROCESS Identifier might indicate
+                  specific steps and tools required before processing module content, while a
+                  different UserExtensions section with a POST_PROCESS Identifier might describe steps
+                  that need to be executed after operations on the modules in this package.
+                </xs:documentation>
+              </xs:annotation>
+            </xs:attribute>
+            <xs:anyAttribute processContents="lax"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageSurfaceArea UserExtensions element. -->
+
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <!-- End of the PackageSurfaceArea element. -->
+
+  <xs:element name="ModuleSurfaceArea">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        Each module is uniquely identified by it's GUID and Version number.
+        Backward compatible releases of a module need only change the version number, while non-backward
+        compatible changes require the GUID to change (resetting the version number to 1.0 is optional.)
+      </xs:documentation>
+    </xs:annotation>
+    <xs:complexType>
+      <xs:sequence>
+
+        <xs:element minOccurs="1" maxOccurs="1" name="Header">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="1" name="Name">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to a DXE driver.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the User Interface Name for this Module.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="DXE_RUNTIME_DRIVER">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:normalizedString">
+                      <xs:attribute name="BaseName" type="xs:NMTOKEN" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This is a single word BaseName
+                            that will be used to create a module meta-data file.
+                          </xs:documentation>
+                          <xs:documentation xml:lang="en-us">
+                            This name should also be used to
+                            create output file names and directories.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="1" name="GUID">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to a DXE runtime driver.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This GUID and the Version attribute uniquely
+                    identify a given Module.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="DXE_SAL_DRIVER">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="RegistryFormatGuid">
+                      <xs:attribute name="Version" type="xs:decimal" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This value, along with the GUID,
+                            is used to uniquely identify this object.
+                          </xs:documentation>
+                          <xs:documentation xml:lang="en-us">
+                            Backward compatible changes must
+                            make sure this number is incremented from the most recent
+                            version. Non-backward compatible changes require a new GUID, and
+                            the version can be reset.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Copyright">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to an IPF DXE runtime driver.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the Copyright is
+                    different from either the Package or Distribution copyright. Multiple copyright
+                    lines are permitted within this section.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="DXE_SMM_DRIVER">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="License">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to a DXE SMM driver.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the license is
+                    different from either the Package or Distribution license. Multiple licenses are
+                    permitted within this section.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="PEI_CORE">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Abstract">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to the PEI core.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    A brief text description of the module.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="PEIM">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:normalizedString">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only valid for PEI modules. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    A complete description of the module contents
+                    and/or features including a description of the updates since the previous module
+                    release.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="SEC">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Module Surface Area Header Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="ModuleProperties">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              List general information about a module, including the
+              Supported Architectures, this module's type, specifications the module is coded against, and
+              other informational content.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="1" name="ModuleType" type="ModuleTypes">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to Security phase.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    One of the Enumerated module types that limit
+                    the use of a module.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="UEFI_DRIVER">
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="1" name="Path" type="xs:anyURI">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only valid for UEFI drivers. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    For stand-alone modules that are NOT part of any
+                    package, this is the path to the root of the module as listed in the ZIP file.
+                    For modules included in a package, this is the location, relative to the root of
+                    the package (PackagePath) this module belongs to.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="UEFI_RUNTIME_DRIVER">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="PcdIsDriver">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only valid for UEFI runtime
-                        drivers.</xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This element is only required for the PEIM that
+                    produces the PCD PPI or the DXE Driver that produces the PCD Protocol.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="UEFI_APPLICATION">
+                <xs:simpleType>
+                  <xs:restriction base="xs:NCName">
+                    <xs:enumeration value="PEI_PCD_DRIVER"/>
+                    <xs:enumeration value="DXE_PCD_DRIVER"/>
+                  </xs:restriction>
+                </xs:simpleType>
+              </xs:element>
+
+              <xs:element minOccurs="0" maxOccurs="1" name="UefiSpecificationVersion" type="xs:decimal"/>
+
+              <xs:element minOccurs="0" maxOccurs="1" name="PiSpecificationVersion" type="xs:decimal"/>
+
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Specification">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only valid for UEFI applications.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is a list of other specifications that this
+                    module is written against. These entries can be used in #define statements
+                    (depending on the build system implementation, they may be autogenerated.)
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="SMM_CORE">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:NCName">
+                      <xs:attribute name="Version" type="xs:decimal" use="required"/>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="BootMode">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This module is only applicable to the SMM
-                        core.</xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    Different firmware execution paths may be taken
+                    based on a given state of the hardware, firmware, or through feature settings. A
+                    BootMode may be declared (PRODUCES) or discovered (CONSUMES) based on these
+                    states and feature settings. If the usage is UNDEFINE, it implies that a Boot
+                    Mode is used, but the package creator does not know how it is used. The
+                    supported boot modes map to the PI specification Boot Modes. The boot modes
+                    listed with Recovery are to indicate that the BootMode is valid during a
+                    recovery boot.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="USER_DEFINED">
+                <xs:complexType>
+                  <xs:sequence minOccurs="0">
+                    <xs:element minOccurs="1" maxOccurs="1" name="SupportedBootModes">
+                      <xs:simpleType>
+                        <xs:list>
+                          <xs:simpleType>
+                            <xs:restriction base="xs:NCName">
+                              <xs:enumeration value="FULL"/>
+                              <xs:enumeration value="MINIMAL"/>
+                              <xs:enumeration value="NO_CHANGE"/>
+                              <xs:enumeration value="DIAGNOSTICS"/>
+                              <xs:enumeration value="DEFAULT"/>
+                              <xs:enumeration value="S2_RESUME"/>
+                              <xs:enumeration value="S3_RESUME"/>
+                              <xs:enumeration value="S4_RESUME"/>
+                              <xs:enumeration value="S5_RESUME"/>
+                              <xs:enumeration value="FLASH_UPDATE"/>
+                              <xs:enumeration value="RECOVERY_FULL"/>
+                              <xs:enumeration value="RECOVERY_MINIMAL"/>
+                              <xs:enumeration value="RECOVERY_NO_CHANGE"/>
+                              <xs:enumeration value="RECOVERY_DIAGNOSTICS"/>
+                              <xs:enumeration value="RECOVERY_DEFAULT"/>
+                              <xs:enumeration value="RECOVERY_S2_RESUME"/>
+                              <xs:enumeration value="RECOVERY_S3_RESUME"/>
+                              <xs:enumeration value="RECOVERY_S4_RESUME"/>
+                              <xs:enumeration value="RECOVERY_S5_RESUME"/>
+                              <xs:enumeration value="RECOVERY_FLASH_UPDATE"/>
+                              <xs:enumeration value="UNDEFINED"/>
+                            </xs:restriction>
+                          </xs:simpleType>
+                        </xs:list>
+                      </xs:simpleType>
+                    </xs:element>
+
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module always supports
+                              the given boot modes.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module may support a
+                              given mode on some execution paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will change the
+                              boot mode.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIME_PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will change the
+                              boot mode on some exection paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="UNDEFINED">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The package creator does not
+                              know how the boot mode is used.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Event" nillable="true">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This content is restricted to a specific implementation.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    The functions that make up the Event, Timer, and
+                    Task Priority Services are used during preboot to create, close, signal, and
+                    wait for events; to set timers; and to raise and restore task priority levels as
+                    defined in the UEFI specification. GUIDed events should be listed in the Guids
+                    section.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="UNDEFINED">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will register a
+                              notification function and calls the function when it is
+                              signaled.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will register a
+                              notification function and calls the function when it is
+                              signaled on some execution paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will signal all
+                              events in an event group.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module will signal all
+                              events in an event group under some execution paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="UNDEFINED">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The package creator does not
+                              know how an event is used.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="EventType" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="EVENT_TYPE_PERIODIC_TIMER"/>
+                        <xs:enumeration value="EVENT_TYPE_RELATIVE_TIMER"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+
+
+                  </xs:attribute>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="HOB" nillable="false">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This enumeration is for use in a list that where the package
-                        creator does not know the what module types are supported by a module. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is a list of non-GUIDed Hand Off Blocks
+                    (HOBs) produced or consumed by this module.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:pattern value="([A-Z])([a-zA-Z0-9])*">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="HobType" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="PHIT"/>
+                        <xs:enumeration value="MEMORY_ALLOCATION"/>
+                        <xs:enumeration value="RESOURCE_DESCRIPTOR"/>
+                        <xs:enumeration value="FIRMWARE_VOLUME"/>
+                        <xs:enumeration value="LOAD_PEIM"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              A HOB must be present in the
+                              system.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              If present, the HOB will be
+                              used.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The HOB is always produced
+                              by the module.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The HOB may be produced by
+                              the module under some execution paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="UNDEFINED">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The package creator knows
+                              that a HOB is used, but does not know how it is used.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+
+            </xs:sequence>
+            <xs:attributeGroup ref="SupportedArchMod"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of ModuleProperties Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="ClonedFrom">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section may be included for Modules that are copied
+              from a different module.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="1" name="GUID">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This pattern has been added for use in a module lists - for
-                        future expansion. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This GUID and the Version attribute uniquely
+                    identify the Module that this Module was copied from.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:pattern>
-        </xs:restriction>
-    </xs:simpleType>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="RegistryFormatGuid">
+                      <xs:attribute name="Version" type="xs:decimal" use="required">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            This value, along with the GUID,
+                            is used to uniquely identify this object.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!--  End of ClonedFrom Section. -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="LibraryClassDefinitions">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A list of the different Library Classes consumed by a
+              driver, core and/or application module, or produced by a Library module.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="LibraryClass">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="Keyword" type="xs:NCName">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us ">
+                          Used by tools to identify different
+                          instances of libraries that provide the library class. This keyword
+                          identifies the library class this module needs to be linked against.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element minOccurs="0" maxOccurs="1" name="RecommendedInstance">
+                      <xs:complexType>
+                        <xs:all>
+                          <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                This GUID and the
+                                Version attribute uniquely identify the recommended Library
+                                Instance for this module .
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:simpleContent>
+                                <xs:extension base="RegistryFormatGuid">
+                                  <xs:attribute name="Version" type="xs:decimal"
+                                  use="optional">
+                                    <xs:annotation>
+                                      <xs:documentation xml:lang="en-us">
+                                        This value, along with
+                                        the GUID, is used to uniquely identify this object.
+                                      </xs:documentation>
+                                    </xs:annotation>
+                                  </xs:attribute>
+                                </xs:extension>
+                              </xs:simpleContent>
+                            </xs:complexType>
+                          </xs:element>
+                        </xs:all>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          Library instances can provide code
+                          for a library class, or may require other library instances
+                          themselves. Since different execution paths in a library (or module)
+                          may need different library classes based on some setting, library
+                          classes may not alway be required.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="PRODUCES"/>
+                        <xs:enumeration value="CONSUMES"/>
+                        <xs:enumeration value="SOMETIMES_CONSUMES"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+
+                  <xs:attributeGroup ref="SupportedArchMod"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional">
+                    <xs:annotation>
+                      <xs:documentation xml:lang="en-us">
+                        A FeatureFlag attribute must evaluate to
+                        either true or false - it may be a fixed value of true or false, a C
+                        name or an in-fix expression.
+                      </xs:documentation>
+                    </xs:annotation>
+                  </xs:attribute>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of LibraryClassDefinitions Section -->
 
-    <xs:simpleType name="PcdDatumTypes">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> The following data types are defined by the PCD specification (or PCD
-                section of the UEFI/PI specifications.) </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:normalizedString">
-            <xs:enumeration value="UINT8"/>
-            <xs:enumeration value="UINT16"/>
-            <xs:enumeration value="UINT32"/>
-            <xs:enumeration value="UINT64"/>
-            <xs:enumeration value="BOOLEAN"/>
-            <xs:enumeration value="VOID*"/>
-        </xs:restriction>
-    </xs:simpleType>
-
-    <xs:simpleType name="PcdItemListType">
-        <xs:list itemType="PcdItemTypes"/>
-    </xs:simpleType>
-
-    <xs:simpleType name="PcdItemTypes">
-        <xs:restriction base="xs:NCName">
-            <xs:enumeration value="FeaturePcd">
+        <xs:element minOccurs="0" maxOccurs="1" name="SourceFiles">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> The Feature PCD is a binary, evaluating to either true or false.
-                        This is used during build to include/exclude content. It can also be used during execution to
-                        force execution paths within drivers, or to enable/disable features within a driver for a given
-                        platform. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the module relative
+                    (ModuleProperties.Path) path and filename location within the ZIP file.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="FixedPcd">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:anyURI">
+                      <xs:attribute name="Family" type="FamilyTypes" use="optional">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            The Family attribute is used to
+                            restrict usage to a given family of compilers, such as GCC or
+                            MSFT. Since not all code processing tools use the same syntax,
+                            especially for assembly, this field can be used to identify
+                            different syntax.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                      <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                      <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                      <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of SourceFiles Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="BinaryFiles">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="BinaryFile">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          This is the module relative
+                          (ModuleProperties.Path) path and filename location within the ZIP
+                          file.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:complexType>
+                        <xs:simpleContent>
+                          <xs:extension base="xs:anyURI">
+                            <xs:attribute name="FileType" use="optional">
+                              <xs:simpleType>
+                                <xs:restriction base="xs:NCName">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      Binary file distribution
+                                      is limited to UEFI/PI FFS leaf section file types.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:enumeration value="GUID"/>
+                                  <xs:enumeration value="FREEFORM"/>
+                                  <xs:enumeration value="UEFI_IMAGE"/>
+                                  <xs:enumeration value="PE32">
+                                    <xs:annotation>
+                                      <xs:documentation xml:lang="en-us">
+                                        A UEFI/PI FFS Leaf
+                                        section file type, not a raw PE32 file.
+                                      </xs:documentation>
+                                    </xs:annotation>
+                                  </xs:enumeration>
+                                  <xs:enumeration value="PIC"/>
+                                  <xs:enumeration value="PEI_DEPEX"/>
+                                  <xs:enumeration value="DXE_DEPEX"/>
+                                  <xs:enumeration value="SMM_DEPEX"/>
+                                  <xs:enumeration value="COMPAT16"/>
+                                  <xs:enumeration value="DISPOSABLE"/>
+                                  <xs:enumeration value="TE"/>
+                                  <xs:enumeration value="VER"/>
+                                  <xs:enumeration value="UI"/>
+                                  <xs:enumeration value="BIN"/>
+                                  <xs:enumeration value="FV"/>
+                                </xs:restriction>
+                              </xs:simpleType>
+                            </xs:attribute>
+                            <xs:attribute name="GUID" use="optional"
+                                type="RegistryFormatGuid"/>
+                            <xs:attribute name="SupArchList" type="ArchListType"
+                                use="optional"/>
+                            <xs:attribute name="SupModList" type="ModuleListType"
+                                use="optional"/>
+                            <xs:attribute name="FeatureFlag" type="xs:normalizedString"
+                                use="optional"/>
+                          </xs:extension>
+                        </xs:simpleContent>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element minOccurs="0" maxOccurs="unbounded" name="AsBuilt">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          This section contains information
+                          about how the module was coded, such as Compiler Tools, Flags, PCDs
+                          (only PatchPcd and/or PcdEx) and Library Class Instances used to
+                          build the binary.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:complexType>
+                        <xs:sequence>
+
+                          <xs:element minOccurs="0" maxOccurs="unbounded" name="PatchPcdValue">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                The element is the
+                                Patchable PCD Value that was used during the build.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:sequence>
+                                <xs:element minOccurs="1" maxOccurs="1"
+                                name="TokenSpaceGuidValue" type="RegistryFormatGuid"/>
+                                <xs:element minOccurs="1" maxOccurs="1" name="PcdCName"
+                                type="xs:NCName"/>
+                                <xs:element minOccurs="1" maxOccurs="1" name="Token">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      The minLength of 3 is
+                                      required to handle the "0x" prefix to the hex number.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:simpleType>
+                                    <xs:restriction base="HexNumber">
+                                      <xs:minLength value="3"/>
+                                      <xs:maxLength value="10"/>
+                                    </xs:restriction>
+                                  </xs:simpleType>
+                                </xs:element>
+                                <xs:element minOccurs="1" maxOccurs="1" name="DatumType"
+                                type="PcdDatumTypes"/>
+                                <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      This field is required
+                                      if the Pcd Datum Type is VOID*
+                                    </xs:documentation>
+                                    <xs:documentation xml:lang="en-us">
+                                      The minLength of 3 is
+                                      required to handle the "0x" prefix to the hex number.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:simpleType>
+                                    <xs:restriction base="HexNumber">
+                                      <xs:minLength value="3"/>
+                                    </xs:restriction>
+                                  </xs:simpleType>
+                                </xs:element>
+                                <xs:element minOccurs="1" maxOccurs="1" name="Value"
+                                type="xs:normalizedString"/>
+                                <xs:element minOccurs="1" maxOccurs="1" name="Offset">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      The minLength of 3 is
+                                      required to handle the "0x" prefix to the hex number.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:simpleType>
+                                    <xs:restriction base="HexNumber">
+                                      <xs:minLength value="3"/>
+                                    </xs:restriction>
+                                  </xs:simpleType>
+                                </xs:element>
+                                <xs:element ref="HelpText" minOccurs="0"
+                                maxOccurs="unbounded"/>
+                                <xs:element minOccurs="0" maxOccurs="unbounded"
+                                name="PcdError">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      Error information
+                                      implemented by the module.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:complexType>
+                                    <xs:sequence>
+                                      <xs:choice>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
+                                          <xs:complexType>
+                                            <xs:simpleContent>
+                                              <xs:extension base="xs:normalizedString">
+                                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+                                              </xs:extension>
+                                            </xs:simpleContent>
+                                          </xs:complexType>
+                                        </xs:element>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange" type="xs:normalizedString"/>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="Expression" type="xs:normalizedString"/>
+                                      </xs:choice>
+                                      <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
+                                        <xs:annotation>
+                                          <xs:documentation xml:lang="en-us">
+                                            The minLength of 3 is
+                                            required to handle the "0x" prefix to the hex number.
+                                          </xs:documentation>
+                                        </xs:annotation>
+                                        <xs:simpleType>
+                                          <xs:restriction base="HexNumber">
+                                            <xs:minLength value="3"/>
+                                          </xs:restriction>
+                                        </xs:simpleType>
+                                      </xs:element>
+                                      <xs:element minOccurs="0" maxOccurs="unbounded"
+                                      name="ErrorMessage">
+                                        <xs:complexType>
+                                          <xs:simpleContent>
+                                            <xs:extension base="xs:string">
+                                              <xs:attribute name="Lang" type="xs:language" default="en-us"
+                                              use="optional"/>
+                                            </xs:extension>
+                                          </xs:simpleContent>
+                                        </xs:complexType>
+                                      </xs:element>
+                                    </xs:sequence>
+                                  </xs:complexType>
+                                </xs:element>
+                              </xs:sequence>
+                            </xs:complexType>
+                          </xs:element>
+
+                          <xs:element minOccurs="0" maxOccurs="unbounded" name="PcdExValue">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                The element is the
+                                DynamicEx PCD Value that was used during the build.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:sequence>
+                                <xs:element minOccurs="1" maxOccurs="1"
+                                name="TokenSpaceGuidValue" type="RegistryFormatGuid"/>
+                                <xs:element minOccurs="1" maxOccurs="1" name="Token">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      The minLength of 3 is
+                                      required to handle the "0x" prefix to the hex number.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:simpleType>
+                                    <xs:restriction base="HexNumber">
+                                      <xs:minLength value="3"/>
+                                      <xs:maxLength value="10"/>
+                                    </xs:restriction>
+                                  </xs:simpleType>
+                                </xs:element>
+                                <xs:element minOccurs="1" maxOccurs="1" name="DatumType"
+                                type="PcdDatumTypes"/>
+                                <xs:element minOccurs="0" maxOccurs="1" name="MaxDatumSize">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      This field is required
+                                      if the Pcd Datum Type is VOID*
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:simpleType>
+                                    <xs:restriction base="HexNumber">
+                                      <xs:minLength value="3"/>
+                                    </xs:restriction>
+                                  </xs:simpleType>
+                                </xs:element>
+                                <xs:element minOccurs="1" maxOccurs="1" name="Value"
+                                type="xs:normalizedString"/>
+                                <xs:element ref="HelpText" minOccurs="0"
+                                maxOccurs="unbounded"/>
+                                <xs:element minOccurs="0" maxOccurs="unbounded"
+                                name="PcdError">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      Error information
+                                      implemented by the module.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:complexType>
+                                    <xs:sequence>
+                                      <xs:choice>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueList">
+                                          <xs:complexType>
+                                            <xs:simpleContent>
+                                              <xs:extension base="xs:normalizedString">
+                                                <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+                                              </xs:extension>
+                                            </xs:simpleContent>
+                                          </xs:complexType>
+                                        </xs:element>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="ValidValueRange" type="xs:normalizedString"/>
+                                        <xs:element minOccurs="0" maxOccurs="1" name="Expression" type="xs:normalizedString"/>
+                                      </xs:choice>
+                                      <xs:element minOccurs="1" maxOccurs="1" name="ErrorNumber">
+                                        <xs:annotation>
+                                          <xs:documentation xml:lang="en-us">
+                                            The minLength of 3 is
+                                            required to handle the "0x" prefix to the hex number.
+                                          </xs:documentation>
+                                        </xs:annotation>
+                                        <xs:simpleType>
+                                          <xs:restriction base="HexNumber">
+                                            <xs:minLength value="3"/>
+                                          </xs:restriction>
+                                        </xs:simpleType>
+                                      </xs:element>
+                                      <xs:element minOccurs="0" maxOccurs="unbounded"
+                                      name="ErrorMessage">
+                                        <xs:complexType>
+                                          <xs:simpleContent>
+                                            <xs:extension base="xs:string">
+                                              <xs:attribute name="Lang" type="xs:language" default="en-us"
+                                              use="optional"/>
+                                            </xs:extension>
+                                          </xs:simpleContent>
+                                        </xs:complexType>
+                                      </xs:element>
+                                    </xs:sequence>
+                                  </xs:complexType>
+                                </xs:element>
+                              </xs:sequence>
+                            </xs:complexType>
+                          </xs:element>
+
+                          <xs:element minOccurs="0" maxOccurs="1" name="LibraryInstances">
+                            <xs:annotation>
+                              <xs:documentation xml:lang="en-us">
+                                This is the actual
+                                library instance that was used to link against the module.
+                              </xs:documentation>
+                            </xs:annotation>
+                            <xs:complexType>
+                              <xs:sequence>
+                                <xs:element minOccurs="1" maxOccurs="unbounded" name="GUID">
+                                  <xs:annotation>
+                                    <xs:documentation xml:lang="en-us">
+                                      This GUID and the
+                                      Version attribute uniquely identify the actual Library
+                                      Instance linked in this module.
+                                    </xs:documentation>
+                                  </xs:annotation>
+                                  <xs:complexType>
+                                    <xs:simpleContent>
+                                      <xs:extension base="RegistryFormatGuid">
+                                        <xs:attribute name="Version" type="xs:decimal"
+                                        use="required">
+                                          <xs:annotation>
+                                            <xs:documentation xml:lang="en-us">
+                                              This value, along with
+                                              the GUID, is used to uniquely identify this object.
+                                            </xs:documentation>
+                                          </xs:annotation>
+                                        </xs:attribute>
+                                      </xs:extension>
+                                    </xs:simpleContent>
+                                  </xs:complexType>
+                                </xs:element>
+                              </xs:sequence>
+                            </xs:complexType>
+                          </xs:element>
+
+                          <xs:element minOccurs="0" maxOccurs="unbounded" name="BuildFlags">
+                            <xs:complexType mixed="true">
+                              <xs:simpleContent>
+                                <xs:annotation>
+                                  <xs:documentation xml:lang="en-us">
+                                    Any description of OS,
+                                    Tool, and flags for the individual tool can go in this
+                                    section.
+                                  </xs:documentation>
+                                </xs:annotation>
+                                <xs:extension base="xs:string">
+                                  <xs:anyAttribute processContents="lax"/>
+                                </xs:extension>
+                              </xs:simpleContent>
+                            </xs:complexType>
+                          </xs:element>
+                        </xs:sequence>
+                      </xs:complexType>
+                    </xs:element>
+                    <!-- End of AsBuilt -->
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                </xs:complexType>
+              </xs:element>
+
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of BinaryFiles Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PackageDependencies">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Package">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
+                      <xs:complexType>
+                        <xs:simpleContent>
+                          <xs:extension base="xs:string">
+                            <xs:attribute name="Lang" type="xs:language" default="en-us"
+                                use="optional"/>
+                          </xs:extension>
+                        </xs:simpleContent>
+                      </xs:complexType>
+                    </xs:element>
+                    <xs:element minOccurs="1" maxOccurs="1" name="GUID">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us">
+                          This GUID and the Version attribute
+                          uniquely identify Package that this Module depends on.
+                        </xs:documentation>
+                      </xs:annotation>
+                      <xs:complexType>
+                        <xs:simpleContent>
+                          <xs:extension base="RegistryFormatGuid">
+                            <xs:attribute name="Version" type="xs:decimal" use="optional">
+                              <xs:annotation>
+                                <xs:documentation xml:lang="en-us">
+                                  This value, along with
+                                  the GUID, is used to uniquely identify this object. If the
+                                  version attribute is not specified, the most recent version
+                                  of the package can be used.
+                                </xs:documentation>
+                              </xs:annotation>
+                            </xs:attribute>
+                          </xs:extension>
+                        </xs:simpleContent>
+                      </xs:complexType>
+                    </xs:element>
+                  </xs:sequence>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PackageDependencies -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="Guids">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="GuidCName">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="VariableName"
+                        type="xs:normalizedString">
+                      <xs:annotation>
+                        <xs:documentation xml:lang="en-us"> Only valid for Variable GUID types. </xs:documentation>
+                        <xs:documentation>
+                          This can be either a Hex Array or C string in unicode
+                          format: L"string" Data.
+                        </xs:documentation>
+                      </xs:annotation>
+                    </xs:element>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module does not install
+                              the GUID, and the GUID must be present for the module to
+                              execute.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_CONSUMES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module does not install
+                              the GUID, however, the GUID will be used if it is present.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The module always installs
+                              the GUID.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="SOMETIMES_PRODUCES">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The Module will install the
+                              GUID under certain execution paths.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                        <xs:enumeration value="UNDEFINED">
+                          <xs:annotation>
+                            <xs:documentation xml:lang="en-us">
+                              The package creator knows
+                              that a GUID is used, but does not know how it is used.
+                            </xs:documentation>
+                          </xs:annotation>
+                        </xs:enumeration>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="GuidType" type="GuidListType" use="required"/>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Guids Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="Protocols">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A listing of protocols required or produced by this module.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Protocol" nillable="true">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="PRODUCES"/>
+                        <xs:enumeration value="SOMETIMES_PRODUCES"/>
+                        <xs:enumeration value="CONSUMES"/>
+                        <xs:enumeration value="SOMETIMES_CONSUMES"/>
+                        <xs:enumeration value="TO_START"/>
+                        <xs:enumeration value="BY_START"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="Notify" type="xs:boolean" use="optional"/>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Protocols Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PPIs">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              A listing of PPIs required or produced by this module.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Ppi" nillable="true">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="GUID" type="RegistryFormatGuid"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="Usage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="PRODUCES"/>
+                        <xs:enumeration value="SOMETIMES_PRODUCES"/>
+                        <xs:enumeration value="CONSUMES"/>
+                        <xs:enumeration value="SOMETIMES_CONSUMES"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+                  </xs:attribute>
+                  <xs:attribute name="Notify" type="xs:boolean" use="optional"/>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PPIs Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="Externs">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              These elements specify additional information about the
+              module. This area may be used by tools to generate code.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Extern">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:choice minOccurs="1">
+                      <xs:sequence>
+                        <xs:element minOccurs="0" maxOccurs="1" name="EntryPoint"
+                            type="xs:NCName"/>
+                        <xs:element minOccurs="0" maxOccurs="1" name="UnloadImage"
+                            type="xs:NCName"/>
+                      </xs:sequence>
+                      <xs:sequence>
+                        <xs:element minOccurs="0" maxOccurs="1" name="Constructor"
+                            type="xs:NCName"/>
+                        <xs:element minOccurs="0" maxOccurs="1" name="Destructor"
+                            type="xs:NCName"/>
+                      </xs:sequence>
+                    </xs:choice>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
+                  </xs:sequence>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Externs Section -->
+
+        <xs:element minOccurs="0" maxOccurs="1" name="PcdCoded">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section describes how a platform is coded with respect
+              to the platform configuration knobs.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="PcdEntry">
+                <xs:complexType>
+                  <xs:sequence>
+                    <xs:element minOccurs="1" maxOccurs="1" name="CName" type="xs:NCName"/>
+                    <xs:element minOccurs="1" maxOccurs="1" name="TokenSpaceGuidCName"
+                        type="xs:NCName"/>
+                    <xs:element minOccurs="0" maxOccurs="1" name="DefaultValue"
+                        type="xs:normalizedString"/>
+                    <xs:element ref="HelpText" minOccurs="0" maxOccurs="unbounded"/>
+                  </xs:sequence>
+                  <xs:attribute name="PcdItemType" type="PcdItemTypes" use="required"/>
+                  <xs:attribute name="PcdUsage" use="required">
+                    <xs:simpleType>
+                      <xs:restriction base="xs:NCName">
+                        <xs:enumeration value="PRODUCES"/>
+                        <xs:enumeration value="SOMETIMES_PRODUCES"/>
+                        <xs:enumeration value="CONSUMES"/>
+                        <xs:enumeration value="SOMETIMES_CONSUMES"/>
+                        <xs:enumeration value="UNDEFINED"/>
+                      </xs:restriction>
+                    </xs:simpleType>
+
+
+                  </xs:attribute>
+                  <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+                  <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+                  <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PcdCoded Section -->
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="PeiDepex">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the PEI dependency expression for a Dependency
+              Section.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="Expression" type="xs:string" minOccurs="1" maxOccurs="1">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> The Fixed PCD is a #define value that is set at build time.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    An in-fix expression, of C identifiers and TRUE,
+                    FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
+                    notation. The operators are restricted to grammar defined in the PI
+                    specification.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="PatchPcd">
+              </xs:element>
+              <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
+            </xs:sequence>
+            <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+            <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+            <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of PeiDepex Section -->
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="DxeDepex">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the DXE dependency expression for a Dependency
+              Section.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="Expression" type=" xs:string " minOccurs="1" maxOccurs="1">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> The Patch PCD is a #define that is set at build time, and that
-                        can be modified within a binary file. Additional information, such as the offset location of the
-                        value, along with it's length may need to be provided.</xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    An in-fix expression, of C identifiers and TRUE,
+                    FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
+                    notation. The operators are restricted to grammar defined in the PI
+                    specification.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="Pcd">
+              </xs:element>
+              <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
+            </xs:sequence>
+            <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+            <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+            <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of DxeDepex Section -->
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="SmmDepex">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the SMM dependency expression for a Dependency
+              Section.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="Expression" type=" xs:string " minOccurs="1" maxOccurs="1">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> This PCD type has an overloaded definition. Prior to build, the
-                        platform integrator may choose to implement a PCD as Fixed, Patchable or a Dynamic PCD. If the
-                        platform integrator choose to use the PCD as dynamic, then a PCD driver is required in the
-                        platform (PEI/DXE/both) to track the PCD in some sort of 'database' of these items. For Dynamic
-                        PCDs, the PcdGet* must pass in the token space guid and the token number to retrieve data
-                        (PcdSet* also needs these values.) </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    An in-fix expression, of C identifiers and TRUE,
+                    FALSE, AND, OR, NOT, BEFORE, and AFTER as well as parenthesis () in the in-fix
+                    notation. The operators are restricted to grammar defined in the PI
+                    specification.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="PcdEx">
+              </xs:element>
+              <xs:element ref="HelpText" minOccurs="0" maxOccurs="1"/>
+            </xs:sequence>
+            <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+            <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+            <xs:attribute name="FeatureFlag" type="xs:normalizedString" use="optional"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of SmmDepex Section -->
+
+
+        <xs:element minOccurs="0" maxOccurs="1" name="MiscellaneousFiles">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used to provide comments and/or list
+              auxiliary files, such as pdb or map files.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> The PCD can only be used as Dynamic, and the platform firmware
-                        must contain a driver to maintain a 'database' of these items. For Dynamic PCDs, the PcdGet*
-                        must pass in the token space guid and the token number to retrieve data (PcdSet* also needs
-                        these values.) </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the path and filename location within
+                    the ZIP file.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-        </xs:restriction>
-    </xs:simpleType>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:anyURI">
+                      <xs:attribute name="Executable" type="xs:boolean" default="false"
+                          use="optional">
+                        <xs:annotation>
+                          <xs:documentation xml:lang="en-us">
+                            If true, used by installation
+                            tools to ensure that a file that must be executable has the
+                            correct properties to permit execution.
+                          </xs:documentation>
+                        </xs:annotation>
+                      </xs:attribute>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Module Surface Area Misc Section -->
+
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="UserExtensions">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This section is used for any processing instructions that
+              may be custom to the content provided by the distribution that are common to module.
+            </xs:documentation>
+            <xs:documentation xml:lang="en-us"> The content is vendor specific. </xs:documentation>
+            <xs:documentation xml:lang="en-us">
+              The content can be plain text as well as any user-defined,
+              properly formatted XML structure.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType mixed="true">
+            <xs:attribute name="UserId" type="xs:NCName" use="required">
+              <xs:annotation>
+                <xs:documentation xml:lang="en-us">
+                  This is a single word identifier for grouping
+                  similar content. For example, ReferenceBuild might be used to identify non-PI
+                  compliant build steps, with two different UserExtensions sections, one with an
+                  Identifier of Prebuild, and another of PostBuild. Both UserExtensions sections would
+                  use the same UserId.
+                </xs:documentation>
+              </xs:annotation>
+            </xs:attribute>
+            <xs:attribute name="Identifier" type="xs:string" use="required">
+              <xs:annotation>
+                <xs:documentation xml:lang="en-us">
+                  This can be any string used to differentiate or
+                  identify this section from other UserExtensions sections.
+                </xs:documentation>
+                <xs:documentation xml:lang="en-us">
+                  For example, a PRE_PROCESS Identifier might indicate
+                  specific steps and tools required before processing module content, while a
+                  different UserExtensions section with a POST_PROCESS Identifier might describe steps
+                  that need to be executed after operations on this module.
+                </xs:documentation>
+              </xs:annotation>
+            </xs:attribute>
+            <xs:anyAttribute processContents="lax"/>
+          </xs:complexType>
+        </xs:element>
+        <!-- End of Module Surface Area UserExtensions Section -->
 
-    <xs:simpleType name="RegistryFormatGuid">
+      </xs:sequence>
+      <xs:attribute name="BinaryModule" type="xs:boolean" default="false" use="optional">
         <xs:annotation>
-            <xs:documentation xml:lang="en-us"> A GUID must contain five different Hexadecimal character sets that are
-                separated by a dash (-) character. </xs:documentation>
+          <xs:documentation xml:lang="en-us">
+            This attribute is used when the binaries are distributed for
+            this module and no code generation from source files is required. If set, then the BinaryFiles
+            section should be used, and any files listed in the SourceFiles section do not have to be built.
+            Additionally, the AsBuilt section for each binary file must be included.
+          </xs:documentation>
         </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:pattern value="\s*[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\s*"/>
-        </xs:restriction>
-    </xs:simpleType>
+      </xs:attribute>
+    </xs:complexType>
 
-    <xs:simpleType name="SupportedOs">
-        <xs:annotation>
-            <xs:documentation xml:lang="en-us"> The EDK II build system supports workstations running one of the
-                following supported operating systems. This is the OS for the developer's workstation, not the target
-                platform. </xs:documentation>
-        </xs:annotation>
-        <xs:restriction base="xs:string">
-            <xs:enumeration value="Win32">
+  </xs:element>
+  <!-- End of the ModuleSurfaceArea element. -->
+
+  <xs:element name="Tools">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="1" name="Header">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="1" maxOccurs="1" name="Name" type="xs:normalizedString">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> For Windows 2003, Windows XP and Windows Vista.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is the User Interface Name for this Tools
+                    Distribution.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="Win64">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> For Windows 2003, Windows XP and Windows Vista.
-                    </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the Copyright is
+                    different from the Distribution Package copyright.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="RedHat32"/>
-            <xs:enumeration value="RedHat64"/>
-            <xs:enumeration value="SuSE32"/>
-            <xs:enumeration value="SuSE64"/>
-            <xs:enumeration value="Linux32"/>
-            <xs:enumeration value="Linux64"/>
-            <xs:enumeration value="OS/X32"/>
-            <xs:enumeration value="OS/X64"/>
-            <xs:enumeration value="Generic"/>
-            <xs:enumeration value="GenericWin">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> Typically, this is used for Windows Batch files.
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the License is
+                    different from the Distribution Package license.
+                  </xs:documentation>
+                </xs:annotation>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Abstract">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the Abstract is
+                    different from the Distribution Package Abstract.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:normalizedString">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Description">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the Description is
+                    different from the Distribution Package Description.
+                  </xs:documentation>
+                </xs:annotation>
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="1" maxOccurs="unbounded" name="Filename">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the path and filename location within the ZIP file.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:anyURI">
+                <xs:attribute name="OS" type="SupportedOs" use="optional">
+                  <xs:annotation>
+                    <xs:documentation xml:lang="en-us">
+                      This is required for tools that execute; it
+                      should not be used for configuration files.
                     </xs:documentation>
+                  </xs:annotation>
+                </xs:attribute>
+                <xs:attribute name="Executable" type="xs:boolean" default="false" use="optional">
+                  <xs:annotation>
+                    <xs:documentation xml:lang="en-us">
+                      If true, used by installation tools to
+                      ensure that a file that must be executable has the correct properties to
+                      permit execution.
+                    </xs:documentation>
+                  </xs:annotation>
+                </xs:attribute>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <!-- End of the Tools element. -->
+
+  <xs:element name="MiscellaneousFiles">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        This section contains a list of files that are not part of the code
+        distributed with modules, packages or tools.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="1" name="Header">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element minOccurs="0" maxOccurs="1" name="Name" type="xs:normalizedString">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    The User interface name for this content.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:enumeration value="GenericNix">
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Copyright" type="xs:string">
                 <xs:annotation>
-                    <xs:documentation xml:lang="en-us"> Typically use for shell scripts - valid for any Linux and Mac
-                        OS/X. </xs:documentation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the Copyright is
+                    different from the Distribution Package Copyright.
+                  </xs:documentation>
                 </xs:annotation>
-            </xs:enumeration>
-            <xs:pattern value="[a-zA-Z]([a-zA-Z0-9])*"/>
-        </xs:restriction>
-    </xs:simpleType>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="License" type="xs:string">
+                <xs:annotation>
+                  <xs:documentation xml:lang="en-us">
+                    This is only required if the License is
+                    different from the Distribution Package License.
+                  </xs:documentation>
+                </xs:annotation>
+              </xs:element>
+              <xs:element minOccurs="0" maxOccurs="1" name="Abstract" type="xs:normalizedString"/>
+              <xs:element minOccurs="0" maxOccurs="unbounded" name="Description">
+                <xs:complexType>
+                  <xs:simpleContent>
+                    <xs:extension base="xs:string">
+                      <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"
+                                            />
+                    </xs:extension>
+                  </xs:simpleContent>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="Filename">
+          <xs:annotation>
+            <xs:documentation xml:lang="en-us">
+              This is the path and filename location within the ZIP file.
+            </xs:documentation>
+          </xs:annotation>
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:anyURI">
+                <xs:attribute name="Executable" type="xs:boolean" default="false" use="optional">
+                  <xs:annotation>
+                    <xs:documentation xml:lang="en-us">
+                      If true, used by installation tools to
+                      ensure that a file that must be executable has the correct properties to
+                      permit execution.
+                    </xs:documentation>
+                  </xs:annotation>
+                </xs:attribute>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <!-- End of the Misc element. -->
+
+  <xs:element name="UserExtensions">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
+      </xs:sequence>
+      <xs:attribute name="UserId" type="xs:NCName" use="required">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This is a single word identifier for grouping similar content.
+            For example, ReferenceBuild might be used to identify non-PI compliant build steps, with two
+            different UserExtensions sections, one with an Identifier of Prebuild, and another of PostBuild.
+            Both UserExtensions sections would use the same UserId.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:attribute name="Identifier" type="xs:string" use="optional">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This can be any string used to differentiate or identify this
+            section from other UserExtensions sections.
+          </xs:documentation>
+          <xs:documentation xml:lang="en-us">
+            For example, a PRE_PROCESS Identifier might indicate specific
+            steps and tools required before processing distribution package content, while a different
+            UserExtensions section with a POST_PROCESS Identifier might describe steps that need to be
+            executed after operations on this content.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
+      <xs:anyAttribute processContents="lax"/>
+    </xs:complexType>
+  </xs:element>
+  <!-- The following elsements are common definitions used with the ref attribute for elements. -->
+
+  <xs:element name="HelpText">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:string">
+          <xs:attribute name="Lang" type="xs:language" default="en-us" use="optional"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+
+  <!-- The following attribute groups are used in various elements above. -->
+
+  <xs:attributeGroup name="SupportedArchMod">
+    <xs:attribute name="SupArchList" type="ArchListType" use="optional"/>
+    <xs:attribute name="SupModList" type="ModuleListType" use="optional"/>
+  </xs:attributeGroup>
+
+  <!-- The following data types are used to restrict content. -->
+
+  <xs:simpleType name="ArchListType">
+    <xs:list itemType="ArchTypes"/>
+  </xs:simpleType>
+
+  <xs:simpleType name="ArchTypes">
+    <xs:restriction base="xs:NCName">
+      <xs:enumeration value="IA32"/>
+      <xs:enumeration value="X64"/>
+      <xs:enumeration value="IPF"/>
+      <xs:enumeration value="EBC"/>
+      <xs:enumeration value="ARM"/>
+      <xs:pattern value="([A-Z])([a-zA-Z0-9])*">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            Any processor architecture not listed above. The Architecture
+            must be a target architecture of one or more compiler tool chains.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+
+
+  <xs:simpleType name="FamilyTypes">
+    <xs:restriction base="xs:NCName">
+      <xs:enumeration value="MSFT"/>
+      <xs:enumeration value="GCC"/>
+      <xs:pattern value="[A-Z][a-zA-Z0-9]*">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            Any other family of build utilities for which compiler tools
+            exist.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="GuidListType">
+    <xs:list itemType="GuidTypes"/>
+  </xs:simpleType>
+
+  <xs:simpleType name="GuidTypes">
+    <xs:restriction base="xs:NCName">
+      <xs:enumeration value="Event"/>
+      <xs:enumeration value="File"/>
+      <xs:enumeration value="FV"/>
+      <xs:enumeration value="GUID"/>
+      <xs:enumeration value="HII"/>
+      <xs:enumeration value="Hii"/>
+      <xs:enumeration value="HOB"/>
+      <xs:enumeration value="SystemTable"/>
+      <xs:enumeration value="TokenSpaceGuid"/>
+      <xs:enumeration value="Variable"/>
+      <xs:enumeration value="UNDEFINED"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="HexNumber">
+    <xs:restriction base="xs:hexBinary">
+      <xs:pattern value="0x([a-fA-F0-9])+"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="Md5Sum">
+    <xs:restriction base="xs:normalizedString">
+      <xs:pattern value="[a-zA-Z0-9]{32}"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="ModuleListType">
+    <xs:list itemType="ModuleTypes"/>
+  </xs:simpleType>
+
+  <xs:simpleType name="ModuleTypes">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us"> The following module types are defined by specifications. </xs:documentation>
+      <xs:documentation xml:lang="en-us">
+        Module types for components and libraries defined for this distribution
+        mechanism.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:NCName">
+      <xs:enumeration value="BASE ">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us"> Use of this module is not restricted. </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="DXE_CORE">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to the DXE core.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="DXE_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to a DXE driver.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="DXE_RUNTIME_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to a DXE runtime driver.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="DXE_SAL_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to an IPF DXE runtime driver.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="DXE_SMM_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to a DXE SMM driver.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="PEI_CORE">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to the PEI core.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="PEIM">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us"> This module is only valid for PEI modules. </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="SEC">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to Security phase.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="UEFI_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us"> This module is only valid for UEFI drivers. </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="UEFI_RUNTIME_DRIVER">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only valid for UEFI runtime
+            drivers.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="UEFI_APPLICATION">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only valid for UEFI applications.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="SMM_CORE">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This module is only applicable to the SMM
+            core.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="USER_DEFINED">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This content is restricted to a specific implementation.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="UNDEFINED">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This enumeration is for use in a list that where the package
+            creator does not know the what module types are supported by a module.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:pattern value="([A-Z])([a-zA-Z0-9])*">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This pattern has been added for use in a module lists - for
+            future expansion.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:pattern>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="PcdDatumTypes">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        The following data types are defined by the PCD specification (or PCD
+        section of the UEFI/PI specifications.)
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:normalizedString">
+      <xs:enumeration value="UINT8"/>
+      <xs:enumeration value="UINT16"/>
+      <xs:enumeration value="UINT32"/>
+      <xs:enumeration value="UINT64"/>
+      <xs:enumeration value="BOOLEAN"/>
+      <xs:enumeration value="VOID*"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="PcdItemListType">
+    <xs:list itemType="PcdItemTypes"/>
+  </xs:simpleType>
+
+  <xs:simpleType name="PcdItemTypes">
+    <xs:restriction base="xs:NCName">
+      <xs:enumeration value="FeaturePcd">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            The Feature PCD is a binary, evaluating to either true or false.
+            This is used during build to include/exclude content. It can also be used during execution to
+            force execution paths within drivers, or to enable/disable features within a driver for a given
+            platform.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="FixedPcd">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            The Fixed PCD is a #define value that is set at build time.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="PatchPcd">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            The Patch PCD is a #define that is set at build time, and that
+            can be modified within a binary file. Additional information, such as the offset location of the
+            value, along with it's length may need to be provided.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="Pcd">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            This PCD type has an overloaded definition. Prior to build, the
+            platform integrator may choose to implement a PCD as Fixed, Patchable or a Dynamic PCD. If the
+            platform integrator choose to use the PCD as dynamic, then a PCD driver is required in the
+            platform (PEI/DXE/both) to track the PCD in some sort of 'database' of these items. For Dynamic
+            PCDs, the PcdGet* must pass in the token space guid and the token number to retrieve data
+            (PcdSet* also needs these values.)
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="PcdEx">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            The PCD can only be used as Dynamic, and the platform firmware
+            must contain a driver to maintain a 'database' of these items. For Dynamic PCDs, the PcdGet*
+            must pass in the token space guid and the token number to retrieve data (PcdSet* also needs
+            these values.)
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="RegistryFormatGuid">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        A GUID must contain five different Hexadecimal character sets that are
+        separated by a dash (-) character.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="\s*[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\s*"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="SupportedOs">
+    <xs:annotation>
+      <xs:documentation xml:lang="en-us">
+        The EDK II build system supports workstations running one of the
+        following supported operating systems. This is the OS for the developer's workstation, not the target
+        platform.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="Win32">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            For Windows 2003, Windows XP and Windows Vista.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="Win64">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            For Windows 2003, Windows XP and Windows Vista.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="RedHat32"/>
+      <xs:enumeration value="RedHat64"/>
+      <xs:enumeration value="SuSE32"/>
+      <xs:enumeration value="SuSE64"/>
+      <xs:enumeration value="Linux32"/>
+      <xs:enumeration value="Linux64"/>
+      <xs:enumeration value="OS/X32"/>
+      <xs:enumeration value="OS/X64"/>
+      <xs:enumeration value="Generic"/>
+      <xs:enumeration value="GenericWin">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            Typically, this is used for Windows Batch files.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:enumeration value="GenericNix">
+        <xs:annotation>
+          <xs:documentation xml:lang="en-us">
+            Typically use for shell scripts - valid for any Linux and Mac
+            OS/X.
+          </xs:documentation>
+        </xs:annotation>
+      </xs:enumeration>
+      <xs:pattern value="[a-zA-Z]([a-zA-Z0-9])*"/>
+    </xs:restriction>
+  </xs:simpleType>
 
 </xs:schema>

From aa5bcdb0448db35b8169efeff38ffcd54202d4c4 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Wed, 17 Feb 2016 14:58:02 +0800
Subject: [PATCH 461/525] BaseTools/Trim: Fix the bug for stripping when no
 line directive in file

when no line directive in file, the tool still need to strip the typedef
statement (eg: typedef struct, typedef union ..).

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit 7cf1e91d611c5dbe8bdaefd5a48b61e63ea58263)
---
 BaseTools/Source/Python/Trim/Trim.py | 37 +++++++++++++++++++++++++---
 1 file changed, 34 insertions(+), 3 deletions(-)

diff --git a/BaseTools/Source/Python/Trim/Trim.py b/BaseTools/Source/Python/Trim/Trim.py
index 8fefa1bcd9d2..e5fe730f2ca0 100644
--- a/BaseTools/Source/Python/Trim/Trim.py
+++ b/BaseTools/Source/Python/Trim/Trim.py
@@ -1,7 +1,7 @@
 ## @file
 # Trim files preprocessed by compiler
 #
-# Copyright (c) 2007 - 2014, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials
 # are licensed and made available under the terms and conditions of the BSD License
 # which accompanies this distribution.  The full text of the license may be found at
@@ -29,7 +29,7 @@
 # Version and Copyright
 __version_number__ = ("0.10" + " " + gBUILD_VERSION)
 __version__ = "%prog Version " + __version_number__
-__copyright__ = "Copyright (c) 2007-2010, Intel Corporation. All rights reserved."
+__copyright__ = "Copyright (c) 2007-2016, Intel Corporation. All rights reserved."
 
 ## Regular expression for matching Line Control directive like "#line xxx"
 gLineControlDirective = re.compile('^\s*#(?:line)?\s+([0-9]+)\s+"*([^"]*)"')
@@ -37,6 +37,10 @@
 gTypedefPattern = re.compile("^\s*typedef\s+struct(\s+\w+)?\s*[{]*$", re.MULTILINE)
 ## Regular expression for matching "#pragma pack"
 gPragmaPattern = re.compile("^\s*#pragma\s+pack", re.MULTILINE)
+## Regular expression for matching "typedef"
+gTypedef_SinglePattern = re.compile("^\s*typedef", re.MULTILINE)
+## Regular expression for matching "typedef struct, typedef union, struct, union"
+gTypedef_MulPattern = re.compile("^\s*(typedef)?\s+(struct|union)(\s+\w+)?\s*[{]*$", re.MULTILINE)
 
 #
 # The following number pattern match will only match if following criteria is met:
@@ -206,7 +210,34 @@ def TrimPreprocessedFile(Source, Target, ConvertHex, TrimLong):
 
     # in case there's no line directive or linemarker found
     if (not LineControlDirectiveFound) and NewLines == []:
-        NewLines = Lines
+        MulPatternFlag = False
+        SinglePatternFlag = False
+        Brace = 0
+        for Index in range(len(Lines)):
+            Line = Lines[Index]
+            if MulPatternFlag == False and gTypedef_MulPattern.search(Line) == None:
+                if SinglePatternFlag == False and gTypedef_SinglePattern.search(Line) == None:
+                    # remove "#pragram pack" directive
+                    if gPragmaPattern.search(Line) == None:
+                        NewLines.append(Line)
+                    continue
+                elif SinglePatternFlag == False:
+                    SinglePatternFlag = True
+                if Line.find(";") >= 0:
+                    SinglePatternFlag = False
+            elif MulPatternFlag == False:
+                # found "typedef struct, typedef union, union, struct", keep its position and set a flag
+                MulPatternFlag = True
+
+            # match { and } to find the end of typedef definition
+            if Line.find("{") >= 0:
+                Brace += 1
+            elif Line.find("}") >= 0:
+                Brace -= 1
+
+            # "typedef struct, typedef union, union, struct" must end with a ";"
+            if Brace == 0 and Line.find(";") >= 0:
+                MulPatternFlag = False
 
     # save to file
     try:

From ba1b6e1492a31ed8454938bc9e4bfd7fb89dcd14 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Thu, 21 Jan 2016 02:14:43 +0000
Subject: [PATCH 462/525] IntelFspPkg: Add NOOPT target in IntelFspPkg.dsc

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19702 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit a505a870771debf602c09bf138f113dd98345682)
---
 IntelFspPkg/IntelFspPkg.dsc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/IntelFspPkg/IntelFspPkg.dsc b/IntelFspPkg/IntelFspPkg.dsc
index c8c604eac9ba..f3b5689ea16c 100644
--- a/IntelFspPkg/IntelFspPkg.dsc
+++ b/IntelFspPkg/IntelFspPkg.dsc
@@ -1,7 +1,7 @@
 ## @file
 # Provides driver and definitions to build fsp in EDKII bios.
 #
-# Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under
 # the terms and conditions of the BSD License that accompanies this distribution.
 # The full text of the license may be found at
@@ -19,7 +19,7 @@
   DSC_SPECIFICATION              = 0x00010005
   OUTPUT_DIRECTORY               = Build/IntelFspPkg
   SUPPORTED_ARCHITECTURES        = IA32
-  BUILD_TARGETS                  = DEBUG|RELEASE
+  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
   SKUID_IDENTIFIER               = DEFAULT
 
 [LibraryClasses]

From b2e9df3da840986f4b4a122190334785f8334ac9 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Thu, 21 Jan 2016 02:15:02 +0000
Subject: [PATCH 463/525] IntelFspWrapperPkg: Add NOOPT target in
 IntelFspWrapperPkg.dsc

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19703 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 61f816bd75accffe8f9f4d0d28e45a05922c1997)
---
 IntelFspWrapperPkg/IntelFspWrapperPkg.dsc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/IntelFspWrapperPkg/IntelFspWrapperPkg.dsc b/IntelFspWrapperPkg/IntelFspWrapperPkg.dsc
index 04677c32315d..3714e30985a0 100644
--- a/IntelFspWrapperPkg/IntelFspWrapperPkg.dsc
+++ b/IntelFspWrapperPkg/IntelFspWrapperPkg.dsc
@@ -1,7 +1,7 @@
 ## @file
 # Provides drivers and definitions to support fsp in EDKII bios.
 #
-# Copyright (c) 2014 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2014 - 2016, Intel Corporation. All rights reserved.<BR>
 # This program and the accompanying materials are licensed and made available under
 # the terms and conditions of the BSD License that accompanies this distribution.
 # The full text of the license may be found at
@@ -19,7 +19,7 @@
   DSC_SPECIFICATION              = 0x00010005
   OUTPUT_DIRECTORY               = Build/IntelFspWrapperPkg
   SUPPORTED_ARCHITECTURES        = IA32|X64
-  BUILD_TARGETS                  = DEBUG|RELEASE
+  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
   SKUID_IDENTIFIER               = DEFAULT
 
 [LibraryClasses]

From 39cad952199ab911cd0794883278eaf3bcf841be Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Tue, 15 Dec 2015 04:51:26 +0000
Subject: [PATCH 464/525] CryptoPkg: Convert all .uni files to utf-8

To convert these files I ran:

$ python3 BaseTools/Scripts/ConvertUni.py CryptoPkg

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19250 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 3af422600fe7bc92ed385907586af8b61db53a74)
---
 CryptoPkg/Application/Cryptest/Cryptest.uni   | Bin 1924 -> 961 bytes
 .../Application/Cryptest/CryptestExtra.uni    | Bin 1330 -> 664 bytes
 CryptoPkg/CryptRuntimeDxe/CryptRuntimeDxe.uni | Bin 1968 -> 983 bytes
 .../CryptRuntimeDxe/CryptRuntimeDxeExtra.uni  | Bin 1358 -> 678 bytes
 CryptoPkg/CryptoPkg.uni                       | Bin 2014 -> 1006 bytes
 CryptoPkg/CryptoPkgExtra.uni                  | Bin 1344 -> 671 bytes
 .../Library/BaseCryptLib/BaseCryptLib.uni     | Bin 2500 -> 1249 bytes
 .../Library/BaseCryptLib/PeiCryptLib.uni      | Bin 3990 -> 1994 bytes
 .../Library/BaseCryptLib/RuntimeCryptLib.uni  | Bin 3634 -> 1816 bytes
 .../Library/BaseCryptLib/SmmCryptLib.uni      | Bin 3602 -> 1800 bytes
 .../BaseCryptLibRuntimeCryptProtocol.uni      | Bin 3586 -> 1792 bytes
 .../Library/IntrinsicLib/BaseIntrinsicLib.uni | Bin 1780 -> 889 bytes
 CryptoPkg/Library/OpensslLib/OpensslLib.uni   | Bin 1742 -> 870 bytes
 13 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/CryptoPkg/Application/Cryptest/Cryptest.uni b/CryptoPkg/Application/Cryptest/Cryptest.uni
index 0ae792eee09ea16a05ce87004f163838443e8e1a..34f55498b314904f31a1e9792b3b2c38809058ab 100644
GIT binary patch
literal 961
zcmcIjPj8zr6u(c}cX&!KZInPa?XXVMG!op^Y6204bvsoC9I!;NWjpQIr{BX#mP*qu
zlLivV=J)SCKf(~g=@dS1WhY+03PWJ6=sMt9ce3J6svca+9Xw0ib;3Ga3aHGWoq|r5
zhMOT6iJn}LTME$&?p7I3_{uw3ALP{bNN)_+?Qjx-%aU7B0~)4U^o*_GI=Bhm|17W0
z`b(t;Bb(O2WpxE_udi=lj;}ZGW<Yx<I#?>BmGMRaL>SqlEf`^ic@lN-aglxc9XD^K
z1#J{2*#YlsAC*^?+G*YovTtC=oiLJj)|bbPz_^v@$DkvA$7=!niOY_coq&B`i$lH0
z+F1{&RA0-nj~1}<v3Uy?!|I^oRi9f~wQ#bP!XgTD)zUg6%l*g=0CHq*_x=!mxRcZ|
z4CWZ1#P13d0C!%tbxwZ>Lxs(>YHunLDAR;Th7C(w&yR~hx7t(uBflfC$<i-bv<Au`
zrYz6sqR2@MMG}(?Mu4w@E=j@&qzOa`Od^Kx2`nN;*~}|F(EKhfa(IZcEJ|`p7^E3w
zWRnp_l03?3n&8$g(!aw!P2w34q@V@)Hex)St~V=6;`0nlr#NfleKGb2&j|B9uG6?!
xk;iC(i)fj{%j=@!eY59{0MXA229tjn@yTBdW5Sjh-Her-E&nk5Prro^^$VVHDzX3o

literal 1924
zcmdUwTW`}q5QXO%iT|)lUs}{A1@Qm~Ark6>MX94)C_GipwULr0attN>c;Gv`aom(t
z@Pvdc?`3xO%$YOe<mZo?)y(le;&JxcMmDjj4eg;lz^b#hU9q3?I7@B8GsUORI%l5S
zHTE1I?Va8D`|{1Xwe&Wf4zcttvlaJqZaI(A!;*SybrZ3S+_lI~EylNgPuvkmnU57B
zd<0GG23zdrWVIcA?Bg!rwfc>TvwiDve+lOSry;`x219af^PFKlwyHhneP-YBK44Yw
zE@o$MxVs=i2BR^tq|ZJo956ot;TQyGN9)~VduoTQW1>hqX()sY42`AURZi-h%cI0z
z`kgc%V*TpbSM8-WtYxouu<O8Rg0}-dBSO$*#y*9CGB4_u!nu#f3{Rb{xOa`e!y;CS
zH(@met;}9^Rn<ecNV`JO0$;ZW-Y11`3dWSN$EbT>JPTo$OhT-gXI-F(nfOj%68cd&
zg_;)`G^pAM)-yc%pa(7`*Bh@zpHbOwXFI`Ph{6hbDV920S@+;s#8q9KNmub7aT01I
z*5B~D%W7Mhpr-n<x4u7LYamYfEoIe7IkkA<zfkp9$VmQ~&#y}U85OGCQGbc02loM8
zw;jC-$`x;^NxACSJHA9`O*$#Dw~TfBz&=J*hpw7CSYvvv%PR6(ckP@x!Y)k$LRp8H
z-j48Sd*p<bdRk+JS-3*2FgN^OyTe=TE;tuz;v+h{z^mn%onwzd6-MHtx7dlhY>L^z
zS3ZgwyiV~|^v}%iIT3Sxi_tnt$Re^&8=Mk7MvEq$rI;r>e+Ts2TJzkcsouR!|Ag--
z=ywTH0!A0K$Sz?dy`*d%wL0**@7bf8`X0t~K+358Q%@X$C8ia|fAK3`*<|^58LB_p
W<fh(fZfdeC%RguMfBjpOO8o*ZN-VDc

diff --git a/CryptoPkg/Application/Cryptest/CryptestExtra.uni b/CryptoPkg/Application/Cryptest/CryptestExtra.uni
index 68873052b4a193c050ae81473afa2e44bea9f600..530faa593c8bc18af8552cdbd805f57fcc1c60d6 100644
GIT binary patch
literal 664
zcmYL{PmkLm5XJA2@*PI$rHvB1fA&;WRh^i2Q4>1?Tic!@ViOw)g9UiE>8J15$)+a+
zy!Yle191%TatYtgO3V2yj$!LAeULuD&Q?OJzp@4%oHC6EVQSb~6Ql{F^eVUg#i^zZ
z@V0sfAK!oY1nY5mSOG<)MuY3E6G2%ML83KGY7b6&>7HdBec7<D_qd`}9(rdRC%UO#
zXeEfMvRyCC1u38tK{_S0pUMj-L90p{kDMc4Cu%f23#G+LOBhTo9gHF9>aHzR*3@d`
z@nFx>-G-;IyQWO3FRiNDds!tts*tNz9w%`cuDw8kspkPZ3i3~Qjk>`g#|2J!Z;=4R
zG%sjF=s(A??Ge`wu9A^;O?-3s_~h&LZ4>ov|9>Wr1P(0!!IC{t4k_gYqnolIDU?}C
z7!)X&TA*8!aRPY;Nd}9AqkI9Igj2qn`g)?pV_p{UlrWZL1tlDE28<jS;Up`Pg60_>
zeMkFm_(`*L1q3Zvg8Ujalbr4kJ4({%&bM6RSD4S<jKjePLb@a39tax?9QS!z?#MAq
f_5@I*g=q%SNRVb-ay(hwKU`<)LCeLMHJ|+h>+8y{

literal 1330
zcmZvcS#Q%&5QXO%iT`kwz5r?ywkL!TNo&BOO`<dr@KiZVQ%gx4xnT)EzU4dPjZ~H8
zyUffzbLQN!@9#R+vB3L+C)h{3w$xU(u&4F}t9+-H+upXe!+OgY?A$V&SwdWDf3eQ7
zUE;~vZ){0az`Jq#DX|+rtFc0@W}#<b@BQr3ZXEv^=+D7;Z7=PWy<v4y@7~%m>$t>R
zu@*uOhQ@^Rsb_5C>B3ME;#FXaS?+Z#n14C<w!OEWjqJlC?8Y!ky`C-c87RuJ2BoTR
zN5sPSGgxQ%w(i@PS_CX&rF<!?6=+TM309q!k~3BtyoH_>zE00QCV_84+=_9^sB=GE
zWnl+$6ikX->w{YmGu=m8>mwyHZo4_x;||Z*pC52(xc+u6W{j%-u-X(hLKKHWFXd9V
zsOl*^|G$@D(pCJg@f3F?)_;h4$m&p;Ld`u<)AD>)Y9LNce+BS&JX?F`U927})Kz@$
zTDPe`=SDjZ)W5|th5MYYJIvk&<%YM?q?%RF7mHvuq>l#nnXzjZ>|-<ysH%C4HKx-h
ztRh!>VtwWadxOy2LQH2zL|i)ZfR#F0V~bh1LTxeke6QVc%`MnB{Ngq6jM{g}BxZf=
zF{r{Ac=i!HahFXw$3!VcS&OJo#OmY^=C63fTwh{TW+|$O?0b#VpvP!2q_33o%-S`_
zMnC<1I&PQksO}v7P4sV(c2}jkLr_L_1y^7XK%Iae5z~j|1*_m_N8F&kq$RhWFskR&
Z2PedfpR%<c`NOU0jk)*c0>7fF_a7_x%&PzZ

diff --git a/CryptoPkg/CryptRuntimeDxe/CryptRuntimeDxe.uni b/CryptoPkg/CryptRuntimeDxe/CryptRuntimeDxe.uni
index 9e49aebd789a3a87e73edd4c3bb597311c41ff27..337cdf47b80ccb81260f3325d491a45b53304df7 100644
GIT binary patch
literal 983
zcmcIj!H&}~5WOSu52Nk{s<v5HzyTqIn;2@*CY7CP;k0rSH?ic{k?nTr-(!0V3qqWL
zL`vfL&71dT##sj0bPDeeQi-QevJC28I%ust2@6s?&y{jukJ`&YKyJ^YhtV2u8l%9Q
z_<fSC0JcImuU-S!El`HQ344-_SVYSINt>JTY-QJbc-B0Jo9h?XFpsa7Ga%Xv1-Y@K
zvD{0e7l4$4gbt2GlqlN8+a-PXtIA-hvwTQid@q1EjTuI+&r)|Va4)Rn$|YCa3Q)nP
zcA`!Afrnb~6PJqbm4KseLm4AUh#FjiG)A{F>TzHWX>Z92SU<2N*85&I{g1R#xPXdH
zk<MGWKR$Q~jS_G;21j0e_1~#3VuH*w?8CkZ3V{1W+j~F0$uctrx#nm?cZ}__ON7hz
zuAN^Ni?JV5NP5&O3|m@#q-X<#K|xqe$#PfY0(NDADMUc>Kyq9%3{?rJgb88+K7l1-
zgv}DuEvZ-4u7+DgDJpA%8B`P~-crnPS)-a%W%%_Wgnxlgq%3BDLr6%0KSxZ0lg)Nb
zaPc@=(`gv7cwfc(gdPQbcblr%t??aNh6T!N`1!h0Tz5y_2@ra|V=y6qJLi)>q%Sbb
SDcMF}j{<&6|8I|6(((<6h%$lz

literal 1968
zcmdUwTW`}q5QXO%iT|)lUjVfURKNp5h@>@O73wG#6`m^RT1&Z9j$6o|FMMaWu@fkl
zH$aj1GBZAN_ROsF^`>DBb3BjuIeTpr%WP(2yKncf%Ga|CY%5kH%UNCH&DmwPz*<;J
z{LK4vyTVrBnG@seh`6;~VsVVQEm<vX$TP#D^~Qe9J0t&2*WOvv4(*ve$D4vTV(wTM
zt0RkYD|*PPUb6gO*&d<6B^pWBDLPB32b}F8^PxSqCp^v$%H31jXB~T$$6iGt<X~t_
zc|T*dKpBT#s*BsgRt<A>+o(83+q%897W%&WrIw+3Q=elF%BC&_oK@)*&Z_GiCi1P}
zvEW1wi&&{@87uWkRjbsqaacn=)lcG7;p^?t7b#UwiJLJF7?oAsCa=12!zARIgH)l2
znIf}NA9<Jbdi7q54m)Q5euqoN^|QYPL&hIZo54Yd;;^|XnhSsG0X(<s5^j|EPw<2q
ziS-wvzGt<oOi*)8)WDyA!Wn`F;#6!Yt4=DY#S4Fj)nj86So!$;_U@=-rucVrtgsA-
z9MN^Vo;oNOJe4NZs>iL3;MJy+5_`+ov=8iKRCVa8xra5T*ZQm?uXW!}nIr7dBp_6E
zi1~g*M07oJ!b&}@vBoT1q1KpNey`pB7P~Y2LQQ-|XJ<rpJhM~mF{r{weD)4IahFXw
zd&DY6SwqwtVwL?9^9dd?*IkTmvxHMb_OZmN&||b{(^<-SeCJn7U*Cr3E=~39mHiX$
zQPA%kqy&sUXpx=6NP0=xCTjKI^RwR`)zr<L(lIHc`cFM^0G626VE4Db=e1ISKRdm8
Yr^~t3SM9Q1cPa4u)Bnr=a+NOM09o`je*gdg

diff --git a/CryptoPkg/CryptRuntimeDxe/CryptRuntimeDxeExtra.uni b/CryptoPkg/CryptRuntimeDxe/CryptRuntimeDxeExtra.uni
index 584d9ff08d9990e222baf015888e994296665d8f..7fe3a617539ca80ab744e436ee9f3ca27e4cfc8b 100644
GIT binary patch
literal 678
zcmZ9KPmkLm5XJA2@*PI$rHvB1|4vm^)rn~rHL)YGwe2Y)HnEW~Sb%po{q!9>X)5)E
zfcM_~W+09sUM}J5S!p?+#W8H%r4MW{L3J{Hk+8Fs(CW9Wfd{8d<3X4jw$=n`!sxiV
zY=3d8X#>2j-oX2}?>@kKTt2RVqEe&5_11}?tcf7e8YZ;|C%tq}vW`A)*q3`;(JBwU
zvyBtoR4=p=L{-_Y7v_Q#(1{?O653DYg_EFFC5=bUk*^aq8lHsG;-n=Erj`!I5Oj6d
z7Ak9MHS&0{=jm?4Q`lWorqt(FRqeg3k{(saRV$B^I1Sfcpup7gfE@+-68=WrV36Yi
zC%m^v0AiXKv?27L;@I|xYX?`!$hs!JIedKb_4>An`nLZ!lLrC^mVal-9w>*D@`BM#
zS&$UUEF}yI6ihA9Ey*~6JcA^IMZ!_OfK9?FUrl{I(&8a63wTTzOR|Cz4mkrx4vcV;
z6-hz!43EB{{TKY8S-Jv(7A!%2j+#kM_lF%NX>{jXF7YeOXRpTL-~%Du5pfTMjRlVT
lJS}(Rm?e7xDAK|-gJ>j3vo1NFEdKv@ovjBg7h~jn_6Mx=&>#Q+

literal 1358
zcmai!TW`}q5QXO%iT|)lUjVfUw<m-UNn^mGjiWRX@KiaMrk0X8azbhN@xXW1UYnE$
zWO;XXcJ|EKGh_e$)v=B_-e)|{-rJ33wz7piwnuoicW#9pY-@WP*>~G8XSODyZ}*JO
zE-bg1rJTy_C!RUJE20Y48(Z3rb&4hbIk7@m_%Y-NbGg4Io6aunmPlt$K!3{o(w^H3
zdxdpYuU^|Jc3feuu$7^Jt;W=IRmL_uT^K5&!4|UuE<4`B?mYLly|o@UeOD{cup7fD
z^Y_^jpTkf&)}Vy@?TL^kDV%3StYM<PL#2hoBUZ|nVXZ)G@Kd}xEhT4I8_!I-1$>>J
zR~hcGRjbsdj5??4Xt%%)Ov+qq&pM!pnIf}VA1RSj`{rDa8unRV9C2y5{_tAN82`O(
z1_vREL#dZ??O5y9Q+TR}LS39mSMk4Lr>v1!-xKwa)v+?Ang^n$)%m>AK%Dk}DXUJ}
zQ;Rpgr*o`QUBwq(>o$A}D%yFV{tnL+?sK~CIC~qETi&2an022|7Qt#rA0_sYv1^yC
zV>ETBs(Fkzrqd=^kym<R1Lg>SgV0nVrn4g=t~_#rrH<CvVivAYTg*Mb*6Ot8=Ijgm
z;+6P}T6f7LW&`{&sKQ8m_7N*_mrpszL@7pD%cu{;>f|@(&+Le~zQm}?Qr;r6uQg7C
z9;3yOzEaLUUuMuP%+CLdI^HkeN!>a6o9N#n?XD|zhoFq=8(f2(fI0y`B4z-~ODyNn
lPN<;1fhAQ>8P#*@gEQjAPuW`k{ok$Wl)3NJ1<^Va-aqB1(j5Q*

diff --git a/CryptoPkg/CryptoPkg.uni b/CryptoPkg/CryptoPkg.uni
index 0f3dd225ca2e09fca7fdc1872a1a8380c079b6be..effb918cf47147899927b91227a4e923c39670f0 100644
GIT binary patch
literal 1006
zcmb_b(QcbC6n&qxf4E9twkUya+RLVCngecYwIv9Mx;<46IA9I1Wt(*Q`(3+P+G^U<
z1`^2ToO92)zQi%a^ErIo$zHsE6~~bC`Uh_X?397p9JEud;krA(pqi-{Hu9)|tU75=
zaBb9HHo`vV$a-l+&z)$Xms`V)#P42rLoXOuQBOv?m%_jt@ZKso>2Ywv;-=QUthtkF
z1g9SNPNGkq5~UADww;4F^;>v<e*O`b_<HwY0c>=lheR2zOwfsd^gRT$1tY95d(lLn
zSH+i?5zz{^U;sWg;5q@kuGOIVc#vZY1I9BFEr*tHBQR<$MvIv}e&7uf_FVRS+Y6Y+
zMwlRitic9It;R<BTo%+Wd|Q<%+&roT)rU^j-Knf^qVuh9q;*DaC(n%lDzvtnFp(2K
z-EXO*8T4_0tv^(B0Ne%H&N=-lj+I8cYBIHmlxgE5!^T_NERTywcREnQqq?Gy7wgM{
z+yW~hWo1>c)uy5;Y_gOV-~k~6OK4V7SZ6>on2{3UGgy(5m5ZQs$EvIKrh+?C6eOz{
zEn!_iLGyx^G^<F()){VHApJXBvn*WzMGBUn-#jM3*=>HqX!<k*^Eu9^zt4Ps@Ql#k
zeNK{Va!K#W3Rfhl;MsN7^Rb=$(2H@oDPflX^Dxi;RzIa>Qn1`7J308H{{Q~7f*bGX
E7lCp<2><{9

literal 2014
zcmd6oU2hUW7=_<!6aT}8-l!>{#v6?>g5B0lwGcj1y=s;PDY1NHmsb1d)#uExI~GXw
z${4cq`ObOIoH;Z6{L!?gMSM^AMfTRd*vzhMVh`;BqnhhlYMFhdoH8B}v9z2zqrA11
zt?5r`r?f8_iEPfu*sdK;VT}qaU=E0!S+NIw1=7-Pm>rW%5&QGZ7_SpMAxjE}3Gor_
znT;HmoR(i-@*P@i$CeOPFq6SgG3$F7N5rpLk%C;nD`Jn^{8C1hzt}{sh!Ky>@tUz}
z;Ucs;#O*TOr_(!DuV5&qQ#2EoM<73@er`|sy`)v&^q$!ZJEWbEQJJo23n2$XrF8Oq
z8qBnqS46;;+EP^d<eY&tZP;sTThHFydx~Ba?}9lfDGYQTYdFg@a!>|`IZQNn3y%dm
zl2`ociG^1=xFmIK{HbQ(EF3f8miSsNpJ?QUPu@*&fE*lg!eXJl1SZlYC#&{aqKKIy
z<p!^hW|ufUtZQ4}j_7|NB5(;@zd1)|l)JkvohUWD>y=A>(XL1EEc5DIBGc{gH%)g)
zXC&6&DYsd9pOwmZHFX0=oAt|$2I91?PA~$0&2MF|+#Q$4Jci<Px4(vS%#``NISNKb
za3ABkyE6??F8P8cp*67g+&;Y}J?q#BWy?O&Pf#^NSJeYX6TCL06+5kmc19gDE=@c_
zIEMsp$3*lUa)*{Yt+GZfT%p#e+pe$P;cx8DnHOruWsK~csGehX#&`m%Fgh-KkDj<|
zOgRU{Dn?m-)G@Kj{+are88O#gj5k^QE@Jys;RN&qExI^MIgj?fmwKI>j=MC~cToAq
z-y^Tz1vo8qIi)-S?Sfj0Nn4E%V6^{tz-j6}OmRT@(#sQd)DhDf$lEX9zkiu)l?H#i
bfBC1+&gHFcb!NL7{CWTX`+ru@ru4`!r#?Ui

diff --git a/CryptoPkg/CryptoPkgExtra.uni b/CryptoPkg/CryptoPkgExtra.uni
index 92e9fd4c8ead15ad0d95ca96fc9d2920c7dbebb1..71c4a65aa4b3963beb333073198e76b250bf121f 100644
GIT binary patch
literal 671
zcmYL{Pmh~05XJA2@*PI$rHvBkzf)CJb%MKVZ34(9+V&JV;DA-Ik?rg@{q!9m-8~`O
z@4flWFmVj=atYthx>fU89K+UK`(PoL<!@Ol*x6FH`md@$1gA~yL7ED-)&yljG&m-g
z?XOPPO@O!MJNWqi!zWk|pU*2`C~eW<dh2A+)<i(s7DlxPr@V4cs*1jD__vq1qR}3D
zXKN?Bv0!Kv$g;FuFU=J(pp!v4En7d9mrg;eOJzKQ4uGAk(C{R6D^IP0i>Z`@Ap~9B
z)I(`ar3W4l_B_6AL;|}hWlVi;blJR=)yks^xhm~(6sOD73lx}ozF<c|{R#i0ZZODk
zg%iG8Bmf!4*d~PjOB~xCaqY#GDzdJQZw?=ye6_wEqQ2>0XL3&==h+=6dtd?*CJN3r
zhk_<>NE6DTK*87o+tO4}$WkCFEQmn)0yac2u^Is$S#h5o3V0-(leAz|K*oX7oKr#5
zf)p%E@#+WKf58JwlNC_3U<vwj(2R1n&v%R_uPd-z;wsE%Z-(LE4??;l;^veO1&%q{
jK9D<lOv#=Cs#<C4%dlX|tPcWj7PrOgr^Q<gS@YRHWLC^t

literal 1344
zcmZvcTTk0S5QXQt692(UUuXpmrG2U@)C63xpd<=GrBBFlxL8eM<b+H5<DuW#^(CPw
z%I?nW%$c)i$NTc!wzdWQKk^IgyIosm6T7kvdxuwh`&QV}?rdQ>R^Jj!?GNJ(QGuP{
zO|d5A{lzoJcSdZ1JtJn0ov@OBpV%3DS8fdJ8mqN(DlJ|1jolI(*e3WNn0IZ*KG|nh
z+qLz@wphm{>V&mw6kupf$j@BOkev=36(MFGTigoR%=s7g;Mj-u&AK+Qy*JnmVU)QO
z-4UOIq8d|BsuM1VkSfwBC1MH_?JY|+0z6`+dKs$;XwB&pyvmlADXW=dCgm!8Wsl1W
z53F@piH#VQcTa|P3)U4AUu)`ES14kp$gI{!O61&qlh@@I53o<xxHMcJofawM|EJC1
zAVhKSda2eNTc;kubM;;Vldj@_&5pk#v3?@zHLG=HyqZg*MrD3pY9LOF6=l^)3-02p
z>uL3vS6A_c(>mn*1vlD$rT!ex2<~ILZoPU4$}Rs&lWNv^jx2&zpFZl@A!EmWV#jD2
zpsMB}-k451XB9c6&+U{s!rve?w-D3W5fNt&xyMQ!t+B-{T%op@yUv!iRdWmM7yIJX
za}{NGs3c~m_+wCo(R0-YSmG|9Y7U7~jH>#mAH*v2H}f$&Vy-VSDy#TYM0Qc*H0Uu}
z^yw?rJg~Q30lh_S$6cDfuRBNYiC!0JcUh|22W3#7K;8~Y9Wx%Xa|ttPuiNlg`d)-{
d&+K0?b;35Ph@oOy<gdPX`huGmuT}F>>_0e_&Q|~c

diff --git a/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.uni b/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.uni
index dcfde21b068be9864576f6e22de009a7cbc981af..00609947e5b167f89a95926f11eedfad57b85f28 100644
GIT binary patch
literal 1249
zcmb_bTW`}a6n;nIKOA*0P;Jea_QHe^X=7N#mR3p1#?#~`PGZTmgD>gw?>Tl0t3XKH
z8mUs8^PTfue4+@V=@i~IT(IZQq6ijx?5%1w?K@t<4c}<0M@XfyR8|Zcr6IW|4@sVW
zBKgci_Au%!SMmzVjvLsj+6e}leQ{hf1GKKW|4ap*4V>*@*D>kKc*9v8+U$|yFmT6(
zfQ}9f*rR3IBf0FIg)=a`mDD=Tj$l6&ZJn{OVK7j^Yid~y71gY9LX2P)&_VGU46B^x
zb_8yWLz2c-9Z(bGY+TbY4QgPz5o!mhnoG;tqq8IJsvk9PI}0zWmvC`@{u)_coWHs}
zMc*tFuu!^JntBIj5TmeAZO{wD^nm)`%=5S3tqczK+Gnr@Dr>ME16oyT+fzAm*}@hj
zX->tSD=GuQD<%!<^z~a>BVeFh&<&>GWR0|a6GUw>3@oXX+$Ul{HR0R5NHFctB{;Cd
z_|cBTSdRW!pKQ&I)qE4eo&jctR|0Lt){pjEs{<M2G5Qc1g$#h&(6+O-zltK&BVFZm
z#b!#k(E(wijj7KLFSEYu10?*F*92Di@<SfqLRvtQ7G<8!*Ck0{oh2j(Ul25;3z8KC
zmKnquOyUB|CoqqTv^Wi&?$Yvlxh~-@&ht1cQ&PY(hn%c(Qjn~S%XFFH(R+k{hL35M
zoB}}zjv)8GCX}bQtDBT0Pj_HC#Xa!PiT4LHLVgdo%Vd2+9^yH^#ETM+e<y;<*3lL(
sxI9}IF!`g!oBU!_LW)J6uDph)VLy-hr)B+%McqUG<C4PfENC$4EB~#P)c^nh

literal 2500
zcmd6oOK%fF5QO`T#D5r>3!uaX#07*9PGZ0U;>d9boT81ru`T(9Um<@U_^OBXY@!6^
zz)LH8W_o(7tE+ovzkjP)%>uuNJi%VsnGJ1Zx!tupShcrnbGxvaEp2Lj<{9$=US0Oy
zGoHFlKEawcu?3zPV;7VF-jw}dd-lm1cEZ@k>m&2FRX0(}(K1_sFyy_7J?G7iM_Vu(
zW9zXiegV|nzOWklO#2zTJ=VqB8J^K^jWxG(R_CDQAQxyu&p7A3#HJi`#GB;|&smQg
zcR;+gGs*2MF>`oKuqoz{+063@w#|BhrSH2-tYUtBv|l5Qc~|NN7)gP(M;pRD^Y}e%
zUFO0+!&f|26;)2^tQqAkJ~^IZBDLf*#J0ea^RN9C`vZS#v8j^cu0TG+OEsN({&UtN
z=2AD-TG>mF{tbR9_j28*D0bnD`b1Wi_u=q>@rga+dB#jyYW3Kj+7@&5n<7c`U5`HV
zf9VlBsLD>=l~5<B3c^;7Qb{_@Jqy+Uh3(LlFE{xncBuzv_!sA342n8kiY~pcwC?gu
z>D8I<T@Z6ZRP|e|l31uq%DTpy1*|$(>Q6BfZh^12d)Q(fGyFzaPWhK@<t$=V3MR25
z$DV6}B4*;7&WMzlQo)qLjvaDJ<JnGJk`_8aVi~*Ra<)2ULKFveRPb2pS!J#6Dc2>Q
zGx0CFRd2>KaFx|%Wultu+jtUm%R~*N&vH}20FNcljGIKanR+a$EC0D`UBx=5LbWUE
zFR+}FLyxYz9K8z4fM3!i%{um$yDiuOoz${7{MYRR>n5t|7S!0m+N9Txm^EDMBim=x
zohVHrLaIZP-frM==*TT*>S_H~7=<g;3geEiwc0ANJ7!;~Esq%N7_YW7+sEDnRTwRg
z-ex84vMFW<U->9%^m>i2qJL(5$BvlmEH-{diCHwb?+cuS-b9N7z8Z?TSGog}e)<m8
zoV#rL-J=Gvf8sfc`kjE(0^<lYeOKz_9(U@f)q&4V&pkgm!dlTQx}$>k#5P!BTKR)t
syvioC+hwJmIE0V-<zQ2X>oU7dR{!qH`ggvl<tYE>m-P32K~pFF0BTK_(f|Me

diff --git a/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.uni b/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.uni
index aaa28d0598d87aa9a0e7e1e22b2643bcd8721628..41fdbbd2cd372854d7fd3f82b1accbcfe75a7017 100644
GIT binary patch
literal 1994
zcmb_dO^@3~480fVe;{@*?P6_hiVcb`ilVZm)<V{@A<0O33dRy84=|ch=fjTweK{jH
zD<mlpq_z*XX86cQ@{x)ni0<y-_m&I%{<|oGr9KZ<b(#$aUc)orYo^bTNn@F;5n82T
zn`Y~|Hy#1ZS+3+0R0nRLSB(=08vk}&qXE`5++Q<6XGe}FI2}-WGv0D+f}0U3E}>3b
z2sp4K0)DWlJ(A18S(t(0on+Q&oWMRY>YcH$M>sOU8)mVAnrUpE5NEIo*irEY4AxF_
zdj@WdBa+6|2Vf?ovv+Na8q^VWE7S=nUoI_nld~~;u+EjmCs-$sknj#Ebn9g8^ELOd
zTF1-TI(hxsS-FZ|O%LO=97|ax^e--!kJH<tj9)4-ald`DEN_2?l4^oY!Ym8rnIHqf
zgtt`Z*$Rc|nVj6hyZP&fU!X>9sS`Doii$29L3vJsP;aSSme;Bo<?*ovKm{6sl<gF<
zP1j%aBpVnEx<+XVqk538-=hvBJCvxIrBZ(k4b(M|%2IEJL22JeF2Q<<@rxEG5>&%k
z^X_2bhx$kO>EYD_iG_Y1?@7281uT^&C(Jiy4l(H~SR0b0L470{{<<iB^Hc(zAml;&
zA?Sg~Qdk65*Qy_wJagGWPvz2_iBU41s^B$BLoB_0&l&<885e9%!{B5?RrO8?)zeIn
zNv-5K7zR`u?iOW2;}*OG7AKlNQspHqCz*!q8*Z%T`!I8JpwXe3Bz2SP5B6VI7c#`-
z>}R1>!~mELZV%QDPf?@>qN|*)ajtY1T@WVPn`U--m=A{`K*pl1QrH%oKZ|$`SqVv2
zRz<ehRcQjdJV^_v$ROm9Ez`VAVUt6g!%bY0`3)@MGAr+cr?*+P+UzQL8y7{KS6N!Z
zrhp>d7HOI0Ra|A8oR0n=_+RiQ%aeOZ2|^*#citwLXY1{AmL@M6xVxj~`R}c-5A}%n
zy<cyV-E;arUeH6ltYG@N6-;)Hb+l*XY*)g~S8l$W{|G{}yDYM;Xa5rB^C16gTYkf)
l93fZSlJGSf60Wuw;krwa_Vm>j;>-K!O3M(waS;Yd{sU+fn2Z1b

literal 3990
zcmd6p?N4Jx6o=1e6aR-B_~M!cT(cXaF~$N_n_XT4CA)qyg_hE!h1ybZ|9SO!X1tw?
z6obiTmo&XIbLPxBzw<it*PmOl6&3$4`Bm{_oX04}F^JFOGpO$E#4O&&G_K<+hRl1+
zFW@?3?+xQ=qRCT5CoW?SXOHm=DHZar*stO++U)Md=2CJ~LoXJb8o_%R-@)BY8s^L<
z(E99(sY22qerGjGGxvM!_F31bdvIpH8>oZ0Wp#_R0g`KJqh#fPa|KOP=a`dCt8Q73
zliUmR-6SM~_ye5-a9l!D=ZM)f*-^y?>p7HR+P#J<^3~e@ThfHHdb9$O9=J)`MquwH
z{e5U>%$0u*uQ-i_(b79NjB<--0H;XwmOLY9b0`D8?l0KCNT=q@D5-aW<a4-;<5jYM
z#(K<L@8<Ywz5W<Jz}K|BM1G&so-*cpu^TTLcaz`5q}AGFF4gg!$8)H^z}+G<H`1wB
zkKjAzOe<bI$k`%4kIDCftqYP&YsC?|#I_pE5hq*h-jC#J{=;~UyyIApZ#Z?F?7if4
zAB{$}2er<g)jA7Gy=8RF^$lzsqzsrK!+c+@{~ek5D!z(u;jl_)$-BxhlZ;129w?!Y
zv>f-<l5*YV>M}xS#Iw(dg0Hqixw#6=VP)nj%o=m$KZMubvG+ePiMyf}&G-d#Gc;Rs
zML(&qYr$we%^FC}T%#bb)nm5bx7wPr)|6uI=DL}p%@g`g-ByD&XrHvUTsQk-sfOaI
z9VAStOFc8>q_V%jqt6(>CR#7}=gyK>FH<FSkgQfakP>G9Akl{G)lGI<DJ$%YwQNyo
zhd!F6h}aFkk8N`Ohox5vy3&!S@Ygqi-proO*6NoYn9YL;NZfm$tRJ#tR*F>=_RMCN
zsl96NH7E5~_GK;K)8<z0YCZVIP)_+uvrD*Z)bzWwtZRa#f>LC1mK(#}D<WOaZBvuG
zti9a|mf{QV6L)g2ylbs>sKgR`bs2lDwwE^Jl5ZWcnrZot5w&;Azfs-wO!lT-Jl_l6
zv)KpQdcBOGm3+-_N{{tEH^;Jf<)0<{HlfbQxh)VhEuKR;1$&>)a(8DFDHr^UPs*%I
z7ixp+kW4y=pZT^@^>*;8-QBSZwL`9*Fl#4YpTs_68@fKp5=tC8<aQg5<0ScjnK|uu
zjZwKuU1Qu%Ygf-3=-#rg)Ptn4innkbC1m^1J4jW=LDGK2O6=0q*@aggwPvoL;8pvt
zjIY@dxwn!poQz#7+VO5Fr%3k=bVz2YbGPv#DE{*$mhT~H{@0iJb4irEG4$VWNIF2q
z3DVlETG*a<ycxUjJ@i{AnpV}24CwJS|ICREWQlZ*^B?lfx0bAUye0YG-ND8VzN&q{
z%9_Vm^6B1|ALmWk)N=m?;>}aPN<Y<G^25C$D{Aejy%_cX(|sxC_w>_yA(j`ex7Aa8
P8CIz?e!Lf9>5_i~&O4fk

diff --git a/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.uni b/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.uni
index fdf3f89db0359f527e71a541cd372839bacfe017..593faa7b060a6326b670813c7fde836f793353cd 100644
GIT binary patch
literal 1816
zcmb_cQE$^Q5PnDEKb*D~sMcnih7c1%q>Z7`*0f4eHl8XsaZ*dJ9c-sv|2=27s1Xwa
zjV3RNec#=8ci&wQK+x;K=ZXvV`c)9XNbee}YE7FJFW{apHPt(arLj~N3@W7|dL)Z<
zp5*a_ETT02M$&<U?%}kxT*+I=SKPo_m91c)*^icMW`LF@ch^+l*@m+%Y*$P=GhT64
zdN+HdI0W8uAz(!}4A_%p+9A1YS_^$Jyq46qnss2m8LeAmVaZ@a1uv;(B@|S%suf}f
zRsr28UV>potGV3)H>O3BrY%-LjZbIURu$8rHcVGSZ2`0A(z3d9wvX<u6J^;gOrjfz
zc+D_$)yl%<Yc60s2}k`&^zPYNHV&`4hat)KrOYGz3e(X|_cqPKV<kH7XLqCQ{5@n?
z6IMplQeU19(i4n$g>~+anGkC#JGVe(3D`R9hUJAS*|EBSxnp+<>Jm9Z01N4TN@cNR
zO{27{FPC6l=lMY}9c8Fyr+K}y@TPbR*O!+cu!q-|S2q`^F3SXrltw2$%m6}cySFx|
z6vOle)$wtdesUpwSg)@}JEg8Yd*lwZDAc;4a>r#2YizjYRO~y6bV2ZfNrNn1wrh%6
z(hcQ;E>WYcEU~H138L00RWvD--0RhVs{GwBi*P2q7tdmgLxN&CgypCnpMA-V)qLqk
zVF0LT92^uKx_+|1Tph?DkDZffrH}zo>)o!bZEk}=HAq*rx?lsP>)?Pe!P1od!_S~u
zH6F4r%9y|`oqkQj3B(yhah9j?aGsM0=1D|S$kD*(5RXWb5tt?rCU6#JXnqF6FpIMb
z@981V$J2QZ4`G^yIO-&WX$mQsr6eOs9_H~h!J{t-{|<L?5?ug62!<e!&c>U^li7Vt
zqN4_SJ#3zP&s}}6N62q6nMU(_vIvLx6OMA|KIekUx}`OazwFO5ID650I{QON9I#Ou
s&s;9YpwC18*GhZAI@?1|xXR#P))<^@d%<Zp7cSG2ZY}uB#`0?U3H4`Iy#N3J

literal 3634
zcmd6pU2j`O5QgU(iT`kv+)&gc6oC*GLO8LZR%sL24uz}Ai5<t1?HD^B^v@TbXSc`e
zv<`|8Y9q^Mzh-CNnR$11|9-m{dr|TKl3x`+#aWDF62tgBK4aFkgIL6yn8#&Y#E5>M
z{y9>oto=%RlIE1Dq8+nXBH5=sMN5Ug3)ZV>#_!RJ*U^dNco{t;U!-x9nRfg}zZ1JF
ztLxVLafQY)dS>wyO}%7&NpH&BfK~BUSQ*BjjK-<wdY{z+<9c@=$t-ux>@aQ^-JorV
z=33i0MPSIjf@a<3gq`ai-!Psez314wPDqCF7dD6Bm@%i#F}->6qlz8IOJ+uC^^#eU
zZ?^XDnx^bE+7*b5z;&`V275o*A24@HU;SsuiqkBaNuzU3tF(BANQ%U0DKlnn$;^<i
z>sPFwr(Mfcmb80?<};+s@kR1~!FWR7=;qw(z3~{`A-C>($^1)pyUU!vfIr{RHdEZh
zq}Tc+&+7ax<1w?(kZ!=*owV!Qd&qU!(}*W`N;Y6;m$Oi?^+1y68u0cYVcU$R!_Eep
zKg{H2`J;G_zHV&CckJpWe`o9-V9~7hnXTEgIRXWx(K0)7eFq<hi2+k|$oI|mU6T>{
z)aA2bd{4>701d^uXfk(Yo(#xmN5<6|*<?lCGP2;DrA%j*%{eEs#>|UD?#Ngxj!bmC
zUSSG%ioOFh%we&JM(mU;U*N$b+OOj)e&5sc96EYJ_T)_)&06)ms$uaCN%3Zvl}3u8
zRixG}D*f>cEm9<`9Y4fA%=mHTWkFZ!*Btq}rcTjP$6jxZbRW#deF_rS-X!lwte8Ww
zioy!BekOBtD`w4_wM}F>r#ZLo&bhP(^pTtJJ>jcW&y=g4=o(43HAPcFDKaHXeRcH$
zUX^|OFu2Lsd!k?|v9S8Ok}Jz?Z)L3-OYXI0?)BQrQ?tyx<Qgr0d7Ue=sIA2Bqq-fL
z98GIpuA<&pIR^TAxyoRbm~=@lo~D~oj^*eozexV=vUdUJ_TG#Bl9>~*4`AJG>$_+<
z=U-w{dOgl;3tUGq=`eob+n}b&)Gps<YJ1GK;o33xVk^bk`_<~yL8jJF^3aCcEhM^0
z^C3Ms?RSe-y=vd0-A`jjkJr$>VqL9=$zm0+km@94`Bt|oR;+5hgAK7er_CO+-uzn4
zQa>Z5^*?Bzvm$cOV(Xoi>_v;WL#?N1_XTkTv)V{E*Y3{}Ki@RDYCGqDd&Qp_S+c$w
zzt?CwM8`4Oe4{k*J+F9=^pLyjw@o%ZnIjm`=PUo@#16Vdy2bvF^?KS$9^T)}e1jd}
zf15bgdD-OYeZ2g1ue6WzI$O8$;a%>nRKM>&)vN6PdyQ3`!-w|vGX4+u&6QuK5BIHA
O!A~>#U*A}zw)_Jm{#d#I

diff --git a/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.uni b/CryptoPkg/Library/BaseCryptLib/SmmCryptLib.uni
index 89f598a56d84c5cc9e1512e06c7eab96a3e21b4a..9b2df9858262c1a49e31a4a9ec177917e7327e9e 100644
GIT binary patch
literal 1800
zcmb_c!H(ND5WN@3KRoPS+Qr&RiY)>xf}*me)<V{@A<0O33TTOv3DBfUQg;0J9nuag
zBq)+JD<5Q$^Jd=6yqPFMba#h8S|Rz1pP~qJbLyS$4C{BI#*^3@W=_bIbxhS9tu`o^
zOEg9txS4v$8O8=Dw0cCf6Bc{j43fj}e+FT=1#24NubHH?gWyLTcU*Zh(F)!KH)o{0
z1Uw2Uv111g{?T#ckwW!@!vt1zin+n?5$rRg{a_uo90w*v!yIo=GsD|K$`hOhJ803s
z@_I1Bogl0oh@>6r9heR2Y=^ex2AXngr9OhP7RvE%basv&taI)7BbLbn647xA-43eu
z`PzFdmhpVDOn&>~tX#ye#)olQo=aIJ^e-;v598aSjIWg#xnIAXm$$D`QcZZ1Fvmi9
zM#w-g5iQkuvfxtgnHt@KsRq<K>V^}wZuqsjpxmiDHS>vFA)rDApGrF_S>J2p>njwT
z@4UDOWuy$<pN!~s4nNnw;MbS0UQ!R~^>9zBa$I7r4LJ#6riiKS!P=5iEH?*I$D3L4
zyAK({27UF$D|8>&6L+w>*885RlTaP@)Nmu1Ja>}lLW-IzODui1dq!EZ0~3;MNuz^m
zsHxrwq4p$IGO4vX>(xTH;ciwYGz-B?U~#13AhBG+3Q|wVz7f_Lu??dz1u2>ahD1lM
zKe|t@E@X(u$xF1=!~o0%w>#(h$0*W0(ba>g`Ba-Ox*%+{waw)6G3|GKfSil6NU<(f
ze--f(S&1Yot0J3isx-kSPtpPv8H60Nd776gRypDvH*rbkH<-m`R^A6s@3LyK+EjQK
z7e$;`Sz2OMph(w6TBdmwSJ^73qdy7$H{ND>a*vcC6e4}^ZGw5WTt8)La@D}y9W~GY
zZhd{IN5t>La+PeJ(hu>BKH_<W@pCJg>IT-)_^ZjL#LaiDrJMf<MT0djvbE3Q8tltZ
lKeWpJ#~M3Bo^gfYTh<qzZEN9qHx@0?XWdr#%BBix`4{<<Qpo@S

literal 3602
zcmd6pU2j`O5QgU(iT`kv+yH8lQWYUp2;n3KtkO7&9Tl#S6FZKj*ba6+=${9kXE(=t
z(mE(YKqJd%cV}kj^WE9~^N*d_iHiRh{Hpja&SDZ5F^W&)6R7g`ViE7+GOl7CW99?q
z=SZEx`-$-+(Uhs86SG(%Ibb|RONG8U{3?3!hF=v!R+G4aw}|bPm8P{pT%%#azFE9t
zM?YCxGMhph!qvZu{iFDe)g;a258w`2*SiNuX1N=vqqt>ti?$J(Yi*Mh@rZrJo2JbR
zb~YotWqpzKo@38AD*nG?(}-r!v^imRnc}Eoi}e!9IB~C_>iK$Wf3IoEUb9=_k#=vA
zwF$ltlKmmHQ|9VFLsmbnij^}vH;hW_&j?99F<Z(^pe><{_{zVAf1Y+NS5?yPHJZ<m
zvZnL9I-X%?p0b;3ZS>}2{D53D_EPx+bhyi!zlr^L$+(~LrcXv~Oya7p?=qf2{SoOF
zDBViCzIudQk3FsU@<GW~w8866Bkn$)WLhhZu%&P7y*XlM3+{)NTrYnZuhG|w&G?#K
zy%g_^-9s!|)dAERJ?m|j44N&gBi6Twag-1+MTdA_Z(p8>$fqu!4fA_SHHK&?*7YW1
zSLBI+e0D@!U6FNG)GZ>5pR-iyjIvA4iKwyi`XP2itQ|%qx^8xqf}Nso4-J=~SdYf+
z6f2(*!RL%G;yIOm&dhU|S1%K8I%w9a=T!}hJ5Ne9+i+Sbhjx)#w_X{KXK0Z!Vej}R
zc0tCst0;?irGH%_U-!@{TI$>zt(hL+vw5H5iM)3y`Y{}9sIPiqhiRV4oZSklRkOG0
zS*~fWt-EtA?EwSiF8H4C)v9Mot|z+oB-@&zsd%YpN|ydAcMh(~zFiQ!&)R#T_)>CV
z_mz`7%l&9Ytr|=1wPo#%+Rjs>%(~<rt^eXWcVxY`6Tk1({mkTS+VgT3^@hqhFxIP8
z1*?RlD{Ap7-GpK+XIJ?}if@~}3oy6yUiOzzPVjvQ>h4?LM$0+>l9Mv)b7tH4bqJEW
z@dMvhx-&au)n4e>huQ&a$IRL(*T-?d*oJOSvW8NJ4%luZ(My`U%*3?c4Mz2<b%Sv?
ztzA89c=r~*TD!?&6>pI`N}e4+@1Rv3-DLfUmA*^UW*=E)w3?;9M^@{<FusPP=l1aS
zos}F#JAPj2DcU>a;t*tMbH8zami+mK$z5BT|IHPCW>m@kYW{vjQx_e_Xlt`-5qsu%
zkMxmy=(kBVJ(*(=FyJfx#Kac5^mK#$|J7@0BSrN1sPc`qN4y>KR@Y%&WRHpJ<GsrM
zpVwH^%7=Hiw^03_`&h5AfA95GaqgblTg&`E-8WW#i9X%8RRun+=s$f^mEQ6f?Wa`6

diff --git a/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/BaseCryptLibRuntimeCryptProtocol.uni b/CryptoPkg/Library/BaseCryptLibRuntimeCryptProtocol/BaseCryptLibRuntimeCryptProtocol.uni
index f16637b7713f108293e1057581f3d9588e2d00b1..533fffa8c37373f0ddfa055e836ffc0199a72e5f 100644
GIT binary patch
literal 1792
zcmb_d(QcbC6n&qxe>iGix~d7?)NWceO(Vb-w1z}L*6yitz<?#NkumM^_q%r6CEB#7
zCXo!7d(S!7KE8M!ywg*BsYJ_Pzw$f;dfOXSYt}cSz_r+DrniXYV3;g8Hf-P}ltem8
zBRc*VkCj$N6{?+D42P39Vt{x~dk}4l4X4C*i_t=CwlEEcKhj7@1v51HgK5DwEk~)v
zJ=ds|M!fp!P~l(`W%v~q;f1#dFTHH;zeOl&J{VM^ER0ZcIKzD52NQb#&zy_j1v*4O
z%Dg<J!B2yW{fsp8!G9U9C2RNRSKou|_yaOgOJ0V|Fbs6-kzP@49psLI#8s8xlR0nO
zj>&zP+v(-`M-*HeQMvNbFj=;?>OYk@H1@nis^pG}nNf2%KAT82@1<ZBE&hkp4}2_@
zCK}a2j@^dHYA(5Eh8B893yMJ2uy>d5!?ACjx|26x#444+F!sIDv|mo1khGC|d%d$j
zp!%&Abz^W+yurKkx96DH%f%V_$?z6|(gfrxn8GKAxaa|z4_x2#a{6hOezqiz$T_Ol
z)|;JEX#K;ALUlcpTOn(7WFj(9J3Ou%$tCSvTD#ebIz|h~?wM$v$3|IF{T76>y1|7M
zN|wU82&!`LW?4w5z@a$Q2RatbA6mhO$LdQl7%euV&7A@{p;jYRWXM6!P)}k=$JU;O
zN|6FE<6s+O`YX><J;_z0F8EaG+Iz|vyv<Nfo*t%s)4LQm<nsutbonjy7l<>2ah9j?
zY@J6T)=3zpumP@yIEa!g!ZLxM;K<J?{0K8Yi?cI_bQ9<E<vPcWpQe72$5Do5iZoiK
zQ5Ge+pU2CDroK}8PkfJ)@C*^95JhxrV_bN=SY5|axbwj2DQ%wpAKUezJtBQ~i)FaJ
zj_&*!J@`S6{oirRWIeK)gUiV}!_mtc($Rmo>A(kRys|~@*#F@^XcNOhdlwGdxAsr}
V%X$_L(ywsnUPa%czxtH3#%~4MN;&`l

literal 3586
zcmd6qT~8W86o$`rlm3T^-q=Q=8f{b4G)2TptYQ$Wy)w&(N`gQZsP)gcecl;%2Nhy_
zrP(YqJ9Fke@A;TB!=K+pE1Khd%j4{eU0T<A*0I<2ic!s#Ewwuv+SmqmML(f`jZ}-d
zZ?sK6CK+c{>)Qy)gti5WV>V%=V{Q5aMxE7dLOW*VjhBe{&W^zvcug(Zo)vN)kx#>G
zAA!_;r0tfm9*^`&yEOJZvq{dP>A%OINTLLr&<~ti@EuS2ey5*;n1CjqIIPh3Px>ie
zm*A_d!h3IqtIJtCJM#8)Y#X^l+qF%6s&<R^#P-p@&de^TSD?yw!j*?w^t;}Ik*zYi
z&$<%PSeveYS}x+xLyR6RSp_adYrrG)N<^s)*F`$&$d{Py*e~y`6uyb~`#epG>j8Kt
zwrn3*b>gk<v$~B&`8#2BG#xEY{oBP4cQc-xk1Wq!@^nF4!$%!h^vEn_;3D?t#A?gl
z*+(RlrK$I{FtX@7vO@@MANLUJ$1#Z>Ode&?fVIk)%qm$qL6gQp{)l&`F~oTh-(#Y3
z$h!aIH1ruifrqj*STn#g4!b6_+99$`d8b%NMtgjbwQh=`_=(8|K73F7Ce(voZb`>h
z><y^eIkL6y^Iv|D+|c8P{T02ZeeBS!sxoh1&#MAukcQ-k_Tv>RwQp94pLA~!+jU+?
zMr2=`eh;ZWNxLe95Yj0lSsr3gV5Y>pBqFw0$sSd*)W@$)4t=s6_Q~fwN25itMh%hA
z>ZW`j;t;Hre-b#W*4@BFb9eCQW0CVYEUuvf_0S#hGw%k!D}Gsx&G5AYLIx)AO+fAO
zo7FMpvSt<QtP%!YH$DOxikL~VoBKze7?8Pf-46M%%eT$~?WVvba=rC&ZSniqTJ2gP
z#@I`js-UcHk~6b$aa5>KwN(p3jKo?s=pn27o(bO62^G!-Rqo&eaT?EfR+%&=7TeUr
zB2vStMUqdweFa8SB2<LIti>Znns9HEb@yiqpj`7tpTu5+npJ_<F_~1eul$z$Ua#U+
zoeOFkj8@6DQ+gHe>r>7Z)#^Gj8A6OhmE5i%apI9{^pw;3U7{7PP?u<T{I|YVXV{%F
zFVvdX=<E!sx@UI8cokG()V%gOU*fJY>1-e?8EFktd&o-r584A}#9ZfDWvV4uQL*zJ
zC!$yJ#W9&Box3w9Z1kV*Ek(~=V|thK{0aLg`0oOw8W^XbRqO&r@|QfTGqnMqMbEO|
zIl`KdE2@?{_xeQn)LXd3`sceLE#<cVo894rFJrfEEm@@I+5WWMvC6%)o7hXfcWF1g
s-22v|JIHh1vs9xW-qN4ze&wj+I%{9<y(;`Knmtn=?#=?WKdY910p>?cHvj+t

diff --git a/CryptoPkg/Library/IntrinsicLib/BaseIntrinsicLib.uni b/CryptoPkg/Library/IntrinsicLib/BaseIntrinsicLib.uni
index 7435d1251b18b8214fc9bfab4e8fc179a668b327..c40b856a4942f8a978edb30d279a15bce6f44471 100644
GIT binary patch
literal 889
zcmbtSO^?$s6ucwxAD+4wsM=;hoDf2!jbSa?q;gypPAfNY6HAF5+0O3v-}7u`cli(p
zL?R_|JTq_J_$3J>^ErGvt4_Xrkt9I1w@N!z0W+glS~@sdF$~heR-LS{7lb%3bR}1T
z5J|jM4ti6Modo<+Pa5`7<9^cUCJij{o5scr7pt1q!>j5wyuE&N4a@L)w+NnO2ODDt
zV}(~nuORI@h-e2^I%)4@z51|bAAhwpSkqY1gU~hjR)VN1(+@&lly0CGURotO7h4ck
zLZ>RJovb6i7c~;@gzCfz+ZuI^5d;xr^)5mxqiYrXI56k9w=Oe`DXK)(`&L!$Q(1*!
z`VdvE9HxB2d_yn5QT04xM_xYoN2$pS+PuIC_YFD#;iGKp{qR0X%z$>yXz?hFZIX%M
zl9Q{K(_%HWL!`t9zag+^#TS<DfR>Qak~6wKaFW3x&j^D6h&|8^$x8x74rvavv_$v}
z)@e!0MN~Rcep4Jc98<>9oKsRl!GMuHBPGds%4w0~ug^&T4qs`WEr1{eOOS5?6XA5X
z-%^r2&(VC2^Azr@kPn^_`n%l~*<nj=(={&A4Tqnvt4`=<6paL_mxmH&|1iF@zZA+y
TxnXo4I(RPiN1^{1`B?Y|)gBds

literal 1780
zcmchXTW`}q5QXO%iT_}wFM!$v5Kjmp5^BH#>Zoy4c&h9qZ6oC-C!y`1r~S^Z<E2R{
zNJz-?US?;{oH;wYH$Pj}vWWi~Uu5s>%*Hmckv+CYShbee%vM%npV^XjfbH1kw#F*k
z2y0{~c;vR=8!?LP3u}e5m3CdBEZLE>V}MVyju0YccEK*8O~D@$K}@2`rdZoN${ik;
zTRbLPJbV@p^LP*H0@lj;98N1ZJc0F7`j__HUhqeDP|sf3KI6pk8^Jj;A(UXK&7Dqj
zR-3G}S(it^R=%ZEQOf;bG{p0bbx`^3gDNfXpTkfwrl3gMA^i%@(k+Mc0FNn5w02EC
zGyJ8mSSj9^(FD!IDdbqSTgvIAbn4<1@U?sBd~*2a_)TaFTJ2jq7QPBLOnj`VJKGIQ
zF%#c$t&fzLQ-L9aj`i%2xvD8}30yB-#SCb7vmL`mh~nU@O0iUf%DSlPcXKY0srtnK
z%+;OFNUX1Dw^`j)#;d6sFRJ~z8~!Aua$u`UT5%Sy-OW;sd3EJqy8N2tUvfgNE%ldJ
z3b+rcy1UVvpj_~WC}EV@CyU|LrIJ$nNZYor%o9|N&{chgHKEq}jAEyC-;U^G?9#*|
zgmXx!?HG@qLrxi~rqwp+g)7tseaFo;+y8~#3F|^lT|~VbZ6b-;5%vUBVWcklF*9+O
zO))dP<fEwG>jS>p`JMhVD`Kv@7*|nz7O{P+aRPdR7F{Y!F%R#3kMt(C9CvA|f3L0|
ze~-L=ry!+Z^g)a56h_iZ%C=D}gU|22J$G}2wdMw$yZTX09DpUJ4cP6zdjJ0VHtMYY
cE+f@Lk6ctM-TDmf%j(Y=>7M=nS3YEX3w=cwe*gdg

diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.uni b/CryptoPkg/Library/OpensslLib/OpensslLib.uni
index 86412d878d66bf6f3b312392bcfb22ed604648e2..0dffec1c98a3b9a9fb700f0882ac7f3ca05f9522 100644
GIT binary patch
literal 870
zcma)5U60c+5PV1CKdgE$P_@m0ctQw~55rlsNoA)xcse<Wn^;Qh$ac#0-?K4=1Hqk0
zq(qKqW@pEnD1vCYgbzp6%jeIc2+B@57)&$u5=LuIs*w)NC^hF>*s973dj>U(y&R<W
z!YiXUGx2e9@t@?>jAyIb&cloPCA_|Vbq(wJ^=1WBd)Y&3>}c$dk`VVj1hfMyowO&}
zY~Cg8{hwa2gVu@xgl@oh5=32_VHEnTbPI#<(kjur;9Xb=y{e^lvI+P>G)OoJ)r$(l
zm~<m;5JA@90;D#&QF8<s(J|~LJj0ZNN>KgQsk-}BR$-QY4!BXyTUAXVKETi=94G9^
z%X|M*>S6|Mo}t2hgAPFWAlrFAzKx>!T%4I~EjPxt(S_ln$~EiDVl#GQpoB+xLtxK}
zPb}U6<&aTcGMXGplEER*2!k0AdY~!EIe{XFIEO{d5x#&V=9I63(k(4-ibDyvF=KIF
zQo^BNz{s8vPVzD?X_4cnk4XOtpJ|@0fFK1+kS{YP!0B$kr6hY8pyd(=X}+)KeDI9W
z-`%dr4qI{;C%A~y5`Mp~dZF7%v=XFVA2=+Yp0>p!+8N;~qx;$PgZf|E|NJ+eF1QI5
FzXK-)4U7N)

literal 1742
zcmb`IS#Q%&5QXO%iT_}wFM!$v5Kjmp5^BJr)KL}{o~rD%l%-1Cl>B+x@6083f(ldx
zMb~$k@ywYs=Q=k(YF4v|@r++&?`&+DO>Jb4?GdN4b?kz(6|0#oY-m?*kL=Qx?AO?a
z_{+ZFY-Dq5^E+XGf~}8NkFjB&5#iF`p1EI+CFgX(JJllNLo%oTIrDq3WdrWaCe)vU
z{)r9jDf3HvZZ8;-9TmG*cE~!Rj-1M-tQBDiDm{0rjI54b9%XECw{#9i%xhLd_;_Ot
zYuVdB@)CM5@f<Uv^gu9V&cQtL{Q%Sp=Uui9^~|YAy%Z|t%UDh6U&*`rrMIWp2CU{-
zg{h3Mx7Br>tQpcwk6ueT5eg9s#V(PATr=0n7NwBMGXqIbK~T|n=e-76I%Y2|l~_uw
z*RIY1Phr`wHUonqijAOP<yx^<)qQYo^H%W+N*DgIYg|1N>hC<I?Ojy+%mg;2@V?hS
z#yfBzO!*G8Qc{j8Ui;nJ-j|j8FTK7h>m?nk{lfl=lRnsosBS-dm3SA7l9O`Pu}>C*
ztBI0Q`^d9yU)U$G8o{gP4yOrP>#~ZS>#m(L$DE6k5TWctg0^Ek+8#M&B~9yDVOCs4
ztuQxyuifDex-;yGntH~_&hTnEvQy3zqAEt}*<0*{U1!SK!B;-Y8oWN>tL)#HKVuPc
z-NpE4mQY1(UyC?p^aL)NC`&ny@B9Mkt5|dF;#A|H&`-EWfxmMirNrnGEw*zIi7zo*
zhpi5He)l`@o1<7)Xl3I1(TzJImXKD6`|z)7rNDka-0FH8#8O1FVEQiXf5(0Q|BZjC
KunI%l-rNG!XAg-0


From b26f550219797b73687705c9aa1d2fb071d784cb Mon Sep 17 00:00:00 2001
From: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Date: Thu, 17 Dec 2015 17:02:06 +0000
Subject: [PATCH 465/525] CryptoPkg: fix build support under RVCT

The RVCT compiler chokes on a couple of issues in upstream OpenSSL that
can be confirmed to be non-issues by inspection. So just ignore these
warnings entirely.

Also, move the dummy -J system include from CryptoPkg.dsc to the various
.INF files, since it will not be picked up when building the CryptoPkg
libraries from a platform .DSC

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19328 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5fa05671e2ac0dafc52eb3b8049b4ac95f54d3bf)
---
 CryptoPkg/CryptoPkg.dsc                        | 18 ------------------
 .../Library/BaseCryptLib/BaseCryptLib.inf      |  4 ++++
 CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf |  4 ++++
 .../Library/BaseCryptLib/RuntimeCryptLib.inf   |  4 ++++
 CryptoPkg/Library/OpensslLib/OpensslLib.inf    |  7 ++++++-
 5 files changed, 18 insertions(+), 19 deletions(-)

diff --git a/CryptoPkg/CryptoPkg.dsc b/CryptoPkg/CryptoPkg.dsc
index 043704067a22..fdd0431fd1db 100644
--- a/CryptoPkg/CryptoPkg.dsc
+++ b/CryptoPkg/CryptoPkg.dsc
@@ -87,24 +87,6 @@
 [LibraryClasses.common.UEFI_APPLICATION]
   BaseCryptLib|CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
 
-###############################################################################
-#
-# BuildOptions Section - Define the module specific tool chain flags that
-#                        should be used as the default flags for a module.
-#                        These flags are appended to any standard flags that
-#                        are defined by the build process.
-#
-# -JCryptoPkg/Include : To disable the use of the system includes provided by
-#                       the RVCT toolchain.
-# --diag_remark=1     : To make the warning "#1-D: last line of file ends
-#                       without a newline" just a remark such that the
-#                       build doesn't stop as warnings are considered as
-#                       errors.
-#
-################################################################################
-[BuildOptions]
-RVCT:*_*_ARM_CC_FLAGS = -JCryptoPkg/Include --diag_remark=1
-
 ################################################################################
 #
 # Pcd Section - list of all EDK II PCD Entries defined by this Platform
diff --git a/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
index 05cfe11b2cc4..a66faf1c04c0 100644
--- a/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
+++ b/CryptoPkg/Library/BaseCryptLib/BaseCryptLib.inf
@@ -95,3 +95,7 @@
   #   C4305: truncation from type1 to type2 (Introduced by RFC3161 Timestamp ASN.1 declarations)
   MSFT:*_*_*_CC_FLAGS = /wd4305
   GCC:*_GCC44_IA32_CC_FLAGS = "-D__cdecl=__attribute__((cdecl))" "-D__declspec(t)=__attribute__((t))"
+
+  # -JCryptoPkg/Include : To disable the use of the system includes provided by RVCT
+  # --diag_remark=1     : Reduce severity of "#1-D: last line of file ends without a newline"
+  RVCT:*_*_ARM_CC_FLAGS = -JCryptoPkg/Include --diag_remark=1
diff --git a/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
index b522a3628bad..75f8e6e5f06d 100644
--- a/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
+++ b/CryptoPkg/Library/BaseCryptLib/PeiCryptLib.inf
@@ -85,3 +85,7 @@
 #
 [BuildOptions]
   GCC:*_GCC44_IA32_CC_FLAGS = "-D__cdecl=__attribute__((cdecl))" "-D__declspec(t)=__attribute__((t))"
+
+  # -JCryptoPkg/Include : To disable the use of the system includes provided by RVCT
+  # --diag_remark=1     : Reduce severity of "#1-D: last line of file ends without a newline"
+  RVCT:*_*_ARM_CC_FLAGS = -JCryptoPkg/Include --diag_remark=1
diff --git a/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf b/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf
index cf38b51ff20d..446f0ae47605 100644
--- a/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf
+++ b/CryptoPkg/Library/BaseCryptLib/RuntimeCryptLib.inf
@@ -98,3 +98,7 @@
 #
 [BuildOptions]
   GCC:*_GCC44_IA32_CC_FLAGS = "-D__cdecl=__attribute__((cdecl))" "-D__declspec(t)=__attribute__((t))"
+
+  # -JCryptoPkg/Include : To disable the use of the system includes provided by RVCT
+  # --diag_remark=1     : Reduce severity of "#1-D: last line of file ends without a newline"
+  RVCT:*_*_ARM_CC_FLAGS = -JCryptoPkg/Include --diag_remark=1
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 216c1bb764eb..54ac055a43ca 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -893,6 +893,11 @@
   #  513: a value of type <type> cannot be assigned to an entity of type <type>
   #  188: enumerated type mixed with another type (i.e. passing an integer as an enum without a cast)
   # 1296: Extended constant initialiser used
-  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) --library_interface=aeabi_clib99 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188
+  #  128: loop is not reachable - may be emitted inappropriately if code follows a conditional return
+  #       from the function that evaluates to true at compile time
+  #  546: transfer of control bypasses initialization - may be emitted inappropriately if the uninitialized
+  #       variable is never referenced after the jump
+  #    1: ignore "#1-D: last line of file ends without a newline"
+  RVCT:*_*_ARM_CC_FLAGS     = $(OPENSSL_FLAGS) --library_interface=aeabi_clib99 --diag_suppress=1296,1295,550,1293,111,68,177,223,144,513,188,128,546,1 -JCryptoPkg/Include
   XCODE:*_*_IA32_CC_FLAGS   = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w
   XCODE:*_*_X64_CC_FLAGS    = -mmmx -msse -U_WIN32 -U_WIN64 $(OPENSSL_FLAGS) -w

From 1a684f0d9f49e295a3b030d3c9cfcef9c020935b Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Tue, 19 Jan 2016 04:04:54 +0000
Subject: [PATCH 466/525] CryptoPkg: Add NOOPT target in CryptoPkg.dsc

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19670 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit e7efd897d05198ef079cfc6a0ce08467e5c4d0c3)
---
 CryptoPkg/CryptoPkg.dsc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CryptoPkg/CryptoPkg.dsc b/CryptoPkg/CryptoPkg.dsc
index fdd0431fd1db..5ae0e67f86d6 100644
--- a/CryptoPkg/CryptoPkg.dsc
+++ b/CryptoPkg/CryptoPkg.dsc
@@ -1,7 +1,7 @@
 ## @file
 #  Cryptographic Library Package for UEFI Security Implementation.
 #
-#  Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution.  The full text of the license may be found at
@@ -24,7 +24,7 @@
   DSC_SPECIFICATION              = 0x00010005
   OUTPUT_DIRECTORY               = Build/CryptoPkg
   SUPPORTED_ARCHITECTURES        = IA32|X64|IPF|ARM|AARCH64
-  BUILD_TARGETS                  = DEBUG|RELEASE
+  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
   SKUID_IDENTIFIER               = DEFAULT
 
 ################################################################################

From 5a2329660040f8d4590d3437f86a6537fcb9dc02 Mon Sep 17 00:00:00 2001
From: Karyne Mayer <kmayer@hp.com>
Date: Tue, 26 Jan 2016 08:51:13 +0000
Subject: [PATCH 467/525] CryptoPkg: Fix function qsort for non 32-bit machines

Although the function qsort receives as an argument a "compare" function
which returns an "int", QuickSortWorker (the function used internally by
qsort to do its job) receives as an argument a "CompareFunction" which
returns an "INTN". In a 32-bit machine, "INTN" is defined as "INT32",
which is defined as "int" and everything works well. However, when qsort
is compiled for a 64-bit machine, "INTN" is defined as "INT64" and the
return values of the compare functions become incompatible ("int" for
qsort and "INT64" for QuickSortWorker), causing malfunction.

For example, let's assume qsort is being compiled for a 64-bit machine.
As stated before, the "compare" function will be returning an "int",
and "CompareFunction" will be returning an "INT64". When, for example,
the "compare" function (which was passed as an argument to qsort and,
then, re-passed as an argument to QuickSortWorker) returns -1 (or
0xffffffff, in a 32-bit integer, its original return type) from inside
a call to QuickSortWorker, its return value is interpreted as being an
"INT64" value - which turns out to be 4294967295 (or 0x00000000ffffffff,
in a 64-bit integer) -, making the function QuickSortWorker to behave
unexpectedly.

Note that this unexpected (or incorrect) conversion does not happen when
casting an "INT32" to an "INT64" directly, but does happen when casting
function types.

The issue is fixed by changing the return type of SORT_COMPARE (the type
of "CompareFunction", used by QuickSortWorker) from "INTN" to "int".
This way, both qsort and QuickSortWorker use compatible definitions for
their compare functions.

Contributed-under: TianoCore Contribution Agreement 1.0
Acked-by: Paulo Alcantara Cavalcanti <paulo.alc.cavalcanti@hp.com>
Signed-off-by: Karyne Mayer <kmayer@hp.com>
Signed-off-by: Rodrigo Dias Correa <rodrigo.dia.correa@hp.com>
Signed-off-by: Arthur Crippa Burigo <acb@hp.com>
Reviewed-by: Qin Long <qin.long@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19748 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 03805fc376239ddc56838d33b20a031734e3e3a1)
---
 CryptoPkg/Library/BaseCryptLib/SysCall/CrtWrapper.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/SysCall/CrtWrapper.c b/CryptoPkg/Library/BaseCryptLib/SysCall/CrtWrapper.c
index fb446b677044..c0ccc0e79e6d 100644
--- a/CryptoPkg/Library/BaseCryptLib/SysCall/CrtWrapper.c
+++ b/CryptoPkg/Library/BaseCryptLib/SysCall/CrtWrapper.c
@@ -2,7 +2,7 @@
   C Run-Time Libraries (CRT) Wrapper Implementation for OpenSSL-based
   Cryptographic Library.
 
-Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -22,7 +22,7 @@ FILE  *stdin  = NULL;
 FILE  *stdout = NULL;
 
 typedef
-INTN
+int
 (*SORT_COMPARE)(
   IN  VOID  *Buffer1,
   IN  VOID  *Buffer2

From bc9c0c217deb113171d79303a1b3a158c51246de Mon Sep 17 00:00:00 2001
From: Qin Long <qin.long@intel.com>
Date: Tue, 23 Feb 2016 11:12:51 +0800
Subject: [PATCH 468/525] CryptoPkg/OpensslLib: Upgrade OpenSSL version to
 1.0.2f

OpenSSL has released version 1.0.2f with two security fixes
(http://www.openssl.org/news/secadv/20160128.txt) at 28-Jan-2016.
Upgrade the supported OpenSSL version in CryptoPkg/OpensslLib
to catch the latest release 1.0.2f.
(NOTE: The patch file was just re-generated, and no new source
       changes was introduced for 1.0.2f enabling)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Qin Long <qin.long@intel.com>
Reviewed-by: Ting Ye <ting.ye@intel.com>
(cherry picked from commit e6b2c99121963f84b847120044075e7b6ce374cb)
---
 ....0.2e.patch => EDKII_openssl-1.0.2f.patch} | 63 +++++++++----------
 CryptoPkg/Library/OpensslLib/Install.cmd      |  2 +-
 CryptoPkg/Library/OpensslLib/Install.sh       |  2 +-
 CryptoPkg/Library/OpensslLib/OpensslLib.inf   |  4 +-
 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt  | 26 ++++----
 5 files changed, 48 insertions(+), 49 deletions(-)
 rename CryptoPkg/Library/OpensslLib/{EDKII_openssl-1.0.2e.patch => EDKII_openssl-1.0.2f.patch} (89%)

diff --git a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2f.patch
similarity index 89%
rename from CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
rename to CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2f.patch
index e4eaff6eadd2..c42b776de85c 100644
--- a/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2e.patch
+++ b/CryptoPkg/Library/OpensslLib/EDKII_openssl-1.0.2f.patch
@@ -1,7 +1,7 @@
 diff U3 crypto/bio/bio.h crypto/bio/bio.h
---- crypto/bio/bio.h	Thu Jun 11 21:50:12 2015
-+++ crypto/bio/bio.h	Fri Jun 12 11:00:52 2015
-@@ -646,10 +646,10 @@
+--- crypto/bio/bio.h	Thu Jan 28 21:56:08 2016
++++ crypto/bio/bio.h	Wed Feb 17 16:43:40 2016
+@@ -650,10 +650,10 @@
  int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix,
                          asn1_ps_func **psuffix_free);
  
@@ -14,8 +14,8 @@ diff U3 crypto/bio/bio.h crypto/bio/bio.h
  # endif
  BIO *BIO_new(BIO_METHOD *type);
 diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
---- crypto/bio/bss_file.c	Thu Jun 11 21:01:06 2015
-+++ crypto/bio/bss_file.c	Fri Jun 12 11:01:28 2015
+--- crypto/bio/bss_file.c	Thu Jan 28 21:38:30 2016
++++ crypto/bio/bss_file.c	Wed Feb 17 16:01:02 2016
 @@ -467,6 +467,23 @@
      return (ret);
  }
@@ -41,8 +41,8 @@ diff U3 crypto/bio/bss_file.c crypto/bio/bss_file.c
  
  #endif                          /* HEADER_BSS_FILE_C */
 diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
---- crypto/dh/dh_pmeth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/dh/dh_pmeth.c	Fri Jun 12 11:08:48 2015
+--- crypto/dh/dh_pmeth.c	Thu Jan 28 21:56:08 2016
++++ crypto/dh/dh_pmeth.c	Wed Feb 17 16:15:58 2016
 @@ -449,6 +449,9 @@
          *keylen = ret;
          return 1;
@@ -62,8 +62,8 @@ diff U3 crypto/dh/dh_pmeth.c crypto/dh/dh_pmeth.c
      return 1;
  }
 diff U3 crypto/pem/pem.h crypto/pem/pem.h
---- crypto/pem/pem.h	Thu Jun 11 21:50:12 2015
-+++ crypto/pem/pem.h	Fri Jun 12 10:58:18 2015
+--- crypto/pem/pem.h	Thu Jan 28 21:56:08 2016
++++ crypto/pem/pem.h	Wed Feb 17 15:56:26 2016
 @@ -324,6 +324,7 @@
  
  #  define DECLARE_PEM_read_fp(name, type) /**/
@@ -73,8 +73,8 @@ diff U3 crypto/pem/pem.h crypto/pem/pem.h
  # else
  
 diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
---- crypto/pkcs7/pk7_smime.c	Thu Jun 11 21:01:06 2015
-+++ crypto/pkcs7/pk7_smime.c	Fri Jun 12 11:23:38 2015
+--- crypto/pkcs7/pk7_smime.c	Thu Jan 28 21:56:08 2016
++++ crypto/pkcs7/pk7_smime.c	Wed Feb 17 16:22:45 2016
 @@ -254,7 +254,8 @@
      STACK_OF(PKCS7_SIGNER_INFO) *sinfos;
      PKCS7_SIGNER_INFO *si;
@@ -114,20 +114,19 @@ diff U3 crypto/pkcs7/pk7_smime.c crypto/pkcs7/pk7_smime.c
          if (i <= 0)
              break;
          if (tmpout)
-@@ -394,6 +394,10 @@
+@@ -394,6 +394,9 @@
      }
      BIO_free_all(p7bio);
      sk_X509_free(signers);
-+
 +    if (buf != NULL) {
-+      OPENSSL_free(buf);
++        OPENSSL_free(buf);
 +    }
      return ret;
  }
  
 diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
---- crypto/rand/rand_unix.c	Thu Jun 11 21:01:06 2015
-+++ crypto/rand/rand_unix.c	Fri Jun 12 10:51:21 2015
+--- crypto/rand/rand_unix.c	Thu Jan 28 21:38:32 2016
++++ crypto/rand/rand_unix.c	Wed Feb 17 15:40:02 2016
 @@ -116,7 +116,7 @@
  #include <openssl/rand.h>
  #include "rand_lcl.h"
@@ -147,8 +146,8 @@ diff U3 crypto/rand/rand_unix.c crypto/rand/rand_unix.c
  {
      return 0;
 diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
---- crypto/rsa/rsa_ameth.c	Thu Jun 11 21:50:12 2015
-+++ crypto/rsa/rsa_ameth.c	Fri Jun 12 10:45:38 2015
+--- crypto/rsa/rsa_ameth.c	Thu Jan 28 21:56:08 2016
++++ crypto/rsa/rsa_ameth.c	Wed Feb 17 15:09:46 2016
 @@ -68,10 +68,12 @@
  #endif
  #include "asn1_locl.h"
@@ -221,8 +220,8 @@ diff U3 crypto/rsa/rsa_ameth.c crypto/rsa/rsa_ameth.c
  const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[] = {
      {
 diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
---- crypto/x509/x509_vfy.c	Thu Jun 11 21:52:58 2015
-+++ crypto/x509/x509_vfy.c	Fri Jun 12 11:29:37 2015
+--- crypto/x509/x509_vfy.c	Thu Jan 28 21:56:08 2016
++++ crypto/x509/x509_vfy.c	Wed Feb 17 16:09:58 2016
 @@ -940,6 +940,8 @@
          ctx->current_crl = crl;
      if (ctx->param->flags & X509_V_FLAG_USE_CHECK_TIME)
@@ -242,8 +241,8 @@ diff U3 crypto/x509/x509_vfy.c crypto/x509/x509_vfy.c
          ptime = NULL;
  
 diff U3 crypto/x509/x509_vfy.h crypto/x509/x509_vfy.h
---- crypto/x509/x509_vfy.h	Thu Jul 09 19:57:16 2015
-+++ crypto/x509/x509_vfy.h	Thu Oct 29 14:05:57 2015
+--- crypto/x509/x509_vfy.h	Thu Jan 28 21:56:08 2016
++++ crypto/x509/x509_vfy.h	Wed Feb 17 16:08:18 2016
 @@ -438,6 +438,8 @@
   * will force the behaviour to match that of previous versions.
   */
@@ -254,8 +253,8 @@ diff U3 crypto/x509/x509_vfy.h crypto/x509/x509_vfy.h
  # define X509_VP_FLAG_DEFAULT                    0x1
  # define X509_VP_FLAG_OVERWRITE                  0x2
 diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
---- crypto/x509v3/ext_dat.h	Thu Jun 11 21:50:12 2015
-+++ crypto/x509v3/ext_dat.h	Fri Jun 12 11:11:03 2015
+--- crypto/x509v3/ext_dat.h	Thu Jan 28 21:56:08 2016
++++ crypto/x509v3/ext_dat.h	Wed Feb 17 16:13:30 2016
 @@ -127,8 +127,10 @@
      &v3_idp,
      &v3_alt[2],
@@ -268,8 +267,8 @@ diff U3 crypto/x509v3/ext_dat.h crypto/x509v3/ext_dat.h
  
  /* Number of standard extensions */
 diff U3 crypto/crypto.h crypto/crypto.h
---- crypto/crypto.h	Thu Jun 11 21:01:06 2015
-+++ crypto/crypto.h	Fri Jun 12 11:33:27 2015
+--- crypto/crypto.h	Thu Jan 28 21:38:30 2016
++++ crypto/crypto.h	Wed Feb 17 16:33:00 2016
 @@ -235,15 +235,15 @@
  # ifndef OPENSSL_NO_LOCKING
  #  ifndef CRYPTO_w_lock
@@ -353,8 +352,8 @@ diff U3 crypto/crypto.h crypto/crypto.h
  
  # else
 diff U3 crypto/opensslconf.h crypto/opensslconf.h
---- crypto/opensslconf.h	Thu Jun 11 21:55:38 2015
-+++ crypto/opensslconf.h	Fri Jun 12 10:28:27 2015
+--- crypto/opensslconf.h	Thu Jan 28 21:57:22 2016
++++ crypto/opensslconf.h	Wed Feb 17 14:58:26 2016
 @@ -5,15 +5,72 @@
  extern "C" {
  #endif
@@ -675,8 +674,8 @@ diff U3 crypto/opensslconf.h crypto/opensslconf.h
  #undef BN_LLONG
  
 diff U3 e_os.h e_os.h
---- e_os.h	Thu Jul 09 19:57:16 2015
-+++ e_os.h	Thu Oct 29 16:54:10 2015
+--- e_os.h	Thu Jan 28 21:56:08 2016
++++ e_os.h	Wed Feb 17 15:52:08 2016
 @@ -136,7 +136,7 @@
  #  define MSDOS
  # endif
@@ -687,8 +686,8 @@ diff U3 e_os.h e_os.h
  # endif
  
 diff U3 e_os2.h e_os2.h
---- e_os2.h	Thu Jul 09 19:57:16 2015
-+++ e_os2.h	Thu Oct 29 15:08:19 2015
+--- e_os2.h	Thu Jan 28 21:56:08 2016
++++ e_os2.h	Wed Feb 17 15:53:08 2016
 @@ -97,7 +97,14 @@
   * For 32 bit environment, there seems to be the CygWin environment and then
   * all the others that try to do the same thing Microsoft does...
diff --git a/CryptoPkg/Library/OpensslLib/Install.cmd b/CryptoPkg/Library/OpensslLib/Install.cmd
index b9b6fc6f7094..a96501cafc71 100755
--- a/CryptoPkg/Library/OpensslLib/Install.cmd
+++ b/CryptoPkg/Library/OpensslLib/Install.cmd
@@ -1,4 +1,4 @@
-cd openssl-1.0.2e
+cd openssl-1.0.2f
 copy e_os2.h                    ..\..\..\Include\openssl
 copy crypto\crypto.h            ..\..\..\Include\openssl
 copy crypto\opensslv.h          ..\..\..\Include\openssl
diff --git a/CryptoPkg/Library/OpensslLib/Install.sh b/CryptoPkg/Library/OpensslLib/Install.sh
index 543439529448..76648cd5a34c 100755
--- a/CryptoPkg/Library/OpensslLib/Install.sh
+++ b/CryptoPkg/Library/OpensslLib/Install.sh
@@ -1,6 +1,6 @@
 #!/bin/sh
 
-cd openssl-1.0.2e
+cd openssl-1.0.2f
 cp e_os2.h                    ../../../Include/openssl
 cp crypto/crypto.h            ../../../Include/openssl
 cp crypto/opensslv.h          ../../../Include/openssl
diff --git a/CryptoPkg/Library/OpensslLib/OpensslLib.inf b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
index 54ac055a43ca..9b6e860337a5 100644
--- a/CryptoPkg/Library/OpensslLib/OpensslLib.inf
+++ b/CryptoPkg/Library/OpensslLib/OpensslLib.inf
@@ -1,7 +1,7 @@
 ## @file
 #  This module provides openSSL Library implementation.
 #
-#  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved.<BR>
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
 #  which accompanies this distribution.  The full text of the license may be found at
@@ -20,7 +20,7 @@
   MODULE_TYPE                    = BASE
   VERSION_STRING                 = 1.0
   LIBRARY_CLASS                  = OpensslLib
-  DEFINE OPENSSL_PATH            = openssl-1.0.2e
+  DEFINE OPENSSL_PATH            = openssl-1.0.2f
   DEFINE OPENSSL_FLAGS           = -DL_ENDIAN -DOPENSSL_SMALL_FOOTPRINT -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE
 
 #
diff --git a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
index f575d7147bdf..433f626c65d6 100644
--- a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
+++ b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
@@ -17,36 +17,36 @@ cryptography. This patch will enable openssl building under UEFI environment.
 ================================================================================
                                 OpenSSL-Version
 ================================================================================
-  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2e.
-    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
+  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2f.
+    http://www.openssl.org/source/openssl-1.0.2f.tar.gz
 
 
 ================================================================================
                       HOW to Install Openssl for UEFI Building
 ================================================================================
-1.  Download OpenSSL 1.0.2e from official website:
-    http://www.openssl.org/source/openssl-1.0.2e.tar.gz
+1.  Download OpenSSL 1.0.2f from official website:
+    http://www.openssl.org/source/openssl-1.0.2f.tar.gz
 
-    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2e.tar.tar.
-          When you do the download, rename the "openssl-1.0.2e.tar.tar" to
-          "openssl-1.0.2e.tar.gz" or rename the local downloaded file with ".tar.tar"
+    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2f.tar.tar.
+          When you do the download, rename the "openssl-1.0.2f.tar.tar" to
+          "openssl-1.0.2f.tar.gz" or rename the local downloaded file with ".tar.tar"
           extension to ".tar.gz".
 
-2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2e
+2.  Extract TAR into CryptoPkg/Library/OpenSslLib/openssl-1.0.2f
 
     NOTE: If you use WinZip to unpack the openssl source in Windows, please
           uncheck the WinZip smart CR/LF conversion option (WINZIP: Options -->
           Configuration --> Miscellaneous --> "TAR file smart CR/LF conversion").
 
-3.  Apply this patch: EDKII_openssl-1.0.2e.patch, and make installation
+3.  Apply this patch: EDKII_openssl-1.0.2f.patch, and make installation
 
     For Windows Environment:
     ------------------------
     1) Make sure the patch utility has been installed in your machine.
        Install Cygwin or get the patch utility binary from
           http://gnuwin32.sourceforge.net/packages/patch.htm
-    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2e
-    3) patch -p0 -i ..\EDKII_openssl-1.0.2e.patch
+    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2f
+    3) patch -p0 -i ..\EDKII_openssl-1.0.2f.patch
     4) cd ..
     5) Install.cmd
 
@@ -54,8 +54,8 @@ cryptography. This patch will enable openssl building under UEFI environment.
     -----------------------
     1) Make sure the patch utility has been installed in your machine.
        Patch utility is available from http://directory.fsf.org/project/patch/
-    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2e
-    3) patch -p0 -i ../EDKII_openssl-1.0.2e.patch
+    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2f
+    3) patch -p0 -i ../EDKII_openssl-1.0.2f.patch
     4) cd ..
     5) ./Install.sh
 

From fdf0b891433999f308a256d035c3091e1b120393 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 9 Oct 2015 07:04:00 +0000
Subject: [PATCH 469/525] UefiCpuPkg: Add ASSERT to handle local APIC not
 config properly

When the local APIC is not configurated properly, function
GetApicTimerInitCount() in LocalApicLib may return zero, which will lead
to a divide by zero exception in SecPeiDxeTimerLibUefiCpu.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18594 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit f17e2f8c9e1a34c3707f93ca373a79f14927f7b1)
---
 UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/X86TimerLib.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/X86TimerLib.c b/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/X86TimerLib.c
index 52ae7717ddf5..f703d7e47768 100644
--- a/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/X86TimerLib.c
+++ b/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/X86TimerLib.c
@@ -3,7 +3,7 @@
 
   This library uses the local APIC library so that it supports x2APIC mode.
   
-  Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -45,6 +45,9 @@ InternalX86GetTimerFrequency (
   Stalls the CPU for at least the given number of ticks. It's invoked by
   MicroSecondDelay() and NanoSecondDelay().
 
+  This function will ASSERT if the APIC timer intial count returned from
+  GetApicTimerInitCount() is zero.
+
   @param  Delay     A period of time to delay in ticks.
 
 **/
@@ -67,6 +70,7 @@ InternalX86Delay (
   // Delay and the Init Count.
   //
   InitCount = GetApicTimerInitCount ();
+  ASSERT (InitCount != 0);
   Times     = Delay / (InitCount / 2);
   Delay     = Delay % (InitCount / 2);
 

From 62435c267fa66b835bab6ec5db682d8a77fdc2bb Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 9 Oct 2015 07:04:26 +0000
Subject: [PATCH 470/525] UefiCpuPkg BaseXApic(X2)Lib: Add ASSERT if local APIC
 not software enabled

Add an ASSERT in GetApicTimerState() to check if the local APIC is
software enabled.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18595 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 6d72ff7d9daf7efae5243e9c00a281b350fc0f95)
---
 UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c        |  9 +++++++++
 .../Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c   | 11 ++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
index 7090cd4911ff..1fca66ef1b29 100644
--- a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.c
@@ -754,6 +754,8 @@ InitializeApicTimer (
 /**
   Get the state of the local APIC timer.
 
+  This function will ASSERT if the local APIC is not software enabled.
+
   @param DivideValue   Return the divide value for the DCR. It is one of 1,2,4,8,16,32,64,128.
   @param PeriodicMode  Return the timer mode. If TRUE, timer mode is peridoic. Othewise, timer mode is one-shot.
   @param Vector        Return the timer interrupt vector number.
@@ -770,6 +772,13 @@ GetApicTimerState (
   LOCAL_APIC_DCR Dcr;
   LOCAL_APIC_LVT_TIMER LvtTimer;
 
+  //
+  // Check the APIC Software Enable/Disable bit (bit 8) in Spurious-Interrupt
+  // Vector Register.
+  // This bit will be 1, if local APIC is software enabled.
+  //
+  ASSERT ((ReadLocalApicReg(XAPIC_SPURIOUS_VECTOR_OFFSET) & BIT8) != 0);
+
   if (DivideValue != NULL) {
     Dcr.Uint32 = ReadLocalApicReg (XAPIC_TIMER_DIVIDE_CONFIGURATION_OFFSET);
     Divisor = Dcr.Bits.DivideValue1 | (Dcr.Bits.DivideValue2 << 2);
diff --git a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
index bc3d0a57e246..38f5370cc3df 100644
--- a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
+++ b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.c
@@ -4,7 +4,7 @@
   This local APIC library instance supports x2APIC capable processors
   which have xAPIC and x2APIC modes.
 
-  Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -849,6 +849,8 @@ InitializeApicTimer (
 /**
   Get the state of the local APIC timer.
 
+  This function will ASSERT if the local APIC is not software enabled.
+
   @param DivideValue   Return the divide value for the DCR. It is one of 1,2,4,8,16,32,64,128.
   @param PeriodicMode  Return the timer mode. If TRUE, timer mode is peridoic. Othewise, timer mode is one-shot.
   @param Vector        Return the timer interrupt vector number.
@@ -865,6 +867,13 @@ GetApicTimerState (
   LOCAL_APIC_DCR Dcr;
   LOCAL_APIC_LVT_TIMER LvtTimer;
 
+  //
+  // Check the APIC Software Enable/Disable bit (bit 8) in Spurious-Interrupt
+  // Vector Register.
+  // This bit will be 1, if local APIC is software enabled.
+  //
+  ASSERT ((ReadLocalApicReg(XAPIC_SPURIOUS_VECTOR_OFFSET) & BIT8) != 0);
+
   if (DivideValue != NULL) {
     Dcr.Uint32 = ReadLocalApicReg (XAPIC_TIMER_DIVIDE_CONFIGURATION_OFFSET);
     Divisor = Dcr.Bits.DivideValue1 | (Dcr.Bits.DivideValue2 << 2);

From a60eecec64175466fc6d22d8bc504eabff113363 Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Fri, 20 Nov 2015 08:22:46 +0000
Subject: [PATCH 471/525] UefiCpuPkg/CpuDxe: Don't use gBS->Stall

The CpuDxe driver may run before the gEfiMetronomeArchProtocolGuid
protocol is installed. gBS->Stall does not work until this arch
protocol is installed.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18914 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit f73dd6f5bb31aed6097bcb4991fc04b542fc3911)
---
 UefiCpuPkg/CpuDxe/CpuMp.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/UefiCpuPkg/CpuDxe/CpuMp.c b/UefiCpuPkg/CpuDxe/CpuMp.c
index 04c2f1f0ac12..98fdfdf5e0e7 100644
--- a/UefiCpuPkg/CpuDxe/CpuMp.c
+++ b/UefiCpuPkg/CpuDxe/CpuMp.c
@@ -801,7 +801,7 @@ StartupAllAPs (
       goto Done;
     }
 
-    gBS->Stall (gPollInterval);
+    MicroSecondDelay (gPollInterval);
     mMpSystemData.Timeout -= gPollInterval;
   }
 
@@ -987,7 +987,7 @@ StartupThisAP (
       return EFI_TIMEOUT;
     }
 
-    gBS->Stall (gPollInterval);
+    MicroSecondDelay (gPollInterval);
     CpuData->Timeout -= gPollInterval;
   }
 
@@ -1755,7 +1755,7 @@ InitializeMpSupport (
     if (CheckAllAPsSleeping ()) {
       break;
     }
-    gBS->Stall (gPollInterval);
+    MicroSecondDelay (gPollInterval);
     Timeout += gPollInterval;
   } while (Timeout <= PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));
   ASSERT (Timeout <= PcdGet32 (PcdCpuApInitTimeOutInMicroSeconds));

From b05b1615418f324f9eb80896268a9a293df2980d Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 04:01:00 +0000
Subject: [PATCH 472/525] Correct TSS segment.

TSS segment should use (SIZE - 1) as limit, and do not set G bit (highest bit of LimitHigh) because limit means byte count.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Fan, Jeff" <jeff.fan@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18935 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 20ab326972339d16d7e95d94f9d7710cae1ae75f)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S   | 8 ++++----
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm | 8 ++++----
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S    | 4 ++--
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm  | 4 ++--
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
index 69dfd946de48..4130bf5be5eb 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.S
@@ -82,18 +82,18 @@ CodeSeg64:
 .equ  GDT_SIZE, .- NullSeg
 
 TssSeg:
-            .word      TSS_DESC_SIZE       # LimitLow
+            .word      TSS_DESC_SIZE -1    # LimitLow
             .word      0                   # BaseLow
             .byte      0                   # BaseMid
             .byte      0x89
-            .byte      0x80                # LimitHigh
+            .byte      0x00                # LimitHigh
             .byte      0                   # BaseHigh
 ExceptionTssSeg:
-            .word      TSS_DESC_SIZE       # LimitLow
+            .word      TSS_DESC_SIZE - 1   # LimitLow
             .word      0                   # BaseLow
             .byte      0                   # BaseMid
             .byte      0x89
-            .byte      0x80                # LimitHigh
+            .byte      0x00                # LimitHigh
             .byte      0                   # BaseHigh
 
 .equ  CODE_SEL,          CodeSeg32 - NullSeg
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
index 65a120e1e78a..b4eb492da0c0 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiException.asm
@@ -85,18 +85,18 @@ CodeSeg64   LABEL   QWORD
 GDT_SIZE = $ - offset NullSeg
 
 TssSeg      LABEL   QWORD
-            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      TSS_DESC_SIZE - 1   ; LimitLow
             DW      0                   ; BaseLow
             DB      0                   ; BaseMid
             DB      89h
-            DB      080h                ; LimitHigh
+            DB      00h                 ; LimitHigh
             DB      0                   ; BaseHigh
 ExceptionTssSeg     LABEL   QWORD
-            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      TSS_DESC_SIZE - 1   ; LimitLow
             DW      0                   ; BaseLow
             DB      0                   ; BaseMid
             DB      89h
-            DB      080h                ; LimitHigh
+            DB      00h                 ; LimitHigh
             DB      0                   ; BaseHigh
 
 CODE_SEL          = offset CodeSeg32 - offset NullSeg
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
index 6dbcaa5b6714..2ae6f2c32f54 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.S
@@ -79,11 +79,11 @@ CodeSeg64:
             .byte 0                     # BaseHigh
 # TSS Segment for X64 specially
 TssSeg:
-            .word TSS_DESC_SIZE         # LimitLow
+            .word TSS_DESC_SIZE - 1     # LimitLow
             .word 0                     # BaseLow
             .byte 0                     # BaseMid
             .byte 0x89
-            .byte 0xDB                  # LimitHigh
+            .byte 0x00                  # LimitHigh
             .byte 0                     # BaseHigh
             .long 0                     # BaseUpper
             .long 0                     # Reserved
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
index 3d841c654676..ab716450b71a 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiException.asm
@@ -78,11 +78,11 @@ CodeSeg64   LABEL   QWORD
             DB      0                   ; BaseHigh
 ; TSS Segment for X64 specially
 TssSeg      LABEL   QWORD
-            DW      TSS_DESC_SIZE       ; LimitLow
+            DW      TSS_DESC_SIZE - 1   ; LimitLow
             DW      0                   ; BaseLow
             DB      0                   ; BaseMid
             DB      89h
-            DB      080h                ; LimitHigh
+            DB      00h                 ; LimitHigh
             DB      0                   ; BaseHigh
             DD      0                   ; BaseUpper
             DD      0                   ; Reserved

From f2a56d8bd97bb67b829e6546d155b4d71b19da20 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 04:23:01 +0000
Subject: [PATCH 473/525] Eliminate EFI_IMAGE_MACHINE_TYPE_SUPPORTED.

Move Gdt initialization from InitializeMpServiceData() to CPU Arch specific function.
We create SmmFuncsArch.c for hold CPU specific function, so that
EFI_IMAGE_MACHINE_TYPE_SUPPORTED(EFI_IMAGE_MACHINE_X64) can be removed.

For IA32 version, we always allocate new page for GDT entry, for easy maintenance.
For X64 version, we fixed TssBase in GDT entry to make sure TSS data is correct.
Remove TSS fixup for GDT in ASM file.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Fan, Jeff" <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18937 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit fe5f19494353421d3382f32f31a627e09724bbb2)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmFuncsArch.c | 96 +++++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c         | 83 +---------------
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h    | 15 +++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf  |  2 +
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S      |  8 --
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm    |  8 --
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmFuncsArch.c  | 70 ++++++++++++++
 7 files changed, 186 insertions(+), 96 deletions(-)
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmFuncsArch.c
 create mode 100644 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmFuncsArch.c

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmFuncsArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmFuncsArch.c
new file mode 100644
index 000000000000..545b534f2796
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmFuncsArch.c
@@ -0,0 +1,96 @@
+/** @file
+  SMM CPU misc functions for Ia32 arch specific.
+  
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+/**
+  Initialize Gdt for all processors.
+  
+  @param[in]   Cr3          CR3 value.
+  @param[out]  GdtStepSize  The step size for GDT table.
+
+  @return GdtBase for processor 0.
+          GdtBase for processor X is: GdtBase + (GdtStepSize * X)
+**/
+VOID *
+InitGdt (
+  IN  UINTN  Cr3,
+  OUT UINTN  *GdtStepSize
+  )
+{
+  UINTN                     Index;
+  IA32_SEGMENT_DESCRIPTOR   *GdtDescriptor;
+  UINTN                     TssBase;
+  UINTN                     GdtTssTableSize;
+  UINT8                     *GdtTssTables;
+  UINTN                     GdtTableStepSize;
+
+  if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+    //
+    // For IA32 SMM, if SMM Stack Guard feature is enabled, we use 2 TSS.
+    // in this case, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
+    // on each SMI entry.
+    //
+
+    //
+    // Enlarge GDT to contain 2 TSS descriptors
+    //
+    gcSmiGdtr.Limit += (UINT16)(2 * sizeof (IA32_SEGMENT_DESCRIPTOR));
+
+    GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE * 2 + 7) & ~7; // 8 bytes aligned
+    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
+    ASSERT (GdtTssTables != NULL);
+    GdtTableStepSize = GdtTssTableSize;
+
+    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
+      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE * 2);
+      //
+      // Fixup TSS descriptors
+      //
+      TssBase = (UINTN)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1);
+      GdtDescriptor = (IA32_SEGMENT_DESCRIPTOR *)(TssBase) - 2;
+      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
+      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
+      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
+
+      TssBase += TSS_SIZE;
+      GdtDescriptor++;
+      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
+      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
+      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
+      //
+      // Fixup TSS segments
+      //
+      // ESP as known good stack
+      //
+      *(UINTN *)(TssBase + TSS_IA32_ESP_OFFSET) =  mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize;
+      *(UINT32 *)(TssBase + TSS_IA32_CR3_OFFSET) = Cr3;
+    }
+  } else {
+    //
+    // Just use original table, AllocatePage and copy them here to make sure GDTs are covered in page memory.
+    //
+    GdtTssTableSize = gcSmiGdtr.Limit + 1;
+    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
+    ASSERT (GdtTssTables != NULL);
+    GdtTableStepSize = GdtTssTableSize;
+
+    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
+      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1);
+    }
+  }
+
+  *GdtStepSize = GdtTableStepSize;
+  return GdtTssTables;
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 730c32df0a25..80378a3faf42 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -1163,10 +1163,7 @@ InitializeMpServiceData (
   UINTN                     Index;
   MTRR_SETTINGS             *Mtrr;
   PROCESSOR_SMM_DESCRIPTOR  *Psd;
-  UINTN                     GdtTssTableSize;
   UINT8                     *GdtTssTables;
-  IA32_SEGMENT_DESCRIPTOR   *GdtDescriptor;
-  UINTN                     TssBase;
   UINTN                     GdtTableStepSize;
 
   //
@@ -1182,71 +1179,7 @@ InitializeMpServiceData (
   //
   Cr3 = SmmInitPageTable ();
 
-  GdtTssTables    = NULL;
-  GdtTssTableSize = 0;
-  GdtTableStepSize = 0;
-  //
-  // For X64 SMM, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
-  // on each SMI entry.
-  //
-  if (EFI_IMAGE_MACHINE_TYPE_SUPPORTED(EFI_IMAGE_MACHINE_X64)) {
-    GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE + 7) & ~7; // 8 bytes aligned
-    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
-    ASSERT (GdtTssTables != NULL);
-    GdtTableStepSize = GdtTssTableSize;
-
-    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
-      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE);
-      if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
-        //
-        // Setup top of known good stack as IST1 for each processor.
-        //
-        *(UINTN *)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1 + TSS_X64_IST1_OFFSET) = (mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize);
-      }
-    }
-  } else if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
-
-    //
-    // For IA32 SMM, if SMM Stack Guard feature is enabled, we use 2 TSS.
-    // in this case, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
-    // on each SMI entry.
-    //
-
-    //
-    // Enlarge GDT to contain 2 TSS descriptors
-    //
-    gcSmiGdtr.Limit += (UINT16)(2 * sizeof (IA32_SEGMENT_DESCRIPTOR));
-
-    GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE * 2 + 7) & ~7; // 8 bytes aligned
-    GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
-    ASSERT (GdtTssTables != NULL);
-    GdtTableStepSize = GdtTssTableSize;
-
-    for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
-      CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE * 2);
-      //
-      // Fixup TSS descriptors
-      //
-      TssBase = (UINTN)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1);
-      GdtDescriptor = (IA32_SEGMENT_DESCRIPTOR *)(TssBase) - 2;
-      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
-      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
-      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
-
-      TssBase += TSS_SIZE;
-      GdtDescriptor++;
-      GdtDescriptor->Bits.BaseLow = (UINT16)TssBase;
-      GdtDescriptor->Bits.BaseMid = (UINT8)(TssBase >> 16);
-      GdtDescriptor->Bits.BaseHigh = (UINT8)(TssBase >> 24);
-      //
-      // Fixup TSS segments
-      //
-      // ESP as known good stack
-      //
-      *(UINTN *)(TssBase + TSS_IA32_ESP_OFFSET) =  mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize;
-      *(UINT32 *)(TssBase + TSS_IA32_CR3_OFFSET) = Cr3;
-    }
-  }
+  GdtTssTables = InitGdt (Cr3, &GdtTableStepSize);
 
   //
   // Initialize PROCESSOR_SMM_DESCRIPTOR for each CPU
@@ -1254,18 +1187,8 @@ InitializeMpServiceData (
   for (Index = 0; Index < mMaxNumberOfCpus; Index++) {
     Psd = (PROCESSOR_SMM_DESCRIPTOR *)(VOID *)(UINTN)(mCpuHotPlugData.SmBase[Index] + SMM_PSD_OFFSET);
     CopyMem (Psd, &gcPsd, sizeof (gcPsd));
-    if (EFI_IMAGE_MACHINE_TYPE_SUPPORTED (EFI_IMAGE_MACHINE_X64)) {
-      //
-      // For X64 SMM, set GDT to the copy allocated above.
-      //
-      Psd->SmmGdtPtr = (UINT64)(UINTN)(GdtTssTables + GdtTableStepSize * Index);
-    } else if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
-      //
-      // For IA32 SMM, if SMM Stack Guard feature is enabled, set GDT to the copy allocated above.
-      //
-      Psd->SmmGdtPtr = (UINT64)(UINTN)(GdtTssTables + GdtTableStepSize * Index);
-      Psd->SmmGdtSize = gcSmiGdtr.Limit + 1;
-    }
+    Psd->SmmGdtPtr = (UINT64)(UINTN)(GdtTssTables + GdtTableStepSize * Index);
+    Psd->SmmGdtSize = gcSmiGdtr.Limit + 1;
 
     //
     // Install SMI handler
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index cfbf2ca6dae3..106e67465c0a 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -427,6 +427,21 @@ InitializeIDTSmmStackGuard (
   VOID
   );
 
+/**
+  Initialize Gdt for all processors.
+  
+  @param[in]   Cr3          CR3 value.
+  @param[out]  GdtStepSize  The step size for GDT table.
+
+  @return GdtBase for processor 0.
+          GdtBase for processor X is: GdtBase + (GdtStepSize * X)
+**/
+VOID *
+InitGdt (
+  IN  UINTN  Cr3,
+  OUT UINTN  *GdtStepSize
+  );
+
 /**
 
   Register the SMM Foundation entry point.
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
index a293a88e9914..122318f02e68 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.inf
@@ -48,6 +48,7 @@
 [Sources.Ia32]
   Ia32/Semaphore.c
   Ia32/PageTbl.c
+  Ia32/SmmFuncsArch.c
   Ia32/SmmProfileArch.c
   Ia32/SmmProfileArch.h
   Ia32/SmmInit.asm      | MSFT
@@ -68,6 +69,7 @@
 [Sources.X64]
   X64/Semaphore.c
   X64/PageTbl.c
+  X64/SmmFuncsArch.c
   X64/SmmProfileArch.c
   X64/SmmProfileArch.h
   X64/SmmInit.asm      | MSFT
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
index 831559357f15..95e6dfa814f7 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
@@ -128,14 +128,6 @@ ASM_PFX(gSmiCr3):    .space  4
     sgdt    (%rsp)
     movl    2(%rsp), %eax               # eax = GDT base
     addl    $8, %esp
-    movl    %eax, %edx
-    addl    $GDT_SIZE, %edx
-    movb    %dl, (TSS_SEGMENT + 2)(%rax)
-    movb    %dh, (TSS_SEGMENT + 3)(%rax)
-    .byte   0xc1, 0xea, 0x10             # shr     edx, 16
-    movb    %dl, (TSS_SEGMENT + 4)(%rax)
-    movb    %dh, (TSS_SEGMENT + 7)(%rax)
-    movl    %eax, %edx
     movb    $0x89, %dl
     movb    %dl, (TSS_SEGMENT + 5)(%rax) # clear busy flag
     movl    $TSS_SEGMENT, %eax
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
index c556bf5f5b28..4d53db5b00da 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
@@ -124,14 +124,6 @@ gSmiCr3     DD      ?
     sgdt    fword ptr [rsp]
     mov     eax, [rsp + 2]              ; eax = GDT base
     add     esp, 8
-    mov     edx, eax
-    add     edx, GDT_SIZE
-    mov     [rax + TSS_SEGMENT + 2], dl
-    mov     [rax + TSS_SEGMENT + 3], dh
-    DB      0c1h, 0eah, 10h             ; shr     edx, 16
-    mov     [rax + TSS_SEGMENT + 4], dl
-    mov     [rax + TSS_SEGMENT + 7], dh
-    mov     edx, eax
     mov     dl, 89h
     mov     [rax + TSS_SEGMENT + 5], dl ; clear busy flag
     mov     eax, TSS_SEGMENT
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmFuncsArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmFuncsArch.c
new file mode 100644
index 000000000000..b53aa45c2149
--- /dev/null
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmFuncsArch.c
@@ -0,0 +1,70 @@
+/** @file
+  SMM CPU misc functions for x64 arch specific.
+  
+Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include "PiSmmCpuDxeSmm.h"
+
+/**
+  Initialize Gdt for all processors.
+  
+  @param[in]   Cr3          CR3 value.
+  @param[out]  GdtStepSize  The step size for GDT table.
+
+  @return GdtBase for processor 0.
+          GdtBase for processor X is: GdtBase + (GdtStepSize * X)
+**/
+VOID *
+InitGdt (
+  IN  UINTN  Cr3,
+  OUT UINTN  *GdtStepSize
+  )
+{
+  UINTN                     Index;
+  IA32_SEGMENT_DESCRIPTOR   *GdtDescriptor;
+  UINTN                     TssBase;
+  UINTN                     GdtTssTableSize;
+  UINT8                     *GdtTssTables;
+  UINTN                     GdtTableStepSize;
+
+  //
+  // For X64 SMM, we allocate separate GDT/TSS for each CPUs to avoid TSS load contention
+  // on each SMI entry.
+  //
+  GdtTssTableSize = (gcSmiGdtr.Limit + 1 + TSS_SIZE + 7) & ~7; // 8 bytes aligned
+  GdtTssTables = (UINT8*)AllocatePages (EFI_SIZE_TO_PAGES (GdtTssTableSize * gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus));
+  ASSERT (GdtTssTables != NULL);
+  GdtTableStepSize = GdtTssTableSize;
+
+  for (Index = 0; Index < gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus; Index++) {
+    CopyMem (GdtTssTables + GdtTableStepSize * Index, (VOID*)(UINTN)gcSmiGdtr.Base, gcSmiGdtr.Limit + 1 + TSS_SIZE);
+
+    //
+    // Fixup TSS descriptors
+    //
+    TssBase = (UINTN)(GdtTssTables + GdtTableStepSize * Index + gcSmiGdtr.Limit + 1);
+    GdtDescriptor = (IA32_SEGMENT_DESCRIPTOR *)(TssBase) - 2;
+    GdtDescriptor->Bits.BaseLow = (UINT16)(UINTN)TssBase;
+    GdtDescriptor->Bits.BaseMid = (UINT8)((UINTN)TssBase >> 16);
+    GdtDescriptor->Bits.BaseHigh = (UINT8)((UINTN)TssBase >> 24);
+
+    if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
+      //
+      // Setup top of known good stack as IST1 for each processor.
+      //
+      *(UINTN *)(TssBase + TSS_X64_IST1_OFFSET) = (mSmmStackArrayBase + EFI_PAGE_SIZE + Index * mSmmStackSize);
+    }
+  }
+
+  *GdtStepSize = GdtTableStepSize;
+  return GdtTssTables;
+}

From e1ac59f7ddaaf076eee592bceb5ef7adb56de12a Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 04:28:46 +0000
Subject: [PATCH 474/525] Move RestoreSmmConfigurationInS3 function to
 PerformPreTasks().

In this way, we can centralize the silicon configuration in
PerformRemainingTasks()/PerformPreTasks() function.
If there are more features need to be configured, they can put in
PerformRemainingTasks()/PerformPreTasks() only.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>
Reviewed-by: "Laszlo Ersek" <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18938 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 9f419739d1ae849e0c4d75a131502f9367ca4a7d)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c      | 10 ++--------
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 22 ++++++++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h |  9 +++++++++
 3 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 80378a3faf42..3e8b0936aa84 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -412,15 +412,9 @@ BSPHandler (
   AcquireSpinLockOrFail (&mSmmMpSyncData->CpuData[CpuIndex].Busy);
 
   //
-  // Restore SMM Configuration in S3 boot path.
+  // Perform the pre tasks
   //
-  if (mRestoreSmmConfigurationInS3) {
-    //
-    // Configure SMM Code Access Check feature if available.
-    //
-    ConfigSmmCodeAccessCheck ();
-    mRestoreSmmConfigurationInS3 = FALSE;
-  }
+  PerformPreTasks ();
 
   //
   // Invoke SMM Foundation EntryPoint with the processor information context.
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index 684dbd701d6c..f4ed39f95973 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -1442,3 +1442,25 @@ PerformRemainingTasks (
     mSmmReadyToLock = FALSE;
   }
 }
+
+/**
+  Perform the pre tasks.
+
+**/
+VOID
+PerformPreTasks (
+  VOID
+  )
+{
+  //
+  // Restore SMM Configuration in S3 boot path.
+  //
+  if (mRestoreSmmConfigurationInS3) {
+    //
+    // Configure SMM Code Access Check feature if available.
+    //
+    ConfigSmmCodeAccessCheck ();
+
+    mRestoreSmmConfigurationInS3 = FALSE;
+  }
+}
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index 106e67465c0a..66d85d80e126 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -586,6 +586,15 @@ PerformRemainingTasks (
   VOID
   );
 
+/**
+  Perform the pre tasks.
+
+**/
+VOID
+PerformPreTasks (
+  VOID
+  );
+
 /**
   Initialize MSR spin lock by MSR index.
 

From ca119e707e0f0b896de01eca4b53f8a0f559571b Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Wed, 25 Nov 2015 08:51:15 +0000
Subject: [PATCH 475/525] Move SmmDebug feature from ASM to C.

SmmDebug feature is implemented in ASM, which is not easy to maintain.
So we move it to C function.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18946 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit f45f2d4ad4d803eb33c608bca8242992f1841fec)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S   | 44 ++++-----------
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm | 48 ++++++-----------
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c       | 59 +++++++++++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S    | 39 +++++---------
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm  | 47 ++++++----------
 5 files changed, 114 insertions(+), 123 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
index 6fcf41a677d6..fbaa0725f0bc 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
@@ -24,7 +24,6 @@ ASM_GLOBAL  ASM_PFX(gcSmiHandlerSize)
 ASM_GLOBAL  ASM_PFX(gSmiCr3)
 ASM_GLOBAL  ASM_PFX(gSmiStack)
 ASM_GLOBAL  ASM_PFX(gSmbase)
-ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
 ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmStackGuard))
 ASM_GLOBAL  ASM_PFX(gSmiHandlerIdtr)
 
@@ -148,43 +147,22 @@ L5:
 #   jmp     _SmiHandler                 # instruction is not needed
 
 _SmiHandler:
-    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
-    jz      L3
-
-L6:
-    call    L1
-L1:
-    popl    %ebp
-    movl    $0x80000001, %eax
-    cpuid
-    btl     $29, %edx                   # check cpuid to identify X64 or IA32
-    leal    (0x7fc8 - (L1 - _SmiEntryPoint))(%ebp), %edi
-    leal    4(%edi), %esi
-    jnc     L2
-    addl    $4, %esi
-L2:
-    movl    (%esi), %ecx
-    movl    (%edi), %edx
-L7:
-    movl    %ecx, %dr6
-    movl    %edx, %dr7                  # restore DR6 & DR7 before running C code
-L3:
-
-    pushl   (%esp)
+    movl    (%esp), %ebx
 
+    pushl   %ebx
+    movl    $ASM_PFX(CpuSmmDebugEntry), %eax
+    call    *%eax
+    popl    %ecx
+    
+    pushl   %ebx
     movl    $ASM_PFX(SmiRendezvous), %eax
     call    *%eax
     popl    %ecx
 
-
-    cmpb    $0, ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
-    jz      L4
-
-    movl    %dr6, %ecx
-    movl    %dr7, %edx
-    movl    %ecx, (%esi)
-    movl    %edx, (%edi)
-L4:
+    pushl   %ebx
+    movl    $ASM_PFX(CpuSmmDebugExit), %eax
+    call    *%eax
+    popl    %ecx
 
     rsm
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
index b628fe8bd88c..8a12927300ca 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
@@ -34,14 +34,15 @@ PROTECT_MODE_CS EQU   08h
 PROTECT_MODE_DS EQU   20h
 TSS_SEGMENT     EQU   40h
 
-SmiRendezvous   PROTO   C
+SmiRendezvous      PROTO   C
+CpuSmmDebugEntry   PROTO   C
+CpuSmmDebugExit    PROTO   C
 
 EXTERNDEF   gcSmiHandlerTemplate:BYTE
 EXTERNDEF   gcSmiHandlerSize:WORD
 EXTERNDEF   gSmiCr3:DWORD
 EXTERNDEF   gSmiStack:DWORD
 EXTERNDEF   gSmbase:DWORD
-EXTERNDEF   FeaturePcdGet (PcdCpuSmmDebug):BYTE
 EXTERNDEF   FeaturePcdGet (PcdCpuSmmStackGuard):BYTE
 EXTERNDEF   gSmiHandlerIdtr:FWORD
 
@@ -151,40 +152,23 @@ gSmiCr3     DD      ?
 ;   jmp     _SmiHandler                 ; instruction is not needed
 
 _SmiHandler PROC
-    cmp     FeaturePcdGet (PcdCpuSmmDebug), 0
-    jz      @3
-    call    @1
-@1:
-    pop     ebp
-    mov     eax, 80000001h
-    cpuid
-    bt      edx, 29                     ; check cpuid to identify X64 or IA32
-    lea     edi, [ebp - (@1 - _SmiEntryPoint) + 7fc8h]
-    lea     esi, [edi + 4]
-    jnc     @2
-    add     esi, 4
-@2:
-    mov     ecx, [esi]
-    mov     edx, [edi]
-@5:
-    mov     dr6, ecx
-    mov     dr7, edx                    ; restore DR6 & DR7 before running C code
-@3:
-    mov     ecx, [esp]                  ; CPU Index
-
-    push    ecx
-    mov     eax, SmiRendezvous
+    mov     ebx, [esp]                  ; CPU Index
+
+    push    ebx
+    mov     eax, CpuSmmDebugEntry
     call    eax
     pop     ecx
 
-    cmp     FeaturePcdGet (PcdCpuSmmDebug), 0
-    jz      @4
+    push    ebx
+    mov     eax, SmiRendezvous
+    call    eax
+    pop     ecx
+    
+    push    ebx
+    mov     eax, CpuSmmDebugExit
+    call    eax
+    pop     ecx
 
-    mov     ecx, dr6
-    mov     edx, dr7
-    mov     [esi], ecx
-    mov     [edi], edx
-@4:
     rsm
 _SmiHandler ENDP
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 3e8b0936aa84..83f5bf962d57 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -940,6 +940,65 @@ SmmStartupThisAp (
   return EFI_SUCCESS;
 }
 
+/**
+  This funciton sets DR6 & DR7 according to SMM save state, before running SMM C code.
+  They are useful when you want to enable hardware breakpoints in SMM without entry SMM mode.
+
+  NOTE: It might not be appreciated in runtime since it might
+        conflict with OS debugging facilities. Turn them off in RELEASE.
+
+  @param    CpuIndex              CPU Index
+
+**/
+VOID
+EFIAPI
+CpuSmmDebugEntry (
+  IN UINTN  CpuIndex
+  )
+{
+  SMRAM_SAVE_STATE_MAP *CpuSaveState;
+  
+  if (FeaturePcdGet (PcdCpuSmmDebug)) {
+    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmst->CpuSaveState[CpuIndex];
+    if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
+      AsmWriteDr6 (CpuSaveState->x86._DR6);
+      AsmWriteDr7 (CpuSaveState->x86._DR7);
+    } else {
+      AsmWriteDr6 ((UINTN)CpuSaveState->x64._DR6);
+      AsmWriteDr7 ((UINTN)CpuSaveState->x64._DR7);
+    }
+  }
+}
+
+/**
+  This funciton restores DR6 & DR7 to SMM save state.
+
+  NOTE: It might not be appreciated in runtime since it might
+        conflict with OS debugging facilities. Turn them off in RELEASE.
+
+  @param    CpuIndex              CPU Index
+
+**/
+VOID
+EFIAPI
+CpuSmmDebugExit (
+  IN UINTN  CpuIndex
+  )
+{
+  SMRAM_SAVE_STATE_MAP *CpuSaveState;
+
+  if (FeaturePcdGet (PcdCpuSmmDebug)) {
+    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmst->CpuSaveState[CpuIndex];
+    if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
+      CpuSaveState->x86._DR7 = (UINT32)AsmReadDr7 ();
+      CpuSaveState->x86._DR6 = (UINT32)AsmReadDr6 ();
+    } else {
+      CpuSaveState->x64._DR7 = AsmReadDr7 ();
+      CpuSaveState->x64._DR6 = AsmReadDr6 ();
+    }
+  }
+}
+
 /**
   C function for SMI entry, each processor comes here upon SMI trigger.
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
index 95e6dfa814f7..b488b74b7075 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
@@ -24,7 +24,6 @@ ASM_GLOBAL  ASM_PFX(gcSmiHandlerSize)
 ASM_GLOBAL  ASM_PFX(gSmiCr3)
 ASM_GLOBAL  ASM_PFX(gSmiStack)
 ASM_GLOBAL  ASM_PFX(gSmbase)
-ASM_GLOBAL  ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug))
 ASM_GLOBAL  ASM_PFX(gSmiHandlerIdtr)
 
 #
@@ -163,20 +162,7 @@ LongMode:                               # long mode (64-bit code) starts here
 #   jmp     _SmiHandler                 ; instruction is not needed
 
 _SmiHandler:
-    movabsq $ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug)), %rax
-    cmpb    $0, (%rax)
-    jz      L1
-
-    .byte   0x48, 0x8b, 0x0d            # mov rcx, [rip + disp32]
-    .long   SSM_DR6 - (. + 4 - _SmiEntryPoint + 0x8000)
-    .byte   0x48, 0x8b, 0x15            # mov rdx, [rip + disp32]
-    .long   SSM_DR7 - (. + 4 - _SmiEntryPoint + 0x8000)
-    movq    %rcx, %dr6
-    movq    %rdx, %dr7
-L1:
-
-    movabsq $ASM_PFX(SmiRendezvous), %rax
-    movq    (%rsp), %rcx
+    movq    (%rsp), %rbx
     # Save FP registers
 
     subq    $0x208, %rsp
@@ -184,7 +170,19 @@ L1:
     fxsave  (%rsp)
 
     addq    $-0x20, %rsp
+
+    movq    %rbx, %rcx
+    movabsq $ASM_PFX(CpuSmmDebugEntry), %rax
     call    *%rax
+
+    movq    %rbx, %rcx
+    movabsq $ASM_PFX(SmiRendezvous), %rax
+    call    *%rax
+
+    movq    %rbx, %rcx
+    movabsq $ASM_PFX(CpuSmmDebugExit), %rax
+    call    *%rax
+
     addq    $0x20, %rsp
 
     #
@@ -193,17 +191,6 @@ L1:
     .byte   0x48                        # FXRSTOR64
     fxrstor (%rsp)
 
-    movabsq $ASM_PFX(FeaturePcdGet (PcdCpuSmmDebug)), %rax
-    cmpb    $0, (%rax)
-    jz      L2
-
-    movq    %dr7, %rdx
-    movq    %dr6, %rcx
-    .byte   0x48, 0x89, 0x15            # mov [rip + disp32], rdx
-    .long   SSM_DR7 - (. + 4 - _SmiEntryPoint + 0x8000)
-    .byte   0x48, 0x89, 0x0d            # mov [rip + disp32], rcx
-    .long   SSM_DR6 - (. + 4 - _SmiEntryPoint + 0x8000)
-L2:
     rsm
 
 ASM_PFX(gcSmiHandlerSize):    .word      . - _SmiEntryPoint
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
index 4d53db5b00da..4f5c03c5cf5f 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
@@ -22,12 +22,13 @@
 ; Variables referenced by C code
 ;
 EXTERNDEF   SmiRendezvous:PROC
+EXTERNDEF   CpuSmmDebugEntry:PROC
+EXTERNDEF   CpuSmmDebugExit:PROC
 EXTERNDEF   gcSmiHandlerTemplate:BYTE
 EXTERNDEF   gcSmiHandlerSize:WORD
 EXTERNDEF   gSmiCr3:DWORD
 EXTERNDEF   gSmiStack:DWORD
 EXTERNDEF   gSmbase:DWORD
-EXTERNDEF   FeaturePcdGet (PcdCpuSmmDebug):BYTE
 EXTERNDEF   gSmiHandlerIdtr:FWORD
 
 
@@ -157,26 +158,7 @@ Base:
 ;   jmp     _SmiHandler                 ; instruction is not needed
 
 _SmiHandler:
-;
-; The following lines restore DR6 & DR7 before running C code. They are useful
-; when you want to enable hardware breakpoints in SMM.
-;
-; NOTE: These lines might not be appreciated in runtime since they might
-;       conflict with OS debugging facilities. Turn them off in RELEASE.
-;
-    mov     rax, offset FeaturePcdGet (PcdCpuSmmDebug) ;Get absolute address. Avoid RIP relative addressing
-    cmp     byte ptr [rax], 0
-    jz      @1
-
-    DB      48h, 8bh, 0dh               ; mov rcx, [rip + disp32]
-    DD      SSM_DR6 - ($ + 4 - _SmiEntryPoint + 8000h)
-    DB      48h, 8bh, 15h               ; mov rdx, [rip + disp32]
-    DD      SSM_DR7 - ($ + 4 - _SmiEntryPoint + 8000h)
-    mov     dr6, rcx
-    mov     dr7, rdx
-@1:
-    mov     rcx, [rsp]                  ; rcx <- CpuIndex
-    mov     rax, SmiRendezvous          ; rax <- absolute addr of SmiRedezvous
+    mov     rbx, [rsp]                  ; rbx <- CpuIndex
 
     ;
     ; Save FP registers
@@ -186,7 +168,19 @@ _SmiHandler:
     fxsave  [rsp]
 
     add     rsp, -20h
+
+    mov     rcx, rbx
+    mov     rax, CpuSmmDebugEntry
+    call    rax
+    
+    mov     rcx, rbx
+    mov     rax, SmiRendezvous          ; rax <- absolute addr of SmiRedezvous
+    call    rax
+    
+    mov     rcx, rbx
+    mov     rax, CpuSmmDebugExit
     call    rax
+    
     add     rsp, 20h
 
     ;
@@ -195,17 +189,6 @@ _SmiHandler:
     DB      48h                         ; FXRSTOR64
     fxrstor [rsp]
 
-    mov     rax, offset FeaturePcdGet (PcdCpuSmmDebug) ;Get absolute address. Avoid RIP relative addressing
-    cmp     byte ptr [rax], 0
-    jz      @2
-
-    mov     rdx, dr7
-    mov     rcx, dr6
-    DB      48h, 89h, 15h               ; mov [rip + disp32], rdx
-    DD      SSM_DR7 - ($ + 4 - _SmiEntryPoint + 8000h)
-    DB      48h, 89h, 0dh               ; mov [rip + disp32], rcx
-    DD      SSM_DR6 - ($ + 4 - _SmiEntryPoint + 8000h)
-@2:
     rsm
 
 gcSmiHandlerSize    DW      $ - _SmiEntryPoint

From 021d6b35a20841cc1e76a1b85ec7926cedfd448d Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Wed, 25 Nov 2015 17:00:51 +0000
Subject: [PATCH 476/525] UefiCpuPkg/Include: Expand description of
 AcpiCpuData.h structures

Provide a more detailed description of each field of the
ACPI_CPU_DATA and CPU_REGISTER_TABLE structures.

Cc: Laszlo Ersek <lersek@redhat.com>
Cc: "Yao, Jiewen" <jiewen.yao@intel.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18950 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit af381fda9b63f548a1b9f71bac3d4721f1fd8db4)
---
 UefiCpuPkg/Include/AcpiCpuData.h | 115 +++++++++++++++++++++++++++----
 1 file changed, 102 insertions(+), 13 deletions(-)

diff --git a/UefiCpuPkg/Include/AcpiCpuData.h b/UefiCpuPkg/Include/AcpiCpuData.h
index a36725711cd8..12e9692c5cf8 100644
--- a/UefiCpuPkg/Include/AcpiCpuData.h
+++ b/UefiCpuPkg/Include/AcpiCpuData.h
@@ -18,7 +18,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //
 // Register types in register table
 //
-typedef enum _REGISTER_TYPE {
+typedef enum {
   Msr,
   ControlRegister,
   MemoryMapped,
@@ -29,11 +29,11 @@ typedef enum _REGISTER_TYPE {
 // Element of register table entry
 //
 typedef struct {
-  REGISTER_TYPE RegisterType;
-  UINT32        Index;
-  UINT8         ValidBitStart;
-  UINT8         ValidBitLength;
-  UINT64        Value;
+  REGISTER_TYPE  RegisterType;
+  UINT32         Index;
+  UINT8          ValidBitStart;
+  UINT8          ValidBitLength;
+  UINT64         Value;
 } CPU_REGISTER_TABLE_ENTRY;
 
 //
@@ -41,30 +41,119 @@ typedef struct {
 // allocated size of this table, and pointer to the list of table entries.
 //
 typedef struct {
-  UINT32                   TableLength;
-  UINT32                   NumberBeforeReset;
-  UINT32                   AllocatedSize;
-  UINT32                   InitialApicId;
-  CPU_REGISTER_TABLE_ENTRY *RegisterTableEntry;
+  //
+  // The number of valid entries in the RegisterTableEntry buffer
+  //
+  UINT32                    TableLength;
+  UINT32                    NumberBeforeReset;
+  //
+  // The size, in bytes, of the RegisterTableEntry buffer
+  //
+  UINT32                    AllocatedSize;
+  //
+  // The initial APIC ID of the CPU this register table applies to
+  //
+  UINT32                    InitialApicId;
+  //
+  // Buffer of CPU_REGISTER_TABLE_ENTRY structures.  This buffer must be
+  // allocated below 4GB from memory of type EfiACPIMemoryNVS.
+  //
+  CPU_REGISTER_TABLE_ENTRY  *RegisterTableEntry;
 } CPU_REGISTER_TABLE;
 
+//
+// Data structure that is required for ACPI S3 resume.  This structure must be
+// allocated below 4GB from memory of type EfiACPIMemoryNVS.  The PCD
+// PcdCpuS3DataAddress must be set to the physical address where this structure
+// is allocated
+//
 typedef struct {
+  //
+  // Physical address of 4KB buffer allocated below 1MB from memory of type
+  // EfiReservedMemoryType.  The buffer is not required to be initialized, but
+  // it is recommended that the buffer be zero-filled.  This buffer is used to
+  // wake APs during an ACPI S3 resume.
+  //
   EFI_PHYSICAL_ADDRESS  StartupVector;
+  //
+  // Physical address of structure of type IA32_DESCRIPTOR.  This structure must
+  // be allocated below 4GB from memory of type EfiACPIMemoryNVS.  The
+  // IA32_DESCRIPTOR structure provides the base address and length of a GDT
+  // The buffer for GDT must also be allocated below 4GB from memory of type
+  // EfiACPIMemoryNVS.  The GDT must be filled in with the GDT contents that are
+  // used during an ACPI S3 resume.  This is typically the contents of the GDT
+  // used by the boot processor when the platform is booted.
+  //
   EFI_PHYSICAL_ADDRESS  GdtrProfile;
+  //
+  // Physical address of structure of type IA32_DESCRIPTOR.  This structure must
+  // be allocated below 4GB from memory of type EfiACPIMemoryNVS.  The
+  // IA32_DESCRIPTOR structure provides the base address and length of an IDT.
+  // The buffer for IDT must also be allocated below 4GB from memory of type
+  // EfiACPIMemoryNVS.  The IDT must be filled in with the IDT contents that are
+  // used during an ACPI S3 resume.  This is typically the contents of the IDT
+  // used by the boot processor when the platform is booted.
+  //
   EFI_PHYSICAL_ADDRESS  IdtrProfile;
+  //
+  // Physical address of a buffer that is used as stacks during ACPI S3 resume.
+  // The total size of this buffer, in bytes, is NumberOfCpus * StackSize.  This
+  // structure must be allocated below 4GB from memory of type EfiACPIMemoryNVS.
+  //
   EFI_PHYSICAL_ADDRESS  StackAddress;
+  //
+  // The size, in bytes, of the stack provided to each CPU during ACPI S3 resume.
+  //
   UINT32                StackSize;
+  //
+  // The number of CPUs.  If a platform does not support hot plug CPUs, then
+  // this is the number of CPUs detected when the platform is booted, regardless
+  // of being enabled or disabled.  If a platform does support hot plug CPUs,
+  // then this is the maximum number of CPUs that the platform supports.
+  //
   UINT32                NumberOfCpus;
+  //
+  // Physical address of structure of type MTRR_SETTINGS that contains a copy
+  // of the MTRR settings that are compatible with the MTRR settings used by
+  // the boot processor when the platform was booted.  These MTRR settings are
+  // used during an ACPI S3 resume.  This structure must be allocated below 4GB
+  // from memory of type EfiACPIMemoryNVS.
+  //
   EFI_PHYSICAL_ADDRESS  MtrrTable;
   //
-  // Physical address of a CPU_REGISTER_TABLE structure
+  // Physical address of an array of CPU_REGISTER_TABLE structures, with
+  // NumberOfCpus entries.  This array must be allocated below 4GB from memory
+  // of type EfiACPIMemoryNVS.  If a register table is not required, then the
+  // TableLength and AllocatedSize fields of CPU_REGISTER_TABLE are set to 0.
+  // If TableLength is > 0, then elements of RegisterTableEntry are used to
+  // initialize the CPU that matches InitialApicId, during an ACPI S3 resume,
+  // before SMBASE relocation is performed.
   //
   EFI_PHYSICAL_ADDRESS  PreSmmInitRegisterTable;
   //
-  // Physical address of a CPU_REGISTER_TABLE structure
+  // Physical address of an array of CPU_REGISTER_TABLE structures, with
+  // NumberOfCpus entries.  This array must be allocated below 4GB from memory
+  // of type EfiACPIMemoryNVS.  If a register table is not required, then the
+  // TableLength and AllocatedSize fields of CPU_REGISTER_TABLE are set to 0.
+  // If TableLength is > 0, then elements of RegisterTableEntry are used to
+  // initialize the CPU that matches InitialApicId, during an ACPI S3 resume,
+  // after SMBASE relocation is performed.
   //
   EFI_PHYSICAL_ADDRESS  RegisterTable;
+  //
+  // Physical address of a buffer that contains the machine check handler that
+  // is used during an ACPI S3 Resume.  This buffer must be allocated below 4GB
+  // from memory of type EfiACPIMemoryNVS.  In order for this machine check
+  // handler to be active on an AP during an ACPI S3 resume, the machine check
+  // vector in the IDT provided by IdtrProfile must be initialized to transfer
+  // control to this physical address.
+  //
   EFI_PHYSICAL_ADDRESS  ApMachineCheckHandlerBase;
+  //
+  // The size, in bytes, of the machine check handler that is used during an
+  // ACPI S3 Resume.  If this field is 0, then a machine check handler is not
+  // provided.
+  //
   UINT32                ApMachineCheckHandlerSize;
 } ACPI_CPU_DATA;
 

From f1c2707c90471a1acf75b1c69199e1696f948af8 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Wed, 25 Nov 2015 17:01:02 +0000
Subject: [PATCH 477/525] UefiCpuPkg/CpuS3DataDxe: Add module to initialize
 ACPI_CPU_DATA for S3

This module initializes the ACPI_CPU_DATA structure and registers the
address of this structure in the PcdCpuS3DataAddress PCD.  This is a
generic/simple version of this module.  It does not provide a machine
check handler or CPU register initialization tables for ACPI S3 resume.
It also only supports the number of CPUs reported by the MP Services
Protocol, so this module does not support hot plug CPUs.  This module
can be copied into a CPU specific package and customized if these
additional features are required.

This patch series is in response to the OvmfPkg patch series from
Laszlo Ersek that enables SMM on OVMF.  The v4 version of the patch
series from Laszlo includes an OVMF specific CPU module to initialize
the ACPI_CPU_DATA structure.

This proposed patch series replaces the patches listed below.

[PATCH v4 27/41] OvmfPkg:
  add skeleton QuarkPort/CpuS3DataDxe

[PATCH v4 28/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: fill in ACPI_CPU_DATA.StartupVector

[PATCH v4 29/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: handle IDT, GDT and MCE in ACPI_CPU_DATA

[PATCH v4 30/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: handle StackAddress and StackSize

[PATCH v4 31/41] OvmfPkg:
  import CpuConfigLib header from Quark_EDKII_v1.1.0/IA32FamilyCpuBasePkg

[PATCH v4 32/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: fill in ACPI_CPU_DATA.NumberOfCpus

[PATCH v4 33/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: fill in ACPI_CPU_DATA.MtrrTable

[PATCH v4 34/41] OvmfPkg:
  QuarkPort/CpuS3DataDxe: handle register tables in ACPI_CPU_DATA

[PATCH v4 35/41] OvmfPkg:
  port CpuS3DataDxe to X64
  patch originally authored by Paolo Bonzini

[PATCH v4 36/41] OvmfPkg:
  build QuarkPort/CpuS3DataDxe for -D SMM_REQUIRE

Cc: Laszlo Ersek <lersek@redhat.com>
Cc: "Yao, Jiewen" <jiewen.yao@intel.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18951 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit bfec5efa56cae21ea8a1bb52cd7701749d43d70a)
---
 UefiCpuPkg/CpuS3DataDxe/CpuS3Data.c      | 271 +++++++++++++++++++++++
 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf |  64 ++++++
 UefiCpuPkg/UefiCpuPkg.dsc                |   1 +
 3 files changed, 336 insertions(+)
 create mode 100644 UefiCpuPkg/CpuS3DataDxe/CpuS3Data.c
 create mode 100644 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf

diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3Data.c b/UefiCpuPkg/CpuS3DataDxe/CpuS3Data.c
new file mode 100644
index 000000000000..9fb47dc5289d
--- /dev/null
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3Data.c
@@ -0,0 +1,271 @@
+/** @file
+ACPI CPU Data initialization module
+
+This module initializes the ACPI_CPU_DATA structure and registers the address
+of this structure in the PcdCpuS3DataAddress PCD.  This is a generic/simple
+version of this module.  It does not provide a machine check handler or CPU
+register initialization tables for ACPI S3 resume.  It also only supports the
+number of CPUs reported by the MP Services Protocol, so this module does not
+support hot plug CPUs.  This module can be copied into a CPU specific package
+and customized if these additional features are required.
+
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015, Red Hat, Inc.
+
+This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <PiDxe.h>
+
+#include <AcpiCpuData.h>
+
+#include <Library/BaseLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/UefiBootServicesTableLib.h>
+#include <Library/DebugLib.h>
+#include <Library/MtrrLib.h>
+
+#include <Protocol/MpService.h>
+#include <Guid/EventGroup.h>
+
+//
+// Data structure used to allocate ACPI_CPU_DATA and its supporting structures
+//
+typedef struct {
+  ACPI_CPU_DATA             AcpiCpuData;
+  MTRR_SETTINGS             MtrrTable;
+  IA32_DESCRIPTOR           GdtrProfile;
+  IA32_DESCRIPTOR           IdtrProfile;
+} ACPI_CPU_DATA_EX;
+
+/**
+  Allocate EfiACPIMemoryNVS below 4G memory address.
+
+  This function allocates EfiACPIMemoryNVS below 4G memory address.
+
+  @param[in] Size   Size of memory to allocate.
+
+  @return       Allocated address for output.
+
+**/
+VOID *
+AllocateAcpiNvsMemoryBelow4G (
+  IN UINTN  Size
+  )
+{
+  EFI_PHYSICAL_ADDRESS  Address;
+  EFI_STATUS            Status;
+  VOID                  *Buffer;
+
+  Address = BASE_4GB - 1;
+  Status  = gBS->AllocatePages (
+                   AllocateMaxAddress,
+                   EfiACPIMemoryNVS,
+                   EFI_SIZE_TO_PAGES (Size),
+                   &Address
+                   );
+  if (EFI_ERROR (Status)) {
+    return NULL;
+  }
+
+  Buffer = (VOID *)(UINTN)Address;
+  ZeroMem (Buffer, Size);
+
+  return Buffer;
+}
+
+/**
+  Callback function executed when the EndOfDxe event group is signaled.
+
+  We delay saving the MTRR settings until BDS signals EndOfDxe.
+
+  @param[in]  Event    Event whose notification function is being invoked.
+  @param[out] Context  Pointer to the MTRR_SETTINGS buffer to fill in.
+**/
+VOID
+EFIAPI
+SaveMtrrsOnEndOfDxe (
+  IN  EFI_EVENT  Event,
+  OUT VOID       *Context
+  )
+{
+  DEBUG ((EFI_D_VERBOSE, "%a\n", __FUNCTION__));
+  MtrrGetAllMtrrs (Context);
+
+  //
+  // Close event, so it will not be invoked again.
+  //
+  gBS->CloseEvent (Event);
+}
+
+/**
+   The entry function of the CpuS3Data driver.
+
+   Allocate and initialize all fields of the ACPI_CPU_DATA structure except the
+   MTRR settings.  Register an event notification on gEfiEndOfDxeEventGroupGuid
+   to capture the ACPI_CPU_DATA MTRR settings.  The PcdCpuS3DataAddress is set
+   to the address that ACPI_CPU_DATA is allocated at.
+
+   @param[in] ImageHandle  The firmware allocated handle for the EFI image.
+   @param[in] SystemTable  A pointer to the EFI System Table.
+
+   @retval EFI_SUCCESS     The entry point is executed successfully.
+   @retval other           Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+CpuS3DataInitialize (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS                 Status;
+  ACPI_CPU_DATA_EX           *AcpiCpuDataEx;
+  ACPI_CPU_DATA              *AcpiCpuData;
+  EFI_MP_SERVICES_PROTOCOL   *MpServices;
+  UINTN                      NumberOfCpus;
+  UINTN                      NumberOfEnabledProcessors;
+  VOID                       *Stack;
+  UINTN                      TableSize;
+  CPU_REGISTER_TABLE         *RegisterTable;
+  UINTN                      Index;
+  EFI_PROCESSOR_INFORMATION  ProcessorInfoBuffer;
+  UINTN                      GdtSize;
+  UINTN                      IdtSize;
+  VOID                       *Gdt;
+  VOID                       *Idt;
+  EFI_EVENT                  Event;
+
+  //
+  // Allocate ACPI NVS memory below 4G memory for use on ACPI S3 resume.
+  //
+  AcpiCpuDataEx = AllocateAcpiNvsMemoryBelow4G (sizeof (ACPI_CPU_DATA_EX));
+  ASSERT (AcpiCpuDataEx != NULL);
+  AcpiCpuData = &AcpiCpuDataEx->AcpiCpuData;
+
+  //
+  // Get MP Services Protocol
+  //
+  Status = gBS->LocateProtocol (
+                  &gEfiMpServiceProtocolGuid,
+                  NULL,
+                  (VOID **)&MpServices
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Allocate a 4KB reserved page below 1MB
+  //
+  AcpiCpuData->StartupVector = BASE_1MB - 1;
+  Status = gBS->AllocatePages (
+                  AllocateMaxAddress,
+                  EfiReservedMemoryType,
+                  1,
+                  &AcpiCpuData->StartupVector
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Get the number of CPUs
+  //
+  Status = MpServices->GetNumberOfProcessors (
+                         MpServices,
+                         &NumberOfCpus,
+                         &NumberOfEnabledProcessors
+                         );
+  ASSERT_EFI_ERROR (Status);
+  AcpiCpuData->NumberOfCpus = (UINT32)NumberOfCpus;
+
+  //
+  // Initialize ACPI_CPU_DATA fields
+  //
+  AcpiCpuData->StackSize                 = PcdGet32 (PcdCpuApStackSize);
+  AcpiCpuData->ApMachineCheckHandlerBase = 0;
+  AcpiCpuData->ApMachineCheckHandlerSize = 0;
+  AcpiCpuData->GdtrProfile  = (EFI_PHYSICAL_ADDRESS)(UINTN)&AcpiCpuDataEx->GdtrProfile;
+  AcpiCpuData->IdtrProfile  = (EFI_PHYSICAL_ADDRESS)(UINTN)&AcpiCpuDataEx->IdtrProfile;
+  AcpiCpuData->MtrrTable    = (EFI_PHYSICAL_ADDRESS)(UINTN)&AcpiCpuDataEx->MtrrTable;
+
+  //
+  // Allocate stack space for all CPUs
+  //
+  Stack = AllocateAcpiNvsMemoryBelow4G (NumberOfCpus * AcpiCpuData->StackSize);
+  ASSERT (Stack != NULL);
+  AcpiCpuData->StackAddress = (EFI_PHYSICAL_ADDRESS)(UINTN)Stack;
+
+  //
+  // Get the boot processor's GDT and IDT
+  //
+  AsmReadGdtr (&AcpiCpuDataEx->GdtrProfile);
+  AsmReadIdtr (&AcpiCpuDataEx->IdtrProfile);
+
+  //
+  // Allocate GDT and IDT in ACPI NVS and copy current GDT and IDT contents
+  //
+  GdtSize = AcpiCpuDataEx->GdtrProfile.Limit + 1;
+  IdtSize = AcpiCpuDataEx->IdtrProfile.Limit + 1;
+  Gdt = AllocateAcpiNvsMemoryBelow4G (GdtSize + IdtSize);
+  ASSERT (Gdt != NULL);
+  Idt = (VOID *)((UINTN)Gdt + GdtSize);
+  CopyMem (Gdt, (VOID *)AcpiCpuDataEx->GdtrProfile.Base, GdtSize);
+  CopyMem (Idt, (VOID *)AcpiCpuDataEx->IdtrProfile.Base, IdtSize);
+  AcpiCpuDataEx->GdtrProfile.Base = (UINTN)Gdt;
+  AcpiCpuDataEx->IdtrProfile.Base = (UINTN)Idt;
+
+  //
+  // Allocate buffer for empty RegisterTable and PreSmmInitRegisterTable for all CPUs
+  //
+  TableSize = 2 * NumberOfCpus * sizeof (CPU_REGISTER_TABLE);
+  RegisterTable = (CPU_REGISTER_TABLE *)AllocateAcpiNvsMemoryBelow4G (TableSize);
+  ASSERT (RegisterTable != NULL);
+  for (Index = 0; Index < NumberOfCpus; Index++) {
+    Status = MpServices->GetProcessorInfo (
+                           MpServices,
+                           Index,
+                           &ProcessorInfoBuffer
+                           );
+    ASSERT_EFI_ERROR (Status);
+
+    RegisterTable[Index].InitialApicId      = (UINT32)ProcessorInfoBuffer.ProcessorId;
+    RegisterTable[Index].TableLength        = 0;
+    RegisterTable[Index].AllocatedSize      = 0;
+    RegisterTable[Index].RegisterTableEntry = NULL;
+
+    RegisterTable[NumberOfCpus + Index].InitialApicId      = (UINT32)ProcessorInfoBuffer.ProcessorId;
+    RegisterTable[NumberOfCpus + Index].TableLength        = 0;
+    RegisterTable[NumberOfCpus + Index].AllocatedSize      = 0;
+    RegisterTable[NumberOfCpus + Index].RegisterTableEntry = NULL;
+  }
+  AcpiCpuData->RegisterTable           = (EFI_PHYSICAL_ADDRESS)(UINTN)RegisterTable;
+  AcpiCpuData->PreSmmInitRegisterTable = (EFI_PHYSICAL_ADDRESS)(UINTN)(RegisterTable + NumberOfCpus);
+
+  //
+  // Set PcdCpuS3DataAddress to the base address of the ACPI_CPU_DATA structure
+  //
+  Status = PcdSet64S (PcdCpuS3DataAddress, (UINT64)(UINTN)AcpiCpuData);
+  ASSERT_EFI_ERROR (Status);
+
+  //
+  // Register EFI_END_OF_DXE_EVENT_GROUP_GUID event.
+  // The notification function saves MTRRs for ACPI_CPU_DATA
+  //
+  Status = gBS->CreateEventEx (
+                  EVT_NOTIFY_SIGNAL,
+                  TPL_CALLBACK,
+                  SaveMtrrsOnEndOfDxe,
+                  &AcpiCpuDataEx->MtrrTable,
+                  &gEfiEndOfDxeEventGroupGuid,
+                  &Event
+                  );
+  ASSERT_EFI_ERROR (Status);
+
+  return EFI_SUCCESS;
+}
diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
new file mode 100644
index 000000000000..2ef16a79320e
--- /dev/null
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
@@ -0,0 +1,64 @@
+## @file
+#  ACPI CPU Data initialization module
+#
+#  This module initializes the ACPI_CPU_DATA structure and registers the address
+#  of this structure in the PcdCpuS3DataAddress PCD.  This is a generic/simple
+#  version of this module.  It does not provide a machine check handler or CPU
+#  register initialization tables for ACPI S3 resume.  It also only supports the
+#  number of CPUs reported by the MP Services Protocol, so this module does not
+#  support hot plug CPUs.  This module can be copied into a CPU specific package
+#  and customized if these additional features are required.
+#
+#  Copyright (c) 2013-2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2015, Red Hat, Inc.
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution.  The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = CpuS3DataDxe
+  FILE_GUID                      = 4D2E57EE-0E3F-44DD-93C4-D3B57E96945D
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  ENTRY_POINT                    = CpuS3DataInitialize
+
+# The following information is for reference only and not required by the build
+# tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+
+[Sources]
+  CpuS3Data.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
+
+[LibraryClasses]
+  UefiDriverEntryPoint
+  UefiBootServicesTableLib
+  BaseMemoryLib
+  DebugLib
+  BaseLib
+  MtrrLib
+
+[Guids]
+  gEfiEndOfDxeEventGroupGuid         ## CONSUMES
+
+[Protocols]
+  gEfiMpServiceProtocolGuid          ## CONSUMES
+
+[Pcd]
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuApStackSize    ## CONSUMES
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuS3DataAddress  ## PRODUCES
+
+[Depex]
+  gEfiMpServiceProtocolGuid
diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 756645f728d4..406105073270 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -101,6 +101,7 @@
   UefiCpuPkg/CpuDxe/CpuDxe.inf
   UefiCpuPkg/CpuIo2Smm/CpuIo2Smm.inf
   UefiCpuPkg/CpuMpPei/CpuMpPei.inf
+  UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
   UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.inf
   UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.inf
   UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.inf

From 08bc350901f68435a8c0ec2c06e00323b659eddd Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Thu, 26 Nov 2015 03:56:33 +0000
Subject: [PATCH 478/525] Allocate Tile size based on Page.

We had better separate code from data in tile in page level,
so that other program may use page level protection on that.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18957 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit ae82a30bee2c8a4630389699391ce02a63e9a464)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index f4ed39f95973..cf0128e1cb48 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -760,6 +760,9 @@ PiCpuSmmEntry (
   UINTN                      NumberOfEnabledProcessors;
   UINTN                      Index;
   VOID                       *Buffer;
+  UINTN                      BufferPages;
+  UINTN                      TileCodeSize;
+  UINTN                      TileDataSize;
   UINTN                      TileSize;
   VOID                       *GuidHob;
   EFI_SMRAM_DESCRIPTOR       *SmramDescriptor;
@@ -942,9 +945,13 @@ PiCpuSmmEntry (
   // specific context in a PROCESSOR_SMM_DESCRIPTOR, and the SMI entry point.  This size
   // is rounded up to nearest power of 2.
   //
-  TileSize = sizeof (SMRAM_SAVE_STATE_MAP) + sizeof (PROCESSOR_SMM_DESCRIPTOR) + GetSmiHandlerSize () - 1;
+  TileCodeSize = GetSmiHandlerSize ();
+  TileCodeSize = ALIGN_VALUE(TileCodeSize, SIZE_4KB);
+  TileDataSize = sizeof (SMRAM_SAVE_STATE_MAP) + sizeof (PROCESSOR_SMM_DESCRIPTOR);
+  TileDataSize = ALIGN_VALUE(TileDataSize, SIZE_4KB);
+  TileSize = TileDataSize + TileCodeSize - 1;
   TileSize = 2 * GetPowerOfTwo32 ((UINT32)TileSize);
-  DEBUG ((EFI_D_INFO, "SMRAM TileSize = %08x\n", TileSize));
+  DEBUG ((EFI_D_INFO, "SMRAM TileSize = 0x%08x (0x%08x, 0x%08x)\n", TileSize, TileCodeSize, TileDataSize));
 
   //
   // If the TileSize is larger than space available for the SMI Handler of CPU[i],
@@ -966,12 +973,14 @@ PiCpuSmmEntry (
   // Intel486 processors: FamilyId is 4
   // Pentium processors : FamilyId is 5
   //
+  BufferPages = EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1));
   if ((FamilyId == 4) || (FamilyId == 5)) {
-    Buffer = AllocateAlignedPages (EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1)), SIZE_32KB);
+    Buffer = AllocateAlignedCodePages (BufferPages, SIZE_32KB);
   } else {
-    Buffer = AllocatePages (EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1)));
+    Buffer = AllocateAlignedCodePages (BufferPages, SIZE_4KB);
   }
   ASSERT (Buffer != NULL);
+  DEBUG ((EFI_D_INFO, "SMRAM SaveState Buffer (0x%08x, 0x%08x)\n", Buffer, EFI_PAGES_TO_SIZE(BufferPages)));
 
   //
   // Allocate buffer for pointers to array in  SMM_CPU_PRIVATE_DATA.

From c466f5d9ebd7c18fbfebf16ccaeab2680ee7ea03 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Fri, 27 Nov 2015 13:48:03 +0000
Subject: [PATCH 479/525] UefiCpuPkg/PiSmmCpu: Add 2 APIs in SmmCpuFeaturesLib.

SmmCpuFeaturesCompleteSmmReadyToLock() is a hook point to
allow CPU specific code to do more registers setting after
the gEfiSmmReadyToLockProtocolGuid notification is completely
processed.

SmmCpuFeaturesAllocatePageTableMemory() is an API to allow
CPU to allocate a specific region for storing page tables.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Laszlo Ersek" <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18979 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit e3840072cd932fc1c9fc48510866534297a58dd2)
---
 .../Include/Library/SmmCpuFeaturesLib.h       | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h b/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
index d1c7a8ac965c..4478003467c8 100644
--- a/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
+++ b/UefiCpuPkg/Include/Library/SmmCpuFeaturesLib.h
@@ -363,4 +363,39 @@ SmmCpuFeaturesWriteSaveStateRegister (
   IN CONST VOID                   *Buffer
   );
 
+/**
+  This function is hook point called after the gEfiSmmReadyToLockProtocolGuid
+  notification is completely processed.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesCompleteSmmReadyToLock (
+  VOID
+  );
+
+/**
+  This API provides a method for a CPU to allocate a specific region for storing page tables.
+
+  This API can be called more once to allocate memory for page tables.
+
+  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.
+
+  This function can also return NULL if there is no preference on where the page tables are allocated in SMRAM.
+
+  @param  Pages                 The number of 4 KB pages to allocate.
+
+  @return A pointer to the allocated buffer for page tables.
+  @retval NULL      Fail to allocate a specific region for storing page tables,
+                    Or there is no preference on where the page tables are allocated in SMRAM.
+
+**/
+VOID *
+EFIAPI
+SmmCpuFeaturesAllocatePageTableMemory (
+  IN UINTN           Pages
+  );
+
 #endif

From 4bae35fe63638213a978ae545728b3ec2642b46b Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Fri, 27 Nov 2015 13:48:08 +0000
Subject: [PATCH 480/525] UefiCpuPkg/PiSmmCpu: Add NULL func for 2 new APIs in
 SmmCpuFeaturesLib.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Laszlo Ersek" <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18980 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit b095a5403b1dd2ad7af153069f3729716a864e80)
---
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.c     | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
index b839d3192f56..3e480e1761fd 100644
--- a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
+++ b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.c
@@ -615,3 +615,44 @@ SmmCpuFeaturesWriteSaveStateRegister (
 {
   return EFI_UNSUPPORTED;
 }
+
+/**
+  This function is hook point called after the gEfiSmmReadyToLockProtocolGuid
+  notification is completely processed.
+**/
+VOID
+EFIAPI
+SmmCpuFeaturesCompleteSmmReadyToLock (
+  VOID
+  )
+{
+}
+
+/**
+  This API provides a method for a CPU to allocate a specific region for storing page tables.
+
+  This API can be called more once to allocate memory for page tables.
+
+  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.
+
+  This function can also return NULL if there is no preference on where the page tables are allocated in SMRAM.
+
+  @param  Pages                 The number of 4 KB pages to allocate.
+
+  @return A pointer to the allocated buffer for page tables.
+  @retval NULL      Fail to allocate a specific region for storing page tables,
+                    Or there is no preference on where the page tables are allocated in SMRAM.
+
+**/
+VOID *
+EFIAPI
+SmmCpuFeaturesAllocatePageTableMemory (
+  IN UINTN           Pages
+  )
+{
+  return NULL;
+}
+

From b2c7f09d779b252b6cd4fa48cd42aea203522bf4 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Fri, 27 Nov 2015 13:48:12 +0000
Subject: [PATCH 481/525] UefiCpuPkg/PiSmmCpu: Update function call for 2 new
 APIs.

All page table allocation will use AllocatePageTableMemory().
Add SmmCpuFeaturesCompleteSmmReadyToLock() to PerformRemainingTasks()
and PerformPreTasks().

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Reviewed-by: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Laszlo Ersek" <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18981 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 21c1719318056691a3e5901c6e28e5ba2b70afe2)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c      |  4 +--
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 37 ++++++++++++++++++++--
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h | 21 ++++++++++++
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c     |  2 +-
 4 files changed, 59 insertions(+), 5 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 83f5bf962d57..06ffc6dd86a8 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -770,7 +770,7 @@ Gen4GPageTable (
   //
   // Allocate the page table
   //
-  PageTable = AllocatePages (ExtraPages + 5 + PagesNeeded);
+  PageTable = AllocatePageTableMemory (ExtraPages + 5 + PagesNeeded);
   ASSERT (PageTable != NULL);
 
   PageTable = (VOID *)((UINTN)PageTable + EFI_PAGES_TO_SIZE (ExtraPages));
@@ -872,7 +872,7 @@ SetCacheability (
     //
     // Allocate a page from SMRAM
     //
-    NewPageTableAddress = AllocatePages (1);
+    NewPageTableAddress = AllocatePageTableMemory (1);
     ASSERT (NewPageTableAddress != NULL);
 
     NewPageTable = (UINT64 *)NewPageTableAddress;
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index cf0128e1cb48..949dd4e5c1e7 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -975,9 +975,9 @@ PiCpuSmmEntry (
   //
   BufferPages = EFI_SIZE_TO_PAGES (SIZE_32KB + TileSize * (mMaxNumberOfCpus - 1));
   if ((FamilyId == 4) || (FamilyId == 5)) {
-    Buffer = AllocateAlignedCodePages (BufferPages, SIZE_32KB);
+    Buffer = AllocateAlignedPages (BufferPages, SIZE_32KB);
   } else {
-    Buffer = AllocateAlignedCodePages (BufferPages, SIZE_4KB);
+    Buffer = AllocateAlignedPages (BufferPages, SIZE_4KB);
   }
   ASSERT (Buffer != NULL);
   DEBUG ((EFI_D_INFO, "SMRAM SaveState Buffer (0x%08x, 0x%08x)\n", Buffer, EFI_PAGES_TO_SIZE(BufferPages)));
@@ -1420,6 +1420,35 @@ ConfigSmmCodeAccessCheck (
   }
 }
 
+/**
+  This API provides a way to allocate memory for page table.
+
+  This API can be called more once to allocate memory for page tables.
+
+  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 *
+AllocatePageTableMemory (
+  IN UINTN           Pages
+  )
+{
+  VOID  *Buffer;
+
+  Buffer = SmmCpuFeaturesAllocatePageTableMemory (Pages);
+  if (Buffer != NULL) {
+    return Buffer;
+  }
+  return AllocatePages (Pages);
+}
+
 /**
   Perform the remaining tasks.
 
@@ -1445,6 +1474,8 @@ PerformRemainingTasks (
     //
     ConfigSmmCodeAccessCheck ();
 
+    SmmCpuFeaturesCompleteSmmReadyToLock ();
+
     //
     // Clean SMM ready to lock flag
     //
@@ -1470,6 +1501,8 @@ PerformPreTasks (
     //
     ConfigSmmCodeAccessCheck ();
 
+    SmmCpuFeaturesCompleteSmmReadyToLock ();
+
     mRestoreSmmConfigurationInS3 = FALSE;
   }
 }
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index 66d85d80e126..f2a91655a33b 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -718,4 +718,25 @@ VOID
 DumpModuleInfoByIp (
   IN  UINTN              CallerIpAddress
   );
+
+/**
+  This API provides a way to allocate memory for page table.
+
+  This API can be called more once to allocate memory for page tables.
+
+  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 *
+AllocatePageTableMemory (
+  IN UINTN           Pages
+  );
+
 #endif
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
index 8ddde9acb55c..ff4e28ec58e4 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
@@ -552,7 +552,7 @@ InitPaging (
           //
           ASSERT (Address == (*Pte & PHYSICAL_ADDRESS_MASK));
 
-          Pt = AllocatePages (1);
+          Pt = AllocatePageTableMemory (1);
           ASSERT (Pt != NULL);
 
           // Split it

From cd5e29959f602cddd8e4b42b207f2101b6e92e89 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 30 Nov 2015 19:57:40 +0000
Subject: [PATCH 482/525] UefiCpuPkg/PiSmmCpu: Always set RW+P bit for page
 table by default

So that we can use write-protection for code later.

This is REPOST.
It includes the bug fix from "Paolo Bonzini" <pbonzini@redhat.com>:

  Title: fix generation of 32-bit PAE page tables

  "Bits 1 and 2 are reserved in 32-bit PAE Page Directory Pointer Table
  Entries (PDPTEs); see Table 4-8 in the SDM.  With VMX extended page
  tables, the processor notices and fails the VM entry as soon as CR0.PG
  is set to 1."

And thanks "Laszlo Ersek" <lersek@redhat.com> to validate the fix.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Signed-off-by: "Paolo Bonzini" <pbonzini@redhat.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Laszlo Ersek" <lersek@redhat.com>
Cc: "Paolo Bonzini" <pbonzini@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19067 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 881520ea6778953c57d975ca2a9cf3f2114f99c4)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c        |  2 +-
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c |  2 +-
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c           | 14 ++++++++------
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h      | 13 ++++++++++++-
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c          | 12 ++++++------
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c         |  8 ++++----
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c  | 14 +++++++-------
 7 files changed, 39 insertions(+), 26 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
index edebaabb47bd..5d299044c41b 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/PageTbl.c
@@ -60,7 +60,7 @@ SmmInitPageTable (
   if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
     InitializeIDTSmmStackGuard ();
   }
-  return Gen4GPageTable (0);
+  return Gen4GPageTable (0, TRUE);
 }
 
 /**
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
index 85756d0710cf..767cb6908b39 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmmProfileArch.c
@@ -24,7 +24,7 @@ InitSmmS3Cr3 (
   VOID
   )
 {
-  mSmmS3ResumeState->SmmS3Cr3 = Gen4GPageTable (0);
+  mSmmS3ResumeState->SmmS3Cr3 = Gen4GPageTable (0, TRUE);
 
   return ;
 }
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 06ffc6dd86a8..620b0136c5cf 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -732,12 +732,14 @@ APHandler (
   Create 4G PageTable in SMRAM.
 
   @param          ExtraPages       Additional page numbers besides for 4G memory
+  @param          Is32BitPageTable Whether the page table is 32-bit PAE
   @return         PageTable Address
 
 **/
 UINT32
 Gen4GPageTable (
-  IN      UINTN                     ExtraPages
+  IN      UINTN                     ExtraPages,
+  IN      BOOLEAN                   Is32BitPageTable
   )
 {
   VOID    *PageTable;
@@ -785,7 +787,7 @@ Gen4GPageTable (
   // Set Page Directory Pointers
   //
   for (Index = 0; Index < 4; Index++) {
-    Pte[Index] = (UINTN)PageTable + EFI_PAGE_SIZE * (Index + 1) + IA32_PG_P;
+    Pte[Index] = (UINTN)PageTable + EFI_PAGE_SIZE * (Index + 1) + (Is32BitPageTable ? IA32_PAE_PDPTE_ATTRIBUTE_BITS : PAGE_ATTRIBUTE_BITS);
   }
   Pte += EFI_PAGE_SIZE / sizeof (*Pte);
 
@@ -793,7 +795,7 @@ Gen4GPageTable (
   // Fill in Page Directory Entries
   //
   for (Index = 0; Index < EFI_PAGE_SIZE * 4 / sizeof (*Pte); Index++) {
-    Pte[Index] = (Index << 21) + IA32_PG_PS + IA32_PG_RW + IA32_PG_P;
+    Pte[Index] = (Index << 21) | IA32_PG_PS | PAGE_ATTRIBUTE_BITS;
   }
 
   if (FeaturePcdGet (PcdCpuSmmStackGuard)) {
@@ -802,7 +804,7 @@ Gen4GPageTable (
     Pdpte = (UINT64*)PageTable;
     for (PageIndex = Low2MBoundary; PageIndex <= High2MBoundary; PageIndex += SIZE_2MB) {
       Pte = (UINT64*)(UINTN)(Pdpte[BitFieldRead32 ((UINT32)PageIndex, 30, 31)] & ~(EFI_PAGE_SIZE - 1));
-      Pte[BitFieldRead32 ((UINT32)PageIndex, 21, 29)] = (UINT64)Pages + IA32_PG_RW + IA32_PG_P;
+      Pte[BitFieldRead32 ((UINT32)PageIndex, 21, 29)] = (UINT64)Pages | PAGE_ATTRIBUTE_BITS;
       //
       // Fill in Page Table Entries
       //
@@ -819,7 +821,7 @@ Gen4GPageTable (
             GuardPage = 0;
           }
         } else {
-          Pte[Index] = PageAddress + IA32_PG_RW + IA32_PG_P;
+          Pte[Index] = PageAddress | PAGE_ATTRIBUTE_BITS;
         }
         PageAddress+= EFI_PAGE_SIZE;
       }
@@ -886,7 +888,7 @@ SetCacheability (
       NewPageTable[Index] |= (UINT64)(Index << EFI_PAGE_SHIFT);
     }
 
-    PageTable[PTIndex] = ((UINTN)NewPageTableAddress & gPhyMask) | IA32_PG_P;
+    PageTable[PTIndex] = ((UINTN)NewPageTableAddress & gPhyMask) | PAGE_ATTRIBUTE_BITS;
   }
 
   ASSERT (PageTable[PTIndex] & IA32_PG_P);
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
index f2a91655a33b..9920cd1d1e1a 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.h
@@ -71,15 +71,24 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 ///
 #define IA32_PG_P                   BIT0
 #define IA32_PG_RW                  BIT1
+#define IA32_PG_U                   BIT2
 #define IA32_PG_WT                  BIT3
 #define IA32_PG_CD                  BIT4
 #define IA32_PG_A                   BIT5
+#define IA32_PG_D                   BIT6
 #define IA32_PG_PS                  BIT7
 #define IA32_PG_PAT_2M              BIT12
 #define IA32_PG_PAT_4K              IA32_PG_PS
 #define IA32_PG_PMNT                BIT62
 #define IA32_PG_NX                  BIT63
 
+#define PAGE_ATTRIBUTE_BITS         (IA32_PG_RW | IA32_PG_P)
+//
+// Bits 1, 2, 5, 6 are reserved in the IA32 PAE PDPTE
+// X64 PAE PDPTE does not have such restriction
+//
+#define IA32_PAE_PDPTE_ATTRIBUTE_BITS    (IA32_PG_P)
+
 //
 // Size of Task-State Segment defined in IA32 Manual
 //
@@ -364,12 +373,14 @@ extern IA32_DESCRIPTOR                     gcSmiInitGdtr;
   Create 4G PageTable in SMRAM.
 
   @param          ExtraPages       Additional page numbers besides for 4G memory
+  @param          Is32BitPageTable Whether the page table is 32-bit PAE
   @return         PageTable Address
 
 **/
 UINT32
 Gen4GPageTable (
-  IN      UINTN                     ExtraPages
+  IN      UINTN                     ExtraPages,
+  IN      BOOLEAN                   Is32BitPageTable
   );
 
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
index ff4e28ec58e4..ec4ec9b067c5 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
@@ -557,9 +557,9 @@ InitPaging (
 
           // Split it
           for (Level4 = 0; Level4 < SIZE_4KB / sizeof(*Pt); Level4++) {
-            Pt[Level4] = Address + ((Level4 << 12) | IA32_PG_RW | IA32_PG_P);
+            Pt[Level4] = Address + ((Level4 << 12) | PAGE_ATTRIBUTE_BITS);
           } // end for PT
-          *Pte = (UINTN)Pt | IA32_PG_RW | IA32_PG_P;
+          *Pte = (UINTN)Pt | PAGE_ATTRIBUTE_BITS;
         } // end if IsAddressSplit
       } // end for PTE
     } // end for PDE
@@ -608,7 +608,7 @@ InitPaging (
             //
             // Patch to remove Present flag and RW flag
             //
-            *Pte = *Pte & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+            *Pte = *Pte & (INTN)(INT32)(~PAGE_ATTRIBUTE_BITS);
           }
           if (Nx && mXdSupported) {
             *Pte = *Pte | IA32_PG_NX;
@@ -621,7 +621,7 @@ InitPaging (
           }
           for (Level4 = 0; Level4 < SIZE_4KB / sizeof(*Pt); Level4++, Pt++) {
             if (!IsAddressValid (Address, &Nx)) {
-              *Pt = *Pt & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+              *Pt = *Pt & (INTN)(INT32)(~PAGE_ATTRIBUTE_BITS);
             }
             if (Nx && mXdSupported) {
               *Pt = *Pt | IA32_PG_NX;
@@ -1244,7 +1244,7 @@ RestorePageTableBelow4G (
     //
     PageTable[PTIndex] = (PFAddress & ~((1ull << 21) - 1));
     PageTable[PTIndex] |= (UINT64)IA32_PG_PS;
-    PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+    PageTable[PTIndex] |= (UINT64)PAGE_ATTRIBUTE_BITS;
     if ((ErrorCode & IA32_PF_EC_ID) != 0) {
       PageTable[PTIndex] &= ~IA32_PG_NX;
     }
@@ -1277,7 +1277,7 @@ RestorePageTableBelow4G (
     // Set new entry
     //
     PageTable[PTIndex] = (PFAddress & ~((1ull << 12) - 1));
-    PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+    PageTable[PTIndex] |= (UINT64)PAGE_ATTRIBUTE_BITS;
     if ((ErrorCode & IA32_PF_EC_ID) != 0) {
       PageTable[PTIndex] &= ~IA32_PG_NX;
     }
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
index a7d790fd8aa0..5b11e5eb48a8 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/PageTbl.c
@@ -113,7 +113,7 @@ SmmInitPageTable (
   //
   // Generate PAE page table for the first 4GB memory space
   //
-  Pages = Gen4GPageTable (PAGE_TABLE_PAGES + 1);
+  Pages = Gen4GPageTable (PAGE_TABLE_PAGES + 1, FALSE);
 
   //
   // Set IA32_PG_PMNT bit to mask this entry
@@ -127,7 +127,7 @@ SmmInitPageTable (
   // Fill Page-Table-Level4 (PML4) entry
   //
   PTEntry = (UINT64*)(UINTN)(Pages - EFI_PAGES_TO_SIZE (PAGE_TABLE_PAGES + 1));
-  *PTEntry = Pages + IA32_PG_P;
+  *PTEntry = Pages + PAGE_ATTRIBUTE_BITS;
   ZeroMem (PTEntry + 1, EFI_PAGE_SIZE - sizeof (*PTEntry));
   //
   // Set sub-entries number
@@ -591,7 +591,7 @@ SmiDefaultPFHandler (
         //
         // If the entry is not present, allocate one page from page pool for it
         //
-        PageTable[PTIndex] = AllocPage () | IA32_PG_RW | IA32_PG_P;
+        PageTable[PTIndex] = AllocPage () | PAGE_ATTRIBUTE_BITS;
       } else {
         //
         // Save the upper entry address
@@ -621,7 +621,7 @@ SmiDefaultPFHandler (
     // Fill the new entry
     //
     PageTable[PTIndex] = (PFAddress & gPhyMask & ~((1ull << EndBit) - 1)) |
-                         PageAttribute | IA32_PG_A | IA32_PG_RW | IA32_PG_P;
+                         PageAttribute | IA32_PG_A | PAGE_ATTRIBUTE_BITS;
     if (UpperEntry != NULL) {
       SetSubEntriesNum (UpperEntry, GetSubEntriesNum (UpperEntry) + 1);
     }
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
index c4ec12debb1c..79e23ef6476e 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmmProfileArch.c
@@ -45,13 +45,13 @@ InitSmmS3Cr3 (
   //
   // Generate PAE page table for the first 4GB memory space
   //
-  Pages = Gen4GPageTable (1);
+  Pages = Gen4GPageTable (1, FALSE);
 
   //
   // Fill Page-Table-Level4 (PML4) entry
   //
   PTEntry = (UINT64*)(UINTN)(Pages - EFI_PAGES_TO_SIZE (1));
-  *PTEntry = Pages + IA32_PG_P;
+  *PTEntry = Pages | PAGE_ATTRIBUTE_BITS;
   ZeroMem (PTEntry + 1, EFI_PAGE_SIZE - sizeof (*PTEntry));
 
   //
@@ -117,7 +117,7 @@ AcquirePage (
   //
   // Link & Record the current uplink
   //
-  *Uplink = Address | IA32_PG_P | IA32_PG_RW;
+  *Uplink = Address | PAGE_ATTRIBUTE_BITS;
   mPFPageUplink[mPFPageIndex] = Uplink;
 
   mPFPageIndex = (mPFPageIndex + 1) % MAX_PF_PAGE_COUNT;
@@ -242,9 +242,9 @@ RestorePageTableAbove4G (
       // PTE
       PageTable = (UINT64*)(UINTN)(PageTable[PTIndex] & PHYSICAL_ADDRESS_MASK);
       for (Index = 0; Index < 512; Index++) {
-        PageTable[Index] = Address | IA32_PG_RW | IA32_PG_P;
+        PageTable[Index] = Address | PAGE_ATTRIBUTE_BITS;
         if (!IsAddressValid (Address, &Nx)) {
-          PageTable[Index] = PageTable[Index] & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+          PageTable[Index] = PageTable[Index] & (INTN)(INT32)(~PAGE_ATTRIBUTE_BITS);
         }
         if (Nx && mXdSupported) {
           PageTable[Index] = PageTable[Index] | IA32_PG_NX;
@@ -262,7 +262,7 @@ RestorePageTableAbove4G (
         //
         // Patch to remove present flag and rw flag.
         //
-        PageTable[PTIndex] = PageTable[PTIndex] & (INTN)(INT32)(~(IA32_PG_RW | IA32_PG_P));
+        PageTable[PTIndex] = PageTable[PTIndex] & (INTN)(INT32)(~PAGE_ATTRIBUTE_BITS);
       }
       //
       // Set XD bit to 1
@@ -289,7 +289,7 @@ RestorePageTableAbove4G (
   //
   // Add present flag or clear XD flag to make page fault handler succeed.
   //
-  PageTable[PTIndex] |= (UINT64)(IA32_PG_RW | IA32_PG_P);
+  PageTable[PTIndex] |= (UINT64)(PAGE_ATTRIBUTE_BITS);
   if ((ErrorCode & IA32_PF_EC_ID) != 0) {
     //
     // If page fault is caused by instruction fetch, clear XD bit in the entry.

From f48825541ade03c576ecc2357b5fc9ca2db83e71 Mon Sep 17 00:00:00 2001
From: "Yao, Jiewen" <jiewen.yao@intel.com>
Date: Mon, 30 Nov 2015 19:57:45 +0000
Subject: [PATCH 483/525] UefiCpuPkg/PiSmmCpu: Always set WP in CR0

So that we can use write-protection for code later.

It is REPOST.
It includes suggestion from Michael Kinney <michael.d.kinney@intel.com>:
- "For IA32 assembly, can we combine into a single OR instruction that
  sets both page enable and WP?"
- "For X64, does it make sense to use single OR instruction instead of 2
  BTS instructions as well?"

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: "Yao, Jiewen" <jiewen.yao@intel.com>
Suggested-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
Cc: "Fan, Jeff" <jeff.fan@intel.com>
Cc: "Kinney, Michael D" <michael.d.kinney@intel.com>
Cc: "Laszlo Ersek" <lersek@redhat.com>
Cc: "Paolo Bonzini" <pbonzini@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19068 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 53ba3fb8aaf91df4a65244480deb6fa60968c146)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S   | 2 +-
 UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm | 2 +-
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S    | 2 +-
 UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
index fbaa0725f0bc..ec5b9a0b0423 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.S
@@ -123,7 +123,7 @@ L11:
 L12:                                       # as cr4.PGE is not set here, refresh cr3
     movl    %eax, %cr4                     # in PreModifyMtrrs() to flush TLB.
     movl    %cr0, %ebx
-    orl     $0x080000000, %ebx             # enable paging
+    orl     $0x080010000, %ebx             # enable paging + WP
     movl    %ebx, %cr0
     leal    DSC_OFFSET(%edi),%ebx
     movw    DSC_DS(%ebx),%ax
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
index 8a12927300ca..ac1a9b48ddd0 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/Ia32/SmiEntry.asm
@@ -129,7 +129,7 @@ gSmiCr3     DD      ?
 @@:                                     ; as cr4.PGE is not set here, refresh cr3
     mov     cr4, eax                    ; in PreModifyMtrrs() to flush TLB.
     mov     ebx, cr0
-    or      ebx, 080000000h             ; enable paging
+    or      ebx, 080010000h             ; enable paging + WP
     mov     cr0, ebx
     lea     ebx, [edi + DSC_OFFSET]
     mov     ax, [ebx + DSC_DS]
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
index b488b74b7075..7e9ac58cb2c9 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.S
@@ -144,7 +144,7 @@ Base:
     orb     $1,%ah
     wrmsr
     movq    %cr0, %rbx
-    btsl    $31, %ebx
+    orl     $0x080010000, %ebx          # enable paging + WP
     movq    %rbx, %cr0
     retf
 LongMode:                               # long mode (64-bit code) starts here
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
index 4f5c03c5cf5f..094cf2c3da33 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/X64/SmiEntry.asm
@@ -140,7 +140,7 @@ Base:
     or      ah, 1
     wrmsr
     mov     rbx, cr0
-    bts     ebx, 31
+    or      ebx, 080010000h            ; enable paging + WP
     mov     cr0, rbx
     retf
 @LongMode:                              ; long mode (64-bit code) starts here

From be1b021b113cb122caa83a3211ad09a692afa5c4 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 3 Dec 2015 01:13:57 +0000
Subject: [PATCH 484/525] UefiCpuPkg/CpuS3DataDxe: Add more detailed
 description on GUID in INF

Add the GUID gEfiEndOfDxeEventGroupGuid usage description in more details in
INF file.

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19100 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 69206a0664cc5a67766ed7cf91c85cfcb45c18b5)
---
 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
index 2ef16a79320e..9143b87723fe 100644
--- a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
@@ -51,7 +51,7 @@
   MtrrLib
 
 [Guids]
-  gEfiEndOfDxeEventGroupGuid         ## CONSUMES
+  gEfiEndOfDxeEventGroupGuid         ## CONSUMES   ## Event
 
 [Protocols]
   gEfiMpServiceProtocolGuid          ## CONSUMES

From bf6e577dbaaf387e47cf008219931dfcacb18943 Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Tue, 15 Dec 2015 04:59:14 +0000
Subject: [PATCH 485/525] UefiCpuPkg: Convert all .uni files to utf-8

To convert these files I ran:

$ python3 BaseTools/Scripts/ConvertUni.py UefiCpuPkg

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19264 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5999b89e22d359fb456afc946937f9af41ec5614)
---
 UefiCpuPkg/CpuDxe/CpuDxe.uni                  | Bin 1756 -> 877 bytes
 UefiCpuPkg/CpuDxe/CpuDxeExtra.uni             | Bin 1352 -> 675 bytes
 UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.uni            | Bin 1952 -> 975 bytes
 UefiCpuPkg/CpuIo2Dxe/CpuIo2DxeExtra.uni       | Bin 1344 -> 671 bytes
 UefiCpuPkg/CpuIo2Smm/CpuIo2Smm.uni            | Bin 1972 -> 985 bytes
 UefiCpuPkg/CpuIo2Smm/CpuIo2SmmExtra.uni       | Bin 1332 -> 665 bytes
 UefiCpuPkg/CpuIoPei/CpuIoPei.uni              | Bin 1896 -> 947 bytes
 UefiCpuPkg/CpuIoPei/CpuIoPeiExtra.uni         | Bin 1336 -> 667 bytes
 UefiCpuPkg/CpuMpPei/CpuMpPei.uni              | Bin 1706 -> 852 bytes
 UefiCpuPkg/CpuMpPei/CpuMpPeiExtra.uni         | Bin 1344 -> 671 bytes
 .../Library/BaseUefiCpuLib/BaseUefiCpuLib.uni | Bin 1826 -> 912 bytes
 .../Library/BaseXApicLib/BaseXApicLib.uni     | Bin 1962 -> 980 bytes
 .../BaseXApicX2ApicLib/BaseXApicX2ApicLib.uni | Bin 2136 -> 1067 bytes
 .../DxeCpuExceptionHandlerLib.uni             | Bin 1810 -> 904 bytes
 .../SecPeiCpuExceptionHandlerLib.uni          | Bin 1842 -> 920 bytes
 .../SmmCpuExceptionHandlerLib.uni             | Bin 1810 -> 904 bytes
 UefiCpuPkg/Library/MtrrLib/MtrrLib.uni        | Bin 1736 -> 867 bytes
 .../PlatformSecLibNull/PlatformSecLibNull.uni | Bin 1644 -> 821 bytes
 .../SecPeiDxeTimerLibUefiCpu.uni              | Bin 4168 -> 2083 bytes
 .../SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni   | Bin 1672 -> 835 bytes
 .../SmmCpuPlatformHookLibNull.uni             | Bin 1604 -> 801 bytes
 .../PiSmmCommunicationPei.uni                 | Bin 2066 -> 1032 bytes
 .../PiSmmCommunicationPeiExtra.uni            | Bin 1370 -> 684 bytes
 .../PiSmmCommunicationSmm.uni                 | Bin 3004 -> 1501 bytes
 .../PiSmmCommunicationSmmExtra.uni            | Bin 1392 -> 695 bytes
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni  | Bin 1868 -> 933 bytes
 .../PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni    | Bin 1378 -> 688 bytes
 .../ResetVector/FixupVtf/ResetVector.uni      | Bin 1696 -> 847 bytes
 .../ResetVector/FixupVtf/ResetVectorExtra.uni | Bin 1310 -> 654 bytes
 .../ResetVector/Vtf0/Bin/ResetVector.uni      | Bin 1510 -> 754 bytes
 .../ResetVector/Vtf0/Bin/ResetVectorExtra.uni | Bin 1310 -> 654 bytes
 UefiCpuPkg/ResetVector/Vtf0/ResetVector.uni   | Bin 1454 -> 726 bytes
 .../ResetVector/Vtf0/ResetVectorExtra.uni     | Bin 1310 -> 654 bytes
 UefiCpuPkg/SecCore/SecCore.uni                | Bin 2908 -> 1453 bytes
 UefiCpuPkg/SecCore/SecCoreExtra.uni           | Bin 1316 -> 657 bytes
 UefiCpuPkg/UefiCpuPkg.uni                     | Bin 23534 -> 11766 bytes
 UefiCpuPkg/UefiCpuPkgExtra.uni                | Bin 1346 -> 672 bytes
 .../Acpi/S3Resume2Pei/S3Resume2Pei.uni        | Bin 2606 -> 1302 bytes
 .../Acpi/S3Resume2Pei/S3Resume2PeiExtra.uni   | Bin 1354 -> 676 bytes
 39 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/UefiCpuPkg/CpuDxe/CpuDxe.uni b/UefiCpuPkg/CpuDxe/CpuDxe.uni
index 715766dd36ed291b1378c472dac841dc03b3e79e..5ac78100fb0e1abf5903d6d642709cfe3734598d 100644
GIT binary patch
literal 877
zcmb_b(TdbC6nz)`hs*4X4l~nLd=L?_(?&Nq)0U=X^=ZkpnKqCnB}r$UzxOsf?g}D;
z*g!*)bIv{Y<|c|DS}x(^Q7ZBLSrh@2!>9x#MGdW$Ct*Qq=ebfY?8Ua}r5BB#tboEA
zZyKXEGxI;N6EmKz?0OF`nwRkU`uZ)baeDP;1yp;XATf3{mV0UR24bZkpdDD@gguFN
z^L|@?cr;V>(!pp=XZZkJx8QpLylKoZa($M%gMoWtC08z(=a`a`jnGcC0YC5-2`4TU
zKVVHJ-C{Xr5o8T6KpLZ4Is0*7j^S*}QrJDH1l9XqHvMB*DIB8ES1X;j@-RK*0u`zr
zC(Ou;@BXLM#SGd!!vW6?Isop2Z14T}E{e>EcFklPu`#xbE({kPT)Vz3He){qO88Yb
z1d1~MT*iB#3{uLfl5XpYq)=xmDPabL9B4u^Mj+21&R`KUgfCzlGs;#$>6TVEd0oM6
zT$XWGQNkcEp(I5~7|E)*qIrf}pOF3yzR)aP0YM6eAYW%pfYW`kqa=Ompyd)fX&zT|
zeejOZ-`ze>>m9j^x44Lt3V!{r6xZFvI{`wkYX%GY*M436K|dudDQPhqe~R#%{y)8t
G5b_6x{tfQ{

literal 1756
zcmd6o-HX#u5XI+N@P7#17nR+uiVq?prn^ytx(WSY^-0nu+YPi$X|t>S=hff2Nt0G9
z3W7+<{g^v<=FFLs^xN02b<N{>z|XUnc4fKEEVH|I2dmBoSmw5LR?p5Xwh`9UR@iUx
zT(Qe-VQVWb!E45<_47HO*fky{z7xh9EEyg#bHTpAT5#*M$@zceJ_FU#HlWOHN(CjD
z?}7C`^J9C+?<uR3diThl*fHx6CRFK+wIZyDp)tXlvszH6XTIaf+lejC#LJpz<#<i;
zd~QAK+lvFt3>~MswZy*wp>oXGC*(+(OFYDL0%kF+9_no4x;5ow&R$qmp*pv2^5|C8
zr5R@veAM5}#ofl&?X=Et%UZfgY|N;vHx5OmjxCZZ*WBr28%4;3SNf><QB4IpY%A!Y
z!E^TS_OP@n`Rurm%6_gk2aO^ML+)0}C9SIJF*vt*)fdmitMFfOA}#A?W?vY8M77UM
z#pVXDaecq2IS{6Dhgm79q!-WJ`z4K4?8;y7N=DzMm?`J`Io4RlU{6uq{>dp(u6bHc
z+SSnBSOBgVB}Mj{(YN>PLs<3TRr3&Qh}K4|0>|~pE|>%C;-reu_8~;u0UiSvIbtPE
zYwR#9uA+9Bdv34Y@eaC6&J{Is89lqitM8CqU=N9^7?I1~XD95kDd!Mh`6z4U^$K5Q
z|H%B76Cu~T7}Qy+Dgyh^#A&04a1o;{<vc(54bqpf>#&PcJx7gx7IaBpNb&cHND(nc
zL<`vY)LxzVur<W*SHB~=srO-u0un~)PntL(mXLNp_xIn|PE*65;aB$uAeS=YhVer+
N{2u?m`wwZW{0^}`59|N{

diff --git a/UefiCpuPkg/CpuDxe/CpuDxeExtra.uni b/UefiCpuPkg/CpuDxe/CpuDxeExtra.uni
index 0ba595eeb852c1dd02bacbb4ad9da5df6f29f326..fbfc2e1fb257eb10362dbe1841b53fa030bb6d36 100644
GIT binary patch
literal 675
zcmYL{%Z{5c6o&UB<sE*dn>I>9Z>y@RN`l+5nm}ZOX1a<TaKIA5$e7HePu~Mc(-p%0
zFW)&31PEp`d_S66Pac8*>$Z<xH8wU^wfUn9NbgKjc2G@$wQam^{2;uFZF_O1tUTW4
z@9^>chfi1xkI!>(Qr2W}t#!&9+bj{*HAZy@r#tP=x>$Z)iEsC~v@#u9XG^C}W1p`y
zRG!;YtC|Z@;H12EM%CR|ubf70a@};qIq;oSL58z3wK~)qeN$+MA%t9~>j=4R3N!F@
zu*dOkB_nLEDP!tOW%BA?Yjj5{;wnr>n>h5>S&&ldv8Rc=e)a#NZZO1g!GZ2A5kQUm
zLgjt?B?xRwxVCq>URqZMH%Av7x?*vAS+-UCe<zO&JCXbp;TBvX;xZL{m8C2~7Dr4V
zCBZlXU$a;;Br(Dm(@>Ipid87NoR4!o@$@mtQapu1gmKE5L?R&APB6*hG)#FC)6oyI
z|HdyKM{_W;Pz8G)G^3nvcN@;4<(+RfqhDe2@Mc&JeITOS6Yh?Qp<usFqHM$Vakyn5
pQLUP?SEYt-7MY}z>3WwTba`dG&VBDxjp&&na^|evbO@e2`~{0m&2<0(

literal 1352
zcmZXUTW`}q5QWb(692(UUjVfUw<m-UNn;?QO`<dv<*9O#Hno(SoU}Cjc;GwhTU%s#
zcXoF6%-J(z|NYZaOA+rYo=Bf{tyBwL>A9Za_1>{Ix>Z;Acq5%?t*H`XQvJp=!*`~g
zGS(~2wPl@P*?&yzioL5amWbt??{BmZXXm;hGSUmsUoyYdYrWAstfOl6UWeGd0&{`w
z3>o}9CY(=0#wI&$7&^kda%?lp;Iie-bQicc^-&#-^r^aU&29{%G~8!H{2CPJSb|dC
zZ%2eRN#HysVhI!P?F%g;JZ9y5Db@nC8b877(^hhdwF=CvTZ!+}vm(PCwkwlp!sv6i
zobYajT{6jYEd%Qk#mpR;R{B_pHI=T<b*N#N^~obHHP>H3iz(y(w@u+-M03dXa;`0F
z-+BVihjoc$UCsZRoxDb7eNWU=R*#j*)!Y*`DbBA84a{lxKv{Rvj#_*O9lXZM)pdLp
zv~F_$jEc6NsK3QCf%}ZEdz`%q$_;O+NjdvI-xR}YNFNRKm9ec;);%<hP}TDoZ;wtp
z$BKi}=jt=Z_-ll^3OzbICgLn053t<P9vjTYHEM&o6V_fGR@@@}VBfq3A*0uAGMQN)
ze-Bh+3_|u1D|5HcImbjf##!^IFU0!fPv-CJn7O~ixX6;<BGyHPQ=|9LVn|;(XIIUN
zW38Y6Jgwlj@1W`&|4saFv38e*x<gP#)eSDe9)NldeoRasmZw-zKs%s<{s!h$Jz;du
sxetzrH$P`<p!1Nm@8`~N2fG`mjP4bGv##MqK<(m5!=EGLq|cY{KbC9HasU7T

diff --git a/UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.uni b/UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.uni
index 3ce8ec04cf84c5b76ddf71f559629dd995693f51..59456fb3e5fa012ec9497e5be56a32e590f6ae49 100644
GIT binary patch
literal 975
zcmcJNQE!_t6oua>?LS<lFI$vASM8<MG>w3_T1x=gM%|t&0}fas7}=&B|9-ZYwtLyz
z3KGcnxyRqRb{s>zUc;B89K_o<aSWwa?c4|hwil3=72vplD?e>jqXwuKn2j8}ux^BY
zkY22gVeGYgS!=GB$h*CgW2&Y_%dWTZu6YkvmzUSDb-xcEH-JYg21u2jl;&2dF@j_m
zAgB#!;fX~XecF-F&w#9#1}3dK%}>C`Hbmh~qfQea7oYXSt<aJWCIsSIz~Ew!MzleH
z;;jJwz~#W}LBKq=LI)F9buvNHsIirv=ebuqnz>#Dm*D!?%ch5?ZDlwC$JI(>wXEkq
zS%A4yInFMT6~F9L+s`l#bAj5eD@Op_2HW1+=_ZcV<Z#uj8xbkp#penW*QVW`2hr3|
zp(K3RErOC1-$-%*Od-RR5xlDy%Am?KM8FF|2AratA}Df5a#$tQ$ycyTD5jg>bcfk(
zQ8Bnn2uX5=5ru*PK_x*H<t$;i$lcUeSN;>e<2>5{awTpH^uud{93RR(M%l})TCd&h
z^6!Q3k2@pBcYi3dYLD)dof{-6gTJ4PfsftHI{{+cRuoqM>!z>%L6ISv5?uOtFC4E%
H5e1CjpBO5B

literal 1952
zcmdUvTW`}q5QXO%iT_}wFM!$vDqcVck+cRZppFtpg{R6++SF1mmE!>U^T2m@V>_vW
z#3Plpx7pb<XV1*~_pgq1ETBE(3+$cUSZ*`Bw#W7etM>X<*wQApwlVe<meOvS1$M^X
zh%v%1W;~^N?~)T^+6+r(8~QaTb6ePyd3AmTN@3rzSIA4^H~SUtXFM`IQ`*MbHMfVw
z@eDog;9qc?DGHX{^a(eA%6Mwe`Cc(Q*{)vLOFL#Bp;?JeQc?&780u53IkN?N1lDC=
z9u2ngRJeS3jjzdI+um5u2KM%Vf(eXrm)$$gEn%n_b5K%ZOc<-IrEpem=P=RUhI2lz
zbH_^Ya%MBonhYs-s+k#k%Jza?acb~&dg6RiY9hsNMxW8^+}g1acEd!v6!6epE0$s=
zzIm;WcK7S5XG1&3s=8{pG+ci;Eync1-M?*4%<2tzy%cLjG~GIb=WbpCldj@_!;a69
zSpUT9KC69Y0`8T%my>PJFSi<qQ@Nw8DybwFuibl9jd^wDU%30Vxqm@MJNMLIVaeb=
zq3ZUdw?Vn3HJUWD#6DUG`#zNv+XwotePJD;YJjd96RZ)nHewb!tw(mj7-E+u9-+xY
zL~Vz73>|XJOf{{(#VA~%witVEt<~`kyG!<k8oP*rUE(!x%r3A;pb8^)(Fd%=T{gu`
z@Rg6Edaw8RD*89ZPwa@f-eS0o;%^b!*BYlmkI<q|Whv(Q!GD$hv>nG?nyMYu_2b`>
z*Y66X7>p5Up<Tg9dP&(XY9;Xb+jm4Z^&X~FKuWLrQ%#(JC8jMH{$Ky}R;|asX`xCQ
VqJpZdUuW--9uH58Hu<S4;}2&<EPDU|

diff --git a/UefiCpuPkg/CpuIo2Dxe/CpuIo2DxeExtra.uni b/UefiCpuPkg/CpuIo2Dxe/CpuIo2DxeExtra.uni
index 512a2f65b24157d516780c185c6c3411f1e61fe8..655da485dfd4e015f38ad744058df1ecc8edd490 100644
GIT binary patch
literal 671
zcmYL{U$2@l7{>2S{0>jt&1O_Kx2t7YhSKdcQy>L$&aO;_3Qdrb7Tj^4elO_U6`_6p
z{N5Kl58ix^Zzo-=>BRG}ZF_Fk!K=c~<g(U(RDq<kx+xuGQ($YFPBq=2z3EMRwYsc2
zyv^TX{r<y8EQiOZ1vn{dGT7Ew*=f_P;MX-qwS!eo*^4SxUpC_FBQCA9Lu*ZG<$3Ju
zDg~M6=G@BWN)$NDPFXE$H`Yt5Q0rVZjyMOtvn<GPk-C=0TA^<WWif=1>wFs_H%*}j
z9tU$8?>0$*-7RHI{axw2demy=NJU(QcC?9Of13p<rJj14s8g@qzo<J5aa?hvdqV_}
z<GxUJUHjSdOiQ??x4BvwTY7hg^Ny}q-d|R2)&Aef6GJSbAHv^*CkS|w3ckrw79a})
zCXkX~9D#3Hm@q^k{17ugA^8j&KjFz@oa>pVPf?cQ*%!hOQ_d1Z0)oYYB`i$+lt&>Q
zeJA@b{N!P<03!=ku$MtI%K1LtaTcr|eDgW|3e(A(VL9}Hi0(kRF%v_<VIKwAjvYdO
m&p@JDHf1kM1=TFGgidDLI0N@0T-FF)7y_#=%Fc$w>EtggNy?)D

literal 1344
zcmZXU-ER^>6vfZ8iT}f<eNoebqEE&cOIdYe3xq<{r)GhEY|;W*Xf6Kn>hH{cl^U`$
z_ujd4?wK=}`TM7>wj#b){33nQr83><LeKS#sMn6Q(w!15)lp9mtVKG(n<*tT({Cbk
zVrSYY$6x45Yy1?;@ndoqtX+h$!mZ|FeWh*Kd!=hKBfS9qC38ow^+s>84r}k74zQCF
z^9I`$a#(sy*`I}qEmn?T=nV5Ju+1!o%bG9Oec;~G2X!^l$NJO_yD^NiaGn+UOHf?n
z7L@9I8#1g(3g;Oaw=nVAw$vgbVpgt~Vcme%;HN~r+e*%`7J->{tMI*hURJor_Wh)q
zGJ4+~JG`1>S4@gpw}EwqVrI_FYJIH4lKXD<b-BYH{>cuPhU>4O#f<U)(`IlmqB#_L
zxz-xrr=G&|@x4T{uI7KqN^wVK{Xo`JR=dg+YHrDzmiw2b2IjPRq^vt>!(F@&eZ0gf
z)OCIyv~F?!oEvRFQGZQj3iml(w_Cjh$~9l5Nj3XCUlqe@NFNRKh4DzI_z9XusOou4
zG@;WbSaDE#qCRs>yg_JgA)&KlGR^|>0LvZiagW)!M%`oX2H)O6%`MV**3D}WD%wAy
zl9~01C!iW*5UP*x%-u299Fyf7S1qzWlk1&7nZL1O=Kd$fWtHL-v3}Gz4SIqWL;A`!
zdur7j8~yzLv_ssn{kn7fn)q$8cITzKLr_Nb3C_VDfI0y`CZ`X}Q>-YU?Q?_v4_tBU
qDWiMNeQ-#=`MKI2IuG%!XB(`DccH`B<1EJMg&y`>k(28k)%Op`Y|Nkl

diff --git a/UefiCpuPkg/CpuIo2Smm/CpuIo2Smm.uni b/UefiCpuPkg/CpuIo2Smm/CpuIo2Smm.uni
index 89bac865d601e633455c8b03fadeacdf4f6dd62f..c3a212b1e759758377d78d30952930c86f935047 100644
GIT binary patch
literal 985
zcmcJN&2H2%6ovOlyu;OW1EZOwRBT!yL?$uRV)7%~QDId%i6^m?i6h%-nYYI_)0Pc8
znk=FlpL_hBYsWFf>ot5i$Wgp~6UR_#)h(?sU<Uy-&mpa9z;Ovze#xp<jnJH6F>>mI
z#t8i&eS<oL+H3c+(OjP*@A!(YshUq(_Jf6Y?R&Voyu603`+WGg0X$hTLaOwvG`CVs
z5hUXXL2W<_Pc6FW(~f+8hGc^@Fl*Ioegr;sAr5a_b)5Nh@_CQk3N86)LMW~Uj4t|Q
zL>Kf&-U;9jT#mdM1uRo1bTDyUM-wEinmXxup69irnVVN|39gTWYzKJSR)&*sT%9yl
z%VznLg}K8yEH020zwFcG&n%Ae1dUr)4gk0fu7kDnO&qJ)(W*taB2v1K&mAUiOt(E3
z(LBtdh20{kNcoK<IbaGIri|cS%}@q)ks$(J5a@A=3W}gCASqy#P$yr(E}@uig3}#l
zw`I-XE+Hf-7)BII0t8hAQB<&m;j(bQzPk3G@EsS~29RrUTc96a6XZCr_84U^cWS+M
zcgw#QelqTK9N&FjX7wK3Cp%XpDTBYCi;++L!g~Q?+SU|S|MRY|{y~x<ni5?3h%YR!
IN)iQ>-?C*b{Qv*}

literal 1972
zcmdUvTW`}q5QXO%iT_}wFM!$vDqcVck+cRZppFtpg{R6++SF1mmE!>U^T2m@V>_vW
z#3Plp7thX~IeTVyfB))O#{$|jzQEqujpa78YkO>uuxhPug)MDjYa3%<VJYpFSztr^
z!WY;XJ|o5m|CsTV=699s9Mfi4GTYFvLC9@kQ|1-U3bew$W3M7C;nA#DxS#RJ@JwkN
zYu6kfCf74`x#JuKr<$T@$%&t!z*ELkd(QWY*~#|rg}t<6<`LSJ=p{vkP=KL6#hNo)
zpi5v~*5%P)D{qC%pV#`DjJEBK^=x2o4=9<yD0kVuW8V^niZKTzCB}rY%3ca*<#-Mg
zt!>!n^E-E}6fb8s1FgxFa;O@bv8JpqSQV!RU%MyHC#5!0{ATnSz4omg3t=}*q)P!0
zowZ^qX5yRI`e=2(zIs&hIabwI!=>T+!)Y<57w-OPb7EF^!t142E28Pt89aCMB2~ry
z2D{IYIRC`wKBs+M0#22>`;%?=FSiPaQMse5>Zl|Wuifocg?Vk|U%1n?IekGsJNL9-
zVaZ@Vq2~6Zw?Vn3HHswm(Ly-)sh-$A(0AQS5TRs%mKqbR5%o1<7CL=LcEK2853qTJ
zM*E0*4)GW|<d~W2Sbd98xI%3)_T0bzj(0d+vM$uvMGWi`uYqHBfjt6M7_o~!;7{CT
zQ_KWk`6#OQdXKN7e`EZ_ikR#Eh1)3p6rp{saT@dpE&5cGVxAv-r}Wx(9CvA|c2w7l
zzdK&PE0AI^Mxcdu1taMtWxJ@Az~^t@5joTyn3DIDUR9?`H~~vcTQK}T-}P3l%fD%&
XiW;JZs;ysV@sKVLSCcmRsw(9VwW2Tj

diff --git a/UefiCpuPkg/CpuIo2Smm/CpuIo2SmmExtra.uni b/UefiCpuPkg/CpuIo2Smm/CpuIo2SmmExtra.uni
index 84ba7210c3541626ab29fa2bc6cb4181ff40cfd0..b1b82b03b701ef200d6c8c39b8cc9c5f46f45b5a 100644
GIT binary patch
literal 665
zcmX|;U$2ue7{>3H>^nS}H@a*?r&q=p*{Ghz0Skp3y;?fxpb1dY!jALP`@-hAYD%9!
zzxT!S;4PQ<cG0z(&pZ$NZs2Asng$1x%Ub_c1w?OkTRO<Lz}~dIYWq=p*PHHUby@Xz
zo4>>M{fCcOkH@DKI4Nr~*v?qlYtwGv*EJ@!gH=x1t132McFEV*xU|v^oi(ME&D7Ud
z3Np`4)5-Qm6li3xtd_N#>ZMhvb*@@RoFiW&3o=}#uI0H_7}`Qvj3MM|?jz);E%eCa
zU@p_!P6RmIQ>N6HO6S#UtyYdy#8qfVn>Y{mSyBqU3^Y)${`CKo9xQ}$!<pU<0YFac
zLe=-(XU{Vo(VD^LYGZ8aJsi$EyJG#gY`UtOK+-3MV-o*J{199q;37@<E=yT}EDBhH
zQ83Z-J&OcG9KnyU@CC^i*!hBs)s*zi)2BE~@$4swAElfL#0e61OqgI%>Zd%8=+k$y
z|He-q1uHPJPzC!nY9=`kj|a|z&6qf)E|+x9XK%*6(7z$N6X70NG8UY|ILHp{6!{?o
kiE7!FgDe$PyUxUXw%8vta4*Jn3lWA0tiCF{7z5|Ce^wsK1^@s6

literal 1332
zcmZ9MTW`}q5QXO%iT_}wFM!$v0#67bn#O=dn?$*&@KiaMrk2t;a?+OY<ALvtZ%Gw-
zcV>3>%-OS({r9(JEerVG@C)pV-CANRTi8o`K~!rOwy_6`EVZ_c?4Dm>mv}Ra$xQ4I
z*>hqe+gXOcwxw<HV=Tol$X&Cx@Ug@#=X`x*d*8dXJ2C@%1^R2|w!O7?_8#l3@;=xp
zc2r=luvH<0rN)^3iC1j0at=dfh*yp+W*J<ze3?Bu_ojWajt%W|b?Tbk7)FVoXG4Ap
zifTxM@_aio7VghrowBy^wSA#QKt!xmFTq-YR^!J+wOdNgu-48@x|R6aJufOeV(Wfl
zn=)$O13R>uVV6wuTKCSnL=iJ(CY3%?BIUm8eI4$wi+_2<rRMtNTFe;5?)bC`9E2zi
zxn8QZ#n-8)@I1U1sVerj#Pb^x=ilT!=X9(~uH~MrX|X>o6cD4`fv)PK9XIjOyEw(l
zwN-xRN;f%u#(lP)X}={hh54MGJFeaY<&LjbWNhCpgw25N>DxEPbGyQiP%=PE&10ew
z{WZY~UEhiIm_y<Lu^ge+KBAvPGDeQv$5J0_Y%mK~s14?h`|?f?I9;<Y)V@~??3%2h
zGwTtLKov&cs}J$ST`|=hldBw6&9lCetLnd)f3PCv`u~MRmHZT;{j6|m^aw2mbdzd!
ztyyub_0y}<^0;CrRln#B(TgJOZVGh=pbV=M+<@H&bpn1!P7jt>Sb?LRaC7SXCAS?j
os@HV?XXKAOqk+l;JgM0NDc~(=Gmb#f4R*b6^*&^1Eq3Mi9|TFv0{{R3

diff --git a/UefiCpuPkg/CpuIoPei/CpuIoPei.uni b/UefiCpuPkg/CpuIoPei/CpuIoPei.uni
index 366efe43d43da50c50824096019f6a0570b0bf3d..0d8a14ef12df58a316b67500b789a08f2fc37563 100644
GIT binary patch
literal 947
zcmb_aO>fjN5WOSuA4b~?tag)vxPTBMABI}&CXwx^aH^cdn^?-mk?j=n@3GCc<-&<N
zlC6o~ym@ataSZWx3!hJN6fa-IF;rT0ODhc6K|og3fa4OX3PZEPV&v3^3nTQs^eA--
zu?HPwqq$xqPxIVVnVMHE`@zDi_BFh{zJ3pTcf5JG13XzVLZ<YrG`CVs5hUXX0c}7F
zFI9BW$CP|}RK^BrVAiVF{0w~Rf(PEV>OAvl^(N2U3N86)f)lO<jLz?5L>KU9-U;CM
zT#mdM1uRo1bRcnAXA>Z;nmXzAJT@t%xoc8j39LT{*$(hfR)(HCU7a*m%VzoG1(<t>
z)8ZUi@ykB+`y$54T%mFI$|(SD1MOh#{2`9j?BuFNw<1!yk1rV}ZcMko1kpUqAth|=
z20=y2uOvAFrjTRG2u^E;a;S?O5%7TE0cWV72+9JI0yYVC@C~F1#dH^#ZZW$lYX-Lo
zAxXh7qEHebs3M4>f+Y->h5PlzrT>6$xX5>aT#74!zI#l7<70KeD1REK?beNz|E_$0
z+#5N4cgHfX59lsQU65o9{$5ujpZbOO0>rehDQy0Gwm1JMpCg(PTzOwl0-nEo6zcy5
D2T&i9

literal 1896
zcmdUvPjAye5XI+=#CNdL3!pXu#07*9No&9YYAbP6I8}Dirk3)ja*{&6Jn(z#*qc;A
z;s(g_?s{kT&6_u~{`sS09SeA$@C5eOuC1`CUD-o>z^-hGmA0_4t!>2qlAV>^unO!H
z+mJcJFLs^@>%el`Fs|_}Y;F_Q^@%0tO1opf###{3+iRpxc;t9yyc=sbZ2omtrzmv`
z;}ZT8R9cbSBXWJr{M?@MykvE<{d#6E?3i_gN-LC^vKB%KhQ^HDg4G-a0_$RzhsRbe
zN>`Ig)hnvhw%69PzP&l1Sqh`VRq&Q`3m7WK43vx*W9GU}8JtIW%wQthhI3UVXO5NP
z6|AP9`I@L&>We8h)pw3noIJixkDX6O7i9QN8FNORTRRrQ_DrNp2@mC3vlKJ&EgF4f
z-S4EH4eX3vb&}`exqfq6j2MNxpKU?Ry3Z@U6l+N|Wu3!ww=RK6SMk5bQq@STzvFeE
z)xI(Td1dad<lFO$tp?(>+EG@Ww4xTT+?`a9RqD#WbosT(zoep_d+IOQ$>Bbx>-M9!
zLAl}en)p>}A1s7@LMO%cp0R76`HoOEKv&HvyAi!MWEDEChjz{!vM)_41Yd`U-VX5?
zIOLd>dRk+PS-3)NG56fJzK(a;U0@e#>>>tsfmh!#J7+%vRT#00-sel)wWpXVzVcDj
z%Ih7zivE@PBNj2&T@1HTsw_hL(%^XX2rUviOEJ$5{+;wU?KtkzRPRyKKh-^|^t%Kp
z24e_XXqPaOUQ)J;S}A;f_Z(48-G>PskTI(N)DtIQiD?UlfBV1PY83dh?A1F1@>X9Z
RO}!2&@IPeVrUrHOe*wroA&&q6

diff --git a/UefiCpuPkg/CpuIoPei/CpuIoPeiExtra.uni b/UefiCpuPkg/CpuIoPei/CpuIoPeiExtra.uni
index 7aa54a3306e0d3e665abe75afae8ce87115b3233..cd1f53a0cc23253b811ffa78cd7e5cde88e4269e 100644
GIT binary patch
literal 667
zcmYL{%Z{5c6o&Va@(#b!O&cYlw^dbDCBf}jO#s=TX;+a04p<@>*)Y@e>3bmQbcL}0
z%Xbb00fOZcU(cq|^H~sJ*A3jJ+F)-B)tEoJgzTMZD-YF{*x9z%Z9htHa@$><sp=lD
zi#K@x_T2}p$H&JNI4K)4xXwD&8{2LWHVr1VhtpoWCtYqnZ^f6FxU4oFowJowm#MF>
zHB?d9OQ+f^QQ)F_?Tl*tRIi*yV+!4R;vD%dswBgcGL1Sl8be!ZhcSd)m)i)1ZA&xq
zc-ZrFx0Mn0x0EUMxi&@pQfss)6>*iu(<V;CZ5CvddLC$^UjOd@McrYD<BAjATOxp(
z_Jz9dyH7!2JHoYtEA+;?D!4m*aPsB){<7)n?*C367*dgZ7vTY1BH}U=e4A%1LLNs<
zAS1yv0^hM%G9)p=7>iJne1UB!xm-<iJ@V`!$um5LLWFU~nM5KWSSpxgaTaDgiRtJY
z*?-{&kE0bBS*U{j95s`iAJRQ%(dLD3xujoVK6^DThdvO|9SJvOVk|fwk|^J^V;mkB
iNYtpd8dRmB+jTDKWU)(g@E}3TI1aWP8oe0f=Ci*)amk$k

literal 1336
zcmZ9MTW`}q5QXO%iT_}wFMwK`+Y>^Fq%~mC##WjLc&eOBQ%h+aIcZDy@xXW1Uc0F(
z@6OE5o;iDFnty*Ii!9)K#b02b?b-@k*}|UNGom^>wT<0bVx?uo3nJ&(Gt0><><_Uy
zu}j-og}=6?ZSiv~#ZSpybGC4+NA-JszOlW#yR;iJ1A77bOZK<++TPeZtdrJzZ^zh4
zgSo<1g$j;ZbM6<eV#rA!hRP7H8e7aNxNP|<yLa3}`)C6j*{Al+9lJ4%3iqB3`6Vc-
zaSMun-;Ruh^JlOwIor6ieWOJ{M66V=z*>RU;paqkTT0Hb){dEU^Z2?wZz|klt2?<(
zS#|G@8#=A9J(IfDtz+#`#7vn*tB;f@>2`N-Ko8IG&kwkCTpyekGgh%Xd~E>-A&Nt-
zmuhYC_39}+ANM6N=_>x$oYXxM>)&KOWp$`bt>&JrX>-49G!UoVBV{#7J9_cKO>v1;
ztE>FVX&v(ZijGE4)ZY@B!hO!v9aaxPx#9Dg_+9V$W-+WX<|wtVtbMz{PtY_#RqbP<
z36nO#ik;FE8?wj5JA|$a36mX@ap{m#EKRi59=mXb+G8I$U*2)cEwCS)i&yF@%I{N2
z%!b4hP=%4Y>LWaHS4=g>WGP2g>#Q&2>gF%@@0^Ia{uAS-O8tu1ezrIrdV&@ibETSR
z7PcHa{q*Y-xwv9S?d0g!M87T4?y6BY17*~{;0o*%)Cu@8IYU@pU<D5Chz{z1U`f|=
lR?VE|;DmhfQ?(vCXZX@H0!v-gs{(LJra%+AAWOOa`w!mK%bEZH

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPei.uni b/UefiCpuPkg/CpuMpPei/CpuMpPei.uni
index 00c41e2faa60bc9dd497538c9c19f1a14f41ab5c..d458d0d624b68b8eca4c4f1254a1290201731d74 100644
GIT binary patch
literal 852
zcmbtTU#rtF6n_`|4u{<r9owpcFCt>MMsILyOVV=n>5{cs8_1H9r1S3Edzw4%1Q8L_
zrzF3B=kz2=AeqnM<3VZp{8^H~rmUfL>LeW~<Ac!J$Fq{cZqz|72WK1Uy>(EQbTx7Q
zk7tLoQ(Yh6Me`Egyn6k10n`MkVPoB3oe0XB6{K22gn4k%OLvm(>iwF1c=E4$<pHyG
zP8>m)7D6vUG>ttD!km@q;3$H0N@ySR3MWCUMj9{Mh(C%J2`8bn*lP)+X|V;92(peo
zLK<sYHRbVO5AklzGuS?=MAh%TYWgQzB|V}rSF3z*YCk^K0u`zrMyx2vhwxMC5(Z<Q
zVUPC~6MzU&whv)=mn3$;xOQ}nTv^v87lu#vzFl56tDzsRJ-H=Nvf?vKcR)F0lvj+d
z>xyJh=NVy8At07OHzel-iX74$W+_Mb4Av>9d=UfO(dxFSE4WJ;OY@2n4g~{7N=7)z
ztF)p;jz^!6{tdp+JX-)k3R;k_6DGpxuG~_RU1w%K$Jv>_o2fnci!k5)uE^>wxlh-)
sNjDYzx^A>E-6%Q<(kyEZGy3-to&CWeBYeYXIVHbZ{ATcv&mo%q0K1I?4*&oF

literal 1706
zcmc(gU60aW5QXR3#Q)H+H)?i4H}S?8BP>-Lb!iredS%MTvQ1!1pzO+@cYV$j+O5Ip
zg~pJ+Uo-E_nKP&5?t9Bx7Vtdb7uajNwAAJ{wTJeAQ`ycewjuMxR@iQ^t=Oe@ZEMRd
z!F$fC@{28E_t7?-=lGr2k{g+gxw+<-`Tdxvku}Ra|1)0(!mU>~vnwzM_6W3(nNRJh
zJ+tR_%sQgtoEqk=&%BDIkBL{AVQpe*J0HQlXyRt&wTn6NH^K9zb?m}k9jJc*hSV7?
zc$;x6u?0~Qa!i<WJf^-MgEPanblcXuGQ+Z9FRbdAI<zkHD2mVooTlCr^--9r__{sW
zWw>E2MI<(2)V+<PC{(aVQsi1V>OD#!6W+AsM@(cWtg4`6ee1ISP{UGb;nukrGYVb3
z+7vX3C=3N($|X&z>Jd1lzI|T;6R*O5>B>|Wh58%g&#3Cm6l`ws8tv|9I}U^?zsIb!
zlhcbA{^m$kQy7rqH(-+fo2*wh!(Pv^=46EDgtw(`X%gj%XV1xgRz2@51XYZVdiIvF
z&08m(_8GfA4>*lb+7R#1nI76XbI5rWq3S|}vO_%j9=XR#iq_a*R$N7IFn4^f-EoO6
zuus^9tLGWDZ<9&L&N+{Wsu(@be!))Ib*7vHyyT;-h1VN=b@L1Jdn`h(H!<90DXIwV
za~Y?K9>GP7u9UNT@H?X~UdyqIQ$0tedamhF01EN<l}J5e42c%9Yg2n+X~Wh4zhC{1
y{Jl}E4N950dZdUGVhL#jbbsS3+9<2|vkKJzKG>y=xa9m$6~C|G-~KyPmHhy=@&yb4

diff --git a/UefiCpuPkg/CpuMpPei/CpuMpPeiExtra.uni b/UefiCpuPkg/CpuMpPei/CpuMpPeiExtra.uni
index 55ca4f0292bf02765477f80a582ccae533be83d1..cf832fb80b41a9bbca266445ade1e378bcac73c6 100644
GIT binary patch
literal 671
zcmYL{%Z}496o&Ve`VL2B16A7q5*su^q>W)Lnv3j21FOnS+{BV=N48TaPtQqOI?LGq
z<vYiTB8Zkt_<B-W&Sy~syM9RfLMqtXT4?oGHo${Zru86913PPiG+~t9<hH*$)ph~i
z*6-ls`wyR1KvAMm>3Zu#P}Xc9)*2?62PeIB7ujr{w(QFzr|gu6-r3fP^HdZ%38Jp;
zxfkY&^>7wJIwiE9dWDmqRV|H2z!B^$8Z=yl(&DHk45pC|#t?L!Z|t=-jT(78*wb{k
z<q7O>DO2k2PSxF`R!NU4<Z6`16&#1#EKp+VX~2ns{1g61-C>a93P-%RNC0A56m%i<
zpQFh3h-(K|%Z+tyba(jZ=$rNZW7Bv2>rS2t6fFPF;uI){gz}QnZB>#4sw^Q4N)${Z
z&>hJ*fjomagGJ0yzJP7aDPK)<z0mSGuS$4{8H=-$5)L^7MhZqa$;!B-d4@;d(Eba4
z&@5R2K?_!ppQC1y)3n%Al58G)%O(B;^VyqmIru<GcR<{Nu(9Bf=1H|Dhb&GBYP2xz
nAX*91tSdgBEp|l(>7avJ<Ez)wd+VSeG=;>ei*$=Ic|Q9G>F3SV

literal 1344
zcmZ9MS#Q%&5QXO%iT_}Q7eGw{NW36~NE!ncZDM5+@Kj}MYAKB)Cus>k9{A39Ya+|{
z-r3HaJ2Upbzin$<!26mfu+MgDiLGsE&+Qpn*)DBs2fJpC(I;rGEVa2!@k{Ivx&^wC
z?JYyz*vfXuQ%=%f;=94N^tD7S_uRg<qsOl74$r_|g8qvAoxQQQ_TDZyM+M5dz|7#2
z5;Y|v@f<BI9XQEDOmZ}F$;iIr&FsP1w(O&IZD^mWTh@HWa7g?HTl`Z{l;a+h@<w|+
zmM+iXnPS_z?O5DCKqFSlmvCBxR^w06Dq6LhbJ{pFRjR~S^rFb{z*+s6+Kg3k2O?z6
zIG0TFT=&kpL=iK2CRKe@iIo1<ab3FBL%urUQgeOuTFhC+?)0_^9E2zidA*cthpb!A
z;Q6#KfvK+Ie~TsWky!u6>zvhTW%6ns@tPI!X;A}l+CQnRW@k??KKR_Gobu|*Kl56*
zxPL}R+h^6^p_##bVa+p33zR$FvL@xO`+TzyRxxulu&=Bgz7fsoh_&bY7;VI)P4EuA
z(i7{mhv;jBx(g9sONhtFkq4YK(OMhq!WDXhz3Z~1i;7!dKd_6}z%xqjkV(w?=p#^t
zG4Sj|BypEcImdX(M_F^PFZe3*7yEZCVy-VSEVAUc2<>NuQ=>=JB4)0XvuCY}V_iS}
zZ`!Vx?nN~@`hVzeqT1aQ)r~<JRyVi-djRSL{1Bf$EU!7`IQmwEabREh#Aphdc#qtp
oL5*XifEZ1prnE_i^{wlB-0^5i)LGqBJ?$YU{_n`BzVejse?!L4(EtDd

diff --git a/UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.uni b/UefiCpuPkg/Library/BaseUefiCpuLib/BaseUefiCpuLib.uni
index 951fd46a837157f884114e948190ff7f23b7b381..1a1c0d2411b8428e36699822e7a64bb7e7d10493 100644
GIT binary patch
literal 912
zcmZ`&TW^~%7=53#|8SJPY*7kbx0g-RG!op^YC<9|>h@GQV89aC$adQ0-_N+YN!vgI
z8Gq;UeLjRC!s!&>YtiwyZ^96HD-1fZ)lBbE@mff3U{uec)z12rZJ7nr91WLTixRcc
zpwY)$)T|fX9*a#8jAREwe&Rb(jOc>gQJ8_3q825yLP?aWA3DLLJ;N7j*lW?W7VpaU
zxV^dgjBEG$@M#7rE$^^UdQjTq14La1Uu~ed;rf|Z!Pj~E?ZS;~Z_ujItOt`7Y|FvQ
zQJBfSkPUifT~n+x-u-B_6D601SH8Yyl><C8(XnmEv6B_op2VSg<4Z~<D>3$CplZK2
z&tfcJSv>1YE6VmHE8K+bIQB{ytHsuhS;+wIC^+h!>&Wuo_DFRw<81D+b^FRW0JEO9
zwRZRthH7wj)lQc@P`U{Z2or8ib$wU_Lpykgf8_TBn{@pnjaHx;Vw&YCofkQYQ6w=*
zF&6k9=z=5}!8$>dU=n4ne1dtD(QM|K9%+8RE^<6ZX&NOtB^lN!QnE=&Mv^?r={j+r
z?i~CV9%vHJKpezLke_3XFQ==`l9KqGf$7vmX}qt-`M5K3{+?FrxLA^>Xzmu#BFE)*
z)iK%ZSi`~Pb&+8bAA)>L>?w%<h^`4H|Ivy`wn*t_Y~rl;m)3Y}#~<jV<CDF|i?FRv
Mgb#mq8U9z*KhF6XZvX%Q

literal 1826
zcma)-TW`}q5QXO%iT_}wFM!$v3NIjpNLm*xpowx(;i+<*CXLiw6sIly^T2m@6K|ZP
zqO$D0&7L`PW_JDePt9r;@xJ1T?6VDRY&Ujg&+QqrTI<?1b2+^m+P*C;<$Yj0z)tp4
zTCL|cvkCo(^_kt;a${`?O3F;+cFSgjrFJf`$`}vXv!G3^Zg1__&7|OokG!2&%X(HV
zn3Wj{ahu;R3o(~v&tf~nlQ_?r$?&2`GRJWYlPPPNi)Zd|Q)ZTXy`Nw;hoRya5v5{$
z!QPj&$M%}%J-wsV=#9OzL;8usy8>I0De}4dN+a*T%1WJeSp;n9tQc~q+#TNmtUg-9
z+V<%YZG86T?3=+*`I~^Ehz7LEj5JB%ypC9F5Ac{`A7L$4K2s@t^1@HZrnJwnnL1{|
zUE^!FDn&DQyvk=v9jVG9szfY=9hi7u6OaOmn8|Wn=%dvcSqu9b*0EE@-%DIVo!q-h
z&iD$q9PJnmLX;X_FZs$DOZ)z+n#DnR@ux!khphM<iS=*nw^@~y@oK7``!0S}z1KjT
zmK(~dl9p7(2X_utV_sd^FPzp@_Aba!4F;R)=gjosKA`H#D^*agd4ndQ*R`*liilIz
zwx)gITelyK6I6}RRc)8qgj(y-i=EazJEx7AmnI$|<RPK9V=Oujxk*not#5@^xI(Sa
zHr!aF!wq&9tP8d2JVthbRogK;XFdT{7)|HB%}CreC!bwxWh1ZN>I_?X|3&+a6*1RY
zj8|TK6tVp*Z~}UQ7A-1EK2P`F1G+(Lj=MC~dr;JmKSy4_OOTpi^gxU45=PQX%GOb<
z3!lfH1G1@8HKGDizN$af#1U9xS^>3uBX8fayEo#~Zrz-SD@ANii%V6}AtF^wtH{K@
q*!~}v{y~aX)x7x!+Kp#@gZY2PJ@z`$;f@G5f5)AueK-GRtp5PaaT{y^

diff --git a/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.uni b/UefiCpuPkg/Library/BaseXApicLib/BaseXApicLib.uni
index 0a9d25466143888b42eef36a50536f8323fdbadf..49b05e6cecadc31dc65d0ad1343587b742c0b3aa 100644
GIT binary patch
literal 980
zcmb`GU2oGc7=`bV_zy?j4ODA05LXjIq={h`ZBiwv23M1txQ!(zj%;VF{~p`@7y^we
z5-E}6bB>?ac^yTFrc-?03CUl-iXv1k$5PcyA|6ByDYlyF1I#!KN?U`ccuf;@s^L(*
zJj}f*7&B%0?b+%zXDc&i?6`qErur#iz<aipyqSYqG|El)%A#d`BROhjxCx;@Tdw&Z
z&PJG{^|ExLhJzOS*5Xb57VmG~-C*WlAFe@r%Ow(}9X+!`^>f5hBB%{CH(WnDijRxp
z(<QEI9p9kUUb7C42-fWht83K_tUri;kB(Wc1(Qce<`G5Bd&8Tc@0i;i_Q-_vpcwmx
z>k#5xoe7d!^^Nd625J}P7G;X%G38XcsN2i3!tIdtT&{Yn#dbW_5`NcibQM|tWY1A2
z7>9YlmSd+J0hkT3t+m5#6sf`Cs!`W`uJk@SIZU)Q&FnOo5A6^v;ZfZYtc(0>5wAc?
zq_nIGy4X}C#U@Kh0WSzO(1c_qL7pMbFo{bipI{M}w7d>U_q4jpHx=&VqKLDKk`j4=
zf~*TtlB|j=nrH6Q7ia&0Z!}A<L7c@cLB4xUkki$ANlE(Le$%OILw{fS{c-=u@ja~a
zbh9K6@xl$_q{8plm1O;XWP9#fakeQjDPL&u$qT6|DU*V(J??YvU#b85Sm2*WBC!4f
DP9iM{

literal 1962
zcmd6o-ER^>6vgkeiT}fdzNl$IjZcj+f?aiE1;R(FPtC%%WfQ)#P%Zzw`a3hgK!cx8
zhV0JQopa8dduRFnt!6cIJWu#Jdu`WN*x0V@p*>($Ydsq=c6M$v8(PMyv%1ZR8`2xo
z4y<Ipv=!rp-Lf_(wzMT9XLm%mEwwlFC(P#_ZDv#UuB^Icii}O7mPDPhW1n?{bDuSX
zNz4;=iF3TCb+fDRYgaI5Xx1rn_#N7oymR)1-BZu+ICn;D?jxN)`@%;=rC+@_C9}Wg
z%yDV4$GXATv<`n}__o5g!fwEorbn<orhRTt?HP}=lkMn*9n()yD6f<iA(U(HGiD3M
zQ-8ub>xzija!I;%qSC(bmKQIrVI6yQASbGV;NP71848v22`IrM2Vba@49!C#CMeO`
zihWb!m3^raUqNpScRao7C%CA(QjVl7-@(`JP&*lVGcd-yLmnNuSEhs=l?1K{NKvJf
zDYDr5qtzL8ANMt^YiEqliHcgHR%Kl)Bagd(+5!zilpDdXko%=S^#Gl_d5O2{nw5|v
zslFrXzADvxR1@6PjT;c}&_7#yptCM_oK+<)$;GL^&#JNDuHs9NSY>ZXhH5C-<ybH?
z;50c^x4%*aWyBLbiM^h^w**CPDye1fc-QSC;}lmNzN+mpn^J3idWrYCZ%x{Sd3h2L
zVjlGMNQmfq<Q6@BgY>S@3RkEV+J+x%biAYPf_0&`JfpJ<qB>q#llc@>VYEDZhmo{v
zPMker6(iOV^_Ez%f2RGwij?avCTo^(io`x`aUyz(7i}s_oM#8We)<yEymoo2=ZGAH
z`U&?a_;(3X3yeN!iCv;de#zN7ZuQXfv)_@wIl{W7R&IR#s3uOplF|zAzx#?;wtD|e
dt1{h1rK+I4b@!0o-)sHf|1F&T`@cl=^#|E2F9rYr

diff --git a/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.uni b/UefiCpuPkg/Library/BaseXApicX2ApicLib/BaseXApicX2ApicLib.uni
index a46183c0906ea66cb91540b22d7bbf454117cd3e..97f62273ba4155c4ded793288c8a7fa3b5e2520b 100644
GIT binary patch
literal 1067
zcmb`GQE!_t5Xavq?K_;(mn}*{SM8~qra9oP))I(-sM}NJ7$;Z)jBJx8-@a!jX{Sxy
zUIr4#_<#5R-QkNOh{j|1vQ>?I`zDH@tR*b8;0=&o324;DaB~DZ^u0FD!r_LjSPX*q
zeA7tijTX{cZ7e+2O4LyEy@W&1@UFVZTU|*z^9I2r)lS}CY<#+l4Yzh^rG@51;J1_o
z*?F&O2FyXFal6wFjk*c}1h>+Lq>r^U^0&xJ*;DAVb*%fNQM=l~JMkWFu0LGE)W1GX
zfOSqb5Nm^#a;J1R1JX1Q)E11i((IAq(>(wDoUW{q51X(vyaivd!~St0bldapsJb1r
z+)1N&bAsd^Q3=^uSp|K|D-76k)r5WyT_sIOf>Esv5}~_Fc^(UT8}{Z!0*h0YbLqbI
z7h8oLa-IvTcSdc7Q!U}wZU?N$$%DJ3I>R955jGOG8VP{AkhXTNzl|c@Bd#8dkTY#|
z(K*6K8(U4!i&<ayAtXG?I|{2j`<9a>umTcRlsTKPOPatsO=u2Y5NcpCO$!QH3M7RQ
zDNsIwIVo5%37PI$d6%tAxF>l|(vr~vvK(@{%4tE<l9Vh<@zYlf{|Vn&noNLV2wKn|
zUK8YOxmqxqyd1yr7>}X9uY7;-A0gkvGE3GA`atHmAaM!5URMq8b_3r@Jc`qG0i)vI
l<KSxU59zDZFnR?bp+%gtm9Ojt;SYfSJwZ6Vf0>@Z`UE&sO0NI_

literal 2136
zcmd6oTW`}q5QXO%iT|)lUjVfUR6JD(kx~N@C5e($g{LZMZkC#)vYnFtdEh&{jn^&Z
zqKXG(+3VezJ#*&Fto{94!y4wepK&>RV^d4*!Y20E9<eIhz~;=I9ox#zZHU!b(=PEl
z=k0=VWEtz3T{F*ZjqMWO%nD}CHnxv{*IM?LnGi0yM?Q+<J@dE|d~?4`d%hA=_;cRp
zcwc!2n+nd*mNxzgeF4H4-`whD1~HR1)&lDR`)+5mWp_85p=Y(Wg~wF3RSmYgQoI}<
z%QCMq@f{f#Jjd)2BZpn_Lq=jRor5B|_lQiD{{&@Z|6R;6D&@DLZZWo_L-iFZUxSv~
z3|ujIg0@c?_wBj8;C8lG&R*Is?=9F$D^*(v*-cG{tftJDKEoz<c|>gGDc;H`^L3LJ
zuk6rz_WGWhsJnuGp%Z588lt!387f?OEi^ypT47WFEXgS4Im2_oTwKLM{h60>v}>!P
z`bjksGj+}uU%S;aTDjs@|HuAZdltfW#0V!L#9Dw9QN&Dq(^4N<SDdG~@6h^o#QYeq
z$R$>)+Vyv{O<^cRaR_>a+7~|S5vQ(Nmw0NYSVE1&dV|+pR_gi4Ca9^CJo1`M$suT<
zT#Jgb>ZF2N9Qf~qdMv0b|I8!S*_%<J1`Mh(a#luUGp6fqTk4?9xuYiWZD1cPfmfGK
z>ezdpP5Z>Wg{lr+H4a#9(Q7BXC0^?jYcnRSOOt>Q>!5E^f=AyYcX-pcP0t#maD`f9
zJoIzTb}Q^ou?w~1BRV_9tLK@uS#N<VjE;}qV<zreQ_KOr@=?^_^$uS}|HAkYi<s*y
zCO1(+7Kwc>aUyyPExL4;VjkW5_0t!=;kipw-8<AE^iMcPLBBJQI$)fDme?7Lq?eR!
zqSgRDzq)q($r09?UYYs+QBUlFC8jl=|KjhUGoW64=)a*>s_=ITsDJw8uHNdFHM>uR
SKP&LR|AWH6_hJ8@sOt|0qfD#-

diff --git a/UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.uni b/UefiCpuPkg/Library/CpuExceptionHandlerLib/DxeCpuExceptionHandlerLib.uni
index dd98f5d6655dcc13ed04e1d9c9cdb749bf5f5c23..d59ad7fed0bb9949e5595ed3856ef838aaaac728 100644
GIT binary patch
literal 904
zcmb_a%Wm5+5WE-YKMb5pYuHv_r=ln-TWn3#mJB_R^c2t%EfJ7Nfuxf7?@Kan(n~Kz
zL_h?onc11uMiHX<9N$i&=dWKy5jKYk<e}!H6-r{uWYcqvUK};kX9#I5lQqXlX(TrU
zgKDOpo0aFj3}20BE!xiFP5l-h-o5{brQbd+K&9n9HcF35GjDH&xbG3r2AUhL?|8HN
zvd+Ig*(p0=FlyCmHo%2}?KoInt6^mFEM$v;S*``^O|Z{2cVTNT4Q~Q|V2vZ(G10SQ
z&oRlywZn@z)?fmpR<aS^kAXUcZ|fq#?olPE-glzzp2`Yt9Lo7>gt1y2r^hTPo$6_F
zi7bDxf21yEoXs<izVFTfm<_U>wd3a~Qlqo0CSCKD(rt8MnCNJl<>jy%yD?D0tK1SC
z^6W<*??DSBv?z1Bu1b=iN)wX9140J6A!$L7rHE6^;=;jaSjPn|7D4HnmfNf<aUJJ*
zoR*Xn$a3W5kduO>Wn9uMbywdV{TF`HG+BT+iYq~GJSM>D{;;DYd7h#9+|80-SH3^)
zA31-w`z)z;<ThTrL%b>R_jA=V*-otG;Br|NnEmGz&;C&~A;l)A2cPD-?28ut4d_P}
AV*mgE

literal 1810
zcmd6n-ER_65XI-&#Q))jzNl%zuP0-S(5|{s3xOroC$oGAn?Pw6TFXDL{?07yb`2&z
znTBw`X70?HGw1HFpDk-y;QxeQu($TzGF#Zx9@+y=WjnQ=4VfdmwK0|}+u*aZOU^!6
z$~^HKIr{~ck>#A`wq>7TUE?n=-3`QFVGDL<Ux*lN$$nzj9${_GGVguLzoO<Xs56_{
zoN9tSqMFCd&+Vx_vlpyR%H2ylW*t-UhKd)gPrc?VAJdY(CYCmKc~r62zMI0@l+zo=
z39P)fj`i)$0d^7)Wq1cL=46;Lrmz}zoeAWdJM$@+$9OF9R6n-fof)1>_QEO@DR|ap
z9!1IhwmPd0s-MDC#n<hL`=sDa@mnyC7}f7<Zpf;h?~xR_mX5m6PjF=N%u0S#(+a&*
z_c}H}H^DyDuvAL<;arRvg|1$01_nhGhJr8Uk~UTK2%LLWt1rRCYoS+ZQ#}&uTgE?8
z)tM>Sl=erv`>P!X!nC==tdz8&7q9%CNn-`O^3R>?rYmNKy`E#u$q4KdR9Ck&i8AM3
zaZ;@kUaMYQ4<&W&J!9KGvyWj_?@@EYX^hr}tRm-nXy?ok=i;P@Q1u~3+YufEkKAP?
zO>1m0E3Tq8m^;4L?)VP63+#&8^^CzT@aj9VbIxO;Dn{3{_t^=%&XhC3S3b&Gc)i0{
z*}pP>#3JN+i_tDiQANa;XCJ4E9>YZsWhv*`!S9g1kS)h9PW3-3^>fL)3!o5x--y&D
z#*k<cyEe5KmNsl9`2Fp7L^t&wW+)(Kl>VfN6JiNz<3E3k8)dcsR;hF{0HZY2D|>UO
I+WTASZ{Ix_U;qFB

diff --git a/UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.uni b/UefiCpuPkg/Library/CpuExceptionHandlerLib/SecPeiCpuExceptionHandlerLib.uni
index e5530f451ebf252a9d15fa2e1b29305ab8572ee7..b808c812f242b32809056d32996e451b78511b45 100644
GIT binary patch
literal 920
zcmb_a!H&}~6ucwx52Nk{s<wd@Cxj4bVyMM7iQ-fXr<I$yiKWDjY-id2J&w2Ra^b|r
zQY<?&^JZRN6d_tJ@#Q3Y@%mL1At??Z549Mb)CxPUnqC<6@@Tj@Ln`aIss&EkfRQ9B
z2*seAsTX!L^IuLwk7py>&f!h{7T53IUt>LQA6B5si5`hIqc(iDxk23b2xto<tT6YY
z*?iiTpPwvMowOK@ZVeycL&0?dysq^ya&?xf#lW2~lJ_=5;70h+wNO?x0YC7@6Yja}
z`LP$6RO8z+i+I*x1Ekifk+UBQeG1>UEXB>EN>KgP$+~+gD~0ta@2ip48F`!@v!L>-
zr^zRB;=%oqx|s1c&p6Kg_YS~aknNlsKSq%ry<I(-T5PmwqYJ}EN879~ht1fHff8QT
zj-V*>Z)Lm(Wk@NjO1eE%B*h_1Nr@Q{GSGx%j3CbtXIR9{!xz}bjIvcwx~0`FKUBDl
z%QDU?N*MAIB`He6NLIxa%`<=X)zg3CJI&G+h^P1x<j0H&aJnyUC`q5^Xu0(BG_R|<
zKmH$ie|P&lJ=~DHc<T>wQsM9Cs^_Ymcq<^(`oOUGk7-`~qi{-CQqp2h^j!MI3;zZb
CbsByE

literal 1842
zcmd6nUvJY;48{G7#CN#rUI1+^OgtfkXuALr&_-RW!4pdV&_-(4DeYkW@{Hecx@18`
z;*BYaZ+z`*A0PYX_E*bV7I>fW1bb`WEwiP~?6Ey!SGKMtHe!wJ#wJ*<Y>Us@F4_BF
zDeKfv<mgK*W6RmiZHJy=-QX`ToejiaV+(dpye{z*));-o{?x8L(#D!){)dQT4F@}_
z$ZT#4stfjn>YlQm+H-q>40cj#FYTD`7zVa5u;jbz99+3fOE#NW+Suh$#oo9!gT)!U
zKaf+{d2JmV*qZ|^4MCLQ9l)5AVUA2;H|#qV$hYuLq+p)lvBFdR*?G6-c&^ZeRVY&M
zY|1=}lKW|OS{+q?g{g|K(^L0J!JFc@M2?Z_|1~FM)ePJrDRQkGbumxDk;yYF`B6=4
z=BGN>VT#VsKh>~Q6Z6x#m>`9&UTp>jMHGgDFXhs#s_HQ~@1|UR2_{~P`PGc7M?!sr
z{1a83nSxE-h4KFUde4C{ZSOIwN!rqjSAOp_V+FhN&z<Y0Ps|*9J;#QfG1#X}UER_o
z%7VAzr1~0idn0fqOj6(8Bir^FJ%-f)uUd!f#?0D?ugJL`S&ubhUz`*Xsy@Wbc7%s+
zcOYsH*>>4rRa`}Fuy$ORc6<-r1$IU4d&XcFcnus`kNudaiqZG%12kdRo^lTHm5;I(
zUhnqVzp{SBBILS@`r{PXRYhc9$~aZ@7%mbfOF7RD{*Uy>Y&mvus`sdzpG)qY{&C{(
z8<G0N7!fT(Yg2n+X~WhKzrQ_4bW`_X&IF`L&7WrCgjhn_;QasiH#f?v|E*%p%Q;vz
OOG(+ILsdWgihl!lDja(N

diff --git a/UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.uni b/UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.uni
index 1d348931d8c038732f5c3f70ccb7817399f254c7..a835101a2d2be46a2ed8f5a39a8b8b858f691bf9 100644
GIT binary patch
literal 904
zcmb_aO^=%}6uejJe;8#iZIpz5omN#<65PgW0ucsnds;c*fF-bzZMK_#U*pa0_R>qW
zSi-WInK$!zQG{qd$JdkW#Oqg4gw3G@xv#|Fq*mB+Rd>RmlSjkN8B$rtRV8rJ25i4a
zuj{cBb~SNdhOdXSkxlFHrh1DH@7{mJa@syEK$R06Hrfo@@X6i^an~WBEsU_j+=+Vi
zd7XcGvQxCuVlcWfyoV11*9!2e(*3~IS*iv-cfv^C*<ha=;lox!Sy2ak&udS(<Fez&
zPGD5EZ^tC!S-lOAN~>B<ek}AUd|R^wy9bq^`n#1?`&3p6>rviUEv+;1I6h=S;Z;wg
zPvpeCdz8AE@ixymPJQ<dz+I4Sog1#BNDtnw9!(`y+BDIHVWXq1mzTq8Xoo-vuVPDZ
z$g}Txya#1SC@XThE(?;NOcRo00)z~7LsCYNrHE6^V&>s9tYb#mA}HO^Vw;r(ZsI(T
z(}EI)EJscbIbkF%;(}(Wzxw9szwm>m$pXYvd<pV%!UQ<oA9j=^&oeZi`&pXS)zlyV
zkG#LzeU_9vavQJxA>I`D`?>14YDV4&2(>I3X8$?Gvwsv#2;1cJFr|4e`=Ukv06TUT
AlK=n!

literal 1810
zcmd6nPjAye5XI+=#CKSw7eH;ozY{`;q%~jxO_Vq)oRFP_#8T2!PFk8T-|~Co)NW9a
zIHAh&u6Jj4=FOY8zP)K#%L4B+o?!3or{y-ci9NPQ?8<g*JsUDdc5Ndp7q-S{Y3J;H
zvXpu3CkobcESVMT7PeuXV_o4dFP#m<Ut$Y3u&+G97Ocm1=@C}etnxmj{7Y)yfI7FS
z&8Q~W6RLU2{L-G=3wy=aQMGz)hkVCWyr$wg-^X6_g^y{)UK2|jyFBXHD_>1uZNlyq
z;}}-nTF3hKZVx*Nh;qCG7z;8?8B<sd+s*{?&7AoZ%p*J&c&Z;8@6Hs@1#4jyiWEGn
zDvzQRep;PX2h~qus^jbQ*nLv)rufYnGe-6Mk`uD3=XXfTTnk5C>L)lddFB;As%eQ{
z>T?}bbHe(|4whOeznqH^qtNYEn}b0Sg`wn2xui{1oq_XC)#^(y@mlIt+EkB(`kL`i
zRJ+WSY)bpt_WW|ofiSJ_F)Jml>BSqrXVO^7uKWw<y6K9UV&BcNVkZOp7}f1snnaoL
z)|}K|3AZ%@R}Uq1?IUB`Z(t0o0bVsH?8azq$XDcC5ABpWVqct;5$Zm~Xgk7V;E}t0
zNz)n|%!;e14d#xowK}|q?hL!4c0FUTGrana?3DeOsEX0`?0r_ku07>U@Rg6UmR=w5
zRrc@9pRowJ?qamfQdSY!w<=B@J%)=O%2Ljgz5gNoAzO}Joa#NO^mER=(?3o8{UB18
z7(=2(tlHFGTH3Ic;P<!ZfNttOOi@6}DE&zjN5m4+#((}7H>zs?ty1Y^07hx3SM_FJ
IwGX$_--V1AkN^Mx

diff --git a/UefiCpuPkg/Library/MtrrLib/MtrrLib.uni b/UefiCpuPkg/Library/MtrrLib/MtrrLib.uni
index b04a44fe57b8812a2ccdf4a586e4b7c4bc3ab5e6..34753a089a7f8ef37cf31b6aa0434cda5b749f49 100644
GIT binary patch
literal 867
zcmbtS&u`N(6uu+zKYZ#gP_4~Chyy|hw=vA3O)A^f;5503n^;QY$aV|;?{U1cap8cL
zNQs>H{dzAi%aBc{_`Elre)%HHu$G*oGdri;8H2MYQ)>^hVIF(y9?EvmP6cE8`AB&V
zZE1(IGff-ts(OvLH#hGwi?28DuEF}CJ1ngm?8OYE>yXeMPJ8W6x}JYr@K28^WNZ8w
zx^e0N)z=8EhN>!i7*u~YeS?Dv+8NdPlv+6*d#!Zub)E1BRY$@}nNICGjbmSHmqa4#
z;1i^>eQn0(J?uW!79z*$K_#jFY)#cZ+L}1NFy^X_56<k4X>fpy(e}sKQP97_AE`^2
z81sx>tlO9XDkRx9gyBP$#o_nf9$ls9)-~CM;j^8uXP3i#Xoo~e4|z+m;pJCO)?flT
z6OyyVR?-~XBBvZ9AoakOv=9_!0a9Q>M1)VUAcBeOq;$vRZMl`WBb<{$GAdAVaJu1C
z&_WW)$|8RH66rtijTQMdXrx37`hCPCI9qR4jOI_PGo8j28t<!dKJg#LeD~`z->&FA
sS;PZbO8k9Yb*gWUs?pH>Y%4JNubrLz!z!m@$=PP?;mPcIR`cZb8yDmU_W%F@

literal 1736
zcmc(fOK;Oq5QS%r#DB2T4WKpwgjgViNQi+5ilf9)VTJOpr93Lf1p4PG-<jLkNfjhE
zsIu<+&Y3f3=KAJ$!x|RRp72HX)@GL3!lw4n9<Zykb4#tq7qOq&$Z{Lfu329(u5HWi
z1d9zjP3v06XERRn1M4;Sr*2(fv9^`fOE353?HxR>h$V;7+%Bzv@gp1CW5(z9l<y_8
zv)k1(dts-{J8&<EWx-qsIT-4P?Cv6y77M>oVN0Rhm68ryW)n1cZ7tM&b3}_2MwzP_
zl%BhfB`8A}Oc)DpOnp6u_1cy&(b+Y2D<X>65i9x2m@Po7v{oKvt-OwztvD5@3SZXB
zt#-CF)y9w-P=!SH!&wNsViJ5Uo%N2Tn2B#z>LVrA)LLcNvc9!he?H(+asBC9jOoSY
zFxm_@LX;XoFZtTAR@5VS?&l?<o`Y&LPC|~v`WLtEvN}{IsHw^ydHkyJpn*6Qd&;Vk
z3Ucwv-%zN0sjK_BYh7oalcB~P^*8K{xH+Nf4!zgGyQEc`RI}7RS`4o)m6X^A`X=vI
zmD;Co`>0pkq1Fb(AG_8A`@$HrFHHhMm4^<s9do1a$O$vmwE7yOaD`rDZ24NN(>-<<
zoC`H^kC9z)OaBpJq@2Z$k+}CBD{<GJe5Tye9eI_f#NN}(@*CqPPQ+YqF~0Q@qKNHl
zi4*J;TL&$=RF-_UkN$P^_iH$JX{vTo)=zjxefae3J4gu_1JGhtO=1rxP1H*9^|$YY
xZ0bGCsemE9-j80~8CYUk`;Y(GS{d2DMWveP6OZbpTjt?dWcL|W9nE&x`U9&s3G@H}

diff --git a/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.uni b/UefiCpuPkg/Library/PlatformSecLibNull/PlatformSecLibNull.uni
index 352ede7190b859c7332adf9717d285c0fea895d8..d7212f0351b59fba29f3973db4f20123c4a72cf9 100644
GIT binary patch
literal 821
zcma))QES^U6oual{STM)WeaJ%4fZn1m=kNOSYjJVq1#hYY{eGXl9A+Y`S-h4vt&>P
z^^1}H-E+>px=8}bd=6g@x>MIzNdg<achVi<Fq$f8YdjpRgR+wW-#u3q0?UbvbUt<+
zXyb!4l>&P>gMj2;tqZ=k!_n!c4e+LV3m@LS|F{5Zg6d#x-C&)Z9G8%yXv91?<&}F<
z_401TKA&wxt33?PHcs{+O%0({AgjvugEU8N8t7$EPRq{6n9?cebft_}b>w?lW5JWu
zo!oZ{MpG*nMX;*(5vi=H_45R<ugPG=Gi)iUMAcuduG+J$RvszLRcjxd-jC0{fWXSb
zG^U__hiOEU)F}+cJi;FTTTB2lMA<fk;Zu^>0pr@yRcdKnlbkAiviJ4v>98Ey;WCqZ
z0wpWHv2+WRLq@q^bhQ&CgI%5x1_FWD0$r1w6DV>>bC{(Z@foaAPWd7Rc%b6G*a>(@
z8B23P35S9KBPAo8<RTTc$nn!xEdL4LX`U^BU<q1~9}^RCx-B=9WS6_2&v9k0uWqK{
z;00m2$8C}AHsmo~;UQfM`1iT#q-jRkC{X5h$6@xG#hm@eAtQXvXgLMHc)W0U-7=%c
EAG_21@&Et;

literal 1644
zcmb`H-EPxB5QXO&iFa6~H-K6Pkhnnz;ZOq>kVK6m;0ifOlSXRl$}xq$Jn)@e|CBTc
zA&_OScV_m?nKNVm_};g^IqnBs&R*Ek)^={EcGvD;mG2#vnU$7vU$bA@7rU^zRoDyO
zw%%6YbvEW~j%SIdw2e(bn%4+Xi`iih!8+%1U<s+>w6IUH6rkKjbT#HKuYKq*!MKET
z3Hr*;KzDWz^!u!j?V&xgCw9ntO3sR$;-NDor}R`Mp~eVLTr=&^RC&p{Eq7^GJQo((
zGaJ~6J>OGp28XrR>yr2aPRg+XMO80YD<V{T4$C<a8<@y<?e$sV*{~N^vB+VxZS&}q
z*f^|fub~tbrw(7I7j=d!-qq`z?yBR?_f=kXvSAW(Z9MCSrI?BDy46QYgnl*W2K4C|
ztENZ&3|zX-fAw0-dETyeO}r3=74%XrO^2$U!SiNcoMp9Yn#?dwV*QP%T~@y;6V%j9
z&xqG#7qtfBRNYWkvs2NFr~aGJRE3HZU;6qY&X#nvzoY&Z%M9)dJKFI?pqz0xnl!8G
zd1DED#>~;kUh|CYJ^K_*9ja>0u%=Afl()nyJ+&cgg1tlNx{xy22@w;IJmO6gt!Ix_
zxI*o*4*Xub!<L(~5BSAv<TGj?lS#~m*i%r2G4k0@*onJr%9#<R7-bDnuZY#jPpoh8
zh`GMRq|OqmNbF;a)1jwmF=nom^O*0g(XCmX|CjZ>UABXEaxUnP{vXorGbkg@PeDr9
z#nc@<F-m2`{q8!TkNOf;^gidQ$<Z_%fhCr``hWNDf6U%r)}ZcBV6Vv-w~Ftp<Igqx
J&p&gh<0m{g{_g+)

diff --git a/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/SecPeiDxeTimerLibUefiCpu.uni b/UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/SecPeiDxeTimerLibUefiCpu.uni
index 9d100b96ab051c4d062fc76d0352fdc7c5193db8..da9e4d8191bce0a1554fab61679dcaa62f1fbc4b 100644
GIT binary patch
literal 2083
zcmcIkU61256n#hHKU~eez^KzK1L9$Y5NVQSEv9Ldr0nuEauc_)NbJaVx>J5V$4+O<
z@+ASKeW;q;k8{pF_eK##x3~1&UiRYCPojvJvW}}pkls@*2Vv+z?hH34(yBkvWTiS#
zQf$cxt0&V4yYzV>_v3iiarc}g?8iCeG>t|dWh<!Rz3<>eORebn$%a~55sUA>ykF4M
z*IzA&tCm>tI`pDkJMoHQYK=SsAdtG#C@6iGJ(k<NX6x)RE!mG*8PfdYYQ27b)NlnB
zf?Ox<%n$@aOR4ZsNJCOdCxPl0?j&%$m#)*3L$MP{YbQ{qx)WzbI(|ekO*_xTi2c+f
zKh#4plEc`GK`1wu0#q|82VKbubCi%TV64`RI&kcTnf0WVXt;;zrGC)Rh~k1JvkrAa
zjh_0}_k@ZE!-oOt?M}3*79<^jD5V`<2OKC9UP6SkWOLJJB(scmL2*(r^57tW#ef@)
zx~fI?UK>JsD0dDIP<~fp9#4p>y}V(tuud!YdoT-1dX1?PO(A6ZB!XoyfMlFLM9*`e
zbt{UW4;L}vCQt(z8%p#SQJ&jajW=_coyJicXX)ua=r-t9T#TCN@nqzobM#sBIo-ef
z;w9br9~g}(CwfY>L3)_klH$In5bZVbV-xN2n^pO(=Xv3J9z>AEQ{)Zg8{rwhFazvu
zV5!;LunEXELixdXXAc~Ez>i$^eAf$_pt%Voku}W2YP4$MO08`0I~uI26uTL!1QhQ(
z*>oS;${-VF&`Rr!+)X|=_?BSNo}75Xc4Bi->5K(1PTo>`4FJSlsM<L<zKS9}0&Up$
zr8bA?oMEG#ZST&1mSZ>02B_a;RFs?V%Xm$!qLfv2$yVDsOKF>@SW6!e;IkyltBf`|
z#W~%?6~b?56<4fUgzj%y{bsYR>1|w=F*ZA^Xj4*|6=hasc^%hmljG5Ar2j-eusmH*
zh7`2O-uaji&ep{P%hJpEZ*MU-|9#=5!FYi0alJ{m57}e9!k;*)>9?O3Jy(Z`9|Q??
zx2@>rpI^zFzv!1{RZ_CT6S;K!L%%CsR-EHMy{iAiMaABFZ(Ze@29y4qOM0a%>W|Kq
WF6iGKV85MLJDSk!zaPwC+Ft=bWvP+?

literal 4168
zcmdUyU2hUm5QgX4#Q(6VH)<-?YP>MUNDJ!5RtQk5R|ZNyh?J5AYU__zpZ5%hv$TFR
zCTb1Y-Sau~&dfV=4qv~l*_vfMcll-Z+zxDDL)*8Tc7svP<u<a3O|8p!kD1I)Se03a
zmB;i8+FP`Hw7NX!VZ{h3YR%X?VCNz2O>5c?--2Beq|9hZ;>0QoeM#@n<WKDgUDHdN
zB<p8-GWMLXVvOb!I|W%kShR<<;lhR~V|`X>Zph3zQWLHdtdUo$cF!K#x~<YXv&Z%*
zwB#l2&9U`G$*#=apiz>aFk9v6gJA#$_n`Z9imovunbqu_)$N0|@YoxCo!fTk*BHs|
zE$tSoqPDoY&8ls7Ew7Sw!mL<Gw!Ak8o=QIU2qr5PGheySTE$o+1NIK)zWU5pJ@?0_
zFn2_6#;7Ax{H15Ym`7QxIikJH5yet|h|%eVwor>H2kais^(TC?K|933G4uO@iz9TG
zQMp$OBxuI@nguTuA^Og~<VX20N2(Ahj*?rjKJhcN4aS5mdNZ<m3)`JXif<D+n@EZg
z%CTJiz2Ko?;E3DlTs%Zi7aNpO;!iL5sA28ED*0V|C2fQR^|U+r!_lOj&V*%_DK{dX
zi#{o{aT0V^L%zxz(R0oMNl{#6iQ|>09Q6TXTIJdkx@GBCMN#&8k|hQ?dsD`G)#)>S
zz|UirS>$Bov2Y1@llOoeIpf=zv!a;Suua%B!-9*l%lVMO5?S1|kD;z<F5we1y*7E&
zJTmfH<m?bHU1rKfjjE8orz}mmH0CEiPhqBN&w7b($IJ*@@?Ao<$=n!TsqP$tQY^X+
zk~@6Y?Y=$W$*5|v=M^o-I@K-Zpd=J??J3VH%v71ziX=PoL^Vg*CWch(Df!c~XA6HN
zbSbXO8Ijl${nrJvvu_;ue2zVS!W;+BOP^P%a^3c7;*nL}>r`{r#+=Y@`A!;7d2|wX
z$um^}RZr)+_#KhRF9lg3TcZ>q(@L+EYHK#ucduF-FtNs{s&2xPeDNu8e2=%}E?YZ5
zrz8r4=Ye$TgqGDkaK@^vxX7zQ?^RS066Q1B7cq%{2}_1mI{CcLXum4E>=L5sB7Uls
zQ+{L4HQg7)F!yab-z$t3Fm4S`mUT=R>4Cft=ay$GNIBw3ES4p&IQ25Ju4N5-$-7D(
z>ZEP+u7z)h(Hw^Du(}>RtkbhLKP{t#<bBoXIxE^ia)XwbtoI6E$(8gKz8j&h-fGGA
zUFIdV5j1AD%c@pD=4W<2$Y?N<@zeu$jY(&RwK~_ORhk;y7hL;$zOR`P@>SaPxfVb3
z>)Z_F1Ih7ylCJwf6F%jP*Ghg%oYD<%EnwG}o?8pnc=oix)8h894VD@fZ6WIeDCIBB
z=tStC>qoy^AzvhG21gD9@5F_B$P&^O(Ea(l<jTUvtJx=Zw6RRgX)Yr2JsW>*Uph@L
z--(s4UddGx((U-q-C334qri=;-BtgOJF4GAV-3DOchiXI@7+nS*IhLJzqnp^(BHiQ
V$FuYL-87wN<vZcOx?!eD`wiaKtB(Kx

diff --git a/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni b/UefiCpuPkg/Library/SmmCpuFeaturesLib/SmmCpuFeaturesLib.uni
index 594062cd0bace29214e055fe8453f214cefff6bf..322aa8bb5a9754a7c2924d6c51adde0ae5d98d0f 100644
GIT binary patch
literal 835
zcmb`FPmh~05XJ8+?ROYuFKv{BZKWPsRaFVNU8@No+i2U<$^i!~0Y<jjKi|HCH@oSj
zm#SRA@ZOu>3=>5VEtl~1s5^Ce5k(+c1xZnY8&#!`x`NS~#>&3eLjy-+q0qeVlW|HP
z6+S?3>Zwzk*&F<c8K10fS`TlkxA6Y@`Xj9I_U^+9=-^cciLs-x(rYtpAnrN{Y6n(1
zW$#tJ`MhOcUgJco-3tQ9p$3n9vZ_o!%He5d>ZMm!%g%-J(kke5r3R<!pzmdkhI^?y
zdFT{OL#=EGL09jBq%uRTXC4RU7`|<J3cKf&kowT-s(mf1l|vPB)!KQh57TomVRXj{
zJM!w$zeJs25c3HR3MYsJAbp5!y&peCkr@%!Otw-RW1HyYaM8il>(gN~w&QswHv|fn
ze`oO?D2J4C!RWRWB!x0d2?K$G&;m_J#tGyZ#2GANj`9U;V@~-h0Nhe>la~T+W5(i4
zP{JW+z(~OeCz*%^%`<%U4eh_+2hGwI5VT+k@^jV%Io%gKO49QRESI<nmls#_aPS8q
y-Q7M<%N@Ckw|IyX0e@asogA7;HVV|RE;%gzaRnEDDVh?VFj~yLoXh^lqQ3#EbOH1L

literal 1672
zcmd6n&2Q5{5XI+=#Q(5LFM!$vkT`%4A|D1UppKeEz^QVaw6WxT$Vs66=YikbZR{or
z2QCO%-rbp<ee>q+*uQ?ZtYwb(36Hb4c4fI0HnoTL0I&9jHp6z-wZ4s**S5mWh*NBa
zXJw@=?V2&QIZtj2EXV#5pW|F^1HaQHc56Mm0U>xC{-sUuDr>XKTj%exzp`79a!_Zs
z0r3%eA2UC<r#vrNo!wc_?1i1Oj^VHYv0yEP5)6$g-kjBfT+Z6;E273;duvLSQ@r09
zCq%xsj$PQBBkZJ3PV}J)j!X;AI`RemQaER1p2I|Yx10+)%{?pS%UKnm)zznXrGCL)
z#%kf233rFD(-R+)!Z#(ZU>q~*+}5)YcFjb(l<*Mi9g3KVZ(ix6-6eNepX+dEJ?u|=
zTxzaAycQXwaQCat$tgss5%f~7HMXiA!}I>V)LnPwJ41IQ);ElYtoD^rKc#5vz*PO}
z!JvUSZSE<nPTFu6uY8}Y$AY?wFTK`H&X)9C>p=ZAo-y1fblraTCMYxBohG|k^?a}h
zK7INqvG<H^`-~l<sY6xGL%cDaHewZdrAKzo9O17K>RX8E?1+egM^0F&qct{|g)7ts
zbI04VPAhKCzOXM|iO(pzO(ror#~*_#jKpWZz!G=)lygXwVw5#Ry(3m9zcGJgN6hsl
zMt5046_I_daBB1zE&BA8a`uk?1@wPvdG6Bmr0SgT1qJOcK}k420x7af*hnj>+D54%
wT>kW&_-{s7Te{@hcaFN@3@ov1aQa{V1si`^sd{8Ujq0C%buY)N{XZ-H4N)co@c;k-

diff --git a/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.uni b/UefiCpuPkg/Library/SmmCpuPlatformHookLibNull/SmmCpuPlatformHookLibNull.uni
index 9935934a35273bab9d569804e73a1f1326a1bee2..46de9f34942d8da8459e30d1180c4f84dd94afd0 100644
GIT binary patch
literal 801
zcmbu7L66fg5QXn6?SB|`FHp73f&>SI5NTpqi#CaDM+>Kwo4AQZVn?>S(0|X=Tee&{
zAaaQuzc=rj$s`FR^ErIn>p@*#B?<8D7P6{_YLH=X-3WKqeutvoY+%qkC*2XW@j;qK
ztxkq$%ItJ>y6XeHXkNnW+uOIW#Mi4g3!o;b0W#|*>txW@tRNi*h-wc`dF38eyL!K7
zAD+vJUVE6F?VKDznifK@KsJpXCuxq_bTG=GoR))+@zN=TYn1V-jrvixXn2%*kh?*_
z!L-W7BIp`@lr+|~`o!bG?&IB>=dgLI6082`b<;n`YUNRdT&?!O>D}R}7Z8ZHKVU~e
z{S3cLona932s^yDNB}a#vV92CyCks_;@X45F<RFpXNOOAzFnRVtErzZGr1#BvGOxZ
zw?H}MlnX}JwIDgvMNSw96vP&2MhZ@#EFdjlmU5KOV4ZTx7ZKo|io3EFaGx@k7J?EE
zB?Cq(MmQ-%Dri~Yr%!1A2485AFMyy0Bgog2Cd%oy+E9{TR$xBIRk*&oISmJY5Yjzt
x%e>x@hjfjHG!yXWb2CWO9b~6KnPtsk_78hE`%6$xc*baT;=e@wPtXdJegUj-^78-y

literal 1604
zcmc(fOK;Oq5QS%r#DBO-H-Op%kYIrj!f6b(D7BS`fE98cO)b*6a@<1yJn)@s$8M^y
zV1bb3`<l6D&YT(h*Uz5y%<(?qarV~EEwhy^?4dp2RJM_Q<Z*UviA|Uj?5UM_=2qAx
zCnv0O`^M@Fk5e9pPi9l>Deo=&%+|KyR?0jBzuQD;BOQZsg?EAX(k}3J_6YCC%+Kv9
z&r4QE_3oLyutU}nh$V<C)<P)2&?t@>t2MEl1=!`$VsHFz0jmY4H;i*UUt8aX_GS;e
zF^n?29ry*fOCLk|E2lYgiO0h4XRyxE=E~b{efCQ%m!6g4Wvo`9wb@H4-Ij7vNP3A=
zi?7@BI>HTWRVqbg)yvtnXCdsCiF8qo#Cpq8%)~cq^pQ2Ep6$IpRUfcF-Qm)5{qD7x
zF$#A#+l-h(lp2*@ily2s>nS|%*2S5075{TARgJ{@2VVDC?J85Lsot8__w!l<aVqa9
zt4=DZ#Vg;@>aj{)`4?X6F8LQ!w0BSa4JT8$&*{3|=v`1Qc(<BtXXSHZA*>SmD7N>E
zf&YFYG<B$|dCX}<r%hOeUg-(n&Vcn0pDjXLg^11$@fdmJn3XzOV~1I|LhUg3{a(An
zhMTib*o7MVh}s8460<YTBT$7A`{+Y<;;u8r9OES)MXkKv;j5cpm_J|<bA5?n9i_@5
zw9gGriyomxLSHH7VDDc*f1;k}E=>=b&RJ6*{f(sES5RW^>u(dX3&^{&1SmDe?@!MG
vb<~%zr1mMJI#1nj1eREK82`opuJe}}sTW4%qCQC){r6?{zcT8gl`8Zb&D-?w

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPei.uni
index 08af34e11b69fd4856a2cb42332ca51e2545652f..697bb2b3d9e783d8e1eb7d246f1784df57fb2987 100644
GIT binary patch
literal 1032
zcmb_bTW^~%6n?MN|8SJPY*7N;<!PFxk>IV?!bR9ox2MX01C{_IW76f{@8D$0+O%)u
z1z~^ZyJ7o2`13h@-Kj=iU->?y6j&6&TDR@ksX|z#J4gwQ;IURk4ZYFjSjb^odkL9R
zZ{l%WyjBhufsxiIxyLbEOE*?L5h!$L<!=k3D=!or)iXaSRo#*51LRs;Xmu&i!fV|h
zjH+r2Z;H3@{`TE1ET`AU1yB@fFrMkPap61&ng$$tK%av&ds%v)SJ{`RIWTx-MC&Y0
zAw+=@deI$JS3xVRG)gpsGb@aQMisIfWa;p&C~;sfR3q|6!q}D4IQux&4i171lxiw_
z0KId2D;C1$$l_R!{r{C!u1oB<R0DRKkJGFNz|q=n#6+&o6V=HK+B`sx`x+g9u#UF2
zw*Tb&x<|WuG==oEsr=K#;O9fRJbie5-Jd(TBamjv_biBjG6*T-8C`8T31J(DBm<5B
z7lE!x%m^eg1ToA4hVU7z0!G=w8MvqXF4=Op53($XIVB8|3^I~tgprsBoF*|YeZ%oz
z@Po$T0tk+v1o=5(9Gph!hLZ4n1m<%*gV$F#Q#ts9(A`6ngxd{y2v+zJtU3Jq+%%%A
yMo~$S-Ezxd_WC`rwXhe5^!bHJ>FgExkg#<|(<#;2z=iz(xjL7w;H7(mR{sE?F+imN

literal 2066
zcmc(gTW`}q5QXO%iT_}wFM!$vC{G9>5^BH#>L?chPbl|T%B6BbA%7nD&Ti~&s*to#
z$nsvtXU?3NUH|!AvzkS`Pk17GV`Ix~W+QuO4_MV+(-PXYeddYmtu1ZN^TQTc4y<Qu
z`Xw`2#@Nd0r%m1Nl<}42><{^30Pd=^yDO&rS4%#DSI7AXc=DU$VNILSUvIswu^X{h
zL@+oIf%X<4jO-U}M05+7ACDohI;@Xk$(&Y!)j9Zm{4SlxIsFj-`yv+hm2F&n6QUBs
zN2vOk{<%H1XS|V}m9rOi$~f6ZG-E7;91OJ~b5(ZgWL*~0&SOhi>AB*~oti^fy|RY2
z?DfHX_>51Sk2xrXibc#lI7{g{OtiOgnoO{qJ67_SF`D5!DBE*vB34y*Bfb+eWv9T`
z*V0Za*SxCa9@?s&BUiE7%^4R=l<6F=inTxyGi5!)%2&2_mz<37U4v@6VE$=`OW=C5
z{%=RC+7zNVWNsv1E9Q#256{A{@)B8RTfbv=e2zkW?y}ld#;dsjq3_}!6N65zS8RPl
zSyj@ST)cEAUNz>`m3{8CuJUb8UDR%=zhb2i_aRlc>%9ufl(*2N=oQZg?g`x%Elce^
zZQb1&37STzs=mW&LZx*X#ZKw2UDC&_2ZWG?gvySwXglPTkt$kkg<iNqt<X2zT(i@X
zTV!9@7q8TL)Vz)-F}q|v0aX~O^WI`6?pl-24py>}S8w$WTYdSB{v$hLu9K+S(MPW+
zV*6U+1a#e>P3lTMFZSL7x~Xf9yEHv1D`!D|bjwM*@1Uf7-vudVRwr)1Q%9)|cK>=#
z$fHiegxvRNb#hb<XJCnC1$OuUAE?%K-yFY5kNsify>id!RX1(oR!ud_T<uffc=S4r
g{?vxQ-T(UQ+(oMhwhMGu29(RTozw37-*{F30!%MLq5uE@

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPeiExtra.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationPeiExtra.uni
index ee10182a682b17cbccbeb5658c32a1cb7fbfe2b3..62e3f97928916cbe211e22316c2edf13dd2aeaa0 100644
GIT binary patch
literal 684
zcmYk4ORv)~5QX=Z`X5GR167;wS|Nl;8^g6|9<oziSXFM~CYBsKvXcwt*E8`gg;nJE
zoHO5yCypUrui^7WX}Mg)F_en;{oeNdWK=CiWlbp+9BeJL`Yjvaqf@5!AWQ>$Yes3t
z*%!QfJ6xS=yAfX2ui)+LH}7COf8K9^qEe&54c3L!2okL!s69C8rF)W1^l`^N-Q%iG
zc^I5+o#;cov6CR`+V+DmSEPVmjM6EgeJC%S1g&amJaW!_y=c(zB$O6sEnzZ^bTEgY
ztAB2xwx&^YmmcgT-0gS@hv$@#`m<AYcQ31?M-_54%Ht%?)9j4^Donjh*wH9|jenzV
zFvxL*Gu~Sy01@T|-8c>(;@A#|YbRIB$htPZIedKf&GvSPhHm&blLrDNE55QM1Ii(#
zykc~BtVjySJS7Y&6oeM&p5&ZBkwcQhD&Z(!!7kyHZ$e*>w0bCx6+9-4C3!^&hk^kk
zB_o{VRZ`I+$6sI2{sX?zJlz063zi_?XHAgPtUOSXMt8pT8dqVtcrgzL9|-AAh+7gi
t7dT}_dOVO*o@4|yT9|ectpsVdN4{LFc$VRc{I_~g5(=4ZCM{RX#UG@6(;ol;

literal 1370
zcmZXUNpBND5QXcE#D5r>3!ubiJ0XOy$p9nbMP3A)B5!d<vOU(=NiaVi_+IraILMl=
zuIlPnuV0t@&+nGCEaH34FR~AIZK<toX^-s@QLPP#jBLa2qh)SyZA)x!Q#)WYya78>
zaxd`|U*r8EwjeelE63m3%J%qEW{L}K%i7Y%vR-M!`p%BNcV#zZM)nl+XV_Qv!d}{I
zX6Kdn#?F{01?HN$D&)5FvF6%jr42)6h*!WCvm7pazTEDdd(+-o$A<R4Qln-!hEeM0
z*^!@tl5?^RDCPMMWGvmE!&=JieC=3h5fKq9)k~SJL96knM73K=&Y5kUnRF}hwR=%i
zxMQw+o7#*~`*cTI&6$@>LamLnE>XlxnJHP}E~P|9AJqFg+~EcO<q4OX>%D6+XB4~B
z)246`qBsP-RBMl~Q_tX8*44d4CSAq<nw4-zV*Qh>hpbMO32Gk6nic!ALIZI+{G+To
z>A+pQ_5RM71$C95yVgz4pL3(F2kP&M%;3JD>rSgTLAl{8H7Tvm^TlFV4d|o3eP(Q1
z7e7JM2vudrL=!q~!Yp>BC)UHp#A}5577{u;CS&BteP-%tjSZ}Dh1$S&+?RJ&af|F5
z>*Ce-it^i360;uh1XN-4z4{PO+!a&JF<Ht{)sXdxT<!dU{mP1%>z^1GRl+G^`(EMH
z=m}a3=quH{ux7=v)=%$J%j1eYsX9lmiQX1zcU7o60A*O6;0o+Ms1xvGa(b}rG7C8R
suL$E7yYh}v7o3wl@{9(y%P+hldj0-?^>nK`Wkg;^SEyr`=&lNX0qm328~^|S

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmm.uni
index 0ce635815c6b4b3257e5e107cc3cb846d570c1e7..55df3905df085ac27e1ad89bf2b88195d19024c8 100644
GIT binary patch
literal 1501
zcmb_cO>f&U480fVe<0G!79@7}aT<nUPOPrN8Yi$EbUPJ_Eyn_E$&lo9`S+ug6lt*z
z7>4BH$bNi$e54r15Rb?3wU({8yoh61QDBP&%yridN|xM7t-_ni$el3Y8ty<U>v-E*
zJc(D}$sAb<zG+3|IRkIeNc)`UpDCacwN#?Qq#@m!+)%K+C<E<dBg+PQqj$0r7C3aG
zY`BuPJ18x=f{lQ|o(Pr<@xlt_K&YKGT6O;aW*-QZR?}LV?vWb-e2ZT!)Y@QnC(N|d
zm4NbvH;>Xap|Aru0_uRbR)gg`VFRZ(^kq<~k?xlZ%%}~MzhdKx(8W{L>;r7HcHjk^
zOr7g~Z{)Ud@TPnV@2}ro!_+@MPJm*97TaigZ9)?xNZJ+x+Jdj&>_ioPp5<S>#-KCw
z2)*1I-T_xt@SB$?z2|B#)fPIAE=Vjd;JrnyEQRv!dVI&x9=_wU_05MtRbgTTU{r_Q
zK?qh}Nk3E;bR81RSPFLsmcV*w=~G&XU3GqTDrudOo59CM00mB7Jzzz_$0OBI4C>hX
zuGbnB0C$15ajyRq$GS(kdN8GkwAseT2pex~H9a1pzUh5P2rF(0tn%fzJXru`kWyCU
zbha)?3hOK-Ie0)QfzC<B2rM&5G8iQc;UkzOjIv2!x~IkMa$UfElIKZQP{LrDLrzvX
zVI(V(f-W<Bb%WtQ;XBRJ2@njy6y%4;1UOx+?kGu5BQPGL&dZA{Zw@vH)jceh>H3a5
zBr`lD^8%j#u3E0P1CA=r{&dY?bl&?u`iqv7uz5~bzQmK7KeU{8M=;zGvOcb`3H;Zl
Vn7+O#;LKYBZ$`NP=Ufulir+xK=Y0SG

literal 3004
zcmd6pTW=FF5QXO%iT_}wFMvqG?Fk`7LQ{x<CdwuPo=`4r8Y!1*H?;K61K$~Uvl~cT
zApxpZyI$Mlnd6x=WB>SGx4H%12Ry-E*|E)RZbx?4?l7vkuC@6l_JJqZYg^fZ=c_G|
z9NW;=v@3dr%*0a0&d`!Fy0#OS3XCl+qd&yLoWD4CR9bnR_6D{imOdIrj<UAFS>Wws
zZ|2%_%-eYWK8j!y_A1XUX(#MQf5q+w*0KZlVrHjEj5nx*ojckw-@sgoC(l?dee%zc
zci}7KLwP)-U-qdYAX_7(0#V6me@D<Eeo?>l9<gFgU#+ak>eB7R@sVAW5H5YT>ibKP
zI>%z_)`m8{)FrIP$SL01`<n68sz|SVFM&N@&6{)9h$RJs%9?A8w;iu|lc6W@9Xh|V
z63#r@*ICkBMEA`#=9r`3<i(2;itE_eC8ll9i0xP>_7n{x?5x~E?txuQmHtyKDqE)P
zUop9dr|#1}u}AipH{iv*_skyh-@e?zoPTLZ(V=gViSk&(b1al}D@KZ&;-9+rCRVc-
z*0i3z-1u=<9z|YG-G<mF#))H!nOHXjvpl;1iRLbx15;)ej!O1s{3&{c{+vZ~=Emqz
zZHU~>^=q{<K^D$<Rhjb47uSWNs4<d@yj!5DKq+LB6vtwv((DSp7CUH?AN%y*Z(%90
zmb3KN-Oj)ujq*mUJF=xZr(KW0ncG!df~h_U>oGH`gAsM)<2I^o&qQyEpE1|P-RJ}D
zbzSnTn6xGq&%J_+W6`^kPu<rw)~0Z-j{UOtGe$;WpTN59nHpM7cypiRt@iVlT+lhu
zvyQ#t+wi<-d(GL0uL&|e+NKToYq_Tfc1YV|ywFfYp$)TJNF=Vg!=D(fZ-q9YmDUPv
z)BEZ@++Yj#k$K_jxJC6FSQ4^B#@lF>j*eUJ(Gzx!$z~rZ$;fJyIzUz{KhwTrM#z<k
zssM5K+C|GgZS)k{RU^9aN;db&x7=@e8~o(0`?$vTHq2QPA5}#8?h9HvtRJAMMX$lW
z<BU$lK5|z*d&E)sG$r=2s>ZrsMVC-kKzDo3_sSpoMT|=Dh}hQML~)mIZuX1v^tRq3
z63^)|_;l+i-@?Spa<%%mcZw=F@-yY;J4Jwps>QeUE)ma+;uaFmwB2{zc&g~U`TsYG
Hm=!+()}`rs

diff --git a/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmmExtra.uni b/UefiCpuPkg/PiSmmCommunication/PiSmmCommunicationSmmExtra.uni
index 60a7d627dab28774284412ae1adc735204db53dd..34e7731fb5ae50f127a04b1eaf16d9673fcd299c 100644
GIT binary patch
literal 695
zcmYk4TaTMC5QX0(<v)zlmo`eEx2LMAN`l+98ZNRyyM2lraKIAS$e3)?U*Ex-rhP)j
z=bZUwJYfjodJSLCs*}q_7(%Xi-|tP|Pg+&NDWmZW2UCeo{gyRwXO(V75W0rF(N1bN
z`@DB=hO1Rg>)>_u2HwAY_W`!^=i>$_DmygT!C0RfK-6{M)gxFrN_&xY@Oj6++~bN?
zjWAf#Ske1>u9YCF%JhTKSEPVmIBAvWMqgf737x8>9+7kA>qU)*i%^|7brL3BOAB)d
zy84$EDx+&PcR7MN`@0>F;qa2;Q=eN^wfC}0j;KPeT8%h~(=>YnfC5v`6L#d}FZVa<
z27??|IN`lP0uX*)&^kAK3PUp>u9<8l17n-;<`~1%SZ{BKU}%SbGkGA8v+O&I5}+Jn
z$_qw!WkF&n)0i+QP~cmjdy;YjSqf1KtB9j~1-pn-zVUrM(&8a23wVqei_(G;4jBVR
zaz;2wi>RPkiod?0{U`jOX}ke~7A!%YW{sEABtK9R2Y0^p8dqVtcr_0P9|-A=h?^5O
z7dR$aTpq|VjS_;IPUvP5jRdK;C0{O9JV|gx{#!kW_Bn;Zzh3-AAhzlv?P|IB1M|n$
Ad;kCd

literal 1392
zcmZXUTW`}q5QXO%iT_}Q7eH;o?Fk`7(ipI4F3Lr~Q<YoONJ$(yX(9Z0+V9NzLW(SV
zc4lYKoIN|<`@aoqSj791C$dj=Z7W;b!k*d_qMGXy8QO;D!cw=lwk0;Ri5;*hUYL*U
z5>N3p@jsx<SwAEz!{6G{_V^P<iVJPa+`_*_y~2k1ogIDc(r(C%>^bN!uy5>@y|%ZE
z&P(r|oiR>w%r#?G$ZY4|iff&jCJdD!UIAOoGPvw{GrM!{b^Bl~8`#HEjf&j}Ml0XX
zj{FpqjGb*jDfV|DW8wY`)>3ZgbH`kZh=^FJ-ipy0v<iPhRI8=rjM3JaNw)%DtLJ%z
zJH|S<iB0)xoz6(J8RLRUsI_s{1&Wv{b46A-ODU1k2i3Y3XV}KSJmFGt{pDKB_=?@>
zZdY&+qBsP-RBMl~T~Faz)YZ8}CSAq<nwfA$V*Q(}$E;4332Gk6n&#`%Tmx}B{G+To
z>A+dM_x?^91$C95xz=^|pK+p%N9ym1OyNGK>rSiJLAl{AG%2k1^VMQl_35LYec{`*
z4t|2B5vt0Lh$eK}m{IIXkFAT1iB|~KDI|1uOvccWdyLf4`qr?*6>1IJa$nwA$t|+)
z%!^mgE6Q(DNzA&$6HtZG^XdaUaaT+=M`S5SRYTTia<%d&_8T)|u0Ju(tAt&|_M^n9
z&=a)i(^sn5wtC62(ogqN!{drQD?3NGiS8C@ca^K#2W3$1;0o*>sAKSBa=NhWFbX*O
zSA=nkU3$l;3(m<NdPWV~;R&~hZomI;J?;B~+6h@BaEgDg&0clpZSQg2B^jrox(~MY
B*m(c|

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.uni
index 6a5b8c972fe8c4b881826cee4b4a1253706a8fbe..98eae1d697de7408f78dd990d0765232b90d40d6 100644
GIT binary patch
literal 933
zcmbVL!H&}~5WTOo|1j!aplXu^i312B(!{V9Z4%iD3#XNvxQV6IjvTj8zMhF&Xe+cA
za)~^C@6DU>Oc+8qox;bB>g4TB7($$vz*j4%t=dZ)j4>ZCS~Xl;Krija*zGZ<v~o&x
z>X&fJ=o!?q@65r&iFWn?UuETtoq46+n!T#!;8P8~tkgzTFi5*s6-JdFdFRBj=?_*l
zt%DcUOL%>M{}$%>d-Y}pR6E&0Y;13=&m2J1b>PthSUGCSI(WZeAFk^_3yl?95V{7}
zN)T0Lw!P2?r5o4^CoNVpfUw7&bZATuviA6`sFAQ2suSx@!cN!HdJ$w{J4VUM=o%Yh
z^Z;h#?-o3P<x$1=;76;f_HSB+WxKJzwHlmN>)pr=01C9W*<nRa{&at&PG->N0oHhL
z&;bbNWn1U^cVTFHv}<;@l7X>Jcw!9UdZ_28L(sSVxhD?<a+ZB&(F!Psgz|#XMOlyp
z$}}Mi3IzBPXiQR0AWI=iVG?nKPhb&o%8zgRNQ;N8EZ{L>EJ_PXIAjbM$r<4!Euw;E
zDTY2F{X2Z2X)*(X6ih+BjTjH7t9(gGavp){6ld`E=5A~bJ`lQlT4hPOBu~)-4^dpe
z<#*Q!-RwjoLF#$QVRAjwlV`LN!ed7B(c)R{AFcn`gX4}|ErK7D%SD(!y9j9aH@iz8
AkpKVy

literal 1868
zcmchYTW`}q5QXO%iT_}wFMyf^kaz$gMA90tfF{a?!c&zvmqsc{6sLjm<ALwY#&!dV
zP+yScUGL89nKNg`_OG9Ht6RkVh%2(!HnEvq+1T#eJ$7X~v9|S@yY`VQvXQOu+2FIX
zTH#mv_v{jTcHl&0OFucW1?Ru+_|0t2$u;)?4m10~tkr`3V~;%M^cCxyTj(*?HCWpF
z1a`_w*vADo#ayws0c(VZxaC=8&L_p9%u_6x^OJA7^%bu?|9u&sfW0KXbeWR<8t(_3
ze#rdP9&<hCsk&V~v1gu5;=IS?BQ|2Z^s&sjhNXdB9woNeubi1GpgN4G!%J&g$6ggV
z@2f{pValli%14ZI&PMRP1V!tVYk_U)wj1)9lTpNuSSenpjW`UPMHxpGlVWpMP`Ek1
zPD^*~Y`E270~<1G@7h@iyJQk#h3?2v#7ulchv-=>7Sydg*Q85NS%28!QgZy}y_qup
zo$U-ZLX;Yze-$fZt*nRe%zIIFiA;Si{u3;rMq>RPuRmGsDihRHw+^@G7h4U)X<bw>
z0)Nf5v={y+s>g!5@?W{uHSd@y_T3m6J43jS=(=4?4U|jnT$6lOKJP4sRhvF)*;~ej
zzwZf}MyRT}$8JKW^?8b2>AsyY$LyB~Wfc-SJI15y$St1K(Hbkv!WC+Tx#?@IZojwZ
z*u|^m5hFXttK-bh*iS$eM$4mjSc$v#6tjn~d=xc!y}?(}zc9bYBIf$8#M>w#i`YIF
zI3;?57H#@UF;Dk?_w)s=yROposOX&V1_kXdKxuKl4^nIwu#r|$wSiJSxE#8UsH5J5
zDYYLks`JzhRj|aeQhd?&eWxpT<fV#sK~%Ndg^K&Q{hQbS`5$CxkY|4Qk5GP-4*e0T
N)J^Z%UH%9`-QW0^A&vk5

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmmExtra.uni
index cd71f57ed9548ffcd85e3a329e49d9354364477e..d0a8d54006f3eadd1fdc20d1ddf75f063a70d4ba 100644
GIT binary patch
literal 688
zcmYL{TaVf>5QX27_zxrc(jp+es4uIkY9MacD!Ir`wA&|S5|da;?8tW5rN6$Dz|yB&
ze9p{w#uEe(ESK=(q*^(j1p#D=cipZZqF0G8us5Y>)n8cw_g3lJfzTD~jP_Fd(J+~I
zroUKKHy+-XAK>%HPhVg?KEAGiqOwJU?Tr;)8NGq9ZDCS7u+m9;meuClmVLjM%NymO
zx2CqDoBH`if+$PV^+I2e0y^QPRiZ^4d*yCbDYZk+k*^aK8qPws;@C<UbR{i}MbOn<
zBa}v0YUFWXPSe?zN3g$EnL@oZs%-9Um2{{=u1Yza#BsQ0fgG!z22AATtA8tXgF%i9
z9P!*B0f=c{(0JcJ1cB)h*9^9l8)NI>=5WE$RqNZwrf>THGkGMCvGf-UW1t)&%5z4y
zMNT3pl87+KQ7}cIJCbk$X#!yai;$yy0o#yMzM679(flzja(D_E3zM7@4k-ghGDbK_
z@-U}qg1>&E{SW-6Nwflj7HmPDN6jRsaki%<+T8h;OI(Hd?A<sVydb1IAZ|w3*x(SS
zQL!h7B#a4aTA}Mf)Dom#7koZjWY(0@Ib(sx7*FHHj9WMD3q;QZBCF2QF6Og;@_W>M

literal 1378
zcmZ9MTW`}q5QXO%iT_}Q7eKAUMZ6${NE!ncO&sMS%2SnFQ%gx4IZ4~_<ALw&`jQ~a
z-r1SiGiT3^_wS#kH7($M%@f!cyR+0*wy@{+46kB+JVRUaT-nwR*0Cqz-V@lhWj3=3
zYf}4-f6j`b?JZ}%v8C;pPq5^_B6mY<;l5>sa`f@79o^cc-IE#EOVD32zOy&>*4|@X
zR<jRwfgKl^D{NKBVX5zg^{J~E5^2Fu8RF%!#Vm)*jyJal$33)9*0zCtuJ&KE8^I`b
z``MD8fub5~P|E%7$ym7g4AvR3t&1HCEdo4ZrFtpWs!&HP>N-+#hG*lLNw*STtLH_9
z2W*|x#HM^z^}q^6bL^6dueC1f_)`!wS!tz@l*l;wdR?0{>@dGR<5F{cbXv^#irx8c
zQ#c4w9K2qtwPUVbPvLobE`do`@xLSD&q%DF$oikvxiVhOBU#g8eO727PWux@)k%BK
z;-l;649lyl{M>0Bvj3bDZNlJG{T-eu+~;)Nc_akop10Jb9JQbC7Qw1dA0_sUZ_B#O
zV>As=RpSV6Os9>pBB%7&dW;eN8lgUgn9h#K7&_zxOC7CmgHgCbZ7{aoT(gUcTVOwl
zi&x?*YTlxfnDy|-pb8^#)d$SPT|U(uk)<3}^;uuZ)yiLtKZuCA{=}%L;&&0*O@&jV
z$7s=~uT-;RVa2i5Pd8E1`Q>|2b&hTm-7V7YwotbZ%Anf8E!YXDWAGz#da&$bc^v&K
z!Z<K4UB{>kF3BFcj0Twcul4Wkc+?T9*X8lIjQ?ZGyRN=pbgDPh(WoBRU6OMes{0R^
Ch}L=l

diff --git a/UefiCpuPkg/ResetVector/FixupVtf/ResetVector.uni b/UefiCpuPkg/ResetVector/FixupVtf/ResetVector.uni
index d746ebcef4d4d813a9fe225f0f6b01ddf37b0247..06af9d2ff0824e1ab4c5a63ba628530f058bfb0f 100644
GIT binary patch
literal 847
zcmb_aU2oGc6n#hHKOA*0P<72fhzEoaY2q=9HmPEFgQv+&+{9862iqCzzsK>q4+-&x
z{b2d}+;h*lzEOl|KF8OCYUS%!QG`NT>2NJer_B@yLEb2fYkmnMe~rpWi~XqD3Qlzr
z2X#LV7OICfl{9eLhkF0mNHCH>_RbtJXw|#r6Jw%>qfvF^@TPo=_ZJr*aqf?I9~Pj!
zlPwZ$25p2>x?du0TLiTA3am7DvRZy#6<?m{g22J(+K3L~R9uv$?gr5xRbQhMP8uaz
z8w?2}(W+ARR#pMuiAqA;3Dt^yD>3%LiFe?$IvXIR?khFvvCxO$ZpBipA6NqG??#mk
z9?L4<CO0*%Qq~!@A0NDMPkI==At&$MBhyKXS9!$VziTf5!UfjGx#3e3>A|bjqbcQ5
zn>spW*l2I7^V4NHG($+?R|MN4|5n5sP==H;UeMK!lN7rwB?TrxP)`$*F@iipoM9F-
z51(NbGs+f$>4x&Fe8+JU7e$<LN*MA21=$vak&MTj=9v#&`t+apPP23Y;!}JH@?*jT
zINfa5l%&tUKcD-#n)cb$8UH(8-|Z$(cWZJRulyxWI9{%^R`m5KYU!uxe8(_*Ii|CJ
WFr|bg1>H^(pSk{G`d_mhRQv&Jf&-iY

literal 1696
zcmc(f-H*~x5XI-&#Q&jTU)1b^nvD;}7-6?+qXL1lt52qU2qZwUly&!?cm17vOA7|0
zZ>H(}nz?7roSF9iXTus6@IK)Q?2Uc1xh-sB5A6Y`vh~<)cyrcQ%p+E*Wu-^u8QYB8
z8|N3>TjmV^@3!SsD_Mqax3Dqmobx5;fs1;JW$k?Cw&F}N##l4wnHFBF;^xfV>sx3S
zSSH-a@w{Wb=B5yGs~_Qbfpv{vhR+nf%IXn0J!XDxPkCOjIxBY1?A%USM-Fd-G6C_#
zOi?mRTn;JLI+iAOc~scS*k`UhZs0k_^Odzw_4N^Um4a*hQy4175|o4(UNfJ00_PDP
zOPI)Z=W?Fnxpb@)Z_a9gqE&?wPNnw(+sLV=$_jUfuiH{xCpWz6hJ>oACju%Y7Q32w
zCb`=$UFCKtVkXadsgIOMsk5r?@3pLNm+U_taH+WdaNRUw6qmzn=fo7EuzbfU)`q>Z
zR*$K-c6E`ezRR}cp$dufE#vQ;4t4Qbs;7p<{j^X(jPgBQ)kis%c<H_wb(lJG1A{G$
zq;#EiMm-zE-`9S_$q>&mJ$GoSgEHf-6p8IU{T^7C?&;V&#-@E@AE9J`mYQQuBl>H=
zDs=h|tj!#99&qLnD(xfsImAO>QUGe3vFXMdvv7r4V{W;<cBgxsuCWWX<01xjjaSbx
zYjYlfDvXYc-eV{3I#bLTU->Ai_tHN@(Z4W%z#``Q{=y=P&my$XB~FDNp+%Q&Qq0Sv
z-@g8F4aZ%Y>OCoYW<_lRSV+IGAa%ePfEKcAlDoGwQ7gvpPtOT8)Hg7t?g^v1PMvTD
pmYCK+KmIqZmAw9qlPcPWjjG)(RXoP)@0_Z?&J{@i|G!;n@e2a_1(^T<

diff --git a/UefiCpuPkg/ResetVector/FixupVtf/ResetVectorExtra.uni b/UefiCpuPkg/ResetVector/FixupVtf/ResetVectorExtra.uni
index b907f406beb9f0f1762f36560c8cb90c6be8217c..f18a4f0443b72c882ae7a233f964d9b1839178da 100644
GIT binary patch
literal 654
zcmYk4%Z}496o&Ve`VL2(4OE>55Gyo7q>W)L+N81*23D1uxQQjlj%;V3JUu6FXT&OU
z{9isFJ4ql}F5$~rX*r)I2{7qp_#x|H9qeo^wE8O>;K3==dJv|8tu;ZKFsY+sYln+d
zZ5QB8{T4pFd;f6-6eSv!Zm>=SWz8B=ts%-hIP7rGvROZD*yq=rvQr)gXIm%wSQI)5
zqONT}2y?-D=tYoD3GHLAa1yktrSS+jf%T$6!?RFYoV0||G}6Hog0B9`UR%?siN}LI
z$Gr{DV0TT4slPi_cdxZddQ>4-qdbn_G+xhAV(59q0|ogfyd>RN5aR+T+_wk-BF+iA
z5Qa}lVh5zPqpRiGx;D8vd~)*5{cW)xx*>v;j|2{^_{P#bP!1X8C8L|FBpFnBMi@+j
zNKdyU=LCuz(i|2kNBIIaDW`lDlb&e#SX3oErHrL{NePF70V4-SILXVjq(zRuzM}mX
ze5ZM~0)iH-AU`Kfl+*oTM@hDx5@YIeiQoC`Zkh|;4bmME_dwWGaNHMJwIjzo-4nRe
a!nC7kB}j8$aajES#(LX~S}vxj`RpHstIFsA

literal 1310
zcmZvcTW=Ck6ovP*iT`1OFKXIBjZelHiyd`h%Mc1ypBiqZlK?{o+KNA3{nnlv5JTo%
z_GRsL*4doDf7;fzfbS*0z&_forM9q{J+&uT<?FNC@NMlo<Agc09Qy_H#70D?_8ZR>
z+ZEoN{mSO#1bA0&|3vHx-^|AfyP5-&e{DO@o!cFefjtNP1@jwwWv}h6ov@Belm%<$
z<YZ|ak&$|h5YHK$6d@)Bnz-at*Ew=~aJHenw+^TKP@lEoGk`<tCs-4ofub5qP^uGc
ziJ19*0?!QJ+I_q7^Z^#JQoWSb0<;EygjLznZo+Ei%%ot2uk2}A;eoYoWn^PU<=vAZ
zukN8@Qq)>H>k3886q(lgNQsPFZt^<Z+By4+11=5MN7rJ)D0YXZP2nI!aVYdstqpsf
zdJNC~dy%SQe~Z1iA#wgi%rU1!T?#FCM2*Y*tW-dZwtKp&bGF>XJMUffRH3cnb5}a#
z^f~w0KGJ@JWeoGFogR5YQ118|MF#fOBG~lkp2WT|p4lb)7$pO=)I7i%(_ceYk?T9O
zE^~xEz*ZnM+Q;;BM8uUNC#=-R8e7c56>5vQ<9qE+_BdVR7i!`a1G^@w@65W`V^D>W
zc=bLzahFXs2gE8yRg0+4#H#vF=5Kh!T>rnQtWumJvL7{0gC3(rk8V=Ua|>&ZjedG-
z+HRNaS=}#sHS~r^yPHzo9w`0#1UFzOpbo*0i0Q)el2rhT{vSfPXP$eX=<ZL66}J{B
S|9{7pbi~v<az>OGRo_21rOf33

diff --git a/UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVector.uni b/UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVector.uni
index 0773173b2cd5e890fe0e8aa788a17ffbb44f1b53..43eba267b62e70aa550537d8044717f8e0c7c722 100644
GIT binary patch
literal 754
zcma))&5qMB6ovOlyu(#z167+02(ds2ksrfYv`J;V46H^@;wF|-JF?w@zCAadGOz$a
zys+$h&UcUPq$#A!CA>fAQ9XT<rofa}0Y0lXSO<+Z(w*o1f7S{+ot^H70MFXz@bdcl
zHLP)Z@oELs1T{io-DI5%+L{EiafGP$;IN^)S6%WpXYU?ci9vgqob8=Ff;1h3L4j;r
zdz_>>YtzF~2IaIIeT*iZf>F21c-2MyQFds!mwJ@VsNiHe<st-KM;|4vHJzUGc(8|9
z%XtZ#2TG)V8+1E7w$;j`3UhVZ2dA6U!&w9-JDl)9L46NDNtY~`@(c~uEd~G?B6SF1
zdXuJh!nF3}T9sJWrx%A$8{e%ji)0$6Xc0FAcC7x$vMo>!CFO$Ad@o1|`>G@iW<g9(
z3sP|cbp=@ki;Sau0eQwLUq#X_6*u)>z-`7@RtZWt)C?HeF~UhDGC}JKw?3f#D}16=
zxdMU~Y(c)vnkc8+-G-7fnTe6QT;e>BtNCW|bui!Ewl4P@a+l?}$O-|!e^;Y4{Ymx;
blv(dNEdKD{E&c*52`?Dk%}IYD{~P!Nn84#z

literal 1510
zcmb`HOK;Oq5QS%r#DB2T4WKrG3b8;4kx&B`rH&GZ!U{Q$rk3(Rb|~b}1K$}tc7lpj
z31r!KX72dRxo5`y^|NCg3%DO~1@_9WEVG5p?7rP2s=WbT!M(x$$U4DVTaGs-cV#K|
zw$A_e_g;hk6~r9$xm|nR2ULAX#Z!CC^$hEz@}AgJJI0P+vVq+KTL?KAdZt7(td+Id
z>9Vhk2D@;tJYjA(AWX@8VLi_M@|II2Fv`#)06zzJ?lqS9DK)078!~3@Phh>aC7IgW
zx>|E~md<MCEK>LsbseGP{`P|G3D(NB7w!&UZ%?ZVH`wY|N-xy4z`i*PVK+>qOHNg>
z-l2$@_-3^}+FjHC=DnT`?F|3?fJ@Wi@2<s!r*IEXn^9AUQlr#MwF-P`KZfUiU!<zo
zUlA`mB+fs``IFP3E~S=Rvc}c>>q-GJ+U)77Ioi;P=RVb%uu@y)=dN^{)93WF1A~3-
z3nF8fPno&Hoi-@f+>IiMy|WNDeWoY2w>-P{0Y5^?04=p9L?h;FgcZ8JBfDS?i3h|=
zghu;_c@D`KI&zGqIo7kqDqNwqSbOfvJKp1T$-YoyuNc@RSp#QwK|BIg7_nC$;EB6p
zs+o|h991o|-jJ*6pIP6tBj)=4!m3JniqJmQI1PG)7Ja5kHP86UcDn7>!2d!Wk1MA8
zsGgY>y$N6;{l0({gE0av#OreQa;J-033-3Jj_9GjfjNCod1~r32`6BQX$$nb{O?*d
W%eygDe}`~W@B6i;x3T>H41WXbhUHQK

diff --git a/UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVectorExtra.uni b/UefiCpuPkg/ResetVector/Vtf0/Bin/ResetVectorExtra.uni
index b907f406beb9f0f1762f36560c8cb90c6be8217c..f18a4f0443b72c882ae7a233f964d9b1839178da 100644
GIT binary patch
literal 654
zcmYk4%Z}496o&Ve`VL2(4OE>55Gyo7q>W)L+N81*23D1uxQQjlj%;V3JUu6FXT&OU
z{9isFJ4ql}F5$~rX*r)I2{7qp_#x|H9qeo^wE8O>;K3==dJv|8tu;ZKFsY+sYln+d
zZ5QB8{T4pFd;f6-6eSv!Zm>=SWz8B=ts%-hIP7rGvROZD*yq=rvQr)gXIm%wSQI)5
zqONT}2y?-D=tYoD3GHLAa1yktrSS+jf%T$6!?RFYoV0||G}6Hog0B9`UR%?siN}LI
z$Gr{DV0TT4slPi_cdxZddQ>4-qdbn_G+xhAV(59q0|ogfyd>RN5aR+T+_wk-BF+iA
z5Qa}lVh5zPqpRiGx;D8vd~)*5{cW)xx*>v;j|2{^_{P#bP!1X8C8L|FBpFnBMi@+j
zNKdyU=LCuz(i|2kNBIIaDW`lDlb&e#SX3oErHrL{NePF70V4-SILXVjq(zRuzM}mX
ze5ZM~0)iH-AU`Kfl+*oTM@hDx5@YIeiQoC`Zkh|;4bmME_dwWGaNHMJwIjzo-4nRe
a!nC7kB}j8$aajES#(LX~S}vxj`RpHstIFsA

literal 1310
zcmZvcTW=Ck6ovP*iT`1OFKXIBjZelHiyd`h%Mc1ypBiqZlK?{o+KNA3{nnlv5JTo%
z_GRsL*4doDf7;fzfbS*0z&_forM9q{J+&uT<?FNC@NMlo<Agc09Qy_H#70D?_8ZR>
z+ZEoN{mSO#1bA0&|3vHx-^|AfyP5-&e{DO@o!cFefjtNP1@jwwWv}h6ov@Belm%<$
z<YZ|ak&$|h5YHK$6d@)Bnz-at*Ew=~aJHenw+^TKP@lEoGk`<tCs-4ofub5qP^uGc
ziJ19*0?!QJ+I_q7^Z^#JQoWSb0<;EygjLznZo+Ei%%ot2uk2}A;eoYoWn^PU<=vAZ
zukN8@Qq)>H>k3886q(lgNQsPFZt^<Z+By4+11=5MN7rJ)D0YXZP2nI!aVYdstqpsf
zdJNC~dy%SQe~Z1iA#wgi%rU1!T?#FCM2*Y*tW-dZwtKp&bGF>XJMUffRH3cnb5}a#
z^f~w0KGJ@JWeoGFogR5YQ118|MF#fOBG~lkp2WT|p4lb)7$pO=)I7i%(_ceYk?T9O
zE^~xEz*ZnM+Q;;BM8uUNC#=-R8e7c56>5vQ<9qE+_BdVR7i!`a1G^@w@65W`V^D>W
zc=bLzahFXs2gE8yRg0+4#H#vF=5Kh!T>rnQtWumJvL7{0gC3(rk8V=Ua|>&ZjedG-
z+HRNaS=}#sHS~r^yPHzo9w`0#1UFzOpbo*0i0Q)el2rhT{vSfPXP$eX=<ZL66}J{B
S|9{7pbi~v<az>OGRo_21rOf33

diff --git a/UefiCpuPkg/ResetVector/Vtf0/ResetVector.uni b/UefiCpuPkg/ResetVector/Vtf0/ResetVector.uni
index 591dc29543f7c591ecab6d4a388a16927a564c6d..3fcc3f084ca9109ff371cd4138574a620483263e 100644
GIT binary patch
literal 726
zcmaiy&5qMB6ovOlyu(#z167+02(ds2ksrfYv`J+<46H_O;wF}oII^9AzCAadGR$T~
zys&(I&UcUP#4*I{HGDqlUcGz~$H0_R9=@yE8@m*qFJ@*sTitdZUe&MR?e+D0*y8l&
z-3I9BRS%i5ld;lkGe(f~Jp{D_i!JQEYNC%R`}EjDblSmWO>5-<a%{kN3S?cIVUpun
zk1Y(+E30MiLMCYy^tx7~Q%%qhvO&YW)V)0R3g)p<HbBrdxFD&`*ytsX19J*{DbHc|
zKnc`eovypbwpuw<VXj6yZ}oA0IE%n!rx_3A)o=fobjgA#&v3+jg8@MLK<&JrKE$z^
zFs+$wts-OF_~LN!(KXx4BAU7>Si}v111rC>WDk@>PPt$-tpv%TDssYL5rp(KBLyc=
z7LXLMN;t|_kS3h+O(5M;aZ^?TZWG3mLQuk?WWdOQ5l#w`2wE0c`hxbK@QoJv1_)ZP
z1^KaPf}HLTJ4*6sAqMJtjq@_DmYc!X!F+f7GOu>zE=h5bWCEUkSG^qDS+)w)xUD#>
Wp8jd8XGl5W8KZ|K;y>2^Nq+ztn%Kbr

literal 1454
zcmb`H-EPxB5QXO&iFdHl8$fLW72*ORL_!T%lsZZr3RhMBnp$cSWQRgt9{A2|Vkam_
z2qDY6JF~NA&Yl_j=Z}`PEaH8{6WJ@fw%l%QYWM9PUhVa;O5PRgkIZ9MODn2~e~Ekz
z!WUbElH1H~9Qy&t56N+Ak9nT4I@wrH?5Q2IPHaKs6n>Ejp#VeU5O2<EVNG`0>?@+i
zF5L>ZDC`b|36U?X!`)sUxJL$~oI6M07vRo3#~gb|jtTRMh^gCSSTAi(r1sXFTM!@N
z5v!@Q7{aHl@(88y)3-#ASuI>&;coGDda}uI$67TR+K5qEzd8$H*GxjLxwGD)h?)52
zl|H)Dk{Z|NI@Y%{?DIV?bxpsy7Gp-S+rMoN8zD-KpqFx$*wTIk&)vF6Rk6RuA1Wly
z---F1)4nc2%QaD>&H3d<0Wn(b=&C+iQHkf?x$3Z>t>Oz;y2<Se>eGV3uJ$FK5zHs_
z-2P4zlpEe!k<8v%44W?9liFLxwtc`(P%=VG%^BW={u;1~UEhISFvs{Kd;y`>KB1pu
zBKnS;vQi&wY%mK~s14?h+p>;#I9;+Y)YLOZc1cvvnO)#dKov&n*?U;xE}wE{#41Kv
zL)05$mHjjGdv?TJ-(S4R5^fROrwXS=Ptc-EH!0^CU)ff-?Hu`^rsaP5^d40`6TY3G
z-xWwH7z5B^yMmGQlCo{o%HZ>-=ZG5W8<<h|A)~rZop1t{m^Q#T{7-9Cy#9`pD%yvQ
Os@<(rJjCmNaQX#()7riO

diff --git a/UefiCpuPkg/ResetVector/Vtf0/ResetVectorExtra.uni b/UefiCpuPkg/ResetVector/Vtf0/ResetVectorExtra.uni
index b907f406beb9f0f1762f36560c8cb90c6be8217c..f18a4f0443b72c882ae7a233f964d9b1839178da 100644
GIT binary patch
literal 654
zcmYk4%Z}496o&Ve`VL2(4OE>55Gyo7q>W)L+N81*23D1uxQQjlj%;V3JUu6FXT&OU
z{9isFJ4ql}F5$~rX*r)I2{7qp_#x|H9qeo^wE8O>;K3==dJv|8tu;ZKFsY+sYln+d
zZ5QB8{T4pFd;f6-6eSv!Zm>=SWz8B=ts%-hIP7rGvROZD*yq=rvQr)gXIm%wSQI)5
zqONT}2y?-D=tYoD3GHLAa1yktrSS+jf%T$6!?RFYoV0||G}6Hog0B9`UR%?siN}LI
z$Gr{DV0TT4slPi_cdxZddQ>4-qdbn_G+xhAV(59q0|ogfyd>RN5aR+T+_wk-BF+iA
z5Qa}lVh5zPqpRiGx;D8vd~)*5{cW)xx*>v;j|2{^_{P#bP!1X8C8L|FBpFnBMi@+j
zNKdyU=LCuz(i|2kNBIIaDW`lDlb&e#SX3oErHrL{NePF70V4-SILXVjq(zRuzM}mX
ze5ZM~0)iH-AU`Kfl+*oTM@hDx5@YIeiQoC`Zkh|;4bmME_dwWGaNHMJwIjzo-4nRe
a!nC7kB}j8$aajES#(LX~S}vxj`RpHstIFsA

literal 1310
zcmZvcTW=Ck6ovP*iT`1OFKXIBjZelHiyd`h%Mc1ypBiqZlK?{o+KNA3{nnlv5JTo%
z_GRsL*4doDf7;fzfbS*0z&_forM9q{J+&uT<?FNC@NMlo<Agc09Qy_H#70D?_8ZR>
z+ZEoN{mSO#1bA0&|3vHx-^|AfyP5-&e{DO@o!cFefjtNP1@jwwWv}h6ov@Belm%<$
z<YZ|ak&$|h5YHK$6d@)Bnz-at*Ew=~aJHenw+^TKP@lEoGk`<tCs-4ofub5qP^uGc
ziJ19*0?!QJ+I_q7^Z^#JQoWSb0<;EygjLznZo+Ei%%ot2uk2}A;eoYoWn^PU<=vAZ
zukN8@Qq)>H>k3886q(lgNQsPFZt^<Z+By4+11=5MN7rJ)D0YXZP2nI!aVYdstqpsf
zdJNC~dy%SQe~Z1iA#wgi%rU1!T?#FCM2*Y*tW-dZwtKp&bGF>XJMUffRH3cnb5}a#
z^f~w0KGJ@JWeoGFogR5YQ118|MF#fOBG~lkp2WT|p4lb)7$pO=)I7i%(_ceYk?T9O
zE^~xEz*ZnM+Q;;BM8uUNC#=-R8e7c56>5vQ<9qE+_BdVR7i!`a1G^@w@65W`V^D>W
zc=bLzahFXs2gE8yRg0+4#H#vF=5Kh!T>rnQtWumJvL7{0gC3(rk8V=Ua|>&ZjedG-
z+HRNaS=}#sHS~r^yPHzo9w`0#1UFzOpbo*0i0Q)el2rhT{vSfPXP$eX=<ZL66}J{B
S|9{7pbi~v<az>OGRo_21rOf33

diff --git a/UefiCpuPkg/SecCore/SecCore.uni b/UefiCpuPkg/SecCore/SecCore.uni
index dff756a3b322aea1a748929138498bb8d5e81e91..bd43c8b753fbead949c28da6ec081c5ff6c732ca 100644
GIT binary patch
literal 1453
zcmb_cQES^U5PmQ8KOE^x7m~OeV-I7DIkC2yB~Gv$x;+)emSZtn5|Z33|9&SWS;k5R
zgBpX8^xgM;cPC#IK{On~r&_f9`YMWm@^YpOhfY;}%fU6wf#`J0J1(8YH3v#&pc`iS
z#7Bgvq7fGG^~bd^*8PrWKZM*usiZTi1yu)#Zkel<>7dt2f>t|j#!5zpTkZlWq|a0j
zv_bboV|m#d;r2&2P@p=xG`OLJbWr!QbOIHG4K5!SAt~Y^tAG#^R!1+G_*`rzmq~V_
zZNct@D;sbs5Ne|wFCDLZx_ks^zt>PBBXqn|XvFWgBXq?!zM8z#$}qowIA*d6L?uIR
zw5)vnsbdCtZeN}2J5zdZ#I|v8TfTxfcX#h#jGxzUN03U#Tfm-qW}oc@Vk8S_3%;c0
ziC2>k)BK~C3UZ-cXnt#02k0R*g_Wi1G?RPZu#P!y1Zxk4V|XE2QF3W9Rgdpj#eqFB
z(T2QwS#c9cFsicwf-SFv_hV1(n$iU32bSPs*9a`-Nmg)weee!d!a5^1{UMjokGjW<
z9RKM~R7W%DV-Fj=ata*)bAh&TPQQ;LrO~eHP01(9Y@=g@jW)I#9~Tqd=yOf(39Rzv
zmpooTN+C&Uk*CvjK@wPJ3CW>AKu95-k&F^pW)NpEh$+GcFpX(SN5Q~DTHG(!1w6!g
z9%n^LC@gcx$tow5WJO%0%M7<ZWB7OYnr6ue2!@~p`Q|YJo-S7NlqBaXFdSm<uCH!<
zaj-$??s2h9)^qY0PjL~?3i$K6X_?&iZ0rAs@tVTme}3%21*L@0S)Q(Z0%xsfN-sGK
fUVIS1OAZ0}djK3}#HA?^PX93qAOJ4R0_@2z8_3^*

literal 2908
zcmd6p?Q0W35XR@T;Qw%>Us`Ds74d_JnA%f=+Jq!U{Un!{rp3IJOKR;uul}Cd-0d~g
zN(({>*}I*coq6V&*}47wt6>dG_&?&8*lRnsQ=8h@9@+z>TI(?z+8bL~&Rb$L-bQxr
zT8XXf#4^T&eKR|A=?uL&vL#ZjYgf-wY$Rw%e~GMK`iQ>zte*P5Fc!OoDn~9qoBlKV
z&g$GItPQ~?&pFR2^9Aul3_>TY$H;T+Bt&uMJA`Xt7of^*&m|4s#*TAUL7G_0G29$$
z6>W@n6OA|+f*=R|$}T|@b?eN;g_sLm=4*|G$0{C<**nL=3W=gt29_nKiG8zA$cs#+
zYhEs`gH(KloM~TYgO`x;k7x~u{Vqr@*gN$MEMZmg4T(mXSX2<65&Hs}c+faPBV>1M
zyS$5`mFGy&hTKVG>{@}5LVxNz#8n1rRj|BCQ<=??7W&oQ8Tz9Nq9J+#cVK9NmB2<1
zYqAmWY}-zyDq{WWl$?<%<#a;C;&_|rc6dIu$NZl2wzr-=v1g9D<=GfJU*Vh;n2X#h
z3(YmMXj|v2sM6ei5bX$5FKyqt_Nt63qKl_1Fh5~;215y>c!(z@1GCPO*wfl2@q`mL
zV=i8WLR?iVPW*`XDQiRC=AJ>>E$nOe$aOOCX6PxaMZQ$eTFom+g0C5tqLpyUN9->6
z(dyN+zE9o`kgAF!mdM40cbZU@o6(+vq3B(q56PFhkD?w>k%eF7C7utR$WT2({S&QC
zR9Bf%EoXkN2hNH5Qs6+buF4E1UP&u*@xptuYAmoT{oLcLvp1*a8XN2{kqp2-qUx@C
zuVdwef5A!dR6OtL*6IsgYuh`<CcQ+xug7@c&py%?m3D-7>P#QmA<q<fv=Fn<qWh<4
z=sS>L^^mdYV~wZm%6g6GzRxw=EwLr`nRVf6yGPBNcoMQh<SneqM%%r2nF+gO^4UjA
zI`SH{-mblW<@tdXAy>yq*Iq&tseLK!MC&cM=ulVkd2nqP(6_YV*v08qSvlbZ^}y2g
z?%Zbo5tdSBP2vtKO_=I~<!`?&KQpp*PL)i&a#Rg_*b>Sb<Nx_$*KQe;s-Z_Ts+3Nd
zf$QS>cTBN&-LIR${l5|1-<yDLJU8C}s`rT7-UZ^`yWI*Bzqy2de!F`?I46Gq&C20^

diff --git a/UefiCpuPkg/SecCore/SecCoreExtra.uni b/UefiCpuPkg/SecCore/SecCoreExtra.uni
index 15e22ed85253d9e1bad6286d049ddc91125cc6ea..c4bd4da20e9e49179f810901aef64376a9e2d8c0 100644
GIT binary patch
literal 657
zcmYL{%Z{5c6o&Va@(xGorj3%&%dD!ZDgn1+H9%w&O}mO5aKMtWk!@z0K79`)ldcf>
zzkKK5D1vCYgl}i1<$M-Jz-5(KCt+tRq19hm0}oD_#)B|5B-R9J!l<0oiR~{=HEn>m
z)jRn3{=+9&kB^5HP*iF(xZXMulr<ZOwT4OU!AUROv#d8?w(RRYu56Wu-r2^9Zt4rI
z1W{GC>xH=>1#}`vr-b%Xy+BZ{Drr1&j(nY{(eNyk7AGxXFtv0rhM=pvj!;=stC7cp
zJx^y_p2F^$GNrz>s%r1GN_tcwSFJp5;xt@mff7^C15Om=pYR%WgF%i9obcQt0f=c|
z(1y@|jw0J5t{q$@H`X=L&Ecbyuh+MiP2cwack)PJ&x#)`&VX`ADK8n_9!iqJAx{Z|
z5(U!;G$A=BP~;Hju!uRz7qE>v<*R9~Ct5xhhZ3G*#^SuBghRoAkv$`v<YipaBF9hP
z(f%8L(mY)OK?_!pU!!J{(`>(^B;DNkmP@<}^VyqmIrxK+?ufX1!p4GQR-}g=Ip%Rj
eP@{!u2GK~6W_{rE*@BZ~ydn}ZTMt?;=CglQLCA~%

literal 1316
zcmZvcS#Q%&5QXO%iT_}Q7eH;o_Jj~3X$@F3i?RrKs+^=vEoGCFwuB!Kd}po~Qcz^y
zxpQaEoH=*m-@jVcvWVw7zsNq=wPm)nD|>8@@ak;DZf0k;u^cP13#^%?L}m69&)j47
zoMyJRh3(j<Sn?}tZF{2hE-}kBoNw*mxeL1?CbFlXKVyAmFYKkg#yYKbZ|np+DKMAV
zf!EgArQ~N`vB^mrhKdlcfGuX~VaJo(opW#6JL}lc-v5W)7)F`*vn755N=|1hP|E)H
zL`ahq&NCubw)L|^p+$s8tW+<<T7p)0pW;=vl$>F$otbni@s&L<D%@e~Zc>}_R^BZc
zI?b_5CZX2KS(hkcrpT<)M@nqC>pHK)J)g6`IO0-sy>~5Uy#MVsgM$#oA?T%AJND{&
z3eUgqB{JzM{@0v@I}+<3L_K76tV~ezK-9Fz-xL~%Q$1f1_<Md^d+Rg2!3ydsK6kB~
z^q+I1tq1Dw@J!)8XX=itH$l1KDK#lq_4C<cSPht?zJ21|wl4bwO(Rs*I>wtYX%np2
zm7Z9SHO5~f)VGi@*)b6#NA6>3qV;aD3RkEN){gJBJE^!u_LXz->U%})+f)*>9{vPW
zVf4NFke#^8r<!A;6r-vk>Lanr{LcD?6EW96F)pfvE@Jyu;ne5}S`3&g)jYRm#j(~;
z-=3EH<$F?1j=m=P{z$vaLfru<!>WTzu=}7+z>kUP!Lo}LaP(gh#x3i@Cq`3nO7zGh
X8s6_2HNsa!GudS>=02BKs4JX5;;_nz

diff --git a/UefiCpuPkg/UefiCpuPkg.uni b/UefiCpuPkg/UefiCpuPkg.uni
index 9fbc7310fd30d3349fc2c9a6b26029cc6f739b2f..13f0e41aeb03321c448a3d414ce2e46b726a913a 100644
GIT binary patch
literal 11766
zcmcgy+ivT)6@4FI{$V5YGINmIbf#!g6rIYKbB=K0M39tD3ls=wiMEAEqM%C>&)0Wt
zQj+aBiY+^CUXs|P_TuK^+865TimpC=qJPe!SbqQA)fM@Rs31oKk76z<%hgj9%7X64
zpKS_Ml8G{!#*&84JtZovVtgmkkm6{Xi#(FWB|qe2A2d|iGLPnql70++qCZ_<|Aj8_
z>*qh8lbx0_rlHC+l>?bdFUg8y(xVH?Wg+t?8D9Q<;QnJ17Zx_pMWV5n3rQl-i%XYL
zI;TXGGLJ-zrR5S!3uIczP>)SSh`~=HiUqr&N<*3J)$&6yD>3c}R2oK%ryw;W{%+un
z=*B#Wo)=NDXidUt7y+k;QBmg6w9@OST_|Z*VL_#QDVrzNcz|+AQ+%%gf<&n&EXp$b
z+troIfLK*|ATL!uzp7^xSJNWAsQ<al7TL-rU&rLQcVAp<LbgXE+w)y}aPN;tbbmV<
zyX0elUV%Lv-+E)ZyCv(E&MXhZ&uCzIws)=p{BHYS@9us2-Ev*)*0;wV-MQqB9e3=F
zZ+*+R?{4wYXH5SOeY0;z=QPF?m>B<?$LQhq#JRD@qZO4teFCMv|LzC&5B3M>9vo}<
z&H6Haum<?g8v3;M^Fu7sdByyd>BYTAXHIV#pLN+AjlH33JG_q8;+DN*&ycphx!(D`
zoJGT|avtZtdX%Y`i9mj-qVT~9LVSLs0uftT6bwWmtuO@liwErK#DQzJ01j0;i{=&B
zJ;iVmW;`>D54L_5S&lv2a>GF|zK(C4H$Z4FJ&CxI1orbG*)+a^?YucPaWu!N(r30o
zosytmFTM?yCDy~oLFCKJ9?-|G`|#Im{qys-uj~{UqmT^JS`ouO&o?_{r%`EV(MZN(
zX{VDY$dxBqDE8W?kf+rc#0*M9h2(Rel6`CYWIJ|`1@8pZv148)gJ{NrwGJmrDdE)=
zW;L{e$A?u_<vPm#ew&Dw8#RwWZye(Qv{w0Tl}u&654{udLPeD!Jd{xIRL^6Y*H5JO
zkwtI!b>rIUz5P-3cbAoUC8D<%{UP^pP{D(#z-UC0oUANEfY70I<s16Za(?RVpLHM|
z9$8a>qNNre?QR&f0(?#thh>I6$;d;fM|^E`BB_e<zbQbsD*YjUoIwgcTz|}Qv@%u*
zKT70XRqiVgJe*G$JHezG4wVYWvy=hO9a0C&DcWymQC^f(V$LDF>W0^`y(_t3lMJ&~
z`&WW-dhl9p0~Ja~l)++Wcx;E0E9c1KHX>1f*R_w^u)f=AI0&!9Gw-q4MJ>6!BqZxt
z6G4Uf%hksQ`mt!uQ{GpTc72VzSWZ6B@LrzM5>_YM$2-AG5`+dWipD8t`rT4$z9(-o
zVZr1Xy_IsySjU2G6cx~Bgx_ekZjhcM9CXwIQezD-$(}WTpMw}ko2!7U3X(4}(Del#
zfvgD$L?}wZr3m6G*CC1$nW%ipVY@)($Fb6za9z;Yh}C?KlB%u~ha=A2R2na}$mmST
zM31aOQC3J`DXCbfDh?T8A)!BtW+<+Z^`%^3h6bB1(zsANfof~%Kl9!DF`;x^+p2a|
zjpt4Z;Inmu+UacoDE^pdrdB<IK`wHxK{cDbmmc}h33dXU&wM3pDNXep-b{h=8F`!e
z;A4>N!)F$+Jwa)HHx4_eRB-{L%WV<s#RN!;LAFq(5@mxl%D7q~m((Yx8*{FuT%X0A
zl7bpkL&II5Qk5rgsPUWj*CA{e#0uGHDe|()IN!6fZY|~guZJRU(Go>dp3j7wiDCf_
z`ydSaP;wtQm#31eZOz){8NEfPh0{>yEzhJXy?DJ@2eSri4IaN#B1eCttBJ7|dG&D8
z;}7A-nzbIhK;5J*ZUvEz@LT8tOFhYa7OQ9GG&`?Ws6bTcYc@5DL@$O*>uEKggYl=8
zs8*Zmz3g1g$@J*#6`QsYG!lO>iwr{sMK+F64naJ2l4;;MB<sQTUL8WHZNvNU>J8)X
zb4#Ep>$F3{Wh#*QqUc+iHE_>5QIJlq0}<>^^F*h9QlMn;CiW%WAq?ctQGv?29YWVS
z5s06~68S)(t$?`gB&Nj4XrYB~Eq3nXm6L;MsQMn5<LLTTl}=pEJ=3h}CMq9S?vpN5
zd68j4Z+gBm)IrQzT-g#^Y^?ou+O2OzN!FFj={B}ipX0U-wcCgVyL-cGPqG*F$le>)
zn&{Z7t+G&?X=R~t<wjImAhJI5?bbAx;xSWET54S|wO$>axLDh$11EgvhwB2=jiq=*
zy@@&lZ6*`bP8P0OQnW7ITH7gT(h_9b?9r6@EJcai7hJ=Xxr!%6jw_ePZVK_Y`WV*p
zaO0^b(!_HQq0`&uJLvVE@e|8I9SZQP<p5U$b(MV5RF`cwqF<$JR{Qzek&!PGzMamO
zu1IvE`F=Caq_Vo3g>%I<TG>2+(1-aT^BsG=>e!mJwG+lAQiMbb+{7(JJmW6W#xf7;
z|E=0!J3Is>ZCV$)eN|WX47Q(paBup`=uW?^*<#(B;?7aG%?k0f*}q_9+$EEB(|gqe
z6O>eO8D;3az;C~P8}x6L0`(qLa+;KH?b76kq;_R-r<XR_W1PfYew{(C(#$$=9I|P+
zU0S9=ef`m`oaiDH7`Mn(8vS7!lUsKY(D&mJ>~zVNS>2>=?o8LOK#W(oP5LY%bG6f4
z<lr;Br^206`~}<xF=vPvZt0Hia3O<7lb>|Eki#EOAv1^cq(dC`w%rcLtz}JH#(&#L
zWtukD0%=K%dvPQ$sVeJMH`Eg+FktviCd2E=^|em1*~KnUcFThAiQ!z`EXGcNtaXE$
zq6Dv$oGi;(#X9p>8}Z)s|NkWe+Je*s#P=Z`ogMMXo?y#%aFR=tS7&=7%Y_OLA!lo|
zgO95un+e5b(Q92vv~6=It((rZ&T;P&{b(+>Pgp#iUB6sk<8HyvMcWGRMyZjUAb(;M
zKLdq}w^d$nkai&Gzfr%85LS2I-*VK|H4WqdXIW?*-Y@2|%S7-aO?R+_^KyX;H?2B5
z5ODA}H*@?RmNj(j2e|8DWcgNqS+9%wL%hR#gz3cH2jU0xcFh~c5Ax3jiZ$Qhwv$0F
z>W&BZrrLLU`n$@!Jajj6>$gMyh4)tZ>TOcy`8%&-nQ6Rf&1<Dd?95D>_^#Xk1)}$X
zba-%;p|cLHUTE6HvckxT#hu5h)ZbH9cB54Gz7q3MLz1O4l^CNr)hzp`;cKS$TKKj}
z3M+kY>D+lfWec>@4_UA;^0_RBdJ)~>hZo(vuoUw0alM6UG`!Fg%_~XllHNzj$~F+}
L>x(Y?T~7HQ4@MEc

literal 23534
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

diff --git a/UefiCpuPkg/UefiCpuPkgExtra.uni b/UefiCpuPkg/UefiCpuPkgExtra.uni
index d60a6a285ac7b0fbdd5ce99f1493a67699868c6a..858761af245023fc5ec3308e4d7c2daebe6daa9d 100644
GIT binary patch
literal 672
zcmYL{Pmh~05XJA2@*PI$rHzu%f2XRd>VUgzZ34(9+V&JV;DA-Ikulq*pT1*~-8~`O
z@4flWFi`~2atYthx>fU86v08Ab=;4T%ksCZ73^#&Tm4T}AiUG29zdE3Vr#rIeiJN{
zEw=r|>ALaowtNR4-+%Z7>+t!!0*2BS9j>=ddTq@HNZZ1s9>A$VxhGX^zHa%qm$;(Q
z1N6?;PIgm4-zbn}X}eyU3t~Vgy>eQ%$m0~Wx>ROB$N<;L3dK)SxAN2~7)_<z1Q|lm
z)m?iit*Lb28Ni+)ylq7SyK55sX>{4Vl+<cK1u|87z%iW0sgEhNK;wDDhP?XgpObDp
zh;o4wzFUL<=_f<ueg7qjY>&itbfwx@S4TI;5S@l<eLHOWrhgsDJ%yZScbx2j2}qbI
zINKfyn!q7VD2D<CQwJ=jsi2UhKvGx`f${}xiC|(i0X(weK06ffNH`~H!Ki?Y1E)Es
zf~Ey2SeD||548V+2bLx)plHDo^k>jaa<<QRj3%!euw3FM%x7=HeDMDu-4Stf%0q!;
lPT~i0M~^AlQ$STKO+AMFQf7S+c(Zt3y#Bg)ix4)S{Rd|6%$fiI

literal 1346
zcmZvcTW`}q5QWb(692&pFMwKy+Y>^Fq&3BAX`(a{@Koi}i$!j7l9uq}f$yvxyR=o5
z-JRLlGiT3?_wS#knu_?p<QM6aE|qDj3q92nyxtpN*?XX+HrQPaHP%nYD|RBCXn{TC
zRHol}Ciu>@R*pR<W`#XuW&Z)ObM`L67*|>9Y>rrJ8%|&8n%GFs!GFR0Mz8c*Z&~eE
z);sO7PD|7&Ya`@fcpP#*3przUT5xoPnHAXPmcwSnKi5rQAM1nK>gnSn?D{au!i|>1
zFF<jQ87R9Ou8FWJ)@V$`3?|;&mTE+J%*y#PR?|`+vxtI*V^;IP$cpW7eQHu7->`O-
zh8i*Y+=dh0%`46kISM94u34F<sDqh#l~wv!i3N48&$X%IA@&JTHK$0oL4z^l!&_!>
zFp_f@IyuJ*+qWITv#v*7bF1oGT(VzO$ee!>d!Lhg>@F9pvL$L%o?nzonA!S{7Ve`p
zm3SX|+8tJC?D#w&#@s%qp3QqTSm7CQg9$zNfA$!ZYyP`??B+;)eNh6dE?v~o5o1eV
zu~QU{(A0AuZ%UsHSS3N{fliqd{53*dgOt8bh&T(#9aipVj}2zy8nwaP4z{hmid&>_
z?3-67WVGEPlbN03PeC<CCuHwonY(??*(b^|&RRr$Ce|l^FdwsH=Kc<oGD~rbMBgi%
z8a+jeE?woEhkEP{@LSXj+^y-es(<{N_-(Ov=cT$`P<qu3>}{dcG2;<C=P<MOu1107
guf{kV=HmTwC+wq&89Ju%;KlP7T)%jYikYMT0YSmemjD0&

diff --git a/UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.uni b/UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2Pei.uni
index ea3bfd8c4feaacf350f2c90c951d783e39013caa..0f78a15173cb63281218c744154d0441d829fae8 100644
GIT binary patch
literal 1302
zcmbtT(QeZ)6n#hHAFjF=sJ3QoJRyWg8;@DENff6VNJy2NxQ#V8j%;V${+?@RP%6g5
zMk}>-bI(2J-0KrX5RJ$1c_Wp0{VIxpT|yyjzZ0;~b*}`-);g|~1#(4KIiV|dxhe=-
zF380y&*{XY0<vtRh1~$!YjbO1FI@x7@wSeYZpBn<$0{Q`NA5+{J8i&ePiO{0JY+2N
zgQH$jDG>Jv5a1dCYit8H^a0E7L=AOsWV;2$ts9;qBk+wANYHS18st^Fbw(>dksY@d
zVSx|!{MLi}4jP0hVGfRFx_dBk+c<bry@iYOcjs{Czuun$ZJkgs)27pgJE_|V#3(aV
zTW?4hR5tlIEj}F&s55$N_zt{8?}k^E-gUfv@FI2`HA{}e=4M!jl9gz^SYN;6H3IIq
zRD6w_>DxLu#IXpoLkyOn%UXIp7W5_%Oj!c+p-Y&<zL8b)n^p>oRXCGcT4&_CAH3iK
z1Z;YA<ix%E)#_0U>Ue-PKG&!KxC?C?=eiG3q&t+WdsB&tHrwbCVWYLJ&mIqxuIU0K
ze3aJ&@*?|E#0#Jd63WVgPM0M~V3{VQ0ACP1&>2Y?fh>hMg;C6~d<4^&Q8q02hL+da
zvV@zsDB`rFgh5t7L2|sUBrW5TW-0!4h4An2m8Qul5QHEF`Q~dvIbGy)N|M7J7?1IG
z`}c{T5AF!{trl6boRd{N#X~$R;m_BJ;_bHQTLGdyTQV3uH&LU1uqA}e3YvQx2fn}9
pj*|286#i&Y#)0N}zeYzQhWPrxzcj!9C+5lE`{-rtiSUQ%{{)p%hH3x+

literal 2606
zcmd6pUr$;=5XI-YNx#DeU)rWZt9@#krYhH#RDl4-Hfdt6f=UD~K@k1&ZGUIidlw9*
zyx2D6?!TFxIdf)qmtQ|CRx!u-il4Jjc5ZzeSkIo@Ggc*Q+cs^BwQHN%klxv$W!7aT
zO~;NAvZ<xa2aKF0wr@2%u_hz+vT=fqgwYYZ6Wj9ACem`@EBfr%C01o=xa4WhY+_el
zGDl;Io)F6S2t+&h&lvS=mp)^?ZD;K0+n8};w@A*wJ@s~+@AC*J$YO-jaMoad#OLgB
zTw-m&jvhXO2Qedj>QC>{I6Oo=nx%GwMi(9NDWoI2U^YM^P8auv7#)&xBt5i)hm_gt
zf<=c1aWF-mc}#)HvA1}A?=8mXY>wor@H~Sn2kzia8J;X~5OcJL^|9S~%opej>kE9p
zq~EeP_Lk4tW-)sQMn}Gdtmkpb!UP*?6+@rV2w%?UQEZBjU|Y2iG9)~Kv$B04&n^2{
z#2(SbOpVdcup%ErtmG`_xk<q+#)cq~?5<#9=uydEpHZmnl-c6x7$7@iMJFKSF}JVX
zUDo9BhEEleQVHSA%-A7mp2JWrnh&uQQHET0*`4zvX+{Oa>e{7BtIQ9UutYBAWJf4<
zRvt#%2ZJn%jZi1@rOH#(r~a(Oyo3`VtmpppD@V%aE$u^8%gpE`r*Nx!4*N4Khy!7o
z78z9KP5F)Oy}y4{V}V`iPdwLU;-8Sw3S2I-f6dA%*t=BSvZRcaOTNfS9ChpqH-qD@
zYH{8_)9!FXsZ!gtRo{15tx;=7+yIH^`pD|^3G3n{ScrM3*&ebw7G$}>NHwjtL@&Ft
zUZUUibIle{@G){(ZFrB)j?rp)WOdeSSe1>2_pV!2*tI5~9dxB5uR&`cU3vdb{}qXl
z>n!SS4%ih%V&4io(RvLonpBp2R#)BwdO0edS#hdwqo|*7m$mWI;=VrwQ<aDguyq0=
z@g>O)Y;{2J*l)w19NC&tD;K_gR1=%n64DawHvQARQKcfj^<q<Hw24Yp(<HW#jaBje
zIktF{{SR;94|or3tcvC-*Gll1-%$^lSbTl+7hbnae#iff_xE2i6JCjRUi_R9{j*u`
I<&U-h8)#XGX8-^I

diff --git a/UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2PeiExtra.uni b/UefiCpuPkg/Universal/Acpi/S3Resume2Pei/S3Resume2PeiExtra.uni
index bc9ae0bcb0a9ad7d4a2b267393e65b786b402ab2..4d88423149f4202fedfef658fb7ff2b5211914aa 100644
GIT binary patch
literal 676
zcmYL{L9d!X6ovOD{)ZF0X^l$z?5b&+qD=cHRUk8%*RIS6BTNDe8NgTj>w7_KSA>~!
z&i&2>&x1Fg<LlX!dOGnu$hFXIU+Je<8|-YVO7ll&kexGi-a^$Gwzlqc-3{{5vbD|C
znY`%mHhqVu_aD|+4v&uua8j0JaE*1UGqzsAFH4N-7EZU?U39kkyb)g>aY<oXG|uKu
zRpY#_&`@b=t47sVqCllO?Tji3$K9w)lj^!9&VjE|85u6hl<HJ!^mV2kh7fX9w+gAP
zGc)kCu;=k^BLnPiDPyVE!lcDxtkEs0h$}NKZQ|75x*(y{b5D&r{k!`Yb%!C2D^7H8
zi2!Qc7mBWHK6##P2-o&5)hp|A@9t>5Q=2XCFRP|#{_o_OAr{eh;qSpE0xlE5H;04;
zID`QcNJubN;9C|-hA4y|V&+Sd&#>_&my5C23s0V-LxLAy2tQ0XlZXTaiv^P`O#FmL
zAsu}q`!D?9VXy!r3yoku2hAww`*_D$uzK*#=kzN~CvS%3&<7&ABjLtO3<Hk)C^+oc
oG4%HgBq~*%_bS)W_3|L;WG2_R{dKrJA!ZzVoAsrh4Vlx)U#P&$_5c6?

literal 1354
zcmZvcNpBND5QXcE#D8cx7eI*(4kv^VHW^?<yvVTyoFZ>=M)Iby6EHs>_+HIsBV<i?
zbyfAN*RRX{=Xb*z7WiK93-;dbEU~4{?WsM%tJsZQ+5pea9&E+jv_4}(<k~hiwK4gL
z{lYi%?7gL|*S26sAi8${2Xfc8Cre|2Ud+K1-`c_VF6^G1V9!8*&fK(@_6iokF3Qzw
zJI9W5%q6xEQZO`**`IjDI*}F(l_6dkwwR@G+3}_J=-lh}*4mu(-GA5(VU+lJw&ZU>
zQH>QS#rgJR%zZtD^@iBiV~1RefJdxUFTq;o>WD?9f|Q)%Svxc7S>S8;EU)m0ty>z~
zgi%!=*r8~OT`<XNt@1kAEr^+{q|`@BY`FDmUz;1hVtswWrQ-O*wU{!B-RWr)I0#W3
zGQCu5$6BYJ!1MTCf=O5Lzax^}ky!sE>t9x<%4BLD$eQH)H@ODlRP|Q?f6s4gZ@in;
zW0|_jPhIOe=TEuO1`LkX-{G0SeMZ-vM(Uv4^A(yDv(EF`B3Sk5qn>?YY*~kOjHUrq
zH4pK|blM0ja-~PsWsdMy2-Pjbbaq6>jU)H4)X^Gi%)%9Fjk)b>t<Fns!M+j~ubx-b
zx<w^1>*9|=6-Lji4_Jx2e5yGlOF62VWql-9JHIo3AtL7bCq{Xd>=coGD{(6H7%lqr
zm1<sDz2sQwr&p-qe)-PI&e3b4mq^;(=IZuA8I&iu1-l382>ghgE-X7(!O_mRLH&~!
q-1?YNJ*PgnAYc4ct%h}pef-u1-i9VV)ry%r^vcY8bxyu^72jXgOV0BE


From 7233344929570e0d41e0774eb1216d2f9b5c6b19 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 24 Dec 2015 00:13:47 +0000
Subject: [PATCH 486/525] UefiCpuPkg/PiSmmCpuDxeSmm: Fix failure when
 PcdCpuSmmDebug is TRUE

If PcdCpuSmmDebug is set to TRUE, then the first time the function
CpuSmmDebugEntry () is called during the first normal SMI, the
registers DR6 or DR7 may be set to invalid values due to gSmst
not being fully initialized yet.  Instead, use gSmmCpuPrivate that
is fully initialized for the first SMI to look up CpuSaveState
for the currently executing CPU.

Cc: Jeff Fan <jeff.fan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19502 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 3eed6dda20149609ceb8b50318a780f1a1422341)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 620b0136c5cf..79b7c90a809b 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -943,7 +943,7 @@ SmmStartupThisAp (
 }
 
 /**
-  This funciton sets DR6 & DR7 according to SMM save state, before running SMM C code.
+  This function sets DR6 & DR7 according to SMM save state, before running SMM C code.
   They are useful when you want to enable hardware breakpoints in SMM without entry SMM mode.
 
   NOTE: It might not be appreciated in runtime since it might
@@ -961,7 +961,7 @@ CpuSmmDebugEntry (
   SMRAM_SAVE_STATE_MAP *CpuSaveState;
   
   if (FeaturePcdGet (PcdCpuSmmDebug)) {
-    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmst->CpuSaveState[CpuIndex];
+    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmmCpuPrivate->CpuSaveState[CpuIndex];
     if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
       AsmWriteDr6 (CpuSaveState->x86._DR6);
       AsmWriteDr7 (CpuSaveState->x86._DR7);
@@ -973,7 +973,7 @@ CpuSmmDebugEntry (
 }
 
 /**
-  This funciton restores DR6 & DR7 to SMM save state.
+  This function restores DR6 & DR7 to SMM save state.
 
   NOTE: It might not be appreciated in runtime since it might
         conflict with OS debugging facilities. Turn them off in RELEASE.
@@ -990,7 +990,7 @@ CpuSmmDebugExit (
   SMRAM_SAVE_STATE_MAP *CpuSaveState;
 
   if (FeaturePcdGet (PcdCpuSmmDebug)) {
-    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmst->CpuSaveState[CpuIndex];
+    CpuSaveState = (SMRAM_SAVE_STATE_MAP *)gSmmCpuPrivate->CpuSaveState[CpuIndex];
     if (mSmmSaveStateRegisterLma == EFI_SMM_SAVE_STATE_REGISTER_LMA_32BIT) {
       CpuSaveState->x86._DR7 = (UINT32)AsmReadDr7 ();
       CpuSaveState->x86._DR6 = (UINT32)AsmReadDr6 ();

From f478dac8a100526cafd82ffe8a3229d3b22a7836 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 24 Dec 2015 00:14:00 +0000
Subject: [PATCH 487/525] UefiCpuPkg/PiSmmCpuDxeSmm: Initialize gSmst fields on
 S3 resume

Update S3 resume path to initialize the fields of gSmst before
the gSmst fields are used to complete initialization in S3 resume.

Cc: Jeff Fan <jeff.fan@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19504 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 6011381199b21e906bcb87a30f58ebe70b9b7154)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
index 949dd4e5c1e7..36a0650b2fd0 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/PiSmmCpuDxeSmm.c
@@ -1496,6 +1496,15 @@ PerformPreTasks (
   // Restore SMM Configuration in S3 boot path.
   //
   if (mRestoreSmmConfigurationInS3) {
+    //
+    // Need make sure gSmst is correct because below function may use them.
+    //
+    gSmst->SmmStartupThisAp      = gSmmCpuPrivate->SmmCoreEntryContext.SmmStartupThisAp;
+    gSmst->CurrentlyExecutingCpu = gSmmCpuPrivate->SmmCoreEntryContext.CurrentlyExecutingCpu;
+    gSmst->NumberOfCpus          = gSmmCpuPrivate->SmmCoreEntryContext.NumberOfCpus;
+    gSmst->CpuSaveStateSize      = gSmmCpuPrivate->SmmCoreEntryContext.CpuSaveStateSize;
+    gSmst->CpuSaveState          = gSmmCpuPrivate->SmmCoreEntryContext.CpuSaveState;
+
     //
     // Configure SMM Code Access Check feature if available.
     //

From 5abebb47505a7d46665309dd37b629577827bd56 Mon Sep 17 00:00:00 2001
From: Liming Gao <liming.gao@intel.com>
Date: Thu, 24 Dec 2015 02:30:43 +0000
Subject: [PATCH 488/525] UefiCpuPkg: Add the missing module uni for
 CpuS3DataDxe

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19510 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 2dc41d450a027c249342c88cac7321f0d1b7ec8c)
---
 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf      |  4 ++
 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.uni      | 40 +++++++++++++++++++
 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxeExtra.uni | 20 ++++++++++
 3 files changed, 64 insertions(+)
 create mode 100644 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.uni
 create mode 100644 UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxeExtra.uni

diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
index 9143b87723fe..857e12b8025f 100644
--- a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.inf
@@ -25,6 +25,7 @@
 [Defines]
   INF_VERSION                    = 0x00010005
   BASE_NAME                      = CpuS3DataDxe
+  MODULE_UNI_FILE                = CpuS3DataDxe.uni
   FILE_GUID                      = 4D2E57EE-0E3F-44DD-93C4-D3B57E96945D
   MODULE_TYPE                    = DXE_DRIVER
   VERSION_STRING                 = 1.0
@@ -62,3 +63,6 @@
 
 [Depex]
   gEfiMpServiceProtocolGuid
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  CpuS3DataDxeExtra.uni
diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.uni b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.uni
new file mode 100644
index 000000000000..4a0218f18023
--- /dev/null
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxe.uni
@@ -0,0 +1,40 @@
+// /** @file
+// ACPI CPU Data initialization module
+//
+// This module initializes the ACPI_CPU_DATA structure and registers the address
+// of this structure in the PcdCpuS3DataAddress PCD.  This is a generic/simple
+// version of this module.  It does not provide a machine check handler or CPU
+// register initialization tables for ACPI S3 resume.  It also only supports the
+// number of CPUs reported by the MP Services Protocol, so this module does not
+// support hot plug CPUs.  This module can be copied into a CPU specific package
+// and customized if these additional features are required.
+//
+// Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+//
+// Copyright (c) 2015, Red Hat, Inc.
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution.  The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+//
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+#string STR_MODULE_ABSTRACT
+#language en-US
+"ACPI CPU Data initialization module"
+
+#string STR_MODULE_DESCRIPTION
+#language en-US
+"This module initializes the ACPI_CPU_DATA structure and registers the address "
+"of this structure in the PcdCpuS3DataAddress PCD.  This is a generic/simple "
+"version of this module.  It does not provide a machine check handler or CPU "
+"register initialization tables for ACPI S3 resume.  It also only supports the "
+"number of CPUs reported by the MP Services Protocol, so this module does not "
+"support hot plug CPUs.  This module can be copied into a CPU specific package "
+"and customized if these additional features are required."
+
+
diff --git a/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxeExtra.uni b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxeExtra.uni
new file mode 100644
index 000000000000..050f25f843e4
--- /dev/null
+++ b/UefiCpuPkg/CpuS3DataDxe/CpuS3DataDxeExtra.uni
@@ -0,0 +1,20 @@
+// /** @file
+// CpuS3DataDxe Localized Strings and Content
+//
+// Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+//
+// Copyright (c) 2015, Red Hat, Inc.
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution.  The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+//
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+#string STR_PROPERTIES_MODULE_NAME #language en-US "CpuS3DataDxe module"
+
+

From d52d89417057a86686b3edecdceb8f934d6c4a9e Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Tue, 19 Jan 2016 04:08:09 +0000
Subject: [PATCH 489/525] UefiCpuPkg: Add NOOPT target in UefiCpuPkg.dsc

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19681 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit a7bd6695c5b3e4c4d5daa0ba05cf6b518811fb8e)
---
 UefiCpuPkg/UefiCpuPkg.dsc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 406105073270..31e60bbe7765 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -1,7 +1,7 @@
 ## @file
 #  UefiCpuPkg Package
 #
-#  Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 #  This program and the accompanying materials
 #  are licensed and made available under the terms and conditions of the BSD License
@@ -20,7 +20,7 @@
   DSC_SPECIFICATION              = 0x00010005
   OUTPUT_DIRECTORY               = Build/UefiCpu
   SUPPORTED_ARCHITECTURES        = IA32|IPF|X64
-  BUILD_TARGETS                  = DEBUG|RELEASE
+  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
   SKUID_IDENTIFIER               = DEFAULT
 
 #

From c3a78be406beb4af7b63652c5817defb8907d249 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 18 Feb 2016 09:46:25 -0800
Subject: [PATCH 490/525] UefiCpuPkg/PiSmmCpuDxeSmm: Add EFIAPI to
 CheckFeatureSupported()

The function CheckFeatureSupported() is used as an EFI_AP_PROCEDURE
in the MP Services Protocol service StartAllAPs().  Any function
used as an EFI_AP_PROCEDURE must use EFIAPI calling convention.

Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>
(cherry picked from commit d691abec1bae4db5e4c58be7dbce40974d810f7a)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c | 11 +++++++----
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h |  7 +++++--
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
index ec4ec9b067c5..2078421a1243 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.c
@@ -1,7 +1,7 @@
 /** @file
 Enable SMM profile.
 
-Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2012 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -928,10 +928,13 @@ InitSmmProfileInternal (
 /**
   Check if XD feature is supported by a processor.
 
+  @param[in,out] Buffer  The pointer to private data buffer.
+
 **/
 VOID
+EFIAPI
 CheckFeatureSupported (
-  VOID
+  IN OUT VOID   *Buffer
   )
 {
   UINT32                 RegEax;
@@ -1001,7 +1004,7 @@ CheckProcessorFeature (
   //
   // Check if XD and BTS are supported on all processors.
   //
-  CheckFeatureSupported ();
+  CheckFeatureSupported (NULL);
 
   //
   //Check on other processors if BSP supports this
@@ -1009,7 +1012,7 @@ CheckProcessorFeature (
   if (mXdSupported || mBtsSupported) {
     MpServices->StartupAllAPs (
                   MpServices,
-                  (EFI_AP_PROCEDURE) CheckFeatureSupported,
+                  CheckFeatureSupported,
                   TRUE,
                   NULL,
                   0,
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
index 45484674589d..c6ce1f59adda 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
@@ -1,7 +1,7 @@
 /** @file
 SMM profile header file.
 
-Copyright (c) 2012 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2012 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -95,10 +95,13 @@ PageFaultIdtHandlerSmmProfile (
 /**
   Check if XD feature is supported by a processor.
 
+  @param[in,out] Buffer  The pointer to private data buffer.
+
 **/
 VOID
+EFIAPI
 CheckFeatureSupported (
-  VOID
+  IN OUT VOID   *Buffer
   );
 
 /**

From f7ff5dae06dce09a554994066a2cf5d8d49ea322 Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 18 Feb 2016 13:09:23 -0800
Subject: [PATCH 491/525] UefiCpuPkg/PiSmmCpuDxeSmm: Enable/Restore XD in SMM

If XD is supported, then SMM enables it.  The non-SMM execution
environment can choose to enable or disable XD, so the state of
XD must be detected in each SMI and be enabled/restored.

Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
Regression-tested-by: Laszlo Ersek <lersek@redhat.com>
(cherry picked from commit e1695f8dcf18f612d34f6da0a4579a5b7c49ef9b)
---
 UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c  | 18 +++++++++++++++---
 UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h |  1 +
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
index 79b7c90a809b..185cb3d5935f 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/MpService.c
@@ -1,7 +1,7 @@
 /** @file
 SMM MP service implementation
 
-Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -1019,6 +1019,7 @@ SmiRendezvous (
   BOOLEAN           BspInProgress;
   UINTN             Index;
   UINTN             Cr2;
+  BOOLEAN           XdDisableFlag;
 
   //
   // Save Cr2 because Page Fault exception in SMM may override its value
@@ -1078,9 +1079,14 @@ SmiRendezvous (
     }
 
     //
-    // Try to enable NX
+    // Try to enable XD
     //
+    XdDisableFlag = FALSE;
     if (mXdSupported) {
+      if ((AsmReadMsr64 (MSR_IA32_MISC_ENABLE) & B_XD_DISABLE_BIT) != 0) {
+        XdDisableFlag = TRUE;
+        AsmMsrAnd64 (MSR_IA32_MISC_ENABLE, ~B_XD_DISABLE_BIT);
+      }
       ActivateXd ();
     }
 
@@ -1152,7 +1158,6 @@ SmiRendezvous (
         // BSP Handler is always called with a ValidSmi == TRUE
         //
         BSPHandler (CpuIndex, mSmmMpSyncData->EffectiveSyncMode);
-
       } else {
         APHandler (CpuIndex, ValidSmi, mSmmMpSyncData->EffectiveSyncMode);
       }
@@ -1165,6 +1170,13 @@ SmiRendezvous (
     //
     while (mSmmMpSyncData->AllCpusInSync) {
       CpuPause ();
+     }
+
+    //
+    // Restore XD
+    //
+    if (XdDisableFlag) {
+      AsmMsrOr64 (MSR_IA32_MISC_ENABLE, B_XD_DISABLE_BIT);
     }
   }
 
diff --git a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
index c6ce1f59adda..5488c148e8bc 100644
--- a/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
+++ b/UefiCpuPkg/PiSmmCpuDxeSmm/SmmProfile.h
@@ -21,6 +21,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 /// MSR Register Index
 ///
 #define MSR_IA32_MISC_ENABLE                  0x1A0
+#define   B_XD_DISABLE_BIT                    BIT34
 
 //
 // External functions

From d34bfced81bc2e94819d51901d7b28a2cdaa11b9 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Wed, 20 Jan 2016 00:39:14 +0000
Subject: [PATCH 492/525] Maintainers.txt: Update maintainers for CryptoPkg and
 NetworkPkg

This patch is used to update the CryptoPkg and NetworkPkg
maintainer list.

Cc: Long Qin <qin.long@intel.com>
Cc: Fu Siyuan <siyuan.fu@intel.com>
Cc: Tian Hot <hot.tian@intel.com>
Cc: Li Ruth <ruth.li@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Qin Long <qin.long@intel.com>
Reviewed-by: Siyuan Fu <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19692 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 5af229d81f15da8cb97e817ccdf9a10177d6b4c4)
---
 Maintainers.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Maintainers.txt b/Maintainers.txt
index acb717e03a07..7fa7d8cf55ca 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -85,6 +85,7 @@ S: Maintained
 CryptoPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/CryptoPkg
 M: Qin Long <qin.long@intel.com>
+M: Ting Ye <ting.ye@intel.com>
 
 DuetPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/DuetPkg
@@ -146,6 +147,9 @@ M: Liming Gao <liming.gao@intel.com>
 NetworkPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/NetworkPkg
 M: Siyuan Fu <siyuan.fu@intel.com>
+M: Jiaxin Wu <jiaxin.wu@intel.com>
+M: Lubo Zhang <lubo.zhang@intel.com>
+M: Fan Wang <fan.wang@intel.com>
 
 Nt32Pkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/Nt32Pkg

From ae7a4137c083fb2760f9dc5cf80df9d4ac499e9f Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 20 Jan 2016 04:38:14 +0000
Subject: [PATCH 493/525] Maintainers.txt: Update maintainers for
 SourceLevelDebugPkg

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19693 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 59fae92d8d8d3d5471e59cc2922080854b570e7c)
---
 Maintainers.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Maintainers.txt b/Maintainers.txt
index 7fa7d8cf55ca..64a398cc710f 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -191,6 +191,7 @@ M: Shumin Qiu <shumin.qiu@intel.com>
 SourceLevelDebugPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/SourceLevelDebugPkg
 M: Jeff Fan <jeff.fan@intel.com>
+M: Hao Wu <hao.a.wu@intel.com>
 
 StdLib, StdLibPrivateInternalFiles
 W: https://github.com/tianocore/tianocore.github.io/wiki/StdLib

From c75ba3c2edfb5af300a7fac204fa7dce1e578f58 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Fri, 29 Jan 2016 09:33:10 +0000
Subject: [PATCH 494/525] Maintainers.txt: Update maintainers for MdeModulePkg

Cc: Feng Tian <feng.tian@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19774 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit d0b2d190829a1dabdf5835c56665f95bc864d9cf)
---
 Maintainers.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Maintainers.txt b/Maintainers.txt
index 64a398cc710f..c9d705a26848 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -138,6 +138,7 @@ M: Jiewen Yao <jiewen.yao@intel.com>
 MdeModulePkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/MdeModulePkg
 M: Feng Tian <feng.tian@intel.com>
+M: Star Zeng <star.zeng@intel.com>
 
 MdePkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/MdePkg

From 0f2455661f3aa2d272e4b318da5e068e7a483161 Mon Sep 17 00:00:00 2001
From: Jiaxin Wu <jiaxin.wu@intel.com>
Date: Mon, 1 Feb 2016 01:49:29 +0000
Subject: [PATCH 495/525] Maintainers.txt: Update maintainers for NetworkPkg

Cc: Fu Siyuan <siyuan.fu@intel.com>
Cc: Ye Ting <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jiaxin Wu <jiaxin.wu@intel.com>
Reviewed-by: Siyuan Fu <siyuan.fu@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19782 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 39bbd1fbbf26851646d75a0a57883ab80da9a858)
---
 Maintainers.txt | 2 --
 1 file changed, 2 deletions(-)

diff --git a/Maintainers.txt b/Maintainers.txt
index c9d705a26848..4fc71c6b1d47 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -149,8 +149,6 @@ NetworkPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/NetworkPkg
 M: Siyuan Fu <siyuan.fu@intel.com>
 M: Jiaxin Wu <jiaxin.wu@intel.com>
-M: Lubo Zhang <lubo.zhang@intel.com>
-M: Fan Wang <fan.wang@intel.com>
 
 Nt32Pkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/Nt32Pkg

From 4a8f1338c0eccff31c00cc71f34069f0d806246f Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Tue, 2 Feb 2016 19:05:09 +0000
Subject: [PATCH 496/525] Maintainers.txt: Add newline to final line of file

(Actually, this is a test to see if SVN is read-only.)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@19793 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 796ce381e48f5aa4c4711576daf75ad31ef95672)
---
 Maintainers.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Maintainers.txt b/Maintainers.txt
index 4fc71c6b1d47..b04fe1a4e321 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -211,4 +211,4 @@ M: Tim He <tim.he@intel.com>
 
 Vlv2TbltDevicePkg
 M: David Wei <david.wei@intel.com>
-M: Tim He <tim.he@intel.com>
\ No newline at end of file
+M: Tim He <tim.he@intel.com>

From 31aec1973c8e0ea5941f58f55fb283b1bc3f7239 Mon Sep 17 00:00:00 2001
From: Jordan Justen <jordan.l.justen@intel.com>
Date: Tue, 2 Feb 2016 08:53:59 -0800
Subject: [PATCH 497/525] Maintainers.txt: Update source repository urls

Add 'mirror' to mirror/backup git repositories, and mark svn as
read-only and deprecated.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
(cherry picked from commit dd9044b310ae2be2ae989a522979feee86b39cc8)
---
 Maintainers.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Maintainers.txt b/Maintainers.txt
index b04fe1a4e321..a5a301892b3f 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -30,9 +30,9 @@ EDK II
 W: http://www.tianocore.org/edk2/
 L: https://lists.sourceforge.net/lists/listinfo/edk2-devel
 T: git - https://github.com/tianocore/edk2.git
-T: git - https://bitbucket.org/tianocore/edk2.git
-T: git - http://git.code.sf.net/p/tianocore/edk2
-T: svn - https://svn.code.sf.net/p/edk2/code/trunk/edk2
+T: git (mirror) - https://bitbucket.org/tianocore/edk2.git
+T: git (mirror) - http://git.code.sf.net/p/tianocore/edk2
+T: svn (read-only, deprecated) - https://svn.code.sf.net/p/edk2/code/trunk/edk2
 
 Responsible Disclosure, Reporting Security Issues
 -------------------------------------------------

From 0093b2d81911fea18dffba0984bca051b984a90a Mon Sep 17 00:00:00 2001
From: Leif Lindholm <leif.lindholm@linaro.org>
Date: Tue, 9 Feb 2016 17:18:55 +0000
Subject: [PATCH 498/525] Maintainers.txt: Update maintainers for ShellBinPkg

Separate ShellPkg and ShellBinPkg into separate entities.
Add Leif Lindholm and Ard Biesheuvel as ShellBinPkg maintainers
for ARM/AArch64 only.
Add indicaton that Jaben Carsey and Shumin Qiu are maintainers for
Ia32/X64 specifically.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Leif Lindholm <leif.lindholm@linaro.org>
Reviewed-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Jaben Carsey <jaben.carsey@intel.com>
(cherry picked from commit 7d0f92e8fd68e1f1242f36c203400be23954d563)
---
 Maintainers.txt | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Maintainers.txt b/Maintainers.txt
index a5a301892b3f..05e6e39b3d91 100644
--- a/Maintainers.txt
+++ b/Maintainers.txt
@@ -182,7 +182,14 @@ SecurityPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/SecurityPkg
 M: Chao Zhang <chao.b.zhang@intel.com>
 
-ShellPkg, ShellBinPkg
+ShellBinPkg
+W: https://github.com/tianocore/tianocore.github.io/wiki/ShellPkg
+M: Jaben Carsey <jaben.carsey@intel.com>      (Ia32/X64)
+M: Shumin Qiu <shumin.qiu@intel.com>          (Ia32/X64)
+M: Leif Lindholm <leif.lindholm@linaro.org>   (ARM/AArch64)
+M: Ard Biesheuvel <ard.biesheuvel@linaro.org> (ARM/AArch64)
+
+ShellPkg
 W: https://github.com/tianocore/tianocore.github.io/wiki/ShellPkg
 M: Jaben Carsey <jaben.carsey@intel.com>
 M: Shumin Qiu <shumin.qiu@intel.com>

From 8b6a81346beb18adddb52e9fda3a0d5821f7de82 Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Thu, 25 Feb 2016 14:37:55 +0800
Subject: [PATCH 499/525] External link to BaseTools Win binary r122(main trunk
 r19875)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
---
 BaseTools/Bin/externals.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Bin/externals.txt b/BaseTools/Bin/externals.txt
index 146687fa930d..f0bc6d898bfd 100644
--- a/BaseTools/Bin/externals.txt
+++ b/BaseTools/Bin/externals.txt
@@ -1 +1 @@
-Win32  -r 112 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
+Win32  -r 122 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32

From d14fd60dc0227b6fa9b18a344fb2aa0e73303a4b Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Wed, 24 Feb 2016 21:00:04 +0100
Subject: [PATCH 500/525] CryptoPkg: BaseCryptLib: support free(NULL)

The ISO C standard says about free(),

  If ptr is a null pointer, no action occurs.

This is not true of the FreePool() interface of the MemoryAllocationLib
class:

  Buffer must have been allocated on a previous call to the pool
  allocation services of the Memory Allocation Library. [...] If Buffer
  was not allocated with a pool allocation function in the Memory
  Allocation Library, then ASSERT().

Therefore we must not forward the argument of free() to FreePool() without
checking.

This bug can be triggered by upstream OpenSSL commit 8e704858f219
("RT3955: Reduce some stack usage"), for example.

Cc: David Woodhouse <dwmw2@infradead.org>
Cc: Qin Long <qin.long@intel.com>
Cc: Ting Ye <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>
(cherry picked from commit 211372d63a82861e52250c0f7a5ee78d9dc417ae)
---
 .../Library/BaseCryptLib/SysCall/BaseMemAllocation.c      | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/SysCall/BaseMemAllocation.c b/CryptoPkg/Library/BaseCryptLib/SysCall/BaseMemAllocation.c
index 544f07215b8f..964545f143cc 100644
--- a/CryptoPkg/Library/BaseCryptLib/SysCall/BaseMemAllocation.c
+++ b/CryptoPkg/Library/BaseCryptLib/SysCall/BaseMemAllocation.c
@@ -38,5 +38,11 @@ void *realloc (void *ptr, size_t size)
 /* De-allocates or frees a memory block */
 void free (void *ptr)
 {
-  FreePool (ptr);
+  //
+  // In Standard C, free() handles a null pointer argument transparently. This
+  // is not true of FreePool() below, so protect it.
+  //
+  if (ptr != NULL) {
+    FreePool (ptr);
+  }
 }

From 547b9e2744c4b18de4e5af62756e865a175c7e36 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Wed, 24 Feb 2016 21:00:04 +0100
Subject: [PATCH 501/525] CryptoPkg: RuntimeCryptLib: support free(NULL)

The ISO C standard says about free(),

  If ptr is a null pointer, no action occurs.

This is not true of the RuntimeFreeMem() internal function. Therefore we
must not forward the argument of free() to RuntimeFreeMem() without
checking.

Cc: David Woodhouse <dwmw2@infradead.org>
Cc: Qin Long <qin.long@intel.com>
Cc: Ting Ye <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>
(cherry picked from commit 1246dde58e8a84644ad46679b8767f8643818e31)
---
 .../Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c   | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
index 616ee7717e72..45ef9ff5f252 100644
--- a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
+++ b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
@@ -434,5 +434,11 @@ void *realloc (void *ptr, size_t size)
 /* Deallocates or frees a memory block */
 void free (void *ptr)
 {
-  RuntimeFreeMem (ptr);
+  //
+  // In Standard C, free() handles a null pointer argument transparently. This
+  // is not true of RuntimeFreeMem() below, so protect it.
+  //
+  if (ptr != NULL) {
+    RuntimeFreeMem (ptr);
+  }
 }

From 34791faedd6449762fb9110151f70c7ef3713fd0 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Wed, 24 Feb 2016 21:00:04 +0100
Subject: [PATCH 502/525] CryptoPkg: RuntimeCryptLib: support realloc(NULL,
 size)

The ISO C standard says about realloc(),

  If ptr is a null pointer, the realloc function behaves like the malloc
  function for the specified size.

The realloc() implementation doesn't conform to this currently, so add a
check and call malloc() if appropriate.

Cc: David Woodhouse <dwmw2@infradead.org>
Cc: Qin Long <qin.long@intel.com>
Cc: Ting Ye <ting.ye@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qin Long <qin.long@intel.com>
(cherry picked from commit e89d672110aaf1c5a85404375ca6767b099d3b50)
---
 CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
index 45ef9ff5f252..413e47e92325 100644
--- a/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
+++ b/CryptoPkg/Library/BaseCryptLib/SysCall/RuntimeMemAllocation.c
@@ -396,6 +396,10 @@ void *realloc (void *ptr, size_t size)
   UINTN  StartPageIndex;
   UINTN  PageCount;
 
+  if (ptr == NULL) {
+    return malloc (size);
+  }
+
   //
   // Get Original Size of ptr
   //

From ee412056de7ecf2f6642fc7fb04a09f6290d0d1e Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 18 Feb 2016 23:15:48 -0800
Subject: [PATCH 503/525] UefiCpuPkg/Cpuid.h: Add CPUID leaf/sub-leaf defines
 and structures

Add CPUID leaf and sub-leaf indexes and structures as described by
Intel(R) 64 and IA-32 Architectures Software Developer's Manual,
Volume 2A, December 2015, CPUID instruction.

Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
(cherry picked from commit 57d16ba1e7593e4fabc2b483ed5ac53cbfd5d9c7)
---
 UefiCpuPkg/Include/Register/Cpuid.h | 3120 ++++++++++++++++++++++++++-
 1 file changed, 3097 insertions(+), 23 deletions(-)

diff --git a/UefiCpuPkg/Include/Register/Cpuid.h b/UefiCpuPkg/Include/Register/Cpuid.h
index f8ff247d098f..4a5bc732bf45 100644
--- a/UefiCpuPkg/Include/Register/Cpuid.h
+++ b/UefiCpuPkg/Include/Register/Cpuid.h
@@ -1,53 +1,3127 @@
 /** @file
-CPUID Definitions.
+  CPUID leaf definitions.
 
-CPUID definitions based on contents of the Intel(R) 64 and IA-32 Architectures
-Software Developer's Manual, Volume 2A, CPUID instruction.
+  Provides defines for CPUID leaf indexes.  Data structures are provided for
+  registers returned by a CPUID leaf that contain one or more bit fields.
+  If a register returned is a single 32-bit value, then a data structure is
+  not provided for that register.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
-This program and the accompanying materials
-are licensed and made available under the terms and conditions of the BSD License
-which accompanies this distribution.  The full text of the license may be found at
-http://opensource.org/licenses/bsd-license.php
+  Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials are licensed and made available under
+  the terms and conditions of the BSD License which accompanies this distribution.
+  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
 
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+  @par Specification Reference:
+  Intel(R) 64 and IA-32 Architectures Software Developer's Manual, Volume 2A,
+  December 2015, CPUID instruction.
 
 **/
 
 #ifndef __CPUID_H__
 #define __CPUID_H__
 
-//
-// Definitions for CPUID instruction
-//
-#define CPUID_SIGNATURE                         0x0
+/**
+  CPUID Signature Information
+
+  @param   EAX  CPUID_SIGNATURE (0x00)
+
+  @retval  EAX  Returns the highest value the CPUID instruction recognizes for
+                returning basic processor information. The value is returned is
+                processor specific.
+  @retval  EBX  First 4 characters of a vendor identification string.
+  @retval  ECX  Last 4 characters of a vendor identification string.
+  @retval  EDX  Middle 4 characters of a vendor identification string.
+
+  <b>Example usage</b>
+  @code
+  UINT32 Eax;
+  UINT32 Ebx;
+  UINT32 Ecx;
+  UINT32 Edx;
+
+  AsmCpuid (CPUID_SIGNATURE, &Eax, &Ebx, &Ecx, &Edx);
+  @endcode
+**/
+#define CPUID_SIGNATURE                         0x00
+
+///
+/// @{ CPUID signature values returned by Intel processors
+///
+#define CPUID_SIGNATURE_GENUINE_INTEL_EBX  SIGNATURE_32 ('G', 'e', 'n', 'u')
+#define CPUID_SIGNATURE_GENUINE_INTEL_EDX  SIGNATURE_32 ('i', 'n', 'e', 'I')
+#define CPUID_SIGNATURE_GENUINE_INTEL_ECX  SIGNATURE_32 ('n', 't', 'e', 'l')
+///
+/// @}
+///
+
+
+/**
+  CPUID Version Information
+
+  @param   EAX  CPUID_VERSION_INFO (0x01)
+
+  @retval  EAX  Returns Model, Family, Stepping Information described by the
+                type CPUID_VERSION_INFO_EAX.
+  @retval  EBX  Returns Brand, Cache Line Size, and Initial APIC ID described by
+                the type CPUID_VERSION_INFO_EBX.
+  @retval  ECX  CPU Feature Information described by the type
+                CPUID_VERSION_INFO_ECX.
+  @retval  EDX  CPU Feature Information described by the type
+                CPUID_VERSION_INFO_EDX.
+
+  <b>Example usage</b>
+  @code
+  CPUID_VERSION_INFO_EAX  Eax;
+  CPUID_VERSION_INFO_EBX  Ebx;
+  CPUID_VERSION_INFO_ECX  Ecx;
+  CPUID_VERSION_INFO_EDX  Edx;
+
+  AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
+#define CPUID_VERSION_INFO                      0x01
+
+/**
+  CPUID Version Information returned in EAX for CPUID leaf
+  #CPUID_VERSION_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  SteppingId:4;        ///< [Bits   3:0] Stepping ID
+    UINT32  Model:4;             ///< [Bits   7:4] Model
+    UINT32  FamilyId:4;          ///< [Bits  11:8] Family
+    UINT32  ProcessorType:2;     ///< [Bits 13:12] Processor Type
+    UINT32  Reserved1:2;         ///< [Bits 15:14] Reserved
+    UINT32  ExtendedModelId:4;   ///< [Bits 19:16] Extended Model ID
+    UINT32  ExtendedFamilyId:8;  ///< [Bits 27:20] Extended Family ID
+    UINT32  Reserved2:4;         ///< Reserved
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32    Uint32;
+} CPUID_VERSION_INFO_EAX;
+
+///
+/// @{ Define value for bit field CPUID_VERSION_INFO_EAX.ProcessorType
+///
+#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_ORIGINAL_OEM_PROCESSOR     0x00
+#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_INTEL_OVERDRIVE_PROCESSOR  0x01
+#define CPUID_VERSION_INFO_EAX_PROCESSOR_TYPE_DUAL_PROCESSOR             0x02
+///
+/// @}
+///
+
+/**
+  CPUID Version Information returned in EBX for CPUID leaf
+  #CPUID_VERSION_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 7:0] Provides an entry into a brand string table that contains
+    /// brand strings for IA-32 processors.
+    ///
+    UINT32  BrandIndex:8;
+    ///
+    /// [Bits 15:8] Indicates the size of the cache line flushed by the CLFLUSH
+    /// and CLFLUSHOPT instructions in 8-byte increments. This field was
+    /// introduced in the Pentium 4 processor.
+    ///
+    UINT32  CacheLineSize:8;
+    ///
+    /// [Bits 23:16] Maximum number of addressable IDs for logical processors
+    /// in this physical package.
+    ///
+    /// @note
+    /// The nearest power-of-2 integer that is not smaller than EBX[23:16] is
+    /// the number of unique initial APICIDs reserved for addressing different
+    /// logical processors in a physical package. This field is only valid if
+    /// CPUID.1.EDX.HTT[bit 28]= 1.
+    ///
+    UINT32  MaximumAddressableIdsForLogicalProcessors:8;
+    ///
+    /// [Bits 31:24] The 8-bit ID that is assigned to the local APIC on the
+    /// processor during power up. This field was introduced in the Pentium 4
+    /// processor.
+    ///
+    UINT32  InitialLocalApicId:8;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32    Uint32;
+} CPUID_VERSION_INFO_EBX;
+
+/**
+  CPUID Version Information returned in ECX for CPUID leaf
+  #CPUID_VERSION_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Streaming SIMD Extensions 3 (SSE3).  A value of 1 indicates the
+    /// processor supports this technology
+    ///
+    UINT32  SSE3:1;
+    ///
+    /// [Bit 1] A value of 1 indicates the processor supports the PCLMULQDQ
+    /// instruction.  Carryless Multiplication
+    ///
+    UINT32  PCLMULQDQ:1;
+    ///
+    /// [Bit 2] 64-bit DS Area.  A value of 1 indicates the processor supports
+    /// DS area using 64-bit layout.
+    ///
+    UINT32  DTES64:1;
+    ///
+    /// [Bit 3] MONITOR/MWAIT.  A value of 1 indicates the processor supports
+    /// this feature.
+    ///
+    UINT32  MONITOR:1;
+    ///
+    /// [Bit 4] CPL Qualified Debug Store.  A value of 1 indicates the processor
+    /// supports the extensions to the Debug Store feature to allow for branch
+    /// message storage qualified by CPL
+    ///
+    UINT32  DS_CPL:1;
+    ///
+    /// [Bit 5] Virtual Machine Extensions.  A value of 1 indicates that the
+    /// processor supports this technology.
+    ///
+    UINT32  VMX:1;
+    ///
+    /// [Bit 6] Safer Mode Extensions. A value of 1 indicates that the processor
+    /// supports this technology
+    ///
+    UINT32  SMX:1;
+    ///
+    /// [Bit 7] Enhanced Intel SpeedStep(R) technology.  A value of 1 indicates
+    /// that the processor supports this technology
+    ///
+    UINT32  EIST:1;
+    ///
+    /// [Bit 8] Thermal Monitor 2.  A value of 1 indicates whether the processor
+    /// supports this technology
+    ///
+    UINT32  TM2:1;
+    ///
+    /// [Bit 9] A value of 1 indicates the presence of the Supplemental Streaming
+    /// SIMD Extensions 3 (SSSE3). A value of 0 indicates the instruction
+    /// extensions are not present in the processor.
+    ///
+    UINT32  SSSE3:1;
+    ///
+    /// [Bit 10] L1 Context ID.  A value of 1 indicates the L1 data cache mode
+    /// can be set to either adaptive mode or shared mode. A value of 0 indicates
+    /// this feature is not supported. See definition of the IA32_MISC_ENABLE MSR
+    /// Bit 24 (L1 Data Cache Context Mode) for details
+    ///
+    UINT32  CNXT_ID:1;
+    ///
+    /// [Bit 11] A value of 1 indicates the processor supports IA32_DEBUG_INTERFACE
+    /// MSR for silicon debug
+    ///
+    UINT32  SDBG:1;
+    ///
+    /// [Bit 12] A value of 1 indicates the processor supports FMA (Fused Multiple
+    ///  Add) extensions using YMM state.
+    ///
+    UINT32  FMA:1;
+    ///
+    /// [Bit 13] CMPXCHG16B Available.  A value of 1 indicates that the feature
+    /// is available.
+    ///
+    UINT32  CMPXCHG16B:1;
+    ///
+    /// [Bit 14] xTPR Update Control.  A value of 1 indicates that the processor
+    /// supports changing IA32_MISC_ENABLE[Bit 23].
+    ///
+    UINT32  xTPR_Update_Control:1;
+    ///
+    /// [Bit 15] Perfmon and Debug Capability:  A value of 1 indicates the
+    /// processor supports the performance and debug feature indication MSR
+    /// IA32_PERF_CAPABILITIES.
+    ///
+    UINT32  PDCM:1;
+    UINT32  Reserved:1;
+    ///
+    /// [Bit 17] Process-context identifiers.  A value of 1 indicates that the
+    /// processor supports PCIDs and that software may set CR4.PCIDE to 1.
+    ///
+    UINT32  PCID:1;
+    ///
+    /// [Bit 18] A value of 1 indicates the processor supports the ability to
+    /// prefetch data from a memory mapped device.  Direct Cache Access.
+    ///
+    UINT32  DCA:1;
+    ///
+    /// [Bit 19] A value of 1 indicates that the processor supports SSE4.1.
+    ///
+    UINT32  SSE4_1:1;
+    ///
+    /// [Bit 20] A value of 1 indicates that the processor supports SSE4.2.
+    ///
+    UINT32  SSE4_2:1;
+    ///
+    /// [Bit 21] A value of 1 indicates that the processor supports x2APIC
+    /// feature.
+    ///
+    UINT32  x2APIC:1;
+    ///
+    /// [Bit 22] A value of 1 indicates that the processor supports MOVBE
+    /// instruction.
+    ///
+    UINT32  MOVBE:1;
+    ///
+    /// [Bit 23] A value of 1 indicates that the processor supports the POPCNT
+    /// instruction.
+    ///
+    UINT32  POPCNT:1;
+    ///
+    /// [Bit 24] A value of 1 indicates that the processor's local APIC timer
+    /// supports one-shot operation using a TSC deadline value.
+    ///
+    UINT32  TSC_Deadline:1;
+    ///
+    /// [Bit 25] A value of 1 indicates that the processor supports the AESNI
+    /// instruction extensions.
+    ///
+    UINT32  AESNI:1;
+    ///
+    /// [Bit 26] A value of 1 indicates that the processor supports the
+    /// XSAVE/XRSTOR processor extended states feature, the XSETBV/XGETBV
+    /// instructions, and XCR0.
+    ///
+    UINT32  XSAVE:1;
+    ///
+    /// [Bit 27] A value of 1 indicates that the OS has set CR4.OSXSAVE[Bit 18]
+    /// to enable XSETBV/XGETBV instructions to access XCR0 and to support
+    /// processor extended state management using XSAVE/XRSTOR.
+    ///
+    UINT32  OSXSAVE:1;
+    ///
+    /// [Bit 28] A value of 1 indicates the processor supports the AVX instruction
+    /// extensions.
+    ///
+    UINT32  AVX:1;
+    ///
+    /// [Bit 29] A value of 1 indicates that processor supports 16-bit
+    /// floating-point conversion instructions.
+    ///
+    UINT32  F16C:1;
+    ///
+    /// [Bit 30] A value of 1 indicates that processor supports RDRAND instruction.
+    ///
+    UINT32  RDRAND:1;
+    ///
+    /// [Bit 31] Always returns 0.
+    ///
+    UINT32  NotUsed:1;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32    Uint32;
+} CPUID_VERSION_INFO_ECX;
+
+/**
+  CPUID Version Information returned in EDX for CPUID leaf
+  #CPUID_VERSION_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Floating Point Unit On-Chip. The processor contains an x87 FPU.
+    ///
+    UINT32  FPU:1;
+    ///
+    /// [Bit 1] Virtual 8086 Mode Enhancements.  Virtual 8086 mode enhancements,
+    /// including CR4.VME for controlling the feature, CR4.PVI for protected
+    /// mode virtual interrupts, software interrupt indirection, expansion of
+    /// the TSS with the software indirection bitmap, and EFLAGS.VIF and
+    /// EFLAGS.VIP flags.
+    ///
+    UINT32  VME:1;
+    ///
+    /// [Bit 2] Debugging Extensions.  Support for I/O breakpoints, including
+    /// CR4.DE for controlling the feature, and optional trapping of accesses to
+    /// DR4 and DR5.
+    ///
+    UINT32  DE:1;
+    ///
+    /// [Bit 3] Page Size Extension.  Large pages of size 4 MByte are supported,
+    /// including CR4.PSE for controlling the feature, the defined dirty bit in
+    /// PDE (Page Directory Entries), optional reserved bit trapping in CR3,
+    /// PDEs, and PTEs.
+    ///
+    UINT32  PSE:1;
+    ///
+    /// [Bit 4] Time Stamp Counter.  The RDTSC instruction is supported,
+    /// including CR4.TSD for controlling privilege.
+    ///
+    UINT32  TSC:1;
+    ///
+    /// [Bit 5] Model Specific Registers RDMSR and WRMSR Instructions.  The
+    /// RDMSR and WRMSR instructions are supported. Some of the MSRs are
+    /// implementation dependent.
+    ///
+    UINT32  MSR:1;
+    ///
+    /// [Bit 6] Physical Address Extension.  Physical addresses greater than 32
+    /// bits are supported: extended page table entry formats, an extra level in
+    /// the page translation tables is defined, 2-MByte pages are supported
+    /// instead of 4 Mbyte pages if PAE bit is 1.
+    ///
+    UINT32  PAE:1;
+    ///
+    /// [Bit 7] Machine Check Exception.  Exception 18 is defined for Machine
+    /// Checks, including CR4.MCE for controlling the feature. This feature does
+    /// not define the model-specific implementations of machine-check error
+    /// logging, reporting, and processor shutdowns. Machine Check exception
+    /// handlers may have to depend on processor version to do model specific
+    /// processing of the exception, or test for the presence of the Machine
+    /// Check feature.
+    ///
+    UINT32  MCE:1;
+    ///
+    /// [Bit 8] CMPXCHG8B Instruction.  The compare-and-exchange 8 bytes(64 bits)
+    /// instruction is supported (implicitly locked and atomic).
+    ///
+    UINT32  CX8:1;
+    ///
+    /// [Bit 9] APIC On-Chip.  The processor contains an Advanced Programmable
+    /// Interrupt Controller (APIC), responding to memory mapped commands in the
+    /// physical address range FFFE0000H to FFFE0FFFH (by default - some
+    /// processors permit the APIC to be relocated).
+    ///
+    UINT32  APIC:1;
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 11] SYSENTER and SYSEXIT Instructions.  The SYSENTER and SYSEXIT
+    /// and associated MSRs are supported.
+    ///
+    UINT32  SEP:1;
+    ///
+    /// [Bit 12] Memory Type Range Registers.  MTRRs are supported. The MTRRcap
+    /// MSR contains feature bits that describe what memory types are supported,
+    /// how many variable MTRRs are supported, and whether fixed MTRRs are
+    /// supported.
+    ///
+    UINT32  MTRR:1;
+    ///
+    /// [Bit 13] Page Global Bit.  The global bit is supported in paging-structure
+    /// entries that map a page, indicating TLB entries that are common to
+    /// different processes and need not be flushed. The CR4.PGE bit controls
+    /// this feature.
+    ///
+    UINT32  PGE:1;
+    ///
+    /// [Bit 14] Machine Check Architecture.  The Machine Check Architecture,
+    /// which provides a compatible mechanism for error reporting in P6 family,
+    /// Pentium 4, Intel Xeon processors, and future processors, is supported.
+    /// The MCG_CAP MSR contains feature bits describing how many banks of error
+    /// reporting MSRs are supported.
+    ///
+    UINT32  MCA:1;
+    ///
+    /// [Bit 15] Conditional Move Instructions.  The conditional move instruction
+    /// CMOV is supported. In addition, if x87 FPU is present as indicated by the
+    /// CPUID.FPU feature bit, then the FCOMI and FCMOV instructions are supported.
+    ///
+    UINT32  CMOV:1;
+    ///
+    /// [Bit 16] Page Attribute Table.  Page Attribute Table is supported. This
+    /// feature augments the Memory Type Range Registers (MTRRs), allowing an
+    /// operating system to specify attributes of memory accessed through a
+    /// linear address on a 4KB granularity.
+    ///
+    UINT32  PAT:1;
+    ///
+    /// [Bit 17] 36-Bit Page Size Extension.  4-MByte pages addressing physical
+    /// memory beyond 4 GBytes are supported with 32-bit paging. This feature
+    /// indicates that upper bits of the physical address of a 4-MByte page are
+    /// encoded in bits 20:13 of the page-directory entry. Such physical
+    /// addresses are limited by MAXPHYADDR and may be up to 40 bits in size.
+    ///
+    UINT32  PSE_36:1;
+    ///
+    /// [Bit 18] Processor Serial Number.  The processor supports the 96-bit
+    /// processor identification number feature and the feature is enabled.
+    ///
+    UINT32  PSN:1;
+    ///
+    /// [Bit 19] CLFLUSH Instruction.  CLFLUSH Instruction is supported.
+    ///
+    UINT32  CLFSH:1;
+    UINT32  Reserved2:1;
+    ///
+    /// [Bit 21] Debug Store.  The processor supports the ability to write debug
+    /// information into a memory resident buffer.  This feature is used by the
+    /// branch trace store (BTS) and precise event-based sampling (PEBS)
+    /// facilities.
+    ///
+    UINT32  DS:1;
+    ///
+    /// [Bit 22] Thermal Monitor and Software Controlled Clock Facilities.  The
+    /// processor implements internal MSRs that allow processor temperature to
+    /// be monitored and processor performance to be modulated in predefined
+    /// duty cycles under software control.
+    ///
+    UINT32  ACPI:1;
+    ///
+    /// [Bit 23] Intel MMX Technology.  The processor supports the Intel MMX
+    /// technology.
+    ///
+    UINT32  MMX:1;
+    ///
+    /// [Bit 24] FXSAVE and FXRSTOR Instructions.  The FXSAVE and FXRSTOR
+    /// instructions are supported for fast save and restore of the floating
+    /// point context. Presence of this bit also indicates that CR4.OSFXSR is
+    /// available for an operating system to indicate that it supports the
+    /// FXSAVE and FXRSTOR instructions.
+    ///
+    UINT32  FXSR:1;
+    ///
+    /// [Bit 25] SSE.  The processor supports the SSE extensions.
+    ///
+    UINT32  SSE:1;
+    ///
+    /// [Bit 26] SSE2.  The processor supports the SSE2 extensions.
+    ///
+    UINT32  SSE2:1;
+    ///
+    /// [Bit 27] Self Snoop.  The processor supports the management of
+    /// conflicting memory types by performing a snoop of its own cache
+    /// structure for transactions issued to the bus.
+    ///
+    UINT32  SS:1;
+    ///
+    /// [Bit 28] Max APIC IDs reserved field is Valid.  A value of 0 for HTT
+    /// indicates there is only a single logical processor in the package and
+    /// software should assume only a single APIC ID is reserved. A value of 1
+    /// for HTT indicates the value in CPUID.1.EBX[23:16] (the Maximum number of
+    /// addressable IDs for logical processors in this package) is valid for the
+    /// package.
+    ///
+    UINT32  HTT:1;
+    ///
+    /// [Bit 29] Thermal Monitor.  The processor implements the thermal monitor
+    /// automatic thermal control circuitry (TCC).
+    ///
+    UINT32  TM:1;
+    UINT32  Reserved3:1;
+    ///
+    /// [Bit 31] Pending Break Enable.  The processor supports the use of the
+    /// FERR#/PBE# pin when the processor is in the stop-clock state (STPCLK# is
+    /// asserted) to signal the processor that an interrupt is pending and that
+    /// the processor should return to normal operation to handle the interrupt.
+    /// Bit 10 (PBE enable) in the IA32_MISC_ENABLE MSR enables this capability.
+    ///
+    UINT32  PBE:1;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32    Uint32;
+} CPUID_VERSION_INFO_EDX;
+
+
+/**
+  CPUID Cache and TLB Information
+
+  @param   EAX  CPUID_CACHE_INFO (0x02)
+
+  @retval  EAX  Cache and TLB Information described by the type
+                CPUID_CACHE_INFO_CACHE_TLB.
+                CPUID_CACHE_INFO_CACHE_TLB.CacheDescriptor[0] always returns
+                0x01 and must be ignored.  Only valid if
+                CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear.
+  @retval  EBX  Cache and TLB Information described by the type
+                CPUID_CACHE_INFO_CACHE_TLB.  Only valid if
+                CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear.
+  @retval  ECX  Cache and TLB Information described by the type
+                CPUID_CACHE_INFO_CACHE_TLB.  Only valid if
+                CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear.
+  @retval  EDX  Cache and TLB Information described by the type
+                CPUID_CACHE_INFO_CACHE_TLB.  Only valid if
+                CPUID_CACHE_INFO_CACHE_TLB.Bits.NotValid is clear.
+
+  <b>Example usage</b>
+  @code
+  CPUID_CACHE_INFO_CACHE_TLB  Eax;
+  CPUID_CACHE_INFO_CACHE_TLB  Ebx;
+  CPUID_CACHE_INFO_CACHE_TLB  Ecx;
+  CPUID_CACHE_INFO_CACHE_TLB  Edx;
+
+  AsmCpuid (CPUID_CACHE_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+
+  <b>Cache Descriptor values</b>
+  <table>
+  <tr><th>Value </th><th> Type    </th><th> Description </th></tr>
+  <tr><td> 0x00 </td><td> General </td><td> Null descriptor, this byte contains no information</td></tr>
+  <tr><td> 0x01 </td><td> TLB     </td><td> Instruction TLB: 4 KByte pages, 4-way set associative, 32 entries</td></tr>
+  <tr><td> 0x02 </td><td> TLB     </td><td> Instruction TLB: 4 MByte pages, fully associative, 2 entries</td></tr>
+  <tr><td> 0x03 </td><td> TLB     </td><td> Data TLB: 4 KByte pages, 4-way set associative, 64 entries</td></tr>
+  <tr><td> 0x04 </td><td> TLB     </td><td> Data TLB: 4 MByte pages, 4-way set associative, 8 entries</td></tr>
+  <tr><td> 0x05 </td><td> TLB     </td><td> Data TLB1: 4 MByte pages, 4-way set associative, 32 entries</td></tr>
+  <tr><td> 0x06 </td><td> Cache   </td><td> 1st-level instruction cache: 8 KBytes, 4-way set associative,
+                                            32 byte line size</td></tr>
+  <tr><td> 0x08 </td><td> Cache   </td><td> 1st-level instruction cache: 16 KBytes, 4-way set associative,
+                                            32 byte line size</td></tr>
+  <tr><td> 0x09 </td><td> Cache   </td><td> 1st-level instruction cache: 32KBytes, 4-way set associative,
+                                            64 byte line size</td></tr>
+  <tr><td> 0x0A </td><td> Cache   </td><td> 1st-level data cache: 8 KBytes, 2-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x0B </td><td> TLB     </td><td> Instruction TLB: 4 MByte pages, 4-way set associative, 4 entries</td></tr>
+  <tr><td> 0x0C </td><td> Cache   </td><td> 1st-level data cache: 16 KBytes, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x0D </td><td> Cache   </td><td> 1st-level data cache: 16 KBytes, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x0E </td><td> Cache   </td><td> 1st-level data cache: 24 KBytes, 6-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x1D </td><td> Cache   </td><td> 2nd-level cache: 128 KBytes, 2-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x21 </td><td> Cache   </td><td> 2nd-level cache: 256 KBytes, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x22 </td><td> Cache   </td><td> 3rd-level cache: 512 KBytes, 4-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x23 </td><td> Cache   </td><td> 3rd-level cache: 1 MBytes, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x24 </td><td> Cache   </td><td> 2nd-level cache: 1 MBytes, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x25 </td><td> Cache   </td><td> 3rd-level cache: 2 MBytes, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x29 </td><td> Cache   </td><td> 3rd-level cache: 4 MBytes, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x2C </td><td> Cache   </td><td> 1st-level data cache: 32 KBytes, 8-way set associative,
+                                            64 byte line size</td></tr>
+  <tr><td> 0x30 </td><td> Cache   </td><td> 1st-level instruction cache: 32 KBytes, 8-way set associative,
+                                            64 byte line size</td></tr>
+  <tr><td> 0x40 </td><td> Cache   </td><td> No 2nd-level cache or, if processor contains a valid 2nd-level cache,
+                                            no 3rd-level cache</td></tr>
+  <tr><td> 0x41 </td><td> Cache   </td><td> 2nd-level cache: 128 KBytes, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x42 </td><td> Cache   </td><td> 2nd-level cache: 256 KBytes, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x43 </td><td> Cache   </td><td> 2nd-level cache: 512 KBytes, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x44 </td><td> Cache   </td><td> 2nd-level cache: 1 MByte, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x45 </td><td> Cache   </td><td> 2nd-level cache: 2 MByte, 4-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x46 </td><td> Cache   </td><td> 3rd-level cache: 4 MByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x47 </td><td> Cache   </td><td> 3rd-level cache: 8 MByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x48 </td><td> Cache   </td><td> 2nd-level cache: 3MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x49 </td><td> Cache   </td><td> 3rd-level cache: 4MB, 16-way set associative, 64-byte line size
+                                            (Intel Xeon processor MP, Family 0FH, Model 06H)<BR>
+                                            2nd-level cache: 4 MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4A </td><td> Cache   </td><td> 3rd-level cache: 6MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4B </td><td> Cache   </td><td> 3rd-level cache: 8MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4C </td><td> Cache   </td><td> 3rd-level cache: 12MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4D </td><td> Cache   </td><td> 3rd-level cache: 16MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4E </td><td> Cache   </td><td> 2nd-level cache: 6MByte, 24-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x4F </td><td> TLB     </td><td> Instruction TLB: 4 KByte pages, 32 entries</td></tr>
+  <tr><td> 0x50 </td><td> TLB     </td><td> Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 64 entries</td></tr>
+  <tr><td> 0x51 </td><td> TLB     </td><td> Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 128 entries</td></tr>
+  <tr><td> 0x52 </td><td> TLB     </td><td> Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 256 entries</td></tr>
+  <tr><td> 0x55 </td><td> TLB     </td><td> Instruction TLB: 2-MByte or 4-MByte pages, fully associative, 7 entries</td></tr>
+  <tr><td> 0x56 </td><td> TLB     </td><td> Data TLB0: 4 MByte pages, 4-way set associative, 16 entries</td></tr>
+  <tr><td> 0x57 </td><td> TLB     </td><td> Data TLB0: 4 KByte pages, 4-way associative, 16 entries</td></tr>
+  <tr><td> 0x59 </td><td> TLB     </td><td> Data TLB0: 4 KByte pages, fully associative, 16 entries</td></tr>
+  <tr><td> 0x5A </td><td> TLB     </td><td> Data TLB0: 2-MByte or 4 MByte pages, 4-way set associative, 32 entries</td></tr>
+  <tr><td> 0x5B </td><td> TLB     </td><td> Data TLB: 4 KByte and 4 MByte pages, 64 entries</td></tr>
+  <tr><td> 0x5C </td><td> TLB     </td><td> Data TLB: 4 KByte and 4 MByte pages,128 entries</td></tr>
+  <tr><td> 0x5D </td><td> TLB     </td><td> Data TLB: 4 KByte and 4 MByte pages,256 entries</td></tr>
+  <tr><td> 0x60 </td><td> Cache   </td><td> 1st-level data cache: 16 KByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x61 </td><td> TLB     </td><td> Instruction TLB: 4 KByte pages, fully associative, 48 entries</td></tr>
+  <tr><td> 0x63 </td><td> TLB     </td><td> Data TLB: 1 GByte pages, 4-way set associative, 4 entries</td></tr>
+  <tr><td> 0x66 </td><td> Cache   </td><td> 1st-level data cache: 8 KByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x67 </td><td> Cache   </td><td> 1st-level data cache: 16 KByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x68 </td><td> Cache   </td><td> 1st-level data cache: 32 KByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x6A </td><td> Cache   </td><td> uTLB: 4 KByte pages, 8-way set associative, 64 entries</td></tr>
+  <tr><td> 0x6B </td><td> Cache   </td><td> DTLB: 4 KByte pages, 8-way set associative, 256 entries</td></tr>
+  <tr><td> 0x6C </td><td> Cache   </td><td> DTLB: 2M/4M pages, 8-way set associative, 128 entries</td></tr>
+  <tr><td> 0x6D </td><td> Cache   </td><td> DTLB: 1 GByte pages, fully associative, 16 entries</td></tr>
+  <tr><td> 0x70 </td><td> Cache   </td><td> Trace cache: 12 K-uop, 8-way set associative</td></tr>
+  <tr><td> 0x71 </td><td> Cache   </td><td> Trace cache: 16 K-uop, 8-way set associative</td></tr>
+  <tr><td> 0x72 </td><td> Cache   </td><td> Trace cache: 32 K-uop, 8-way set associative</td></tr>
+  <tr><td> 0x76 </td><td> TLB     </td><td> Instruction TLB: 2M/4M pages, fully associative, 8 entries</td></tr>
+  <tr><td> 0x78 </td><td> Cache   </td><td> 2nd-level cache: 1 MByte, 4-way set associative, 64byte line size</td></tr>
+  <tr><td> 0x79 </td><td> Cache   </td><td> 2nd-level cache: 128 KByte, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x7A </td><td> Cache   </td><td> 2nd-level cache: 256 KByte, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x7B </td><td> Cache   </td><td> 2nd-level cache: 512 KByte, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x7C </td><td> Cache   </td><td> 2nd-level cache: 1 MByte, 8-way set associative, 64 byte line size,
+                                            2 lines per sector</td></tr>
+  <tr><td> 0x7D </td><td> Cache   </td><td> 2nd-level cache: 2 MByte, 8-way set associative, 64byte line size</td></tr>
+  <tr><td> 0x7F </td><td> Cache   </td><td> 2nd-level cache: 512 KByte, 2-way set associative, 64-byte line size</td></tr>
+  <tr><td> 0x80 </td><td> Cache   </td><td> 2nd-level cache: 512 KByte, 8-way set associative, 64-byte line size</td></tr>
+  <tr><td> 0x82 </td><td> Cache   </td><td> 2nd-level cache: 256 KByte, 8-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x83 </td><td> Cache   </td><td> 2nd-level cache: 512 KByte, 8-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x84 </td><td> Cache   </td><td> 2nd-level cache: 1 MByte, 8-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x85 </td><td> Cache   </td><td> 2nd-level cache: 2 MByte, 8-way set associative, 32 byte line size</td></tr>
+  <tr><td> 0x86 </td><td> Cache   </td><td> 2nd-level cache: 512 KByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0x87 </td><td> Cache   </td><td> 2nd-level cache: 1 MByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xA0 </td><td> DTLB    </td><td> DTLB: 4k pages, fully associative, 32 entries</td></tr>
+  <tr><td> 0xB0 </td><td> TLB     </td><td> Instruction TLB: 4 KByte pages, 4-way set associative, 128 entries</td></tr>
+  <tr><td> 0xB1 </td><td> TLB     </td><td> Instruction TLB: 2M pages, 4-way, 8 entries or 4M pages, 4-way, 4 entries</td></tr>
+  <tr><td> 0xB2 </td><td> TLB     </td><td> Instruction TLB: 4KByte pages, 4-way set associative, 64 entries</td></tr>
+  <tr><td> 0xB3 </td><td> TLB     </td><td> Data TLB: 4 KByte pages, 4-way set associative, 128 entries</td></tr>
+  <tr><td> 0xB4 </td><td> TLB     </td><td> Data TLB1: 4 KByte pages, 4-way associative, 256 entries</td></tr>
+  <tr><td> 0xB5 </td><td> TLB     </td><td> Instruction TLB: 4KByte pages, 8-way set associative, 64 entries</td></tr>
+  <tr><td> 0xB6 </td><td> TLB     </td><td> Instruction TLB: 4KByte pages, 8-way set associative,
+                                            128 entries</td></tr>
+  <tr><td> 0xBA </td><td> TLB     </td><td> Data TLB1: 4 KByte pages, 4-way associative, 64 entries</td></tr>
+  <tr><td> 0xC0 </td><td> TLB     </td><td> Data TLB: 4 KByte and 4 MByte pages, 4-way associative, 8 entries</td></tr>
+  <tr><td> 0xC1 </td><td> STLB    </td><td> Shared 2nd-Level TLB: 4 KByte/2MByte pages, 8-way associative,
+                                            1024 entries</td></tr>
+  <tr><td> 0xC2 </td><td> DTLB    </td><td> DTLB: 4 KByte/2 MByte pages, 4-way associative, 16 entries</td></tr>
+  <tr><td> 0xC3 </td><td> STLB    </td><td> Shared 2nd-Level TLB: 4 KByte /2 MByte pages, 6-way associative,
+                                            1536 entries. Also 1GBbyte pages, 4-way, 16 entries.</td></tr>
+  <tr><td> 0xCA </td><td> STLB    </td><td> Shared 2nd-Level TLB: 4 KByte pages, 4-way associative, 512 entries</td></tr>
+  <tr><td> 0xD0 </td><td> Cache   </td><td> 3rd-level cache: 512 KByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xD1 </td><td> Cache   </td><td> 3rd-level cache: 1 MByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xD2 </td><td> Cache   </td><td> 3rd-level cache: 2 MByte, 4-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xD6 </td><td> Cache   </td><td> 3rd-level cache: 1 MByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xD7 </td><td> Cache   </td><td> 3rd-level cache: 2 MByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xD8 </td><td> Cache   </td><td> 3rd-level cache: 4 MByte, 8-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xDC </td><td> Cache   </td><td> 3rd-level cache: 1.5 MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xDD </td><td> Cache   </td><td> 3rd-level cache: 3 MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xDE </td><td> Cache   </td><td> 3rd-level cache: 6 MByte, 12-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xE2 </td><td> Cache   </td><td> 3rd-level cache: 2 MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xE3 </td><td> Cache   </td><td> 3rd-level cache: 4 MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xE4 </td><td> Cache   </td><td> 3rd-level cache: 8 MByte, 16-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xEA </td><td> Cache   </td><td> 3rd-level cache: 12MByte, 24-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xEB </td><td> Cache   </td><td> 3rd-level cache: 18MByte, 24-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xEC </td><td> Cache   </td><td> 3rd-level cache: 24MByte, 24-way set associative, 64 byte line size</td></tr>
+  <tr><td> 0xF0 </td><td> Prefetch</td><td> 64-Byte prefetching</td></tr>
+  <tr><td> 0xF1 </td><td> Prefetch</td><td> 128-Byte prefetching</td></tr>
+  <tr><td> 0xFF </td><td> General </td><td> CPUID leaf 2 does not report cache descriptor information,
+                                            use CPUID leaf 4 to query cache parameters</td></tr>
+  </table>
+**/
+#define CPUID_CACHE_INFO                        0x02
+
+/**
+  CPUID Cache and TLB Information returned in EAX, EBX, ECX, and EDX for CPUID
+  leaf #CPUID_CACHE_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved:31;
+    ///
+    /// [Bit 31] If 0, then the cache descriptor bytes in the register are valid.
+    /// if 1, then none of the cache descriptor bytes in the register are valid.
+    ///
+    UINT32  NotValid:1;
+  } Bits;
+  ///
+  /// Array of Cache and TLB descriptor bytes
+  ///
+  UINT8   CacheDescriptor[4];
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_CACHE_INFO_CACHE_TLB;
+
+
+/**
+  CPUID Processor Serial Number
+
+  Processor serial number (PSN) is not supported in the Pentium 4 processor
+  or later.  On all models, use the PSN flag (returned using CPUID) to check
+  for PSN support before accessing the feature.
+
+  @param   EAX  CPUID_SERIAL_NUMBER (0x03)
+
+  @retval  EAX  Reserved.
+  @retval  EBX  Reserved.
+  @retval  ECX  Bits 31:0 of 96 bit processor serial number. (Available in
+                Pentium III processor only; otherwise, the value in this
+                register is reserved.)
+  @retval  EDX  Bits 63:32 of 96 bit processor serial number. (Available in
+                Pentium III processor only; otherwise, the value in this
+                register is reserved.)
+
+  <b>Example usage</b>
+  @code
+  UINT32  Ecx;
+  UINT32  Edx;
+
+  AsmCpuid (CPUID_SERIAL_NUMBER, NULL, NULL, &Ecx, &Edx);
+  @endcode
+**/
+#define CPUID_SERIAL_NUMBER                     0x03
+
+
+/**
+  CPUID Cache Parameters
+
+  @param   EAX  CPUID_CACHE_PARAMS (0x04)
+  @param   ECX  Cache Level.  Valid values start at 0.  Software can enumerate
+                the deterministic cache parameters for each level of the cache
+                hierarchy starting with an index value of 0, until the
+                parameters report the value associated with the CacheType
+                field in CPUID_CACHE_PARAMS_EAX is 0.
+
+  @retval  EAX  Returns cache type information described by the type
+                CPUID_CACHE_PARAMS_EAX.
+  @retval  EBX  Returns cache line and associativity information described by
+                the type CPUID_CACHE_PARAMS_EBX.
+  @retval  ECX  Returns the number of sets in the cache.
+  @retval  EDX  Returns cache WINVD/INVD behavior described by the type
+                CPUID_CACHE_PARAMS_EDX.
+
+  <b>Example usage</b>
+  @code
+  UINT32                  CacheLevel;
+  CPUID_CACHE_PARAMS_EAX  Eax;
+  CPUID_CACHE_PARAMS_EBX  Ebx;
+  UINT32                  Ecx;
+  CPUID_CACHE_PARAMS_EDX  Edx;
+
+  CacheLevel = 0;
+  do {
+    AsmCpuidEx (
+      CPUID_CACHE_PARAMS, CacheLevel,
+      &Eax.Uint32, &Ebx.Uint32, &Ecx, &Edx.Uint32
+      );
+    CacheLevel++;
+  } while (Eax.Bits.CacheType != CPUID_CACHE_PARAMS_CACHE_TYPE_NULL);
+  @endcode
+**/
+#define CPUID_CACHE_PARAMS                      0x04
+
+/**
+  CPUID Cache Parameters Information returned in EAX for CPUID leaf
+  #CPUID_CACHE_PARAMS.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 4:0] Cache type field.  If #CPUID_CACHE_PARAMS_CACHE_TYPE_NULL,
+    /// then there is no information for the requested cache level.
+    ///
+    UINT32  CacheType:5;
+    ///
+    /// [Bits 7:5] Cache level (Starts at 1).
+    ///
+    UINT32  CacheLevel:3;
+    ///
+    /// [Bit 8] Self Initializing cache level (does not need SW initialization).
+    ///
+    UINT32  SelfInitializingCache:1;
+    ///
+    /// [Bit 9] Fully Associative cache.
+    ///
+    UINT32  FullyAssociativeCache:1;
+    ///
+    /// [Bits 13:10] Reserved.
+    ///
+    UINT32  Reserved:4;
+    ///
+    /// [Bits 25:14] Maximum number of addressable IDs for logical processors
+    /// sharing this cache.
+    ///
+    /// Add one to the return value to get the result.
+    /// The nearest power-of-2 integer that is not smaller than (1 + EAX[25:14])
+    /// is the number of unique initial APIC IDs reserved for addressing
+    /// different logical processors sharing this cache.
+    ///
+    UINT32  MaximumAddressableIdsForLogicalProcessors:12;
+    ///
+    /// [Bits 31:26] Maximum number of addressable IDs for processor cores in
+    /// the physical package.
+    ///
+    /// The nearest power-of-2 integer that is not smaller than (1 + EAX[31:26])
+    /// is the number of unique Core_IDs reserved for addressing different
+    /// processor cores in a physical package. Core ID is a subset of bits of
+    /// the initial APIC ID.
+    /// The returned value is constant for valid initial values in ECX. Valid
+    /// ECX values start from 0.
+    ///
+    UINT32  MaximumAddressableIdsForProcessorCores:6;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_CACHE_PARAMS_EAX;
+
+///
+/// @{ Define value for bit field CPUID_CACHE_PARAMS_EAX.CacheType
+///
+#define CPUID_CACHE_PARAMS_CACHE_TYPE_NULL         0x00
+#define CPUID_CACHE_PARAMS_CACHE_TYPE_DATA         0x01
+#define CPUID_CACHE_PARAMS_CACHE_TYPE_INSTRUCTION  0x02
+#define CPUID_CACHE_PARAMS_CACHE_TYPE_UNIFIED      0x03
+///
+/// @}
+///
+
+/**
+  CPUID Cache Parameters Information returned in EBX for CPUID leaf
+  #CPUID_CACHE_PARAMS.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 11:0] System Coherency Line Size.  Add one to the return value to
+    /// get the result.
+    ///
+    UINT32  LineSize:12;
+    ///
+    /// [Bits 21:12] Physical Line Partitions.  Add one to the return value to
+    /// get the result.
+    ///
+    UINT32  LinePartitions:10;
+    ///
+    /// [Bits 31:22] Ways of associativity.  Add one to the return value to get
+    /// the result.
+    ///
+    UINT32  Ways:10;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_CACHE_PARAMS_EBX;
+
+/**
+  CPUID Cache Parameters Information returned in EDX for CPUID leaf
+  #CPUID_CACHE_PARAMS.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Write-Back Invalidate/Invalidate.
+    /// 0 = WBINVD/INVD from threads sharing this cache acts upon lower level
+    /// caches for threads sharing this cache.
+    /// 1 = WBINVD/INVD is not guaranteed to act upon lower level caches of
+    /// non-originating threads sharing this cache.
+    ///
+    UINT32  Invalidate:1;
+    ///
+    /// [Bit 1] Cache Inclusiveness.
+    /// 0 = Cache is not inclusive of lower cache levels.
+    /// 1 = Cache is inclusive of lower cache levels.
+    ///
+    UINT32  CacheInclusiveness:1;
+    ///
+    /// [Bit 2] Complex Cache Indexing.
+    /// 0 = Direct mapped cache.
+    /// 1 = A complex function is used to index the cache, potentially using all
+    /// address bits.
+    ///
+    UINT32  ComplexCacheIndexing:1;
+    UINT32  Reserved:29;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_CACHE_PARAMS_EDX;
+
+
+/**
+  CPUID MONITOR/MWAIT Information
+
+  @param   EAX  CPUID_MONITOR_MWAIT (0x05)
+
+  @retval  EAX  Smallest monitor-line size in bytes described by the type
+                CPUID_MONITOR_MWAIT_EAX.
+  @retval  EBX  Largest monitor-line size in bytes described by the type
+                CPUID_MONITOR_MWAIT_EBX.
+  @retval  ECX  Enumeration of Monitor-Mwait extensions support described by
+                the type CPUID_MONITOR_MWAIT_ECX.
+  @retval  EDX  Sub C-states supported described by the type
+                CPUID_MONITOR_MWAIT_EDX.
+
+  <b>Example usage</b>
+  @code
+  CPUID_MONITOR_MWAIT_EAX  Eax;
+  CPUID_MONITOR_MWAIT_EBX  Ebx;
+  CPUID_MONITOR_MWAIT_ECX  Ecx;
+  CPUID_MONITOR_MWAIT_EDX  Edx;
+
+  AsmCpuid (CPUID_MONITOR_MWAIT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
+#define CPUID_MONITOR_MWAIT                     0x05
+
+/**
+  CPUID MONITOR/MWAIT Information returned in EAX for CPUID leaf
+  #CPUID_MONITOR_MWAIT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Smallest monitor-line size in bytes (default is processor's
+    /// monitor granularity).
+    ///
+    UINT32  SmallestMonitorLineSize:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_MONITOR_MWAIT_EAX;
+
+/**
+  CPUID MONITOR/MWAIT Information returned in EBX for CPUID leaf
+  #CPUID_MONITOR_MWAIT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Largest monitor-line size in bytes (default is processor's
+    /// monitor granularity).
+    ///
+    UINT32  LargestMonitorLineSize:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_MONITOR_MWAIT_EBX;
+
+/**
+  CPUID MONITOR/MWAIT Information returned in ECX for CPUID leaf
+  #CPUID_MONITOR_MWAIT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] If 0, then only EAX and EBX are valid.  If 1, then EAX, EBX, ECX,
+    /// and EDX are valid.
+    ///
+    UINT32  ExtensionsSupported:1;
+    ///
+    /// [Bit 1] Supports treating interrupts as break-event for MWAIT, even when
+    /// interrupts disabled.
+    ///
+    UINT32  InterruptAsBreak:1;
+    UINT32  Reserved:30;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_MONITOR_MWAIT_ECX;
+
+/**
+  CPUID MONITOR/MWAIT Information returned in EDX for CPUID leaf
+  #CPUID_MONITOR_MWAIT.
+
+  @note
+  The definition of C0 through C7 states for MWAIT extension are
+  processor-specific C-states, not ACPI C-states.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 3:0] Number of C0 sub C-states supported using MWAIT.
+    ///
+    UINT32  C0States:4;
+    ///
+    /// [Bits 7:4] Number of C1 sub C-states supported using MWAIT.
+    ///
+    UINT32  C1States:4;
+    ///
+    /// [Bits 11:8] Number of C2 sub C-states supported using MWAIT.
+    ///
+    UINT32  C2States:4;
+    ///
+    /// [Bits 15:12] Number of C3 sub C-states supported using MWAIT.
+    ///
+    UINT32  C3States:4;
+    ///
+    /// [Bits 19:16] Number of C4 sub C-states supported using MWAIT.
+    ///
+    UINT32  C4States:4;
+    ///
+    /// [Bits 23:20] Number of C5 sub C-states supported using MWAIT.
+    ///
+    UINT32  C5States:4;
+    ///
+    /// [Bits 27:24] Number of C6 sub C-states supported using MWAIT.
+    ///
+    UINT32  C6States:4;
+    ///
+    /// [Bits 31:28] Number of C7 sub C-states supported using MWAIT.
+    ///
+    UINT32  C7States:4;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_MONITOR_MWAIT_EDX;
+
+
+/**
+  CPUID Thermal and Power Management
+
+  @param   EAX  CPUID_THERMAL_POWER_MANAGEMENT (0x06)
+
+  @retval  EAX  Thermal and power management features described by the type
+                CPUID_THERMAL_POWER_MANAGEMENT_EAX.
+  @retval  EBX  Number of Interrupt Thresholds in Digital Thermal Sensor
+                described by the type CPUID_THERMAL_POWER_MANAGEMENT_EBX.
+  @retval  ECX  Performance features described by the type
+                CPUID_THERMAL_POWER_MANAGEMENT_ECX.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  CPUID_THERMAL_POWER_MANAGEMENT_EAX  Eax;
+  CPUID_THERMAL_POWER_MANAGEMENT_EBX  Ebx;
+  CPUID_THERMAL_POWER_MANAGEMENT_ECX  Ecx;
+
+  AsmCpuid (CPUID_THERMAL_POWER_MANAGEMENT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, NULL);
+  @endcode
+**/
+#define CPUID_THERMAL_POWER_MANAGEMENT          0x06
+
+/**
+  CPUID Thermal and Power Management Information returned in EAX for CPUID leaf
+  #CPUID_THERMAL_POWER_MANAGEMENT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Digital temperature sensor is supported if set.
+    ///
+    UINT32  DigitalTemperatureSensor:1;
+    ///
+    /// [Bit 1] Intel Turbo Boost Technology Available (see IA32_MISC_ENABLE[38]).
+    ///
+    UINT32  TurboBoostTechnology:1;
+    ///
+    /// [Bit 2] APIC-Timer-always-running feature is supported if set.
+    ///
+    UINT32  ARAT:1;
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 4] Power limit notification controls are supported if set.
+    ///
+    UINT32  PLN:1;
+    ///
+    /// [Bit 5] Clock modulation duty cycle extension is supported if set.
+    ///
+    UINT32  ECMD:1;
+    ///
+    /// [Bit 6] Package thermal management is supported if set.
+    ///
+    UINT32  PTM:1;
+    ///
+    /// [Bit 7] HWP base registers (IA32_PM_ENABLE[Bit 0], IA32_HWP_CAPABILITIES,
+    /// IA32_HWP_REQUEST, IA32_HWP_STATUS) are supported if set.
+    ///
+    UINT32  HWP:1;
+    ///
+    /// [Bit 8] IA32_HWP_INTERRUPT MSR is supported if set.
+    ///
+    UINT32  HWP_Notification:1;
+    ///
+    /// [Bit 9] IA32_HWP_REQUEST[Bits 41:32] is supported if set.
+    ///
+    UINT32  HWP_Activity_Window:1;
+    ///
+    /// [Bit 10] IA32_HWP_REQUEST[Bits 31:24] is supported if set.
+    ///
+    UINT32  HWP_Energy_Performance_Preference:1;
+    ///
+    /// [Bit 11] IA32_HWP_REQUEST_PKG MSR is supported if set.
+    ///
+    UINT32  HWP_Package_Level_Request:1;
+    UINT32  Reserved2:1;
+    ///
+    /// [Bit 13] HDC base registers IA32_PKG_HDC_CTL, IA32_PM_CTL1,
+    /// IA32_THREAD_STALL MSRs are supported if set.
+    ///
+    UINT32  HDC:1;
+    UINT32  Reserved3:18;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_THERMAL_POWER_MANAGEMENT_EAX;
+
+/**
+  CPUID Thermal and Power Management Information returned in EBX for CPUID leaf
+  #CPUID_THERMAL_POWER_MANAGEMENT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// {Bits 3:0] Number of Interrupt Thresholds in Digital Thermal Sensor.
+    ///
+    UINT32  InterruptThresholds:4;
+    UINT32  Reserved:28;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_THERMAL_POWER_MANAGEMENT_EBX;
+
+/**
+  CPUID Thermal and Power Management Information returned in ECX for CPUID leaf
+  #CPUID_THERMAL_POWER_MANAGEMENT.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Hardware Coordination Feedback Capability (Presence of IA32_MPERF
+    /// and IA32_APERF). The capability to provide a measure of delivered
+    /// processor performance (since last reset of the counters), as a percentage
+    /// of the expected processor performance when running at the TSC frequency.
+    ///
+    UINT32  HardwareCoordinationFeedback:1;
+    UINT32  Reserved1:2;
+    ///
+    /// [Bit 3] If this bit is set, then the processor supports performance-energy
+    /// bias preference and the architectural MSR called IA32_ENERGY_PERF_BIAS
+    /// (1B0H).
+    ///
+    UINT32  PerformanceEnergyBias:1;
+    UINT32  Reserved2:28;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_THERMAL_POWER_MANAGEMENT_ECX;
+
+
+/**
+  CPUID Structured Extended Feature Flags Enumeration
+
+  @param   EAX  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS (0x07)
+  @param   ECX  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO (0x00).
+
+  @note
+  If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0.  Sub-leaf
+  index n is invalid if n exceeds the value that sub-leaf 0 returns in EAX.
+
+  @retval  EAX  The maximum input value for ECX to retrieve sub-leaf information.
+  @retval  EBX  Structured Extended Feature Flags described by the type
+                CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX.
+  @retval  EBX  Structured Extended Feature Flags described by the type
+                CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                       Eax;
+  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX  Ebx;
+  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX  Ecx;
+  UINT32                                       SubLeaf;
+
+  AsmCpuidEx (
+    CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS,
+    CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO,
+    &Eax, NULL, NULL, NULL
+    );
+  for (SubLeaf = 0; SubLeaf <= Eax; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS,
+      SubLeaf,
+      NULL, &Ebx.Uint32, &Ecx.Uint32, NULL
+      );
+    SubLeaf++;
+  } while (SubLeaf <= Eax);
+  @endcode
+**/
+#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS                0x07
+
+///
+/// CPUID Structured Extended Feature Flags Enumeration sub-leaf
+///
+#define CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO  0x00
+
+/**
+  CPUID Structured Extended Feature Flags Enumeration in EBX for CPUID leaf
+  #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf
+  #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Supports RDFSBASE/RDGSBASE/WRFSBASE/WRGSBASE if 1.
+    ///
+    UINT32  FSGSBASE:1;
+    ///
+    /// [Bit 1] IA32_TSC_ADJUST MSR is supported if 1.
+    ///
+    UINT32  IA32_TSC_ADJUST:1;
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 3] If 1 indicates the processor supports the first group of advanced
+    /// bit manipulation extensions (ANDN, BEXTR, BLSI, BLSMSK, BLSR, TZCNT)
+    ///
+    UINT32  BMI1:1;
+    ///
+    /// [Bit 4] Hardware Lock Elision
+    ///
+    UINT32  HLE:1;
+    ///
+    /// [Bit 5] If 1 indicates the processor supports AVX2 instruction extensions.
+    ///
+    UINT32  AVX2:1;
+    ///
+    /// [Bit 6] x87 FPU Data Pointer updated only on x87 exceptions if 1.
+    ///
+    UINT32  FDP_EXCPTN_ONLY:1;
+    ///
+    /// [Bit 7] Supports Supervisor-Mode Execution Prevention if 1.
+    ///
+    UINT32  SMEP:1;
+    ///
+    /// [Bit 8] If 1 indicates the processor supports the second group of
+    /// advanced bit manipulation extensions (BZHI, MULX, PDEP, PEXT, RORX,
+    /// SARX, SHLX, SHRX)
+    ///
+    UINT32  BMI2:1;
+    ///
+    /// [Bit 9] Supports Enhanced REP MOVSB/STOSB if 1.
+    ///
+    UINT32  EnhancedRepMovsbStosb:1;
+    ///
+    /// [Bit 10] If 1, supports INVPCID instruction for system software that
+    /// manages process-context identifiers.
+    ///
+    UINT32  INVPCID:1;
+    ///
+    /// [Bit 11] Restricted Transactional Memory
+    ///
+    UINT32  RTM:1;
+    ///
+    /// [Bit 12] Supports Platform Quality of Service Monitoring (PQM)
+    /// capability if 1.
+    ///
+    UINT32  PQM:1;
+    ///
+    /// [Bit 13] Deprecates FPU CS and FPU DS values if 1.
+    ///
+    UINT32  DeprecateFpuCsDs:1;
+    ///
+    /// [Bit 14] Supports Intel(R) Memory Protection Extensions if 1.
+    ///
+    UINT32  MPX:1;
+    ///
+    /// [Bit 15] Supports Platform Quality of Service Enforcement (PQE)
+    /// capability if 1.
+    ///
+    UINT32  PQE:1;
+    UINT32  Reserved2:2;
+    ///
+    /// [Bit 18] If 1 indicates the processor supports the RDSEED instruction.
+    ///
+    UINT32  RDSEED:1;
+    ///
+    /// [Bit 19] If 1 indicates the processor supports the ADCX and ADOX
+    /// instructions.
+    ///
+    UINT32  ADX:1;
+    ///
+    /// [Bit 20] Supports Supervisor-Mode Access Prevention (and the CLAC/STAC
+    /// instructions) if 1.
+    ///
+    UINT32  SMAP:1;
+    UINT32  Reserved3:2;
+    ///
+    /// [Bit 23] If 1 indicates the processor supports the CLFLUSHOPT instruction.
+    ///
+    UINT32  CLFLUSHOPT:1;
+    UINT32  Reserved4:1;
+    ///
+    /// [Bit 25] If 1 indicates the processor supports the Intel Processor Trace
+    /// extensions.
+    ///
+    UINT32  IntelProcessorTrace:1;
+    UINT32  Reserved5:6;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX;
+
+/**
+  CPUID Structured Extended Feature Flags Enumeration in ECX for CPUID leaf
+  #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS sub leaf
+  #CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] If 1 indicates the processor supports the PREFETCHWT1 instruction.
+    ///
+    UINT32  PREFETCHWT1:1;
+    UINT32  Reserved1:2;
+    ///
+    /// [Bit 3] Supports protection keys for user-mode pages if 1.
+    ///
+    UINT32  PKU:1;
+    ///
+    /// [Bit 4] If 1, OS has set CR4.PKE to enable protection keys (and the
+    /// RDPKRU/WRPKRU instructions).
+    ///
+    UINT32  OSPKE:1;
+    UINT32  Reserved2:27;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX;
+
+
+/**
+  CPUID Direct Cache Access Information
+
+  @param   EAX  CPUID_DIRECT_CACHE_ACCESS_INFO (0x09)
+
+  @retval  EAX  Value of bits [31:0] of IA32_PLATFORM_DCA_CAP MSR (address 1F8H).
+  @retval  EBX  Reserved.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32  Eax;
+
+  AsmCpuid (CPUID_DIRECT_CACHE_ACCESS_INFO, &Eax, NULL, NULL, NULL);
+  @endcode
+**/
+#define CPUID_DIRECT_CACHE_ACCESS_INFO              0x09
+
+
+/**
+  CPUID Architectural Performance Monitoring
+
+  @param   EAX  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING (0x0A)
+
+  @retval  EAX  Architectural Performance Monitoring information described by
+                the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX.
+  @retval  EBX  Architectural Performance Monitoring information described by
+                the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX.
+  @retval  ECX  Reserved.
+  @retval  EDX  Architectural Performance Monitoring information described by
+                the type CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX.
+
+  <b>Example usage</b>
+  @code
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX  Eax;
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX  Ebx;
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX  Edx;
+
+  AsmCpuid (CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING, &Eax.Uint32, &Ebx.Uint32, NULL, &Edx.Uint32);
+  @endcode
+**/
+#define CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING  0x0A
+
+/**
+  CPUID Architectural Performance Monitoring EAX for CPUID leaf
+  #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 7:0] Version ID of architectural performance monitoring.
+    ///
+    UINT32  ArchPerfMonVerID:8;
+    ///
+    /// [Bits 15:8] Number of general-purpose performance monitoring counter
+    /// per logical processor.
+    ///
+    /// IA32_PERFEVTSELx MSRs start at address 186H and occupy a contiguous
+    /// block of MSR address space. Each performance event select register is
+    /// paired with a corresponding performance counter in the 0C1H address
+    /// block.
+    ///
+    UINT32  PerformanceMonitorCounters:8;
+    ///
+    /// [Bits 23:16] Bit width of general-purpose, performance monitoring counter.
+    ///
+    /// The bit width of an IA32_PMCx MSR. This the number of valid bits for
+    /// read operation. On write operations, the lower-order 32 bits of the MSR
+    /// may be written with any value, and the high-order bits are sign-extended
+    /// from the value of bit 31.
+    ///
+    UINT32  PerformanceMonitorCounterWidth:8;
+    ///
+    /// [Bits 31:24] Length of EBX bit vector to enumerate architectural
+    /// performance monitoring events.
+    ///
+    UINT32  EbxBitVectorLength:8;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX;
+
+/**
+  CPUID Architectural Performance Monitoring EBX for CPUID leaf
+  #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Core cycle event not available if 1.
+    ///
+    UINT32  UnhaltedCoreCycles:1;
+    ///
+    /// [Bit 1] Instruction retired event not available if 1.
+    ///
+    UINT32  InstructionsRetired:1;
+    ///
+    /// [Bit 2] Reference cycles event not available if 1.
+    ///
+    UINT32  UnhaltedReferenceCycles:1;
+    ///
+    /// [Bit 3] Last-level cache reference event not available if 1.
+    ///
+    UINT32  LastLevelCacheReferences:1;
+    ///
+    /// [Bit 4] Last-level cache misses event not available if 1.
+    ///
+    UINT32  LastLevelCacheMisses:1;
+    ///
+    /// [Bit 5] Branch instruction retired event not available if 1.
+    ///
+    UINT32  BranchInstructionsRetired:1;
+    ///
+    /// [Bit 6] Branch mispredict retired event not available if 1.
+    ///
+    UINT32  AllBranchMispredictRetired:1;
+    UINT32  Reserved:25;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX;
+
+/**
+  CPUID Architectural Performance Monitoring EDX for CPUID leaf
+  #CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 4:0] Number of fixed-function performance counters
+    /// (if Version ID > 1).
+    ///
+    UINT32  FixedFunctionPerformanceCounters:5;
+    ///
+    /// [Bits 12:5] Bit width of fixed-function performance counters
+    /// (if Version ID > 1).
+    ///
+    UINT32  FixedFunctionPerformanceCounterWidth:8;
+    UINT32  Reserved:19;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX;
+
+
+/**
+  CPUID Extended Topology Information
+
+  @note
+  Most of Leaf 0BH output depends on the initial value in ECX.  The EDX output
+  of leaf 0BH is always valid and does not vary with input value in ECX.  Output
+  value in ECX[7:0] always equals input value in ECX[7:0].  For sub-leaves that
+  return an invalid level-type of 0 in ECX[15:8]; EAX and EBX will return 0.  If
+  an input value n in ECX returns the invalid level-type of 0 in ECX[15:8],
+  other input values with ECX > n also return 0 in ECX[15:8].
+
+  @param   EAX  CPUID_EXTENDED_TOPOLOGY (0x0B)
+  @param   ECX  Level number
+
+  @retval  EAX  Extended topology information described by the type
+                CPUID_EXTENDED_TOPOLOGY_EAX.
+  @retval  EBX  Extended topology information described by the type
+                CPUID_EXTENDED_TOPOLOGY_EBX.
+  @retval  ECX  Extended topology information described by the type
+                CPUID_EXTENDED_TOPOLOGY_ECX.
+  @retval  EDX  x2APIC ID the current logical processor.
+
+  <b>Example usage</b>
+  @code
+  CPUID_EXTENDED_TOPOLOGY_EAX  Eax;
+  CPUID_EXTENDED_TOPOLOGY_EBX  Ebx;
+  CPUID_EXTENDED_TOPOLOGY_ECX  Ecx;
+  UINT32                       Edx;
+  UINT32                       LevelNumber;
+
+  LevelNumber = 0;
+  do {
+    AsmCpuidEx (
+      CPUID_EXTENDED_TOPOLOGY, LevelNumber,
+      &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx
+      );
+    LevelNumber++;
+  } while (Eax.Bits.ApicIdShift != 0);
+  @endcode
+**/
+#define CPUID_EXTENDED_TOPOLOGY                             0x0B
+
+/**
+  CPUID Extended Topology Information EAX for CPUID leaf #CPUID_EXTENDED_TOPOLOGY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 4:0] Number of bits to shift right on x2APIC ID to get a unique
+    /// topology ID of the next level type.  All logical processors with the
+    /// same next level ID share current level.
+    ///
+    /// @note
+    /// Software should use this field (EAX[4:0]) to enumerate processor
+    /// topology of the system.
+    ///
+    UINT32  ApicIdShift:5;
+    UINT32  Reserved:27;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_TOPOLOGY_EAX;
+
+/**
+  CPUID Extended Topology Information EBX for CPUID leaf #CPUID_EXTENDED_TOPOLOGY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Number of logical processors at this level type. The number
+    /// reflects configuration as shipped by Intel.
+    ///
+    /// @note
+    /// Software must not use EBX[15:0] to enumerate processor topology of the
+    /// system. This value in this field (EBX[15:0]) is only intended for
+    /// display/diagnostic purposes. The actual number of logical processors
+    /// available to BIOS/OS/Applications may be different from the value of
+    /// EBX[15:0], depending on software and platform hardware configurations.
+    ///
+    UINT32  LogicalProcessors:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_TOPOLOGY_EBX;
+
+/**
+  CPUID Extended Topology Information ECX for CPUID leaf #CPUID_EXTENDED_TOPOLOGY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 7:0] Level number. Same value in ECX input.
+    ///
+    UINT32  LevelNumber:8;
+    ///
+    /// [Bits 15:8] Level type.
+    ///
+    /// @note
+    /// The value of the "level type" field is not related to level numbers in
+    /// any way, higher "level type" values do not mean higher levels.
+    ///
+    UINT32  LevelType:8;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_TOPOLOGY_ECX;
+
+///
+/// @{ Define value for CPUID_EXTENDED_TOPOLOGY_ECX.LevelType
+///
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID        0x00
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT            0x01
+#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE           0x02
+///
+/// @}
+///
+
+
+/**
+  CPUID Extended State Information
+
+  @param   EAX  CPUID_EXTENDED_STATE (0x0D)
+  @param   ECX  CPUID_EXTENDED_STATE_MAIN_LEAF (0x00).
+                CPUID_EXTENDED_STATE_SUB_LEAF (0x01).
+                CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02).
+                Sub leafs 2..n based on supported bits in XCR0 or IA32_XSS_MSR.
+**/
+#define CPUID_EXTENDED_STATE                                0x0D
+
+/**
+  CPUID Extended State Information Main Leaf
+
+  @param   EAX  CPUID_EXTENDED_STATE (0x0D)
+  @param   ECX  CPUID_EXTENDED_STATE_MAIN_LEAF (0x00)
+
+  @retval  EAX  Reports the supported bits of the lower 32 bits of XCR0. XCR0[n]
+                can be set to 1 only if EAX[n] is 1.  The format of the extended
+                state main leaf is described by the type
+                CPUID_EXTENDED_STATE_MAIN_LEAF_EAX.
+  @retval  EBX  Maximum size (bytes, from the beginning of the XSAVE/XRSTOR save
+                area) required by enabled features in XCR0. May be different than
+                ECX if some features at the end of the XSAVE save area are not
+                enabled.
+  @retval  ECX  Maximum size (bytes, from the beginning of the XSAVE/XRSTOR save
+                area) of the XSAVE/XRSTOR save area required by all supported
+                features in the processor, i.e all the valid bit fields in XCR0.
+  @retval  EDX  Reports the supported bits of the upper 32 bits of XCR0.
+                XCR0[n+32] can be set to 1 only if EDX[n] is 1.
+
+  <b>Example usage</b>
+  @code
+  CPUID_EXTENDED_STATE_MAIN_LEAF_EAX  Eax;
+  UINT32                              Ebx;
+  UINT32                              Ecx;
+  UINT32                              Edx;
+
+  AsmCpuidEx (
+    CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_MAIN_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx, &Edx
+    );
+  @endcode
+**/
+#define CPUID_EXTENDED_STATE_MAIN_LEAF                      0x00
+
+/**
+  CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STATE,
+  sub-leaf #CPUID_EXTENDED_STATE_MAIN_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] x87 state.
+    ///
+    UINT32  x87:1;
+    ///
+    /// [Bit 1] SSE state.
+    ///
+    UINT32  SSE:1;
+    ///
+    /// [Bit 2] AVX state.
+    ///
+    UINT32  AVX:1;
+    ///
+    /// [Bits 4:3] MPX state.
+    ///
+    UINT32  MPX:2;
+    ///
+    /// [Bits 7:5] AVX-512 state.
+    ///
+    UINT32  AVX_512:3;
+    ///
+    /// [Bit 8] Used for IA32_XSS.
+    ///
+    UINT32  IA32_XSS:1;
+    ///
+    /// [Bit 9] PKRU state.
+    ///
+    UINT32  PKRU:1;
+    UINT32  Reserved:22;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_STATE_MAIN_LEAF_EAX;
+
+/**
+  CPUID Extended State Information Sub Leaf
+
+  @param   EAX  CPUID_EXTENDED_STATE (0x0D)
+  @param   ECX  CPUID_EXTENDED_STATE_SUB_LEAF (0x01)
+
+  @retval  EAX  The format of the extended state sub-leaf is described by the
+                type CPUID_EXTENDED_STATE_SUB_LEAF_EAX.
+  @retval  EBX  The size in bytes of the XSAVE area containing all states
+                enabled by XCRO | IA32_XSS.
+  @retval  ECX  The format of the extended state sub-leaf is described by the
+                type CPUID_EXTENDED_STATE_SUB_LEAF_ECX.
+  @retval  EDX  Reports the supported bits of the upper 32 bits of the
+                IA32_XSS MSR. IA32_XSS[n+32] can be set to 1 only if EDX[n] is 1.
+
+  <b>Example usage</b>
+  @code
+  CPUID_EXTENDED_STATE_SUB_LEAF_EAX  Eax;
+  UINT32                             Ebx;
+  CPUID_EXTENDED_STATE_SUB_LEAF_ECX  Ecx;
+  UINT32                             Edx;
+
+  AsmCpuidEx (
+    CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_SUB_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx
+    );
+  @endcode
+**/
+#define CPUID_EXTENDED_STATE_SUB_LEAF                       0x01
+
+/**
+  CPUID Extended State Information EAX for CPUID leaf #CPUID_EXTENDED_STATE,
+  sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] XSAVEOPT is available.
+    ///
+    UINT32  XSAVEOPT:1;
+    ///
+    /// [Bit 1] Supports XSAVEC and the compacted form of XRSTOR if set.
+    ///
+    UINT32  XSAVEC:1;
+    ///
+    /// [Bit 2] Supports XGETBV with ECX = 1 if set.
+    ///
+    UINT32  XGETBV:1;
+    ///
+    /// [Bit 3] Supports XSAVES/XRSTORS and IA32_XSS if set.
+    ///
+    UINT32  XSAVES:1;
+    UINT32  Reserved:28;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_STATE_SUB_LEAF_EAX;
+
+/**
+  CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STATE,
+  sub-leaf #CPUID_EXTENDED_STATE_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 7:0] Used for XCR0.
+    ///
+    UINT32  XCR0:1;
+    ///
+    /// [Bit 8] PT STate.
+    ///
+    UINT32  PT:1;
+    ///
+    /// [Bit 9] Used for XCR0.
+    ///
+    UINT32  XCR0_1:1;
+    UINT32  Reserved:22;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_STATE_SUB_LEAF_ECX;
+
+/**
+  CPUID Extended State Information Size and Offset Sub Leaf
+
+  @note
+  Leaf 0DH output depends on the initial value in ECX.
+  Each sub-leaf index (starting at position 2) is supported if it corresponds to
+  a supported bit in either the XCR0 register or the IA32_XSS MSR.
+  If ECX contains an invalid sub-leaf index, EAX/EBX/ECX/EDX return 0. Sub-leaf
+  n (0 <= n <= 31) is invalid if sub-leaf 0 returns 0 in EAX[n] and sub-leaf 1
+  returns 0 in ECX[n]. Sub-leaf n (32 <= n <= 63) is invalid if sub-leaf 0
+  returns 0 in EDX[n-32] and sub-leaf 1 returns 0 in EDX[n-32].
+
+  @param   EAX  CPUID_EXTENDED_STATE (0x0D)
+  @param   ECX  CPUID_EXTENDED_STATE_SIZE_OFFSET (0x02).  Sub leafs 2..n based
+                on supported bits in XCR0 or IA32_XSS_MSR.
+
+  @retval  EAX  The size in bytes (from the offset specified in EBX) of the save
+                area for an extended state feature associated with a valid
+                sub-leaf index, n.
+  @retval  EBX  The offset in bytes of this extended state component's save area
+                from the beginning of the XSAVE/XRSTOR area.  This field reports
+                0 if the sub-leaf index, n, does not map to a valid bit in the
+                XCR0 register.
+  @retval  ECX  The format of the extended state components's save area as
+                described by the type CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX.
+                This field reports 0 if the sub-leaf index, n, is invalid.
+  @retval  EDX  This field reports 0 if the sub-leaf index, n, is invalid;
+                otherwise it is reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                Eax;
+  UINT32                                Ebx;
+  CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX  Ecx;
+  UINT32                                Edx;
+  UINTN                                 SubLeaf;
+
+  for (SubLeaf = CPUID_EXTENDED_STATE_SIZE_OFFSET; SubLeaf < 32; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_EXTENDED_STATE, SubLeaf,
+      &Eax, &Ebx, &Ecx.Uint32, &Edx
+      );
+  }
+  @endcode
+**/
+#define CPUID_EXTENDED_STATE_SIZE_OFFSET                    0x02
+
+/**
+  CPUID Extended State Information ECX for CPUID leaf #CPUID_EXTENDED_STATE,
+  sub-leaf #CPUID_EXTENDED_STATE_SIZE_OFFSET.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Is set if the bit n (corresponding to the sub-leaf index) is
+    /// supported in the IA32_XSS MSR; it is clear if bit n is instead supported
+    /// in XCR0.
+    ///
+    UINT32  XSS:1;
+    ///
+    /// [Bit 1] is set if, when the compacted format of an XSAVE area is used,
+    /// this extended state component located on the next 64-byte boundary
+    /// following the preceding state component (otherwise, it is located
+    /// immediately following the preceding state component).
+    ///
+    UINT32  Compacted:1;
+    UINT32  Reserved:30;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX;
+
+
+/**
+  CPUID Platform QoS Monitoring Information
+
+  @param   EAX  CPUID_PLATFORM_QOS_MONITORING (0x0F)
+  @param   ECX  CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF (0x00).
+                CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF  (0x01).
+
+**/
+#define CPUID_PLATFORM_QOS_MONITORING                       0x0F
+
+/**
+  CPUID Platform QoS Monitoring Information Enumeration Sub-leaf
+
+  @param   EAX  CPUID_PLATFORM_QOS_MONITORING (0x0F)
+  @param   ECX  CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF (0x00)
+
+  @retval  EAX  Reserved.
+  @retval  EBX  Maximum range (zero-based) of RMID within this physical
+                processor of all types.
+  @retval  ECX  Reserved.
+  @retval  EDX  L3 Cache QoS Monitoring Information Enumeration described by the
+                type CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF_EDX.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                                  Ebx;
+  CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF_EDX  Edx;
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF,
+    NULL, &Ebx, NULL, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF  0x00
+
+/**
+  CPUID Platform QoS Monitoring Information EDX for CPUID leaf
+  #CPUID_PLATFORM_QOS_MONITORING, sub-leaf
+  #CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 1] Supports L3 Cache QoS Monitoring if 1.
+    ///
+    UINT32  L3CacheQosEnforcement:1;
+    UINT32  Reserved2:30;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF_EDX;
+
+/**
+  CPUID Platform QoS Monitoring Information Capability Sub-leaf
+
+  @param   EAX  CPUID_PLATFORM_QOS_MONITORING (0x0F)
+  @param   ECX  CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF (0x01)
+
+  @retval  EAX  Reserved.
+  @retval  EBX  Conversion factor from reported IA32_QM_CTR value to occupancy metric (bytes).
+  @retval  ECX  Maximum range (zero-based) of RMID of this resource type.
+  @retval  EDX  L3 Cache QoS Monitoring Capability information described by the
+                type CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF_EDX.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                                 Ebx;
+  UINT32                                                 Ecx;
+  CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF_EDX  Edx;
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF,
+    NULL, &Ebx, &Ecx, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF   0x01
+
+/**
+  CPUID Platform QoS Monitoring Information Capability EDX for CPUID leaf
+  #CPUID_PLATFORM_QOS_MONITORING, sub-leaf
+  #CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] Supports L3 occupancy monitoring if 1.
+    ///
+    UINT32  L3CacheOccupancyMonitoring:1;
+    UINT32  Reserved:31;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF_EDX;
+
+
+/**
+  CPUID Platform QoS Enforcement Information
+
+  @param   EAX  CPUID_PLATFORM_QOS_ENFORCEMENT (0x10).
+  @param   ECX  CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF (0x00).
+                CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF (0x01).
+                Additional sub leafs 1..n based in RESID from sub leaf 0x00.
+**/
+#define CPUID_PLATFORM_QOS_ENFORCEMENT                      0x10
+
+/**
+  CPUID Platform QoS Enforcement Information
+
+  @param   EAX  CPUID_PLATFORM_QOS_ENFORCEMENT (0x10)
+  @param   ECX  CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF (0x00).
+
+  @retval  EAX  Reserved.
+  @retval  EBX  L3 Cache QoS Enforcement information described by the
+                type CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF_EBX.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF_EBX  Ebx;
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF,
+    NULL, &Ebx.Uint32, NULL, NULL
+    );
+  @endcode
+**/
+#define CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF            0x00
+
+/**
+  CPUID Platform QoS Enforcement Information EBX for CPUID leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT, sub-leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 1] Supports L3 Cache QoS Enforcement if 1.
+    ///
+    UINT32  L3CacheQosEnforcement:1;
+    UINT32  Reserved2:30;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF_EBX;
+
+
+/**
+  CPUID Platform QoS Enforcement Information
+
+  @param   EAX  CPUID_PLATFORM_QOS_ENFORCEMENT (0x10)
+  @param   ECX  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF (0x00)
+                Additional sub leafs 1..n based in RESID from sub leaf 0x00.
+
+  @retval  EAX  RESID L3 Cache3 QoS Enforcement information described by the
+                type CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EAX.
+  @retval  EBX  Bit-granular map of isolation/contention of allocation units.
+  @retval  ECX  RESID L3 Cache3 QoS Enforcement information described by the
+                type CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_ECX.
+  @retval  EDX  RESID L3 Cache3 QoS Enforcement information described by the
+                type CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EDX.
+
+  <b>Example usage</b>
+  @code
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EAX Eax;
+  UINT32                                            Ebx;
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_ECX Ecx;
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EDX Edx;
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF       0x01
+
+/**
+  CPUID Platform QoS Enforcement Information EAX for CPUID leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT, sub-leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 3:0] Length of the capacity bit mask for the corresponding ResID.
+    ///
+    UINT32  CapacityLength:4;
+    UINT32  Reserved:28;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EAX;
+
+/**
+  CPUID Platform QoS Enforcement Information ECX for CPUID leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT, sub-leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved1:1;
+    ///
+    /// [Bit 1] Updates of COS should be infrequent if 1.
+    ///
+    UINT32  CosUpdatesInfrequent:1;
+    ///
+    /// [Bit 2] Code and Data Prioritization Technology supported if 1.
+    ///
+    UINT32  CodeDataPrioritization:1;
+    UINT32  Reserved2:29;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_ECX;
+
+/**
+  CPUID Platform QoS Enforcement Information EDX for CPUID leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT, sub-leaf
+  #CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Highest COS number supported for this ResID.
+    ///
+    UINT32  HighestCosNumber:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EDX;
+
+
+/**
+  CPUID Intel Processor Trace Information
+
+  @param   EAX  CPUID_INTEL_PROCESSOR_TRACE (0x14)
+  @param   ECX  CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF (0x00).
+                CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01).
+
+**/
+#define CPUID_INTEL_PROCESSOR_TRACE                         0x14
+
+/**
+  CPUID Intel Processor Trace Information Main Leaf
+
+  @param   EAX  CPUID_INTEL_PROCEDSSOR_TRACE (0x14)
+  @param   ECX  CPUID_INTEL_PROCEDSSOR_TRACE_MAIN_LEAF (0x00)
+
+  @retval  EAX  Reports the maximum sub-leaf supported in leaf 14H.
+  @retval  EBX  Returns Intel processor trace information described by the
+                type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX.
+  @retval  ECX  Returns Intel processor trace information described by the
+                type CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                     Eax;
+  CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX  Ebx;
+  CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX  Ecx;
+
+  AsmCpuidEx (
+    CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF,
+    &Eax, &Ebx.Uint32, &Ecx.Uint32, NULL
+    );
+  @endcode
+**/
+#define CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF               0x00
+
+/**
+  CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TRACE,
+  sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] If 1, Indicates that IA32_RTIT_CTL.CR3Filter can be set to 1,
+    /// and that IA32_RTIT_CR3_MATCH MSR can be accessed.
+    ///
+    UINT32  Cr3Filter:1;
+    ///
+    /// [Bit 1] If 1, Indicates support of Configurable PSB and Cycle-Accurate
+    /// Mode.
+    ///
+    UINT32  ConfigurablePsb:1;
+    ///
+    /// [Bit 2] If 1, Indicates support of IP Filtering, TraceStop filtering,
+    /// and preservation of Intel PT MSRs across warm reset.
+    ///
+    UINT32  IpTraceStopFiltering:1;
+    ///
+    /// [Bit 3] If 1, Indicates support of MTC timing packet and suppression of
+    /// COFI-based packets.
+    ///
+    UINT32  Mtc:1;
+    UINT32  Reserved:28;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX;
+
+/**
+  CPUID Intel Processor Trace ECX for CPUID leaf #CPUID_INTEL_PROCESSOR_TRACE,
+  sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] If 1, Tracing can be enabled with IA32_RTIT_CTL.ToPA = 1, hence
+    /// utilizing the ToPA output scheme; IA32_RTIT_OUTPUT_BASE and
+    /// IA32_RTIT_OUTPUT_MASK_PTRS MSRs can be accessed.
+    ///
+    UINT32  RTIT:1;
+    ///
+    /// [Bit 1] If 1, ToPA tables can hold any number of output entries, up to
+    /// the maximum allowed by the MaskOrTableOffset field of
+    /// IA32_RTIT_OUTPUT_MASK_PTRS.
+    ///
+    UINT32  ToPA:1;
+    ///
+    /// [Bit 2] If 1, Indicates support of Single-Range Output scheme.
+    ///
+    UINT32  SingleRangeOutput:1;
+    ///
+    /// [Bit 3] If 1, Indicates support of output to Trace Transport subsystem.
+    ///
+    UINT32  TraceTransportSubsystem:1;
+    UINT32  Reserved:27;
+    ///
+    /// [Bit 31] If 1, Generated packets which contain IP payloads have LIP
+    /// values, which include the CS base component.
+    ///
+    UINT32  LIP:1;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX;
+
+
+/**
+  CPUID Intel Processor Trace Information Sub-leaf
+
+  @param   EAX  CPUID_INTEL_PROCEDSSOR_TRACE (0x14)
+  @param   ECX  CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF (0x01)
+
+  @retval  EAX  Returns Intel processor trace information described by the
+                type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX.
+  @retval  EBX  Returns Intel processor trace information described by the
+                type CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32                                    MaximumSubLeaf;
+  UINT32                                    SubLeaf;
+  CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX  Eax;
+  CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX  Ebx;
+
+  AsmCpuidEx (
+    CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF,
+    &MaximumSubLeaf, NULL, NULL, NULL
+    );
+
+  for (SubLeaf = CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF; SubLeaf <= MaximumSubLeaf; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_INTEL_PROCESSOR_TRACE, SubLeaf,
+      &Eax.Uint32, &Ebx.Uint32, NULL, NULL
+      );
+  }
+  @endcode
+**/
+#define CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF                0x01
+
+/**
+  CPUID Intel Processor Trace EAX for CPUID leaf #CPUID_INTEL_PROCESSOR_TRACE,
+  sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 2:0] Number of configurable Address Ranges for filtering.
+    ///
+    UINT32  ConfigurableAddressRanges:3;
+    UINT32  Reserved:13;
+    ///
+    /// [Bits 31:16] Bitmap of supported MTC period encodings
+    ///
+    UINT32  MtcPeriodEncodings:16;
+
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX;
+
+/**
+  CPUID Intel Processor Trace EBX for CPUID leaf #CPUID_INTEL_PROCESSOR_TRACE,
+  sub-leaf #CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Bitmap of supported Cycle Threshold value encodings.
+    ///
+    UINT32  CycleThresholdEncodings:16;
+    ///
+    /// [Bits 31:16] Bitmap of supported Configurable PSB frequency encodings.
+    ///
+    UINT32  PsbFrequencyEncodings:16;
+
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX;
+
+
+/**
+  CPUID Time Stamp Counter Information
+
+  @note
+  If EBX[31:0] is 0, the TSC/"core crystal clock" ratio is not enumerated.
+  EBX[31:0]/EAX[31:0] indicates the ratio of the TSC frequency and the core
+  crystal clock frequency.
+    "TSC frequency" = "core crystal clock frequency" * EBX/EAX.
+  The core crystal clock may differ from the reference clock, bus clock, or core
+  clock frequencies.
+
+  @param   EAX  CPUID_TIME_STAMP_COUNTER (0x15)
+
+  @retval  EAX  An unsigned integer which is the denominator of the
+                TSC/"core crystal clock" ratio
+  @retval  EBX  An unsigned integer which is the numerator of the
+                TSC/"core crystal clock" ratio.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32  Eax;
+  UINT32  Ebx;
+
+  AsmCpuid (CPUID_TIME_STAMP_COUNTER, &Eax, &Ebx, NULL, NULL);
+  @endcode
+**/
+#define CPUID_TIME_STAMP_COUNTER                            0x15
+
+
+/**
+  CPUID Processor Frequency Information
+
+  @note
+  Data is returned from this interface in accordance with the processor's
+  specification and does not reflect actual values. Suitable use of this data
+  includes the display of processor information in like manner to the processor
+  brand string and for determining the appropriate range to use when displaying
+  processor information e.g. frequency history graphs. The returned information
+  should not be used for any other purpose as the returned information does not
+  accurately correlate to information / counters returned by other processor
+  interfaces.  While a processor may support the Processor Frequency Information
+  leaf, fields that return a value of zero are not supported.
+
+  @param   EAX  CPUID_TIME_STAMP_COUNTER (0x16)
+
+  @retval  EAX  Returns processor base frequency information described by the
+                type CPUID_PROCESSOR_FREQUENCY_EAX.
+  @retval  EBX  Returns maximum frequency information described by the type
+                CPUID_PROCESSOR_FREQUENCY_EBX.
+  @retval  ECX  Returns bus frequency information described by the type
+                CPUID_PROCESSOR_FREQUENCY_ECX.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  CPUID_PROCESSOR_FREQUENCY_EAX  Eax;
+  CPUID_PROCESSOR_FREQUENCY_EBX  Ebx;
+  CPUID_PROCESSOR_FREQUENCY_ECX  Ecx;
+
+  AsmCpuid (CPUID_PROCESSOR_FREQUENCY, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, NULL);
+  @endcode
+**/
+#define CPUID_PROCESSOR_FREQUENCY                           0x16
+
+/**
+  CPUID Processor Frequency Information EAX for CPUID leaf
+  #CPUID_PROCESSOR_FREQUENCY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Processor Base Frequency (in MHz).
+    ///
+    UINT32  ProcessorBaseFrequency:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PROCESSOR_FREQUENCY_EAX;
+
+/**
+  CPUID Processor Frequency Information EBX for CPUID leaf
+  #CPUID_PROCESSOR_FREQUENCY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Maximum Frequency (in MHz).
+    ///
+    UINT32  MaximumFrequency:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PROCESSOR_FREQUENCY_EBX;
+
+/**
+  CPUID Processor Frequency Information ECX for CPUID leaf
+  #CPUID_PROCESSOR_FREQUENCY.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] Bus (Reference) Frequency (in MHz).
+    ///
+    UINT32  BusFrequency:16;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_PROCESSOR_FREQUENCY_ECX;
+
 
-#define CPUID_VERSION_INFO                      0x1
+/**
+  CPUID SoC Vendor Information
 
-#define CPUID_CACHE_INFO                        0x2
+  @param   EAX  CPUID_SOC_VENDOR (0x17)
+  @param   ECX  CPUID_SOC_VENDOR_MAIN_LEAF (0x00)
+                CPUID_SOC_VENDOR_BRAND_STRING1 (0x01)
+                CPUID_SOC_VENDOR_BRAND_STRING1 (0x02)
+                CPUID_SOC_VENDOR_BRAND_STRING1 (0x03)
 
-#define CPUID_SERIAL_NUMBER                     0x3
+  @note
+  Leaf 17H output depends on the initial value in ECX.  SOC Vendor Brand String
+  is a UTF-8 encoded string padded with trailing bytes of 00H.  The complete SOC
+  Vendor Brand String is constructed by concatenating in ascending order of
+  EAX:EBX:ECX:EDX and from the sub-leaf 1 fragment towards sub-leaf 3.
 
-#define CPUID_CACHE_PARAMS                      0x4
+**/
+#define CPUID_SOC_VENDOR                                    0x17
+
+/**
+  CPUID SoC Vendor Information
+
+  @param   EAX  CPUID_SOC_VENDOR (0x17)
+  @param   ECX  CPUID_SOC_VENDOR_MAIN_LEAF (0x00)
+
+  @retval  EAX  MaxSOCID_Index. Reports the maximum input value of supported
+                sub-leaf in leaf 17H.
+  @retval  EBX  Returns SoC Vendor information described by the type
+                CPUID_SOC_VENDOR_MAIN_LEAF_EBX.
+  @retval  ECX  Project ID. A unique number an SOC vendor assigns to its SOC
+                projects.
+  @retval  EDX  Stepping ID. A unique number within an SOC project that an SOC
+                vendor assigns.
+
+  <b>Example usage</b>
+  @code
+  UINT32                          Eax;
+  CPUID_SOC_VENDOR_MAIN_LEAF_EBX  Ebx;
+  UINT32                          Ecx;
+  UINT32                          Edx;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_MAIN_LEAF,
+    &Eax, &Ebx.Uint32, &Ecx, &Edx
+    );
+  @endcode
+**/
+#define CPUID_SOC_VENDOR_MAIN_LEAF                          0x00
+
+/**
+  CPUID SoC Vendor Information EBX for CPUID leaf #CPUID_SOC_VENDOR sub-leaf
+  #CPUID_SOC_VENDOR_MAIN_LEAF.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 15:0] SOC Vendor ID.
+    ///
+    UINT32  SocVendorId:16;
+    ///
+    /// [Bit 16] If 1, the SOC Vendor ID field is assigned via an industry
+    /// standard enumeration scheme. Otherwise, the SOC Vendor ID field is
+    /// assigned by Intel.
+    ///
+    UINT32  IsVendorScheme:1;
+    UINT32  Reserved:15;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_SOC_VENDOR_MAIN_LEAF_EBX;
+
+/**
+  CPUID SoC Vendor Information
+
+  @param   EAX  CPUID_SOC_VENDOR (0x17)
+  @param   ECX  CPUID_SOC_VENDOR_BRAND_STRING1 (0x01)
+
+  @retval  EAX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EBX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  ECX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EDX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Eax;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ebx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ecx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Edx;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING1,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_SOC_VENDOR_BRAND_STRING1                      0x01
+
+/**
+  CPUID SoC Vendor Brand String for CPUID leafs #CPUID_SOC_VENDOR_BRAND_STRING1,
+  #CPUID_SOC_VENDOR_BRAND_STRING2, and #CPUID_SOC_VENDOR_BRAND_STRING3.
+**/
+typedef union {
+  ///
+  /// 4 UTF-8 characters of Soc Vendor Brand String
+  ///
+  CHAR8   BrandString[4];
+  ///
+  /// All fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_SOC_VENDOR_BRAND_STRING_DATA;
+
+/**
+  CPUID SoC Vendor Information
+
+  @param   EAX  CPUID_SOC_VENDOR (0x17)
+  @param   ECX  CPUID_SOC_VENDOR_BRAND_STRING2 (0x02)
+
+  @retval  EAX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EBX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  ECX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EDX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Eax;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ebx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ecx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Edx;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING2,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_SOC_VENDOR_BRAND_STRING2                      0x02
+
+/**
+  CPUID SoC Vendor Information
+
+  @param   EAX  CPUID_SOC_VENDOR (0x17)
+  @param   ECX  CPUID_SOC_VENDOR_BRAND_STRING3 (0x03)
 
-#define CPUID_MONITOR_MWAIT                     0x5
+  @retval  EAX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EBX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  ECX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+  @retval  EDX  SOC Vendor Brand String. UTF-8 encoded string of type
+                CPUID_SOC_VENDOR_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Eax;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ebx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ecx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Edx;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING3,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  @endcode
+**/
+#define CPUID_SOC_VENDOR_BRAND_STRING3                      0x03
 
-#define CPUID_EXTENDED_TOPOLOGY                 0xB
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_INVALID  0x0
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_SMT      0x1
-#define   CPUID_EXTENDED_TOPOLOGY_LEVEL_TYPE_CORE     0x2
 
+/**
+  CPUID Extended Function
+
+  @param   EAX  CPUID_EXTENDED_FUNCTION (0x80000000)
+
+  @retval  EAX  Maximum Input Value for Extended Function CPUID Information.
+  @retval  EBX  Reserved.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  UINT32  Eax;
+
+  AsmCpuid (CPUID_EXTENDED_FUNCTION, &Eax, NULL, NULL, NULL);
+  @endcode
+**/
 #define CPUID_EXTENDED_FUNCTION                 0x80000000
 
+
+/**
+  CPUID Extended Processor Signature and Feature Bits
+
+  @param   EAX  CPUID_EXTENDED_CPU_SIG (0x80000001)
+
+  @retval  EAX  CPUID_EXTENDED_CPU_SIG.
+  @retval  EBX  Reserved.
+  @retval  ECX  Extended Processor Signature and Feature Bits information
+                described by the type CPUID_EXTENDED_CPU_SIG_ECX.
+  @retval  EDX  Extended Processor Signature and Feature Bits information
+                described by the type CPUID_EXTENDED_CPU_SIG_EDX.
+
+  <b>Example usage</b>
+  @code
+  UINT32                      Eax;
+  CPUID_EXTENDED_CPU_SIG_ECX  Ecx;
+  CPUID_EXTENDED_CPU_SIG_EDX  Edx;
+
+  AsmCpuid (CPUID_EXTENDED_CPU_SIG, &Eax, NULL, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
 #define CPUID_EXTENDED_CPU_SIG                  0x80000001
 
+/**
+  CPUID Extended Processor Signature and Feature Bits ECX for CPUID leaf
+  #CPUID_EXTENDED_CPU_SIG.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bit 0] LAHF/SAHF available in 64-bit mode.
+    ///
+    UINT32  LAHF_SAHF:1;
+    UINT32  Reserved1:4;
+    ///
+    /// [Bit 5] LZCNT.
+    ///
+    UINT32  LZCNT:1;
+    UINT32  Reserved2:2;
+    ///
+    /// [Bit 8] PREFETCHW.
+    ///
+    UINT32  PREFETCHW:1;
+    UINT32  Reserved3:23;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_CPU_SIG_ECX;
+
+/**
+  CPUID Extended Processor Signature and Feature Bits EDX for CPUID leaf
+  #CPUID_EXTENDED_CPU_SIG.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved1:11;
+    ///
+    /// [Bit 11] SYSCALL/SYSRET available in 64-bit mode.
+    ///
+    UINT32  SYSCALL_SYSRET:1;
+    UINT32  Reserved2:8;
+    ///
+    /// [Bit 20] Execute Disable Bit available.
+    ///
+    UINT32  NX:1;
+    UINT32  Reserved3:5;
+    ///
+    /// [Bit 26] 1-GByte pages are available if 1.
+    ///
+    UINT32  Page1GB:1;
+    ///
+    /// [Bit 27] RDTSCP and IA32_TSC_AUX are available if 1.
+    ///
+    UINT32  RDTSCP:1;
+    UINT32  Reserved4:1;
+    ///
+    /// [Bit 29] Intel(R) 64 Architecture available if 1.
+    ///
+    UINT32  LM:1;
+    UINT32  Reserved5:2;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_CPU_SIG_EDX;
+
+
+/**
+  CPUID Processor Brand String
+
+  @param   EAX  CPUID_BRAND_STRING1 (0x80000002)
+
+  @retval  EAX  Processor Brand String in type CPUID_BRAND_STRING_DATA.
+  @retval  EBX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  ECX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  EDX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_BRAND_STRING_DATA  Eax;
+  CPUID_BRAND_STRING_DATA  Ebx;
+  CPUID_BRAND_STRING_DATA  Ecx;
+  CPUID_BRAND_STRING_DATA  Edx;
+
+  AsmCpuid (CPUID_BRAND_STRING1, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
 #define CPUID_BRAND_STRING1                     0x80000002
 
+/**
+  CPUID Processor Brand String for CPUID leafs #CPUID_BRAND_STRING1,
+  #CPUID_BRAND_STRING2, and #CPUID_BRAND_STRING3.
+**/
+typedef union {
+  ///
+  /// 4 ASCII characters of Processor Brand String
+  ///
+  CHAR8   BrandString[4];
+  ///
+  /// All fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_BRAND_STRING_DATA;
+
+/**
+  CPUID Processor Brand String
+
+  @param   EAX  CPUID_BRAND_STRING2 (0x80000003)
+
+  @retval  EAX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  EBX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  ECX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  EDX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_BRAND_STRING_DATA  Eax;
+  CPUID_BRAND_STRING_DATA  Ebx;
+  CPUID_BRAND_STRING_DATA  Ecx;
+  CPUID_BRAND_STRING_DATA  Edx;
+
+  AsmCpuid (CPUID_BRAND_STRING2, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
 #define CPUID_BRAND_STRING2                     0x80000003
 
+/**
+  CPUID Processor Brand String
+
+  @param   EAX  CPUID_BRAND_STRING3 (0x80000004)
+
+  @retval  EAX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  EBX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  ECX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+  @retval  EDX  Processor Brand String Continued in type CPUID_BRAND_STRING_DATA.
+
+  <b>Example usage</b>
+  @code
+  CPUID_BRAND_STRING_DATA  Eax;
+  CPUID_BRAND_STRING_DATA  Ebx;
+  CPUID_BRAND_STRING_DATA  Ecx;
+  CPUID_BRAND_STRING_DATA  Edx;
+
+  AsmCpuid (CPUID_BRAND_STRING3, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+  @endcode
+**/
 #define CPUID_BRAND_STRING3                     0x80000004
 
+
+/**
+  CPUID Extended Cache information
+
+  @param   EAX  CPUID_EXTENDED_CACHE_INFO (0x80000006)
+
+  @retval  EAX  Reserved.
+  @retval  EBX  Reserved.
+  @retval  ECX  Extended cache information described by the type
+                CPUID_EXTENDED_CACHE_INFO_ECX.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  CPUID_EXTENDED_CACHE_INFO_ECX  Ecx;
+
+  AsmCpuid (CPUID_EXTENDED_CACHE_INFO, NULL, NULL, &Ecx.Uint32, NULL);
+  @endcode
+**/
+#define CPUID_EXTENDED_CACHE_INFO               0x80000006
+
+/**
+  CPUID Extended Cache information ECX for CPUID leaf #CPUID_EXTENDED_CACHE_INFO.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 7:0] Cache line size in bytes.
+    ///
+    UINT32  CacheLineSize:8;
+    UINT32  Reserved:4;
+    ///
+    /// [Bits 15:12] L2 Associativity field.  Supported values are in the range
+    /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED to
+    /// #CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL
+    ///
+    UINT32  L2Associativity:4;
+    ///
+    /// [Bits 31:16] Cache size in 1K units.
+    ///
+    UINT32  CacheSize:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_CACHE_INFO_ECX;
+
+///
+/// @{ Define value for bit field CPUID_EXTENDED_CACHE_INFO_ECX.L2Associativity
+///
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DISABLED       0x00
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_DIRECT_MAPPED  0x01
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_2_WAY          0x02
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_4_WAY          0x04
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_8_WAY          0x06
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_16_WAY         0x08
+#define CPUID_EXTENDED_CACHE_INFO_ECX_L2_ASSOCIATIVITY_FULL           0x0F
+///
+/// @}
+///
+
+/**
+  CPUID Extended Time Stamp Counter information
+
+  @param   EAX  CPUID_EXTENDED_TIME_STAMP_COUNTER (0x80000007)
+
+  @retval  EAX  Reserved.
+  @retval  EBX  Reserved.
+  @retval  ECX  Reserved.
+  @retval  EDX  Extended time stamp counter (TSC) information described by the
+                type CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX.
+
+  <b>Example usage</b>
+  @code
+  CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX  Edx;
+
+  AsmCpuid (CPUID_EXTENDED_TIME_STAMP_COUNTER, NULL, NULL, NULL, &Edx.Uint32);
+  @endcode
+**/
+#define CPUID_EXTENDED_TIME_STAMP_COUNTER       0x80000007
+
+/**
+  CPUID Extended Time Stamp Counter information EDX for CPUID leaf
+  #CPUID_EXTENDED_TIME_STAMP_COUNTER.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    UINT32  Reserved1:8;
+    ///
+    /// [Bit 8] Invariant TSC available if 1.
+    ///
+    UINT32  InvariantTsc:1;
+    UINT32  Reserved2:23;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX;
+
+
+/**
+  CPUID Linear Physical Address Size
+
+  @param   EAX  CPUID_VIR_PHY_ADDRESS_SIZE (0x80000008)
+
+  @retval  EAX  Linear/Physical Address Size described by the type
+                CPUID_VIR_PHY_ADDRESS_SIZE_EAX.
+  @retval  EBX  Reserved.
+  @retval  ECX  Reserved.
+  @retval  EDX  Reserved.
+
+  <b>Example usage</b>
+  @code
+  CPUID_VIR_PHY_ADDRESS_SIZE_EAX  Eax;
+
+  AsmCpuid (CPUID_VIR_PHY_ADDRESS_SIZE, &Eax.Uint32, NULL, NULL, NULL);
+  @endcode
+**/
 #define CPUID_VIR_PHY_ADDRESS_SIZE              0x80000008
 
+/**
+  CPUID Linear Physical Address Size EAX for CPUID leaf
+  #CPUID_VIR_PHY_ADDRESS_SIZE.
+**/
+typedef union {
+  ///
+  /// Individual bit fields
+  ///
+  struct {
+    ///
+    /// [Bits 7:0] Number of physical address bits.
+    ///
+    /// @note
+    /// If CPUID.80000008H:EAX[7:0] is supported, the maximum physical address
+    /// number supported should come from this field.
+    ///
+    UINT32  PhysicalAddressBits:8;
+    ///
+    /// [Bits 15:8] Number of linear address bits.
+    ///
+    UINT32  LinearAddressBits:8;
+    UINT32  Reserved:16;
+  } Bits;
+  ///
+  /// All bit fields as a 32-bit value
+  ///
+  UINT32  Uint32;
+} CPUID_VIR_PHY_ADDRESS_SIZE_EAX;
+
 #endif

From 6078c1d7e0954325cc95e9ef635da72204dcd29d Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Thu, 18 Feb 2016 23:16:02 -0800
Subject: [PATCH 504/525] UefiCpuPkg/Cpuid: Add UEFI CPUID application

Add UEFI application to UefiCpuPkg to display all supported CPUID
leafs and sub-leafs described by UefiCpuPkg/Include/Register/Cpuid.h
that is based on information from Intel(R) 64 and IA-32
Architectures Software Developer's Manual, Volume 2A, December
2015, CPUID instruction.

Cc: Jeff Fan <jeff.fan@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jeff Fan <jeff.fan@intel.com>
(cherry picked from commit 2570575276ab8f1f29e00c536e3d80983d5fccb1)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c        | 1353 +++++++++++++++++++
 UefiCpuPkg/Application/Cpuid/Cpuid.inf      |   48 +
 UefiCpuPkg/Application/Cpuid/Cpuid.uni      |   22 +
 UefiCpuPkg/Application/Cpuid/CpuidExtra.uni |   22 +
 UefiCpuPkg/UefiCpuPkg.dsc                   |    5 +
 5 files changed, 1450 insertions(+)
 create mode 100644 UefiCpuPkg/Application/Cpuid/Cpuid.c
 create mode 100644 UefiCpuPkg/Application/Cpuid/Cpuid.inf
 create mode 100644 UefiCpuPkg/Application/Cpuid/Cpuid.uni
 create mode 100644 UefiCpuPkg/Application/Cpuid/CpuidExtra.uni

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
new file mode 100644
index 000000000000..f82e43f563ad
--- /dev/null
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -0,0 +1,1353 @@
+/** @file
+  UEFI Application to display CPUID leaf information.
+
+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+  This program and the accompanying materials
+  are licensed and made available under the terms and conditions of the BSD License
+  which accompanies this distribution.  The full text of the license may be found at
+  http://opensource.org/licenses/bsd-license.php
+
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+**/
+
+#include <Uefi.h>
+#include <Library/BaseLib.h>
+#include <Library/UefiLib.h>
+#include <Register/Cpuid.h>
+
+///
+/// Macro used to display the value of a bit field in a register returned by CPUID.
+///
+#define PRINT_BIT_FIELD(Variable, FieldName) \
+  Print (L"%5a%42a: %x\n", #Variable, #FieldName, ##Variable.Bits.##FieldName);
+
+///
+/// Macro used to display the value of a register returned by CPUID.
+///
+#define PRINT_VALUE(Variable, Description) \
+  Print (L"%5a%42a: %x\n", #Variable, #Description, Variable);
+
+///
+/// Structure for cache description lookup table
+///
+typedef struct {
+  UINT8  CacheDescriptor;
+  CHAR8  *Type;
+  CHAR8  *Description;
+} CPUID_CACHE_INFO_DESCRIPTION;
+
+///
+/// Cache description lookup table
+///
+CPUID_CACHE_INFO_DESCRIPTION  mCpuidCacheInfoDescription[] = {
+  { 0x00 , "General"  , "Null descriptor, this byte contains no information" },
+  { 0x01 , "TLB"      , "Instruction TLB: 4 KByte pages, 4-way set associative, 32 entries" },
+  { 0x02 , "TLB"      , "Instruction TLB: 4 MByte pages, fully associative, 2 entries" },
+  { 0x03 , "TLB"      , "Data TLB: 4 KByte pages, 4-way set associative, 64 entries" },
+  { 0x04 , "TLB"      , "Data TLB: 4 MByte pages, 4-way set associative, 8 entries" },
+  { 0x05 , "TLB"      , "Data TLB1: 4 MByte pages, 4-way set associative, 32 entries" },
+  { 0x06 , "Cache"    , "1st-level instruction cache: 8 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x08 , "Cache"    , "1st-level instruction cache: 16 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x09 , "Cache"    , "1st-level instruction cache: 32KBytes, 4-way set associative, 64 byte line size" },
+  { 0x0A , "Cache"    , "1st-level data cache: 8 KBytes, 2-way set associative, 32 byte line size" },
+  { 0x0B , "TLB"      , "Instruction TLB: 4 MByte pages, 4-way set associative, 4 entries" },
+  { 0x0C , "Cache"    , "1st-level data cache: 16 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x0D , "Cache"    , "1st-level data cache: 16 KBytes, 4-way set associative, 64 byte line size" },
+  { 0x0E , "Cache"    , "1st-level data cache: 24 KBytes, 6-way set associative, 64 byte line size" },
+  { 0x1D , "Cache"    , "2nd-level cache: 128 KBytes, 2-way set associative, 64 byte line size" },
+  { 0x21 , "Cache"    , "2nd-level cache: 256 KBytes, 8-way set associative, 64 byte line size" },
+  { 0x22 , "Cache"    , "3rd-level cache: 512 KBytes, 4-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x23 , "Cache"    , "3rd-level cache: 1 MBytes, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x24 , "Cache"    , "2nd-level cache: 1 MBytes, 16-way set associative, 64 byte line size" },
+  { 0x25 , "Cache"    , "3rd-level cache: 2 MBytes, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x29 , "Cache"    , "3rd-level cache: 4 MBytes, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x2C , "Cache"    , "1st-level data cache: 32 KBytes, 8-way set associative, 64 byte line size" },
+  { 0x30 , "Cache"    , "1st-level instruction cache: 32 KBytes, 8-way set associative, 64 byte line size" },
+  { 0x40 , "Cache"    , "No 2nd-level cache or, if processor contains a valid 2nd-level cache, no 3rd-level cache" },
+  { 0x41 , "Cache"    , "2nd-level cache: 128 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x42 , "Cache"    , "2nd-level cache: 256 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x43 , "Cache"    , "2nd-level cache: 512 KBytes, 4-way set associative, 32 byte line size" },
+  { 0x44 , "Cache"    , "2nd-level cache: 1 MByte, 4-way set associative, 32 byte line size" },
+  { 0x45 , "Cache"    , "2nd-level cache: 2 MByte, 4-way set associative, 32 byte line size" },
+  { 0x46 , "Cache"    , "3rd-level cache: 4 MByte, 4-way set associative, 64 byte line size" },
+  { 0x47 , "Cache"    , "3rd-level cache: 8 MByte, 8-way set associative, 64 byte line size" },
+  { 0x48 , "Cache"    , "2nd-level cache: 3MByte, 12-way set associative, 64 byte line size" },
+  { 0x49 , "Cache"    , "3rd-level cache: 4MB, 16-way set associative, 64-byte line size (Intel Xeon processor MP, Family 0FH, Model 06H). 2nd-level cache: 4 MByte, 16-way set associative, 64 byte line size" },
+  { 0x4A , "Cache"    , "3rd-level cache: 6MByte, 12-way set associative, 64 byte line size" },
+  { 0x4B , "Cache"    , "3rd-level cache: 8MByte, 16-way set associative, 64 byte line size" },
+  { 0x4C , "Cache"    , "3rd-level cache: 12MByte, 12-way set associative, 64 byte line size" },
+  { 0x4D , "Cache"    , "3rd-level cache: 16MByte, 16-way set associative, 64 byte line size" },
+  { 0x4E , "Cache"    , "2nd-level cache: 6MByte, 24-way set associative, 64 byte line size" },
+  { 0x4F , "TLB"      , "Instruction TLB: 4 KByte pages, 32 entries" },
+  { 0x50 , "TLB"      , "Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 64 entries" },
+  { 0x51 , "TLB"      , "Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 128 entries" },
+  { 0x52 , "TLB"      , "Instruction TLB: 4 KByte and 2-MByte or 4-MByte pages, 256 entries" },
+  { 0x55 , "TLB"      , "Instruction TLB: 2-MByte or 4-MByte pages, fully associative, 7 entries" },
+  { 0x56 , "TLB"      , "Data TLB0: 4 MByte pages, 4-way set associative, 16 entries" },
+  { 0x57 , "TLB"      , "Data TLB0: 4 KByte pages, 4-way associative, 16 entries" },
+  { 0x59 , "TLB"      , "Data TLB0: 4 KByte pages, fully associative, 16 entries" },
+  { 0x5A , "TLB"      , "Data TLB0: 2-MByte or 4 MByte pages, 4-way set associative, 32 entries" },
+  { 0x5B , "TLB"      , "Data TLB: 4 KByte and 4 MByte pages, 64 entries" },
+  { 0x5C , "TLB"      , "Data TLB: 4 KByte and 4 MByte pages,128 entries" },
+  { 0x5D , "TLB"      , "Data TLB: 4 KByte and 4 MByte pages,256 entries" },
+  { 0x60 , "Cache"    , "1st-level data cache: 16 KByte, 8-way set associative, 64 byte line size" },
+  { 0x61 , "TLB"      , "Instruction TLB: 4 KByte pages, fully associative, 48 entries" },
+  { 0x63 , "TLB"      , "Data TLB: 1 GByte pages, 4-way set associative, 4 entries" },
+  { 0x66 , "Cache"    , "1st-level data cache: 8 KByte, 4-way set associative, 64 byte line size" },
+  { 0x67 , "Cache"    , "1st-level data cache: 16 KByte, 4-way set associative, 64 byte line size" },
+  { 0x68 , "Cache"    , "1st-level data cache: 32 KByte, 4-way set associative, 64 byte line size" },
+  { 0x6A , "Cache"    , "uTLB: 4 KByte pages, 8-way set associative, 64 entries" },
+  { 0x6B , "Cache"    , "DTLB: 4 KByte pages, 8-way set associative, 256 entries" },
+  { 0x6C , "Cache"    , "DTLB: 2M/4M pages, 8-way set associative, 128 entries" },
+  { 0x6D , "Cache"    , "DTLB: 1 GByte pages, fully associative, 16 entries" },
+  { 0x70 , "Cache"    , "Trace cache: 12 K-uop, 8-way set associative" },
+  { 0x71 , "Cache"    , "Trace cache: 16 K-uop, 8-way set associative" },
+  { 0x72 , "Cache"    , "Trace cache: 32 K-uop, 8-way set associative" },
+  { 0x76 , "TLB"      , "Instruction TLB: 2M/4M pages, fully associative, 8 entries" },
+  { 0x78 , "Cache"    , "2nd-level cache: 1 MByte, 4-way set associative, 64byte line size" },
+  { 0x79 , "Cache"    , "2nd-level cache: 128 KByte, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x7A , "Cache"    , "2nd-level cache: 256 KByte, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x7B , "Cache"    , "2nd-level cache: 512 KByte, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x7C , "Cache"    , "2nd-level cache: 1 MByte, 8-way set associative, 64 byte line size, 2 lines per sector" },
+  { 0x7D , "Cache"    , "2nd-level cache: 2 MByte, 8-way set associative, 64byte line size" },
+  { 0x7F , "Cache"    , "2nd-level cache: 512 KByte, 2-way set associative, 64-byte line size" },
+  { 0x80 , "Cache"    , "2nd-level cache: 512 KByte, 8-way set associative, 64-byte line size" },
+  { 0x82 , "Cache"    , "2nd-level cache: 256 KByte, 8-way set associative, 32 byte line size" },
+  { 0x83 , "Cache"    , "2nd-level cache: 512 KByte, 8-way set associative, 32 byte line size" },
+  { 0x84 , "Cache"    , "2nd-level cache: 1 MByte, 8-way set associative, 32 byte line size" },
+  { 0x85 , "Cache"    , "2nd-level cache: 2 MByte, 8-way set associative, 32 byte line size" },
+  { 0x86 , "Cache"    , "2nd-level cache: 512 KByte, 4-way set associative, 64 byte line size" },
+  { 0x87 , "Cache"    , "2nd-level cache: 1 MByte, 8-way set associative, 64 byte line size" },
+  { 0xA0 , "DTLB"     , "DTLB: 4k pages, fully associative, 32 entries" },
+  { 0xB0 , "TLB"      , "Instruction TLB: 4 KByte pages, 4-way set associative, 128 entries" },
+  { 0xB1 , "TLB"      , "Instruction TLB: 2M pages, 4-way, 8 entries or 4M pages, 4-way, 4 entries" },
+  { 0xB2 , "TLB"      , "Instruction TLB: 4KByte pages, 4-way set associative, 64 entries" },
+  { 0xB3 , "TLB"      , "Data TLB: 4 KByte pages, 4-way set associative, 128 entries" },
+  { 0xB4 , "TLB"      , "Data TLB1: 4 KByte pages, 4-way associative, 256 entries" },
+  { 0xB5 , "TLB"      , "Instruction TLB: 4KByte pages, 8-way set associative, 64 entries" },
+  { 0xB6 , "TLB"      , "Instruction TLB: 4KByte pages, 8-way set associative, 128 entries" },
+  { 0xBA , "TLB"      , "Data TLB1: 4 KByte pages, 4-way associative, 64 entries" },
+  { 0xC0 , "TLB"      , "Data TLB: 4 KByte and 4 MByte pages, 4-way associative, 8 entries" },
+  { 0xC1 , "STLB"     , "Shared 2nd-Level TLB: 4 KByte/2MByte pages, 8-way associative, 1024 entries" },
+  { 0xC2 , "DTLB"     , "DTLB: 4 KByte/2 MByte pages, 4-way associative, 16 entries" },
+  { 0xC3 , "STLB"     , "Shared 2nd-Level TLB: 4 KByte /2 MByte pages, 6-way associative, 1536 entries. Also 1GBbyte pages, 4-way, 16 entries." },
+  { 0xCA , "STLB"     , "Shared 2nd-Level TLB: 4 KByte pages, 4-way associative, 512 entries" },
+  { 0xD0 , "Cache"    , "3rd-level cache: 512 KByte, 4-way set associative, 64 byte line size" },
+  { 0xD1 , "Cache"    , "3rd-level cache: 1 MByte, 4-way set associative, 64 byte line size" },
+  { 0xD2 , "Cache"    , "3rd-level cache: 2 MByte, 4-way set associative, 64 byte line size" },
+  { 0xD6 , "Cache"    , "3rd-level cache: 1 MByte, 8-way set associative, 64 byte line size" },
+  { 0xD7 , "Cache"    , "3rd-level cache: 2 MByte, 8-way set associative, 64 byte line size" },
+  { 0xD8 , "Cache"    , "3rd-level cache: 4 MByte, 8-way set associative, 64 byte line size" },
+  { 0xDC , "Cache"    , "3rd-level cache: 1.5 MByte, 12-way set associative, 64 byte line size" },
+  { 0xDD , "Cache"    , "3rd-level cache: 3 MByte, 12-way set associative, 64 byte line size" },
+  { 0xDE , "Cache"    , "3rd-level cache: 6 MByte, 12-way set associative, 64 byte line size" },
+  { 0xE2 , "Cache"    , "3rd-level cache: 2 MByte, 16-way set associative, 64 byte line size" },
+  { 0xE3 , "Cache"    , "3rd-level cache: 4 MByte, 16-way set associative, 64 byte line size" },
+  { 0xE4 , "Cache"    , "3rd-level cache: 8 MByte, 16-way set associative, 64 byte line size" },
+  { 0xEA , "Cache"    , "3rd-level cache: 12MByte, 24-way set associative, 64 byte line size" },
+  { 0xEB , "Cache"    , "3rd-level cache: 18MByte, 24-way set associative, 64 byte line size" },
+  { 0xEC , "Cache"    , "3rd-level cache: 24MByte, 24-way set associative, 64 byte line size" },
+  { 0xF0 , "Prefetch" , "64-Byte prefetching" },
+  { 0xF1 , "Prefetch" , "128-Byte prefetching" },
+  { 0xFF , "General"  , "CPUID leaf 2 does not report cache descriptor information, use CPUID leaf 4 to query cache parameters" }
+};
+
+///
+/// The maximum supported CPUID leaf index starting from leaf 0x00000000.
+///
+UINT32  gMaximumBasicFunction    = CPUID_SIGNATURE;
+
+///
+/// The maximum supported CPUID leaf index starting from leaf 0x80000000.
+///
+UINT32  gMaximumExtendedFunction = CPUID_EXTENDED_FUNCTION;
+
+/**
+  Display CPUID_SIGNATURE leaf.
+
+**/
+VOID
+CpuidSignature (
+  VOID
+  )
+{
+  UINT32 Eax;
+  UINT32 Ebx;
+  UINT32 Ecx;
+  UINT32 Edx;
+  CHAR8  Signature[13];
+
+  if (CPUID_SIGNATURE > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_SIGNATURE, &Eax, &Ebx, &Ecx, &Edx);
+
+  Print (L"CPUID_SIGNATURE (Leaf %08x)\n", CPUID_SIGNATURE);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx, Ecx, Edx);
+  PRINT_VALUE (Eax, MaximumLeaf);
+  *(UINT32 *)(Signature + 0) = Ebx;
+  *(UINT32 *)(Signature + 4) = Edx;
+  *(UINT32 *)(Signature + 8) = Ecx;
+  Signature [12] = 0;
+  Print (L"  Signature = %a\n", Signature);
+
+  gMaximumBasicFunction = Eax;
+}
+
+/**
+  Display CPUID_VERSION_INFO leaf.
+
+**/
+VOID
+CpuidVersionInfo (
+  VOID
+  )
+{
+  CPUID_VERSION_INFO_EAX  Eax;
+  CPUID_VERSION_INFO_EBX  Ebx;
+  CPUID_VERSION_INFO_ECX  Ecx;
+  CPUID_VERSION_INFO_EDX  Edx;
+  UINTN                   DisplayFamily;
+  UINTN                   DisplayModel;
+
+  if (CPUID_VERSION_INFO > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+
+  Print (L"CPUID_VERSION_INFO (Leaf %08x)\n", CPUID_VERSION_INFO);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+
+  DisplayFamily = Eax.Bits.FamilyId;
+  if (Eax.Bits.FamilyId == 0x0F) {
+    DisplayFamily |= (Eax.Bits.ExtendedFamilyId << 4);
+  }
+
+  DisplayModel = Eax.Bits.Model;
+  if (Eax.Bits.FamilyId == 0x06 || Eax.Bits.FamilyId == 0x0f) {
+    DisplayModel |= (Eax.Bits.ExtendedModelId << 4);
+  }
+
+  Print (L"  Family = %x  Model = %x  Stepping = %x\n", DisplayFamily, DisplayModel, Eax.Bits.SteppingId);
+
+  PRINT_BIT_FIELD (Eax, SteppingId);
+  PRINT_BIT_FIELD (Eax, Model);
+  PRINT_BIT_FIELD (Eax, FamilyId);
+  PRINT_BIT_FIELD (Eax, ProcessorType);
+  PRINT_BIT_FIELD (Eax, ExtendedModelId);
+  PRINT_BIT_FIELD (Eax, ExtendedFamilyId);
+  PRINT_BIT_FIELD (Ebx, BrandIndex);
+  PRINT_BIT_FIELD (Ebx, CacheLineSize);
+  PRINT_BIT_FIELD (Ebx, MaximumAddressableIdsForLogicalProcessors);
+  PRINT_BIT_FIELD (Ebx, InitialLocalApicId);
+  PRINT_BIT_FIELD (Ecx, SSE3);
+  PRINT_BIT_FIELD (Ecx, PCLMULQDQ);
+  PRINT_BIT_FIELD (Ecx, DTES64);
+  PRINT_BIT_FIELD (Ecx, MONITOR);
+  PRINT_BIT_FIELD (Ecx, DS_CPL);
+  PRINT_BIT_FIELD (Ecx, VMX);
+  PRINT_BIT_FIELD (Ecx, SMX);
+  PRINT_BIT_FIELD (Ecx, TM2);
+  PRINT_BIT_FIELD (Ecx, SSSE3);
+  PRINT_BIT_FIELD (Ecx, CNXT_ID);
+  PRINT_BIT_FIELD (Ecx, SDBG);
+  PRINT_BIT_FIELD (Ecx, FMA);
+  PRINT_BIT_FIELD (Ecx, CMPXCHG16B);
+  PRINT_BIT_FIELD (Ecx, xTPR_Update_Control);
+  PRINT_BIT_FIELD (Ecx, PDCM);
+  PRINT_BIT_FIELD (Ecx, PCID);
+  PRINT_BIT_FIELD (Ecx, DCA);
+  PRINT_BIT_FIELD (Ecx, SSE4_1);
+  PRINT_BIT_FIELD (Ecx, SSE4_2);
+  PRINT_BIT_FIELD (Ecx, x2APIC);
+  PRINT_BIT_FIELD (Ecx, MOVBE);
+  PRINT_BIT_FIELD (Ecx, POPCNT);
+  PRINT_BIT_FIELD (Ecx, TSC_Deadline);
+  PRINT_BIT_FIELD (Ecx, AESNI);
+  PRINT_BIT_FIELD (Ecx, XSAVE);
+  PRINT_BIT_FIELD (Ecx, OSXSAVE);
+  PRINT_BIT_FIELD (Ecx, AVX);
+  PRINT_BIT_FIELD (Ecx, F16C);
+  PRINT_BIT_FIELD (Ecx, RDRAND);
+  PRINT_BIT_FIELD (Edx, FPU);
+  PRINT_BIT_FIELD (Edx, VME);
+  PRINT_BIT_FIELD (Edx, DE);
+  PRINT_BIT_FIELD (Edx, PSE);
+  PRINT_BIT_FIELD (Edx, TSC);
+  PRINT_BIT_FIELD (Edx, MSR);
+  PRINT_BIT_FIELD (Edx, PAE);
+  PRINT_BIT_FIELD (Edx, MCE);
+  PRINT_BIT_FIELD (Edx, CX8);
+  PRINT_BIT_FIELD (Edx, APIC);
+  PRINT_BIT_FIELD (Edx, SEP);
+  PRINT_BIT_FIELD (Edx, MTRR);
+  PRINT_BIT_FIELD (Edx, PGE);
+  PRINT_BIT_FIELD (Edx, MCA);
+  PRINT_BIT_FIELD (Edx, CMOV);
+  PRINT_BIT_FIELD (Edx, PAT);
+  PRINT_BIT_FIELD (Edx, PSE_36);
+  PRINT_BIT_FIELD (Edx, PSN);
+  PRINT_BIT_FIELD (Edx, CLFSH);
+  PRINT_BIT_FIELD (Edx, DS);
+  PRINT_BIT_FIELD (Edx, ACPI);
+  PRINT_BIT_FIELD (Edx, MMX);
+  PRINT_BIT_FIELD (Edx, FXSR);
+  PRINT_BIT_FIELD (Edx, SSE);
+  PRINT_BIT_FIELD (Edx, SSE2);
+  PRINT_BIT_FIELD (Edx, SS);
+  PRINT_BIT_FIELD (Edx, HTT);
+  PRINT_BIT_FIELD (Edx, TM);
+  PRINT_BIT_FIELD (Edx, PBE);
+}
+
+/**
+  Lookup a cache description string from the mCpuidCacheInfoDescription table.
+
+  @param[in] CacheDescriptor  Cache descriptor value from CPUID_CACHE_INFO.
+
+**/
+CPUID_CACHE_INFO_DESCRIPTION *
+LookupCacheDescription (
+  UINT8  CacheDescriptor
+  )
+{
+  UINTN  NumDescriptors;
+  UINTN  Descriptor;
+
+  if (CacheDescriptor == 0x00) {
+    return NULL;
+  }
+  NumDescriptors = sizeof (mCpuidCacheInfoDescription)/sizeof (mCpuidCacheInfoDescription[0]);
+  for (Descriptor = 0; Descriptor < NumDescriptors; Descriptor++) {
+    if (CacheDescriptor == mCpuidCacheInfoDescription[Descriptor].CacheDescriptor) {
+      return &mCpuidCacheInfoDescription[Descriptor];
+    }
+  }
+  return NULL;
+}
+
+/**
+  Display CPUID_CACHE_INFO leaf for each supported cache descriptor.
+
+**/
+VOID
+CpuidCacheInfo (
+  VOID
+  )
+{
+  CPUID_CACHE_INFO_CACHE_TLB    Eax;
+  CPUID_CACHE_INFO_CACHE_TLB    Ebx;
+  CPUID_CACHE_INFO_CACHE_TLB    Ecx;
+  CPUID_CACHE_INFO_CACHE_TLB    Edx;
+  UINTN                         Index;
+  CPUID_CACHE_INFO_DESCRIPTION  *CacheDescription;
+
+  if (CPUID_CACHE_INFO > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_CACHE_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+
+  Print (L"CPUID_CACHE_INFO (Leaf %08x)\n", CPUID_CACHE_INFO);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+  if (Eax.Bits.NotValid == 0) {
+    //
+    // Process Eax.CacheDescriptor[1..3].  Ignore Eax.CacheDescriptor[0]
+    //
+    for (Index = 1; Index < 4; Index++) {
+      CacheDescription = LookupCacheDescription (Eax.CacheDescriptor[Index]);
+      if (CacheDescription != NULL) {
+        Print (L"  %-8a %a\n",
+          CacheDescription->Type,
+          CacheDescription->Description
+          );
+      }
+    }
+  }
+  if (Ebx.Bits.NotValid == 0) {
+    //
+    // Process Ebx.CacheDescriptor[0..3]
+    //
+    for (Index = 0; Index < 4; Index++) {
+      CacheDescription = LookupCacheDescription (Ebx.CacheDescriptor[Index]);
+      if (CacheDescription != NULL) {
+        Print (L"  %-8a %a\n",
+          CacheDescription->Type,
+          CacheDescription->Description
+          );
+      }
+    }
+  }
+  if (Ecx.Bits.NotValid == 0) {
+    //
+    // Process Ecx.CacheDescriptor[0..3]
+    //
+    for (Index = 0; Index < 4; Index++) {
+      CacheDescription = LookupCacheDescription (Ecx.CacheDescriptor[Index]);
+      if (CacheDescription != NULL) {
+        Print (L"  %-8a %a\n",
+          CacheDescription->Type,
+          CacheDescription->Description
+          );
+      }
+    }
+  }
+  if (Edx.Bits.NotValid == 0) {
+    //
+    // Process Edx.CacheDescriptor[0..3]
+    //
+    for (Index = 0; Index < 4; Index++) {
+      CacheDescription = LookupCacheDescription (Edx.CacheDescriptor[Index]);
+      if (CacheDescription != NULL) {
+        Print (L"  %-8a %a\n",
+          CacheDescription->Type,
+          CacheDescription->Description
+          );
+      }
+    }
+  }
+}
+
+/**
+  Display CPUID_SERIAL_NUMBER leaf if it is supported.
+
+**/
+VOID
+CpuidSerialNumber (
+  VOID
+  )
+{
+  CPUID_VERSION_INFO_EDX  VersionInfoEdx;
+  UINT32                  Ecx;
+  UINT32                  Edx;
+
+  Print (L"CPUID_SERIAL_NUMBER (Leaf %08x)\n", CPUID_SERIAL_NUMBER);
+
+  if (CPUID_SERIAL_NUMBER > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_VERSION_INFO, NULL, NULL, NULL, &VersionInfoEdx.Uint32);
+  if (VersionInfoEdx.Bits.PSN == 0) {
+    Print (L"  Not Supported\n");
+    return;
+  }
+
+  AsmCpuid (CPUID_SERIAL_NUMBER, NULL, NULL, &Ecx, &Edx);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, 0, Ecx, Edx);
+  Print (L"  Processor Serial Number = %08x%08x%08x\n", 0, Edx, Ecx);
+}
+
+/**
+  Display CPUID_CACHE_PARAMS for all supported sub-leafs.
+
+**/
+VOID
+CpuidCacheParams (
+  VOID
+  )
+{
+  UINT32                  CacheLevel;
+  CPUID_CACHE_PARAMS_EAX  Eax;
+  CPUID_CACHE_PARAMS_EBX  Ebx;
+  UINT32                  Ecx;
+  CPUID_CACHE_PARAMS_EDX  Edx;
+
+  if (CPUID_CACHE_PARAMS > gMaximumBasicFunction) {
+    return;
+  }
+
+  CacheLevel = 0;
+  do {
+    AsmCpuidEx (
+      CPUID_CACHE_PARAMS, CacheLevel,
+      &Eax.Uint32, &Ebx.Uint32, &Ecx, &Edx.Uint32
+      );
+    if (Eax.Bits.CacheType != CPUID_CACHE_PARAMS_CACHE_TYPE_NULL) {
+      Print (L"CPUID_CACHE_PARAMS (Leaf %08x, Sub-Leaf %08x)\n", CPUID_CACHE_PARAMS, CacheLevel);
+      Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx, Edx.Uint32);
+      PRINT_BIT_FIELD (Eax, CacheType);
+      PRINT_BIT_FIELD (Eax, CacheLevel);
+      PRINT_BIT_FIELD (Eax, SelfInitializingCache);
+      PRINT_BIT_FIELD (Eax, FullyAssociativeCache);
+      PRINT_BIT_FIELD (Eax, MaximumAddressableIdsForLogicalProcessors);
+      PRINT_BIT_FIELD (Eax, MaximumAddressableIdsForProcessorCores);
+      PRINT_BIT_FIELD (Ebx, LineSize);
+      PRINT_BIT_FIELD (Ebx, LinePartitions);
+      PRINT_BIT_FIELD (Ebx, Ways);
+      PRINT_VALUE     (Ecx, NumberOfSets);
+      PRINT_BIT_FIELD (Edx, Invalidate);
+      PRINT_BIT_FIELD (Edx, CacheInclusiveness);
+      PRINT_BIT_FIELD (Edx, ComplexCacheIndexing);
+    }
+    CacheLevel++;
+  } while (Eax.Bits.CacheType != CPUID_CACHE_PARAMS_CACHE_TYPE_NULL);
+}
+
+/**
+  Display CPUID_MONITOR_MWAIT leaf.
+
+**/
+VOID
+CpuidMonitorMwait (
+  VOID
+  )
+{
+  CPUID_MONITOR_MWAIT_EAX  Eax;
+  CPUID_MONITOR_MWAIT_EBX  Ebx;
+  CPUID_MONITOR_MWAIT_ECX  Ecx;
+  CPUID_MONITOR_MWAIT_EDX  Edx;
+
+  if (CPUID_MONITOR_MWAIT > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_MONITOR_MWAIT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+
+  Print (L"CPUID_MONITOR_MWAIT (Leaf %08x)\n", CPUID_MONITOR_MWAIT);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+
+  PRINT_BIT_FIELD (Eax, SmallestMonitorLineSize);
+  PRINT_BIT_FIELD (Ebx, LargestMonitorLineSize);
+  PRINT_BIT_FIELD (Ecx, ExtensionsSupported);
+  PRINT_BIT_FIELD (Ecx, InterruptAsBreak);
+  PRINT_BIT_FIELD (Edx, C0States);
+  PRINT_BIT_FIELD (Edx, C1States);
+  PRINT_BIT_FIELD (Edx, C2States);
+  PRINT_BIT_FIELD (Edx, C3States);
+  PRINT_BIT_FIELD (Edx, C4States);
+  PRINT_BIT_FIELD (Edx, C5States);
+  PRINT_BIT_FIELD (Edx, C6States);
+  PRINT_BIT_FIELD (Edx, C7States);
+}
+
+/**
+  Display CPUID_THERMAL_POWER_MANAGEMENT leaf.
+
+**/
+VOID
+CpuidThermalPowerManagement (
+  VOID
+  )
+{
+  CPUID_THERMAL_POWER_MANAGEMENT_EAX  Eax;
+  CPUID_THERMAL_POWER_MANAGEMENT_EBX  Ebx;
+  CPUID_THERMAL_POWER_MANAGEMENT_ECX  Ecx;
+
+  if (CPUID_THERMAL_POWER_MANAGEMENT > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_THERMAL_POWER_MANAGEMENT, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, NULL);
+
+  Print (L"CPUID_THERMAL_POWER_MANAGEMENT (Leaf %08x)\n", CPUID_THERMAL_POWER_MANAGEMENT);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, 0);
+
+  PRINT_BIT_FIELD (Eax, DigitalTemperatureSensor);
+  PRINT_BIT_FIELD (Eax, TurboBoostTechnology);
+  PRINT_BIT_FIELD (Eax, ARAT);
+  PRINT_BIT_FIELD (Eax, PLN);
+  PRINT_BIT_FIELD (Eax, ECMD);
+  PRINT_BIT_FIELD (Eax, PTM);
+  PRINT_BIT_FIELD (Eax, HWP);
+  PRINT_BIT_FIELD (Eax, HWP_Notification);
+  PRINT_BIT_FIELD (Eax, HWP_Activity_Window);
+  PRINT_BIT_FIELD (Eax, HWP_Energy_Performance_Preference);
+  PRINT_BIT_FIELD (Eax, HWP_Package_Level_Request);
+  PRINT_BIT_FIELD (Eax, HDC);
+  PRINT_BIT_FIELD (Ebx, InterruptThresholds);
+  PRINT_BIT_FIELD (Ecx, HardwareCoordinationFeedback);
+  PRINT_BIT_FIELD (Ecx, PerformanceEnergyBias);
+}
+
+/**
+  Display CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS for all supported sub-leafs.
+
+**/
+VOID
+CpuidStructuredExtendedFeatureFlags (
+  VOID
+  )
+{
+  UINT32                                       Eax;
+  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_EBX  Ebx;
+  CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_ECX  Ecx;
+  UINT32                                       SubLeaf;
+
+  if (CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS,
+    CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS_SUB_LEAF_INFO,
+    &Eax, NULL, NULL, NULL
+    );
+  for (SubLeaf = 0; SubLeaf <= Eax; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS,
+      SubLeaf,
+      NULL, &Ebx.Uint32, &Ecx.Uint32, NULL
+      );
+    if (Ebx.Uint32 != 0 || Ecx.Uint32 != 0) {
+      Print (L"CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS (Leaf %08x, Sub-Leaf %08x)\n", CPUID_STRUCTURED_EXTENDED_FEATURE_FLAGS, SubLeaf);
+      Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx.Uint32, Ecx.Uint32, 0);
+      PRINT_BIT_FIELD (Ebx, FSGSBASE);
+      PRINT_BIT_FIELD (Ebx, IA32_TSC_ADJUST);
+      PRINT_BIT_FIELD (Ebx, BMI1);
+      PRINT_BIT_FIELD (Ebx, HLE);
+      PRINT_BIT_FIELD (Ebx, AVX2);
+      PRINT_BIT_FIELD (Ebx, FDP_EXCPTN_ONLY);
+      PRINT_BIT_FIELD (Ebx, SMEP);
+      PRINT_BIT_FIELD (Ebx, BMI2);
+      PRINT_BIT_FIELD (Ebx, EnhancedRepMovsbStosb);
+      PRINT_BIT_FIELD (Ebx, INVPCID);
+      PRINT_BIT_FIELD (Ebx, RTM);
+      PRINT_BIT_FIELD (Ebx, PQM);
+      PRINT_BIT_FIELD (Ebx, DeprecateFpuCsDs);
+      PRINT_BIT_FIELD (Ebx, MPX);
+      PRINT_BIT_FIELD (Ebx, PQE);
+      PRINT_BIT_FIELD (Ebx, RDSEED);
+      PRINT_BIT_FIELD (Ebx, ADX);
+      PRINT_BIT_FIELD (Ebx, SMAP);
+      PRINT_BIT_FIELD (Ebx, CLFLUSHOPT);
+      PRINT_BIT_FIELD (Ebx, IntelProcessorTrace);
+      PRINT_BIT_FIELD (Ecx, PREFETCHWT1);
+      PRINT_BIT_FIELD (Ecx, PKU);
+      PRINT_BIT_FIELD (Ecx, OSPKE);
+    }
+    SubLeaf++;
+  } while (SubLeaf <= Eax);
+}
+
+/**
+  Display CPUID_DIRECT_CACHE_ACCESS_INFO leaf.
+
+**/
+VOID
+CpuidDirectCacheAccessInfo (
+  VOID
+  )
+{
+  UINT32  Eax;
+
+  if (CPUID_DIRECT_CACHE_ACCESS_INFO > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_DIRECT_CACHE_ACCESS_INFO, &Eax, NULL, NULL, NULL);
+  Print (L"CPUID_DIRECT_CACHE_ACCESS_INFO (Leaf %08x)\n", CPUID_DIRECT_CACHE_ACCESS_INFO);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, 0, 0, 0);
+}
+
+/**
+  Display CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING leaf.
+
+**/
+VOID
+CpuidArchitecturalPerformanceMonitoring (
+  VOID
+  )
+{
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EAX  Eax;
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EBX  Ebx;
+  CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING_EDX  Edx;
+
+  if (CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING, &Eax.Uint32, &Ebx.Uint32, NULL, &Edx.Uint32);
+  Print (L"CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING (Leaf %08x)\n", CPUID_ARCHITECTURAL_PERFORMANCE_MONITORING);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, 0, Edx.Uint32);
+  PRINT_BIT_FIELD (Eax, ArchPerfMonVerID);
+  PRINT_BIT_FIELD (Eax, PerformanceMonitorCounters);
+  PRINT_BIT_FIELD (Eax, PerformanceMonitorCounterWidth);
+  PRINT_BIT_FIELD (Eax, EbxBitVectorLength);
+  PRINT_BIT_FIELD (Ebx, UnhaltedCoreCycles);
+  PRINT_BIT_FIELD (Ebx, InstructionsRetired);
+  PRINT_BIT_FIELD (Ebx, UnhaltedReferenceCycles);
+  PRINT_BIT_FIELD (Ebx, LastLevelCacheReferences);
+  PRINT_BIT_FIELD (Ebx, LastLevelCacheMisses);
+  PRINT_BIT_FIELD (Ebx, BranchInstructionsRetired);
+  PRINT_BIT_FIELD (Ebx, AllBranchMispredictRetired);
+  PRINT_BIT_FIELD (Edx, FixedFunctionPerformanceCounters);
+  PRINT_BIT_FIELD (Edx, FixedFunctionPerformanceCounterWidth);
+}
+
+/**
+  Display CPUID_EXTENDED_TOPOLOGY leafs for all supported levels.
+
+**/
+VOID
+CpuidExtendedTopology (
+  VOID
+  )
+{
+  CPUID_EXTENDED_TOPOLOGY_EAX  Eax;
+  CPUID_EXTENDED_TOPOLOGY_EBX  Ebx;
+  CPUID_EXTENDED_TOPOLOGY_ECX  Ecx;
+  UINT32                       Edx;
+  UINT32                       LevelNumber;
+
+  if (CPUID_EXTENDED_TOPOLOGY > gMaximumBasicFunction) {
+    return;
+  }
+
+  LevelNumber = 0;
+  do {
+    AsmCpuidEx (
+      CPUID_EXTENDED_TOPOLOGY, LevelNumber,
+      &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx
+      );
+    if (Eax.Bits.ApicIdShift != 0) {
+      Print (L"CPUID_EXTENDED_TOPOLOGY (Leaf %08x, Sub-Leaf %08x)\n", CPUID_EXTENDED_TOPOLOGY, LevelNumber);
+      Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx);
+      PRINT_BIT_FIELD (Eax, ApicIdShift);
+      PRINT_BIT_FIELD (Ebx, LogicalProcessors);
+      PRINT_BIT_FIELD (Ecx, LevelNumber);
+      PRINT_BIT_FIELD (Ecx, LevelType);
+      PRINT_VALUE     (Edx, x2APIC_ID);
+    }
+    LevelNumber++;
+  } while (Eax.Bits.ApicIdShift != 0);
+}
+
+/**
+  Display CPUID_EXTENDED_STATE sub-leaf.
+
+**/
+VOID
+CpuidExtendedStateSubLeaf (
+  VOID
+  )
+{
+  CPUID_EXTENDED_STATE_SUB_LEAF_EAX  Eax;
+  UINT32                             Ebx;
+  CPUID_EXTENDED_STATE_SUB_LEAF_ECX  Ecx;
+  UINT32                             Edx;
+
+  AsmCpuidEx (
+    CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_SUB_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx
+    );
+  Print (L"CPUID_EXTENDED_STATE (Leaf %08x, Sub-Leaf %08x)\n", CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_SUB_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx, Ecx.Uint32, Edx);
+  PRINT_BIT_FIELD (Eax, XSAVEOPT);
+  PRINT_BIT_FIELD (Eax, XSAVEC);
+  PRINT_BIT_FIELD (Eax, XGETBV);
+  PRINT_BIT_FIELD (Eax, XSAVES);
+  PRINT_VALUE     (Ebx, EnabledSaveStateSize_XCR0_IA32_XSS);
+  PRINT_BIT_FIELD (Ecx, XCR0);
+  PRINT_BIT_FIELD (Ecx, PT);
+  PRINT_BIT_FIELD (Ecx, XCR0_1);
+  PRINT_VALUE     (Edx, IA32_XSS_Supported_32_63);
+}
+
+/**
+  Display CPUID_EXTENDED_STATE size and offset information sub-leaf.
+
+**/
+VOID
+CpuidExtendedStateSizeOffset (
+  VOID
+  )
+{
+  UINT32                                Eax;
+  UINT32                                Ebx;
+  CPUID_EXTENDED_STATE_SIZE_OFFSET_ECX  Ecx;
+  UINT32                                Edx;
+  UINT32                                SubLeaf;
+
+  for (SubLeaf = CPUID_EXTENDED_STATE_SIZE_OFFSET; SubLeaf < 32; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_EXTENDED_STATE, SubLeaf,
+      &Eax, &Ebx, &Ecx.Uint32, &Edx
+      );
+    if (Edx != 0) {
+      Print (L"CPUID_EXTENDED_STATE (Leaf %08x, Sub-Leaf %08x)\n", CPUID_EXTENDED_STATE, SubLeaf);
+      Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx, Ecx.Uint32, Edx);
+      PRINT_VALUE     (Eax, FeatureSaveStateSize);
+      PRINT_VALUE     (Ebx, FeatureSaveStateOffset);
+      PRINT_BIT_FIELD (Ecx, XSS);
+      PRINT_BIT_FIELD (Ecx, Compacted);
+    }
+  }
+}
+
+/**
+  Display CPUID_EXTENDED_STATE main leaf and sub-leafs.
+
+**/
+VOID
+CpuidExtendedStateMainLeaf (
+  VOID
+  )
+{
+  CPUID_EXTENDED_STATE_MAIN_LEAF_EAX  Eax;
+  UINT32                              Ebx;
+  UINT32                              Ecx;
+  UINT32                              Edx;
+
+  if (CPUID_EXTENDED_STATE > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_MAIN_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx, &Edx
+    );
+  Print (L"CPUID_EXTENDED_STATE (Leaf %08x, Sub-Leaf %08x)\n", CPUID_EXTENDED_STATE, CPUID_EXTENDED_STATE_MAIN_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx, Ecx, Edx);
+  PRINT_BIT_FIELD (Eax, x87);
+  PRINT_BIT_FIELD (Eax, SSE);
+  PRINT_BIT_FIELD (Eax, AVX);
+  PRINT_BIT_FIELD (Eax, MPX);
+  PRINT_BIT_FIELD (Eax, AVX_512);
+  PRINT_BIT_FIELD (Eax, IA32_XSS);
+  PRINT_BIT_FIELD (Eax, PKRU);
+  PRINT_VALUE     (Ebx, EnabledSaveStateSize);
+  PRINT_VALUE     (Ecx, SupportedSaveStateSize);
+  PRINT_VALUE     (Edx, XCR0_Supported_32_63);
+
+  CpuidExtendedStateSubLeaf ();
+  CpuidExtendedStateSizeOffset ();
+}
+
+/**
+  Display CPUID_PLATFORM_QOS_MONITORING enumeration sub-leaf.
+
+**/
+VOID
+CpuidPlatformQosMonitoringEnumerationSubLeaf (
+  VOID
+  )
+{
+  UINT32                                                  Ebx;
+  CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF_EDX  Edx;
+
+  if (CPUID_PLATFORM_QOS_MONITORING > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF,
+    NULL, &Ebx, NULL, &Edx.Uint32
+    );
+  Print (L"CPUID_PLATFORM_QOS_MONITORING (Leaf %08x, Sub-Leaf %08x)\n", CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_ENUMERATION_SUB_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, Ebx, 0, Edx.Uint32);
+  PRINT_VALUE     (Ebx, Maximum_RMID_Range);
+  PRINT_BIT_FIELD (Edx, L3CacheQosEnforcement);
+}
+
+/**
+  Display CPUID_PLATFORM_QOS_MONITORING capability sub-leaf.
+
+**/
+VOID
+CpuidPlatformQosMonitoringCapabilitySubLeaf (
+  VOID
+  )
+{
+  UINT32                                                 Ebx;
+  UINT32                                                 Ecx;
+  CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF_EDX  Edx;
+
+  if (CPUID_PLATFORM_QOS_MONITORING > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF,
+    NULL, &Ebx, &Ecx, &Edx.Uint32
+    );
+  Print (L"CPUID_PLATFORM_QOS_MONITORING (Leaf %08x, Sub-Leaf %08x)\n", CPUID_PLATFORM_QOS_MONITORING, CPUID_PLATFORM_QOS_MONITORING_CAPABILITY_SUB_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, Ebx, Ecx, Edx.Uint32);
+  PRINT_VALUE     (Ebx, OccupancyConversionFactor);
+  PRINT_VALUE     (Ecx, Maximum_RMID_Range);
+  PRINT_BIT_FIELD (Edx, L3CacheOccupancyMonitoring);
+}
+
+/**
+  Display CPUID_PLATFORM_QOS_ENFORCEMENT sub-leaf.
+
+**/
+VOID
+CpuidPlatformQosEnforcementResidSubLeaf (
+  VOID
+  )
+{
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EAX Eax;
+  UINT32                                            Ebx;
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_ECX Ecx;
+  CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF_EDX Edx;
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF,
+    &Eax.Uint32, &Ebx, &Ecx.Uint32, &Edx.Uint32
+    );
+  Print (L"CPUID_PLATFORM_QOS_ENFORCEMENT (Leaf %08x, Sub-Leaf %08x)\n", CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_RESID_SUB_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx, Ecx.Uint32, Edx.Uint32);
+  PRINT_BIT_FIELD (Eax, CapacityLength);
+  PRINT_VALUE     (Ebx, AllocationUnitBitMap);
+  PRINT_BIT_FIELD (Ecx, CosUpdatesInfrequent);
+  PRINT_BIT_FIELD (Ecx, CodeDataPrioritization);
+  PRINT_BIT_FIELD (Edx, HighestCosNumber);
+}
+
+/**
+  Display CPUID_PLATFORM_QOS_ENFORCEMENT main leaf and sub-leaf.
+
+**/
+VOID
+CpuidPlatformQosEnforcementMainLeaf (
+  VOID
+  )
+{
+  CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF_EBX  Ebx;
+
+  if (CPUID_PLATFORM_QOS_ENFORCEMENT > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF,
+    NULL, &Ebx.Uint32, NULL, NULL
+    );
+  Print (L"CPUID_PLATFORM_QOS_ENFORCEMENT (Leaf %08x, Sub-Leaf %08x)\n", CPUID_PLATFORM_QOS_ENFORCEMENT, CPUID_PLATFORM_QOS_ENFORCEMENT_MAIN_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, Ebx.Uint32, 0, 0);
+  PRINT_BIT_FIELD (Ebx, L3CacheQosEnforcement);
+
+  CpuidPlatformQosEnforcementResidSubLeaf ();
+}
+
+/**
+  Display CPUID_INTEL_PROCESSOR_TRACE sub-leafs.
+
+  @param[in] MaximumSubLeaf  Maximum sub-leaf index for CPUID_INTEL_PROCESSOR_TRACE.
+
+**/
+VOID
+CpuidIntelProcessorTraceSubLeaf (
+  UINT32  MaximumSubLeaf
+  )
+{
+  UINT32                                    SubLeaf;
+  CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EAX  Eax;
+  CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF_EBX  Ebx;
+
+  for (SubLeaf = CPUID_INTEL_PROCESSOR_TRACE_SUB_LEAF; SubLeaf <= MaximumSubLeaf; SubLeaf++) {
+    AsmCpuidEx (
+      CPUID_INTEL_PROCESSOR_TRACE, SubLeaf,
+      &Eax.Uint32, &Ebx.Uint32, NULL, NULL
+      );
+    Print (L"CPUID_INTEL_PROCESSOR_TRACE (Leaf %08x, Sub-Leaf %08x)\n", CPUID_INTEL_PROCESSOR_TRACE, SubLeaf);
+    Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, 0, 0);
+    PRINT_BIT_FIELD (Eax, ConfigurableAddressRanges);
+    PRINT_BIT_FIELD (Eax, MtcPeriodEncodings);
+    PRINT_BIT_FIELD (Ebx, CycleThresholdEncodings);
+    PRINT_BIT_FIELD (Ebx, PsbFrequencyEncodings);
+  }
+}
+
+/**
+  Display CPUID_INTEL_PROCESSOR_TRACE main leaf and sub-leafs.
+
+**/
+VOID
+CpuidIntelProcessorTraceMainLeaf (
+  VOID
+  )
+{
+  UINT32                                     Eax;
+  CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_EBX  Ebx;
+  CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF_ECX  Ecx;
+
+  if (CPUID_INTEL_PROCESSOR_TRACE > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF,
+    &Eax, &Ebx.Uint32, &Ecx.Uint32, NULL
+    );
+  Print (L"CPUID_INTEL_PROCESSOR_TRACE (Leaf %08x, Sub-Leaf %08x)\n", CPUID_INTEL_PROCESSOR_TRACE, CPUID_INTEL_PROCESSOR_TRACE_MAIN_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx.Uint32, Ecx.Uint32, 0);
+  PRINT_VALUE     (Eax, MaximumSubLeaf);
+  PRINT_BIT_FIELD (Ebx, Cr3Filter);
+  PRINT_BIT_FIELD (Ebx, ConfigurablePsb);
+  PRINT_BIT_FIELD (Ebx, IpTraceStopFiltering);
+  PRINT_BIT_FIELD (Ebx, Mtc);
+  PRINT_BIT_FIELD (Ecx, RTIT);
+  PRINT_BIT_FIELD (Ecx, ToPA);
+  PRINT_BIT_FIELD (Ecx, SingleRangeOutput);
+  PRINT_BIT_FIELD (Ecx, TraceTransportSubsystem);
+  PRINT_BIT_FIELD (Ecx, LIP);
+
+  CpuidIntelProcessorTraceSubLeaf (Eax);
+}
+
+/**
+  Display CPUID_TIME_STAMP_COUNTER leaf.
+
+**/
+VOID
+CpuidTimeStampCounter (
+  VOID
+  )
+{
+  UINT32  Eax;
+  UINT32  Ebx;
+
+  if (CPUID_TIME_STAMP_COUNTER > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_TIME_STAMP_COUNTER, &Eax, &Ebx, NULL, NULL);
+  Print (L"CPUID_TIME_STAMP_COUNTER (Leaf %08x)\n", CPUID_TIME_STAMP_COUNTER);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx, 0, 0);
+}
+
+/**
+  Display CPUID_PROCESSOR_FREQUENCY leaf.
+
+**/
+VOID
+CpuidProcessorFrequency (
+  VOID
+  )
+{
+  CPUID_PROCESSOR_FREQUENCY_EAX  Eax;
+  CPUID_PROCESSOR_FREQUENCY_EBX  Ebx;
+  CPUID_PROCESSOR_FREQUENCY_ECX  Ecx;
+
+  if (CPUID_PROCESSOR_FREQUENCY > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_PROCESSOR_FREQUENCY, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, NULL);
+  Print (L"CPUID_PROCESSOR_FREQUENCY (Leaf %08x)\n", CPUID_PROCESSOR_FREQUENCY);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, 0);
+  PRINT_BIT_FIELD (Eax, ProcessorBaseFrequency);
+  PRINT_BIT_FIELD (Ebx, MaximumFrequency);
+  PRINT_BIT_FIELD (Ecx, BusFrequency);
+}
+
+/**
+  Display CPUID_SOC_VENDOR sub-leafs that contain the SoC Vendor Brand String.
+  Also display these sub-leafs as a single SoC Vendor Brand String.
+
+**/
+VOID
+CpuidSocVendorBrandString (
+  VOID
+  )
+{
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Eax;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ebx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Ecx;
+  CPUID_SOC_VENDOR_BRAND_STRING_DATA  Edx;
+  //
+  // Array to store brand string from 3 brand string leafs with
+  // 4 32-bit brand string values per leaf and an extra value to
+  // null terminate the string.
+  //
+  UINT32                              BrandString[3 * 4 + 1];
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING1,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  Print (L"CPUID_SOC_VENDOR (Leaf %08x, Sub-Leaf %08x)\n", CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING1);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+  BrandString[0] = Eax.Uint32;
+  BrandString[1] = Ebx.Uint32;
+  BrandString[2] = Ecx.Uint32;
+  BrandString[3] = Edx.Uint32;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING2,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  Print (L"CPUID_SOC_VENDOR (Leaf %08x, Sub-Leaf %08x)\n", CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING2);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+  BrandString[4] = Eax.Uint32;
+  BrandString[5] = Ebx.Uint32;
+  BrandString[6] = Ecx.Uint32;
+  BrandString[7] = Edx.Uint32;
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING3,
+    &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32
+    );
+  Print (L"CPUID_SOC_VENDOR (Leaf %08x, Sub-Leaf %08x)\n", CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_BRAND_STRING3);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+  BrandString[8]  = Eax.Uint32;
+  BrandString[9]  = Ebx.Uint32;
+  BrandString[10] = Ecx.Uint32;
+  BrandString[11] = Edx.Uint32;
+
+  BrandString[12] = 0;
+
+  Print (L"Vendor Brand String = %a\n", (CHAR8 *)BrandString);
+}
+
+/**
+  Display CPUID_SOC_VENDOR main leaf and sub-leafs.
+
+**/
+VOID
+CpuidSocVendor (
+  VOID
+  )
+{
+  UINT32                          Eax;
+  CPUID_SOC_VENDOR_MAIN_LEAF_EBX  Ebx;
+  UINT32                          Ecx;
+  UINT32                          Edx;
+
+  if (CPUID_SOC_VENDOR > gMaximumBasicFunction) {
+    return;
+  }
+
+  AsmCpuidEx (
+    CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_MAIN_LEAF,
+    &Eax, &Ebx.Uint32, &Ecx, &Edx
+    );
+  Print (L"CPUID_SOC_VENDOR (Leaf %08x, Sub-Leaf %08x)\n", CPUID_SOC_VENDOR, CPUID_SOC_VENDOR_MAIN_LEAF);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, Ebx.Uint32, Ecx, Edx);
+  if (Eax < 3) {
+    Print (L"  Not Supported\n");
+    return;
+  }
+  PRINT_VALUE     (Eax, MaxSOCID_Index);
+  PRINT_BIT_FIELD (Ebx, SocVendorId);
+  PRINT_BIT_FIELD (Ebx, IsVendorScheme);
+  PRINT_VALUE     (Ecx, ProjectID);
+  PRINT_VALUE     (Edx, SteppingID);
+  CpuidSocVendorBrandString ();
+}
+
+/**
+  Display CPUID_EXTENDED_FUNCTION leaf.
+
+**/
+VOID
+CpuidExtendedFunction (
+  VOID
+  )
+{
+  UINT32  Eax;
+
+  AsmCpuid (CPUID_EXTENDED_FUNCTION, &Eax, NULL, NULL, NULL);
+  Print (L"CPUID_EXTENDED_FUNCTION (Leaf %08x)\n", CPUID_EXTENDED_FUNCTION);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, 0, 0, 0);
+  PRINT_VALUE     (Eax, MaximumExtendedFunction);
+
+  gMaximumExtendedFunction = Eax;
+}
+
+/**
+  Display CPUID_EXTENDED_CPU_SIG leaf.
+
+**/
+VOID
+CpuidExtendedCpuSig (
+  VOID
+  )
+{
+  UINT32                      Eax;
+  CPUID_EXTENDED_CPU_SIG_ECX  Ecx;
+  CPUID_EXTENDED_CPU_SIG_EDX  Edx;
+
+  if (CPUID_EXTENDED_CPU_SIG > gMaximumExtendedFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_EXTENDED_CPU_SIG, &Eax, NULL, &Ecx.Uint32, &Edx.Uint32);
+  Print (L"CPUID_EXTENDED_CPU_SIG (Leaf %08x)\n", CPUID_EXTENDED_CPU_SIG);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax, 0, Ecx.Uint32, Edx.Uint32);
+  PRINT_BIT_FIELD (Ecx, LAHF_SAHF);
+  PRINT_BIT_FIELD (Ecx, LZCNT);
+  PRINT_BIT_FIELD (Ecx, PREFETCHW);
+  PRINT_BIT_FIELD (Edx, SYSCALL_SYSRET);
+  PRINT_BIT_FIELD (Edx, NX);
+  PRINT_BIT_FIELD (Edx, Page1GB);
+  PRINT_BIT_FIELD (Edx, RDTSCP);
+  PRINT_BIT_FIELD (Edx, LM);
+}
+
+/**
+  Display CPUID_BRAND_STRING1, CPUID_BRAND_STRING2 and  CPUID_BRAND_STRING3
+  leafs.  Also display these three leafs as a single brand string.
+
+**/
+VOID
+CpuidProcessorBrandString (
+  VOID
+  )
+{
+  CPUID_BRAND_STRING_DATA  Eax;
+  CPUID_BRAND_STRING_DATA  Ebx;
+  CPUID_BRAND_STRING_DATA  Ecx;
+  CPUID_BRAND_STRING_DATA  Edx;
+  //
+  // Array to store brand string from 3 brand string leafs with
+  // 4 32-bit brand string values per leaf and an extra value to
+  // null terminate the string.
+  //
+  UINT32                   BrandString[3 * 4 + 1];
+
+  if (CPUID_BRAND_STRING1 <= gMaximumExtendedFunction) {
+    AsmCpuid (CPUID_BRAND_STRING1, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+    Print (L"CPUID_BRAND_STRING1 (Leaf %08x)\n", CPUID_BRAND_STRING1);
+    Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+    BrandString[0] = Eax.Uint32;
+    BrandString[1] = Ebx.Uint32;
+    BrandString[2] = Ecx.Uint32;
+    BrandString[3] = Edx.Uint32;
+  }
+
+  if (CPUID_BRAND_STRING2 <= gMaximumExtendedFunction) {
+    AsmCpuid (CPUID_BRAND_STRING2, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+    Print (L"CPUID_BRAND_STRING2 (Leaf %08x)\n", CPUID_BRAND_STRING2);
+    Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+    BrandString[4] = Eax.Uint32;
+    BrandString[5] = Ebx.Uint32;
+    BrandString[6] = Ecx.Uint32;
+    BrandString[7] = Edx.Uint32;
+  }
+
+  if (CPUID_BRAND_STRING3 <= gMaximumExtendedFunction) {
+    AsmCpuid (CPUID_BRAND_STRING3, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
+    Print (L"CPUID_BRAND_STRING3 (Leaf %08x)\n", CPUID_BRAND_STRING3);
+    Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, Ebx.Uint32, Ecx.Uint32, Edx.Uint32);
+    BrandString[8]  = Eax.Uint32;
+    BrandString[9]  = Ebx.Uint32;
+    BrandString[10] = Ecx.Uint32;
+    BrandString[11] = Edx.Uint32;
+  }
+
+  BrandString[12] = 0;
+
+  Print (L"Brand String = %a\n", (CHAR8 *)BrandString);
+}
+
+/**
+  Display CPUID_EXTENDED_CACHE_INFO leaf.
+
+**/
+VOID
+CpuidExtendedCacheInfo (
+  VOID
+  )
+{
+  CPUID_EXTENDED_CACHE_INFO_ECX  Ecx;
+
+  if (CPUID_EXTENDED_CACHE_INFO > gMaximumExtendedFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_EXTENDED_CACHE_INFO, NULL, NULL, &Ecx.Uint32, NULL);
+  Print (L"CPUID_EXTENDED_CACHE_INFO (Leaf %08x)\n", CPUID_EXTENDED_CACHE_INFO);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, 0, Ecx.Uint32, 0);
+  PRINT_BIT_FIELD (Ecx, CacheLineSize);
+  PRINT_BIT_FIELD (Ecx, L2Associativity);
+  PRINT_BIT_FIELD (Ecx, CacheSize);
+}
+
+/**
+  Display CPUID_EXTENDED_TIME_STAMP_COUNTER leaf.
+
+**/
+VOID
+CpuidExtendedTimeStampCounter (
+  VOID
+  )
+{
+  CPUID_EXTENDED_TIME_STAMP_COUNTER_EDX  Edx;
+
+  if (CPUID_EXTENDED_TIME_STAMP_COUNTER > gMaximumExtendedFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_EXTENDED_TIME_STAMP_COUNTER, NULL, NULL, NULL, &Edx.Uint32);
+  Print (L"CPUID_EXTENDED_TIME_STAMP_COUNTER (Leaf %08x)\n", CPUID_EXTENDED_TIME_STAMP_COUNTER);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", 0, 0, 0, Edx.Uint32);
+  PRINT_BIT_FIELD (Edx, InvariantTsc);
+}
+
+/**
+  Display CPUID_VIR_PHY_ADDRESS_SIZE leaf.
+
+**/
+VOID
+CpuidVirPhyAddressSize (
+  VOID
+  )
+{
+  CPUID_VIR_PHY_ADDRESS_SIZE_EAX  Eax;
+
+  if (CPUID_VIR_PHY_ADDRESS_SIZE > gMaximumExtendedFunction) {
+    return;
+  }
+
+  AsmCpuid (CPUID_VIR_PHY_ADDRESS_SIZE, &Eax.Uint32, NULL, NULL, NULL);
+  Print (L"CPUID_VIR_PHY_ADDRESS_SIZE (Leaf %08x)\n", CPUID_VIR_PHY_ADDRESS_SIZE);
+  Print (L"  EAX:%08x  EBX:%08x  ECX:%08x  EDX:%08x\n", Eax.Uint32, 0, 0, 0);
+  PRINT_BIT_FIELD (Eax, PhysicalAddressBits);
+  PRINT_BIT_FIELD (Eax, LinearAddressBits);
+}
+
+/**
+  The user Entry Point for Application. The user code starts with this function
+  as the real entry point for the application.
+
+  @param[in] ImageHandle    The firmware allocated handle for the EFI image.
+  @param[in] SystemTable    A pointer to the EFI System Table.
+
+  @retval EFI_SUCCESS       The entry point is executed successfully.
+  @retval other             Some error occurs when executing this entry point.
+
+**/
+EFI_STATUS
+EFIAPI
+UefiMain (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  Print (L"UEFI CPUID Version 0.5\n");
+
+  CpuidSignature ();
+  CpuidVersionInfo ();
+  CpuidCacheInfo ();
+  CpuidSerialNumber ();
+  CpuidCacheParams();
+  CpuidMonitorMwait ();
+  CpuidThermalPowerManagement ();
+  CpuidStructuredExtendedFeatureFlags ();
+  CpuidDirectCacheAccessInfo();
+  CpuidArchitecturalPerformanceMonitoring ();
+  CpuidExtendedTopology ();
+  CpuidExtendedStateMainLeaf ();
+  CpuidPlatformQosMonitoringEnumerationSubLeaf ();
+  CpuidPlatformQosMonitoringCapabilitySubLeaf ();
+  CpuidPlatformQosEnforcementMainLeaf ();
+  CpuidIntelProcessorTraceMainLeaf ();
+  CpuidTimeStampCounter ();
+  CpuidProcessorFrequency ();
+  CpuidSocVendor ();
+  CpuidExtendedFunction ();
+  CpuidExtendedCpuSig ();
+  CpuidProcessorBrandString ();
+  CpuidExtendedCacheInfo ();
+  CpuidExtendedTimeStampCounter ();
+  CpuidVirPhyAddressSize ();
+
+  return EFI_SUCCESS;
+}
diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.inf b/UefiCpuPkg/Application/Cpuid/Cpuid.inf
new file mode 100644
index 000000000000..0d71b115d978
--- /dev/null
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.inf
@@ -0,0 +1,48 @@
+## @file
+#  UEFI Application to display CPUID leaf information.
+#
+#  This UEFI application displays the registers values returned by CPUID for
+#  all the CPUID leafs and sub-leafs that a CPU supports.  It also displays
+#  the values of all the bit fields in the registers returned by each CPUID
+#  leaf and sub-leaf.
+#
+#  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+#
+#  This program and the accompanying materials
+#  are licensed and made available under the terms and conditions of the BSD License
+#  which accompanies this distribution. The full text of the license may be found at
+#  http://opensource.org/licenses/bsd-license.php
+#  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#
+##
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = Cpuid
+  MODULE_UNI_FILE                = Cpuid.uni
+  FILE_GUID                      = 4AE7E1E8-9DFE-4e3e-85B4-A5F6ABD470FB
+  MODULE_TYPE                    = UEFI_APPLICATION
+  VERSION_STRING                 = 0.5
+  ENTRY_POINT                    = UefiMain
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32 X64
+#
+
+[Sources]
+  Cpuid.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UefiCpuPkg/UefiCpuPkg.dec
+
+[LibraryClasses]
+  UefiApplicationEntryPoint
+  BaseLib
+  UefiLib
+
+[UserExtensions.TianoCore."ExtraFiles"]
+  CpuidExtra.uni
diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.uni b/UefiCpuPkg/Application/Cpuid/Cpuid.uni
new file mode 100644
index 000000000000..32dee43414e8
--- /dev/null
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.uni
@@ -0,0 +1,22 @@
+// /** @file
+// UEFI Application to display CPUID leaf information.
+//
+// This UEFI application displays the registers values returned by CPUID for
+// all the CPUID leafs and sub-leafs that a CPU supports.  It also displays
+// the values of all the bit fields in the registers returned by each CPUID
+// leaf and sub-leaf.
+//
+// Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+#string STR_MODULE_ABSTRACT             #language en-US "UEFI Application to display CPUID leaf information"
+
+#string STR_MODULE_DESCRIPTION          #language en-US "This UEFI application displays the registers values returned by CPUID for all the CPUID leafs and sub-leafs that a CPU supports.  It also displays the values of all the bit fields in the registers returned by each CPUID leaf and sub-leaf."
diff --git a/UefiCpuPkg/Application/Cpuid/CpuidExtra.uni b/UefiCpuPkg/Application/Cpuid/CpuidExtra.uni
new file mode 100644
index 000000000000..b4251e23cce1
--- /dev/null
+++ b/UefiCpuPkg/Application/Cpuid/CpuidExtra.uni
@@ -0,0 +1,22 @@
+// /** @file
+// UEFI Application to display CPUID leaf information.
+//
+// This UEFI application displays the registers values returned by CPUID for
+// all the CPUID leafs and sub-leafs that a CPU supports.  It also displays
+// the values of all the bit fields in the registers returned by each CPUID
+// leaf and sub-leaf.
+//
+// Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
+//
+// This program and the accompanying materials
+// are licensed and made available under the terms and conditions of the BSD License
+// which accompanies this distribution. The full text of the license may be found at
+// http://opensource.org/licenses/bsd-license.php
+// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+//
+// **/
+
+#string STR_PROPERTIES_MODULE_NAME
+#language en-US
+"CPUID Application"
diff --git a/UefiCpuPkg/UefiCpuPkg.dsc b/UefiCpuPkg/UefiCpuPkg.dsc
index 31e60bbe7765..731915286c3f 100644
--- a/UefiCpuPkg/UefiCpuPkg.dsc
+++ b/UefiCpuPkg/UefiCpuPkg.dsc
@@ -88,6 +88,10 @@
   HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
   CpuExceptionHandlerLib|UefiCpuPkg/Library/CpuExceptionHandlerLib/SmmCpuExceptionHandlerLib.inf
 
+[LibraryClasses.common.UEFI_APPLICATION]
+  UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
+  MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
+
 #
 # Drivers/Libraries within this package
 #
@@ -96,6 +100,7 @@
   UefiCpuPkg/CpuIo2Dxe/CpuIo2Dxe.inf
   UefiCpuPkg/CpuIoPei/CpuIoPei.inf
   UefiCpuPkg/Library/SecPeiDxeTimerLibUefiCpu/SecPeiDxeTimerLibUefiCpu.inf
+  UefiCpuPkg/Application/Cpuid/Cpuid.inf
 
 [Components.IA32, Components.X64]
   UefiCpuPkg/CpuDxe/CpuDxe.inf

From ed1ce80bfb03db35099a3f9b574e3869a13a489a Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Fri, 26 Feb 2016 16:43:02 +0800
Subject: [PATCH 505/525] UefiCpuPkg/Cpuid: Fix GCC build error

define PRINT_BIT_FIELD(Variable, FieldName) \
  Print (L"%5a%42a: %x\n", #Variable, #FieldName, \
  ##Variable.Bits.##FieldName);

The above definition in UefiCpuPkg/Application/Cpuid/Cpuid.c
will cause GCC build error.

Fix it with:

define PRINT_BIT_FIELD(Variable, FieldName) \
  Print (L"%5a%42a: %x\n", #Variable, #FieldName, \
  Variable.Bits.FieldName);

The '.' has its origin meaning as a member operator in the define
statement. Thus, the token-pasting operator '##' is not necessary here.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit d2ba6f41e2f8cbc8dffee8bddaebbbd6f3a3b9ab)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
index f82e43f563ad..366c3ca20504 100644
--- a/UefiCpuPkg/Application/Cpuid/Cpuid.c
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -21,7 +21,7 @@
 /// Macro used to display the value of a bit field in a register returned by CPUID.
 ///
 #define PRINT_BIT_FIELD(Variable, FieldName) \
-  Print (L"%5a%42a: %x\n", #Variable, #FieldName, ##Variable.Bits.##FieldName);
+  Print (L"%5a%42a: %x\n", #Variable, #FieldName, Variable.Bits.FieldName);
 
 ///
 /// Macro used to display the value of a register returned by CPUID.

From 2393ff514569da4df5a44d56b4294032fd5c518c Mon Sep 17 00:00:00 2001
From: Michael Kinney <michael.d.kinney@intel.com>
Date: Mon, 22 Feb 2016 16:46:06 -0800
Subject: [PATCH 506/525] BaseTools/tools_def.txt: Add -march=i586 for IA32 GCC
 targets

Newer GCC compilers use a default of march higher than i586
for -m32 (IA32 configuration) and this is causing generation of
instructions that are not compatible with all IA32 targets.
Specically Galileo platform support in the QuarkPlatformPkg does
not boot if GCC48 or higher is used.

This is similar to the following checkin that was done to address
this same issue for VS2012 and higher tool chains:

SHA-1: 71028ba2c4c398d70475504e671d048d9003d90f

Cc: Yonghong Zhu <yonghong.zhu@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Leroy Leahy <leroy.p.leahy@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit c261c27dcee4603b9628d68639e7dccc4253af7e)
---
 BaseTools/Conf/tools_def.template | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/BaseTools/Conf/tools_def.template b/BaseTools/Conf/tools_def.template
index c42a434165c0..b1577af8c897 100644
--- a/BaseTools/Conf/tools_def.template
+++ b/BaseTools/Conf/tools_def.template
@@ -1,6 +1,6 @@
 #
 #  Copyright (c) 2015, Hewlett-Packard Development Company, L.P.<BR>
-#  Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
+#  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 #  Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
 #  Portions copyright (c) 2011 - 2014, ARM Ltd. All rights reserved.<BR>
 #
@@ -4351,7 +4351,7 @@ DEFINE GCC_ARM_RC_FLAGS            = -I binary -O elf32-littlearm     -B arm
 DEFINE GCC_AARCH64_RC_FLAGS        = -I binary -O elf64-littleaarch64 -B aarch64 --rename-section .data=.hii
 
 DEFINE GCC44_ALL_CC_FLAGS            = -g -fshort-wchar -fno-strict-aliasing -Wall -Werror -Wno-array-bounds -ffunction-sections -fdata-sections -c -include AutoGen.h -fno-common -DSTRING_ARRAY_NAME=$(BASE_NAME)Strings
-DEFINE GCC44_IA32_CC_FLAGS           = DEF(GCC44_ALL_CC_FLAGS) -m32 -malign-double -fno-stack-protector -D EFI32 -fno-asynchronous-unwind-tables
+DEFINE GCC44_IA32_CC_FLAGS           = DEF(GCC44_ALL_CC_FLAGS) -m32 -march=i586 -malign-double -fno-stack-protector -D EFI32 -fno-asynchronous-unwind-tables
 DEFINE GCC44_X64_CC_FLAGS            = DEF(GCC44_ALL_CC_FLAGS) -m64 -fno-stack-protector "-DEFIAPI=__attribute__((ms_abi))" -DNO_BUILTIN_VA_FUNCS -mno-red-zone -Wno-address -mcmodel=large -fno-asynchronous-unwind-tables
 DEFINE GCC44_IA32_X64_DLINK_COMMON   = -nostdlib -n -q --gc-sections -z common-page-size=0x20
 DEFINE GCC44_IA32_X64_ASLDLINK_FLAGS = DEF(GCC44_IA32_X64_DLINK_COMMON) --entry ReferenceAcpiTable -u ReferenceAcpiTable

From 7dda8dc47259d2f68194944ec6aa225d38525a30 Mon Sep 17 00:00:00 2001
From: Yonghong Zhu <yonghong.zhu@intel.com>
Date: Mon, 29 Feb 2016 11:18:12 +0800
Subject: [PATCH 507/525] BaseTools: fix LzmaCompress VS2013 make failure

when make BaseTools by VS2013, LzmaEnc.c report warning C4127:
conditional expression is constant, so this patch fix this issue.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Yonghong Zhu <yonghong.zhu@intel.com>
Reviewed-by: Liming Gao <liming.gao@intel.com>
(cherry picked from commit b0c583cdd19cc6316cbda82cb79df4346a7db8c7)
---
 BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
index c6717eeea3a0..297db9d54d42 100644
--- a/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
+++ b/BaseTools/Source/C/LzmaCompress/Sdk/C/LzmaEnc.c
@@ -1366,8 +1366,9 @@ static UInt32 GetOptimum(CLzmaEnc *p, UInt32 position, UInt32 *backRes)
       
       if (repIndex == 0)
         startLen = lenTest + 1;
-        
+      #ifndef _MSC_VER
       if (1 /* _maxMode */)
+      #endif
         {
           UInt32 lenTest2 = lenTest + 1;
           UInt32 limit = lenTest2 + p->numFastBytes;

From 2a44566d80032386e8e2e37a04e4ddf0405c04ea Mon Sep 17 00:00:00 2001
From: Hao Wu <hao.a.wu@intel.com>
Date: Wed, 2 Mar 2016 10:23:25 +0800
Subject: [PATCH 508/525] External link to BaseTools Win binary r123(main trunk
 r20055)

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Hao Wu <hao.a.wu@intel.com>
---
 BaseTools/Bin/externals.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/BaseTools/Bin/externals.txt b/BaseTools/Bin/externals.txt
index f0bc6d898bfd..ffc8dd1b67fb 100644
--- a/BaseTools/Bin/externals.txt
+++ b/BaseTools/Bin/externals.txt
@@ -1 +1 @@
-Win32  -r 122 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32
+Win32  -r 123 https://svn.code.sf.net/p/edk2-toolbinaries/code/trunk/Win32

From 5729f0ca6212c01102ec82a8991ae195ef2ca998 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Mar 2016 09:45:14 +0800
Subject: [PATCH 509/525] UefiCpuPkg/CpuMpPei: Load microcode if found newer
 revision

Current implementation only loads the latest revision if there is no microcode
loaded. Per IA32 User Manual, we should load the newer revision by comparing
the existing microcode loaded with the updating revision.

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit 15dbb3933282c0f55ceb5ab501e26cb17cff5560)
---
 UefiCpuPkg/CpuMpPei/Microcode.c | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/UefiCpuPkg/CpuMpPei/Microcode.c b/UefiCpuPkg/CpuMpPei/Microcode.c
index 70e149be8772..9dcbf99db3b6 100644
--- a/UefiCpuPkg/CpuMpPei/Microcode.c
+++ b/UefiCpuPkg/CpuMpPei/Microcode.c
@@ -1,7 +1,7 @@
 /** @file
   Implementation of loading microcode on processors.
 
-  Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+  Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>
   This program and the accompanying materials
   are licensed and made available under the terms and conditions of the BSD License
   which accompanies this distribution.  The full text of the license may be found at
@@ -57,7 +57,6 @@ MicrocodeDetect (
   UINTN                                   TotalSize;
   UINT32                                  CheckSum32;
   BOOLEAN                                 CorrectMicrocode;
-  INT32                                   CurrentSignature;
   MICROCODE_INFO                          MicrocodeInfo;
 
   ZeroMem (&MicrocodeInfo, sizeof (MICROCODE_INFO));
@@ -181,17 +180,20 @@ MicrocodeDetect (
 
   if (LatestRevision > 0) {
     //
-    // Get microcode update signature of currently loaded microcode update
+    // BIOS only authenticate updates that contain a numerically larger revision
+    // than the currently loaded revision, where Current Signature < New Update
+    // Revision. A processor with no loaded update is considered to have a
+    // revision equal to zero.
     //
-    CurrentSignature = GetCurrentMicrocodeSignature ();
-    //
-    // If no microcode update has been loaded, then trigger microcode load.
-    //
-    if (CurrentSignature == 0) {
+    if (LatestRevision > GetCurrentMicrocodeSignature ()) {
       AsmWriteMsr64 (
         EFI_MSR_IA32_BIOS_UPDT_TRIG,
         (UINT64) (UINTN) MicrocodeInfo.MicrocodeData
         );
+      //
+      // Get and verify new microcode signature
+      //
+      ASSERT (LatestRevision == GetCurrentMicrocodeSignature ());
       MicrocodeInfo.Load = TRUE;
     } else {
       MicrocodeInfo.Load = FALSE;

From d02317febbf5eb54fa9f2b9f1a01e2ea2fa7dac7 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Mar 2016 10:00:31 +0800
Subject: [PATCH 510/525] UefiCpuPkg/Application/Cpuid: Remove unnecessary code
 check

gMaximumBasicFunction is set to CPUID_SIGNATURE as below, so removed the compare
code.
UINT32  gMaximumBasicFunction = CPUID_SIGNATURE;

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit 2bdc0de6a525d48f4a74fb01351d53085ecaa281)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
index 366c3ca20504..b05da3ee0ca7 100644
--- a/UefiCpuPkg/Application/Cpuid/Cpuid.c
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -213,10 +213,6 @@ CpuidVersionInfo (
   UINTN                   DisplayFamily;
   UINTN                   DisplayModel;
 
-  if (CPUID_VERSION_INFO > gMaximumBasicFunction) {
-    return;
-  }
-
   AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
 
   Print (L"CPUID_VERSION_INFO (Leaf %08x)\n", CPUID_VERSION_INFO);

From 79d8353e14eb3cee269d9e2dbbfd4b60a1432177 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 2 Mar 2016 10:05:44 +0800
Subject: [PATCH 511/525] UefiCpuPkg/Application/Cpuid: Change
 DisplayFamily/DisplayModel type

Change DisplayFamily/DisplayModel type to UINT32 to avoid different size in
bitwise operation.

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit 5a676df9cddfd659f65c39a1d984971d916fd00b)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
index b05da3ee0ca7..371df6699417 100644
--- a/UefiCpuPkg/Application/Cpuid/Cpuid.c
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -210,8 +210,8 @@ CpuidVersionInfo (
   CPUID_VERSION_INFO_EBX  Ebx;
   CPUID_VERSION_INFO_ECX  Ecx;
   CPUID_VERSION_INFO_EDX  Edx;
-  UINTN                   DisplayFamily;
-  UINTN                   DisplayModel;
+  UINT32                  DisplayFamily;
+  UINT32                  DisplayModel;
 
   AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
 

From 919ca401a953137ec882ba05474735fa507ece25 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Sat, 10 Oct 2015 02:53:41 +0000
Subject: [PATCH 512/525] MdeModulePkg PiDxeS3BootScriptLib: Use PcdSet64S to
 instead of PcdSet64

PcdSet## has no error status returned, then the caller has no idea about whether the set operation is successful or not.
PcdSet##S were added to return error status and PcdSet## APIs were put in ifndef DISABLE_NEW_DEPRECATED_INTERFACES condition.
To adopt PcdSet##S and further code development with DISABLE_NEW_DEPRECATED_INTERFACES defined, we need to Replace PcdSet## usage with PcdSet##S.

Normally, DynamicDefault PCD set is expected to be success, but DynamicHii PCD set failure is a legal case.
For this case, PcdS3BootScriptTablePrivateDataPtr and PcdS3BootScriptTablePrivateSmmDataPtr are expected to be DynamicDefault,
so use PcdSet64S to instead of PcdSet64 and assert when set failure.

Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18599 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit ca49b6f9bfcf74da90bf500f3f81d702aa4be6cc)
---
 MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c b/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
index 24c67984ca16..e7d2a2492e84 100644
--- a/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
+++ b/MdeModulePkg/Library/PiDxeS3BootScriptLib/BootScriptSave.c
@@ -454,7 +454,8 @@ S3BootScriptLibInitialize (
     }
     S3TablePtr = (VOID *) (UINTN) Buffer;
 
-    PcdSet64 (PcdS3BootScriptTablePrivateDataPtr, (UINT64) (UINTN)S3TablePtr); 
+    Status = PcdSet64S (PcdS3BootScriptTablePrivateDataPtr, (UINT64) (UINTN)S3TablePtr);
+    ASSERT_EFI_ERROR (Status);
     ZeroMem (S3TablePtr, sizeof(SCRIPT_TABLE_PRIVATE_DATA));  
     //
     // Create event to notify the library system enter the SmmLocked phase.
@@ -506,7 +507,8 @@ S3BootScriptLibInitialize (
       return RETURN_OUT_OF_RESOURCES;
     }
 
-    PcdSet64 (PcdS3BootScriptTablePrivateSmmDataPtr, (UINT64) (UINTN)S3TableSmmPtr);
+    Status = PcdSet64S (PcdS3BootScriptTablePrivateSmmDataPtr, (UINT64) (UINTN)S3TableSmmPtr);
+    ASSERT_EFI_ERROR (Status);
     ZeroMem (S3TableSmmPtr, sizeof(SCRIPT_TABLE_PRIVATE_DATA));
 
     //

From cefcac86ca0e662c43b205ec8266724cc262a831 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Thu, 15 Oct 2015 00:56:41 +0000
Subject: [PATCH 513/525] MdeModulePkg: Use PcdSet##S to replace PcdSet##

PcdSet## has no error status returned, then the caller has no idea about whether the set operation is successful or not.
PcdSet##S were added to return error status and PcdSet## APIs were put in ifndef DISABLE_NEW_DEPRECATED_INTERFACES condition.
To adopt PcdSet##S and further code development with DISABLE_NEW_DEPRECATED_INTERFACES defined, we need to Replace PcdSet## usage with PcdSet##S.

Normally, DynamicDefault PCD set is expected to be success, but DynamicHii PCD set failure is a legal case.
So for DynamicDefault, we add assert when set failure. For DynamicHii, we add logic to handle it.

Cc: Star Zeng <star.zeng@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18603 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 377680ae64bd6f702bfac7c98e65f73019b7d285)
---
 .../BootManagerMenuApp/BootManagerMenu.c      | 19 ++++++++++++-------
 .../Application/UiApp/BootMaint/Variable.c    |  8 +++++---
 MdeModulePkg/Application/UiApp/FrontPage.c    | 18 ++++++++++++------
 .../Console/ConSplitterDxe/ConSplitter.c      |  8 +++++---
 4 files changed, 34 insertions(+), 19 deletions(-)

diff --git a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
index 8748ac0e0590..9547c7eb5a83 100644
--- a/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
+++ b/MdeModulePkg/Application/BootManagerMenuApp/BootManagerMenu.c
@@ -810,8 +810,10 @@ BdsSetConsoleMode (
                   //
                   // Update text mode PCD.
                   //
-                  PcdSet32 (PcdConOutColumn, mSetupTextModeColumn);
-                  PcdSet32 (PcdConOutRow, mSetupTextModeRow);
+                  Status = PcdSet32S (PcdConOutColumn, mSetupTextModeColumn);
+                  ASSERT_EFI_ERROR (Status);
+                  Status = PcdSet32S (PcdConOutRow, mSetupTextModeRow);
+                  ASSERT_EFI_ERROR (Status);
                   FreePool (Info);
                   return EFI_SUCCESS;
                 }
@@ -852,11 +854,14 @@ BdsSetConsoleMode (
   // Set PCD to Inform GraphicsConsole to change video resolution.
   // Set PCD to Inform Consplitter to change text mode.
   //
-  PcdSet32 (PcdVideoHorizontalResolution, NewHorizontalResolution);
-  PcdSet32 (PcdVideoVerticalResolution, NewVerticalResolution);
-  PcdSet32 (PcdConOutColumn, NewColumns);
-  PcdSet32 (PcdConOutRow, NewRows);
-  
+  Status = PcdSet32S (PcdVideoHorizontalResolution, NewHorizontalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdVideoVerticalResolution, NewVerticalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutColumn, NewColumns);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutRow, NewRows);
+  ASSERT_EFI_ERROR (Status);
   
   //
   // Video mode is changed, so restart graphics console driver and higher level driver.
diff --git a/MdeModulePkg/Application/UiApp/BootMaint/Variable.c b/MdeModulePkg/Application/UiApp/BootMaint/Variable.c
index 76dbd3a4a946..a8d9cd5efbdb 100644
--- a/MdeModulePkg/Application/UiApp/BootMaint/Variable.c
+++ b/MdeModulePkg/Application/UiApp/BootMaint/Variable.c
@@ -1064,9 +1064,11 @@ Var_UpdateConMode (
 
   Status = gST->ConOut->QueryMode (gST->ConOut, Mode, &(ModeInfo.Column), &(ModeInfo.Row));
   if (!EFI_ERROR(Status)) {
-    PcdSet32 (PcdSetupConOutColumn, (UINT32) ModeInfo.Column);
-    PcdSet32 (PcdSetupConOutRow, (UINT32) ModeInfo.Row);
+    Status = PcdSet32S (PcdSetupConOutColumn, (UINT32) ModeInfo.Column);
+    if (!EFI_ERROR (Status)) {
+      Status = PcdSet32S (PcdSetupConOutRow, (UINT32) ModeInfo.Row);
+    }
   }
 
-  return EFI_SUCCESS;
+  return Status;
 }
diff --git a/MdeModulePkg/Application/UiApp/FrontPage.c b/MdeModulePkg/Application/UiApp/FrontPage.c
index d1b4f5cb6a98..245c3497c802 100644
--- a/MdeModulePkg/Application/UiApp/FrontPage.c
+++ b/MdeModulePkg/Application/UiApp/FrontPage.c
@@ -989,8 +989,10 @@ BdsSetConsoleMode (
                   //
                   // Update text mode PCD.
                   //
-                  PcdSet32 (PcdConOutColumn, mSetupTextModeColumn);
-                  PcdSet32 (PcdConOutRow, mSetupTextModeRow);
+                  Status = PcdSet32S (PcdConOutColumn, mSetupTextModeColumn);
+                  ASSERT_EFI_ERROR (Status);
+                  Status = PcdSet32S (PcdConOutRow, mSetupTextModeRow);
+                  ASSERT_EFI_ERROR (Status);
                   FreePool (Info);
                   return EFI_SUCCESS;
                 }
@@ -1031,10 +1033,14 @@ BdsSetConsoleMode (
   // Set PCD to Inform GraphicsConsole to change video resolution.
   // Set PCD to Inform Consplitter to change text mode.
   //
-  PcdSet32 (PcdVideoHorizontalResolution, NewHorizontalResolution);
-  PcdSet32 (PcdVideoVerticalResolution, NewVerticalResolution);
-  PcdSet32 (PcdConOutColumn, NewColumns);
-  PcdSet32 (PcdConOutRow, NewRows);
+  Status = PcdSet32S (PcdVideoHorizontalResolution, NewHorizontalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdVideoVerticalResolution, NewVerticalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutColumn, NewColumns);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutRow, NewRows);
+  ASSERT_EFI_ERROR (Status);
   
   
   //
diff --git a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c b/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c
index bea206d35bfe..dae97b09a2e2 100644
--- a/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c
+++ b/MdeModulePkg/Universal/Console/ConSplitterDxe/ConSplitter.c
@@ -16,7 +16,7 @@
   never removed. Such design ensures sytem function well during none console
   device situation.
 
-Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials
 are licensed and made available under the terms and conditions of the BSD License
 which accompanies this distribution.  The full text of the license may be found at
@@ -2946,8 +2946,10 @@ ConsplitterSetConsoleOutMode (
     Status = TextOut->SetMode (TextOut, BaseMode);
     ASSERT(!EFI_ERROR(Status));
 
-    PcdSet32 (PcdConOutColumn, 80);
-    PcdSet32 (PcdConOutRow, 25);
+    Status = PcdSet32S (PcdConOutColumn, 80);
+    ASSERT(!EFI_ERROR(Status));
+    Status = PcdSet32S (PcdConOutRow, 25);
+    ASSERT(!EFI_ERROR(Status));
   }
 
   return ;

From ff24f60a1c06f1dc6b0f17007281aed032a66405 Mon Sep 17 00:00:00 2001
From: Eric Dong <eric.dong@intel.com>
Date: Thu, 15 Oct 2015 00:57:45 +0000
Subject: [PATCH 514/525] IntelFrameworkModulePkg BdsDxe: Use PcdSet##S to
 replace PcdSet##

PcdSet## has no error status returned, then the caller has no idea about whether the set operation is successful or not.
PcdSet##S were added to return error status and PcdSet## APIs were put in ifndef DISABLE_NEW_DEPRECATED_INTERFACES condition.
To adopt PcdSet##S and further code development with DISABLE_NEW_DEPRECATED_INTERFACES defined, we need to Replace PcdSet## usage with PcdSet##S.

Normally, DynamicDefault PCD set is expected to be success, but DynamicHii PCD set failure is a legal case.
So for DynamicDefault, we add assert when set failure. For DynamicHii, we add logic to handle it.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Eric Dong <eric.dong@intel.com>
Reviewed-by: Star Zeng <star.zeng@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18605 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit 84db9040cc8ba556faec61ad3480c774ca8b984c)
---
 .../Universal/BdsDxe/BootMaint/Variable.c      |  8 +++++---
 .../Universal/BdsDxe/FrontPage.c               | 18 ++++++++++++------
 .../Universal/BdsDxe/MemoryTest.c              |  5 ++++-
 3 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/IntelFrameworkModulePkg/Universal/BdsDxe/BootMaint/Variable.c b/IntelFrameworkModulePkg/Universal/BdsDxe/BootMaint/Variable.c
index 616549e64a22..b933dd9699cb 100644
--- a/IntelFrameworkModulePkg/Universal/BdsDxe/BootMaint/Variable.c
+++ b/IntelFrameworkModulePkg/Universal/BdsDxe/BootMaint/Variable.c
@@ -1370,9 +1370,11 @@ Var_UpdateConMode (
 
   Status = gST->ConOut->QueryMode (gST->ConOut, Mode, &(ModeInfo.Column), &(ModeInfo.Row));
   if (!EFI_ERROR(Status)) {
-    PcdSet32 (PcdSetupConOutColumn, (UINT32) ModeInfo.Column);
-    PcdSet32 (PcdSetupConOutRow, (UINT32) ModeInfo.Row);
+    Status = PcdSet32S (PcdSetupConOutColumn, (UINT32) ModeInfo.Column);
+    if (!EFI_ERROR (Status)){
+      Status = PcdSet32S (PcdSetupConOutRow, (UINT32) ModeInfo.Row);
+    }
   }
 
-  return EFI_SUCCESS;
+  return Status;
 }
diff --git a/IntelFrameworkModulePkg/Universal/BdsDxe/FrontPage.c b/IntelFrameworkModulePkg/Universal/BdsDxe/FrontPage.c
index 14a7ae29f4dd..0a9238c2e7c8 100644
--- a/IntelFrameworkModulePkg/Universal/BdsDxe/FrontPage.c
+++ b/IntelFrameworkModulePkg/Universal/BdsDxe/FrontPage.c
@@ -1395,8 +1395,10 @@ BdsSetConsoleMode (
                   //
                   // Update text mode PCD.
                   //
-                  PcdSet32 (PcdConOutColumn, mSetupTextModeColumn);
-                  PcdSet32 (PcdConOutRow, mSetupTextModeRow);
+                  Status = PcdSet32S (PcdConOutColumn, mSetupTextModeColumn);
+                  ASSERT_EFI_ERROR (Status);
+                  Status = PcdSet32S (PcdConOutRow, mSetupTextModeRow);
+                  ASSERT_EFI_ERROR (Status);
                   FreePool (Info);
                   return EFI_SUCCESS;
                 }
@@ -1437,10 +1439,14 @@ BdsSetConsoleMode (
   // Set PCD to Inform GraphicsConsole to change video resolution.
   // Set PCD to Inform Consplitter to change text mode.
   //
-  PcdSet32 (PcdVideoHorizontalResolution, NewHorizontalResolution);
-  PcdSet32 (PcdVideoVerticalResolution, NewVerticalResolution);
-  PcdSet32 (PcdConOutColumn, NewColumns);
-  PcdSet32 (PcdConOutRow, NewRows);
+  Status = PcdSet32S (PcdVideoHorizontalResolution, NewHorizontalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdVideoVerticalResolution, NewVerticalResolution);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutColumn, NewColumns);
+  ASSERT_EFI_ERROR (Status);
+  Status = PcdSet32S (PcdConOutRow, NewRows);
+  ASSERT_EFI_ERROR (Status);
   
   
   //
diff --git a/IntelFrameworkModulePkg/Universal/BdsDxe/MemoryTest.c b/IntelFrameworkModulePkg/Universal/BdsDxe/MemoryTest.c
index fedb151a0c63..700e3e6626af 100644
--- a/IntelFrameworkModulePkg/Universal/BdsDxe/MemoryTest.c
+++ b/IntelFrameworkModulePkg/Universal/BdsDxe/MemoryTest.c
@@ -426,7 +426,10 @@ BdsMemoryTest (
   //
   IsFirstBoot = PcdGetBool(PcdBootState);
   if (IsFirstBoot) {
-    PcdSetBool(PcdBootState, FALSE);
+    Status = PcdSetBoolS(PcdBootState, FALSE);
+    if (EFI_ERROR (Status)) {
+      DEBUG ((EFI_D_ERROR, "Set PcdBootState to FALSE failed.\n"));
+    }
   }
 
   return ReturnStatus;

From 88e61ced4642aad305e7ff455616253b55e7d742 Mon Sep 17 00:00:00 2001
From: Star Zeng <star.zeng@intel.com>
Date: Fri, 16 Oct 2015 01:46:19 +0000
Subject: [PATCH 515/525] SecurityPkg: Use PcdSet##S to instead of PcdSet##

PcdSet## has no error status returned, then the caller has no idea about whether the set operation is successful or not.
PcdSet##S were added to return error status and PcdSet## APIs were put in ifndef DISABLE_NEW_DEPRECATED_INTERFACES condition.
To adopt PcdSet##S and further code development with DISABLE_NEW_DEPRECATED_INTERFACES defined, we need to Replace PcdSet## usage with PcdSet##S.

Normally, DynamicDefault PCD set is expected to be success, but DynamicHii PCD set failure is a legal case.
PcdTpmInitializationPolicy/PcdTcg2HashAlgorithmBitmap/PcdTpm2HashMask/PcdTpmInstanceGuid all have set operation in PEI phase,
PEI phase does not allow DynamicHii PCD set, so DynamicDefault is expected for them and use PcdSet##S to instead of PcdSet## and assert when set failure.

Cc: Jiewen Yao <jiewen.yao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Star Zeng <star.zeng@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18614 6f19259b-4bc3-4df7-8a09-765794883524
(cherry picked from commit fe3ca12d06a534e5f10587a52730f5fd43dab831)
---
 .../HashLibBaseCryptoRouter/HashLibBaseCryptoRouterDxe.c     | 4 +++-
 .../HashLibBaseCryptoRouter/HashLibBaseCryptoRouterPei.c     | 4 +++-
 SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigPeim.c                  | 3 ++-
 SecurityPkg/Tcg/Tcg2Config/TpmDetection.c                    | 3 ++-
 SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c                            | 3 ++-
 SecurityPkg/Tcg/TrEEConfig/TpmDetection.c                    | 5 +++--
 SecurityPkg/Tcg/TrEEConfig/TrEEConfigPeim.c                  | 3 ++-
 7 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterDxe.c b/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterDxe.c
index 89673373c41f..4f3c8dfa7c1f 100644
--- a/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterDxe.c
+++ b/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterDxe.c
@@ -205,6 +205,7 @@ RegisterHashInterfaceLib (
   UINTN              Index;
   UINT32             HashMask;
   UINT32             BiosSupportedHashMask;
+  EFI_STATUS         Status;
 
   //
   // Check allow
@@ -218,7 +219,8 @@ RegisterHashInterfaceLib (
     return EFI_OUT_OF_RESOURCES;
   }
   BiosSupportedHashMask = PcdGet32 (PcdTcg2HashAlgorithmBitmap);
-  PcdSet32 (PcdTcg2HashAlgorithmBitmap, BiosSupportedHashMask | HashMask);
+  Status = PcdSet32S (PcdTcg2HashAlgorithmBitmap, BiosSupportedHashMask | HashMask);
+  ASSERT_EFI_ERROR (Status);
 
   //
   // Check duplication
diff --git a/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterPei.c b/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterPei.c
index 98c07933d827..c3d487958b32 100644
--- a/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterPei.c
+++ b/SecurityPkg/Library/HashLibBaseCryptoRouter/HashLibBaseCryptoRouterPei.c
@@ -258,6 +258,7 @@ RegisterHashInterfaceLib (
   HASH_INTERFACE_HOB LocalHashInterfaceHob;
   UINT32             HashMask;
   UINT32             BiosSupportedHashMask;
+  EFI_STATUS         Status;
 
   //
   // Check allow
@@ -280,7 +281,8 @@ RegisterHashInterfaceLib (
     return EFI_OUT_OF_RESOURCES;
   }
   BiosSupportedHashMask = PcdGet32 (PcdTcg2HashAlgorithmBitmap);
-  PcdSet32 (PcdTcg2HashAlgorithmBitmap, BiosSupportedHashMask | HashMask);
+  Status = PcdSet32S (PcdTcg2HashAlgorithmBitmap, BiosSupportedHashMask | HashMask);
+  ASSERT_EFI_ERROR (Status);
 
   //
   // Check duplication
diff --git a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigPeim.c b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigPeim.c
index 34767c0f49fb..004c7efe70b6 100644
--- a/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigPeim.c
+++ b/SecurityPkg/Tcg/Tcg2Config/Tcg2ConfigPeim.c
@@ -132,7 +132,8 @@ Tcg2ConfigPeimEntryPoint (
   for (Index = 0; Index < sizeof(mTpmInstanceId)/sizeof(mTpmInstanceId[0]); Index++) {
     if (TpmDevice == mTpmInstanceId[Index].TpmDevice) {
       Size = sizeof(mTpmInstanceId[Index].TpmInstanceGuid);
-      PcdSetPtr (PcdTpmInstanceGuid, &Size, &mTpmInstanceId[Index].TpmInstanceGuid);
+      Status = PcdSetPtrS (PcdTpmInstanceGuid, &Size, &mTpmInstanceId[Index].TpmInstanceGuid);
+      ASSERT_EFI_ERROR (Status);
       DEBUG ((EFI_D_INFO, "TpmDevice PCD: %g\n", &mTpmInstanceId[Index].TpmInstanceGuid));
       break;
     }
diff --git a/SecurityPkg/Tcg/Tcg2Config/TpmDetection.c b/SecurityPkg/Tcg/Tcg2Config/TpmDetection.c
index 9e93e9c2d930..33f3a21d87b6 100644
--- a/SecurityPkg/Tcg/Tcg2Config/TpmDetection.c
+++ b/SecurityPkg/Tcg/Tcg2Config/TpmDetection.c
@@ -124,6 +124,7 @@ DetectTpmDevice (
   }
 
   // NO initialization needed again.
-  PcdSet8 (PcdTpmInitializationPolicy, 0);
+  Status = PcdSet8S (PcdTpmInitializationPolicy, 0);
+  ASSERT_EFI_ERROR (Status);
   return TPM_DEVICE_1_2;
 }
diff --git a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
index 3743bfbb1117..63045f1c5903 100644
--- a/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
+++ b/SecurityPkg/Tcg/Tcg2Pei/Tcg2Pei.c
@@ -410,7 +410,8 @@ SetTpm2HashMask (
       }
     }
   }
-  PcdSet32 (PcdTpm2HashMask, ActivePcrBanks);
+  Status = PcdSet32S (PcdTpm2HashMask, ActivePcrBanks);
+  ASSERT_EFI_ERROR (Status);
 }
 
 /**
diff --git a/SecurityPkg/Tcg/TrEEConfig/TpmDetection.c b/SecurityPkg/Tcg/TrEEConfig/TpmDetection.c
index 3706c2c96793..54b1ff1128d5 100644
--- a/SecurityPkg/Tcg/TrEEConfig/TpmDetection.c
+++ b/SecurityPkg/Tcg/TrEEConfig/TpmDetection.c
@@ -1,7 +1,7 @@
 /** @file
   TPM1.2/dTPM2.0 auto detection.
 
-Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2013 - 2015, Intel Corporation. All rights reserved.<BR>
 This program and the accompanying materials 
 are licensed and made available under the terms and conditions of the BSD License 
 which accompanies this distribution.  The full text of the license may be found at 
@@ -124,6 +124,7 @@ DetectTpmDevice (
   }
 
   // NO initialization needed again.
-  PcdSet8 (PcdTpmInitializationPolicy, 0);
+  Status = PcdSet8S (PcdTpmInitializationPolicy, 0);
+  ASSERT_EFI_ERROR (Status);
   return TPM_DEVICE_1_2;
 }
diff --git a/SecurityPkg/Tcg/TrEEConfig/TrEEConfigPeim.c b/SecurityPkg/Tcg/TrEEConfig/TrEEConfigPeim.c
index efe40bc3ce25..b4a3d523479d 100644
--- a/SecurityPkg/Tcg/TrEEConfig/TrEEConfigPeim.c
+++ b/SecurityPkg/Tcg/TrEEConfig/TrEEConfigPeim.c
@@ -132,7 +132,8 @@ TrEEConfigPeimEntryPoint (
   for (Index = 0; Index < sizeof(mTpmInstanceId)/sizeof(mTpmInstanceId[0]); Index++) {
     if (TpmDevice == mTpmInstanceId[Index].TpmDevice) {
       Size = sizeof(mTpmInstanceId[Index].TpmInstanceGuid);
-      PcdSetPtr (PcdTpmInstanceGuid, &Size, &mTpmInstanceId[Index].TpmInstanceGuid);
+      Status = PcdSetPtrS (PcdTpmInstanceGuid, &Size, &mTpmInstanceId[Index].TpmInstanceGuid);
+      ASSERT_EFI_ERROR (Status);
       DEBUG ((EFI_D_INFO, "TpmDevice PCD: %g\n", &mTpmInstanceId[Index].TpmInstanceGuid));
       break;
     }

From 3eb9d5cc5d91bcd1f14ea591b68dd1e69e5eb416 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 25 Feb 2016 09:14:29 +0800
Subject: [PATCH 516/525] MdeModulePkg/PciHostBridge: Refine function header
 comments.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Shumin Qiu <shumin.qiu@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
(cherry picked from commit 63b90643afb19f84e4cd3681a9a402ec65b1cf8d)
---
 .../Bus/Pci/PciHostBridgeDxe/PciHostBridge.c  |  14 ++
 .../Bus/Pci/PciHostBridgeDxe/PciHostBridge.h  |  26 ++--
 .../Bus/Pci/PciHostBridgeDxe/PciRootBridge.h  | 141 ++++++++++--------
 .../Pci/PciHostBridgeDxe/PciRootBridgeIo.c    |   3 -
 4 files changed, 103 insertions(+), 81 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
index 08285d84d501..edf042cc2547 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
@@ -258,6 +258,19 @@ ResourceConflict (
   FreePool (Resources);
 }
 
+/**
+  Allocate Length of MMIO or IO resource with alignment BitsOfAlignment
+  from GCD range [BaseAddress, Limit).
+
+  @param Mmio            TRUE for MMIO and FALSE for IO.
+  @param Length          Length of the resource to allocate.
+  @param BitsOfAlignment Alignment of the resource to allocate.
+  @param BaseAddress     The starting address the allocation is from.
+  @param Limit           The ending address the allocation is to.
+
+  @retval  The base address of the allocated resource or MAX_UINT64 if allocation
+           fails.
+**/
 UINT64
 AllocateResource (
   BOOLEAN Mmio,
@@ -306,6 +319,7 @@ AllocateResource (
   }
   return MAX_UINT64;
 }
+
 /**
 
   Enter a certain phase of the PCI enumeration process.
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
index 288823c7784a..9a8ca21f4819 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.h
@@ -65,12 +65,12 @@ InitializePciHostBridge (
 
   Enter a certain phase of the PCI enumeration process.
 
-  @param This   -  The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
-  @param Phase  -  The phase during enumeration.
+  @param This   The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL instance.
+  @param Phase  The phase during enumeration.
 
-  @retval EFI_SUCCESS            -  Succeed.
-  @retval EFI_INVALID_PARAMETER  -  Wrong phase parameter passed in.
-  @retval EFI_NOT_READY          -  Resources have not been submitted yet.
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_INVALID_PARAMETER  Wrong phase parameter passed in.
+  @retval EFI_NOT_READY          Resources have not been submitted yet.
 
 **/
 EFI_STATUS
@@ -85,15 +85,15 @@ NotifyPhase (
   Return the device handle of the next PCI root bridge that is associated with
   this Host Bridge.
 
-  @param This              - The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
-  RootBridgeHandle  -  Returns the device handle of the next PCI Root Bridge.
-                       On input, it holds the RootBridgeHandle returned by the most
-                       recent call to GetNextRootBridge().The handle for the first
-                       PCI Root Bridge is returned if RootBridgeHandle is NULL on input.
+  @param This              The EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_ PROTOCOL instance.
+  @param RootBridgeHandle  Returns the device handle of the next PCI Root Bridge.
+                           On input, it holds the RootBridgeHandle returned by the most
+                           recent call to GetNextRootBridge().The handle for the first
+                           PCI Root Bridge is returned if RootBridgeHandle is NULL on input.
 
-  @retval EFI_SUCCESS            -  Succeed.
-  @retval EFI_NOT_FOUND          -  Next PCI root bridge not found.
-  @retval EFI_INVALID_PARAMETER  -  Wrong parameter passed in.
+  @retval EFI_SUCCESS            Succeed.
+  @retval EFI_NOT_FOUND          Next PCI root bridge not found.
+  @retval EFI_INVALID_PARAMETER  Wrong parameter passed in.
 
 **/
 EFI_STATUS
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
index 2915981ea553..b1e83f1c9089 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
@@ -86,15 +86,13 @@ typedef struct {
 #define ROOT_BRIDGE_FROM_LINK(a) CR (a, PCI_ROOT_BRIDGE_INSTANCE, Link, PCI_ROOT_BRIDGE_SIGNATURE)
 
 /**
+  Construct the Pci Root Bridge instance.
 
-  Construct the Pci Root Bridge Io protocol.
-
-  @param Protocol          -  Protocol to initialize.
-  @param HostBridgeHandle  -  Handle to the HostBridge.
-
-  @retval EFI_SUCCESS  -  Success.
-  @retval Others       -  Fail.
+  @param Bridge            The root bridge instance.
+  @param HostBridgeHandle  Handle to the HostBridge.
 
+  @return The pointer to PCI_ROOT_BRIDGE_INSTANCE just created
+          or NULL if creation fails.
 **/
 PCI_ROOT_BRIDGE_INSTANCE *
 CreateRootBridge (
@@ -359,30 +357,25 @@ RootBridgeIoPciWrite (
 ;
 
 /**
-
   Provides the PCI controller-specific address needed to access
   system memory for DMA.
 
-  @param This           -  A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
-  @param Operation      -  Indicate if the bus master is going to read or write
-                           to system memory.
-  @param HostAddress    -  The system memory address to map on the PCI controller.
-  @param NumberOfBytes  -  On input the number of bytes to map.
-                           On output the number of bytes that were mapped.
-  @param DeviceAddress  -  The resulting map address for the bus master PCI
-                           controller to use to access the system memory's HostAddress.
-  @param Mapping        -  The value to pass to Unmap() when the bus master DMA
-                           operation is complete.
-
-  @retval EFI_SUCCESS            -  Success.
-  @retval EFI_INVALID_PARAMETER  -  Invalid parameters found.
-  @retval EFI_UNSUPPORTED        -  The HostAddress cannot be mapped as a common
-                            @retval buffer.
-  @retval EFI_DEVICE_ERROR       -  The System hardware could not map the requested
-                            @retval address.
-  @retval EFI_OUT_OF_RESOURCES   -  The request could not be completed due to
-                            @retval lack of resources.
-
+  @param This           A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Operation      Indicate if the bus master is going to read or write
+                        to system memory.
+  @param HostAddress    The system memory address to map on the PCI controller.
+  @param NumberOfBytes  On input the number of bytes to map.
+                        On output the number of bytes that were mapped.
+  @param DeviceAddress  The resulting map address for the bus master PCI
+                        controller to use to access the system memory's HostAddress.
+  @param Mapping        The value to pass to Unmap() when the bus master DMA
+                        operation is complete.
+
+  @retval EFI_SUCCESS            Success.
+  @retval EFI_INVALID_PARAMETER  Invalid parameters found.
+  @retval EFI_UNSUPPORTED        The HostAddress cannot be mapped as a common buffer.
+  @retval EFI_DEVICE_ERROR       The System hardware could not map the requested address.
+  @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to lack of resources.
 **/
 EFI_STATUS
 EFIAPI
@@ -397,18 +390,21 @@ RootBridgeIoMap (
 ;
 
 /**
-
   Completes the Map() operation and releases any corresponding resources.
 
-  @param This     -  Pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL instance.
-  Mapping  -  The value returned from Map() operation.
+  The Unmap() function completes the Map() operation and releases any
+  corresponding resources.
+  If the operation was an EfiPciOperationBusMasterWrite or
+  EfiPciOperationBusMasterWrite64, the data is committed to the target system
+  memory.
+  Any resources used for the mapping are freed.
 
-  @retval EFI_SUCCESS            -  The range was unmapped successfully.
-  @retval EFI_INVALID_PARAMETER  -  Mapping is not a value that was returned
-                            @retval by Map operation.
-  @retval EFI_DEVICE_ERROR       -  The data was not committed to the target
-                            @retval system memory.
+  @param[in] This      A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param[in] Mapping   The mapping value returned from Map().
 
+  @retval EFI_SUCCESS            The range was unmapped.
+  @retval EFI_INVALID_PARAMETER  Mapping is not a value that was returned by Map().
+  @retval EFI_DEVICE_ERROR       The data was not committed to the target system memory.
 **/
 EFI_STATUS
 EFIAPI
@@ -419,22 +415,30 @@ RootBridgeIoUnmap (
 ;
 
 /**
-
-  Allocates pages that are suitable for a common buffer mapping.
-
-  @param This         -  Pointer to EFI_ROOT_BRIDGE_IO_PROTOCOL instance.
-  @param Type         -  Not used and can be ignored.
-  @param MemoryType   -  Type of memory to allocate.
-  @param Pages        -  Number of pages to allocate.
-  @param HostAddress  -  Pointer to store the base system memory address
-                         of the allocated range.
-  @param Attributes   -  Requested bit mask of attributes of the allocated
-                         range.
-
-  @retval EFI_SUCCESS            -  The requested memory range were allocated.
-  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
-  @retval EFI_UNSUPPORTED        -  Attributes is unsupported.
-
+  Allocates pages that are suitable for an EfiPciOperationBusMasterCommonBuffer
+  or EfiPciOperationBusMasterCommonBuffer64 mapping.
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Type        This parameter is not used and must be ignored.
+  @param MemoryType  The type of memory to allocate, EfiBootServicesData or
+                     EfiRuntimeServicesData.
+  @param Pages       The number of pages to allocate.
+  @param HostAddress A pointer to store the base system memory address of the
+                     allocated range.
+  @param Attributes  The requested bit mask of attributes for the allocated
+                     range. Only the attributes
+                     EFI_PCI_ATTRIBUTE_MEMORY_WRITE_COMBINE,
+                     EFI_PCI_ATTRIBUTE_MEMORY_CACHED, and
+                     EFI_PCI_ATTRIBUTE_DUAL_ADDRESS_CYCLE may be used with this
+                     function.
+
+  @retval EFI_SUCCESS            The requested memory pages were allocated.
+  @retval EFI_INVALID_PARAMETER  MemoryType is invalid.
+  @retval EFI_INVALID_PARAMETER  HostAddress is NULL.
+  @retval EFI_UNSUPPORTED        Attributes is unsupported. The only legal
+                                 attribute bits are MEMORY_WRITE_COMBINE,
+                                 MEMORY_CACHED, and DUAL_ADDRESS_CYCLE.
+  @retval EFI_OUT_OF_RESOURCES   The memory pages could not be allocated.
 **/
 EFI_STATUS
 EFIAPI
@@ -491,19 +495,26 @@ RootBridgeIoFlush (
 ;
 
 /**
-
-  Get the attributes that a PCI root bridge supports and
-  the attributes the PCI root bridge is currently using.
-
-  @param This        -  Pointer to EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL
-                        instance.
-  @param Supports    -  A pointer to the mask of attributes that
-                        this PCI root bridge supports.
-  @param Attributes  -  A pointer to the mask of attributes that
-                        this PCI root bridge is currently using.
-  @retval EFI_SUCCESS            -  Success.
-  @retval EFI_INVALID_PARAMETER  -  Invalid parameter found.
-
+  Gets the attributes that a PCI root bridge supports setting with
+  SetAttributes(), and the attributes that a PCI root bridge is currently
+  using.
+
+  The GetAttributes() function returns the mask of attributes that this PCI
+  root bridge supports and the mask of attributes that the PCI root bridge is
+  currently using.
+
+  @param This        A pointer to the EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  @param Supported   A pointer to the mask of attributes that this PCI root
+                     bridge supports setting with SetAttributes().
+  @param Attributes  A pointer to the mask of attributes that this PCI root
+                     bridge is currently using.
+
+  @retval  EFI_SUCCESS           If Supports is not NULL, then the attributes
+                                 that the PCI root bridge supports is returned
+                                 in Supports. If Attributes is not NULL, then
+                                 the attributes that the PCI root bridge is
+                                 currently using is returned in Attributes.
+  @retval  EFI_INVALID_PARAMETER Both Supports and Attributes are NULL.
 **/
 EFI_STATUS
 EFIAPI
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
index 6a9294d3495b..332860eb3819 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
@@ -399,7 +399,6 @@ RootBridgeIoCheckParameter (
   @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to a
                                  lack of resources.
 **/
-
 EFI_STATUS
 EFIAPI
 RootBridgeIoPollMem (
@@ -987,7 +986,6 @@ RootBridgeIoPciWrite (
 }
 
 /**
-
   Provides the PCI controller-specific address needed to access
   system memory for DMA.
 
@@ -1007,7 +1005,6 @@ RootBridgeIoPciWrite (
   @retval EFI_UNSUPPORTED        The HostAddress cannot be mapped as a common buffer.
   @retval EFI_DEVICE_ERROR       The System hardware could not map the requested address.
   @retval EFI_OUT_OF_RESOURCES   The request could not be completed due to lack of resources.
-
 **/
 EFI_STATUS
 EFIAPI

From 414f7e3bc26ce01128fc36c5829a40d5db9f6be9 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 25 Feb 2016 17:13:31 +0800
Subject: [PATCH 517/525] MdeModulePkg/PciHostBridge: Don't assume resources
 are fully NonExistent

The patch removes the assumption that the resources claimed by root
bridges should not exist. Because resources might have been added:
1. by platform modules either in PEI through resource HOB, or in DXE,
   before the PCI host bridge driver runs.
2. Resources claimed by different root bridges may overlap so that
   resource adding operation for latter root bridges may fail if
   we assume the resource should not exist.

In real world, this patch is to fit OVMF platform needs because
different root bridges in OVMF platform shares the same resources.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
[lersek@redhat.com: intersection-based implementation]
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>

(cherry picked from commit 6474f1f156eefa6886e594039f4d562e374ba344)
---
 .../Bus/Pci/PciHostBridgeDxe/PciHostBridge.c  | 305 +++++++++++++++++-
 1 file changed, 294 insertions(+), 11 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
index edf042cc2547..ef0c4f2a5e7b 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
@@ -28,6 +28,290 @@ GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *mPciResourceTypeStr[] = {
   L"I/O", L"Mem", L"PMem", L"Mem64", L"PMem64", L"Bus"
 };
 
+/**
+  Ensure the compatibility of an IO space descriptor with the IO aperture.
+
+  The IO space descriptor can come from the GCD IO space map, or it can
+  represent a gap between two neighboring IO space descriptors. In the latter
+  case, the GcdIoType field is expected to be EfiGcdIoTypeNonExistent.
+
+  If the IO space descriptor already has type EfiGcdIoTypeIo, then no action is
+  taken -- it is by definition compatible with the aperture.
+
+  Otherwise, the intersection of the IO space descriptor is calculated with the
+  aperture. If the intersection is the empty set (no overlap), no action is
+  taken; the IO space descriptor is compatible with the aperture.
+
+  Otherwise, the type of the descriptor is investigated again. If the type is
+  EfiGcdIoTypeNonExistent (representing a gap, or a genuine descriptor with
+  such a type), then an attempt is made to add the intersection as IO space to
+  the GCD IO space map. This ensures continuity for the aperture, and the
+  descriptor is deemed compatible with the aperture.
+
+  Otherwise, the IO space descriptor is incompatible with the IO aperture.
+
+  @param[in] Base        Base address of the aperture.
+  @param[in] Length      Length of the aperture.
+  @param[in] Descriptor  The descriptor to ensure compatibility with the
+                         aperture for.
+
+  @retval EFI_SUCCESS            The descriptor is compatible. The GCD IO space
+                                 map may have been updated, for continuity
+                                 within the aperture.
+  @retval EFI_INVALID_PARAMETER  The descriptor is incompatible.
+  @return                        Error codes from gDS->AddIoSpace().
+**/
+EFI_STATUS
+IntersectIoDescriptor (
+  IN  UINT64                            Base,
+  IN  UINT64                            Length,
+  IN  CONST EFI_GCD_IO_SPACE_DESCRIPTOR *Descriptor
+  )
+{
+  UINT64                                IntersectionBase;
+  UINT64                                IntersectionEnd;
+  EFI_STATUS                            Status;
+
+  if (Descriptor->GcdIoType == EfiGcdIoTypeIo) {
+    return EFI_SUCCESS;
+  }
+
+  IntersectionBase = MAX (Base, Descriptor->BaseAddress);
+  IntersectionEnd = MIN (Base + Length,
+                      Descriptor->BaseAddress + Descriptor->Length);
+  if (IntersectionBase >= IntersectionEnd) {
+    //
+    // The descriptor and the aperture don't overlap.
+    //
+    return EFI_SUCCESS;
+  }
+
+  if (Descriptor->GcdIoType == EfiGcdIoTypeNonExistent) {
+    Status = gDS->AddIoSpace (EfiGcdIoTypeIo, IntersectionBase,
+                    IntersectionEnd - IntersectionBase);
+
+    DEBUG ((EFI_ERROR (Status) ? EFI_D_ERROR : EFI_D_VERBOSE,
+      "%a: %a: add [%Lx, %Lx): %r\n", gEfiCallerBaseName, __FUNCTION__,
+      IntersectionBase, IntersectionEnd, Status));
+    return Status;
+  }
+
+  DEBUG ((EFI_D_ERROR, "%a: %a: desc [%Lx, %Lx) type %u conflicts with "
+    "aperture [%Lx, %Lx)\n", gEfiCallerBaseName, __FUNCTION__,
+    Descriptor->BaseAddress, Descriptor->BaseAddress + Descriptor->Length,
+    (UINT32)Descriptor->GcdIoType, Base, Base + Length));
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  Add IO space to GCD.
+  The routine checks the GCD database and only adds those which are
+  not added in the specified range to GCD.
+
+  @param Base   Base address of the IO space.
+  @param Length Length of the IO space.
+
+  @retval EFI_SUCCES The IO space was added successfully.
+**/
+EFI_STATUS
+AddIoSpace (
+  IN  UINT64                        Base,
+  IN  UINT64                        Length
+  )
+{
+  EFI_STATUS                        Status;
+  UINTN                             Index;
+  UINTN                             NumberOfDescriptors;
+  EFI_GCD_IO_SPACE_DESCRIPTOR       *IoSpaceMap;
+
+  Status = gDS->GetIoSpaceMap (&NumberOfDescriptors, &IoSpaceMap);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "%a: %a: GetIoSpaceMap(): %r\n",
+      gEfiCallerBaseName, __FUNCTION__, Status));
+    return Status;
+  }
+
+  for (Index = 0; Index < NumberOfDescriptors; Index++) {
+    Status = IntersectIoDescriptor (Base, Length, &IoSpaceMap[Index]);
+    if (EFI_ERROR (Status)) {
+      goto FreeIoSpaceMap;
+    }
+  }
+
+  DEBUG_CODE (
+    //
+    // Make sure there are adjacent descriptors covering [Base, Base + Length).
+    // It is possible that they have not been merged; merging can be prevented
+    // by allocation.
+    //
+    UINT64                      CheckBase;
+    EFI_STATUS                  CheckStatus;
+    EFI_GCD_IO_SPACE_DESCRIPTOR Descriptor;
+
+    for (CheckBase = Base;
+         CheckBase < Base + Length;
+         CheckBase = Descriptor.BaseAddress + Descriptor.Length) {
+      CheckStatus = gDS->GetIoSpaceDescriptor (CheckBase, &Descriptor);
+      ASSERT_EFI_ERROR (CheckStatus);
+      ASSERT (Descriptor.GcdIoType == EfiGcdIoTypeIo);
+    }
+    );
+
+FreeIoSpaceMap:
+  FreePool (IoSpaceMap);
+
+  return Status;
+}
+
+/**
+  Ensure the compatibility of a memory space descriptor with the MMIO aperture.
+
+  The memory space descriptor can come from the GCD memory space map, or it can
+  represent a gap between two neighboring memory space descriptors. In the
+  latter case, the GcdMemoryType field is expected to be
+  EfiGcdMemoryTypeNonExistent.
+
+  If the memory space descriptor already has type
+  EfiGcdMemoryTypeMemoryMappedIo, and its capabilities are a superset of the
+  required capabilities, then no action is taken -- it is by definition
+  compatible with the aperture.
+
+  Otherwise, the intersection of the memory space descriptor is calculated with
+  the aperture. If the intersection is the empty set (no overlap), no action is
+  taken; the memory space descriptor is compatible with the aperture.
+
+  Otherwise, the type of the descriptor is investigated again. If the type is
+  EfiGcdMemoryTypeNonExistent (representing a gap, or a genuine descriptor with
+  such a type), then an attempt is made to add the intersection as MMIO space
+  to the GCD memory space map, with the specified capabilities. This ensures
+  continuity for the aperture, and the descriptor is deemed compatible with the
+  aperture.
+
+  Otherwise, the memory space descriptor is incompatible with the MMIO
+  aperture.
+
+  @param[in] Base         Base address of the aperture.
+  @param[in] Length       Length of the aperture.
+  @param[in] Capabilities Capabilities required by the aperture.
+  @param[in] Descriptor   The descriptor to ensure compatibility with the
+                          aperture for.
+
+  @retval EFI_SUCCESS            The descriptor is compatible. The GCD memory
+                                 space map may have been updated, for
+                                 continuity within the aperture.
+  @retval EFI_INVALID_PARAMETER  The descriptor is incompatible.
+  @return                        Error codes from gDS->AddMemorySpace().
+**/
+EFI_STATUS
+IntersectMemoryDescriptor (
+  IN  UINT64                                Base,
+  IN  UINT64                                Length,
+  IN  UINT64                                Capabilities,
+  IN  CONST EFI_GCD_MEMORY_SPACE_DESCRIPTOR *Descriptor
+  )
+{
+  UINT64                                    IntersectionBase;
+  UINT64                                    IntersectionEnd;
+  EFI_STATUS                                Status;
+
+  if (Descriptor->GcdMemoryType == EfiGcdMemoryTypeMemoryMappedIo &&
+      (Descriptor->Capabilities & Capabilities) == Capabilities) {
+    return EFI_SUCCESS;
+  }
+
+  IntersectionBase = MAX (Base, Descriptor->BaseAddress);
+  IntersectionEnd = MIN (Base + Length,
+                      Descriptor->BaseAddress + Descriptor->Length);
+  if (IntersectionBase >= IntersectionEnd) {
+    //
+    // The descriptor and the aperture don't overlap.
+    //
+    return EFI_SUCCESS;
+  }
+
+  if (Descriptor->GcdMemoryType == EfiGcdMemoryTypeNonExistent) {
+    Status = gDS->AddMemorySpace (EfiGcdMemoryTypeMemoryMappedIo,
+                    IntersectionBase, IntersectionEnd - IntersectionBase,
+                    Capabilities);
+
+    DEBUG ((EFI_ERROR (Status) ? EFI_D_ERROR : EFI_D_VERBOSE,
+      "%a: %a: add [%Lx, %Lx): %r\n", gEfiCallerBaseName, __FUNCTION__,
+      IntersectionBase, IntersectionEnd, Status));
+    return Status;
+  }
+
+  DEBUG ((EFI_D_ERROR, "%a: %a: desc [%Lx, %Lx) type %u cap %Lx conflicts "
+    "with aperture [%Lx, %Lx) cap %Lx\n", gEfiCallerBaseName, __FUNCTION__,
+    Descriptor->BaseAddress, Descriptor->BaseAddress + Descriptor->Length,
+    (UINT32)Descriptor->GcdMemoryType, Descriptor->Capabilities,
+    Base, Base + Length, Capabilities));
+  return EFI_INVALID_PARAMETER;
+}
+
+/**
+  Add MMIO space to GCD.
+  The routine checks the GCD database and only adds those which are
+  not added in the specified range to GCD.
+
+  @param Base         Base address of the MMIO space.
+  @param Length       Length of the MMIO space.
+  @param Capabilities Capabilities of the MMIO space.
+
+  @retval EFI_SUCCES The MMIO space was added successfully.
+**/
+EFI_STATUS
+AddMemoryMappedIoSpace (
+  IN  UINT64                            Base,
+  IN  UINT64                            Length,
+  IN  UINT64                            Capabilities
+  )
+{
+  EFI_STATUS                            Status;
+  UINTN                                 Index;
+  UINTN                                 NumberOfDescriptors;
+  EFI_GCD_MEMORY_SPACE_DESCRIPTOR       *MemorySpaceMap;
+
+  Status = gDS->GetMemorySpaceMap (&NumberOfDescriptors, &MemorySpaceMap);
+  if (EFI_ERROR (Status)) {
+    DEBUG ((EFI_D_ERROR, "%a: %a: GetMemorySpaceMap(): %r\n",
+      gEfiCallerBaseName, __FUNCTION__, Status));
+    return Status;
+  }
+
+  for (Index = 0; Index < NumberOfDescriptors; Index++) {
+    Status = IntersectMemoryDescriptor (Base, Length, Capabilities,
+               &MemorySpaceMap[Index]);
+    if (EFI_ERROR (Status)) {
+      goto FreeMemorySpaceMap;
+    }
+  }
+
+  DEBUG_CODE (
+    //
+    // Make sure there are adjacent descriptors covering [Base, Base + Length).
+    // It is possible that they have not been merged; merging can be prevented
+    // by allocation and different capabilities.
+    //
+    UINT64                          CheckBase;
+    EFI_STATUS                      CheckStatus;
+    EFI_GCD_MEMORY_SPACE_DESCRIPTOR Descriptor;
+
+    for (CheckBase = Base;
+         CheckBase < Base + Length;
+         CheckBase = Descriptor.BaseAddress + Descriptor.Length) {
+      CheckStatus = gDS->GetMemorySpaceDescriptor (CheckBase, &Descriptor);
+      ASSERT_EFI_ERROR (CheckStatus);
+      ASSERT (Descriptor.GcdMemoryType == EfiGcdMemoryTypeMemoryMappedIo);
+      ASSERT ((Descriptor.Capabilities & Capabilities) == Capabilities);
+    }
+    );
+
+FreeMemorySpaceMap:
+  FreePool (MemorySpaceMap);
+
+  return Status;
+}
+
 /**
 
   Entry point of this driver.
@@ -89,6 +373,7 @@ InitializePciHostBridge (
                   &gEfiPciHostBridgeResourceAllocationProtocolGuid, &HostBridge->ResAlloc,
                   NULL
                   );
+  ASSERT_EFI_ERROR (Status);
   if (EFI_ERROR (Status)) {
     FreePool (HostBridge);
     PciHostBridgeFreeRootBridges (RootBridges, RootBridgeCount);
@@ -109,11 +394,10 @@ InitializePciHostBridge (
     }
 
     if (RootBridges[Index].Io.Limit > RootBridges[Index].Io.Base) {
-      Status = gDS->AddIoSpace (
-                      EfiGcdIoTypeIo,
-                      RootBridges[Index].Io.Base,
-                      RootBridges[Index].Io.Limit - RootBridges[Index].Io.Base + 1
-                      );
+      Status = AddIoSpace (
+                 RootBridges[Index].Io.Base,
+                 RootBridges[Index].Io.Limit - RootBridges[Index].Io.Base + 1
+                 );
       ASSERT_EFI_ERROR (Status);
     }
 
@@ -130,12 +414,11 @@ InitializePciHostBridge (
 
     for (MemApertureIndex = 0; MemApertureIndex < sizeof (MemApertures) / sizeof (MemApertures[0]); MemApertureIndex++) {
       if (MemApertures[MemApertureIndex]->Limit > MemApertures[MemApertureIndex]->Base) {
-        Status = gDS->AddMemorySpace (
-                        EfiGcdMemoryTypeMemoryMappedIo,
-                        MemApertures[MemApertureIndex]->Base,
-                        MemApertures[MemApertureIndex]->Limit - MemApertures[MemApertureIndex]->Base + 1,
-                        EFI_MEMORY_UC
-                        );
+        Status = AddMemoryMappedIoSpace (
+                   MemApertures[MemApertureIndex]->Base,
+                   MemApertures[MemApertureIndex]->Limit - MemApertures[MemApertureIndex]->Base + 1,
+                   EFI_MEMORY_UC
+                   );
         ASSERT_EFI_ERROR (Status);
         Status = gDS->SetMemorySpaceAttributes (
                         MemApertures[MemApertureIndex]->Base,

From 00ddfc7f540ff83fc223b5a61e927f016ad399b4 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Mon, 25 Jan 2016 20:47:35 +0100
Subject: [PATCH 518/525] MdeModulePkg: PciHostBridgeLibNull: rewrap source to
 79 characters

Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Marcel Apfelbaum <marcel@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
(cherry picked from commit 9b6b938538076116768ee9b8e4d52d0cb51dcc8c)
---
 .../PciHostBridgeLibNull.c                    | 50 ++++++++++++-------
 .../PciHostBridgeLibNull.inf                  | 12 +++--
 2 files changed, 38 insertions(+), 24 deletions(-)

diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
index 41861b0c535a..fe0632dd3552 100644
--- a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
@@ -2,21 +2,22 @@
   Null instance of PCI Host Bridge Library with empty functions.
 
   Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
-  This program and the accompanying materials are
-  licensed and made available under the terms and conditions of
-  the BSD License which accompanies this distribution.  The full
-  text of the license may be found at
+
+  This program and the accompanying materials are licensed and made available
+  under the terms and conditions of the BSD License which accompanies this
+  distribution.  The full text of the license may be found at
   http://opensource.org/licenses/bsd-license.php.
 
-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT
+  WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 
 **/
 #include <PiDxe.h>
 #include <Library/PciHostBridgeLib.h>
 #include <Library/DebugLib.h>
 
-GLOBAL_REMOVE_IF_UNREFERENCED CHAR16 *mPciHostBridgeLibAcpiAddressSpaceTypeStr[] = {
+GLOBAL_REMOVE_IF_UNREFERENCED
+CHAR16 *mPciHostBridgeLibAcpiAddressSpaceTypeStr[] = {
   L"Mem", L"I/O", L"Bus"
 };
 
@@ -40,7 +41,8 @@ PciHostBridgeGetRootBridges (
 }
 
 /**
-  Free the root bridge instances array returned from PciHostBridgeGetRootBridges().
+  Free the root bridge instances array returned from
+  PciHostBridgeGetRootBridges().
 
   @param  The root bridge instances array.
   @param  The count of the array.
@@ -59,13 +61,15 @@ PciHostBridgeFreeRootBridges (
   Inform the platform that the resource conflict happens.
 
   @param HostBridgeHandle Handle of the Host Bridge.
-  @param Configuration    Pointer to PCI I/O and PCI memory resource descriptors.
-                          The Configuration contains the resources for all the
-                          root bridges. The resource for each root bridge is
-                          terminated with END descriptor and an additional END
-                          is appended indicating the end of the entire resources.
-                          The resource descriptor field values follow the description
-                          in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.SubmitResources().
+  @param Configuration    Pointer to PCI I/O and PCI memory resource
+                          descriptors. The Configuration contains the resources
+                          for all the root bridges. The resource for each root
+                          bridge is terminated with END descriptor and an
+                          additional END is appended indicating the end of the
+                          entire resources. The resource descriptor field
+                          values follow the description in
+                          EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL
+                          .SubmitResources().
 **/
 VOID
 EFIAPI
@@ -84,14 +88,20 @@ PciHostBridgeResourceConflict (
     DEBUG ((EFI_D_ERROR, "RootBridge[%d]:\n", RootBridgeIndex++));
     for (; Descriptor->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR; Descriptor++) {
       ASSERT (Descriptor->ResType <
-              sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr) / sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr[0])
+              (sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr) /
+               sizeof (mPciHostBridgeLibAcpiAddressSpaceTypeStr[0])
+               )
               );
       DEBUG ((EFI_D_ERROR, " %s: Length/Alignment = 0x%lx / 0x%lx\n",
-              mPciHostBridgeLibAcpiAddressSpaceTypeStr[Descriptor->ResType], Descriptor->AddrLen, Descriptor->AddrRangeMax));
+              mPciHostBridgeLibAcpiAddressSpaceTypeStr[Descriptor->ResType],
+              Descriptor->AddrLen, Descriptor->AddrRangeMax
+              ));
       if (Descriptor->ResType == ACPI_ADDRESS_SPACE_TYPE_MEM) {
         DEBUG ((EFI_D_ERROR, "     Granularity/SpecificFlag = %ld / %02x%s\n",
                 Descriptor->AddrSpaceGranularity, Descriptor->SpecificFlag,
-                ((Descriptor->SpecificFlag & EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE) != 0) ? L" (Prefetchable)" : L""
+                ((Descriptor->SpecificFlag &
+                  EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE
+                  ) != 0) ? L" (Prefetchable)" : L""
                 ));
       }
     }
@@ -99,6 +109,8 @@ PciHostBridgeResourceConflict (
     // Skip the END descriptor for root bridge
     //
     ASSERT (Descriptor->Desc == ACPI_END_TAG_DESCRIPTOR);
-    Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *) ((EFI_ACPI_END_TAG_DESCRIPTOR *) Descriptor + 1);
+    Descriptor = (EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *)(
+                   (EFI_ACPI_END_TAG_DESCRIPTOR *)Descriptor + 1
+                   );
   }
 }
diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
index 6b3021184493..8df14924add3 100644
--- a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.inf
@@ -3,12 +3,13 @@
 #
 #  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>
 #
-#  This program and the accompanying materials
-#  are licensed and made available under the terms and conditions of the BSD License
-#  which accompanies this distribution. The full text of the license may be found at
+#  This program and the accompanying materials are licensed and made available
+#  under the terms and conditions of the BSD License which accompanies this
+#  distribution. The full text of the license may be found at
 #  http://opensource.org/licenses/bsd-license.php
 #  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+#  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR
+#  IMPLIED.
 #
 #
 ##
@@ -23,7 +24,8 @@
   LIBRARY_CLASS                  = PciHostBridgeLib
 
 #
-# The following information is for reference only and not required by the build tools.
+# The following information is for reference only and not required by the build
+# tools.
 #
 #  VALID_ARCHITECTURES           = IA32 X64 IPF EBC
 #

From 3f125f4e8b2c673b4617661edff28fa5997bf838 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Tue, 1 Mar 2016 11:04:59 +0100
Subject: [PATCH 519/525] MdeModulePkg: PciHostBridgeDxe: insert horizontal
 whitespace

... in preparation for the next patch.

Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
(cherry picked from commit 3da829657e67d01e39eb6cf8ef9754043271e2e7)
---
 .../Pci/PciHostBridgeDxe/PciRootBridgeIo.c    | 18 ++++-----
 .../Include/Library/PciHostBridgeLib.h        | 40 +++++++++----------
 2 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
index 332860eb3819..932aefd5d621 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
@@ -78,18 +78,18 @@ CreateRootBridge (
 
   DEBUG ((EFI_D_INFO, "RootBridge: "));
   DEBUG ((EFI_D_INFO, "%s\n", DevicePathStr = ConvertDevicePathToText (Bridge->DevicePath, FALSE, FALSE)));
-  DEBUG ((EFI_D_INFO, "Support/Attr: %lx / %lx\n", Bridge->Supports, Bridge->Attributes));
-  DEBUG ((EFI_D_INFO, "  DmaAbove4G: %s\n", Bridge->DmaAbove4G ? L"Yes" : L"No"));
-  DEBUG ((EFI_D_INFO, "   AllocAttr: %lx (%s%s)\n", Bridge->AllocationAttributes,
+  DEBUG ((EFI_D_INFO, "  Support/Attr: %lx / %lx\n", Bridge->Supports, Bridge->Attributes));
+  DEBUG ((EFI_D_INFO, "    DmaAbove4G: %s\n", Bridge->DmaAbove4G ? L"Yes" : L"No"));
+  DEBUG ((EFI_D_INFO, "     AllocAttr: %lx (%s%s)\n", Bridge->AllocationAttributes,
           (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0 ? L"CombineMemPMem " : L"",
           (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) != 0 ? L"Mem64Decode" : L""
           ));
-  DEBUG ((EFI_D_INFO, "         Bus: %lx - %lx\n", Bridge->Bus.Base, Bridge->Bus.Limit));
-  DEBUG ((EFI_D_INFO, "          Io: %lx - %lx\n", Bridge->Io.Base, Bridge->Io.Limit));
-  DEBUG ((EFI_D_INFO, "         Mem: %lx - %lx\n", Bridge->Mem.Base, Bridge->Mem.Limit));
-  DEBUG ((EFI_D_INFO, "  MemAbove4G: %lx - %lx\n", Bridge->MemAbove4G.Base, Bridge->MemAbove4G.Limit));
-  DEBUG ((EFI_D_INFO, "        PMem: %lx - %lx\n", Bridge->PMem.Base, Bridge->PMem.Limit));
-  DEBUG ((EFI_D_INFO, " PMemAbove4G: %lx - %lx\n", Bridge->PMemAbove4G.Base, Bridge->PMemAbove4G.Limit));
+  DEBUG ((EFI_D_INFO, "           Bus: %lx - %lx\n", Bridge->Bus.Base, Bridge->Bus.Limit));
+  DEBUG ((EFI_D_INFO, "            Io: %lx - %lx\n", Bridge->Io.Base, Bridge->Io.Limit));
+  DEBUG ((EFI_D_INFO, "           Mem: %lx - %lx\n", Bridge->Mem.Base, Bridge->Mem.Limit));
+  DEBUG ((EFI_D_INFO, "    MemAbove4G: %lx - %lx\n", Bridge->MemAbove4G.Base, Bridge->MemAbove4G.Limit));
+  DEBUG ((EFI_D_INFO, "          PMem: %lx - %lx\n", Bridge->PMem.Base, Bridge->PMem.Limit));
+  DEBUG ((EFI_D_INFO, "   PMemAbove4G: %lx - %lx\n", Bridge->PMemAbove4G.Base, Bridge->PMemAbove4G.Limit));
 
   //
   // Make sure Mem and MemAbove4G apertures are valid
diff --git a/MdeModulePkg/Include/Library/PciHostBridgeLib.h b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
index b1dba0f754d7..16ad104a9368 100644
--- a/MdeModulePkg/Include/Library/PciHostBridgeLib.h
+++ b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
@@ -25,26 +25,26 @@ typedef struct {
 } PCI_ROOT_BRIDGE_APERTURE;
 
 typedef struct {
-  UINT32                   Segment;              ///< Segment number.
-  UINT64                   Supports;             ///< Supported attributes.
-                                                 ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
-                                                 ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
-  UINT64                   Attributes;           ///< Initial attributes.
-                                                 ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
-                                                 ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
-  BOOLEAN                  DmaAbove4G;           ///< DMA above 4GB memory.
-                                                 ///< Set to TRUE when root bridge supports DMA above 4GB memory.
-  UINT64                   AllocationAttributes; ///< Allocation attributes.
-                                                 ///< Refer to EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM and
-                                                 ///< EFI_PCI_HOST_BRIDGE_MEM64_DECODE used by GetAllocAttributes()
-                                                 ///< in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.
-  PCI_ROOT_BRIDGE_APERTURE Bus;                  ///< Bus aperture which can be used by the root bridge.
-  PCI_ROOT_BRIDGE_APERTURE Io;                   ///< IO aperture which can be used by the root bridge.
-  PCI_ROOT_BRIDGE_APERTURE Mem;                  ///< MMIO aperture below 4GB which can be used by the root bridge.
-  PCI_ROOT_BRIDGE_APERTURE MemAbove4G;           ///< MMIO aperture above 4GB which can be used by the root bridge.
-  PCI_ROOT_BRIDGE_APERTURE PMem;                 ///< Prefetchable MMIO aperture below 4GB which can be used by the root bridge.
-  PCI_ROOT_BRIDGE_APERTURE PMemAbove4G;          ///< Prefetchable MMIO aperture above 4GB which can be used by the root bridge.
-  EFI_DEVICE_PATH_PROTOCOL *DevicePath;          ///< Device path.
+  UINT32                   Segment;               ///< Segment number.
+  UINT64                   Supports;              ///< Supported attributes.
+                                                  ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
+                                                  ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  UINT64                   Attributes;            ///< Initial attributes.
+                                                  ///< Refer to EFI_PCI_ATTRIBUTE_xxx used by GetAttributes()
+                                                  ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
+  BOOLEAN                  DmaAbove4G;            ///< DMA above 4GB memory.
+                                                  ///< Set to TRUE when root bridge supports DMA above 4GB memory.
+  UINT64                   AllocationAttributes;  ///< Allocation attributes.
+                                                  ///< Refer to EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM and
+                                                  ///< EFI_PCI_HOST_BRIDGE_MEM64_DECODE used by GetAllocAttributes()
+                                                  ///< in EFI_PCI_HOST_BRIDGE_RESOURCE_ALLOCATION_PROTOCOL.
+  PCI_ROOT_BRIDGE_APERTURE Bus;                   ///< Bus aperture which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE Io;                    ///< IO aperture which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE Mem;                   ///< MMIO aperture below 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE MemAbove4G;            ///< MMIO aperture above 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE PMem;                  ///< Prefetchable MMIO aperture below 4GB which can be used by the root bridge.
+  PCI_ROOT_BRIDGE_APERTURE PMemAbove4G;           ///< Prefetchable MMIO aperture above 4GB which can be used by the root bridge.
+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;           ///< Device path.
 } PCI_ROOT_BRIDGE;
 
 /**

From 6e51208f8b6e580b2ffa4ca00dd3668bf50de563 Mon Sep 17 00:00:00 2001
From: Laszlo Ersek <lersek@redhat.com>
Date: Fri, 26 Feb 2016 23:09:46 +0100
Subject: [PATCH 520/525] MdeModulePkg: PciHostBridgeDxe: don't assume extended
 config space

The "pc" ("pc-i440fx-*") machine types of QEMU don't support extended
config space. Accordingly, OVMF will use the following library instances
in connection with the core PciHostBridgeDxe driver:

  BasePciSegmentLibPci [class: PciSegmentLib]
    BasePciLibCf8      [class: PciLib]
      BasePciCf8Lib    [class: PciCf8Lib]

Add a new field to the PCI_ROOT_BRIDGE structure so that
RootBridgeIoCheckParameter() can catch config space offsets above 0xFF on
such old (emulated) platforms.

Cc: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Marcel Apfelbaum <marcel@redhat.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
Reviewed-by: Jordan Justen <jordan.l.justen@intel.com>
Reviewed-by: Marcel Apfelbaum <marcel@redhat.com>
Reviewed-by: Ruiyu Ni <ruiyu.ni@intel.com>
(cherry picked from commit 014b472053ae31e6b9fcdb5d4ee01e29b4d44fd4)
---
 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h   | 1 +
 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c | 4 +++-
 MdeModulePkg/Include/Library/PciHostBridgeLib.h         | 4 ++++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
index b1e83f1c9089..aa3f43a511c4 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridge.h
@@ -72,6 +72,7 @@ typedef struct {
   PCI_ROOT_BRIDGE_APERTURE          MemAbove4G;
   PCI_ROOT_BRIDGE_APERTURE          PMemAbove4G;
   BOOLEAN                           DmaAbove4G;
+  BOOLEAN                           NoExtendedConfigSpace;
   VOID                              *ConfigBuffer;
   EFI_DEVICE_PATH_PROTOCOL          *DevicePath;
   CHAR16                            *DevicePathStr;
diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
index 932aefd5d621..cda9b49b3925 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciRootBridgeIo.c
@@ -80,6 +80,7 @@ CreateRootBridge (
   DEBUG ((EFI_D_INFO, "%s\n", DevicePathStr = ConvertDevicePathToText (Bridge->DevicePath, FALSE, FALSE)));
   DEBUG ((EFI_D_INFO, "  Support/Attr: %lx / %lx\n", Bridge->Supports, Bridge->Attributes));
   DEBUG ((EFI_D_INFO, "    DmaAbove4G: %s\n", Bridge->DmaAbove4G ? L"Yes" : L"No"));
+  DEBUG ((EFI_D_INFO, "NoExtConfSpace: %s\n", Bridge->NoExtendedConfigSpace ? L"Yes" : L"No"));
   DEBUG ((EFI_D_INFO, "     AllocAttr: %lx (%s%s)\n", Bridge->AllocationAttributes,
           (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM) != 0 ? L"CombineMemPMem " : L"",
           (Bridge->AllocationAttributes & EFI_PCI_HOST_BRIDGE_MEM64_DECODE) != 0 ? L"Mem64Decode" : L""
@@ -155,6 +156,7 @@ CreateRootBridge (
   RootBridge->Supports = Bridge->Supports;
   RootBridge->Attributes = Bridge->Attributes;
   RootBridge->DmaAbove4G = Bridge->DmaAbove4G;
+  RootBridge->NoExtendedConfigSpace = Bridge->NoExtendedConfigSpace;
   RootBridge->AllocationAttributes = Bridge->AllocationAttributes;
   RootBridge->DevicePath = DuplicateDevicePath (Bridge->DevicePath);
   RootBridge->DevicePathStr = DevicePathStr;
@@ -351,7 +353,7 @@ RootBridgeIoCheckParameter (
       Address = PciRbAddr->Register;
     }
     Base = 0;
-    Limit = 0xFFF;
+    Limit = RootBridge->NoExtendedConfigSpace ? 0xFF : 0xFFF;
   }
 
   if (Address < Base) {
diff --git a/MdeModulePkg/Include/Library/PciHostBridgeLib.h b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
index 16ad104a9368..b67ac5e17d48 100644
--- a/MdeModulePkg/Include/Library/PciHostBridgeLib.h
+++ b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
@@ -34,6 +34,10 @@ typedef struct {
                                                   ///< and SetAttributes() in EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL.
   BOOLEAN                  DmaAbove4G;            ///< DMA above 4GB memory.
                                                   ///< Set to TRUE when root bridge supports DMA above 4GB memory.
+  BOOLEAN                  NoExtendedConfigSpace; ///< When FALSE, the root bridge supports
+                                                  ///< Extended (4096-byte) Configuration Space.
+                                                  ///< When TRUE, the root bridge supports
+                                                  ///< 256-byte Configuration Space only.
   UINT64                   AllocationAttributes;  ///< Allocation attributes.
                                                   ///< Refer to EFI_PCI_HOST_BRIDGE_COMBINE_MEM_PMEM and
                                                   ///< EFI_PCI_HOST_BRIDGE_MEM64_DECODE used by GetAllocAttributes()

From 7e72bd3e89d0e65792cf9b45e756ff7e7f59f5ec Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Thu, 3 Mar 2016 17:47:52 +0800
Subject: [PATCH 521/525] MdeModulePkg/PciHostBridgeLib: Correct the function
 header comments

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Shumin Qiu <shumin.qiu@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
(cherry picked from commit eea222ced0f8b40b2b02e9da31cca33ca6688faf)
---
 MdeModulePkg/Include/Library/PciHostBridgeLib.h            | 4 ++--
 .../Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c    | 7 +++----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/MdeModulePkg/Include/Library/PciHostBridgeLib.h b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
index b67ac5e17d48..eb45cfdd79c1 100644
--- a/MdeModulePkg/Include/Library/PciHostBridgeLib.h
+++ b/MdeModulePkg/Include/Library/PciHostBridgeLib.h
@@ -69,8 +69,8 @@ PciHostBridgeGetRootBridges (
 /**
   Free the root bridge instances array returned from PciHostBridgeGetRootBridges().
 
-  @param  The root bridge instances array.
-  @param  The count of the array.
+  @param Bridges The root bridge instances array.
+  @param Count   The count of the array.
 **/
 VOID
 EFIAPI
diff --git a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
index fe0632dd3552..761e45b0deb6 100644
--- a/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
+++ b/MdeModulePkg/Library/PciHostBridgeLibNull/PciHostBridgeLibNull.c
@@ -41,11 +41,10 @@ PciHostBridgeGetRootBridges (
 }
 
 /**
-  Free the root bridge instances array returned from
-  PciHostBridgeGetRootBridges().
+  Free the root bridge instances array returned from PciHostBridgeGetRootBridges().
 
-  @param  The root bridge instances array.
-  @param  The count of the array.
+  @param Bridges The root bridge instances array.
+  @param Count   The count of the array.
 **/
 VOID
 EFIAPI

From 873d970c5c7314e1f186552c6aec13f2f111af88 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 3 Mar 2016 15:25:26 +0800
Subject: [PATCH 522/525] UefiCpuPkg: Add dynamic type for
 PcdCpuMaxLogicalProcessorNumber

Currently, PcdCpuMaxLogicalProcessorNumber only supports fixed type. There are
some requests on this PCD to support dynamic type also. For example, platform
may dynamically set this PCD to actual processor count to save memory or improve
boot performance.

Cc: Feng Tian <feng.tian@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Feng Tian <feng.tian@intel.com>
(cherry picked from commit b1e01bd4e60eec18ead0263a47732bb21038c48b)
---
 UefiCpuPkg/UefiCpuPkg.dec | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/UefiCpuPkg/UefiCpuPkg.dec b/UefiCpuPkg/UefiCpuPkg.dec
index 472b38acbc1e..16637dfdc14b 100644
--- a/UefiCpuPkg/UefiCpuPkg.dec
+++ b/UefiCpuPkg/UefiCpuPkg.dec
@@ -1,7 +1,7 @@
 ## @file  UefiCpuPkg.dec
 # This Package provides UEFI compatible CPU modules and libraries.
 #
-# Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2016, Intel Corporation. All rights reserved.<BR>
 #
 # This program and the accompanying materials are licensed and made available under
 # the terms and conditions of the BSD License which accompanies this distribution.
@@ -128,10 +128,6 @@
   # @Prompt Configure delay value after send an INIT IPI
   gUefiCpuPkgTokenSpaceGuid.PcdCpuInitIpiDelayInMicroSeconds|10000|UINT32|0x30000002
 
-  ## Specifies max supported number of Logical Processors.
-  # @Prompt Configure max supported number of Logical Processors
-  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber|64|UINT32|0x00000002
-
   ## This value specifies the Application Processor (AP) stack size, used for Mp Service, which must
   ## aligns the address on a 4-KByte boundary.
   # @Prompt Configure stack size for Application Processor (AP)
@@ -173,6 +169,9 @@
   gUefiCpuPkgTokenSpaceGuid.PcdCpuNumberOfReservedVariableMtrrs|0x2|UINT32|0x00000015
 
 [PcdsFixedAtBuild, PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
+  ## Specifies max supported number of Logical Processors.
+  # @Prompt Configure max supported number of Logical Processors
+  gUefiCpuPkgTokenSpaceGuid.PcdCpuMaxLogicalProcessorNumber|64|UINT32|0x00000002
   ## Specifies timeout value in microseconds for the BSP to detect all APs for the first time.
   # @Prompt Timeout for the BSP to detect all APs for the first time.
   gUefiCpuPkgTokenSpaceGuid.PcdCpuApInitTimeOutInMicroSeconds|50000|UINT32|0x00000004

From dc6cc13bc2f9f928378c180bcdc4080991e5d343 Mon Sep 17 00:00:00 2001
From: Ruiyu Ni <ruiyu.ni@intel.com>
Date: Fri, 4 Mar 2016 13:04:21 +0800
Subject: [PATCH 523/525] MdeModulePkg/PciHostBridge: Don't assert when setting
 UC to MMIO fails

Failing to set EFI_MEMORY_UC to MMIO aperture is not a fatal error.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ruiyu Ni <ruiyu.ni@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Tested-by: Laszlo Ersek <lersek@redhat.com>
(cherry picked from commit 13be90faafdfe2a053090b99644a246680687166)
---
 MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
index ef0c4f2a5e7b..d5da6995af36 100644
--- a/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
+++ b/MdeModulePkg/Bus/Pci/PciHostBridgeDxe/PciHostBridge.c
@@ -425,7 +425,9 @@ InitializePciHostBridge (
                         MemApertures[MemApertureIndex]->Limit - MemApertures[MemApertureIndex]->Base + 1,
                         EFI_MEMORY_UC
                         );
-        ASSERT_EFI_ERROR (Status);
+        if (EFI_ERROR (Status)) {
+          DEBUG ((DEBUG_WARN, "PciHostBridge driver failed to set EFI_MEMORY_UC to MMIO aperture - %r.\n", Status));
+        }
       }
     }
     //

From b61c47582d0a48db76221acc2a3515b6abe94639 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Wed, 9 Mar 2016 10:05:30 +0800
Subject: [PATCH 524/525] UefiCpuPkg/Application/Cpuid: Add check for
 gMaximumBasicFunction

Add check for gMaximumBasicFunction in CpuidVersionInfo () back.

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit 321ef72c92072eb2d40fac6fee70b94ccbc6e7c0)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
index 371df6699417..f5268cd05ed9 100644
--- a/UefiCpuPkg/Application/Cpuid/Cpuid.c
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -213,6 +213,10 @@ CpuidVersionInfo (
   UINT32                  DisplayFamily;
   UINT32                  DisplayModel;
 
+  if (CPUID_VERSION_INFO > gMaximumBasicFunction) {
+    return;
+  }
+
   AsmCpuid (CPUID_VERSION_INFO, &Eax.Uint32, &Ebx.Uint32, &Ecx.Uint32, &Edx.Uint32);
 
   Print (L"CPUID_VERSION_INFO (Leaf %08x)\n", CPUID_VERSION_INFO);

From 0eabcb1b85331dccd446805f13efc77804604d14 Mon Sep 17 00:00:00 2001
From: Jeff Fan <jeff.fan@intel.com>
Date: Thu, 10 Mar 2016 09:33:17 +0800
Subject: [PATCH 525/525] UefiCpuPkg/Application/Cpuid: Remove unnecessary code
 check

gMaximumBasicFunction is set to CPUID_SIGNATURE as below, so removed the compare code.
UINT32  gMaximumBasicFunction = CPUID_SIGNATURE;

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
UefiCpuPkg/Application/Cpuid: Remove unnecessary code check

gMaximumBasicFunction is set to CPUID_SIGNATURE as below, so removed the compare code.
UINT32  gMaximumBasicFunction = CPUID_SIGNATURE;

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
UefiCpuPkg/Application/Cpuid: Remove unnecessary code check

gMaximumBasicFunction is set to CPUID_SIGNATURE as below, so removed the compare code.
UINT32  gMaximumBasicFunction = CPUID_SIGNATURE;

Cc: Qiu Shumin <shumin.qiu@intel.com>
Cc: Michael Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Jeff Fan <jeff.fan@intel.com>
Reviewed-by: Qiu Shumin <shumin.qiu@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
(cherry picked from commit 70849819c15482d4d6b7db4b06c4b21fa2e3b1c5)
---
 UefiCpuPkg/Application/Cpuid/Cpuid.c | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/UefiCpuPkg/Application/Cpuid/Cpuid.c b/UefiCpuPkg/Application/Cpuid/Cpuid.c
index f5268cd05ed9..b0624e1c23fd 100644
--- a/UefiCpuPkg/Application/Cpuid/Cpuid.c
+++ b/UefiCpuPkg/Application/Cpuid/Cpuid.c
@@ -179,10 +179,6 @@ CpuidSignature (
   UINT32 Edx;
   CHAR8  Signature[13];
 
-  if (CPUID_SIGNATURE > gMaximumBasicFunction) {
-    return;
-  }
-
   AsmCpuid (CPUID_SIGNATURE, &Eax, &Ebx, &Ecx, &Edx);
 
   Print (L"CPUID_SIGNATURE (Leaf %08x)\n", CPUID_SIGNATURE);