Simulator Options - Simulator Options - 2026.1 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2026-06-23
Version
2026.1 English

This section describes the complete set of the x86 simulator (x86simulator) options.

Table 1. x86 Simulator Options
Option Description
-h,--help --h Shows the help message.
--pkg-dir=PKG_DIR Sets the package directory, for example: ./Work
--i, -i, --input-dir=PATH Sets the input directory.
--o, -o, --output-dir=PATH Sets the output directory.
--timeout=secs Terminates simulation after a specified number of seconds immediately after the program begins. Seconds refers to the wall clock time.
--dump Generates snapshots of the data traffic on kernel ports. A snapshot file is generated for each port on a kernel. For more information, see Data Snapshots.
--dump-size=SIZE Sets the maximum size of the snapshot file in MB. The snapshot file is generated by the --dump option.
Note: When the snapshot file exceeds the specified maximum size, setting this option ignores any additional writes to this file and shows the following warning:: WARNING: Snapshot File will exceed its maximum size, further writes to this file will be ignored.
--gdb Invokes from GDB.
--valgrind Runs the simulator under Valgrind to detect memory access violations.
--valgrind-gdb Runs the simulator under Valgrind and debug via GDB server.
--valgrind-args=ARGS Overrides the default options for Valgrind. Used with --valgrind.
--disable-stop-on-deadlock By default the simulator monitors the simulation and stops the simulation when deadlock is detected. This option disables the deadlock monitoring process.
--trace Enables trace of kernel stall events.
--trace-print Prints kernel stall events during simulation.