Initial setup of a SystemMemoryTest.
Set up a memory test to experiment with actionable memory metrics and
detect regressions in system server memory use.
The initial CUJ is to launch an instrumentation that does nothing for
a few seconds.
The initial metric is to read showmap for system_server and report
VSS, RSS, and PSS.
The CUJ and metrics will be made more interesting once the basic
infrastructure for continuously running the test is set up.
Bug: 111830582
Test: tradefed.sh run commandAndExit template/local_min --template:map test=system-memory-test
Change-Id: I8793adb66de4adab254173585e2c8afc754d4a3a
diff --git a/tests/SystemMemoryTest/README.txt b/tests/SystemMemoryTest/README.txt
new file mode 100644
index 0000000..de5042c
--- /dev/null
+++ b/tests/SystemMemoryTest/README.txt
@@ -0,0 +1,21 @@
+This directory contains a test for system server memory use.
+
+Directory structure
+===================
+device
+ - those parts of the test that run on device.
+
+host
+ - those parts of the test that run on host.
+
+Running the test
+================
+
+You can manually run the test as follows:
+
+ make tradefed-all system-memory-test SystemMemoryTestDevice
+ tradefed.sh run commandAndExit template/local_min --template:map test=system-memory-test
+
+This installs and runs the test on device. You can see the metrics in the
+tradefed output.
+