Enables V8 integration with the Intel VTune performance analysis tool. This allows the VTune profi…

src/third_party/vtune/jitprofiling.h

+/*
+  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 */
+    iJVM_EVENT_TYPE_SHUTDOWN = 2,                /* Program exiting
+                                                  * EventSpecificData NA
+                                                  */
+
+
+    /* JIT profiling */
+    iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED=13,     /* issued after method code jitted
+                                                  * into memory but before code is executed
+                                                  * EventSpecificData is an iJIT_Method_Load
+                                                  */
+
+    iJVM_EVENT_TYPE_METHOD_UNLOAD_START,         /* 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
+                                                  */
+
+    /* Method Profiling */
+
+    /* method name, Id and stack is supplied */
+    iJVM_EVENT_TYPE_ENTER_NIDS = 19,             /* issued when a method is about to be entered
+                                                  * EventSpecificData is iJIT_Method_NIDS
+                                                  */
+
+    /* method name, Id and stack is supplied */
+    iJVM_EVENT_TYPE_LEAVE_NIDS                   /* issued when a method is about to be left
+                                                  * EventSpecificData is iJIT_Method_NIDS
+                                                  */
+} iJIT_JVM_EVENT;
+
+typedef enum _iJIT_ModeFlags
+{
+    iJIT_NO_NOTIFICATIONS          = 0x0000,     /* No need to Notify VTune,
+                                                  * Since VTune is not running
+                                                  */
+    iJIT_BE_NOTIFY_ON_LOAD         = 0x0001,     /* 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_UNLOAD       = 0x0002,     /* 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_METHOD_ENTRY = 0x0004,     /* when turned on the jit must instrument all
+                                                  * the currently jited code with calls on
+                                                  * method entries
+                                                  */
+    iJIT_BE_NOTIFY_ON_METHOD_EXIT  = 0x0008      /* when turned on the jit must instrument all
+                                                  * the currently jited code with calls
+                                                  * on method exit
+                                                  */
+} iJIT_ModeFlags;
+
+
+ /* Flags used by iJIT_IsProfilingActive() */
+typedef enum _iJIT_IsProfilingActiveFlags
+{
+    iJIT_NOTHING_RUNNING           = 0x0000,     /* No profiler is running. Currently not used */
+    iJIT_SAMPLING_ON               = 0x0001,     /* Sampling is running. This is the default value
+                                                  * returned by iJIT_IsProfilingActive()
+                                                  */
+    iJIT_CALLGRAPH_ON              = 0x0002      /* Call Graph is running */
+} 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
+{
+    unsigned int       method_id;              /* Id of the method (same as the one passed in
+                                                * the iJIT_Method_Load struct
+                                                */
+
+} *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
+{
+    unsigned int       method_id;              /* unique method ID */
+    unsigned int       stack_id;               /* NOTE: no need to fill this field,
+                                                * it's filled by VTune */
+    char*              method_name;            /* method name (just the method,
+                                                * without the class)
+                                                */
+} *piJIT_Method_NIDS, iJIT_Method_NIDS;
+
+/* structures for the events:
+ * iJVM_EVENT_TYPE_METHOD_LOAD_FINISHED
+ */
+
+typedef struct _LineNumberInfo
+{
+    unsigned int        Offset;                 /* x86 Offset from the begining of the method*/
+    unsigned int        LineNumber;             /* source line number from the begining of
+                                                 * the source file
+                                                 */
+
+} *pLineNumberInfo, LineNumberInfo;
+
+typedef struct _iJIT_Method_Load
+{
+    unsigned int        method_id;              /* unique method ID - can be any unique value,
+                                                 * (except 0 - 999)
+                                                 */
+    char*               method_name;            /* method name (can be with or without
+                                                 * the class and signature, in any case
+                                                 * the class name will be added to it)
+                                                 */
+    void*               method_load_address;    /* virtual address of that method
+                                                 * - This determines the method range for the
+                                                 * iJVM_EVENT_TYPE_ENTER/LEAVE_METHOD_ADDR
+                                                 * events
+                                                 */
+    unsigned int        method_size;            /* Size in memory - Must be exact */
+    unsigned int        line_number_size;       /* Line Table size in number of entries
+                                                 * - Zero if none
+                                                 */
+    pLineNumberInfo     line_number_table;      /* Pointer to the begining of the line numbers
+                                                 * info array
+                                                 */
+    unsigned int        class_id;               /* unique class ID */
+    char*               class_file_name;        /* class file name */
+    char*               source_file_name;       /* source file name */
+    void*               user_data;              /* bits supplied by the user for saving in
+                                                 * the JIT file
+                                                 */
+    unsigned int        user_data_size;         /* the size of the user data buffer */
+    iJDEnvironmentType  env;                    /* NOTE: no need to fill this field,
+                                                 * it's filled by VTune
+                                                 */
+} *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__ */