122 lines
3.9 KiB
Text
122 lines
3.9 KiB
Text
$NetBSD: patch-aa,v 1.2 1999/02/10 14:59:50 frueauf Exp $
|
|
|
|
*** /dev/null Fri Jun 12 13:20:02 1998
|
|
--- hint.1 Fri Jun 12 14:14:15 1998
|
|
***************
|
|
*** 0 ****
|
|
--- 1,115 ----
|
|
+ .\" Copyright 1998 Iowa State University Research Foundation, Inc.
|
|
+ .\"
|
|
+ .\" This program is free software; you can redistribute it and/or modify
|
|
+ .\" it under the terms of the GNU General Public License as published by
|
|
+ .\" the Free Software Foundation. You should have received a copy of the
|
|
+ .\" GNU General Public License along with this program; if not, write to the
|
|
+ .\" Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
+ .\"
|
|
+ .\" THIS SOFTWARE IS PROVIDED BY THE IOWA STATE UNIVERSITY RESEARCH
|
|
+ .\" FOUNDATION ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
|
+ .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
+ .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
+ .\" IN NO EVENT SHALL THE IOWA STATE UNIVERSITY RESEARCH FOUNDATION BE
|
|
+ .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
|
|
+ .\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
+ .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
+ .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
+ .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
+ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
+ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
+ .\"
|
|
+ .\" Id
|
|
+ .\"
|
|
+ .Dd May 18, 1998
|
|
+ .Dt HINT 1
|
|
+ .Os
|
|
+ .Sh NAME
|
|
+ .Nm hint
|
|
+ .Nd scalable benchmark for CPU and memory
|
|
+ .Sh SYNOPSIS
|
|
+ .Nm hint
|
|
+ .Sh DESCRIPTION
|
|
+ The program
|
|
+ .Nm
|
|
+ reveals many aspects of computer performance: operation speed,
|
|
+ precision, memory bandwidth, and usable memory size. HINT measures
|
|
+ "QUIPS" (QUality Improvement Per Second) as a function of time. "Net
|
|
+ QUIPS" is a single number that summarizes the QUIPS over time.
|
|
+ .Pp
|
|
+ As provided,
|
|
+ .Nm
|
|
+ tests double-precision floating point arithmetic. The original source
|
|
+ can be re-compiled to test other data types (such as long integers).
|
|
+ The original source should be available directly from
|
|
+ .Pa ftp://ftp.scl.ameslab.gov/pub/HINT/ .
|
|
+ See
|
|
+ .Pa http://www.scl.ameslab.gov/Projects/HINT/
|
|
+ for more information on HINT, including technical reports and an
|
|
+ on-line database of HINT results.
|
|
+ .Pp
|
|
+ The output of
|
|
+ .Nm
|
|
+ is a file in the directory
|
|
+ .Pa data
|
|
+ named
|
|
+ .Pa DOUBLE
|
|
+ which contains five columns:
|
|
+ .Bl -enum
|
|
+ .It
|
|
+ Time
|
|
+ .It
|
|
+ QUIPS
|
|
+ .It
|
|
+ Quality
|
|
+ .It
|
|
+ Subintervals
|
|
+ .It
|
|
+ Memory Used
|
|
+ .El
|
|
+ .Pp
|
|
+ The first two columns are used to produce the QUIPS graph. The third
|
|
+ and fourth columns are Quality and subintervals. These columns can be
|
|
+ used to check for loss of quality due to insufficient precision and
|
|
+ poor choices of which rectangle to split. The fifth is useful for
|
|
+ finding the sizes of memory regimes, like where primary cache
|
|
+ saturates or where virtual memory is first invoked.
|
|
+ .Pp
|
|
+ The file is set up in a format suitable for
|
|
+ .Xr gnuplot 1
|
|
+ or similar plotting packages. QUIPS graphs should be plotted on a
|
|
+ semi-log scale with log of time as the horizontal axis and QUIPS as
|
|
+ the vertical axis. The following gnuplot commands would be suitable to
|
|
+ display the QUIPS graph from the file
|
|
+ .Pa data/DOUBLE :
|
|
+ .nf
|
|
+
|
|
+ set logscale x
|
|
+ plot "data/DOUBLE"
|
|
+
|
|
+ .fi
|
|
+ QUIPS vs. memory use can also be plotted to reveal memory regime sizes,
|
|
+ by using the following
|
|
+ .Xr gnuplot 1
|
|
+ command:
|
|
+ .nf
|
|
+
|
|
+ plot "data/DOUBLE" using 5:2
|
|
+
|
|
+ .fi
|
|
+
|
|
+ .Sh FILES
|
|
+ .Bl -tag -width DOUBLE -compact
|
|
+ .It Pa DOUBLE output file in the directory
|
|
+ .Pa data
|
|
+ .El
|
|
+ .Sh SEE ALSO
|
|
+ .Xr gnuplot 1
|
|
+ .Sh AUTHOR
|
|
+ .Nm HINT
|
|
+ was developed by the Scalable Computing Laboratory (SCL) of Ames Laboratory,
|
|
+ a US Department of Energy laboratory.
|
|
+ .Sh BUGS
|
|
+ .Nm
|
|
+ only writes its output file in the directory
|
|
+ .Pa data .
|