Move SimulatorHelper into V8 out of profiler clients.

include/v8-profiler.h

 // Copyright 2010 the V8 project authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef V8_V8_PROFILER_H_
 #define V8_V8_PROFILER_H_
 
 #include <vector>
 #include "v8.h"  // NOLINT(build/include)
 
@@ skipping 42 matching lines @@
   // samples don't care.
   enum RecordCEntryFrame { kIncludeCEntryFrame, kSkipCEntryFrame };
 
   TickSample()
       : state(OTHER),
         pc(nullptr),
         external_callback_entry(nullptr),
         frames_count(0),
         has_external_callback(false),
         update_stats(true) {}
+
+  /**
+   * Initialize a tick sample from the isolate.
+   * \param isolate The currect isolate.
+   * \param state Execution state.
+   * \param updated_state When running on simulator, this will be set to
+                          the real register state used for sampling.
+   * \param record_c_entry_frame Include or skip the runtime function.
+   * \param update_stats Whether update the sample to the aggregated stats.
+   * \param use_first_state Force V8 to use the first register state to
+                            collect sample, default value is false, unless
+                            the first register state is absolutely correct,
+                            otherwise don't use it.
+   */
   void Init(Isolate* isolate, const v8::RegisterState& state,
-            RecordCEntryFrame record_c_entry_frame, bool update_stats);
+            RegisterState& updated_state,

[alph, 2016/07/28 23:57:06]

Hmm. Is it an output parameter? Where is it used?

+            RecordCEntryFrame record_c_entry_frame, bool update_stats,
+            bool use_first_state = false);

[alph, 2016/07/28 23:57:06]

The name looks a bit awkward. Not sure about a better name though. :-/

+  /**
+   * Get a call stack sample from the isolate.
+   * \param isolate The currect isolate.
+   * \param state Execution state.
+   * \param updated_state When running on simulator, this will be set to
+                          the real register state used for sampling.
+   * \param record_c_entry_frame Include or skip the runtime function.
+   * \param frames Caller allocated buffer to store stack frames.
+   * \param frames_limit Maximum number of frames to capture. The buffer must
+   *                     be large enough to hold the number of frames.
+   * \param sample_info The sample info is filled up by the function
+   *                    provides number of actual captured stack frames and
+   *                    the current VM state.
+   * \param use_first_state Force V8 to use the first register state to
+                            collect sample, default value is false, unless
+                            the first register state is absolutely correct,
+                            otherwise don't use it.
+   * \note GetStackSample should only be called when the JS thread is paused or
+   *       interrupted. Otherwise the behavior is undefined.
+   */
   static bool GetStackSample(Isolate* isolate, const v8::RegisterState& state,
+                             RegisterState& updated_state,
                              RecordCEntryFrame record_c_entry_frame,
                              void** frames, size_t frames_limit,
-                             v8::SampleInfo* sample_info);
+                             v8::SampleInfo* sample_info,
+                             bool use_first_state = false);
   StateTag state;  // The state of the VM.
   void* pc;        // Instruction pointer.
   union {
     void* tos;  // Top stack value (*sp).
     void* external_callback_entry;
   };
   static const unsigned kMaxFramesCountLog2 = 8;
   static const unsigned kMaxFramesCount = (1 << kMaxFramesCountLog2) - 1;
   void* stack[kMaxFramesCount];                 // Call stack.
   unsigned frames_count : kMaxFramesCountLog2;  // Number of captured frames.
@@ skipping 744 matching lines @@
   uint32_t index;  // Index of the time interval that was changed.
   uint32_t count;  // New value of count field for the interval with this index.
   uint32_t size;  // New value of size field for the interval with this index.
 };
 
 
 }  // namespace v8
 
 
 #endif  // V8_V8_PROFILER_H_