Option Summary - HACKT CHPSIM Manual
Description: HACKT CHPSIM Manual

Next: General Flags, Up: Usage

### 2.1 Option Summary

For options that take an argument, the space between the flag and the argument is optional.

— User Option: none

> With no arguments, just print a list of all command-line options, much like what is summarized below.

— User Option: -b

> Batch mode, non-interactive, promptless. This is useful for running scripts or piping in commands while suppressing prompts. This mode also turns off tab-completion in the interpreter. The opposing option is `-i`. Note: executables linked against `libeditline` may require this option for processing scripts due to a mishandling of EOF.

— User Option: -d checkpoint

> Produce a textual dump of a checkpoint binary. Exits without running the simulator.

— User Option: -f flag

> See General Flags.

— User Option: -h

> Help. Print list of all interpreter commands and exit.

— User Option: -i

> Interactive, prompting. This is the default mode. The opposing option is `-b`.

— User Option: -I path (repeatable)

> Append path to the list of paths to search for sourcing other command scripts in the interpreter.

— User Option: -L path (repeatable)

> Append path to the list of paths to search for opening shared library plug-ins (modules). The equivalent command in the interpreter is `dladdpath`. For more on building and loading shared-libraries, See Extending simulation.

— User Option: -l lib (repeatable)

> Load the lib shared library module for registering user-defined run-time functions. lib should be named without its file extension, for the sake of portability. For example, `libcrunch.la` should be referenced as ``libcrunch`', and `chewy.so` should be referenced as ``chewy`'. The equivalent command in the interpreter is `dlopen`.

— User Option: -c

> Pass to indicate that input file is a source (to be compiled) as opposed to an object file.

— User Option: -C options

> When input is a source file, forward options to the compiler driver.

— User Option: -r file

> Startup the simulation already recording a trace file of every event. Trace file is automatically close when simulation exits. This is equivalent issuing `trace` command at the beginning of a simulation session.

— User Option: -t type

> Instead of expanding the whole top-level instances, only operate on the given type type, i.e. instantiate one instance of type as the top-level. This variation, however does not expand subinstances recursively, like the `-T` option. This is particularly useful for examining the CHP event structure of a particular definition.

— User Option: -T type

> Instantiate one instance of type type as the top-level, ignoring all previous top-level instances in the object file. This variation does recursively instantiate substructures. The ports of the instance of type (if any) will not be connected to any other processes. This is particularly useful for selecting test structures out of a collection of test structure definitions.