MdePkg: Apply uncrustify changes

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

/** @file\r
  Processor or Compiler specific defines and types x64 (Intel 64, AMD64).\r
\r
  Copyright (c) 2006 - 2019, 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_X64\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 (__GNUC__) && defined (__pic__) && !defined (USING_LTO)  && !defined (__APPLE__)\r
//\r
// Mark all symbol declarations and references as hidden, meaning they will\r
// not be subject to symbol preemption. This allows the compiler to refer to\r
// symbols directly using relative references rather than via the GOT, which\r
// contains absolute symbol addresses that are subject to runtime relocation.\r
//\r
// The LTO linker will not emit GOT based relocations when all symbol\r
// references can be resolved locally, and so there is no need to set the\r
// pragma in that case (and doing so will cause other issues).\r
//\r
  #pragma GCC visibility push (hidden)\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
#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 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 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
#if defined (_MSC_EXTENSIONS)\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 UINT64 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 INT64 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  0x8000000000000000ULL\r
///\r
/// A value of native width with the two highest bits set.\r
///\r
#define MAX_2_BITS  0xC000000000000000ULL\r
\r
///\r
/// Maximum legal x64 address\r
///\r
#define MAX_ADDRESS  0xFFFFFFFFFFFFFFFFULL\r
\r
///\r
/// Maximum usable address at boot time\r
///\r
#define MAX_ALLOC_ADDRESS  MAX_ADDRESS\r
\r
///\r
/// Maximum legal x64 INTN and UINTN values.\r
///\r
#define MAX_INTN   ((INTN)0x7FFFFFFFFFFFFFFFULL)\r
#define MAX_UINTN  ((UINTN)0xFFFFFFFFFFFFFFFFULL)\r
\r
///\r
/// Minimum legal x64 INTN value.\r
///\r
#define MIN_INTN  (((INTN)-9223372036854775807LL) - 1)\r
\r
///\r
/// The stack alignment required for x64\r
///\r
#define CPU_STACK_ALIGNMENT  16\r
\r
///\r
/// Page allocation granularity for x64\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
/// Define the standard calling convention regardless of optimization level.\r
/// The GCC support assumes a GCC compiler that supports the EFI ABI. The EFI\r
/// ABI is much closer to the x64 Microsoft* ABI than standard x64 (x86-64)\r
/// GCC ABI. Thus a standard x64 (x86-64) GCC compiler can not be used for\r
/// x64. Warning the assembly code in the MDE x64 does not follow the correct\r
/// ABI for the standard x64 (x86-64) GCC.\r
///\r
#define EFIAPI\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__) || 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 x64 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