259 lines
7.0 KiB
C
259 lines
7.0 KiB
C
/*===-- jitprofiling.h - JIT Profiling API-------------------------*- C -*-===*
|
|
*
|
|
* Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
* See https://llvm.org/LICENSE.txt for license information.
|
|
* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
*
|
|
*===----------------------------------------------------------------------===*
|
|
*
|
|
* This file provides Intel(R) Performance Analyzer JIT (Just-In-Time)
|
|
* Profiling API declaration.
|
|
*
|
|
* NOTE: This file comes in a style different from the rest of LLVM
|
|
* source base since this is a piece of code shared from Intel(R)
|
|
* products. Please do not reformat / re-style this code to make
|
|
* subsequent merges and contributions from the original source base eaiser.
|
|
*
|
|
*===----------------------------------------------------------------------===*/
|
|
#ifndef __JITPROFILING_H__
|
|
#define __JITPROFILING_H__
|
|
|
|
/*
|
|
* Various constants used by functions
|
|
*/
|
|
|
|
/* event notification */
|
|
typedef enum iJIT_jvm_event
|
|
{
|
|
|
|
/* shutdown */
|
|
|
|
/*
|
|
* Program exiting EventSpecificData NA
|
|
*/
|
|
iJVM_EVENT_TYPE_SHUTDOWN = 2,
|
|
|
|
/* JIT profiling */
|
|
|
|
/*
|
|
* issued after method code jitted into memory but before code is executed
|
|
* EventSpecificData is an iJIT_Method_Load
|
|
*/
|
|
iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED=13,
|
|
|
|
/* issued before unload. Method code will no longer be executed, but code
|
|
* and info are still in memory. The VTune profiler may capture method
|
|
* code only at this point EventSpecificData is iJIT_Method_Id
|
|
*/
|
|
iJVM_EVENT_TYPE_METHOD_UNLOAD_START,
|
|
|
|
/* Method Profiling */
|
|
|
|
/* method name, Id and stack is supplied
|
|
* issued when a method is about to be entered EventSpecificData is
|
|
* iJIT_Method_NIDS
|
|
*/
|
|
iJVM_EVENT_TYPE_ENTER_NIDS = 19,
|
|
|
|
/* method name, Id and stack is supplied
|
|
* issued when a method is about to be left EventSpecificData is
|
|
* iJIT_Method_NIDS
|
|
*/
|
|
iJVM_EVENT_TYPE_LEAVE_NIDS
|
|
} iJIT_JVM_EVENT;
|
|
|
|
typedef enum _iJIT_ModeFlags
|
|
{
|
|
/* No need to Notify VTune, since VTune is not running */
|
|
iJIT_NO_NOTIFICATIONS = 0x0000,
|
|
|
|
/* when turned on the jit must call
|
|
* iJIT_NotifyEvent
|
|
* (
|
|
* iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED,
|
|
* )
|
|
* for all the method already jitted
|
|
*/
|
|
iJIT_BE_NOTIFY_ON_LOAD = 0x0001,
|
|
|
|
/* when turned on the jit must call
|
|
* iJIT_NotifyEvent
|
|
* (
|
|
* iJVM_EVENT_TYPE_METHOD_UNLOAD_FINISHED,
|
|
* ) for all the method that are unloaded
|
|
*/
|
|
iJIT_BE_NOTIFY_ON_UNLOAD = 0x0002,
|
|
|
|
/* when turned on the jit must instrument all
|
|
* the currently jited code with calls on
|
|
* method entries
|
|
*/
|
|
iJIT_BE_NOTIFY_ON_METHOD_ENTRY = 0x0004,
|
|
|
|
/* when turned on the jit must instrument all
|
|
* the currently jited code with calls
|
|
* on method exit
|
|
*/
|
|
iJIT_BE_NOTIFY_ON_METHOD_EXIT = 0x0008
|
|
|
|
} iJIT_ModeFlags;
|
|
|
|
|
|
/* Flags used by iJIT_IsProfilingActive() */
|
|
typedef enum _iJIT_IsProfilingActiveFlags
|
|
{
|
|
/* No profiler is running. Currently not used */
|
|
iJIT_NOTHING_RUNNING = 0x0000,
|
|
|
|
/* Sampling is running. This is the default value
|
|
* returned by iJIT_IsProfilingActive()
|
|
*/
|
|
iJIT_SAMPLING_ON = 0x0001,
|
|
|
|
/* Call Graph is running */
|
|
iJIT_CALLGRAPH_ON = 0x0002
|
|
|
|
} iJIT_IsProfilingActiveFlags;
|
|
|
|
/* Enumerator for the environment of methods*/
|
|
typedef enum _iJDEnvironmentType
|
|
{
|
|
iJDE_JittingAPI = 2
|
|
} iJDEnvironmentType;
|
|
|
|
/**********************************
|
|
* Data structures for the events *
|
|
**********************************/
|
|
|
|
/* structure for the events:
|
|
* iJVM_EVENT_TYPE_METHOD_UNLOAD_START
|
|
*/
|
|
|
|
typedef struct _iJIT_Method_Id
|
|
{
|
|
/* Id of the method (same as the one passed in
|
|
* the iJIT_Method_Load struct
|
|
*/
|
|
unsigned int method_id;
|
|
|
|
} *piJIT_Method_Id, iJIT_Method_Id;
|
|
|
|
|
|
/* structure for the events:
|
|
* iJVM_EVENT_TYPE_ENTER_NIDS,
|
|
* iJVM_EVENT_TYPE_LEAVE_NIDS,
|
|
* iJVM_EVENT_TYPE_EXCEPTION_OCCURRED_NIDS
|
|
*/
|
|
|
|
typedef struct _iJIT_Method_NIDS
|
|
{
|
|
/* unique method ID */
|
|
unsigned int method_id;
|
|
|
|
/* NOTE: no need to fill this field, it's filled by VTune */
|
|
unsigned int stack_id;
|
|
|
|
/* method name (just the method, without the class) */
|
|
char* method_name;
|
|
} *piJIT_Method_NIDS, iJIT_Method_NIDS;
|
|
|
|
/* structures for the events:
|
|
* iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED
|
|
*/
|
|
|
|
typedef struct _LineNumberInfo
|
|
{
|
|
/* x86 Offset from the beginning of the method*/
|
|
unsigned int Offset;
|
|
|
|
/* source line number from the beginning of the source file */
|
|
unsigned int LineNumber;
|
|
|
|
} *pLineNumberInfo, LineNumberInfo;
|
|
|
|
typedef struct _iJIT_Method_Load
|
|
{
|
|
/* unique method ID - can be any unique value, (except 0 - 999) */
|
|
unsigned int method_id;
|
|
|
|
/* method name (can be with or without the class and signature, in any case
|
|
* the class name will be added to it)
|
|
*/
|
|
char* method_name;
|
|
|
|
/* virtual address of that method - This determines the method range for the
|
|
* iJVM_EVENT_TYPE_ENTER/LEAVE_METHOD_ADDR events
|
|
*/
|
|
void* method_load_address;
|
|
|
|
/* Size in memory - Must be exact */
|
|
unsigned int method_size;
|
|
|
|
/* Line Table size in number of entries - Zero if none */
|
|
unsigned int line_number_size;
|
|
|
|
/* Pointer to the beginning of the line numbers info array */
|
|
pLineNumberInfo line_number_table;
|
|
|
|
/* unique class ID */
|
|
unsigned int class_id;
|
|
|
|
/* class file name */
|
|
char* class_file_name;
|
|
|
|
/* source file name */
|
|
char* source_file_name;
|
|
|
|
/* bits supplied by the user for saving in the JIT file */
|
|
void* user_data;
|
|
|
|
/* the size of the user data buffer */
|
|
unsigned int user_data_size;
|
|
|
|
/* NOTE: no need to fill this field, it's filled by VTune */
|
|
iJDEnvironmentType env;
|
|
|
|
} *piJIT_Method_Load, iJIT_Method_Load;
|
|
|
|
/* API Functions */
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef CDECL
|
|
# if defined WIN32 || defined _WIN32
|
|
# define CDECL __cdecl
|
|
# else /* defined WIN32 || defined _WIN32 */
|
|
# if defined _M_X64 || defined _M_AMD64 || defined __x86_64__
|
|
# define CDECL /* not actual on x86_64 platform */
|
|
# else /* _M_X64 || _M_AMD64 || __x86_64__ */
|
|
# define CDECL __attribute__ ((cdecl))
|
|
# endif /* _M_X64 || _M_AMD64 || __x86_64__ */
|
|
# endif /* defined WIN32 || defined _WIN32 */
|
|
#endif /* CDECL */
|
|
|
|
#define JITAPI CDECL
|
|
|
|
/* called when the settings are changed with new settings */
|
|
typedef void (*iJIT_ModeChangedEx)(void *UserData, iJIT_ModeFlags Flags);
|
|
|
|
int JITAPI iJIT_NotifyEvent(iJIT_JVM_EVENT event_type, void *EventSpecificData);
|
|
|
|
/* The new mode call back routine */
|
|
void JITAPI iJIT_RegisterCallbackEx(void *userdata,
|
|
iJIT_ModeChangedEx NewModeCallBackFuncEx);
|
|
|
|
iJIT_IsProfilingActiveFlags JITAPI iJIT_IsProfilingActive(void);
|
|
|
|
void JITAPI FinalizeThread(void);
|
|
|
|
void JITAPI FinalizeProcess(void);
|
|
|
|
unsigned int JITAPI iJIT_GetNewMethodID(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __JITPROFILING_H__ */
|