Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: more information about new log file format

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Parameter license_key_id 

Optional parameter. There can be several license_key_id parameters in this section. They define a prioritized list of license keys. The first entry has the highest priority. If no key with this ID is available, the next key in the list will be tried. If a higher priority key becomes available, the emulator will switch to this license at the next periodic license check.

Syntax:

license_key_id "key-id-prio1"

...

Optional parameter. There can be several license_id parameters in this section. They define a prioritized list of product license IDs. The first entry has the highest priority. If no key with this product license ID is available, the next product license ID in the list will be attempted. If a higher priority license becomes available, the emulator will switch to this license at the next periodic license check.

Syntax:

license_id "lic-id-prio1"

...

Serial port option
Description
type

The serial port type determines the protocol used on the serial port. Possible values are:

  • socket: the port is set to telnet raw mode.
  • telnet: the port supports the telnet protocol.
  • device: indicates that the emulated serial line is connected to a physical terminal on the host.
port

Each port is mapped to a TCP socket on the emulator host or to a physical line. This parameter defines the TCP port used or the name of the physical device. A TCP port number must be unique on the host system.

A TCP port number is specified as "<where-to-listen>:<portnumber>". It requires a port type of socket or telnet.

Possible values for where-to-listen:

  • Empty:
    • If the port number is specified without a colon (:), the console will only be accessible on the localhost address. Equivalent lo:<portnumber>.
    • If the port number is specified with a colon, the console process will listen on all host interfaces.
  • Interface name: the console process will only listen on the specified host interface.
  • IP address: the console process will only listen on host IP address.

Default values:

  • ":30000" for line 1
  • ":30002" for line 2

A physical device is specified as "<device-file>". It requires a port type of device.

Example:

  • "/dev/ttyS0"
  • "/dev/ttyUSB0"
commandThis parameter is optional. It can be used to specify a terminal emulation program that is started automatically when the emulated system is started. Charon-PAR provides preconfigured profiles for PuTTY (HPA-Socket HPA-Telnet HPA-Telnet-VT100) that can be used to connect to the emulated system via a serial line.

...

This section defines how Charon-PAR handles logging. Note that the default log file location is the directory in which the emulator was started. This can be changed with the emulator command-line option
-l (or --logfile-path).

Log File Parameters

The following table shows the parameters relevant to the log file and their values:

ParameterDescription
log.name="log-file-name"log-file-name specifies the base name of the log file. The full log file name will be created using the base name combined with date and serial number. Default: hppa_log.
log.on_console= false | trueDefines if logging output should be sent to the Charon-PAR console. Default: true.
log.disable= false | trueEnable or disable logging. Default: false.
log.no_rotate= false | trueIf set to false, once the line limit for a log file has been reached, the old log file will be closed and a new one will be opened with the last number in the log-file name incremented.. Default: false.
log.line_limit = valueMaximum number of lines in the log file before rotation. Default: 100000.

Log File Format

Starting with version 3.0.1 the log file has the following format:

Code Block
languageactionscript3
YYYYMMDD:hhmmss.uuuuuu:<severity><message>

   where

YYYY   - year
MM     - month
DD     - day
hh     - hour
mm     - munites
ss     - seconds
uuuuuu - usecs

<severity> := '(warn|err|ERR):' or empty

warn   - warning
err    - error
ERR    - fatal error

<message> the component's message in free form

Parameter system.license_logging_level

...