Mario1159/verilator
1
0
Fork 0
forked from github/verilator
Code Pull Requests Releases 1 Activity

Commentary on --main

Browse Source
This commit is contained in:
Wilson Snyder 2022-09-15 20:26:08 -04:00
parent 22846df03e
commit ab6e1c2399
2 changed files with 10 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
bin/verilator
View File

@ -341,10 +341,9 @@ detailed descriptions of these arguments.
--lib-create <name> Create a DPI library --lib-create <name> Create a DPI library
+libext+<ext>+[ext]... Extensions for finding modules +libext+<ext>+[ext]... Extensions for finding modules
--lint-only Lint, but do not make output --lint-only Lint, but do not make output
--main Generate a main C++ file
--make <build-tool> Generate scripts for specified build tool --make <build-tool> Generate scripts for specified build tool
-MAKEFLAGS <flags> Arguments to pass to make during --build -MAKEFLAGS <flags> Arguments to pass to make during --build
--main Generate C++ main() --main Generate C++ main() file
--max-num-width <value> Maximum number width (default: 64K) --max-num-width <value> Maximum number width (default: 64K)
--Mdir <directory> Name of output object directory --Mdir <directory> Name of output object directory
--MMD Create .d dependency files --MMD Create .d dependency files

21
docs/guide/exe_verilator.rst
View File

@ -684,16 +684,6 @@ Summary:
If the design is not to be completely Verilated see also the If the design is not to be completely Verilated see also the
:vlopt:`--bbox-sys` and :vlopt:`--bbox-unsup` options. :vlopt:`--bbox-sys` and :vlopt:`--bbox-unsup` options.
.. option:: --main
Generates a simple main C++ file. Without :vlopt:`--timing`, you need to
modify this file to provide some stimuli to the design. However, this option
is especially useful with :vlopt:`--timing` and delay-generated clocks, as
then the main file provides a timing-enabled eval loop and requires no
modification by the user. :vlopt:`--build` can then be used to build the
simulation, allowing you to use Verilator without directly invoking
the C++ toolchain.
.. option:: --make <build-tool> .. option:: --make <build-tool>
Generates a script for the specified build tool. Generates a script for the specified build tool.
@ -720,8 +710,15 @@ Summary:
Generates a top-level C++ main() file that supports parsing arguments, Generates a top-level C++ main() file that supports parsing arguments,
but does not drive any inputs. This is sufficient to use for top-level but does not drive any inputs. This is sufficient to use for top-level
SystemVerilog designs that has no inputs, and does not need the C++ to SystemVerilog designs that has no inputs.
do any time advancement.
This option can also be used once to generate a main .cpp file as a
starting point for editing. Copy it outside the obj directory, manually
edit, and then pass the filename on later Verilator command line
invocations.
Typically used with :vlopt:`--timing` to support delay-generated clocks,
and :vlopt:`--build`.
Implies :vlopt:`--cc` if no other output mode was provided. Implies :vlopt:`--cc` if no other output mode was provided.