dengzedong
2024-09-25 f7932f5848903427a2c08f8eb40bc0022410de42
提交 | 用户 | 时间
f7932f 1 /*
D 2  * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
3  * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
4  *
5  *
6  *
7  *
8  *
9  *
10  *
11  *
12  *
13  *
14  *
15  *
16  *
17  *
18  *
19  *
20  *
21  *
22  *
23  *
24  */
25
26 /*
27  * This header file defines the data structures sent by the VM
28  * through the JVMTI CompiledMethodLoad callback function via the
29  * "void * compile_info" parameter. The memory pointed to by the
30  * compile_info parameter may not be referenced after returning from
31  * the CompiledMethodLoad callback. These are VM implementation
32  * specific data structures that may evolve in future releases. A
33  * JVMTI agent should interpret a non-NULL compile_info as a pointer
34  * to a region of memory containing a list of records. In a typical
35  * usage scenario, a JVMTI agent would cast each record to a
36  * jvmtiCompiledMethodLoadRecordHeader, a struct that represents
37  * arbitrary information. This struct contains a kind field to indicate
38  * the kind of information being passed, and a pointer to the next
39  * record. If the kind field indicates inlining information, then the
40  * agent would cast the record to a jvmtiCompiledMethodLoadInlineRecord.
41  * This record contains an array of PCStackInfo structs, which indicate
42  * for every pc address what are the methods on the invocation stack.
43  * The "methods" and "bcis" fields in each PCStackInfo struct specify a
44  * 1-1 mapping between these inlined methods and their bytecode indices.
45  * This can be used to derive the proper source lines of the inlined
46  * methods.
47  */
48
49 #ifndef _JVMTI_CMLR_H_
50 #define _JVMTI_CMLR_H_
51
52 enum {
53     JVMTI_CMLR_MAJOR_VERSION_1 = 0x00000001,
54     JVMTI_CMLR_MINOR_VERSION_0 = 0x00000000,
55
56     JVMTI_CMLR_MAJOR_VERSION   = 0x00000001,
57     JVMTI_CMLR_MINOR_VERSION   = 0x00000000
58
59     /*
60      * This comment is for the "JDK import from HotSpot" sanity check:
61      * version: 1.0.0
62      */
63 };
64
65 typedef enum {
66     JVMTI_CMLR_DUMMY       = 1,
67     JVMTI_CMLR_INLINE_INFO = 2
68 } jvmtiCMLRKind;
69
70 /*
71  * Record that represents arbitrary information passed through JVMTI
72  * CompiledMethodLoadEvent void pointer.
73  */
74 typedef struct _jvmtiCompiledMethodLoadRecordHeader {
75   jvmtiCMLRKind kind;     /* id for the kind of info passed in the record */
76   jint majorinfoversion;  /* major and minor info version values. Init'ed */
77   jint minorinfoversion;  /* to current version value in jvmtiExport.cpp. */
78
79   struct _jvmtiCompiledMethodLoadRecordHeader* next;
80 } jvmtiCompiledMethodLoadRecordHeader;
81
82 /*
83  * Record that gives information about the methods on the compile-time
84  * stack at a specific pc address of a compiled method. Each element in
85  * the methods array maps to same element in the bcis array.
86  */
87 typedef struct _PCStackInfo {
88   void* pc;             /* the pc address for this compiled method */
89   jint numstackframes;  /* number of methods on the stack */
90   jmethodID* methods;   /* array of numstackframes method ids */
91   jint* bcis;           /* array of numstackframes bytecode indices */
92 } PCStackInfo;
93
94 /*
95  * Record that contains inlining information for each pc address of
96  * an nmethod.
97  */
98 typedef struct _jvmtiCompiledMethodLoadInlineRecord {
99   jvmtiCompiledMethodLoadRecordHeader header;  /* common header for casting */
100   jint numpcs;          /* number of pc descriptors in this nmethod */
101   PCStackInfo* pcinfo;  /* array of numpcs pc descriptors */
102 } jvmtiCompiledMethodLoadInlineRecord;
103
104 /*
105  * Dummy record used to test that we can pass records with different
106  * information through the void pointer provided that they can be cast
107  * to a jvmtiCompiledMethodLoadRecordHeader.
108  */
109
110 typedef struct _jvmtiCompiledMethodLoadDummyRecord {
111   jvmtiCompiledMethodLoadRecordHeader header;  /* common header for casting */
112   char message[50];
113 } jvmtiCompiledMethodLoadDummyRecord;
114
115 #endif