1 // Licensed to the .NET Foundation under one or more agreements.
2 // The .NET Foundation licenses this file to you under the MIT license.
3 // See the LICENSE file in the project root for more information.
8 // This file defines tables for references between VM and mscorlib.
10 // When compiling crossgen, this file is compiled with the FEATURE_XXX define settings matching the target.
11 // It allows us to strip features (e.g. refection only load) from crossgen without stripping them from the target.
14 #ifdef CROSSGEN_MSCORLIB
15 // Use minimal set of headers for crossgen
21 #endif // CROSSGEN_MSCORLIB
23 #ifndef CROSSGEN_COMPILE
25 // Headers for all ECall entrypoints
27 #include "arraynative.h"
28 #include "stringnative.h"
29 #include "stringbuffer.h"
30 #include "objectnative.h"
31 #include "comdelegate.h"
32 #include "customattribute.h"
33 #include "comdynamic.h"
37 #include "calendardata.h"
38 #include "commodule.h"
39 #include "marshalnative.h"
41 #include "comutilnative.h"
42 #include "comsynchronizable.h"
43 #include "floatdouble.h"
44 #include "floatsingle.h"
47 #include "comdatetime.h"
49 #include "compatibilityswitch.h"
50 #include "debugdebugger.h"
51 #include "assemblyname.hpp"
52 #include "assemblynative.hpp"
54 #include "comthreadpool.h"
55 #include "comwaithandle.h"
56 #include "nativeoverlapped.h"
58 #include "proftoeeinterfaceimpl.h"
60 #include "appdomainnative.hpp"
61 #include "arrayhelpers.h"
62 #include "runtimehandles.h"
63 #include "reflectioninvocation.h"
64 #include "managedmdimport.hpp"
65 #include "synchronizationcontextnative.h"
66 #include "commemoryfailpoint.h"
67 #include "typestring.h"
68 #include "comdependenthandle.h"
69 #include "weakreferencenative.h"
70 #include "varargsnative.h"
73 #include "mdaassistants.h"
78 #ifdef FEATURE_COMINTEROP
80 #include "oavariant.h"
81 #include "registration.h"
82 #include "mngstdinterfaces.h"
83 #include "extensibleclassfactory.h"
84 #endif // FEATURE_COMINTEROP
86 #include "stubhelpers.h"
87 #include "ilmarshalers.h"
89 #ifdef FEATURE_MULTICOREJIT
90 #include "multicorejit.h"
93 #ifdef FEATURE_COMINTEROP
94 #include "windowsruntimebufferhelper.h"
97 #if defined(FEATURE_EVENTSOURCE_XPLAT)
98 #include "nativeeventsource.h"
99 #endif //defined(FEATURE_EVENTSOURCE_XPLAT)
101 #endif // CROSSGEN_MSCORLIB
104 #ifdef CROSSGEN_MSCORLIB
106 ///////////////////////////////////////////////////////////////////////////////
108 // Duplicate definitions of constants and datastructures required to define the tables
111 #define NumItems(s) (sizeof(s) / sizeof(s[0]))
113 #define GetEEFuncEntryPoint(pfn) 0x1001
116 FCFuncFlag_EndOfArray = 0x01,
117 FCFuncFlag_HasSignature = 0x02,
118 FCFuncFlag_Unreferenced = 0x04, // Suppress unused fcall check
119 FCFuncFlag_QCall = 0x08, // QCall - mscorlib.dll to mscorwks.dll transition implemented as PInvoke
124 LPCSTR m_szClassName;
125 LPCSTR m_szNameSpace;
126 const LPVOID * m_pECFunc;
129 struct HardCodedMetaSig
131 const BYTE* m_pMetaSig; // metasig prefixed with INT8 length:
132 // length > 0 - resolved, lenght < 0 - has unresolved type references
137 #define TYPEINFO(e,ns,c,s,g,ia,ip,if,im,gv) CLASS__ ## e,
138 #include "cortypeinfo.h"
141 #define DEFINE_CLASS(i,n,s) CLASS__ ## i,
142 #include "mscorlib.h"
144 CLASS__MSCORLIB_COUNT,
146 CLASS__VOID = CLASS__ELEMENT_TYPE_VOID,
147 CLASS__BOOLEAN = CLASS__ELEMENT_TYPE_BOOLEAN,
148 CLASS__CHAR = CLASS__ELEMENT_TYPE_CHAR,
149 CLASS__BYTE = CLASS__ELEMENT_TYPE_U1,
150 CLASS__SBYTE = CLASS__ELEMENT_TYPE_I1,
151 CLASS__INT16 = CLASS__ELEMENT_TYPE_I2,
152 CLASS__UINT16 = CLASS__ELEMENT_TYPE_U2,
153 CLASS__INT32 = CLASS__ELEMENT_TYPE_I4,
154 CLASS__UINT32 = CLASS__ELEMENT_TYPE_U4,
155 CLASS__INT64 = CLASS__ELEMENT_TYPE_I8,
156 CLASS__UINT64 = CLASS__ELEMENT_TYPE_U8,
157 CLASS__SINGLE = CLASS__ELEMENT_TYPE_R4,
158 CLASS__DOUBLE = CLASS__ELEMENT_TYPE_R8,
159 CLASS__STRING = CLASS__ELEMENT_TYPE_STRING,
160 CLASS__TYPED_REFERENCE = CLASS__ELEMENT_TYPE_TYPEDBYREF,
161 CLASS__INTPTR = CLASS__ELEMENT_TYPE_I,
162 CLASS__UINTPTR = CLASS__ELEMENT_TYPE_U,
163 CLASS__OBJECT = CLASS__ELEMENT_TYPE_OBJECT
166 struct MscorlibClassDescription
172 struct MscorlibMethodDescription
174 BinderClassID classID;
176 const HardCodedMetaSig * sig;
179 struct MscorlibFieldDescription
181 BinderClassID classID;
185 #endif // CROSSGEN_MSCORLIB
188 #ifdef CROSSGEN_MSCORLIB
189 // When compiling crossgen this namespace creates the second version of the tables than matches the target
190 namespace CrossGenMscorlib {
194 ///////////////////////////////////////////////////////////////////////////////
196 // Hardcoded Meta-Sig
200 // Helper enum with metasig lengths
202 // iterate over the metasig recursing into the complex types
203 #define DEFINE_METASIG(body) body,
204 #define METASIG_ATOM(x) + 1
205 #define METASIG_RECURSE 1
206 #define SM(varname, args, retval) gsigl_SM_ ## varname = 1 + 1 retval args
207 #define IM(varname, args, retval) gsigl_IM_ ## varname = 1 + 1 retval args
208 #define GM(varname, conv, n, args, retval) gsigl_GM_ ## varname = 1 + 1 + 1 + retval args
209 #define Fld(varname, val) gsigl_Fld_ ## varname = 1 val
215 // Helper enum with metasig argcount
217 // iterate over the metasig without recursing into the complex types
218 #define DEFINE_METASIG(body) body,
219 #define METASIG_ATOM(x) + 1
220 #define METASIG_RECURSE 0
221 #define SM(varname, args, retval) gsigc_SM_ ## varname = 0 args
222 #define IM(varname, args, retval) gsigc_IM_ ## varname = 0 args
223 #define GM(varname, conv, n, args, retval) gsigc_GM_ ## varname = 0 args
224 #define Fld(varname, val) gsigc_Fld_ ## varname = 0
231 // The actual array with the hardcoded metasig:
233 // There are 3 variations of the macros for Fields, Static Methods and Instance Methods.
235 // Each of them has 2 flavors: one for the fully baked signatures, and the other
236 // for the signatures with unresolved type references
238 // The signatures with unresolved type references are marked with negative size,
239 // and the pointer to them is non-const because of it will be overwritten with
240 // the pointer to the resolved signature at runtime.
243 #define DEFINE_METASIG(body) body
244 #define DEFINE_METASIG_T(body) _##body
245 #define METASIG_ATOM(x) x,
246 #define METASIG_RECURSE 1
248 // define gsig_ ## varname before gsige_ ## varname to give a hint to the compiler about the desired layout
250 #define SM(varname, args, retval) extern const BYTE gsige_SM_ ## varname[]; \
251 const HardCodedMetaSig gsig_SM_ ## varname = { gsige_SM_ ## varname }; \
252 const BYTE gsige_SM_ ## varname[] = { gsigl_SM_ ## varname, \
253 IMAGE_CEE_CS_CALLCONV_DEFAULT, gsigc_SM_ ## varname, retval args };
255 #define IM(varname, args, retval) extern const BYTE gsige_IM_ ## varname[]; \
256 const HardCodedMetaSig gsig_IM_ ## varname = { gsige_IM_ ## varname }; \
257 const BYTE gsige_IM_ ## varname[] = { gsigl_IM_ ## varname, \
258 IMAGE_CEE_CS_CALLCONV_HASTHIS, gsigc_IM_ ## varname, retval args };
260 #define GM(varname, conv, n, args, retval) extern const BYTE gsige_GM_ ## varname[]; \
261 const HardCodedMetaSig gsig_GM_ ## varname = { gsige_GM_ ## varname }; \
262 const BYTE gsige_GM_ ## varname[] = { gsigl_GM_ ## varname, \
263 conv | IMAGE_CEE_CS_CALLCONV_GENERIC, n, gsigc_GM_ ## varname, retval args };
265 #define Fld(varname, val) extern const BYTE gsige_Fld_ ## varname[]; \
266 const HardCodedMetaSig gsig_Fld_ ## varname = { gsige_Fld_ ## varname }; \
267 const BYTE gsige_Fld_ ## varname[] = { gsigl_Fld_ ## varname, \
268 IMAGE_CEE_CS_CALLCONV_FIELD, val };
270 #define _SM(varname, args, retval) extern const BYTE gsige_SM_ ## varname[]; \
271 HardCodedMetaSig gsig_SM_ ## varname = { gsige_SM_ ## varname }; \
272 const BYTE gsige_SM_ ## varname[] = { (BYTE) -gsigl_SM_ ## varname, \
273 IMAGE_CEE_CS_CALLCONV_DEFAULT, gsigc_SM_ ## varname, retval args };
275 #define _IM(varname, args, retval) extern const BYTE gsige_IM_ ## varname[]; \
276 HardCodedMetaSig gsig_IM_ ## varname = { gsige_IM_ ## varname }; \
277 const BYTE gsige_IM_ ## varname[] = { (BYTE) -gsigl_IM_ ## varname, \
278 IMAGE_CEE_CS_CALLCONV_HASTHIS, gsigc_IM_ ## varname, retval args };
280 #define _Fld(varname, val) extern const BYTE gsige_Fld_ ## varname[]; \
281 HardCodedMetaSig gsig_Fld_ ## varname = { gsige_Fld_ ## varname }; \
282 const BYTE gsige_Fld_ ## varname[] = { (BYTE) -gsigl_Fld_ ## varname, \
283 IMAGE_CEE_CS_CALLCONV_FIELD, val };
296 // Make sure DEFINE_METASIG is used for signatures that do not reference other types
298 // counts number of type references in the signature and C_ASSERTs that
299 // it is zero. An assertion failure results in error C2118: negative subscript.
300 #define DEFINE_METASIG(body) body
301 #define DEFINE_METASIG_T(body)
302 #define METASIG_BODY(varname, types) C_ASSERT(types 0 == 0);
303 #define METASIG_ATOM(x) 0+
304 #define METASIG_RECURSE 1
310 // Make sure DEFINE_METASIG_T is used only for signatures that reference
313 // counts number of type references in the signature and C_ASSERTs that
314 // it is non zero. An assertion failure results in error C2118: negative subscript.
315 #define DEFINE_METASIG(body)
316 #define DEFINE_METASIG_T(body) body
317 #define METASIG_BODY(varname, types) C_ASSERT(types 0 != 0);
318 #define METASIG_ATOM(x) 0+
319 #define METASIG_RECURSE 1
330 ///////////////////////////////////////////////////////////////////////////////
335 // Extern definitions so that binder.cpp can see these tables
336 extern const MscorlibClassDescription c_rgMscorlibClassDescriptions[];
337 extern const USHORT c_nMscorlibClassDescriptions;
339 extern const MscorlibMethodDescription c_rgMscorlibMethodDescriptions[];
340 extern const USHORT c_nMscorlibMethodDescriptions;
342 extern const MscorlibFieldDescription c_rgMscorlibFieldDescriptions[];
343 extern const USHORT c_nMscorlibFieldDescriptions;
345 const MscorlibClassDescription c_rgMscorlibClassDescriptions[] =
347 #define TYPEINFO(e,ns,c,s,g,ia,ip,if,im,gv) { ns, c },
348 #include "cortypeinfo.h"
351 #define DEFINE_CLASS(i,n,s) { g_ ## n ## NS, # s },
352 #include "namespace.h"
353 #include "mscorlib.h"
355 // Include all exception types here that are defined in mscorlib. Omit exceptions defined elsewhere.
356 #define DEFINE_EXCEPTION(ns, reKind, bHRformessage, ...) { ns , # reKind },
357 #define DEFINE_EXCEPTION_HR_WINRT_ONLY(ns, reKind, ...)
358 #define DEFINE_EXCEPTION_IN_OTHER_FX_ASSEMBLY(ns, reKind, assemblySimpleName, publicKeyToken, bHRformessage, ...)
361 const USHORT c_nMscorlibClassDescriptions = NumItems(c_rgMscorlibClassDescriptions);
363 #define gsig_NoSig (*(HardCodedMetaSig *)NULL)
365 const MscorlibMethodDescription c_rgMscorlibMethodDescriptions[] =
367 #define DEFINE_METHOD(c,i,s,g) { CLASS__ ## c , # s, & gsig_ ## g },
368 #include "mscorlib.h"
370 const USHORT c_nMscorlibMethodDescriptions = NumItems(c_rgMscorlibMethodDescriptions) + 1;
372 const MscorlibFieldDescription c_rgMscorlibFieldDescriptions[] =
374 #define DEFINE_FIELD(c,i,s) { CLASS__ ## c , # s },
375 #include "mscorlib.h"
377 const USHORT c_nMscorlibFieldDescriptions = NumItems(c_rgMscorlibFieldDescriptions) + 1;
383 ///////////////////////////////////////////////////////////////////////////////
388 // When compiling crossgen, we only need the target version of the ecall tables
389 #if !defined(CROSSGEN_COMPILE) || defined(CROSSGEN_MSCORLIB)
391 #ifdef CROSSGEN_COMPILE
393 #define QCFuncElement(name,impl) \
394 FCFuncFlag_QCall + FCFuncFlags(CORINFO_INTRINSIC_Illegal, ECall::InvalidDynamicFCallId), NULL, (LPVOID)name,
396 #define FCFuncFlags(intrinsicID, dynamicID) \
397 (BYTE*)( (((BYTE)intrinsicID) << 16) )
401 #define QCFuncElement(name,impl) \
402 FCFuncFlag_QCall + FCFuncFlags(CORINFO_INTRINSIC_Illegal, ECall::InvalidDynamicFCallId), (LPVOID)(impl), (LPVOID)name,
404 #define FCFuncFlags(intrinsicID, dynamicID) \
405 (BYTE*)( (((BYTE)intrinsicID) << 16) + (((BYTE)dynamicID) << 24) )
409 #define FCFuncElement(name, impl) FCFuncFlags(CORINFO_INTRINSIC_Illegal, ECall::InvalidDynamicFCallId), \
410 (LPVOID)GetEEFuncEntryPoint(impl), (LPVOID)name,
412 #define FCFuncElementSig(name,sig,impl) \
413 FCFuncFlag_HasSignature + FCFuncElement(name, impl) (LPVOID)sig,
415 #define FCIntrinsic(name,impl,intrinsicID) FCFuncFlags(intrinsicID, ECall::InvalidDynamicFCallId), \
416 (LPVOID)GetEEFuncEntryPoint(impl), (LPVOID)name,
418 #define FCIntrinsicSig(name,sig,impl,intrinsicID) \
419 FCFuncFlag_HasSignature + FCIntrinsic(name,impl,intrinsicID) (LPVOID)sig,
421 #define FCDynamic(name,intrinsicID,dynamicID) FCFuncFlags(intrinsicID, dynamicID), \
424 #define FCDynamicSig(name,sig,intrinsicID,dynamicID) \
425 FCFuncFlag_HasSignature + FCDynamic(name,intrinsicID,dynamicID) (LPVOID)sig,
427 #define FCUnreferenced FCFuncFlag_Unreferenced +
429 #define FCFuncStart(name) static const LPVOID name[] = {
430 #define FCFuncEnd() FCFuncFlag_EndOfArray + FCFuncFlags(CORINFO_INTRINSIC_Illegal, ECall::InvalidDynamicFCallId) };
432 #include "ecalllist.h"
435 // Extern definitions so that ecall.cpp can see these tables
436 extern const ECClass c_rgECClasses[];
437 extern const int c_nECClasses;
439 const ECClass c_rgECClasses[] =
441 #define FCClassElement(name,namespace,funcs) {name, namespace, funcs},
442 #include "ecalllist.h"
443 }; // c_rgECClasses[]
445 const int c_nECClasses = NumItems(c_rgECClasses);
447 #endif // !CROSSGEN_COMPILE && CROSSGEN_MSCORLIB
450 #ifdef CROSSGEN_MSCORLIB
451 }; // namespace CrossGenMscorlib