Command-Line Options » History » Revision 19
Revision 18 (Alexander Kamkin, 04/05/2017 11:22 AM) → Revision 19/24 (Alexander Kamkin, 04/05/2017 11:30 AM)
h1. MicroTESK Command-Line Options
_~By Andrei Tatarnikov~_
MicroTESK works in two modes: specification translation and test generation, which are enabled with the @--translate@ (used by default) and @--generate@ keys correspondingly. In addition, the @--help@ key prints information on the command-line format.
The @--translate@ and @--generate@ keys are inserted into the command-line by @compile.sh/compile.bat@ and @generate.sh/generate.bat@ scripts correspondingly. Other options should be specified explicitly to customize the behavior of MicroTESK.
*Options:*
table=.
{font-style:italic; font-weight:bold; background:#ddd}. |<.
| Full name | Short name | Description | Requires |
|<. @--help@ | @-h@ --help | -h |<. | Shows help message | |
|<. @--verbose@ | @-v@ --verbose | -v |<. | Enables printing diagnostic messages | |
|<. @--translate@ | @-t@ --translate | -t |<. | Translates formal specifications | |
|<. @--generate@ | @-g@ --generate | -g |<. | Generates test programs | |
|<. @--output-dir <arg>@ | @-od@ --output-dir <arg> | -od |<. | Sets where to place generated files | |
|<. @--include <arg>@ | @-i@ --include <arg> | -i |<. | Sets include files directories | @--translate@ --translate |
|<. @--extension-dir <arg>@ | @-ed@ --extension-dir <arg> | -ed |<. | Sets directory that stores user-defined Java code | @--translate@ --translate |
|<. @--random-seed <arg>@ | @-rs@ --random-seed <arg> | -rs |<. | Sets seed for randomizer | @--generate@ --generate |
|<. @--solver <arg>@ | @-s@ --solver <arg> | -s |<. | Sets constraint solver engine to be used | @--generate@ --generate |
|<. @--branch-exec-limit <arg>@ | @-bel@ --branch-exec-limit <arg> | -bel |<. | Sets the limit on control transfers to detect endless loops | @--generate@ --generate |
|<. @--solver-debug@ | @-sd@ --solver-debug | -sd |<. | Enables debug mode for SMT solvers | @--generate@ --generate |
|<. @--tarmac-log@ | @-tl@ --tarmac-log | -tl |<. | Saves simulator log in Tarmac format | @--generate@ --generate |
|<. @--self-checks@ | @-sc@ --self-checks | -sc |<. | Inserts self-checking code into test programs | @--generate@ --generate |
|<. @--arch-dirs <arg>@ | @-ad@ --arch-dirs <arg> | -ad |<. | Home directories for tested architectures | @--generate@ --generate |
|<. @--rate-limit <arg>@ | @-rl@ --rate-limit <arg> | -rl |<. | Generation rate limit, causes error when broken | @--generate@ --generate |
|<. @--code-file-extension <arg>@ | @-cfe@ --code-file-extension <arg> | -cfe |<. | The output file extension | @--generate@ --generate |
|<. @--code-file-prefix <arg>@ | @-cfp@ --code-file-prefix <arg> | -cfp |<. | The output file prefix (file names are as follows @prefix_xxxx.ext@, prefix_xxxx.ext, where @xxxx@ xxxx is a 4-digit decimal number) | @--generate@ --generate |
|<. @--data-file-extension <arg>@ | @-dfe@ --data-file-extension <arg> | -dfe |<. | The data file extension | @--generate@ --generate |
|<. @--data-file-prefix <arg>@ | @-dfp@ --data-file-prefix <arg> | -dfp |<. | The data file prefix | @--generate@ --generate |
|<. @--exception-file-prefix <arg>@ | @-efp@ |<. --exception-file-prefix <arg> | -efp | The exception handler file prefix | @--generate@ --generate |
|<. @--program-length-limit <arg>@ | @-pll@ --program-length-limit <arg>| -pll |<. | The maximum number of instructions in output programs | @--generate@ --generate |
|<. @--trace-length-limit <arg>@ | @-tll@ --trace-length-limit <arg> | -tll |<. | The maximum length of execution traces of output programs | @--generate@ --generate |
|<. @--comments-enabled@ | @-ce@ --comments-enabled | -ce |<. | Enables printing comments; if not specified no comments are printed | @--generate@ --generate |
|<. @--comments-debug@ | @-cd@ --comments-debug | -cd |<. | Enables printing detailed comments; must be used together with @--comments-enabled@ --comments-enabled | @--generate@ --generate |
*Notes:*
Format of the <code>--arch-dirs</code> option argument is the following:
<pre><code>--arch-dirs mips=arch/mips:arm=arch/arm:sparc=arch/sparc</code></pre>
# Entries are separated by <code>'':''</code>.
# Each entry has the following format: <code><architecture-name>=<path-to-the-architecture-directory></code>.
# If a path is relative, <code>MICROTESK_HOME</code> is used as a prefix.