Possible values:

• RAW: the emulated Ethernet card is mapped to a physical interface on the Charon host that is dedicated to the Charon guest system. This setting is the default value.
• TAP: the emulated Ethernet card is mapped to a TAP device on the Charon host. If the parameter iface is not set or the specified interface does not exist, it is created by the emulator.
• DUMMY: presents a network interface without any actual network connectivity to the guest system. All other Ethernet parameters are ignored if this parameter is set.
  It will be set automatically, if
  • iface="dummy",
  • or iface="" and mapping_mode="RAW".

Specifies the name of the host interface mapped to the emulated interface.

For mapping_mode="RAW": this parameter must be set to an interface dedicated to the emulator.

For mapping_mode="TAP": the parameter can be

• empty: the emulator will choose a name for the TAP interface and create it automatically at startup (and delete it when stopped).
• name of non-existing TAP interface: the emulator will create the interface automatically at startup (and delete it when stopped).
• name of an existing TAP interface: the emulator will use this interface.

For any mapping_mode: the value dummy will cause the emulator to present a dummy network interface to the guest system.

Upon emulator start, Charon-PAR will set a variable IFACE to contain the interface name. This variable can then be used in the initialization command to refer to the interface name.

Can be set to override the default (same as host interface) MAC address of the interface.
By default, when using mapping_mode RAW, the interface is put into promiscuous mode, and the original MAC address of the interface is not overwritten.
If the legacy_mode is configured for the interface, it is not set into promiscuous mode, and the MAC address of the corresponding host NIC is changed to the configured address. The original MAC address is restored upon emulator exit.

Please note: the above behavior is new starting with version 3.0.1 build 21.500. In older versions, when the MAC address was changed, it was not reset automatically when the emulator was stopped.

initialize_command

Command(s) to initialize the host interface for use with the Charon emulator.

• For physical interfaces (RAW): all offload parameters active on the interface should be turned off, as shown by the example in the configuration file template.
• For TAP interfaces: the TAP interface should be activated, if needed, and added to the appropriate bridge interface (example: "ip link set $IFACE up; ip link set $IFACE master br0"); the exact configuration depends on the customer requirements.

The variable IFACE is set by the emulator and defined automatically for the execution of the initialization command.

Defines the speed and duplex settings of the interface that are reported to the guest system.

Possible values: auto, 10BaseT-HD, 10BaseT-FD, 100BaseT-HD, 100BaseT-FD
Default: 100BaseT-FD

New starting with version 3.0.1 build 21.500. Only applicable to mapping_mode RAW. PA64 uses a physical network adapter in promiscuous mode by default. This parameter allows to change the mode to non-promiscuous.

Possible values:

• true - non-promiscuous mode; if a custom MAC address was set, it will be set on the physical NIC during emulator operation and reset to the burned-in MAC address when the emulator stops.
• false - promiscuous mode; if a custom MAC address was set, it will not be be set on the physical NIC (not required for the guest communication due to promiscuous mode)

Default: false

Can be used to enable a packet dump to the log file.
Possible values: true or false
Default: false

Can be used to set the size of the RX FIFO buffer (in KB). Do not change unless advised to do so by Stromasys support.
Possible values: 0, or 16 to 1024
Default: 0 = disabled