preferences

Description

The preferences class represents Simics's global simulator preferences that, unlike the settings in the sim object, usually are the same between sessions.

Interfaces Implemented

conf_object, log_object, preference

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
pref-change: Notifier that is triggered when preferences are changed.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for this class

info – print information about the object
status – print status of the object

Attributes

cpu_mode: Optional attribute; read/write access; type: s
Default CPU mode used when loading processor modules. As of Simics 6 only normal is allowed. The value for the current session is in sim->cpu_mode.
gui_mode: Optional attribute; read/write access; type: s
Default GUI mode when starting the command line version of Simics. The value is one of "mixed" and "no-gui". The value for the current session is in sim->gui_mode.
startup_simics_path: Optional attribute; read/write access; type: [s*]
The initial value of the Simics search path. This list of dictionaries are copied to the sim->simics_path attribute at startup.
swap_dir: Optional attribute; read/write access; type: s
Directory where to store swap files, to limit Simics memory usage.
license_file: Optional attribute; read/write access; type: s|n
The path to the default FlexNET license file. See also the license_file attribute in the sim class. The value for the current session is in sim->license_file. Simics has to be restarted for a new license path to take effect.
gui_default_project: Optional attribute; read/write access; type: s|n
Default Simics project to open when Simics is launched in GUI mode. The value for the current session is in sim->project.
output_radix: Optional attribute; read/write access; type: i
The default output radix for integers in the command line. One of 2, 8, 10 and 16. Default is 10.
output_grouping: Optional attribute; read/write access; type: [iiii]
The default digit grouping for integers in the command line, for binary, octal, decimal and hexadecimal integers.
enable_rev_exec: Optional attribute; read/write access; type: b
Set to TRUE if reverse execution should be enabled when Simics is started. Default FALSE.
enable_multithreading: Optional attribute; read/write access; type: b
Set to TRUE if Multimachine Accelerator should be enabled when Simics is started. Default TRUE.
history_lines: Optional attribute; read/write access; type: i
The number of input lines saved in the command history.
async_command_line: Optional attribute; read/write access; type: b
Set to TRUE (default) if command lines in Simics should be asynchronous, meaning that a prompt exists and commands can be entered while the simulation is advancing.
gui_cmd_line_font: Optional attribute; read/write access; type: s|n
Font used in the command line window.
readline_shortcuts: Optional attribute; read/write access; type: b
Set to TRUE if GNU Readline style keyboard shortcuts should be used in the command line. If set to FALSE, Windows style shortcuts are used.
gui_source_code_encoding: Optional attribute; read/write access; type: s|n
Default encoding used in the source code window.
gui_open_cmdline_win: Optional attribute; read/write access; type: b
Set to TRUE if the command line window always should open when Simics is launched in GUI mode.
gui_open_control_win: Optional attribute; read/write access; type: b
Set to TRUE if the control window should open when Simics is launched in command line mode and windows are allowed.
gui_show_deprecated: Optional attribute; read/write access; type: b
Set to TRUE if deprecated functionality in the built-in GUI, such as source level debugging, should be visible.
autostart_sim: Optional attribute; read/write access; type: b
Set to TRUE if the simulation should automatically start when a new session is started. Default FALSE.
legacy_cell: Optional attribute; read/write access; type: b
Allow pre-cell configurations to run.
default_log_endianness: Optional attribute; read/write access; type: s
Sets the default endianness of logged values when not given by context. Valid values are "little" (the default) and "big".
wireshark_path: Optional attribute; read/write access; type: s|n
The directory were wireshark or ethereal binaries are located. If not set the default environment path will be searched.
rle_data_attr: Optional attribute; read/write access; type: b
Whether data attribute values will be RLE-compressed in checkpoints. The default is TRUE.
gzip_config: Optional attribute; read/write access; type: b
Whether saved checkpoint config files will be compressed with gzip (config.gz). The default is TRUE.
checkpoint_chdir: Optional attribute; read/write access; type: b
Whether Simics should change the current working directory during checkpoint saving and loading. The default is FALSE.
cli_table_border_style: Optional attribute; read/write access; type: s
The style of the table-borders. Valid styles are: borderless, ascii, thin, thick and header_only_underline_ascii. Default is thin.
force_ipv4: Optional attribute; read/write access; type: b
If TRUE, network services such as telnet and VNC in the target consoles will use IPv4 only. Default is FALSE.

Provided By

Simics Core