1 /* $NetBSD: efibind.h,v 1.5 2021/09/30 19:02:47 jmcneill Exp $ */ 2 3 /*++ 4 5 Copyright (c) 1998 Intel Corporation 6 7 Module Name: 8 9 efefind.h 10 11 Abstract: 12 13 EFI to compile bindings 14 15 16 17 18 Revision History 19 20 --*/ 21 22 #ifndef __GNUC__ 23 #pragma pack() 24 #endif 25 26 // 27 // Basic int types of various widths 28 // 29 30 #if !defined(__STDC_VERSION__) || (__STDC_VERSION__ < 199901L ) && !defined(__cplusplus) 31 32 // No ANSI C 1999/2000 stdint.h integer width declarations 33 34 #if defined(_MSC_EXTENSIONS) 35 36 // Use Microsoft C compiler integer width declarations 37 38 typedef unsigned __int64 uint64_t; 39 typedef __int64 int64_t; 40 typedef unsigned __int32 uint32_t; 41 typedef __int32 int32_t; 42 typedef unsigned short uint16_t; 43 typedef short int16_t; 44 typedef unsigned char uint8_t; 45 typedef char int8_t; 46 #elif defined(__GNUC__) 47 typedef int __attribute__((__mode__(__DI__))) int64_t; 48 typedef unsigned int __attribute__((__mode__(__DI__))) uint64_t; 49 typedef unsigned int uint32_t; 50 typedef int int32_t; 51 typedef unsigned short uint16_t; 52 typedef short int16_t; 53 typedef unsigned char uint8_t; 54 typedef signed char int8_t; 55 #elif defined(UNIX_LP64) 56 57 /* Use LP64 programming model from C_FLAGS for integer width declarations */ 58 59 typedef unsigned long uint64_t; 60 typedef long int64_t; 61 typedef unsigned int uint32_t; 62 typedef int int32_t; 63 typedef unsigned short uint16_t; 64 typedef short int16_t; 65 typedef unsigned char uint8_t; 66 typedef char int8_t; 67 #else 68 69 /* Assume P64 programming model from C_FLAGS for integer width declarations */ 70 71 typedef unsigned long long uint64_t __attribute__((aligned (8))); 72 typedef long long int64_t __attribute__((aligned (8))); 73 typedef unsigned int uint32_t; 74 typedef int int32_t; 75 typedef unsigned short uint16_t; 76 typedef short int16_t; 77 typedef unsigned char uint8_t; 78 typedef char int8_t; 79 #endif 80 typedef uint32_t uintptr_t; 81 typedef int32_t intptr_t; 82 #elif defined(__NetBSD__) 83 #include <sys/stdint.h> 84 #elif defined(__GNUC__) 85 #include <stdint.h> 86 #endif 87 88 // 89 // Basic EFI types of various widths 90 // 91 92 #ifndef __WCHAR_TYPE__ 93 # define __WCHAR_TYPE__ short 94 #endif 95 96 #ifndef __ACTYPES_H__ 97 typedef uint64_t UINT64; 98 typedef int64_t INT64; 99 100 #ifndef _BASETSD_H_ 101 typedef uint32_t UINT32; 102 typedef int32_t INT32; 103 #endif 104 105 typedef uint16_t UINT16; 106 typedef int16_t INT16; 107 typedef uint8_t UINT8; 108 typedef int8_t INT8; 109 #endif /* __ACTYPES_H__ */ 110 typedef __WCHAR_TYPE__ WCHAR; 111 112 #undef VOID 113 #define VOID void 114 115 116 typedef int32_t INTN; 117 typedef uint32_t UINTN; 118 119 #ifdef EFI_NT_EMULATOR 120 #define POST_CODE(_Data) 121 #else 122 #ifdef EFI_DEBUG 123 #define POST_CODE(_Data) __asm mov eax,(_Data) __asm out 0x80,al 124 #else 125 #define POST_CODE(_Data) 126 #endif 127 #endif 128 129 #define EFIERR(a) (0x80000000 | a) 130 #define EFI_ERROR_MASK 0x80000000 131 #define EFIERR_OEM(a) (0xc0000000 | a) 132 133 134 #define BAD_POINTER 0xFBFBFBFB 135 #define MAX_ADDRESS 0xFFFFFFFF 136 137 #ifdef EFI_NT_EMULATOR 138 #define BREAKPOINT() __asm { int 3 } 139 #else 140 #define BREAKPOINT() while (TRUE); // Make it hang on Bios[Dbg]32 141 #endif 142 143 // 144 // Pointers must be aligned to these address to function 145 // 146 147 #define MIN_ALIGNMENT_SIZE 4 148 149 #define ALIGN_VARIABLE(Value ,Adjustment) \ 150 (UINTN)Adjustment = 0; \ 151 if((UINTN)Value % MIN_ALIGNMENT_SIZE) \ 152 (UINTN)Adjustment = MIN_ALIGNMENT_SIZE - ((UINTN)Value % MIN_ALIGNMENT_SIZE); \ 153 Value = (UINTN)Value + (UINTN)Adjustment 154 155 156 // 157 // Define macros to build data structure signatures from characters. 158 // 159 160 #define EFI_SIGNATURE_16(A,B) ((A) | (B<<8)) 161 #define EFI_SIGNATURE_32(A,B,C,D) (EFI_SIGNATURE_16(A,B) | (EFI_SIGNATURE_16(C,D) << 16)) 162 #define EFI_SIGNATURE_64(A,B,C,D,E,F,G,H) (EFI_SIGNATURE_32(A,B,C,D) | ((UINT64)(EFI_SIGNATURE_32(E,F,G,H)) << 32)) 163 // 164 // To export & import functions in the EFI emulator environment 165 // 166 167 #ifdef EFI_NT_EMULATOR 168 #define EXPORTAPI __declspec( dllexport ) 169 #else 170 #define EXPORTAPI 171 #endif 172 173 174 // 175 // EFIAPI - prototype calling convention for EFI function pointers 176 // BOOTSERVICE - prototype for implementation of a boot service interface 177 // RUNTIMESERVICE - prototype for implementation of a runtime service interface 178 // RUNTIMEFUNCTION - prototype for implementation of a runtime function that is not a service 179 // RUNTIME_CODE - pragma macro for declaring runtime code 180 // 181 182 #ifndef EFIAPI // Forces EFI calling conventions reguardless of compiler options 183 #ifdef _MSC_EXTENSIONS 184 #define EFIAPI __cdecl // Force C calling convention for Microsoft C compiler 185 #else 186 #define EFIAPI // Substitute expresion to force C calling convention 187 #endif 188 #endif 189 190 #define BOOTSERVICE 191 //#define RUNTIMESERVICE(proto,a) alloc_text("rtcode",a); proto a 192 //#define RUNTIMEFUNCTION(proto,a) alloc_text("rtcode",a); proto a 193 #define RUNTIMESERVICE 194 #define RUNTIMEFUNCTION 195 196 197 #define RUNTIME_CODE(a) alloc_text("rtcode", a) 198 #define BEGIN_RUNTIME_DATA() data_seg("rtdata") 199 #define END_RUNTIME_DATA() data_seg("") 200 201 #define VOLATILE volatile 202 203 #define MEMORY_FENCE() 204 205 #ifdef EFI_NT_EMULATOR 206 207 // 208 // To help ensure proper coding of integrated drivers, they are 209 // compiled as DLLs. In NT they require a dll init entry pointer. 210 // The macro puts a stub entry point into the DLL so it will load. 211 // 212 213 #define EFI_DRIVER_ENTRY_POINT(InitFunction) \ 214 UINTN \ 215 __stdcall \ 216 _DllMainCRTStartup ( \ 217 UINTN Inst, \ 218 UINTN reason_for_call, \ 219 VOID *rserved \ 220 ) \ 221 { \ 222 return 1; \ 223 } \ 224 \ 225 int \ 226 EXPORTAPI \ 227 __cdecl \ 228 InitializeDriver ( \ 229 void *ImageHandle, \ 230 void *SystemTable \ 231 ) \ 232 { \ 233 return InitFunction(ImageHandle, SystemTable); \ 234 } 235 236 237 #define LOAD_INTERNAL_DRIVER(_if, type, name, entry) \ 238 (_if)->LoadInternal(type, name, NULL) 239 240 #else // EFI_NT_EMULATOR 241 242 // 243 // When build similiar to FW, then link everything together as 244 // one big module. For the MSVC toolchain, we simply tell the 245 // linker what our driver init function is using /ENTRY. 246 // 247 #if defined(_MSC_EXTENSIONS) 248 #define EFI_DRIVER_ENTRY_POINT(InitFunction) \ 249 __pragma(comment(linker, "/ENTRY:" # InitFunction)) 250 #else 251 #define EFI_DRIVER_ENTRY_POINT(InitFunction) \ 252 UINTN \ 253 InitializeDriver ( \ 254 VOID *ImageHandle, \ 255 VOID *SystemTable \ 256 ) \ 257 { \ 258 return InitFunction(ImageHandle, \ 259 SystemTable); \ 260 } \ 261 \ 262 EFI_STATUS efi_main( \ 263 EFI_HANDLE image, \ 264 EFI_SYSTEM_TABLE *systab \ 265 ) __attribute__((weak, \ 266 alias ("InitializeDriver"))); 267 #endif 268 269 #define LOAD_INTERNAL_DRIVER(_if, type, name, entry) \ 270 (_if)->LoadInternal(type, name, entry) 271 272 #endif // EFI_FW_NT 273 274 // 275 // Some compilers don't support the forward reference construct: 276 // typedef struct XXXXX 277 // 278 // The following macro provide a workaround for such cases. 279 // 280 #ifdef NO_INTERFACE_DECL 281 #define INTERFACE_DECL(x) 282 #else 283 #if defined(__GNUC__) || defined(_MSC_EXTENSIONS) 284 #define INTERFACE_DECL(x) struct x 285 #else 286 #define INTERFACE_DECL(x) typedef struct x 287 #endif 288 #endif 289 290 /* No efi call wrapper for IA32 architecture */ 291 #define uefi_call_wrapper(func, va_num, ...) func(__VA_ARGS__) 292 #define EFI_FUNCTION 293 294 #ifdef _MSC_EXTENSIONS 295 #pragma warning ( disable : 4731 ) // Suppress warnings about modification of EBP 296 #endif 297 298