VMStack.java revision f33eae7e84eb6d3b0f4e86b59605bb3de73009f3
1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * you may not use this file except in compliance with the License. 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * You may obtain a copy of the License at 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage dalvik.system; 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Provides a limited interface to the Dalvik VM stack. This class is mostly 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * used for implementing security checks. 2204aaaf18dac85eee31b3451226daf586a455feb7Jesse Wilson * 238f273343b7758c09822c74b4f8a0dcf7df3a78b5Jesse Wilson * @hide 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic final class VMStack { 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the defining class loader of the caller's caller. 28f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the requested class loader, or {@code null} if this is the 30adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * bootstrap class loader. 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static ClassLoader getCallingClassLoader(); 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 35adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Returns the defining class loader of the caller's caller's caller. 36f33eae7e84eb6d3b0f4e86b59605bb3de73009f3Elliott Hughes * 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the requested class loader, or {@code null} if this is the 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * bootstrap class loader. 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 40adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static ClassLoader getCallingClassLoader2(); 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 43bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * Returns the class of the caller's caller's caller. 44bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * 459ad964cce1c86e1493902340147fba223c52c2d7Jesse Wilson * @hide 46bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * @return the requested class, or {@code null}. 47bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson */ 48bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson native public static Class<?> getStackClass2(); 49bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson 50bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson /** 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates an array of classes from the methods at the top of the stack. 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * We continue until we reach the bottom of the stack or exceed the 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * specified maximum depth. If stopAtPrivileged is set, the last 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * element of the array will be the caller of the most-recent privileged 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method. 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The topmost stack frame (this method) and the one above that (the 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * caller) are excluded from the array. Frames with java.lang.reflect 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * classes are skipped over. 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 61adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The classes in the array are the defining classes of the methods. 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This is expected to be identical to Harmony's VMStack.getClasses. 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param maxDepth 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * maximum number of classes to return, or -1 for all 67adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param stopAtPrivileged 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * stop when a privileged frame is reached 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array with classes for the most-recent methods on the stack 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static Class<?>[] getClasses(int maxDepth, 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project boolean stopAtPrivileged); 73adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 74adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Retrieves the stack trace from the specified thread. 76adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param t 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * thread of interest 79adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array of stack trace elements, or null if the thread 80adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * doesn't have a stack trace (e.g. because it exited) 81adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 82adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static StackTraceElement[] getThreadStackTrace(Thread t); 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 84adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 85