View source for Firefox OS/Performance/Automation/Memory Consumption

= Memory Consumption =

== Summary ==

Measures memory consumption in several test scenarios to detect abnormal memory usage patterns.

* '''Lead:''' Wander Lairson Costa

==== Memory usage parameters ====

{| border="1"
|-
!Parameter !! Description
|-
| VSS || Virtual set size
|-
| RSS || Resident set size
|-
| USS || Unique set size
|-
| PSS || Proportional set size
|-
|}

== Test cases ==

=== Startup Memory Consumption ===

* '''Tracking Bug:''' [http://bugzilla.mozilla.org/show_bug.cgi?id=1044297 1044297]

Measures memory consumption of the application and b2g process after [https://developer.mozilla.org/en-US/Apps/Build/Performance/Firefox_OS_app_responsiveness_guidelines moz-app-loaded event].

Launch each of the following apps:

* Browser
* Calendar
* Camera
* Clock
* Contacts
* Dialer
* Email
* FM Radio
* Gallery
* Marketplace
* Music
* Settings
* SMS
* Template
* Usage
* Video

For each app, report the the memory usage after the moz-app-loaded event, for both the app and b2g process. Below you can see a flowchart of the test case:

[[File:Moz-app-load-mem-test.jpg|600x600px|framed|center|Flowchart of the startup memory test]]

==== Common Setup ====

# Set up workload
# Restart B2G process
# Invoke launch programmatically
# Inject the Performance Helper
# App instrumentation throws timeline events at appropriate times
# Performance helper observes events
# After moz-app-loaded event grab memory usage parameters for the app and b2g process

==== Results ====
* Result is the memory usage summary for app and b2g process.

=== Homescreen memory performance ===

* '''Tracking Bug:''' [https://bugzilla.mozilla.org/show_bug.cgi?id=1048443 1048443]

TBD

=== Identify apps memory leaks ===

* '''Tracking Bug:''' [https://bugzilla.mozilla.org/show_bug.cgi?id=1041668 1041668]

TBD

== References ==

* [http://www.akkadia.org/drepper/cpumemory.pdf What every programmer should know about memory]
* [http://sealedabstract.com/rants/why-mobile-web-apps-are-slow/ Why mobile web apps are slow]
* [https://developer.mozilla.org/en-US/Apps/Build/Performance/Firefox_OS_app_responsiveness_guidelines Firefox OS App Responsiveness Guidelines]

<small>[http://wiki.mozilla.org/FirefoxOS/Performance/Automation/Memory_Consumption]</small>