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 9b9a58f..3707377 100644 (file)
--- a/docs/heap-profiling.html
+++ b/docs/heap-profiling.html
@@ -177,6 +177,22 @@ 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,