Scripting¶
IOR can use an input script with the command line using the -f
option.
Any options on the command line set before the ‘-f’ option is given will be
considered the default settings for running the script. For example,
mpirun ./ior -W -f script
will run all tests in the script with an implicit -W
. The script itself can
override these settings and may be set to run many different tests of IOR under
a single execution, and it is important to note that any command-line options
specified after ``-f`` will not be applied to the runs dictated by the script.
For example,
mpirun ./ior -f script -W
will not run any tests with the implicit -W
since that argument does not
get applied until after the -f
option (and its constituent runs) are complete.
Input scripts are specified using the long-form option names that correspond to each command-line option. In addition to long-form options,
IOR START
andIOR END
mark the beginning and end of the scriptRUN
dispatches the test using all of the options specified before it- All previous set parameter stay set for the next test. They are not reset to the default! For default the must be rest manually.
- White space is ignored in script, as are comments starting with
#
.- Not all test parameters need be set.
An example of a script:
IOR START
api=[POSIX|MPIIO|HDF5|HDFS|S3|S3_EMC|NCMPI|RADOS]
testFile=testFile
hintsFileName=hintsFile
repetitions=8
multiFile=0
interTestDelay=5
readFile=1
writeFile=1
filePerProc=0
checkWrite=0
checkRead=0
keepFile=1
quitOnError=0
segmentCount=1
blockSize=32k
outlierThreshold=0
setAlignment=1
transferSize=32
singleXferAttempt=0
individualDataSets=0
verbose=0
numTasks=32
collective=1
preallocate=0
useFileView=0
keepFileWithError=0
setTimeStampSignature=0
useSharedFilePointer=0
useStridedDatatype=0
uniqueDir=0
fsync=0
storeFileOffset=0
maxTimeDuration=60
deadlineForStonewalling=0
useExistingTestFile=0
useO_DIRECT=0
showHints=0
showHelp=0
RUN
# additional tests are optional
transferSize=64
blockSize=64k
segmentcount=2
RUN
transferSize=4K
blockSize=1M
segmentcount=1024
RUN
IOR STOP