MdeModulePkg DxePrintLibPrint2Protocol Library SPrintLength() API issue.
[mirror_edk2.git] / MdePkg / Include / X64 / ProcessorBind.h
CommitLineData
959ccb23 1/** @file\r
1a2f870c 2 Processor or Compiler specific defines and types x64 (Intel 64, AMD64).\r
959ccb23 3\r
068a82fc 4 Copyright (c) 2006 - 2013, Intel Corporation. All rights reserved.<BR>\r
9df063a0 5 This program and the accompanying materials \r
959ccb23 6 are licensed and made available under the terms and conditions of the BSD License \r
7 which accompanies this distribution. The full text of the license may be found at \r
8 http://opensource.org/licenses/bsd-license.php \r
9\r
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
12\r
959ccb23 13**/\r
14\r
15#ifndef __PROCESSOR_BIND_H__\r
16#define __PROCESSOR_BIND_H__\r
17\r
fb5148a0 18///\r
19/// Define the processor type so other code can make processor based choices\r
20///\r
959ccb23 21#define MDE_CPU_X64\r
22\r
959ccb23 23//\r
3963c4bf 24// Make sure we are using the correct packing rules per EFI specification\r
959ccb23 25//\r
5cfbd055 26#if !defined(__GNUC__)\r
959ccb23 27#pragma pack()\r
28#endif\r
29\r
b483e395 30\r
5cfbd055 31#if defined(__INTEL_COMPILER)\r
1fb24cc4 32//\r
33// Disable ICC's remark #869: "Parameter" was never referenced warning.\r
34// This is legal ANSI C code so we disable the remark that is turned on with -Wall\r
35//\r
36#pragma warning ( disable : 869 )\r
37\r
b483e395
A
38//\r
39// Disable ICC's remark #1418: external function definition with no prior declaration.\r
40// This is legal ANSI C code so we disable the remark that is turned on with /W4\r
41//\r
42#pragma warning ( disable : 1418 )\r
43\r
b483e395
A
44//\r
45// Disable ICC's remark #1419: external declaration in primary source file\r
46// This is legal ANSI C code so we disable the remark that is turned on with /W4\r
47//\r
48#pragma warning ( disable : 1419 )\r
49\r
8fe69f13 50//\r
51// Disable ICC's remark #593: "Variable" was set but never used.\r
52// This is legal ANSI C code so we disable the remark that is turned on with /W4\r
53//\r
54#pragma warning ( disable : 593 )\r
55\r
b483e395
A
56#endif\r
57\r
58\r
5cfbd055 59#if defined(_MSC_EXTENSIONS)\r
1fb24cc4 60\r
959ccb23 61//\r
62// Disable warning that make it impossible to compile at /W4\r
63// This only works for Microsoft* tools\r
64//\r
65\r
66//\r
67// Disabling bitfield type checking warnings.\r
68//\r
69#pragma warning ( disable : 4214 )\r
70\r
71//\r
72// Disabling the unreferenced formal parameter warnings.\r
73//\r
74#pragma warning ( disable : 4100 )\r
75\r
76//\r
77// Disable slightly different base types warning as CHAR8 * can not be set\r
78// to a constant string.\r
79//\r
80#pragma warning ( disable : 4057 )\r
81\r
82//\r
83// ASSERT(FALSE) or while (TRUE) are legal constructes so supress this warning\r
84//\r
85#pragma warning ( disable : 4127 )\r
86\r
87//\r
88// This warning is caused by functions defined but not used. For precompiled header only.\r
89//\r
90#pragma warning ( disable : 4505 )\r
91\r
92//\r
3963c4bf 93// This warning is caused by empty (after preprocessing) source file. For precompiled header only.\r
959ccb23 94//\r
95#pragma warning ( disable : 4206 )\r
96\r
97#endif\r
98\r
99\r
52aa9e13 100#if defined(_MSC_EXTENSIONS)\r
959ccb23 101 //\r
52aa9e13 102 // use Microsoft C complier dependent integer width types \r
959ccb23 103 //\r
f4ec40ab 104\r
52aa9e13
EB
105 ///\r
106 /// 8-byte unsigned value\r
107 ///\r
108 typedef unsigned __int64 UINT64;\r
109 ///\r
110 /// 8-byte signed value\r
111 ///\r
112 typedef __int64 INT64;\r
113 ///\r
114 /// 4-byte unsigned value\r
115 ///\r
116 typedef unsigned __int32 UINT32;\r
117 ///\r
118 /// 4-byte signed value\r
119 ///\r
120 typedef __int32 INT32;\r
121 ///\r
122 /// 2-byte unsigned value\r
123 ///\r
124 typedef unsigned short UINT16;\r
125 ///\r
126 /// 2-byte Character. Unless otherwise specified all strings are stored in the\r
127 /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
128 ///\r
129 typedef unsigned short CHAR16;\r
130 ///\r
131 /// 2-byte signed value\r
132 ///\r
133 typedef short INT16;\r
f4ec40ab 134 ///\r
135 /// Logical Boolean. 1-byte value containing 0 for FALSE or a 1 for TRUE. Other\r
136 /// values are undefined.\r
137 ///\r
52aa9e13
EB
138 typedef unsigned char BOOLEAN;\r
139 ///\r
140 /// 1-byte unsigned value\r
141 ///\r
142 typedef unsigned char UINT8;\r
143 ///\r
144 /// 1-byte Character\r
145 ///\r
146 typedef char CHAR8;\r
f4ec40ab 147 ///\r
148 /// 1-byte signed value\r
149 ///\r
d22ebbe3 150 typedef signed char INT8;\r
52aa9e13 151#else\r
f4ec40ab 152 ///\r
52aa9e13 153 /// 8-byte unsigned value\r
f4ec40ab 154 ///\r
52aa9e13 155 typedef unsigned long long UINT64;\r
f4ec40ab 156 ///\r
52aa9e13 157 /// 8-byte signed value\r
f4ec40ab 158 ///\r
52aa9e13 159 typedef long long INT64;\r
f4ec40ab 160 ///\r
52aa9e13 161 /// 4-byte unsigned value\r
f4ec40ab 162 ///\r
52aa9e13 163 typedef unsigned int UINT32;\r
f4ec40ab 164 ///\r
165 /// 4-byte signed value\r
166 ///\r
52aa9e13 167 typedef int INT32;\r
f4ec40ab 168 ///\r
52aa9e13 169 /// 2-byte unsigned value\r
f4ec40ab 170 ///\r
52aa9e13 171 typedef unsigned short UINT16;\r
f4ec40ab 172 ///\r
52aa9e13
EB
173 /// 2-byte Character. Unless otherwise specified all strings are stored in the\r
174 /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.\r
f4ec40ab 175 ///\r
52aa9e13 176 typedef unsigned short CHAR16;\r
f4ec40ab 177 ///\r
52aa9e13
EB
178 /// 2-byte signed value\r
179 ///\r
180 typedef short INT16;\r
181 ///\r
182 /// Logical Boolean. 1-byte value containing 0 for FALSE or a 1 for TRUE. Other\r
183 /// values are undefined.\r
f4ec40ab 184 ///\r
52aa9e13
EB
185 typedef unsigned char BOOLEAN;\r
186 ///\r
187 /// 1-byte unsigned value\r
188 ///\r
189 typedef unsigned char UINT8;\r
f4ec40ab 190 ///\r
191 /// 1-byte Character\r
192 ///\r
52aa9e13 193 typedef char CHAR8;\r
f4ec40ab 194 ///\r
52aa9e13 195 /// 1-byte signed value\r
f4ec40ab 196 ///\r
d22ebbe3 197 typedef signed char INT8;\r
959ccb23 198#endif\r
199\r
f4ec40ab 200///\r
201/// Unsigned value of native width. (4 bytes on supported 32-bit processor instructions,\r
202/// 8 bytes on supported 64-bit processor instructions)\r
203///\r
959ccb23 204typedef UINT64 UINTN;\r
f4ec40ab 205///\r
206/// Signed value of native width. (4 bytes on supported 32-bit processor instructions,\r
207/// 8 bytes on supported 64-bit processor instructions)\r
208///\r
959ccb23 209typedef INT64 INTN;\r
210\r
211\r
212//\r
213// Processor specific defines\r
214//\r
f4ec40ab 215\r
216///\r
217/// A value of native width with the highest bit set.\r
218///\r
959ccb23 219#define MAX_BIT 0x8000000000000000ULL\r
f4ec40ab 220///\r
221/// A value of native width with the two highest bits set.\r
222///\r
959ccb23 223#define MAX_2_BITS 0xC000000000000000ULL\r
224\r
f4ec40ab 225///\r
226/// Maximum legal x64 address\r
227///\r
959ccb23 228#define MAX_ADDRESS 0xFFFFFFFFFFFFFFFFULL\r
229\r
068a82fc
LG
230///\r
231/// Maximum legal x64 INTN and UINTN values.\r
232///\r
233#define MAX_INTN ((INTN)0x7FFFFFFFFFFFFFFFULL)\r
234#define MAX_UINTN ((UINTN)0xFFFFFFFFFFFFFFFFULL)\r
235\r
f4ec40ab 236///\r
237/// The stack alignment required for x64\r
238///\r
959ccb23 239#define CPU_STACK_ALIGNMENT 16\r
240\r
241//\r
242// Modifier to ensure that all protocol member functions and EFI intrinsics\r
243// use the correct C calling convention. All protocol member functions and\r
f4ec40ab 244// EFI intrinsics are required to modify their member functions with EFIAPI.\r
959ccb23 245//\r
6149e6bb 246#ifdef EFIAPI\r
247 ///\r
248 /// If EFIAPI is already defined, then we use that definition.\r
249 ///\r
250#elif defined(_MSC_EXTENSIONS)\r
959ccb23 251 ///\r
f9080cdd 252 /// Microsoft* compiler specific method for EFIAPI calling convention.\r
959ccb23 253 /// \r
254 #define EFIAPI __cdecl \r
5cfbd055 255#elif defined(__GNUC__)\r
959ccb23 256 ///\r
f9080cdd 257 /// Define the standard calling convention regardless of optimization level.\r
959ccb23 258 /// The GCC support assumes a GCC compiler that supports the EFI ABI. The EFI\r
259 /// ABI is much closer to the x64 Microsoft* ABI than standard x64 (x86-64) \r
260 /// GCC ABI. Thus a standard x64 (x86-64) GCC compiler can not be used for \r
261 /// x64. Warning the assembly code in the MDE x64 does not follow the correct \r
262 /// ABI for the standard x64 (x86-64) GCC.\r
263 ///\r
264 #define EFIAPI \r
265#else\r
266 ///\r
267 /// The default for a non Microsoft* or GCC compiler is to assume the EFI ABI\r
268 /// is the standard. \r
269 ///\r
270 #define EFIAPI \r
271#endif\r
272\r
5cfbd055 273#if defined(__GNUC__)\r
68167fed 274 ///\r
275 /// For GNU assembly code, .global or .globl can declare global symbols.\r
276 /// Define this macro to unify the usage.\r
277 ///\r
278 #define ASM_GLOBAL .globl\r
27af6b87 279#endif\r
280\r
14996c96
LG
281/**\r
282 Return the pointer to the first instruction of a function given a function pointer.\r
283 On x64 CPU architectures, these two pointer values are the same, \r
284 so the implementation of this macro is very simple.\r
285 \r
3963c4bf 286 @param FunctionPointer A pointer to a function.\r
14996c96
LG
287\r
288 @return The pointer to the first instruction of a function given a function pointer.\r
3963c4bf 289 \r
14996c96 290**/\r
9a1d00cb 291#define FUNCTION_ENTRY_POINT(FunctionPointer) (VOID *)(UINTN)(FunctionPointer)\r
24a7505c 292\r
02eef553
JJ
293#ifndef __USER_LABEL_PREFIX__\r
294#define __USER_LABEL_PREFIX__\r
295#endif\r
296\r
959ccb23 297#endif\r
298\r