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 /** 35bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * Returns the class of the caller's caller's caller. 36bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * 37bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson * @return the requested class, or {@code null}. 38bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson */ 39bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson native public static Class<?> getStackClass2(); 40bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson 41bba8d1acd6dfff06c94d761c67a30154ca5ca5dfJesse Wilson /** 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates an array of classes from the methods at the top of the stack. 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * We continue until we reach the bottom of the stack or exceed the 443d93b50c1e9d8cb12d17a4331edd27ee2a1dc7a9Dan Bornstein * specified maximum depth. 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 46adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The topmost stack frame (this method) and the one above that (the 47adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * caller) are excluded from the array. Frames with java.lang.reflect 48adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * classes are skipped over. 49adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 50adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The classes in the array are the defining classes of the methods. 51adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * <p> 523d93b50c1e9d8cb12d17a4331edd27ee2a1dc7a9Dan Bornstein * This is similar to Harmony's VMStack.getClasses, except that this 533d93b50c1e9d8cb12d17a4331edd27ee2a1dc7a9Dan Bornstein * implementation doesn't have a concept of "privileged" frames. 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 55adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param maxDepth 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * maximum number of classes to return, or -1 for all 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array with classes for the most-recent methods on the stack 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 593d93b50c1e9d8cb12d17a4331edd27ee2a1dc7a9Dan Bornstein native public static Class<?>[] getClasses(int maxDepth); 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 61adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Retrieves the stack trace from the specified thread. 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @param t 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * thread of interest 66adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return an array of stack trace elements, or null if the thread 67adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * doesn't have a stack trace (e.g. because it exited) 68adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 69adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project native public static StackTraceElement[] getThreadStackTrace(Thread t); 70e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom 71e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom /** 72e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * Retrieves a partial stack trace from the specified thread into 73e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * the provided array. 74e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * 75e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * @param t 76e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * thread of interest 77e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * @param stackTraceElements 78e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * preallocated array for use when only the top of stack is 79e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * desired. Unused elements will be filled with null values. 80e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom * @return the number of elements filled 81e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom */ 82e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom native public static int fillStackTraceElements(Thread t, 83e9af8901fc4ed7c05d085e2e492f5dcc857f0146Brian Carlstrom StackTraceElement[] stackTraceElements); 84adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project} 85