asm-constants.h revision d726991ba52466cde88e37aba4de2395b62477fa 
1/*
2 * Copyright 2008 The Android Open Source Project
3 *
4 * Constants used by the assembler and verified by the C compiler.
5 */
6
7#if defined(ASM_DEF_VERIFY)
8  /*
9   * Generate C fragments that verify values; assumes "bool failed" exists.
10   * These are all constant expressions, so on success these will compile
11   * down to nothing.
12   */
13# define MTERP_OFFSET(_name, _type, _field, _offset)                        \
14    if (offsetof(_type, _field) != _offset) {                               \
15        LOGE("Bad asm offset %s (%d), should be %d\n",                      \
16            #_name, _offset, offsetof(_type, _field));                      \
17        failed = true;                                                      \
18    }
19# define MTERP_SIZEOF(_name, _type, _size)                                  \
20    if (sizeof(_type) != (_size)) {                                         \
21        LOGE("Bad asm sizeof %s (%d), should be %d\n",                      \
22            #_name, (_size), sizeof(_type));                                \
23        failed = true;                                                      \
24    }
25# define MTERP_CONSTANT(_name, _value)                                      \
26    if ((_name) != (_value)) {                                              \
27        LOGE("Bad asm constant %s (%d), should be %d\n",                    \
28            #_name, (_value), (_name));                                     \
29        failed = true;                                                      \
30    }
31#else
32  /* generate constant labels for the assembly output */
33# define MTERP_OFFSET(name, type, field, offset)    name = offset
34# define MTERP_SIZEOF(name, type, size)             name = size
35# define MTERP_CONSTANT(name, value)                name = value
36#endif
37
38/*
39 * Platform dependencies.  Some platforms require 64-bit alignment of 64-bit
40 * data structures.  Some versions of gcc will hold small enumerated types
41 * in a char instead of an int.
42 */
43#if defined(__ARM_EABI__)
44# define MTERP_NO_UNALIGN_64
45#endif
46#if defined(HAVE_SHORT_ENUMS)
47# define MTERP_SMALL_ENUM   1
48#else
49# define MTERP_SMALL_ENUM   4
50#endif
51
52/*
53 * This file must only contain the following kinds of statements:
54 *
55 *  MTERP_OFFSET(name, StructType, fieldname, offset)
56 *
57 *   Declares that the expected offset of StructType.fieldname is "offset".
58 *   This will break whenever the contents of StructType are rearranged.
59 *
60 *  MTERP_SIZEOF(name, Type, size)
61 *
62 *   Declares that the expected size of Type is "size".
63 *
64 *  MTERP_CONSTANT(name, value)
65 *
66 *   Declares that the expected value of "name" is "value".  Useful for
67 *   enumerations and defined constants that are inaccessible to the
68 *   assembly source.  (Note this assumes you will use the same name in
69 *   both C and assembly, which is good practice.)
70 *
71 * In all cases the "name" field is the label you will use in the assembler.
72 *
73 * The "value" field must always be an actual number, not a symbol, unless
74 * you are sure that the symbol's value will be visible to both C and
75 * assembly sources.  There may be restrictions on the possible range of
76 * values (which are usually provided as immediate operands), so it's best
77 * to restrict numbers assuming a signed 8-bit field.
78 *
79 * On the assembly side, these just become "name=value" constants.  On the
80 * C side, these turn into assertions that cause the VM to abort if the
81 * values are incorrect.
82 */
83
84/* globals (sanity check for LDR vs LDRB) */
85MTERP_SIZEOF(sizeofGlobal_debuggerActive, gDvm.debuggerActive, 1)
86#if defined(WITH_PROFILER)
87MTERP_SIZEOF(sizeofGlobal_activeProfilers, gDvm.activeProfilers, 4)
88#endif
89
90/* MterpGlue fields */
91MTERP_OFFSET(offGlue_pc,                MterpGlue, pc, 0)
92MTERP_OFFSET(offGlue_fp,                MterpGlue, fp, 4)
93MTERP_OFFSET(offGlue_retval,            MterpGlue, retval, 8)
94MTERP_OFFSET(offGlue_method,            MterpGlue, method, 16)
95MTERP_OFFSET(offGlue_methodClassDex,    MterpGlue, methodClassDex, 20)
96MTERP_OFFSET(offGlue_self,              MterpGlue, self, 24)
97MTERP_OFFSET(offGlue_bailPtr,           MterpGlue, bailPtr, 28)
98MTERP_OFFSET(offGlue_interpStackEnd,    MterpGlue, interpStackEnd, 32)
99MTERP_OFFSET(offGlue_pSelfSuspendCount, MterpGlue, pSelfSuspendCount, 36)
100#if defined(WITH_DEBUGGER) && defined(WITH_PROFILER)
101MTERP_OFFSET(offGlue_pDebuggerActive,   MterpGlue, pDebuggerActive, 40)
102MTERP_OFFSET(offGlue_pActiveProfilers,  MterpGlue, pActiveProfilers, 44)
103MTERP_OFFSET(offGlue_entryPoint,        MterpGlue, entryPoint, 48)
104#if defined(WITH_JIT)
105MTERP_OFFSET(offGlue_pJitProfTable,     MterpGlue, pJitProfTable, 56)
106MTERP_OFFSET(offGlue_jitState,          MterpGlue, jitState, 60)
107MTERP_OFFSET(offGlue_jitResume,         MterpGlue, jitResume, 64)
108MTERP_OFFSET(offGlue_jitResumePC,       MterpGlue, jitResumePC, 68)
109MTERP_OFFSET(offGlue_jitThreshold,      MterpGlue, jitThreshold, 72)
110#endif
111#elif defined(WITH_DEBUGGER)
112MTERP_OFFSET(offGlue_pDebuggerActive,   MterpGlue, pDebuggerActive, 40)
113MTERP_OFFSET(offGlue_entryPoint,        MterpGlue, entryPoint, 44)
114#if defined(WITH_JIT)
115MTERP_OFFSET(offGlue_pJitProfTable,     MterpGlue, pJitProfTable, 52)
116MTERP_OFFSET(offGlue_jitState,          MterpGlue, jitState, 56)
117MTERP_OFFSET(offGlue_jitResume,         MterpGlue, jitResume, 60)
118MTERP_OFFSET(offGlue_jitResumePC,       MterpGlue, jitResumePC, 64)
119MTERP_OFFSET(offGlue_jitThreshold,      MterpGlue, jitThreshold, 68)
120#endif
121#elif defined(WITH_PROFILER)
122MTERP_OFFSET(offGlue_pActiveProfilers,  MterpGlue, pActiveProfilers, 40)
123MTERP_OFFSET(offGlue_entryPoint,        MterpGlue, entryPoint, 44)
124#if defined(WITH_JIT)
125MTERP_OFFSET(offGlue_pJitProfTable,     MterpGlue, pJitProfTable, 52)
126MTERP_OFFSET(offGlue_jitState,          MterpGlue, jitState, 56)
127MTERP_OFFSET(offGlue_jitResume,         MterpGlue, jitResume, 60)
128MTERP_OFFSET(offGlue_jitResumePC,       MterpGlue, jitResumePC, 64)
129MTERP_OFFSET(offGlue_jitThreshold,      MterpGlue, jitThreshold, 68)
130#endif
131#else
132MTERP_OFFSET(offGlue_entryPoint,        MterpGlue, entryPoint, 40)
133#if defined(WITH_JIT)
134MTERP_OFFSET(offGlue_pJitProfTable,     MterpGlue, pJitProfTable, 48)
135MTERP_OFFSET(offGlue_jitState,          MterpGlue, jitState, 52)
136MTERP_OFFSET(offGlue_jitResume,         MterpGlue, jitResume, 56)
137MTERP_OFFSET(offGlue_jitResumePC,       MterpGlue, jitResumePC, 60)
138MTERP_OFFSET(offGlue_jitThreshold,      MterpGlue, jitThreshold, 64)
139#endif
140#endif
141/* make sure all JValue union members are stored at the same offset */
142MTERP_OFFSET(offGlue_retval_z,          MterpGlue, retval.z, 8)
143MTERP_OFFSET(offGlue_retval_i,          MterpGlue, retval.i, 8)
144MTERP_OFFSET(offGlue_retval_j,          MterpGlue, retval.j, 8)
145MTERP_OFFSET(offGlue_retval_l,          MterpGlue, retval.l, 8)
146
147/* DvmDex fields */
148MTERP_OFFSET(offDvmDex_pResStrings,     DvmDex, pResStrings, 8)
149MTERP_OFFSET(offDvmDex_pResClasses,     DvmDex, pResClasses, 12)
150MTERP_OFFSET(offDvmDex_pResMethods,     DvmDex, pResMethods, 16)
151MTERP_OFFSET(offDvmDex_pResFields,      DvmDex, pResFields, 20)
152MTERP_OFFSET(offDvmDex_pInterfaceCache, DvmDex, pInterfaceCache, 24)
153
154/* StackSaveArea fields */
155#ifdef EASY_GDB
156MTERP_OFFSET(offStackSaveArea_prevSave, StackSaveArea, prevSave, 0)
157MTERP_OFFSET(offStackSaveArea_prevFrame, StackSaveArea, prevFrame, 4)
158MTERP_OFFSET(offStackSaveArea_savedPc,  StackSaveArea, savedPc, 8)
159MTERP_OFFSET(offStackSaveArea_method,   StackSaveArea, method, 12)
160MTERP_OFFSET(offStackSaveArea_currentPc, StackSaveArea, xtra.currentPc, 16)
161MTERP_OFFSET(offStackSaveArea_localRefCookie, \
162                                        StackSaveArea, xtra.localRefCookie, 16)
163MTERP_OFFSET(offStackSaveArea_returnAddr, StackSaveArea, returnAddr, 20)
164MTERP_SIZEOF(sizeofStackSaveArea,       StackSaveArea, 24)
165#else
166MTERP_OFFSET(offStackSaveArea_prevFrame, StackSaveArea, prevFrame, 0)
167MTERP_OFFSET(offStackSaveArea_savedPc,  StackSaveArea, savedPc, 4)
168MTERP_OFFSET(offStackSaveArea_method,   StackSaveArea, method, 8)
169MTERP_OFFSET(offStackSaveArea_currentPc, StackSaveArea, xtra.currentPc, 12)
170MTERP_OFFSET(offStackSaveArea_localRefCookie, \
171                                        StackSaveArea, xtra.localRefCookie, 12)
172MTERP_OFFSET(offStackSaveArea_returnAddr, StackSaveArea, returnAddr, 16)
173MTERP_SIZEOF(sizeofStackSaveArea,       StackSaveArea, 20)
174#endif
175
176  /* ShadowSpace fields */
177#if defined(WITH_JIT) && defined(WITH_SELF_VERIFICATION)
178MTERP_OFFSET(offShadowSpace_startPC, ShadowSpace, startPC, 0)
179MTERP_OFFSET(offShadowSpace_fp, ShadowSpace, fp, 4)
180MTERP_OFFSET(offShadowSpace_glue, ShadowSpace, glue, 8)
181MTERP_OFFSET(offShadowSpace_svState, ShadowSpace, selfVerificationState, 12)
182MTERP_OFFSET(offShadowSpace_shadowFP, ShadowSpace, shadowFP, 20)
183MTERP_OFFSET(offShadowSpace_interpState, ShadowSpace, interpState, 24)
184#endif
185
186/* InstField fields */
187#ifdef PROFILE_FIELD_ACCESS
188MTERP_OFFSET(offInstField_byteOffset,   InstField, byteOffset, 24)
189#else
190MTERP_OFFSET(offInstField_byteOffset,   InstField, byteOffset, 16)
191#endif
192
193/* StaticField fields */
194#ifdef PROFILE_FIELD_ACCESS
195MTERP_OFFSET(offStaticField_value,      StaticField, value, 24)
196#else
197MTERP_OFFSET(offStaticField_value,      StaticField, value, 16)
198#endif
199
200/* Method fields */
201MTERP_OFFSET(offMethod_clazz,           Method, clazz, 0)
202MTERP_OFFSET(offMethod_accessFlags,     Method, accessFlags, 4)
203MTERP_OFFSET(offMethod_methodIndex,     Method, methodIndex, 8)
204MTERP_OFFSET(offMethod_registersSize,   Method, registersSize, 10)
205MTERP_OFFSET(offMethod_outsSize,        Method, outsSize, 12)
206MTERP_OFFSET(offMethod_name,            Method, name, 16)
207MTERP_OFFSET(offMethod_insns,           Method, insns, 32)
208MTERP_OFFSET(offMethod_nativeFunc,      Method, nativeFunc, 40)
209
210/* InlineOperation fields -- code assumes "func" offset is zero, do not alter */
211MTERP_OFFSET(offInlineOperation_func,   InlineOperation, func, 0)
212
213/* Thread fields */
214MTERP_OFFSET(offThread_stackOverflowed, Thread, stackOverflowed, 40)
215MTERP_OFFSET(offThread_curFrame,        Thread, curFrame, 44)
216MTERP_OFFSET(offThread_exception,       Thread, exception, 48)
217#ifdef USE_INDIRECT_REF
218MTERP_OFFSET(offThread_jniLocal_topCookie, \
219                                Thread, jniLocalRefTable.segmentState.all, 76)
220#else
221MTERP_OFFSET(offThread_jniLocal_topCookie, \
222                                Thread, jniLocalRefTable.nextEntry, 76)
223#endif
224
225/* Object fields */
226MTERP_OFFSET(offObject_clazz,           Object, clazz, 0)
227
228/* ArrayObject fields */
229MTERP_OFFSET(offArrayObject_length,     ArrayObject, length, 8)
230#ifdef MTERP_NO_UNALIGN_64
231MTERP_OFFSET(offArrayObject_contents,   ArrayObject, contents, 16)
232#else
233MTERP_OFFSET(offArrayObject_contents,   ArrayObject, contents, 12)
234#endif
235
236/* String fields */
237MTERP_CONSTANT(STRING_FIELDOFF_VALUE,     8)
238MTERP_CONSTANT(STRING_FIELDOFF_HASHCODE, 12)
239MTERP_CONSTANT(STRING_FIELDOFF_OFFSET,   16)
240MTERP_CONSTANT(STRING_FIELDOFF_COUNT,    20)
241
242#if defined(WITH_JIT)
243/*
244 * Reasons for the non-chaining interpreter entry points
245 * Enums defined in vm/Globals.h
246 */
247MTERP_CONSTANT(kInlineCacheMiss,        0)
248MTERP_CONSTANT(kCallsiteInterpreted,    1)
249MTERP_CONSTANT(kSwitchOverflow,         2)
250#endif
251
252/* ClassObject fields */
253MTERP_OFFSET(offClassObject_descriptor, ClassObject, descriptor, 24)
254MTERP_OFFSET(offClassObject_accessFlags, ClassObject, accessFlags, 32)
255MTERP_OFFSET(offClassObject_pDvmDex,    ClassObject, pDvmDex, 40)
256MTERP_OFFSET(offClassObject_status,     ClassObject, status, 44)
257MTERP_OFFSET(offClassObject_super,      ClassObject, super, 76)
258MTERP_OFFSET(offClassObject_vtableCount, ClassObject, vtableCount, 116)
259MTERP_OFFSET(offClassObject_vtable,     ClassObject, vtable, 120)
260
261/* InterpEntry enumeration */
262MTERP_SIZEOF(sizeofClassStatus,         InterpEntry, MTERP_SMALL_ENUM)
263MTERP_CONSTANT(kInterpEntryInstr,   0)
264MTERP_CONSTANT(kInterpEntryReturn,  1)
265MTERP_CONSTANT(kInterpEntryThrow,   2)
266#if defined(WITH_JIT)
267MTERP_CONSTANT(kInterpEntryResume,  3)
268#endif
269
270#if defined(WITH_JIT)
271MTERP_CONSTANT(kJitOff,             0)
272MTERP_CONSTANT(kJitNormal,          1)
273MTERP_CONSTANT(kJitTSelectRequest,  2)
274MTERP_CONSTANT(kJitTSelect,         3)
275MTERP_CONSTANT(kJitTSelectAbort,    4)
276MTERP_CONSTANT(kJitTSelectEnd,      5)
277MTERP_CONSTANT(kJitSingleStep,      6)
278MTERP_CONSTANT(kJitSingleStepEnd,   7)
279MTERP_CONSTANT(kJitSelfVerification, 8)
280
281#if defined(WITH_SELF_VERIFICATION)
282MTERP_CONSTANT(kSVSIdle, 0)
283MTERP_CONSTANT(kSVSStart, 1)
284MTERP_CONSTANT(kSVSPunt, 2)
285MTERP_CONSTANT(kSVSSingleStep, 3)
286MTERP_CONSTANT(kSVSTraceSelect, 4)
287MTERP_CONSTANT(kSVSNormal, 5)
288MTERP_CONSTANT(kSVSNoChain, 6)
289MTERP_CONSTANT(kSVSBackwardBranch, 7)
290MTERP_CONSTANT(kSVSDebugInterp, 8)
291#endif
292#endif
293
294/* ClassStatus enumeration */
295MTERP_SIZEOF(sizeofClassStatus,         ClassStatus, MTERP_SMALL_ENUM)
296MTERP_CONSTANT(CLASS_INITIALIZED,   7)
297
298/* MethodType enumeration */
299MTERP_SIZEOF(sizeofMethodType,          MethodType, MTERP_SMALL_ENUM)
300MTERP_CONSTANT(METHOD_DIRECT,       1)
301MTERP_CONSTANT(METHOD_STATIC,       2)
302MTERP_CONSTANT(METHOD_VIRTUAL,      3)
303MTERP_CONSTANT(METHOD_INTERFACE,    4)
304
305/* ClassObject constants */
306MTERP_CONSTANT(ACC_PRIVATE,         0x0002)
307MTERP_CONSTANT(ACC_STATIC,          0x0008)
308MTERP_CONSTANT(ACC_NATIVE,          0x0100)
309MTERP_CONSTANT(ACC_INTERFACE,       0x0200)
310MTERP_CONSTANT(ACC_ABSTRACT,        0x0400)
311
312/* flags for dvmMalloc */
313MTERP_CONSTANT(ALLOC_DONT_TRACK,    0x02)
314
315/* opcode number */
316MTERP_CONSTANT(OP_MOVE_EXCEPTION,   0x0d)
317