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