BaseTools/Source/C/Include/Common/BaseTypes.h

   1 /** @file
   2   Processor or Compiler specific defines for all supported processors.
   3
   4   This file is stand alone self consistent set of definitions.
   5
   6   Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>
   7   This program and the accompanying materials
   8   are licensed and made available under the terms and conditions of the BSD License
   9   which accompanies this distribution.  The full text of the license may be found at
  10   http://opensource.org/licenses/bsd-license.php
  11
  12   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  13   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  14
  15 **/
  16
  17 #ifndef __BASE_TYPES_H__
  18 #define __BASE_TYPES_H__
  19
  20 //
  21 // Include processor specific binding
  22 //
  23 #include <ProcessorBind.h>
  24 #include <stdarg.h>
  25
  26 //
  27 // Modifiers to abstract standard types to aid in debug of problems
  28 //
  29 #define CONST     const
  30 #define STATIC    static
  31 #define VOID      void
  32
  33 //
  34 // Modifiers for Data Types used to self document code.
  35 // This concept is borrowed for UEFI specification.
  36 //
  37 #ifndef IN
  38 //
  39 // Some other environments use this construct, so #ifndef to prevent
  40 // multiple definition.
  41 //
  42 #define IN
  43 #define OUT
  44 #define OPTIONAL
  45 #endif
  46
  47 //
  48 // Constants. They may exist in other build structures, so #ifndef them.
  49 //
  50 #ifndef TRUE
  51 //
  52 // BugBug: UEFI specification claims 1 and 0. We are concerned about the
  53 //  complier portability so we did it this way.
  54 //
  55 #define TRUE  ((BOOLEAN)(1==1))
  56 #endif
  57
  58 #ifndef FALSE
  59 #define FALSE ((BOOLEAN)(0==1))
  60 #endif
  61
  62 #ifndef NULL
  63 #define NULL  ((VOID *) 0)
  64 #endif
  65
  66 //
  67 //  Support for variable length argument lists using the ANSI standard.
  68 //
  69 //  Since we are using the ANSI standard we used the standard naming and
  70 //  did not follow the coding convention
  71 //
  72 //  VA_LIST  - typedef for argument list.
  73 //  VA_START (VA_LIST Marker, argument before the ...) - Init Marker for use.
  74 //  VA_END (VA_LIST Marker) - Clear Marker
  75 //  VA_ARG (VA_LIST Marker, var arg size) - Use Marker to get an argument from
  76 //    the ... list. You must know the size and pass it in this macro.
  77 //
  78 //  example:
  79 //
  80 //  UINTN
  81 //  ExampleVarArg (
  82 //    IN UINTN  NumberOfArgs,
  83 //    ...
  84 //    )
  85 //  {
  86 //    VA_LIST Marker;
  87 //    UINTN   Index;
  88 //    UINTN   Result;
  89 //
  90 //    //
  91 //    // Initialize the Marker
  92 //    //
  93 //    VA_START (Marker, NumberOfArgs);
  94 //    for (Index = 0, Result = 0; Index < NumberOfArgs; Index++) {
  95 //      //
  96 //      // The ... list is a series of UINTN values, so average them up.
  97 //      //
  98 //      Result += VA_ARG (Marker, UINTN);
  99 //    }
 100 //
 101 //    VA_END (Marker);
 102 //    return Result
 103 //  }
 104 //
 105
 106 #define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))
 107
 108 //
 109 // Also support coding convention rules for var arg macros
 110 //
 111 #ifndef VA_START
 112
 113 // typedef CHAR8 *VA_LIST;
 114 // #define VA_START(ap, v) (ap = (VA_LIST) & (v) + _INT_SIZE_OF (v))
 115 // #define VA_ARG(ap, t)   (*(t *) ((ap += _INT_SIZE_OF (t)) - _INT_SIZE_OF (t)))
 116 // #define VA_END(ap)      (ap = (VA_LIST) 0)
 117 // Use the native arguments for tools.
 118 #define VA_START va_start
 119 #define VA_ARG   va_arg
 120 #define VA_END   va_end
 121 #define VA_LIST  va_list
 122
 123 #endif
 124
 125 #ifndef GUID_DEFINED
 126 #define GUID_DEFINED
 127 ///
 128 /// 128 bit buffer containing a unique identifier value.
 129 /// Unless otherwise specified, aligned on a 64 bit boundary.
 130 ///
 131 typedef struct {
 132   UINT32  Data1;
 133   UINT16  Data2;
 134   UINT16  Data3;
 135   UINT8   Data4[8];
 136 } GUID;
 137 #endif
 138
 139 ///
 140 /// 4-byte buffer. An IPv4 internet protocol address.
 141 ///
 142 typedef struct {
 143   UINT8 Addr[4];
 144 } IPv4_ADDRESS;
 145
 146 ///
 147 /// 16-byte buffer. An IPv6 internet protocol address.
 148 ///
 149 typedef struct {
 150   UINT8 Addr[16];
 151 } IPv6_ADDRESS;
 152
 153 //
 154 // Macro that returns the byte offset of a field in a data structure.
 155 //
 156 #define OFFSET_OF(TYPE, Field) ((UINTN) &(((TYPE *)0)->Field))
 157
 158 ///
 159 ///  _CR - returns a pointer to the structure
 160 ///      from one of it's elements.
 161 ///
 162 #define _CR(Record, TYPE, Field)  ((TYPE *) ((CHAR8 *) (Record) - (CHAR8 *) &(((TYPE *) 0)->Field)))
 163
 164 ///
 165 ///  ALIGN_POINTER - aligns a pointer to the lowest boundary
 166 ///
 167 #define ALIGN_POINTER(p, s) ((VOID *) ((UINTN)(p) + (((s) - ((UINTN) (p))) & ((s) - 1))))
 168
 169 ///
 170 ///  ALIGN_VARIABLE - aligns a variable up to the next natural boundary for int size of a processor
 171 ///
 172 #define ALIGN_VARIABLE(Value, Adjustment) \
 173   Adjustment = 0U; \
 174   if ((UINTN) (Value) % sizeof (UINTN)) { \
 175     (Adjustment) = (UINTN)(sizeof (UINTN) - ((UINTN) (Value) % sizeof (UINTN))); \
 176   } \
 177   (Value) = (UINTN)((UINTN) (Value) + (UINTN) (Adjustment))
 178
 179 //
 180 // Return the maximum of two operands.
 181 // This macro returns the maximum of two operand specified by a and b.
 182 // Both a and b must be the same numerical types, signed or unsigned.
 183 //
 184 #define MAX(a, b)                       \
 185   (((a) > (b)) ? (a) : (b))
 186
 187
 188 //
 189 // Return the minimum of two operands.
 190 // This macro returns the minimal of two operand specified by a and b.
 191 // Both a and b must be the same numerical types, signed or unsigned.
 192 //
 193 #define MIN(a, b)                       \
 194   (((a) < (b)) ? (a) : (b))
 195
 196
 197 //
 198 // EFI Error Codes common to all execution phases
 199 //
 200
 201 typedef UINTN RETURN_STATUS;
 202
 203 ///
 204 /// Set the upper bit to indicate EFI Error.
 205 ///
 206 #define ENCODE_ERROR(a)              ((RETURN_STATUS)(MAX_BIT | (a)))
 207
 208 #define ENCODE_WARNING(a)            ((RETURN_STATUS)(a))
 209 #define RETURN_ERROR(a)              (((INTN)(RETURN_STATUS)(a)) < 0)
 210
 211 #define RETURN_SUCCESS               0
 212 #define RETURN_LOAD_ERROR            ENCODE_ERROR (1)
 213 #define RETURN_INVALID_PARAMETER     ENCODE_ERROR (2)
 214 #define RETURN_UNSUPPORTED           ENCODE_ERROR (3)
 215 #define RETURN_BAD_BUFFER_SIZE       ENCODE_ERROR (4)
 216 #define RETURN_BUFFER_TOO_SMALL      ENCODE_ERROR (5)
 217 #define RETURN_NOT_READY             ENCODE_ERROR (6)
 218 #define RETURN_DEVICE_ERROR          ENCODE_ERROR (7)
 219 #define RETURN_WRITE_PROTECTED       ENCODE_ERROR (8)
 220 #define RETURN_OUT_OF_RESOURCES      ENCODE_ERROR (9)
 221 #define RETURN_VOLUME_CORRUPTED      ENCODE_ERROR (10)
 222 #define RETURN_VOLUME_FULL           ENCODE_ERROR (11)
 223 #define RETURN_NO_MEDIA              ENCODE_ERROR (12)
 224 #define RETURN_MEDIA_CHANGED         ENCODE_ERROR (13)
 225 #define RETURN_NOT_FOUND             ENCODE_ERROR (14)
 226 #define RETURN_ACCESS_DENIED         ENCODE_ERROR (15)
 227 #define RETURN_NO_RESPONSE           ENCODE_ERROR (16)
 228 #define RETURN_NO_MAPPING            ENCODE_ERROR (17)
 229 #define RETURN_TIMEOUT               ENCODE_ERROR (18)
 230 #define RETURN_NOT_STARTED           ENCODE_ERROR (19)
 231 #define RETURN_ALREADY_STARTED       ENCODE_ERROR (20)
 232 #define RETURN_ABORTED               ENCODE_ERROR (21)
 233 #define RETURN_ICMP_ERROR            ENCODE_ERROR (22)
 234 #define RETURN_TFTP_ERROR            ENCODE_ERROR (23)
 235 #define RETURN_PROTOCOL_ERROR        ENCODE_ERROR (24)
 236 #define RETURN_INCOMPATIBLE_VERSION  ENCODE_ERROR (25)
 237 #define RETURN_SECURITY_VIOLATION    ENCODE_ERROR (26)
 238 #define RETURN_CRC_ERROR             ENCODE_ERROR (27)
 239 #define RETURN_END_OF_MEDIA          ENCODE_ERROR (28)
 240 #define RETURN_END_OF_FILE           ENCODE_ERROR (31)
 241
 242 #define RETURN_WARN_UNKNOWN_GLYPH    ENCODE_WARNING (1)
 243 #define RETURN_WARN_DELETE_FAILURE   ENCODE_WARNING (2)
 244 #define RETURN_WARN_WRITE_FAILURE    ENCODE_WARNING (3)
 245 #define RETURN_WARN_BUFFER_TOO_SMALL ENCODE_WARNING (4)
 246
 247 typedef UINT64 PHYSICAL_ADDRESS;
 248
 249 #define  BIT0     0x00000001
 250 #define  BIT1     0x00000002
 251 #define  BIT2     0x00000004
 252 #define  BIT3     0x00000008
 253 #define  BIT4     0x00000010
 254 #define  BIT5     0x00000020
 255 #define  BIT6     0x00000040
 256 #define  BIT7     0x00000080
 257 #define  BIT8     0x00000100
 258 #define  BIT9     0x00000200
 259 #define  BIT10    0x00000400
 260 #define  BIT11    0x00000800
 261 #define  BIT12    0x00001000
 262 #define  BIT13    0x00002000
 263 #define  BIT14    0x00004000
 264 #define  BIT15    0x00008000
 265 #define  BIT16    0x00010000
 266 #define  BIT17    0x00020000
 267 #define  BIT18    0x00040000
 268 #define  BIT19    0x00080000
 269 #define  BIT20    0x00100000
 270 #define  BIT21    0x00200000
 271 #define  BIT22    0x00400000
 272 #define  BIT23    0x00800000
 273 #define  BIT24    0x01000000
 274 #define  BIT25    0x02000000
 275 #define  BIT26    0x04000000
 276 #define  BIT27    0x08000000
 277 #define  BIT28    0x10000000
 278 #define  BIT29    0x20000000
 279 #define  BIT30    0x40000000
 280 #define  BIT31    0x80000000
 281 #define  BIT32    0x0000000100000000ULL
 282 #define  BIT33    0x0000000200000000ULL
 283 #define  BIT34    0x0000000400000000ULL
 284 #define  BIT35    0x0000000800000000ULL
 285 #define  BIT36    0x0000001000000000ULL
 286 #define  BIT37    0x0000002000000000ULL
 287 #define  BIT38    0x0000004000000000ULL
 288 #define  BIT39    0x0000008000000000ULL
 289 #define  BIT40    0x0000010000000000ULL
 290 #define  BIT41    0x0000020000000000ULL
 291 #define  BIT42    0x0000040000000000ULL
 292 #define  BIT43    0x0000080000000000ULL
 293 #define  BIT44    0x0000100000000000ULL
 294 #define  BIT45    0x0000200000000000ULL
 295 #define  BIT46    0x0000400000000000ULL
 296 #define  BIT47    0x0000800000000000ULL
 297 #define  BIT48    0x0001000000000000ULL
 298 #define  BIT49    0x0002000000000000ULL
 299 #define  BIT50    0x0004000000000000ULL
 300 #define  BIT51    0x0008000000000000ULL
 301 #define  BIT52    0x0010000000000000ULL
 302 #define  BIT53    0x0020000000000000ULL
 303 #define  BIT54    0x0040000000000000ULL
 304 #define  BIT55    0x0080000000000000ULL
 305 #define  BIT56    0x0100000000000000ULL
 306 #define  BIT57    0x0200000000000000ULL
 307 #define  BIT58    0x0400000000000000ULL
 308 #define  BIT59    0x0800000000000000ULL
 309 #define  BIT60    0x1000000000000000ULL
 310 #define  BIT61    0x2000000000000000ULL
 311 #define  BIT62    0x4000000000000000ULL
 312 #define  BIT63    0x8000000000000000ULL
 313
 314 #endif