summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAndy McFadden <fadden@android.com>2010-10-19 11:25:02 -0700
committerAndy McFadden <fadden@android.com>2010-10-19 11:28:09 -0700
commit6440496a8320c8e7f3d489d87ce2da2788a3996c (patch)
tree4870313ddeeb8a462b43152f0dcbda684a4cd2cd /docs
parentf44af1c40f4a81aed17765671b100edeeec28dab (diff)
downloadandroid_dalvik-6440496a8320c8e7f3d489d87ce2da2788a3996c.tar.gz
android_dalvik-6440496a8320c8e7f3d489d87ce2da2788a3996c.tar.bz2
android_dalvik-6440496a8320c8e7f3d489d87ce2da2788a3996c.zip
Update heap dump notes.
The release order changed slightly. Bug 3110872 is related. Change-Id: I2b2982a29910ee58746188e9dbd61ffd9c3b3d64
Diffstat (limited to 'docs')
-rw-r--r--docs/heap-profiling.html15
1 files changed, 11 insertions, 4 deletions
diff --git a/docs/heap-profiling.html b/docs/heap-profiling.html
index ca0c2bce7..dfb3cd18b 100644
--- a/docs/heap-profiling.html
+++ b/docs/heap-profiling.html
@@ -165,16 +165,21 @@ you must have a card inserted and the permission enabled in your application.
</p>
-<h3>Android 2.2 ("Froyo"), Android 2.x ("Gingerbread")</h3>
+<h3>Android 2.2 ("Froyo")</h3>
<p>
DDMS heap dump requests are now streamed directly out of the VM, removing
the external storage requirement.
</p>
-<h3>Android 2.x ("Honeycomb")</h3>
+<h3>Android 2.3 ("Gingerbread")</h3>
<p>
The <code>kill -10</code> (<code>SIGUSR1</code>) method of generating heap
-dumps has been removed, in favor of a much more useful shell command:
+dumps has been removed from the VM.
+</p>
+
+<h3>Android x.y ("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>
@@ -183,7 +188,9 @@ 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.
+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>