Track JS allocations as they arrive with no affection on performance when tracking is switched off

include/v8-profiler.h

 // Copyright 2010 the V8 project authors. 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
@@ skipping 455 matching lines @@
   static const uint16_t kPersistentHandleNoClassId = 0;
 
   /** Returns memory used for profiler internal data and snapshots. */
   size_t GetProfilerMemorySize();
 
   /**
    * Sets a RetainedObjectInfo for an object group (see V8::SetObjectGroupId).
    */
   void SetRetainedObjectInfo(UniqueId id, RetainedObjectInfo* info);
 
+  /**
+   * Starts recording JS allocations immediately as they arrive
+   * and tracking of heap objects population statistics.

[Hannes Payer (out of office), 2013/10/02 18:00:29]

Please fill up the 80 characters line width.

[Alexandra Mikhaylova, 2013/10/03 16:27:55]

Done.

+   */
+  void StartRecordingHeapAllocations();
+
+  /**
+   * Stops recording JS allocations and tracking of heap objects
+   * population statistics, cleans all collected heap objects
+   * population statistics data.

[Hannes Payer (out of office), 2013/10/02 18:00:29]

Please fill up the 80 characters line width.

[Alexandra Mikhaylova, 2013/10/03 16:27:55]

Done.

+   */
+  void StopRecordingHeapAllocations();
+
+
  private:
   HeapProfiler();
   ~HeapProfiler();
   HeapProfiler(const HeapProfiler&);
   HeapProfiler& operator=(const HeapProfiler&);
 };
 
 
 /**
  * Interface for providing information about embedder's objects
@@ skipping 79 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_