* [Patch 01/15] BaseTools/Python: Allow HOST_APPLICATION to use NULL libraries
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 6:22 ` [edk2-devel] " Yuwei Chen
2020-06-15 0:19 ` [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing Michael D Kinney
` (13 subsequent siblings)
14 siblings, 1 reply; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Bob Feng, Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2797
Update HOST_APPLICATION module type to use NULL library instances.
Cc: Bob Feng <bob.c.feng@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
BaseTools/Source/Python/Workspace/WorkspaceCommon.py | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/BaseTools/Source/Python/Workspace/WorkspaceCommon.py b/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
index 913e710fd9..53027a0e30 100644
--- a/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
+++ b/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
@@ -1,7 +1,7 @@
## @file
# Common routines used by workspace
#
-# Copyright (c) 2012 - 2018, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2012 - 2020, Intel Corporation. All rights reserved.<BR>
# SPDX-License-Identifier: BSD-2-Clause-Patent
#
@@ -100,7 +100,7 @@ def GetModuleLibInstances(Module, Platform, BuildDatabase, Arch, Target, Toolcha
# If a module has a MODULE_TYPE of USER_DEFINED,
# do not link in NULL library class instances from the global [LibraryClasses.*] sections.
#
- if Module.ModuleType != SUP_MODULE_USER_DEFINED and Module.ModuleType != SUP_MODULE_HOST_APPLICATION:
+ if Module.ModuleType != SUP_MODULE_USER_DEFINED:
for LibraryClass in Platform.LibraryClasses.GetKeys():
if LibraryClass.startswith("NULL") and Platform.LibraryClasses[LibraryClass, Module.ModuleType]:
Module.LibraryClasses[LibraryClass] = Platform.LibraryClasses[LibraryClass, Module.ModuleType]
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* Re: [edk2-devel] [Patch 01/15] BaseTools/Python: Allow HOST_APPLICATION to use NULL libraries
2020-06-15 0:19 ` [Patch 01/15] BaseTools/Python: Allow HOST_APPLICATION to use NULL libraries Michael D Kinney
@ 2020-06-15 6:22 ` Yuwei Chen
0 siblings, 0 replies; 23+ messages in thread
From: Yuwei Chen @ 2020-06-15 6:22 UTC (permalink / raw)
To: devel@edk2.groups.io, Kinney, Michael D
Cc: Feng, Bob C, Gao, Liming, Sean Brogan, Bret Barkelew, Yao, Jiewen
Hi, Michael
This patch looks good. While I have a little format suggestion: the Bugzilla link "https://bugzilla.tianocore.org/show_bug.cgi?id=2797" could be written as "REF: https://bugzilla.tianocore.org/show_bug.cgi?id=2797".
Reviewed-by: Yuwei Chen <yuwei.chen@intel.com>
Thanks,
Yuwei
> -----Original Message-----
> From: devel@edk2.groups.io <devel@edk2.groups.io> On Behalf Of Michael
> D Kinney
> Sent: Monday, June 15, 2020 8:19 AM
> To: devel@edk2.groups.io
> Cc: Feng, Bob C <bob.c.feng@intel.com>; Gao, Liming
> <liming.gao@intel.com>; Sean Brogan <sean.brogan@microsoft.com>; Bret
> Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> <jiewen.yao@intel.com>
> Subject: [edk2-devel] [Patch 01/15] BaseTools/Python: Allow
> HOST_APPLICATION to use NULL libraries
>
> https://bugzilla.tianocore.org/show_bug.cgi?id=2797
>
> Update HOST_APPLICATION module type to use NULL library instances.
>
> Cc: Bob Feng <bob.c.feng@intel.com>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Sean Brogan <sean.brogan@microsoft.com>
> Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> Cc: Jiewen Yao <jiewen.yao@intel.com>
> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
> ---
> BaseTools/Source/Python/Workspace/WorkspaceCommon.py | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
> b/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
> index 913e710fd9..53027a0e30 100644
> --- a/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
> +++ b/BaseTools/Source/Python/Workspace/WorkspaceCommon.py
> @@ -1,7 +1,7 @@
> ## @file
> # Common routines used by workspace
> #
> -# Copyright (c) 2012 - 2018, Intel Corporation. All rights reserved.<BR>
> +# Copyright (c) 2012 - 2020, Intel Corporation. All rights
> +reserved.<BR>
> # SPDX-License-Identifier: BSD-2-Clause-Patent #
>
> @@ -100,7 +100,7 @@ def GetModuleLibInstances(Module, Platform,
> BuildDatabase, Arch, Target, Toolcha
> # If a module has a MODULE_TYPE of USER_DEFINED,
> # do not link in NULL library class instances from the global
> [LibraryClasses.*] sections.
> #
> - if Module.ModuleType != SUP_MODULE_USER_DEFINED and
> Module.ModuleType != SUP_MODULE_HOST_APPLICATION:
> + if Module.ModuleType != SUP_MODULE_USER_DEFINED:
> for LibraryClass in Platform.LibraryClasses.GetKeys():
> if LibraryClass.startswith("NULL") and
> Platform.LibraryClasses[LibraryClass, Module.ModuleType]:
> Module.LibraryClasses[LibraryClass] =
> Platform.LibraryClasses[LibraryClass, Module.ModuleType]
> --
> 2.21.0.windows.1
>
>
>
^ permalink raw reply [flat|nested] 23+ messages in thread
* [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
2020-06-15 0:19 ` [Patch 01/15] BaseTools/Python: Allow HOST_APPLICATION to use NULL libraries Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-07-09 14:03 ` Liming Gao
2020-06-15 0:19 ` [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance " Michael D Kinney
` (12 subsequent siblings)
14 siblings, 1 reply; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2798
The services in CpuLib usually generate exceptions in a unit test
host application. Provide a Null instance that can be safely used.
This Null instance can also be used as a template for implementing
new instances of CpuLib.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../Library/BaseCpuLibNull/BaseCpuLibNull.c | 37 +++++++++++++++++++
.../Library/BaseCpuLibNull/BaseCpuLibNull.inf | 26 +++++++++++++
.../Library/BaseCpuLibNull/BaseCpuLibNull.uni | 11 ++++++
MdePkg/MdePkg.dsc | 3 +-
4 files changed, 76 insertions(+), 1 deletion(-)
create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
new file mode 100644
index 0000000000..3ba7a35096
--- /dev/null
+++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
@@ -0,0 +1,37 @@
+/** @file
+ Null instance of CPU Library.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+/**
+ Places the CPU in a sleep state until an interrupt is received.
+
+ Places the CPU in a sleep state until an interrupt is received. If interrupts
+ are disabled prior to calling this function, then the CPU will be placed in a
+ sleep state indefinitely.
+
+**/
+VOID
+EFIAPI
+CpuSleep (
+ VOID
+ )
+{
+}
+
+/**
+ Flushes all the Translation Lookaside Buffers(TLB) entries in a CPU.
+
+ Flushes all the Translation Lookaside Buffers(TLB) entries in a CPU.
+
+**/
+VOID
+EFIAPI
+CpuFlushTlb (
+ VOID
+ )
+{
+}
diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
new file mode 100644
index 0000000000..a9e8399038
--- /dev/null
+++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
@@ -0,0 +1,26 @@
+## @file
+# Null instance of CPU Library.
+#
+# Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+ INF_VERSION = 0x00010005
+ BASE_NAME = BaseCpuLibNull
+ MODULE_UNI_FILE = BaseCpuLibNull.uni
+ FILE_GUID = 8A29AAA5-0FB7-44CC-8709-1344FE89B878
+ MODULE_TYPE = BASE
+ VERSION_STRING = 1.0
+ LIBRARY_CLASS = CpuLib
+
+#
+# VALID_ARCHITECTURES = IA32 X64 EBC ARM AARCH64 RISCV64
+#
+
+[Sources]
+ BaseCpuLibNull.c
+
+[Packages]
+ MdePkg/MdePkg.dec
diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
new file mode 100644
index 0000000000..1030221d5c
--- /dev/null
+++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
@@ -0,0 +1,11 @@
+// /** @file
+// Null instance of CPU Library.
+//
+// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+// SPDX-License-Identifier: BSD-2-Clause-Patent
+//
+// **/
+
+#string STR_MODULE_ABSTRACT #language en-US "Null Instance of CPU Library"
+
+#string STR_MODULE_DESCRIPTION #language en-US "Null instance of CPU Library."
diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index 6cd38e7ec3..3abe65ec7f 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -1,7 +1,7 @@
## @file
# EFI/PI MdePkg Package
#
-# Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
# Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
# (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
#
@@ -36,6 +36,7 @@ [Components]
MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
+ MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
MdePkg/Library/BaseDebugLibSerialPort/BaseDebugLibSerialPort.inf
MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* Re: [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing
2020-06-15 0:19 ` [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing Michael D Kinney
@ 2020-07-09 14:03 ` Liming Gao
0 siblings, 0 replies; 23+ messages in thread
From: Liming Gao @ 2020-07-09 14:03 UTC (permalink / raw)
To: Kinney, Michael D, devel@edk2.groups.io
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Reviewed-by: Liming Gao <liming.gao@intel.com>
> -----Original Message-----
> From: Kinney, Michael D <michael.d.kinney@intel.com>
> Sent: Monday, June 15, 2020 8:19 AM
> To: devel@edk2.groups.io
> Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan <sean.brogan@microsoft.com>; Bret Barkelew <Bret.Barkelew@microsoft.com>;
> Yao, Jiewen <jiewen.yao@intel.com>
> Subject: [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing
>
> https://bugzilla.tianocore.org/show_bug.cgi?id=2798
>
> The services in CpuLib usually generate exceptions in a unit test
> host application. Provide a Null instance that can be safely used.
>
> This Null instance can also be used as a template for implementing
> new instances of CpuLib.
>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Sean Brogan <sean.brogan@microsoft.com>
> Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> Cc: Jiewen Yao <jiewen.yao@intel.com>
> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
> ---
> .../Library/BaseCpuLibNull/BaseCpuLibNull.c | 37 +++++++++++++++++++
> .../Library/BaseCpuLibNull/BaseCpuLibNull.inf | 26 +++++++++++++
> .../Library/BaseCpuLibNull/BaseCpuLibNull.uni | 11 ++++++
> MdePkg/MdePkg.dsc | 3 +-
> 4 files changed, 76 insertions(+), 1 deletion(-)
> create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
> create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
> create mode 100644 MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
>
> diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
> new file mode 100644
> index 0000000000..3ba7a35096
> --- /dev/null
> +++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.c
> @@ -0,0 +1,37 @@
> +/** @file
> + Null instance of CPU Library.
> +
> + Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> + SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +
> +/**
> + Places the CPU in a sleep state until an interrupt is received.
> +
> + Places the CPU in a sleep state until an interrupt is received. If interrupts
> + are disabled prior to calling this function, then the CPU will be placed in a
> + sleep state indefinitely.
> +
> +**/
> +VOID
> +EFIAPI
> +CpuSleep (
> + VOID
> + )
> +{
> +}
> +
> +/**
> + Flushes all the Translation Lookaside Buffers(TLB) entries in a CPU.
> +
> + Flushes all the Translation Lookaside Buffers(TLB) entries in a CPU.
> +
> +**/
> +VOID
> +EFIAPI
> +CpuFlushTlb (
> + VOID
> + )
> +{
> +}
> diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
> new file mode 100644
> index 0000000000..a9e8399038
> --- /dev/null
> +++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
> @@ -0,0 +1,26 @@
> +## @file
> +# Null instance of CPU Library.
> +#
> +# Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> +# SPDX-License-Identifier: BSD-2-Clause-Patent
> +#
> +##
> +
> +[Defines]
> + INF_VERSION = 0x00010005
> + BASE_NAME = BaseCpuLibNull
> + MODULE_UNI_FILE = BaseCpuLibNull.uni
> + FILE_GUID = 8A29AAA5-0FB7-44CC-8709-1344FE89B878
> + MODULE_TYPE = BASE
> + VERSION_STRING = 1.0
> + LIBRARY_CLASS = CpuLib
> +
> +#
> +# VALID_ARCHITECTURES = IA32 X64 EBC ARM AARCH64 RISCV64
> +#
> +
> +[Sources]
> + BaseCpuLibNull.c
> +
> +[Packages]
> + MdePkg/MdePkg.dec
> diff --git a/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
> new file mode 100644
> index 0000000000..1030221d5c
> --- /dev/null
> +++ b/MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.uni
> @@ -0,0 +1,11 @@
> +// /** @file
> +// Null instance of CPU Library.
> +//
> +// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> +// SPDX-License-Identifier: BSD-2-Clause-Patent
> +//
> +// **/
> +
> +#string STR_MODULE_ABSTRACT #language en-US "Null Instance of CPU Library"
> +
> +#string STR_MODULE_DESCRIPTION #language en-US "Null instance of CPU Library."
> diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
> index 6cd38e7ec3..3abe65ec7f 100644
> --- a/MdePkg/MdePkg.dsc
> +++ b/MdePkg/MdePkg.dsc
> @@ -1,7 +1,7 @@
> ## @file
> # EFI/PI MdePkg Package
> #
> -# Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
> +# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
> # Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> # (C) Copyright 2020 Hewlett Packard Enterprise Development LP<BR>
> #
> @@ -36,6 +36,7 @@ [Components]
> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
> MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
> MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
> + MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
> MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
> MdePkg/Library/BaseDebugLibSerialPort/BaseDebugLibSerialPort.inf
> MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
> --
> 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread
* [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance for host testing
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
2020-06-15 0:19 ` [Patch 01/15] BaseTools/Python: Allow HOST_APPLICATION to use NULL libraries Michael D Kinney
2020-06-15 0:19 ` [Patch 02/15] MdePkg/BaseCpuLibNull: Add Null version of CpuLib for host testing Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-07-09 14:03 ` Liming Gao
2020-06-15 0:19 ` [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions Michael D Kinney
` (11 subsequent siblings)
14 siblings, 1 reply; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2799
The services in CacheMaintenanceLib usually generate exceptions in a
unit test host application. Provide a Null instance that can be safely
used.
This Null instance can also be used as a template for implementing
new instances of CacheMaintenanceLib.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../BaseCacheMaintenanceLibNull.c | 225 ++++++++++++++++++
.../BaseCacheMaintenanceLibNull.inf | 29 +++
.../BaseCacheMaintenanceLibNull.uni | 12 +
MdePkg/MdePkg.dsc | 1 +
4 files changed, 267 insertions(+)
create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
new file mode 100644
index 0000000000..fd5b9d4710
--- /dev/null
+++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
@@ -0,0 +1,225 @@
+/** @file
+ Null Cache Maintenance Librfary implementation.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include <Base.h>
+#include <Library/DebugLib.h>
+
+/**
+ Invalidates the entire instruction cache in cache coherency domain of the
+ calling CPU.
+
+**/
+VOID
+EFIAPI
+InvalidateInstructionCache (
+ VOID
+ )
+{
+}
+
+/**
+ Invalidates a range of instruction cache lines in the cache coherency domain
+ of the calling CPU.
+
+ Invalidates the instruction cache lines specified by Address and Length. If
+ Address is not aligned on a cache line boundary, then entire instruction
+ cache line containing Address is invalidated. If Address + Length is not
+ aligned on a cache line boundary, then the entire instruction cache line
+ containing Address + Length -1 is invalidated. This function may choose to
+ invalidate the entire instruction cache if that is more efficient than
+ invalidating the specified range. If Length is 0, then no instruction cache
+ lines are invalidated. Address is returned.
+
+ If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
+
+ @param Address The base address of the instruction cache lines to
+ invalidate. If the CPU is in a physical addressing mode, then
+ Address is a physical address. If the CPU is in a virtual
+ addressing mode, then Address is a virtual address.
+
+ @param Length The number of bytes to invalidate from the instruction cache.
+
+ @return Address.
+
+**/
+VOID *
+EFIAPI
+InvalidateInstructionCacheRange (
+ IN VOID *Address,
+ IN UINTN Length
+ )
+{
+ ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
+ return Address;
+}
+
+/**
+ Writes back and invalidates the entire data cache in cache coherency domain
+ of the calling CPU.
+
+ Writes back and invalidates the entire data cache in cache coherency domain
+ of the calling CPU. This function guarantees that all dirty cache lines are
+ written back to system memory, and also invalidates all the data cache lines
+ in the cache coherency domain of the calling CPU.
+
+**/
+VOID
+EFIAPI
+WriteBackInvalidateDataCache (
+ VOID
+ )
+{
+}
+
+/**
+ Writes back and invalidates a range of data cache lines in the cache
+ coherency domain of the calling CPU.
+
+ Writes Back and Invalidate the data cache lines specified by Address and
+ Length. If Address is not aligned on a cache line boundary, then entire data
+ cache line containing Address is written back and invalidated. If Address +
+ Length is not aligned on a cache line boundary, then the entire data cache
+ line containing Address + Length -1 is written back and invalidated. This
+ function may choose to write back and invalidate the entire data cache if
+ that is more efficient than writing back and invalidating the specified
+ range. If Length is 0, then no data cache lines are written back and
+ invalidated. Address is returned.
+
+ If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
+
+ @param Address The base address of the data cache lines to write back and
+ invalidate. If the CPU is in a physical addressing mode, then
+ Address is a physical address. If the CPU is in a virtual
+ addressing mode, then Address is a virtual address.
+ @param Length The number of bytes to write back and invalidate from the
+ data cache.
+
+ @return Address of cache invalidation.
+
+**/
+VOID *
+EFIAPI
+WriteBackInvalidateDataCacheRange (
+ IN VOID *Address,
+ IN UINTN Length
+ )
+{
+ ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
+ return Address;
+}
+
+/**
+ Writes back the entire data cache in cache coherency domain of the calling
+ CPU.
+
+ Writes back the entire data cache in cache coherency domain of the calling
+ CPU. This function guarantees that all dirty cache lines are written back to
+ system memory. This function may also invalidate all the data cache lines in
+ the cache coherency domain of the calling CPU.
+
+**/
+VOID
+EFIAPI
+WriteBackDataCache (
+ VOID
+ )
+{
+}
+
+/**
+ Writes back a range of data cache lines in the cache coherency domain of the
+ calling CPU.
+
+ Writes back the data cache lines specified by Address and Length. If Address
+ is not aligned on a cache line boundary, then entire data cache line
+ containing Address is written back. If Address + Length is not aligned on a
+ cache line boundary, then the entire data cache line containing Address +
+ Length -1 is written back. This function may choose to write back the entire
+ data cache if that is more efficient than writing back the specified range.
+ If Length is 0, then no data cache lines are written back. This function may
+ also invalidate all the data cache lines in the specified range of the cache
+ coherency domain of the calling CPU. Address is returned.
+
+ If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
+
+ @param Address The base address of the data cache lines to write back. If
+ the CPU is in a physical addressing mode, then Address is a
+ physical address. If the CPU is in a virtual addressing
+ mode, then Address is a virtual address.
+ @param Length The number of bytes to write back from the data cache.
+
+ @return Address of cache written in main memory.
+
+**/
+VOID *
+EFIAPI
+WriteBackDataCacheRange (
+ IN VOID *Address,
+ IN UINTN Length
+ )
+{
+ ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
+ return Address;
+}
+
+/**
+ Invalidates the entire data cache in cache coherency domain of the calling
+ CPU.
+
+ Invalidates the entire data cache in cache coherency domain of the calling
+ CPU. This function must be used with care because dirty cache lines are not
+ written back to system memory. It is typically used for cache diagnostics. If
+ the CPU does not support invalidation of the entire data cache, then a write
+ back and invalidate operation should be performed on the entire data cache.
+
+**/
+VOID
+EFIAPI
+InvalidateDataCache (
+ VOID
+ )
+{
+}
+
+/**
+ Invalidates a range of data cache lines in the cache coherency domain of the
+ calling CPU.
+
+ Invalidates the data cache lines specified by Address and Length. If Address
+ is not aligned on a cache line boundary, then entire data cache line
+ containing Address is invalidated. If Address + Length is not aligned on a
+ cache line boundary, then the entire data cache line containing Address +
+ Length -1 is invalidated. This function must never invalidate any cache lines
+ outside the specified range. If Length is 0, then no data cache lines are
+ invalidated. Address is returned. This function must be used with care
+ because dirty cache lines are not written back to system memory. It is
+ typically used for cache diagnostics. If the CPU does not support
+ invalidation of a data cache range, then a write back and invalidate
+ operation should be performed on the data cache range.
+
+ If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
+
+ @param Address The base address of the data cache lines to invalidate. If
+ the CPU is in a physical addressing mode, then Address is a
+ physical address. If the CPU is in a virtual addressing mode,
+ then Address is a virtual address.
+ @param Length The number of bytes to invalidate from the data cache.
+
+ @return Address.
+
+**/
+VOID *
+EFIAPI
+InvalidateDataCacheRange (
+ IN VOID *Address,
+ IN UINTN Length
+ )
+{
+ ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
+ return Address;
+}
diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
new file mode 100644
index 0000000000..8d6eaaeaa0
--- /dev/null
+++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
@@ -0,0 +1,29 @@
+## @file
+# Null Cache Maintenance Library implementation.
+#
+# Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+ INF_VERSION = 0x00010005
+ BASE_NAME = BaseCacheMaintenanceLibNull
+ MODULE_UNI_FILE = BaseCacheMaintenanceLibNull.uni
+ FILE_GUID = 13F13249-AC31-4373-8B2B-AFC5755A6FCD
+ MODULE_TYPE = BASE
+ VERSION_STRING = 1.1
+ LIBRARY_CLASS = CacheMaintenanceLib
+
+#
+# VALID_ARCHITECTURES = IA32 X64 EBC ARM AARCH64
+#
+
+[Sources]
+ BaseCacheMaintenanceLibNull.c
+
+[Packages]
+ MdePkg/MdePkg.dec
+
+[LibraryClasses]
+ DebugLib
diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
new file mode 100644
index 0000000000..260c756190
--- /dev/null
+++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
@@ -0,0 +1,12 @@
+// /** @file
+// Null Cache Maintenance Library implementation.
+//
+// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+// SPDX-License-Identifier: BSD-2-Clause-Patent
+//
+// **/
+
+#string STR_MODULE_ABSTRACT #language en-US "Null instance of Cache Maintenance Library"
+
+#string STR_MODULE_DESCRIPTION #language en-US "Null instance of the Cache Maintenance Library."
+
diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index 3abe65ec7f..472fa37774 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -35,6 +35,7 @@ [LibraryClasses]
[Components]
MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
+ MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* Re: [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance for host testing
2020-06-15 0:19 ` [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance " Michael D Kinney
@ 2020-07-09 14:03 ` Liming Gao
0 siblings, 0 replies; 23+ messages in thread
From: Liming Gao @ 2020-07-09 14:03 UTC (permalink / raw)
To: Kinney, Michael D, devel@edk2.groups.io
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Reviewed-by: Liming Gao <liming.gao@intel.com>
> -----Original Message-----
> From: Kinney, Michael D <michael.d.kinney@intel.com>
> Sent: Monday, June 15, 2020 8:19 AM
> To: devel@edk2.groups.io
> Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan <sean.brogan@microsoft.com>; Bret Barkelew <Bret.Barkelew@microsoft.com>;
> Yao, Jiewen <jiewen.yao@intel.com>
> Subject: [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance for host testing
>
> https://bugzilla.tianocore.org/show_bug.cgi?id=2799
>
> The services in CacheMaintenanceLib usually generate exceptions in a
> unit test host application. Provide a Null instance that can be safely
> used.
>
> This Null instance can also be used as a template for implementing
> new instances of CacheMaintenanceLib.
>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Sean Brogan <sean.brogan@microsoft.com>
> Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> Cc: Jiewen Yao <jiewen.yao@intel.com>
> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
> ---
> .../BaseCacheMaintenanceLibNull.c | 225 ++++++++++++++++++
> .../BaseCacheMaintenanceLibNull.inf | 29 +++
> .../BaseCacheMaintenanceLibNull.uni | 12 +
> MdePkg/MdePkg.dsc | 1 +
> 4 files changed, 267 insertions(+)
> create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
> create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
> create mode 100644 MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
>
> diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
> b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
> new file mode 100644
> index 0000000000..fd5b9d4710
> --- /dev/null
> +++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.c
> @@ -0,0 +1,225 @@
> +/** @file
> + Null Cache Maintenance Librfary implementation.
> +
> + Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> + SPDX-License-Identifier: BSD-2-Clause-Patent
> +
> +**/
> +
> +#include <Base.h>
> +#include <Library/DebugLib.h>
> +
> +/**
> + Invalidates the entire instruction cache in cache coherency domain of the
> + calling CPU.
> +
> +**/
> +VOID
> +EFIAPI
> +InvalidateInstructionCache (
> + VOID
> + )
> +{
> +}
> +
> +/**
> + Invalidates a range of instruction cache lines in the cache coherency domain
> + of the calling CPU.
> +
> + Invalidates the instruction cache lines specified by Address and Length. If
> + Address is not aligned on a cache line boundary, then entire instruction
> + cache line containing Address is invalidated. If Address + Length is not
> + aligned on a cache line boundary, then the entire instruction cache line
> + containing Address + Length -1 is invalidated. This function may choose to
> + invalidate the entire instruction cache if that is more efficient than
> + invalidating the specified range. If Length is 0, then no instruction cache
> + lines are invalidated. Address is returned.
> +
> + If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
> +
> + @param Address The base address of the instruction cache lines to
> + invalidate. If the CPU is in a physical addressing mode, then
> + Address is a physical address. If the CPU is in a virtual
> + addressing mode, then Address is a virtual address.
> +
> + @param Length The number of bytes to invalidate from the instruction cache.
> +
> + @return Address.
> +
> +**/
> +VOID *
> +EFIAPI
> +InvalidateInstructionCacheRange (
> + IN VOID *Address,
> + IN UINTN Length
> + )
> +{
> + ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
> + return Address;
> +}
> +
> +/**
> + Writes back and invalidates the entire data cache in cache coherency domain
> + of the calling CPU.
> +
> + Writes back and invalidates the entire data cache in cache coherency domain
> + of the calling CPU. This function guarantees that all dirty cache lines are
> + written back to system memory, and also invalidates all the data cache lines
> + in the cache coherency domain of the calling CPU.
> +
> +**/
> +VOID
> +EFIAPI
> +WriteBackInvalidateDataCache (
> + VOID
> + )
> +{
> +}
> +
> +/**
> + Writes back and invalidates a range of data cache lines in the cache
> + coherency domain of the calling CPU.
> +
> + Writes Back and Invalidate the data cache lines specified by Address and
> + Length. If Address is not aligned on a cache line boundary, then entire data
> + cache line containing Address is written back and invalidated. If Address +
> + Length is not aligned on a cache line boundary, then the entire data cache
> + line containing Address + Length -1 is written back and invalidated. This
> + function may choose to write back and invalidate the entire data cache if
> + that is more efficient than writing back and invalidating the specified
> + range. If Length is 0, then no data cache lines are written back and
> + invalidated. Address is returned.
> +
> + If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
> +
> + @param Address The base address of the data cache lines to write back and
> + invalidate. If the CPU is in a physical addressing mode, then
> + Address is a physical address. If the CPU is in a virtual
> + addressing mode, then Address is a virtual address.
> + @param Length The number of bytes to write back and invalidate from the
> + data cache.
> +
> + @return Address of cache invalidation.
> +
> +**/
> +VOID *
> +EFIAPI
> +WriteBackInvalidateDataCacheRange (
> + IN VOID *Address,
> + IN UINTN Length
> + )
> +{
> + ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
> + return Address;
> +}
> +
> +/**
> + Writes back the entire data cache in cache coherency domain of the calling
> + CPU.
> +
> + Writes back the entire data cache in cache coherency domain of the calling
> + CPU. This function guarantees that all dirty cache lines are written back to
> + system memory. This function may also invalidate all the data cache lines in
> + the cache coherency domain of the calling CPU.
> +
> +**/
> +VOID
> +EFIAPI
> +WriteBackDataCache (
> + VOID
> + )
> +{
> +}
> +
> +/**
> + Writes back a range of data cache lines in the cache coherency domain of the
> + calling CPU.
> +
> + Writes back the data cache lines specified by Address and Length. If Address
> + is not aligned on a cache line boundary, then entire data cache line
> + containing Address is written back. If Address + Length is not aligned on a
> + cache line boundary, then the entire data cache line containing Address +
> + Length -1 is written back. This function may choose to write back the entire
> + data cache if that is more efficient than writing back the specified range.
> + If Length is 0, then no data cache lines are written back. This function may
> + also invalidate all the data cache lines in the specified range of the cache
> + coherency domain of the calling CPU. Address is returned.
> +
> + If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
> +
> + @param Address The base address of the data cache lines to write back. If
> + the CPU is in a physical addressing mode, then Address is a
> + physical address. If the CPU is in a virtual addressing
> + mode, then Address is a virtual address.
> + @param Length The number of bytes to write back from the data cache.
> +
> + @return Address of cache written in main memory.
> +
> +**/
> +VOID *
> +EFIAPI
> +WriteBackDataCacheRange (
> + IN VOID *Address,
> + IN UINTN Length
> + )
> +{
> + ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
> + return Address;
> +}
> +
> +/**
> + Invalidates the entire data cache in cache coherency domain of the calling
> + CPU.
> +
> + Invalidates the entire data cache in cache coherency domain of the calling
> + CPU. This function must be used with care because dirty cache lines are not
> + written back to system memory. It is typically used for cache diagnostics. If
> + the CPU does not support invalidation of the entire data cache, then a write
> + back and invalidate operation should be performed on the entire data cache.
> +
> +**/
> +VOID
> +EFIAPI
> +InvalidateDataCache (
> + VOID
> + )
> +{
> +}
> +
> +/**
> + Invalidates a range of data cache lines in the cache coherency domain of the
> + calling CPU.
> +
> + Invalidates the data cache lines specified by Address and Length. If Address
> + is not aligned on a cache line boundary, then entire data cache line
> + containing Address is invalidated. If Address + Length is not aligned on a
> + cache line boundary, then the entire data cache line containing Address +
> + Length -1 is invalidated. This function must never invalidate any cache lines
> + outside the specified range. If Length is 0, then no data cache lines are
> + invalidated. Address is returned. This function must be used with care
> + because dirty cache lines are not written back to system memory. It is
> + typically used for cache diagnostics. If the CPU does not support
> + invalidation of a data cache range, then a write back and invalidate
> + operation should be performed on the data cache range.
> +
> + If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
> +
> + @param Address The base address of the data cache lines to invalidate. If
> + the CPU is in a physical addressing mode, then Address is a
> + physical address. If the CPU is in a virtual addressing mode,
> + then Address is a virtual address.
> + @param Length The number of bytes to invalidate from the data cache.
> +
> + @return Address.
> +
> +**/
> +VOID *
> +EFIAPI
> +InvalidateDataCacheRange (
> + IN VOID *Address,
> + IN UINTN Length
> + )
> +{
> + ASSERT (Length <= MAX_ADDRESS - (UINTN)Address + 1);
> + return Address;
> +}
> diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
> b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
> new file mode 100644
> index 0000000000..8d6eaaeaa0
> --- /dev/null
> +++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
> @@ -0,0 +1,29 @@
> +## @file
> +# Null Cache Maintenance Library implementation.
> +#
> +# Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> +# SPDX-License-Identifier: BSD-2-Clause-Patent
> +#
> +##
> +
> +[Defines]
> + INF_VERSION = 0x00010005
> + BASE_NAME = BaseCacheMaintenanceLibNull
> + MODULE_UNI_FILE = BaseCacheMaintenanceLibNull.uni
> + FILE_GUID = 13F13249-AC31-4373-8B2B-AFC5755A6FCD
> + MODULE_TYPE = BASE
> + VERSION_STRING = 1.1
> + LIBRARY_CLASS = CacheMaintenanceLib
> +
> +#
> +# VALID_ARCHITECTURES = IA32 X64 EBC ARM AARCH64
> +#
> +
> +[Sources]
> + BaseCacheMaintenanceLibNull.c
> +
> +[Packages]
> + MdePkg/MdePkg.dec
> +
> +[LibraryClasses]
> + DebugLib
> diff --git a/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
> b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
> new file mode 100644
> index 0000000000..260c756190
> --- /dev/null
> +++ b/MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.uni
> @@ -0,0 +1,12 @@
> +// /** @file
> +// Null Cache Maintenance Library implementation.
> +//
> +// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
> +// SPDX-License-Identifier: BSD-2-Clause-Patent
> +//
> +// **/
> +
> +#string STR_MODULE_ABSTRACT #language en-US "Null instance of Cache Maintenance Library"
> +
> +#string STR_MODULE_DESCRIPTION #language en-US "Null instance of the Cache Maintenance Library."
> +
> diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
> index 3abe65ec7f..472fa37774 100644
> --- a/MdePkg/MdePkg.dsc
> +++ b/MdePkg/MdePkg.dsc
> @@ -35,6 +35,7 @@ [LibraryClasses]
> [Components]
> MdePkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
> MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
> + MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
> MdePkg/Library/BaseCpuLib/BaseCpuLib.inf
> MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
> MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
> --
> 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread
* [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (2 preceding siblings ...)
2020-06-15 0:19 ` [Patch 03/15] MdePkg/BaseCacheMaintenanceLibNull: Add Null instance " Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-07-09 14:07 ` Liming Gao
2020-06-15 0:19 ` [Patch 05/15] MdePkg/Library/BaseLib: Add BaseLib instance for host based unit tests Michael D Kinney
` (10 subsequent siblings)
14 siblings, 1 reply; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2800
Break out the IA32/X64 GCC inline functions that can not be used
in a unit test host application into their own source file. This
does not make any changes to the BaseLib library instance. This
is in preparation for a new BaseLib instances that is safe to use
with host-based unit test applications.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
MdePkg/Library/BaseLib/BaseLib.inf | 4 +-
MdePkg/Library/BaseLib/Ia32/GccInline.c | 1181 +---------------
.../Ia32/{GccInline.c => GccInlinePriv.c} | 601 +-------
MdePkg/Library/BaseLib/X64/GccInline.c | 1240 +----------------
.../X64/{GccInline.c => GccInlinePriv.c} | 572 +-------
5 files changed, 11 insertions(+), 3587 deletions(-)
copy MdePkg/Library/BaseLib/Ia32/{GccInline.c => GccInlinePriv.c} (62%)
copy MdePkg/Library/BaseLib/X64/{GccInline.c => GccInlinePriv.c} (65%)
diff --git a/MdePkg/Library/BaseLib/BaseLib.inf b/MdePkg/Library/BaseLib/BaseLib.inf
index a57ae2da31..c740a819ca 100644
--- a/MdePkg/Library/BaseLib/BaseLib.inf
+++ b/MdePkg/Library/BaseLib/BaseLib.inf
@@ -1,7 +1,7 @@
## @file
# Base Library implementation.
#
-# Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
# Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
# Portions copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>
# Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
@@ -156,6 +156,7 @@ [Sources.Ia32]
Ia32/GccInline.c | GCC
+ Ia32/GccInlinePriv.c | GCC
Ia32/Thunk16.nasm
Ia32/EnableDisableInterrupts.nasm| GCC
Ia32/EnablePaging64.nasm
@@ -310,6 +311,7 @@ [Sources.X64]
X86PatchInstruction.c
X86SpeculationBarrier.c
X64/GccInline.c | GCC
+ X64/GccInlinePriv.c | GCC
X64/EnableDisableInterrupts.nasm
X64/DisablePaging64.nasm
X64/RdRand.nasm
diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c b/MdePkg/Library/BaseLib/Ia32/GccInline.c
index 5287200f87..6ed938187a 100644
--- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
+++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c
@@ -1,7 +1,7 @@
/** @file
GCC inline implementation of BaseLib processor specific functions.
- Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@@ -10,8 +10,6 @@
#include "BaseLibInternals.h"
-
-
/**
Used to serialize load and store operations.
@@ -31,41 +29,6 @@ MemoryFence (
__asm__ __volatile__ ("":::"memory");
}
-
-/**
- Enables CPU interrupts.
-
- Enables CPU interrupts.
-
-**/
-VOID
-EFIAPI
-EnableInterrupts (
- VOID
- )
-{
- __asm__ __volatile__ ("sti"::: "memory");
-}
-
-
-/**
- Disables CPU interrupts.
-
- Disables CPU interrupts.
-
-**/
-VOID
-EFIAPI
-DisableInterrupts (
- VOID
- )
-{
- __asm__ __volatile__ ("cli"::: "memory");
-}
-
-
-
-
/**
Requests CPU to pause for a short period of time.
@@ -82,7 +45,6 @@ CpuPause (
__asm__ __volatile__ ("pause");
}
-
/**
Generates a breakpoint on the CPU.
@@ -99,75 +61,6 @@ CpuBreakpoint (
__asm__ __volatile__ ("int $3");
}
-
-
-/**
- Returns a 64-bit Machine Specific Register(MSR).
-
- Reads and returns the 64-bit MSR specified by Index. No parameter checking is
- performed on Index, and some Index values may cause CPU exceptions. The
- caller must either guarantee that Index is valid, or the caller must set up
- exception handlers to catch the exceptions. This function is only available
- on IA-32 and X64.
-
- @param Index The 32-bit MSR index to read.
-
- @return The value of the MSR identified by Index.
-
-**/
-UINT64
-EFIAPI
-AsmReadMsr64 (
- IN UINT32 Index
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "rdmsr"
- : "=A" (Data) // %0
- : "c" (Index) // %1
- );
-
- return Data;
-}
-
-/**
- Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
- value.
-
- Writes the 64-bit value specified by Value to the MSR specified by Index. The
- 64-bit value written to the MSR is returned. No parameter checking is
- performed on Index or Value, and some of these may cause CPU exceptions. The
- caller must either guarantee that Index and Value are valid, or the caller
- must establish proper exception handlers. This function is only available on
- IA-32 and X64.
-
- @param Index The 32-bit MSR index to write.
- @param Value The 64-bit value to write to the MSR.
-
- @return Value
-
-**/
-UINT64
-EFIAPI
-AsmWriteMsr64 (
- IN UINT32 Index,
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "wrmsr"
- :
- : "c" (Index),
- "A" (Value)
- );
-
- return Value;
-}
-
-
-
/**
Reads the current value of the EFLAGS register.
@@ -195,965 +88,6 @@ AsmReadEflags (
return Eflags;
}
-
-
-/**
- Reads the current value of the Control Register 0 (CR0).
-
- Reads and returns the current value of CR0. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 0 (CR0).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr0 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%cr0,%0"
- : "=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of the Control Register 2 (CR2).
-
- Reads and returns the current value of CR2. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 2 (CR2).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr2 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%cr2, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-/**
- Reads the current value of the Control Register 3 (CR3).
-
- Reads and returns the current value of CR3. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 3 (CR3).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr3 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%cr3, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of the Control Register 4 (CR4).
-
- Reads and returns the current value of CR4. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 4 (CR4).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr4 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%cr4, %0"
- : "=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Writes a value to Control Register 0 (CR0).
-
- Writes and returns a new value to CR0. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr0 The value to write to CR0.
-
- @return The value written to CR0.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr0 (
- UINTN Cr0
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%cr0"
- :
- : "r" (Cr0)
- );
- return Cr0;
-}
-
-
-/**
- Writes a value to Control Register 2 (CR2).
-
- Writes and returns a new value to CR2. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr2 The value to write to CR2.
-
- @return The value written to CR2.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr2 (
- UINTN Cr2
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%cr2"
- :
- : "r" (Cr2)
- );
- return Cr2;
-}
-
-
-/**
- Writes a value to Control Register 3 (CR3).
-
- Writes and returns a new value to CR3. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr3 The value to write to CR3.
-
- @return The value written to CR3.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr3 (
- UINTN Cr3
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%cr3"
- :
- : "r" (Cr3)
- );
- return Cr3;
-}
-
-
-/**
- Writes a value to Control Register 4 (CR4).
-
- Writes and returns a new value to CR4. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr4 The value to write to CR4.
-
- @return The value written to CR4.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr4 (
- UINTN Cr4
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%cr4"
- :
- : "r" (Cr4)
- );
- return Cr4;
-}
-
-
-/**
- Reads the current value of Debug Register 0 (DR0).
-
- Reads and returns the current value of DR0. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 0 (DR0).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr0 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr0, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 1 (DR1).
-
- Reads and returns the current value of DR1. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 1 (DR1).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr1 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr1, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 2 (DR2).
-
- Reads and returns the current value of DR2. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 2 (DR2).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr2 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr2, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 3 (DR3).
-
- Reads and returns the current value of DR3. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 3 (DR3).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr3 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr3, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 4 (DR4).
-
- Reads and returns the current value of DR4. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 4 (DR4).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr4 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr4, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 5 (DR5).
-
- Reads and returns the current value of DR5. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 5 (DR5).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr5 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr5, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 6 (DR6).
-
- Reads and returns the current value of DR6. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 6 (DR6).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr6 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr6, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 7 (DR7).
-
- Reads and returns the current value of DR7. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 7 (DR7).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr7 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "movl %%dr7, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Writes a value to Debug Register 0 (DR0).
-
- Writes and returns a new value to DR0. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr0 The value to write to Dr0.
-
- @return The value written to Debug Register 0 (DR0).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr0 (
- UINTN Dr0
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr0"
- :
- : "r" (Dr0)
- );
- return Dr0;
-}
-
-
-/**
- Writes a value to Debug Register 1 (DR1).
-
- Writes and returns a new value to DR1. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr1 The value to write to Dr1.
-
- @return The value written to Debug Register 1 (DR1).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr1 (
- UINTN Dr1
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr1"
- :
- : "r" (Dr1)
- );
- return Dr1;
-}
-
-
-/**
- Writes a value to Debug Register 2 (DR2).
-
- Writes and returns a new value to DR2. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr2 The value to write to Dr2.
-
- @return The value written to Debug Register 2 (DR2).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr2 (
- UINTN Dr2
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr2"
- :
- : "r" (Dr2)
- );
- return Dr2;
-}
-
-
-/**
- Writes a value to Debug Register 3 (DR3).
-
- Writes and returns a new value to DR3. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr3 The value to write to Dr3.
-
- @return The value written to Debug Register 3 (DR3).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr3 (
- UINTN Dr3
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr3"
- :
- : "r" (Dr3)
- );
- return Dr3;
-}
-
-
-/**
- Writes a value to Debug Register 4 (DR4).
-
- Writes and returns a new value to DR4. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr4 The value to write to Dr4.
-
- @return The value written to Debug Register 4 (DR4).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr4 (
- UINTN Dr4
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr4"
- :
- : "r" (Dr4)
- );
- return Dr4;
-}
-
-
-/**
- Writes a value to Debug Register 5 (DR5).
-
- Writes and returns a new value to DR5. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr5 The value to write to Dr5.
-
- @return The value written to Debug Register 5 (DR5).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr5 (
- UINTN Dr5
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr5"
- :
- : "r" (Dr5)
- );
- return Dr5;
-}
-
-
-/**
- Writes a value to Debug Register 6 (DR6).
-
- Writes and returns a new value to DR6. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr6 The value to write to Dr6.
-
- @return The value written to Debug Register 6 (DR6).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr6 (
- UINTN Dr6
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr6"
- :
- : "r" (Dr6)
- );
- return Dr6;
-}
-
-
-/**
- Writes a value to Debug Register 7 (DR7).
-
- Writes and returns a new value to DR7. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr7 The value to write to Dr7.
-
- @return The value written to Debug Register 7 (DR7).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr7 (
- UINTN Dr7
- )
-{
- __asm__ __volatile__ (
- "movl %0, %%dr7"
- :
- : "r" (Dr7)
- );
- return Dr7;
-}
-
-
-/**
- Reads the current value of Code Segment Register (CS).
-
- Reads and returns the current value of CS. This function is only available on
- IA-32 and X64.
-
- @return The current value of CS.
-
-**/
-UINT16
-EFIAPI
-AsmReadCs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%cs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Data Segment Register (DS).
-
- Reads and returns the current value of DS. This function is only available on
- IA-32 and X64.
-
- @return The current value of DS.
-
-**/
-UINT16
-EFIAPI
-AsmReadDs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%ds, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Extra Segment Register (ES).
-
- Reads and returns the current value of ES. This function is only available on
- IA-32 and X64.
-
- @return The current value of ES.
-
-**/
-UINT16
-EFIAPI
-AsmReadEs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%es, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of FS Data Segment Register (FS).
-
- Reads and returns the current value of FS. This function is only available on
- IA-32 and X64.
-
- @return The current value of FS.
-
-**/
-UINT16
-EFIAPI
-AsmReadFs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%fs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of GS Data Segment Register (GS).
-
- Reads and returns the current value of GS. This function is only available on
- IA-32 and X64.
-
- @return The current value of GS.
-
-**/
-UINT16
-EFIAPI
-AsmReadGs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%gs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Stack Segment Register (SS).
-
- Reads and returns the current value of SS. This function is only available on
- IA-32 and X64.
-
- @return The current value of SS.
-
-**/
-UINT16
-EFIAPI
-AsmReadSs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%ds, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Task Register (TR).
-
- Reads and returns the current value of TR. This function is only available on
- IA-32 and X64.
-
- @return The current value of TR.
-
-**/
-UINT16
-EFIAPI
-AsmReadTr (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "str %0"
- : "=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current Global Descriptor Table Register(GDTR) descriptor.
-
- Reads and returns the current GDTR descriptor and returns it in Gdtr. This
- function is only available on IA-32 and X64.
-
- @param Gdtr The pointer to a GDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86ReadGdtr (
- OUT IA32_DESCRIPTOR *Gdtr
- )
-{
- __asm__ __volatile__ (
- "sgdt %0"
- : "=m" (*Gdtr)
- );
-}
-
-
-/**
- Writes the current Global Descriptor Table Register (GDTR) descriptor.
-
- Writes and the current GDTR descriptor specified by Gdtr. This function is
- only available on IA-32 and X64.
-
- @param Gdtr The pointer to a GDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86WriteGdtr (
- IN CONST IA32_DESCRIPTOR *Gdtr
- )
-{
- __asm__ __volatile__ (
- "lgdt %0"
- :
- : "m" (*Gdtr)
- );
-
-}
-
-
-/**
- Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.
-
- Reads and returns the current IDTR descriptor and returns it in Idtr. This
- function is only available on IA-32 and X64.
-
- @param Idtr The pointer to a IDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86ReadIdtr (
- OUT IA32_DESCRIPTOR *Idtr
- )
-{
- __asm__ __volatile__ (
- "sidt %0"
- : "=m" (*Idtr)
- );
-}
-
-
-/**
- Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.
-
- Writes the current IDTR descriptor and returns it in Idtr. This function is
- only available on IA-32 and X64.
-
- @param Idtr The pointer to a IDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86WriteIdtr (
- IN CONST IA32_DESCRIPTOR *Idtr
- )
-{
- __asm__ __volatile__ (
- "lidt %0"
- :
- : "m" (*Idtr)
- );
-}
-
-
-/**
- Reads the current Local Descriptor Table Register(LDTR) selector.
-
- Reads and returns the current 16-bit LDTR descriptor value. This function is
- only available on IA-32 and X64.
-
- @return The current selector of LDT.
-
-**/
-UINT16
-EFIAPI
-AsmReadLdtr (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "sldt %0"
- : "=g" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Writes the current Local Descriptor Table Register (GDTR) selector.
-
- Writes and the current LDTR descriptor specified by Ldtr. This function is
- only available on IA-32 and X64.
-
- @param Ldtr 16-bit LDTR selector value.
-
-**/
-VOID
-EFIAPI
-AsmWriteLdtr (
- IN UINT16 Ldtr
- )
-{
- __asm__ __volatile__ (
- "lldtw %0"
- :
- : "g" (Ldtr) // %0
- );
-}
-
-
/**
Save the current floating point/SSE/SSE2 context to a buffer.
@@ -1650,116 +584,3 @@ AsmReadTsc (
return Data;
}
-
-
-/**
- Reads the current value of a Performance Counter (PMC).
-
- Reads and returns the current value of performance counter specified by
- Index. This function is only available on IA-32 and X64.
-
- @param Index The 32-bit Performance Counter index to read.
-
- @return The value of the PMC specified by Index.
-
-**/
-UINT64
-EFIAPI
-AsmReadPmc (
- IN UINT32 Index
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "rdpmc"
- : "=A" (Data)
- : "c" (Index)
- );
-
- return Data;
-}
-
-
-
-
-/**
- Executes a WBINVD instruction.
-
- Executes a WBINVD instruction. This function is only available on IA-32 and
- X64.
-
-**/
-VOID
-EFIAPI
-AsmWbinvd (
- VOID
- )
-{
- __asm__ __volatile__ ("wbinvd":::"memory");
-}
-
-
-/**
- Executes a INVD instruction.
-
- Executes a INVD instruction. This function is only available on IA-32 and
- X64.
-
-**/
-VOID
-EFIAPI
-AsmInvd (
- VOID
- )
-{
- __asm__ __volatile__ ("invd":::"memory");
-
-}
-
-
-/**
- Flushes a cache line from all the instruction and data caches within the
- coherency domain of the CPU.
-
- Flushed the cache line specified by LinearAddress, and returns LinearAddress.
- This function is only available on IA-32 and X64.
-
- @param LinearAddress The address of the cache line to flush. If the CPU is
- in a physical addressing mode, then LinearAddress is a
- physical address. If the CPU is in a virtual
- addressing mode, then LinearAddress is a virtual
- address.
-
- @return LinearAddress
-**/
-VOID *
-EFIAPI
-AsmFlushCacheLine (
- IN VOID *LinearAddress
- )
-{
- UINT32 RegEdx;
-
- //
- // If the CPU does not support CLFLUSH instruction,
- // then promote flush range to flush entire cache.
- //
- AsmCpuid (0x01, NULL, NULL, NULL, &RegEdx);
- if ((RegEdx & BIT19) == 0) {
- __asm__ __volatile__ ("wbinvd":::"memory");
- return LinearAddress;
- }
-
-
- __asm__ __volatile__ (
- "clflush (%0)"
- : "+a" (LinearAddress)
- :
- : "memory"
- );
-
- return LinearAddress;
-}
-
-
diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
similarity index 62%
copy from MdePkg/Library/BaseLib/Ia32/GccInline.c
copy to MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
index 5287200f87..30aa63243b 100644
--- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
+++ b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
@@ -1,7 +1,8 @@
/** @file
- GCC inline implementation of BaseLib processor specific functions.
+ GCC inline implementation of BaseLib processor specific functions that use
+ privlidged instructions.
- Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@@ -10,28 +11,6 @@
#include "BaseLibInternals.h"
-
-
-/**
- Used to serialize load and store operations.
-
- All loads and stores that proceed calls to this function are guaranteed to be
- globally visible when this function returns.
-
-**/
-VOID
-EFIAPI
-MemoryFence (
- VOID
- )
-{
- // This is a little bit of overkill and it is more about the compiler that it is
- // actually processor synchronization. This is like the _ReadWriteBarrier
- // Microsoft specific intrinsic
- __asm__ __volatile__ ("":::"memory");
-}
-
-
/**
Enables CPU interrupts.
@@ -63,44 +42,6 @@ DisableInterrupts (
__asm__ __volatile__ ("cli"::: "memory");
}
-
-
-
-/**
- Requests CPU to pause for a short period of time.
-
- Requests CPU to pause for a short period of time. Typically used in MP
- systems to prevent memory starvation while waiting for a spin lock.
-
-**/
-VOID
-EFIAPI
-CpuPause (
- VOID
- )
-{
- __asm__ __volatile__ ("pause");
-}
-
-
-/**
- Generates a breakpoint on the CPU.
-
- Generates a breakpoint on the CPU. The breakpoint must be implemented such
- that code can resume normal execution after the breakpoint.
-
-**/
-VOID
-EFIAPI
-CpuBreakpoint (
- VOID
- )
-{
- __asm__ __volatile__ ("int $3");
-}
-
-
-
/**
Returns a 64-bit Machine Specific Register(MSR).
@@ -166,37 +107,6 @@ AsmWriteMsr64 (
return Value;
}
-
-
-/**
- Reads the current value of the EFLAGS register.
-
- Reads and returns the current value of the EFLAGS register. This function is
- only available on IA-32 and X64. This returns a 32-bit value on IA-32 and a
- 64-bit value on X64.
-
- @return EFLAGS on IA-32 or RFLAGS on X64.
-
-**/
-UINTN
-EFIAPI
-AsmReadEflags (
- VOID
- )
-{
- UINTN Eflags;
-
- __asm__ __volatile__ (
- "pushfl \n\t"
- "popl %0 "
- : "=r" (Eflags)
- );
-
- return Eflags;
-}
-
-
-
/**
Reads the current value of the Control Register 0 (CR0).
@@ -1153,505 +1063,6 @@ AsmWriteLdtr (
);
}
-
-/**
- Save the current floating point/SSE/SSE2 context to a buffer.
-
- Saves the current floating point/SSE/SSE2 state to the buffer specified by
- Buffer. Buffer must be aligned on a 16-byte boundary. This function is only
- available on IA-32 and X64.
-
- @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
-
-**/
-VOID
-EFIAPI
-InternalX86FxSave (
- OUT IA32_FX_BUFFER *Buffer
- )
-{
- __asm__ __volatile__ (
- "fxsave %0"
- :
- : "m" (*Buffer) // %0
- );
-}
-
-
-/**
- Restores the current floating point/SSE/SSE2 context from a buffer.
-
- Restores the current floating point/SSE/SSE2 state from the buffer specified
- by Buffer. Buffer must be aligned on a 16-byte boundary. This function is
- only available on IA-32 and X64.
-
- @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
-
-**/
-VOID
-EFIAPI
-InternalX86FxRestore (
- IN CONST IA32_FX_BUFFER *Buffer
- )
-{
- __asm__ __volatile__ (
- "fxrstor %0"
- :
- : "m" (*Buffer) // %0
- );
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #0 (MM0).
-
- Reads and returns the current value of MM0. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM0.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm0 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm0, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #1 (MM1).
-
- Reads and returns the current value of MM1. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM1.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm1 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm1, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #2 (MM2).
-
- Reads and returns the current value of MM2. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM2.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm2 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm2, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #3 (MM3).
-
- Reads and returns the current value of MM3. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM3.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm3 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm3, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #4 (MM4).
-
- Reads and returns the current value of MM4. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM4.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm4 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm4, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #5 (MM5).
-
- Reads and returns the current value of MM5. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM5.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm5 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm5, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #6 (MM6).
-
- Reads and returns the current value of MM6. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM6.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm6 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm6, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #7 (MM7).
-
- Reads and returns the current value of MM7. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM7.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm7 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "push %%eax \n\t"
- "push %%eax \n\t"
- "movq %%mm7, (%%esp)\n\t"
- "pop %%eax \n\t"
- "pop %%edx \n\t"
- : "=A" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #0 (MM0).
-
- Writes the current value of MM0. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM0.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm0 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm0" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #1 (MM1).
-
- Writes the current value of MM1. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM1.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm1 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm1" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #2 (MM2).
-
- Writes the current value of MM2. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM2.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm2 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm2" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #3 (MM3).
-
- Writes the current value of MM3. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM3.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm3 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm3" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #4 (MM4).
-
- Writes the current value of MM4. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM4.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm4 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm4" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #5 (MM5).
-
- Writes the current value of MM5. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM5.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm5 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm5" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #6 (MM6).
-
- Writes the current value of MM6. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM6.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm6 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm6" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #7 (MM7).
-
- Writes the current value of MM7. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM7.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm7 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movq %0, %%mm7" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Reads the current value of Time Stamp Counter (TSC).
-
- Reads and returns the current value of TSC. This function is only available
- on IA-32 and X64.
-
- @return The current value of TSC
-
-**/
-UINT64
-EFIAPI
-AsmReadTsc (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "rdtsc"
- : "=A" (Data)
- );
-
- return Data;
-}
-
-
/**
Reads the current value of a Performance Counter (PMC).
@@ -1680,9 +1091,6 @@ AsmReadPmc (
return Data;
}
-
-
-
/**
Executes a WBINVD instruction.
@@ -1699,7 +1107,6 @@ AsmWbinvd (
__asm__ __volatile__ ("wbinvd":::"memory");
}
-
/**
Executes a INVD instruction.
@@ -1761,5 +1168,3 @@ AsmFlushCacheLine (
return LinearAddress;
}
-
-
diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c b/MdePkg/Library/BaseLib/X64/GccInline.c
index 154ce1f57e..40a208f198 100644
--- a/MdePkg/Library/BaseLib/X64/GccInline.c
+++ b/MdePkg/Library/BaseLib/X64/GccInline.c
@@ -1,7 +1,7 @@
/** @file
GCC inline implementation of BaseLib processor specific functions.
- Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@@ -33,40 +33,6 @@ MemoryFence (
}
-/**
- Enables CPU interrupts.
-
- Enables CPU interrupts.
-
-**/
-VOID
-EFIAPI
-EnableInterrupts (
- VOID
- )
-{
- __asm__ __volatile__ ("sti"::: "memory");
-}
-
-
-/**
- Disables CPU interrupts.
-
- Disables CPU interrupts.
-
-**/
-VOID
-EFIAPI
-DisableInterrupts (
- VOID
- )
-{
- __asm__ __volatile__ ("cli"::: "memory");
-}
-
-
-
-
/**
Requests CPU to pause for a short period of time.
@@ -101,83 +67,6 @@ CpuBreakpoint (
}
-
-/**
- Returns a 64-bit Machine Specific Register(MSR).
-
- Reads and returns the 64-bit MSR specified by Index. No parameter checking is
- performed on Index, and some Index values may cause CPU exceptions. The
- caller must either guarantee that Index is valid, or the caller must set up
- exception handlers to catch the exceptions. This function is only available
- on IA-32 and X64.
-
- @param Index The 32-bit MSR index to read.
-
- @return The value of the MSR identified by Index.
-
-**/
-UINT64
-EFIAPI
-AsmReadMsr64 (
- IN UINT32 Index
- )
-{
- UINT32 LowData;
- UINT32 HighData;
-
- __asm__ __volatile__ (
- "rdmsr"
- : "=a" (LowData), // %0
- "=d" (HighData) // %1
- : "c" (Index) // %2
- );
-
- return (((UINT64)HighData) << 32) | LowData;
-}
-
-/**
- Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
- value.
-
- Writes the 64-bit value specified by Value to the MSR specified by Index. The
- 64-bit value written to the MSR is returned. No parameter checking is
- performed on Index or Value, and some of these may cause CPU exceptions. The
- caller must either guarantee that Index and Value are valid, or the caller
- must establish proper exception handlers. This function is only available on
- IA-32 and X64.
-
- @param Index The 32-bit MSR index to write.
- @param Value The 64-bit value to write to the MSR.
-
- @return Value
-
-**/
-UINT64
-EFIAPI
-AsmWriteMsr64 (
- IN UINT32 Index,
- IN UINT64 Value
- )
-{
- UINT32 LowData;
- UINT32 HighData;
-
- LowData = (UINT32)(Value);
- HighData = (UINT32)(Value >> 32);
-
- __asm__ __volatile__ (
- "wrmsr"
- :
- : "c" (Index),
- "a" (LowData),
- "d" (HighData)
- );
-
- return Value;
-}
-
-
-
/**
Reads the current value of the EFLAGS register.
@@ -205,965 +94,6 @@ AsmReadEflags (
return Eflags;
}
-
-
-/**
- Reads the current value of the Control Register 0 (CR0).
-
- Reads and returns the current value of CR0. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 0 (CR0).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr0 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%cr0,%0"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of the Control Register 2 (CR2).
-
- Reads and returns the current value of CR2. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 2 (CR2).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr2 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%cr2, %0"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-/**
- Reads the current value of the Control Register 3 (CR3).
-
- Reads and returns the current value of CR3. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 3 (CR3).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr3 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%cr3, %0"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of the Control Register 4 (CR4).
-
- Reads and returns the current value of CR4. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of the Control Register 4 (CR4).
-
-**/
-UINTN
-EFIAPI
-AsmReadCr4 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%cr4, %0"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Writes a value to Control Register 0 (CR0).
-
- Writes and returns a new value to CR0. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr0 The value to write to CR0.
-
- @return The value written to CR0.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr0 (
- UINTN Cr0
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%cr0"
- :
- : "r" (Cr0)
- );
- return Cr0;
-}
-
-
-/**
- Writes a value to Control Register 2 (CR2).
-
- Writes and returns a new value to CR2. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr2 The value to write to CR2.
-
- @return The value written to CR2.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr2 (
- UINTN Cr2
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%cr2"
- :
- : "r" (Cr2)
- );
- return Cr2;
-}
-
-
-/**
- Writes a value to Control Register 3 (CR3).
-
- Writes and returns a new value to CR3. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr3 The value to write to CR3.
-
- @return The value written to CR3.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr3 (
- UINTN Cr3
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%cr3"
- :
- : "r" (Cr3)
- );
- return Cr3;
-}
-
-
-/**
- Writes a value to Control Register 4 (CR4).
-
- Writes and returns a new value to CR4. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Cr4 The value to write to CR4.
-
- @return The value written to CR4.
-
-**/
-UINTN
-EFIAPI
-AsmWriteCr4 (
- UINTN Cr4
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%cr4"
- :
- : "r" (Cr4)
- );
- return Cr4;
-}
-
-
-/**
- Reads the current value of Debug Register 0 (DR0).
-
- Reads and returns the current value of DR0. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 0 (DR0).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr0 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr0, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 1 (DR1).
-
- Reads and returns the current value of DR1. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 1 (DR1).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr1 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr1, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 2 (DR2).
-
- Reads and returns the current value of DR2. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 2 (DR2).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr2 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr2, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 3 (DR3).
-
- Reads and returns the current value of DR3. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 3 (DR3).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr3 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr3, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 4 (DR4).
-
- Reads and returns the current value of DR4. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 4 (DR4).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr4 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr4, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 5 (DR5).
-
- Reads and returns the current value of DR5. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 5 (DR5).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr5 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr5, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 6 (DR6).
-
- Reads and returns the current value of DR6. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 6 (DR6).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr6 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr6, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Debug Register 7 (DR7).
-
- Reads and returns the current value of DR7. This function is only available
- on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
- X64.
-
- @return The value of Debug Register 7 (DR7).
-
-**/
-UINTN
-EFIAPI
-AsmReadDr7 (
- VOID
- )
-{
- UINTN Data;
-
- __asm__ __volatile__ (
- "mov %%dr7, %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Writes a value to Debug Register 0 (DR0).
-
- Writes and returns a new value to DR0. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr0 The value to write to Dr0.
-
- @return The value written to Debug Register 0 (DR0).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr0 (
- UINTN Dr0
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr0"
- :
- : "r" (Dr0)
- );
- return Dr0;
-}
-
-
-/**
- Writes a value to Debug Register 1 (DR1).
-
- Writes and returns a new value to DR1. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr1 The value to write to Dr1.
-
- @return The value written to Debug Register 1 (DR1).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr1 (
- UINTN Dr1
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr1"
- :
- : "r" (Dr1)
- );
- return Dr1;
-}
-
-
-/**
- Writes a value to Debug Register 2 (DR2).
-
- Writes and returns a new value to DR2. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr2 The value to write to Dr2.
-
- @return The value written to Debug Register 2 (DR2).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr2 (
- UINTN Dr2
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr2"
- :
- : "r" (Dr2)
- );
- return Dr2;
-}
-
-
-/**
- Writes a value to Debug Register 3 (DR3).
-
- Writes and returns a new value to DR3. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr3 The value to write to Dr3.
-
- @return The value written to Debug Register 3 (DR3).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr3 (
- UINTN Dr3
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr3"
- :
- : "r" (Dr3)
- );
- return Dr3;
-}
-
-
-/**
- Writes a value to Debug Register 4 (DR4).
-
- Writes and returns a new value to DR4. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr4 The value to write to Dr4.
-
- @return The value written to Debug Register 4 (DR4).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr4 (
- UINTN Dr4
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr4"
- :
- : "r" (Dr4)
- );
- return Dr4;
-}
-
-
-/**
- Writes a value to Debug Register 5 (DR5).
-
- Writes and returns a new value to DR5. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr5 The value to write to Dr5.
-
- @return The value written to Debug Register 5 (DR5).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr5 (
- UINTN Dr5
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr5"
- :
- : "r" (Dr5)
- );
- return Dr5;
-}
-
-
-/**
- Writes a value to Debug Register 6 (DR6).
-
- Writes and returns a new value to DR6. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr6 The value to write to Dr6.
-
- @return The value written to Debug Register 6 (DR6).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr6 (
- UINTN Dr6
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr6"
- :
- : "r" (Dr6)
- );
- return Dr6;
-}
-
-
-/**
- Writes a value to Debug Register 7 (DR7).
-
- Writes and returns a new value to DR7. This function is only available on
- IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
-
- @param Dr7 The value to write to Dr7.
-
- @return The value written to Debug Register 7 (DR7).
-
-**/
-UINTN
-EFIAPI
-AsmWriteDr7 (
- UINTN Dr7
- )
-{
- __asm__ __volatile__ (
- "mov %0, %%dr7"
- :
- : "r" (Dr7)
- );
- return Dr7;
-}
-
-
-/**
- Reads the current value of Code Segment Register (CS).
-
- Reads and returns the current value of CS. This function is only available on
- IA-32 and X64.
-
- @return The current value of CS.
-
-**/
-UINT16
-EFIAPI
-AsmReadCs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%cs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Data Segment Register (DS).
-
- Reads and returns the current value of DS. This function is only available on
- IA-32 and X64.
-
- @return The current value of DS.
-
-**/
-UINT16
-EFIAPI
-AsmReadDs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%ds, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Extra Segment Register (ES).
-
- Reads and returns the current value of ES. This function is only available on
- IA-32 and X64.
-
- @return The current value of ES.
-
-**/
-UINT16
-EFIAPI
-AsmReadEs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%es, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of FS Data Segment Register (FS).
-
- Reads and returns the current value of FS. This function is only available on
- IA-32 and X64.
-
- @return The current value of FS.
-
-**/
-UINT16
-EFIAPI
-AsmReadFs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%fs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of GS Data Segment Register (GS).
-
- Reads and returns the current value of GS. This function is only available on
- IA-32 and X64.
-
- @return The current value of GS.
-
-**/
-UINT16
-EFIAPI
-AsmReadGs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%gs, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Stack Segment Register (SS).
-
- Reads and returns the current value of SS. This function is only available on
- IA-32 and X64.
-
- @return The current value of SS.
-
-**/
-UINT16
-EFIAPI
-AsmReadSs (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "mov %%ds, %0"
- :"=a" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of Task Register (TR).
-
- Reads and returns the current value of TR. This function is only available on
- IA-32 and X64.
-
- @return The current value of TR.
-
-**/
-UINT16
-EFIAPI
-AsmReadTr (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "str %0"
- : "=r" (Data)
- );
-
- return Data;
-}
-
-
-/**
- Reads the current Global Descriptor Table Register(GDTR) descriptor.
-
- Reads and returns the current GDTR descriptor and returns it in Gdtr. This
- function is only available on IA-32 and X64.
-
- @param Gdtr The pointer to a GDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86ReadGdtr (
- OUT IA32_DESCRIPTOR *Gdtr
- )
-{
- __asm__ __volatile__ (
- "sgdt %0"
- : "=m" (*Gdtr)
- );
-}
-
-
-/**
- Writes the current Global Descriptor Table Register (GDTR) descriptor.
-
- Writes and the current GDTR descriptor specified by Gdtr. This function is
- only available on IA-32 and X64.
-
- @param Gdtr The pointer to a GDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86WriteGdtr (
- IN CONST IA32_DESCRIPTOR *Gdtr
- )
-{
- __asm__ __volatile__ (
- "lgdt %0"
- :
- : "m" (*Gdtr)
- );
-
-}
-
-
-/**
- Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.
-
- Reads and returns the current IDTR descriptor and returns it in Idtr. This
- function is only available on IA-32 and X64.
-
- @param Idtr The pointer to a IDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86ReadIdtr (
- OUT IA32_DESCRIPTOR *Idtr
- )
-{
- __asm__ __volatile__ (
- "sidt %0"
- : "=m" (*Idtr)
- );
-}
-
-
-/**
- Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.
-
- Writes the current IDTR descriptor and returns it in Idtr. This function is
- only available on IA-32 and X64.
-
- @param Idtr The pointer to a IDTR descriptor.
-
-**/
-VOID
-EFIAPI
-InternalX86WriteIdtr (
- IN CONST IA32_DESCRIPTOR *Idtr
- )
-{
- __asm__ __volatile__ (
- "lidt %0"
- :
- : "m" (*Idtr)
- );
-}
-
-
-/**
- Reads the current Local Descriptor Table Register(LDTR) selector.
-
- Reads and returns the current 16-bit LDTR descriptor value. This function is
- only available on IA-32 and X64.
-
- @return The current selector of LDT.
-
-**/
-UINT16
-EFIAPI
-AsmReadLdtr (
- VOID
- )
-{
- UINT16 Data;
-
- __asm__ __volatile__ (
- "sldt %0"
- : "=g" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Writes the current Local Descriptor Table Register (GDTR) selector.
-
- Writes and the current LDTR descriptor specified by Ldtr. This function is
- only available on IA-32 and X64.
-
- @param Ldtr 16-bit LDTR selector value.
-
-**/
-VOID
-EFIAPI
-AsmWriteLdtr (
- IN UINT16 Ldtr
- )
-{
- __asm__ __volatile__ (
- "lldtw %0"
- :
- : "g" (Ldtr) // %0
- );
-}
-
-
/**
Save the current floating point/SSE/SSE2 context to a buffer.
@@ -1630,171 +560,3 @@ AsmReadTsc (
return (((UINT64)HiData) << 32) | LowData;
}
-
-
-/**
- Reads the current value of a Performance Counter (PMC).
-
- Reads and returns the current value of performance counter specified by
- Index. This function is only available on IA-32 and X64.
-
- @param Index The 32-bit Performance Counter index to read.
-
- @return The value of the PMC specified by Index.
-
-**/
-UINT64
-EFIAPI
-AsmReadPmc (
- IN UINT32 Index
- )
-{
- UINT32 LowData;
- UINT32 HiData;
-
- __asm__ __volatile__ (
- "rdpmc"
- : "=a" (LowData),
- "=d" (HiData)
- : "c" (Index)
- );
-
- return (((UINT64)HiData) << 32) | LowData;
-}
-
-
-/**
- Sets up a monitor buffer that is used by AsmMwait().
-
- Executes a MONITOR instruction with the register state specified by Eax, Ecx
- and Edx. Returns Eax. This function is only available on IA-32 and X64.
-
- @param Eax The value to load into EAX or RAX before executing the MONITOR
- instruction.
- @param Ecx The value to load into ECX or RCX before executing the MONITOR
- instruction.
- @param Edx The value to load into EDX or RDX before executing the MONITOR
- instruction.
-
- @return Eax
-
-**/
-UINTN
-EFIAPI
-AsmMonitor (
- IN UINTN Eax,
- IN UINTN Ecx,
- IN UINTN Edx
- )
-{
- __asm__ __volatile__ (
- "monitor"
- :
- : "a" (Eax),
- "c" (Ecx),
- "d" (Edx)
- );
-
- return Eax;
-}
-
-
-/**
- Executes an MWAIT instruction.
-
- Executes an MWAIT instruction with the register state specified by Eax and
- Ecx. Returns Eax. This function is only available on IA-32 and X64.
-
- @param Eax The value to load into EAX or RAX before executing the MONITOR
- instruction.
- @param Ecx The value to load into ECX or RCX before executing the MONITOR
- instruction.
-
- @return Eax
-
-**/
-UINTN
-EFIAPI
-AsmMwait (
- IN UINTN Eax,
- IN UINTN Ecx
- )
-{
- __asm__ __volatile__ (
- "mwait"
- :
- : "a" (Eax),
- "c" (Ecx)
- );
-
- return Eax;
-}
-
-
-/**
- Executes a WBINVD instruction.
-
- Executes a WBINVD instruction. This function is only available on IA-32 and
- X64.
-
-**/
-VOID
-EFIAPI
-AsmWbinvd (
- VOID
- )
-{
- __asm__ __volatile__ ("wbinvd":::"memory");
-}
-
-
-/**
- Executes a INVD instruction.
-
- Executes a INVD instruction. This function is only available on IA-32 and
- X64.
-
-**/
-VOID
-EFIAPI
-AsmInvd (
- VOID
- )
-{
- __asm__ __volatile__ ("invd":::"memory");
-
-}
-
-
-/**
- Flushes a cache line from all the instruction and data caches within the
- coherency domain of the CPU.
-
- Flushed the cache line specified by LinearAddress, and returns LinearAddress.
- This function is only available on IA-32 and X64.
-
- @param LinearAddress The address of the cache line to flush. If the CPU is
- in a physical addressing mode, then LinearAddress is a
- physical address. If the CPU is in a virtual
- addressing mode, then LinearAddress is a virtual
- address.
-
- @return LinearAddress
-**/
-VOID *
-EFIAPI
-AsmFlushCacheLine (
- IN VOID *LinearAddress
- )
-{
- __asm__ __volatile__ (
- "clflush (%0)"
- :
- : "r" (LinearAddress)
- : "memory"
- );
-
- return LinearAddress;
-}
-
-
diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
similarity index 65%
copy from MdePkg/Library/BaseLib/X64/GccInline.c
copy to MdePkg/Library/BaseLib/X64/GccInlinePriv.c
index 154ce1f57e..98be19b3c7 100644
--- a/MdePkg/Library/BaseLib/X64/GccInline.c
+++ b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
@@ -1,7 +1,8 @@
/** @file
- GCC inline implementation of BaseLib processor specific functions.
+ GCC inline implementation of BaseLib processor specific functions that use
+ privlidged instructions.
- Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
+ Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
@@ -10,29 +11,6 @@
#include "BaseLibInternals.h"
-
-
-
-/**
- Used to serialize load and store operations.
-
- All loads and stores that proceed calls to this function are guaranteed to be
- globally visible when this function returns.
-
-**/
-VOID
-EFIAPI
-MemoryFence (
- VOID
- )
-{
- // This is a little bit of overkill and it is more about the compiler that it is
- // actually processor synchronization. This is like the _ReadWriteBarrier
- // Microsoft specific intrinsic
- __asm__ __volatile__ ("":::"memory");
-}
-
-
/**
Enables CPU interrupts.
@@ -64,44 +42,6 @@ DisableInterrupts (
__asm__ __volatile__ ("cli"::: "memory");
}
-
-
-
-/**
- Requests CPU to pause for a short period of time.
-
- Requests CPU to pause for a short period of time. Typically used in MP
- systems to prevent memory starvation while waiting for a spin lock.
-
-**/
-VOID
-EFIAPI
-CpuPause (
- VOID
- )
-{
- __asm__ __volatile__ ("pause");
-}
-
-
-/**
- Generates a breakpoint on the CPU.
-
- Generates a breakpoint on the CPU. The breakpoint must be implemented such
- that code can resume normal execution after the breakpoint.
-
-**/
-VOID
-EFIAPI
-CpuBreakpoint (
- VOID
- )
-{
- __asm__ __volatile__ ("int $3");
-}
-
-
-
/**
Returns a 64-bit Machine Specific Register(MSR).
@@ -176,37 +116,6 @@ AsmWriteMsr64 (
return Value;
}
-
-
-/**
- Reads the current value of the EFLAGS register.
-
- Reads and returns the current value of the EFLAGS register. This function is
- only available on IA-32 and X64. This returns a 32-bit value on IA-32 and a
- 64-bit value on X64.
-
- @return EFLAGS on IA-32 or RFLAGS on X64.
-
-**/
-UINTN
-EFIAPI
-AsmReadEflags (
- VOID
- )
-{
- UINTN Eflags;
-
- __asm__ __volatile__ (
- "pushfq \n\t"
- "pop %0 "
- : "=r" (Eflags) // %0
- );
-
- return Eflags;
-}
-
-
-
/**
Reads the current value of the Control Register 0 (CR0).
@@ -1163,475 +1072,6 @@ AsmWriteLdtr (
);
}
-
-/**
- Save the current floating point/SSE/SSE2 context to a buffer.
-
- Saves the current floating point/SSE/SSE2 state to the buffer specified by
- Buffer. Buffer must be aligned on a 16-byte boundary. This function is only
- available on IA-32 and X64.
-
- @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
-
-**/
-VOID
-EFIAPI
-InternalX86FxSave (
- OUT IA32_FX_BUFFER *Buffer
- )
-{
- __asm__ __volatile__ (
- "fxsave %0"
- :
- : "m" (*Buffer) // %0
- );
-}
-
-
-/**
- Restores the current floating point/SSE/SSE2 context from a buffer.
-
- Restores the current floating point/SSE/SSE2 state from the buffer specified
- by Buffer. Buffer must be aligned on a 16-byte boundary. This function is
- only available on IA-32 and X64.
-
- @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
-
-**/
-VOID
-EFIAPI
-InternalX86FxRestore (
- IN CONST IA32_FX_BUFFER *Buffer
- )
-{
- __asm__ __volatile__ (
- "fxrstor %0"
- :
- : "m" (*Buffer) // %0
- );
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #0 (MM0).
-
- Reads and returns the current value of MM0. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM0.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm0 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm0, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #1 (MM1).
-
- Reads and returns the current value of MM1. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM1.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm1 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm1, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #2 (MM2).
-
- Reads and returns the current value of MM2. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM2.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm2 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm2, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #3 (MM3).
-
- Reads and returns the current value of MM3. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM3.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm3 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm3, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #4 (MM4).
-
- Reads and returns the current value of MM4. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM4.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm4 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm4, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #5 (MM5).
-
- Reads and returns the current value of MM5. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM5.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm5 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm5, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #6 (MM6).
-
- Reads and returns the current value of MM6. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM6.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm6 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm6, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Reads the current value of 64-bit MMX Register #7 (MM7).
-
- Reads and returns the current value of MM7. This function is only available
- on IA-32 and X64.
-
- @return The current value of MM7.
-
-**/
-UINT64
-EFIAPI
-AsmReadMm7 (
- VOID
- )
-{
- UINT64 Data;
-
- __asm__ __volatile__ (
- "movd %%mm7, %0 \n\t"
- : "=r" (Data) // %0
- );
-
- return Data;
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #0 (MM0).
-
- Writes the current value of MM0. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM0.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm0 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm0" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #1 (MM1).
-
- Writes the current value of MM1. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM1.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm1 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm1" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #2 (MM2).
-
- Writes the current value of MM2. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM2.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm2 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm2" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #3 (MM3).
-
- Writes the current value of MM3. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM3.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm3 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm3" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #4 (MM4).
-
- Writes the current value of MM4. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM4.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm4 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm4" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #5 (MM5).
-
- Writes the current value of MM5. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM5.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm5 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm5" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #6 (MM6).
-
- Writes the current value of MM6. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM6.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm6 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm6" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Writes the current value of 64-bit MMX Register #7 (MM7).
-
- Writes the current value of MM7. This function is only available on IA32 and
- X64.
-
- @param Value The 64-bit value to write to MM7.
-
-**/
-VOID
-EFIAPI
-AsmWriteMm7 (
- IN UINT64 Value
- )
-{
- __asm__ __volatile__ (
- "movd %0, %%mm7" // %0
- :
- : "m" (Value)
- );
-}
-
-
-/**
- Reads the current value of Time Stamp Counter (TSC).
-
- Reads and returns the current value of TSC. This function is only available
- on IA-32 and X64.
-
- @return The current value of TSC
-
-**/
-UINT64
-EFIAPI
-AsmReadTsc (
- VOID
- )
-{
- UINT32 LowData;
- UINT32 HiData;
-
- __asm__ __volatile__ (
- "rdtsc"
- : "=a" (LowData),
- "=d" (HiData)
- );
-
- return (((UINT64)HiData) << 32) | LowData;
-}
-
-
/**
Reads the current value of a Performance Counter (PMC).
@@ -1662,7 +1102,6 @@ AsmReadPmc (
return (((UINT64)HiData) << 32) | LowData;
}
-
/**
Sets up a monitor buffer that is used by AsmMwait().
@@ -1698,7 +1137,6 @@ AsmMonitor (
return Eax;
}
-
/**
Executes an MWAIT instruction.
@@ -1730,7 +1168,6 @@ AsmMwait (
return Eax;
}
-
/**
Executes a WBINVD instruction.
@@ -1747,7 +1184,6 @@ AsmWbinvd (
__asm__ __volatile__ ("wbinvd":::"memory");
}
-
/**
Executes a INVD instruction.
@@ -1796,5 +1232,3 @@ AsmFlushCacheLine (
return LinearAddress;
}
-
-
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* Re: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
2020-06-15 0:19 ` [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions Michael D Kinney
@ 2020-07-09 14:07 ` Liming Gao
2020-07-09 17:00 ` Michael D Kinney
0 siblings, 1 reply; 23+ messages in thread
From: Liming Gao @ 2020-07-09 14:07 UTC (permalink / raw)
To: Kinney, Michael D, devel@edk2.groups.io
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Mike:
Is there the rule to know which function can't be in unit test? And, those functions will be in GccInline.c or GccInlinePriv.c? There is no change in MSFT C source file, because MSFT C source file has been separated as the function level. Right?
Thanks
Liming
> -----Original Message-----
> From: Kinney, Michael D <michael.d.kinney@intel.com>
> Sent: Monday, June 15, 2020 8:19 AM
> To: devel@edk2.groups.io
> Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan <sean.brogan@microsoft.com>; Bret Barkelew <Bret.Barkelew@microsoft.com>;
> Yao, Jiewen <jiewen.yao@intel.com>
> Subject: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
>
> https://bugzilla.tianocore.org/show_bug.cgi?id=2800
>
> Break out the IA32/X64 GCC inline functions that can not be used
> in a unit test host application into their own source file. This
> does not make any changes to the BaseLib library instance. This
> is in preparation for a new BaseLib instances that is safe to use
> with host-based unit test applications.
>
> Cc: Liming Gao <liming.gao@intel.com>
> Cc: Sean Brogan <sean.brogan@microsoft.com>
> Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> Cc: Jiewen Yao <jiewen.yao@intel.com>
> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
> ---
> MdePkg/Library/BaseLib/BaseLib.inf | 4 +-
> MdePkg/Library/BaseLib/Ia32/GccInline.c | 1181 +---------------
> .../Ia32/{GccInline.c => GccInlinePriv.c} | 601 +-------
> MdePkg/Library/BaseLib/X64/GccInline.c | 1240 +----------------
> .../X64/{GccInline.c => GccInlinePriv.c} | 572 +-------
> 5 files changed, 11 insertions(+), 3587 deletions(-)
> copy MdePkg/Library/BaseLib/Ia32/{GccInline.c => GccInlinePriv.c} (62%)
> copy MdePkg/Library/BaseLib/X64/{GccInline.c => GccInlinePriv.c} (65%)
>
> diff --git a/MdePkg/Library/BaseLib/BaseLib.inf b/MdePkg/Library/BaseLib/BaseLib.inf
> index a57ae2da31..c740a819ca 100644
> --- a/MdePkg/Library/BaseLib/BaseLib.inf
> +++ b/MdePkg/Library/BaseLib/BaseLib.inf
> @@ -1,7 +1,7 @@
> ## @file
> # Base Library implementation.
> #
> -# Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
> +# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
> # Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> # Portions copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>
> # Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
> @@ -156,6 +156,7 @@ [Sources.Ia32]
>
>
> Ia32/GccInline.c | GCC
> + Ia32/GccInlinePriv.c | GCC
> Ia32/Thunk16.nasm
> Ia32/EnableDisableInterrupts.nasm| GCC
> Ia32/EnablePaging64.nasm
> @@ -310,6 +311,7 @@ [Sources.X64]
> X86PatchInstruction.c
> X86SpeculationBarrier.c
> X64/GccInline.c | GCC
> + X64/GccInlinePriv.c | GCC
> X64/EnableDisableInterrupts.nasm
> X64/DisablePaging64.nasm
> X64/RdRand.nasm
> diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> index 5287200f87..6ed938187a 100644
> --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> +++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> @@ -1,7 +1,7 @@
> /** @file
> GCC inline implementation of BaseLib processor specific functions.
>
> - Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
> + Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> SPDX-License-Identifier: BSD-2-Clause-Patent
>
> @@ -10,8 +10,6 @@
>
> #include "BaseLibInternals.h"
>
> -
> -
> /**
> Used to serialize load and store operations.
>
> @@ -31,41 +29,6 @@ MemoryFence (
> __asm__ __volatile__ ("":::"memory");
> }
>
> -
> -/**
> - Enables CPU interrupts.
> -
> - Enables CPU interrupts.
> -
> -**/
> -VOID
> -EFIAPI
> -EnableInterrupts (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("sti"::: "memory");
> -}
> -
> -
> -/**
> - Disables CPU interrupts.
> -
> - Disables CPU interrupts.
> -
> -**/
> -VOID
> -EFIAPI
> -DisableInterrupts (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("cli"::: "memory");
> -}
> -
> -
> -
> -
> /**
> Requests CPU to pause for a short period of time.
>
> @@ -82,7 +45,6 @@ CpuPause (
> __asm__ __volatile__ ("pause");
> }
>
> -
> /**
> Generates a breakpoint on the CPU.
>
> @@ -99,75 +61,6 @@ CpuBreakpoint (
> __asm__ __volatile__ ("int $3");
> }
>
> -
> -
> -/**
> - Returns a 64-bit Machine Specific Register(MSR).
> -
> - Reads and returns the 64-bit MSR specified by Index. No parameter checking is
> - performed on Index, and some Index values may cause CPU exceptions. The
> - caller must either guarantee that Index is valid, or the caller must set up
> - exception handlers to catch the exceptions. This function is only available
> - on IA-32 and X64.
> -
> - @param Index The 32-bit MSR index to read.
> -
> - @return The value of the MSR identified by Index.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMsr64 (
> - IN UINT32 Index
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "rdmsr"
> - : "=A" (Data) // %0
> - : "c" (Index) // %1
> - );
> -
> - return Data;
> -}
> -
> -/**
> - Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
> - value.
> -
> - Writes the 64-bit value specified by Value to the MSR specified by Index. The
> - 64-bit value written to the MSR is returned. No parameter checking is
> - performed on Index or Value, and some of these may cause CPU exceptions. The
> - caller must either guarantee that Index and Value are valid, or the caller
> - must establish proper exception handlers. This function is only available on
> - IA-32 and X64.
> -
> - @param Index The 32-bit MSR index to write.
> - @param Value The 64-bit value to write to the MSR.
> -
> - @return Value
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmWriteMsr64 (
> - IN UINT32 Index,
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "wrmsr"
> - :
> - : "c" (Index),
> - "A" (Value)
> - );
> -
> - return Value;
> -}
> -
> -
> -
> /**
> Reads the current value of the EFLAGS register.
>
> @@ -195,965 +88,6 @@ AsmReadEflags (
> return Eflags;
> }
>
> -
> -
> -/**
> - Reads the current value of the Control Register 0 (CR0).
> -
> - Reads and returns the current value of CR0. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 0 (CR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr0 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%cr0,%0"
> - : "=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of the Control Register 2 (CR2).
> -
> - Reads and returns the current value of CR2. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 2 (CR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr2 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%cr2, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -/**
> - Reads the current value of the Control Register 3 (CR3).
> -
> - Reads and returns the current value of CR3. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 3 (CR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr3 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%cr3, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of the Control Register 4 (CR4).
> -
> - Reads and returns the current value of CR4. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 4 (CR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr4 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%cr4, %0"
> - : "=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 0 (CR0).
> -
> - Writes and returns a new value to CR0. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr0 The value to write to CR0.
> -
> - @return The value written to CR0.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr0 (
> - UINTN Cr0
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%cr0"
> - :
> - : "r" (Cr0)
> - );
> - return Cr0;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 2 (CR2).
> -
> - Writes and returns a new value to CR2. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr2 The value to write to CR2.
> -
> - @return The value written to CR2.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr2 (
> - UINTN Cr2
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%cr2"
> - :
> - : "r" (Cr2)
> - );
> - return Cr2;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 3 (CR3).
> -
> - Writes and returns a new value to CR3. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr3 The value to write to CR3.
> -
> - @return The value written to CR3.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr3 (
> - UINTN Cr3
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%cr3"
> - :
> - : "r" (Cr3)
> - );
> - return Cr3;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 4 (CR4).
> -
> - Writes and returns a new value to CR4. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr4 The value to write to CR4.
> -
> - @return The value written to CR4.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr4 (
> - UINTN Cr4
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%cr4"
> - :
> - : "r" (Cr4)
> - );
> - return Cr4;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 0 (DR0).
> -
> - Reads and returns the current value of DR0. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 0 (DR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr0 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr0, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 1 (DR1).
> -
> - Reads and returns the current value of DR1. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 1 (DR1).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr1 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr1, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 2 (DR2).
> -
> - Reads and returns the current value of DR2. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 2 (DR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr2 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr2, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 3 (DR3).
> -
> - Reads and returns the current value of DR3. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 3 (DR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr3 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr3, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 4 (DR4).
> -
> - Reads and returns the current value of DR4. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 4 (DR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr4 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr4, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 5 (DR5).
> -
> - Reads and returns the current value of DR5. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 5 (DR5).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr5 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr5, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 6 (DR6).
> -
> - Reads and returns the current value of DR6. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 6 (DR6).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr6 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr6, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 7 (DR7).
> -
> - Reads and returns the current value of DR7. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 7 (DR7).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr7 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "movl %%dr7, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 0 (DR0).
> -
> - Writes and returns a new value to DR0. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr0 The value to write to Dr0.
> -
> - @return The value written to Debug Register 0 (DR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr0 (
> - UINTN Dr0
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr0"
> - :
> - : "r" (Dr0)
> - );
> - return Dr0;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 1 (DR1).
> -
> - Writes and returns a new value to DR1. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr1 The value to write to Dr1.
> -
> - @return The value written to Debug Register 1 (DR1).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr1 (
> - UINTN Dr1
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr1"
> - :
> - : "r" (Dr1)
> - );
> - return Dr1;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 2 (DR2).
> -
> - Writes and returns a new value to DR2. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr2 The value to write to Dr2.
> -
> - @return The value written to Debug Register 2 (DR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr2 (
> - UINTN Dr2
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr2"
> - :
> - : "r" (Dr2)
> - );
> - return Dr2;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 3 (DR3).
> -
> - Writes and returns a new value to DR3. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr3 The value to write to Dr3.
> -
> - @return The value written to Debug Register 3 (DR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr3 (
> - UINTN Dr3
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr3"
> - :
> - : "r" (Dr3)
> - );
> - return Dr3;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 4 (DR4).
> -
> - Writes and returns a new value to DR4. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr4 The value to write to Dr4.
> -
> - @return The value written to Debug Register 4 (DR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr4 (
> - UINTN Dr4
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr4"
> - :
> - : "r" (Dr4)
> - );
> - return Dr4;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 5 (DR5).
> -
> - Writes and returns a new value to DR5. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr5 The value to write to Dr5.
> -
> - @return The value written to Debug Register 5 (DR5).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr5 (
> - UINTN Dr5
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr5"
> - :
> - : "r" (Dr5)
> - );
> - return Dr5;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 6 (DR6).
> -
> - Writes and returns a new value to DR6. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr6 The value to write to Dr6.
> -
> - @return The value written to Debug Register 6 (DR6).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr6 (
> - UINTN Dr6
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr6"
> - :
> - : "r" (Dr6)
> - );
> - return Dr6;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 7 (DR7).
> -
> - Writes and returns a new value to DR7. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr7 The value to write to Dr7.
> -
> - @return The value written to Debug Register 7 (DR7).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr7 (
> - UINTN Dr7
> - )
> -{
> - __asm__ __volatile__ (
> - "movl %0, %%dr7"
> - :
> - : "r" (Dr7)
> - );
> - return Dr7;
> -}
> -
> -
> -/**
> - Reads the current value of Code Segment Register (CS).
> -
> - Reads and returns the current value of CS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of CS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadCs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Data Segment Register (DS).
> -
> - Reads and returns the current value of DS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of DS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadDs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%ds, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Extra Segment Register (ES).
> -
> - Reads and returns the current value of ES. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of ES.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadEs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%es, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of FS Data Segment Register (FS).
> -
> - Reads and returns the current value of FS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of FS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadFs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%fs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of GS Data Segment Register (GS).
> -
> - Reads and returns the current value of GS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of GS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadGs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%gs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Stack Segment Register (SS).
> -
> - Reads and returns the current value of SS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of SS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadSs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%ds, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Task Register (TR).
> -
> - Reads and returns the current value of TR. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of TR.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadTr (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "str %0"
> - : "=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current Global Descriptor Table Register(GDTR) descriptor.
> -
> - Reads and returns the current GDTR descriptor and returns it in Gdtr. This
> - function is only available on IA-32 and X64.
> -
> - @param Gdtr The pointer to a GDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86ReadGdtr (
> - OUT IA32_DESCRIPTOR *Gdtr
> - )
> -{
> - __asm__ __volatile__ (
> - "sgdt %0"
> - : "=m" (*Gdtr)
> - );
> -}
> -
> -
> -/**
> - Writes the current Global Descriptor Table Register (GDTR) descriptor.
> -
> - Writes and the current GDTR descriptor specified by Gdtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Gdtr The pointer to a GDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86WriteGdtr (
> - IN CONST IA32_DESCRIPTOR *Gdtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lgdt %0"
> - :
> - : "m" (*Gdtr)
> - );
> -
> -}
> -
> -
> -/**
> - Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.
> -
> - Reads and returns the current IDTR descriptor and returns it in Idtr. This
> - function is only available on IA-32 and X64.
> -
> - @param Idtr The pointer to a IDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86ReadIdtr (
> - OUT IA32_DESCRIPTOR *Idtr
> - )
> -{
> - __asm__ __volatile__ (
> - "sidt %0"
> - : "=m" (*Idtr)
> - );
> -}
> -
> -
> -/**
> - Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.
> -
> - Writes the current IDTR descriptor and returns it in Idtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Idtr The pointer to a IDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86WriteIdtr (
> - IN CONST IA32_DESCRIPTOR *Idtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lidt %0"
> - :
> - : "m" (*Idtr)
> - );
> -}
> -
> -
> -/**
> - Reads the current Local Descriptor Table Register(LDTR) selector.
> -
> - Reads and returns the current 16-bit LDTR descriptor value. This function is
> - only available on IA-32 and X64.
> -
> - @return The current selector of LDT.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadLdtr (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "sldt %0"
> - : "=g" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes the current Local Descriptor Table Register (GDTR) selector.
> -
> - Writes and the current LDTR descriptor specified by Ldtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Ldtr 16-bit LDTR selector value.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteLdtr (
> - IN UINT16 Ldtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lldtw %0"
> - :
> - : "g" (Ldtr) // %0
> - );
> -}
> -
> -
> /**
> Save the current floating point/SSE/SSE2 context to a buffer.
>
> @@ -1650,116 +584,3 @@ AsmReadTsc (
>
> return Data;
> }
> -
> -
> -/**
> - Reads the current value of a Performance Counter (PMC).
> -
> - Reads and returns the current value of performance counter specified by
> - Index. This function is only available on IA-32 and X64.
> -
> - @param Index The 32-bit Performance Counter index to read.
> -
> - @return The value of the PMC specified by Index.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadPmc (
> - IN UINT32 Index
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "rdpmc"
> - : "=A" (Data)
> - : "c" (Index)
> - );
> -
> - return Data;
> -}
> -
> -
> -
> -
> -/**
> - Executes a WBINVD instruction.
> -
> - Executes a WBINVD instruction. This function is only available on IA-32 and
> - X64.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWbinvd (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("wbinvd":::"memory");
> -}
> -
> -
> -/**
> - Executes a INVD instruction.
> -
> - Executes a INVD instruction. This function is only available on IA-32 and
> - X64.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmInvd (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("invd":::"memory");
> -
> -}
> -
> -
> -/**
> - Flushes a cache line from all the instruction and data caches within the
> - coherency domain of the CPU.
> -
> - Flushed the cache line specified by LinearAddress, and returns LinearAddress.
> - This function is only available on IA-32 and X64.
> -
> - @param LinearAddress The address of the cache line to flush. If the CPU is
> - in a physical addressing mode, then LinearAddress is a
> - physical address. If the CPU is in a virtual
> - addressing mode, then LinearAddress is a virtual
> - address.
> -
> - @return LinearAddress
> -**/
> -VOID *
> -EFIAPI
> -AsmFlushCacheLine (
> - IN VOID *LinearAddress
> - )
> -{
> - UINT32 RegEdx;
> -
> - //
> - // If the CPU does not support CLFLUSH instruction,
> - // then promote flush range to flush entire cache.
> - //
> - AsmCpuid (0x01, NULL, NULL, NULL, &RegEdx);
> - if ((RegEdx & BIT19) == 0) {
> - __asm__ __volatile__ ("wbinvd":::"memory");
> - return LinearAddress;
> - }
> -
> -
> - __asm__ __volatile__ (
> - "clflush (%0)"
> - : "+a" (LinearAddress)
> - :
> - : "memory"
> - );
> -
> - return LinearAddress;
> -}
> -
> -
> diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> similarity index 62%
> copy from MdePkg/Library/BaseLib/Ia32/GccInline.c
> copy to MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> index 5287200f87..30aa63243b 100644
> --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> +++ b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> @@ -1,7 +1,8 @@
> /** @file
> - GCC inline implementation of BaseLib processor specific functions.
> + GCC inline implementation of BaseLib processor specific functions that use
> + privlidged instructions.
>
> - Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
> + Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> SPDX-License-Identifier: BSD-2-Clause-Patent
>
> @@ -10,28 +11,6 @@
>
> #include "BaseLibInternals.h"
>
> -
> -
> -/**
> - Used to serialize load and store operations.
> -
> - All loads and stores that proceed calls to this function are guaranteed to be
> - globally visible when this function returns.
> -
> -**/
> -VOID
> -EFIAPI
> -MemoryFence (
> - VOID
> - )
> -{
> - // This is a little bit of overkill and it is more about the compiler that it is
> - // actually processor synchronization. This is like the _ReadWriteBarrier
> - // Microsoft specific intrinsic
> - __asm__ __volatile__ ("":::"memory");
> -}
> -
> -
> /**
> Enables CPU interrupts.
>
> @@ -63,44 +42,6 @@ DisableInterrupts (
> __asm__ __volatile__ ("cli"::: "memory");
> }
>
> -
> -
> -
> -/**
> - Requests CPU to pause for a short period of time.
> -
> - Requests CPU to pause for a short period of time. Typically used in MP
> - systems to prevent memory starvation while waiting for a spin lock.
> -
> -**/
> -VOID
> -EFIAPI
> -CpuPause (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("pause");
> -}
> -
> -
> -/**
> - Generates a breakpoint on the CPU.
> -
> - Generates a breakpoint on the CPU. The breakpoint must be implemented such
> - that code can resume normal execution after the breakpoint.
> -
> -**/
> -VOID
> -EFIAPI
> -CpuBreakpoint (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("int $3");
> -}
> -
> -
> -
> /**
> Returns a 64-bit Machine Specific Register(MSR).
>
> @@ -166,37 +107,6 @@ AsmWriteMsr64 (
> return Value;
> }
>
> -
> -
> -/**
> - Reads the current value of the EFLAGS register.
> -
> - Reads and returns the current value of the EFLAGS register. This function is
> - only available on IA-32 and X64. This returns a 32-bit value on IA-32 and a
> - 64-bit value on X64.
> -
> - @return EFLAGS on IA-32 or RFLAGS on X64.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadEflags (
> - VOID
> - )
> -{
> - UINTN Eflags;
> -
> - __asm__ __volatile__ (
> - "pushfl \n\t"
> - "popl %0 "
> - : "=r" (Eflags)
> - );
> -
> - return Eflags;
> -}
> -
> -
> -
> /**
> Reads the current value of the Control Register 0 (CR0).
>
> @@ -1153,505 +1063,6 @@ AsmWriteLdtr (
> );
> }
>
> -
> -/**
> - Save the current floating point/SSE/SSE2 context to a buffer.
> -
> - Saves the current floating point/SSE/SSE2 state to the buffer specified by
> - Buffer. Buffer must be aligned on a 16-byte boundary. This function is only
> - available on IA-32 and X64.
> -
> - @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86FxSave (
> - OUT IA32_FX_BUFFER *Buffer
> - )
> -{
> - __asm__ __volatile__ (
> - "fxsave %0"
> - :
> - : "m" (*Buffer) // %0
> - );
> -}
> -
> -
> -/**
> - Restores the current floating point/SSE/SSE2 context from a buffer.
> -
> - Restores the current floating point/SSE/SSE2 state from the buffer specified
> - by Buffer. Buffer must be aligned on a 16-byte boundary. This function is
> - only available on IA-32 and X64.
> -
> - @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86FxRestore (
> - IN CONST IA32_FX_BUFFER *Buffer
> - )
> -{
> - __asm__ __volatile__ (
> - "fxrstor %0"
> - :
> - : "m" (*Buffer) // %0
> - );
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #0 (MM0).
> -
> - Reads and returns the current value of MM0. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM0.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm0 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm0, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #1 (MM1).
> -
> - Reads and returns the current value of MM1. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM1.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm1 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm1, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #2 (MM2).
> -
> - Reads and returns the current value of MM2. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM2.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm2 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm2, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #3 (MM3).
> -
> - Reads and returns the current value of MM3. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM3.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm3 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm3, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #4 (MM4).
> -
> - Reads and returns the current value of MM4. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM4.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm4 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm4, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #5 (MM5).
> -
> - Reads and returns the current value of MM5. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM5.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm5 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm5, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #6 (MM6).
> -
> - Reads and returns the current value of MM6. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM6.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm6 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm6, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #7 (MM7).
> -
> - Reads and returns the current value of MM7. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM7.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm7 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "push %%eax \n\t"
> - "push %%eax \n\t"
> - "movq %%mm7, (%%esp)\n\t"
> - "pop %%eax \n\t"
> - "pop %%edx \n\t"
> - : "=A" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #0 (MM0).
> -
> - Writes the current value of MM0. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM0.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm0 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm0" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #1 (MM1).
> -
> - Writes the current value of MM1. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM1.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm1 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm1" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #2 (MM2).
> -
> - Writes the current value of MM2. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM2.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm2 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm2" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #3 (MM3).
> -
> - Writes the current value of MM3. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM3.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm3 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm3" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #4 (MM4).
> -
> - Writes the current value of MM4. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM4.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm4 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm4" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #5 (MM5).
> -
> - Writes the current value of MM5. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM5.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm5 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm5" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #6 (MM6).
> -
> - Writes the current value of MM6. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM6.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm6 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm6" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #7 (MM7).
> -
> - Writes the current value of MM7. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM7.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm7 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movq %0, %%mm7" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Reads the current value of Time Stamp Counter (TSC).
> -
> - Reads and returns the current value of TSC. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of TSC
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadTsc (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "rdtsc"
> - : "=A" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> /**
> Reads the current value of a Performance Counter (PMC).
>
> @@ -1680,9 +1091,6 @@ AsmReadPmc (
> return Data;
> }
>
> -
> -
> -
> /**
> Executes a WBINVD instruction.
>
> @@ -1699,7 +1107,6 @@ AsmWbinvd (
> __asm__ __volatile__ ("wbinvd":::"memory");
> }
>
> -
> /**
> Executes a INVD instruction.
>
> @@ -1761,5 +1168,3 @@ AsmFlushCacheLine (
>
> return LinearAddress;
> }
> -
> -
> diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c b/MdePkg/Library/BaseLib/X64/GccInline.c
> index 154ce1f57e..40a208f198 100644
> --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> +++ b/MdePkg/Library/BaseLib/X64/GccInline.c
> @@ -1,7 +1,7 @@
> /** @file
> GCC inline implementation of BaseLib processor specific functions.
>
> - Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
> + Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> SPDX-License-Identifier: BSD-2-Clause-Patent
>
> @@ -33,40 +33,6 @@ MemoryFence (
> }
>
>
> -/**
> - Enables CPU interrupts.
> -
> - Enables CPU interrupts.
> -
> -**/
> -VOID
> -EFIAPI
> -EnableInterrupts (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("sti"::: "memory");
> -}
> -
> -
> -/**
> - Disables CPU interrupts.
> -
> - Disables CPU interrupts.
> -
> -**/
> -VOID
> -EFIAPI
> -DisableInterrupts (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("cli"::: "memory");
> -}
> -
> -
> -
> -
> /**
> Requests CPU to pause for a short period of time.
>
> @@ -101,83 +67,6 @@ CpuBreakpoint (
> }
>
>
> -
> -/**
> - Returns a 64-bit Machine Specific Register(MSR).
> -
> - Reads and returns the 64-bit MSR specified by Index. No parameter checking is
> - performed on Index, and some Index values may cause CPU exceptions. The
> - caller must either guarantee that Index is valid, or the caller must set up
> - exception handlers to catch the exceptions. This function is only available
> - on IA-32 and X64.
> -
> - @param Index The 32-bit MSR index to read.
> -
> - @return The value of the MSR identified by Index.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMsr64 (
> - IN UINT32 Index
> - )
> -{
> - UINT32 LowData;
> - UINT32 HighData;
> -
> - __asm__ __volatile__ (
> - "rdmsr"
> - : "=a" (LowData), // %0
> - "=d" (HighData) // %1
> - : "c" (Index) // %2
> - );
> -
> - return (((UINT64)HighData) << 32) | LowData;
> -}
> -
> -/**
> - Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
> - value.
> -
> - Writes the 64-bit value specified by Value to the MSR specified by Index. The
> - 64-bit value written to the MSR is returned. No parameter checking is
> - performed on Index or Value, and some of these may cause CPU exceptions. The
> - caller must either guarantee that Index and Value are valid, or the caller
> - must establish proper exception handlers. This function is only available on
> - IA-32 and X64.
> -
> - @param Index The 32-bit MSR index to write.
> - @param Value The 64-bit value to write to the MSR.
> -
> - @return Value
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmWriteMsr64 (
> - IN UINT32 Index,
> - IN UINT64 Value
> - )
> -{
> - UINT32 LowData;
> - UINT32 HighData;
> -
> - LowData = (UINT32)(Value);
> - HighData = (UINT32)(Value >> 32);
> -
> - __asm__ __volatile__ (
> - "wrmsr"
> - :
> - : "c" (Index),
> - "a" (LowData),
> - "d" (HighData)
> - );
> -
> - return Value;
> -}
> -
> -
> -
> /**
> Reads the current value of the EFLAGS register.
>
> @@ -205,965 +94,6 @@ AsmReadEflags (
> return Eflags;
> }
>
> -
> -
> -/**
> - Reads the current value of the Control Register 0 (CR0).
> -
> - Reads and returns the current value of CR0. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 0 (CR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr0 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cr0,%0"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of the Control Register 2 (CR2).
> -
> - Reads and returns the current value of CR2. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 2 (CR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr2 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cr2, %0"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -/**
> - Reads the current value of the Control Register 3 (CR3).
> -
> - Reads and returns the current value of CR3. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 3 (CR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr3 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cr3, %0"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of the Control Register 4 (CR4).
> -
> - Reads and returns the current value of CR4. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of the Control Register 4 (CR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadCr4 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cr4, %0"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 0 (CR0).
> -
> - Writes and returns a new value to CR0. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr0 The value to write to CR0.
> -
> - @return The value written to CR0.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr0 (
> - UINTN Cr0
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%cr0"
> - :
> - : "r" (Cr0)
> - );
> - return Cr0;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 2 (CR2).
> -
> - Writes and returns a new value to CR2. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr2 The value to write to CR2.
> -
> - @return The value written to CR2.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr2 (
> - UINTN Cr2
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%cr2"
> - :
> - : "r" (Cr2)
> - );
> - return Cr2;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 3 (CR3).
> -
> - Writes and returns a new value to CR3. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr3 The value to write to CR3.
> -
> - @return The value written to CR3.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr3 (
> - UINTN Cr3
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%cr3"
> - :
> - : "r" (Cr3)
> - );
> - return Cr3;
> -}
> -
> -
> -/**
> - Writes a value to Control Register 4 (CR4).
> -
> - Writes and returns a new value to CR4. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Cr4 The value to write to CR4.
> -
> - @return The value written to CR4.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteCr4 (
> - UINTN Cr4
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%cr4"
> - :
> - : "r" (Cr4)
> - );
> - return Cr4;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 0 (DR0).
> -
> - Reads and returns the current value of DR0. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 0 (DR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr0 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr0, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 1 (DR1).
> -
> - Reads and returns the current value of DR1. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 1 (DR1).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr1 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr1, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 2 (DR2).
> -
> - Reads and returns the current value of DR2. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 2 (DR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr2 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr2, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 3 (DR3).
> -
> - Reads and returns the current value of DR3. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 3 (DR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr3 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr3, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 4 (DR4).
> -
> - Reads and returns the current value of DR4. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 4 (DR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr4 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr4, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 5 (DR5).
> -
> - Reads and returns the current value of DR5. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 5 (DR5).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr5 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr5, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 6 (DR6).
> -
> - Reads and returns the current value of DR6. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 6 (DR6).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr6 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr6, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Debug Register 7 (DR7).
> -
> - Reads and returns the current value of DR7. This function is only available
> - on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on
> - X64.
> -
> - @return The value of Debug Register 7 (DR7).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadDr7 (
> - VOID
> - )
> -{
> - UINTN Data;
> -
> - __asm__ __volatile__ (
> - "mov %%dr7, %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 0 (DR0).
> -
> - Writes and returns a new value to DR0. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr0 The value to write to Dr0.
> -
> - @return The value written to Debug Register 0 (DR0).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr0 (
> - UINTN Dr0
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr0"
> - :
> - : "r" (Dr0)
> - );
> - return Dr0;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 1 (DR1).
> -
> - Writes and returns a new value to DR1. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr1 The value to write to Dr1.
> -
> - @return The value written to Debug Register 1 (DR1).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr1 (
> - UINTN Dr1
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr1"
> - :
> - : "r" (Dr1)
> - );
> - return Dr1;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 2 (DR2).
> -
> - Writes and returns a new value to DR2. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr2 The value to write to Dr2.
> -
> - @return The value written to Debug Register 2 (DR2).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr2 (
> - UINTN Dr2
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr2"
> - :
> - : "r" (Dr2)
> - );
> - return Dr2;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 3 (DR3).
> -
> - Writes and returns a new value to DR3. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr3 The value to write to Dr3.
> -
> - @return The value written to Debug Register 3 (DR3).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr3 (
> - UINTN Dr3
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr3"
> - :
> - : "r" (Dr3)
> - );
> - return Dr3;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 4 (DR4).
> -
> - Writes and returns a new value to DR4. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr4 The value to write to Dr4.
> -
> - @return The value written to Debug Register 4 (DR4).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr4 (
> - UINTN Dr4
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr4"
> - :
> - : "r" (Dr4)
> - );
> - return Dr4;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 5 (DR5).
> -
> - Writes and returns a new value to DR5. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr5 The value to write to Dr5.
> -
> - @return The value written to Debug Register 5 (DR5).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr5 (
> - UINTN Dr5
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr5"
> - :
> - : "r" (Dr5)
> - );
> - return Dr5;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 6 (DR6).
> -
> - Writes and returns a new value to DR6. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr6 The value to write to Dr6.
> -
> - @return The value written to Debug Register 6 (DR6).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr6 (
> - UINTN Dr6
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr6"
> - :
> - : "r" (Dr6)
> - );
> - return Dr6;
> -}
> -
> -
> -/**
> - Writes a value to Debug Register 7 (DR7).
> -
> - Writes and returns a new value to DR7. This function is only available on
> - IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.
> -
> - @param Dr7 The value to write to Dr7.
> -
> - @return The value written to Debug Register 7 (DR7).
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmWriteDr7 (
> - UINTN Dr7
> - )
> -{
> - __asm__ __volatile__ (
> - "mov %0, %%dr7"
> - :
> - : "r" (Dr7)
> - );
> - return Dr7;
> -}
> -
> -
> -/**
> - Reads the current value of Code Segment Register (CS).
> -
> - Reads and returns the current value of CS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of CS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadCs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%cs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Data Segment Register (DS).
> -
> - Reads and returns the current value of DS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of DS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadDs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%ds, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Extra Segment Register (ES).
> -
> - Reads and returns the current value of ES. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of ES.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadEs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%es, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of FS Data Segment Register (FS).
> -
> - Reads and returns the current value of FS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of FS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadFs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%fs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of GS Data Segment Register (GS).
> -
> - Reads and returns the current value of GS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of GS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadGs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%gs, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Stack Segment Register (SS).
> -
> - Reads and returns the current value of SS. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of SS.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadSs (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "mov %%ds, %0"
> - :"=a" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of Task Register (TR).
> -
> - Reads and returns the current value of TR. This function is only available on
> - IA-32 and X64.
> -
> - @return The current value of TR.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadTr (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "str %0"
> - : "=r" (Data)
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current Global Descriptor Table Register(GDTR) descriptor.
> -
> - Reads and returns the current GDTR descriptor and returns it in Gdtr. This
> - function is only available on IA-32 and X64.
> -
> - @param Gdtr The pointer to a GDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86ReadGdtr (
> - OUT IA32_DESCRIPTOR *Gdtr
> - )
> -{
> - __asm__ __volatile__ (
> - "sgdt %0"
> - : "=m" (*Gdtr)
> - );
> -}
> -
> -
> -/**
> - Writes the current Global Descriptor Table Register (GDTR) descriptor.
> -
> - Writes and the current GDTR descriptor specified by Gdtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Gdtr The pointer to a GDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86WriteGdtr (
> - IN CONST IA32_DESCRIPTOR *Gdtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lgdt %0"
> - :
> - : "m" (*Gdtr)
> - );
> -
> -}
> -
> -
> -/**
> - Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.
> -
> - Reads and returns the current IDTR descriptor and returns it in Idtr. This
> - function is only available on IA-32 and X64.
> -
> - @param Idtr The pointer to a IDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86ReadIdtr (
> - OUT IA32_DESCRIPTOR *Idtr
> - )
> -{
> - __asm__ __volatile__ (
> - "sidt %0"
> - : "=m" (*Idtr)
> - );
> -}
> -
> -
> -/**
> - Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.
> -
> - Writes the current IDTR descriptor and returns it in Idtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Idtr The pointer to a IDTR descriptor.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86WriteIdtr (
> - IN CONST IA32_DESCRIPTOR *Idtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lidt %0"
> - :
> - : "m" (*Idtr)
> - );
> -}
> -
> -
> -/**
> - Reads the current Local Descriptor Table Register(LDTR) selector.
> -
> - Reads and returns the current 16-bit LDTR descriptor value. This function is
> - only available on IA-32 and X64.
> -
> - @return The current selector of LDT.
> -
> -**/
> -UINT16
> -EFIAPI
> -AsmReadLdtr (
> - VOID
> - )
> -{
> - UINT16 Data;
> -
> - __asm__ __volatile__ (
> - "sldt %0"
> - : "=g" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes the current Local Descriptor Table Register (GDTR) selector.
> -
> - Writes and the current LDTR descriptor specified by Ldtr. This function is
> - only available on IA-32 and X64.
> -
> - @param Ldtr 16-bit LDTR selector value.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteLdtr (
> - IN UINT16 Ldtr
> - )
> -{
> - __asm__ __volatile__ (
> - "lldtw %0"
> - :
> - : "g" (Ldtr) // %0
> - );
> -}
> -
> -
> /**
> Save the current floating point/SSE/SSE2 context to a buffer.
>
> @@ -1630,171 +560,3 @@ AsmReadTsc (
>
> return (((UINT64)HiData) << 32) | LowData;
> }
> -
> -
> -/**
> - Reads the current value of a Performance Counter (PMC).
> -
> - Reads and returns the current value of performance counter specified by
> - Index. This function is only available on IA-32 and X64.
> -
> - @param Index The 32-bit Performance Counter index to read.
> -
> - @return The value of the PMC specified by Index.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadPmc (
> - IN UINT32 Index
> - )
> -{
> - UINT32 LowData;
> - UINT32 HiData;
> -
> - __asm__ __volatile__ (
> - "rdpmc"
> - : "=a" (LowData),
> - "=d" (HiData)
> - : "c" (Index)
> - );
> -
> - return (((UINT64)HiData) << 32) | LowData;
> -}
> -
> -
> -/**
> - Sets up a monitor buffer that is used by AsmMwait().
> -
> - Executes a MONITOR instruction with the register state specified by Eax, Ecx
> - and Edx. Returns Eax. This function is only available on IA-32 and X64.
> -
> - @param Eax The value to load into EAX or RAX before executing the MONITOR
> - instruction.
> - @param Ecx The value to load into ECX or RCX before executing the MONITOR
> - instruction.
> - @param Edx The value to load into EDX or RDX before executing the MONITOR
> - instruction.
> -
> - @return Eax
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmMonitor (
> - IN UINTN Eax,
> - IN UINTN Ecx,
> - IN UINTN Edx
> - )
> -{
> - __asm__ __volatile__ (
> - "monitor"
> - :
> - : "a" (Eax),
> - "c" (Ecx),
> - "d" (Edx)
> - );
> -
> - return Eax;
> -}
> -
> -
> -/**
> - Executes an MWAIT instruction.
> -
> - Executes an MWAIT instruction with the register state specified by Eax and
> - Ecx. Returns Eax. This function is only available on IA-32 and X64.
> -
> - @param Eax The value to load into EAX or RAX before executing the MONITOR
> - instruction.
> - @param Ecx The value to load into ECX or RCX before executing the MONITOR
> - instruction.
> -
> - @return Eax
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmMwait (
> - IN UINTN Eax,
> - IN UINTN Ecx
> - )
> -{
> - __asm__ __volatile__ (
> - "mwait"
> - :
> - : "a" (Eax),
> - "c" (Ecx)
> - );
> -
> - return Eax;
> -}
> -
> -
> -/**
> - Executes a WBINVD instruction.
> -
> - Executes a WBINVD instruction. This function is only available on IA-32 and
> - X64.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWbinvd (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("wbinvd":::"memory");
> -}
> -
> -
> -/**
> - Executes a INVD instruction.
> -
> - Executes a INVD instruction. This function is only available on IA-32 and
> - X64.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmInvd (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("invd":::"memory");
> -
> -}
> -
> -
> -/**
> - Flushes a cache line from all the instruction and data caches within the
> - coherency domain of the CPU.
> -
> - Flushed the cache line specified by LinearAddress, and returns LinearAddress.
> - This function is only available on IA-32 and X64.
> -
> - @param LinearAddress The address of the cache line to flush. If the CPU is
> - in a physical addressing mode, then LinearAddress is a
> - physical address. If the CPU is in a virtual
> - addressing mode, then LinearAddress is a virtual
> - address.
> -
> - @return LinearAddress
> -**/
> -VOID *
> -EFIAPI
> -AsmFlushCacheLine (
> - IN VOID *LinearAddress
> - )
> -{
> - __asm__ __volatile__ (
> - "clflush (%0)"
> - :
> - : "r" (LinearAddress)
> - : "memory"
> - );
> -
> - return LinearAddress;
> -}
> -
> -
> diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> similarity index 65%
> copy from MdePkg/Library/BaseLib/X64/GccInline.c
> copy to MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> index 154ce1f57e..98be19b3c7 100644
> --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> +++ b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> @@ -1,7 +1,8 @@
> /** @file
> - GCC inline implementation of BaseLib processor specific functions.
> + GCC inline implementation of BaseLib processor specific functions that use
> + privlidged instructions.
>
> - Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
> + Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
> SPDX-License-Identifier: BSD-2-Clause-Patent
>
> @@ -10,29 +11,6 @@
>
> #include "BaseLibInternals.h"
>
> -
> -
> -
> -/**
> - Used to serialize load and store operations.
> -
> - All loads and stores that proceed calls to this function are guaranteed to be
> - globally visible when this function returns.
> -
> -**/
> -VOID
> -EFIAPI
> -MemoryFence (
> - VOID
> - )
> -{
> - // This is a little bit of overkill and it is more about the compiler that it is
> - // actually processor synchronization. This is like the _ReadWriteBarrier
> - // Microsoft specific intrinsic
> - __asm__ __volatile__ ("":::"memory");
> -}
> -
> -
> /**
> Enables CPU interrupts.
>
> @@ -64,44 +42,6 @@ DisableInterrupts (
> __asm__ __volatile__ ("cli"::: "memory");
> }
>
> -
> -
> -
> -/**
> - Requests CPU to pause for a short period of time.
> -
> - Requests CPU to pause for a short period of time. Typically used in MP
> - systems to prevent memory starvation while waiting for a spin lock.
> -
> -**/
> -VOID
> -EFIAPI
> -CpuPause (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("pause");
> -}
> -
> -
> -/**
> - Generates a breakpoint on the CPU.
> -
> - Generates a breakpoint on the CPU. The breakpoint must be implemented such
> - that code can resume normal execution after the breakpoint.
> -
> -**/
> -VOID
> -EFIAPI
> -CpuBreakpoint (
> - VOID
> - )
> -{
> - __asm__ __volatile__ ("int $3");
> -}
> -
> -
> -
> /**
> Returns a 64-bit Machine Specific Register(MSR).
>
> @@ -176,37 +116,6 @@ AsmWriteMsr64 (
> return Value;
> }
>
> -
> -
> -/**
> - Reads the current value of the EFLAGS register.
> -
> - Reads and returns the current value of the EFLAGS register. This function is
> - only available on IA-32 and X64. This returns a 32-bit value on IA-32 and a
> - 64-bit value on X64.
> -
> - @return EFLAGS on IA-32 or RFLAGS on X64.
> -
> -**/
> -UINTN
> -EFIAPI
> -AsmReadEflags (
> - VOID
> - )
> -{
> - UINTN Eflags;
> -
> - __asm__ __volatile__ (
> - "pushfq \n\t"
> - "pop %0 "
> - : "=r" (Eflags) // %0
> - );
> -
> - return Eflags;
> -}
> -
> -
> -
> /**
> Reads the current value of the Control Register 0 (CR0).
>
> @@ -1163,475 +1072,6 @@ AsmWriteLdtr (
> );
> }
>
> -
> -/**
> - Save the current floating point/SSE/SSE2 context to a buffer.
> -
> - Saves the current floating point/SSE/SSE2 state to the buffer specified by
> - Buffer. Buffer must be aligned on a 16-byte boundary. This function is only
> - available on IA-32 and X64.
> -
> - @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86FxSave (
> - OUT IA32_FX_BUFFER *Buffer
> - )
> -{
> - __asm__ __volatile__ (
> - "fxsave %0"
> - :
> - : "m" (*Buffer) // %0
> - );
> -}
> -
> -
> -/**
> - Restores the current floating point/SSE/SSE2 context from a buffer.
> -
> - Restores the current floating point/SSE/SSE2 state from the buffer specified
> - by Buffer. Buffer must be aligned on a 16-byte boundary. This function is
> - only available on IA-32 and X64.
> -
> - @param Buffer The pointer to a buffer to save the floating point/SSE/SSE2 context.
> -
> -**/
> -VOID
> -EFIAPI
> -InternalX86FxRestore (
> - IN CONST IA32_FX_BUFFER *Buffer
> - )
> -{
> - __asm__ __volatile__ (
> - "fxrstor %0"
> - :
> - : "m" (*Buffer) // %0
> - );
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #0 (MM0).
> -
> - Reads and returns the current value of MM0. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM0.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm0 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm0, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #1 (MM1).
> -
> - Reads and returns the current value of MM1. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM1.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm1 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm1, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #2 (MM2).
> -
> - Reads and returns the current value of MM2. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM2.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm2 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm2, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #3 (MM3).
> -
> - Reads and returns the current value of MM3. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM3.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm3 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm3, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #4 (MM4).
> -
> - Reads and returns the current value of MM4. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM4.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm4 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm4, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #5 (MM5).
> -
> - Reads and returns the current value of MM5. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM5.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm5 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm5, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #6 (MM6).
> -
> - Reads and returns the current value of MM6. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM6.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm6 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm6, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Reads the current value of 64-bit MMX Register #7 (MM7).
> -
> - Reads and returns the current value of MM7. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of MM7.
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadMm7 (
> - VOID
> - )
> -{
> - UINT64 Data;
> -
> - __asm__ __volatile__ (
> - "movd %%mm7, %0 \n\t"
> - : "=r" (Data) // %0
> - );
> -
> - return Data;
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #0 (MM0).
> -
> - Writes the current value of MM0. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM0.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm0 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm0" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #1 (MM1).
> -
> - Writes the current value of MM1. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM1.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm1 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm1" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #2 (MM2).
> -
> - Writes the current value of MM2. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM2.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm2 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm2" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #3 (MM3).
> -
> - Writes the current value of MM3. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM3.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm3 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm3" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #4 (MM4).
> -
> - Writes the current value of MM4. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM4.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm4 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm4" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #5 (MM5).
> -
> - Writes the current value of MM5. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM5.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm5 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm5" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #6 (MM6).
> -
> - Writes the current value of MM6. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM6.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm6 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm6" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Writes the current value of 64-bit MMX Register #7 (MM7).
> -
> - Writes the current value of MM7. This function is only available on IA32 and
> - X64.
> -
> - @param Value The 64-bit value to write to MM7.
> -
> -**/
> -VOID
> -EFIAPI
> -AsmWriteMm7 (
> - IN UINT64 Value
> - )
> -{
> - __asm__ __volatile__ (
> - "movd %0, %%mm7" // %0
> - :
> - : "m" (Value)
> - );
> -}
> -
> -
> -/**
> - Reads the current value of Time Stamp Counter (TSC).
> -
> - Reads and returns the current value of TSC. This function is only available
> - on IA-32 and X64.
> -
> - @return The current value of TSC
> -
> -**/
> -UINT64
> -EFIAPI
> -AsmReadTsc (
> - VOID
> - )
> -{
> - UINT32 LowData;
> - UINT32 HiData;
> -
> - __asm__ __volatile__ (
> - "rdtsc"
> - : "=a" (LowData),
> - "=d" (HiData)
> - );
> -
> - return (((UINT64)HiData) << 32) | LowData;
> -}
> -
> -
> /**
> Reads the current value of a Performance Counter (PMC).
>
> @@ -1662,7 +1102,6 @@ AsmReadPmc (
> return (((UINT64)HiData) << 32) | LowData;
> }
>
> -
> /**
> Sets up a monitor buffer that is used by AsmMwait().
>
> @@ -1698,7 +1137,6 @@ AsmMonitor (
> return Eax;
> }
>
> -
> /**
> Executes an MWAIT instruction.
>
> @@ -1730,7 +1168,6 @@ AsmMwait (
> return Eax;
> }
>
> -
> /**
> Executes a WBINVD instruction.
>
> @@ -1747,7 +1184,6 @@ AsmWbinvd (
> __asm__ __volatile__ ("wbinvd":::"memory");
> }
>
> -
> /**
> Executes a INVD instruction.
>
> @@ -1796,5 +1232,3 @@ AsmFlushCacheLine (
>
> return LinearAddress;
> }
> -
> -
> --
> 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread* Re: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
2020-07-09 14:07 ` Liming Gao
@ 2020-07-09 17:00 ` Michael D Kinney
2020-07-10 8:06 ` Liming Gao
0 siblings, 1 reply; 23+ messages in thread
From: Michael D Kinney @ 2020-07-09 17:00 UTC (permalink / raw)
To: Gao, Liming, devel@edk2.groups.io, Kinney, Michael D
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Liming,
In order to support host based unit tests, all the code
has to be compatible with a user mode process. This means
any functions that execute instructions that are not allowed
in a user mode process need to be separated out.
For the IA32/X64 specific GccInline.c files, the analysis
was done for APIs that use instructions that would
generate an exception in a user mode process.
In addition, the BaseLib functions that return system
state (e.g. CS/DS/ES/SS/FS/GS) are also split out. It
does not make sense to return system state information
from the currently executing user mode process. Instead,
the FW code under test would expect system state that
matches a FW execution environment. Each unit test
implementation has the option of providing emulation
of this system state if that is required to exercise the
code under test.
No changes to the MSFT specific BaseLib implementation
were required because there those are already split out
to one function per file.
Best regards,
Mike
> -----Original Message-----
> From: Gao, Liming <liming.gao@intel.com>
> Sent: Thursday, July 9, 2020 7:07 AM
> To: Kinney, Michael D <michael.d.kinney@intel.com>;
> devel@edk2.groups.io
> Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret
> Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> <jiewen.yao@intel.com>
> Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
>
> Mike:
> Is there the rule to know which function can't be in
> unit test? And, those functions will be in GccInline.c
> or GccInlinePriv.c? There is no change in MSFT C source
> file, because MSFT C source file has been separated as
> the function level. Right?
>
> Thanks
> Liming
> > -----Original Message-----
> > From: Kinney, Michael D <michael.d.kinney@intel.com>
> > Sent: Monday, June 15, 2020 8:19 AM
> > To: devel@edk2.groups.io
> > Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan
> <sean.brogan@microsoft.com>; Bret Barkelew
> <Bret.Barkelew@microsoft.com>;
> > Yao, Jiewen <jiewen.yao@intel.com>
> > Subject: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
> >
> > https://bugzilla.tianocore.org/show_bug.cgi?id=2800
> >
> > Break out the IA32/X64 GCC inline functions that can
> not be used
> > in a unit test host application into their own source
> file. This
> > does not make any changes to the BaseLib library
> instance. This
> > is in preparation for a new BaseLib instances that is
> safe to use
> > with host-based unit test applications.
> >
> > Cc: Liming Gao <liming.gao@intel.com>
> > Cc: Sean Brogan <sean.brogan@microsoft.com>
> > Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> > Cc: Jiewen Yao <jiewen.yao@intel.com>
> > Signed-off-by: Michael D Kinney
> <michael.d.kinney@intel.com>
> > ---
> > MdePkg/Library/BaseLib/BaseLib.inf | 4
> +-
> > MdePkg/Library/BaseLib/Ia32/GccInline.c | 1181
> +---------------
> > .../Ia32/{GccInline.c => GccInlinePriv.c} | 601
> +-------
> > MdePkg/Library/BaseLib/X64/GccInline.c | 1240
> +----------------
> > .../X64/{GccInline.c => GccInlinePriv.c} | 572
> +-------
> > 5 files changed, 11 insertions(+), 3587 deletions(-)
> > copy MdePkg/Library/BaseLib/Ia32/{GccInline.c =>
> GccInlinePriv.c} (62%)
> > copy MdePkg/Library/BaseLib/X64/{GccInline.c =>
> GccInlinePriv.c} (65%)
> >
> > diff --git a/MdePkg/Library/BaseLib/BaseLib.inf
> b/MdePkg/Library/BaseLib/BaseLib.inf
> > index a57ae2da31..c740a819ca 100644
> > --- a/MdePkg/Library/BaseLib/BaseLib.inf
> > +++ b/MdePkg/Library/BaseLib/BaseLib.inf
> > @@ -1,7 +1,7 @@
> > ## @file
> > # Base Library implementation.
> > #
> > -# Copyright (c) 2007 - 2019, Intel Corporation. All
> rights reserved.<BR>
> > +# Copyright (c) 2007 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > # Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > # Portions copyright (c) 2011 - 2013, ARM Ltd. All
> rights reserved.<BR>
> > # Copyright (c) 2020, Hewlett Packard Enterprise
> Development LP. All rights reserved.<BR>
> > @@ -156,6 +156,7 @@ [Sources.Ia32]
> >
> >
> > Ia32/GccInline.c | GCC
> > + Ia32/GccInlinePriv.c | GCC
> > Ia32/Thunk16.nasm
> > Ia32/EnableDisableInterrupts.nasm| GCC
> > Ia32/EnablePaging64.nasm
> > @@ -310,6 +311,7 @@ [Sources.X64]
> > X86PatchInstruction.c
> > X86SpeculationBarrier.c
> > X64/GccInline.c | GCC
> > + X64/GccInlinePriv.c | GCC
> > X64/EnableDisableInterrupts.nasm
> > X64/DisablePaging64.nasm
> > X64/RdRand.nasm
> > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > index 5287200f87..6ed938187a 100644
> > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > @@ -1,7 +1,7 @@
> > /** @file
> > GCC inline implementation of BaseLib processor
> specific functions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,8 +10,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > /**
> > Used to serialize load and store operations.
> >
> > @@ -31,41 +29,6 @@ MemoryFence (
> > __asm__ __volatile__ ("":::"memory");
> > }
> >
> > -
> > -/**
> > - Enables CPU interrupts.
> > -
> > - Enables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -EnableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("sti"::: "memory");
> > -}
> > -
> > -
> > -/**
> > - Disables CPU interrupts.
> > -
> > - Disables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -DisableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("cli"::: "memory");
> > -}
> > -
> > -
> > -
> > -
> > /**
> > Requests CPU to pause for a short period of time.
> >
> > @@ -82,7 +45,6 @@ CpuPause (
> > __asm__ __volatile__ ("pause");
> > }
> >
> > -
> > /**
> > Generates a breakpoint on the CPU.
> >
> > @@ -99,75 +61,6 @@ CpuBreakpoint (
> > __asm__ __volatile__ ("int $3");
> > }
> >
> > -
> > -
> > -/**
> > - Returns a 64-bit Machine Specific Register(MSR).
> > -
> > - Reads and returns the 64-bit MSR specified by
> Index. No parameter checking is
> > - performed on Index, and some Index values may cause
> CPU exceptions. The
> > - caller must either guarantee that Index is valid,
> or the caller must set up
> > - exception handlers to catch the exceptions. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to read.
> > -
> > - @return The value of the MSR identified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMsr64 (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdmsr"
> > - : "=A" (Data) // %0
> > - : "c" (Index) // %1
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Writes a 64-bit value to a Machine Specific
> Register(MSR), and returns the
> > - value.
> > -
> > - Writes the 64-bit value specified by Value to the
> MSR specified by Index. The
> > - 64-bit value written to the MSR is returned. No
> parameter checking is
> > - performed on Index or Value, and some of these may
> cause CPU exceptions. The
> > - caller must either guarantee that Index and Value
> are valid, or the caller
> > - must establish proper exception handlers. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to write.
> > - @param Value The 64-bit value to write to the MSR.
> > -
> > - @return Value
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmWriteMsr64 (
> > - IN UINT32 Index,
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "wrmsr"
> > - :
> > - : "c" (Index),
> > - "A" (Value)
> > - );
> > -
> > - return Value;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the EFLAGS register.
> >
> > @@ -195,965 +88,6 @@ AsmReadEflags (
> > return Eflags;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 0
> (CR0).
> > -
> > - Reads and returns the current value of CR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 0 (CR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr0,%0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 2
> (CR2).
> > -
> > - Reads and returns the current value of CR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 2 (CR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Reads the current value of the Control Register 3
> (CR3).
> > -
> > - Reads and returns the current value of CR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 3 (CR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 4
> (CR4).
> > -
> > - Reads and returns the current value of CR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 4 (CR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr4, %0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 0 (CR0).
> > -
> > - Writes and returns a new value to CR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr0 The value to write to CR0.
> > -
> > - @return The value written to CR0.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr0 (
> > - UINTN Cr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr0"
> > - :
> > - : "r" (Cr0)
> > - );
> > - return Cr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 2 (CR2).
> > -
> > - Writes and returns a new value to CR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr2 The value to write to CR2.
> > -
> > - @return The value written to CR2.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr2 (
> > - UINTN Cr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr2"
> > - :
> > - : "r" (Cr2)
> > - );
> > - return Cr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 3 (CR3).
> > -
> > - Writes and returns a new value to CR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr3 The value to write to CR3.
> > -
> > - @return The value written to CR3.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr3 (
> > - UINTN Cr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr3"
> > - :
> > - : "r" (Cr3)
> > - );
> > - return Cr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 4 (CR4).
> > -
> > - Writes and returns a new value to CR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr4 The value to write to CR4.
> > -
> > - @return The value written to CR4.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr4 (
> > - UINTN Cr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr4"
> > - :
> > - : "r" (Cr4)
> > - );
> > - return Cr4;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 0 (DR0).
> > -
> > - Reads and returns the current value of DR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 0 (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr0, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 1 (DR1).
> > -
> > - Reads and returns the current value of DR1. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 1 (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr1 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr1, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 2 (DR2).
> > -
> > - Reads and returns the current value of DR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 2 (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 3 (DR3).
> > -
> > - Reads and returns the current value of DR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 3 (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 4 (DR4).
> > -
> > - Reads and returns the current value of DR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 4 (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr4, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 5 (DR5).
> > -
> > - Reads and returns the current value of DR5. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 5 (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr5 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr5, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 6 (DR6).
> > -
> > - Reads and returns the current value of DR6. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 6 (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr6 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr6, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 7 (DR7).
> > -
> > - Reads and returns the current value of DR7. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 7 (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr7 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr7, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 0 (DR0).
> > -
> > - Writes and returns a new value to DR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr0 The value to write to Dr0.
> > -
> > - @return The value written to Debug Register 0
> (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr0 (
> > - UINTN Dr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr0"
> > - :
> > - : "r" (Dr0)
> > - );
> > - return Dr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 1 (DR1).
> > -
> > - Writes and returns a new value to DR1. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr1 The value to write to Dr1.
> > -
> > - @return The value written to Debug Register 1
> (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr1 (
> > - UINTN Dr1
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr1"
> > - :
> > - : "r" (Dr1)
> > - );
> > - return Dr1;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 2 (DR2).
> > -
> > - Writes and returns a new value to DR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr2 The value to write to Dr2.
> > -
> > - @return The value written to Debug Register 2
> (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr2 (
> > - UINTN Dr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr2"
> > - :
> > - : "r" (Dr2)
> > - );
> > - return Dr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 3 (DR3).
> > -
> > - Writes and returns a new value to DR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr3 The value to write to Dr3.
> > -
> > - @return The value written to Debug Register 3
> (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr3 (
> > - UINTN Dr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr3"
> > - :
> > - : "r" (Dr3)
> > - );
> > - return Dr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 4 (DR4).
> > -
> > - Writes and returns a new value to DR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr4 The value to write to Dr4.
> > -
> > - @return The value written to Debug Register 4
> (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr4 (
> > - UINTN Dr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr4"
> > - :
> > - : "r" (Dr4)
> > - );
> > - return Dr4;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 5 (DR5).
> > -
> > - Writes and returns a new value to DR5. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr5 The value to write to Dr5.
> > -
> > - @return The value written to Debug Register 5
> (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr5 (
> > - UINTN Dr5
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr5"
> > - :
> > - : "r" (Dr5)
> > - );
> > - return Dr5;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 6 (DR6).
> > -
> > - Writes and returns a new value to DR6. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr6 The value to write to Dr6.
> > -
> > - @return The value written to Debug Register 6
> (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr6 (
> > - UINTN Dr6
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr6"
> > - :
> > - : "r" (Dr6)
> > - );
> > - return Dr6;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 7 (DR7).
> > -
> > - Writes and returns a new value to DR7. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr7 The value to write to Dr7.
> > -
> > - @return The value written to Debug Register 7
> (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr7 (
> > - UINTN Dr7
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr7"
> > - :
> > - : "r" (Dr7)
> > - );
> > - return Dr7;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Code Segment Register
> (CS).
> > -
> > - Reads and returns the current value of CS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of CS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadCs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Data Segment Register
> (DS).
> > -
> > - Reads and returns the current value of DS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of DS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadDs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Extra Segment Register
> (ES).
> > -
> > - Reads and returns the current value of ES. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of ES.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadEs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%es, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of FS Data Segment Register
> (FS).
> > -
> > - Reads and returns the current value of FS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of FS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadFs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%fs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of GS Data Segment Register
> (GS).
> > -
> > - Reads and returns the current value of GS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of GS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadGs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%gs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Stack Segment Register
> (SS).
> > -
> > - Reads and returns the current value of SS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of SS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadSs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Task Register (TR).
> > -
> > - Reads and returns the current value of TR. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of TR.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadTr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "str %0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current Global Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current GDTR descriptor and
> returns it in Gdtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadGdtr (
> > - OUT IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sgdt %0"
> > - : "=m" (*Gdtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Global Descriptor Table Register
> (GDTR) descriptor.
> > -
> > - Writes and the current GDTR descriptor specified by
> Gdtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteGdtr (
> > - IN CONST IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lgdt %0"
> > - :
> > - : "m" (*Gdtr)
> > - );
> > -
> > -}
> > -
> > -
> > -/**
> > - Reads the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current IDTR descriptor and
> returns it in Idtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadIdtr (
> > - OUT IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sidt %0"
> > - : "=m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Writes the current IDTR descriptor and returns it
> in Idtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteIdtr (
> > - IN CONST IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lidt %0"
> > - :
> > - : "m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current Local Descriptor Table
> Register(LDTR) selector.
> > -
> > - Reads and returns the current 16-bit LDTR
> descriptor value. This function is
> > - only available on IA-32 and X64.
> > -
> > - @return The current selector of LDT.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadLdtr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "sldt %0"
> > - : "=g" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current Local Descriptor Table Register
> (GDTR) selector.
> > -
> > - Writes and the current LDTR descriptor specified by
> Ldtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Ldtr 16-bit LDTR selector value.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteLdtr (
> > - IN UINT16 Ldtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lldtw %0"
> > - :
> > - : "g" (Ldtr) // %0
> > - );
> > -}
> > -
> > -
> > /**
> > Save the current floating point/SSE/SSE2 context to
> a buffer.
> >
> > @@ -1650,116 +584,3 @@ AsmReadTsc (
> >
> > return Data;
> > }
> > -
> > -
> > -/**
> > - Reads the current value of a Performance Counter
> (PMC).
> > -
> > - Reads and returns the current value of performance
> counter specified by
> > - Index. This function is only available on IA-32 and
> X64.
> > -
> > - @param Index The 32-bit Performance Counter index
> to read.
> > -
> > - @return The value of the PMC specified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadPmc (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdpmc"
> > - : "=A" (Data)
> > - : "c" (Index)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -
> > -
> > -/**
> > - Executes a WBINVD instruction.
> > -
> > - Executes a WBINVD instruction. This function is
> only available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWbinvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > -}
> > -
> > -
> > -/**
> > - Executes a INVD instruction.
> > -
> > - Executes a INVD instruction. This function is only
> available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmInvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("invd":::"memory");
> > -
> > -}
> > -
> > -
> > -/**
> > - Flushes a cache line from all the instruction and
> data caches within the
> > - coherency domain of the CPU.
> > -
> > - Flushed the cache line specified by LinearAddress,
> and returns LinearAddress.
> > - This function is only available on IA-32 and X64.
> > -
> > - @param LinearAddress The address of the cache line
> to flush. If the CPU is
> > - in a physical addressing
> mode, then LinearAddress is a
> > - physical address. If the CPU
> is in a virtual
> > - addressing mode, then
> LinearAddress is a virtual
> > - address.
> > -
> > - @return LinearAddress
> > -**/
> > -VOID *
> > -EFIAPI
> > -AsmFlushCacheLine (
> > - IN VOID *LinearAddress
> > - )
> > -{
> > - UINT32 RegEdx;
> > -
> > - //
> > - // If the CPU does not support CLFLUSH instruction,
> > - // then promote flush range to flush entire cache.
> > - //
> > - AsmCpuid (0x01, NULL, NULL, NULL, &RegEdx);
> > - if ((RegEdx & BIT19) == 0) {
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > - return LinearAddress;
> > - }
> > -
> > -
> > - __asm__ __volatile__ (
> > - "clflush (%0)"
> > - : "+a" (LinearAddress)
> > - :
> > - : "memory"
> > - );
> > -
> > - return LinearAddress;
> > -}
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > similarity index 62%
> > copy from MdePkg/Library/BaseLib/Ia32/GccInline.c
> > copy to MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > index 5287200f87..30aa63243b 100644
> > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > @@ -1,7 +1,8 @@
> > /** @file
> > - GCC inline implementation of BaseLib processor
> specific functions.
> > + GCC inline implementation of BaseLib processor
> specific functions that use
> > + privlidged instructions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,28 +11,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > -/**
> > - Used to serialize load and store operations.
> > -
> > - All loads and stores that proceed calls to this
> function are guaranteed to be
> > - globally visible when this function returns.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -MemoryFence (
> > - VOID
> > - )
> > -{
> > - // This is a little bit of overkill and it is more
> about the compiler that it is
> > - // actually processor synchronization. This is like
> the _ReadWriteBarrier
> > - // Microsoft specific intrinsic
> > - __asm__ __volatile__ ("":::"memory");
> > -}
> > -
> > -
> > /**
> > Enables CPU interrupts.
> >
> > @@ -63,44 +42,6 @@ DisableInterrupts (
> > __asm__ __volatile__ ("cli"::: "memory");
> > }
> >
> > -
> > -
> > -
> > -/**
> > - Requests CPU to pause for a short period of time.
> > -
> > - Requests CPU to pause for a short period of time.
> Typically used in MP
> > - systems to prevent memory starvation while waiting
> for a spin lock.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuPause (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("pause");
> > -}
> > -
> > -
> > -/**
> > - Generates a breakpoint on the CPU.
> > -
> > - Generates a breakpoint on the CPU. The breakpoint
> must be implemented such
> > - that code can resume normal execution after the
> breakpoint.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuBreakpoint (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("int $3");
> > -}
> > -
> > -
> > -
> > /**
> > Returns a 64-bit Machine Specific Register(MSR).
> >
> > @@ -166,37 +107,6 @@ AsmWriteMsr64 (
> > return Value;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the EFLAGS register.
> > -
> > - Reads and returns the current value of the EFLAGS
> register. This function is
> > - only available on IA-32 and X64. This returns a 32-
> bit value on IA-32 and a
> > - 64-bit value on X64.
> > -
> > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadEflags (
> > - VOID
> > - )
> > -{
> > - UINTN Eflags;
> > -
> > - __asm__ __volatile__ (
> > - "pushfl \n\t"
> > - "popl %0 "
> > - : "=r" (Eflags)
> > - );
> > -
> > - return Eflags;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the Control Register 0
> (CR0).
> >
> > @@ -1153,505 +1063,6 @@ AsmWriteLdtr (
> > );
> > }
> >
> > -
> > -/**
> > - Save the current floating point/SSE/SSE2 context to
> a buffer.
> > -
> > - Saves the current floating point/SSE/SSE2 state to
> the buffer specified by
> > - Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is only
> > - available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxSave (
> > - OUT IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxsave %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Restores the current floating point/SSE/SSE2
> context from a buffer.
> > -
> > - Restores the current floating point/SSE/SSE2 state
> from the buffer specified
> > - by Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxRestore (
> > - IN CONST IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxrstor %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Reads and returns the current value of MM0. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM0.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm0 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm0, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Reads and returns the current value of MM1. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM1.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm1 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm1, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Reads and returns the current value of MM2. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM2.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm2 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm2, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Reads and returns the current value of MM3. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM3.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm3 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm3, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Reads and returns the current value of MM4. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM4.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm4 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm4, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Reads and returns the current value of MM5. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM5.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm5 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm5, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Reads and returns the current value of MM6. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM6.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm6 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm6, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Reads and returns the current value of MM7. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM7.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm7 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm7, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Writes the current value of MM0. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM0.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm0 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm0" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Writes the current value of MM1. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM1.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm1 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm1" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Writes the current value of MM2. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM2.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm2 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm2" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Writes the current value of MM3. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM3.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm3 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm3" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Writes the current value of MM4. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM4.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm4 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm4" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Writes the current value of MM5. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM5.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm5 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm5" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Writes the current value of MM6. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM6.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm6 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm6" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Writes the current value of MM7. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM7.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm7 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm7" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Time Stamp Counter
> (TSC).
> > -
> > - Reads and returns the current value of TSC. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of TSC
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadTsc (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdtsc"
> > - : "=A" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > /**
> > Reads the current value of a Performance Counter
> (PMC).
> >
> > @@ -1680,9 +1091,6 @@ AsmReadPmc (
> > return Data;
> > }
> >
> > -
> > -
> > -
> > /**
> > Executes a WBINVD instruction.
> >
> > @@ -1699,7 +1107,6 @@ AsmWbinvd (
> > __asm__ __volatile__ ("wbinvd":::"memory");
> > }
> >
> > -
> > /**
> > Executes a INVD instruction.
> >
> > @@ -1761,5 +1168,3 @@ AsmFlushCacheLine (
> >
> > return LinearAddress;
> > }
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> b/MdePkg/Library/BaseLib/X64/GccInline.c
> > index 154ce1f57e..40a208f198 100644
> > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/X64/GccInline.c
> > @@ -1,7 +1,7 @@
> > /** @file
> > GCC inline implementation of BaseLib processor
> specific functions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -33,40 +33,6 @@ MemoryFence (
> > }
> >
> >
> > -/**
> > - Enables CPU interrupts.
> > -
> > - Enables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -EnableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("sti"::: "memory");
> > -}
> > -
> > -
> > -/**
> > - Disables CPU interrupts.
> > -
> > - Disables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -DisableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("cli"::: "memory");
> > -}
> > -
> > -
> > -
> > -
> > /**
> > Requests CPU to pause for a short period of time.
> >
> > @@ -101,83 +67,6 @@ CpuBreakpoint (
> > }
> >
> >
> > -
> > -/**
> > - Returns a 64-bit Machine Specific Register(MSR).
> > -
> > - Reads and returns the 64-bit MSR specified by
> Index. No parameter checking is
> > - performed on Index, and some Index values may cause
> CPU exceptions. The
> > - caller must either guarantee that Index is valid,
> or the caller must set up
> > - exception handlers to catch the exceptions. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to read.
> > -
> > - @return The value of the MSR identified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMsr64 (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HighData;
> > -
> > - __asm__ __volatile__ (
> > - "rdmsr"
> > - : "=a" (LowData), // %0
> > - "=d" (HighData) // %1
> > - : "c" (Index) // %2
> > - );
> > -
> > - return (((UINT64)HighData) << 32) | LowData;
> > -}
> > -
> > -/**
> > - Writes a 64-bit value to a Machine Specific
> Register(MSR), and returns the
> > - value.
> > -
> > - Writes the 64-bit value specified by Value to the
> MSR specified by Index. The
> > - 64-bit value written to the MSR is returned. No
> parameter checking is
> > - performed on Index or Value, and some of these may
> cause CPU exceptions. The
> > - caller must either guarantee that Index and Value
> are valid, or the caller
> > - must establish proper exception handlers. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to write.
> > - @param Value The 64-bit value to write to the MSR.
> > -
> > - @return Value
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmWriteMsr64 (
> > - IN UINT32 Index,
> > - IN UINT64 Value
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HighData;
> > -
> > - LowData = (UINT32)(Value);
> > - HighData = (UINT32)(Value >> 32);
> > -
> > - __asm__ __volatile__ (
> > - "wrmsr"
> > - :
> > - : "c" (Index),
> > - "a" (LowData),
> > - "d" (HighData)
> > - );
> > -
> > - return Value;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the EFLAGS register.
> >
> > @@ -205,965 +94,6 @@ AsmReadEflags (
> > return Eflags;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 0
> (CR0).
> > -
> > - Reads and returns the current value of CR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 0 (CR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr0,%0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 2
> (CR2).
> > -
> > - Reads and returns the current value of CR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 2 (CR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr2, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Reads the current value of the Control Register 3
> (CR3).
> > -
> > - Reads and returns the current value of CR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 3 (CR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr3, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 4
> (CR4).
> > -
> > - Reads and returns the current value of CR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 4 (CR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr4, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 0 (CR0).
> > -
> > - Writes and returns a new value to CR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr0 The value to write to CR0.
> > -
> > - @return The value written to CR0.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr0 (
> > - UINTN Cr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr0"
> > - :
> > - : "r" (Cr0)
> > - );
> > - return Cr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 2 (CR2).
> > -
> > - Writes and returns a new value to CR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr2 The value to write to CR2.
> > -
> > - @return The value written to CR2.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr2 (
> > - UINTN Cr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr2"
> > - :
> > - : "r" (Cr2)
> > - );
> > - return Cr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 3 (CR3).
> > -
> > - Writes and returns a new value to CR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr3 The value to write to CR3.
> > -
> > - @return The value written to CR3.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr3 (
> > - UINTN Cr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr3"
> > - :
> > - : "r" (Cr3)
> > - );
> > - return Cr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 4 (CR4).
> > -
> > - Writes and returns a new value to CR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr4 The value to write to CR4.
> > -
> > - @return The value written to CR4.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr4 (
> > - UINTN Cr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr4"
> > - :
> > - : "r" (Cr4)
> > - );
> > - return Cr4;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 0 (DR0).
> > -
> > - Reads and returns the current value of DR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 0 (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr0, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 1 (DR1).
> > -
> > - Reads and returns the current value of DR1. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 1 (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr1 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr1, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 2 (DR2).
> > -
> > - Reads and returns the current value of DR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 2 (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 3 (DR3).
> > -
> > - Reads and returns the current value of DR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 3 (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 4 (DR4).
> > -
> > - Reads and returns the current value of DR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 4 (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr4, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 5 (DR5).
> > -
> > - Reads and returns the current value of DR5. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 5 (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr5 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr5, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 6 (DR6).
> > -
> > - Reads and returns the current value of DR6. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 6 (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr6 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr6, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 7 (DR7).
> > -
> > - Reads and returns the current value of DR7. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 7 (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr7 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr7, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 0 (DR0).
> > -
> > - Writes and returns a new value to DR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr0 The value to write to Dr0.
> > -
> > - @return The value written to Debug Register 0
> (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr0 (
> > - UINTN Dr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr0"
> > - :
> > - : "r" (Dr0)
> > - );
> > - return Dr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 1 (DR1).
> > -
> > - Writes and returns a new value to DR1. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr1 The value to write to Dr1.
> > -
> > - @return The value written to Debug Register 1
> (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr1 (
> > - UINTN Dr1
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr1"
> > - :
> > - : "r" (Dr1)
> > - );
> > - return Dr1;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 2 (DR2).
> > -
> > - Writes and returns a new value to DR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr2 The value to write to Dr2.
> > -
> > - @return The value written to Debug Register 2
> (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr2 (
> > - UINTN Dr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr2"
> > - :
> > - : "r" (Dr2)
> > - );
> > - return Dr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 3 (DR3).
> > -
> > - Writes and returns a new value to DR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr3 The value to write to Dr3.
> > -
> > - @return The value written to Debug Register 3
> (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr3 (
> > - UINTN Dr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr3"
> > - :
> > - : "r" (Dr3)
> > - );
> > - return Dr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 4 (DR4).
> > -
> > - Writes and returns a new value to DR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr4 The value to write to Dr4.
> > -
> > - @return The value written to Debug Register 4
> (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr4 (
> > - UINTN Dr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr4"
> > - :
> > - : "r" (Dr4)
> > - );
> > - return Dr4;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 5 (DR5).
> > -
> > - Writes and returns a new value to DR5. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr5 The value to write to Dr5.
> > -
> > - @return The value written to Debug Register 5
> (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr5 (
> > - UINTN Dr5
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr5"
> > - :
> > - : "r" (Dr5)
> > - );
> > - return Dr5;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 6 (DR6).
> > -
> > - Writes and returns a new value to DR6. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr6 The value to write to Dr6.
> > -
> > - @return The value written to Debug Register 6
> (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr6 (
> > - UINTN Dr6
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr6"
> > - :
> > - : "r" (Dr6)
> > - );
> > - return Dr6;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 7 (DR7).
> > -
> > - Writes and returns a new value to DR7. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr7 The value to write to Dr7.
> > -
> > - @return The value written to Debug Register 7
> (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr7 (
> > - UINTN Dr7
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr7"
> > - :
> > - : "r" (Dr7)
> > - );
> > - return Dr7;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Code Segment Register
> (CS).
> > -
> > - Reads and returns the current value of CS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of CS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadCs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Data Segment Register
> (DS).
> > -
> > - Reads and returns the current value of DS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of DS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadDs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Extra Segment Register
> (ES).
> > -
> > - Reads and returns the current value of ES. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of ES.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadEs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%es, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of FS Data Segment Register
> (FS).
> > -
> > - Reads and returns the current value of FS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of FS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadFs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%fs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of GS Data Segment Register
> (GS).
> > -
> > - Reads and returns the current value of GS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of GS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadGs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%gs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Stack Segment Register
> (SS).
> > -
> > - Reads and returns the current value of SS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of SS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadSs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Task Register (TR).
> > -
> > - Reads and returns the current value of TR. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of TR.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadTr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "str %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current Global Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current GDTR descriptor and
> returns it in Gdtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadGdtr (
> > - OUT IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sgdt %0"
> > - : "=m" (*Gdtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Global Descriptor Table Register
> (GDTR) descriptor.
> > -
> > - Writes and the current GDTR descriptor specified by
> Gdtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteGdtr (
> > - IN CONST IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lgdt %0"
> > - :
> > - : "m" (*Gdtr)
> > - );
> > -
> > -}
> > -
> > -
> > -/**
> > - Reads the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current IDTR descriptor and
> returns it in Idtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadIdtr (
> > - OUT IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sidt %0"
> > - : "=m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Writes the current IDTR descriptor and returns it
> in Idtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteIdtr (
> > - IN CONST IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lidt %0"
> > - :
> > - : "m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current Local Descriptor Table
> Register(LDTR) selector.
> > -
> > - Reads and returns the current 16-bit LDTR
> descriptor value. This function is
> > - only available on IA-32 and X64.
> > -
> > - @return The current selector of LDT.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadLdtr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "sldt %0"
> > - : "=g" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current Local Descriptor Table Register
> (GDTR) selector.
> > -
> > - Writes and the current LDTR descriptor specified by
> Ldtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Ldtr 16-bit LDTR selector value.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteLdtr (
> > - IN UINT16 Ldtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lldtw %0"
> > - :
> > - : "g" (Ldtr) // %0
> > - );
> > -}
> > -
> > -
> > /**
> > Save the current floating point/SSE/SSE2 context to
> a buffer.
> >
> > @@ -1630,171 +560,3 @@ AsmReadTsc (
> >
> > return (((UINT64)HiData) << 32) | LowData;
> > }
> > -
> > -
> > -/**
> > - Reads the current value of a Performance Counter
> (PMC).
> > -
> > - Reads and returns the current value of performance
> counter specified by
> > - Index. This function is only available on IA-32 and
> X64.
> > -
> > - @param Index The 32-bit Performance Counter index
> to read.
> > -
> > - @return The value of the PMC specified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadPmc (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HiData;
> > -
> > - __asm__ __volatile__ (
> > - "rdpmc"
> > - : "=a" (LowData),
> > - "=d" (HiData)
> > - : "c" (Index)
> > - );
> > -
> > - return (((UINT64)HiData) << 32) | LowData;
> > -}
> > -
> > -
> > -/**
> > - Sets up a monitor buffer that is used by
> AsmMwait().
> > -
> > - Executes a MONITOR instruction with the register
> state specified by Eax, Ecx
> > - and Edx. Returns Eax. This function is only
> available on IA-32 and X64.
> > -
> > - @param Eax The value to load into EAX or RAX
> before executing the MONITOR
> > - instruction.
> > - @param Ecx The value to load into ECX or RCX
> before executing the MONITOR
> > - instruction.
> > - @param Edx The value to load into EDX or RDX
> before executing the MONITOR
> > - instruction.
> > -
> > - @return Eax
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmMonitor (
> > - IN UINTN Eax,
> > - IN UINTN Ecx,
> > - IN UINTN Edx
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "monitor"
> > - :
> > - : "a" (Eax),
> > - "c" (Ecx),
> > - "d" (Edx)
> > - );
> > -
> > - return Eax;
> > -}
> > -
> > -
> > -/**
> > - Executes an MWAIT instruction.
> > -
> > - Executes an MWAIT instruction with the register
> state specified by Eax and
> > - Ecx. Returns Eax. This function is only available
> on IA-32 and X64.
> > -
> > - @param Eax The value to load into EAX or RAX
> before executing the MONITOR
> > - instruction.
> > - @param Ecx The value to load into ECX or RCX
> before executing the MONITOR
> > - instruction.
> > -
> > - @return Eax
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmMwait (
> > - IN UINTN Eax,
> > - IN UINTN Ecx
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mwait"
> > - :
> > - : "a" (Eax),
> > - "c" (Ecx)
> > - );
> > -
> > - return Eax;
> > -}
> > -
> > -
> > -/**
> > - Executes a WBINVD instruction.
> > -
> > - Executes a WBINVD instruction. This function is
> only available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWbinvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > -}
> > -
> > -
> > -/**
> > - Executes a INVD instruction.
> > -
> > - Executes a INVD instruction. This function is only
> available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmInvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("invd":::"memory");
> > -
> > -}
> > -
> > -
> > -/**
> > - Flushes a cache line from all the instruction and
> data caches within the
> > - coherency domain of the CPU.
> > -
> > - Flushed the cache line specified by LinearAddress,
> and returns LinearAddress.
> > - This function is only available on IA-32 and X64.
> > -
> > - @param LinearAddress The address of the cache line
> to flush. If the CPU is
> > - in a physical addressing
> mode, then LinearAddress is a
> > - physical address. If the CPU
> is in a virtual
> > - addressing mode, then
> LinearAddress is a virtual
> > - address.
> > -
> > - @return LinearAddress
> > -**/
> > -VOID *
> > -EFIAPI
> > -AsmFlushCacheLine (
> > - IN VOID *LinearAddress
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "clflush (%0)"
> > - :
> > - : "r" (LinearAddress)
> > - : "memory"
> > - );
> > -
> > - return LinearAddress;
> > -}
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > similarity index 65%
> > copy from MdePkg/Library/BaseLib/X64/GccInline.c
> > copy to MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > index 154ce1f57e..98be19b3c7 100644
> > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > @@ -1,7 +1,8 @@
> > /** @file
> > - GCC inline implementation of BaseLib processor
> specific functions.
> > + GCC inline implementation of BaseLib processor
> specific functions that use
> > + privlidged instructions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,29 +11,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > -
> > -/**
> > - Used to serialize load and store operations.
> > -
> > - All loads and stores that proceed calls to this
> function are guaranteed to be
> > - globally visible when this function returns.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -MemoryFence (
> > - VOID
> > - )
> > -{
> > - // This is a little bit of overkill and it is more
> about the compiler that it is
> > - // actually processor synchronization. This is like
> the _ReadWriteBarrier
> > - // Microsoft specific intrinsic
> > - __asm__ __volatile__ ("":::"memory");
> > -}
> > -
> > -
> > /**
> > Enables CPU interrupts.
> >
> > @@ -64,44 +42,6 @@ DisableInterrupts (
> > __asm__ __volatile__ ("cli"::: "memory");
> > }
> >
> > -
> > -
> > -
> > -/**
> > - Requests CPU to pause for a short period of time.
> > -
> > - Requests CPU to pause for a short period of time.
> Typically used in MP
> > - systems to prevent memory starvation while waiting
> for a spin lock.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuPause (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("pause");
> > -}
> > -
> > -
> > -/**
> > - Generates a breakpoint on the CPU.
> > -
> > - Generates a breakpoint on the CPU. The breakpoint
> must be implemented such
> > - that code can resume normal execution after the
> breakpoint.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuBreakpoint (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("int $3");
> > -}
> > -
> > -
> > -
> > /**
> > Returns a 64-bit Machine Specific Register(MSR).
> >
> > @@ -176,37 +116,6 @@ AsmWriteMsr64 (
> > return Value;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the EFLAGS register.
> > -
> > - Reads and returns the current value of the EFLAGS
> register. This function is
> > - only available on IA-32 and X64. This returns a 32-
> bit value on IA-32 and a
> > - 64-bit value on X64.
> > -
> > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadEflags (
> > - VOID
> > - )
> > -{
> > - UINTN Eflags;
> > -
> > - __asm__ __volatile__ (
> > - "pushfq \n\t"
> > - "pop %0 "
> > - : "=r" (Eflags) // %0
> > - );
> > -
> > - return Eflags;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the Control Register 0
> (CR0).
> >
> > @@ -1163,475 +1072,6 @@ AsmWriteLdtr (
> > );
> > }
> >
> > -
> > -/**
> > - Save the current floating point/SSE/SSE2 context to
> a buffer.
> > -
> > - Saves the current floating point/SSE/SSE2 state to
> the buffer specified by
> > - Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is only
> > - available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxSave (
> > - OUT IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxsave %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Restores the current floating point/SSE/SSE2
> context from a buffer.
> > -
> > - Restores the current floating point/SSE/SSE2 state
> from the buffer specified
> > - by Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxRestore (
> > - IN CONST IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxrstor %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Reads and returns the current value of MM0. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM0.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm0 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm0, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Reads and returns the current value of MM1. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM1.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm1 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm1, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Reads and returns the current value of MM2. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM2.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm2 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm2, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Reads and returns the current value of MM3. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM3.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm3 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm3, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Reads and returns the current value of MM4. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM4.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm4 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm4, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Reads and returns the current value of MM5. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM5.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm5 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm5, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Reads and returns the current value of MM6. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM6.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm6 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm6, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Reads and returns the current value of MM7. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM7.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm7 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm7, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Writes the current value of MM0. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM0.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm0 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm0" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Writes the current value of MM1. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM1.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm1 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm1" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Writes the current value of MM2. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM2.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm2 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm2" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Writes the current value of MM3. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM3.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm3 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm3" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Writes the current value of MM4. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM4.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm4 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm4" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Writes the current value of MM5. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM5.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm5 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm5" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Writes the current value of MM6. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM6.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm6 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm6" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Writes the current value of MM7. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM7.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm7 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm7" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Time Stamp Counter
> (TSC).
> > -
> > - Reads and returns the current value of TSC. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of TSC
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadTsc (
> > - VOID
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HiData;
> > -
> > - __asm__ __volatile__ (
> > - "rdtsc"
> > - : "=a" (LowData),
> > - "=d" (HiData)
> > - );
> > -
> > - return (((UINT64)HiData) << 32) | LowData;
> > -}
> > -
> > -
> > /**
> > Reads the current value of a Performance Counter
> (PMC).
> >
> > @@ -1662,7 +1102,6 @@ AsmReadPmc (
> > return (((UINT64)HiData) << 32) | LowData;
> > }
> >
> > -
> > /**
> > Sets up a monitor buffer that is used by
> AsmMwait().
> >
> > @@ -1698,7 +1137,6 @@ AsmMonitor (
> > return Eax;
> > }
> >
> > -
> > /**
> > Executes an MWAIT instruction.
> >
> > @@ -1730,7 +1168,6 @@ AsmMwait (
> > return Eax;
> > }
> >
> > -
> > /**
> > Executes a WBINVD instruction.
> >
> > @@ -1747,7 +1184,6 @@ AsmWbinvd (
> > __asm__ __volatile__ ("wbinvd":::"memory");
> > }
> >
> > -
> > /**
> > Executes a INVD instruction.
> >
> > @@ -1796,5 +1232,3 @@ AsmFlushCacheLine (
> >
> > return LinearAddress;
> > }
> > -
> > -
> > --
> > 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread* Re: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
2020-07-09 17:00 ` Michael D Kinney
@ 2020-07-10 8:06 ` Liming Gao
2020-07-10 16:24 ` Michael D Kinney
0 siblings, 1 reply; 23+ messages in thread
From: Liming Gao @ 2020-07-10 8:06 UTC (permalink / raw)
To: Kinney, Michael D, devel@edk2.groups.io
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Mike:
So, GccInline.c file can't be used in the unit test BaseLib.
Thanks
Liming
-----Original Message-----
From: Kinney, Michael D <michael.d.kinney@intel.com>
Sent: 2020年7月10日 1:01
To: Gao, Liming <liming.gao@intel.com>; devel@edk2.groups.io; Kinney, Michael D <michael.d.kinney@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen <jiewen.yao@intel.com>
Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
Liming,
In order to support host based unit tests, all the code
has to be compatible with a user mode process. This means
any functions that execute instructions that are not allowed
in a user mode process need to be separated out.
For the IA32/X64 specific GccInline.c files, the analysis
was done for APIs that use instructions that would
generate an exception in a user mode process.
In addition, the BaseLib functions that return system
state (e.g. CS/DS/ES/SS/FS/GS) are also split out. It
does not make sense to return system state information
from the currently executing user mode process. Instead,
the FW code under test would expect system state that
matches a FW execution environment. Each unit test
implementation has the option of providing emulation
of this system state if that is required to exercise the
code under test.
No changes to the MSFT specific BaseLib implementation
were required because there those are already split out
to one function per file.
Best regards,
Mike
> -----Original Message-----
> From: Gao, Liming <liming.gao@intel.com>
> Sent: Thursday, July 9, 2020 7:07 AM
> To: Kinney, Michael D <michael.d.kinney@intel.com>;
> devel@edk2.groups.io
> Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret
> Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> <jiewen.yao@intel.com>
> Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
>
> Mike:
> Is there the rule to know which function can't be in
> unit test? And, those functions will be in GccInline.c
> or GccInlinePriv.c? There is no change in MSFT C source
> file, because MSFT C source file has been separated as
> the function level. Right?
>
> Thanks
> Liming
> > -----Original Message-----
> > From: Kinney, Michael D <michael.d.kinney@intel.com>
> > Sent: Monday, June 15, 2020 8:19 AM
> > To: devel@edk2.groups.io
> > Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan
> <sean.brogan@microsoft.com>; Bret Barkelew
> <Bret.Barkelew@microsoft.com>;
> > Yao, Jiewen <jiewen.yao@intel.com>
> > Subject: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
> >
> > https://bugzilla.tianocore.org/show_bug.cgi?id=2800
> >
> > Break out the IA32/X64 GCC inline functions that can
> not be used
> > in a unit test host application into their own source
> file. This
> > does not make any changes to the BaseLib library
> instance. This
> > is in preparation for a new BaseLib instances that is
> safe to use
> > with host-based unit test applications.
> >
> > Cc: Liming Gao <liming.gao@intel.com>
> > Cc: Sean Brogan <sean.brogan@microsoft.com>
> > Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> > Cc: Jiewen Yao <jiewen.yao@intel.com>
> > Signed-off-by: Michael D Kinney
> <michael.d.kinney@intel.com>
> > ---
> > MdePkg/Library/BaseLib/BaseLib.inf | 4
> +-
> > MdePkg/Library/BaseLib/Ia32/GccInline.c | 1181
> +---------------
> > .../Ia32/{GccInline.c => GccInlinePriv.c} | 601
> +-------
> > MdePkg/Library/BaseLib/X64/GccInline.c | 1240
> +----------------
> > .../X64/{GccInline.c => GccInlinePriv.c} | 572
> +-------
> > 5 files changed, 11 insertions(+), 3587 deletions(-)
> > copy MdePkg/Library/BaseLib/Ia32/{GccInline.c =>
> GccInlinePriv.c} (62%)
> > copy MdePkg/Library/BaseLib/X64/{GccInline.c =>
> GccInlinePriv.c} (65%)
> >
> > diff --git a/MdePkg/Library/BaseLib/BaseLib.inf
> b/MdePkg/Library/BaseLib/BaseLib.inf
> > index a57ae2da31..c740a819ca 100644
> > --- a/MdePkg/Library/BaseLib/BaseLib.inf
> > +++ b/MdePkg/Library/BaseLib/BaseLib.inf
> > @@ -1,7 +1,7 @@
> > ## @file
> > # Base Library implementation.
> > #
> > -# Copyright (c) 2007 - 2019, Intel Corporation. All
> rights reserved.<BR>
> > +# Copyright (c) 2007 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > # Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > # Portions copyright (c) 2011 - 2013, ARM Ltd. All
> rights reserved.<BR>
> > # Copyright (c) 2020, Hewlett Packard Enterprise
> Development LP. All rights reserved.<BR>
> > @@ -156,6 +156,7 @@ [Sources.Ia32]
> >
> >
> > Ia32/GccInline.c | GCC
> > + Ia32/GccInlinePriv.c | GCC
> > Ia32/Thunk16.nasm
> > Ia32/EnableDisableInterrupts.nasm| GCC
> > Ia32/EnablePaging64.nasm
> > @@ -310,6 +311,7 @@ [Sources.X64]
> > X86PatchInstruction.c
> > X86SpeculationBarrier.c
> > X64/GccInline.c | GCC
> > + X64/GccInlinePriv.c | GCC
> > X64/EnableDisableInterrupts.nasm
> > X64/DisablePaging64.nasm
> > X64/RdRand.nasm
> > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > index 5287200f87..6ed938187a 100644
> > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > @@ -1,7 +1,7 @@
> > /** @file
> > GCC inline implementation of BaseLib processor
> specific functions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,8 +10,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > /**
> > Used to serialize load and store operations.
> >
> > @@ -31,41 +29,6 @@ MemoryFence (
> > __asm__ __volatile__ ("":::"memory");
> > }
> >
> > -
> > -/**
> > - Enables CPU interrupts.
> > -
> > - Enables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -EnableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("sti"::: "memory");
> > -}
> > -
> > -
> > -/**
> > - Disables CPU interrupts.
> > -
> > - Disables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -DisableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("cli"::: "memory");
> > -}
> > -
> > -
> > -
> > -
> > /**
> > Requests CPU to pause for a short period of time.
> >
> > @@ -82,7 +45,6 @@ CpuPause (
> > __asm__ __volatile__ ("pause");
> > }
> >
> > -
> > /**
> > Generates a breakpoint on the CPU.
> >
> > @@ -99,75 +61,6 @@ CpuBreakpoint (
> > __asm__ __volatile__ ("int $3");
> > }
> >
> > -
> > -
> > -/**
> > - Returns a 64-bit Machine Specific Register(MSR).
> > -
> > - Reads and returns the 64-bit MSR specified by
> Index. No parameter checking is
> > - performed on Index, and some Index values may cause
> CPU exceptions. The
> > - caller must either guarantee that Index is valid,
> or the caller must set up
> > - exception handlers to catch the exceptions. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to read.
> > -
> > - @return The value of the MSR identified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMsr64 (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdmsr"
> > - : "=A" (Data) // %0
> > - : "c" (Index) // %1
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Writes a 64-bit value to a Machine Specific
> Register(MSR), and returns the
> > - value.
> > -
> > - Writes the 64-bit value specified by Value to the
> MSR specified by Index. The
> > - 64-bit value written to the MSR is returned. No
> parameter checking is
> > - performed on Index or Value, and some of these may
> cause CPU exceptions. The
> > - caller must either guarantee that Index and Value
> are valid, or the caller
> > - must establish proper exception handlers. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to write.
> > - @param Value The 64-bit value to write to the MSR.
> > -
> > - @return Value
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmWriteMsr64 (
> > - IN UINT32 Index,
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "wrmsr"
> > - :
> > - : "c" (Index),
> > - "A" (Value)
> > - );
> > -
> > - return Value;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the EFLAGS register.
> >
> > @@ -195,965 +88,6 @@ AsmReadEflags (
> > return Eflags;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 0
> (CR0).
> > -
> > - Reads and returns the current value of CR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 0 (CR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr0,%0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 2
> (CR2).
> > -
> > - Reads and returns the current value of CR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 2 (CR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Reads the current value of the Control Register 3
> (CR3).
> > -
> > - Reads and returns the current value of CR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 3 (CR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 4
> (CR4).
> > -
> > - Reads and returns the current value of CR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 4 (CR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%cr4, %0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 0 (CR0).
> > -
> > - Writes and returns a new value to CR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr0 The value to write to CR0.
> > -
> > - @return The value written to CR0.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr0 (
> > - UINTN Cr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr0"
> > - :
> > - : "r" (Cr0)
> > - );
> > - return Cr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 2 (CR2).
> > -
> > - Writes and returns a new value to CR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr2 The value to write to CR2.
> > -
> > - @return The value written to CR2.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr2 (
> > - UINTN Cr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr2"
> > - :
> > - : "r" (Cr2)
> > - );
> > - return Cr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 3 (CR3).
> > -
> > - Writes and returns a new value to CR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr3 The value to write to CR3.
> > -
> > - @return The value written to CR3.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr3 (
> > - UINTN Cr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr3"
> > - :
> > - : "r" (Cr3)
> > - );
> > - return Cr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 4 (CR4).
> > -
> > - Writes and returns a new value to CR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr4 The value to write to CR4.
> > -
> > - @return The value written to CR4.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr4 (
> > - UINTN Cr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%cr4"
> > - :
> > - : "r" (Cr4)
> > - );
> > - return Cr4;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 0 (DR0).
> > -
> > - Reads and returns the current value of DR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 0 (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr0, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 1 (DR1).
> > -
> > - Reads and returns the current value of DR1. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 1 (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr1 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr1, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 2 (DR2).
> > -
> > - Reads and returns the current value of DR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 2 (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 3 (DR3).
> > -
> > - Reads and returns the current value of DR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 3 (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 4 (DR4).
> > -
> > - Reads and returns the current value of DR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 4 (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr4, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 5 (DR5).
> > -
> > - Reads and returns the current value of DR5. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 5 (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr5 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr5, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 6 (DR6).
> > -
> > - Reads and returns the current value of DR6. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 6 (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr6 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr6, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 7 (DR7).
> > -
> > - Reads and returns the current value of DR7. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 7 (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr7 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "movl %%dr7, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 0 (DR0).
> > -
> > - Writes and returns a new value to DR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr0 The value to write to Dr0.
> > -
> > - @return The value written to Debug Register 0
> (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr0 (
> > - UINTN Dr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr0"
> > - :
> > - : "r" (Dr0)
> > - );
> > - return Dr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 1 (DR1).
> > -
> > - Writes and returns a new value to DR1. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr1 The value to write to Dr1.
> > -
> > - @return The value written to Debug Register 1
> (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr1 (
> > - UINTN Dr1
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr1"
> > - :
> > - : "r" (Dr1)
> > - );
> > - return Dr1;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 2 (DR2).
> > -
> > - Writes and returns a new value to DR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr2 The value to write to Dr2.
> > -
> > - @return The value written to Debug Register 2
> (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr2 (
> > - UINTN Dr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr2"
> > - :
> > - : "r" (Dr2)
> > - );
> > - return Dr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 3 (DR3).
> > -
> > - Writes and returns a new value to DR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr3 The value to write to Dr3.
> > -
> > - @return The value written to Debug Register 3
> (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr3 (
> > - UINTN Dr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr3"
> > - :
> > - : "r" (Dr3)
> > - );
> > - return Dr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 4 (DR4).
> > -
> > - Writes and returns a new value to DR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr4 The value to write to Dr4.
> > -
> > - @return The value written to Debug Register 4
> (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr4 (
> > - UINTN Dr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr4"
> > - :
> > - : "r" (Dr4)
> > - );
> > - return Dr4;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 5 (DR5).
> > -
> > - Writes and returns a new value to DR5. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr5 The value to write to Dr5.
> > -
> > - @return The value written to Debug Register 5
> (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr5 (
> > - UINTN Dr5
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr5"
> > - :
> > - : "r" (Dr5)
> > - );
> > - return Dr5;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 6 (DR6).
> > -
> > - Writes and returns a new value to DR6. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr6 The value to write to Dr6.
> > -
> > - @return The value written to Debug Register 6
> (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr6 (
> > - UINTN Dr6
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr6"
> > - :
> > - : "r" (Dr6)
> > - );
> > - return Dr6;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 7 (DR7).
> > -
> > - Writes and returns a new value to DR7. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr7 The value to write to Dr7.
> > -
> > - @return The value written to Debug Register 7
> (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr7 (
> > - UINTN Dr7
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movl %0, %%dr7"
> > - :
> > - : "r" (Dr7)
> > - );
> > - return Dr7;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Code Segment Register
> (CS).
> > -
> > - Reads and returns the current value of CS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of CS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadCs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Data Segment Register
> (DS).
> > -
> > - Reads and returns the current value of DS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of DS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadDs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Extra Segment Register
> (ES).
> > -
> > - Reads and returns the current value of ES. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of ES.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadEs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%es, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of FS Data Segment Register
> (FS).
> > -
> > - Reads and returns the current value of FS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of FS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadFs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%fs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of GS Data Segment Register
> (GS).
> > -
> > - Reads and returns the current value of GS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of GS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadGs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%gs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Stack Segment Register
> (SS).
> > -
> > - Reads and returns the current value of SS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of SS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadSs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Task Register (TR).
> > -
> > - Reads and returns the current value of TR. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of TR.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadTr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "str %0"
> > - : "=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current Global Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current GDTR descriptor and
> returns it in Gdtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadGdtr (
> > - OUT IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sgdt %0"
> > - : "=m" (*Gdtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Global Descriptor Table Register
> (GDTR) descriptor.
> > -
> > - Writes and the current GDTR descriptor specified by
> Gdtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteGdtr (
> > - IN CONST IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lgdt %0"
> > - :
> > - : "m" (*Gdtr)
> > - );
> > -
> > -}
> > -
> > -
> > -/**
> > - Reads the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current IDTR descriptor and
> returns it in Idtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadIdtr (
> > - OUT IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sidt %0"
> > - : "=m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Writes the current IDTR descriptor and returns it
> in Idtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteIdtr (
> > - IN CONST IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lidt %0"
> > - :
> > - : "m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current Local Descriptor Table
> Register(LDTR) selector.
> > -
> > - Reads and returns the current 16-bit LDTR
> descriptor value. This function is
> > - only available on IA-32 and X64.
> > -
> > - @return The current selector of LDT.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadLdtr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "sldt %0"
> > - : "=g" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current Local Descriptor Table Register
> (GDTR) selector.
> > -
> > - Writes and the current LDTR descriptor specified by
> Ldtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Ldtr 16-bit LDTR selector value.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteLdtr (
> > - IN UINT16 Ldtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lldtw %0"
> > - :
> > - : "g" (Ldtr) // %0
> > - );
> > -}
> > -
> > -
> > /**
> > Save the current floating point/SSE/SSE2 context to
> a buffer.
> >
> > @@ -1650,116 +584,3 @@ AsmReadTsc (
> >
> > return Data;
> > }
> > -
> > -
> > -/**
> > - Reads the current value of a Performance Counter
> (PMC).
> > -
> > - Reads and returns the current value of performance
> counter specified by
> > - Index. This function is only available on IA-32 and
> X64.
> > -
> > - @param Index The 32-bit Performance Counter index
> to read.
> > -
> > - @return The value of the PMC specified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadPmc (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdpmc"
> > - : "=A" (Data)
> > - : "c" (Index)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -
> > -
> > -/**
> > - Executes a WBINVD instruction.
> > -
> > - Executes a WBINVD instruction. This function is
> only available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWbinvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > -}
> > -
> > -
> > -/**
> > - Executes a INVD instruction.
> > -
> > - Executes a INVD instruction. This function is only
> available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmInvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("invd":::"memory");
> > -
> > -}
> > -
> > -
> > -/**
> > - Flushes a cache line from all the instruction and
> data caches within the
> > - coherency domain of the CPU.
> > -
> > - Flushed the cache line specified by LinearAddress,
> and returns LinearAddress.
> > - This function is only available on IA-32 and X64.
> > -
> > - @param LinearAddress The address of the cache line
> to flush. If the CPU is
> > - in a physical addressing
> mode, then LinearAddress is a
> > - physical address. If the CPU
> is in a virtual
> > - addressing mode, then
> LinearAddress is a virtual
> > - address.
> > -
> > - @return LinearAddress
> > -**/
> > -VOID *
> > -EFIAPI
> > -AsmFlushCacheLine (
> > - IN VOID *LinearAddress
> > - )
> > -{
> > - UINT32 RegEdx;
> > -
> > - //
> > - // If the CPU does not support CLFLUSH instruction,
> > - // then promote flush range to flush entire cache.
> > - //
> > - AsmCpuid (0x01, NULL, NULL, NULL, &RegEdx);
> > - if ((RegEdx & BIT19) == 0) {
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > - return LinearAddress;
> > - }
> > -
> > -
> > - __asm__ __volatile__ (
> > - "clflush (%0)"
> > - : "+a" (LinearAddress)
> > - :
> > - : "memory"
> > - );
> > -
> > - return LinearAddress;
> > -}
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > similarity index 62%
> > copy from MdePkg/Library/BaseLib/Ia32/GccInline.c
> > copy to MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > index 5287200f87..30aa63243b 100644
> > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > @@ -1,7 +1,8 @@
> > /** @file
> > - GCC inline implementation of BaseLib processor
> specific functions.
> > + GCC inline implementation of BaseLib processor
> specific functions that use
> > + privlidged instructions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,28 +11,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > -/**
> > - Used to serialize load and store operations.
> > -
> > - All loads and stores that proceed calls to this
> function are guaranteed to be
> > - globally visible when this function returns.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -MemoryFence (
> > - VOID
> > - )
> > -{
> > - // This is a little bit of overkill and it is more
> about the compiler that it is
> > - // actually processor synchronization. This is like
> the _ReadWriteBarrier
> > - // Microsoft specific intrinsic
> > - __asm__ __volatile__ ("":::"memory");
> > -}
> > -
> > -
> > /**
> > Enables CPU interrupts.
> >
> > @@ -63,44 +42,6 @@ DisableInterrupts (
> > __asm__ __volatile__ ("cli"::: "memory");
> > }
> >
> > -
> > -
> > -
> > -/**
> > - Requests CPU to pause for a short period of time.
> > -
> > - Requests CPU to pause for a short period of time.
> Typically used in MP
> > - systems to prevent memory starvation while waiting
> for a spin lock.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuPause (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("pause");
> > -}
> > -
> > -
> > -/**
> > - Generates a breakpoint on the CPU.
> > -
> > - Generates a breakpoint on the CPU. The breakpoint
> must be implemented such
> > - that code can resume normal execution after the
> breakpoint.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuBreakpoint (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("int $3");
> > -}
> > -
> > -
> > -
> > /**
> > Returns a 64-bit Machine Specific Register(MSR).
> >
> > @@ -166,37 +107,6 @@ AsmWriteMsr64 (
> > return Value;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the EFLAGS register.
> > -
> > - Reads and returns the current value of the EFLAGS
> register. This function is
> > - only available on IA-32 and X64. This returns a 32-
> bit value on IA-32 and a
> > - 64-bit value on X64.
> > -
> > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadEflags (
> > - VOID
> > - )
> > -{
> > - UINTN Eflags;
> > -
> > - __asm__ __volatile__ (
> > - "pushfl \n\t"
> > - "popl %0 "
> > - : "=r" (Eflags)
> > - );
> > -
> > - return Eflags;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the Control Register 0
> (CR0).
> >
> > @@ -1153,505 +1063,6 @@ AsmWriteLdtr (
> > );
> > }
> >
> > -
> > -/**
> > - Save the current floating point/SSE/SSE2 context to
> a buffer.
> > -
> > - Saves the current floating point/SSE/SSE2 state to
> the buffer specified by
> > - Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is only
> > - available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxSave (
> > - OUT IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxsave %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Restores the current floating point/SSE/SSE2
> context from a buffer.
> > -
> > - Restores the current floating point/SSE/SSE2 state
> from the buffer specified
> > - by Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxRestore (
> > - IN CONST IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxrstor %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Reads and returns the current value of MM0. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM0.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm0 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm0, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Reads and returns the current value of MM1. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM1.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm1 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm1, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Reads and returns the current value of MM2. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM2.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm2 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm2, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Reads and returns the current value of MM3. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM3.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm3 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm3, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Reads and returns the current value of MM4. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM4.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm4 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm4, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Reads and returns the current value of MM5. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM5.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm5 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm5, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Reads and returns the current value of MM6. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM6.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm6 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm6, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Reads and returns the current value of MM7. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM7.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm7 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "push %%eax \n\t"
> > - "push %%eax \n\t"
> > - "movq %%mm7, (%%esp)\n\t"
> > - "pop %%eax \n\t"
> > - "pop %%edx \n\t"
> > - : "=A" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Writes the current value of MM0. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM0.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm0 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm0" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Writes the current value of MM1. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM1.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm1 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm1" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Writes the current value of MM2. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM2.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm2 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm2" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Writes the current value of MM3. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM3.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm3 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm3" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Writes the current value of MM4. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM4.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm4 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm4" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Writes the current value of MM5. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM5.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm5 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm5" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Writes the current value of MM6. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM6.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm6 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm6" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Writes the current value of MM7. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM7.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm7 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movq %0, %%mm7" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Time Stamp Counter
> (TSC).
> > -
> > - Reads and returns the current value of TSC. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of TSC
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadTsc (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "rdtsc"
> > - : "=A" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > /**
> > Reads the current value of a Performance Counter
> (PMC).
> >
> > @@ -1680,9 +1091,6 @@ AsmReadPmc (
> > return Data;
> > }
> >
> > -
> > -
> > -
> > /**
> > Executes a WBINVD instruction.
> >
> > @@ -1699,7 +1107,6 @@ AsmWbinvd (
> > __asm__ __volatile__ ("wbinvd":::"memory");
> > }
> >
> > -
> > /**
> > Executes a INVD instruction.
> >
> > @@ -1761,5 +1168,3 @@ AsmFlushCacheLine (
> >
> > return LinearAddress;
> > }
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> b/MdePkg/Library/BaseLib/X64/GccInline.c
> > index 154ce1f57e..40a208f198 100644
> > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/X64/GccInline.c
> > @@ -1,7 +1,7 @@
> > /** @file
> > GCC inline implementation of BaseLib processor
> specific functions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -33,40 +33,6 @@ MemoryFence (
> > }
> >
> >
> > -/**
> > - Enables CPU interrupts.
> > -
> > - Enables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -EnableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("sti"::: "memory");
> > -}
> > -
> > -
> > -/**
> > - Disables CPU interrupts.
> > -
> > - Disables CPU interrupts.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -DisableInterrupts (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("cli"::: "memory");
> > -}
> > -
> > -
> > -
> > -
> > /**
> > Requests CPU to pause for a short period of time.
> >
> > @@ -101,83 +67,6 @@ CpuBreakpoint (
> > }
> >
> >
> > -
> > -/**
> > - Returns a 64-bit Machine Specific Register(MSR).
> > -
> > - Reads and returns the 64-bit MSR specified by
> Index. No parameter checking is
> > - performed on Index, and some Index values may cause
> CPU exceptions. The
> > - caller must either guarantee that Index is valid,
> or the caller must set up
> > - exception handlers to catch the exceptions. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to read.
> > -
> > - @return The value of the MSR identified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMsr64 (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HighData;
> > -
> > - __asm__ __volatile__ (
> > - "rdmsr"
> > - : "=a" (LowData), // %0
> > - "=d" (HighData) // %1
> > - : "c" (Index) // %2
> > - );
> > -
> > - return (((UINT64)HighData) << 32) | LowData;
> > -}
> > -
> > -/**
> > - Writes a 64-bit value to a Machine Specific
> Register(MSR), and returns the
> > - value.
> > -
> > - Writes the 64-bit value specified by Value to the
> MSR specified by Index. The
> > - 64-bit value written to the MSR is returned. No
> parameter checking is
> > - performed on Index or Value, and some of these may
> cause CPU exceptions. The
> > - caller must either guarantee that Index and Value
> are valid, or the caller
> > - must establish proper exception handlers. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @param Index The 32-bit MSR index to write.
> > - @param Value The 64-bit value to write to the MSR.
> > -
> > - @return Value
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmWriteMsr64 (
> > - IN UINT32 Index,
> > - IN UINT64 Value
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HighData;
> > -
> > - LowData = (UINT32)(Value);
> > - HighData = (UINT32)(Value >> 32);
> > -
> > - __asm__ __volatile__ (
> > - "wrmsr"
> > - :
> > - : "c" (Index),
> > - "a" (LowData),
> > - "d" (HighData)
> > - );
> > -
> > - return Value;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the EFLAGS register.
> >
> > @@ -205,965 +94,6 @@ AsmReadEflags (
> > return Eflags;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 0
> (CR0).
> > -
> > - Reads and returns the current value of CR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 0 (CR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr0,%0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 2
> (CR2).
> > -
> > - Reads and returns the current value of CR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 2 (CR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr2, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -/**
> > - Reads the current value of the Control Register 3
> (CR3).
> > -
> > - Reads and returns the current value of CR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 3 (CR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr3, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of the Control Register 4
> (CR4).
> > -
> > - Reads and returns the current value of CR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of the Control Register 4 (CR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadCr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cr4, %0"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 0 (CR0).
> > -
> > - Writes and returns a new value to CR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr0 The value to write to CR0.
> > -
> > - @return The value written to CR0.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr0 (
> > - UINTN Cr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr0"
> > - :
> > - : "r" (Cr0)
> > - );
> > - return Cr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 2 (CR2).
> > -
> > - Writes and returns a new value to CR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr2 The value to write to CR2.
> > -
> > - @return The value written to CR2.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr2 (
> > - UINTN Cr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr2"
> > - :
> > - : "r" (Cr2)
> > - );
> > - return Cr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 3 (CR3).
> > -
> > - Writes and returns a new value to CR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr3 The value to write to CR3.
> > -
> > - @return The value written to CR3.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr3 (
> > - UINTN Cr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr3"
> > - :
> > - : "r" (Cr3)
> > - );
> > - return Cr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Control Register 4 (CR4).
> > -
> > - Writes and returns a new value to CR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Cr4 The value to write to CR4.
> > -
> > - @return The value written to CR4.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteCr4 (
> > - UINTN Cr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%cr4"
> > - :
> > - : "r" (Cr4)
> > - );
> > - return Cr4;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 0 (DR0).
> > -
> > - Reads and returns the current value of DR0. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 0 (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr0 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr0, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 1 (DR1).
> > -
> > - Reads and returns the current value of DR1. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 1 (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr1 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr1, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 2 (DR2).
> > -
> > - Reads and returns the current value of DR2. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 2 (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr2 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr2, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 3 (DR3).
> > -
> > - Reads and returns the current value of DR3. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 3 (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr3 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr3, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 4 (DR4).
> > -
> > - Reads and returns the current value of DR4. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 4 (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr4 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr4, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 5 (DR5).
> > -
> > - Reads and returns the current value of DR5. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 5 (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr5 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr5, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 6 (DR6).
> > -
> > - Reads and returns the current value of DR6. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 6 (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr6 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr6, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Debug Register 7 (DR7).
> > -
> > - Reads and returns the current value of DR7. This
> function is only available
> > - on IA-32 and X64. This returns a 32-bit value on
> IA-32 and a 64-bit value on
> > - X64.
> > -
> > - @return The value of Debug Register 7 (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadDr7 (
> > - VOID
> > - )
> > -{
> > - UINTN Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%dr7, %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 0 (DR0).
> > -
> > - Writes and returns a new value to DR0. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr0 The value to write to Dr0.
> > -
> > - @return The value written to Debug Register 0
> (DR0).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr0 (
> > - UINTN Dr0
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr0"
> > - :
> > - : "r" (Dr0)
> > - );
> > - return Dr0;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 1 (DR1).
> > -
> > - Writes and returns a new value to DR1. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr1 The value to write to Dr1.
> > -
> > - @return The value written to Debug Register 1
> (DR1).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr1 (
> > - UINTN Dr1
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr1"
> > - :
> > - : "r" (Dr1)
> > - );
> > - return Dr1;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 2 (DR2).
> > -
> > - Writes and returns a new value to DR2. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr2 The value to write to Dr2.
> > -
> > - @return The value written to Debug Register 2
> (DR2).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr2 (
> > - UINTN Dr2
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr2"
> > - :
> > - : "r" (Dr2)
> > - );
> > - return Dr2;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 3 (DR3).
> > -
> > - Writes and returns a new value to DR3. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr3 The value to write to Dr3.
> > -
> > - @return The value written to Debug Register 3
> (DR3).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr3 (
> > - UINTN Dr3
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr3"
> > - :
> > - : "r" (Dr3)
> > - );
> > - return Dr3;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 4 (DR4).
> > -
> > - Writes and returns a new value to DR4. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr4 The value to write to Dr4.
> > -
> > - @return The value written to Debug Register 4
> (DR4).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr4 (
> > - UINTN Dr4
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr4"
> > - :
> > - : "r" (Dr4)
> > - );
> > - return Dr4;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 5 (DR5).
> > -
> > - Writes and returns a new value to DR5. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr5 The value to write to Dr5.
> > -
> > - @return The value written to Debug Register 5
> (DR5).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr5 (
> > - UINTN Dr5
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr5"
> > - :
> > - : "r" (Dr5)
> > - );
> > - return Dr5;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 6 (DR6).
> > -
> > - Writes and returns a new value to DR6. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr6 The value to write to Dr6.
> > -
> > - @return The value written to Debug Register 6
> (DR6).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr6 (
> > - UINTN Dr6
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr6"
> > - :
> > - : "r" (Dr6)
> > - );
> > - return Dr6;
> > -}
> > -
> > -
> > -/**
> > - Writes a value to Debug Register 7 (DR7).
> > -
> > - Writes and returns a new value to DR7. This
> function is only available on
> > - IA-32 and X64. This writes a 32-bit value on IA-32
> and a 64-bit value on X64.
> > -
> > - @param Dr7 The value to write to Dr7.
> > -
> > - @return The value written to Debug Register 7
> (DR7).
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmWriteDr7 (
> > - UINTN Dr7
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mov %0, %%dr7"
> > - :
> > - : "r" (Dr7)
> > - );
> > - return Dr7;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Code Segment Register
> (CS).
> > -
> > - Reads and returns the current value of CS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of CS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadCs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%cs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Data Segment Register
> (DS).
> > -
> > - Reads and returns the current value of DS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of DS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadDs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Extra Segment Register
> (ES).
> > -
> > - Reads and returns the current value of ES. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of ES.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadEs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%es, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of FS Data Segment Register
> (FS).
> > -
> > - Reads and returns the current value of FS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of FS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadFs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%fs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of GS Data Segment Register
> (GS).
> > -
> > - Reads and returns the current value of GS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of GS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadGs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%gs, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Stack Segment Register
> (SS).
> > -
> > - Reads and returns the current value of SS. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of SS.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadSs (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "mov %%ds, %0"
> > - :"=a" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Task Register (TR).
> > -
> > - Reads and returns the current value of TR. This
> function is only available on
> > - IA-32 and X64.
> > -
> > - @return The current value of TR.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadTr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "str %0"
> > - : "=r" (Data)
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current Global Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current GDTR descriptor and
> returns it in Gdtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadGdtr (
> > - OUT IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sgdt %0"
> > - : "=m" (*Gdtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Global Descriptor Table Register
> (GDTR) descriptor.
> > -
> > - Writes and the current GDTR descriptor specified by
> Gdtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Gdtr The pointer to a GDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteGdtr (
> > - IN CONST IA32_DESCRIPTOR *Gdtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lgdt %0"
> > - :
> > - : "m" (*Gdtr)
> > - );
> > -
> > -}
> > -
> > -
> > -/**
> > - Reads the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Reads and returns the current IDTR descriptor and
> returns it in Idtr. This
> > - function is only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86ReadIdtr (
> > - OUT IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "sidt %0"
> > - : "=m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current Interrupt Descriptor Table
> Register(GDTR) descriptor.
> > -
> > - Writes the current IDTR descriptor and returns it
> in Idtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Idtr The pointer to a IDTR descriptor.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86WriteIdtr (
> > - IN CONST IA32_DESCRIPTOR *Idtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lidt %0"
> > - :
> > - : "m" (*Idtr)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current Local Descriptor Table
> Register(LDTR) selector.
> > -
> > - Reads and returns the current 16-bit LDTR
> descriptor value. This function is
> > - only available on IA-32 and X64.
> > -
> > - @return The current selector of LDT.
> > -
> > -**/
> > -UINT16
> > -EFIAPI
> > -AsmReadLdtr (
> > - VOID
> > - )
> > -{
> > - UINT16 Data;
> > -
> > - __asm__ __volatile__ (
> > - "sldt %0"
> > - : "=g" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current Local Descriptor Table Register
> (GDTR) selector.
> > -
> > - Writes and the current LDTR descriptor specified by
> Ldtr. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Ldtr 16-bit LDTR selector value.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteLdtr (
> > - IN UINT16 Ldtr
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "lldtw %0"
> > - :
> > - : "g" (Ldtr) // %0
> > - );
> > -}
> > -
> > -
> > /**
> > Save the current floating point/SSE/SSE2 context to
> a buffer.
> >
> > @@ -1630,171 +560,3 @@ AsmReadTsc (
> >
> > return (((UINT64)HiData) << 32) | LowData;
> > }
> > -
> > -
> > -/**
> > - Reads the current value of a Performance Counter
> (PMC).
> > -
> > - Reads and returns the current value of performance
> counter specified by
> > - Index. This function is only available on IA-32 and
> X64.
> > -
> > - @param Index The 32-bit Performance Counter index
> to read.
> > -
> > - @return The value of the PMC specified by Index.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadPmc (
> > - IN UINT32 Index
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HiData;
> > -
> > - __asm__ __volatile__ (
> > - "rdpmc"
> > - : "=a" (LowData),
> > - "=d" (HiData)
> > - : "c" (Index)
> > - );
> > -
> > - return (((UINT64)HiData) << 32) | LowData;
> > -}
> > -
> > -
> > -/**
> > - Sets up a monitor buffer that is used by
> AsmMwait().
> > -
> > - Executes a MONITOR instruction with the register
> state specified by Eax, Ecx
> > - and Edx. Returns Eax. This function is only
> available on IA-32 and X64.
> > -
> > - @param Eax The value to load into EAX or RAX
> before executing the MONITOR
> > - instruction.
> > - @param Ecx The value to load into ECX or RCX
> before executing the MONITOR
> > - instruction.
> > - @param Edx The value to load into EDX or RDX
> before executing the MONITOR
> > - instruction.
> > -
> > - @return Eax
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmMonitor (
> > - IN UINTN Eax,
> > - IN UINTN Ecx,
> > - IN UINTN Edx
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "monitor"
> > - :
> > - : "a" (Eax),
> > - "c" (Ecx),
> > - "d" (Edx)
> > - );
> > -
> > - return Eax;
> > -}
> > -
> > -
> > -/**
> > - Executes an MWAIT instruction.
> > -
> > - Executes an MWAIT instruction with the register
> state specified by Eax and
> > - Ecx. Returns Eax. This function is only available
> on IA-32 and X64.
> > -
> > - @param Eax The value to load into EAX or RAX
> before executing the MONITOR
> > - instruction.
> > - @param Ecx The value to load into ECX or RCX
> before executing the MONITOR
> > - instruction.
> > -
> > - @return Eax
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmMwait (
> > - IN UINTN Eax,
> > - IN UINTN Ecx
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "mwait"
> > - :
> > - : "a" (Eax),
> > - "c" (Ecx)
> > - );
> > -
> > - return Eax;
> > -}
> > -
> > -
> > -/**
> > - Executes a WBINVD instruction.
> > -
> > - Executes a WBINVD instruction. This function is
> only available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWbinvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("wbinvd":::"memory");
> > -}
> > -
> > -
> > -/**
> > - Executes a INVD instruction.
> > -
> > - Executes a INVD instruction. This function is only
> available on IA-32 and
> > - X64.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmInvd (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("invd":::"memory");
> > -
> > -}
> > -
> > -
> > -/**
> > - Flushes a cache line from all the instruction and
> data caches within the
> > - coherency domain of the CPU.
> > -
> > - Flushed the cache line specified by LinearAddress,
> and returns LinearAddress.
> > - This function is only available on IA-32 and X64.
> > -
> > - @param LinearAddress The address of the cache line
> to flush. If the CPU is
> > - in a physical addressing
> mode, then LinearAddress is a
> > - physical address. If the CPU
> is in a virtual
> > - addressing mode, then
> LinearAddress is a virtual
> > - address.
> > -
> > - @return LinearAddress
> > -**/
> > -VOID *
> > -EFIAPI
> > -AsmFlushCacheLine (
> > - IN VOID *LinearAddress
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "clflush (%0)"
> > - :
> > - : "r" (LinearAddress)
> > - : "memory"
> > - );
> > -
> > - return LinearAddress;
> > -}
> > -
> > -
> > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > similarity index 65%
> > copy from MdePkg/Library/BaseLib/X64/GccInline.c
> > copy to MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > index 154ce1f57e..98be19b3c7 100644
> > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > +++ b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > @@ -1,7 +1,8 @@
> > /** @file
> > - GCC inline implementation of BaseLib processor
> specific functions.
> > + GCC inline implementation of BaseLib processor
> specific functions that use
> > + privlidged instructions.
> >
> > - Copyright (c) 2006 - 2018, Intel Corporation. All
> rights reserved.<BR>
> > + Copyright (c) 2006 - 2020, Intel Corporation. All
> rights reserved.<BR>
> > Portions copyright (c) 2008 - 2009, Apple Inc. All
> rights reserved.<BR>
> > SPDX-License-Identifier: BSD-2-Clause-Patent
> >
> > @@ -10,29 +11,6 @@
> >
> > #include "BaseLibInternals.h"
> >
> > -
> > -
> > -
> > -/**
> > - Used to serialize load and store operations.
> > -
> > - All loads and stores that proceed calls to this
> function are guaranteed to be
> > - globally visible when this function returns.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -MemoryFence (
> > - VOID
> > - )
> > -{
> > - // This is a little bit of overkill and it is more
> about the compiler that it is
> > - // actually processor synchronization. This is like
> the _ReadWriteBarrier
> > - // Microsoft specific intrinsic
> > - __asm__ __volatile__ ("":::"memory");
> > -}
> > -
> > -
> > /**
> > Enables CPU interrupts.
> >
> > @@ -64,44 +42,6 @@ DisableInterrupts (
> > __asm__ __volatile__ ("cli"::: "memory");
> > }
> >
> > -
> > -
> > -
> > -/**
> > - Requests CPU to pause for a short period of time.
> > -
> > - Requests CPU to pause for a short period of time.
> Typically used in MP
> > - systems to prevent memory starvation while waiting
> for a spin lock.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuPause (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("pause");
> > -}
> > -
> > -
> > -/**
> > - Generates a breakpoint on the CPU.
> > -
> > - Generates a breakpoint on the CPU. The breakpoint
> must be implemented such
> > - that code can resume normal execution after the
> breakpoint.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -CpuBreakpoint (
> > - VOID
> > - )
> > -{
> > - __asm__ __volatile__ ("int $3");
> > -}
> > -
> > -
> > -
> > /**
> > Returns a 64-bit Machine Specific Register(MSR).
> >
> > @@ -176,37 +116,6 @@ AsmWriteMsr64 (
> > return Value;
> > }
> >
> > -
> > -
> > -/**
> > - Reads the current value of the EFLAGS register.
> > -
> > - Reads and returns the current value of the EFLAGS
> register. This function is
> > - only available on IA-32 and X64. This returns a 32-
> bit value on IA-32 and a
> > - 64-bit value on X64.
> > -
> > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > -
> > -**/
> > -UINTN
> > -EFIAPI
> > -AsmReadEflags (
> > - VOID
> > - )
> > -{
> > - UINTN Eflags;
> > -
> > - __asm__ __volatile__ (
> > - "pushfq \n\t"
> > - "pop %0 "
> > - : "=r" (Eflags) // %0
> > - );
> > -
> > - return Eflags;
> > -}
> > -
> > -
> > -
> > /**
> > Reads the current value of the Control Register 0
> (CR0).
> >
> > @@ -1163,475 +1072,6 @@ AsmWriteLdtr (
> > );
> > }
> >
> > -
> > -/**
> > - Save the current floating point/SSE/SSE2 context to
> a buffer.
> > -
> > - Saves the current floating point/SSE/SSE2 state to
> the buffer specified by
> > - Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is only
> > - available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxSave (
> > - OUT IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxsave %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Restores the current floating point/SSE/SSE2
> context from a buffer.
> > -
> > - Restores the current floating point/SSE/SSE2 state
> from the buffer specified
> > - by Buffer. Buffer must be aligned on a 16-byte
> boundary. This function is
> > - only available on IA-32 and X64.
> > -
> > - @param Buffer The pointer to a buffer to save the
> floating point/SSE/SSE2 context.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -InternalX86FxRestore (
> > - IN CONST IA32_FX_BUFFER *Buffer
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "fxrstor %0"
> > - :
> > - : "m" (*Buffer) // %0
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Reads and returns the current value of MM0. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM0.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm0 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm0, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Reads and returns the current value of MM1. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM1.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm1 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm1, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Reads and returns the current value of MM2. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM2.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm2 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm2, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Reads and returns the current value of MM3. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM3.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm3 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm3, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Reads and returns the current value of MM4. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM4.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm4 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm4, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Reads and returns the current value of MM5. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM5.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm5 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm5, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Reads and returns the current value of MM6. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM6.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm6 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm6, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Reads and returns the current value of MM7. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of MM7.
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadMm7 (
> > - VOID
> > - )
> > -{
> > - UINT64 Data;
> > -
> > - __asm__ __volatile__ (
> > - "movd %%mm7, %0 \n\t"
> > - : "=r" (Data) // %0
> > - );
> > -
> > - return Data;
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #0
> (MM0).
> > -
> > - Writes the current value of MM0. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM0.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm0 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm0" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #1
> (MM1).
> > -
> > - Writes the current value of MM1. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM1.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm1 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm1" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #2
> (MM2).
> > -
> > - Writes the current value of MM2. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM2.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm2 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm2" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #3
> (MM3).
> > -
> > - Writes the current value of MM3. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM3.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm3 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm3" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #4
> (MM4).
> > -
> > - Writes the current value of MM4. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM4.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm4 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm4" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #5
> (MM5).
> > -
> > - Writes the current value of MM5. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM5.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm5 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm5" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #6
> (MM6).
> > -
> > - Writes the current value of MM6. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM6.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm6 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm6" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Writes the current value of 64-bit MMX Register #7
> (MM7).
> > -
> > - Writes the current value of MM7. This function is
> only available on IA32 and
> > - X64.
> > -
> > - @param Value The 64-bit value to write to MM7.
> > -
> > -**/
> > -VOID
> > -EFIAPI
> > -AsmWriteMm7 (
> > - IN UINT64 Value
> > - )
> > -{
> > - __asm__ __volatile__ (
> > - "movd %0, %%mm7" // %0
> > - :
> > - : "m" (Value)
> > - );
> > -}
> > -
> > -
> > -/**
> > - Reads the current value of Time Stamp Counter
> (TSC).
> > -
> > - Reads and returns the current value of TSC. This
> function is only available
> > - on IA-32 and X64.
> > -
> > - @return The current value of TSC
> > -
> > -**/
> > -UINT64
> > -EFIAPI
> > -AsmReadTsc (
> > - VOID
> > - )
> > -{
> > - UINT32 LowData;
> > - UINT32 HiData;
> > -
> > - __asm__ __volatile__ (
> > - "rdtsc"
> > - : "=a" (LowData),
> > - "=d" (HiData)
> > - );
> > -
> > - return (((UINT64)HiData) << 32) | LowData;
> > -}
> > -
> > -
> > /**
> > Reads the current value of a Performance Counter
> (PMC).
> >
> > @@ -1662,7 +1102,6 @@ AsmReadPmc (
> > return (((UINT64)HiData) << 32) | LowData;
> > }
> >
> > -
> > /**
> > Sets up a monitor buffer that is used by
> AsmMwait().
> >
> > @@ -1698,7 +1137,6 @@ AsmMonitor (
> > return Eax;
> > }
> >
> > -
> > /**
> > Executes an MWAIT instruction.
> >
> > @@ -1730,7 +1168,6 @@ AsmMwait (
> > return Eax;
> > }
> >
> > -
> > /**
> > Executes a WBINVD instruction.
> >
> > @@ -1747,7 +1184,6 @@ AsmWbinvd (
> > __asm__ __volatile__ ("wbinvd":::"memory");
> > }
> >
> > -
> > /**
> > Executes a INVD instruction.
> >
> > @@ -1796,5 +1232,3 @@ AsmFlushCacheLine (
> >
> > return LinearAddress;
> > }
> > -
> > -
> > --
> > 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread* Re: [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions
2020-07-10 8:06 ` Liming Gao
@ 2020-07-10 16:24 ` Michael D Kinney
0 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-07-10 16:24 UTC (permalink / raw)
To: Gao, Liming, devel@edk2.groups.io, Kinney, Michael D
Cc: Sean Brogan, Bret Barkelew, Yao, Jiewen
Liming,
GccInline.c can be used in UnitTestHostBaseLib instance.
GccInlinePriv.c is the file that cannot be used in the.
UnitTestHostBaseLib instance.
Here are the grep results in the branch:
baselib.inf: Ia32/GccInline.c | GCC
baselib.inf: Ia32/GccInlinePriv.c | GCC
baselib.inf: X64/GccInline.c | GCC
baselib.inf: X64/GccInlinePriv.c | GCC
unittesthostbaselib.inf: Ia32/GccInline.c | GCC
unittesthostbaselib.inf: X64/GccInline.c | GCC
Best regards,
Mike
> -----Original Message-----
> From: Gao, Liming <liming.gao@intel.com>
> Sent: Friday, July 10, 2020 1:06 AM
> To: Kinney, Michael D <michael.d.kinney@intel.com>;
> devel@edk2.groups.io
> Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret
> Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> <jiewen.yao@intel.com>
> Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
>
> Mike:
> So, GccInline.c file can't be used in the unit test
> BaseLib.
>
> Thanks
> Liming
> -----Original Message-----
> From: Kinney, Michael D <michael.d.kinney@intel.com>
> Sent: 2020年7月10日 1:01
> To: Gao, Liming <liming.gao@intel.com>;
> devel@edk2.groups.io; Kinney, Michael D
> <michael.d.kinney@intel.com>
> Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret
> Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> <jiewen.yao@intel.com>
> Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out
> IA32/X64 GCC inline privileged functions
>
> Liming,
>
> In order to support host based unit tests, all the code
> has to be compatible with a user mode process. This
> means
> any functions that execute instructions that are not
> allowed
> in a user mode process need to be separated out.
>
> For the IA32/X64 specific GccInline.c files, the
> analysis
> was done for APIs that use instructions that would
> generate an exception in a user mode process.
>
> In addition, the BaseLib functions that return system
> state (e.g. CS/DS/ES/SS/FS/GS) are also split out. It
> does not make sense to return system state information
> from the currently executing user mode process.
> Instead,
> the FW code under test would expect system state that
> matches a FW execution environment. Each unit test
> implementation has the option of providing emulation
> of this system state if that is required to exercise the
> code under test.
>
> No changes to the MSFT specific BaseLib implementation
> were required because there those are already split out
> to one function per file.
>
> Best regards,
>
> Mike
>
> > -----Original Message-----
> > From: Gao, Liming <liming.gao@intel.com>
> > Sent: Thursday, July 9, 2020 7:07 AM
> > To: Kinney, Michael D <michael.d.kinney@intel.com>;
> > devel@edk2.groups.io
> > Cc: Sean Brogan <sean.brogan@microsoft.com>; Bret
> > Barkelew <Bret.Barkelew@microsoft.com>; Yao, Jiewen
> > <jiewen.yao@intel.com>
> > Subject: RE: [Patch 04/15] MdePkg/BaseLib: Break out
> > IA32/X64 GCC inline privileged functions
> >
> > Mike:
> > Is there the rule to know which function can't be in
> > unit test? And, those functions will be in GccInline.c
> > or GccInlinePriv.c? There is no change in MSFT C
> source
> > file, because MSFT C source file has been separated as
> > the function level. Right?
> >
> > Thanks
> > Liming
> > > -----Original Message-----
> > > From: Kinney, Michael D <michael.d.kinney@intel.com>
> > > Sent: Monday, June 15, 2020 8:19 AM
> > > To: devel@edk2.groups.io
> > > Cc: Gao, Liming <liming.gao@intel.com>; Sean Brogan
> > <sean.brogan@microsoft.com>; Bret Barkelew
> > <Bret.Barkelew@microsoft.com>;
> > > Yao, Jiewen <jiewen.yao@intel.com>
> > > Subject: [Patch 04/15] MdePkg/BaseLib: Break out
> > IA32/X64 GCC inline privileged functions
> > >
> > > https://bugzilla.tianocore.org/show_bug.cgi?id=2800
> > >
> > > Break out the IA32/X64 GCC inline functions that can
> > not be used
> > > in a unit test host application into their own
> source
> > file. This
> > > does not make any changes to the BaseLib library
> > instance. This
> > > is in preparation for a new BaseLib instances that
> is
> > safe to use
> > > with host-based unit test applications.
> > >
> > > Cc: Liming Gao <liming.gao@intel.com>
> > > Cc: Sean Brogan <sean.brogan@microsoft.com>
> > > Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
> > > Cc: Jiewen Yao <jiewen.yao@intel.com>
> > > Signed-off-by: Michael D Kinney
> > <michael.d.kinney@intel.com>
> > > ---
> > > MdePkg/Library/BaseLib/BaseLib.inf |
> 4
> > +-
> > > MdePkg/Library/BaseLib/Ia32/GccInline.c |
> 1181
> > +---------------
> > > .../Ia32/{GccInline.c => GccInlinePriv.c} |
> 601
> > +-------
> > > MdePkg/Library/BaseLib/X64/GccInline.c |
> 1240
> > +----------------
> > > .../X64/{GccInline.c => GccInlinePriv.c} |
> 572
> > +-------
> > > 5 files changed, 11 insertions(+), 3587 deletions(-
> )
> > > copy MdePkg/Library/BaseLib/Ia32/{GccInline.c =>
> > GccInlinePriv.c} (62%)
> > > copy MdePkg/Library/BaseLib/X64/{GccInline.c =>
> > GccInlinePriv.c} (65%)
> > >
> > > diff --git a/MdePkg/Library/BaseLib/BaseLib.inf
> > b/MdePkg/Library/BaseLib/BaseLib.inf
> > > index a57ae2da31..c740a819ca 100644
> > > --- a/MdePkg/Library/BaseLib/BaseLib.inf
> > > +++ b/MdePkg/Library/BaseLib/BaseLib.inf
> > > @@ -1,7 +1,7 @@
> > > ## @file
> > > # Base Library implementation.
> > > #
> > > -# Copyright (c) 2007 - 2019, Intel Corporation.
> All
> > rights reserved.<BR>
> > > +# Copyright (c) 2007 - 2020, Intel Corporation.
> All
> > rights reserved.<BR>
> > > # Portions copyright (c) 2008 - 2009, Apple Inc.
> All
> > rights reserved.<BR>
> > > # Portions copyright (c) 2011 - 2013, ARM Ltd. All
> > rights reserved.<BR>
> > > # Copyright (c) 2020, Hewlett Packard Enterprise
> > Development LP. All rights reserved.<BR>
> > > @@ -156,6 +156,7 @@ [Sources.Ia32]
> > >
> > >
> > > Ia32/GccInline.c | GCC
> > > + Ia32/GccInlinePriv.c | GCC
> > > Ia32/Thunk16.nasm
> > > Ia32/EnableDisableInterrupts.nasm| GCC
> > > Ia32/EnablePaging64.nasm
> > > @@ -310,6 +311,7 @@ [Sources.X64]
> > > X86PatchInstruction.c
> > > X86SpeculationBarrier.c
> > > X64/GccInline.c | GCC
> > > + X64/GccInlinePriv.c | GCC
> > > X64/EnableDisableInterrupts.nasm
> > > X64/DisablePaging64.nasm
> > > X64/RdRand.nasm
> > > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > > index 5287200f87..6ed938187a 100644
> > > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > > +++ b/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > > @@ -1,7 +1,7 @@
> > > /** @file
> > > GCC inline implementation of BaseLib processor
> > specific functions.
> > >
> > > - Copyright (c) 2006 - 2018, Intel Corporation. All
> > rights reserved.<BR>
> > > + Copyright (c) 2006 - 2020, Intel Corporation. All
> > rights reserved.<BR>
> > > Portions copyright (c) 2008 - 2009, Apple Inc.
> All
> > rights reserved.<BR>
> > > SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > > @@ -10,8 +10,6 @@
> > >
> > > #include "BaseLibInternals.h"
> > >
> > > -
> > > -
> > > /**
> > > Used to serialize load and store operations.
> > >
> > > @@ -31,41 +29,6 @@ MemoryFence (
> > > __asm__ __volatile__ ("":::"memory");
> > > }
> > >
> > > -
> > > -/**
> > > - Enables CPU interrupts.
> > > -
> > > - Enables CPU interrupts.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -EnableInterrupts (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("sti"::: "memory");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Disables CPU interrupts.
> > > -
> > > - Disables CPU interrupts.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -DisableInterrupts (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("cli"::: "memory");
> > > -}
> > > -
> > > -
> > > -
> > > -
> > > /**
> > > Requests CPU to pause for a short period of time.
> > >
> > > @@ -82,7 +45,6 @@ CpuPause (
> > > __asm__ __volatile__ ("pause");
> > > }
> > >
> > > -
> > > /**
> > > Generates a breakpoint on the CPU.
> > >
> > > @@ -99,75 +61,6 @@ CpuBreakpoint (
> > > __asm__ __volatile__ ("int $3");
> > > }
> > >
> > > -
> > > -
> > > -/**
> > > - Returns a 64-bit Machine Specific Register(MSR).
> > > -
> > > - Reads and returns the 64-bit MSR specified by
> > Index. No parameter checking is
> > > - performed on Index, and some Index values may
> cause
> > CPU exceptions. The
> > > - caller must either guarantee that Index is valid,
> > or the caller must set up
> > > - exception handlers to catch the exceptions. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @param Index The 32-bit MSR index to read.
> > > -
> > > - @return The value of the MSR identified by Index.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMsr64 (
> > > - IN UINT32 Index
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdmsr"
> > > - : "=A" (Data) // %0
> > > - : "c" (Index) // %1
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -/**
> > > - Writes a 64-bit value to a Machine Specific
> > Register(MSR), and returns the
> > > - value.
> > > -
> > > - Writes the 64-bit value specified by Value to the
> > MSR specified by Index. The
> > > - 64-bit value written to the MSR is returned. No
> > parameter checking is
> > > - performed on Index or Value, and some of these
> may
> > cause CPU exceptions. The
> > > - caller must either guarantee that Index and Value
> > are valid, or the caller
> > > - must establish proper exception handlers. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @param Index The 32-bit MSR index to write.
> > > - @param Value The 64-bit value to write to the
> MSR.
> > > -
> > > - @return Value
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmWriteMsr64 (
> > > - IN UINT32 Index,
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "wrmsr"
> > > - :
> > > - : "c" (Index),
> > > - "A" (Value)
> > > - );
> > > -
> > > - return Value;
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Reads the current value of the EFLAGS register.
> > >
> > > @@ -195,965 +88,6 @@ AsmReadEflags (
> > > return Eflags;
> > > }
> > >
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 0
> > (CR0).
> > > -
> > > - Reads and returns the current value of CR0. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 0
> (CR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%cr0,%0"
> > > - : "=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 2
> > (CR2).
> > > -
> > > - Reads and returns the current value of CR2. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 2
> (CR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%cr2, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 3
> > (CR3).
> > > -
> > > - Reads and returns the current value of CR3. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 3
> (CR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%cr3, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 4
> > (CR4).
> > > -
> > > - Reads and returns the current value of CR4. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 4
> (CR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%cr4, %0"
> > > - : "=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 0 (CR0).
> > > -
> > > - Writes and returns a new value to CR0. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr0 The value to write to CR0.
> > > -
> > > - @return The value written to CR0.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr0 (
> > > - UINTN Cr0
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%cr0"
> > > - :
> > > - : "r" (Cr0)
> > > - );
> > > - return Cr0;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 2 (CR2).
> > > -
> > > - Writes and returns a new value to CR2. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr2 The value to write to CR2.
> > > -
> > > - @return The value written to CR2.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr2 (
> > > - UINTN Cr2
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%cr2"
> > > - :
> > > - : "r" (Cr2)
> > > - );
> > > - return Cr2;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 3 (CR3).
> > > -
> > > - Writes and returns a new value to CR3. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr3 The value to write to CR3.
> > > -
> > > - @return The value written to CR3.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr3 (
> > > - UINTN Cr3
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%cr3"
> > > - :
> > > - : "r" (Cr3)
> > > - );
> > > - return Cr3;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 4 (CR4).
> > > -
> > > - Writes and returns a new value to CR4. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr4 The value to write to CR4.
> > > -
> > > - @return The value written to CR4.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr4 (
> > > - UINTN Cr4
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%cr4"
> > > - :
> > > - : "r" (Cr4)
> > > - );
> > > - return Cr4;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 0
> (DR0).
> > > -
> > > - Reads and returns the current value of DR0. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 0 (DR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr0, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 1
> (DR1).
> > > -
> > > - Reads and returns the current value of DR1. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 1 (DR1).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr1 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr1, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 2
> (DR2).
> > > -
> > > - Reads and returns the current value of DR2. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 2 (DR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr2, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 3
> (DR3).
> > > -
> > > - Reads and returns the current value of DR3. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 3 (DR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr3, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 4
> (DR4).
> > > -
> > > - Reads and returns the current value of DR4. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 4 (DR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr4, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 5
> (DR5).
> > > -
> > > - Reads and returns the current value of DR5. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 5 (DR5).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr5 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr5, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 6
> (DR6).
> > > -
> > > - Reads and returns the current value of DR6. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 6 (DR6).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr6 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr6, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 7
> (DR7).
> > > -
> > > - Reads and returns the current value of DR7. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 7 (DR7).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr7 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movl %%dr7, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 0 (DR0).
> > > -
> > > - Writes and returns a new value to DR0. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr0 The value to write to Dr0.
> > > -
> > > - @return The value written to Debug Register 0
> > (DR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr0 (
> > > - UINTN Dr0
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr0"
> > > - :
> > > - : "r" (Dr0)
> > > - );
> > > - return Dr0;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 1 (DR1).
> > > -
> > > - Writes and returns a new value to DR1. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr1 The value to write to Dr1.
> > > -
> > > - @return The value written to Debug Register 1
> > (DR1).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr1 (
> > > - UINTN Dr1
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr1"
> > > - :
> > > - : "r" (Dr1)
> > > - );
> > > - return Dr1;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 2 (DR2).
> > > -
> > > - Writes and returns a new value to DR2. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr2 The value to write to Dr2.
> > > -
> > > - @return The value written to Debug Register 2
> > (DR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr2 (
> > > - UINTN Dr2
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr2"
> > > - :
> > > - : "r" (Dr2)
> > > - );
> > > - return Dr2;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 3 (DR3).
> > > -
> > > - Writes and returns a new value to DR3. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr3 The value to write to Dr3.
> > > -
> > > - @return The value written to Debug Register 3
> > (DR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr3 (
> > > - UINTN Dr3
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr3"
> > > - :
> > > - : "r" (Dr3)
> > > - );
> > > - return Dr3;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 4 (DR4).
> > > -
> > > - Writes and returns a new value to DR4. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr4 The value to write to Dr4.
> > > -
> > > - @return The value written to Debug Register 4
> > (DR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr4 (
> > > - UINTN Dr4
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr4"
> > > - :
> > > - : "r" (Dr4)
> > > - );
> > > - return Dr4;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 5 (DR5).
> > > -
> > > - Writes and returns a new value to DR5. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr5 The value to write to Dr5.
> > > -
> > > - @return The value written to Debug Register 5
> > (DR5).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr5 (
> > > - UINTN Dr5
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr5"
> > > - :
> > > - : "r" (Dr5)
> > > - );
> > > - return Dr5;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 6 (DR6).
> > > -
> > > - Writes and returns a new value to DR6. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr6 The value to write to Dr6.
> > > -
> > > - @return The value written to Debug Register 6
> > (DR6).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr6 (
> > > - UINTN Dr6
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr6"
> > > - :
> > > - : "r" (Dr6)
> > > - );
> > > - return Dr6;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 7 (DR7).
> > > -
> > > - Writes and returns a new value to DR7. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr7 The value to write to Dr7.
> > > -
> > > - @return The value written to Debug Register 7
> > (DR7).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr7 (
> > > - UINTN Dr7
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movl %0, %%dr7"
> > > - :
> > > - : "r" (Dr7)
> > > - );
> > > - return Dr7;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Code Segment Register
> > (CS).
> > > -
> > > - Reads and returns the current value of CS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of CS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadCs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Data Segment Register
> > (DS).
> > > -
> > > - Reads and returns the current value of DS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of DS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadDs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%ds, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Extra Segment Register
> > (ES).
> > > -
> > > - Reads and returns the current value of ES. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of ES.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadEs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%es, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of FS Data Segment
> Register
> > (FS).
> > > -
> > > - Reads and returns the current value of FS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of FS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadFs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%fs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of GS Data Segment
> Register
> > (GS).
> > > -
> > > - Reads and returns the current value of GS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of GS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadGs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%gs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Stack Segment Register
> > (SS).
> > > -
> > > - Reads and returns the current value of SS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of SS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadSs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%ds, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Task Register (TR).
> > > -
> > > - Reads and returns the current value of TR. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of TR.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadTr (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "str %0"
> > > - : "=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Global Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Reads and returns the current GDTR descriptor and
> > returns it in Gdtr. This
> > > - function is only available on IA-32 and X64.
> > > -
> > > - @param Gdtr The pointer to a GDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86ReadGdtr (
> > > - OUT IA32_DESCRIPTOR *Gdtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "sgdt %0"
> > > - : "=m" (*Gdtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Global Descriptor Table
> Register
> > (GDTR) descriptor.
> > > -
> > > - Writes and the current GDTR descriptor specified
> by
> > Gdtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Gdtr The pointer to a GDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86WriteGdtr (
> > > - IN CONST IA32_DESCRIPTOR *Gdtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lgdt %0"
> > > - :
> > > - : "m" (*Gdtr)
> > > - );
> > > -
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Interrupt Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Reads and returns the current IDTR descriptor and
> > returns it in Idtr. This
> > > - function is only available on IA-32 and X64.
> > > -
> > > - @param Idtr The pointer to a IDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86ReadIdtr (
> > > - OUT IA32_DESCRIPTOR *Idtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "sidt %0"
> > > - : "=m" (*Idtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Interrupt Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Writes the current IDTR descriptor and returns it
> > in Idtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Idtr The pointer to a IDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86WriteIdtr (
> > > - IN CONST IA32_DESCRIPTOR *Idtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lidt %0"
> > > - :
> > > - : "m" (*Idtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Local Descriptor Table
> > Register(LDTR) selector.
> > > -
> > > - Reads and returns the current 16-bit LDTR
> > descriptor value. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @return The current selector of LDT.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadLdtr (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "sldt %0"
> > > - : "=g" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Local Descriptor Table
> Register
> > (GDTR) selector.
> > > -
> > > - Writes and the current LDTR descriptor specified
> by
> > Ldtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Ldtr 16-bit LDTR selector value.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteLdtr (
> > > - IN UINT16 Ldtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lldtw %0"
> > > - :
> > > - : "g" (Ldtr) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > /**
> > > Save the current floating point/SSE/SSE2 context
> to
> > a buffer.
> > >
> > > @@ -1650,116 +584,3 @@ AsmReadTsc (
> > >
> > > return Data;
> > > }
> > > -
> > > -
> > > -/**
> > > - Reads the current value of a Performance Counter
> > (PMC).
> > > -
> > > - Reads and returns the current value of
> performance
> > counter specified by
> > > - Index. This function is only available on IA-32
> and
> > X64.
> > > -
> > > - @param Index The 32-bit Performance Counter
> index
> > to read.
> > > -
> > > - @return The value of the PMC specified by Index.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadPmc (
> > > - IN UINT32 Index
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdpmc"
> > > - : "=A" (Data)
> > > - : "c" (Index)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -
> > > -
> > > -/**
> > > - Executes a WBINVD instruction.
> > > -
> > > - Executes a WBINVD instruction. This function is
> > only available on IA-32 and
> > > - X64.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWbinvd (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("wbinvd":::"memory");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Executes a INVD instruction.
> > > -
> > > - Executes a INVD instruction. This function is
> only
> > available on IA-32 and
> > > - X64.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmInvd (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("invd":::"memory");
> > > -
> > > -}
> > > -
> > > -
> > > -/**
> > > - Flushes a cache line from all the instruction and
> > data caches within the
> > > - coherency domain of the CPU.
> > > -
> > > - Flushed the cache line specified by
> LinearAddress,
> > and returns LinearAddress.
> > > - This function is only available on IA-32 and X64.
> > > -
> > > - @param LinearAddress The address of the cache
> line
> > to flush. If the CPU is
> > > - in a physical addressing
> > mode, then LinearAddress is a
> > > - physical address. If the
> CPU
> > is in a virtual
> > > - addressing mode, then
> > LinearAddress is a virtual
> > > - address.
> > > -
> > > - @return LinearAddress
> > > -**/
> > > -VOID *
> > > -EFIAPI
> > > -AsmFlushCacheLine (
> > > - IN VOID *LinearAddress
> > > - )
> > > -{
> > > - UINT32 RegEdx;
> > > -
> > > - //
> > > - // If the CPU does not support CLFLUSH
> instruction,
> > > - // then promote flush range to flush entire
> cache.
> > > - //
> > > - AsmCpuid (0x01, NULL, NULL, NULL, &RegEdx);
> > > - if ((RegEdx & BIT19) == 0) {
> > > - __asm__ __volatile__ ("wbinvd":::"memory");
> > > - return LinearAddress;
> > > - }
> > > -
> > > -
> > > - __asm__ __volatile__ (
> > > - "clflush (%0)"
> > > - : "+a" (LinearAddress)
> > > - :
> > > - : "memory"
> > > - );
> > > -
> > > - return LinearAddress;
> > > -}
> > > -
> > > -
> > > diff --git a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > > similarity index 62%
> > > copy from MdePkg/Library/BaseLib/Ia32/GccInline.c
> > > copy to MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > > index 5287200f87..30aa63243b 100644
> > > --- a/MdePkg/Library/BaseLib/Ia32/GccInline.c
> > > +++ b/MdePkg/Library/BaseLib/Ia32/GccInlinePriv.c
> > > @@ -1,7 +1,8 @@
> > > /** @file
> > > - GCC inline implementation of BaseLib processor
> > specific functions.
> > > + GCC inline implementation of BaseLib processor
> > specific functions that use
> > > + privlidged instructions.
> > >
> > > - Copyright (c) 2006 - 2018, Intel Corporation. All
> > rights reserved.<BR>
> > > + Copyright (c) 2006 - 2020, Intel Corporation. All
> > rights reserved.<BR>
> > > Portions copyright (c) 2008 - 2009, Apple Inc.
> All
> > rights reserved.<BR>
> > > SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > > @@ -10,28 +11,6 @@
> > >
> > > #include "BaseLibInternals.h"
> > >
> > > -
> > > -
> > > -/**
> > > - Used to serialize load and store operations.
> > > -
> > > - All loads and stores that proceed calls to this
> > function are guaranteed to be
> > > - globally visible when this function returns.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -MemoryFence (
> > > - VOID
> > > - )
> > > -{
> > > - // This is a little bit of overkill and it is
> more
> > about the compiler that it is
> > > - // actually processor synchronization. This is
> like
> > the _ReadWriteBarrier
> > > - // Microsoft specific intrinsic
> > > - __asm__ __volatile__ ("":::"memory");
> > > -}
> > > -
> > > -
> > > /**
> > > Enables CPU interrupts.
> > >
> > > @@ -63,44 +42,6 @@ DisableInterrupts (
> > > __asm__ __volatile__ ("cli"::: "memory");
> > > }
> > >
> > > -
> > > -
> > > -
> > > -/**
> > > - Requests CPU to pause for a short period of time.
> > > -
> > > - Requests CPU to pause for a short period of time.
> > Typically used in MP
> > > - systems to prevent memory starvation while
> waiting
> > for a spin lock.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -CpuPause (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("pause");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Generates a breakpoint on the CPU.
> > > -
> > > - Generates a breakpoint on the CPU. The breakpoint
> > must be implemented such
> > > - that code can resume normal execution after the
> > breakpoint.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -CpuBreakpoint (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("int $3");
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Returns a 64-bit Machine Specific Register(MSR).
> > >
> > > @@ -166,37 +107,6 @@ AsmWriteMsr64 (
> > > return Value;
> > > }
> > >
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the EFLAGS register.
> > > -
> > > - Reads and returns the current value of the EFLAGS
> > register. This function is
> > > - only available on IA-32 and X64. This returns a
> 32-
> > bit value on IA-32 and a
> > > - 64-bit value on X64.
> > > -
> > > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadEflags (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Eflags;
> > > -
> > > - __asm__ __volatile__ (
> > > - "pushfl \n\t"
> > > - "popl %0 "
> > > - : "=r" (Eflags)
> > > - );
> > > -
> > > - return Eflags;
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Reads the current value of the Control Register 0
> > (CR0).
> > >
> > > @@ -1153,505 +1063,6 @@ AsmWriteLdtr (
> > > );
> > > }
> > >
> > > -
> > > -/**
> > > - Save the current floating point/SSE/SSE2 context
> to
> > a buffer.
> > > -
> > > - Saves the current floating point/SSE/SSE2 state
> to
> > the buffer specified by
> > > - Buffer. Buffer must be aligned on a 16-byte
> > boundary. This function is only
> > > - available on IA-32 and X64.
> > > -
> > > - @param Buffer The pointer to a buffer to save
> the
> > floating point/SSE/SSE2 context.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86FxSave (
> > > - OUT IA32_FX_BUFFER *Buffer
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "fxsave %0"
> > > - :
> > > - : "m" (*Buffer) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Restores the current floating point/SSE/SSE2
> > context from a buffer.
> > > -
> > > - Restores the current floating point/SSE/SSE2
> state
> > from the buffer specified
> > > - by Buffer. Buffer must be aligned on a 16-byte
> > boundary. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Buffer The pointer to a buffer to save
> the
> > floating point/SSE/SSE2 context.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86FxRestore (
> > > - IN CONST IA32_FX_BUFFER *Buffer
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "fxrstor %0"
> > > - :
> > > - : "m" (*Buffer) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #0
> > (MM0).
> > > -
> > > - Reads and returns the current value of MM0. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM0.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm0, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #1
> > (MM1).
> > > -
> > > - Reads and returns the current value of MM1. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM1.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm1 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm1, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #2
> > (MM2).
> > > -
> > > - Reads and returns the current value of MM2. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM2.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm2, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #3
> > (MM3).
> > > -
> > > - Reads and returns the current value of MM3. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM3.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm3, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #4
> > (MM4).
> > > -
> > > - Reads and returns the current value of MM4. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM4.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm4, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #5
> > (MM5).
> > > -
> > > - Reads and returns the current value of MM5. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM5.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm5 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm5, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #6
> > (MM6).
> > > -
> > > - Reads and returns the current value of MM6. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM6.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm6 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm6, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #7
> > (MM7).
> > > -
> > > - Reads and returns the current value of MM7. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM7.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm7 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "push %%eax \n\t"
> > > - "push %%eax \n\t"
> > > - "movq %%mm7, (%%esp)\n\t"
> > > - "pop %%eax \n\t"
> > > - "pop %%edx \n\t"
> > > - : "=A" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #0
> > (MM0).
> > > -
> > > - Writes the current value of MM0. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM0.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm0 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm0" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #1
> > (MM1).
> > > -
> > > - Writes the current value of MM1. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM1.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm1 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm1" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #2
> > (MM2).
> > > -
> > > - Writes the current value of MM2. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM2.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm2 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm2" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #3
> > (MM3).
> > > -
> > > - Writes the current value of MM3. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM3.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm3 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm3" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #4
> > (MM4).
> > > -
> > > - Writes the current value of MM4. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM4.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm4 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm4" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #5
> > (MM5).
> > > -
> > > - Writes the current value of MM5. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM5.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm5 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm5" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #6
> > (MM6).
> > > -
> > > - Writes the current value of MM6. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM6.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm6 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm6" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #7
> > (MM7).
> > > -
> > > - Writes the current value of MM7. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM7.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm7 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movq %0, %%mm7" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Time Stamp Counter
> > (TSC).
> > > -
> > > - Reads and returns the current value of TSC. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of TSC
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadTsc (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdtsc"
> > > - : "=A" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > /**
> > > Reads the current value of a Performance Counter
> > (PMC).
> > >
> > > @@ -1680,9 +1091,6 @@ AsmReadPmc (
> > > return Data;
> > > }
> > >
> > > -
> > > -
> > > -
> > > /**
> > > Executes a WBINVD instruction.
> > >
> > > @@ -1699,7 +1107,6 @@ AsmWbinvd (
> > > __asm__ __volatile__ ("wbinvd":::"memory");
> > > }
> > >
> > > -
> > > /**
> > > Executes a INVD instruction.
> > >
> > > @@ -1761,5 +1168,3 @@ AsmFlushCacheLine (
> > >
> > > return LinearAddress;
> > > }
> > > -
> > > -
> > > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> > b/MdePkg/Library/BaseLib/X64/GccInline.c
> > > index 154ce1f57e..40a208f198 100644
> > > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > > +++ b/MdePkg/Library/BaseLib/X64/GccInline.c
> > > @@ -1,7 +1,7 @@
> > > /** @file
> > > GCC inline implementation of BaseLib processor
> > specific functions.
> > >
> > > - Copyright (c) 2006 - 2018, Intel Corporation. All
> > rights reserved.<BR>
> > > + Copyright (c) 2006 - 2020, Intel Corporation. All
> > rights reserved.<BR>
> > > Portions copyright (c) 2008 - 2009, Apple Inc.
> All
> > rights reserved.<BR>
> > > SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > > @@ -33,40 +33,6 @@ MemoryFence (
> > > }
> > >
> > >
> > > -/**
> > > - Enables CPU interrupts.
> > > -
> > > - Enables CPU interrupts.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -EnableInterrupts (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("sti"::: "memory");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Disables CPU interrupts.
> > > -
> > > - Disables CPU interrupts.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -DisableInterrupts (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("cli"::: "memory");
> > > -}
> > > -
> > > -
> > > -
> > > -
> > > /**
> > > Requests CPU to pause for a short period of time.
> > >
> > > @@ -101,83 +67,6 @@ CpuBreakpoint (
> > > }
> > >
> > >
> > > -
> > > -/**
> > > - Returns a 64-bit Machine Specific Register(MSR).
> > > -
> > > - Reads and returns the 64-bit MSR specified by
> > Index. No parameter checking is
> > > - performed on Index, and some Index values may
> cause
> > CPU exceptions. The
> > > - caller must either guarantee that Index is valid,
> > or the caller must set up
> > > - exception handlers to catch the exceptions. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @param Index The 32-bit MSR index to read.
> > > -
> > > - @return The value of the MSR identified by Index.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMsr64 (
> > > - IN UINT32 Index
> > > - )
> > > -{
> > > - UINT32 LowData;
> > > - UINT32 HighData;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdmsr"
> > > - : "=a" (LowData), // %0
> > > - "=d" (HighData) // %1
> > > - : "c" (Index) // %2
> > > - );
> > > -
> > > - return (((UINT64)HighData) << 32) | LowData;
> > > -}
> > > -
> > > -/**
> > > - Writes a 64-bit value to a Machine Specific
> > Register(MSR), and returns the
> > > - value.
> > > -
> > > - Writes the 64-bit value specified by Value to the
> > MSR specified by Index. The
> > > - 64-bit value written to the MSR is returned. No
> > parameter checking is
> > > - performed on Index or Value, and some of these
> may
> > cause CPU exceptions. The
> > > - caller must either guarantee that Index and Value
> > are valid, or the caller
> > > - must establish proper exception handlers. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @param Index The 32-bit MSR index to write.
> > > - @param Value The 64-bit value to write to the
> MSR.
> > > -
> > > - @return Value
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmWriteMsr64 (
> > > - IN UINT32 Index,
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - UINT32 LowData;
> > > - UINT32 HighData;
> > > -
> > > - LowData = (UINT32)(Value);
> > > - HighData = (UINT32)(Value >> 32);
> > > -
> > > - __asm__ __volatile__ (
> > > - "wrmsr"
> > > - :
> > > - : "c" (Index),
> > > - "a" (LowData),
> > > - "d" (HighData)
> > > - );
> > > -
> > > - return Value;
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Reads the current value of the EFLAGS register.
> > >
> > > @@ -205,965 +94,6 @@ AsmReadEflags (
> > > return Eflags;
> > > }
> > >
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 0
> > (CR0).
> > > -
> > > - Reads and returns the current value of CR0. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 0
> (CR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cr0,%0"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 2
> > (CR2).
> > > -
> > > - Reads and returns the current value of CR2. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 2
> (CR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cr2, %0"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 3
> > (CR3).
> > > -
> > > - Reads and returns the current value of CR3. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 3
> (CR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cr3, %0"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the Control Register 4
> > (CR4).
> > > -
> > > - Reads and returns the current value of CR4. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of the Control Register 4
> (CR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadCr4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cr4, %0"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 0 (CR0).
> > > -
> > > - Writes and returns a new value to CR0. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr0 The value to write to CR0.
> > > -
> > > - @return The value written to CR0.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr0 (
> > > - UINTN Cr0
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%cr0"
> > > - :
> > > - : "r" (Cr0)
> > > - );
> > > - return Cr0;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 2 (CR2).
> > > -
> > > - Writes and returns a new value to CR2. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr2 The value to write to CR2.
> > > -
> > > - @return The value written to CR2.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr2 (
> > > - UINTN Cr2
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%cr2"
> > > - :
> > > - : "r" (Cr2)
> > > - );
> > > - return Cr2;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 3 (CR3).
> > > -
> > > - Writes and returns a new value to CR3. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr3 The value to write to CR3.
> > > -
> > > - @return The value written to CR3.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr3 (
> > > - UINTN Cr3
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%cr3"
> > > - :
> > > - : "r" (Cr3)
> > > - );
> > > - return Cr3;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Control Register 4 (CR4).
> > > -
> > > - Writes and returns a new value to CR4. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Cr4 The value to write to CR4.
> > > -
> > > - @return The value written to CR4.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteCr4 (
> > > - UINTN Cr4
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%cr4"
> > > - :
> > > - : "r" (Cr4)
> > > - );
> > > - return Cr4;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 0
> (DR0).
> > > -
> > > - Reads and returns the current value of DR0. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 0 (DR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr0, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 1
> (DR1).
> > > -
> > > - Reads and returns the current value of DR1. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 1 (DR1).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr1 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr1, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 2
> (DR2).
> > > -
> > > - Reads and returns the current value of DR2. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 2 (DR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr2, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 3
> (DR3).
> > > -
> > > - Reads and returns the current value of DR3. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 3 (DR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr3, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 4
> (DR4).
> > > -
> > > - Reads and returns the current value of DR4. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 4 (DR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr4, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 5
> (DR5).
> > > -
> > > - Reads and returns the current value of DR5. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 5 (DR5).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr5 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr5, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 6
> (DR6).
> > > -
> > > - Reads and returns the current value of DR6. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 6 (DR6).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr6 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr6, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Debug Register 7
> (DR7).
> > > -
> > > - Reads and returns the current value of DR7. This
> > function is only available
> > > - on IA-32 and X64. This returns a 32-bit value on
> > IA-32 and a 64-bit value on
> > > - X64.
> > > -
> > > - @return The value of Debug Register 7 (DR7).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadDr7 (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%dr7, %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 0 (DR0).
> > > -
> > > - Writes and returns a new value to DR0. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr0 The value to write to Dr0.
> > > -
> > > - @return The value written to Debug Register 0
> > (DR0).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr0 (
> > > - UINTN Dr0
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr0"
> > > - :
> > > - : "r" (Dr0)
> > > - );
> > > - return Dr0;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 1 (DR1).
> > > -
> > > - Writes and returns a new value to DR1. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr1 The value to write to Dr1.
> > > -
> > > - @return The value written to Debug Register 1
> > (DR1).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr1 (
> > > - UINTN Dr1
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr1"
> > > - :
> > > - : "r" (Dr1)
> > > - );
> > > - return Dr1;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 2 (DR2).
> > > -
> > > - Writes and returns a new value to DR2. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr2 The value to write to Dr2.
> > > -
> > > - @return The value written to Debug Register 2
> > (DR2).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr2 (
> > > - UINTN Dr2
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr2"
> > > - :
> > > - : "r" (Dr2)
> > > - );
> > > - return Dr2;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 3 (DR3).
> > > -
> > > - Writes and returns a new value to DR3. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr3 The value to write to Dr3.
> > > -
> > > - @return The value written to Debug Register 3
> > (DR3).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr3 (
> > > - UINTN Dr3
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr3"
> > > - :
> > > - : "r" (Dr3)
> > > - );
> > > - return Dr3;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 4 (DR4).
> > > -
> > > - Writes and returns a new value to DR4. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr4 The value to write to Dr4.
> > > -
> > > - @return The value written to Debug Register 4
> > (DR4).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr4 (
> > > - UINTN Dr4
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr4"
> > > - :
> > > - : "r" (Dr4)
> > > - );
> > > - return Dr4;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 5 (DR5).
> > > -
> > > - Writes and returns a new value to DR5. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr5 The value to write to Dr5.
> > > -
> > > - @return The value written to Debug Register 5
> > (DR5).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr5 (
> > > - UINTN Dr5
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr5"
> > > - :
> > > - : "r" (Dr5)
> > > - );
> > > - return Dr5;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 6 (DR6).
> > > -
> > > - Writes and returns a new value to DR6. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr6 The value to write to Dr6.
> > > -
> > > - @return The value written to Debug Register 6
> > (DR6).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr6 (
> > > - UINTN Dr6
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr6"
> > > - :
> > > - : "r" (Dr6)
> > > - );
> > > - return Dr6;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes a value to Debug Register 7 (DR7).
> > > -
> > > - Writes and returns a new value to DR7. This
> > function is only available on
> > > - IA-32 and X64. This writes a 32-bit value on IA-
> 32
> > and a 64-bit value on X64.
> > > -
> > > - @param Dr7 The value to write to Dr7.
> > > -
> > > - @return The value written to Debug Register 7
> > (DR7).
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmWriteDr7 (
> > > - UINTN Dr7
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mov %0, %%dr7"
> > > - :
> > > - : "r" (Dr7)
> > > - );
> > > - return Dr7;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Code Segment Register
> > (CS).
> > > -
> > > - Reads and returns the current value of CS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of CS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadCs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%cs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Data Segment Register
> > (DS).
> > > -
> > > - Reads and returns the current value of DS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of DS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadDs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%ds, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Extra Segment Register
> > (ES).
> > > -
> > > - Reads and returns the current value of ES. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of ES.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadEs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%es, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of FS Data Segment
> Register
> > (FS).
> > > -
> > > - Reads and returns the current value of FS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of FS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadFs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%fs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of GS Data Segment
> Register
> > (GS).
> > > -
> > > - Reads and returns the current value of GS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of GS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadGs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%gs, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Stack Segment Register
> > (SS).
> > > -
> > > - Reads and returns the current value of SS. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of SS.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadSs (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "mov %%ds, %0"
> > > - :"=a" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Task Register (TR).
> > > -
> > > - Reads and returns the current value of TR. This
> > function is only available on
> > > - IA-32 and X64.
> > > -
> > > - @return The current value of TR.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadTr (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "str %0"
> > > - : "=r" (Data)
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Global Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Reads and returns the current GDTR descriptor and
> > returns it in Gdtr. This
> > > - function is only available on IA-32 and X64.
> > > -
> > > - @param Gdtr The pointer to a GDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86ReadGdtr (
> > > - OUT IA32_DESCRIPTOR *Gdtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "sgdt %0"
> > > - : "=m" (*Gdtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Global Descriptor Table
> Register
> > (GDTR) descriptor.
> > > -
> > > - Writes and the current GDTR descriptor specified
> by
> > Gdtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Gdtr The pointer to a GDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86WriteGdtr (
> > > - IN CONST IA32_DESCRIPTOR *Gdtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lgdt %0"
> > > - :
> > > - : "m" (*Gdtr)
> > > - );
> > > -
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Interrupt Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Reads and returns the current IDTR descriptor and
> > returns it in Idtr. This
> > > - function is only available on IA-32 and X64.
> > > -
> > > - @param Idtr The pointer to a IDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86ReadIdtr (
> > > - OUT IA32_DESCRIPTOR *Idtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "sidt %0"
> > > - : "=m" (*Idtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Interrupt Descriptor Table
> > Register(GDTR) descriptor.
> > > -
> > > - Writes the current IDTR descriptor and returns it
> > in Idtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Idtr The pointer to a IDTR descriptor.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86WriteIdtr (
> > > - IN CONST IA32_DESCRIPTOR *Idtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lidt %0"
> > > - :
> > > - : "m" (*Idtr)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current Local Descriptor Table
> > Register(LDTR) selector.
> > > -
> > > - Reads and returns the current 16-bit LDTR
> > descriptor value. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @return The current selector of LDT.
> > > -
> > > -**/
> > > -UINT16
> > > -EFIAPI
> > > -AsmReadLdtr (
> > > - VOID
> > > - )
> > > -{
> > > - UINT16 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "sldt %0"
> > > - : "=g" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current Local Descriptor Table
> Register
> > (GDTR) selector.
> > > -
> > > - Writes and the current LDTR descriptor specified
> by
> > Ldtr. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Ldtr 16-bit LDTR selector value.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteLdtr (
> > > - IN UINT16 Ldtr
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "lldtw %0"
> > > - :
> > > - : "g" (Ldtr) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > /**
> > > Save the current floating point/SSE/SSE2 context
> to
> > a buffer.
> > >
> > > @@ -1630,171 +560,3 @@ AsmReadTsc (
> > >
> > > return (((UINT64)HiData) << 32) | LowData;
> > > }
> > > -
> > > -
> > > -/**
> > > - Reads the current value of a Performance Counter
> > (PMC).
> > > -
> > > - Reads and returns the current value of
> performance
> > counter specified by
> > > - Index. This function is only available on IA-32
> and
> > X64.
> > > -
> > > - @param Index The 32-bit Performance Counter
> index
> > to read.
> > > -
> > > - @return The value of the PMC specified by Index.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadPmc (
> > > - IN UINT32 Index
> > > - )
> > > -{
> > > - UINT32 LowData;
> > > - UINT32 HiData;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdpmc"
> > > - : "=a" (LowData),
> > > - "=d" (HiData)
> > > - : "c" (Index)
> > > - );
> > > -
> > > - return (((UINT64)HiData) << 32) | LowData;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Sets up a monitor buffer that is used by
> > AsmMwait().
> > > -
> > > - Executes a MONITOR instruction with the register
> > state specified by Eax, Ecx
> > > - and Edx. Returns Eax. This function is only
> > available on IA-32 and X64.
> > > -
> > > - @param Eax The value to load into EAX or RAX
> > before executing the MONITOR
> > > - instruction.
> > > - @param Ecx The value to load into ECX or RCX
> > before executing the MONITOR
> > > - instruction.
> > > - @param Edx The value to load into EDX or RDX
> > before executing the MONITOR
> > > - instruction.
> > > -
> > > - @return Eax
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmMonitor (
> > > - IN UINTN Eax,
> > > - IN UINTN Ecx,
> > > - IN UINTN Edx
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "monitor"
> > > - :
> > > - : "a" (Eax),
> > > - "c" (Ecx),
> > > - "d" (Edx)
> > > - );
> > > -
> > > - return Eax;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Executes an MWAIT instruction.
> > > -
> > > - Executes an MWAIT instruction with the register
> > state specified by Eax and
> > > - Ecx. Returns Eax. This function is only available
> > on IA-32 and X64.
> > > -
> > > - @param Eax The value to load into EAX or RAX
> > before executing the MONITOR
> > > - instruction.
> > > - @param Ecx The value to load into ECX or RCX
> > before executing the MONITOR
> > > - instruction.
> > > -
> > > - @return Eax
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmMwait (
> > > - IN UINTN Eax,
> > > - IN UINTN Ecx
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "mwait"
> > > - :
> > > - : "a" (Eax),
> > > - "c" (Ecx)
> > > - );
> > > -
> > > - return Eax;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Executes a WBINVD instruction.
> > > -
> > > - Executes a WBINVD instruction. This function is
> > only available on IA-32 and
> > > - X64.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWbinvd (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("wbinvd":::"memory");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Executes a INVD instruction.
> > > -
> > > - Executes a INVD instruction. This function is
> only
> > available on IA-32 and
> > > - X64.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmInvd (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("invd":::"memory");
> > > -
> > > -}
> > > -
> > > -
> > > -/**
> > > - Flushes a cache line from all the instruction and
> > data caches within the
> > > - coherency domain of the CPU.
> > > -
> > > - Flushed the cache line specified by
> LinearAddress,
> > and returns LinearAddress.
> > > - This function is only available on IA-32 and X64.
> > > -
> > > - @param LinearAddress The address of the cache
> line
> > to flush. If the CPU is
> > > - in a physical addressing
> > mode, then LinearAddress is a
> > > - physical address. If the
> CPU
> > is in a virtual
> > > - addressing mode, then
> > LinearAddress is a virtual
> > > - address.
> > > -
> > > - @return LinearAddress
> > > -**/
> > > -VOID *
> > > -EFIAPI
> > > -AsmFlushCacheLine (
> > > - IN VOID *LinearAddress
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "clflush (%0)"
> > > - :
> > > - : "r" (LinearAddress)
> > > - : "memory"
> > > - );
> > > -
> > > - return LinearAddress;
> > > -}
> > > -
> > > -
> > > diff --git a/MdePkg/Library/BaseLib/X64/GccInline.c
> > b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > > similarity index 65%
> > > copy from MdePkg/Library/BaseLib/X64/GccInline.c
> > > copy to MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > > index 154ce1f57e..98be19b3c7 100644
> > > --- a/MdePkg/Library/BaseLib/X64/GccInline.c
> > > +++ b/MdePkg/Library/BaseLib/X64/GccInlinePriv.c
> > > @@ -1,7 +1,8 @@
> > > /** @file
> > > - GCC inline implementation of BaseLib processor
> > specific functions.
> > > + GCC inline implementation of BaseLib processor
> > specific functions that use
> > > + privlidged instructions.
> > >
> > > - Copyright (c) 2006 - 2018, Intel Corporation. All
> > rights reserved.<BR>
> > > + Copyright (c) 2006 - 2020, Intel Corporation. All
> > rights reserved.<BR>
> > > Portions copyright (c) 2008 - 2009, Apple Inc.
> All
> > rights reserved.<BR>
> > > SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > > @@ -10,29 +11,6 @@
> > >
> > > #include "BaseLibInternals.h"
> > >
> > > -
> > > -
> > > -
> > > -/**
> > > - Used to serialize load and store operations.
> > > -
> > > - All loads and stores that proceed calls to this
> > function are guaranteed to be
> > > - globally visible when this function returns.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -MemoryFence (
> > > - VOID
> > > - )
> > > -{
> > > - // This is a little bit of overkill and it is
> more
> > about the compiler that it is
> > > - // actually processor synchronization. This is
> like
> > the _ReadWriteBarrier
> > > - // Microsoft specific intrinsic
> > > - __asm__ __volatile__ ("":::"memory");
> > > -}
> > > -
> > > -
> > > /**
> > > Enables CPU interrupts.
> > >
> > > @@ -64,44 +42,6 @@ DisableInterrupts (
> > > __asm__ __volatile__ ("cli"::: "memory");
> > > }
> > >
> > > -
> > > -
> > > -
> > > -/**
> > > - Requests CPU to pause for a short period of time.
> > > -
> > > - Requests CPU to pause for a short period of time.
> > Typically used in MP
> > > - systems to prevent memory starvation while
> waiting
> > for a spin lock.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -CpuPause (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("pause");
> > > -}
> > > -
> > > -
> > > -/**
> > > - Generates a breakpoint on the CPU.
> > > -
> > > - Generates a breakpoint on the CPU. The breakpoint
> > must be implemented such
> > > - that code can resume normal execution after the
> > breakpoint.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -CpuBreakpoint (
> > > - VOID
> > > - )
> > > -{
> > > - __asm__ __volatile__ ("int $3");
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Returns a 64-bit Machine Specific Register(MSR).
> > >
> > > @@ -176,37 +116,6 @@ AsmWriteMsr64 (
> > > return Value;
> > > }
> > >
> > > -
> > > -
> > > -/**
> > > - Reads the current value of the EFLAGS register.
> > > -
> > > - Reads and returns the current value of the EFLAGS
> > register. This function is
> > > - only available on IA-32 and X64. This returns a
> 32-
> > bit value on IA-32 and a
> > > - 64-bit value on X64.
> > > -
> > > - @return EFLAGS on IA-32 or RFLAGS on X64.
> > > -
> > > -**/
> > > -UINTN
> > > -EFIAPI
> > > -AsmReadEflags (
> > > - VOID
> > > - )
> > > -{
> > > - UINTN Eflags;
> > > -
> > > - __asm__ __volatile__ (
> > > - "pushfq \n\t"
> > > - "pop %0 "
> > > - : "=r" (Eflags) // %0
> > > - );
> > > -
> > > - return Eflags;
> > > -}
> > > -
> > > -
> > > -
> > > /**
> > > Reads the current value of the Control Register 0
> > (CR0).
> > >
> > > @@ -1163,475 +1072,6 @@ AsmWriteLdtr (
> > > );
> > > }
> > >
> > > -
> > > -/**
> > > - Save the current floating point/SSE/SSE2 context
> to
> > a buffer.
> > > -
> > > - Saves the current floating point/SSE/SSE2 state
> to
> > the buffer specified by
> > > - Buffer. Buffer must be aligned on a 16-byte
> > boundary. This function is only
> > > - available on IA-32 and X64.
> > > -
> > > - @param Buffer The pointer to a buffer to save
> the
> > floating point/SSE/SSE2 context.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86FxSave (
> > > - OUT IA32_FX_BUFFER *Buffer
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "fxsave %0"
> > > - :
> > > - : "m" (*Buffer) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Restores the current floating point/SSE/SSE2
> > context from a buffer.
> > > -
> > > - Restores the current floating point/SSE/SSE2
> state
> > from the buffer specified
> > > - by Buffer. Buffer must be aligned on a 16-byte
> > boundary. This function is
> > > - only available on IA-32 and X64.
> > > -
> > > - @param Buffer The pointer to a buffer to save
> the
> > floating point/SSE/SSE2 context.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -InternalX86FxRestore (
> > > - IN CONST IA32_FX_BUFFER *Buffer
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "fxrstor %0"
> > > - :
> > > - : "m" (*Buffer) // %0
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #0
> > (MM0).
> > > -
> > > - Reads and returns the current value of MM0. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM0.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm0 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm0, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #1
> > (MM1).
> > > -
> > > - Reads and returns the current value of MM1. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM1.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm1 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm1, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #2
> > (MM2).
> > > -
> > > - Reads and returns the current value of MM2. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM2.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm2 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm2, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #3
> > (MM3).
> > > -
> > > - Reads and returns the current value of MM3. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM3.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm3 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm3, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #4
> > (MM4).
> > > -
> > > - Reads and returns the current value of MM4. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM4.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm4 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm4, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #5
> > (MM5).
> > > -
> > > - Reads and returns the current value of MM5. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM5.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm5 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm5, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #6
> > (MM6).
> > > -
> > > - Reads and returns the current value of MM6. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM6.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm6 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm6, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of 64-bit MMX Register #7
> > (MM7).
> > > -
> > > - Reads and returns the current value of MM7. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of MM7.
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadMm7 (
> > > - VOID
> > > - )
> > > -{
> > > - UINT64 Data;
> > > -
> > > - __asm__ __volatile__ (
> > > - "movd %%mm7, %0 \n\t"
> > > - : "=r" (Data) // %0
> > > - );
> > > -
> > > - return Data;
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #0
> > (MM0).
> > > -
> > > - Writes the current value of MM0. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM0.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm0 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm0" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #1
> > (MM1).
> > > -
> > > - Writes the current value of MM1. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM1.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm1 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm1" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #2
> > (MM2).
> > > -
> > > - Writes the current value of MM2. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM2.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm2 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm2" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #3
> > (MM3).
> > > -
> > > - Writes the current value of MM3. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM3.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm3 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm3" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #4
> > (MM4).
> > > -
> > > - Writes the current value of MM4. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM4.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm4 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm4" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #5
> > (MM5).
> > > -
> > > - Writes the current value of MM5. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM5.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm5 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm5" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #6
> > (MM6).
> > > -
> > > - Writes the current value of MM6. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM6.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm6 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm6" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Writes the current value of 64-bit MMX Register
> #7
> > (MM7).
> > > -
> > > - Writes the current value of MM7. This function is
> > only available on IA32 and
> > > - X64.
> > > -
> > > - @param Value The 64-bit value to write to MM7.
> > > -
> > > -**/
> > > -VOID
> > > -EFIAPI
> > > -AsmWriteMm7 (
> > > - IN UINT64 Value
> > > - )
> > > -{
> > > - __asm__ __volatile__ (
> > > - "movd %0, %%mm7" // %0
> > > - :
> > > - : "m" (Value)
> > > - );
> > > -}
> > > -
> > > -
> > > -/**
> > > - Reads the current value of Time Stamp Counter
> > (TSC).
> > > -
> > > - Reads and returns the current value of TSC. This
> > function is only available
> > > - on IA-32 and X64.
> > > -
> > > - @return The current value of TSC
> > > -
> > > -**/
> > > -UINT64
> > > -EFIAPI
> > > -AsmReadTsc (
> > > - VOID
> > > - )
> > > -{
> > > - UINT32 LowData;
> > > - UINT32 HiData;
> > > -
> > > - __asm__ __volatile__ (
> > > - "rdtsc"
> > > - : "=a" (LowData),
> > > - "=d" (HiData)
> > > - );
> > > -
> > > - return (((UINT64)HiData) << 32) | LowData;
> > > -}
> > > -
> > > -
> > > /**
> > > Reads the current value of a Performance Counter
> > (PMC).
> > >
> > > @@ -1662,7 +1102,6 @@ AsmReadPmc (
> > > return (((UINT64)HiData) << 32) | LowData;
> > > }
> > >
> > > -
> > > /**
> > > Sets up a monitor buffer that is used by
> > AsmMwait().
> > >
> > > @@ -1698,7 +1137,6 @@ AsmMonitor (
> > > return Eax;
> > > }
> > >
> > > -
> > > /**
> > > Executes an MWAIT instruction.
> > >
> > > @@ -1730,7 +1168,6 @@ AsmMwait (
> > > return Eax;
> > > }
> > >
> > > -
> > > /**
> > > Executes a WBINVD instruction.
> > >
> > > @@ -1747,7 +1184,6 @@ AsmWbinvd (
> > > __asm__ __volatile__ ("wbinvd":::"memory");
> > > }
> > >
> > > -
> > > /**
> > > Executes a INVD instruction.
> > >
> > > @@ -1796,5 +1232,3 @@ AsmFlushCacheLine (
> > >
> > > return LinearAddress;
> > > }
> > > -
> > > -
> > > --
> > > 2.21.0.windows.1
^ permalink raw reply [flat|nested] 23+ messages in thread
* [Patch 05/15] MdePkg/Library/BaseLib: Add BaseLib instance for host based unit tests
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (3 preceding siblings ...)
2020-06-15 0:19 ` [Patch 04/15] MdePkg/BaseLib: Break out IA32/X64 GCC inline privileged functions Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 06/15] UnitTestFrameworkPkg: Use host libraries from MdePkg Michael D Kinney
` (9 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2800
Add a new version of BaseLib that is safe for use from host based
unit test applications. Host based unit test applications may need
to provide implementations of some BaseLib functions that provide
simple emulation to exercise the code under test. The structure
UNIT_TEST_HOST_BASE_LIB is filled in with services that provide
default emulation for BaseLib APIs that would normally generate
exceptions in a host based unit test application. This structure
allows an individual unit test to replace the default emulation of
a BaseLib service with an alternate version that is required by a
specific unit test.
Normally cmocka would be used to mock services the code under
test calls. However, the BaseLib is used by the Unit Test
Framework itself, so using a mocked interface is not possible.
The use of a structure to provide hooks for unit test is not
expected to be a common feature. It should only be required
for libraries that are used by both the Unit Test Framework and
the code under test where the code under test requires a
different behavior than the Unit Test Framework.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
MdePkg/Library/BaseLib/UnitTestHost.c | 140 +
MdePkg/Library/BaseLib/UnitTestHost.h | 61 +
.../Library/BaseLib/UnitTestHostBaseLib.inf | 216 ++
.../Library/BaseLib/UnitTestHostBaseLib.uni | 11 +
MdePkg/Library/BaseLib/X86UnitTestHost.c | 2969 +++++++++++++++++
MdePkg/MdePkg.dec | 3 +-
MdePkg/MdePkg.dsc | 1 +
.../Include/HostTest/UnitTestHostBaseLib.h | 585 ++++
8 files changed, 3985 insertions(+), 1 deletion(-)
create mode 100644 MdePkg/Library/BaseLib/UnitTestHost.c
create mode 100644 MdePkg/Library/BaseLib/UnitTestHost.h
create mode 100644 MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf
create mode 100644 MdePkg/Library/BaseLib/UnitTestHostBaseLib.uni
create mode 100644 MdePkg/Library/BaseLib/X86UnitTestHost.c
create mode 100644 MdePkg/Test/UnitTest/Include/HostTest/UnitTestHostBaseLib.h
diff --git a/MdePkg/Library/BaseLib/UnitTestHost.c b/MdePkg/Library/BaseLib/UnitTestHost.c
new file mode 100644
index 0000000000..121316105e
--- /dev/null
+++ b/MdePkg/Library/BaseLib/UnitTestHost.c
@@ -0,0 +1,140 @@
+/** @file
+ Unit Test Host functions.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "UnitTestHost.h"
+
+///
+/// Module global variable for simple system emulation of interrupt state
+///
+STATIC BOOLEAN mUnitTestHostBaseLibInterruptState;
+
+/**
+ Enables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibEnableInterrupts (
+ VOID
+ )
+{
+ mUnitTestHostBaseLibInterruptState = TRUE;
+}
+
+/**
+ Disables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibDisableInterrupts (
+ VOID
+ )
+{
+ mUnitTestHostBaseLibInterruptState = FALSE;
+}
+
+/**
+ Enables CPU interrupts for the smallest window required to capture any
+ pending interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibEnableDisableInterrupts (
+ VOID
+ )
+{
+ mUnitTestHostBaseLibInterruptState = FALSE;
+}
+
+/**
+ Set the current CPU interrupt state.
+
+ Sets the current CPU interrupt state to the state specified by
+ InterruptState. If InterruptState is TRUE, then interrupts are enabled. If
+ InterruptState is FALSE, then interrupts are disabled. InterruptState is
+ returned.
+
+ @param InterruptState TRUE if interrupts should enabled. FALSE if
+ interrupts should be disabled.
+
+ @return InterruptState
+
+**/
+BOOLEAN
+EFIAPI
+UnitTestHostBaseLibGetInterruptState (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibInterruptState;
+}
+
+/**
+ Enables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+EnableInterrupts (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.EnableInterrupts ();
+}
+
+/**
+ Disables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+DisableInterrupts (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.DisableInterrupts ();
+}
+
+/**
+ Enables CPU interrupts for the smallest window required to capture any
+ pending interrupts.
+
+**/
+VOID
+EFIAPI
+EnableDisableInterrupts (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.EnableDisableInterrupts ();
+}
+
+/**
+ Set the current CPU interrupt state.
+
+ Sets the current CPU interrupt state to the state specified by
+ InterruptState. If InterruptState is TRUE, then interrupts are enabled. If
+ InterruptState is FALSE, then interrupts are disabled. InterruptState is
+ returned.
+
+ @param InterruptState TRUE if interrupts should enabled. FALSE if
+ interrupts should be disabled.
+
+ @return InterruptState
+
+**/
+BOOLEAN
+EFIAPI
+GetInterruptState (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.GetInterruptState ();
+}
diff --git a/MdePkg/Library/BaseLib/UnitTestHost.h b/MdePkg/Library/BaseLib/UnitTestHost.h
new file mode 100644
index 0000000000..a42f922988
--- /dev/null
+++ b/MdePkg/Library/BaseLib/UnitTestHost.h
@@ -0,0 +1,61 @@
+/** @file
+ Unit Test Host functions.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "BaseLibInternals.h"
+#include <HostTest/UnitTestHostBaseLib.h>
+
+/**
+ Enables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibEnableInterrupts (
+ VOID
+ );
+
+/**
+ Disables CPU interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibDisableInterrupts (
+ VOID
+ );
+
+/**
+ Enables CPU interrupts for the smallest window required to capture any
+ pending interrupts.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibEnableDisableInterrupts (
+ VOID
+ );
+
+/**
+ Set the current CPU interrupt state.
+
+ Sets the current CPU interrupt state to the state specified by
+ InterruptState. If InterruptState is TRUE, then interrupts are enabled. If
+ InterruptState is FALSE, then interrupts are disabled. InterruptState is
+ returned.
+
+ @param InterruptState TRUE if interrupts should enabled. FALSE if
+ interrupts should be disabled.
+
+ @return InterruptState
+
+**/
+BOOLEAN
+EFIAPI
+UnitTestHostBaseLibGetInterruptState (
+ VOID
+ );
diff --git a/MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf b/MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf
new file mode 100644
index 0000000000..e295a0558b
--- /dev/null
+++ b/MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf
@@ -0,0 +1,216 @@
+## @file
+# Base Library implementation for use with host based unit tests.
+#
+# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
+# Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
+# Portions copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>
+# Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+#
+##
+
+[Defines]
+ INF_VERSION = 0x00010005
+ BASE_NAME = UnitTestHostBaseLib
+ MODULE_UNI_FILE = UnitTestHostBaseLib.uni
+ FILE_GUID = 9555A0D3-09BA-46C4-A51A-45198E3C765E
+ MODULE_TYPE = BASE
+ VERSION_STRING = 1.1
+ LIBRARY_CLASS = BaseLib
+
+#
+# VALID_ARCHITECTURES = IA32 X64 EBC ARM AARCH64 RISCV64
+#
+
+[Sources]
+ CheckSum.c
+ SwitchStack.c
+ SwapBytes64.c
+ SwapBytes32.c
+ SwapBytes16.c
+ LongJump.c
+ SetJump.c
+ RShiftU64.c
+ RRotU64.c
+ RRotU32.c
+ MultU64x64.c
+ MultU64x32.c
+ MultS64x64.c
+ ModU64x32.c
+ LShiftU64.c
+ LRotU64.c
+ LRotU32.c
+ LowBitSet64.c
+ LowBitSet32.c
+ HighBitSet64.c
+ HighBitSet32.c
+ GetPowerOfTwo64.c
+ GetPowerOfTwo32.c
+ DivU64x64Remainder.c
+ DivU64x32Remainder.c
+ DivU64x32.c
+ DivS64x64Remainder.c
+ ARShiftU64.c
+ BitField.c
+ CpuDeadLoop.c
+ Cpu.c
+ LinkedList.c
+ SafeString.c
+ String.c
+ FilePaths.c
+ BaseLibInternals.h
+ UnitTestHost.c
+ UnitTestHost.h
+
+[Sources.Ia32]
+ Ia32/SwapBytes64.c | MSFT
+ Ia32/RRotU64.c | MSFT
+ Ia32/RShiftU64.c | MSFT
+ Ia32/ReadTsc.c | MSFT
+ Ia32/ReadEflags.c | MSFT
+ Ia32/ModU64x32.c | MSFT
+ Ia32/MultU64x64.c | MSFT
+ Ia32/MultU64x32.c | MSFT
+ Ia32/LShiftU64.c | MSFT
+ Ia32/LRotU64.c | MSFT
+ Ia32/FxRestore.c | MSFT
+ Ia32/FxSave.c | MSFT
+ Ia32/DivU64x32Remainder.c | MSFT
+ Ia32/DivU64x32.c | MSFT
+ Ia32/CpuPause.c | MSFT
+ Ia32/CpuBreakpoint.c | MSFT
+ Ia32/ARShiftU64.c | MSFT
+ Ia32/GccInline.c | GCC
+ Ia32/LongJump.nasm
+ Ia32/SetJump.nasm
+ Ia32/SwapBytes64.nasm| GCC
+ Ia32/DivU64x64Remainder.nasm
+ Ia32/DivU64x32Remainder.nasm| GCC
+ Ia32/ModU64x32.nasm| GCC
+ Ia32/DivU64x32.nasm| GCC
+ Ia32/MultU64x64.nasm| GCC
+ Ia32/MultU64x32.nasm| GCC
+ Ia32/RRotU64.nasm| GCC
+ Ia32/LRotU64.nasm| GCC
+ Ia32/ARShiftU64.nasm| GCC
+ Ia32/RShiftU64.nasm| GCC
+ Ia32/LShiftU64.nasm| GCC
+ Ia32/RdRand.nasm
+ Ia32/DivS64x64Remainder.c
+ Ia32/InternalSwitchStack.c | MSFT
+ Ia32/InternalSwitchStack.nasm | GCC
+ Ia32/Non-existing.c
+ Unaligned.c
+ X86FxSave.c
+ X86FxRestore.c
+ X86Msr.c
+ X86RdRand.c
+ X86SpeculationBarrier.c
+ X86UnitTestHost.c
+
+[Sources.X64]
+ X64/LongJump.nasm
+ X64/SetJump.nasm
+ X64/SwitchStack.nasm
+ X64/CpuBreakpoint.c | MSFT
+ X64/CpuPause.nasm| MSFT
+ X64/ReadTsc.nasm| MSFT
+ X64/FxRestore.nasm| MSFT
+ X64/FxSave.nasm| MSFT
+ X64/ReadEflags.nasm| MSFT
+ X64/Non-existing.c
+ Math64.c
+ Unaligned.c
+ X86FxSave.c
+ X86FxRestore.c
+ X86Msr.c
+ X86RdRand.c
+ X86SpeculationBarrier.c
+ X64/GccInline.c | GCC
+ X64/RdRand.nasm
+ ChkStkGcc.c | GCC
+ X86UnitTestHost.c
+
+[Sources.EBC]
+ Ebc/CpuBreakpoint.c
+ Ebc/SetJumpLongJump.c
+ Ebc/SwitchStack.c
+ Ebc/SpeculationBarrier.c
+ Unaligned.c
+ Math64.c
+
+[Sources.ARM]
+ Arm/InternalSwitchStack.c
+ Arm/Unaligned.c
+ Math64.c | RVCT
+ Math64.c | MSFT
+
+ Arm/SwitchStack.asm | RVCT
+ Arm/SetJumpLongJump.asm | RVCT
+ Arm/CpuPause.asm | RVCT
+ Arm/CpuBreakpoint.asm | RVCT
+ Arm/MemoryFence.asm | RVCT
+ Arm/SpeculationBarrier.S | RVCT
+
+ Arm/SwitchStack.asm | MSFT
+ Arm/SetJumpLongJump.asm | MSFT
+ Arm/CpuPause.asm | MSFT
+ Arm/CpuBreakpoint.asm | MSFT
+ Arm/MemoryFence.asm | MSFT
+ Arm/SpeculationBarrier.asm | MSFT
+
+ Arm/Math64.S | GCC
+ Arm/SwitchStack.S | GCC
+ Arm/SetJumpLongJump.S | GCC
+ Arm/CpuBreakpoint.S | GCC
+ Arm/MemoryFence.S | GCC
+ Arm/SpeculationBarrier.S | GCC
+
+[Sources.AARCH64]
+ Arm/InternalSwitchStack.c
+ Arm/Unaligned.c
+ Math64.c
+
+ AArch64/MemoryFence.S | GCC
+ AArch64/SwitchStack.S | GCC
+ AArch64/SetJumpLongJump.S | GCC
+ AArch64/CpuBreakpoint.S | GCC
+ AArch64/SpeculationBarrier.S | GCC
+
+ AArch64/MemoryFence.asm | MSFT
+ AArch64/SwitchStack.asm | MSFT
+ AArch64/SetJumpLongJump.asm | MSFT
+ AArch64/CpuBreakpoint.asm | MSFT
+ AArch64/SpeculationBarrier.asm | MSFT
+
+[Sources.RISCV64]
+ Math64.c
+ Unaligned.c
+ RiscV64/InternalSwitchStack.c
+ RiscV64/CpuBreakpoint.c
+ RiscV64/CpuPause.c
+ RiscV64/RiscVSetJumpLongJump.S | GCC
+ RiscV64/RiscVCpuBreakpoint.S | GCC
+ RiscV64/RiscVCpuPause.S | GCC
+ RiscV64/RiscVInterrupt.S | GCC
+ RiscV64/FlushCache.S | GCC
+
+[Packages]
+ MdePkg/MdePkg.dec
+
+[LibraryClasses]
+ PcdLib
+ DebugLib
+ BaseMemoryLib
+
+[Pcd]
+ gEfiMdePkgTokenSpaceGuid.PcdMaximumLinkedListLength ## SOMETIMES_CONSUMES
+ gEfiMdePkgTokenSpaceGuid.PcdMaximumAsciiStringLength ## SOMETIMES_CONSUMES
+ gEfiMdePkgTokenSpaceGuid.PcdMaximumUnicodeStringLength ## SOMETIMES_CONSUMES
+ gEfiMdePkgTokenSpaceGuid.PcdControlFlowEnforcementPropertyMask ## SOMETIMES_CONSUMES
+ gEfiMdePkgTokenSpaceGuid.PcdSpeculationBarrierType ## SOMETIMES_CONSUMES
+
+[FeaturePcd]
+ gEfiMdePkgTokenSpaceGuid.PcdVerifyNodeInList ## CONSUMES
diff --git a/MdePkg/Library/BaseLib/UnitTestHostBaseLib.uni b/MdePkg/Library/BaseLib/UnitTestHostBaseLib.uni
new file mode 100644
index 0000000000..e63ecef82c
--- /dev/null
+++ b/MdePkg/Library/BaseLib/UnitTestHostBaseLib.uni
@@ -0,0 +1,11 @@
+// /** @file
+// Base Library implementation for use with host based unit tests.
+//
+// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+// SPDX-License-Identifier: BSD-2-Clause-Patent
+//
+// **/
+
+#string STR_MODULE_ABSTRACT #language en-US "Base Library implementation for use with host based unit tests."
+
+#string STR_MODULE_DESCRIPTION #language en-US "Base Library implementation for use with host based unit tests."
diff --git a/MdePkg/Library/BaseLib/X86UnitTestHost.c b/MdePkg/Library/BaseLib/X86UnitTestHost.c
new file mode 100644
index 0000000000..acbd390723
--- /dev/null
+++ b/MdePkg/Library/BaseLib/X86UnitTestHost.c
@@ -0,0 +1,2969 @@
+/** @file
+ IA32/X64 specific Unit Test Host functions.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include "UnitTestHost.h"
+
+///
+/// Defines for mUnitTestHostBaseLibSegment indexes
+///
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_CS 0
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_DS 1
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_ES 2
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_FS 3
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_GS 4
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_SS 5
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR 6
+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR 7
+
+///
+/// Module global variables for simple system emulation of MSRs, CRx, DRx,
+/// GDTR, IDTR, and Segment Selectors.
+///
+STATIC UINT64 mUnitTestHostBaseLibMsr[2][0x1000];
+STATIC UINTN mUnitTestHostBaseLibCr[5];
+STATIC UINTN mUnitTestHostBaseLibDr[8];
+STATIC UINT16 mUnitTestHostBaseLibSegment[8];
+STATIC IA32_DESCRIPTOR mUnitTestHostBaseLibGdtr;
+STATIC IA32_DESCRIPTOR mUnitTestHostBaseLibIdtr;
+
+/**
+ Retrieves CPUID information.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index.
+ This function always returns Index.
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+ This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the CPUID
+ instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+
+ @return Index.
+
+**/
+UINT32
+EFIAPI
+UnitTestHostBaseLibAsmCpuid (
+ IN UINT32 Index,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ )
+{
+ if (Eax != NULL) {
+ *Eax = 0;
+ }
+ if (Ebx != NULL) {
+ *Ebx = 0;
+ }
+ if (Ecx != NULL) {
+ *Ecx = 0;
+ }
+ if (Edx != NULL) {
+ *Edx = 0;
+ }
+ return Index;
+}
+
+/**
+ Retrieves CPUID information using an extended leaf identifier.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index
+ and ECX set to the value specified by SubIndex. This function always returns
+ Index. This function is only available on IA-32 and x64.
+
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the
+ CPUID instruction.
+ @param SubIndex The 32-bit value to load into ECX prior to invoking the
+ CPUID instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+
+ @return Index.
+
+**/
+UINT32
+EFIAPI
+UnitTestHostBaseLibAsmCpuidEx (
+ IN UINT32 Index,
+ IN UINT32 SubIndex,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ )
+{
+ if (Eax != NULL) {
+ *Eax = 0;
+ }
+ if (Ebx != NULL) {
+ *Ebx = 0;
+ }
+ if (Ecx != NULL) {
+ *Ecx = 0;
+ }
+ if (Edx != NULL) {
+ *Edx = 0;
+ }
+ return Index;
+}
+
+/**
+ Set CD bit and clear NW bit of CR0 followed by a WBINVD.
+
+ Disables the caches by setting the CD bit of CR0 to 1, clearing the NW bit of CR0 to 0,
+ and executing a WBINVD instruction. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmDisableCache (
+ VOID
+ )
+{
+}
+
+/**
+ Perform a WBINVD and clear both the CD and NW bits of CR0.
+
+ Enables the caches by executing a WBINVD instruction and then clear both the CD and NW
+ bits of CR0 to 0. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmEnableCache (
+ VOID
+ )
+{
+}
+
+/**
+ Returns a 64-bit Machine Specific Register(MSR).
+
+ Reads and returns the 64-bit MSR specified by Index. No parameter checking is
+ performed on Index, and some Index values may cause CPU exceptions. The
+ caller must either guarantee that Index is valid, or the caller must set up
+ exception handlers to catch the exceptions. This function is only available
+ on IA-32 and x64.
+
+ @param Index The 32-bit MSR index to read.
+
+ @return The value of the MSR identified by Index.
+
+**/
+UINT64
+EFIAPI
+UnitTestHostBaseLibAsmReadMsr64 (
+ IN UINT32 Index
+ )
+{
+ if (Index < 0x1000) {
+ return mUnitTestHostBaseLibMsr[0][Index];
+ }
+ if (Index >= 0xC0000000 && Index < 0xC0001000) {
+ return mUnitTestHostBaseLibMsr[1][Index];
+ }
+ return 0;
+}
+
+/**
+ Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
+ value.
+
+ Writes the 64-bit value specified by Value to the MSR specified by Index. The
+ 64-bit value written to the MSR is returned. No parameter checking is
+ performed on Index or Value, and some of these may cause CPU exceptions. The
+ caller must either guarantee that Index and Value are valid, or the caller
+ must establish proper exception handlers. This function is only available on
+ IA-32 and x64.
+
+ @param Index The 32-bit MSR index to write.
+ @param Value The 64-bit value to write to the MSR.
+
+ @return Value
+
+**/
+UINT64
+EFIAPI
+UnitTestHostBaseLibAsmWriteMsr64 (
+ IN UINT32 Index,
+ IN UINT64 Value
+ )
+{
+ if (Index < 0x1000) {
+ mUnitTestHostBaseLibMsr[0][Index] = Value;
+ }
+ if (Index >= 0xC0000000 && Index < 0xC0001000) {
+ mUnitTestHostBaseLibMsr[1][Index - 0xC00000000] = Value;
+ }
+ return Value;
+}
+
+/**
+ Reads the current value of the Control Register 0 (CR0).
+
+ Reads and returns the current value of CR0. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 0 (CR0).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadCr0 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibCr[0];
+}
+
+/**
+ Reads the current value of the Control Register 2 (CR2).
+
+ Reads and returns the current value of CR2. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 2 (CR2).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadCr2 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibCr[2];
+}
+
+/**
+ Reads the current value of the Control Register 3 (CR3).
+
+ Reads and returns the current value of CR3. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 3 (CR3).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadCr3 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibCr[3];
+}
+
+/**
+ Reads the current value of the Control Register 4 (CR4).
+
+ Reads and returns the current value of CR4. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 4 (CR4).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadCr4 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibCr[4];
+}
+
+/**
+ Writes a value to Control Register 0 (CR0).
+
+ Writes and returns a new value to CR0. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr0 The value to write to CR0.
+
+ @return The value written to CR0.
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteCr0 (
+ UINTN Cr0
+ )
+{
+ mUnitTestHostBaseLibCr[0] = Cr0;
+ return Cr0;
+}
+
+/**
+ Writes a value to Control Register 2 (CR2).
+
+ Writes and returns a new value to CR2. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr2 The value to write to CR2.
+
+ @return The value written to CR2.
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteCr2 (
+ UINTN Cr2
+ )
+{
+ mUnitTestHostBaseLibCr[2] = Cr2;
+ return Cr2;
+}
+
+/**
+ Writes a value to Control Register 3 (CR3).
+
+ Writes and returns a new value to CR3. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr3 The value to write to CR3.
+
+ @return The value written to CR3.
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteCr3 (
+ UINTN Cr3
+ )
+{
+ mUnitTestHostBaseLibCr[3] = Cr3;
+ return Cr3;
+}
+
+/**
+ Writes a value to Control Register 4 (CR4).
+
+ Writes and returns a new value to CR4. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr4 The value to write to CR4.
+
+ @return The value written to CR4.
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteCr4 (
+ UINTN Cr4
+ )
+{
+ mUnitTestHostBaseLibCr[4] = Cr4;
+ return Cr4;
+}
+
+/**
+ Reads the current value of Debug Register 0 (DR0).
+
+ Reads and returns the current value of DR0. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 0 (DR0).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr0 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[0];
+}
+
+/**
+ Reads the current value of Debug Register 1 (DR1).
+
+ Reads and returns the current value of DR1. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 1 (DR1).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr1 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[1];
+}
+
+/**
+ Reads the current value of Debug Register 2 (DR2).
+
+ Reads and returns the current value of DR2. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 2 (DR2).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr2 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[2];
+}
+
+/**
+ Reads the current value of Debug Register 3 (DR3).
+
+ Reads and returns the current value of DR3. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 3 (DR3).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr3 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[3];
+}
+
+/**
+ Reads the current value of Debug Register 4 (DR4).
+
+ Reads and returns the current value of DR4. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 4 (DR4).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr4 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[4];
+}
+
+/**
+ Reads the current value of Debug Register 5 (DR5).
+
+ Reads and returns the current value of DR5. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 5 (DR5).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr5 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[5];
+}
+
+/**
+ Reads the current value of Debug Register 6 (DR6).
+
+ Reads and returns the current value of DR6. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 6 (DR6).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr6 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[6];
+}
+
+/**
+ Reads the current value of Debug Register 7 (DR7).
+
+ Reads and returns the current value of DR7. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 7 (DR7).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmReadDr7 (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibDr[7];
+}
+
+/**
+ Writes a value to Debug Register 0 (DR0).
+
+ Writes and returns a new value to DR0. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr0 The value to write to Dr0.
+
+ @return The value written to Debug Register 0 (DR0).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr0 (
+ UINTN Dr0
+ )
+{
+ mUnitTestHostBaseLibDr[0] = Dr0;
+ return Dr0;
+}
+
+/**
+ Writes a value to Debug Register 1 (DR1).
+
+ Writes and returns a new value to DR1. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr1 The value to write to Dr1.
+
+ @return The value written to Debug Register 1 (DR1).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr1 (
+ UINTN Dr1
+ )
+{
+ mUnitTestHostBaseLibDr[1] = Dr1;
+ return Dr1;
+}
+
+/**
+ Writes a value to Debug Register 2 (DR2).
+
+ Writes and returns a new value to DR2. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr2 The value to write to Dr2.
+
+ @return The value written to Debug Register 2 (DR2).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr2 (
+ UINTN Dr2
+ )
+{
+ mUnitTestHostBaseLibDr[2] = Dr2;
+ return Dr2;
+}
+
+/**
+ Writes a value to Debug Register 3 (DR3).
+
+ Writes and returns a new value to DR3. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr3 The value to write to Dr3.
+
+ @return The value written to Debug Register 3 (DR3).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr3 (
+ UINTN Dr3
+ )
+{
+ mUnitTestHostBaseLibDr[3] = Dr3;
+ return Dr3;
+}
+
+/**
+ Writes a value to Debug Register 4 (DR4).
+
+ Writes and returns a new value to DR4. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr4 The value to write to Dr4.
+
+ @return The value written to Debug Register 4 (DR4).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr4 (
+ UINTN Dr4
+ )
+{
+ mUnitTestHostBaseLibDr[4] = Dr4;
+ return Dr4;
+}
+
+/**
+ Writes a value to Debug Register 5 (DR5).
+
+ Writes and returns a new value to DR5. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr5 The value to write to Dr5.
+
+ @return The value written to Debug Register 5 (DR5).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr5 (
+ UINTN Dr5
+ )
+{
+ mUnitTestHostBaseLibDr[5] = Dr5;
+ return Dr5;
+}
+
+/**
+ Writes a value to Debug Register 6 (DR6).
+
+ Writes and returns a new value to DR6. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr6 The value to write to Dr6.
+
+ @return The value written to Debug Register 6 (DR6).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr6 (
+ UINTN Dr6
+ )
+{
+ mUnitTestHostBaseLibDr[6] = Dr6;
+ return Dr6;
+}
+
+/**
+ Writes a value to Debug Register 7 (DR7).
+
+ Writes and returns a new value to DR7. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr7 The value to write to Dr7.
+
+ @return The value written to Debug Register 7 (DR7).
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmWriteDr7 (
+ UINTN Dr7
+ )
+{
+ mUnitTestHostBaseLibDr[7] = Dr7;
+ return Dr7;
+}
+
+/**
+ Reads the current value of Code Segment Register (CS).
+
+ Reads and returns the current value of CS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of CS.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadCs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_CS];
+}
+
+/**
+ Reads the current value of Data Segment Register (DS).
+
+ Reads and returns the current value of DS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of DS.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadDs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_DS];
+}
+
+/**
+ Reads the current value of Extra Segment Register (ES).
+
+ Reads and returns the current value of ES. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of ES.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadEs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_ES];
+}
+
+/**
+ Reads the current value of FS Data Segment Register (FS).
+
+ Reads and returns the current value of FS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of FS.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadFs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_FS];
+}
+
+/**
+ Reads the current value of GS Data Segment Register (GS).
+
+ Reads and returns the current value of GS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of GS.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadGs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_GS];
+}
+
+/**
+ Reads the current value of Stack Segment Register (SS).
+
+ Reads and returns the current value of SS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of SS.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadSs (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_SS];
+}
+
+/**
+ Reads the current value of Task Register (TR).
+
+ Reads and returns the current value of TR. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of TR.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadTr (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR];
+}
+
+/**
+ Reads the current Global Descriptor Table Register(GDTR) descriptor.
+
+ Reads and returns the current GDTR descriptor and returns it in Gdtr. This
+ function is only available on IA-32 and x64.
+
+ If Gdtr is NULL, then ASSERT().
+
+ @param Gdtr The pointer to a GDTR descriptor.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmReadGdtr (
+ OUT IA32_DESCRIPTOR *Gdtr
+ )
+{
+ Gdtr = &mUnitTestHostBaseLibGdtr;
+}
+
+/**
+ Writes the current Global Descriptor Table Register (GDTR) descriptor.
+
+ Writes and the current GDTR descriptor specified by Gdtr. This function is
+ only available on IA-32 and x64.
+
+ If Gdtr is NULL, then ASSERT().
+
+ @param Gdtr The pointer to a GDTR descriptor.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmWriteGdtr (
+ IN CONST IA32_DESCRIPTOR *Gdtr
+ )
+{
+ CopyMem (&mUnitTestHostBaseLibGdtr, Gdtr, sizeof (IA32_DESCRIPTOR));
+}
+
+/**
+ Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.
+
+ Reads and returns the current IDTR descriptor and returns it in Idtr. This
+ function is only available on IA-32 and x64.
+
+ If Idtr is NULL, then ASSERT().
+
+ @param Idtr The pointer to a IDTR descriptor.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmReadIdtr (
+ OUT IA32_DESCRIPTOR *Idtr
+ )
+{
+ Idtr = &mUnitTestHostBaseLibIdtr;
+}
+
+/**
+ Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.
+
+ Writes the current IDTR descriptor and returns it in Idtr. This function is
+ only available on IA-32 and x64.
+
+ If Idtr is NULL, then ASSERT().
+
+ @param Idtr The pointer to a IDTR descriptor.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmWriteIdtr (
+ IN CONST IA32_DESCRIPTOR *Idtr
+ )
+{
+ CopyMem (&mUnitTestHostBaseLibIdtr, Idtr, sizeof (IA32_DESCRIPTOR));
+}
+
+/**
+ Reads the current Local Descriptor Table Register(LDTR) selector.
+
+ Reads and returns the current 16-bit LDTR descriptor value. This function is
+ only available on IA-32 and x64.
+
+ @return The current selector of LDT.
+
+**/
+UINT16
+EFIAPI
+UnitTestHostBaseLibAsmReadLdtr (
+ VOID
+ )
+{
+ return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR];
+}
+
+/**
+ Writes the current Local Descriptor Table Register (LDTR) selector.
+
+ Writes and the current LDTR descriptor specified by Ldtr. This function is
+ only available on IA-32 and x64.
+
+ @param Ldtr 16-bit LDTR selector value.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmWriteLdtr (
+ IN UINT16 Ldtr
+ )
+{
+ mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR] = Ldtr;
+}
+
+/**
+ Reads the current value of a Performance Counter (PMC).
+
+ Reads and returns the current value of performance counter specified by
+ Index. This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit Performance Counter index to read.
+
+ @return The value of the PMC specified by Index.
+
+**/
+UINT64
+EFIAPI
+UnitTestHostBaseLibAsmReadPmc (
+ IN UINT32 Index
+ )
+{
+ return 0;
+}
+
+/**
+ Sets up a monitor buffer that is used by AsmMwait().
+
+ Executes a MONITOR instruction with the register state specified by Eax, Ecx
+ and Edx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+ @param Edx The value to load into EDX or RDX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmMonitor (
+ IN UINTN Eax,
+ IN UINTN Ecx,
+ IN UINTN Edx
+ )
+{
+ return Eax;
+}
+
+/**
+ Executes an MWAIT instruction.
+
+ Executes an MWAIT instruction with the register state specified by Eax and
+ Ecx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+UINTN
+EFIAPI
+UnitTestHostBaseLibAsmMwait (
+ IN UINTN Eax,
+ IN UINTN Ecx
+ )
+{
+ return Eax;
+}
+
+/**
+ Executes a WBINVD instruction.
+
+ Executes a WBINVD instruction. This function is only available on IA-32 and
+ x64.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmWbinvd (
+ VOID
+ )
+{
+}
+
+/**
+ Executes a INVD instruction.
+
+ Executes a INVD instruction. This function is only available on IA-32 and
+ x64.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmInvd (
+ VOID
+ )
+{
+}
+
+/**
+ Flushes a cache line from all the instruction and data caches within the
+ coherency domain of the CPU.
+
+ Flushed the cache line specified by LinearAddress, and returns LinearAddress.
+ This function is only available on IA-32 and x64.
+
+ @param LinearAddress The address of the cache line to flush. If the CPU is
+ in a physical addressing mode, then LinearAddress is a
+ physical address. If the CPU is in a virtual
+ addressing mode, then LinearAddress is a virtual
+ address.
+
+ @return LinearAddress.
+**/
+VOID *
+EFIAPI
+UnitTestHostBaseLibAsmFlushCacheLine (
+ IN VOID *LinearAddress
+ )
+{
+ return LinearAddress;
+}
+
+/**
+ Enables the 32-bit paging mode on the CPU.
+
+ Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
+ must be properly initialized prior to calling this service. This function
+ assumes the current execution mode is 32-bit protected mode. This function is
+ only available on IA-32. After the 32-bit paging mode is enabled, control is
+ transferred to the function specified by EntryPoint using the new stack
+ specified by NewStack and passing in the parameters specified by Context1 and
+ Context2. Context1 and Context2 are optional and may be NULL. The function
+ EntryPoint must never return.
+
+ If the current execution mode is not 32-bit protected mode, then ASSERT().
+ If EntryPoint is NULL, then ASSERT().
+ If NewStack is NULL, then ASSERT().
+
+ There are a number of constraints that must be followed before calling this
+ function:
+ 1) Interrupts must be disabled.
+ 2) The caller must be in 32-bit protected mode with flat descriptors. This
+ means all descriptors must have a base of 0 and a limit of 4GB.
+ 3) CR0 and CR4 must be compatible with 32-bit protected mode with flat
+ descriptors.
+ 4) CR3 must point to valid page tables that will be used once the transition
+ is complete, and those page tables must guarantee that the pages for this
+ function and the stack are identity mapped.
+
+ @param EntryPoint A pointer to function to call with the new stack after
+ paging is enabled.
+ @param Context1 A pointer to the context to pass into the EntryPoint
+ function as the first parameter after paging is enabled.
+ @param Context2 A pointer to the context to pass into the EntryPoint
+ function as the second parameter after paging is enabled.
+ @param NewStack A pointer to the new stack to use for the EntryPoint
+ function after paging is enabled.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmEnablePaging32 (
+ IN SWITCH_STACK_ENTRY_POINT EntryPoint,
+ IN VOID *Context1, OPTIONAL
+ IN VOID *Context2, OPTIONAL
+ IN VOID *NewStack
+ )
+{
+ EntryPoint (Context1, Context2);
+}
+
+/**
+ Disables the 32-bit paging mode on the CPU.
+
+ Disables the 32-bit paging mode on the CPU and returns to 32-bit protected
+ mode. This function assumes the current execution mode is 32-paged protected
+ mode. This function is only available on IA-32. After the 32-bit paging mode
+ is disabled, control is transferred to the function specified by EntryPoint
+ using the new stack specified by NewStack and passing in the parameters
+ specified by Context1 and Context2. Context1 and Context2 are optional and
+ may be NULL. The function EntryPoint must never return.
+
+ If the current execution mode is not 32-bit paged mode, then ASSERT().
+ If EntryPoint is NULL, then ASSERT().
+ If NewStack is NULL, then ASSERT().
+
+ There are a number of constraints that must be followed before calling this
+ function:
+ 1) Interrupts must be disabled.
+ 2) The caller must be in 32-bit paged mode.
+ 3) CR0, CR3, and CR4 must be compatible with 32-bit paged mode.
+ 4) CR3 must point to valid page tables that guarantee that the pages for
+ this function and the stack are identity mapped.
+
+ @param EntryPoint A pointer to function to call with the new stack after
+ paging is disabled.
+ @param Context1 A pointer to the context to pass into the EntryPoint
+ function as the first parameter after paging is disabled.
+ @param Context2 A pointer to the context to pass into the EntryPoint
+ function as the second parameter after paging is
+ disabled.
+ @param NewStack A pointer to the new stack to use for the EntryPoint
+ function after paging is disabled.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmDisablePaging32 (
+ IN SWITCH_STACK_ENTRY_POINT EntryPoint,
+ IN VOID *Context1, OPTIONAL
+ IN VOID *Context2, OPTIONAL
+ IN VOID *NewStack
+ )
+{
+ EntryPoint (Context1, Context2);
+}
+
+/**
+ Enables the 64-bit paging mode on the CPU.
+
+ Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
+ must be properly initialized prior to calling this service. This function
+ assumes the current execution mode is 32-bit protected mode with flat
+ descriptors. This function is only available on IA-32. After the 64-bit
+ paging mode is enabled, control is transferred to the function specified by
+ EntryPoint using the new stack specified by NewStack and passing in the
+ parameters specified by Context1 and Context2. Context1 and Context2 are
+ optional and may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 32-bit protected mode with flat
+ descriptors, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for long mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is enabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is enabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is enabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is enabled.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmEnablePaging64 (
+ IN UINT16 Cs,
+ IN UINT64 EntryPoint,
+ IN UINT64 Context1, OPTIONAL
+ IN UINT64 Context2, OPTIONAL
+ IN UINT64 NewStack
+ )
+{
+ SWITCH_STACK_ENTRY_POINT NewEntryPoint;
+
+ NewEntryPoint = (SWITCH_STACK_ENTRY_POINT)(UINTN)(EntryPoint);
+ NewEntryPoint ((VOID *)(UINTN)Context1, (VOID *)(UINTN)Context2);
+}
+
+/**
+ Disables the 64-bit paging mode on the CPU.
+
+ Disables the 64-bit paging mode on the CPU and returns to 32-bit protected
+ mode. This function assumes the current execution mode is 64-paging mode.
+ This function is only available on x64. After the 64-bit paging mode is
+ disabled, control is transferred to the function specified by EntryPoint
+ using the new stack specified by NewStack and passing in the parameters
+ specified by Context1 and Context2. Context1 and Context2 are optional and
+ may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 64-bit paged mode, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for 32-bit protected mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is disabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is disabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is disabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is disabled.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmDisablePaging64 (
+ IN UINT16 Cs,
+ IN UINT32 EntryPoint,
+ IN UINT32 Context1, OPTIONAL
+ IN UINT32 Context2, OPTIONAL
+ IN UINT32 NewStack
+ )
+{
+ SWITCH_STACK_ENTRY_POINT NewEntryPoint;
+
+ NewEntryPoint = (SWITCH_STACK_ENTRY_POINT)(UINTN)(EntryPoint);
+ NewEntryPoint ((VOID *)(UINTN)Context1, (VOID *)(UINTN)Context2);
+}
+
+/**
+ Retrieves the properties for 16-bit thunk functions.
+
+ Computes the size of the buffer and stack below 1MB required to use the
+ AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This
+ buffer size is returned in RealModeBufferSize, and the stack size is returned
+ in ExtraStackSize. If parameters are passed to the 16-bit real mode code,
+ then the actual minimum stack size is ExtraStackSize plus the maximum number
+ of bytes that need to be passed to the 16-bit real mode code.
+
+ If RealModeBufferSize is NULL, then ASSERT().
+ If ExtraStackSize is NULL, then ASSERT().
+
+ @param RealModeBufferSize A pointer to the size of the buffer below 1MB
+ required to use the 16-bit thunk functions.
+ @param ExtraStackSize A pointer to the extra size of stack below 1MB
+ that the 16-bit thunk functions require for
+ temporary storage in the transition to and from
+ 16-bit real mode.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmGetThunk16Properties (
+ OUT UINT32 *RealModeBufferSize,
+ OUT UINT32 *ExtraStackSize
+ )
+{
+ *RealModeBufferSize = 0;
+ *ExtraStackSize = 0;
+}
+
+/**
+ Prepares all structures a code required to use AsmThunk16().
+
+ Prepares all structures and code required to use AsmThunk16().
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.
+
+ If ThunkContext is NULL, then ASSERT().
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmPrepareThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+}
+
+/**
+ Transfers control to a 16-bit real mode entry point and returns the results.
+
+ Transfers control to a 16-bit real mode entry point and returns the results.
+ AsmPrepareThunk16() must be called with ThunkContext before this function is used.
+ This function must be called with interrupts disabled.
+
+ The register state from the RealModeState field of ThunkContext is restored just prior
+ to calling the 16-bit real mode entry point. This includes the EFLAGS field of RealModeState,
+ which is used to set the interrupt state when a 16-bit real mode entry point is called.
+ Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.
+ The stack is initialized to the SS and ESP fields of RealModeState. Any parameters passed to
+ the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.
+ The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,
+ so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment
+ and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry
+ point must exit with a RETF instruction. The register state is captured into RealModeState immediately
+ after the RETF instruction is executed.
+
+ If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,
+ or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure
+ the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.
+
+ If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,
+ then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.
+ This includes the base vectors, the interrupt masks, and the edge/level trigger mode.
+
+ If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code
+ is invoked in big real mode. Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.
+
+ If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in
+ ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to
+ disable the A20 mask.
+
+ If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in
+ ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask. If this INT 15 call fails,
+ then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.
+
+ If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in
+ ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.
+
+ If ThunkContext is NULL, then ASSERT().
+ If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().
+ If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in
+ ThunkAttributes, then ASSERT().
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer are mapped 1:1.
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+}
+
+/**
+ Prepares all structures and code for a 16-bit real mode thunk, transfers
+ control to a 16-bit real mode entry point, and returns the results.
+
+ Prepares all structures and code for a 16-bit real mode thunk, transfers
+ control to a 16-bit real mode entry point, and returns the results. If the
+ caller only need to perform a single 16-bit real mode thunk, then this
+ service should be used. If the caller intends to make more than one 16-bit
+ real mode thunk, then it is more efficient if AsmPrepareThunk16() is called
+ once and AsmThunk16() can be called for each 16-bit real mode thunk.
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.
+
+ See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmPrepareAndThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+}
+
+/**
+ Load given selector into TR register.
+
+ @param[in] Selector Task segment selector
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmWriteTr (
+ IN UINT16 Selector
+ )
+{
+ mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR] = Selector;
+}
+
+/**
+ Performs a serializing operation on all load-from-memory instructions that
+ were issued prior the AsmLfence function.
+
+ Executes a LFENCE instruction. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibAsmLfence (
+ VOID
+ )
+{
+}
+
+/**
+ Patch the immediate operand of an IA32 or X64 instruction such that the byte,
+ word, dword or qword operand is encoded at the end of the instruction's
+ binary representation.
+
+ This function should be used to update object code that was compiled with
+ NASM from assembly source code. Example:
+
+ NASM source code:
+
+ mov eax, strict dword 0 ; the imm32 zero operand will be patched
+ ASM_PFX(gPatchCr3):
+ mov cr3, eax
+
+ C source code:
+
+ X86_ASSEMBLY_PATCH_LABEL gPatchCr3;
+ PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);
+
+ @param[out] InstructionEnd Pointer right past the instruction to patch. The
+ immediate operand to patch is expected to
+ comprise the trailing bytes of the instruction.
+ If InstructionEnd is closer to address 0 than
+ ValueSize permits, then ASSERT().
+
+ @param[in] PatchValue The constant to write to the immediate operand.
+ The caller is responsible for ensuring that
+ PatchValue can be represented in the byte, word,
+ dword or qword operand (as indicated through
+ ValueSize); otherwise ASSERT().
+
+ @param[in] ValueSize The size of the operand in bytes; must be 1, 2,
+ 4, or 8. ASSERT() otherwise.
+**/
+VOID
+EFIAPI
+UnitTestHostBaseLibPatchInstructionX86 (
+ OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,
+ IN UINT64 PatchValue,
+ IN UINTN ValueSize
+ )
+{
+}
+
+/**
+ Retrieves CPUID information.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index.
+ This function always returns Index.
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+ This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the CPUID
+ instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+
+ @return Index.
+
+**/
+UINT32
+EFIAPI
+AsmCpuid (
+ IN UINT32 Index,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ )
+{
+ return gUnitTestHostBaseLib.AsmCpuid (Index, Eax, Ebx, Ecx, Edx);
+}
+
+/**
+ Retrieves CPUID information using an extended leaf identifier.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index
+ and ECX set to the value specified by SubIndex. This function always returns
+ Index. This function is only available on IA-32 and x64.
+
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the
+ CPUID instruction.
+ @param SubIndex The 32-bit value to load into ECX prior to invoking the
+ CPUID instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+
+ @return Index.
+
+**/
+UINT32
+EFIAPI
+AsmCpuidEx (
+ IN UINT32 Index,
+ IN UINT32 SubIndex,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ )
+{
+ return gUnitTestHostBaseLib.AsmCpuidEx (Index, SubIndex, Eax, Ebx, Ecx, Edx);
+}
+
+/**
+ Set CD bit and clear NW bit of CR0 followed by a WBINVD.
+
+ Disables the caches by setting the CD bit of CR0 to 1, clearing the NW bit of CR0 to 0,
+ and executing a WBINVD instruction. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+AsmDisableCache (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.AsmDisableCache ();
+}
+
+/**
+ Perform a WBINVD and clear both the CD and NW bits of CR0.
+
+ Enables the caches by executing a WBINVD instruction and then clear both the CD and NW
+ bits of CR0 to 0. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+AsmEnableCache (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.AsmEnableCache ();
+}
+
+/**
+ Returns a 64-bit Machine Specific Register(MSR).
+
+ Reads and returns the 64-bit MSR specified by Index. No parameter checking is
+ performed on Index, and some Index values may cause CPU exceptions. The
+ caller must either guarantee that Index is valid, or the caller must set up
+ exception handlers to catch the exceptions. This function is only available
+ on IA-32 and x64.
+
+ @param Index The 32-bit MSR index to read.
+
+ @return The value of the MSR identified by Index.
+
+**/
+UINT64
+EFIAPI
+AsmReadMsr64 (
+ IN UINT32 Index
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadMsr64 (Index);
+}
+
+/**
+ Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
+ value.
+
+ Writes the 64-bit value specified by Value to the MSR specified by Index. The
+ 64-bit value written to the MSR is returned. No parameter checking is
+ performed on Index or Value, and some of these may cause CPU exceptions. The
+ caller must either guarantee that Index and Value are valid, or the caller
+ must establish proper exception handlers. This function is only available on
+ IA-32 and x64.
+
+ @param Index The 32-bit MSR index to write.
+ @param Value The 64-bit value to write to the MSR.
+
+ @return Value
+
+**/
+UINT64
+EFIAPI
+AsmWriteMsr64 (
+ IN UINT32 Index,
+ IN UINT64 Value
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteMsr64 (Index, Value);
+}
+
+/**
+ Reads the current value of the Control Register 0 (CR0).
+
+ Reads and returns the current value of CR0. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 0 (CR0).
+
+**/
+UINTN
+EFIAPI
+AsmReadCr0 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadCr0 ();
+}
+
+/**
+ Reads the current value of the Control Register 2 (CR2).
+
+ Reads and returns the current value of CR2. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 2 (CR2).
+
+**/
+UINTN
+EFIAPI
+AsmReadCr2 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadCr2 ();
+}
+
+/**
+ Reads the current value of the Control Register 3 (CR3).
+
+ Reads and returns the current value of CR3. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 3 (CR3).
+
+**/
+UINTN
+EFIAPI
+AsmReadCr3 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadCr3 ();
+}
+
+/**
+ Reads the current value of the Control Register 4 (CR4).
+
+ Reads and returns the current value of CR4. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of the Control Register 4 (CR4).
+
+**/
+UINTN
+EFIAPI
+AsmReadCr4 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadCr4 ();
+}
+
+/**
+ Writes a value to Control Register 0 (CR0).
+
+ Writes and returns a new value to CR0. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr0 The value to write to CR0.
+
+ @return The value written to CR0.
+
+**/
+UINTN
+EFIAPI
+AsmWriteCr0 (
+ UINTN Cr0
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteCr0 (Cr0);
+}
+
+/**
+ Writes a value to Control Register 2 (CR2).
+
+ Writes and returns a new value to CR2. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr2 The value to write to CR2.
+
+ @return The value written to CR2.
+
+**/
+UINTN
+EFIAPI
+AsmWriteCr2 (
+ UINTN Cr2
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteCr2 (Cr2);
+}
+
+/**
+ Writes a value to Control Register 3 (CR3).
+
+ Writes and returns a new value to CR3. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr3 The value to write to CR3.
+
+ @return The value written to CR3.
+
+**/
+UINTN
+EFIAPI
+AsmWriteCr3 (
+ UINTN Cr3
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteCr3 (Cr3);
+}
+
+/**
+ Writes a value to Control Register 4 (CR4).
+
+ Writes and returns a new value to CR4. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Cr4 The value to write to CR4.
+
+ @return The value written to CR4.
+
+**/
+UINTN
+EFIAPI
+AsmWriteCr4 (
+ UINTN Cr4
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteCr4 (Cr4);
+}
+
+/**
+ Reads the current value of Debug Register 0 (DR0).
+
+ Reads and returns the current value of DR0. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 0 (DR0).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr0 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr0 ();
+}
+
+/**
+ Reads the current value of Debug Register 1 (DR1).
+
+ Reads and returns the current value of DR1. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 1 (DR1).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr1 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr1 ();
+}
+
+/**
+ Reads the current value of Debug Register 2 (DR2).
+
+ Reads and returns the current value of DR2. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 2 (DR2).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr2 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr2 ();
+}
+
+/**
+ Reads the current value of Debug Register 3 (DR3).
+
+ Reads and returns the current value of DR3. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 3 (DR3).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr3 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr3 ();
+}
+
+/**
+ Reads the current value of Debug Register 4 (DR4).
+
+ Reads and returns the current value of DR4. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 4 (DR4).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr4 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr4 ();
+}
+
+/**
+ Reads the current value of Debug Register 5 (DR5).
+
+ Reads and returns the current value of DR5. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 5 (DR5).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr5 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr5 ();
+}
+
+/**
+ Reads the current value of Debug Register 6 (DR6).
+
+ Reads and returns the current value of DR6. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 6 (DR6).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr6 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr6 ();
+}
+
+/**
+ Reads the current value of Debug Register 7 (DR7).
+
+ Reads and returns the current value of DR7. This function is only available
+ on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on
+ x64.
+
+ @return The value of Debug Register 7 (DR7).
+
+**/
+UINTN
+EFIAPI
+AsmReadDr7 (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDr7 ();
+}
+
+/**
+ Writes a value to Debug Register 0 (DR0).
+
+ Writes and returns a new value to DR0. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr0 The value to write to Dr0.
+
+ @return The value written to Debug Register 0 (DR0).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr0 (
+ UINTN Dr0
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr0 (Dr0);
+}
+
+/**
+ Writes a value to Debug Register 1 (DR1).
+
+ Writes and returns a new value to DR1. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr1 The value to write to Dr1.
+
+ @return The value written to Debug Register 1 (DR1).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr1 (
+ UINTN Dr1
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr1 (Dr1);
+}
+
+/**
+ Writes a value to Debug Register 2 (DR2).
+
+ Writes and returns a new value to DR2. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr2 The value to write to Dr2.
+
+ @return The value written to Debug Register 2 (DR2).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr2 (
+ UINTN Dr2
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr2 (Dr2);
+}
+
+/**
+ Writes a value to Debug Register 3 (DR3).
+
+ Writes and returns a new value to DR3. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr3 The value to write to Dr3.
+
+ @return The value written to Debug Register 3 (DR3).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr3 (
+ UINTN Dr3
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr3 (Dr3);
+}
+
+/**
+ Writes a value to Debug Register 4 (DR4).
+
+ Writes and returns a new value to DR4. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr4 The value to write to Dr4.
+
+ @return The value written to Debug Register 4 (DR4).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr4 (
+ UINTN Dr4
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr4 (Dr4);
+}
+
+/**
+ Writes a value to Debug Register 5 (DR5).
+
+ Writes and returns a new value to DR5. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr5 The value to write to Dr5.
+
+ @return The value written to Debug Register 5 (DR5).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr5 (
+ UINTN Dr5
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr5 (Dr5);
+}
+
+/**
+ Writes a value to Debug Register 6 (DR6).
+
+ Writes and returns a new value to DR6. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr6 The value to write to Dr6.
+
+ @return The value written to Debug Register 6 (DR6).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr6 (
+ UINTN Dr6
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr6 (Dr6);
+}
+
+/**
+ Writes a value to Debug Register 7 (DR7).
+
+ Writes and returns a new value to DR7. This function is only available on
+ IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.
+
+ @param Dr7 The value to write to Dr7.
+
+ @return The value written to Debug Register 7 (DR7).
+
+**/
+UINTN
+EFIAPI
+AsmWriteDr7 (
+ UINTN Dr7
+ )
+{
+ return gUnitTestHostBaseLib.AsmWriteDr7 (Dr7);
+}
+
+/**
+ Reads the current value of Code Segment Register (CS).
+
+ Reads and returns the current value of CS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of CS.
+
+**/
+UINT16
+EFIAPI
+AsmReadCs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadCs ();
+}
+
+/**
+ Reads the current value of Data Segment Register (DS).
+
+ Reads and returns the current value of DS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of DS.
+
+**/
+UINT16
+EFIAPI
+AsmReadDs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadDs ();
+}
+
+/**
+ Reads the current value of Extra Segment Register (ES).
+
+ Reads and returns the current value of ES. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of ES.
+
+**/
+UINT16
+EFIAPI
+AsmReadEs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadEs ();
+}
+
+/**
+ Reads the current value of FS Data Segment Register (FS).
+
+ Reads and returns the current value of FS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of FS.
+
+**/
+UINT16
+EFIAPI
+AsmReadFs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadFs ();
+}
+
+/**
+ Reads the current value of GS Data Segment Register (GS).
+
+ Reads and returns the current value of GS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of GS.
+
+**/
+UINT16
+EFIAPI
+AsmReadGs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadGs ();
+}
+
+/**
+ Reads the current value of Stack Segment Register (SS).
+
+ Reads and returns the current value of SS. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of SS.
+
+**/
+UINT16
+EFIAPI
+AsmReadSs (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadSs ();
+}
+
+/**
+ Reads the current value of Task Register (TR).
+
+ Reads and returns the current value of TR. This function is only available on
+ IA-32 and x64.
+
+ @return The current value of TR.
+
+**/
+UINT16
+EFIAPI
+AsmReadTr (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadTr ();
+}
+
+/**
+ Reads the current Global Descriptor Table Register(GDTR) descriptor.
+
+ Reads and returns the current GDTR descriptor and returns it in Gdtr. This
+ function is only available on IA-32 and x64.
+
+ If Gdtr is NULL, then ASSERT().
+
+ @param Gdtr The pointer to a GDTR descriptor.
+
+**/
+VOID
+EFIAPI
+AsmReadGdtr (
+ OUT IA32_DESCRIPTOR *Gdtr
+ )
+{
+ gUnitTestHostBaseLib.AsmReadGdtr (Gdtr);
+}
+
+/**
+ Writes the current Global Descriptor Table Register (GDTR) descriptor.
+
+ Writes and the current GDTR descriptor specified by Gdtr. This function is
+ only available on IA-32 and x64.
+
+ If Gdtr is NULL, then ASSERT().
+
+ @param Gdtr The pointer to a GDTR descriptor.
+
+**/
+VOID
+EFIAPI
+AsmWriteGdtr (
+ IN CONST IA32_DESCRIPTOR *Gdtr
+ )
+{
+ gUnitTestHostBaseLib.AsmWriteGdtr (Gdtr);
+}
+
+/**
+ Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.
+
+ Reads and returns the current IDTR descriptor and returns it in Idtr. This
+ function is only available on IA-32 and x64.
+
+ If Idtr is NULL, then ASSERT().
+
+ @param Idtr The pointer to a IDTR descriptor.
+
+**/
+VOID
+EFIAPI
+AsmReadIdtr (
+ OUT IA32_DESCRIPTOR *Idtr
+ )
+{
+ gUnitTestHostBaseLib.AsmReadIdtr (Idtr);
+}
+
+/**
+ Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.
+
+ Writes the current IDTR descriptor and returns it in Idtr. This function is
+ only available on IA-32 and x64.
+
+ If Idtr is NULL, then ASSERT().
+
+ @param Idtr The pointer to a IDTR descriptor.
+
+**/
+VOID
+EFIAPI
+AsmWriteIdtr (
+ IN CONST IA32_DESCRIPTOR *Idtr
+ )
+{
+ gUnitTestHostBaseLib.AsmWriteIdtr (Idtr);
+}
+
+/**
+ Reads the current Local Descriptor Table Register(LDTR) selector.
+
+ Reads and returns the current 16-bit LDTR descriptor value. This function is
+ only available on IA-32 and x64.
+
+ @return The current selector of LDT.
+
+**/
+UINT16
+EFIAPI
+AsmReadLdtr (
+ VOID
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadLdtr ();
+}
+
+/**
+ Writes the current Local Descriptor Table Register (LDTR) selector.
+
+ Writes and the current LDTR descriptor specified by Ldtr. This function is
+ only available on IA-32 and x64.
+
+ @param Ldtr 16-bit LDTR selector value.
+
+**/
+VOID
+EFIAPI
+AsmWriteLdtr (
+ IN UINT16 Ldtr
+ )
+{
+ gUnitTestHostBaseLib.AsmWriteLdtr (Ldtr);
+}
+
+/**
+ Reads the current value of a Performance Counter (PMC).
+
+ Reads and returns the current value of performance counter specified by
+ Index. This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit Performance Counter index to read.
+
+ @return The value of the PMC specified by Index.
+
+**/
+UINT64
+EFIAPI
+AsmReadPmc (
+ IN UINT32 Index
+ )
+{
+ return gUnitTestHostBaseLib.AsmReadPmc (Index);
+}
+
+/**
+ Sets up a monitor buffer that is used by AsmMwait().
+
+ Executes a MONITOR instruction with the register state specified by Eax, Ecx
+ and Edx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+ @param Edx The value to load into EDX or RDX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+UINTN
+EFIAPI
+AsmMonitor (
+ IN UINTN Eax,
+ IN UINTN Ecx,
+ IN UINTN Edx
+ )
+{
+ return gUnitTestHostBaseLib.AsmMonitor (Eax, Ecx, Edx);
+}
+
+/**
+ Executes an MWAIT instruction.
+
+ Executes an MWAIT instruction with the register state specified by Eax and
+ Ecx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+UINTN
+EFIAPI
+AsmMwait (
+ IN UINTN Eax,
+ IN UINTN Ecx
+ )
+{
+ return gUnitTestHostBaseLib.AsmMwait (Eax, Ecx);
+}
+
+/**
+ Executes a WBINVD instruction.
+
+ Executes a WBINVD instruction. This function is only available on IA-32 and
+ x64.
+
+**/
+VOID
+EFIAPI
+AsmWbinvd (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.AsmWbinvd ();
+}
+
+/**
+ Executes a INVD instruction.
+
+ Executes a INVD instruction. This function is only available on IA-32 and
+ x64.
+
+**/
+VOID
+EFIAPI
+AsmInvd (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.AsmInvd ();
+}
+
+/**
+ Flushes a cache line from all the instruction and data caches within the
+ coherency domain of the CPU.
+
+ Flushed the cache line specified by LinearAddress, and returns LinearAddress.
+ This function is only available on IA-32 and x64.
+
+ @param LinearAddress The address of the cache line to flush. If the CPU is
+ in a physical addressing mode, then LinearAddress is a
+ physical address. If the CPU is in a virtual
+ addressing mode, then LinearAddress is a virtual
+ address.
+
+ @return LinearAddress.
+**/
+VOID *
+EFIAPI
+AsmFlushCacheLine (
+ IN VOID *LinearAddress
+ )
+{
+ return gUnitTestHostBaseLib.AsmFlushCacheLine (LinearAddress);
+}
+
+/**
+ Enables the 32-bit paging mode on the CPU.
+
+ Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
+ must be properly initialized prior to calling this service. This function
+ assumes the current execution mode is 32-bit protected mode. This function is
+ only available on IA-32. After the 32-bit paging mode is enabled, control is
+ transferred to the function specified by EntryPoint using the new stack
+ specified by NewStack and passing in the parameters specified by Context1 and
+ Context2. Context1 and Context2 are optional and may be NULL. The function
+ EntryPoint must never return.
+
+ If the current execution mode is not 32-bit protected mode, then ASSERT().
+ If EntryPoint is NULL, then ASSERT().
+ If NewStack is NULL, then ASSERT().
+
+ There are a number of constraints that must be followed before calling this
+ function:
+ 1) Interrupts must be disabled.
+ 2) The caller must be in 32-bit protected mode with flat descriptors. This
+ means all descriptors must have a base of 0 and a limit of 4GB.
+ 3) CR0 and CR4 must be compatible with 32-bit protected mode with flat
+ descriptors.
+ 4) CR3 must point to valid page tables that will be used once the transition
+ is complete, and those page tables must guarantee that the pages for this
+ function and the stack are identity mapped.
+
+ @param EntryPoint A pointer to function to call with the new stack after
+ paging is enabled.
+ @param Context1 A pointer to the context to pass into the EntryPoint
+ function as the first parameter after paging is enabled.
+ @param Context2 A pointer to the context to pass into the EntryPoint
+ function as the second parameter after paging is enabled.
+ @param NewStack A pointer to the new stack to use for the EntryPoint
+ function after paging is enabled.
+
+**/
+VOID
+EFIAPI
+AsmEnablePaging32 (
+ IN SWITCH_STACK_ENTRY_POINT EntryPoint,
+ IN VOID *Context1, OPTIONAL
+ IN VOID *Context2, OPTIONAL
+ IN VOID *NewStack
+ )
+{
+ gUnitTestHostBaseLib.AsmEnablePaging32 (EntryPoint, Context1, Context2, NewStack);
+}
+
+/**
+ Disables the 32-bit paging mode on the CPU.
+
+ Disables the 32-bit paging mode on the CPU and returns to 32-bit protected
+ mode. This function assumes the current execution mode is 32-paged protected
+ mode. This function is only available on IA-32. After the 32-bit paging mode
+ is disabled, control is transferred to the function specified by EntryPoint
+ using the new stack specified by NewStack and passing in the parameters
+ specified by Context1 and Context2. Context1 and Context2 are optional and
+ may be NULL. The function EntryPoint must never return.
+
+ If the current execution mode is not 32-bit paged mode, then ASSERT().
+ If EntryPoint is NULL, then ASSERT().
+ If NewStack is NULL, then ASSERT().
+
+ There are a number of constraints that must be followed before calling this
+ function:
+ 1) Interrupts must be disabled.
+ 2) The caller must be in 32-bit paged mode.
+ 3) CR0, CR3, and CR4 must be compatible with 32-bit paged mode.
+ 4) CR3 must point to valid page tables that guarantee that the pages for
+ this function and the stack are identity mapped.
+
+ @param EntryPoint A pointer to function to call with the new stack after
+ paging is disabled.
+ @param Context1 A pointer to the context to pass into the EntryPoint
+ function as the first parameter after paging is disabled.
+ @param Context2 A pointer to the context to pass into the EntryPoint
+ function as the second parameter after paging is
+ disabled.
+ @param NewStack A pointer to the new stack to use for the EntryPoint
+ function after paging is disabled.
+
+**/
+VOID
+EFIAPI
+AsmDisablePaging32 (
+ IN SWITCH_STACK_ENTRY_POINT EntryPoint,
+ IN VOID *Context1, OPTIONAL
+ IN VOID *Context2, OPTIONAL
+ IN VOID *NewStack
+ )
+{
+ gUnitTestHostBaseLib.AsmDisablePaging32 (EntryPoint, Context1, Context2, NewStack);
+}
+
+/**
+ Enables the 64-bit paging mode on the CPU.
+
+ Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
+ must be properly initialized prior to calling this service. This function
+ assumes the current execution mode is 32-bit protected mode with flat
+ descriptors. This function is only available on IA-32. After the 64-bit
+ paging mode is enabled, control is transferred to the function specified by
+ EntryPoint using the new stack specified by NewStack and passing in the
+ parameters specified by Context1 and Context2. Context1 and Context2 are
+ optional and may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 32-bit protected mode with flat
+ descriptors, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for long mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is enabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is enabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is enabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is enabled.
+
+**/
+VOID
+EFIAPI
+AsmEnablePaging64 (
+ IN UINT16 Cs,
+ IN UINT64 EntryPoint,
+ IN UINT64 Context1, OPTIONAL
+ IN UINT64 Context2, OPTIONAL
+ IN UINT64 NewStack
+ )
+{
+ gUnitTestHostBaseLib.AsmEnablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);
+}
+
+/**
+ Disables the 64-bit paging mode on the CPU.
+
+ Disables the 64-bit paging mode on the CPU and returns to 32-bit protected
+ mode. This function assumes the current execution mode is 64-paging mode.
+ This function is only available on x64. After the 64-bit paging mode is
+ disabled, control is transferred to the function specified by EntryPoint
+ using the new stack specified by NewStack and passing in the parameters
+ specified by Context1 and Context2. Context1 and Context2 are optional and
+ may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 64-bit paged mode, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for 32-bit protected mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is disabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is disabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is disabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is disabled.
+
+**/
+VOID
+EFIAPI
+AsmDisablePaging64 (
+ IN UINT16 Cs,
+ IN UINT32 EntryPoint,
+ IN UINT32 Context1, OPTIONAL
+ IN UINT32 Context2, OPTIONAL
+ IN UINT32 NewStack
+ )
+{
+ gUnitTestHostBaseLib.AsmDisablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);
+}
+
+/**
+ Retrieves the properties for 16-bit thunk functions.
+
+ Computes the size of the buffer and stack below 1MB required to use the
+ AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This
+ buffer size is returned in RealModeBufferSize, and the stack size is returned
+ in ExtraStackSize. If parameters are passed to the 16-bit real mode code,
+ then the actual minimum stack size is ExtraStackSize plus the maximum number
+ of bytes that need to be passed to the 16-bit real mode code.
+
+ If RealModeBufferSize is NULL, then ASSERT().
+ If ExtraStackSize is NULL, then ASSERT().
+
+ @param RealModeBufferSize A pointer to the size of the buffer below 1MB
+ required to use the 16-bit thunk functions.
+ @param ExtraStackSize A pointer to the extra size of stack below 1MB
+ that the 16-bit thunk functions require for
+ temporary storage in the transition to and from
+ 16-bit real mode.
+
+**/
+VOID
+EFIAPI
+AsmGetThunk16Properties (
+ OUT UINT32 *RealModeBufferSize,
+ OUT UINT32 *ExtraStackSize
+ )
+{
+ gUnitTestHostBaseLib.AsmGetThunk16Properties (RealModeBufferSize, ExtraStackSize);
+}
+
+/**
+ Prepares all structures a code required to use AsmThunk16().
+
+ Prepares all structures and code required to use AsmThunk16().
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.
+
+ If ThunkContext is NULL, then ASSERT().
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+AsmPrepareThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+ gUnitTestHostBaseLib.AsmPrepareThunk16 (ThunkContext);
+}
+
+/**
+ Transfers control to a 16-bit real mode entry point and returns the results.
+
+ Transfers control to a 16-bit real mode entry point and returns the results.
+ AsmPrepareThunk16() must be called with ThunkContext before this function is used.
+ This function must be called with interrupts disabled.
+
+ The register state from the RealModeState field of ThunkContext is restored just prior
+ to calling the 16-bit real mode entry point. This includes the EFLAGS field of RealModeState,
+ which is used to set the interrupt state when a 16-bit real mode entry point is called.
+ Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.
+ The stack is initialized to the SS and ESP fields of RealModeState. Any parameters passed to
+ the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.
+ The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,
+ so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment
+ and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry
+ point must exit with a RETF instruction. The register state is captured into RealModeState immediately
+ after the RETF instruction is executed.
+
+ If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,
+ or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure
+ the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.
+
+ If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,
+ then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.
+ This includes the base vectors, the interrupt masks, and the edge/level trigger mode.
+
+ If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code
+ is invoked in big real mode. Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.
+
+ If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in
+ ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to
+ disable the A20 mask.
+
+ If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in
+ ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask. If this INT 15 call fails,
+ then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.
+
+ If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in
+ ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.
+
+ If ThunkContext is NULL, then ASSERT().
+ If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().
+ If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in
+ ThunkAttributes, then ASSERT().
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer are mapped 1:1.
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+AsmThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+ gUnitTestHostBaseLib.AsmThunk16 (ThunkContext);
+}
+
+/**
+ Prepares all structures and code for a 16-bit real mode thunk, transfers
+ control to a 16-bit real mode entry point, and returns the results.
+
+ Prepares all structures and code for a 16-bit real mode thunk, transfers
+ control to a 16-bit real mode entry point, and returns the results. If the
+ caller only need to perform a single 16-bit real mode thunk, then this
+ service should be used. If the caller intends to make more than one 16-bit
+ real mode thunk, then it is more efficient if AsmPrepareThunk16() is called
+ once and AsmThunk16() can be called for each 16-bit real mode thunk.
+
+ This interface is limited to be used in either physical mode or virtual modes with paging enabled where the
+ virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.
+
+ See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+VOID
+EFIAPI
+AsmPrepareAndThunk16 (
+ IN OUT THUNK_CONTEXT *ThunkContext
+ )
+{
+ gUnitTestHostBaseLib.AsmPrepareAndThunk16 (ThunkContext);
+}
+
+/**
+ Load given selector into TR register.
+
+ @param[in] Selector Task segment selector
+**/
+VOID
+EFIAPI
+AsmWriteTr (
+ IN UINT16 Selector
+ )
+{
+ gUnitTestHostBaseLib.AsmWriteTr (Selector);
+}
+
+/**
+ Performs a serializing operation on all load-from-memory instructions that
+ were issued prior the AsmLfence function.
+
+ Executes a LFENCE instruction. This function is only available on IA-32 and x64.
+
+**/
+VOID
+EFIAPI
+AsmLfence (
+ VOID
+ )
+{
+ gUnitTestHostBaseLib.AsmLfence ();
+}
+
+/**
+ Patch the immediate operand of an IA32 or X64 instruction such that the byte,
+ word, dword or qword operand is encoded at the end of the instruction's
+ binary representation.
+
+ This function should be used to update object code that was compiled with
+ NASM from assembly source code. Example:
+
+ NASM source code:
+
+ mov eax, strict dword 0 ; the imm32 zero operand will be patched
+ ASM_PFX(gPatchCr3):
+ mov cr3, eax
+
+ C source code:
+
+ X86_ASSEMBLY_PATCH_LABEL gPatchCr3;
+ PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);
+
+ @param[out] InstructionEnd Pointer right past the instruction to patch. The
+ immediate operand to patch is expected to
+ comprise the trailing bytes of the instruction.
+ If InstructionEnd is closer to address 0 than
+ ValueSize permits, then ASSERT().
+
+ @param[in] PatchValue The constant to write to the immediate operand.
+ The caller is responsible for ensuring that
+ PatchValue can be represented in the byte, word,
+ dword or qword operand (as indicated through
+ ValueSize); otherwise ASSERT().
+
+ @param[in] ValueSize The size of the operand in bytes; must be 1, 2,
+ 4, or 8. ASSERT() otherwise.
+**/
+VOID
+EFIAPI
+PatchInstructionX86 (
+ OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,
+ IN UINT64 PatchValue,
+ IN UINTN ValueSize
+ )
+{
+ gUnitTestHostBaseLib.PatchInstructionX86 (InstructionEnd, PatchValue, ValueSize);
+}
+
+///
+/// Structure of hook functions for BaseLib functions that can not be used from
+/// a host application. A simple emulation of these function is provided by
+/// default. A specific unit test can provide their own implementation for any
+/// of these functions.
+///
+UNIT_TEST_HOST_BASE_LIB gUnitTestHostBaseLib = {
+ //
+ // Common services
+ //
+ UnitTestHostBaseLibEnableInterrupts,
+ UnitTestHostBaseLibDisableInterrupts,
+ UnitTestHostBaseLibEnableDisableInterrupts,
+ UnitTestHostBaseLibGetInterruptState,
+ //
+ // IA32/X64 services
+ //
+ UnitTestHostBaseLibAsmCpuid,
+ UnitTestHostBaseLibAsmCpuidEx,
+ UnitTestHostBaseLibAsmDisableCache,
+ UnitTestHostBaseLibAsmEnableCache,
+ UnitTestHostBaseLibAsmReadMsr64,
+ UnitTestHostBaseLibAsmWriteMsr64,
+ UnitTestHostBaseLibAsmReadCr0,
+ UnitTestHostBaseLibAsmReadCr2,
+ UnitTestHostBaseLibAsmReadCr3,
+ UnitTestHostBaseLibAsmReadCr4,
+ UnitTestHostBaseLibAsmWriteCr0,
+ UnitTestHostBaseLibAsmWriteCr2,
+ UnitTestHostBaseLibAsmWriteCr3,
+ UnitTestHostBaseLibAsmWriteCr4,
+ UnitTestHostBaseLibAsmReadDr0,
+ UnitTestHostBaseLibAsmReadDr1,
+ UnitTestHostBaseLibAsmReadDr2,
+ UnitTestHostBaseLibAsmReadDr3,
+ UnitTestHostBaseLibAsmReadDr4,
+ UnitTestHostBaseLibAsmReadDr5,
+ UnitTestHostBaseLibAsmReadDr6,
+ UnitTestHostBaseLibAsmReadDr7,
+ UnitTestHostBaseLibAsmWriteDr0,
+ UnitTestHostBaseLibAsmWriteDr1,
+ UnitTestHostBaseLibAsmWriteDr2,
+ UnitTestHostBaseLibAsmWriteDr3,
+ UnitTestHostBaseLibAsmWriteDr4,
+ UnitTestHostBaseLibAsmWriteDr5,
+ UnitTestHostBaseLibAsmWriteDr6,
+ UnitTestHostBaseLibAsmWriteDr7,
+ UnitTestHostBaseLibAsmReadCs,
+ UnitTestHostBaseLibAsmReadDs,
+ UnitTestHostBaseLibAsmReadEs,
+ UnitTestHostBaseLibAsmReadFs,
+ UnitTestHostBaseLibAsmReadGs,
+ UnitTestHostBaseLibAsmReadSs,
+ UnitTestHostBaseLibAsmReadTr,
+ UnitTestHostBaseLibAsmReadGdtr,
+ UnitTestHostBaseLibAsmWriteGdtr,
+ UnitTestHostBaseLibAsmReadIdtr,
+ UnitTestHostBaseLibAsmWriteIdtr,
+ UnitTestHostBaseLibAsmReadLdtr,
+ UnitTestHostBaseLibAsmWriteLdtr,
+ UnitTestHostBaseLibAsmReadPmc,
+ UnitTestHostBaseLibAsmMonitor,
+ UnitTestHostBaseLibAsmMwait,
+ UnitTestHostBaseLibAsmWbinvd,
+ UnitTestHostBaseLibAsmInvd,
+ UnitTestHostBaseLibAsmFlushCacheLine,
+ UnitTestHostBaseLibAsmEnablePaging32,
+ UnitTestHostBaseLibAsmDisablePaging32,
+ UnitTestHostBaseLibAsmEnablePaging64,
+ UnitTestHostBaseLibAsmDisablePaging64,
+ UnitTestHostBaseLibAsmGetThunk16Properties,
+ UnitTestHostBaseLibAsmPrepareThunk16,
+ UnitTestHostBaseLibAsmThunk16,
+ UnitTestHostBaseLibAsmPrepareAndThunk16,
+ UnitTestHostBaseLibAsmWriteTr,
+ UnitTestHostBaseLibAsmLfence,
+ UnitTestHostBaseLibPatchInstructionX86
+};
diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec
index d03fc5b49d..3c8f92c89c 100644
--- a/MdePkg/MdePkg.dec
+++ b/MdePkg/MdePkg.dec
@@ -4,7 +4,7 @@
# It also provides the definitions(including PPIs/PROTOCOLs/GUIDs) of
# EFI1.10/UEFI2.7/PI1.7 and some Industry Standards.
#
-# Copyright (c) 2007 - 2019, Intel Corporation. All rights reserved.<BR>
+# Copyright (c) 2007 - 2020, Intel Corporation. All rights reserved.<BR>
# Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
# (C) Copyright 2016 - 2020 Hewlett Packard Enterprise Development LP<BR>
#
@@ -23,6 +23,7 @@ [Defines]
[Includes]
Include
+ Test/UnitTest/Include
[Includes.IA32]
Include/Ia32
diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc
index 472fa37774..8d717c3011 100644
--- a/MdePkg/MdePkg.dsc
+++ b/MdePkg/MdePkg.dsc
@@ -42,6 +42,7 @@ [Components]
MdePkg/Library/BaseDebugLibSerialPort/BaseDebugLibSerialPort.inf
MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
MdePkg/Library/BaseLib/BaseLib.inf
+ MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf
MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
MdePkg/Library/BaseOrderedCollectionRedBlackTreeLib/BaseOrderedCollectionRedBlackTreeLib.inf
MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
diff --git a/MdePkg/Test/UnitTest/Include/HostTest/UnitTestHostBaseLib.h b/MdePkg/Test/UnitTest/Include/HostTest/UnitTestHostBaseLib.h
new file mode 100644
index 0000000000..e5b0273fff
--- /dev/null
+++ b/MdePkg/Test/UnitTest/Include/HostTest/UnitTestHostBaseLib.h
@@ -0,0 +1,585 @@
+/** @file
+ Unit Test Host BaseLib hooks.
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+/**
+ Prototype of service with no parameters and no return value.
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_VOID)(
+ VOID
+ );
+
+/**
+ Prototype of service that reads and returns a BOOLEAN value.
+
+ @return The value read.
+**/
+typedef
+BOOLEAN
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_READ_BOOLEAN)(
+ VOID
+ );
+
+#if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
+/**
+ Prototype of service that reads and returns a UINT16 value.
+
+ @return The value read.
+**/
+typedef
+UINT16
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_READ_UINT16)(
+ VOID
+ );
+
+/**
+ Prototype of service that reads and returns a UINTN value.
+
+ @return The value read.
+**/
+typedef
+UINTN
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_READ_UINTN)(
+ VOID
+ );
+
+/**
+ Prototype of service that writes and returns a UINT16 value.
+
+ @param[in] Value The value to write.
+
+ @return The value written.
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_WRITE_UINT16)(
+ IN UINT16 Value
+ );
+
+/**
+ Prototype of service that writes and returns a UINTN value.
+
+ @param[in] Value The value to write.
+
+ @return The value written.
+**/
+typedef
+UINTN
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN)(
+ IN UINTN Value
+ );
+
+/**
+ Prototype of service that reads and returns an IA32_DESCRIPTOR.
+
+ @param[out] Ia32Descriptor Pointer to the descriptor read.
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_READ_IA32_DESCRIPTOR)(
+ OUT IA32_DESCRIPTOR *Ia32Descriptor
+ );
+
+/**
+ Prototype of service that writes an IA32_DESCRIPTOR.
+
+ @param[in] Ia32Descriptor Pointer to the descriptor to write.
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_WRITE_IA32_DESCRIPTOR)(
+ IN CONST IA32_DESCRIPTOR *Ia32Descriptor
+ );
+
+/**
+ Retrieves CPUID information.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index.
+ This function always returns Index.
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+ This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the CPUID
+ instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be NULL.
+
+ @return Index.
+
+**/
+typedef
+UINT32
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_CPUID)(
+ IN UINT32 Index,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ );
+
+/**
+ Retrieves CPUID information using an extended leaf identifier.
+
+ Executes the CPUID instruction with EAX set to the value specified by Index
+ and ECX set to the value specified by SubIndex. This function always returns
+ Index. This function is only available on IA-32 and x64.
+
+ If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.
+ If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.
+ If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.
+ If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.
+
+ @param Index The 32-bit value to load into EAX prior to invoking the
+ CPUID instruction.
+ @param SubIndex The 32-bit value to load into ECX prior to invoking the
+ CPUID instruction.
+ @param Eax The pointer to the 32-bit EAX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ebx The pointer to the 32-bit EBX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Ecx The pointer to the 32-bit ECX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+ @param Edx The pointer to the 32-bit EDX value returned by the CPUID
+ instruction. This is an optional parameter that may be
+ NULL.
+
+ @return Index.
+
+**/
+typedef
+UINT32
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_CPUID_EX)(
+ IN UINT32 Index,
+ IN UINT32 SubIndex,
+ OUT UINT32 *Eax, OPTIONAL
+ OUT UINT32 *Ebx, OPTIONAL
+ OUT UINT32 *Ecx, OPTIONAL
+ OUT UINT32 *Edx OPTIONAL
+ );
+
+/**
+ Returns a 64-bit Machine Specific Register(MSR).
+
+ Reads and returns the 64-bit MSR specified by Index. No parameter checking is
+ performed on Index, and some Index values may cause CPU exceptions. The
+ caller must either guarantee that Index is valid, or the caller must set up
+ exception handlers to catch the exceptions. This function is only available
+ on IA-32 and x64.
+
+ @param Index The 32-bit MSR index to read.
+
+ @return The value of the MSR identified by Index.
+
+**/
+typedef
+UINT64
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_READ_MSR_64)(
+ IN UINT32 Index
+ );
+
+/**
+ Writes a 64-bit value to a Machine Specific Register(MSR), and returns the
+ value.
+
+ Writes the 64-bit value specified by Value to the MSR specified by Index. The
+ 64-bit value written to the MSR is returned. No parameter checking is
+ performed on Index or Value, and some of these may cause CPU exceptions. The
+ caller must either guarantee that Index and Value are valid, or the caller
+ must establish proper exception handlers. This function is only available on
+ IA-32 and x64.
+
+ @param Index The 32-bit MSR index to write.
+ @param Value The 64-bit value to write to the MSR.
+
+ @return Value
+
+**/
+typedef
+UINT64
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_WRITE_MSR_64)(
+ IN UINT32 Index,
+ IN UINT64 Value
+ );
+
+/**
+ Reads the current value of a Performance Counter (PMC).
+
+ Reads and returns the current value of performance counter specified by
+ Index. This function is only available on IA-32 and x64.
+
+ @param Index The 32-bit Performance Counter index to read.
+
+ @return The value of the PMC specified by Index.
+
+**/
+typedef
+UINT64
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_READ_PMC)(
+ IN UINT32 Index
+ );
+
+/**
+ Sets up a monitor buffer that is used by AsmMwait().
+
+ Executes a MONITOR instruction with the register state specified by Eax, Ecx
+ and Edx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+ @param Edx The value to load into EDX or RDX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+typedef
+UINTN
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_MONITOR)(
+ IN UINTN Eax,
+ IN UINTN Ecx,
+ IN UINTN Edx
+ );
+
+/**
+ Executes an MWAIT instruction.
+
+ Executes an MWAIT instruction with the register state specified by Eax and
+ Ecx. Returns Eax. This function is only available on IA-32 and x64.
+
+ @param Eax The value to load into EAX or RAX before executing the MONITOR
+ instruction.
+ @param Ecx The value to load into ECX or RCX before executing the MONITOR
+ instruction.
+
+ @return Eax
+
+**/
+typedef
+UINTN
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_MWAIT)(
+ IN UINTN Eax,
+ IN UINTN Ecx
+ );
+
+/**
+ Flushes a cache line from all the instruction and data caches within the
+ coherency domain of the CPU.
+
+ Flushed the cache line specified by LinearAddress, and returns LinearAddress.
+ This function is only available on IA-32 and x64.
+
+ @param LinearAddress The address of the cache line to flush. If the CPU is
+ in a physical addressing mode, then LinearAddress is a
+ physical address. If the CPU is in a virtual
+ addressing mode, then LinearAddress is a virtual
+ address.
+
+ @return LinearAddress.
+**/
+typedef
+VOID *
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_FLUSH_CACHE_LINE)(
+ IN VOID *LinearAddress
+ );
+
+/**
+ Prototype of service that enables ot disables 32-bit paging modes.
+
+ @param EntryPoint A pointer to function to call with the new stack after
+ paging is enabled.
+ @param Context1 A pointer to the context to pass into the EntryPoint
+ function as the first parameter after paging is enabled.
+ @param Context2 A pointer to the context to pass into the EntryPoint
+ function as the second parameter after paging is enabled.
+ @param NewStack A pointer to the new stack to use for the EntryPoint
+ function after paging is enabled.
+
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_PAGING_32)(
+ IN SWITCH_STACK_ENTRY_POINT EntryPoint,
+ IN VOID *Context1, OPTIONAL
+ IN VOID *Context2, OPTIONAL
+ IN VOID *NewStack
+ );
+
+/**
+ Enables the 64-bit paging mode on the CPU.
+
+ Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
+ must be properly initialized prior to calling this service. This function
+ assumes the current execution mode is 32-bit protected mode with flat
+ descriptors. This function is only available on IA-32. After the 64-bit
+ paging mode is enabled, control is transferred to the function specified by
+ EntryPoint using the new stack specified by NewStack and passing in the
+ parameters specified by Context1 and Context2. Context1 and Context2 are
+ optional and may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 32-bit protected mode with flat
+ descriptors, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for long mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is enabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is enabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is enabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is enabled.
+
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_ENABLE_PAGING_64)(
+ IN UINT16 Cs,
+ IN UINT64 EntryPoint,
+ IN UINT64 Context1, OPTIONAL
+ IN UINT64 Context2, OPTIONAL
+ IN UINT64 NewStack
+ );
+
+/**
+ Disables the 64-bit paging mode on the CPU.
+
+ Disables the 64-bit paging mode on the CPU and returns to 32-bit protected
+ mode. This function assumes the current execution mode is 64-paging mode.
+ This function is only available on x64. After the 64-bit paging mode is
+ disabled, control is transferred to the function specified by EntryPoint
+ using the new stack specified by NewStack and passing in the parameters
+ specified by Context1 and Context2. Context1 and Context2 are optional and
+ may be 0. The function EntryPoint must never return.
+
+ If the current execution mode is not 64-bit paged mode, then ASSERT().
+ If EntryPoint is 0, then ASSERT().
+ If NewStack is 0, then ASSERT().
+
+ @param Cs The 16-bit selector to load in the CS before EntryPoint
+ is called. The descriptor in the GDT that this selector
+ references must be setup for 32-bit protected mode.
+ @param EntryPoint The 64-bit virtual address of the function to call with
+ the new stack after paging is disabled.
+ @param Context1 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the first parameter after
+ paging is disabled.
+ @param Context2 The 64-bit virtual address of the context to pass into
+ the EntryPoint function as the second parameter after
+ paging is disabled.
+ @param NewStack The 64-bit virtual address of the new stack to use for
+ the EntryPoint function after paging is disabled.
+
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_DISABLE_PAGING_64)(
+ IN UINT16 Cs,
+ IN UINT32 EntryPoint,
+ IN UINT32 Context1, OPTIONAL
+ IN UINT32 Context2, OPTIONAL
+ IN UINT32 NewStack
+ );
+
+/**
+ Retrieves the properties for 16-bit thunk functions.
+
+ Computes the size of the buffer and stack below 1MB required to use the
+ AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This
+ buffer size is returned in RealModeBufferSize, and the stack size is returned
+ in ExtraStackSize. If parameters are passed to the 16-bit real mode code,
+ then the actual minimum stack size is ExtraStackSize plus the maximum number
+ of bytes that need to be passed to the 16-bit real mode code.
+
+ If RealModeBufferSize is NULL, then ASSERT().
+ If ExtraStackSize is NULL, then ASSERT().
+
+ @param RealModeBufferSize A pointer to the size of the buffer below 1MB
+ required to use the 16-bit thunk functions.
+ @param ExtraStackSize A pointer to the extra size of stack below 1MB
+ that the 16-bit thunk functions require for
+ temporary storage in the transition to and from
+ 16-bit real mode.
+
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_GET_THUNK_16_PROPERTIES)(
+ OUT UINT32 *RealModeBufferSize,
+ OUT UINT32 *ExtraStackSize
+ );
+
+/**
+ Prototype of services that operates on a THUNK_CONTEXT structure.
+
+ @param ThunkContext A pointer to the context structure that describes the
+ 16-bit real mode code to call.
+
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_THUNK_16)(
+ IN OUT THUNK_CONTEXT *ThunkContext
+ );
+
+/**
+ Patch the immediate operand of an IA32 or X64 instruction such that the byte,
+ word, dword or qword operand is encoded at the end of the instruction's
+ binary representation.
+
+ This function should be used to update object code that was compiled with
+ NASM from assembly source code. Example:
+
+ NASM source code:
+
+ mov eax, strict dword 0 ; the imm32 zero operand will be patched
+ ASM_PFX(gPatchCr3):
+ mov cr3, eax
+
+ C source code:
+
+ X86_ASSEMBLY_PATCH_LABEL gPatchCr3;
+ PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);
+
+ @param[out] InstructionEnd Pointer right past the instruction to patch. The
+ immediate operand to patch is expected to
+ comprise the trailing bytes of the instruction.
+ If InstructionEnd is closer to address 0 than
+ ValueSize permits, then ASSERT().
+
+ @param[in] PatchValue The constant to write to the immediate operand.
+ The caller is responsible for ensuring that
+ PatchValue can be represented in the byte, word,
+ dword or qword operand (as indicated through
+ ValueSize); otherwise ASSERT().
+
+ @param[in] ValueSize The size of the operand in bytes; must be 1, 2,
+ 4, or 8. ASSERT() otherwise.
+**/
+typedef
+VOID
+(EFIAPI *UNIT_TEST_HOST_BASE_LIB_ASM_PATCH_INSTRUCTION_X86)(
+ OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,
+ IN UINT64 PatchValue,
+ IN UINTN ValueSize
+ );
+#endif // defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
+
+typedef struct {
+ //
+ // Common services
+ //
+ UNIT_TEST_HOST_BASE_LIB_VOID EnableInterrupts;
+ UNIT_TEST_HOST_BASE_LIB_VOID DisableInterrupts;
+ UNIT_TEST_HOST_BASE_LIB_VOID EnableDisableInterrupts;
+ UNIT_TEST_HOST_BASE_LIB_READ_BOOLEAN GetInterruptState;
+#if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
+ //
+ // IA32/X64 services
+ //
+ UNIT_TEST_HOST_BASE_LIB_ASM_CPUID AsmCpuid;
+ UNIT_TEST_HOST_BASE_LIB_ASM_CPUID_EX AsmCpuidEx;
+ UNIT_TEST_HOST_BASE_LIB_VOID AsmDisableCache;
+ UNIT_TEST_HOST_BASE_LIB_VOID AsmEnableCache;
+ UNIT_TEST_HOST_BASE_LIB_ASM_READ_MSR_64 AsmReadMsr64;
+ UNIT_TEST_HOST_BASE_LIB_ASM_WRITE_MSR_64 AsmWriteMsr64;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadCr0;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadCr2;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadCr3;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadCr4;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteCr0;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteCr2;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteCr3;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteCr4;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr0;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr1;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr2;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr3;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr4;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr5;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr6;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINTN AsmReadDr7;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr0;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr1;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr2;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr3;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr4;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr5;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr6;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINTN AsmWriteDr7;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadCs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadDs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadEs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadFs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadGs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadSs;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadTr;
+ UNIT_TEST_HOST_BASE_LIB_ASM_READ_IA32_DESCRIPTOR AsmReadGdtr;
+ UNIT_TEST_HOST_BASE_LIB_ASM_WRITE_IA32_DESCRIPTOR AsmWriteGdtr;
+ UNIT_TEST_HOST_BASE_LIB_ASM_READ_IA32_DESCRIPTOR AsmReadIdtr;
+ UNIT_TEST_HOST_BASE_LIB_ASM_WRITE_IA32_DESCRIPTOR AsmWriteIdtr;
+ UNIT_TEST_HOST_BASE_LIB_READ_UINT16 AsmReadLdtr;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINT16 AsmWriteLdtr;
+ UNIT_TEST_HOST_BASE_LIB_ASM_READ_PMC AsmReadPmc;
+ UNIT_TEST_HOST_BASE_LIB_ASM_MONITOR AsmMonitor;
+ UNIT_TEST_HOST_BASE_LIB_ASM_MWAIT AsmMwait;
+ UNIT_TEST_HOST_BASE_LIB_VOID AsmWbinvd;
+ UNIT_TEST_HOST_BASE_LIB_VOID AsmInvd;
+ UNIT_TEST_HOST_BASE_LIB_ASM_FLUSH_CACHE_LINE AsmFlushCacheLine;
+ UNIT_TEST_HOST_BASE_LIB_ASM_PAGING_32 AsmEnablePaging32;
+ UNIT_TEST_HOST_BASE_LIB_ASM_PAGING_32 AsmDisablePaging32;
+ UNIT_TEST_HOST_BASE_LIB_ASM_ENABLE_PAGING_64 AsmEnablePaging64;
+ UNIT_TEST_HOST_BASE_LIB_ASM_DISABLE_PAGING_64 AsmDisablePaging64;
+ UNIT_TEST_HOST_BASE_LIB_ASM_GET_THUNK_16_PROPERTIES AsmGetThunk16Properties;
+ UNIT_TEST_HOST_BASE_LIB_ASM_THUNK_16 AsmPrepareThunk16;
+ UNIT_TEST_HOST_BASE_LIB_ASM_THUNK_16 AsmThunk16;
+ UNIT_TEST_HOST_BASE_LIB_ASM_THUNK_16 AsmPrepareAndThunk16;
+ UNIT_TEST_HOST_BASE_LIB_WRITE_UINT16 AsmWriteTr;
+ UNIT_TEST_HOST_BASE_LIB_VOID AsmLfence;
+ UNIT_TEST_HOST_BASE_LIB_ASM_PATCH_INSTRUCTION_X86 PatchInstructionX86;
+#endif // defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)
+ //
+ // ARM services
+ //
+#if defined (MDE_CPU_ARM)
+#endif // defined (MDE_CPU_ARM)
+
+ //
+ // AARCH64 services
+ //
+#if defined (MDE_CPU_AARCH64)
+#endif // defined (MDE_CPU_AARCH64)
+
+ //
+ // RISC-V services
+ //
+#if defined (MDE_CPU_RISCV64)
+#endif // defined (MDE_CPU_RISCV64)
+} UNIT_TEST_HOST_BASE_LIB;
+
+extern UNIT_TEST_HOST_BASE_LIB gUnitTestHostBaseLib;
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 06/15] UnitTestFrameworkPkg: Use host libraries from MdePkg
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (4 preceding siblings ...)
2020-06-15 0:19 ` [Patch 05/15] MdePkg/Library/BaseLib: Add BaseLib instance for host based unit tests Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 07/15] UnitTestFrameworkPkg: Enable source level debug for host tests Michael D Kinney
` (8 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2800
https://bugzilla.tianocore.org/show_bug.cgi?id=2799
https://bugzilla.tianocore.org/show_bug.cgi?id=2798
Update the default unit test library mappings to use the
library instances from the MdePkg that are safe for host
based unit tests.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc | 3 +++
1 file changed, 3 insertions(+)
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
index e954968efc..f6a5b16096 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
@@ -9,6 +9,9 @@
!include UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
[LibraryClasses.common.HOST_APPLICATION]
+ BaseLib|MdePkg/Library/BaseLib/UnitTestHostBaseLib.inf
+ CpuLib|MdePkg/Library/BaseCpuLibNull/BaseCpuLibNull.inf
+ CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLibNull/BaseCacheMaintenanceLibNull.inf
CmockaLib|UnitTestFrameworkPkg/Library/CmockaLib/CmockaLib.inf
UnitTestLib|UnitTestFrameworkPkg/Library/UnitTestLib/UnitTestLibCmocka.inf
DebugLib|UnitTestFrameworkPkg/Library/Posix/DebugLibPosix/DebugLibPosix.inf
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 07/15] UnitTestFrameworkPkg: Enable source level debug for host tests
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (5 preceding siblings ...)
2020-06-15 0:19 ` [Patch 06/15] UnitTestFrameworkPkg: Use host libraries from MdePkg Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 08/15] UnitTestFrameworkPkg: Set host application stack size to 256KB Michael D Kinney
` (7 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2804
Optionally enable a feature to support source level debug of a
host based unit test. By default, this feature is disabled.
Exceptions are caught by the unit test framework and are
interpreted as a test failure.
When a unit test is under development, bugs may generate
exceptions or a unit test developer may want to trace the
execution of unit tests to debug some unexpected behavior.
Defining UNIT_TESTING_DEBUG in the DSC file or from the build
command line allows exceptions to be caught by the host OS
and allows the developer to debug their unit test under
development or debug the Unit Test Framework itself.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
index f6a5b16096..5de3c45d5a 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
@@ -19,6 +19,11 @@ [LibraryClasses.common.HOST_APPLICATION]
[BuildOptions]
GCC:*_*_*_CC_FLAGS = -fno-pie
+!ifdef $(UNIT_TESTING_DEBUG)
+ MSFT:*_*_*_CC_FLAGS = -D UNIT_TESTING_DEBUG=1
+ GCC:*_*_*_CC_FLAGS = -D UNIT_TESTING_DEBUG=1
+ XCODE:*_*_*_CC_FLAGS = -D UNIT_TESTING_DEBUG=1
+!endif
[BuildOptions.common.EDKII.HOST_APPLICATION]
#
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 08/15] UnitTestFrameworkPkg: Set host application stack size to 256KB
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (6 preceding siblings ...)
2020-06-15 0:19 ` [Patch 07/15] UnitTestFrameworkPkg: Enable source level debug for host tests Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 09/15] UnitTestFrameworkPkg: Change target mode DebugLib mapping Michael D Kinney
` (6 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2803
The UEFI Specification defines the minimum stack size before
ExitBootServices() to be 128KB. When running a host based unit
test, there may be additional stack overhead from the host
application environment and cmocka.
Update the build flags to set the size of the stack to 256KB
which is double the UEFI Specification requirement.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
index 5de3c45d5a..f82c391ef2 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkgHost.dsc.inc
@@ -29,7 +29,7 @@ [BuildOptions.common.EDKII.HOST_APPLICATION]
#
# MSFT
#
- MSFT:*_*_*_DLINK_FLAGS == /out:"$(BIN_DIR)\$(BASE_NAME).exe" /pdb:"$(BIN_DIR)\$(BASE_NAME).pdb" /IGNORE:4001 /NOLOGO /SUBSYSTEM:CONSOLE /DEBUG /NODEFAULTLIB:libcmt.lib libcmtd.lib
+ MSFT:*_*_*_DLINK_FLAGS == /out:"$(BIN_DIR)\$(BASE_NAME).exe" /pdb:"$(BIN_DIR)\$(BASE_NAME).pdb" /IGNORE:4001 /NOLOGO /SUBSYSTEM:CONSOLE /DEBUG /STACK:0x40000,0x40000 /NODEFAULTLIB:libcmt.lib libcmtd.lib
MSFT:*_*_IA32_DLINK_FLAGS = /MACHINE:I386
MSFT:*_*_X64_DLINK_FLAGS = /MACHINE:AMD64
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 09/15] UnitTestFrameworkPkg: Change target mode DebugLib mapping
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (7 preceding siblings ...)
2020-06-15 0:19 ` [Patch 08/15] UnitTestFrameworkPkg: Set host application stack size to 256KB Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 10/15] UnitTestFrameworkPkg/UnitTestLib: Move print log into cleanup Michael D Kinney
` (5 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2801
The default DebugLib for target mode was DebugLibNull. This
library instance disables all ASSERT() and DEBUG() macros
which removes the ability to write unit tests that check for
ASSERT() behaviors.
The DebugLib is changed to PeiDxeDebugLibReportStatusCode.inf
that guarantees that DEBUG() and ASSERT() macros are active. The
default ReportStatusCodeLib is set to BaseReportStatusCodeLibNull.inf
so no messages are sent to any devices preserving the DebugLibNull
behavior.
A platform specific unit test can always override these mappings
with a platform specific DebugLib.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc b/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
index c29b056fca..0881278ab0 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
@@ -16,7 +16,9 @@ [LibraryClasses]
BaseLib|MdePkg/Library/BaseLib/BaseLib.inf
BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
- DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
+ DebugLib|MdeModulePkg/Library/PeiDxeDebugLibReportStatusCode/PeiDxeDebugLibReportStatusCode.inf
+ ReportStatusCodeLib|MdePkg/Library/BaseReportStatusCodeLibNull/BaseReportStatusCodeLibNull.inf
+ DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
PeiServicesLib|MdePkg/Library/PeiServicesLib/PeiServicesLib.inf
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 10/15] UnitTestFrameworkPkg/UnitTestLib: Move print log into cleanup
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (8 preceding siblings ...)
2020-06-15 0:19 ` [Patch 09/15] UnitTestFrameworkPkg: Change target mode DebugLib mapping Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 11/15] UnitTestFrameworkPkg/UnitTestLib: Fix target mode log messages Michael D Kinney
` (4 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2805
If a unit test fails with an exception or an assert, then the
CmockaUnitTestFunctionRunner() is terminated and the logic
that follows the invocation of the unit test is skipped. This
currently skips the logic that prints log messages.
Move the print of log messages to the beginning of
CmockaUnitTestTeardownFunctionRunner() that is guaranteed to
be executed when a unit test completes normally or is
terminated with an exception or an assert.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../Library/UnitTestLib/RunTestsCmocka.c | 25 ++++++++++---------
1 file changed, 13 insertions(+), 12 deletions(-)
diff --git a/UnitTestFrameworkPkg/Library/UnitTestLib/RunTestsCmocka.c b/UnitTestFrameworkPkg/Library/UnitTestLib/RunTestsCmocka.c
index fb81cc9658..29f4752d59 100644
--- a/UnitTestFrameworkPkg/Library/UnitTestLib/RunTestsCmocka.c
+++ b/UnitTestFrameworkPkg/Library/UnitTestLib/RunTestsCmocka.c
@@ -53,21 +53,9 @@ CmockaUnitTestFunctionRunner (
UnitTest->Result = UNIT_TEST_SKIPPED;
} else {
UnitTest->Result = UNIT_TEST_RUNNING;
-
Framework->CurrentTest = UnitTest;
UnitTest->Result = UnitTest->RunTest (UnitTest->Context);
Framework->CurrentTest = NULL;
-
- // Print out the log messages - This is a partial solution as it
- // does not get the log into the XML. Need cmocka changes to support
- // stdout and stderr in their xml format
- //
- if (UnitTest->Log != NULL) {
- print_message("UnitTest: %s - %s\n", UnitTest->Name, UnitTest->Description);
- print_message("Log Output Start\n");
- print_message("%s", UnitTest->Log);
- print_message("Log Output End\n");
- }
}
}
@@ -112,6 +100,18 @@ CmockaUnitTestTeardownFunctionRunner (
Suite = (UNIT_TEST_SUITE *)(UnitTest->ParentSuite);
Framework = (UNIT_TEST_FRAMEWORK *)(Suite->ParentFramework);
+ //
+ // Print out the log messages - This is a partial solution as it
+ // does not get the log into the XML. Need cmocka changes to support
+ // stdout and stderr in their xml format
+ //
+ if (UnitTest->Log != NULL) {
+ print_message("UnitTest: %s - %s\n", UnitTest->Name, UnitTest->Description);
+ print_message("Log Output Start\n");
+ print_message("%s", UnitTest->Log);
+ print_message("Log Output End\n");
+ }
+
if (UnitTest->CleanUp == NULL) {
return 0;
}
@@ -119,6 +119,7 @@ CmockaUnitTestTeardownFunctionRunner (
Framework->CurrentTest = UnitTest;
UnitTest->CleanUp (UnitTest->Context);
Framework->CurrentTest = NULL;
+
//
// Return 0 for success. Non-zero for error.
//
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 11/15] UnitTestFrameworkPkg/UnitTestLib: Fix target mode log messages
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (9 preceding siblings ...)
2020-06-15 0:19 ` [Patch 10/15] UnitTestFrameworkPkg/UnitTestLib: Move print log into cleanup Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 12/15] UnitTestFrameworkPkg/UnitTestLib: Add checks for ASSERT() Michael D Kinney
` (3 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2806
Update the log messages generated in target mode to use
FileName instead of FunctionName. FunctionName is an empty
string so the log messages generated do not provide enough
information to know the source of a unit test failure.
Using FileName combined with LineNumber provides the
right information to identify the location of a unit test
failure.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../Library/UnitTestLib/Assert.c | 64 +++++++++----------
1 file changed, 32 insertions(+), 32 deletions(-)
diff --git a/UnitTestFrameworkPkg/Library/UnitTestLib/Assert.c b/UnitTestFrameworkPkg/Library/UnitTestLib/Assert.c
index c327ba88f1..8a131fab2b 100644
--- a/UnitTestFrameworkPkg/Library/UnitTestLib/Assert.c
+++ b/UnitTestFrameworkPkg/Library/UnitTestLib/Assert.c
@@ -105,14 +105,14 @@ UnitTestAssertTrue (
if (!Expression) {
UnitTestLogFailure (
FAILURETYPE_ASSERTTRUE,
- "%a::%d Expression (%a) is not TRUE!\n",
- FunctionName,
+ "%a:%d: Expression (%a) is not TRUE!\n",
+ FileName,
LineNumber,
Description
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Expression (%a) is not TRUE!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Expression (%a) is not TRUE!\n",
+ FileName,
LineNumber,
Description
);
@@ -151,14 +151,14 @@ UnitTestAssertFalse (
if (Expression) {
UnitTestLogFailure (
FAILURETYPE_ASSERTFALSE,
- "%a::%d Expression(%a) is not FALSE!\n",
- FunctionName,
+ "%a:%d: Expression(%a) is not FALSE!\n",
+ FileName,
LineNumber,
Description
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Expression (%a) is not FALSE!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Expression (%a) is not FALSE!\n",
+ FileName,
LineNumber,
Description
);
@@ -197,15 +197,15 @@ UnitTestAssertNotEfiError (
if (EFI_ERROR (Status)) {
UnitTestLogFailure (
FAILURETYPE_ASSERTNOTEFIERROR,
- "%a::%d Status '%a' is EFI_ERROR (%r)!\n",
- FunctionName,
+ "%a:%d: Status '%a' is EFI_ERROR (%r)!\n",
+ FileName,
LineNumber,
Description,
Status
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Status '%a' is EFI_ERROR (%r)!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Status '%a' is EFI_ERROR (%r)!\n",
+ FileName,
LineNumber,
Description,
Status
@@ -250,8 +250,8 @@ UnitTestAssertEqual (
if (ValueA != ValueB) {
UnitTestLogFailure (
FAILURETYPE_ASSERTEQUAL,
- "%a::%d Value %a != %a (%d != %d)!\n",
- FunctionName,
+ "%a:%d: Value %a != %a (%d != %d)!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
@@ -259,8 +259,8 @@ UnitTestAssertEqual (
ValueB
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Value %a != %a (%d != %d)!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Value %a != %a (%d != %d)!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
@@ -312,16 +312,16 @@ UnitTestAssertMemEqual (
if (CompareMem(BufferA, BufferB, Length) != 0) {
UnitTestLogFailure (
FAILURETYPE_ASSERTEQUAL,
- "%a::%d Memory at %a != %a for length %d bytes!\n",
- FunctionName,
+ "%a:%d: Memory at %a != %a for length %d bytes!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
Length
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Value %a != %a for length %d bytes!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Value %a != %a for length %d bytes!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
@@ -368,8 +368,8 @@ UnitTestAssertNotEqual (
if (ValueA == ValueB) {
UnitTestLogFailure (
FAILURETYPE_ASSERTNOTEQUAL,
- "%a::%d Value %a == %a (%d == %d)!\n",
- FunctionName,
+ "%a:%d: Value %a == %a (%d == %d)!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
@@ -377,8 +377,8 @@ UnitTestAssertNotEqual (
ValueB
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Value %a == %a (%d == %d)!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Value %a == %a (%d == %d)!\n",
+ FileName,
LineNumber,
DescriptionA,
DescriptionB,
@@ -423,16 +423,16 @@ UnitTestAssertStatusEqual (
if (Status != Expected) {
UnitTestLogFailure (
FAILURETYPE_ASSERTSTATUSEQUAL,
- "%a::%d Status '%a' is %r, should be %r!\n",
- FunctionName,
+ "%a:%d: Status '%a' is %r, should be %r!\n",
+ FileName,
LineNumber,
Description,
Status,
Expected
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Status '%a' is %r, should be %r!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Status '%a' is %r, should be %r!\n",
+ FileName,
LineNumber,
Description,
Status,
@@ -475,14 +475,14 @@ UnitTestAssertNotNull (
if (Pointer == NULL) {
UnitTestLogFailure (
FAILURETYPE_ASSERTNOTNULL,
- "%a::%d Pointer (%a) is NULL!\n",
- FunctionName,
+ "%a:%d: Pointer (%a) is NULL!\n",
+ FileName,
LineNumber,
PointerName
);
UT_LOG_ERROR (
- "[ASSERT FAIL] %a::%d Pointer (%a) is NULL!\n",
- FunctionName,
+ "[ASSERT FAIL] %a:%d: Pointer (%a) is NULL!\n",
+ FileName,
LineNumber,
PointerName
);
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 12/15] UnitTestFrameworkPkg/UnitTestLib: Add checks for ASSERT()
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (10 preceding siblings ...)
2020-06-15 0:19 ` [Patch 11/15] UnitTestFrameworkPkg/UnitTestLib: Fix target mode log messages Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 13/15] MdePkg/Include: Hook DebugLib _ASSERT() for unit tests Michael D Kinney
` (2 subsequent siblings)
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2801
Add UnitTestDebugAssertLib that provides the UnitTestDebugAssert()
service and the gUnitTestExpectAssertFailureJumpBuffer global
variable. This NULL library is linked against all host and target
unit test builds. This guarantees that the UnitTestDebugAssert()
service is available to link against all libraries and modules that
use the DebugLib class.
EDKII_UNIT_TEST_FRAMEWORK_ENABLED must always be defined when
building unit tests so the behavior of the DebugLib ASSERT()
macros can be adjusted to allow the unit test framework to
catch an ASSERT() if it is triggered by a function under test.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../UnitTestDebugAssertLib.c | 49 +++++++++++++++++++
.../UnitTestDebugAssertLib.inf | 31 ++++++++++++
.../UnitTestDebugAssertLib.uni | 11 +++++
.../Test/UnitTestFrameworkPkgHostTest.dsc | 2 +-
UnitTestFrameworkPkg/UnitTestFrameworkPkg.dsc | 1 +
.../UnitTestFrameworkPkgTarget.dsc.inc | 6 ++-
6 files changed, 97 insertions(+), 3 deletions(-)
create mode 100644 UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.c
create mode 100644 UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf
create mode 100644 UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.uni
diff --git a/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.c b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.c
new file mode 100644
index 0000000000..0a4001e182
--- /dev/null
+++ b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.c
@@ -0,0 +1,49 @@
+/** @file
+ Unit Test Debug Assert Library
+
+ Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+ SPDX-License-Identifier: BSD-2-Clause-Patent
+
+**/
+
+#include <Uefi.h>
+#include <Library/BaseLib.h>
+#include <Library/UnitTestLib.h>
+
+///
+/// Point to jump buffer used with SetJump()/LongJump() to test if a function
+/// under test generates an expected ASSERT() condition.
+///
+BASE_LIBRARY_JUMP_BUFFER *gUnitTestExpectAssertFailureJumpBuffer = NULL;
+
+/**
+ Unit test library replacement for DebugAssert() in DebugLib.
+
+ 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
+UnitTestDebugAssert (
+ IN CONST CHAR8 *FileName,
+ IN UINTN LineNumber,
+ IN CONST CHAR8 *Description
+ )
+{
+ CHAR8 Message[256];
+
+ if (gUnitTestExpectAssertFailureJumpBuffer != NULL) {
+ UT_LOG_INFO ("Detected expected ASSERT: %a(%d): %a\n", FileName, LineNumber, Description);
+ LongJump (gUnitTestExpectAssertFailureJumpBuffer, 1);
+ } else {
+ AsciiStrCpyS (Message, sizeof(Message), "Detected unexpected ASSERT(");
+ AsciiStrCatS (Message, sizeof(Message), Description);
+ AsciiStrCatS (Message, sizeof(Message), ")");
+ UnitTestAssertTrue (FALSE, "", LineNumber, FileName, Message);
+ }
+}
diff --git a/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf
new file mode 100644
index 0000000000..e6ccab0dd9
--- /dev/null
+++ b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf
@@ -0,0 +1,31 @@
+## @file
+# Unit Test Debug Assert Library
+#
+# Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+##
+
+[Defines]
+ INF_VERSION = 0x00010005
+ BASE_NAME = UnitTestDebugAssertLib
+ MODULE_UNI_FILE = UnitTestDebugAssertLib.uni
+ FILE_GUID = 9D53AD0D-5416-451F-A5BF-E5420051A99B
+ MODULE_TYPE = BASE
+ VERSION_STRING = 1.0
+ LIBRARY_CLASS = NULL
+
+#
+# VALID_ARCHITECTURES = ARM AARCH64
+#
+
+[Sources]
+ UnitTestDebugAssertLib.c
+
+[Packages]
+ MdePkg/MdePkg.dec
+ UnitTestFrameworkPkg/UnitTestFrameworkPkg.dec
+
+[LibraryClasses]
+ BaseLib
+ UnitTestLib
diff --git a/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.uni b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.uni
new file mode 100644
index 0000000000..9b794aa205
--- /dev/null
+++ b/UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.uni
@@ -0,0 +1,11 @@
+// /** @file
+// Unit Test Debug Assert Library
+//
+// Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>
+// SPDX-License-Identifier: BSD-2-Clause-Patent
+//
+// **/
+
+#string STR_MODULE_ABSTRACT #language en-US "Unit Test Debug Assert Library"
+
+#string STR_MODULE_DESCRIPTION #language en-US "Unit Test Debug Assert Library"
diff --git a/UnitTestFrameworkPkg/Test/UnitTestFrameworkPkgHostTest.dsc b/UnitTestFrameworkPkg/Test/UnitTestFrameworkPkgHostTest.dsc
index 701e7299d7..70affddead 100644
--- a/UnitTestFrameworkPkg/Test/UnitTestFrameworkPkgHostTest.dsc
+++ b/UnitTestFrameworkPkg/Test/UnitTestFrameworkPkgHostTest.dsc
@@ -25,7 +25,7 @@ [Components]
UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTestHost.inf
#
- # Build Libraries
+ # Build HOST_APPLICATION Libraries
#
UnitTestFrameworkPkg/Library/CmockaLib/CmockaLib.inf
UnitTestFrameworkPkg/Library/Posix/DebugLibPosix/DebugLibPosix.inf
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkg.dsc b/UnitTestFrameworkPkg/UnitTestFrameworkPkg.dsc
index 2d84691bf1..0dfd98f2a8 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkg.dsc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkg.dsc
@@ -28,6 +28,7 @@ [Components]
UnitTestFrameworkPkg/Library/UnitTestResultReportLib/UnitTestResultReportLibConOut.inf
UnitTestFrameworkPkg/Library/UnitTestBootLibUsbClass/UnitTestBootLibUsbClass.inf
UnitTestFrameworkPkg/Library/UnitTestPersistenceLibSimpleFileSystem/UnitTestPersistenceLibSimpleFileSystem.inf
+ UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf
UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTestDxe.inf
UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTestPei.inf
diff --git a/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc b/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
index 0881278ab0..8adf690098 100644
--- a/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
+++ b/UnitTestFrameworkPkg/UnitTestFrameworkPkgTarget.dsc.inc
@@ -29,6 +29,7 @@ [LibraryClasses]
UnitTestLib|UnitTestFrameworkPkg/Library/UnitTestLib/UnitTestLib.inf
UnitTestPersistenceLib|UnitTestFrameworkPkg/Library/UnitTestPersistenceLibNull/UnitTestPersistenceLibNull.inf
UnitTestResultReportLib|UnitTestFrameworkPkg/Library/UnitTestResultReportLib/UnitTestResultReportLibDebugLib.inf
+ NULL|UnitTestFrameworkPkg/Library/UnitTestDebugAssertLib/UnitTestDebugAssertLib.inf
[LibraryClasses.ARM, LibraryClasses.AARCH64]
#
@@ -56,5 +57,6 @@ [PcdsFixedAtBuild]
gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0x17
[BuildOptions]
- MSFT:*_*_*_CC_FLAGS = -D DISABLE_NEW_DEPRECATED_INTERFACES
- GCC:*_*_*_CC_FLAGS = -D DISABLE_NEW_DEPRECATED_INTERFACES
+ MSFT:*_*_*_CC_FLAGS = -D DISABLE_NEW_DEPRECATED_INTERFACES -D EDKII_UNIT_TEST_FRAMEWORK_ENABLED
+ GCC:*_*_*_CC_FLAGS = -D DISABLE_NEW_DEPRECATED_INTERFACES -D EDKII_UNIT_TEST_FRAMEWORK_ENABLED
+ XCODE:*_*_*_CC_FLAGS = -D DISABLE_NEW_DEPRECATED_INTERFACES -D EDKII_UNIT_TEST_FRAMEWORK_ENABLED
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 13/15] MdePkg/Include: Hook DebugLib _ASSERT() for unit tests
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (11 preceding siblings ...)
2020-06-15 0:19 ` [Patch 12/15] UnitTestFrameworkPkg/UnitTestLib: Add checks for ASSERT() Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 14/15] MdePkg/Include: Add UT_EXPECT_ASSERT_FAILURE() to UnitTestLib Michael D Kinney
2020-06-15 0:19 ` [Patch 15/15] UnitTestFramewokPkg/SampleUnitTest: Use UT_EXPECT_ASSERT_FAILURE() Michael D Kinney
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2801
Update DebugLib.h _ASSERT() macro to check if unit testing
is enabled and call UnitTestDebugAssert() instead of
DebugAssert() so the an ASSERT() condition that is triggered
by a function under test can be handled by the Unit Test
Framework.
If EDKII_UNIT_TEST_FRAMEWORK_ENABLED is not defined, then
the existing DebugLib behavior is preserved.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
MdePkg/Include/Library/DebugLib.h | 28 +++++++++++++++++++++++++++-
1 file changed, 27 insertions(+), 1 deletion(-)
diff --git a/MdePkg/Include/Library/DebugLib.h b/MdePkg/Include/Library/DebugLib.h
index baab34bf05..4cacd4b8e2 100644
--- a/MdePkg/Include/Library/DebugLib.h
+++ b/MdePkg/Include/Library/DebugLib.h
@@ -289,12 +289,38 @@ DebugPrintLevelEnabled (
@param Expression Boolean expression that evaluated to FALSE
**/
+#if defined (EDKII_UNIT_TEST_FRAMEWORK_ENABLED)
+/**
+ Unit test library replacement for DebugAssert() in DebugLib.
+
+ 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
+UnitTestDebugAssert (
+ IN CONST CHAR8 *FileName,
+ IN UINTN LineNumber,
+ IN CONST CHAR8 *Description
+ );
+
+#if defined(__clang__) && defined(__FILE_NAME__)
+#define _ASSERT(Expression) UnitTestDebugAssert (__FILE_NAME__, __LINE__, #Expression)
+#else
+#define _ASSERT(Expression) UnitTestDebugAssert (__FILE__, __LINE__, #Expression)
+#endif
+#else
#if defined(__clang__) && defined(__FILE_NAME__)
#define _ASSERT(Expression) DebugAssert (__FILE_NAME__, __LINE__, #Expression)
#else
#define _ASSERT(Expression) DebugAssert (__FILE__, __LINE__, #Expression)
#endif
-
+#endif
/**
Internal worker macro that calls DebugPrint().
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 14/15] MdePkg/Include: Add UT_EXPECT_ASSERT_FAILURE() to UnitTestLib
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (12 preceding siblings ...)
2020-06-15 0:19 ` [Patch 13/15] MdePkg/Include: Hook DebugLib _ASSERT() for unit tests Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
2020-06-15 0:19 ` [Patch 15/15] UnitTestFramewokPkg/SampleUnitTest: Use UT_EXPECT_ASSERT_FAILURE() Michael D Kinney
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Liming Gao, Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2801
Add the UT_EXPECT_ASSERT_FAILURE(FunctionCall, Status) macro
to the UnitTestLib that can be used to check if a function
under test triggers an ASSERT() condition. If an ASSERT()
condition is triggered, then the macro returns. If the
ASSERT() condition is not triggered, then the current unit
test fails with a status of UNIT_TEST_ERROR_TEST_FAILED.
If ASSERT()s are disabled, then this check for ASSERT()
behavior is not possible, and the check is skipped.
Add the UnitTestDebugAssert() to the UnitTestLib class. The
UnitTestDebugAssert() service is the same as the DebugLib
DebugAssert() service and is invoked from the DebugLib
_ASSERT() macro if unit testing is enabled. This allows the
Unit Test Framework to know when code under test triggers an
ASSERT() condition.
The global variable gUnitTestExpectAssertFailureJumpBuffer
is added to the UnitTestLib to save/restore context when
the UT_EXPECT_ASSERT_FAILURE(FunctionCall, Status) macro
is used. The UT_EXPECT_ASSERT_FAILURE() macro uses the
SetJump() service with this global variable. The UnitTestLib
service UnitTestDebugAssert() uses the LongJump() service
with this global to restore context if an ASSERT() is
triggered by the code under test.
Cc: Liming Gao <liming.gao@intel.com>
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
MdePkg/Include/Library/UnitTestLib.h | 70 ++++++++++++++++++++++++++++
1 file changed, 70 insertions(+)
diff --git a/MdePkg/Include/Library/UnitTestLib.h b/MdePkg/Include/Library/UnitTestLib.h
index a4374580a8..1935a14ad1 100644
--- a/MdePkg/Include/Library/UnitTestLib.h
+++ b/MdePkg/Include/Library/UnitTestLib.h
@@ -10,6 +10,14 @@
#ifndef __UNIT_TEST_LIB_H__
#define __UNIT_TEST_LIB_H__
+#include <Library/BaseLib.h>
+
+///
+/// Pointer to jump buffer used with SetJump()/LongJump() to test if a function
+/// under test generates an expected ASSERT() condition.
+///
+extern BASE_LIBRARY_JUMP_BUFFER *gUnitTestExpectAssertFailureJumpBuffer;
+
///
/// Unit Test Status
///
@@ -441,6 +449,68 @@ SaveFrameworkState (
return UNIT_TEST_ERROR_TEST_FAILED; \
}
+/**
+ This macro uses the framework assertion logic to check whether a function call
+ triggers an ASSERT() condition. The BaseLib SetJump()/LongJump() services
+ are used to establish a safe return point when an ASSERT() is triggered.
+ If an ASSERT() is triggered, unit test execution continues and Status is set
+ to UNIT_TEST_PASSED. Otherwise, a unit test case failure is raised and
+ Status is set to UNIT_TEST_ERROR_TEST_FAILED.
+
+ If ASSERT() macros are disabled, then the test case is skipped and a warning
+ message is added to the unit test log. Status is set to UNIT_TEST_SKIPPED.
+
+ @param[in] FunctionCall Function call that is expected to trigger ASSERT().
+ @param[out] Status Pointer to a UNIT_TEST_STATUS return value. This
+ is an optional parameter that may be NULL.
+**/
+#if defined (EDKII_UNIT_TEST_FRAMEWORK_ENABLED)
+ #define UT_EXPECT_ASSERT_FAILURE(FunctionCall, Status) \
+ if (DebugAssertEnabled ()) { \
+ BASE_LIBRARY_JUMP_BUFFER UnitTestJumpBuffer; \
+ gUnitTestExpectAssertFailureJumpBuffer = &UnitTestJumpBuffer; \
+ if (SetJump (gUnitTestExpectAssertFailureJumpBuffer) == 0) { \
+ FunctionCall; \
+ gUnitTestExpectAssertFailureJumpBuffer = NULL; \
+ UT_LOG_ERROR ("UT_EXPECT_ASSERT_FAILURE("#FunctionCall") did not ASSERT()\n"); \
+ if (Status != NULL) { \
+ *((UNIT_TEST_STATUS *)Status) = UNIT_TEST_ERROR_TEST_FAILED; \
+ } \
+ return UNIT_TEST_ERROR_TEST_FAILED; \
+ } \
+ gUnitTestExpectAssertFailureJumpBuffer = NULL; \
+ if (Status != NULL) { \
+ *((UNIT_TEST_STATUS *)Status) = UNIT_TEST_PASSED; \
+ } \
+ } else { \
+ UT_LOG_WARNING ("UT_EXPECT_ASSERT_FAILURE("#FunctionCall") disabled\n"); \
+ if (Status != NULL) { \
+ *((UNIT_TEST_STATUS *)Status) = UNIT_TEST_SKIPPED; \
+ } \
+ }
+#else
+ #define UT_EXPECT_ASSERT_FAILURE(FunctionCall, Status) FunctionCall;
+#endif
+
+/**
+ Unit test library replacement for DebugAssert() in DebugLib.
+
+ 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
+UnitTestDebugAssert (
+ IN CONST CHAR8 *FileName,
+ IN UINTN LineNumber,
+ IN CONST CHAR8 *Description
+ );
+
/**
If Expression is TRUE, then TRUE is returned.
If Expression is FALSE, then an assert is triggered and the location of the
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread* [Patch 15/15] UnitTestFramewokPkg/SampleUnitTest: Use UT_EXPECT_ASSERT_FAILURE()
2020-06-15 0:19 [Patch 00/15] UnitTestFrameworkPkg: Enhancements and bug fixes Michael D Kinney
` (13 preceding siblings ...)
2020-06-15 0:19 ` [Patch 14/15] MdePkg/Include: Add UT_EXPECT_ASSERT_FAILURE() to UnitTestLib Michael D Kinney
@ 2020-06-15 0:19 ` Michael D Kinney
14 siblings, 0 replies; 23+ messages in thread
From: Michael D Kinney @ 2020-06-15 0:19 UTC (permalink / raw)
To: devel; +Cc: Sean Brogan, Bret Barkelew, Jiewen Yao
https://bugzilla.tianocore.org/show_bug.cgi?id=2801
Add samples using UT_EXPECT_ASSERT_FAILURE() for both positive
test cases where the ASSERT() is triggered and detected correctly
and negative test cases where an ASSERT() is never triggered.
These new test cases also generate passing test results when
ASSERT()s are disabled.
Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Bret Barkelew <Bret.Barkelew@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
---
.../Sample/SampleUnitTest/SampleUnitTest.c | 109 ++++++++++++++++++
1 file changed, 109 insertions(+)
diff --git a/UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTest.c b/UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTest.c
index 37d5747bca..424b7abf88 100644
--- a/UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTest.c
+++ b/UnitTestFrameworkPkg/Test/UnitTest/Sample/SampleUnitTest/SampleUnitTest.c
@@ -181,6 +181,102 @@ GlobalPointerShouldBeChangeable (
return UNIT_TEST_PASSED;
}
+UNIT_TEST_STATUS
+EFIAPI
+DetectExpectedAssert (
+ IN UNIT_TEST_CONTEXT Context
+ )
+{
+ //
+ // This test passes because it directly triggers an ASSERT().
+ //
+ UT_EXPECT_ASSERT_FAILURE (ASSERT (FALSE), NULL);
+
+ //
+ // This test passes because DecimalToBcd() generates an ASSERT() if the
+ // value passed in is >= 100. The expected ASSERT() is caught by the unit
+ // test framework and UT_EXPECT_ASSERT_FAILURE() returns without an error.
+ //
+ UT_EXPECT_ASSERT_FAILURE (DecimalToBcd8 (101), NULL);
+
+ return UNIT_TEST_PASSED;
+}
+
+UNIT_TEST_STATUS
+EFIAPI
+DetectNoAssertsWorker1 (
+ IN UNIT_TEST_CONTEXT Context
+ )
+{
+ UNIT_TEST_STATUS Status;
+
+ //
+ // If ASSERT()s are enabled, then the following test case will not triggered
+ // an ASSERT() and UT_EXPECT_ASSERT_FAILURE() exits the function from the
+ // macro with status UNIT_TEST_ERROR_TEST_FAILED.
+ //
+ // If ASSERT()s are disabled, then UNIT_TEST_ERROR_TEST_FAILED() is ignored
+ // and Status is set to UNIT_TEST_SKIPPED.
+ //
+ // If ASSERT()s are enabled and this ASSERT() is incorrectly triggered, then
+ // UT_EXPECT_ASSERT_FAILURE() returns with Status set to UNIT_TEST_PASSED.
+ //
+ UT_EXPECT_ASSERT_FAILURE (ASSERT (TRUE), &Status);
+
+ return Status;
+}
+
+UNIT_TEST_STATUS
+EFIAPI
+DetectNoAssertsWorker2 (
+ IN UNIT_TEST_CONTEXT Context
+ )
+{
+ UNIT_TEST_STATUS Status;
+
+ //
+ // If ASSERT()s are enabled, then the following test case will not triggered
+ // an ASSERT() and UT_EXPECT_ASSERT_FAILURE() exits the function from the
+ // macro with status UNIT_TEST_ERROR_TEST_FAILED.
+ //
+ // If ASSERT()s are disabled, then UNIT_TEST_ERROR_TEST_FAILED() is ignored
+ // and Status is set to UNIT_TEST_SKIPPED.
+ //
+ // If ASSERT()s are enabled and this ASSERT() is incorrectly triggered, then
+ // UT_EXPECT_ASSERT_FAILURE() returns with Status set to UNIT_TEST_PASSED.
+ //
+ // DecimalToBcd() only generates an ASSERT() if the value passed in is >= 100.
+ //
+ UT_EXPECT_ASSERT_FAILURE (DecimalToBcd8 (99), &Status);
+
+ return Status;
+}
+
+UNIT_TEST_STATUS
+EFIAPI
+DetectNoAsserts (
+ IN UNIT_TEST_CONTEXT Context
+ )
+{
+ UNIT_TEST_STATUS Status;
+
+ //
+ // This call is expected to return UNIT_TEST_ERROR_TEST_FAILED or
+ // UNIT_TEST_SKIPPED.
+ //
+ Status = DetectNoAssertsWorker1 (Context);
+ UT_ASSERT_FALSE (Status == UNIT_TEST_PASSED);
+
+ //
+ // This call is expected to return UNIT_TEST_ERROR_TEST_FAILED or
+ // UNIT_TEST_SKIPPED.
+ //
+ Status = DetectNoAssertsWorker2 (Context);
+ UT_ASSERT_FALSE (Status == UNIT_TEST_PASSED);
+
+ return UNIT_TEST_PASSED;
+}
+
/**
Initialize the unit test framework, suite, and unit tests for the
sample unit tests and run the unit tests.
@@ -199,6 +295,7 @@ UefiTestMain (
UNIT_TEST_FRAMEWORK_HANDLE Framework;
UNIT_TEST_SUITE_HANDLE SimpleMathTests;
UNIT_TEST_SUITE_HANDLE GlobalVarTests;
+ UNIT_TEST_SUITE_HANDLE DebugAssertTests;
Framework = NULL;
@@ -236,6 +333,18 @@ UefiTestMain (
AddTestCase (GlobalVarTests, "You should be able to change a global BOOLEAN", "Boolean", GlobalBooleanShouldBeChangeable, NULL, NULL, NULL);
AddTestCase (GlobalVarTests, "You should be able to change a global pointer", "Pointer", GlobalPointerShouldBeChangeable, MakeSureThatPointerIsNull, ClearThePointer, NULL);
+ //
+ // Populate the DebugLib ASSERT() Unit Test Suite.
+ //
+ Status = CreateUnitTestSuite (&DebugAssertTests, Framework, "DebugLib ASSERT() Tests", "Sample.DebugLibAssert", NULL, NULL);
+ if (EFI_ERROR (Status)) {
+ DEBUG ((DEBUG_ERROR, "Failed in CreateUnitTestSuite for DebugAssertTests\n"));
+ Status = EFI_OUT_OF_RESOURCES;
+ goto EXIT;
+ }
+ AddTestCase (DebugAssertTests, "Detect Expected ASSERT()", "DetectExpectedAssert", DetectExpectedAssert, NULL, NULL, NULL);
+ AddTestCase (DebugAssertTests, "Detect no ASSERT() triggered", "DetectNoAsserts", DetectNoAsserts, NULL, NULL, NULL);
+
//
// Execute the tests.
//
--
2.21.0.windows.1
^ permalink raw reply related [flat|nested] 23+ messages in thread