From 25e888464681da74c9c5e0c2c2967db480a64d8f Mon Sep 17 00:00:00 2001 From: "Brian \"DragonLord\" Wong" Date: Sun, 28 Dec 2014 17:08:46 -0500 Subject: [PATCH] Update documentation, increase max filename length I've updating the documentation to better reflect the fact that memory use can now be limited. I've also increased the maximum filename length to 160 characters. --- CHANGES.md | 8 +++++++- README.md | 10 +++++++--- hi64.c | 6 +++--- hi64.h | 3 ++- 4 files changed, 19 insertions(+), 8 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index 70bb059..80fc131 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -20,4 +20,10 @@ - Added the ability to limit memory use. The memory limit is specified at runtime in megabytes as the first parameter to the benchmark executable. The output directory name is now specified by the second parameter. - - Fixed a typo in the out-of-memory error message. \ No newline at end of file + - Fixed a typo in the out-of-memory error message. + +## 0.3.1 (December 28, 2014) + + - Updated documentation to reflect the memory limiting feature. + - Increased the maximum file name length to 200 characters. + - Minor stylistic changes in code. diff --git a/README.md b/README.md index c723b4a..cc808a2 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,9 @@ disk paging to complete the computation, resulting in a dramatic slowdown and an attendant drop in QUIPS. Specifically, the benchmark stops when the QUIPS for the previous trial drops belows a predefined ratio of the peak QUIPS attained during the benchmark or when the shortest lap in a trial takes longer than a -predefined amount of time. (More details on how to set these limits follow.) +predefined amount of time. Alternatively, the maximum amount of memory to use +can be set and the benchmark will stop when this limit is reached. (More details +on how to set these limits follow.) ## Building and configuration @@ -75,7 +77,8 @@ An example build command would look like this: A Makefile is included to simplify compilation of the benchmark. Running `make` or `mingw32-make` will generate binaries which use `DSIZE` of 16-, 32-, and 64-bit integers as well as single-, double-, and extended-precision -floating-point numbers. +floating-point numbers. The Makefile currently assumes GCC; modify it as needed +if you are using a different compiler. The macros in the "Adjustable Defines" section of `hi64.h` determine the behavior of the benchmark, such as when to stop the benchmark and how many laps @@ -150,7 +153,8 @@ directory does not exist, the benchmark will not run. (This unusual output behavior was inherited from the original HINT code and will be changed in a future release to make the program easier to use.) -The program runs until the `STOPRT` or `STOPTM` thresholds are reached. This +The program runs until the `STOPRT` or `STOPTM` thresholds are reached, or until +the specified memory limit is reached. If no memory limit is specified, this generally means that the system will run out of memory and start swapping to disk heavily before the benchmark is finished. diff --git a/hi64.c b/hi64.c index 7aebcb1..cb077d4 100644 --- a/hi64.c +++ b/hi64.c @@ -27,7 +27,7 @@ int main(int argc, char *argv[]) { FILE *curv; /* Output file for QUIPS curve */ - char filnm[80]; /* Output file name */ + char filnm[200]; /* Output file name */ Speed qdata[NSAMP]; /* Array to keep track of QUIPs and time */ @@ -63,7 +63,7 @@ int main(int argc, char *argv[]) t0, /* Starting time */ t1, /* Ending time */ tdelta, /* Timer resolution */ - /* tlast, */ /* Time of last recorded trial */ + /* tlast, */ /* Time of last recorded trial */ tscout; /* Time for initial survey */ int64_t dbits, /* Number of bits of accuracy for dmax */ @@ -77,7 +77,7 @@ int main(int argc, char *argv[]) char* suffix; /* Suffix for data.suffix directory */ - printf("\nHI64 System Benchmark, Version 0.3.0"); + printf("\nHI64 System Benchmark, Version 0.3.1"); printf(" (December 28, 2014)\n"); printf("Derived from HINT originally developed by"); printf(" John L. Gustafson & Quinn O. Snell,\n"); diff --git a/hi64.h b/hi64.h index 99293d8..a0c31aa 100644 --- a/hi64.h +++ b/hi64.h @@ -125,7 +125,8 @@ /* run out of decent-speed memory well before this */ #endif -#define MXPROC 32 /* Maximum number of processors to use in shared */ /* memory configuration. Adjust as necessary. */ +#define MXPROC 32 /* Maximum number of processors to use in shared */ + /* memory configuration. Adjust as necessary. */ /******************************************************************************/ /* Non-Adjustable Defines */