luke
/
verilator
mirror of https://github.com/verilator/verilator.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Commentary (#4517)

This commit is contained in:
Wilson Snyder 2023-11-01 17:43:11 -04:00
parent 839315b271
commit 2a57ead7e3
1 changed files with 43 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
docs/guide/environment.rst
View File

@ -7,21 +7,6 @@ Environment
This section describes the environment variables used by Verilator and This section describes the environment variables used by Verilator and
associated programs. associated programs.
.. option:: AR
Optionally overrides the default :command:`ar` (archive) binary used by
the Verilated makefiles. If AR is not set, the version found at
configure time is used.
.. option:: CXX
Optionally overrides the default compiler binary used by the Verilated
makefiles. If CXX is not set, the version found at configure time is
used. Note the default flags passed to the compiler are determined at
configuration time, so changing the CXX compiler version using this
variable, as opposed to passing it at configuration time, may not give
desired results.
.. option:: LD_LIBRARY_PATH .. option:: LD_LIBRARY_PATH
A generic Linux/OS variable specifying what directories have shared A generic Linux/OS variable specifying what directories have shared
@ -50,12 +35,6 @@ associated programs.
those programs. If OBJCACHE is not set, and at configure time ccache those programs. If OBJCACHE is not set, and at configure time ccache
was present, ccache will be used as a default. was present, ccache will be used as a default.
.. option:: PYTHON3
Optionally overrides the default :command:`python3` binary used by the
Verilated makefiles. If PYTHON3 is not set, the version found at
configure time is used.
.. option:: SYSTEMC .. option:: SYSTEMC
Deprecated. Used only if :option:`SYSTEMC_INCLUDE` or Deprecated. Used only if :option:`SYSTEMC_INCLUDE` or
@ -138,3 +117,46 @@ associated programs.
``VERILATOR_ROOT`` to point to the new version. ``VERILATOR_ROOT`` to point to the new version.
See :ref:`Installation` for more details. See :ref:`Installation` for more details.
Make Variables
==============
This section describes the make variables used by Verilator. These may be
set by passing them to make e.g. ``make CXX=my-gcc ...``.
.. option:: AR
Optionally overrides the default :command:`ar` (archive) binary used by
the Verilated makefiles. If AR is not set, the version found at
configure time is used.
.. option:: CXX
Optionally overrides the default compiler binary used by the Verilated
makefiles. If CXX is not set, the version found at configure time is
used. Note the default flags passed to the compiler are determined at
configuration time, so changing the CXX compiler version using this
variable, as opposed to passing it at configuration time, may not give
desired results.
.. option:: LINK
Optionally overrides the default linker binary used by the Verilated
makefiles. If LINK is not set, the version found at configure time is
used. Note the default flags passed to the linker are determined at
configuration time, so changing the LINK version using this variable, as
opposed to passing it at configuration time, may not give desired
results.
.. option:: PERL
Optionally overrides the default :command:`perl` binary used by the
Verilated makefiles. If PERL is not set, the version found at configure
time, and compiled into the Verilator binary, is used.
.. option:: PYTHON3
Optionally overrides the default :command:`python3` binary used by the
Verilated makefiles. If PYTHON3 is not set, the version found at
configure time is used.