MdePkg: Replace BSD License with BSD+Patent License

[mirror_edk2.git] / MdePkg / Include / Ia32 / ProcessorBind.h

/** @file\r
  Processor or Compiler specific defines and types for IA-32 architecture.\r
\r
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#ifndef __PROCESSOR_BIND_H__\r
#define __PROCESSOR_BIND_H__\r
\r
///\r
/// Define the processor type so other code can make processor based choices.\r
///\r
#define MDE_CPU_IA32\r
\r
//\r
// Make sure we are using the correct packing rules per EFI specification\r
//\r
#if !defined(__GNUC__)\r
#pragma pack()\r
#endif\r
\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
\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
\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
\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
\r
#endif\r
\r
\r
#if defined(_MSC_EXTENSIONS)\r
\r
//\r
// Disable warning that make it impossible to compile at /W4\r
// This only works for Microsoft* tools\r
//\r
\r
//\r
// Disabling bitfield type checking warnings.\r
//\r
#pragma warning ( disable : 4214 )\r
\r
//\r
// Disabling the unreferenced formal parameter warnings.\r
//\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
\r
//\r
// ASSERT(FALSE) or while (TRUE) are legal constructs so suppress this warning\r
//\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
\r
//\r
// This warning is caused by empty (after preprocessing) source file. For precompiled header only.\r
//\r
#pragma warning ( disable : 4206 )\r
\r
#if _MSC_VER == 1800 || _MSC_VER == 1900 || _MSC_VER >= 1910\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 and VS2015 build\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 and VS2015 build\r
//\r
#pragma warning ( disable : 4703 )\r
\r
#endif\r
\r
#endif\r
\r
\r
#if defined(_MSC_EXTENSIONS)\r
\r
  //\r
  // use Microsoft C compiler 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
#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
///\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
\r
//\r
// Processor specific defines\r
//\r
\r
///\r
/// A value of native width with the highest bit set.\r
///\r
#define MAX_BIT     0x80000000\r
///\r
/// A value of native width with the two highest bits set.\r
///\r
#define MAX_2_BITS  0xC0000000\r
\r
///\r
/// Maximum legal IA-32 address.\r
///\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
///\r
#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
\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
// use the correct C calling convention. All protocol member functions and\r
// 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
#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
#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
#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
  so the implementation of this macro is very simple.\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
#define FUNCTION_ENTRY_POINT(FunctionPointer) (VOID *)(UINTN)(FunctionPointer)\r
\r
#ifndef __USER_LABEL_PREFIX__\r
#define __USER_LABEL_PREFIX__ _\r
#endif\r
\r
#endif\r
\r