| Index: src/third_party/vtune/jitprofiling.h
|
| ===================================================================
|
| --- src/third_party/vtune/jitprofiling.h (revision 0)
|
| +++ src/third_party/vtune/jitprofiling.h (revision 0)
|
| @@ -0,0 +1,298 @@
|
| +/*
|
| + This file is provided under a dual BSD/GPLv2 license. When using or
|
| + redistributing this file, you may do so under either license.
|
| +
|
| + GPL LICENSE SUMMARY
|
| +
|
| + Copyright (c) 2005-2012 Intel Corporation. All rights reserved.
|
| +
|
| + This program is free software; you can redistribute it and/or modify
|
| + it under the terms of version 2 of the GNU General Public License as
|
| + published by the Free Software Foundation.
|
| +
|
| + This program is distributed in the hope that it will be useful, but
|
| + WITHOUT ANY WARRANTY; without even the implied warranty of
|
| + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
| + General Public License for more details.
|
| +
|
| + You should have received a copy of the GNU General Public License
|
| + along with this program; if not, write to the Free Software
|
| + Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
|
| + The full GNU General Public License is included in this distribution
|
| + in the file called LICENSE.GPL.
|
| +
|
| + Contact Information:
|
| + http://software.intel.com/en-us/articles/intel-vtune-amplifier-xe/
|
| +
|
| + BSD LICENSE
|
| +
|
| + Copyright (c) 2005-2012 Intel Corporation. All rights reserved.
|
| + All rights reserved.
|
| +
|
| + Redistribution and use in source and binary forms, with or without
|
| + modification, are permitted provided that the following conditions
|
| + are met:
|
| +
|
| + * Redistributions of source code must retain the above copyright
|
| + notice, this list of conditions and the following disclaimer.
|
| + * Redistributions in binary form must reproduce the above copyright
|
| + notice, this list of conditions and the following disclaimer in
|
| + the documentation and/or other materials provided with the
|
| + distribution.
|
| + * Neither the name of Intel Corporation nor the names of its
|
| + contributors may be used to endorse or promote products derived
|
| + from this software without specific prior written permission.
|
| +
|
| + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
| + A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
| + OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
| + SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
| + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
| + DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
| + THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| + OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| +*/
|
| +#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 begining of the method*/
|
| + unsigned int Offset;
|
| +
|
| + /* source line number from the begining 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 begining 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__ */
|
|
|