Project

General

Profile

Command-Line Options » History » Version 20

Alexander Kamkin, 04/05/2017 11:35 AM

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 19 Alexander Kamkin
|<. @--help@                        | @-h@         |<. Shows help message                                          | |
14
|<. @--verbose@                     | @-v@         |<. Enables printing diagnostic messages                        | |
15
|<. @--translate@                   | @-t@         |<. Translates formal specifications                            | |
16
|<. @--generate@                    | @-g@         |<. Generates test programs                                     | |
17
|<. @--output-dir <arg>@            | @-od@        |<. Sets where to place generated files                         | |
18
|<. @--include <arg>@               | @-i@         |<. Sets include files directories                              | @--translate@ |
19
|<. @--extension-dir <arg>@         | @-ed@        |<. Sets directory that stores user-defined Java code           | @--translate@ |
20
|<. @--random-seed <arg>@           | @-rs@        |<. Sets seed for randomizer                                    | @--generate@ |
21
|<. @--solver <arg>@                | @-s@         |<. Sets constraint solver engine to be used                    | @--generate@ |
22
|<. @--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
|<. @--tarmac-log@                  | @-tl@        |<. Saves simulator log in Tarmac format                        | @--generate@ |
25
|<. @--self-checks@                 | @-sc@        |<. Inserts self-checking code into test programs               | @--generate@ |
26
|<. @--arch-dirs <arg>@             | @-ad@        |<. Home directories for tested architectures                   | @--generate@ |
27
|<. @--rate-limit <arg>@            | @-rl@        |<. Generation rate limit, causes error when broken             | @--generate@ |
28
|<. @--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
|<. @--data-file-extension <arg>@   | @-dfe@       |<. The data file extension                                     | @--generate@ |
31
|<. @--data-file-prefix <arg>@      | @-dfp@       |<. The data file prefix                                        | @--generate@ |
32
|<. @--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
|<. @--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
|<. @--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.