iJIT_NotifyEvent

iJIT_JVM_EVENT event_type

Notification code sent to the agent. See a complete list of event types below.

void *EventSpecificData

Pointer to event specific data.

iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED

Send this notification after a JITted method has been loaded into memory, and possibly JIT compiled, but before the code is executed. Use the iJIT_Method_Load structure for EventSpecificData. The return value of iJIT_NotifyEvent is undefined.

iJVM_EVENT_TYPE_SHUTDOWN

Send this notification to terminate profiling. Use NULL for EventSpecificData. iJIT_NotifyEvent returns 1 on success.

JVM_EVENT_TYPE_METHOD_UPDATE

Send this notification to provide new content for a previously reported dynamic code. The previous content will be invalidated starting from the time of the notification. Use the iJIT_Method_Load structure for EventSpecificData with the following required fields:

• method_id to identify the code to update

• method_load_address to specify the start address within an identified code range where the update should be started

• method_size to specify the length of an updated code range

JVM_EVENT_TYPE_METHOD_INLINE_LOAD_FINISHED

Send this notification when an inline dynamic code is JIT compiled and loaded into memory by the JIT engine, but before the parent code region starts executing. Use the iJIT_Method_Inline_Load structure for EventSpecificData.

iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED_V2

Send this notification when a dynamic code is JIT compiled and loaded into memory by the JIT engine, but before the code is executed. Use the iJIT_Method_Load_V2 structure for EventSpecificData.

unsigned int method_id

Unique method ID. Method ID cannot be smaller than 999. You must either use the API function iJIT_GetNewMethodID to get a valid and unique method ID, or else manage ID uniqueness and correct range by yourself.

unsigned int parent_method_id

Unique immediate parent’s method ID. Method ID may not be smaller than 999. You must either use the API function iJIT_GetNewMethodID to get a valid and unique method ID, or else manage ID uniqueness and correct range by yourself.

char *method_name

The name of the method, optionally prefixed with its class name and appended with its complete signature. This argument cannot be set to NULL.

void *method_load_address

The base address of the method code. Can be NULL if the method is not JITted.

unsigned int method_size

The virtual address on which the method is inlined. If NULL, then data provided with the event are not accepted.

unsigned int line_number_size

The number of entries in the line number table. 0 if none.

pLineNumberInfo line_number_table

Pointer to the line numbers info array. Can be NULL if line_number_size is 0. See LineNumberInfo structure for a description of a single entry in the line number info array.

char *class_file_name

Class name. Can be NULL.

char *source_file_name

Source file name. Can be NULL.

unsigned int method_id

Unique method ID. Method ID cannot be smaller than 999. You must either use the API function iJIT_GetNewMethodID to get a valid and unique method ID, or else manage ID uniqueness and correct range by yourself.

char *method_name

The name of the method, optionally prefixed with its class name and appended with its complete signature. This argument cannot be set to NULL.

void *method_load_address

The base address of the method code. Can be NULL if the method is not JITted.

unsigned int method_size

The virtual address on which the method is inlined. If NULL, then data provided with the event are not accepted.

unsigned int line_number_size

The number of entries in the line number table. 0 if none.

pLineNumberInfo line_number_table

Pointer to the line numbers info array. Can be NULL if line_number_size is 0. See LineNumberInfo structure for a description of a single entry in the line number info array.

unsigned int class_id

This field is obsolete.

char *class_file_name

Class name. Can be NULL.

char *source_file_name

Source file name. Can be NULL.

void *user_data

This field is obsolete.

unsigned int user_data_size

This field is obsolete.

iJDEnvironmentType env

This field is obsolete.

unsigned int method_id

Unique method ID. Method ID cannot be smaller than 999. You must either use the API function iJIT_GetNewMethodID to get a valid and unique method ID, or else manage ID uniqueness and correct range by yourself.

char *method_name

The name of the method, optionally prefixed with its class name and appended with its complete signature. This argument cannot be set to NULL.

void *method_load_address

The base address of the method code. Can be NULL if the method is not JITted.

unsigned int method_size

The virtual address on which the method is inlined. If NULL, then data provided with the event are not accepted.

unsigned int line_number_size

The number of entries in the line number table. 0 if none.

pLineNumberInfo line_number_table

Pointer to the line numbers info array. Can be NULL if line_number_size is 0. See LineNumberInfo structure for a description of a single entry in the line number info array.

char *class_file_name

Class name. Can be NULL.

char *source_file_name

Source file name. Can be NULL.

char *module_name

Module name. Can be NULL. The module name can be useful for distinguishing among different JIT engines. VTune Amplifier will display reported methods grouped by specific module.

unsigned int Offset

Opcode byte offset from the beginning of the method.

unsigned int LineNumber

Matching source line number offset (from beginning of source file).