1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * you may not use this file except in compliance with the License. 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * You may obtain a copy of the License at 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Stack frames, and uses thereof. 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifndef _DALVIK_INTERP_STACK 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define _DALVIK_INTERP_STACK 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#include "jni.h" 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#include <stdarg.h> 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectStack layout 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectIn what follows, the "top" of the stack is at a low position in memory, 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectand the "bottom" of the stack is in a high position (put more simply, 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectthey grow downward). They may be merged with the native stack at a 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectlater date. The interpreter assumes that they have a fixed size, 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectdetermined when the thread is created. 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectDalvik's registers (of which there can be up to 64K) map to the "ins" 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project(method arguments) and "locals" (local variables). The "outs" (arguments 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectto called methods) are specified by the "invoke" operand. The return 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvalue, which is passed through the interpreter rather than on the stack, 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectis retrieved with a "move-result" instruction. 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project Low addresses (0x00000000) 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project +- - - - - - - - -+ 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project - out0 - 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project +-----------------+ <-- stack ptr (top of stack) 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project + VM-specific + 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project + internal goop + 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project +-----------------+ <-- curFrame: FP for cur function 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project + v0 == local0 + 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ +-----------------+ 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ out0 + + v1 == in0 + 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ +-----------------+ 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ out1 + + v2 == in1 + 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ +-----------------+ 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ VM-specific + 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ internal goop + 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ <-- frame ptr (FP) for previous function 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ v0 == local0 + 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ v1 == local1 + 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ v2 == in0 + 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ v3 == in1 + 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+ v4 == in2 + 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project- - 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project- - 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project- - 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project+-----------------+ <-- interpStackStart 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project High addresses (0xffffffff) 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectNote the "ins" and "outs" overlap -- values pushed into the "outs" area 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbecome the parameters to the called method. The VM guarantees that there 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectwill be enough room for all possible "outs" on the stack before calling 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectinto a method. 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectAll "V registers" are 32 bits, and all stack entries are 32-bit aligned. 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectRegisters are accessed as a positive offset from the frame pointer, 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projecte.g. register v2 is fp[2]. 64-bit quantities are stored in two adjacent 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectregisters, addressed by the lower-numbered register, and are in host order. 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project64-bit quantities do not need to start in an even-numbered register. 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectWe push two stack frames on when calling an interpreted or native method 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectdirectly from the VM (e.g. invoking <clinit> or via reflection "invoke()"). 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectThe first is a "break" frame, which allows us to tell when a call return or 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectexception unroll has reached the VM call site. Without the break frame the 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectstack might look like an uninterrupted series of interpreted method calls. 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectThe second frame is for the method itself. 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectThe "break" frame is used as an alternative to adding additional fields 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectto the StackSaveArea struct itself. They are recognized by having a 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectNULL method pointer. 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectWhen calling a native method from interpreted code, the stack setup is 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectessentially identical to calling an interpreted method. Because it's a 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectnative method, though, there are never any "locals" or "outs". 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectFor native calls into JNI, we want to store a table of local references 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projecton the stack. The GC needs to scan them while the native code is running, 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectand we want to trivially discard them when the method returns. See JNI.c 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectfor a discussion of how this is managed. In particular note that it is 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpossible to push additional call frames on without calling a method. 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project*/ 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 109f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectstruct StackSaveArea; 110f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projecttypedef struct StackSaveArea StackSaveArea; 111f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 112f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//#define PAD_SAVE_AREA /* help debug stack trampling */ 113f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 114f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 115f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The VM-specific internal goop. 116f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 117f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The idea is to mimic a typical native stack frame, with copies of the 118f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * saved PC and FP. At some point we'd like to have interpreted and 119f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * native code share the same stack, though this makes portability harder. 120f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 121f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectstruct StackSaveArea { 122f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifdef PAD_SAVE_AREA 123f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project u4 pad0, pad1, pad2; 124f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif 125f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 126f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifdef EASY_GDB 127f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* make it easier to trek through stack frames in GDB */ 128f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project StackSaveArea* prevSave; 129f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif 130f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 131f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* saved frame pointer for previous frame, or NULL if this is at bottom */ 132f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project void* prevFrame; 133f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 134f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* saved program counter (from method in caller's frame) */ 135f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project const u2* savedPc; 136f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 137f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* pointer to method we're *currently* executing; handy for exceptions */ 138f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project const Method* method; 139f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 140f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project union { 141f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* for JNI native methods: top of local reference storage */ 142f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project Object** localRefTop; 143f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 144f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /* for interpreted methods: saved current PC, for exception stack 145f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * traces and debugger traces */ 146f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project const u2* currentPc; 147f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } xtra; 148f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 149f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#ifdef PAD_SAVE_AREA 150f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project u4 pad3, pad4, pad5; 151f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif 152f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project}; 153f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 154f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* move between the stack save area and the frame pointer */ 155f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define SAVEAREA_FROM_FP(_fp) ((StackSaveArea*)(_fp) -1) 156f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define FP_FROM_SAVEAREA(_save) ((void*) ((StackSaveArea*)(_save) +1)) 157f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 158f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* when calling a function, get a pointer to outs[0] */ 159f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define OUTS_FROM_FP(_fp, _argCount) \ 160f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project ((u4*) ((u1*)SAVEAREA_FROM_FP(_fp) - sizeof(u4) * (_argCount))) 161f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 162f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* reserve this many bytes for handling StackOverflowError */ 163f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#define STACK_OVERFLOW_RESERVE 512 164f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 165f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 166f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Determine if the frame pointer points to a "break frame". 167f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 168f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectINLINE bool dvmIsBreakFrame(const u4* fp) 169f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project{ 170f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return SAVEAREA_FROM_FP(fp)->method == NULL; 171f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 172f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 173f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 174f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Initialize the interp stack (call this after allocating storage and 175f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * setting thread->interpStackStart). 176f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 177f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbool dvmInitInterpStack(Thread* thread, int stackSize); 178f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 179f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 180f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Push a native method frame directly onto the stack. Used to push the 181f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "fake" native frames at the top of each thread stack. 182f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 183f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbool dvmPushJNIFrame(Thread* thread, const Method* method); 184f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 185f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 186f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * JNI local frame management. 187f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 188f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbool dvmPushLocalFrame(Thread* thread, const Method* method); 189f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbool dvmPopLocalFrame(Thread* thread); 190f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 191f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 192f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Call an interpreted method from native code. 193f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 194f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "obj" should be NULL for "direct" methods. 195f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 196f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmCallMethodV(Thread* self, const Method* method, Object* obj, 197f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project JValue* pResult, va_list args); 198f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmCallMethodA(Thread* self, const Method* method, Object* obj, 199f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project JValue* pResult, const jvalue* args); 200f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmCallMethod(Thread* self, const Method* method, Object* obj, 201f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project JValue* pResult, ...); 202f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 203f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 204f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Invoke a method, using the specified arguments and return type, through 205f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * a reflection interface. 206f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 207f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Deals with boxing/unboxing primitives and performs widening conversions. 208f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 209f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "obj" should be null for a static method. 210f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 211f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "params" and "returnType" come from the Method object, so we don't have 212f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * to re-generate them from the method signature. "returnType" should be 213f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * NULL if we're invoking a constructor. 214f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 215f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectObject* dvmInvokeMethod(Object* invokeObj, const Method* meth, 216f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project ArrayObject* argList, ArrayObject* params, ClassObject* returnType, 217f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project bool noAccessCheck); 218f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 219f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 220f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Determine the source file line number, given the program counter offset 221f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * into the specified method. Returns -2 for native methods, -1 if no 222f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * match was found. 223f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 224f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectint dvmLineNumFromPC(const Method* method, u4 relPc); 225f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 226f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 227f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Given a frame pointer, compute the current call depth. The value can be 228f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * "exact" (a count of non-break frames) or "vague" (just subtracting 229f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * pointers to give relative values). 230f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 231f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectint dvmComputeExactFrameDepth(const void* fp); 232f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectint dvmComputeVagueFrameDepth(Thread* thread, const void* fp); 233f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 234f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 235f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Get the frame pointer for the caller's stack frame. 236f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 237f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid* dvmGetCallerFP(const void* curFrame); 238f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 239f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 240f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Get the class of the method that called us. 241f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 242f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectClassObject* dvmGetCallerClass(const void* curFrame); 243f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 244f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 245f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Get the caller's caller's class. Pass in the current fp. 246f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 247f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * This is used by e.g. java.lang.Class, which wants to know about the 248f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * class loader of the method that called it. 249f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 250f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectClassObject* dvmGetCaller2Class(const void* curFrame); 251f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 252f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 253f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Get the caller's caller's caller's class. Pass in the current fp. 254f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 255f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * This is used by e.g. java.lang.Class, which wants to know about the 256f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * class loader of the method that called it. 257f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 258f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source ProjectClassObject* dvmGetCaller3Class(const void* curFrame); 259f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 260f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 261f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Allocate and fill an array of method pointers representing the current 262f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * stack trace (element 0 is current frame). 263f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 264f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectbool dvmCreateStackTraceArray(const void* fp, const Method*** pArray, 265f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project int* pLength); 266f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 267f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 268f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Common handling for stack overflow. 269f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 270f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmHandleStackOverflow(Thread* self); 271f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmCleanupStackOverflow(Thread* self); 272f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 273f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* debugging; dvmDumpThread() is probably a better starting point */ 274f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmDumpThreadStack(const DebugOutputTarget* target, Thread* thread); 275f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectvoid dvmDumpRunningThreadStack(const DebugOutputTarget* target, Thread* thread); 276f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 277f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project#endif /*_DALVIK_INTERP_STACK*/ 278