Project

General

Profile

Command-Line Options » History » Version 24

Alexander Kamkin, 01/10/2020 02:08 PM

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