Fix broken card table asserts.

[android-x86/dalvik.git] / docs / heap-profiling.html

diff --git a/docs/heap-profiling.html b/docs/heap-profiling.html
index 3570fdb..3707377 100644 (file)
--- a/docs/heap-profiling.html
+++ b/docs/heap-profiling.html
@@ -171,6 +171,28 @@ DDMS heap dump requests are now streamed directly out of the VM, removing
 the external storage requirement.
 </p>
 
+<h3>Android 2.3 ("Gingerbread")</h3>
+<p>
+The <code>kill -10</code> (<code>SIGUSR1</code>) method of generating heap
+dumps has been removed from the VM.
+</p>
+
+<h3>Android 3.0 ("Honeycomb")</h3>
+<p>
+A new command-line tool has been added:
+</p>
+<blockquote><pre>am dumpheap &lt;pid&gt; &lt;output-file-name&gt;</pre></blockquote>
+<p>
+Unlike the <code>SIGUSR1</code> approach, this does not require a rooted
+phone.  It's only necessary for the application to be debuggable (by setting
+<code>android:debuggable="true"</code> in the <code>&lt;application&gt;</code>
+element of the app manifest).  The output file is opened by "am", which
+means you can write the data to a file on <code>/sdcard</code> without
+needing the <code>WRITE_EXTERNAL_STORAGE</code> permission in your app.
+<p>
+The <code>runhat</code> shell function has been updated to use this.
+</p>
+
 <h2>Examining the data</h2>
 <p>
 The data file format was augmented slightly from the common hprof format,