]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/Ia32/ProcessorBind.h
UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm
[mirror_edk2.git] / MdePkg / Include / Ia32 / ProcessorBind.h
index 22f07ca6375e01c5db2bb4a5dbe65e689c1fe368..ee39d1cfe10b7f89d986a18b0ec62ace9e1af79b 100644 (file)
@@ -1,14 +1,8 @@
 /** @file\r
   Processor or Compiler specific defines and types for IA-32 architecture.\r
 \r
-Copyright (c) 2006 - 2015, Intel Corporation. All rights reserved.<BR>\r
-This program and the accompanying materials are licensed and made available under \r
-the terms and conditions of the BSD License that accompanies this distribution.  \r
-The full text of the license may be found at\r
-http://opensource.org/licenses/bsd-license.php.                                          \r
-    \r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
 \r
 **/\r
 \r
@@ -23,39 +17,38 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //\r
 // Make sure we are using the correct packing rules per EFI specification\r
 //\r
-#if !defined(__GNUC__)\r
-#pragma pack()\r
+#if !defined (__GNUC__)\r
+  #pragma pack()\r
 #endif\r
 \r
-#if defined(__INTEL_COMPILER)\r
+#if defined (__INTEL_COMPILER)\r
 //\r
 // Disable ICC's remark #869: "Parameter" was never referenced warning.\r
 // This is legal ANSI C code so we disable the remark that is turned on with -Wall\r
 //\r
-#pragma warning ( disable : 869 )\r
+  #pragma warning ( disable : 869 )\r
 \r
 //\r
 // Disable ICC's remark #1418: external function definition with no prior declaration.\r
 // This is legal ANSI C code so we disable the remark that is turned on with /W4\r
 //\r
-#pragma warning ( disable : 1418 )\r
+  #pragma warning ( disable : 1418 )\r
 \r
 //\r
 // Disable ICC's remark #1419: external declaration in primary source file\r
 // This is legal ANSI C code so we disable the remark that is turned on with /W4\r
 //\r
-#pragma warning ( disable : 1419 )\r
+  #pragma warning ( disable : 1419 )\r
 \r
 //\r
 // Disable ICC's remark #593: "Variable" was set but never used.\r
 // This is legal ANSI C code so we disable the remark that is turned on with /W4\r
 //\r
-#pragma warning ( disable : 593 )\r
+  #pragma warning ( disable : 593 )\r
 \r
 #endif\r
 \r
-\r
-#if defined(_MSC_EXTENSIONS)\r
+#if defined (_MSC_EXTENSIONS)\r
 \r
 //\r
 // Disable warning that make it impossible to compile at /W4\r
@@ -65,168 +58,167 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 //\r
 // Disabling bitfield type checking warnings.\r
 //\r
-#pragma warning ( disable : 4214 )\r
+  #pragma warning ( disable : 4214 )\r
 \r
 //\r
 // Disabling the unreferenced formal parameter warnings.\r
 //\r
-#pragma warning ( disable : 4100 )\r
+  #pragma warning ( disable : 4100 )\r
 \r
 //\r
 // Disable slightly different base types warning as CHAR8 * can not be set\r
 // to a constant string.\r
 //\r
-#pragma warning ( disable : 4057 )\r
+  #pragma warning ( disable : 4057 )\r
 \r
 //\r
-// ASSERT(FALSE) or while (TRUE) are legal constructes so supress this warning\r
+// ASSERT(FALSE) or while (TRUE) are legal constructs so suppress this warning\r
 //\r
-#pragma warning ( disable : 4127 )\r
+  #pragma warning ( disable : 4127 )\r
 \r
 //\r
 // This warning is caused by functions defined but not used. For precompiled header only.\r
 //\r
-#pragma warning ( disable : 4505 )\r
+  #pragma warning ( disable : 4505 )\r
 \r
 //\r
 // This warning is caused by empty (after preprocessing) source file. For precompiled header only.\r
 //\r
-#pragma warning ( disable : 4206 )\r
+  #pragma warning ( disable : 4206 )\r
 \r
-#if _MSC_VER == 1800\r
+  #if defined (_MSC_VER) && _MSC_VER >= 1800\r
 \r
 //\r
 // Disable these warnings for VS2013.\r
 //\r
 \r
 //\r
-// This warning is for potentially uninitialized local variable, and it may cause false \r
-// positive issues in VS2013 build\r
+// This warning is for potentially uninitialized local variable, and it may cause false\r
+// positive issues in VS2013 and VS2015 build\r
 //\r
-#pragma warning ( disable : 4701 )\r
-  \r
+    #pragma warning ( disable : 4701 )\r
+\r
 //\r
-// This warning is for potentially uninitialized local pointer variable, and it may cause \r
-// false positive issues in VS2013 build\r
+// This warning is for potentially uninitialized local pointer variable, and it may cause\r
+// false positive issues in VS2013 and VS2015 build\r
 //\r
-#pragma warning ( disable : 4703 )\r
-  \r
-#endif\r
+    #pragma warning ( disable : 4703 )\r
+\r
+  #endif\r
 \r
 #endif\r
 \r
+#if defined (_MSC_EXTENSIONS)\r
+\r
+//\r
+// use Microsoft C compiler dependent integer width types\r
+//\r
 \r
-#if defined(_MSC_EXTENSIONS)\r
-\r
-  //\r
-  // use Microsoft C complier dependent integer width types \r
-  //\r
-\r
-  ///\r
-  /// 8-byte unsigned value.\r
-  ///\r
-  typedef unsigned __int64    UINT64;\r
-  ///\r
-  /// 8-byte signed value.\r
-  ///\r
-  typedef __int64             INT64;\r
-  ///\r
-  /// 4-byte unsigned value.\r
-  ///\r
-  typedef unsigned __int32    UINT32;\r
-  ///\r
-  /// 4-byte signed value.\r
-  ///\r
-  typedef __int32             INT32;\r
-  ///\r
-  /// 2-byte unsigned value.\r
-  ///\r
-  typedef unsigned short      UINT16;\r
-  ///\r
-  /// 2-byte Character.  Unless otherwise specified all strings are stored in the\r
-  /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
-  ///\r
-  typedef unsigned short      CHAR16;\r
-  ///\r
-  /// 2-byte signed value.\r
-  ///\r
-  typedef short               INT16;\r
-  ///\r
-  /// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other\r
-  /// values are undefined.\r
-  ///\r
-  typedef unsigned char       BOOLEAN;\r
-  ///\r
-  /// 1-byte unsigned value.\r
-  ///\r
-  typedef unsigned char       UINT8;\r
-  ///\r
-  /// 1-byte Character.\r
-  ///\r
-  typedef char                CHAR8;\r
-  ///\r
-  /// 1-byte signed value.\r
-  ///\r
-  typedef signed char         INT8;\r
-#else  \r
-  ///\r
-  /// 8-byte unsigned value.\r
-  ///\r
-  typedef unsigned long long  UINT64;\r
-  ///\r
-  /// 8-byte signed value.\r
-  ///\r
-  typedef long long           INT64;\r
-  ///\r
-  /// 4-byte unsigned value.\r
-  ///\r
-  typedef unsigned int        UINT32;\r
-  ///\r
-  /// 4-byte signed value.\r
-  ///\r
-  typedef int                 INT32;\r
-  ///\r
-  /// 2-byte unsigned value.\r
-  ///\r
-  typedef unsigned short      UINT16;\r
-  ///\r
-  /// 2-byte Character.  Unless otherwise specified all strings are stored in the\r
-  /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
-  ///\r
-  typedef unsigned short      CHAR16;\r
-  ///\r
-  /// 2-byte signed value.\r
-  ///\r
-  typedef short               INT16;\r
-  ///\r
-  /// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other\r
-  /// values are undefined.\r
-  ///\r
-  typedef unsigned char       BOOLEAN;\r
-  ///\r
-  /// 1-byte unsigned value.\r
-  ///\r
-  typedef unsigned char       UINT8;\r
-  ///\r
-  /// 1-byte Character\r
-  ///\r
-  typedef char                CHAR8;\r
-  ///\r
-  /// 1-byte signed value\r
-  ///\r
-  typedef signed char         INT8;\r
+///\r
+/// 8-byte unsigned value.\r
+///\r
+typedef unsigned __int64 UINT64;\r
+///\r
+/// 8-byte signed value.\r
+///\r
+typedef __int64 INT64;\r
+///\r
+/// 4-byte unsigned value.\r
+///\r
+typedef unsigned __int32 UINT32;\r
+///\r
+/// 4-byte signed value.\r
+///\r
+typedef __int32 INT32;\r
+///\r
+/// 2-byte unsigned value.\r
+///\r
+typedef unsigned short UINT16;\r
+///\r
+/// 2-byte Character.  Unless otherwise specified all strings are stored in the\r
+/// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
+///\r
+typedef unsigned short CHAR16;\r
+///\r
+/// 2-byte signed value.\r
+///\r
+typedef short INT16;\r
+///\r
+/// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other\r
+/// values are undefined.\r
+///\r
+typedef unsigned char BOOLEAN;\r
+///\r
+/// 1-byte unsigned value.\r
+///\r
+typedef unsigned char UINT8;\r
+///\r
+/// 1-byte Character.\r
+///\r
+typedef char CHAR8;\r
+///\r
+/// 1-byte signed value.\r
+///\r
+typedef signed char INT8;\r
+#else\r
+///\r
+/// 8-byte unsigned value.\r
+///\r
+typedef unsigned long long UINT64;\r
+///\r
+/// 8-byte signed value.\r
+///\r
+typedef long long INT64;\r
+///\r
+/// 4-byte unsigned value.\r
+///\r
+typedef unsigned int UINT32;\r
+///\r
+/// 4-byte signed value.\r
+///\r
+typedef int INT32;\r
+///\r
+/// 2-byte unsigned value.\r
+///\r
+typedef unsigned short UINT16;\r
+///\r
+/// 2-byte Character.  Unless otherwise specified all strings are stored in the\r
+/// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
+///\r
+typedef unsigned short CHAR16;\r
+///\r
+/// 2-byte signed value.\r
+///\r
+typedef short INT16;\r
+///\r
+/// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other\r
+/// values are undefined.\r
+///\r
+typedef unsigned char BOOLEAN;\r
+///\r
+/// 1-byte unsigned value.\r
+///\r
+typedef unsigned char UINT8;\r
+///\r
+/// 1-byte Character\r
+///\r
+typedef char CHAR8;\r
+///\r
+/// 1-byte signed value\r
+///\r
+typedef signed char INT8;\r
 #endif\r
 \r
 ///\r
 /// Unsigned value of native width.  (4 bytes on supported 32-bit processor instructions;\r
 /// 8 bytes on supported 64-bit processor instructions.)\r
 ///\r
-typedef UINT32  UINTN;\r
+typedef UINT32 UINTN;\r
 ///\r
 /// Signed value of native width.  (4 bytes on supported 32-bit processor instructions;\r
 /// 8 bytes on supported 64-bit processor instructions.)\r
 ///\r
-typedef INT32   INTN;\r
+typedef INT32 INTN;\r
 \r
 //\r
 // Processor specific defines\r
@@ -235,7 +227,7 @@ typedef INT32   INTN;
 ///\r
 /// A value of native width with the highest bit set.\r
 ///\r
-#define MAX_BIT     0x80000000\r
+#define MAX_BIT  0x80000000\r
 ///\r
 /// A value of native width with the two highest bits set.\r
 ///\r
@@ -244,7 +236,12 @@ typedef INT32   INTN;
 ///\r
 /// Maximum legal IA-32 address.\r
 ///\r
-#define MAX_ADDRESS   0xFFFFFFFF\r
+#define MAX_ADDRESS  0xFFFFFFFF\r
+\r
+///\r
+/// Maximum usable address at boot time\r
+///\r
+#define MAX_ALLOC_ADDRESS  MAX_ADDRESS\r
 \r
 ///\r
 /// Maximum legal IA-32 INTN and UINTN values.\r
@@ -252,10 +249,21 @@ typedef INT32   INTN;
 #define MAX_INTN   ((INTN)0x7FFFFFFF)\r
 #define MAX_UINTN  ((UINTN)0xFFFFFFFF)\r
 \r
+///\r
+/// Minimum legal IA-32 INTN value.\r
+///\r
+#define MIN_INTN  (((INTN)-2147483647) - 1)\r
+\r
 ///\r
 /// The stack alignment required for IA-32.\r
 ///\r
-#define CPU_STACK_ALIGNMENT   sizeof(UINTN)\r
+#define CPU_STACK_ALIGNMENT  sizeof(UINTN)\r
+\r
+///\r
+/// Page allocation granularity for IA-32.\r
+///\r
+#define DEFAULT_PAGE_ALLOCATION_GRANULARITY  (0x1000)\r
+#define RUNTIME_PAGE_ALLOCATION_GRANULARITY  (0x1000)\r
 \r
 //\r
 // Modifier to ensure that all protocol member functions and EFI intrinsics\r
@@ -263,50 +271,49 @@ typedef INT32   INTN;
 // EFI intrinsics are required to modify their member functions with EFIAPI.\r
 //\r
 #ifdef EFIAPI\r
-  ///\r
-  /// If EFIAPI is already defined, then we use that definition.\r
-  ///\r
-#elif defined(_MSC_EXTENSIONS)\r
-  ///\r
-  /// Microsoft* compiler specific method for EFIAPI calling convention.\r
-  /// \r
-  #define EFIAPI __cdecl  \r
-#elif defined(__GNUC__)\r
-  ///\r
-  /// GCC specific method for EFIAPI calling convention.\r
-  /// \r
-  #define EFIAPI __attribute__((cdecl))  \r
+///\r
+/// If EFIAPI is already defined, then we use that definition.\r
+///\r
+#elif defined (_MSC_EXTENSIONS)\r
+///\r
+/// Microsoft* compiler specific method for EFIAPI calling convention.\r
+///\r
+#define EFIAPI  __cdecl\r
+#elif defined (__GNUC__) || defined (__clang__)\r
+///\r
+/// GCC specific method for EFIAPI calling convention.\r
+///\r
+#define EFIAPI  __attribute__((cdecl))\r
 #else\r
-  ///\r
-  /// The default for a non Microsoft* or GCC compiler is to assume the EFI ABI\r
-  /// is the standard. \r
-  ///\r
-  #define EFIAPI\r
+///\r
+/// The default for a non Microsoft* or GCC compiler is to assume the EFI ABI\r
+/// is the standard.\r
+///\r
+#define EFIAPI\r
 #endif\r
 \r
-#if defined(__GNUC__)\r
-  ///\r
-  /// For GNU assembly code, .global or .globl can declare global symbols.\r
-  /// Define this macro to unify the usage.\r
-  ///\r
-  #define ASM_GLOBAL .globl\r
+#if defined (__GNUC__) || defined (__clang__)\r
+///\r
+/// For GNU assembly code, .global or .globl can declare global symbols.\r
+/// Define this macro to unify the usage.\r
+///\r
+#define ASM_GLOBAL  .globl\r
 #endif\r
 \r
 /**\r
   Return the pointer to the first instruction of a function given a function pointer.\r
-  On IA-32 CPU architectures, these two pointer values are the same, \r
+  On IA-32 CPU architectures, these two pointer values are the same,\r
   so the implementation of this macro is very simple.\r
-  \r
+\r
   @param  FunctionPointer   A pointer to a function.\r
 \r
   @return The pointer to the first instruction of a function given a function pointer.\r
-  \r
+\r
 **/\r
-#define FUNCTION_ENTRY_POINT(FunctionPointer) (VOID *)(UINTN)(FunctionPointer)\r
+#define FUNCTION_ENTRY_POINT(FunctionPointer)  (VOID *)(UINTN)(FunctionPointer)\r
 \r
 #ifndef __USER_LABEL_PREFIX__\r
-#define __USER_LABEL_PREFIX__ _\r
+#define __USER_LABEL_PREFIX__  _\r
 #endif\r
 \r
 #endif\r
-\r