Change testNum to refNum

master
Christopher J. Morrone 2012-01-13 14:05:13 -08:00
parent bbcc9c26b6
commit 5f162061bd
4 changed files with 14 additions and 62 deletions

View File

@ -20,10 +20,6 @@ Index:
* Frequently Asked Questions
8. How do I . . . ?
* Output
9. Enhanced output description
*******************
* 1. DESCRIPTION *
*******************
@ -57,7 +53,7 @@ Two ways to run IOR:
**************
These options are to be used on the command line. E.g., 'IOR -a POSIX -b 4K'.
-a S api -- API for I/O [POSIX|MPIIO|HDF5|NCMPI]
-A N testNum -- test number for reference in some output
-A N refNum -- user reference number to include in long summary
-b N blockSize -- contiguous bytes to write per task (e.g.: 8, 4k, 2m, 1g)
-B useO_DIRECT -- uses O_DIRECT for POSIX, bypassing I/O buffers
-c collective -- collective I/O
@ -122,7 +118,8 @@ IMPORTANT NOTE: Contrary to appearance, the script options below are NOT case se
GENERAL:
========
* testNum - test reference number for some output [-1]
* refNum - user supplied reference number, included in
long summary [0]
* api - must be set to one of POSIX, MPIIO, HDF5, or NCMPI
depending on test [POSIX]
@ -627,48 +624,3 @@ HOW DO I CORRECT FOR CLOCK SKEW BETWEEN NODES IN A CLUSTER?
difference. To see an egregious outlier, use the '-j' option. Be sure
to set this value high enough to only show a node outside a certain time
from the mean.
**************************
* 9. OUTPUT DESCRIPTION *
**************************
Output Statistics:
The quantity "aggregate operations/sec" was added to the existing "aggregate data rate" test log print file.
An "operation" is defined to be a write or read within an open/close [open/write|read/close].
Multiple writes or reads within an open/close are also counted as multiple operations.
Operation Max (MiB) Min (MiB) Mean (MiB) Std Dev Max (OPs) Min (OPs) Mean (OPs) Std Dev Mean(s)
--------- --------- --------- ---------- ------- --------- --------- ---------- ------- -------
read 309.30 17.20 164.67 73.80 309.30 17.20 164.67 73.80 0.06581
(line-continued)
#Tasks tPN reps fPP reord reordoff reordrand seed segcnt blksiz xsize aggsize
8 2 100 1 0 1 0 0 1 1048576 1048576 8388608 5
Where:
Max (MiB) - Maximum aggregate data rate of 100 iterations (reps)
Min (MiB) - Minumum aggregate data rate of 100 iterations (reps)
Mean(MiB) - Mean aggregate data rate of 100 iterations (reps)
Std Dev - Standard deviation aggregate data rate of 100 iterations (reps)
Max (OPs) - Maximum aggregate operations per second of 100 iterations (reps)
Min (OPs) - Minimum aggregate operations per second of 100 iterations (reps)
Mean (OPs)- Mean aggregate operations per second of 100 iterations (reps)
Std Dev - Standard deviation aggregate operations per second of 100 iteration (reps)
Mean(s) - Mean time per iteration (seconds)
#Tasks - number of I/O processes
tPN - number of I/O processes per node (per shared memory environment)
reps - number of times (iterations) each test is run.
The max,min,mean,ave,sdev above are calculated over "reps" tests
fPP - files per process
reord - constant node offset flag for reads
reordoff - node offset for reads
reordrand - random node offset flag for reads
seed - random seed for node random node offset
segcnt - number of seqments per file
blksiz - total MBytes written/read per process
xsize - total MBytes written/read per process per operation
aggsize - total Mbytes written/read by all processes per operations
5 - testnum
This includes a file "contention" histogram showing the number of files accessed 0,1,2,3,... times for a specified random pattern.

View File

@ -167,7 +167,6 @@ void init_IOR_Param_t(IOR_param_t * p)
p->mode = IOR_IRUSR | IOR_IWUSR | IOR_IRGRP | IOR_IWGRP;
p->openFlags = IOR_RDWR | IOR_CREAT;
p->TestNum = -1;
assert(available_aiori[0] != NULL);
strncpy(p->api, available_aiori[0]->name, MAX_STR);
strncpy(p->platform, "HOST(OSTYPE)", MAX_STR);
@ -662,7 +661,7 @@ static void DisplayUsage(char **argv)
char *opts[] = {
"OPTIONS:",
" -a S api -- API for I/O [POSIX|MPIIO|HDF5|NCMPI]",
" -A N testNum -- test number for reference in some output",
" -A N refNum -- user supplied reference number to include in the summary",
" -b N blockSize -- contiguous bytes to write per task (e.g.: 8, 4k, 2m, 1g)",
" -B useO_DIRECT -- uses O_DIRECT for POSIX, bypassing I/O buffers",
" -c collective -- collective I/O",
@ -1509,7 +1508,7 @@ static void ShowSetup(IOR_param_t *params)
static void ShowTest(IOR_param_t * test)
{
fprintf(stdout, "TEST:\t%s=%d\n", "id", test->id);
fprintf(stdout, "\t%s=%d\n", "testnum", test->TestNum);
fprintf(stdout, "\t%s=%d\n", "refnum", test->referenceNumber);
fprintf(stdout, "\t%s=%s\n", "api", test->api);
fprintf(stdout, "\t%s=%s\n", "platform", test->platform);
fprintf(stdout, "\t%s=%s\n", "testFileName", test->testFileName);
@ -1656,6 +1655,7 @@ static void PrintLongSummaryOneOperation(IOR_test_t *test, double *times, char *
fprintf(stdout, "%10.2f ", bw->sd / MEBIBYTE);
fprintf(stdout, "%10.5f ",
mean_of_array_of_doubles(times, reps));
fprintf(stdout, "%d ", params->id);
fprintf(stdout, "%d ", params->numTasks);
fprintf(stdout, "%d ", params->tasksPerNode);
fprintf(stdout, "%d ", params->repetitions);
@ -1668,8 +1668,8 @@ static void PrintLongSummaryOneOperation(IOR_test_t *test, double *times, char *
fprintf(stdout, "%lld ", params->blockSize);
fprintf(stdout, "%lld ", params->transferSize);
fprintf(stdout, "%lld ", results->aggFileSizeForBW[0]);
fprintf(stdout, "%d ", params->TestNum);
fprintf(stdout, "%s", params->api);
fprintf(stdout, "%s ", params->api);
fprintf(stdout, "%d", params->referenceNumber);
fprintf(stdout, "\n");
fflush(stdout);
@ -1696,8 +1696,8 @@ static void PrintLongSummaryHeader()
fprintf(stdout, "%-9s %10s %10s %10s %10s %10s",
"Operation", "Max(MiB)", "Min(MiB)", "Mean(MiB)", "StdDev",
"Mean(s)");
fprintf(stdout, " #Tasks tPN reps fPP reord reordoff reordrand seed"
" segcnt blksiz xsize aggsize TestNum API\n");
fprintf(stdout, " Test# #Tasks tPN reps fPP reord reordoff reordrand seed"
" segcnt blksiz xsize aggsize API RefNum\n");
}
static void PrintLongSummaryAllTests(IOR_test_t *tests_head)

View File

@ -43,7 +43,7 @@ typedef struct
char debug[MAX_STR]; /* debug info string */
unsigned int mode; /* file permissions */
unsigned int openFlags; /* open flags */
int TestNum; /* test reference number */
int referenceNumber; /* user supplied reference number */
char api[MAX_STR]; /* API for I/O */
char apiVersion[MAX_STR]; /* API version */
char platform[MAX_STR]; /* platform type */

View File

@ -132,8 +132,8 @@ void DecodeDirective(char *line, IOR_param_t *params)
}
if (strcasecmp(option, "api") == 0) {
strcpy(params->api, value);
} else if (strcasecmp(option, "testnum") == 0) {
params->TestNum = atoi(value);
} else if (strcasecmp(option, "refnum") == 0) {
params->referenceNumber = atoi(value);
} else if (strcasecmp(option, "debug") == 0) {
strcpy(params->debug, value);
} else if (strcasecmp(option, "platform") == 0) {
@ -410,7 +410,7 @@ IOR_test_t *ParseCommandLine(int argc, char **argv)
while ((c = getopt(argc, argv, opts)) != -1) {
switch (c) {
case 'A':
initialTestParams.TestNum = atoi(optarg);
initialTestParams.referenceNumber = atoi(optarg);
break;
case 'a':
strcpy(initialTestParams.api, optarg);