1 /* 2 * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. 8 * 9 * This code is distributed in the hope that it will be useful, but WITHOUT 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 12 * version 2 for more details (a copy is included in the LICENSE file that 13 * accompanied this code). 14 * 15 * You should have received a copy of the GNU General Public License version 16 * 2 along with this work; if not, write to the Free Software Foundation, 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 18 * 19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 20 * or visit www.oracle.com if you need additional information or have any 21 * questions. 22 * 23 */ 24 25 #ifndef OS_SOLARIS_DTRACE_LIBJVM_DB_H 26 #define OS_SOLARIS_DTRACE_LIBJVM_DB_H 27 28 #include <proc_service.h> 29 30 #ifdef __cplusplus 31 extern "C" { 32 #endif 33 34 typedef struct jvm_agent jvm_agent_t; 35 36 #define JVM_DB_VERSION 1 37 38 jvm_agent_t *Jagent_create(struct ps_prochandle *P, int vers); 39 40 /* 41 * Called from Jframe_iter() for each java frame. If it returns 0, then 42 * Jframe_iter() proceeds to the next frame. Otherwise, the return value is 43 * immediately returned to the caller of Jframe_iter(). 44 * 45 * Parameters: 46 * 'cld' is client supplied data (to maintain iterator state, if any). 47 * 'name' is java method name. 48 * 'bci' is byte code index. it will be -1 if not available. 49 * 'line' is java source line number. it will be 0 if not available. 50 * 'handle' is an abstract client handle, reserved for future expansions 51 */ 52 53 typedef int java_stack_f(void *cld, const prgregset_t regs, const char* name, int bci, int line, void *handle); 54 55 /* 56 * Iterates over the java frames at the current location. Returns -1 if no java 57 * frames were found, or if there was some unrecoverable error. Otherwise, 58 * returns the last value returned from 'func'. 59 */ 60 int Jframe_iter(jvm_agent_t *agent, prgregset_t gregs, java_stack_f *func, void* cld); 61 62 void Jagent_destroy(jvm_agent_t *J); 63 64 #ifdef __cplusplus 65 } /* extern "C" */ 66 #endif /* __cplusplus */ 67 68 #endif // OS_SOLARIS_DTRACE_LIBJVM_DB_H 69