Project

General

Profile

Command-Line Options » History » Revision 21

Revision 20 (Alexander Kamkin, 04/05/2017 11:35 AM) → Revision 21/24 (Alexander Kamkin, 04/05/2017 01:23 PM)

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@           |<. Shows help message                                            | | 
 {background:#f6fcff}. |<. @--verbose@                       | @-v@           |<. Enables printing diagnostic messages                          | | 
                       
 |<. @--translate@                     | @-t@           |<. Translates formal specifications                              | | 
 {background:#f6fcff}. |<. @--generate@                      | @-g@           |<. Generates test programs                                       | | 
                       
 |<. @--output-dir <arg>@              | @-od@          |<. Sets where to place generated files                           | | 
 {background:#f6fcff}. |<. @--include <arg>@                 | @-i@           |<. Sets include files directories                                | @--translate@ | 
                       
 |<. @--extension-dir <arg>@           | @-ed@          |<. Sets directory that stores user-defined Java code             | @--translate@ | 
 {background:#f6fcff}. |<. @--random-seed <arg>@             | @-rs@          |<. Sets seed for randomizer                                      | @--generate@ | 
                       
 |<. @--solver <arg>@                  | @-s@           |<. Sets constraint solver engine to be used                      | @--generate@ | 
 {background:#f6fcff}. |<. @--branch-exec-limit <arg>@       | @-bel@         |<. Sets the limit on control transfers to detect endless loops | @--generate@ | 
                       
 |<. @--solver-debug@                  | @-sd@          |<. Enables debug mode for SMT solvers                            | @--generate@ | 
 {background:#f6fcff}. |<. @--tarmac-log@                    | @-tl@          |<. Saves simulator log in Tarmac format                          | @--generate@ | 
                       
 |<. @--self-checks@                   | @-sc@          |<. Inserts self-checking code into test programs                 | @--generate@ | 
 {background:#f6fcff}. |<. @--arch-dirs <arg>@               | @-ad@          |<. Home directories for tested architectures                     | @--generate@ | 
                       
 |<. @--rate-limit <arg>@              | @-rl@          |<. Generation rate limit, causes error when broken               | @--generate@ | 
 {background:#f6fcff}. |<. @--code-file-extension <arg>@     | @-cfe@         |<. The output file extension                                     | @--generate@ | 
                       
 |<. @--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@ | 
 {background:#f6fcff}. |<. @--data-file-extension <arg>@     | @-dfe@         |<. The data file extension                                       | @--generate@ | 
                       
 |<. @--data-file-prefix <arg>@        | @-dfp@         |<. The data file prefix                                          | @--generate@ | 
 {background:#f6fcff}. |<. @--exception-file-prefix <arg>@ | @-efp@         |<. The exception handler file prefix                             | @--generate@ | 
                       
 |<. @--program-length-limit <arg>@    | @-pll@         |<. The maximum number of instructions in output programs         | @--generate@ | 
 {background:#f6fcff}. |<. @--trace-length-limit <arg>@      | @-tll@         |<. The maximum length of execution traces of output programs     | @--generate@ | 
                       
 |<. @--comments-enabled@              | @-ce@          |<. Enables printing comments; if not specified no comments are printed | @--generate@ | 
 {background:#f6fcff}. |<. @--comments-debug@                | @-cd@          |<. Enables printing detailed comments; must be used together with @--comments-enabled@    | @--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.