1 /* 2 * Copyright (c) 2003, 2018, 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 #include "jni.h" 30 31 #ifdef __cplusplus 32 extern "C" { 33 #endif 34 35 typedef struct jvm_agent jvm_agent_t; 36 37 #define JVM_DB_VERSION 1 38 39 JNIEXPORT jvm_agent_t *Jagent_create(struct ps_prochandle *P, int vers); 40 41 /* 42 * Called from Jframe_iter() for each java frame. If it returns 0, then 43 * Jframe_iter() proceeds to the next frame. Otherwise, the return value is 44 * immediately returned to the caller of Jframe_iter(). 45 * 46 * Parameters: 47 * 'cld' is client supplied data (to maintain iterator state, if any). 48 * 'name' is java method name. 49 * 'bci' is byte code index. it will be -1 if not available. 50 * 'line' is java source line number. it will be 0 if not available. 51 * 'handle' is an abstract client handle, reserved for future expansions 52 */ 53 54 typedef int java_stack_f(void *cld, const prgregset_t regs, const char* name, int bci, int line, void *handle); 55 56 /* 57 * Iterates over the java frames at the current location. Returns -1 if no java 58 * frames were found, or if there was some unrecoverable error. Otherwise, 59 * returns the last value returned from 'func'. 60 */ 61 JNIEXPORT int Jframe_iter(jvm_agent_t *agent, prgregset_t gregs, java_stack_f *func, void* cld); 62 63 JNIEXPORT void Jagent_destroy(jvm_agent_t *J); 64 65 #ifdef __cplusplus 66 } /* extern "C" */ 67 #endif /* __cplusplus */ 68 69 #endif // OS_SOLARIS_DTRACE_LIBJVM_DB_H