Simulation Runtime Arguments

The following are the arguments that may be passed to a Verilated executable, provided that executable calls Verilated::commandArgs().

All simulation runtime arguments begin with “+verilator”, so that the user’s executable may skip over all “+verilator” arguments when parsing its command line.

Summary:

+verilator+debug                  Enable debugging
+verilator+debugi+<value>         Enable debugging at a level
+verilator+error+limit+<value>    Set error limit
+verilator+help                   Display help
+verilator+noassert               Disable assert checking
+verilator+prof+threads+file+<filename>  Set profile filename
+verilator+prof+threads+start+<value>    Set profile starting point
+verilator+prof+threads+window+<value>   Set profile duration
+verilator+rand+reset+<value>     Set random reset technique
+verilator+seed+<value>           Set random seed
+verilator+V                      Verbose version and config
+verilator+version                Show version and exit
+verilator+debug

Enable simulation runtime debugging. Equivalent to +verilator+debugi+4.

+verilator+debugi+<value>

Enable simulation runtime debugging at the provided level.

+verilator+error+limit+<value>

Set number of non-fatal errors (e.g. assertion failures) before exiting simulation runtime. Also affects number of $stop calls needed before exit. Defaults to 1.

+verilator+help

Display help and exit.

+verilator+prof+threads+file+<filename>

When a model was Verilated using --prof-threads, sets the simulation runtime filename to dump to. Defaults to profile_threads.dat.

+verilator+prof+threads+start+<value>

When a model was Verilated using --prof-threads, the simulation runtime will wait until $time is at this value (expressed in units of the time precision), then start the profiling warmup, then capturing. Generally this should be set to some time that is well within the normal operation of the simulation, i.e. outside of reset. If 0, the dump is disabled. Defaults to 1.

+verilator+prof+threads+window+<value>

When a model was Verilated using --prof-threads, after $time reaches +verilator+prof+threads+start+<value>, Verilator will warm up the profiling for this number of eval() calls, then will capture the profiling of this number of eval() calls. Defaults to 2, which makes sense for a single-clock-domain module where it’s typical to want to capture one posedge eval() and one negedge eval().

+verilator+rand+reset+<value>

When a model was Verilated using --x-initial unique, sets the simulation runtime initialization technique. 0 = Reset to zeros. 1 = Reset to all-ones. 2 = Randomize. See Unknown States.

+verilator+seed+<value>

For $random and --x-initial unique, set the simulation runtime random seed value. If zero or not specified picks a value from the system random number generator.

+verilator+noassert

Disable assert checking per runtime argument. This is the same as calling Verilated::assertOn(false) in the model.

+verilator+V

Shows the verbose version, including configuration information.

+verilator+version

Displays program version and exits.