Get a filename of dumped heap profile in a V8 extension HeapProfilerDump().

third_party/tcmalloc/chromium/src/gperftools/heap-profiler.h

 /* Copyright (c) 2005, Google Inc.
  * 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
@@ skipping 72 matching lines @@
  * but the currently accumulated profiling information will be cleared.
  */
 PERFTOOLS_DLL_DECL void HeapProfilerStop();
 
 /* Dump a profile now - can be used for dumping at a hopefully
  * quiescent state in your program, in order to more easily track down
  * memory leaks. Will include the reason in the logged message
  */
 PERFTOOLS_DLL_DECL void HeapProfilerDump(const char *reason);
 
+/* Dump a profile now and store the filename where the profile is dumped to
+ * in addition to HeapProfilerDump().
+ */
+PERFTOOLS_DLL_DECL void HeapProfilerDumpWithFileName(
+    const char *reason,
+    char* dumped_filename_buffer,
+    int filename_buffer_length);

[Dai Mikurube (NOT FULLTIME), 2013/02/13 16:04:46]

FYI, |dumped_filename_buffer| is output of this function.  Reviewers may think
that it should be the last argument, but it follows the existing convention of
tcmalloc.  See the line 195 in heap-profile-table for example:
http://src.chromium.org/viewvc/chrome/trunk/src/third_party/tcmalloc/chromium...

We may want more comments on the arguments.  I'll add it later.

+
 /* Generate current heap profiling information.
  * Returns an empty string when heap profiling is not active.
  * The returned pointer is a '\0'-terminated string allocated using malloc()
  * and should be free()-ed as soon as the caller does not need it anymore.
  */
 PERFTOOLS_DLL_DECL char* GetHeapProfile();
 
 /* Callback function for iterating through all allocated objects. Accepts
  * pointer to user data passed into IterateAllocatedObjects and pointer
  * to the object being visited.
  */
 typedef void (*AddressVisitor)(void* data, const void* ptr);
 
 /* Iterate over all live allocated objects. For each allocation the
  * callback will be invoked with the data argument and allocation pointer.
  */
 PERFTOOLS_DLL_DECL void IterateAllocatedObjects(AddressVisitor callback,
                                                 void* data);
 
 #ifdef __cplusplus
 }  // extern "C"
 #endif
 
 #endif  /* BASE_HEAP_PROFILER_H_ */