#
# CDDL HEADER START
#
# The contents of this file are subject to the terms
# of the Common Development and Distribution License
# (the "License"). You may not use this file except
# in compliance with the License.
#
# You can obtain a copy of the license at
# See the License for the specific language governing
# permissions and limitations under the License.
#
# When distributing Covered Code, include this CDDL
# HEADER in each file and include the License file at
# usr/src/OPENSOLARIS.LICENSE. If applicable,
# add the following below this CDDL HEADER, with the
# fields enclosed by brackets "[]" replaced with your
# own identifying information: Portions Copyright [yyyy]
# [name of copyright owner]
#
# CDDL HEADER END
#
#
# Copyright 2005 Sun Microsystems, Inc. All rights reserved.
# Use is subject to license terms.
#
Building the tarball
--------------------
As long as cc is in your path, (gcc on Linux),
% tar xf libMicro.tar
% make
will build the benchmark suite.
Running the benchmarks
-----------------------
A set of generic scripts to invoke each micro benchmark
are created in the bin directory; these may be invoked
directly. Note that the actual binaries are created in
OS-specific directories; this allows one to build for
all varients (x86/sparc/Solaris/Linux) in one place.
To collect a complete set of benchmarks, use the bench
script and redirect its output to a file.
% ./bench > output
To compare the output of two or more runs, use multiview in the src
directory:
% ./multiview reference compare1 compare2 compare2 > compare.html
%
where the reference and compare files contain the output of different
libmicro runs.
The compare.html file will allow quick comparisons to be drawn,
allowing a variety of experiments to be quickly analyzed.
All benchmarks support the following options:
[-1] (single process; overrides -P > 1)
[-A] (align with clock)
[-B batch-size (default 10)]
[-C minimum number of samples (default 0)]
[-D duration in msecs (default 10s)]
[-E (echo name to stderr)]
[-H] (suppress headers)
[-I] specify approx. time per op in nsecs
[-L] (print argument line)
[-M] (reports mean rather than median)
[-N test-name ]
[-P processes (default 1)]
[-S] (print detailed stats)
[-T threads (default 1)]
[-V] (print the libMicro version and exit)
[-W] (flag possible benchmark problems)