about summary refs log tree commit diff
path: root/benchtests
diff options
context:
space:
mode:
authorPaul Zimmermann <Paul.Zimmermann@inria.fr>2020-08-04 13:27:39 +0200
committerCarlos O'Donell <carlos@redhat.com>2020-08-04 12:44:41 -0400
commit50a8dd367e305bb6c6146c564fd48c193cc94069 (patch)
tree34e00a7cd75c9a8c757ec490379e7db00067de82 /benchtests
parent45069ac2a994758d06c035804a600066016801f9 (diff)
downloadglibc-50a8dd367e305bb6c6146c564fd48c193cc94069.tar.gz
glibc-50a8dd367e305bb6c6146c564fd48c193cc94069.tar.xz
glibc-50a8dd367e305bb6c6146c564fd48c193cc94069.zip
benchtests/README update.
Improve documentation of the 'name' directive and the 'workload' mechanism.

Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Diffstat (limited to 'benchtests')
-rw-r--r--benchtests/README20
1 files changed, 14 insertions, 6 deletions
diff --git a/benchtests/README b/benchtests/README
index f440f3295a..44736d7e63 100644
--- a/benchtests/README
+++ b/benchtests/README
@@ -125,17 +125,25 @@ math functions perform computations at different levels of precision (64-bit vs
 performance of these functions.  One could separate inputs for these domains in
 the same file by using the `name' directive that looks something like this:
 
-  ##name: 240bit
+  ##name: 240bits
 
-See the pow-inputs file for an example of what such a partitioned input file
-would look like.
+All inputs after the ##name: 240bits directive and until the next `name'
+directive (or the end of file) are part of the "240bits" benchmark and
+will be output separately in benchtests/bench.out.  See the pow-inputs file
+for an example of what such a partitioned input file would look like.
 
-It is also possible to measure throughput of a (partial) trace extracted from
-a real workload.  In this case the whole trace is iterated over multiple times
-rather than repeating every input multiple times.  This can be done via:
+It is also possible to measure latency and reciprocal throughput of a
+(partial) trace extracted from a real workload.  In this case the whole trace
+is iterated over multiple times rather than repeating every input multiple
+times.  This can be done via:
 
   ##name: workload-<name>
 
+where <name> is simply used to distinguish between different traces in the
+same file.  To create such a trace, you can simply extract using printf()
+values uses for a specific application, or generate random values in some
+interval.  See the expf-inputs file for an example of this workload mechanism.
+
 Benchmark Sets:
 ==============