Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: new command-line options in 3.0.3

...

When starting Charon-PAR (the command /opt/charon/bin/charon-par), there are several command-line options that can be used. The following table provides an overview:

OptionDescription
-D, --dump

Do not use in a production environment unless instructed to do so by Stromasys technical support!

Emulator runs in core dump mode. If stopped with SIGQUIT or other stop signal, it will write a core file in the location specified by /proc/sys/kernel/core_pattern.

-F, --fast-fpuFast FPU mode provides better floating-point performance at the expense of minor deviation in floating-point status reporting. When this option is enabled, all floating-point operations produce exactly the same values as the real hardware. The only deviation is that bit I (Inexact) in the Floating Point Status Register is not always accumulated between subsequent operations. Such differences cause FPU tests (ODE WDIAG and llmc_em) to report errors. However, it is highly unlikely that any real system or application software is impacted by this deviation. Configuration show in emulator log as (FPU DIT Mode: Fast - vs Precise).

-G <mode>
--ditgcsync <mode>

Do not use in a production environment unless instructed to do so by Stromasys technical support!

Possible values:

  • sync: synchronous garbage collector mode
  • async: asynchronous garbage collector mode (default)
-S <mode>
--ditsync <mode>

Do not use in a production environment unless instructed to do so by Stromasys technical support!

Possible values:

  • sync: synchronous DIT execution mode
  • async: asynchronous DIT execution mode (default)
  • no_dit: DIT disabled

-K <dit-level>
--dit-kind <dit-level>

Do not use in a production environment unless instructed to do so by Stromasys technical support!

Each Charon-PAR model has a built-in maximal DIT optimization level. This parameter allows to reduce this level. As result, the emulation will run with reduced performance.

Possible values (from lowest to highest): dispatch, slow, medium, basic, adv

-X <mode>
--collect-statistics <mode>

Collect the available statistics.

Mode format: <level>,json,<file-name>, where level = 0-9

-a <name>
--instance-name <name>
Assigns a logical name to the emulated system instance at start. This parameter will only be used in future Baremetal environments. 

-c <console-port>
--console-port <console-port>

Redirects the Charon-PAR console to a TCP/IP port that can be accessed via telnet (from local system only). This makes the console accessible also when the emulator runs in daemon mode. The port number can be in the range of 0-65535. However, port numbers 0-1023 are generally reserved for specific applications and should not be used.

-f <filename>
--config <filename>

Specifies the path to the emulator configuration file.

-h
--help

Displays a short help information.
-l <logpath>
--logfile-path <logpath>
Specifies the path to the logfile.

-p <filename>
--pidfile <filename>

Name of file to store the process ID of the emulator process. Used mostly when running emulator as a daemon.
-x
--daemon

The emulator is started as a daemon.

This mode can be used when the emulator is to be started at system boot.

It can also be used to start the emulator while connected to the system via the network to avoid license problems.

...