Command-Line Options » History » Version 22
Andrei Tatarnikov, 05/11/2017 03:25 PM
| 1 | 1 | Andrei Tatarnikov | h1. MicroTESK Command-Line Options |
|---|---|---|---|
| 2 | |||
| 3 | 3 | Andrei Tatarnikov | _~By Andrei Tatarnikov~_ |
| 4 | |||
| 5 | 2 | 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. |
| 6 | |||
| 7 | 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. |
||
| 8 | |||
| 9 | *Options:* |
||
| 10 | |||
| 11 | 18 | Alexander Kamkin | table=. |
| 12 | 20 | Alexander Kamkin | {font-style:italic; font-weight:bold; background:#ddd}. |<. Full name | Short name |<. Description | Requires | |
| 13 | 21 | Alexander Kamkin | |<. @--help@ | @-h@ |<. Shows help message | | |
| 14 | {background:#f6fcff}. |<. @--verbose@ | @-v@ |<. Enables printing diagnostic messages | | |
||
| 15 | |<. @--translate@ | @-t@ |<. Translates formal specifications | | |
||
| 16 | {background:#f6fcff}. |<. @--generate@ | @-g@ |<. Generates test programs | | |
||
| 17 | |<. @--output-dir <arg>@ | @-od@ |<. Sets where to place generated files | | |
||
| 18 | {background:#f6fcff}. |<. @--include <arg>@ | @-i@ |<. Sets include files directories | @--translate@ | |
||
| 19 | |<. @--extension-dir <arg>@ | @-ed@ |<. Sets directory that stores user-defined Java code | @--translate@ | |
||
| 20 | {background:#f6fcff}. |<. @--random-seed <arg>@ | @-rs@ |<. Sets seed for randomizer | @--generate@ | |
||
| 21 | |<. @--solver <arg>@ | @-s@ |<. Sets constraint solver engine to be used | @--generate@ | |
||
| 22 | {background:#f6fcff}. |<. @--branch-exec-limit <arg>@ | @-bel@ |<. Sets the limit on control transfers to detect endless loops | @--generate@ | |
||
| 23 | |<. @--solver-debug@ | @-sd@ |<. Enables debug mode for SMT solvers | @--generate@ | |
||
| 24 | 22 | Andrei Tatarnikov | {background:#f6fcff}. |<. @--tracer-log@ | @-tl@ |<. Enables generation of Tracer logs for simulation | @--generate@ | |
| 25 | 21 | Alexander Kamkin | |<. @--self-checks@ | @-sc@ |<. Inserts self-checking code into test programs | @--generate@ | |
| 26 | {background:#f6fcff}. |<. @--arch-dirs <arg>@ | @-ad@ |<. Home directories for tested architectures | @--generate@ | |
||
| 27 | |<. @--rate-limit <arg>@ | @-rl@ |<. Generation rate limit, causes error when broken | @--generate@ | |
||
| 28 | {background:#f6fcff}. |<. @--code-file-extension <arg>@ | @-cfe@ |<. The output file extension | @--generate@ | |
||
| 29 | |<. @--code-file-prefix <arg>@ | @-cfp@ |<. The output file prefix (file names are as follows @prefix_xxxx.ext@, where @xxxx@ is a 4-digit decimal number) | @--generate@ | |
||
| 30 | {background:#f6fcff}. |<. @--data-file-extension <arg>@ | @-dfe@ |<. The data file extension | @--generate@ | |
||
| 31 | |<. @--data-file-prefix <arg>@ | @-dfp@ |<. The data file prefix | @--generate@ | |
||
| 32 | {background:#f6fcff}. |<. @--exception-file-prefix <arg>@ | @-efp@ |<. The exception handler file prefix | @--generate@ | |
||
| 33 | |<. @--program-length-limit <arg>@ | @-pll@ |<. The maximum number of instructions in output programs | @--generate@ | |
||
| 34 | {background:#f6fcff}. |<. @--trace-length-limit <arg>@ | @-tll@ |<. The maximum length of execution traces of output programs | @--generate@ | |
||
| 35 | |<. @--comments-enabled@ | @-ce@ |<. Enables printing comments; if not specified no comments are printed | @--generate@ | |
||
| 36 | {background:#f6fcff}. |<. @--comments-debug@ | @-cd@ |<. Enables printing detailed comments; must be used together with @--comments-enabled@ | @--generate@ | |
||
| 37 | 8 | Andrei Tatarnikov | |
| 38 | *Notes:* |
||
| 39 | |||
| 40 | 9 | Andrei Tatarnikov | Format of the <code>--arch-dirs</code> option argument is the following: |
| 41 | 8 | Andrei Tatarnikov | |
| 42 | <pre><code>--arch-dirs mips=arch/mips:arm=arch/arm:sparc=arch/sparc</code></pre> |
||
| 43 | |||
| 44 | 10 | Andrei Tatarnikov | # Entries are separated by <code>'':''</code>. |
| 45 | 8 | Andrei Tatarnikov | # Each entry has the following format: <code><architecture-name>=<path-to-the-architecture-directory></code>. |
| 46 | # If a path is relative, <code>MICROTESK_HOME</code> is used as a prefix. |