xref: /netbsd-src/sys/external/bsd/gnu-efi/dist/inc/aarch64/efibind.h (revision 35ff39e48f27cc4d27af726cb651cda505a965b4)
1 /*	$NetBSD: efibind.h,v 1.3 2021/09/30 19:02:47 jmcneill Exp $	*/
2 
3 /*
4  * Copright (C) 2014 - 2015 Linaro Ltd.
5  * Author: Ard Biesheuvel <ard.biesheuvel@linaro.org>
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice and this list of conditions, without modification.
12  * 2. The name of the author may not be used to endorse or promote products
13  *    derived from this software without specific prior written permission.
14  *
15  * Alternatively, this software may be distributed under the terms of the
16  * GNU General Public License as published by the Free Software Foundation;
17  * either version 2 of the License, or (at your option) any later version.
18  */
19 
20 #if !defined(_MSC_VER) && (!defined(__STDC_VERSION__) || (__STDC_VERSION__ < 199901L )) && !defined(__cplusplus)
21 
22 // ANSI C 1999/2000 stdint.h integer width declarations
23 
24 typedef unsigned long       uint64_t;
25 typedef long                int64_t;
26 typedef unsigned int        uint32_t;
27 typedef int                 int32_t;
28 typedef unsigned short      uint16_t;
29 typedef short               int16_t;
30 typedef unsigned char       uint8_t;
31 typedef signed char         int8_t;   // unqualified 'char' is unsigned on ARM
32 typedef uint64_t            uintptr_t;
33 typedef int64_t             intptr_t;
34 
35 #elif defined(__NetBSD__)
36 #include <sys/stdint.h>
37 #else
38 #include <stdint.h>
39 #endif
40 
41 //
42 // Basic EFI types of various widths
43 //
44 
45 #ifndef __WCHAR_TYPE__
46 # define __WCHAR_TYPE__ short
47 #endif
48 
49 typedef uint64_t   UINT64;
50 typedef int64_t    INT64;
51 
52 typedef uint32_t   UINT32;
53 typedef int32_t    INT32;
54 
55 typedef uint16_t   UINT16;
56 typedef int16_t    INT16;
57 typedef uint8_t    UINT8;
58 typedef int8_t     INT8;
59 typedef __WCHAR_TYPE__ WCHAR;
60 
61 #undef VOID
62 #define VOID    void
63 
64 typedef int64_t    INTN;
65 typedef uint64_t   UINTN;
66 
67 #define EFIERR(a)           (0x8000000000000000 | a)
68 #define EFI_ERROR_MASK      0x8000000000000000
69 #define EFIERR_OEM(a)       (0xc000000000000000 | a)
70 
71 #define BAD_POINTER         0xFBFBFBFBFBFBFBFB
72 #define MAX_ADDRESS         0xFFFFFFFFFFFFFFFF
73 
74 #define BREAKPOINT()        while (TRUE);    // Make it hang on Bios[Dbg]32
75 
76 //
77 // Pointers must be aligned to these address to function
78 //
79 
80 #define MIN_ALIGNMENT_SIZE  8
81 
82 #define ALIGN_VARIABLE(Value ,Adjustment) \
83             (UINTN)Adjustment = 0; \
84             if((UINTN)Value % MIN_ALIGNMENT_SIZE) \
85                 (UINTN)Adjustment = MIN_ALIGNMENT_SIZE - ((UINTN)Value % MIN_ALIGNMENT_SIZE); \
86             Value = (UINTN)Value + (UINTN)Adjustment
87 
88 
89 //
90 // Define macros to build data structure signatures from characters.
91 //
92 
93 #define EFI_SIGNATURE_16(A,B)             ((A) | (B<<8))
94 #define EFI_SIGNATURE_32(A,B,C,D)         (EFI_SIGNATURE_16(A,B)     | (EFI_SIGNATURE_16(C,D)     << 16))
95 #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))
96 
97 //
98 // EFIAPI - prototype calling convention for EFI function pointers
99 // BOOTSERVICE - prototype for implementation of a boot service interface
100 // RUNTIMESERVICE - prototype for implementation of a runtime service interface
101 // RUNTIMEFUNCTION - prototype for implementation of a runtime function that is not a service
102 // RUNTIME_CODE - pragma macro for declaring runtime code
103 //
104 
105 #ifndef EFIAPI          // Forces EFI calling conventions reguardless of compiler options
106 #define EFIAPI          // Substitute expresion to force C calling convention
107 #endif
108 
109 #define BOOTSERVICE
110 #define RUNTIMESERVICE
111 #define RUNTIMEFUNCTION
112 
113 
114 #define RUNTIME_CODE(a)         alloc_text("rtcode", a)
115 #define BEGIN_RUNTIME_DATA()    data_seg("rtdata")
116 #define END_RUNTIME_DATA()      data_seg("")
117 
118 #define VOLATILE                volatile
119 
120 #define MEMORY_FENCE            __sync_synchronize
121 
122 //
123 // When build similiar to FW, then link everything together as
124 // one big module. For the MSVC toolchain, we simply tell the
125 // linker what our driver init function is using /ENTRY.
126 //
127 #if defined(_MSC_EXTENSIONS)
128 #define EFI_DRIVER_ENTRY_POINT(InitFunction) \
129     __pragma(comment(linker, "/ENTRY:" # InitFunction))
130 #else
131 #define EFI_DRIVER_ENTRY_POINT(InitFunction)    \
132     UINTN                                       \
133     InitializeDriver (                          \
134         VOID    *ImageHandle,                   \
135         VOID    *SystemTable                    \
136         )                                       \
137     {                                           \
138         return InitFunction(ImageHandle,        \
139                 SystemTable);                   \
140     }                                           \
141                                                 \
142     EFI_STATUS efi_main(                        \
143         EFI_HANDLE image,                       \
144         EFI_SYSTEM_TABLE *systab                \
145         ) __attribute__((weak,                  \
146                 alias ("InitializeDriver")));
147 #endif
148 
149 #define LOAD_INTERNAL_DRIVER(_if, type, name, entry)    \
150         (_if)->LoadInternal(type, name, entry)
151 
152 
153 //
154 // Some compilers don't support the forward reference construct:
155 //  typedef struct XXXXX
156 //
157 // The following macro provide a workaround for such cases.
158 
159 #define INTERFACE_DECL(x) struct x
160 
161 #define uefi_call_wrapper(func, va_num, ...) func(__VA_ARGS__)
162 #define EFI_FUNCTION
163