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 isolate.
+   * \param state Execution state.
+   * \param record_c_entry_frame Include or skip the runtime function.
+   * \param update_stats Whether update the sample to the aggregated stats.
+   * \param update_state If set to true, V8 will update the register state

[alph, 2016/08/09 19:03:41]

Please change description to something like:
When set to true and V8 is running under a simulator, the method will use the
simulator register state rather than the one provided with |state| argument.
Otherwise the method will use provided register |state| as is.

[lpy, 2016/08/10 05:50:03]

Done.

+                         when running on simulator. Default value is true,

[alph, 2016/08/09 19:03:41]

missing *

[lpy, 2016/08/10 05:50:03]

Done.

+                         unless the 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);
-  static bool GetStackSample(Isolate* isolate, const v8::RegisterState& state,
+            RecordCEntryFrame record_c_entry_frame, bool update_stats,
+            bool update_state = true);
+  /**
+   * Get a call stack sample from the isolate.
+   * \param isolate The isolate.
+   * \param state Register state.
+   * \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 update_state If set to true, V8 will update the given register state
+                         when running on simulator. Default value is true,

[alph, 2016/08/09 19:03:41]

Missing *

[lpy, 2016/08/10 05:50:03]

Done.

+                         unless the register state is absolutely correct,
+                         otherwise don't use it.
+   * \note GetStackSample is thread and signal safe and should only be called
+   *                      when the JS thread is paused or interrupted.
+   *                      Otherwise the behavior is undefined.
+   */
+  static bool GetStackSample(Isolate* isolate, v8::RegisterState* state,
                              RecordCEntryFrame record_c_entry_frame,
                              void** frames, size_t frames_limit,
-                             v8::SampleInfo* sample_info);
+                             v8::SampleInfo* sample_info,
+                             bool update_state = true);

[alph, 2016/08/09 19:03:41]

I'd still mention the word simulator here, as otherwise it's not clear why would
it need to update the state.

So something like use_simulator_reg_state looks better to me.

[lpy, 2016/08/10 05:50:03]

Done.

   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 746 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_