annotate src/os/bsd/dtrace/libjvm_db.h @ 4006:436b4a3231bf

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