83 lines
2.4 KiB
ReStructuredText
83 lines
2.4 KiB
ReStructuredText
|
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`` and ``IOR END`` mark the beginning and end of the script
|
||
|
* ``RUN`` 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
|