[lkml]   [2011]   [Aug]   [4]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectMMTests 0.01
At LSF/MM at some point a request was made that a series of tests be
identified that were of interest to MM developers and that could be
used for testing the Linux memory management subsystem. At the time,
I was occasionally posting tarballs of whatever scripts I happened to
be using at the time but they were not generally usable and tended to
be specific to a set of patches. I promised I would produce something
usable by others but never got around to it. Over the last four months,
I needed a better framework when testing against both distribution
kernels and mainline so without further ado

I am not claiming that this is comprehensive in any way but it is
almost always what I start with when testing patch sets. In preparation
for identifying problems with backports, I also ran a series of tests
against mainline kernels over the course of two months when machines
were otherwise idle. I have not actually had a chance to go through
all the results and identify each problem but I needed to have the
raw data available for my own reference so might as well share.

The directories refer to the distribution used but not the
kernel which is downloaded from Directory structure is
distro/config/machine/comparison.html. For example a set of benchmarks
used for evaluating the page and slab allocators on a test machine
called "hydra" is located at

I know the report structure looks crude but I was not interested
in making them pretty. Due to the fact that some of the scripts
are extremely old, the quality and coding styles vary considerably.
This may get cleaned up over time but in the meantime, try and keep
the contents of your stomach down if you are reading the scripts.

The documentation is not great and so some of the capabilities such
as being able to reconfigure swap for a benchmark is not mentioned.
For my own series, I'll relase the mmtests tarball I used if asked.
If someone wants to use the tarball for their own testing but cannot
configure it, complain on the linux-mm list and if I can, I'll offer

==== MMTests README ====

MMTests is a configurable test suite that runs a number of common
workloads of interest to MM developers. Ideally this would have been
to integrated with LTP, xfstests or Phoronix Test or implemented
with autotest. Unfortunately, large portions of these tests are
cobbled together over a number of years with varying degrees of
quality before decent test frameworks were common. The refactoring
effort to integrate with another framework is significant.


The top-level directory has a single driver script called which reads a config file that describes how the
benchmarks should be run, configures the system and runs the requested
tests. config also has some per-test configuration items that can be
set depending on the test. The driver script takes the name of the
test as a parameter. Generally, this would be a symbolic name naming
the kernel being tested.

Each test is driven by a script which reads
the relevant script. High level items such as
profiling are configured from the top-level script while the driver
scripts typically convert the config parameters into switches for a
"shellpack". A shellpack is a pair of benchmark and install scripts
that are all stored in shellpacks/ .

Monitors can be optionally configured. A full list is in monitors/
. Care should be taken with monitors as there is a possibility that
they introduce overhead of their own. Hence, for some performance
sensitive tests it is preferable to have no monitoring.

Many of the tests download external benchmarks. An attempt will be
made to download from a mirror . To get an idea where the mirror
should be located, grep for MIRROR_LOCATION= in shellpacks/.

A basic invocation of the suite is

$ cp config-global-dhp__pagealloc-performance config
$ ./ --no-monitor 3.0-nomonitor
$ ./ --run-monitor 3.0-runmonitor


The config file used is always called "config". A number of other
sample configuration files are provided that have a given theme. Some
important points of variability are;

MMTESTS is a list of what tests will be run

WEBROOT is the location where a number of tarballs are mirrored. For example,
kernbench tries to download
$WEBROOT/kernbench/linux-2.6.30.tar.gz . If this is not available,
it is downloaded from the internet. This can add delays in testing
and consumes bandwidth so is worth configuring.

LINUX_GIT is the location of a git repo of the kernel. At the moment it's only
used during report generation

These parameters determine what profiling runs are done. Even with
profiling enabled, a non-profile run can be used to ensure that
the profile and non-profile runs are comparable.

It's possible to use a different swap configuration than what is
provided by default.

If the target machine has partitions suitable for configuring RAID,
they can be specified here. This RAID partition is then used for
all the tests

Use this partition for all tests

The filesystem, mkfs parameters and mount arguments for the test

Available tests

Note the ones that are marked untested. These have been ported from other
test suites but no guarantee they actually work correctly here. If you want
to run these tests and run into a problem, report a bug.

Builds a kernel 5 times recording the time taken to completion.
An average time is stored. This is sensitive to the overall
performance of the system as it hits a number of subsystems.

Similar to kernbench except it runs a number of kernel compiles
in parallel. Can be useful for stressing the system and seeing
how well it deals with simple fork-based parallelism.

Runs a short version of aim9 by default. Each test runs for 60
seconds. This is a micro-benchmark of a number of VM operations. It's
sensitive to changes in the allocator paths for example.

Runs the STREAM benchmark a number of times for varying sizes. An
average is recorded. This can be used to measure approximate memory
throughput or the average cost of a number of basic operations. It is
sensitive to cache layout used for page faults.

vmr-cacheeffects (untested)
Performs linear and random walks on nodes of different sizes stored in
a large amount of memory. Sensitive to cache footprint and layout.

vmr-createdelete (untested)
A micro-benchmark that measures the time taken to create and delete
file or anonymous mappings of increasing sizes. Sensitive to changes
in the page fault path performance.

A basic filesystem benchmark.

This tests write workloads varying the number of files and directory

Hackbench is generally a scheduler benchmark but is also sensitive to
overhead in the allocators and to a lesser extent the fault paths.
Can be run for either sockets or pipes.

This is a simple single-threaded benchmark that downloads a large
tar file, expands it a number of times, creates a new tar and
expands it again. Each operation is timed and is aimed at shaking
out stall-related bugs when copying large amounts of data

Similar to largecopy except it uses dd instead of cp.

This downloads and builds libreoffice. It is a more aggressive
compile-orientated test. This is a very download-intensive
benchmark and was only created as a reproduction case for
a bug.

The NAS Parallel Benchmarks for the serial and openmp versions of
the test.

Runs the netperf benchmark for *_STREAM on the local machine.
Sensitive to cache usage and allocator costs. To test for cache line
bouncing, the test can be configured to bind to certain processors.

Run the postmark benchmark. Optionally a program can be run in
the background that consumes anonymous memory. The background
program is vary rarely needed except when trying to identify
desktop stalls during heavy IO.

speccpu (untested)
SPECcpu, what else can be said. A restriction is that you must have
a mirrored copy of the tarball as it is not publicly available.

specjvm (untested)
SPECjvm. Same story as speccpu

specomp (untested)
SPEComp. Same story as speccpu

Runs the complex workload for sysbench backed by postgres. Running
this test requires a significant build environment on the test
machine. It can run either read-only or read/write tests.

This is a simple writeback test based on dd. It's meant to be
easy to understand and quick to run. Useful for measuring page
writeback changes.

ltp (untested)
The LTP benchmark. What it is testing depends on exactly which of the
suite is configured to run.

ltp-pounder (untested)
ltp pounder is a non-default test that exists in LTP. It's used by
IBM for hardware certification to hammer a machine for a configured
number of hours. Typically, they expect it to run for 72 hours
without major errors. Useful for testing general VM stability in
high-pressure low-memory situations.

This test requires that the system not have too much memory and
that systemtap is available. Typically, it's tested with 3GB of
RAM. It builds a number of kernels in parallel such that total
memory usage is 1.5 times physical memory. When this is running
for 5 minutes, it tries to allocate a large percentage of memory
(e.g. 95%) as huge pages recording the latency of each operation as it
goes. It does this twice. It then cancels the kernel compiles, cleans
the system and tries to allocate huge pages at rest again. It's a
basic test for fragmentation avoidance and the performance of huge
page allocation.

xfstests (untested)
This is still at prototype level and aimed at running testcase 180
initially to reproduce some figures provided by the filesystems people.


For reporting, there is a basic script. It must be updated
with a list of kernels you want to compare and in what order. It generates a
table for each test, operation and kernel showing the relative performance
of each. The test reporting scripts are in subreports/.
should be run from the path storing the test logs. By default this is
work/log. If you are automating tests from an external source, work/log is
what you should be capturing after a set of tests complete.

If monitors are configured such as ftrace, there are additional
processing scripts. They can be activated by setting FTRACE_ANALYSERS in A basic post-process script is mmtests-duration which
simply reports how long an individual test took and what its CPU usage was.

There are a limited number of graphing scripts included in report/


o Add option to test on filesystem loopback device stored on tmpfs
o Add volanomark
o Create config-* set suitable for testing scheduler to isolate situations
where the scheduler was the main cause of a regression

Mel Gorman

 \ /
  Last update: 2011-08-04 16:41    [W:0.062 / U:7.660 seconds]
©2003-2018 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site